diff --git a/.tgitconfig b/.tgitconfig new file mode 100644 index 0000000..e69de29 diff --git a/Bin/Debug/CommonControls/.NET4 示例/0.png b/Bin/Debug/CommonControls/.NET4 示例/0.png new file mode 100644 index 0000000..16cf159 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/0.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/1.png b/Bin/Debug/CommonControls/.NET4 示例/1.png new file mode 100644 index 0000000..40f0d77 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/1.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project.exe b/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project.exe deleted file mode 100644 index 1d51c25..0000000 Binary files a/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project.exe and /dev/null differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project2.exe b/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project2.exe index 2bf9a9c..3dc083b 100644 Binary files a/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project2.exe and b/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project2.exe differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project2.exe.config b/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project2.exe.config new file mode 100644 index 0000000..ff99501 --- /dev/null +++ b/Bin/Debug/CommonControls/.NET4 示例/Itrycn_Project2.exe.config @@ -0,0 +1,3 @@ + + + diff --git a/Bin/Debug/CommonControls/.NET4 示例/MyDb.dll b/Bin/Debug/CommonControls/.NET4 示例/MyDb.dll index 45845a5..80404b2 100644 Binary files a/Bin/Debug/CommonControls/.NET4 示例/MyDb.dll and b/Bin/Debug/CommonControls/.NET4 示例/MyDb.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/MyDb.xml b/Bin/Debug/CommonControls/.NET4 示例/MyDb.xml index c3d0f9c..a9f0931 100644 --- a/Bin/Debug/CommonControls/.NET4 示例/MyDb.xml +++ b/Bin/Debug/CommonControls/.NET4 示例/MyDb.xml @@ -1090,6 +1090,13 @@ 是否是通配符表达式,不是，则普通替换，忽略大小写，是，则启用通配符替换 + + + 将颜色转换为Html颜色格式 + + + + 支持忽略大小写的替换文本功能 @@ -1595,8 +1602,15 @@ 比较两个版本号大小 - - oldVer小于newVer,返回1,大于则返回-1,相等返回0 + + oldVer小于newVer,返回1,大于则返回-1,相等返回0,不支持则返回-1000 + + + + 从字符串中提取版本号 + + + @@ -1653,6 +1667,14 @@ 目标文件夹 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + 复制文件夹到目标文件夹,支持进度事件,支持中途取消 @@ -1784,6 +1806,429 @@ 是否要删除 + + + 图片相关API + + + + + 从文件或Url中加载图片,使用本方法，不会导致图片文件被占用。 + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 以逆时针为方向对图像进行旋转 + + 位图流 + 旋转角度[0,360](前台给的) + + + + + 是否包括透明像素 + + + + 操作失败 + + + + 矩形边界 + + + + + + + + 计算水印位置 + + + + + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 计算最大字体大小 + + + + + + + + + + + 计算旋转矩形大小 + + + + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + + + + + 缩放 + + + 宽 + 高 + 插值算法 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 缩放 + + + 宽 + 高 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 根据原边长和新边长计算绘制的起始点坐标 + + + + + + + + 获取缩放模式 + + + + + + 是否裁剪图片 + + + + + 裁剪或填充 + + + + + 背景色 + 插值算法 + + Image 不能为 null + 操作失败 + + + + 裁剪 + + + 宽度 + 高度 + + 返回裁剪后的图片 + Image 不能为 null + 新的图片尺寸的宽度和高度必须大于零 + 操作失败 + + + + 调整宽度 + + + + + + + + 根据最大宽度调整图片尺寸 + + + 最大宽度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最大高度调整图片尺寸 + + + 最大高度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 调整高度 + + + + + + + + 调整图片大小 + + + + + + + + + + 调整图片大小 + + + + + + + + + + + 调整图片大小 + + + + + + + + + + + + + 转换Image为Icon + + 要转换为图标的Image对象 + 当image为null时是否返回null。false则抛空引用异常 + + + + + 缩放模式 + + + + + 宽度优先(不裁剪宽) + + + + + 高度优先(不裁剪高) + + + + + 水印位置 + + + + + 左上角 + + + + + 中上 + + + + + 右上角 + + + + + 左中 + + + + + 居中 + + + + + 右中 + + + + + 左下角 + + + + + 中下 + + + + + 右下角 + + + + + 全屏平铺 + + 音频播放类 @@ -2072,6 +2517,14 @@ 复制目标文件路径 + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) @@ -2186,6 +2639,20 @@ + + + 判断是否为空的文件夹 + + + + + + + 文件或文件夹是否存在 + + + + 判断文件名是否有效 @@ -2260,6 +2727,13 @@ + + + 以UTF-8格式写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + 从文件中加载图片,使用本方法，不会导致图片文件被占用。 @@ -2290,6 +2764,13 @@ + + + 根据文件大小字符串获取长整型表示的文件大小 + + + + 获取文件大小字符串 @@ -2451,7 +2932,7 @@ 判断是否是不带 BOM 的 UTF8 格式 - + @@ -2780,6 +3261,125 @@ 父窗体居中 + + + + + + + + + + + + + + + + + + + + + + + 设置线程数量 + + + + + 要计算的总数量 + + + + + 每个线程要计算的数量 + + + + + + + + + + 当前已使用的时间 + + + + + + + 线程数量 + 要计算的事务数量 + + + + + + + + + + + + + + + + + + + + + + + 多线程计算时激发 + + + + + 在所有线程执行完毕后发生 + + + + + 在线程执行完毕后发生,最后一个执行完毕的线程将不收到本事件通知 + + + + + 进程相关接口 + + + + + 获取进程路径 + + + + + + + 获取进程路径 + + + + + + + 获取命令行 + + + + + + + 获取命令行 + + + + 运行库检测类 @@ -6432,33 +7032,6 @@ The requested URL, such as "http://Myserver/Mypath/Myfile.asp". The XmlTextWriter to which you want to save to. - - Gets or sets the web browser timeout. - - - - Gets or sets the web browser delay. - - - Loads HTML using a WebBrowser and Application.DoEvents. - Thrown when an exception error condition occurs. - The requested URL, such as "http://html-agility-pack.net/". - A new HTML document. - - - Loads HTML using a WebBrowser and Application.DoEvents. - Thrown when an exception error condition occurs. - The requested URL, such as "http://html-agility-pack.net/". - (Optional) Check if the browser script has all been run and completed. - A new HTML document. - - - Loads HTML using a WebBrowser and Application.DoEvents. - Thrown when an exception error condition occurs. - The requested URL, such as "http://html-agility-pack.net/". - (Optional) Check if the browser script has all been run and completed. - A new HTML document. - Creates an instance of the given type from the specified Internet resource. @@ -6881,6 +7454,11 @@ + + + + + 使管理员方式运行时支持拖放 @@ -6930,6 +7508,80 @@ + + + + + + + + 获取WMI内容 + + + + + + + 获取WMI内容 + + + + + + + 获取内存信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取硬盘信息 + + + + + + 获取主板信息 + + + + + + 获取处理器信息 + + + + + + 获取主要硬件信息 + + + + + + 获取主要硬件信息 + + 是否获取XML格式 + + 网络操作类 @@ -7066,6 +7718,61 @@ 文件映射对象的名称 + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 删除内存映射 + + + + 写共享内存 @@ -7651,6 +8358,12 @@ 释放资源 + + + 最后一个错误信息 + + + @@ -7806,6 +8519,12 @@ + + + 获取最后一次错误信息 + + + @@ -8562,6 +9281,11 @@ 是否设置为全文小写，默认为不转化 + + + 获取或设置要在 HTTP 请求中使用的 Date HTTP 标头值。默认不填写 + + 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 @@ -8645,6 +9369,11 @@ item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); + + + 是否重置request,response的值，默认不重置，当设置为True时request,response将被设置为Null + + Http返回参数类 @@ -8819,6 +9548,11 @@ + + + + + @@ -8844,6 +9578,26 @@ + + + + + + + + + + + + + + + + + + + + @@ -8944,6 +9698,11 @@ + + + 是否自动跳转 + + 获取网页源码 @@ -8991,6 +9750,13 @@ + + + + + + + 将相对网址转换成绝对网址 @@ -8999,6 +9765,116 @@ 当前页面地址 转换后的绝对网址 + + + WebDav接口 + + + + + WebDav初始化 + + + + + + + + 删除文件 + + 相对路径,不包括域名 + + + + + 下载文件 + + + + + + + + 下载文件 + + + + + + + + + 上传文件 + + + + + + + + 上传文件 + + + + + + + + + 新建文件夹 + + + + + + + 新建文件夹 + + 文件夹路径 + + + + + + 新建文件夹 + + + + + + + + 将文件或目录列出来 + + + + + + + + 定义每个文件或目录的属性 + + + + + 文件名 + + + + + 是否是文件夹 + + + + + 网址 + + + + + 最后修改时间 + + @@ -10249,6 +11125,22 @@ + + + + + + + + + + + + + + + + @@ -10759,6 +11651,20 @@ + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 diff --git a/Bin/Debug/CommonControls/.NET4 示例/MyDb_SQLite.dll b/Bin/Debug/CommonControls/.NET4 示例/MyDb_SQLite.dll index 61db6a7..fa2c602 100644 Binary files a/Bin/Debug/CommonControls/.NET4 示例/MyDb_SQLite.dll and b/Bin/Debug/CommonControls/.NET4 示例/MyDb_SQLite.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/MyDb_SQLite.xml b/Bin/Debug/CommonControls/.NET4 示例/MyDb_SQLite.xml index 2fe5ccb..b80291c 100644 --- a/Bin/Debug/CommonControls/.NET4 示例/MyDb_SQLite.xml +++ b/Bin/Debug/CommonControls/.NET4 示例/MyDb_SQLite.xml @@ -213,6 +213,12 @@ + + + 获取最后一次错误信息 + + + diff --git a/Bin/Debug/CommonControls/.NET4 示例/MySql.Data.dll b/Bin/Debug/CommonControls/.NET4 示例/MySql.Data.dll new file mode 100644 index 0000000..10eb79b Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/MySql.Data.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/Newtonsoft.Json.dll b/Bin/Debug/CommonControls/.NET4 示例/Newtonsoft.Json.dll new file mode 100644 index 0000000..7af125a Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/Newtonsoft.Json.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/Newtonsoft.Json.xml b/Bin/Debug/CommonControls/.NET4 示例/Newtonsoft.Json.xml new file mode 100644 index 0000000..0cbf62c --- /dev/null +++ b/Bin/Debug/CommonControls/.NET4 示例/Newtonsoft.Json.xml @@ -0,0 +1,9646 @@ + + + + Newtonsoft.Json + + + + + Represents a BSON Oid (object id). + + + + + Gets or sets the value of the Oid. + + The value of the Oid. + + + + Initializes a new instance of the class. + + The Oid value. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. + + + + + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. + + + true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. + + + + + Gets or sets a value indicating whether the root object will be read as a JSON array. + + + true if the root object will be read as a JSON array; otherwise, false. + + + + + Gets or sets the used when reading values from BSON. + + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. + + + + + Gets or sets the used when writing values to BSON. + When set to no conversion will occur. + + The used when writing values to BSON. + + + + Initializes a new instance of the class. + + The to write to. + + + + Initializes a new instance of the class. + + The to write to. + + + + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. + + + + + Writes the end. + + The token. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + + + + Writes the beginning of a JSON array. + + + + + Writes the beginning of a JSON object. + + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value that represents a BSON object id. + + The Object ID value to write. + + + + Writes a BSON regex. + + The regex pattern. + The regex options. + + + + Specifies how constructors are used when initializing objects during deserialization by the . + + + + + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. + + + + + Json.NET will use a non-public default constructor before falling back to a parameterized constructor. + + + + + Converts a binary value to and from a base 64 string value. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Creates a custom object. + + The object type to convert. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Creates an object which will then be populated by the serializer. + + Type of the object. + The created object. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + + + + Provides a base class for converting a to and from JSON. + + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a F# discriminated union type to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an Entity Framework to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). + + + + + Gets or sets the date time styles used when converting a date to and from JSON. + + The date time styles used when converting a date to and from JSON. + + + + Gets or sets the date time format used when converting a date to and from JSON. + + The date time format used when converting a date to and from JSON. + + + + Gets or sets the culture used when converting a date to and from JSON. + + The culture used when converting a date to and from JSON. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from its name string value. + + + + + Gets or sets a value indicating whether the written enum text should be camel case. + The default value is false. + + true if the written enum text will be camel case; otherwise, false. + + + + Gets or sets the naming strategy used to resolve how enum text is written. + + The naming strategy used to resolve how enum text is written. + + + + Gets or sets a value indicating whether integer values are allowed when serializing and deserializing. + The default value is true. + + true if integers are allowed when serializing and deserializing; otherwise, false. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class. + + true if the written enum text will be camel case; otherwise, false. + + + + Initializes a new instance of the class. + + The naming strategy used to resolve how enum text is written. + true if integers are allowed when serializing and deserializing; otherwise, false. + + + + Initializes a new instance of the class. + + The of the used to write enum text. + + + + Initializes a new instance of the class. + + The of the used to write enum text. + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + + Initializes a new instance of the class. + + The of the used to write enum text. + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + true if integers are allowed when serializing and deserializing; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from Unix epoch time + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Converts a to and from a string (e.g. "1.2.3.4"). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts XML to and from JSON. + + + + + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. + + The name of the deserialized root element. + + + + Gets or sets a value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + true if the array attribute is written to the XML; otherwise, false. + + + + Gets or sets a value indicating whether to write the root JSON object. + + true if the JSON root object is omitted; otherwise, false. + + + + Gets or sets a value indicating whether to encode special characters when converting JSON to XML. + If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify + XML namespaces, attributes or processing directives. Instead special characters are encoded and written + as part of the XML element name. + + true if special characters are encoded; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The calling serializer. + The value. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Checks if the is a namespace attribute. + + Attribute name to test. + The attribute name prefix if it has one, otherwise an empty string. + true if attribute name is for a namespace attribute, otherwise false. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + + + + Specifies how dates are formatted when writing JSON text. + + + + + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + + + + + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + + + + + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + + + + + Date formatted strings are not parsed to a date type and are read as strings. + + + + + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + + + + + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + + + + + Specifies how to treat the time value when converting between string and . + + + + + Treat as local time. If the object represents a Coordinated Universal Time (UTC), it is converted to the local time. + + + + + Treat as a UTC. If the object represents a local time, it is converted to a UTC. + + + + + Treat as a local time if a is being converted to a string. + If a string is being converted to , convert to a local time if a time zone is specified. + + + + + Time zone information should be preserved when converting. + + + + + The default JSON name table implementation. + + + + + Initializes a new instance of the class. + + + + + Gets a string containing the same characters as the specified range of characters in the given array. + + The character array containing the name to find. + The zero-based index into the array specifying the first character of the name. + The number of characters in the name. + A string containing the same characters as the specified range of characters in the given array. + + + + Adds the specified string into name table. + + The string to add. + This method is not thread-safe. + The resolved string. + + + + Specifies default value handling options for the . + + + + + + + + + Include members where the member value is the same as the member's default value when serializing objects. + Included members are written to JSON. Has no effect when deserializing. + + + + + Ignore members where the member value is the same as the member's default value when serializing objects + so that it is not written to JSON. + This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, + decimals and floating point numbers; and false for booleans). The default value ignored can be changed by + placing the on the property. + + + + + Members with a default value but no JSON will be set to their default value when deserializing. + + + + + Ignore members where the member value is the same as the member's default value when serializing objects + and set members to their default value when deserializing. + + + + + Specifies float format handling options when writing special floating point numbers, e.g. , + and with . + + + + + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + + + + + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Note that this will produce non-valid JSON. + + + + + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. + + + + + Specifies how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + + + + + Floating point numbers are parsed to . + + + + + Floating point numbers are parsed to . + + + + + Specifies formatting options for the . + + + + + No special formatting is applied. This is the default. + + + + + Causes child objects to be indented according to the and settings. + + + + + Provides an interface for using pooled arrays. + + The array type content. + + + + Rent an array from the pool. This array must be returned when it is no longer needed. + + The minimum required length of the array. The returned array may be longer. + The rented array from the pool. This array must be returned when it is no longer needed. + + + + Return an array to the pool. + + The array that is being returned. + + + + Provides an interface to enable a class to return line and position information. + + + + + Gets a value indicating whether the class can return line information. + + + true if and can be provided; otherwise, false. + + + + + Gets the current line number. + + The current line number or 0 if no line information is available (for example, when returns false). + + + + Gets the current line position. + + The current line position or 0 if no line information is available (for example, when returns false). + + + + Instructs the how to serialize the collection. + + + + + Gets or sets a value indicating whether null items are allowed in the collection. + + true if null items are allowed in the collection; otherwise, false. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a flag indicating whether the array can contain null items. + + A flag indicating whether the array can contain null items. + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Instructs the to use the specified constructor when deserializing that object. + + + + + Instructs the how to serialize the object. + + + + + Gets or sets the id. + + The id. + + + + Gets or sets the title. + + The title. + + + + Gets or sets the description. + + The description. + + + + Gets or sets the collection's items converter. + + The collection's items converter. + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets the of the . + + The of the . + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets a value that indicates whether to preserve object references. + + + true to keep object reference; otherwise, false. The default is false. + + + + + Gets or sets a value that indicates whether to preserve collection's items references. + + + true to keep collection's items object references; otherwise, false. The default is false. + + + + + Gets or sets the reference loop handling used when serializing the collection's items. + + The reference loop handling. + + + + Gets or sets the type name handling used when serializing the collection's items. + + The type name handling. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Provides methods for converting between .NET types and JSON types. + + + + + + + + Gets or sets a function that creates default . + Default settings are automatically used by serialization methods on , + and and on . + To serialize without using any default settings create a with + . + + + + + Represents JavaScript's boolean value true as a string. This field is read-only. + + + + + Represents JavaScript's boolean value false as a string. This field is read-only. + + + + + Represents JavaScript's null as a string. This field is read-only. + + + + + Represents JavaScript's undefined as a string. This field is read-only. + + + + + Represents JavaScript's positive infinity as a string. This field is read-only. + + + + + Represents JavaScript's negative infinity as a string. This field is read-only. + + + + + Represents JavaScript's NaN as a string. This field is read-only. + + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation using the specified. + + The value to convert. + The format the date will be converted to. + The time zone handling when the date is converted to a string. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation using the specified. + + The value to convert. + The format the date will be converted to. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + The string delimiter character. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + The string delimiter character. + The string escape handling. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Serializes the specified object to a JSON string. + + The object to serialize. + A JSON string representation of the object. + + + + Serializes the specified object to a JSON string using formatting. + + The object to serialize. + Indicates how the output should be formatted. + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using a collection of . + + The object to serialize. + A collection of converters used while serializing. + A JSON string representation of the object. + + + + Serializes the specified object to a JSON string using formatting and a collection of . + + The object to serialize. + Indicates how the output should be formatted. + A collection of converters used while serializing. + A JSON string representation of the object. + + + + Serializes the specified object to a JSON string using . + + The object to serialize. + The used to serialize the object. + If this is null, default serialization settings will be used. + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using a type, formatting and . + + The object to serialize. + The used to serialize the object. + If this is null, default serialization settings will be used. + + The type of the value being serialized. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using formatting and . + + The object to serialize. + Indicates how the output should be formatted. + The used to serialize the object. + If this is null, default serialization settings will be used. + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using a type, formatting and . + + The object to serialize. + Indicates how the output should be formatted. + The used to serialize the object. + If this is null, default serialization settings will be used. + + The type of the value being serialized. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + A JSON string representation of the object. + + + + + Deserializes the JSON to a .NET object. + + The JSON to deserialize. + The deserialized object from the JSON string. + + + + Deserializes the JSON to a .NET object using . + + The JSON to deserialize. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type. + + The JSON to deserialize. + The of object being deserialized. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type. + + The type of the object to deserialize to. + The JSON to deserialize. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the given anonymous type. + + + The anonymous type to deserialize to. This can't be specified + traditionally and must be inferred from the anonymous type passed + as a parameter. + + The JSON to deserialize. + The anonymous type object. + The deserialized anonymous type from the JSON string. + + + + Deserializes the JSON to the given anonymous type using . + + + The anonymous type to deserialize to. This can't be specified + traditionally and must be inferred from the anonymous type passed + as a parameter. + + The JSON to deserialize. + The anonymous type object. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized anonymous type from the JSON string. + + + + Deserializes the JSON to the specified .NET type using a collection of . + + The type of the object to deserialize to. + The JSON to deserialize. + Converters to use while deserializing. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type using . + + The type of the object to deserialize to. + The object to deserialize. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type using a collection of . + + The JSON to deserialize. + The type of the object to deserialize. + Converters to use while deserializing. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type using . + + The JSON to deserialize. + The type of the object to deserialize to. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized object from the JSON string. + + + + Populates the object with values from the JSON string. + + The JSON to populate values from. + The target object to populate values onto. + + + + Populates the object with values from the JSON string using . + + The JSON to populate values from. + The target object to populate values onto. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + + + + Serializes the to a JSON string. + + The node to serialize. + A JSON string of the . + + + + Serializes the to a JSON string using formatting. + + The node to serialize. + Indicates how the output should be formatted. + A JSON string of the . + + + + Serializes the to a JSON string using formatting and omits the root object if is true. + + The node to serialize. + Indicates how the output should be formatted. + Omits writing the root object. + A JSON string of the . + + + + Deserializes the from a JSON string. + + The JSON string. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by . + + The JSON string. + The name of the root element to append when deserializing. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by , + writes a Json.NET array attribute for collections, and encodes special characters. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + + A value to indicate whether to encode special characters when converting JSON to XML. + If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify + XML namespaces, attributes or processing directives. Instead special characters are encoded and written + as part of the XML element name. + + The deserialized . + + + + Serializes the to a JSON string. + + The node to convert to JSON. + A JSON string of the . + + + + Serializes the to a JSON string using formatting. + + The node to convert to JSON. + Indicates how the output should be formatted. + A JSON string of the . + + + + Serializes the to a JSON string using formatting and omits the root object if is true. + + The node to serialize. + Indicates how the output should be formatted. + Omits writing the root object. + A JSON string of the . + + + + Deserializes the from a JSON string. + + The JSON string. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by . + + The JSON string. + The name of the root element to append when deserializing. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by , + writes a Json.NET array attribute for collections, and encodes special characters. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + + A value to indicate whether to encode special characters when converting JSON to XML. + If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify + XML namespaces, attributes or processing directives. Instead special characters are encoded and written + as part of the XML element name. + + The deserialized . + + + + Converts an object to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can read JSON. + + true if this can read JSON; otherwise, false. + + + + Gets a value indicating whether this can write JSON. + + true if this can write JSON; otherwise, false. + + + + Converts an object to and from JSON. + + The object type to convert. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. If there is no existing value then null will be used. + The existing value has a value. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Instructs the to use the specified when serializing the member or class. + + + + + Gets the of the . + + The of the . + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + + + + + Initializes a new instance of the class. + + Type of the . + + + + Initializes a new instance of the class. + + Type of the . + Parameter list to use when constructing the . Can be null. + + + + Represents a collection of . + + + + + Instructs the how to serialize the collection. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + The exception thrown when an error occurs during JSON serialization or deserialization. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Instructs the to deserialize properties with no matching class member into the specified collection + and write values during serialization. + + + + + Gets or sets a value that indicates whether to write extension data when serializing the object. + + + true to write extension data when serializing the object; otherwise, false. The default is true. + + + + + Gets or sets a value that indicates whether to read extension data when deserializing the object. + + + true to read extension data when deserializing the object; otherwise, false. The default is true. + + + + + Initializes a new instance of the class. + + + + + Instructs the not to serialize the public field or public read/write property value. + + + + + Base class for a table of atomized string objects. + + + + + Gets a string containing the same characters as the specified range of characters in the given array. + + The character array containing the name to find. + The zero-based index into the array specifying the first character of the name. + The number of characters in the name. + A string containing the same characters as the specified range of characters in the given array. + + + + Instructs the how to serialize the object. + + + + + Gets or sets the member serialization. + + The member serialization. + + + + Gets or sets the missing member handling used when deserializing this object. + + The missing member handling. + + + + Gets or sets how the object's properties with null values are handled during serialization and deserialization. + + How the object's properties with null values are handled during serialization and deserialization. + + + + Gets or sets a value that indicates whether the object's properties are required. + + + A value indicating whether the object's properties are required. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified member serialization. + + The member serialization. + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Instructs the to always serialize the member with the specified name. + + + + + Gets or sets the type used when serializing the property's collection items. + + The collection's items type. + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets the of the . + + The of the . + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets the null value handling used when serializing this property. + + The null value handling. + + + + Gets or sets the default value handling used when serializing this property. + + The default value handling. + + + + Gets or sets the reference loop handling used when serializing this property. + + The reference loop handling. + + + + Gets or sets the object creation handling used when deserializing this property. + + The object creation handling. + + + + Gets or sets the type name handling used when serializing this property. + + The type name handling. + + + + Gets or sets whether this property's value is serialized as a reference. + + Whether this property's value is serialized as a reference. + + + + Gets or sets the order of serialization of a member. + + The numeric order of serialization. + + + + Gets or sets a value indicating whether this property is required. + + + A value indicating whether this property is required. + + + + + Gets or sets the name of the property. + + The name of the property. + + + + Gets or sets the reference loop handling used when serializing the property's collection items. + + The collection's items reference loop handling. + + + + Gets or sets the type name handling used when serializing the property's collection items. + + The collection's items type name handling. + + + + Gets or sets whether this property's collection items are serialized as a reference. + + Whether this property's collection items are serialized as a reference. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified name. + + Name of the property. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + + + Specifies the state of the reader. + + + + + A read method has not been called. + + + + + The end of the file has been reached successfully. + + + + + Reader is at a property. + + + + + Reader is at the start of an object. + + + + + Reader is in an object. + + + + + Reader is at the start of an array. + + + + + Reader is in an array. + + + + + The method has been called. + + + + + Reader has just read a value. + + + + + Reader is at the start of a constructor. + + + + + Reader is in a constructor. + + + + + An error occurred that prevents the read operation from continuing. + + + + + The end of the file has been reached successfully. + + + + + Gets the current reader state. + + The current reader state. + + + + Gets or sets a value indicating whether the source should be closed when this reader is closed. + + + true to close the source when this reader is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether multiple pieces of JSON content can + be read from a continuous stream without erroring. + + + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. + + + + + Gets the quotation mark character used to enclose the value of a string. + + + + + Gets or sets how time zones are handled when reading JSON. + + + + + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + + + + + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + + + + + Gets or sets how custom date formatted strings are parsed when reading JSON. + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + + + + + Gets the type of the current JSON token. + + + + + Gets the text value of the current JSON token. + + + + + Gets the .NET type for the current JSON token. + + + + + Gets the depth of the current token in the JSON document. + + The depth of the current token in the JSON document. + + + + Gets the path of the current JSON token. + + + + + Gets or sets the culture used when reading JSON. Defaults to . + + + + + Initializes a new instance of the class. + + + + + Reads the next JSON token from the source. + + true if the next token was read successfully; false if there are no more tokens to read. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a []. + + A [] or null if the next JSON token is null. This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Skips the children of the current token. + + + + + Sets the current token. + + The new token. + + + + Sets the current token and value. + + The new token. + The value. + + + + Sets the current token and value. + + The new token. + The value. + A flag indicating whether the position index inside an array should be updated. + + + + Sets the state based on current token type. + + + + + Releases unmanaged and - optionally - managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Changes the reader's state to . + If is set to true, the source is also closed. + + + + + The exception thrown when an error occurs while reading JSON text. + + + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Initializes a new instance of the class + with a specified error message, JSON path, line number, line position, and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The path to the JSON where the error occurred. + The line number indicating where the error occurred. + The line position indicating where the error occurred. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Instructs the to always serialize the member, and to require that the member has a value. + + + + + The exception thrown when an error occurs during JSON serialization or deserialization. + + + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Initializes a new instance of the class + with a specified error message, JSON path, line number, line position, and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The path to the JSON where the error occurred. + The line number indicating where the error occurred. + The line position indicating where the error occurred. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Serializes and deserializes objects into and from the JSON format. + The enables you to control how objects are encoded into JSON. + + + + + Occurs when the errors during serialization and deserialization. + + + + + Gets or sets the used by the serializer when resolving references. + + + + + Gets or sets the used by the serializer when resolving type names. + + + + + Gets or sets the used by the serializer when resolving type names. + + + + + Gets or sets the used by the serializer when writing trace messages. + + The trace writer. + + + + Gets or sets the equality comparer used by the serializer when comparing references. + + The equality comparer. + + + + Gets or sets how type name writing and reading is handled by the serializer. + The default value is . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how object references are preserved by the serializer. + The default value is . + + + + + Gets or sets how reference loops (e.g. a class referencing itself) is handled. + The default value is . + + + + + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + The default value is . + + + + + Gets or sets how null values are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how default values are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how objects are created during deserialization. + The default value is . + + The object creation handling. + + + + Gets or sets how constructors are used during deserialization. + The default value is . + + The constructor handling. + + + + Gets or sets how metadata properties are used during deserialization. + The default value is . + + The metadata properties handling. + + + + Gets a collection that will be used during serialization. + + Collection that will be used during serialization. + + + + Gets or sets the contract resolver used by the serializer when + serializing .NET objects to JSON and vice versa. + + + + + Gets or sets the used by the serializer when invoking serialization callback methods. + + The context. + + + + Indicates how JSON text output is formatted. + The default value is . + + + + + Gets or sets how dates are written to JSON text. + The default value is . + + + + + Gets or sets how time zones are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + The default value is . + + + + + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + The default value is . + + + + + Gets or sets how special floating point numbers, e.g. , + and , + are written as JSON text. + The default value is . + + + + + Gets or sets how strings are escaped when writing JSON text. + The default value is . + + + + + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. + The default value is "yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK". + + + + + Gets or sets the culture used when reading JSON. + The default value is . + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + A null value means there is no maximum. + The default value is null. + + + + + Gets a value indicating whether there will be a check for additional JSON content after deserializing an object. + The default value is false. + + + true if there will be a check for additional JSON content after deserializing an object; otherwise, false. + + + + + Initializes a new instance of the class. + + + + + Creates a new instance. + The will not use default settings + from . + + + A new instance. + The will not use default settings + from . + + + + + Creates a new instance using the specified . + The will not use default settings + from . + + The settings to be applied to the . + + A new instance using the specified . + The will not use default settings + from . + + + + + Creates a new instance. + The will use default settings + from . + + + A new instance. + The will use default settings + from . + + + + + Creates a new instance using the specified . + The will use default settings + from as well as the specified . + + The settings to be applied to the . + + A new instance using the specified . + The will use default settings + from as well as the specified . + + + + + Populates the JSON values onto the target object. + + The that contains the JSON structure to read values from. + The target object to populate values onto. + + + + Populates the JSON values onto the target object. + + The that contains the JSON structure to read values from. + The target object to populate values onto. + + + + Deserializes the JSON structure contained by the specified . + + The that contains the JSON structure to deserialize. + The being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The of object being deserialized. + The instance of being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The type of the object to deserialize. + The instance of being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The of object being deserialized. + The instance of being deserialized. + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + The type of the value being serialized. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + The type of the value being serialized. + This parameter is used when is Auto to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + + + Specifies the settings on a object. + + + + + Gets or sets how reference loops (e.g. a class referencing itself) are handled. + The default value is . + + Reference loop handling. + + + + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + The default value is . + + Missing member handling. + + + + Gets or sets how objects are created during deserialization. + The default value is . + + The object creation handling. + + + + Gets or sets how null values are handled during serialization and deserialization. + The default value is . + + Null value handling. + + + + Gets or sets how default values are handled during serialization and deserialization. + The default value is . + + The default value handling. + + + + Gets or sets a collection that will be used during serialization. + + The converters. + + + + Gets or sets how object references are preserved by the serializer. + The default value is . + + The preserve references handling. + + + + Gets or sets how type name writing and reading is handled by the serializer. + The default value is . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + The type name handling. + + + + Gets or sets how metadata properties are used during deserialization. + The default value is . + + The metadata properties handling. + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how constructors are used during deserialization. + The default value is . + + The constructor handling. + + + + Gets or sets the contract resolver used by the serializer when + serializing .NET objects to JSON and vice versa. + + The contract resolver. + + + + Gets or sets the equality comparer used by the serializer when comparing references. + + The equality comparer. + + + + Gets or sets the used by the serializer when resolving references. + + The reference resolver. + + + + Gets or sets a function that creates the used by the serializer when resolving references. + + A function that creates the used by the serializer when resolving references. + + + + Gets or sets the used by the serializer when writing trace messages. + + The trace writer. + + + + Gets or sets the used by the serializer when resolving type names. + + The binder. + + + + Gets or sets the used by the serializer when resolving type names. + + The binder. + + + + Gets or sets the error handler called during serialization and deserialization. + + The error handler called during serialization and deserialization. + + + + Gets or sets the used by the serializer when invoking serialization callback methods. + + The context. + + + + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. + The default value is "yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK". + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + A null value means there is no maximum. + The default value is null. + + + + + Indicates how JSON text output is formatted. + The default value is . + + + + + Gets or sets how dates are written to JSON text. + The default value is . + + + + + Gets or sets how time zones are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + The default value is . + + + + + Gets or sets how special floating point numbers, e.g. , + and , + are written as JSON. + The default value is . + + + + + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + The default value is . + + + + + Gets or sets how strings are escaped when writing JSON text. + The default value is . + + + + + Gets or sets the culture used when reading JSON. + The default value is . + + + + + Gets a value indicating whether there will be a check for additional content after deserializing an object. + The default value is false. + + + true if there will be a check for additional content after deserializing an object; otherwise, false. + + + + + Initializes a new instance of the class. + + + + + Represents a reader that provides fast, non-cached, forward-only access to JSON text data. + + + + + Initializes a new instance of the class with the specified . + + The containing the JSON data to read. + + + + Gets or sets the reader's property name table. + + + + + Gets or sets the reader's character buffer pool. + + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a []. + + A [] or null if the next JSON token is null. This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Gets a value indicating whether the class can return line information. + + + true if and can be provided; otherwise, false. + + + + + Gets the current line number. + + + The current line number or 0 if no line information is available (for example, returns false). + + + + + Gets the current line position. + + + The current line position or 0 if no line information is available (for example, returns false). + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets or sets the writer's character array pool. + + + + + Gets or sets how many s to write for each level in the hierarchy when is set to . + + + + + Gets or sets which character to use to quote attribute values. + + + + + Gets or sets which character to use for indenting when is set to . + + + + + Gets or sets a value indicating whether object names will be surrounded with quotes. + + + + + Initializes a new instance of the class using the specified . + + The to write to. + + + + Flushes whatever is in the buffer to the underlying and also flushes the underlying . + + + + + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes the beginning of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the specified end token. + + The end token to write. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + + + + Writes indent characters. + + + + + Writes the JSON value delimiter. + + + + + Writes an indent space. + + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a value. + + The value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the given white space. + + The string of white space characters. + + + + Specifies the type of JSON token. + + + + + This is returned by the if a read method has not been called. + + + + + An object start token. + + + + + An array start token. + + + + + A constructor start token. + + + + + An object property name. + + + + + A comment. + + + + + Raw JSON. + + + + + An integer. + + + + + A float. + + + + + A string. + + + + + A boolean. + + + + + A null token. + + + + + An undefined token. + + + + + An object end token. + + + + + An array end token. + + + + + A constructor end token. + + + + + A Date. + + + + + Byte data. + + + + + + Represents a reader that provides validation. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Sets an event handler for receiving schema validation errors. + + + + + Gets the text value of the current JSON token. + + + + + + Gets the depth of the current token in the JSON document. + + The depth of the current token in the JSON document. + + + + Gets the path of the current JSON token. + + + + + Gets the quotation mark character used to enclose the value of a string. + + + + + + Gets the type of the current JSON token. + + + + + + Gets the .NET type for the current JSON token. + + + + + + Initializes a new instance of the class that + validates the content returned from the given . + + The to read from while validating. + + + + Gets or sets the schema. + + The schema. + + + + Gets the used to construct this . + + The specified in the constructor. + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a []. + + + A [] or null if the next JSON token is null. + + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets or sets a value indicating whether the destination should be closed when this writer is closed. + + + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. + + + + + Gets the top. + + The top. + + + + Gets the state of the writer. + + + + + Gets the path of the writer. + + + + + Gets or sets a value indicating how JSON text output should be formatted. + + + + + Gets or sets how dates are written to JSON text. + + + + + Gets or sets how time zones are handled when writing JSON text. + + + + + Gets or sets how strings are escaped when writing JSON text. + + + + + Gets or sets how special floating point numbers, e.g. , + and , + are written to JSON text. + + + + + Gets or sets how and values are formatted when writing JSON text. + + + + + Gets or sets the culture used when writing JSON. Defaults to . + + + + + Initializes a new instance of the class. + + + + + Flushes whatever is in the buffer to the destination and also flushes the destination. + + + + + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes the beginning of a JSON object. + + + + + Writes the end of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the end of an array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the end constructor. + + + + + Writes the property name of a name/value pair of a JSON object. + + The name of the property. + + + + Writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + + + + Writes the end of the current JSON object or array. + + + + + Writes the current token and its children. + + The to read the token from. + + + + Writes the current token. + + The to read the token from. + A flag indicating whether the current token's children should be written. + + + + Writes the token and its value. + + The to write. + + The value to write. + A value is only required for tokens that have an associated value, e.g. the property name for . + null can be passed to the method for tokens that don't have a value, e.g. . + + + + + Writes the token. + + The to write. + + + + Writes the specified end token. + + The end token to write. + + + + Writes indent characters. + + + + + Writes the JSON value delimiter. + + + + + Writes an indent space. + + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON without changing the writer's state. + + The raw JSON to write. + + + + Writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the given white space. + + The string of white space characters. + + + + Releases unmanaged and - optionally - managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Sets the state of the . + + The being written. + The value being written. + + + + The exception thrown when an error occurs while writing JSON text. + + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Initializes a new instance of the class + with a specified error message, JSON path and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The path to the JSON where the error occurred. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Specifies how JSON comments are handled when loading JSON. + + + + + Ignore comments. + + + + + Load comments as a with type . + + + + + Specifies how duplicate property names are handled when loading JSON. + + + + + Replace the existing value when there is a duplicate property. The value of the last property in the JSON object will be used. + + + + + Ignore the new value when there is a duplicate property. The value of the first property in the JSON object will be used. + + + + + Throw a when a duplicate property is encountered. + + + + + Contains the LINQ to JSON extension methods. + + + + + Returns a collection of tokens that contains the ancestors of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains the ancestors of every token in the source collection. + + + + Returns a collection of tokens that contains every token in the source collection, and the ancestors of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains every token in the source collection, the ancestors of every token in the source collection. + + + + Returns a collection of tokens that contains the descendants of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains the descendants of every token in the source collection. + + + + Returns a collection of tokens that contains every token in the source collection, and the descendants of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains every token in the source collection, and the descendants of every token in the source collection. + + + + Returns a collection of child properties of every object in the source collection. + + An of that contains the source collection. + An of that contains the properties of every object in the source collection. + + + + Returns a collection of child values of every object in the source collection with the given key. + + An of that contains the source collection. + The token key. + An of that contains the values of every token in the source collection with the given key. + + + + Returns a collection of child values of every object in the source collection. + + An of that contains the source collection. + An of that contains the values of every token in the source collection. + + + + Returns a collection of converted child values of every object in the source collection with the given key. + + The type to convert the values to. + An of that contains the source collection. + The token key. + An that contains the converted values of every token in the source collection with the given key. + + + + Returns a collection of converted child values of every object in the source collection. + + The type to convert the values to. + An of that contains the source collection. + An that contains the converted values of every token in the source collection. + + + + Converts the value. + + The type to convert the value to. + A cast as a of . + A converted value. + + + + Converts the value. + + The source collection type. + The type to convert the value to. + A cast as a of . + A converted value. + + + + Returns a collection of child tokens of every array in the source collection. + + The source collection type. + An of that contains the source collection. + An of that contains the values of every token in the source collection. + + + + Returns a collection of converted child tokens of every array in the source collection. + + An of that contains the source collection. + The type to convert the values to. + The source collection type. + An that contains the converted values of every token in the source collection. + + + + Returns the input typed as . + + An of that contains the source collection. + The input typed as . + + + + Returns the input typed as . + + The source collection type. + An of that contains the source collection. + The input typed as . + + + + Represents a collection of objects. + + The type of token. + + + + Gets the of with the specified key. + + + + + + Represents a JSON array. + + + + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified content. + + The contents of the array. + + + + Initializes a new instance of the class with the specified content. + + The contents of the array. + + + + Loads an from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads an from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + + + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + + + + + + Creates a from an object. + + The object that will be used to create . + A with the values of the specified object. + + + + Creates a from an object. + + The object that will be used to create . + The that will be used to read the object. + A with the values of the specified object. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets or sets the at the specified index. + + + + + + Determines the index of a specific item in the . + + The object to locate in the . + + The index of if found in the list; otherwise, -1. + + + + + Inserts an item to the at the specified index. + + The zero-based index at which should be inserted. + The object to insert into the . + + is not a valid index in the . + + + + + Removes the item at the specified index. + + The zero-based index of the item to remove. + + is not a valid index in the . + + + + + Returns an enumerator that iterates through the collection. + + + A of that can be used to iterate through the collection. + + + + + Adds an item to the . + + The object to add to the . + + + + Removes all items from the . + + + + + Determines whether the contains a specific value. + + The object to locate in the . + + true if is found in the ; otherwise, false. + + + + + Copies the elements of the to an array, starting at a particular array index. + + The array. + Index of the array. + + + + Gets a value indicating whether the is read-only. + + true if the is read-only; otherwise, false. + + + + Removes the first occurrence of a specific object from the . + + The object to remove from the . + + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + + + + + Represents a JSON constructor. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets or sets the name of this constructor. + + The constructor name. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified name and content. + + The constructor name. + The contents of the constructor. + + + + Initializes a new instance of the class with the specified name and content. + + The constructor name. + The contents of the constructor. + + + + Initializes a new instance of the class with the specified name. + + The constructor name. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified key. + + The with the specified key. + + + + Loads a from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Represents a token that can contain other tokens. + + + + + Occurs when the list changes or an item in the list changes. + + + + + Occurs before an item is added to the collection. + + + + + Occurs when the items list of the collection has changed, or the collection is reset. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Raises the event. + + The instance containing the event data. + + + + Raises the event. + + The instance containing the event data. + + + + Raises the event. + + The instance containing the event data. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Get the first child token of this token. + + + A containing the first child token of the . + + + + + Get the last child token of this token. + + + A containing the last child token of the . + + + + + Returns a collection of the child tokens of this token, in document order. + + + An of containing the child tokens of this , in document order. + + + + + Returns a collection of the child values of this token, in document order. + + The type to convert the values to. + + A containing the child values of this , in document order. + + + + + Returns a collection of the descendant tokens for this token in document order. + + An of containing the descendant tokens of the . + + + + Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. + + An of containing this token, and all the descendant tokens of the . + + + + Adds the specified content as children of this . + + The content to be added. + + + + Adds the specified content as the first children of this . + + The content to be added. + + + + Creates a that can be used to add tokens to the . + + A that is ready to have content written to it. + + + + Replaces the child nodes of this token with the specified content. + + The content. + + + + Removes the child nodes from this token. + + + + + Merge the specified content into this . + + The content to be merged. + + + + Merge the specified content into this using . + + The content to be merged. + The used to merge the content. + + + + Gets the count of child JSON tokens. + + The count of child JSON tokens. + + + + Represents a collection of objects. + + The type of token. + + + + An empty collection of objects. + + + + + Initializes a new instance of the struct. + + The enumerable. + + + + Returns an enumerator that can be used to iterate through the collection. + + + A that can be used to iterate through the collection. + + + + + Gets the of with the specified key. + + + + + + Determines whether the specified is equal to this instance. + + The to compare with this instance. + + true if the specified is equal to this instance; otherwise, false. + + + + + Determines whether the specified is equal to this instance. + + The to compare with this instance. + + true if the specified is equal to this instance; otherwise, false. + + + + + Returns a hash code for this instance. + + + A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table. + + + + + Represents a JSON object. + + + + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Occurs when a property value changes. + + + + + Occurs when a property value is changing. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified content. + + The contents of the object. + + + + Initializes a new instance of the class with the specified content. + + The contents of the object. + + + + Gets the node type for this . + + The type. + + + + Gets an of of this object's properties. + + An of of this object's properties. + + + + Gets a with the specified name. + + The property name. + A with the specified name or null. + + + + Gets the with the specified name. + The exact name will be searched for first and if no matching property is found then + the will be used to match a property. + + The property name. + One of the enumeration values that specifies how the strings will be compared. + A matched with the specified name or null. + + + + Gets a of of this object's property values. + + A of of this object's property values. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets or sets the with the specified property name. + + + + + + Loads a from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + is not valid JSON. + + + + + Loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + is not valid JSON. + + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + is not valid JSON. + + + + + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + is not valid JSON. + + + + + + + + Creates a from an object. + + The object that will be used to create . + A with the values of the specified object. + + + + Creates a from an object. + + The object that will be used to create . + The that will be used to read the object. + A with the values of the specified object. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified property name. + + Name of the property. + The with the specified property name. + + + + Gets the with the specified property name. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + Name of the property. + One of the enumeration values that specifies how the strings will be compared. + The with the specified property name. + + + + Tries to get the with the specified property name. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + Name of the property. + The value. + One of the enumeration values that specifies how the strings will be compared. + true if a value was successfully retrieved; otherwise, false. + + + + Adds the specified property name. + + Name of the property. + The value. + + + + Determines whether the JSON object has the specified property name. + + Name of the property. + true if the JSON object has the specified property name; otherwise, false. + + + + Removes the property with the specified name. + + Name of the property. + true if item was successfully removed; otherwise, false. + + + + Tries to get the with the specified property name. + + Name of the property. + The value. + true if a value was successfully retrieved; otherwise, false. + + + + Returns an enumerator that can be used to iterate through the collection. + + + A that can be used to iterate through the collection. + + + + + Raises the event with the provided arguments. + + Name of the property. + + + + Raises the event with the provided arguments. + + Name of the property. + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Represents a JSON property. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets the property name. + + The property name. + + + + Gets or sets the property value. + + The property value. + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + The property name. + The property content. + + + + Initializes a new instance of the class. + + The property name. + The property content. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Loads a from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Represents a view of a . + + + + + Initializes a new instance of the class. + + The name. + + + + When overridden in a derived class, returns whether resetting an object changes its value. + + + true if resetting the component changes its value; otherwise, false. + + The component to test for reset capability. + + + + When overridden in a derived class, gets the current value of the property on a component. + + + The value of a property for a given component. + + The component with the property for which to retrieve the value. + + + + When overridden in a derived class, resets the value for this property of the component to the default value. + + The component with the property value that is to be reset to the default value. + + + + When overridden in a derived class, sets the value of the component to a different value. + + The component with the property value that is to be set. + The new value. + + + + When overridden in a derived class, determines a value indicating whether the value of this property needs to be persisted. + + + true if the property should be persisted; otherwise, false. + + The component with the property to be examined for persistence. + + + + When overridden in a derived class, gets the type of the component this property is bound to. + + + A that represents the type of component this property is bound to. + When the or + + methods are invoked, the object specified might be an instance of this type. + + + + + When overridden in a derived class, gets a value indicating whether this property is read-only. + + + true if the property is read-only; otherwise, false. + + + + + When overridden in a derived class, gets the type of the property. + + + A that represents the type of the property. + + + + + Gets the hash code for the name of the member. + + + + The hash code for the name of the member. + + + + + Represents a raw JSON string. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class. + + The raw json. + + + + Creates an instance of with the content of the reader's current token. + + The reader. + An instance of with the content of the reader's current token. + + + + Specifies the settings used when loading JSON. + + + + + Initializes a new instance of the class. + + + + + Gets or sets how JSON comments are handled when loading JSON. + The default value is . + + The JSON comment handling. + + + + Gets or sets how JSON line info is handled when loading JSON. + The default value is . + + The JSON line info handling. + + + + Gets or sets how duplicate property names in JSON objects are handled when loading JSON. + The default value is . + + The JSON duplicate property name handling. + + + + Specifies the settings used when merging JSON. + + + + + Initializes a new instance of the class. + + + + + Gets or sets the method used when merging JSON arrays. + + The method used when merging JSON arrays. + + + + Gets or sets how null value properties are merged. + + How null value properties are merged. + + + + Gets or sets the comparison used to match property names while merging. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + The comparison used to match property names while merging. + + + + Represents an abstract JSON token. + + + + + Gets a comparer that can compare two tokens for value equality. + + A that can compare two nodes for value equality. + + + + Gets or sets the parent. + + The parent. + + + + Gets the root of this . + + The root of this . + + + + Gets the node type for this . + + The type. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Compares the values of two tokens, including the values of all descendant tokens. + + The first to compare. + The second to compare. + true if the tokens are equal; otherwise false. + + + + Gets the next sibling token of this node. + + The that contains the next sibling token. + + + + Gets the previous sibling token of this node. + + The that contains the previous sibling token. + + + + Gets the path of the JSON token. + + + + + Adds the specified content immediately after this token. + + A content object that contains simple content or a collection of content objects to be added after this token. + + + + Adds the specified content immediately before this token. + + A content object that contains simple content or a collection of content objects to be added before this token. + + + + Returns a collection of the ancestor tokens of this token. + + A collection of the ancestor tokens of this token. + + + + Returns a collection of tokens that contain this token, and the ancestors of this token. + + A collection of tokens that contain this token, and the ancestors of this token. + + + + Returns a collection of the sibling tokens after this token, in document order. + + A collection of the sibling tokens after this tokens, in document order. + + + + Returns a collection of the sibling tokens before this token, in document order. + + A collection of the sibling tokens before this token, in document order. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets the with the specified key converted to the specified type. + + The type to convert the token to. + The token key. + The converted token value. + + + + Get the first child token of this token. + + A containing the first child token of the . + + + + Get the last child token of this token. + + A containing the last child token of the . + + + + Returns a collection of the child tokens of this token, in document order. + + An of containing the child tokens of this , in document order. + + + + Returns a collection of the child tokens of this token, in document order, filtered by the specified type. + + The type to filter the child tokens on. + A containing the child tokens of this , in document order. + + + + Returns a collection of the child values of this token, in document order. + + The type to convert the values to. + A containing the child values of this , in document order. + + + + Removes this token from its parent. + + + + + Replaces this token with the specified token. + + The value. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Returns the indented JSON for this token. + + + ToString() returns a non-JSON string value for tokens with a type of . + If you want the JSON for all token types then you should use . + + + The indented JSON for this token. + + + + + Returns the JSON for this token using the given formatting and converters. + + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. + The JSON for this token using the given formatting and converters. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to []. + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from [] to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Creates a for this token. + + A that can be used to read this token and its descendants. + + + + Creates a from an object. + + The object that will be used to create . + A with the value of the specified object. + + + + Creates a from an object using the specified . + + The object that will be used to create . + The that will be used when reading the object. + A with the value of the specified object. + + + + Creates an instance of the specified .NET type from the . + + The object type that the token will be deserialized to. + The new object created from the JSON value. + + + + Creates an instance of the specified .NET type from the . + + The object type that the token will be deserialized to. + The new object created from the JSON value. + + + + Creates an instance of the specified .NET type from the using the specified . + + The object type that the token will be deserialized to. + The that will be used when creating the object. + The new object created from the JSON value. + + + + Creates an instance of the specified .NET type from the using the specified . + + The object type that the token will be deserialized to. + The that will be used when creating the object. + The new object created from the JSON value. + + + + Creates a from a . + + A positioned at the token to read into this . + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Creates a from a . + + An positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + + + Creates a from a . + + A positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Creates a from a . + + A positioned at the token to read into this . + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Selects a using a JSONPath expression. Selects the token that matches the object path. + + + A that contains a JSONPath expression. + + A , or null. + + + + Selects a using a JSONPath expression. Selects the token that matches the object path. + + + A that contains a JSONPath expression. + + A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. + A . + + + + Selects a collection of elements using a JSONPath expression. + + + A that contains a JSONPath expression. + + An of that contains the selected elements. + + + + Selects a collection of elements using a JSONPath expression. + + + A that contains a JSONPath expression. + + A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. + An of that contains the selected elements. + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Creates a new instance of the . All child tokens are recursively cloned. + + A new instance of the . + + + + Adds an object to the annotation list of this . + + The annotation to add. + + + + Get the first annotation object of the specified type from this . + + The type of the annotation to retrieve. + The first annotation object that matches the specified type, or null if no annotation is of the specified type. + + + + Gets the first annotation object of the specified type from this . + + The of the annotation to retrieve. + The first annotation object that matches the specified type, or null if no annotation is of the specified type. + + + + Gets a collection of annotations of the specified type for this . + + The type of the annotations to retrieve. + An that contains the annotations for this . + + + + Gets a collection of annotations of the specified type for this . + + The of the annotations to retrieve. + An of that contains the annotations that match the specified type for this . + + + + Removes the annotations of the specified type from this . + + The type of annotations to remove. + + + + Removes the annotations of the specified type from this . + + The of annotations to remove. + + + + Compares tokens to determine whether they are equal. + + + + + Determines whether the specified objects are equal. + + The first object of type to compare. + The second object of type to compare. + + true if the specified objects are equal; otherwise, false. + + + + + Returns a hash code for the specified object. + + The for which a hash code is to be returned. + A hash code for the specified object. + The type of is a reference type and is null. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + + + Gets the at the reader's current position. + + + + + Initializes a new instance of the class. + + The token to read from. + + + + Initializes a new instance of the class. + + The token to read from. + The initial path of the token. It is prepended to the returned . + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Gets the path of the current JSON token. + + + + + Specifies the type of token. + + + + + No token type has been set. + + + + + A JSON object. + + + + + A JSON array. + + + + + A JSON constructor. + + + + + A JSON object property. + + + + + A comment. + + + + + An integer value. + + + + + A float value. + + + + + A string value. + + + + + A boolean value. + + + + + A null value. + + + + + An undefined value. + + + + + A date value. + + + + + A raw JSON value. + + + + + A collection of bytes value. + + + + + A Guid value. + + + + + A Uri value. + + + + + A TimeSpan value. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets the at the writer's current position. + + + + + Gets the token being written. + + The token being written. + + + + Initializes a new instance of the class writing to the given . + + The container being written to. + + + + Initializes a new instance of the class. + + + + + Flushes whatever is in the buffer to the underlying . + + + + + Closes this writer. + If is set to true, the JSON is auto-completed. + + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + + + + + Writes the beginning of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the end. + + The token. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Writes a value. + An error will be raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Represents a value in JSON (string, integer, date, etc). + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Creates a comment with the given value. + + The value. + A comment with the given value. + + + + Creates a string with the given value. + + The value. + A string with the given value. + + + + Creates a null value. + + A null value. + + + + Creates a undefined value. + + A undefined value. + + + + Gets the node type for this . + + The type. + + + + Gets or sets the underlying token value. + + The underlying token value. + + + + Writes this token to a . + + A into which this method will write. + A collection of s which will be used when writing the token. + + + + Indicates whether the current object is equal to another object of the same type. + + + true if the current object is equal to the parameter; otherwise, false. + + An object to compare with this object. + + + + Determines whether the specified is equal to the current . + + The to compare with the current . + + true if the specified is equal to the current ; otherwise, false. + + + + + Serves as a hash function for a particular type. + + + A hash code for the current . + + + + + Returns a that represents this instance. + + + ToString() returns a non-JSON string value for tokens with a type of . + If you want the JSON for all token types then you should use . + + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format. + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format provider. + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format. + The format provider. + + A that represents this instance. + + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object. + + An object to compare with this instance. + + A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has these meanings: + Value + Meaning + Less than zero + This instance is less than . + Zero + This instance is equal to . + Greater than zero + This instance is greater than . + + + is not of the same type as this instance. + + + + + Specifies how line information is handled when loading JSON. + + + + + Ignore line information. + + + + + Load line information. + + + + + Specifies how JSON arrays are merged together. + + + + Concatenate arrays. + + + Union arrays, skipping items that already exist. + + + Replace all array items. + + + Merge array items together, matched by index. + + + + Specifies how null value properties are merged. + + + + + The content's null value properties will be ignored during merging. + + + + + The content's null value properties will be merged. + + + + + Specifies the member serialization options for the . + + + + + All public members are serialized by default. Members can be excluded using or . + This is the default member serialization mode. + + + + + Only members marked with or are serialized. + This member serialization mode can also be set by marking the class with . + + + + + All public and private fields are serialized. Members can be excluded using or . + This member serialization mode can also be set by marking the class with + and setting IgnoreSerializableAttribute on to false. + + + + + Specifies metadata property handling options for the . + + + + + Read metadata properties located at the start of a JSON object. + + + + + Read metadata properties located anywhere in a JSON object. Note that this setting will impact performance. + + + + + Do not try to read metadata properties. + + + + + Specifies missing member handling options for the . + + + + + Ignore a missing member and do not attempt to deserialize it. + + + + + Throw a when a missing member is encountered during deserialization. + + + + + Specifies null value handling options for the . + + + + + + + + + Include null values when serializing and deserializing objects. + + + + + Ignore null values when serializing and deserializing objects. + + + + + Specifies how object creation is handled by the . + + + + + Reuse existing objects, create new objects when needed. + + + + + Only reuse existing objects. + + + + + Always create new objects. + + + + + Specifies reference handling options for the . + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . + + + + + + + + Do not preserve references when serializing types. + + + + + Preserve references when serializing into a JSON object structure. + + + + + Preserve references when serializing into a JSON array structure. + + + + + Preserve references when serializing. + + + + + Specifies reference loop handling options for the . + + + + + Throw a when a loop is encountered. + + + + + Ignore loop references and do not serialize. + + + + + Serialize loop references. + + + + + Indicating whether a property is required. + + + + + The property is not required. The default state. + + + + + The property must be defined in JSON but can be a null value. + + + + + The property must be defined in JSON and cannot be a null value. + + + + + The property is not required but it cannot be a null value. + + + + + + Contains the JSON schema extension methods. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + + Determines whether the is valid. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + + true if the specified is valid; otherwise, false. + + + + + + Determines whether the is valid. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + When this method returns, contains any error messages generated while validating. + + true if the specified is valid; otherwise, false. + + + + + + Validates the specified . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + + + + + Validates the specified . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + The validation event handler. + + + + + An in-memory representation of a JSON Schema. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets or sets the id. + + + + + Gets or sets the title. + + + + + Gets or sets whether the object is required. + + + + + Gets or sets whether the object is read-only. + + + + + Gets or sets whether the object is visible to users. + + + + + Gets or sets whether the object is transient. + + + + + Gets or sets the description of the object. + + + + + Gets or sets the types of values allowed by the object. + + The type. + + + + Gets or sets the pattern. + + The pattern. + + + + Gets or sets the minimum length. + + The minimum length. + + + + Gets or sets the maximum length. + + The maximum length. + + + + Gets or sets a number that the value should be divisible by. + + A number that the value should be divisible by. + + + + Gets or sets the minimum. + + The minimum. + + + + Gets or sets the maximum. + + The maximum. + + + + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). + + A flag indicating whether the value can not equal the number defined by the minimum attribute (). + + + + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). + + A flag indicating whether the value can not equal the number defined by the maximum attribute (). + + + + Gets or sets the minimum number of items. + + The minimum number of items. + + + + Gets or sets the maximum number of items. + + The maximum number of items. + + + + Gets or sets the of items. + + The of items. + + + + Gets or sets a value indicating whether items in an array are validated using the instance at their array position from . + + + true if items are validated using their array position; otherwise, false. + + + + + Gets or sets the of additional items. + + The of additional items. + + + + Gets or sets a value indicating whether additional items are allowed. + + + true if additional items are allowed; otherwise, false. + + + + + Gets or sets whether the array items must be unique. + + + + + Gets or sets the of properties. + + The of properties. + + + + Gets or sets the of additional properties. + + The of additional properties. + + + + Gets or sets the pattern properties. + + The pattern properties. + + + + Gets or sets a value indicating whether additional properties are allowed. + + + true if additional properties are allowed; otherwise, false. + + + + + Gets or sets the required property if this property is present. + + The required property if this property is present. + + + + Gets or sets the a collection of valid enum values allowed. + + A collection of valid enum values allowed. + + + + Gets or sets disallowed types. + + The disallowed types. + + + + Gets or sets the default value. + + The default value. + + + + Gets or sets the collection of that this schema extends. + + The collection of that this schema extends. + + + + Gets or sets the format. + + The format. + + + + Initializes a new instance of the class. + + + + + Reads a from the specified . + + The containing the JSON Schema to read. + The object representing the JSON Schema. + + + + Reads a from the specified . + + The containing the JSON Schema to read. + The to use when resolving schema references. + The object representing the JSON Schema. + + + + Load a from a string that contains JSON Schema. + + A that contains JSON Schema. + A populated from the string that contains JSON Schema. + + + + Load a from a string that contains JSON Schema using the specified . + + A that contains JSON Schema. + The resolver. + A populated from the string that contains JSON Schema. + + + + Writes this schema to a . + + A into which this method will write. + + + + Writes this schema to a using the specified . + + A into which this method will write. + The resolver used. + + + + Returns a that represents the current . + + + A that represents the current . + + + + + + Returns detailed information about the schema exception. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + + Generates a from a specified . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets or sets how undefined schemas are handled by the serializer. + + + + + Gets or sets the contract resolver. + + The contract resolver. + + + + Generate a from the specified type. + + The type to generate a from. + A generated from the specified type. + + + + Generate a from the specified type. + + The type to generate a from. + The used to resolve schema references. + A generated from the specified type. + + + + Generate a from the specified type. + + The type to generate a from. + Specify whether the generated root will be nullable. + A generated from the specified type. + + + + Generate a from the specified type. + + The type to generate a from. + The used to resolve schema references. + Specify whether the generated root will be nullable. + A generated from the specified type. + + + + + Resolves from an id. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets or sets the loaded schemas. + + The loaded schemas. + + + + Initializes a new instance of the class. + + + + + Gets a for the specified reference. + + The id. + A for the specified reference. + + + + + The value types allowed by the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + No type specified. + + + + + String type. + + + + + Float type. + + + + + Integer type. + + + + + Boolean type. + + + + + Object type. + + + + + Array type. + + + + + Null type. + + + + + Any type. + + + + + + Specifies undefined schema Id handling options for the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Do not infer a schema Id. + + + + + Use the .NET type name as the schema Id. + + + + + Use the assembly qualified .NET type name as the schema Id. + + + + + + Returns detailed information related to the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets the associated with the validation error. + + The JsonSchemaException associated with the validation error. + + + + Gets the path of the JSON location where the validation error occurred. + + The path of the JSON location where the validation error occurred. + + + + Gets the text description corresponding to the validation error. + + The text description. + + + + + Represents the callback method that will handle JSON schema validation events and the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + A camel case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Resolves member mappings for a type, camel casing property names. + + + + + Initializes a new instance of the class. + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + Used by to resolve a for a given . + + + + + Gets a value indicating whether members are being get and set using dynamic code generation. + This value is determined by the runtime permissions available. + + + true if using dynamic code generation; otherwise, false. + + + + + Gets or sets the default members search flags. + + The default members search flags. + + + + Gets or sets a value indicating whether compiler generated members should be serialized. + + + true if serialized compiler generated members; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore the interface when serializing and deserializing types. + + + true if the interface will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore the attribute when serializing and deserializing types. + + + true if the attribute will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore IsSpecified members when serializing and deserializing types. + + + true if the IsSpecified members will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore ShouldSerialize members when serializing and deserializing types. + + + true if the ShouldSerialize members will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets the naming strategy used to resolve how property names and dictionary keys are serialized. + + The naming strategy used to resolve how property names and dictionary keys are serialized. + + + + Initializes a new instance of the class. + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + Gets the serializable members for the type. + + The type to get serializable members for. + The serializable members for the type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates the constructor parameters. + + The constructor to create properties for. + The type's member properties. + Properties for the given . + + + + Creates a for the given . + + The matching member property. + The constructor parameter. + A created for the given . + + + + Resolves the default for the contract. + + Type of the object. + The contract's default . + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Determines which contract type is created for the given type. + + Type of the object. + A for the given type. + + + + Creates properties for the given . + + The type to create properties for. + /// The member serialization mode for the type. + Properties for the given . + + + + Creates the used by the serializer to get and set values from a member. + + The member. + The used by the serializer to get and set values from a member. + + + + Creates a for the given . + + The member's parent . + The member to create a for. + A created for the given . + + + + Resolves the name of the property. + + Name of the property. + Resolved name of the property. + + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + + + + Resolves the key of the dictionary. By default is used to resolve dictionary keys. + + Key of the dictionary. + Resolved key of the dictionary. + + + + Gets the resolved name of the property. + + Name of the property. + Name of the property. + + + + The default naming strategy. Property names and dictionary keys are unchanged. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + The default serialization binder used when resolving and loading classes from type names. + + + + + Initializes a new instance of the class. + + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + The type of the object the formatter creates a new instance of. + + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + The type of the object the formatter creates a new instance of. + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + + + Represents a trace writer that writes to the application's instances. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of will exclude messages and include , + and messages. + + + The that will be used to filter the trace messages passed to the writer. + + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Get and set values for a using dynamic methods. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + Provides information surrounding an error. + + + + + Gets the error. + + The error. + + + + Gets the original object that caused the error. + + The original object that caused the error. + + + + Gets the member that caused the error. + + The member that caused the error. + + + + Gets the path of the JSON location where the error occurred. + + The path of the JSON location where the error occurred. + + + + Gets or sets a value indicating whether this is handled. + + true if handled; otherwise, false. + + + + Provides data for the Error event. + + + + + Gets the current object the error event is being raised against. + + The current object the error event is being raised against. + + + + Gets the error context. + + The error context. + + + + Initializes a new instance of the class. + + The current object. + The error context. + + + + Get and set values for a using dynamic methods. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + Provides methods to get attributes. + + + + + Returns a collection of all of the attributes, or an empty collection if there are no attributes. + + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. + + The type of the attributes. + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Used by to resolve a for a given . + + + + + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + Used to resolve references when serializing and deserializing JSON by the . + + + + + Resolves a reference to its object. + + The serialization context. + The reference to resolve. + The object that was resolved from the reference. + + + + Gets the reference for the specified object. + + The serialization context. + The object to get a reference for. + The reference to the object. + + + + Determines whether the specified object is referenced. + + The serialization context. + The object to test for a reference. + + true if the specified object is referenced; otherwise, false. + + + + + Adds a reference to the specified object. + + The serialization context. + The reference. + The object to reference. + + + + Allows users to control class loading and mandate what class to load. + + + + + When implemented, controls the binding of a serialized object to a type. + + Specifies the name of the serialized object. + Specifies the name of the serialized object + The type of the object the formatter creates a new instance of. + + + + When implemented, controls the binding of a serialized object to a type. + + The type of the object the formatter creates a new instance of. + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + + + Represents a trace writer. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of will exclude messages and include , + and messages. + + The that will be used to filter the trace messages passed to the writer. + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Provides methods to get and set values. + + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + Contract details for a used by the . + + + + + Gets the of the collection items. + + The of the collection items. + + + + Gets a value indicating whether the collection type is a multidimensional array. + + true if the collection type is a multidimensional array; otherwise, false. + + + + Gets or sets the function used to create the object. When set this function will override . + + The function used to create the object. + + + + Gets a value indicating whether the creator has a parameter with the collection values. + + true if the creator has a parameter with the collection values; otherwise, false. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets or sets the default collection items . + + The converter. + + + + Gets or sets a value indicating whether the collection items preserve object references. + + true if collection items preserve object references; otherwise, false. + + + + Gets or sets the collection item reference loop handling. + + The reference loop handling. + + + + Gets or sets the collection item type name handling. + + The type name handling. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Handles serialization callback events. + + The object that raised the callback event. + The streaming context. + + + + Handles serialization error callback events. + + The object that raised the callback event. + The streaming context. + The error context. + + + + Sets extension data for an object during deserialization. + + The object to set extension data on. + The extension data key. + The extension data value. + + + + Gets extension data for an object during serialization. + + The object to set extension data on. + + + + Contract details for a used by the . + + + + + Gets the underlying type for the contract. + + The underlying type for the contract. + + + + Gets or sets the type created during deserialization. + + The type created during deserialization. + + + + Gets or sets whether this type contract is serialized as a reference. + + Whether this type contract is serialized as a reference. + + + + Gets or sets the default for this contract. + + The converter. + + + + Gets the internally resolved for the contract's type. + This converter is used as a fallback converter when no other converter is resolved. + Setting will always override this converter. + + + + + Gets or sets all methods called immediately after deserialization of the object. + + The methods called immediately after deserialization of the object. + + + + Gets or sets all methods called during deserialization of the object. + + The methods called during deserialization of the object. + + + + Gets or sets all methods called after serialization of the object graph. + + The methods called after serialization of the object graph. + + + + Gets or sets all methods called before serialization of the object. + + The methods called before serialization of the object. + + + + Gets or sets all method called when an error is thrown during the serialization of the object. + + The methods called when an error is thrown during the serialization of the object. + + + + Gets or sets the default creator method used to create the object. + + The default creator method used to create the object. + + + + Gets or sets a value indicating whether the default creator is non-public. + + true if the default object creator is non-public; otherwise, false. + + + + Contract details for a used by the . + + + + + Gets or sets the dictionary key resolver. + + The dictionary key resolver. + + + + Gets the of the dictionary keys. + + The of the dictionary keys. + + + + Gets the of the dictionary values. + + The of the dictionary values. + + + + Gets or sets the function used to create the object. When set this function will override . + + The function used to create the object. + + + + Gets a value indicating whether the creator has a parameter with the dictionary values. + + true if the creator has a parameter with the dictionary values; otherwise, false. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets the object's properties. + + The object's properties. + + + + Gets or sets the property name resolver. + + The property name resolver. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets or sets the object constructor. + + The object constructor. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets or sets the object member serialization. + + The member object serialization. + + + + Gets or sets the missing member handling used when deserializing this object. + + The missing member handling. + + + + Gets or sets a value that indicates whether the object's properties are required. + + + A value indicating whether the object's properties are required. + + + + + Gets or sets how the object's properties with null values are handled during serialization and deserialization. + + How the object's properties with null values are handled during serialization and deserialization. + + + + Gets the object's properties. + + The object's properties. + + + + Gets a collection of instances that define the parameters used with . + + + + + Gets or sets the function used to create the object. When set this function will override . + This function is called with a collection of arguments which are defined by the collection. + + The function used to create the object. + + + + Gets or sets the extension data setter. + + + + + Gets or sets the extension data getter. + + + + + Gets or sets the extension data value type. + + + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Maps a JSON property to a .NET member or constructor parameter. + + + + + Gets or sets the name of the property. + + The name of the property. + + + + Gets or sets the type that declared this property. + + The type that declared this property. + + + + Gets or sets the order of serialization of a member. + + The numeric order of serialization. + + + + Gets or sets the name of the underlying member or parameter. + + The name of the underlying member or parameter. + + + + Gets the that will get and set the during serialization. + + The that will get and set the during serialization. + + + + Gets or sets the for this property. + + The for this property. + + + + Gets or sets the type of the property. + + The type of the property. + + + + Gets or sets the for the property. + If set this converter takes precedence over the contract converter for the property type. + + The converter. + + + + Gets or sets the member converter. + + The member converter. + + + + Gets or sets a value indicating whether this is ignored. + + true if ignored; otherwise, false. + + + + Gets or sets a value indicating whether this is readable. + + true if readable; otherwise, false. + + + + Gets or sets a value indicating whether this is writable. + + true if writable; otherwise, false. + + + + Gets or sets a value indicating whether this has a member attribute. + + true if has a member attribute; otherwise, false. + + + + Gets the default value. + + The default value. + + + + Gets or sets a value indicating whether this is required. + + A value indicating whether this is required. + + + + Gets a value indicating whether has a value specified. + + + + + Gets or sets a value indicating whether this property preserves object references. + + + true if this instance is reference; otherwise, false. + + + + + Gets or sets the property null value handling. + + The null value handling. + + + + Gets or sets the property default value handling. + + The default value handling. + + + + Gets or sets the property reference loop handling. + + The reference loop handling. + + + + Gets or sets the property object creation handling. + + The object creation handling. + + + + Gets or sets or sets the type name handling. + + The type name handling. + + + + Gets or sets a predicate used to determine whether the property should be serialized. + + A predicate used to determine whether the property should be serialized. + + + + Gets or sets a predicate used to determine whether the property should be deserialized. + + A predicate used to determine whether the property should be deserialized. + + + + Gets or sets a predicate used to determine whether the property should be serialized. + + A predicate used to determine whether the property should be serialized. + + + + Gets or sets an action used to set whether the property has been deserialized. + + An action used to set whether the property has been deserialized. + + + + Returns a that represents this instance. + + + A that represents this instance. + + + + + Gets or sets the converter used when serializing the property's collection items. + + The collection's items converter. + + + + Gets or sets whether this property's collection items are serialized as a reference. + + Whether this property's collection items are serialized as a reference. + + + + Gets or sets the type name handling used when serializing the property's collection items. + + The collection's items type name handling. + + + + Gets or sets the reference loop handling used when serializing the property's collection items. + + The collection's items reference loop handling. + + + + A collection of objects. + + + + + Initializes a new instance of the class. + + The type. + + + + When implemented in a derived class, extracts the key from the specified element. + + The element from which to extract the key. + The key for the specified element. + + + + Adds a object. + + The property to add to the collection. + + + + Gets the closest matching object. + First attempts to get an exact case match of and then + a case insensitive match. + + Name of the property. + A matching property if found. + + + + Gets a property by property name. + + The name of the property to get. + Type property name string comparison. + A matching property if found. + + + + Contract details for a used by the . + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Lookup and create an instance of the type described by the argument. + + The type to create. + Optional arguments to pass to an initializing constructor of the JsonConverter. + If null, the default constructor is used. + + + + A kebab case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Represents a trace writer that writes to memory. When the trace message limit is + reached then old trace messages will be removed as new messages are added. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of will exclude messages and include , + and messages. + + + The that will be used to filter the trace messages passed to the writer. + + + + + Initializes a new instance of the class. + + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Returns an enumeration of the most recent trace messages. + + An enumeration of the most recent trace messages. + + + + Returns a of the most recent trace messages. + + + A of the most recent trace messages. + + + + + A base class for resolving how property names and dictionary keys are serialized. + + + + + A flag indicating whether dictionary keys should be processed. + Defaults to false. + + + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + + + + A flag indicating whether explicitly specified property names, + e.g. a property name customized with a , should be processed. + Defaults to false. + + + + + Gets the serialized name for a given property name. + + The initial property name. + A flag indicating whether the property has had a name explicitly specified. + The serialized property name. + + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + + + + Gets the serialized key for a given dictionary key. + + The initial dictionary key. + The serialized dictionary key. + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Hash code calculation + + + + + + Object equality implementation + + + + + + + Compare to another NamingStrategy + + + + + + + Represents a method that constructs an object. + + The object type to create. + + + + When applied to a method, specifies that the method is called when an error occurs serializing an object. + + + + + Provides methods to get attributes from a , , or . + + + + + Initializes a new instance of the class. + + The instance to get attributes for. This parameter should be a , , or . + + + + Returns a collection of all of the attributes, or an empty collection if there are no attributes. + + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. + + The type of the attributes. + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Get and set values for a using reflection. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + A snake case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Specifies how strings are escaped when writing JSON text. + + + + + Only control characters (e.g. newline) are escaped. + + + + + All non-ASCII and control characters (e.g. newline) are escaped. + + + + + HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped. + + + + + Indicates the method that will be used during deserialization for locating and loading assemblies. + + + + + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. + + + + + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. + + + + + Specifies type name handling options for the . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + + + + Do not include the .NET type name when serializing types. + + + + + Include the .NET type name when serializing into a JSON object structure. + + + + + Include the .NET type name when serializing into a JSON array structure. + + + + + Always include the .NET type name when serializing. + + + + + Include the .NET type name when the type of the object being serialized is not the same as its declared type. + Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON + you must specify a root type object with + or . + + + + + Determines whether the collection is null or empty. + + The collection. + + true if the collection is null or empty; otherwise, false. + + + + + Adds the elements of the specified collection to the specified generic . + + The list to add to. + The collection of elements to add. + + + + Converts the value to the specified type. If the value is unable to be converted, the + value is checked whether it assignable to the specified type. + + The value to convert. + The culture to use when converting. + The type to convert or cast the value to. + + The converted type. If conversion was unsuccessful, the initial value + is returned if assignable to the target type. + + + + + Helper method for generating a MetaObject which calls a + specific method on Dynamic that returns a result + + + + + Helper method for generating a MetaObject which calls a + specific method on Dynamic, but uses one of the arguments for + the result. + + + + + Helper method for generating a MetaObject which calls a + specific method on Dynamic, but uses one of the arguments for + the result. + + + + + Returns a Restrictions object which includes our current restrictions merged + with a restriction limiting our type + + + + + Helper class for serializing immutable collections. + Note that this is used by all builds, even those that don't support immutable collections, in case the DLL is GACed + https://github.com/JamesNK/Newtonsoft.Json/issues/652 + + + + + Gets the type of the typed collection's items. + + The type. + The type of the typed collection's items. + + + + Gets the member's underlying type. + + The member. + The underlying type of the member. + + + + Determines whether the property is an indexed property. + + The property. + + true if the property is an indexed property; otherwise, false. + + + + + Gets the member's value on the object. + + The member. + The target object. + The member's value on the object. + + + + Sets the member's value on the target object. + + The member. + The target. + The value. + + + + Determines whether the specified MemberInfo can be read. + + The MemberInfo to determine whether can be read. + /// if set to true then allow the member to be gotten non-publicly. + + true if the specified MemberInfo can be read; otherwise, false. + + + + + Determines whether the specified MemberInfo can be set. + + The MemberInfo to determine whether can be set. + if set to true then allow the member to be set non-publicly. + if set to true then allow the member to be set if read-only. + + true if the specified MemberInfo can be set; otherwise, false. + + + + + Builds a string. Unlike this class lets you reuse its internal buffer. + + + + + Determines whether the string is all white space. Empty string will return false. + + The string to test whether it is all white space. + + true if the string is all white space; otherwise, false. + + + + + Specifies the state of the . + + + + + An exception has been thrown, which has left the in an invalid state. + You may call the method to put the in the Closed state. + Any other method calls result in an being thrown. + + + + + The method has been called. + + + + + An object is being written. + + + + + An array is being written. + + + + + A constructor is being written. + + + + + A property is being written. + + + + + A write method has not been called. + + + + Specifies that an output will not be null even if the corresponding type allows it. + + + Specifies that when a method returns , the parameter will not be null even if the corresponding type allows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + + Gets the return value condition. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + + + Initializes a new instance of the class. + + + The condition parameter value. Code after the method will be considered unreachable by diagnostics if the argument to + the associated parameter matches this value. + + + + Gets the condition parameter value. + + + diff --git a/Bin/Debug/CommonControls/.NET4 示例/OpenXmlPowerTools.dll b/Bin/Debug/CommonControls/.NET4 示例/OpenXmlPowerTools.dll new file mode 100644 index 0000000..c225873 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/OpenXmlPowerTools.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/RaUI.dll b/Bin/Debug/CommonControls/.NET4 示例/RaUI.dll new file mode 100644 index 0000000..edfe6ca Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/RaUI.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/RaUI.xml b/Bin/Debug/CommonControls/.NET4 示例/RaUI.xml new file mode 100644 index 0000000..0a68fdb --- /dev/null +++ b/Bin/Debug/CommonControls/.NET4 示例/RaUI.xml @@ -0,0 +1,61430 @@ + + + + RaUI + + + + + 基于XML实现的权限类 + + + + + 用户名 + + + + + 用户id + + + + + 密码 + + + + + 权限控制Id + + + + + 用户备注 + + + + + 是否是管理员权限 + + + + + 是否是超级管理员权限 + + + + + 设置权限 + + 权限名称 + 权限值 + 返回是否设置成功 + + + + 获取权限 + + 权限名称 + 默认权限值 + 返回权限值 + + + + 获取权限 + + 权限名称 + 返回权限值 + + + + 批量导入权限 + + 权限相关的内容 + 返回是否执行成功 + + + + 导出权限 + + 返回导出文本 + + + + 清除所有权限 + + 返回是否执行成功 + + + + 字符串字数统计 + + + + + 返回字数统计信息 + + + + + + + 字符串统计信息 + + + + + 汉字数量 + + + + + 英文字母数量 + + + + + 英文单词数量 + + + + + 数字数量(一个数字字符算一个数) + + + + + 数字数量(一串数字算一个数) + + + + + 字节总数(汉字算2个字节) + + + + + 总数(英文单词算一个数，一串数字算一个数) + + + + + 可见字符总数(一个字母算一个数,一个数字算一个数) + + + + + 汉字转拼音静态类,包括功能全拼和缩写，方法全部是静态的 + + + + + 汉字的机内码数组 + + + + + 机内码对应的拼音数组 + + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(首拼) + + 汉字字符串 + 转换后的拼音(首拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 用指定字符分隔 + 转换后的拼音(全拼)字符串 + + + + 汉字转拼音缩写 + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串) (小写) (空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (大写) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串)(大写)(空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 字符串操作类 + + + + + 字符串转Base64 + + + + + + + Base64转字符串 + + + + + + + 判断是否包含日文平假和片假 + + + + + + + 转换指定字符串为布尔类型 + + + + + 转换指定字符串为Double类型 + + + + + 已重载.计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 已重载.计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定布尔类型为Int类型,true为1，false为0 + + + + + 判断指定字符串是否是布尔类型 + + + + + 判断指定字符串是否是Double类型 + + + + + 判断指定字符串是否是Int类型 + + + + + 根据年月日转换成日期 + + + + + + + + + 追加字符 + + + + + 获取2个字符串中间的内容,point1为空表示从首位开始算，point2为空表示算到结尾。 + + + + + 判断字符串是否只包含数字或英文 + + + + + + + 判断字符串是否只包含英文 + + + + + + + 判断字符串是否只包含数字 + + + + + + + 判断字符串是否匹配,支持?*通配符 + + 待匹配的字符串 + 匹配的通配符 + + + + + 通配符替换 + + + + + + + + + 支持忽略大小写的替换功能 + + + + + 是否忽略大小写 + + + + + 获取匹配的内容 + + + + + + + + + Json扩展 + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 对变量的拓展 + + + + + 替换文本(忽略大小写) + + + 需要替换的内容 + 替换后的内容 + + + + + 替换文本(忽略大小写),可支持通配符 + + + + + 是否是通配符表达式,不是，则普通替换，忽略大小写，是，则启用通配符替换 + + + + + 将颜色转换为Html颜色格式 + + + + + + + 支持忽略大小写的替换文本功能 + + + + + 是否忽略大小写 + + + + + 获取字数信息 + + + + + + + 获取符合要求的第一个结果 + + + + 是否是正则 + + + + + 查找字符串,忽略大小写 + + + + + + + + + 查找字符串,忽略大小写 + + + + + + + + 判断字符串是否是数字或英文 + + + + + + + 判断字符串是否含有日文 + + + + + + + 判断字符串是否是英文 + + + + + + + 判断字符串是否是数字(不同于IsInt,本函数是判断字符串是否只含有数字,对字符串长度没有限制) + + + + + + + 是否在指定范围内 + + + + + + + + + 是否在指定范围内 + + + + + + + + + 转换指定字符串为Int类型 + + + 最小值 + 最大值 + 如果字符串不在范围内，则使用本默认值 + + + + + 转换指定布尔类型到Int类型,true为1，false为0 + + + + + + + 将指定类型转换成整型 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将指定类型转换成整型 + + + + + + + 将指定类型转换成长整型,如果时间时间类型,则转换为Unix时间戳 + + + + + + + + 转换为Unix时间戳 + + + + + + + 转换为Js时间戳 + + + + + + + 转换为Unix时间戳 + + + + + + + 将指定类型转换成长整型 + + + + + + + 转换指定类型为Double类型 + + + + + + + + 转换指定类型为Double类型 + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + + 转换DateTime类型到日期时间字符串(例如 2000-01-01 08:08:08) + + + + + + + 转换DateTime类型到日期字符串(例如 2000-01-01) + + + + + + + 转换DateTime类型到日期星期字符串(例如 2000-01-01 星期六) + + + + + + + 转换DateTime类型到Unix时间戳 + + + + + + + 转换Unix时间戳到DateTime类型 + + + + + + + 判断字符串是否与内容匹配 + + + + + + + + 将变量值转换成Double类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换到文件大小字符串 + + + + + + + 转换到文件大小字符串 + + + + + + + 转换指定类型为Decimal类型 + + + + + + + + 将变量值转换成Decimal类型 + + + + + + + 将变量值转换成Decimal类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换指定类型为DateTime类型 + + + + + + + + 将变量值转换成DateTime类型 + + + + + + + 转换指定类型为布尔类型 + + + + + + + 追加字符 + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + + + + 判断指定字符串是否是Int类型 + + + + + + + 判断指定字符串是否是Double类型 + + + + + + + 判断是否是布尔类型 + + + + + + + 将字符串转换为Base64类型 + + + + + + + 判断字符串是否在指定长度 + + + + + + + + + 判断能否转换成日期格式 + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 大文件与批量文件操作类,支持中途取消操作,本类需要实例化操作 + + + + + 传输进度 + + 当前传输完成的值 + 全部值,为-1表示无法获取 + 当前传输的百分比,为-1表示无法获取 + 当前下载速度(值为每秒下载的字节数),为-1表示无法获取 + 携带的参数(可选) + + + + 传输失败的事件 + + 错误描述 + 携带的参数(可选) + + + + 文件传输出错 + + + + + 文件传输进度 + + + + + 文件夹传输进度 + + + + + 取消事件 + + + + + 大文件按流复制文件,支持自动创建目标文件夹。 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + 携带的参数(可选) + + + + + 复制文件夹到目标文件夹,不支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持中途取消 + + 源文件夹 + 目标文件夹 + 初始的文件数量 + 总数量,如果不计算,则使用-1 + 操作的数量,包含成功的和失败的 + 携带的参数(可选) + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 获取文件夹中的文件数量 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 获取文件夹的大小 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 文件信息 + + + + + 获取版本号 + + + + + 获取版本号 + + + + + + + 根据版本字符串输出double类型的版本号 + + + + + + + + 比较两个版本号大小 + + + + oldVer小于newVer,返回1,大于则返回-1,相等返回0,不支持则返回-1000 + + + + 从字符串中提取版本号 + + + + + + + 比较版本号 + + + + + + old小于new,返回1,大于则返回-1,相等返回0 + + + + 判断是否是管理员方式运行 + + + + + + Hosts操作类 + + + + + 获取并转换hosts内容 + + hosts内容 + + + + + 获取hosts并转换hosts内容 + + + + + + 追加内容到hosts里 + + 要追加的内容列表，每一行为ip 域名的格式 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + write为true,追加内容到hosts里;为false,判断是否需要追加 + + 要追加的内容列表，每一行为ip 域名的格式 + 是否要写入,如果为false,则只判断是否需要追加,而不写入Hosts文件 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + 要追加的内容 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + ip地址 + 域名 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 从hosts文件里删除内容 + + 要删除的内容 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + 从hosts文件里删除内容 + + ip地址 + 域名 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + Host信息 + + + + + IP + + + + + 域名 + + + + + 注释 + + + + + 是否要删除 + + + + + Ini操作类 + + + + + 写入Ini + + + + + + + + + + 获取Ini + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 获取所有节点名称(Section) + + 存放节点名称的内存地址,每个节点之间用\0分隔 + 内存大小(characters) + Ini文件 + 内容的实际长度,为0表示没有内容,为nSize-2表示内存大小不够 + + + + 编码 + + + + + Ini操作类 + + + + + + 根据section取所有key和值 + + + + + + + 读取INI文件中指定INI文件中的所有节点名称(Section) + + 所有节点,没有内容返回string[0] + + + + 读取INI文件 + + 段，格式[] + 键 + 返回byte类型的section组或键值组 + + + + 根据section取所有key + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入Ini + + + + + + + + 读取Ini + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + + + 写入ini + + + + + + + + + 删除Ini的Key + + + + + + + 删除Ini节点 + + + + + + 控件信息 + + + + + id + + + + + 控件对象 + + + + + 控件值类型 + + + + + 默认值 + + + + + 值类型 + + + + + 默认 + + + + + 取列表顺序值 + + + + + 取当前选择的列表值 + + + + + 取对象值 + + + + + 保存的设置类型 + + + + + Ini + + + + + XML + + + + + 对象值 + + + + + 显示的文本 + + + + + 图片序号 + + + + + id + + + + + Tag值 + + + + + 显示文本值 + + + + + + 星期数据 + + + + + 一周的开始时间 + + + + + 一周的结束时间 + + + + + 图片类型 + + + + + Bmp图片 + + + + + Jpeg图片 + + + + + Png图片 + + + + + Gif动态图片 + + + + + Tiff图片 + + + + + 文件操作类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 永久删除单个文件。 + + 永久删除的文件名 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除一组文件。 + + 字符串数组，表示一组文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + + + + + 移动一个文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 移动一组文件到指定的路径下 + + 要移动的文件名数组 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制一组文件到指定的路径 + + 要复制的文件名数组 + 复制到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 大文件多次复制文件 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 重命名一个文件为新名称，建议您使用更方便的Microsoft.VisualBasic.FileSystem.ReName();替换该方法 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 删除单个或多个文件 + + 删除的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动或复制一个或多个文件到指定路径下 + + 操作类型，是移动操作还是复制操作 + 要移动或复制的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 移动到的目的位置 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 如果指定文件夹不存在，则创建文件夹 + + + + + + 根据指定文件夹路径,生成一个随机不存在的文件名 + + + 扩展名,比如.jpg + 前缀 + + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 解释错误代码 + + 代码号 + 返回关于错误代码的文字描述 + + + + 运行文件 + + + + + + + + /运行文件 + + + + + + + + + 运行程序 + + + + + + + 打开文件 + + + + + + + 打开文件夹并定位文件 + + + + + + + 打开网址 + + + + + + + 判断是否为空的文件夹 + + + + + + + 文件或文件夹是否存在 + + + + + + + 判断文件名是否有效 + + + + + + + 转换到有效文件名 + + + + + + + 追加日志 + + + + + + + 追加文件 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + + 写入所有文本行到文件,如果文件夹不存在，会自动创建 + + + + + + + + 写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + + 以UTF-8格式写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + 从文件中加载图片,使用本方法，不会导致图片文件被占用。 + + + + + + 获取文件大小 + + + + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 获取文件大小字符串 + + + + + + + 根据文件大小字符串获取长整型表示的文件大小 + + + + + + + 获取文件大小字符串 + + + + + + + 复制内容到剪切板 + + + + + + 添加某个控件为支持拖放属性 + + + + + + + 使管理员方式运行时支持拖放 + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 获取绝对路径 + + + + + + + 获取相对路径 + + + + + + + 获取图标 + + + + + + + + + + + + + + 销毁图标 + + + + + + + 获取文件图标 + + + + + + + + 获取文件图标 + + + + + + + + + + 图片相关API + + + + + 检测文件真实扩展名 + + + + + + + 检测文件真实扩展名 + + + + + + + 从文件或Url中加载图片,使用本方法，不会导致图片文件被占用。(如果是webp格式,需要引入OpenXmlPowerTools) + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + 图片质量,0~100 + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + 图片质量,0~100 + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + 图片质量,0~100 + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 以逆时针为方向对图像进行旋转 + + 位图流 + 旋转角度[0,360](前台给的) + + + + + 是否包括透明像素 + + + + 操作失败 + + + + 矩形边界 + + + + + + + + 计算水印位置 + + + + + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 计算最大字体大小 + + + + + + + + + + + 计算旋转矩形大小 + + + + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + + + + + 缩放 + + + 宽 + 高 + 插值算法 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 缩放 + + + 宽 + 高 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 根据原边长和新边长计算绘制的起始点坐标 + + + + + + + + 获取缩放模式 + + + + + + 是否裁剪图片 + + + + + 裁剪或填充 + + + + + 背景色 + 插值算法 + + Image 不能为 null + 操作失败 + + + + 裁剪 + + + 宽度 + 高度 + + 返回裁剪后的图片 + Image 不能为 null + 新的图片尺寸的宽度和高度必须大于零 + 操作失败 + + + + 调整宽度 + + + + + + + + 根据最大宽度调整图片尺寸 + + + 最大宽度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最大高度调整图片尺寸 + + + 最大高度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最长边调整图片尺寸 + + + 设置最长边允许的值,当最长边大于这个值时,自动缩放 + 返回调整后的图片 + Image 不能为 null + 最大值必须大于零 + 操作失败 + + + + 调整高度 + + + + + + + + 调整图片大小 + + + + + + + + + + 调整图片大小 + + + + + + + + + + + 调整图片大小 + + + + + + + + + + + + + 转换Image为Icon + + 要转换为图标的Image对象 + 当image为null时是否返回null。false则抛空引用异常 + + + + + 缩放模式 + + + + + 宽度优先(不裁剪宽) + + + + + 高度优先(不裁剪高) + + + + + 水印位置 + + + + + 左上角 + + + + + 中上 + + + + + 右上角 + + + + + 左中 + + + + + 居中 + + + + + 右中 + + + + + 左下角 + + + + + 中下 + + + + + 右下角 + + + + + 全屏平铺 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + 音频播放类 + + + + + 临时音频文件 + + + + + 父窗口句柄 + + + + + 声音标签 + + + + play synchronously (default) + + + play asynchronously + + + silence (!default) if sound not found + + + pszSound points to a memory file + + + loop the sound until next sndPlaySound + + + don’t stop any currently playing sound + + + Stop Playing Wave + + + don’t wait if the driver is busy + + + name is a registry alias + + + alias is a predefined id + + + name is file name + + + name is resource name or atom + + + + 音频播放类 + + embedded music file + 临时保存的文件位置 + 父窗口句柄 + + + + 音频播放类 + + 要播放的音频位置 + 父窗口句柄 + + + + 音频播放类 + + + 父窗口句柄 + + + + 播放音频 + + + + + + 播放音频 + + + + + 关闭音频 + + + + + XML操作类 + + + + + XML操作类 + + + + + 从XML文本中加载数据 + + + + + + 从指定的XML文本中加载 + + XML文本 + 如为1，表示加载成功，为0为失败 + + + + 载入空的XML文档 + + 如为1，表示加载成功，为0为失败 + + + + 从指定的文件中加载 + + XML文件路径 + 如为1，表示加载成功，为0为失败 + + + + 保存到指定文件中 + + 文件路径 + 如为1，表示保存成功，为0为失败 + + + + 判断节点是否存在 + + 属性名 + 属性值 + 返回1，表示存在，其它表示不存在 + + + + 定位节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 定位节点,如果找不到节点，就新建一个节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 + + 返回第一个符合要求的结果 + + + + 定位设置节点 + + 返回第一个符合要求的结果 + + + + 在节点后插入数据 + + + + + + + 在节点前插入数据 + + + + + + + 获取节点数量 + + 属性名 + 属性值 + 返回符合要求的结果数量 + + + + 获取节点数量 + + 返回符合要求的结果数量 + + + + 获取节点数量 + + 属性名 + 属性值 + + + + 返回符合要求的结果数量 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 读取指定节点的值(string) + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + + + 获取属性值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取所有的节点名称 + + + + + + 读取指定节点的值(string) + + + + + + + + 读取指定节点的值(int) + + + + + + + + 读取指定节点的值(decimal) + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 获取XML文件的根元素 + + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 新增节点 + + + + + + + + 新增节点并定位到新节点 + + + + + + + + 新增设置节点并定位 + + + + + + 在指定节点前新增节点并定位到新节点 + + + + + + + + + 获取当前节点 + + + + + + 删除节点 + + + + + + 获取XML文本 + + + + + + 获取XML文本 + + + + + + 获取文本 + + + + + + 获取文本 + + + + + + 文件时间 + + + + + 创建时间 + + + + + 最后修改时间 + + + + + 访问时间 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 取得一个文本文件的编码方式。如果无法在文件头部找到有效的前导符，Encoding.Default将被返回。 + + 文件名。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + + + + + 取得一个文本文件的编码方式。 + + 文件名。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 通过给定的文件流，判断文件的编码类型 + + 文件流 + 文件的编码类型 + + + + 判断是否是不带 BOM 的 UTF8 格式 + + + + + + + + + + + Read a WebP file + WebP file to load + Bitmap with the WebP image + + + Decode a WebP image + The data to uncompress + Bitmap with the WebP image + + + Decode a WebP image + the data to uncompress + Options for advanced decode + Bitmap with the WebP image + + + Get Thumbnail from webP in mode faster/low quality + The data to uncompress + Wanted width of thumbnail + Wanted height of thumbnail + Bitmap with the WebP thumbnail in 24bpp + + + Thumbnail from webP in mode slow/high quality + The data to uncompress + Wanted width of thumbnail + Wanted height of thumbnail + Bitmap with the WebP thumbnail + + + Save bitmap to file in WebP format + Bitmap with the WebP image + The file to write + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + + + Lossy encoding bitmap to WebP (Simple encoding API) + Bitmap with the image + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + Compressed data + + + Lossy encoding bitmap to WebP (Advanced encoding API) + Bitmap with the image + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + Between 0 (fastest, lowest compression) and 9 (slower, best compression) + + Compressed data + + + Lossless encoding bitmap to WebP (Simple encoding API) + Bitmap with the image + Compressed data + + + Lossless encoding image in bitmap (Advanced encoding API) + Bitmap with the image + Between 0 (fastest, lowest compression) and 9 (slower, best compression) + Compressed data + + + Near lossless encoding image in bitmap + Bitmap with the image + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + Between 0 (fastest, lowest compression) and 9 (slower, best compression) + Compress data + + + Get the libwebp version + Version of library + + + Get info of WEBP data + The data of WebP + width of image + height of image + Image has alpha channel + Image is a animation + Format of image: 0 = undefined (/mixed), 1 = lossy, 2 = lossless + + + Compute PSNR, SSIM or LSIM distortion metric between two pictures. Warning: this function is rather CPU-intensive. + Picture to measure + Reference picture + 0 = PSNR, 1 = SSIM, 2 = LSIM + dB in the Y/U/V/Alpha/All order + + + Encoding image using Advanced encoding API + Bitmap with the image + Config for encode + True if need encode info. + Compressed data + + + Free memory + + + This function will initialize the configuration according to a predefined set of parameters (referred to by 'preset') and a given quality factor. + The WebPConfig struct + Type of image + Quality of compresion + 0 if error + + + Get info of WepP image + Bytes[] of webp image + Size of rawWebP + Features of WebP image + VP8StatusCode + + + Activate the lossless compression mode with the desired efficiency. + The WebPConfig struct + between 0 (fastest, lowest compression) and 9 (slower, best compression) + 0 in case of parameter errorr + + + Check that 'config' is non-NULL and all configuration parameters are within their valid ranges. + The WebPConfig struct + 1 if config are OK + + + Init the struct WebPPicture ckecking the dll version + The WebPPicture struct + 1 if not error + + + Colorspace conversion function to import RGB samples. + The WebPPicture struct + Point to BGR data + stride of BGR data + Returns 0 in case of memory error. + + + Colorspace conversion function to import RGB samples. + The WebPPicture struct + Point to BGRA data + stride of BGRA data + Returns 0 in case of memory error. + + + Colorspace conversion function to import RGB samples. + The WebPPicture struct + Point to BGR data + stride of BGR data + Returns 0 in case of memory error. + + + The writer type for output compress data + Data returned + Size of data returned + Picture struct + + + + Compress to webp format + The config struct for compresion parameters + 'picture' hold the source samples in both YUV(A) or ARGB input + Returns 0 in case of error, 1 otherwise. In case of error, picture->error_code is updated accordingly. + + + Release the memory allocated by WebPPictureAlloc() or WebPPictureImport*() + Note that this function does _not_ free the memory used by the 'picture' object itself. + Besides memory (which is reclaimed) all other fields of 'picture' are preserved. + Picture struct + + + Validate the WebP image header and retrieve the image height and width. Pointers *width and *height can be passed NULL if deemed irrelevant + Pointer to WebP image data + This is the size of the memory block pointed to by data containing the image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + 1 if success, otherwise error code returned in the case of (a) formatting error(s). + + + Decode WEBP image pointed to by *data and returns BGR samples into a pre-allocated buffer + Pointer to WebP image data + This is the size of the memory block pointed to by data containing the image data + Pointer to decoded WebP image + Size of allocated buffer + Specifies the distance between scanlines + output_buffer if function succeeds; NULL otherwise + + + Decode WEBP image pointed to by *data and returns BGR samples into a pre-allocated buffer + Pointer to WebP image data + This is the size of the memory block pointed to by data containing the image data + Pointer to decoded WebP image + Size of allocated buffer + Specifies the distance between scanlines + output_buffer if function succeeds; NULL otherwise + + + Initialize the configuration as empty. This function must always be called first, unless WebPGetFeatures() is to be called. + Configuration struct + False in case of mismatched version. + + + Decodes the full data at once, taking 'config' into account. + WebP raw data to decode + Size of WebP data + Configuration struct + VP8_STATUS_OK if the decoding was successful + + + Free any memory associated with the buffer. Must always be called last. Doesn't free the 'buffer' structure itself. + WebPDecBuffer + + + Lossy encoding images + Pointer to BGR image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + Ranges from 0 (lower quality) to 100 (highest quality). Controls the loss and quality during compression + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Lossy encoding images + Pointer to BGRA image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + Ranges from 0 (lower quality) to 100 (highest quality). Controls the loss and quality during compression + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Lossless encoding images pointed to by *data in WebP format + Pointer to BGR image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Lossless encoding images pointed to by *data in WebP format + Pointer to BGR image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Releases memory returned by the WebPEncode + Pointer to memory + + + Get the webp version library + 8bits for each of major/minor/revision packet in integer. E.g: v2.5.7 is 0x020507 + + + Compute PSNR, SSIM or LSIM distortion metric between two pictures. + Picture to measure + Reference picture + 0 = PSNR, 1 = SSIM, 2 = LSIM + dB in the Y/U/V/Alpha/All order + False in case of error (src and ref don't have same dimension, ...) + + + Enumerate some predefined settings for WebPConfig, depending on the type of source picture. These presets are used when calling WebPConfigPreset(). + + + Default preset. + + + Digital picture, like portrait, inner shot. + + + Outdoor photograph, with natural lighting. + + + Hand or line drawing, with high-contrast details. + + + Small-sized colorful images. + + + Text-like. + + + Encoding error conditions. + + + No error. + + + Memory error allocating objects. + + + Memory error while flushing bits. + + + A pointer parameter is NULL. + + + Configuration is invalid. + + + Picture has invalid width/height. + + + Partition is bigger than 512k. + + + Partition is bigger than 16M. + + + Error while flushing bytes. + + + File is bigger than 4G. + + + Abort request by user. + + + List terminator. always last. + + + Enumeration of the status codes. + + + No error. + + + Memory error allocating objects. + + + Configuration is invalid. + + + + + + + + Configuration is invalid. + + + + + + + + Abort request by user. + + + + + + + + Image characteristics hint for the underlying encoder. + + + Default preset. + + + Digital picture, like portrait, inner shot + + + Outdoor photograph, with natural lighting + + + Discrete tone image (graph, map-tile etc). + + + list terminator. always last. + + + Describes the byte-ordering of packed samples in memory. + + + Byte-order: R,G,B,R,G,B,... + + + Byte-order: R,G,B,A,R,G,B,A,... + + + Byte-order: B,G,R,B,G,R,... + + + Byte-order: B,G,R,A,B,G,R,A,... + + + Byte-order: A,R,G,B,A,R,G,B,... + + + Byte-order: RGB-565: [a4 a3 a2 a1 a0 r5 r4 r3], [r2 r1 r0 g4 g3 g2 g1 g0], ... + WEBP_SWAP_16BITS_CSP is defined, + Byte-order: RGB-565: [a4 a3 a2 a1 a0 b5 b4 b3], [b2 b1 b0 g4 g3 g2 g1 g0], ... + + + Byte-order: RGB-565: [r4 r3 r2 r1 r0 g5 g4 g3], [g2 g1 g0 b4 b3 b2 b1 b0], ... + WEBP_SWAP_16BITS_CSP is defined, + Byte-order: [b3 b2 b1 b0 a3 a2 a1 a0], [r3 r2 r1 r0 g3 g2 g1 g0], ... + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + yuv 4:2:0 + + + yuv 4:2:0 + + + MODE_LAST -> 13 + + + + Decoding states. State normally flows as: + WEBP_HEADER->VP8_HEADER->VP8_PARTS0->VP8_DATA->DONE for a lossy image, and + WEBP_HEADER->VP8L_HEADER->VP8L_DATA->DONE for a lossless image. + If there is any error the decoder goes into state ERROR. + + + + Features gathered from the bitstream + + + Width in pixels, as read from the bitstream. + + + Height in pixels, as read from the bitstream. + + + True if the bitstream contains an alpha channel. + + + True if the bitstream is an animation. + + + 0 = undefined (/mixed), 1 = lossy, 2 = lossless + + + Padding for later use. + + + Compression parameters. + + + Lossless encoding (0=lossy(default), 1=lossless). + + + Between 0 (smallest file) and 100 (biggest) + + + Quality/speed trade-off (0=fast, 6=slower-better) + + + Hint for image type (lossless only for now). + + + If non-zero, set the desired target size in bytes. Takes precedence over the 'compression' parameter. + + + If non-zero, specifies the minimal distortion to try to achieve. Takes precedence over target_size. + + + Maximum number of segments to use, in [1..4] + + + Spatial Noise Shaping. 0=off, 100=maximum. + + + Range: [0 = off .. 100 = strongest] + + + Range: [0 = off .. 7 = least sharp] + + + Filtering type: 0 = simple, 1 = strong (only used if filter_strength > 0 or autofilter > 0) + + + Auto adjust filter's strength [0 = off, 1 = on] + + + Algorithm for encoding the alpha plane (0 = none, 1 = compressed with WebP lossless). Default is 1. + + + Predictive filtering method for alpha plane. 0: none, 1: fast, 2: best. Default if 1. + + + Between 0 (smallest size) and 100 (lossless). Default is 100. + + + Number of entropy-analysis passes (in [1..10]). + + + If true, export the compressed picture back. In-loop filtering is not applied. + + + Preprocessing filter (0=none, 1=segment-smooth, 2=pseudo-random dithering) + + + Log2(number of token partitions) in [0..3] Default is set to 0 for easier progressive decoding. + + + Quality degradation allowed to fit the 512k limit on prediction modes coding (0: no degradation, 100: maximum possible degradation). + + + If true, compression parameters will be remapped to better match the expected output size from JPEG compression. Generally, the output size will be similar but the degradation will be lower. + + + If non-zero, try and use multi-threaded encoding. + + + If set, reduce memory usage (but increase CPU use). + + + Near lossless encoding [0 = max loss .. 100 = off (default)]. + + + If non-zero, preserve the exact RGB values under transparent area. Otherwise, discard this invisible RGB information for better compression. The default value is 0. + + + Reserved for future lossless feature + + + if needed, use sharp (and slow) RGB->YUV conversion + + + Padding for later use. + + + Main exchange structure (input samples, output bytes, statistics) + + + Main flag for encoder selecting between ARGB or YUV input. Recommended to use ARGB input (*argb, argb_stride) for lossless, and YUV input (*y, *u, *v, etc.) for lossy + + + colorspace: should be YUV420 for now (=Y'CbCr). Value = 0 + + + Width of picture (less or equal to WEBP_MAX_DIMENSION) + + + Height of picture (less or equal to WEBP_MAX_DIMENSION) + + + Pointer to luma plane. + + + Pointer to chroma U plane. + + + Pointer to chroma V plane. + + + Luma stride. + + + Chroma stride. + + + Pointer to the alpha plane + + + stride of the alpha plane + + + Padding for later use. + + + Pointer to argb (32 bit) plane. + + + This is stride in pixels units, not bytes. + + + Padding for later use. + + + Byte-emission hook, to store compressed bytes as they are ready. + + + Can be used by the writer. + + + 1: intra type, 2: segment, 3: quant, 4: intra-16 prediction mode, 5: chroma prediction mode, 6: bit cost, 7: distortion + + + if not NULL, points to an array of size ((width + 15) / 16) * ((height + 15) / 16) that will be filled with a macroblock map, depending on extra_info_type. + + + Pointer to side statistics (updated only if not NULL) + + + Error code for the latest error encountered during encoding + + + If not NULL, report progress during encoding. + + + this field is free to be set to any value and used during callbacks (like progress-report e.g.). + + + Padding for later use. + + + Row chunk of memory for yuva planes + + + row chunk of memory for argb planes + + + Padding for later use. + + + + + + + + + Structure for storing auxiliary statistics (mostly for lossy encoding). + + + Final size + + + Peak-signal-to-noise ratio for Y + + + Peak-signal-to-noise ratio for U + + + Peak-signal-to-noise ratio for V + + + Peak-signal-to-noise ratio for All + + + Peak-signal-to-noise ratio for Alpha + + + Number of intra4 + + + Number of intra16 + + + Number of skipped macroblocks + + + Approximate number of bytes spent for header + + + Approximate number of bytes spent for mode-partition #0 + + + Approximate number of bytes spent for DC coefficients for segment 0. + + + Approximate number of bytes spent for AC coefficients for segment 0. + + + Approximate number of bytes spent for uv coefficients for segment 0. + + + Approximate number of bytes spent for DC coefficients for segment 1. + + + Approximate number of bytes spent for AC coefficients for segment 1. + + + Approximate number of bytes spent for uv coefficients for segment 1. + + + Approximate number of bytes spent for DC coefficients for segment 2. + + + Approximate number of bytes spent for AC coefficients for segment 2. + + + Approximate number of bytes spent for uv coefficients for segment 2. + + + Approximate number of bytes spent for DC coefficients for segment 3. + + + Approximate number of bytes spent for AC coefficients for segment 3. + + + Approximate number of bytes spent for uv coefficients for segment 3. + + + Number of macroblocks in segments 0 + + + Number of macroblocks in segments 1 + + + Number of macroblocks in segments 2 + + + Number of macroblocks in segments 3 + + + Quantizer values for segment 0 + + + Quantizer values for segment 1 + + + Quantizer values for segment 2 + + + Quantizer values for segment 3 + + + Filtering strength for segment 0 [0..63] + + + Filtering strength for segment 1 [0..63] + + + Filtering strength for segment 2 [0..63] + + + Filtering strength for segment 3 [0..63] + + + Size of the transparency data + + + Size of the enhancement layer data + + + bit0:predictor bit1:cross-color transform bit2:subtract-green bit3:color indexing + + + Number of precision bits of histogram + + + Precision bits for transform + + + Number of bits for color cache lookup + + + Number of color in palette, if used + + + Final lossless size + + + Lossless header (transform, huffman etc) size + + + Lossless image data size + + + Padding for later use. + + + + + + + + Immutable bitstream features (optional) + + + Output buffer (can point to external mem) + + + Decoding options + + + Output buffer + + + Colorspace. + + + Width of image. + + + Height of image. + + + If non-zero, 'internal_memory' pointer is not used. If value is '2' or more, the external memory is considered 'slow' and multiple read/write will be avoided. + + + Output buffer parameters. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + Internally allocated memory (only when is_external_memory is 0). Should not be used externally, but accessed via WebPRGBABuffer. + + + Union of buffer parameters + + + + + + + + + + + + + + + + + + Pointer to luma samples + + + Pointer to chroma U samples + + + Pointer to chroma V samples + + + Pointer to alpha samples + + + luma stride + + + chroma U stride + + + chroma V stride + + + alpha stride + + + luma plane size + + + chroma plane U size + + + chroma plane V size + + + alpha plane size + + + Generic structure for describing the output sample buffer. + + + pointer to RGBA samples. + + + stride in bytes from one scanline to the next. + + + total size of the rgba buffer. + + + Decoding options + + + if true, skip the in-loop filtering. + + + if true, use faster pointwise upsampler. + + + if true, cropping is applied _first_ + + + left position for cropping. Will be snapped to even values. + + + top position for cropping. Will be snapped to even values. + + + width of the cropping area + + + height of the cropping area + + + if true, scaling is applied _afterward_ + + + final width + + + final height + + + if true, use multi-threaded decoding + + + dithering strength (0=Off, 100=full) + + + flip output vertically + + + alpha dithering strength in [0..100] + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + + 数据库操作扩展 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据,如果没有数据,则返回null + + + + + + + 获取第一行第一列的值 + + + + + + + 获取第一张表的指定行数据 + + + 指定第几行 + + + + + 获取第一张表的行数 + + + + + + + + + + + + 获取和设置aapt.exe的完整路径 + + + + + 获取和设置缓存文件夹 + + + + + 是否开启深度分析,深度分析需要解压apk进行分析，会更耗时。 + + + + + 读取adb内容 + + + + + + + + + + + + app名称 + + + + + 包名 + + + + + 版本号 + + + + + 版本字符串 + + + + + 权限 + + + + + 应用图标,需开启DeepAnaly_On开关，否则无法获取 + + + + + 文件名 + + + + + 文件路径 + + + + + 文件创建时间 + + + + + 文件修改时间 + + + + + 错误信息 + + + + + 对鼠标或键盘的自动化操作 + + + + + 鼠标左键 + + + + + 鼠标中键 + + + + + 鼠标右键 + + + + + 模拟键盘按键 + + + + 按下还是抬起 + + + + 鼠标滚轮 + + + + + + + + 鼠标移动 + + + + + + + + 自定义鼠标按下或抬起 + + + + + + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 粘贴文本 + + + + + + 获取指定句柄的大小及位置 + + + + + + + + 设置指定句柄的大小 + + + + + + + 判断鼠标位置是不是在指定的矩形中 + + + + + + + + 判断2张图是否相似度超90 + + + + + + + + /获取2种颜色的相似度,范围为0~100 + + + + + + + + 新模态窗体 + + + + + 设置窗体返回的结果值，并关闭窗体。 + + 当前窗体 + 模态变量 + 防止 + + + + 窗体返回的结果事件 + + + + + + + 当打开的窗体返回结果时激发 + + + + + 窗体返回的状态 + + + + + 实例化类 + + 父窗体,如果为null,则取桌面为父窗体 + + + + + 获取最顶级的父窗口 + + + + + + 显示新模态窗体,会暂时禁用父窗体,关闭当前窗体后,父窗体会恢复。 + + + + + 只运行一个实例,打开后,所有窗体都依然有效。 + + + + + + 显示窗体 + + 显示的位置 + + + + 显示在父窗体中间 + + + + + 窗体显示位置 + + + + + 右上角 + + + + + 顶部中间 + + + + + 顶部右边 + + + + + 中间 + + + + + 左下角 + + + + + 底部中间 + + + + + 右下角 + + + + + 父窗体居中 + + + + + + + + + + + + + + + + + + + + + + + + + 设置线程数量 + + + + + 要计算的总数量 + + + + + 每个线程要计算的数量 + + + + + + + + + + 当前已使用的时间 + + + + + + + 线程数量 + 要计算的事务数量 + + + + + + + + + + + + + + + + + + + + + + + 多线程计算时激发 + + + + + 在所有线程执行完毕后发生 + + + + + 在线程执行完毕后发生,最后一个执行完毕的线程将不收到本事件通知 + + + + + 进程相关接口 + + + + + 获取进程路径 + + + + + + + 获取进程路径 + + + + + + + 获取命令行 + + + + + + + 获取命令行 + + + + + + + 运行库检测类 + + + + + 获取产品状态 + + + + + + + 判断是否已安装VC运行库 + + + + + + 判断是否已安装VC运行库 + + + + + + 安装状态 + + + + + 组件禁用 + + + + + 配置数据已损坏 + + + + + 安装已暂停或正在进行 + + + + + 从源运行，源不可用 + + + + + 返回缓冲区溢出 + + + + + 无效的参数传递给该函数。 + + + + + 不公布或者未安装该产品。 + + + + + 损坏 + + + + + 该产品已公布但尚未安装。 + + + + + 正在移除的组件（操作状态，不可设置） + + + + + 不同的用户安装该产品。 + + + + + 安装在本地驱动器上 + + + + + 从源代码、CD或网络运行 + + + + + 为当前用户安装该产品。 + + + + + 安装的版本,是x86还是x64，还是全部安装了 + + + + + 判断32位和64位运行库是否已安装 + + + + + 判断32位运行库是否已安装 + + + + + 判断64位运行库是否已安装 + + + + + 判断是否已安装VC2005运行库 + + + + + + 判断是否已安装VC2005SP1运行库 + + + + + + 判断是否已安装VC2008运行库 + + + + + + 判断是否已安装VC2008SP1运行库 + + + + + + 判断是否已安装VC2010运行库 + + + + + + 判断是否已安装VC2010SP1运行库 + + + + + + 判断是否已安装VC2012运行库 + + + + + + 判断是否已安装VC2013运行库 + + + + + + 判断是否已安装VC2015或以上运行库 + + + + + + 判断是否已安装VC2017运行库或以上运行库 + + + + + + 判断是否已安装VC2019运行库或以上运行库 + + + + + + 判断是否已安装VC2022运行库或以上运行库 + + + + + + 判断当前系统是否安装了WebView2组件 + + + + + + 判断当前系统是否安装了.NET 4.8 + + + + + + 日期时间的操作类 + + + + + 获取当前是周几,周一到周日，分别是1-7. + + + + + + + 获取当前是周几,1-7，分别是返回一到日. + + + + + + + 获取当前是周几,输入日期，根据周几，分别是返回一到日. + + + + + + + 获取一周的开始和结束,开始时间为第一天的0点，结束时间以最后一天的0点为结束时间 + + + + + + + 获取2个日期相差几周 + + + + + + + + 获取2个日期相差几个月 + + + + + + + + 获取一个月的开始 + + + + + + + 判断是否在同一个星期。 + + + + + + + + 判断是否在同一个月。 + + + + + + + + 判断是否在同一天 + + + + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + 是否显示秒 + + + + + 将秒数显示成中文表达式 + + + + + + + 计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 将c# DateTime时间格式转换为Unix时间戳格式 + + 时间 + long + + + + 时间戳转为C#格式时间 + + + + + + + 时间戳转为C#格式时间 + + + + + + + 将c# DateTime时间格式转换为js时间戳格式 + + 时间 + long + + + + JS时间戳转为C#格式时间 + + + + + + + JS时间戳转为C#格式时间 + + + + + + + 根据年月日转换成日期 + + + + + + + + + 根据日期和时间转换成日期时间 + + + + + + + + 将时间转换成当前分钟开始的时间 + + + + + + + 将时间转换成当前秒钟开始的时间 + + + + + + + 当前时间在这一天里的秒数 + + + + + + + 窗体操作类 + + + + + 设置Comobox的行间距 + + + + + + + 移除关闭按钮。返回值，非零表示成功，零表示失败。 + + 窗口的句柄 + 是否成功 + + + + 把窗体放到最前 + + + + + + 显示窗体 + + + + + + + + 设置窗体是否置顶 + + + + + + + 显示没有焦点的窗口 + + + + + + 根据句柄获取窗口文本 + + + + + + + 根据句柄获取窗口类 + + + + + + + 获取当前活动的窗口句柄 + + + + + + 获取当前前台的窗口句柄 + + + + + + 设置为当前活动窗口 + + + + + + + 根据窗口句柄来获得进程id + + + + + + + 显示窗体 + + + + + + 设置窗体父窗体为桌面,不会随着显示桌面而最小化,但无法设置窗体透明度 + + + + + + 结束进程 + + + + + + + 打开窗体,只打开一个实例(非模态) + + + + + + + 将窗体植入到容器控件中 + + + 作为窗体容器的控件 + + + + + 重新调整窗体大小以适配容器大小 + + + 作为窗体容器的控件 + + + + + 设置注册表操作,部分功能需要管理员权限 + + + + + 访问的注册表位置(64位还是32位) + + + + + 访问的注册表节点 + + + + + 判断注册表项是否存在 + + + + + + + + + 删除注册表键(如果存在子键,子键将一并被删除) + + + + + + + + + + 删除注册表键值 + + + + + + + + + + 获取注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + 启动命令 + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + + + + + 把指定文件设置为开机启动或取消开机启动 + + 是否开机启动 + 开机启动名称 + 要开机启动的文件路径 + + + + + 检查是否开机启动 + + 开机启动名称 + 开机启动命令 + + + + + 检查是否开机启动 + + 开机启动名称 + + + + + 判断指定文件是否是开机启动 + + 开机启动名称 + 文件路径 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + 启动命令行 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置文件关联 + + 扩展名(如.apk) + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 设置文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 在指定文件格式右键菜单中增加菜单 + + 扩展名(如.apk) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 删除文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 获取文件关联是否存在 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 采用的IE模式 + + + + + IE7兼容视图 + + + + + IE8 标准模式 + + + + + IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE9 标准模式 + + + + + IE9 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE10 标准模式 + + + + + IE10 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置当前软件的浏览器控件内核版本 + + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + IE内核版本 + + + + + 设置当前软件的浏览器控件内核版本 + + IE内核版本 + + + + + 系统音量操作类 + + + + + 判断系统是否正处于静音(暂不支持XP或以下系统) + + + + + + 系统函数 + + + + + + + + + + 红 + + + + + 绿 + + + + + 蓝 + + + + + 获取屏幕伽马值 + + + + + + + + 设置屏幕伽马值 + + + + + + + + 获取键盘和鼠标没有操作的时间 + + + + + + 设置屏幕 Gamma值 + + + + + + + + + 设置屏幕亮度 + + + + + + + 获取系统名称,注意需要在app.manifest文件中设置兼容win10 + + + + + + SOURCE CODE FROM THE WEBSITE. + LAST UPDATE:WWW.VJSDN.COM易学论坛,2009/08/03 by Jonny Sun + + + + + Mutes the left hand channel and transfers audio fully to the right + + + + + Mutes the right hand channel and transfers audio fully to the left + + + + + 窗体操作类 + + + + + 构造函数 + + + + + + 析构 + + + + + 设置让窗体支持移动 + + + + + 是否允许可调节大小 + + + + + 可调节窗体大小的宽度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 提供一个任务调度程序，确保在ThreadPool之上运行时具有最大并发级别。 + + + + Whether the current thread is processing work items. + + + The list of tasks to be executed. + + + The maximum concurrency level allowed by this scheduler. + + + Whether the scheduler is currently processing work items. + + + + Initializes an instance of the LimitedConcurrencyLevelTaskScheduler class with the + specified degree of parallelism. + + The maximum degree of parallelism provided by this scheduler. + + + Queues a task to the scheduler. + The task to be queued. + + + + Informs the ThreadPool that there's work to be executed for this scheduler. + + + + Attempts to execute the specified task on the current thread. + The task to be executed. + + Whether the task could be executed on the current thread. + + + Attempts to remove a previously scheduled task from the scheduler. + The task to be removed. + Whether the task could be found and removed. + + + Gets the maximum concurrency level supported by this scheduler. + + + Gets an enumerable of the tasks currently scheduled on this scheduler. + An enumerable of the tasks currently scheduled. + + + + + + + + + + + + + + + + 开始截图 + + 是否截取鼠标指针 + + + + + 自动排列控件 + + + + + 最大列数 + + + + + 开始排列的坐标 + + + + + 下一项的位置 + + + + + 下一项的右下角坐标 + + + + + 竖向间隔像素 + + + + + 横向间隔像素 + + + + + 最小保留右边距,只对ReDraw2有效 + + + + + 自动排列控件构造函数 + + + + + + 自动排列控件构造函数 + + + + + + + + 开始排列控件 + + + + + 开始排列控件,当列数超过显示空间时，自动换行 + + + + + 加入的控件列表 + + + + + 初始化添加,自动将容器设置为滚动条自动显示 + + + + + + 添加控件 + + + + + + + 删除控件 + + + + + + 删除控件 + + + + + + 清空所有控件 + + + + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据当前节点生成HtmlDocument + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据XPath来查找节点 + + + + + + + + 在当前节点下根据xpath来查找符合的第一个节点 + + + + + + + + 在当前节点下根据xpath来查找所有符合的节点 + + + + + + + + A utility class to compute CRC32. + + + + + Compute a checksum for a given array of bytes. + + The array of bytes to compute the checksum for. + The computed checksum. + + + + Compute a checksum for a given string. + + The string to compute the checksum for. + The computed checksum. + + + + Represents an HTML attribute. + + + + + Gets the line number of this attribute in the document. + + + + + Gets the column number of this attribute in the document. + + + + + Gets the stream position of the value of this attribute in the document, relative to the start of the document. + + + + + Gets the length of the value. + + + + + + + + + + Gets the qualified name of the attribute. + + + + + Name of attribute with original case + + + + + Gets the HTML document to which this attribute belongs. + + + + + Gets the HTML node to which this attribute belongs. + + + + + Specifies what type of quote the data should be wrapped in + + + + + Specifies what type of quote the data should be wrapped in (internal to keep backward compatibility) + + + + + Gets the stream position of this attribute in the document, relative to the start of the document. + + + + + Gets or sets the value of the attribute. + + + + + Gets the DeEntitized value of the attribute. + + + + + Gets a valid XPath string that points to this Attribute + + + + + Compares the current instance with another attribute. Comparison is based on attributes' name. + + An attribute to compare with this instance. + A 32-bit signed integer that indicates the relative order of the names comparison. + + + + Creates a duplicate of this attribute. + + The cloned attribute. + + + + Removes this attribute from it's parents collection + + + + + An Enum representing different types of Quotes used for surrounding attribute values + + + + + A single quote mark ' + + + + + A double quote mark " + + + + + No quote mark + + + + + The initial value (current value) + + + + + Represents a combined list and collection of HTML nodes. + + + + + Gets the number of elements actually contained in the list. + + + + + Gets readonly status of colelction + + + + + Gets the attribute at the specified index. + + + + + Gets a given attribute from the list using its name. + + + + + Adds a new attribute to the collection with the given values + + + + + + + Adds supplied item to collection + + + + + Adds a range supplied items to collection. + An IEnumerable<HtmlAttribute> of items to append to this. + + + Adds a range supplied items to collection using a dictionary. + A Dictionary<string,string> of items to append to this. + + + + Explicit clear + + + + + Retreives existence of supplied item + + + + + + + Copies collection to array + + + + + + + Get Explicit enumerator + + + + + + Explicit non-generic enumerator + + + + + + Retrieves the index for the supplied item, -1 if not found + + + + + + + Inserts given item into collection at supplied index + + + + + + + Explicit collection remove + + + + + + + Removes the attribute at the specified index. + + The index of the attribute to remove. + + + + Inserts the specified attribute as the last attribute in the collection. + + The attribute to insert. May not be null. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The value of the attribute to insert. + The appended attribute. + + + + Checks for existance of attribute with given name + + + + + + + Inserts the specified attribute as the first node in the collection. + + The attribute to insert. May not be null. + The prepended attribute. + + + + Removes a given attribute from the list. + + The attribute to remove. May not be null. + + + + Removes an attribute from the list, using its name. If there are more than one attributes with this name, they will all be removed. + + The attribute's name. May not be null. + + + + Remove all attributes in the list. + + + + + Returns all attributes with specified name. Handles case insentivity + + Name of the attribute + + + + + Removes all attributes from the collection + + + + + Clears the attribute collection + + + + + Represents an HTML comment. + + + + + Gets or Sets the comment text of the node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Represents a complete HTML document. + + + + True to disable, false to enable the behavior tag p. + + + Default builder to use in the HtmlDocument constructor + + + Action to execute before the Parse is executed + + + + Defines the max level we would go deep into the html document + + + + The HtmlDocument Text. Careful if you modify it. + + + True to stay backward compatible with previous version of HAP. This option does not guarantee 100% compatibility. + + + + Adds Debugging attributes to node. Default is false. + + + + + Defines if closing for non closed nodes must be done at the end or directly in the document. + Setting this to true can actually change how browsers render the page. Default is false. + + + + + Defines if non closed nodes will be checked at the end of parsing. Default is true. + + + + + Defines if a checksum must be computed for the document while parsing. Default is false. + + + + + Defines if SelectNodes method will return null or empty collection when no node matched the XPath expression. + Setting this to true will return empty collection and false will return null. Default is false. + + + + True to disable, false to enable the server side code. + + + + Defines the default stream encoding to use. Default is System.Text.Encoding.Default. + + + + + Force to take the original comment instead of creating it + + + + + Defines if source text must be extracted while parsing errors. + If the document has a lot of errors, or cascading errors, parsing performance can be dramatically affected if set to true. + Default is false. + + + + + Defines the maximum length of source text or parse errors. Default is 100. + + + + + Defines if LI, TR, TH, TD tags must be partially fixed when nesting errors are detected. Default is false. + + + + + Defines if output must conform to XML, instead of HTML. Default is false. + + + + + If used together with and enabled, Xml namespaces in element names are preserved. Default is false. + + + + + Defines if attribute value output must be optimized (not bound with double quotes if it is possible). Default is false. + + + + Defines the global attribute value quote. When specified, it will always win. + + + + Defines if name must be output with it's original case. Useful for asp.net tags and attributes. Default is false. + + + + + Defines if name must be output in uppercase. Default is false. + + + + + Defines if declared encoding must be read from the document. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node. + Default is true. + + + + + Defines the name of a node that will throw the StopperNodeException when found as an end node. Default is null. + + + + + Defines if the 'id' attribute must be specifically used. Default is true. + + + + + Defines if empty nodes must be written as closed during output. Default is false. + + + + + The max number of nested child nodes. + Added to prevent stackoverflow problem when a page has tens of thousands of opening html tags with no closing tags + + + + + Creates an instance of an HTML document. + + + + Gets the parsed text. + The parsed text. + + + + Defines the max level we would go deep into the html document. If this depth level is exceeded, and exception is + thrown. + + + + + Gets the document CRC32 checksum if OptionComputeChecksum was set to true before parsing, 0 otherwise. + + + + + Gets the document's declared encoding. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node (pre-HTML5) or the meta charset="XXXXX" html node (HTML5). + + + + + Gets the root node of the document. + + + + + Gets the document's output encoding. + + + + + Gets a list of parse errors found in the document. + + + + + Gets the remaining text. + Will always be null if OptionStopperNodeName is null. + + + + + Gets the offset of Remainder in the original Html text. + If OptionStopperNodeName is null, this will return the length of the original Html text. + + + + + Gets the document's stream encoding. + + + + + Gets a valid XML name. + + Any text. + A string that is a valid XML name. + + + + + + + + + + + + + + + + + + + Applies HTML encoding to a specified string. + + The input string to encode. May not be null. + The encoded string. + + + + Determines if the specified character is considered as a whitespace character. + + The character to check. + true if if the specified character is considered as a whitespace character. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The new HTML attribute. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The value of the attribute. + The new HTML attribute. + + + + Creates an HTML comment node. + + The new HTML comment node. + + + + Creates an HTML comment node with the specified comment text. + + The comment text. May not be null. + The new HTML comment node. + + + + Creates an HTML element node with the specified name. + + The qualified name of the element. May not be null. + The new HTML node. + + + + Creates an HTML text node. + + The new HTML text node. + + + + Creates an HTML text node with the specified text. + + The text of the node. May not be null. + The new HTML text node. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The html is checked. + The detected encoding. + + + + Detects the encoding of an HTML text provided on a TextReader. + + The TextReader used to feed the HTML. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML text. + + The input html text. May not be null. + The detected encoding. + + + + Gets the HTML node with the specified 'id' attribute value. + + The attribute id to match. May not be null. + The HTML node with the matching id or null if not found. + + + + Loads an HTML document from a stream. + + The input stream. + + + + Loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Loads the HTML document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. May not be null. + + + + Loads the HTML document from the specified string. + + String containing the HTML document to load. May not be null. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. May not be null. + The character encoding to use. May not be null. + + + + Saves the HTML document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the HTML document to the specified TextWriter. + + The TextWriter to which you want to save. May not be null. + + + + Saves the HTML document to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. May not be null. + true to detect encoding, false otherwise. + + + + Detects the encoding of an HTML file. + + Path for the file containing the HTML document to detect. May not be null. + The detected encoding. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. May not be null. + The character encoding to use. May not be null. + + + + Creates a new XPathNavigator object for navigating this HTML document. + + An XPathNavigator object. The XPathNavigator is positioned on the root of the document. + + + + Flags that describe the behavior of an Element node. + + + + + The node is a CDATA node. + + + + + The node is empty. META or IMG are example of such nodes. + + + + + The node will automatically be closed during parsing. + + + + + The node can overlap. + + + + + A utility class to replace special characters by entities and vice-versa. + Follows HTML 4.0 specification found at http://www.w3.org/TR/html4/sgml/entities.html + Follows Additional specification found at https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references + See also: https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references + + + + + + + + + + A collection of entities indexed by name. + + + + + A collection of entities indexed by value. + + + + + Replace known entities by characters. + + The source text. + The result text. + + + + Clone and entitize an HtmlNode. This will affect attribute values and nodes' text. It will also entitize all child nodes. + + The node to entitize. + An entitized cloned node. + + + + Replace characters above 127 by entities. + + The source text. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + If set to true, the [quote], [ampersand], [lower than] and [greather than] characters will be entitized. + The result text + + + + Represents an HTML node. + + + + + Gets the name of a comment node. It is actually defined as '#comment'. + + + + + Gets the name of the document node. It is actually defined as '#document'. + + + + + Gets the name of a text node. It is actually defined as '#text'. + + + + + Gets a collection of flags that define specific behaviors for specific element nodes. + The table contains a DictionaryEntry list with the lowercase tag name as the Key, and a combination of HtmlElementFlags as the Value. + + + + + Initialize HtmlNode. Builds a list of all tags that have special allowances + + + + + Initializes HtmlNode, providing type, owner and where it exists in a collection + + + + + + + + Gets the collection of HTML attributes for this node. May not be null. + + + + + Gets all the children of the node. + + + + + Gets a value indicating if this node has been closed or not. + + + + + Gets the collection of HTML attributes for the closing tag. May not be null. + + + + + Gets the closing tag of the node, null if the node is self-closing. + + + + + Gets the first child of the node. + + + + + Gets a value indicating whether the current node has any attributes. + + + + + Gets a value indicating whether this node has any child nodes. + + + + + Gets a value indicating whether the current node has any attributes on the closing tag. + + + + + Gets or sets the value of the 'id' HTML attribute. The document must have been parsed using the OptionUseIdAttribute set to true. + + + + + Gets or Sets the HTML between the start and end tags of the object. + + + + + Gets the text between the start and end tags of the object. + + + + Gets direct inner text. + The direct inner text. + + + + Gets the last child of the node. + + + + + Gets the line number of this node in the document. + + + + + Gets the column number of this node in the document. + + + + + Gets the stream position of the area between the opening and closing tag of the node, relative to the start of the document. + + + + + Gets the stream position of the area of the beginning of the tag, relative to the start of the document. + + + + + Gets the length of the area between the opening and closing tag of the node. + + + + + Gets the length of the entire node, opening and closing tag included. + + + + + Gets or sets this node's name. + + + + + Gets the HTML node immediately following this element. + + + + + Gets the type of this node. + + + + + The original unaltered name of the tag + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets the to which this node belongs. + + + + + Gets the parent of this node (for nodes that can have parents). + + + + + Gets the node immediately preceding this node. + + + + + Gets the stream position of this node in the document, relative to the start of the document. + + + + + Gets a valid XPath string that points to this node + + + + + The depth of the node relative to the opening root html element. This value is used to determine if a document has to many nested html nodes which can cause stack overflows + + + + + Determines if an element node can be kept overlapped. + + The name of the element node to check. May not be null. + true if the name is the name of an element node that can be kept overlapped, false otherwise. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The newly created node instance. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The HTML Document builder. + The newly created node instance. + + + + Determines if an element node is a CDATA element node. + + The name of the element node to check. May not be null. + true if the name is the name of a CDATA element node, false otherwise. + + + + Determines if an element node is closed. + + The name of the element node to check. May not be null. + true if the name is the name of a closed element node, false otherwise. + + + + Determines if an element node is defined as empty. + + The name of the element node to check. May not be null. + true if the name is the name of an empty element node, false otherwise. + + + + Determines if a text corresponds to the closing tag of an node that can be kept overlapped. + + The text to check. May not be null. + true or false. + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Get Ancestors with matching name + + + + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Gets all anscestor nodes and the current node + + + + + + + Adds the specified node to the end of the list of children of this node. + + The node to add. May not be null. + The node added. + + + Sets child nodes identifier. + The chil node. + + + + Adds the specified node to the end of the list of children of this node. + + The node list to add. May not be null. + + + + Gets all Attributes with name + + + + + + + Creates a duplicate of the node + + + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + The cloned node. + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node. + + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node and the subtree under it. + + The node to duplicate. May not be null. + + + + Creates a duplicate of the node. + + The node to duplicate. May not be null. + true to recursively clone the subtree under the specified node, false to clone only the node itself. + + + + Gets all Descendant nodes for this node and each of child nodes + + The depth level of the node to parse in the html tree + the current element as an HtmlNode + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Get all descendant nodes with matching name + + + + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all descendant nodes including this node + + + + + + + Gets first generation child node matching name + + + + + + + Gets matching first generation child nodes matching name + + + + + + Gets data attribute. + The key. + The data attribute. + + + Gets the data attributes in this collection. + + An enumerator that allows foreach to be used to process the data attributes in this + collection. + + + + Gets the attributes in this collection. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + Gets the attributes in this collection. + A variable-length parameters list containing attribute names. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, + the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Inserts the specified node immediately after the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newNode is placed after the refNode. + The node being inserted. + + + + Inserts the specified node immediately before the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newChild is placed before this node. + The node being inserted. + + + + Adds the specified node to the beginning of the list of children of this node. + + The node to add. May not be null. + The node added. + + + + Adds the specified node list to the beginning of the list of children of this node. + + The node list to add. May not be null. + + + + Removes node from parent collection + + + + + Removes all the children and/or attributes of the current node. + + + + + Removes all the children of the current node. + + + + Removes all id for node described by node. + The node. + + + Move a node already associated and append it to this node instead. + The child node to move. + + + Move a children collection already associated and append it to this node instead. + The children collection already associated to move to another node. + + + Removes the children collection for this node. + The old children collection to remove. + + + + Removes the specified child node. + + The node being removed. May not be null. + The node removed. + + + + Removes the specified child node. + + The node being removed. May not be null. + true to keep grand children of the node, false otherwise. + The node removed. + + + + Replaces the child node oldChild with newChild node. + + The new node to put in the child list. + The node being replaced in the list. + The node replaced. + + + + Helper method to set the value of an attribute of this node. If the attribute is not found, it will be created automatically. + + The name of the attribute to set. May not be null. + The value for the attribute. + The corresponding attribute instance. + + + + Saves all the children of the node to the specified TextWriter. + + The TextWriter to which you want to save. + Identifies the level we are in starting at root with 0 + + + + Saves all the children of the node to a string. + + The saved string. + + + + Saves the current node to the specified TextWriter. + + The TextWriter to which you want to save. + identifies the level we are in starting at root with 0 + + + + Saves the current node to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Saves the current node to a string. + + The saved string. + + + + Sets the parent Html node and properly determines the current node's depth using the parent node's depth. + + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + true to throw Error if class name exists, false otherwise. + + + + Removes the class attribute from the node. + + + + + Removes the class attribute from the node. + + true to throw Error if class name doesn't exist, false otherwise. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + true to throw Error if class name doesn't exist, false otherwise. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + true to throw Error if class name doesn't exist, false otherwise. + + + Gets the CSS Class from the node. + + The CSS Class from the node + + + + Check if the node class has the parameter class. + The class. + True if node class has the parameter class, false if not. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type targetType including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Creates a new XPathNavigator object for navigating this HTML node. + + An XPathNavigator object. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document. + + + + Creates an XPathNavigator using the root of this document. + + + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects the first XmlNode that matches the XPath expression. + + The XPath expression. May not be null. + The first that matches the XPath query or a null reference if no matching node was found. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Includes tools that GetEncapsulatedData method uses them. + + + + + Determine if a type define an attribute or not , supporting both .NetStandard and .NetFramework2.0 + + Type you want to test it. + Attribute that type must have or not. + If true , The type parameter define attributeType parameter. + + + + Retrive properties of type that defined . + + Type that you want to find it's XPath-Defined properties. + IEnumerable of property infos of a type , that defined specific attribute. + + + + Determine if a has implemented BUT is considered as NONE-IEnumerable ! + + The property info you want to test. + True if property info is IEnumerable. + + + + Returns T type(first generic type) of or . + + IEnumerable-Implemented property + List of generic types. + + + + Find and Return a mehtod that defined in a class by it's name. + + Type of class include requested method. + Name of requested method as string. + Method info of requested method. + + + + Create of given type. + + Type that you want to make a List of it. + Returns IList of given type. + + + + Returns the part of value of you want as . + + A htmlNode instance. + Attribute that includes ReturnType + String that choosen from HtmlNode as result. + + + + Returns parts of values of you want as . + + that you want to retrive each value. + A instnce incules . + Type of IList generic you want. + + + + + Simulate Func method to use in Lambada Expression. + + + + + + + + + This method works like Where method in LINQ. + + + + + + + + + Check if the type can instantiated. + + + + + + + Returns count of elements stored in IEnumerable of T + + + + + + + + Specify which part of is requested. + + + + + The text between the start and end tags of the object. + + + + + The HTML between the start and end tags of the object + + + + + The object and its content in HTML + + + + + Just mark and flag classes to show they have properties that defined . + + + + + Includes XPath and . XPath for finding html tags and for specify which part of you want to return. + + + + + XPath Expression that is used to find related html node. + + + + + Html Attribute name + + + + + The methode of output + + + + + Specify Xpath to find related Html Node. + + + + + + Specify Xpath to find related Html Node. + + + Specify you want the output include html text too. + + + + Specify Xpath and Attribute to find related Html Node and its attribute value. + + + + + + + Tagging a property with this Attribute make Encapsulator to ignore that property if it causes an error. + + + + + Exception that often occures when there is no way to bind a XPath to a Html Tag. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no way to bind a XPath to a HtmlTag Attribute. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no property that assigned with XPath Property in Class. + + + + + + + + + + + + + + + + + + + + + + + Represents a combined list and collection of HTML nodes. + + + + + Initialize the HtmlNodeCollection with the base parent node + + The base node of the collection + + + Gets the parent node associated to the collection. + + + + Gets a given node from the list. + + + + + Get node with tag name + + + + + + + Gets the number of elements actually contained in the list. + + + + + Is collection read only + + + + + Gets the node at the specified index. + + + + + Add node to the collection + + + + + + Add node to the collection + + + + + + + Clears out the collection of HtmlNodes. Removes each nodes reference to parentnode, nextnode and prevnode + + + + + Gets existence of node in collection + + + + + + + Copy collection to array + + + + + + + Get Enumerator + + + + + + Get Explicit Enumerator + + + + + + Get index of node + + + + + + + Insert node at index + + + + + + + Remove node + + + + + + + Remove at index + + + + + + Get first instance of node in supplied collection + + + + + + + + Add node to the end of the collection + + + + + + Get first instance of node with name + + + + + + + Get index of node + + + + + + + Add node to the beginning of the collection + + + + + + Remove node at index + + + + + + + Replace node at index + + + + + + + Get all node descended from this collection + + + + + + Get all node descended from this collection with matching name + + + + + + Gets all first generation elements in collection + + + + + + Gets all first generation elements matching name + + + + + + + All first generation nodes in collection + + + + + + Represents an HTML navigator on an HTML document seen as a data store. + + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Gets the base URI for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the current HTML document. + + + + + Gets the current HTML node. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node is an empty element. + + + + + Gets the name of the current HTML node without the namespace prefix. + + + + + Gets the qualified name of the current node. + + + + + Gets the namespace URI (as defined in the W3C Namespace Specification) of the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the associated with this implementation. + + + + + Gets the type of the current node. + + + + + Gets the prefix associated with the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the text value of the current node. + + + + + Gets the xml:lang scope for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Creates a new HtmlNavigator positioned at the same node as this HtmlNavigator. + + A new HtmlNavigator object positioned at the same node as the original HtmlNavigator. + + + + Gets the value of the HTML attribute with the specified LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + The value of the specified HTML attribute. String.Empty or null if a matching attribute is not found or if the navigator is not positioned on an element node. + + + + Returns the value of the namespace node corresponding to the specified local name. + Always returns string.Empty for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns string.Empty for the HtmlNavigator implementation. + + + + Determines whether the current HtmlNavigator is at the same position as the specified HtmlNavigator. + + The HtmlNavigator that you want to compare against. + true if the two navigators have the same position, otherwise, false. + + + + Moves to the same position as the specified HtmlNavigator. + + The HtmlNavigator positioned on the node that you want to move to. + true if successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves to the HTML attribute with matching LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + true if the HTML attribute is found, otherwise, false. If false, the position of the navigator does not change. + + + + Moves to the first sibling of the current node. + + true if the navigator is successful moving to the first sibling node, false if there is no first sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the first HTML attribute. + + true if the navigator is successful moving to the first HTML attribute, otherwise, false. + + + + Moves to the first child of the current node. + + true if there is a first child node, otherwise false. + + + + Moves the XPathNavigator to the first namespace node of the current element. + Always returns false for the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the node that has an attribute of type ID whose value matches the specified string. + + A string representing the ID value of the node to which you want to move. This argument does not need to be atomized. + true if the move was successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves the XPathNavigator to the namespace node with the specified local name. + Always returns false for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the next sibling of the current node. + + true if the navigator is successful moving to the next sibling node, false if there are no more siblings or if the navigator is currently positioned on an attribute node. If false, the position of the navigator is unchanged. + + + + Moves to the next HTML attribute. + + + + + + Moves the XPathNavigator to the next namespace node. + Always returns falsefor the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the parent of the current node. + + true if there is a parent node, otherwise false. + + + + Moves to the previous sibling of the current node. + + true if the navigator is successful moving to the previous sibling node, false if there is no previous sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the root node to which the current node belongs. + + + + + Represents the type of a node. + + + + + The root of a document. + + + + + An HTML element. + + + + + An HTML comment. + + + + + A text node is always the child of an element or a document node. + + + + + Represents a parsing error found during document parsing. + + + + + Gets the type of error. + + + + + Gets the line number of this error in the document. + + + + + Gets the column number of this error in the document. + + + + + Gets a description for the error. + + + + + Gets the the full text of the line containing the error. + + + + + Gets the absolute stream position of this error in the document, relative to the start of the document. + + + + + Represents the type of parsing error. + + + + + A tag was not closed. + + + + + A tag was not opened. + + + + + There is a charset mismatch between stream and declared (META) encoding. + + + + + An end tag was not required. + + + + + An end tag is invalid at this position. + + + + + Represents an HTML text node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets or Sets the text of the node. + + + + + A utility class to get HTML document from HTTP. + + + + + Represents the method that will handle the PostResponse event. + + + + + Represents the method that will handle the PreHandleDocument event. + + + + + Represents the method that will handle the PreRequest event. + + + + + Occurs after an HTTP request has been executed. + + + + + Occurs before an HTML document is handled. + + + + + Occurs before an HTTP request is executed. + + + + + Gets or Sets a value indicating if document encoding must be automatically detected. + + + + + Gets or sets the Encoding used to override the response stream from any web request + + + + + Gets or Sets a value indicating whether to get document only from the cache. + If this is set to true and document is not found in the cache, nothing will be loaded. + + + + + Gets or Sets a value indicating whether to get document from the cache if exists, otherwise from the web + A value indicating whether to get document from the cache if exists, otherwise from the web + + + + + Gets or Sets the cache path. If null, no caching mechanism will be used. + + + + + Gets a value indicating if the last document was retrieved from the cache. + + + + + Gets the last request duration in milliseconds. + + + + + Gets the URI of the Internet resource that actually responded to the request. + + + + + Gets the last request status. + + + + + Gets or Sets the size of the buffer used for memory operations. + + + + + Gets or Sets a value indicating if cookies will be stored. + + + + Gets or sets a value indicating whether redirect should be captured instead of the current location. + True if capture redirect, false if not. + + + + Gets or Sets the User Agent HTTP 1.1 header sent on any webrequest + + + + + Gets or Sets a value indicating whether the caching mechanisms should be used or not. + + + + + Gets the MIME content type for a given path extension. + + The input path extension. + The default content type to return if any error occurs. + The path extension's MIME content type. + + + + Gets the path extension for a given MIME content type. + + The input MIME content type. + The default path extension to return if any error occurs. + The MIME content type's path extension. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The requested type. + An newly created instance. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. - Proxy aware + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. Understands Proxies + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + + Gets the cache file path for a specified url. + + The url fo which to retrieve the cache path. May not be null. + The cache file path. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The XmlTextWriter to which you want to save to. + + + Gets or sets the web browser timeout. + + + + Gets or sets the web browser delay. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + An newly created instance. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + An newly created instance. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". May not be null. + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + + + + Represents an exception thrown by the HtmlWeb utility class. + + + + + Creates an instance of the HtmlWebException. + + The exception's message. + + + + Represents a document with mixed code and text. ASP, ASPX, JSP, are good example of such documents. + + + + + Gets or sets the token representing code end. + + + + + Gets or sets the token representing code start. + + + + + Gets or sets the token representing code directive. + + + + + Gets or sets the token representing response write directive. + + + + + Creates a mixed code document instance. + + + + + Gets the code represented by the mixed code document seen as a template. + + + + + Gets the list of code fragments in the document. + + + + + Gets the list of all fragments in the document. + + + + + Gets the encoding of the stream used to read the document. + + + + + Gets the list of text fragments in the document. + + + + + Create a code fragment instances. + + The newly created code fragment instance. + + + + Create a text fragment instances. + + The newly created text fragment instance. + + + + Loads a mixed code document from a stream. + + The input stream. + + + + Loads a mixed code document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads the mixed code document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Loads a mixed document from a text + + The text to load. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + The character encoding to use. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + The character encoding to use. + + + + Saves the mixed document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the mixed document to the specified TextWriter. + + The TextWriter to which you want to save. + + + + Represents a fragment of code in a mixed code document. + + + + + Gets the fragment code text. + + + + + Represents a base class for fragments in a mixed code document. + + + + + Gets the fragement text. + + + + + Gets the type of fragment. + + + + + Gets the line number of the fragment. + + + + + Gets the line position (column) of the fragment. + + + + + Gets the fragment position in the document's stream. + + + + + Represents a list of mixed code fragments. + + + + + Gets the Document + + + + + Gets the number of fragments contained in the list. + + + + + Gets a fragment from the list using its index. + + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Appends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Prepends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Remove a fragment from the list of fragments. If this fragment was not in the list, an exception will be raised. + + The fragment to remove. May not be null. + + + + Remove all fragments from the list. + + + + + Remove a fragment from the list of fragments, using its index in the list. + + The index of the fragment to remove. + + + + Represents a fragment enumerator. + + + + + Gets the current element in the collection. + + + + + Gets the current element in the collection. + + + + + Advances the enumerator to the next element of the collection. + + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + + + + Sets the enumerator to its initial position, which is before the first element in the collection. + + + + + Represents the type of fragment in a mixed code document. + + + + + The fragment contains code. + + + + + The fragment contains text. + + + + + Represents a fragment of text in a mixed code document. + + + + + Gets the fragment text. + + + + + 给控件增加拖放功能的类 + + + + + 拖放实例 + + + + + 高级拖放事件 + + + + + + + + + + + + + + + + + + + + + + + + + 使管理员方式运行时支持拖放 + + + + + + 使支持拖放属性 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取WMI内容 + + + + + + + 获取WMI内容 + + + + + + + 获取内存信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取硬盘信息 + + + + + + 获取主板信息 + + + + + + 获取处理器信息 + + + + + + 获取主要硬件信息 + + + + + + 获取主要硬件信息 + + 是否获取XML格式 + + + + + 网络操作类 + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 根据mac字符串来获取最终的mac地址,可以是各种MAC地址格式,非法的内容将返回null + + + + + + + 远程唤醒 + + + + + + + + 远程唤醒 + + + + + + + + + 消息服务器 + + + + + 消息事件 + + + + + + + 大小改变事件 + + + + + + + + 即将关闭事件 + + + + + + + 当收到消息时激发 + + + + + 消息处理类 + + + + + + + + + + + + + + + + + + + + + + + 发送消息,采用单线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 发送消息，采用多线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 消息类 + + + + + 是否取消 + + + + + 来源句柄 + + + + + + + + + + 消息文本 + + + + + 需要回复的内容 + + + + + 消息客户端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 最后一次接收消息的时间,可用来判断服务端是否有响应 + + + + + 主句柄 + + + + + 当收到消息时激发 + + + + + 连接上主服务器时触发 + + + + + 收到服务端关闭通知 + + + + + 收到服务端关闭通知，即将关闭 + + + + + 服务端大小改变时激发 + + + + + 实例化客户端 + + 服务端ID + 当前客户端ID,会向服务器报告当前ID + 客户端 + + + + + + + + + 断开服务端连接 + + + + + 发送消息,采用多线程发送 + + + + + + + 向服务端发送心跳包 + + + + + 判断服务端句柄是否存在。 + + + + + + 消息服务端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 当收到消息时激发 + + + + + 当收到自定义消息时(非系统消息)激发 + + + + + 有消息客户端发起连接请求时激发 + + + + + 有消息客户端连接成功时激发 + + + + + 有消息客户端断开连接时激发 + + + + + + + 服务端ID,需要唯一性,共客户端识别 + 服务端 + + + + 释放资源 + + + + + 判断是否包含指定客户端 + + + + + + + + + + + + 设置客户端大小 + + + + + 根据客户端ID,获取客户端对象 + + + + + + + 根据客户端句柄,获取客户端对象 + + + + + + + 关闭所有客户端 + + + + + 关闭指定客户端 + + + + + + 关闭指定客户端 + + + + + + 向所有客户端发送消息，单线程 + + + + + + + 向指定客户端发送消息 + + + + + + + + 关闭在指定时间前失去响应的子客户端 + + + + + + 客户端信息 + + + + + 客户端句柄 + + + + + 客户端ID + + + + + 客户端连接时间 + + + + + 心跳时间 + + + + + 共享内存 + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 删除内存映射 + + + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + 发送消息的窗口句柄 + 发送消息 + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射对象 + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射字节数据 + + + + 数据库引擎 + + + + + 数据库枚举类型 + + + + + Odbc引擎 + + + + + OleDb引擎 + + + + + Oracle引擎 + + + + + MSSQL引擎 + + + + + SQLite引擎 + + + + + MySql引擎 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据 + + + + + + + 获取第一行第一列的值 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + + 建立访问数据库的实例 + + 数据库枚举类型 + + + + + 数据库操作接口 + + + + + 连接数据库 + + + + + + 数据库是否已连接 + + + + + 断开数据库 + + + + + + 获取数量 + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + + 获取分页语句 + + + + + + + + + + 添加Parameter参数 + + + + + + + 清空Parameter参数 + + + + + + + 获取Parameter值 + + + + + + 根据RyQuickSQL类来获取Parameter值 + + + + + + + 开始执行事务 + + + + + 提交事务 + + + + + 判断是否包含数据 + + + + + + + + 返回-1000表示该数据库不支持本接口 + + + + + + + 读取数据 + + + + + + + 读取数据 + + + + + + + + 读取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + 执行SQL语句 + + + + + + + 根据id号删除数据 + + + + + + + + 根据id号删除数据 + + + + + + + + 创建数据库 + + + + + + + 释放资源 + + + + + 最后一个错误信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + SQL字段类型 + + + + + SQL字段类型 + + + + + + + SQL字段类型 + + + + + + + + SQL字段名 + + + + + SQL字段值 + + + + + SQL字段长度 + + + + + 不是真的值，而是用于计算的值 + + + + + SQL快速操作类 + + + + + SQL快速操作类 + + + + + + 表名 + + + + + 操作字段列表 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + + + + + + + + 操作参数列表 + + + + + 操作参数列表 + + + + + 添加字符串字段 + + + + + + + 添加null值字段 + + + + + + 添加日期字段 + + + + + + + 添加int字段 + + + + + + + 添加double字段 + + + + + + + 添加decimal字段 + + + + + + + 添加byte[]字段 + + + + + + + 添加bool字段 + + + + + + + 添加用于计算的值 + + + + + + + 添加Int64字段 + + + + + + + 清空内容 + + + + + 数量 + + + + + + + + + + 输出多条件搜索。 + + 字段名,多个字段请用逗号分隔。 + 多个条件之间请用空格隔开 + + + + + 获取插入SQL语句 + + + + + + 获取更新SQL语句 + + + + + + 添加参数 + + + + + + + 获取Ole参数 + + + + + + 获取SQL参数 + + + + + + + + + + + + + + + + + + + + + + + 数据库路径 + 数据库密码 + + + + + + + 数据库路径 + + + + + + + + + + + + + + + + + + + + 连接数据库 + + + + + + 设置路径和密码 + + + + + + 连接数据库 + + + + + + + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 创建数据库 + + SQL语句 + + + + + 根据内置例子创建数据库 + + + + + + 保存信息，如果Name不存在，系统会自动创建 + + 返回1，表示成功，0表示失败 + + + + 获取信息 + + + + + + 获取信息 + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Http连接操作帮助类 + + + + + + + + + + + + 根据相传入的数据，得到相应页面数据 + + 参数类对象 + 返回HttpResult类型 + + + + 获取数据的并解析的方法 + + + + + + + 设置编码 + + HttpItem + HttpResult + byte[] + + + + 提取网页Byte + + + + + + 为请求准备参数 + + 参数列表 + + + + 设置证书 + + + + + + 设置多个证书 + + + + + + 设置Cookie + + Http参数 + + + + 设置Post数据 + + Http参数 + + + + 设置代理 + + 参数对象 + + + + 回调验证证书问题 + + 流对象 + 证书 + X509Chain + SslPolicyErrors + bool + + + + 通过设置这个属性，可以在发出连接的时候绑定客户端发出连接所使用的IP地址。 + + + + + + + + + Http请求参考类 + + + + + 请求URL必须填写 + + + + + 请求方式默认为GET方式,当为POST方式时必须设置Postdata的值 + + + + + 默认请求超时时间 + + + + + 默认写入Post数据超时间 + + + + + 设置Host的标头信息 + + + + + 获取或设置一个值，该值指示是否与 Internet 资源建立持久性连接默认为true。 + + + + + 请求标头值 默认为text/html, application/xhtml+xml, */* + + + + + 请求返回类型默认 text/html + + + + + 客户端访问信息默认Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0) + + + + + 返回数据编码默认为NUll,可以自动识别,一般为utf-8,gbk,gb2312 + + + + + Post的数据类型 + + + + + Post请求时要发送的字符串Post数据 + + + + + Post请求时要发送的Byte类型的Post数据 + + + + + Cookie对象集合 + + + + + 请求时的Cookie + + + + + 来源地址，上次访问地址 + + + + + 证书绝对路径 + + + + + 设置代理对象，不想使用IE默认配置就设置为Null，而且不要设置ProxyIp + + + + + 是否设置为全文小写，默认为不转化 + + + + + 获取或设置要在 HTTP 请求中使用的 Date HTTP 标头值。默认不填写 + + + + + 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 + + + + + 最大连接数 + + + + + 代理Proxy 服务器用户名 + + + + + 代理 服务器密码 + + + + + 代理 服务IP,如果要使用IE代理就设置为ieproxy + + + + + 设置返回类型String和Byte + + + + + header对象 + + + + + 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 + + + + + 获取或设置一个 System.Boolean 值，该值确定是否使用 100-Continue 行为。如果 POST 请求需要 100-Continue 响应，则为 true；否则为 false。默认值为 true。 + + + + + 设置509证书集合 + + + + + 设置或获取Post参数编码,默认的为Default编码 + + + + + Cookie返回类型,默认的是只返回字符串类型 + + + + + 获取或设置请求的身份验证信息。 + + + + + 设置请求将跟随的重定向的最大数目 + + + + + 获取和设置IfModifiedSince，默认为当前日期和时间 + + + + + 设置本地的出口ip和端口 + ] + + item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); + + + + + 是否重置request,response的值，默认不重置，当设置为True时request,response将被设置为Null + + + + + Http返回参数类 + + + + + Http请求返回的Cookie + + + + + Cookie对象集合 + + + + + 返回的String类型数据 只有ResultType.String时才返回数据，其它情况为空 + + + + + 返回的Byte数组 只有ResultType.Byte时才返回数据，其它情况为空 + + + + + header对象 + + + + + 返回状态说明 + + + + + 返回状态码,默认为OK + + + + + 最后访问的URl + + + + + 获取重定向的URl + + + + + 返回类型 + + + + + 表示只返回字符串 只有Html有数据 + + + + + 表示返回字符串和字节流 ResultByte和Html都有数据返回 + + + + + Post的数据格式默认为string + + + + + 字符串类型，这时编码Encoding可不设置 + + + + + Byte类型，需要设置PostdataByte参数的值编码Encoding可设置为空 + + + + + 传文件，Postdata必须设置为文件的绝对路径，必须设置Encoding的值 + + + + + Cookie返回类型 + + + + + 只返回字符串类型的Cookie + + + + + CookieCollection格式的Cookie集合同时也返回String类型的cookie + + + + + Http服务器类 + + + + + + + + + + + + 当收到Get事件时激发 + + + + + 当收到Post事件时激发 + + + + + 监听的主机,默认是localhost + + + + + 最后一次错误信息 + + + + + 在此端口建立Http服务类 + + 端口号 + + + + + + + + + + 开始服务 + + + + + 退出服务 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超时时间 + + + + 以post方式获取网页源码 + + + + + + + + + 以post方式提交json内容 + + + + + + + + + 以post方式提交json内容 + + + + + + + + 头信息 + + + + + 以post方式获取网页源码 + + + + + + + + + + 以post方式获取网页源码 + + + + + + + + 获取网址对应的文件大小 + + + + + + + 获取网址对应的文件大小 + + + + + + + + 获取网址对应的文件大小 + + + + + + + + + 代理 + + + + + 代理用户名 + + + + + 代理密码 + + + + + + + + + + 是否自动跳转 + + + + + 获取网页源码 + + + + + + + + + + 获取网页源码 + + + + + + + + 获取网页源码 + + + + + + + + 获取网页源码 + + + + + + + + + 获取网页源码 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将相对网址转换成绝对网址 + + 相对网址 + 当前页面地址 + 转换后的绝对网址 + + + + WebDav接口 + + + + + WebDav初始化 + + + + + + + + 删除文件 + + 相对路径,不包括域名 + + + + + 下载文件 + + + + + + + + 下载文件 + + + + + + + + + 上传文件 + + + + + + + + 上传文件 + + + + + + + + + 新建文件夹 + + + + + + + 新建文件夹 + + 文件夹路径 + + + + + + 新建文件夹 + + + + + + + + 将文件或目录列出来 + + + + + + + + 定义每个文件或目录的属性 + + + + + 文件名 + + + + + 是否是文件夹 + + + + + 网址 + + + + + 最后修改时间 + + + + + + + + + + + + + + + url解密 + + + + + + + + url解密,按UTF8方式解密 + + + + + + + Url加密 + + + + + + + + Url加密,按UTF8方式加密 + + + + + + + 解密 + + + + + + + 加密 + + + + + + + + + + + + + + + + + + + + + + + + + url加密,Unicode + + + + + + + + + + + + + + + + + + + + + + Html解码,将html里未转义成功的重新转义。 + + + + + + + 将url里的字段分解成表单字典 + + + + + + + + + 根据表单字段名获取值 + + + + + + + + + AES加密解密类 + + + + + AES加密算法 + + 明文字符串 + 密钥 + 返回加密后的密文字节数组 + + + + AES解密 + + 密文字节数组 + 密钥 + 返回解密后的字符串 + + + + 加密 + + + + + + + + 解码 + + + + + + + + 转换密钥到合法密钥 + + + + + + + Base64编码类 + + + + + 编码 + + + + + + + 把字符串编码成Base64字符串 + + + + + + + + 解码 + + + + + + + MD5和SHA1操作类 + + + + + 计算文件MD5。 + 通过MD5CryptoServiceProvider类中的ComputeHash方法直接传入一个FileStream类实现计算MD5 + 操作简单，代码少，调用即可 + + 文件地址 + MD5Hash + + + + 计算文件MD5。 + 通过HashAlgorithm的TransformBlock方法对流进行叠加运算获得MD5 + 实现稍微复杂，但可使用与传输文件或接收文件时同步计算MD5值 + 可自定义缓冲区大小，计算速度较快 + + 文件地址 + MD5Hash + + + + 获取MD5 + + + + + + + 获取MD5 + + + + + + + 获取SHA1 + + + + + + + 获取SHA1 + + + + + + + 获取HmacSHA1 + + + + + + + + 获取SHA256 + + + + + + + 获取HmacSHA256 + + + + + + + + 获取SHA224 + + + + + + + 获取SHA512 + + + + + + + 获取HmacSHA512 + + + + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 内部类 + + + + 读写锁对象 + + + + 是否为写入模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 构造函数 + + 读写锁 + 写入模式为true,读取模式为false + + + 释放对象时退出指定锁定模式 + + + + 空的可释放对象,免去了调用时需要判断是否为null的问题 + 内部类 + + + + 空的可释放对象 + + + + 空的释放方法 + + + + 读写锁 + + + + 保存数据 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + 为Data属性设置初始值 + + + + 获取或设置当前对象中保存数据的值 + + 获取数据时未进入读取或写入锁定模式 + 设置数据时未进入写入锁定模式 + + + 是否启用,当该值为false时,Read()和Write()方法将返回 Disposable.Empty + + + + 进入读取锁定模式,该模式下允许多个读操作同时进行 + 退出读锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在读取或写入锁定模式下重复执行,返回Disposable.Empty; + + + + 进入写入锁定模式,该模式下只允许同时执行一个写操作 + 退出写锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在写入锁定模式下重复执行,返回Disposable.Empty; + + 读取模式下不能进入写入锁定状态 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Shell + + + + + 根据路径获取 IShellFolder 和 PIDL + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 弹出系统右键菜单 + + + + + + + + 中国农历类,最大支持公元0-9999年 + + 日期：2019-02-09 + 作者：http://www.cnblogs.com/zjfree/ + + + + 日历类型 + + + + + 无效 + + + + + Julian 日历 + + + + + Gregorian 日历 + + + + + 有效 + + + + + 公历节日 + + + + + 农历节日 + + + + + 某个月第n个星期几 + + + + + 获取农历 + + + + + + + 获取农历 + + + + + + + + + 获得某农历年的闰月，返回 1~12 对应一月到十二月，返回 0 表示无闰月 + + + + + + + 农历搜索方向 + + + + + 无效 + + + + + 向上 + + + + + 向下 + + + + + {* 日月食类型， 无， 日食， 月全食， 月偏食 } + + + + + 无 + + + + + 日食 + + + + + 月全食 + + + + + 月偏食 + + + + + {* 月相， 无， 朔， 望} + + + + + 无 + + + + + 朔 + + + + + 望 + + + + + 获得某公历年月日的农历日数和该日月相以及日月食类型和时刻 + + + + + + + + + + + + 获得某公历年月日的农历月数 + + + + + + + + + 获取阳历日期对应的农历日期 + + + + + + + + + + + + + 获得某公历年月日的农历月日和是否闰月的信息 + + + + + + + + + + + + 获得等效标准日数对应的某公历日，倒推而来 + + + + + + + + + + 比较两个农历日期（包括闰月信息），1 大于2返回1、1等于2返回0、1小于2返回-1 + + + + + + + + + + + + + + 获得某农历年月日（加是否闰月）的公历年月日 + 该函数采用反向二分法查找 + + + + + + + + + + + + + 获取农历某一个月的总天数 + + + + + + + + + 获取农历年份，范围约1901-2101年 + + + + + + + 获取农历年份，范围约0-9999年 + + + + + + + + + 获取农历月份，范围约1901-2101年 + + + + + + + 获取农历月份，范围约0-9999年 + + + + + + + + + 获取中文表示的农历月份 + + + + + + + 获取农历日，范围约1901-2101年 + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 返回y年第n个节气（如小寒为1）的日差天数值（pd取值真假，分别表示平气和定气） + + + + pd取值真假，分别表示平气和定气 + + + + + 获取等效标准日数 + + + + + + + + + 取本月天数，不考虑 1582 年 10 月的特殊情况 + + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 获取节气 + + + + + + + + + + + + 获取公历节日 + + + + + + + 获取公历节日 + + + + + + + + + 获取指定月份的第n个星期几的节日 + + + + + + + 返回星座，范围约1901-2101年 + + + + + 返回星座，范围约0-9999年 + + + + + 获取农历节日 + + + + + + + + + 获取农历节日 + + + + + + + 判断y年m月(1,2,..,12,下同)d日是Gregorian历还是Julian历（opt=1,2,3分别表示标准日历,Gregorge历和Julian历）,是则返回1，是Julian历则返回0，若是Gregorge历所删去的那10天则返回-1 + + + + + 返回阳历y年m月d日的日差天数（在y年年内所走过的天数，如2000年3月1日为61） + + + + + 返回阳历y年日差天数为x时所对应的月日数（如y=2000，x=274时，返回1001(表示10月1日，即返回100*m+d)） + + + + + 获取指定日期的节气。 + + 要获取的年 + 要获取的月 + + + 立春：立是开始的意思，春是蠢动，表示万物开始有生气，这一天春天开始。 + 雨水：降雨开始，雨水将多。 + 惊蛰：春雷响动，惊动蛰伏地下冬眠的生物，它们将开始出土活动。 + 春分：这是春季九十天的中分点，这一天昼夜相等，所以古代曾称春分秋分为昼夜分。 + 清明：明洁晴朗，气候温暖，草木开始萌发繁茂。 + 谷雨：雨生百谷的意思。雨水增多，适时的降雨对谷物生长很为有利。 + 立夏：夏天开始，万物渐将随温暖的气候而生长。 + 小满：满指籽粒饱满，麦类等夏热作物这时开始结籽灌浆，即将饱满。 + 芒种：有芒作物开始成熟，此时也是秋季作物播种的最繁忙时节。 + 夏至：白天最长，黑夜最短，这一天中午太阳位置最高，日影短至终极，古代又称这一天为日北至或长日至。 + 小暑：暑是炎热，此时还未到达最热。 + 大暑：炎热的程度到达高峰。 + 立秋：秋天开始，植物快成熟了。 + 处暑：处是住的意思，表示暑气到此为止。 + 白露：地面水气凝结为露，色白，是天气开始转凉了。 + 秋分：秋季九十天的中间，这一天昼夜相等，同春分一样，太阳从正东升起正西落下。 + 寒露：水露先白而后寒，是气候将逐渐转冷的意思。 + 霜降：水气开始凝结成霜。 + 立冬：冬是终了，作物收割后要收藏起来的意思，这一天起冬天开始。 + 小雪：开始降雪，但还不多。 + 大雪：雪量由小增大。 + 冬至：这一天中午太阳在天空中位置最低，日影最长，白天最短， 黑夜最长，古代又称短日至或日南至。 + 小寒：冷气积久而为寒，此时尚未冷到顶点。 + 大寒：天候达到最寒冷的程度 + + + + + 获取年柱。 + + + + + 获得月柱 + + + + + + + 获取日柱。 + + + + + 返回甲子数x对应的天干数（如33为3） + + + + + 返回甲子数x对应的地支数（如33为9） + + + + + 获取日的天干地支 + + + + + + + 返回甲子数x对应的天干字符串 + + + + + 返回甲子数x对应的地支字符串 + + + + + 返回甲子数x对应的干支字符串 + + + + + + + 获取三伏开始时间 + + + 0表示1伏，1表示2伏，2表示3伏 + + + + + 节气 + + + + + 节气的时间。 + + + + + 节气名。 + + + + + 热键转换类 + + + + + 功能键。 + + + + + 修改键。 + + + + + 转换功能键到谷歌浏览器专用 + + + + + 将chrome功能键转换为普通功能键 + + + + + + + 按键值。 + + + + + 初始化类 的新实例。 + + The modifiers. + The key code. + + + + + + + + + + + + + + + + + 初始化类 的新实例。 + + + + + 加载热键 + + + + + + + 加载热键 + + + + + + 加载热键 + + + + + + 判断是否是热键 + + + + + 获取当前热键 + + + + + 已重载，返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 功能键 + + + + + 无 + + + + + Alt键 + + + + + Ctrl键 + + + + + Alt+Ctrl键 + + + + + Shift键 + + + + + Shift+Alt键 + + + + + Shift+Ctrl键 + + + + + Alt+Shift+Ctrl键 + + + + + Win键 + + + + + 热键类 + + + + + 热键类 + + + + + + 热键注销 + + + + + 热键是否有效 + + + + + 释放热键 + + + + + 获取热键Tag + + + + + + + 获取热键id + + + + + + + 获取热键id + + + + + + + + 判断热键id是否存在 + + + + + + + 判断热键Tag是否存在 + + + + + + + 判断热键是否存在 + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + + 获取热键数量 + + + + + 删除热键 + + + + + + + 删除所有热键 + + + + + 删除所有热键 + + + + + 热键事件 + + + + + + 当使用热键时发生的事件 + + + + + 热键消息过滤 + + + + + + + 热键类型 + + + + + 热键id + + + + + 热键Tag + + + + + 功能键 + + + + + 普通键 + + + + + 热键类型 + + + + + + + + 热键类型 + + + + + + + + + 热键类型 + + + + + Win32 API + + + + + + + + + + WM_COPYDATA消息的主要目的是允许在进程间传递只读数据。 + + + + + 系统通道ID + + + + + 用户通道ID + + + + + 获取消息 + + + + + + + + 发送消息 + + + + + + + + + + 设置父窗口 + + + + + + + + + + + + + + 删除一个逻辑笔、画笔、字体、位图、区域或者调色板，释放所有与该对象有关的系统资源，在对象被删除之后，指定的句柄也就失效了。 + + + + + + + 选择一对象到指定的设备上下文环境中，该新对象替换先前的相同类型的对象。 + + + + + + + + 创建一个与指定设备兼容的内存设备上下文环境（DC）。 + + + + + + + 为一个设备创建设备上下文环境。 + + + + + + + + + + 删除指定的设备上下文环境（Dc）。 + + + + + + + + + + + + 结束进程 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 模拟鼠标点击 + + + + + + + + + + + 模拟按键 + + + + + + + + + 返回hWnd参数所指定的窗口的设备环境。 + + + + + + + 移动窗口 + + + + + + + + + + + + 将消息信息传送给指定的窗口过程的函数。使用函数CallWindowsProc可进行窗口子分类。 + 通常来说，同一类的所有窗口共享一个窗口过程。子类是一个窗口或者相同类的一套窗口， + 在其消息被传送到该类的窗口过程之前，这些消息是由另一个窗口过程进行解释和处理的。 + + + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 设置弹出式窗口，层叠窗口或子窗口的父窗口 + + + + + + + + 获得一个指定子窗口的父窗口句柄 + + Handle to the window whose parent window handle is to be retrieved. + If the window is a child window, the return value is a handle to the parent window. If the window is a top-level window, the return value is a handle to the owner window. If the window is a top-level unowned window or if the function fails, the return value is NULL. + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作 + + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作。 + 如果此参数为FALSE，GetSystemMenu返回当前使用窗口菜单的拷贝的句柄。该拷贝初始时与窗口菜单相同，但可以被修改。 + 如果此参数为TRUE，GetSystemMenu重置窗口菜单到缺省状态。如果存在先前的窗口菜单，将被销毁。 + + 如果参数bRevert为FALSE，返回值是窗口菜单的拷贝的句柄：如果参数bRevert为TRUE，返回值是NULL。 + + + + 从指定菜单删除一个菜单项或分离一个子菜单。 + 备注：只要一个菜单被修改，无论它是否在显示窗口里，应用程序都必须调用函数DrawMenuBar。 + + 将被修改的菜单的句柄。 + 指定将被删除的菜单项，其含义由参数wFlags决定。 + + 如果函数调用成功，返回非零值；如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。 + + + + 设置前台窗口 + + + + + + + 获取当前前台窗口句柄 + + + + + + 获得当前活动窗体 + + 活动窗口的句柄。如没有窗口处于活动状态或处于活动状态的窗口非当前线程创建，则返回零。 + + + + 设置活动窗体 + + + + + + + 获取类名 + + + + + + + + + 获取当前线程对应的进程ID + + + + + + + + 判断指定句柄是否是一个窗口 + + + + + + + 获取窗口标题 + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + 从文件中载入指针 + + + + + + + 判断窗口是否可见 + + + + + + + 查找窗口 + + + + + + + + The FindWindowEx function retrieves a handle to a window whose class name and window name match the specified strings. The function searches child windows, beginning with the one following the specified child window. + + Handle to the parent window whose child windows are to be searched. + Handle to a child window. + Specifies class name. + Pointer to a null-terminated string that specifies the window name (the window's title). + If the function succeeds, the return value is a handle to the window that has the specified class and window names.If the function fails, the return value is NULL. + + + + The InvalidateRect function adds a rectangle to the specified window's update region. + + Handle to window. + Rectangle coordinates. + Erase state. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + The ValidateRect function validates the client area within a rectangle by removing the rectangle from the update region of the specified window. + + Handle to window. + Validation rectangle coordinates. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + 获取指定窗口的有关信息，也可用于获取窗口内存中指定偏移的32位度整型值。 + + + + + + + + 检索一指定窗口的客户区域或整个屏幕的显示设备上下文环境的句柄，以后可以在GDI函数中使用该句柄来在设备上下文环境中绘图。 + + + + + + + 释放设备上下文环境（DC）供其他应用程序使用。函数的效果与设备上下文环境类型有关。它只释放公用的和设备上下文环境，对于类或私有的则无效。 + + + + + + + + 获取桌面句柄 + + + + + + 获取窗口客户区的大小。注意一下：窗口的客户区为窗口中除标题栏、菜单栏之外的地方。 + + + + + + + + 返回指定窗口的边框矩形的尺寸。该尺寸以相对于屏幕坐标左上角的屏幕坐标给出。 + + + + + + + + 更新一个分层窗口的位置，大小，形状，内容和半透明度 + + + + + + + + + + + + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + + + + + + + + + + + + 设置指针位置 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使用的数据库接口 + + + + + 使用的数据库连接字符串 + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 使用的数据库接口 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + FTP数据管理类(不含上传下载功能) + + + + + + + + + + + + 获取指定id的FTP信息 + + + + + + + 获取指定name的FTP信息 + + + + + + + 打开FTP管理界面 + + + + + 创建SQLite数据库表 + + + + + FTP信息 + + + + + id + + + + + 名称 + + + + + IP + + + + + 端口 + + + + + 用户名 + + + + + 密码 + + + + + 远程目录 + + + + + 加密方式 + + + + + 添加时间 + + + + + + + + + + 备注 + + + + + 添加时间字符串 + + + + + 设置 + + + + + 部门列表 + + + + + + + + + + 远程文件信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 升级地址 + + + + + + + + + + 隔多久后再次检查更新 + + + + + 本地保存的配置信息 + + + + + 当前安装的软件版本 + + + + + 当前安装的软件修正版本 + + + + + 当前安装的数据库版本 + + + + + + + + + + + + + + + + + + + + 获取当前更新的类型 + + + + + 每隔n小时检测一次更新 + + + + + 读取版本信息完成后激发 + + + + + 没有版本更新时激发 + + + + + 发现新版本时激发 + + + + + 发生错误后激发 + + + + + 更新进度变化后激发 + + + + + 开始检测新版本 + + + + + + + + + + 初始化升级函数 + + 为null,则表示事件运行在多线程模式下，否则,事件是在窗体所在线程下 + + + + + + + + + + + + + + 获取版本信息 + + + + + 开始下载 + + + + + 开始下载 + + + + + 下载,不使用多线程 + + + + + 结束下载 + + + + + + + + + + + + + + + 设置升级 + + + + + 是否是在线更新 + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + 提示文本 + + + + + 更新日期 + + + + + 更新版本 + + + + + 更新描述 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新类型,soft或者data + + + + + 更新描述Url + + + + + 更新描述 + + + + + 版本 + + + + + 更新日期 + + + + + 更新地址 + + + + + 在下载升级包前首先要下载的内容 + + + + + 升级程序要使用的设置xml + + + + + + + + + + 错误字符串 + + + + + 错误id + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前登陆用户 + + + + + + + + + + 没有版本更新时激发 + + + + + + + + + + + 取消更新。 + + + + + + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 Docking 的本地化字符串。 + + + + + 查找类似 Docking Notification 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 Property Changed 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 Determines if end user drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 Enable/Disable the close button of the content. 的本地化字符串。 + + + + + 查找类似 Shows or hides the close button of the content. This property does not function with System MDI Document Style. 的本地化字符串。 + + + + + 查找类似 The form must be of type IDockContent. 的本地化字符串。 + + + + + 查找类似 Gets or sets a value indicating in which area of the DockPanel the content allowed to show. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of DockState property changed. 的本地化字符串。 + + + + + 查找类似 Indicates the content will be hidden instead of being closed. 的本地化字符串。 + + + + + 查找类似 The desired docking state when first showing. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找类似 The tab text displayed in the dock pane. If not set, the Text property will be used. 的本地化字符串。 + + + + + 查找类似 The text displayed when mouse hovers over the tab. 的本地化字符串。 + + + + + 查找类似 The provided value is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Value: The value of DockAreas conflicts with current DockState. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 Invalid value, conflicts with DockableAreas property. 的本地化字符串。 + + + + + 查找类似 The dock state is invalid. 的本地化字符串。 + + + + + 查找类似 The dock panel is null. 的本地化字符串。 + + + + + 查找类似 Invalid beforeContent, it must be contained by the pane. 的本地化字符串。 + + + + + 查找类似 Invalid DockState: Content can not be showed as "Unknown" or "Hidden". 的本地化字符串。 + + + + + 查找类似 The previous pane is invalid. It can not be null, and its docking state must not be auto-hide. 的本地化字符串。 + + + + + 查找类似 DockPanel can not be null. 的本地化字符串。 + + + + + 查找类似 The Pane can not be null. 的本地化字符串。 + + + + + 查找类似 Invalid value, check DockableAreas property. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Press SHIFT for docking to full side. 的本地化字符串。 + + + + + 查找类似 Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid argument: Content can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid argument: The content's DockPanel can not be "null". 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 The specified container conflicts with the IsFloat property. 的本地化字符串。 + + + + + 查找类似 The previous pane does not exist in the nested docking pane collection. 的本地化字符串。 + + + + + 查找类似 The container can not be null. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be null when the nested docking pane collection is not empty. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be itself. 的本地化字符串。 + + + + + 查找类似 FloatWindow property can not be set to "null" when DockState is DockState.Float. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid Content: Content not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 The state for the dock pane is invalid. 的本地化字符串。 + + + + + 查找类似 Auto Hide 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window Position 的本地化字符串。 + + + + + 查找类似 Invalid Content: The content must be auto-hide state and associates with this DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of the AutoHideWindow's ActiveContent changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveContentProperty changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveDocument property changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActivePane property changed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop nested docking is allowed. 的本地化字符串。 + + + + + 查找类似 Occurs when a content added to the DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when a content removed from the DockPanel. 的本地化字符串。 + + + + + 查找类似 The default size of float window. 的本地化字符串。 + + + + + 查找类似 Provides Visual Studio .Net style docking. 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The visual skin to use when displaying the docked windows. 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The style of the document window. 的本地化字符串。 + + + + + 查找类似 Determines where the tab strip for Document style content is drawn. 的本地化字符串。 + + + + + 查找类似 The DockPanel has already been initialized. 的本地化字符串。 + + + + + 查找类似 The configuration file's version is invalid. 的本地化字符串。 + + + + + 查找类似 The XML file format is invalid. 的本地化字符串。 + + + + + 查找类似 Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form. 的本地化字符串。 + + + + + 查找类似 DockPanel configuration file. Author: Weifen Luo, all rights reserved. 的本地化字符串。 + + + + + 查找类似 !!! AUTOMATICALLY GENERATED FILE. DO NOT MODIFY !!! 的本地化字符串。 + + + + + 查找类似 Indicates whether the control layout is right-to-left when the RightToLeft property is set to Yes. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Shows the hidden autohide content when hovering over the tab. When disabled, the tab must be clicked to show the content. 的本地化字符串。 + + + + + 查找类似 Show close button on each tab 的本地化字符串。 + + + + + 查找类似 Determines if the document icon will be displayed in the tab strip. 的本地化字符串。 + + + + + 查找类似 Support deeply nested controls. Disabling this setting may improve resize performance but may cause heavily nested content not to resize. 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window List 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid argument: DockPanel can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid DockPanel. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 停靠 的本地化字符串。 + + + + + 查找类似 停靠通知 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 属性已更改 的本地化字符串。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 确定是否允许最终用户拖放停靠 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 启用/禁用DockContent的关闭按钮。 的本地化字符串。 + + + + + 查找类似 显示或隐藏DockContent的关闭按钮。此属性不适用于系统MDI文档样式。 的本地化字符串。 + + + + + 查找类似 窗体的类型必须为IDockContent。 的本地化字符串。 + + + + + 查找类似 获取或设置一个值，该值指示允许在DockPanel的哪个区域显示内容。 的本地化字符串。 + + + + + 查找类似 当DockState属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 指示DockContent将隐藏而不是关闭。 的本地化字符串。 + + + + + 查找类似 首次显示时所需的停靠状态。 的本地化字符串。 + + + + + 查找类似 显示停靠窗格选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 停靠窗格中显示的选项卡文本。如果未设置，将使用Text属性。 的本地化字符串。 + + + + + 查找类似 鼠标悬停在选项卡上时显示的文本。 的本地化字符串。 + + + + + 查找类似 提供的值超出范围。 的本地化字符串。 + + + + + 查找类似 无效值：DockAreas的值与当前DockState冲突。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 无效值，与DockableAreas属性冲突。 的本地化字符串。 + + + + + 查找类似 停靠状态无效。 的本地化字符串。 + + + + + 查找类似 DockPanel 为 null 的本地化字符串。 + + + + + 查找类似 beforeContent无效，它必须包含在pane中。 的本地化字符串。 + + + + + 查找类似 DockState无效：DockContent不能显示为“未知”或“隐藏”。 的本地化字符串。 + + + + + 查找类似 上一个Pane无效。它不能为null，其停靠状态不能自动隐藏。 的本地化字符串。 + + + + + 查找类似 DockPanel不能为null。 的本地化字符串。 + + + + + 查找类似 Pane不能为null。 的本地化字符串。 + + + + + 查找类似 无效值，请检查DockableAreas属性。 的本地化字符串。 + + + + + 查找类似 显示DockPanel选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 按SHIFT键以停靠到完全侧。 的本地化字符串。 + + + + + 查找类似 无效内容：ActiveContent必须是可见内容之一，如果没有可见内容，则为null。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent的DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 指定的容器与IsFloat属性冲突。 的本地化字符串。 + + + + + 查找类似 嵌套DockPanel集合中不存在上一个Pane。 的本地化字符串。 + + + + + 查找类似 容器不能为空。 的本地化字符串。 + + + + + 查找类似 当嵌套DockPanel集合不为空时，上一个Pane不能为空。 的本地化字符串。 + + + + + 查找类似 上一个Pane不能是其本身。 的本地化字符串。 + + + + + 查找类似 当DockState为DockState.Float时，FloatWindow属性不能设置为“null”。 的本地化字符串。 + + + + + 查找类似 无效内容：内容不在集合中。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 DockPanel的状态无效。 的本地化字符串。 + + + + + 查找类似 自动隐藏 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 属性 的本地化字符串。 + + + + + 查找类似 无效DockContent：DockContent必须为自动隐藏状态并与此DockPanel关联。 的本地化字符串。 + + + + + 查找类似 当AutoHideWindow的ActiveContent值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveContentProperty值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveDocument属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActivePane属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放停靠。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放嵌套停靠。 的本地化字符串。 + + + + + 查找类似 当DockContent添加到DockPanel时发生。 的本地化字符串。 + + + + + 查找类似 从DockPanel中删除DockContent时发生。 的本地化字符串。 + + + + + 查找类似 浮动窗口的默认大小。 的本地化字符串。 + + + + + 查找类似 提供Visual Studio.Net样式的停靠。 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 显示停靠窗口时要使用的视觉外观。 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 在停靠面板中拖动文档或Pane时发生。 的本地化字符串。 + + + + + 查找类似 文档窗口的样式。 的本地化字符串。 + + + + + 查找类似 确定绘制文档样式内容的选项卡栏的位置。 的本地化字符串。 + + + + + 查找类似 DockPanel已初始化。 的本地化字符串。 + + + + + 查找类似 配置文件的版本无效。 的本地化字符串。 + + + + + 查找类似 XML文件格式无效。 的本地化字符串。 + + + + + 查找类似 父窗体无效。使用DockingMdi或SystemMdi文档样式时，DockPanel控件必须是主MDI容器窗体的子控件。 的本地化字符串。 + + + + + 查找类似 DockPanel配置文件。作者：罗伟芬，版权所有。 的本地化字符串。 + + + + + 查找类似 !!! 自动生成的文件。不要修改！！！ 的本地化字符串。 + + + + + 查找类似 指示当RightToLeft属性设置为“是”时，控件布局是否从右向左。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 悬停在选项卡上时显示隐藏的自动隐藏内容。禁用时，必须单击选项卡才能显示内容。 的本地化字符串。 + + + + + 查找类似 在每个选项卡上显示关闭按钮 的本地化字符串。 + + + + + 查找类似 确定是否在选项卡栏中显示文档图标。 的本地化字符串。 + + + + + 查找类似 支持深度嵌套控件。禁用此设置可能会提高调整大小的性能，但可能会导致嵌套严重的内容无法调整大小。 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 窗口列表 的本地化字符串。 + + + + + 查找类似 无效参数：DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 无效DockPanel. 的本地化字符串。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置是否捕获鼠标 + + + + + 获取或设置是否显示图像信息 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框边框颜色 + + + + + 获取或设置放大图形的原始尺寸 + + + + + 获取或设置放大图像的倍数 + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置用于被操作的图像 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框线条的颜色 + + + + + 获取当前选中的区域 + + + + + 获取或设置放大图像的原图大小尺寸 + + + + + 获取或设置图像放大的倍数 + + + + + 获取或设置是否绘制操作框点 + + + + + 获取或设置是否限制鼠标操作区域 + + + + + 获取或设置是否绘制信息展示 + + + + + 获取或设置是否根据图像大小自动调整控件尺寸 + + + + + 获取当前是否绘制的有区域 + + + + + 获取当前是否开始绘制 + + + + + 获取当前操作框是否正在移动 + + + + + 获取或设置操作框是否锁定 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 响应四个按键实现精确移动 + + + + + + + + + + + + 绘制操作框 + + + + + + 绘制图像放大信息 + + + + + + 清空所有操作 + + + + + 手动设置一个块选中区域 + + 要选中区域 + + + + 手动设置一个块选中区域 + + 要选中区域的坐标 + 要选中区域的大小 + + + + 手动设置一个块选中区域 + + 要选中区域的x坐标 + 要选中区域的y坐标 + 要选中区域的宽度 + 要选中区域的高度 + + + + 手动设置信息显示的位置 + + 要显示的位置 + + + + 手动设置信息显示的位置 + + 要显示位置的x坐标 + 要显示位置的y坐标 + + + + 获取操作框内的图像 + + 结果图像 + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标结构信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置Hook + + + + + + 卸载Hook + + + + + + 鼠标状态枚举值 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Martin Lottering : 2007-10-27 + -------------------------------- + This is a usefull control in Filters. Allows you to save space and can replace a Grouped Box of CheckBoxes. + Currently used on the TasksFilter for TaskStatusses, which means the user can select which Statusses to include + in the "Search". + This control does not implement a CheckBoxListBox, instead it adds a wrapper for the normal ComboBox and Items. + See the CheckBoxItems property. + ---------------- + ALSO IMPORTANT: In Data Binding when setting the DataSource. The ValueMember must be a bool type property, because it will + be binded to the Checked property of the displayed CheckBox. Also see the DisplayMemberSingleItem for more information. + ---------------- + Extends the CodeProject PopupComboBox "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp" + by Lukasz Swiatkowski. + + + + + + + + + + The checkbox list control. The public CheckBoxItems property provides a direct reference to its Items. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation and its formatting however is controlled + by the Binded object, since it owns that property. + + + + + Builds a CSV string of the items selected. + + + + + A direct reference to the Items of CheckBoxComboBoxListControl. + You can use it to Get or Set the Checked status of items manually if you want. + But do not manipulate the List itself directly, e.g. Adding and Removing, + since the list is synchronised when shown with the ComboBox.Items. So for changing + the list contents, use Items instead. + + + + + The DataSource of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + The ValueMember of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation however is controlled by the Binded + object, since it owns that property. + + + + + Made this property Browsable again, since the Base Popup hides it. This class uses it again. + Gets an object representing the collection of the items contained in this + System.Windows.Forms.ComboBox. + + A System.Windows.Forms.ComboBox.ObjectCollection representing the items in + the System.Windows.Forms.ComboBox. + + + + + + + + + + + + + + + + + Will add an invisible item when the style is DropDownList, + to help maintain the correct text in main TextBox. + + + + + + + + + + + + A function to clear/reset the list. + (Ubiklou : http://www.codeproject.com/KB/combobox/extending_combobox.aspx?msg=2526813#xx2526813xx) + + + + + Uncheck all items. + + + + + The properties that will be assigned to the checkboxes as default values. + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + A container control for the ListControl to ensure the ScrollBar on the ListControl does not + Paint over the Size grip. Setting the Padding or Margin on the Popup or host control does + not work as I expected. + + + + + + + + + + Prescribed by the Popup class to ensure Resize operations work correctly. + + + + + + This ListControl that pops up to the User. It contains the CheckBoxComboBoxItems. + The items are docked DockStyle.Top in this control. + + + + + + + + + + + Simply a reference to the CheckBoxComboBox. + + + + + A Typed list of ComboBoxCheckBoxItems. + + + + + + + + + + Prescribed by the Popup control to enable Resize operations. + + + + + + + + + + + + Maintains the controls displayed in the list by keeping them in sync with the actual + items in the combobox. (e.g. removing and adding as well as ordering) + + + + + The CheckBox items displayed in the Popup of the ComboBox. + + + + + + + A reference to the CheckBoxComboBox. + A reference to the item in the ComboBox.Items that this object is extending. + + + + A reference to the CheckBoxComboBox. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + When using Data Binding operations via the DataSource property of the ComboBox. This + adds the required Bindings for the CheckBoxes. + + + + + + + + + + + Added this handler because the control doesn't seem + to initialize correctly until shown for the first + time, which also means the summary text value + of the combo is out of sync initially. + + + + + A Typed List of the CheckBox items. + Simply a wrapper for the CheckBoxComboBox.Items. A list of CheckBoxComboBoxItem objects. + This List is automatically synchronised with the Items of the ComboBox and extended to + handle the additional boolean value. That said, do not Add or Remove using this List, + it will be lost or regenerated from the ComboBox.Items. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Returns the item with the specified displayName or Text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Called when any property changes. + + + + + + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com Simple pop-up control http://www.codeproject.com/cs/miscctrl/simplepopup.asp. + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Gets a value indicating whether the PopupControl.Popup uses the fade effect. + + true if pop-up uses the fade effect; otherwise, false. + To use the fade effect, the FocusOnOpen property also has to be set to true. + + + + Gets or sets a value indicating whether to focus the content after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether this PopupControl.Popup is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets the size that is the lower limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the size that is the upper limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the PopupControl.Popup class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows pop-up window below the specified area of specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Adjusts the size of the owner to accommodate the if the owner is currently displayed, or clears and resets active child controls of the if the is not currently displayed. + + true if the owner is currently displayed; otherwise, false. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + + + + + + + + + + + + + + + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the size grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the PopupControl.PopupComboBox class. + + + + + The pop-up wrapper for the dropDownControl. + Made PROTECTED instead of PRIVATE so descendent classes can set its Resizable property. + Note however the pop-up properties must be set after the dropDownControl is assigned, since this + popup wrapper is recreated when the dropDownControl is assigned. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Shows the drop down. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Maintains an additional "Selected" and "Count" value for each item in a List. + Useful in the CheckBoxComboBox. It holds a reference to the List[Index] Item and + whether it is selected or not. + It also caters for a Count, if needed. + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. And no Counts will be displayed + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + Is a Count indicator used. + + + + + The original List of values wrapped. A "Selected" and possibly "Count" functionality is added. + + + + + Used to indicate NOT to use ToString(), but read this property instead as a display value. + + + + + When specified, indicates that ToString() should not be performed on the items. + This property will be read instead. + This is specifically useful on DataTable implementations, where PropertyDescriptors are used to read the values. + + + + + Builds a concatenation list of selected items in the list. + + + + + Indicates whether the Item display value (Name) should include a count. + + + + + Reset all counts to zero. + + + + + Creates a ObjectSelectionWrapper item. + Note that the constructor signature of sub classes classes are important. + + + + + + + + + + + + + + Used together with the ListSelectionWrapper in order to wrap data sources for a CheckBoxComboBox. + It helps to ensure you don't add an extra "Selected" property to a class that don't really need or want that information. + + + + + + + + + + + + Used as a count indicator for the item. Not necessarily displayed. + + + + + Is this item selected. + + + + + A reference to the wrapped item. + + + + + The containing list for these selections. + + + + + An indicator of how many items with the specified status is available for the current filter level. + Thaught this would make the app a bit more user-friendly and help not to miss items in Statusses + that are not often used. + + + + + A reference to the item wrapped. + + + + + The item display value. If ShowCount is true, it displays the "Name [Count]". + + + + + The textbox display value. The names concatenated. + + + + + Indicates whether the item is selected. + + + + + + + + + + + + + + + + 控件的状态。 + + + + + 正常 + + + + + 鼠标经过 + + + + + 鼠标按下 + + + + + 鼠标的当前位置 + + + + + + + + + + + + + + + + + + + + 美化按钮 + + + + + 普通按钮矩形位置 + + + + + 美化按钮 + + + + + 分割按钮的宽度 + + + + + 是否启用分割按钮 + + + + + 优先使用默认皮肤 + + + + + 按钮基础背景色 + + + + + 按钮字体颜色 + + + + + 图片宽度,默认值为18px，最小12px + + + + + 圆角的位置,默认全部都是圆角 + + + + + 设置圆角半径 + + + + + 背景色是否渐变 + + + + + 图片高度 + + + + + 图片与文字之间的间距 + + + + + 当鼠标按下时图片和文字是否产生偏移 + + + + + 鼠标进入时 + + + + + + 鼠标离开 + + + + + + 鼠标按下 + + + + + + 鼠标弹起 + + + + + + 鼠标当前所在位置 + + + + + 获取图像以及文字的位置 + + + + + + + + + + + + + + + + + + + + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强版Label(禁用了双击Label会自动复制文本到剪切板的功能) + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强富文本控件 + + + + + 开始更新 + + + + + 结束更新 + + + + + RichTextBox + + + + + + + + + + + + + + + + + + + + + + + 在自带菜单弹出前激发 + + + + + 根据标签获得菜单项 + + + + + + + 只允许输入文本(只对设置之后的人工输入有效) + + + + + 按下按键 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标按下 + + + + + + + + + + + + + + + + + + 当文本框为空时,显示的内容。 + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 消息列表控件 + + + + + 最大高度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 增强时间控件 + + + + + 增强时间控件 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 选择文本框 + + + + + 选择文本框 + + + + + 按钮基础背景色 + + + + + 优先使用默认皮肤 + + + + + 选择的id + + + + + 选择的名称 + + + + + 选择的名称 + + + + + 字体 + + + + + 重新设置大小 + + + + + 在选择时激发 + + + + + 点击选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 建立圆角路径的样式。 + + + + + 四个角都不是圆角。 + + + + + 四个角都为圆角。 + + + + + 左边两个角为圆角。 + + + + + 右边两个角为圆角。 + + + + + 上边两个角为圆角。 + + + + + 下边两个角为圆角。 + + + + + 左下角为圆角。 + + + + + 右下角为圆角。 + + + + + 画图相关API + + + + + 建立带有圆角样式的路径。 + + 用来建立路径的矩形。 + 圆角的大小。 + 圆角的样式。 + 是否把矩形长宽减 1,以便画出边框。 + 建立的路径。 + + + + 窗体皮肤 + + + + + 窗体皮肤 + + + + + 标题属性 + + + + + 是否使用父窗口的图标 + + + + + 点击最小化按钮是最小化还是隐藏 + + + + + 最大化按钮 + + + + + 最小化按钮 + + + + + 标题栏关闭按钮是否显示 + + + + + 当窗口位于后台时，是否标注显示。 + + + + + + + + + + 标题栏字体颜色 + + + + + 标题栏不处于活动状态时的字体颜色 + + + + + 标题栏背景颜色 + + + + + 标题栏不处于活动状态时的背景颜色 + + + + + 是否允许拖拉窗体边缘来改变窗体大小 + + + + + + + + + + + 画边框 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 热键文本框 + + + + + 热键文本框 + + + + + + + + + + + + + + + + + 在控件大小变化时发生 + + + + + + 此属性无效 + + + + + 载入热键配置 + + + + + + 保存热键 + + + + + + 是否含义热键 + + + + + 读取或设置热键 + + + + + 功能键 + + + + + 热键按键 + + + + + KeyDown事件 + + + + + + KeyDown事件 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 可以改变文本行距（行间距）的Label + + + + + 行间距 + + + + + 可以改变文本行距（行间距）的Label + + + + + + + + + + 字体高度 + + + + + + + + + + 文本 + + + + + + + + + + + + + + + + + + + 图标列表控件 + + + + + + + + + + + + 图标列表控件 + + + + + 图标大小 + + + + + 文本显示高度(从底部算起) + + + + + 默认图标 + + + + + 是否显示图标 + + + + + 是否显示网格线 + + + + + 角标图标合集 + + + + + 画项 + + + + + + 选择项的背景开始颜色 + + + + + 选择项的背景结束颜色 + + + + + 选择项的边框颜色 + + + + + 选择项的字体颜色 + + + + + 重绘选中时背景 + + + + + 重绘图标 + + + 区域大小 + + + + + + + + 重绘文本 + + + + + 获取文本对齐 + + + + + 水平滚动条滚动事件 + + + + + 垂直滚动条滚动事件 + + + + + + + + + + + 列表项 + + + + + 图标 + + + + + 角标图片序号,为-1表示无角标 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + 内容 + + + + + 网址 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 计算两个日期的时间间隔,返回的是日期值+ + + 时间值,将显示在返回的值里 + 参照时间 + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 控件边框颜色 + + + + + 控件背景颜色 + + + + + 圆角弧度大小 + + + + + 圆角风格 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 图标 + + + + + 标题 + + + + + 悬浮提示 + + + + + 标题颜色 + + + + + 设置按钮 + + + + + + + 判断和设置是否选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 绘制边框 + + 消息 + + + + 类说明：CContextMenuStrip控件的实现用来代替系统的ContextMenuStrip控件 + + + + + + + + + + + + + + + + 重写OnCreateControl + + + + + 重写OnPaint事件 + + + + + + CreateRoundedRectanglePath + + Rectangle + + + + + + 系统热键数据类。 + + + + + 系统热键数据类 + + + + + 使多行属性失效掉 + + + + + 使只读属性失效掉 + + + + + 获取热键文本 + + + + + 功能键 + + + + + 热键按键 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 在搜索时激发 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + + + + + + 文本为空时的显示效果 + + + + + 文本不选中 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + 字体 + + + + + 优先使用默认皮肤 + + + + + 背景色是否渐变 + + + + + 按钮基础背景色 + + + + + 按钮圆角部分背景颜色 + + + + + + + + + + 重新设置大小 + + + + + 点击搜索按钮 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 使用公共皮肤 + + + + + 按钮颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 皮肤公共类 + + + + + 是否使用默认皮肤 + + + + + 按钮皮肤 + + + + + 按钮皮肤类 + + + + + 背景颜色 + + + + + 字体颜色 + + + + + 是否颜色渐变 + + + + + 类说明：帮助类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 修改控件或窗体的边框，例如Textbox或是Form窗体 + + 消息 + 控件对象 + 边框像素 + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 图片所在上级域名 + + + + + 图片资源所在上级文件夹 + + + + + 根据不同前缀，加载不同格式图片。i:表示工程内置图片;s:表示T_ImageDomain域名下的图片,u:表示指定url的图片;f:表示本地图片 + + + + + + 加载本地图片,加载完毕不会占用本地图片 + + + + + + 加载指定url图片 + + url位置 + 是否异步 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 选项发生变化时激发 + + + + + 标签选择的序号 + + + + + + + + + + 选择的颜色 + + + + + 多标签控件颜色 + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 获取对应的标签 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获得当前进程，以便重绘控件 + + + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点边框颜色 + + + + + 是否鼠标MouseOver状态 + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点时边框颜色 + + + + + + + + + + 鼠标移动到该控件上时 + + + + + + 当鼠标从该控件移开时 + + + + + + 当该控件获得焦点时 + + + + + + 当该控件失去焦点时 + + + + + + 获得操作系统消息 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 美化文本框控件 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + 是否只能输入数字 + + + + + 是否多行 + + + + + 是否在显示不下时换行 + + + + + 最大长度 + + + + + + + + + + 背景颜色 + + + + + 右键菜单 + + + + + 字体颜色 + + + + + 选择的开始位置 + + + + + 选择的长度 + + + + + 选择的文本 + + + + + 提示文本 + + + + + 选择全部 + + + + + 密码 + + + + + 是否只读 + + + + + + + + + + + 文本为空时的显示效果 + + + + + 字体 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + + + + + + 选择文本框中的文本范围 + + 文本框中当前选定文本的第一个字符的位置。 + 要选择的字符数 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Define some Windows message constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This class adds to the functionality provided in System.Windows.Forms.MenuStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + This class adds to the functionality provided in System.Windows.Forms.ToolStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 透明图片控件 + + + + + 是否使用透明,默认为True + + + + + 设置透明度 + + + + + 要绑定的控件 + + + + + 透明图片控件 + + + + + 图片 + + + + + 初始化加载控件 + + 透明度 + 是否显示加载图片 + 图片 + + + + + + + + + + + + + + + 显示加载 + + + + + 隐藏加载 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日历控件 + + + + + 单击事件 + + + + + + + 单击某个日期事件 + + + + + 日历控件 + + + + + 设置日期 + + + + + 放假数据表 + + + + + 是否处于设计模式 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日控件 + + + + + 日控件 + + + + + 当前日期 + + + + + 在发生页码变化前激发 + + + + + 设置休息状态,1为休息,-1为上班，其它为不显示 + + + + + + 日期 + + + + + 农历 + + + + + 阳历日期字体颜色 + + + + + 阳历日期字体 + + + + + 农历日期字体 + + + + + 农历部分字体颜色 + + + + + 是否选中 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + 类 名:ColorHSL + 功 能:H 色相 \ S 饱和度(纯度) \ L 亮度 颜色模型 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + HSL颜色 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 饱和度 + + + + + 类 名:ColorHSV + 功 能:H 色相 \ S 饱和度(纯度) \ V 明度 颜色模型 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 明度 + + + + + 类 名:ColorRGB + 功 能:R 红色 \ G 绿色 \ B 蓝色 颜色模型 + 所有颜色模型的基类,RGB是用于输出到屏幕的颜色模式,所以所有模型都将转换成RGB输出 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + + + + + + + 红色 + + + + + 绿色 + + + + + 蓝色 + + + + + 获取实际颜色 + + + + + + 类 名:ColorHelper + 功 能:提供从RGB到HSV/HSL色彩空间的相互转换 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + RGB转换HSV + + + + + + + HSV转换RGB + + + + + + + RGB转换HSL + + + + + + + HSL转换RGB + + H, S and L input range = 0 -1.0 + + + + + RGB转CMYK + + + + + + + + + + RGB转CMYK + + + + + + + + + + + + CMYK转RGB + + + + + + + + + + Standard-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Standard-RGB,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Adobe-RGB,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Adobe-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Yxy转RGB + + + + + + + + + RGB转Yxy + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 超级颜色选择控件 + + + 分页控件 + + + + + + + + + + + + + + + + + + + + + + + + + + 获取网页颜色 + + + + + 超级颜色选择控件 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Chrome风格的多标签控件 + + + + + 设置选项卡处于选中状态时第一背景色. + + + + + 设置选项卡处于选中状态时第二背景色. + + + + + 设置选项卡处于非选中状态时第一背景色. + + + + + 设置选项卡处于非选中状态时第二背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第一背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第二背景色. + + + + + 设置选项卡工作区背景色. + + + + + 设置选项卡工作区背景图. + + + + + 是否显示关闭按钮 + + + + + 是否显示新增按钮 + + + + + 是否允许拖拽标签 + + + + + 标签最大宽度 + + + + + 标签右键菜单 + + + + + 鼠标按下标签时激发 + + + + + 鼠标放开标签时激发 + + + + + Chrome风格的多标签控件 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置圆角半径 + + + + + Tab文字左边距离 + + + + + + + + + + + + + + 画标签文字 + + + + + + + + + 画标签图标 + + + + + + + 画关闭按钮 + + + + + + + + 获取所有选项卡合起来的宽度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 添加新标签 + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + The position is not over a tab. + + + + + The position is over a tab's icon. + + + + + The position is over a tab's text. + + + + + The position is over a tab but not over its icon or its text. For owner-drawn tab controls, this value is specified if the position is anywhere over a tab. + TCHT_ONITEM is a bitwise-OR operation on TCHT_ONITEMICON and TCHT_ONITEMLABEL. + + + + + Specifies values from SetWindowPosZ enumeration. + + + + + Specified HWND_TOP enumeration value. + + + + + Specified HWND_BOTTOM enumeration value. + + + + + Specified HWND_TOPMOST enumeration value. + + + + + Specified HWND_NOTOPMOST enumeration value. + + + + + Invalidates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_INVALIDATE invalidates the entire window. + + + + Causes the OS to post a WM_PAINT message to the window regardless of whether a portion of the window is invalid. + + + + Causes the window to receive a WM_ERASEBKGND message when the window is repainted. + Specify this value in combination with the RDW_INVALIDATE value; otherwise, RDW_ERASE has no effect. + + + + + Validates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_VALIDATE validates the entire window. + This value does not affect internal WM_PAINT messages. + + + + Suppresses any pending WM_ERASEBKGND messages. + + + Excludes child windows, if any, from the repainting operation. + + + Includes child windows, if any, in the repainting operation. + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND and WM_PAINT messages before the RedrawWindow returns, if necessary. + + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND messages before RedrawWindow returns, if necessary. + The affected windows receive WM_PAINT messages at the ordinary time. + + + + + Specifies values from Msgs enumeration. + + + + + Specified WM_NULL enumeration value. + + + + + Specified WM_CREATE enumeration value. + + + + + Specified WM_DESTROY enumeration value. + + + + + Specified WM_MOVE enumeration value. + + + + + Specified WM_SIZE enumeration value. + + + + + Specified WM_ACTIVATE enumeration value. + + + + + Specified WM_SETFOCUS enumeration value. + + + + + Specified WM_KILLFOCUS enumeration value. + + + + + Specified WM_ENABLE enumeration value. + + + + + Specified WM_SETREDRAW enumeration value. + + + + + Specified WM_SETTEXT enumeration value. + + + + + Specified WM_GETTEXT enumeration value. + + + + + Specified WM_GETTEXTLENGTH enumeration value. + + + + + Specified WM_PAINT enumeration value. + + + + + Specified WM_CLOSE enumeration value. + + + + + Specified WM_QUERYENDSESSION enumeration value. + + + + + Specified WM_QUIT enumeration value. + + + + + Specified WM_QUERYOPEN enumeration value. + + + + + Specified WM_ERASEBKGND enumeration value. + + + + + Specified WM_SYSCOLORCHANGE enumeration value. + + + + + Specified WM_ENDSESSION enumeration value. + + + + + Specified WM_SHOWWINDOW enumeration value. + + + + + Specified WM_WININICHANGE enumeration value. + + + + + Specified WM_SETTINGCHANGE enumeration value. + + + + + Specified WM_DEVMODECHANGE enumeration value. + + + + + Specified WM_ACTIVATEAPP enumeration value. + + + + + Specified WM_FONTCHANGE enumeration value. + + + + + Specified WM_TIMECHANGE enumeration value. + + + + + Specified WM_CANCELMODE enumeration value. + + + + + Specified WM_SETCURSOR enumeration value. + + + + + Specified WM_MOUSEACTIVATE enumeration value. + + + + + Specified WM_CHILDACTIVATE enumeration value. + + + + + Specified WM_QUEUESYNC enumeration value. + + + + + Specified WM_GETMINMAXINFO enumeration value. + + + + + Specified WM_PAINTICON enumeration value. + + + + + Specified WM_ICONERASEBKGND enumeration value. + + + + + Specified WM_NEXTDLGCTL enumeration value. + + + + + Specified WM_SPOOLERSTATUS enumeration value. + + + + + Specified WM_DRAWITEM enumeration value. + + + + + Specified WM_MEASUREITEM enumeration value. + + + + + Specified WM_DELETEITEM enumeration value. + + + + + Specified WM_VKEYTOITEM enumeration value. + + + + + Specified WM_CHARTOITEM enumeration value. + + + + + Specified WM_SETFONT enumeration value. + + + + + Specified WM_GETFONT enumeration value. + + + + + Specified WM_SETHOTKEY enumeration value. + + + + + Specified WM_GETHOTKEY enumeration value. + + + + + Specified WM_QUERYDRAGICON enumeration value. + + + + + Specified WM_COMPAREITEM enumeration value. + + + + + Specified WM_GETOBJECT enumeration value. + + + + + Specified WM_COMPACTING enumeration value. + + + + + Specified WM_COMMNOTIFY enumeration value. + + + + + Specified WM_WINDOWPOSCHANGING enumeration value. + + + + + Specified WM_WINDOWPOSCHANGED enumeration value. + + + + + Specified WM_POWER enumeration value. + + + + + Specified WM_COPYDATA enumeration value. + + + + + Specified WM_CANCELJOURNAL enumeration value. + + + + + Specified WM_NOTIFY enumeration value. + + + + + Specified WM_INPUTLANGCHANGEREQUEST enumeration value. + + + + + Specified WM_INPUTLANGCHANGE enumeration value. + + + + + Specified WM_TCARD enumeration value. + + + + + Specified WM_HELP enumeration value. + + + + + Specified WM_USERCHANGED enumeration value. + + + + + Specified WM_NOTIFYFORMAT enumeration value. + + + + + Specified WM_CONTEXTMENU enumeration value. + + + + + Specified WM_STYLECHANGING enumeration value. + + + + + Specified WM_STYLECHANGED enumeration value. + + + + + Specified WM_DISPLAYCHANGE enumeration value. + + + + + Specified WM_GETICON enumeration value. + + + + + Specified WM_SETICON enumeration value. + + + + + Specified WM_NCCREATE enumeration value. + + + + + Specified VK_RMENU enumeration value. + + + + + Specified WM_NCCALCSIZE enumeration value. + + + + + Specified WM_NCHITTEST enumeration value. + + + + + Specified WM_NCPAINT enumeration value. + + + + + Specified WM_NCACTIVATE enumeration value. + + + + + Specified WM_GETDLGCODE enumeration value. + + + + + Specified WM_SYNCPAINT enumeration value. + + + + + Specified WM_NCMOUSEMOVE enumeration value. + + + + + Specified WM_NCLBUTTONDOWN enumeration value. + + + + + Specified WM_NCLBUTTONUP enumeration value. + + + + + Specified WM_NCLBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCRBUTTONDOWN enumeration value. + + + + + Specified WM_NCRBUTTONUP enumeration value. + + + + + Specified WM_NCRBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCMBUTTONDOWN enumeration value. + + + + + Specified WM_NCMBUTTONUP enumeration value. + + + + + Specified WM_NCMBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCXBUTTONDOWN enumeration value. + + + + + Specified WM_NCXBUTTONUP enumeration value. + + + + + Specified WM_KEYDOWN enumeration value. + + + + + Specified WM_KEYUP enumeration value. + + + + + Specified WM_CHAR enumeration value. + + + + + Specified WM_DEADCHAR enumeration value. + + + + + Specified WM_SYSKEYDOWN enumeration value. + + + + + Specified WM_SYSKEYUP enumeration value. + + + + + Specified WM_SYSCHAR enumeration value. + + + + + Specified WM_SYSDEADCHAR enumeration value. + + + + + Specified WM_KEYLAST enumeration value. + + + + + Specified WM_IME_STARTCOMPOSITION enumeration value. + + + + + Specified WM_IME_ENDCOMPOSITION enumeration value. + + + + + Specified WM_IME_COMPOSITION enumeration value. + + + + + Specified WM_IME_KEYLAST enumeration value. + + + + + Specified WM_INITDIALOG enumeration value. + + + + + Specified WM_COMMAND enumeration value. + + + + + Specified WM_SYSCOMMAND enumeration value. + + + + + Specified WM_TIMER enumeration value. + + + + + Specified WM_HSCROLL enumeration value. + + + + + Specified WM_VSCROLL enumeration value. + + + + + Specified WM_INITMENU enumeration value. + + + + + Specified WM_INITMENUPOPUP enumeration value. + + + + + Specified WM_MENUSELECT enumeration value. + + + + + Specified WM_MENUCHAR enumeration value. + + + + + Specified WM_ENTERIDLE enumeration value. + + + + + Specified WM_MENURBUTTONUP enumeration value. + + + + + Specified WM_MENUDRAG enumeration value. + + + + + Specified WM_MENUGETOBJECT enumeration value. + + + + + Specified WM_UNINITMENUPOPUP enumeration value. + + + + + Specified WM_MENUCOMMAND enumeration value. + + + + + Specified WM_CTLCOLORMSGBOX enumeration value. + + + + + Specified WM_CTLCOLOREDIT enumeration value. + + + + + Specified WM_CTLCOLORLISTBOX enumeration value. + + + + + Specified WM_CTLCOLORBTN enumeration value. + + + + + Specified WM_CTLCOLORDLG enumeration value. + + + + + Specified WM_CTLCOLORSCROLLBAR enumeration value. + + + + + Specified WM_CTLCOLORSTATIC enumeration value. + + + + + Specified WM_MOUSEMOVE enumeration value. + + + + + Specified WM_LBUTTONDOWN enumeration value. + + + + + Specified WM_LBUTTONUP enumeration value. + + + + + Specified WM_LBUTTONDBLCLK enumeration value. + + + + + Specified WM_RBUTTONDOWN enumeration value. + + + + + Specified WM_RBUTTONUP enumeration value. + + + + + Specified WM_RBUTTONDBLCLK enumeration value. + + + + + Specified WM_MBUTTONDOWN enumeration value. + + + + + Specified WM_MBUTTONUP enumeration value. + + + + + Specified WM_MBUTTONDBLCLK enumeration value. + + + + + Specified WM_MOUSEWHEEL enumeration value. + + + + + Specified WM_XBUTTONDOWN enumeration value. + + + + + Specified WM_XBUTTONUP enumeration value. + + + + + Specified WM_XBUTTONDBLCLK enumeration value. + + + + + Specified WM_PARENTNOTIFY enumeration value. + + + + + Specified WM_ENTERMENULOOP enumeration value. + + + + + Specified WM_EXITMENULOOP enumeration value. + + + + + Specified WM_NEXTMENU enumeration value. + + + + + Specified WM_SIZING enumeration value. + + + + + Specified WM_CAPTURECHANGED enumeration value. + + + + + Specified WM_MOVING enumeration value. + + + + + Specified WM_DEVICECHANGE enumeration value. + + + + + Specified WM_MDICREATE enumeration value. + + + + + Specified WM_MDIDESTROY enumeration value. + + + + + Specified WM_MDIACTIVATE enumeration value. + + + + + Specified WM_MDIRESTORE enumeration value. + + + + + Specified WM_MDINEXT enumeration value. + + + + + Specified WM_MDIMAXIMIZE enumeration value. + + + + + Specified WM_MDITILE enumeration value. + + + + + Specified WM_MDICASCADE enumeration value. + + + + + Specified WM_MDIICONARRANGE enumeration value. + + + + + Specified WM_MDIGETACTIVE enumeration value. + + + + + Specified WM_MDISETMENU enumeration value. + + + + + Specified WM_ENTERSIZEMOVE enumeration value. + + + + + Specified WM_EXITSIZEMOVE enumeration value. + + + + + Specified WM_DROPFILES enumeration value. + + + + + Specified WM_MDIREFRESHMENU enumeration value. + + + + + Specified WM_IME_SETCONTEXT enumeration value. + + + + + Specified WM_IME_NOTIFY enumeration value. + + + + + Specified WM_IME_CONTROL enumeration value. + + + + + Specified WM_IME_COMPOSITIONFULL enumeration value. + + + + + Specified WM_IME_SELECT enumeration value. + + + + + Specified WM_IME_CHAR enumeration value. + + + + + Specified WM_IME_REQUEST enumeration value. + + + + + Specified WM_IME_KEYDOWN enumeration value. + + + + + Specified WM_IME_KEYUP enumeration value. + + + + + Specified WM_MOUSEHOVER enumeration value. + + + + + Specified WM_UNDO enumeration value. + + + + + Specified WM_RENDERFORMAT enumeration value. + + + + + Specified WM_RENDERALLFORMATS enumeration value. + + + + + Specified WM_DESTROYCLIPBOARD enumeration value. + + + + + Specified WM_DRAWCLIPBOARD enumeration value. + + + + + Specified WM_PAINTCLIPBOARD enumeration value. + + + + + Specified WM_VSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_SIZECLIPBOARD enumeration value. + + + + + Specified WM_ASKCBFORMATNAME enumeration value. + + + + + Specified WM_CHANGECBCHAIN enumeration value. + + + + + Specified WM_HSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_QUERYNEWPALETTE enumeration value. + + + + + Specified WM_PALETTEISCHANGING enumeration value. + + + + + Specified WM_PALETTECHANGED enumeration value. + + + + + Specified WM_HOTKEY enumeration value. + + + + + Specified WM_PRINT enumeration value. + + + + + Specified WM_PRINTCLIENT enumeration value. + + + + + Specified WM_HANDHELDFIRST enumeration value. + + + + + Specified WM_HANDHELDLAST enumeration value. + + + + + Specified WM_AFXFIRST enumeration value. + + + + + Specified WM_AFXLAST enumeration value. + + + + + Specified WM_PENWINFIRST enumeration value. + + + + + Specified WM_PENWINLAST enumeration value. + + + + + Specified WM_APP enumeration value. + + + + + Specified WM_USER enumeration value. + + + + + Specified WM_REFLECT enumeration value. + + + + + Specified WM_THEMECHANGED enumeration value. + + + + + + + + + + 关键词 + + + + + 密码 + + + + + 权限用户id + + + + + + + + + + + + + 返回关键词 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 树形控件，用于分类用 + + + + + 显示在第一位的名称 + + + + + 是否显示菜单 + + + + + 树形控件 + + + + + 判断指定节点是否是目标节点的子节点 + + + + + + + + + 判断当前节点，当前用户是否有权限访问 + + + + + + + + + 权限事件 + + + + + + + + 选择权限用户时发生 + + + + + 数据变化时发生 + + + + + 数据变化前发生 + + + + + 操作事件 + + + + + + + 在添加分组前发生 + + + + + 在修改分组前发生 + + + + + 在删除分组前发生 + + + + + 在设置密码前发生 + + + + + 在设置权限前发生 + + + + + 获取新的关键词分类 + + + + + + 根据id获取节点 + + + + + + + 根据节点获取节点信息 + + + + + + + 设置节点信息 + + + + + + + 设置节点关键词和密码 + + + + + + + + 设置节点密码 + + + + + + + 设置节点关键词 + + + + + + + 设置节点用户 + + + + + + + RecursionTreeControl:表示将XML文件的内容显示在TreeView控件中 + + 将要加载的XML文件中的节点元素 + 将要加载的XML文件中的节点集合 + + + + 把XML文本载入到列表中 + + + + + + 把XML文件载入到列表中 + + + + + + 将列表保存为xml文本 + + + + + + 改变所有子节点的状态 + + + + + + + 反选子节点 + + + + + + 根据关键词来选中列表 + + + + + + 根据关键词来选中列表 + + + + + + 格式化关键字(会去除重复项)，以便存入数据库 + + + + + + + 去除掉重复项 + + + + + + + 获取当前选中项以及所有父项的关键词组合 + + + + + + 获取选中的 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 是否为添加 + + + + + 选择的文本 + + + + + 选择的Tag + + + + + 选择的图片序号 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + 旧密码 + + + + + 新密码 + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 控件状态 + + + + + 无 + + + + + 获得焦点 + + + + + 失去焦点 + + + + + 鼠标指针进入控件 + + + + + Toolbar控件 + + + + + + + + + + + + + + + 获取或设置控件显示的图片 + + + + + 重写控件焦点属性 + + + + + 自定义绘制 + + + + + + 焦点进入 + + + + + + 失去焦点 + + + + + + 禁止调整大小 + + + + + + + + + + + + + + + + + + 只响应单击鼠标左键事件 + + + + + + 按比例缩放图片 + + + + + + + 图片缩放 + + 源图片 + 缩放图片的宽度 + 缩放图片的高度 + 缩放的图片 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 绘图对像 + + 绘图对像 + 图片 + 绘置的图片大小、坐标 + 绘置的图片边界 + 当前状态 + 状态总数 + + + + 绘图对像 + + 绘图对像 + 图片对像 + 绘置的图片大小、坐标 + 当前状态 + 状态总数 + + + + + + + + + 得到要绘置的图片对像 + + 图像在程序集中的地址 + + + + + 得到要绘置的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 获取资源图标 + + + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的地址 + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 颜色标签 + + + + + 行间距 + + + + + 颜色标签 + + + + + 更新 + + + + + 字体高度 + + + + + 控件高 + + + + + 控件文本 + + + + + 获取过滤掉颜色的字 + + + + + + + 改变字体 + + + + + + + + + + + + + + 分页控件 + + + + + 首页文本 + + + + + 上一页文本 + + + + + 下一页文本 + + + + + 末页文本 + + + + + 跳页文本 + + + + + 页面信息文本 + + + + + 存储SQL参数 + + + + + 最后一页的页码 + + + + + 在发生页码变化时激发 + + + + + 在发生页码变化前激发 + + + + + 设置/返回每页显示的量大小 + + + + + 设置/返回记录总数 + + + + + 设置/返回分页SQL语句,{pagecount}表示页数,{recordcount}表示记录总数,{pagesize}表示页面大小, + {pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 设置/返回当{recordnum}小于等于0时的分页SQL语句(比如第一页),如果为空，则默认使用SQLText值。{pagecount}表示页数, + {recordcount}表示记录总数,{pagesize}表示页面大小,{pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 获取当前页码 + + + + + + 设置分页语句 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取数据库指定条件的记录总数 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MySQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MySQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MSSQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MSSQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 获取SQLite数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 返回分页SQL语句 + + + + + 分页控件 + + + + + 设置当前页为指定页 + + + + + + 下一页 + + + + + 上一页 + + + + + 末页 + + + + + 首页 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 密码控件 + + + + + + + + + + 密码 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + This enum represents the possible browser commands + + + + + Used when no commans are available + + + + + Used in the new navigation events + + + + + The URL to navigate to + + + + + The name of the frame to navigate to + + + + + The flags when opening a new window + + + + + The pointer to ppDisp + + + + + Creates a new instance of WebBrowserExtendedNavigatingEventArgs + + Pointer to the automation object of the browser + The URL to go to + The name of the frame + The new window flags + + + + + + + + + Used in the new navigation events + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 查看源码 + + + + + 复制当前选中区 + + + + + 粘贴当前选中区 + + + + + 剪切当前选中区 + + + + + 全选 + + + + + 清除当前选中区的选中状态。 + + + + + 从当前选中区中删除全部超级链接。 + + + + + 从当前选中区中删除全部书签。 + + + + + 删除当前选中区 + + + + + 重做 + + + + + 撤销 + + + + + 从当前选中区中删除格式化标签。 + + + + + 点击节点 + + + + + + + + 点击节点 + + + + + + + + + 点击元素 + + 节点名 + 属性 + 属性值 + 等待毫秒数 + 第几个符合的元素,从1开始 + + + + 等待多时毫秒 + + + + + + Represents event information for the main form, when the command state of the active browser changes + + + + + Creates a new instance of the class + + A list of commands that are available + + + + Gets a list of commands that are available + + + + + An extended version of the control. + + + + + + + + + + + + 在页面弹出消息对话框时激发 + + + + + + + + + + + + + + + + + + + + + + 打开页面并等待页面加载完毕 + + 要打开的页面地址 + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待页面加载完毕 + + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待指定毫秒 + + 等待指定毫秒 + + + + 获取网页源代码,可以自动去除乱码 + + + + + + 加载html文本到浏览器中 + + + + + + + 加载html文本到浏览器中 + + + + + + 强制用本窗体打开新链接 + + + + + + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is created. + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is discarded. + + + + + Returns the automation object for the web browser + + + + + This method will be called to give you a chance to create your own event sink + + + + + Detaches the event sink + + + + + 在文档下载开始时激发 + + + + + Raises the event + + Empty + + You could start an animation or a notification that downloading is starting + + + + + 下载完成后触发 + + + Here you could start monitoring for script errors. + + + + + Raises the event + + Empty + + + + 在开始浏览新网页时激发. + + + + + 在打开新的网页窗口时激发 + + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 新窗口事件,只限Window XP SP2或以上系统支持 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Overridden + + The send to this procedure + + + + A list of all the available window messages + + + + + Raises the event + + + + + 在网页窗口关闭时激发 + + + Do not confuse this with DWebBrowserEvents2.Quit... That's something else. + + + + + Flags used by INewWindowManager::EvaluateNewWindow. + These values are taken into account in the decision of whether to display a pop-up window. + + + + + No information Present + + + + + The page is unloading. This flag is set in response to the onbeforeunload and onunload events. + Some pages load pop-up windows when you leave them rather than when you enter. This flag is used to identify those situations. + + + + + The call to INewWindowManager::EvaluateNewWindow is the result of a user-initiated action + (a mouse click or key press). Use this flag in conjunction with the NWMF_FIRST_USERINITED flag + to determine whether the call is a direct or indirect result of the user-initiated action. + + + + + When NWMF_USERINITED is present, this flag indicates that the call to + INewWindowManager::EvaluateNewWindow is the first query that results from this user-initiated action. + Always use this flag in conjunction with NWMF_USERINITED. + + + + + The override key (ALT) was pressed. The override key is used to bypass the pop-up manager梐llowing + all pop-up windows to display梐nd must be held down at the time that INewWindowManager::EvaluateNewWindow is called. + + + + + The new window attempting to load is the result of a call to the showHelp method. Help is sometimes displayed in a separate window, + and this flag is valuable in those cases. + + + + + The new window is a dialog box that displays HTML content. + + + + + Indicates that the EvaluateNewWindow method is being called through a marshalled Component Object Model (COM) proxy + from another thread. In this situation, the method should make a decision and return immediately without performing + blocking operations such as showing modal user interface (UI). Lengthy operations will cause the calling thread to + appear unresponsive. + + + + + HRESULT constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + a form that supports custom theme + + + + + 标签新建按钮事件 + + + + + 标签关闭按钮事件 + + + + + 标签创建时事件 + + + + + 标签激活前事件 + + + + + 标签激活后事件 + + + + + 在标签栏创建时激发 + + + + + + + 内边距 + + + + + 默认内边距 + + + + + 标题 + + + + + 皮肤/主题 + + + + + 是否可拖动改变窗体大小 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 标题栏高度 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 控制按钮相对于右上角的偏移量 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 标题栏图标尺寸 + + + + + 窗体图标,如果设置本项,将不使用Icon属性 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题距离左边的距离 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 是否显示阴影 + + + + + 窗体阴影宽度 + + + + + 使用阴影来缩放 + + + + + 窗体阴影颜色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区区域，坐标相对于窗体左上角 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区大小 + + + + + 表示MDI标签栏的区域，包括bottom-region + + + + + MGdUI皮肤 + + + + + + + + + + + + + + + + + 获取子窗体 + + + + + + 通过sendmessage方式激活子窗体以避免闪烁 + + + + + + 当子窗体关闭时激发 + + + + + + + 子窗体可视化变化 + + + + + + + 获取当前的子窗体列表 + + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最小化 + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最大化 + + + + + to make the client area to have 3D view + + + + + 双击事件 + + + + + 消息 + + + + + + 画UI + + + + + + 在画背景时激发 + + + + + + 重写该方法解决在VS设计器中，每次保存一个新的尺寸，再打开尺寸会变大的问题 + + + + + 创建控件时激发 + + + + + 窗体可见变化时激发 + + + + + + 大小改变时激发 + + + + + + 在位置变化时激发 + + + + + + 窗体激活 + + + + + + 窗体关闭后激发 + + + + + + 加载时 + + + + + + 在子窗体激活时激发 + + + + + + 标签菜单 + + + + + 窗体上移动鼠标时激发 + + + + + + 获取当前点击的标签项 + + + + + 在窗体上按下鼠标时激发 + + + + + + 在窗体上放开鼠标时激发 + + + + + + 在鼠标离开窗体时激发 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 该类处理mdi-bar的绘制及鼠标事件管理 + + + + + use left,top,right to location the bar in owner form, + the margin is from Form.ClientRectangle + + + + + 整个标签栏高度,包含标签栏底部区域、标签、标签顶部空隙 + + + + + 标签栏底部区域的高度 + + + + + 是否显示标签栏边框 + + + + + 是否显示标签栏背景 + + + + + 标签栏左内边距 + + + + + 标签栏右内边距 + + + + + 标签高度 + + + + + 激活的标签高度 + + + + + tab顶部与bar顶部的空间,这个值用来计算 BarHeight + + + + + 每个标签的左右边界可以不是垂直的，而是都有一个斜度 + + + + + tab与tab之间的距离，用负值可以使tab有重叠的效果 + + + + + 标签是否显示图标 + + + + + 是否显示标签关闭按钮 + + + + + 标签图标大小 + + + + + 标签图标距离左边的距离 + + + + + 标签文字距离左边的距离 + + + + + 标签关闭按钮的大小 + + + + + 标签关闭按钮距离右边的距离 + + + + + 是否显示新建标签按钮 + + + + + 新建标签按钮的大小 + + + + + 新建标签距离左边的距离 + + + + + 按钮与Bar底部的距离 + + + + + 一个tab允许的最小宽度 + + + + + 一个tab允许的最大显示宽度 + + + + + 标签正常宽度 + + + + + 同步_listTabItems与mdi主窗体实际存在的子form + + + + + 为每个tab分配空间，如果tab数目太多，则有些会被隐藏 + + + + + 重绘整个标签栏 + + + + + + 处理鼠标事件。该方法会触发一些click事件，重刷一些按钮等 + + + + + + + 该类表示一个单独的标签项 + + + + + 该标签所对应的窗体 + + + + + 最终分配到的整个tab的宽度 + + + + + 表示所对应的form是否仍未被关闭 + + + + + 是否因空间不足而被隐藏 + + + + + 返回全部显示该标签文本所需的长度 + + + + + + 返回显示全部文本时该tab所需的宽度,该宽度不超过bar-container + 规定的tabmaxwidth + + + + + + 居左 + + + + + 显示在最后一个标签后面 + + + + + 该类封装设置一个主题所需的信息，可以继承该类实现不同的主题 + + + + + 主题名称，用于标识主题，对主题进行简单描述 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 窗体标题栏高度 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题栏图标尺寸 + + + + + 标题栏文本左边距 + + + + + 控制按钮（关闭按钮）相对于窗体右上角的偏移量 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 是否使用默认的圆角样式，该样式为左上角和右上角圆角， + 最好在窗体边框较粗时才使用该样式 + + + + + 是否在标题栏上绘制图标 + + + + + 是否在标题栏上绘制文本 + + + + + 是否显示窗体阴影 + + + + + 窗体阴影大小 + + + + + 拖动窗体阴影是否可以改变窗体大小 + + + + + 阴影的颜色，可以设置成其他颜色而不一定是黑色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 是否在客户区边界画线使其看起来有立体感 + + + + + 窗体标题栏文字是否居中显示 + + + + + 窗体边框最外一像素的颜色 + + + + + 窗体边框第二最外像素的颜色 + + + + + 窗体边框其他部分颜色，如果窗体边框大小大于2，则其他像素将用此颜色画出 + + + + + 标题栏颜色是从上到下渐变的，这个值设置上边的颜色值 + + + + + 标题栏颜色是从上到下渐变的，这个值设置下边的颜色值 + + + + + 标题栏文字颜色 + + + + + 窗体背景颜色，该值将覆盖窗体自带的BackColor属性值 + + + + + 窗体关闭按钮的颜色集合 + + + + + 窗体最大化/还原按钮的颜色集合 + + + + + 窗体最小化按钮的颜色集合 + + + + + 默认状态下关闭按钮背景图片 + + + + + 鼠标移过去时关闭按钮背景图片 + + + + + 鼠标按下时关闭按钮背景图片 + + + + + 默认状态下最大化按钮背景图片 + + + + + 鼠标移过去时最大化按钮背景图片 + + + + + 鼠标按下时最大化按钮背景图片 + + + + + 默认状态下恢复按钮背景图片 + + + + + 鼠标移过去时恢复按钮背景图片 + + + + + 鼠标按下时恢复按钮背景图片 + + + + + 默认状态下最小化按钮背景图片 + + + + + 鼠标移过去时最小化按钮背景图片 + + + + + 鼠标按下时最小化按钮背景图片 + + + + + 是否用SendMessage的方式切换子窗体，以避免子窗体切换时产生的闪烁 + + + + + Mdi-Bar与窗体左、上、右边界的距离，只用到这三个值，Bottom值没用到。 + 用这三个值来确定Mdi-Bar的宽度及其在窗体中的位置 + + + + + 内部左边空白，第一个标签将从这个空白距离之后开始 + + + + + 标签栏内部右边空白 + + + + + 标签栏背景颜色 + + + + + 标签栏边框颜色 + + + + + 标签栏背景图片 + + + + + 是否显示标签栏边框 + + + + + 标签栏下边区域的背景颜色 + + + + + 标签栏下边区域的高度 + + + + + 标签高度 + + + + + 被选中的标签高度，可以设置成与TabHeight不一样的值，以突出显示被选中状态 + + + + + 标签之间的距离，设成负值可以使标签有重叠的效果 + + + + + 标签的最大宽度，任何情况下标签都不能超过这个宽度 + + + + + 标签正常宽度，如果标签需要很短的宽度（比如20像素）就可以显示完上面的文字， + 但是Mdi-Bar上有足够的空间时，标签会以正常宽度（比如100像素）显示 + + + + + 标签最小宽度，当标签小于这个宽度时将被隐藏 + + + + + 标签梯度大小，标签可以不以矩形方式显示，而是有一个梯度/斜度。 + + + + + 标签顶部空白，这个值用于参与计算Mdi-Bar高度，计算方式为： + Mdi-Bar Height = BottomRegionHeight + TabHeight + TabTopSpace + + + + + 标签上是否显示子窗体图标 + + + + + 标签上是否显示子窗体关闭图标 + + + + + 选中状态的标签的上部背景色，与下部背景色不同时，标签背景色就有渐变效果 + + + + + 选中状态的标签的下部背景色，与上部背景色不同时，标签背景色就有渐变效果 + + + + + 标签激活时字体颜色 + + + + + 非选中状态的标签的字体颜色 + + + + + 非选中状态的标签的上部背景色 + + + + + 非选中状态的标签的下部背景色 + + + + + 标签外边框颜色 + + + + + 标签内边框颜色，这个颜色一般具有一定的透明度 + + + + + 是否显示标签边框 + + + + + 是否显示默认的新建标签按钮(NewTabBtn) + + + + + NewTabBtn与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 新建标签按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 新建标签按钮大小 + + + + + 按钮颜色集合 + + + + + 是否一直显示ListAllBtn，即使在没有标签被隐藏的情况下 + + + + + 《显示全部标签》按钮的位置 + + + + + 《显示全部标签》按钮与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 《显示全部标签》按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 《显示全部标签》按钮的颜色 + + + + + 《显示全部标签》按钮的大小 + + + + + 皮肤主题 + + + + + 设置百分比 + + + + + + + + + 引发 ValueChanged 事件 + + + + + + 引发 ThemeChanged 事件 + + + + + + 指示鼠标位于哪个区域 + + + + + 控件Value值发生变化后引发 + + + + + 控件绘制MainLine前引发, 可以设置Cancel参数来取消默认的绘制 + + + + + 控件绘制Button前引发 + + + + + 引发 ValueChanged 事件 + + + + + 引发 BeforePaintMainLine 事件 + + + + + 引发 BeforePaintButton 事件 + + + + + 将Value值加一个LargeChange量 + + + + + 将Value值减一个LargeChange量 + + + + + 将Value值加一个SmallChange量 + + + + + 将Value值减一个SmallChange量 + + + + + 提供产生各种路径的静态方法，比如圆角路径、关闭按钮上的x路径、+号路径 + + + + + 圆角样式 + + + + + 无 + + + + + 所有 + + + + + 上 + + + + + 下 + + + + + 左 + + + + + 右 + + + + + SimpleObject指的是只有一种状态（不像普通按钮一样有三种状态），并且其上的元素 + 布局比较简单的Object + + + + + + + + + + + + + + + + + + + + DevExpress风格皮肤 + + + + + DevExpress风格皮肤 + + + + + 新风格皮肤 + + + + + 新风格皮肤 + + + + + 基础皮肤 + + + + + VS2013风格皮肤 + + + + + this theme is just for chrome one quarter style + + + + + for diamond ring style only + + + + + Location of cursor hot spot returnet in WM_NCHITTEST. + + + + + On the screen background or on a dividing line between windows + (same as HTNOWHERE, except that the DefWindowProc function produces a system beep to indicate an error). + + + + + In a window currently covered by another window in the same thread + (the message will be sent to underlying windows in the same thread until one of them returns a code that is not HTTRANSPARENT). + + + + + On the screen background or on a dividing line between windows. + + + + In a client area. + + + In a title bar. + + + In a window menu or in a Close button in a child window. + + + In a size box (same as HTSIZE). + + + In a menu. + + + In a horizontal scroll bar. + + + In the vertical scroll bar. + + + In a Minimize button. + + + In a Maximize button. + + + In the left border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the right border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the upper-horizontal border of a window. + + + In the upper-left corner of a window border. + + + In the upper-right corner of a window border. + + + In the lower-horizontal border of a resizable window + (the user can click the mouse to resize the window vertically). + + + In the lower-left corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the lower-right corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the border of a window that does not have a sizing border. + + + In a Close button. + + + In a Help button. + + + + Contains the new coordinates of a window that has been moved or resized, that is, it is the proposed new window coordinates. + + + + + Contains the coordinates of the window before it was moved or resized. + + + + + Contains the coordinates of the window's client area before the window was moved or resized. + + + + + Pointer to a WINDOWPOS structure that contains the size and position values specified in the operation that moved or resized the window. + + + + + + + + + + 是否在这个按钮上按下了鼠标未释放 + + + + + 是否可见 + + + + + + + + + + 画两次可以加深颜色 + + + + + 用于在click事件中传回数据 + + + + + 获取或设置是否将绘制完全限制在指定的区域内 + + + + + + + + + + + + + + + + + Adapter for WinForms brushes objects for core. + + + + + The actual WinForms brush instance. + + + + + If to dispose the brush when is called.
+ Ignore dispose for cached brushes. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms context menu for core. + + + + + the underline win forms context menu + + + + + Init. + + + + + Adapter for WinForms Control for core. + + + + + the underline win forms control. + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Get the underline win forms control + + + + + Adapter for WinForms Font object for core. + + + + + the underline win-forms font. + + + + + a handle to this Font. + + + + + the vertical offset of the font underline location from the top of the font. + + + + + Cached font height. + + + + + Cached font whitespace width. + + + + + Init. + + + + + the underline win-forms font. + + + + + Get the handle to this Font. + + + + + Set font metrics to be cached for the font for future use. + + the full height of the font + the vertical offset of the font underline location from the top of the font. + + + + Adapter for WinForms Font family object for core. + + + + + the underline win-forms font. + + + + + Init. + + + + + the underline win-forms font family. + + + + + Adapter for WinForms Graphics for core. + + + + + used for calculation. + + + + + used for calculation. + + + + + Used for GDI+ measure string. + + + + + The string format to use for measuring strings for GDI+ text rendering + + + + + The string format to use for rendering strings for GDI+ text rendering + + + + + The wrapped WinForms graphics object + + + + + Use GDI+ text rendering to measure/draw text. + + + + + the initialized HDC used + + + + + if to release the graphics object on dispose + + + + + If text alignment was set to RTL + + + + + Init static resources. + + + + + Init. + + the win forms graphics object to use + Use GDI+ text rendering to measure/draw text + optional: if to release the graphics object on dispose (default - false) + + + + Release current HDC to be able to use methods. + + + + + Init HDC for the current graphics object to be used to call GDI directly. + + + + + Set a resource (e.g. a font) for the specified device context. + WARNING: Calling Font.ToHfont() many times without releasing the font handle crashes the app. + + + + + Set the text color of the device context. + + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Special draw logic to draw transparent text using GDI.
+ 1. Create in-memory DC
+ 2. Copy background to in-memory DC
+ 3. Draw the text to in-memory DC
+ 4. Copy the in-memory DC to the proper location with alpha blend
+ + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Adapter for WinForms graphics path object for core. + + + + + The actual WinForms graphics path instance. + + + + + the last point added to the path to begin next segment from + + + + + The actual WinForms graphics path instance. + + + + + Get arc start angle for the given corner. + + + + + Adapter for WinForms Image object for core. + + + + + the underline win-forms image. + + + + + Initializes a new instance of the class. + + + + + the underline win-forms image. + + + + + Adapter for WinForms pens objects for core. + + + + + The actual WinForms brush instance. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms platforms. + + + + + Singleton instance of global adapter. + + + + + Init installed font families and set default font families mapping. + + + + + Singleton instance of global adapter. + + + + + Low level handling of Html Renderer logic, this class is used by , + , and .
+ + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + returns page list + + + + + returns page list count + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrappable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given printer device. + + the printer device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + mouse event args + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the mouse event args + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + + + + + + Create HtmlRenderer mouse event from win forms mouse event. + + + + + Create HtmlRenderer key event from win forms key event. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ Using and client can control how the html content effects the + size of the label. Either case scrollbars are never shown and html content outside of client bounds will be clipped. + and with AutoSize can limit the max/min size of the control
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoSize:

+ AutoSize = AutoSizeHeightOnly = false
+ The label size will not change by the html content. MaximumSize and MinimumSize are ignored.
+
+ AutoSize = true
+ The width and height is adjustable by the html content, the width will be longest line in the html, MaximumSize.Width will restrict it but it can be lower than that.
+
+ AutoSizeHeightOnly = true
+ The width of the label is set and will not change by the content, the height is adjustable by the html content with restrictions to the MaximumSize.Height and MinimumSize.Height values.
+ + +

LinkClicked event

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + the current html text set in the control + + + + + is to handle auto size of the control height only + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + Creates a new HTML Label + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Automatically sets the size of the label by content size + + + + + Automatically sets the height of the label by content height (width is not effected). + + + + + Gets or sets the max size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the min size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the html of this control. + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform paint of the html in the control. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ If is true and the layout of the html resulted in its content beyond the client bounds + of the panel it will show scrollbars (horizontal/vertical) allowing to scroll the content.
+ If is false html content outside the client bounds will be clipped.
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoScroll:

+ Allows showing scrollbars if html content is placed outside the visible boundaries of the panel. + + +

LinkClicked event:

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the control + + + + + the current html text set in the control + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + The last position of the scrollbars to know if it has changed to update mouse + + + + + Creates a new HtmlPanel and sets a basic css for it's styling. + + + + + + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. + + + + + Gets or sets the text of this panel + + + + + + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Adjust the scrollbar of the panel on html element by the given id.
+ The top of the html element rectangle will be at the top of the panel, if there + is not enough height to scroll to the top the scroll will be at maximum.
+ + the id of the element to scroll to + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform html container layout by the current panel client size. + + + + + Perform paint of the html in the control. + + + + + Set focus on the control for keyboard scrollbars handling. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Handle key down event for selection, copy and scrollbars handling. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + On html renderer scroll request adjust the scrolling of the panel to the requested location. + + + + + Adjust the scrolling of the panel to the requested location. + + the location to adjust the scroll to + + + + call mouse move to handle paint after scroll or html change affecting mouse cursor. + + + + + Used to add arrow keys to the handled keys in . + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Standalone static class for simple and direct HTML rendering.
+ For WinForms UI prefer using HTML controls: or .
+ For low-level control and performance consider using .
+ + + + GDI vs. GDI+ text rendering
+ Windows supports two text rendering technologies: GDI and GDI+.
+ GDI is older, has better performance and looks better on standard monitors but doesn't support alpha channel for transparency.
+ GDI+ is newer, device independent so work better for printers but is slower and looks worse on monitors.
+ HtmlRender supports both GDI and GDI+ text rendering to accommodate different needs, GDI+ text rendering methods have "GdiPlus" suffix + in their name where GDI do not.
+ + + Rendering to image
+ See https://htmlrenderer.codeplex.com/wikipage?title=Image%20generation
+ Because of GDI text rendering issue with alpha channel clear type text rendering rendering to image requires special handling.
+ Solid color background - generate an image where the background is filled with solid color and all the html is rendered on top + of the background color, GDI text rendering will be used. (RenderToImage method where the first argument is html string)
+ Image background - render html on top of existing image with whatever currently exist but it cannot have transparent pixels, + GDI text rendering will be used. (RenderToImage method where the first argument is Image object)
+ Transparent background - render html to empty image using GDI+ text rendering, the generated image can be transparent. + Text rendering can be controlled using , note that + doesn't render well on transparent background. (RenderToImageGdiPlus method)
+ + + Overwrite stylesheet resolution
+ Exposed by optional "stylesheetLoad" delegate argument.
+ Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + Overwrite image resolution
+ Exposed by optional "imageLoad" delegate argument.
+ Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ Note: Cannot use asynchronous scheme overwrite scheme.
+ + + + + Simple rendering
+ HtmlRender.Render(g, "Hello World]]>");
+ HtmlRender.Render(g, "Hello World]]>", 10, 10, 500, CssData.Parse("body {font-size: 20px}")");
+ + + Image rendering
+ HtmlRender.RenderToImage("Hello World]]>", new Size(600,400));
+ HtmlRender.RenderToImage("Hello World]]>", 600);
+ HtmlRender.RenderToImage(existingImage, "Hello World]]>");
+ + + + + + Adds a font family to be used in html rendering.
+ The added font will be used by all rendering function including and all WinForms controls. + + + The given font family instance must be remain alive while the renderer is in use.
+ If loaded to then the collection must be alive.
+ If loaded from file then the file must not be deleted. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + + This fonts mapping can be used as a fallback in case the requested font is not installed in the client system. + + the font family to replace + the font family to replace with + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI text rendering, note has no effect. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI+ text rending, use to control text rendering. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Renders the specified HTML source on the specified location and max width restriction.
+ Use GDI text rendering, note has no effect.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI text rendering, note has no effect.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ The HTML will be layout by the given image size but may be clipped if cannot fit.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + optional: the top-left most location to start render the html at (default - 0,0) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Measure the size (width and height) required to draw the given html under given width and height restrictions.
+ + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size of the html by performing layout under the given restrictions. + + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Clip the graphics so the html will not be rendered outside the max height bound given.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Copy all the bitmap bits from memory bitmap buffer to the given image. + + the source memory bitmap buffer to copy from + the destination bitmap image to copy to + + + + Provides HTML rendering on the tooltips. + + + + + the container to render and handle the html shown in the tooltip + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + The text rendering hint to be used for text rendering. + + + + + The CSS class used for tooltip html root div + + + + + the control that the tooltip is currently showing on.
+ Used for link handling. + + + + + timer used to handle mouse move events when mouse is over the tooltip.
+ Used for link handling. + + + + + the handle of the actual tooltip window used to know when the tooltip is hidden
+ Used for link handling. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + The CSS class used for tooltip html root div (default: htmltooltip)
+ Setting to 'null' clear base style on the tooltip.
+ Set custom class found in to change the base style of the tooltip. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Gets or sets the max size the tooltip. + + An ordered pair of type representing the width and height of a rectangle. + + + + On tooltip appear set the html by the associated control, layout and set the tooltip size by the html size. + + + + + Draw the html using the tooltip graphics. + + + + + Adjust the location of the tooltip window to the location of the mouse and handle + if the tooltip window will try to appear outside the boundaries of the control. + + the control the tooltip is appearing on + the size of the tooltip window + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Raised on link handling timer tick, used for: + 1. Know when the tooltip is hidden by checking the visibility of the tooltip window. + 2. Call HandleMouseMove so the mouse cursor will react if over a link element. + 3. Call HandleMouseDown and HandleMouseUp to simulate click on a link if one was clicked. + + + + + Unsubscribe from events and dispose of . + + + + + Helper to encode and set HTML fragment to clipboard.
+ See http://theartofdev.wordpress.com/2012/11/11/setting-html-and-plain-text-formatting-to-clipboard/.
+ . + + + The MIT License (MIT) Copyright (c) 2014 Arthur Teplitzki. + + + + + The string contains index references to other spots in the string, so we need placeholders so we can compute the offsets.
+ The _ strings are just placeholders. We'll back-patch them actual values afterwards.
+ The string layout () also ensures that it can't appear in the body of the html because the
+ character must be escaped.
+ + + + + html comment to point the beginning of html fragment + + + + + html comment to point the end of html fragment + + + + + Used to calculate characters byte count in UTF-8 + + + + + Create with given html and plain-text ready to be used for clipboard or drag and drop.
+ Handle missing ]]> tags, specified start\end segments and Unicode characters. + + + + Windows Clipboard works with UTF-8 Unicode encoding while .NET strings use with UTF-16 so for clipboard to correctly + decode Unicode string added to it from .NET we needs to be re-encoded it using UTF-8 encoding. + + + Builds the CF_HTML header correctly for all possible HTMLs
+ If given html contains start/end fragments then it will use them in the header: + hello world]]> + If given html contains html/body tags then it will inject start/end fragments to exclude html/body tags: + hello world]]> + If given html doesn't contain html/body tags then it will inject the tags and start/end fragments properly: + world]]> + In all cases creating a proper CF_HTML header:
+ + + hello world + ]]> + + See format specification here: http://msdn.microsoft.com/library/default.asp?url=/workshop/networking/clipboard/htmlclipboard.asp + + + a html fragment + the plain text + + + + Clears clipboard and sets the given HTML and plain text fragment to the clipboard, providing additional meta-information for HTML.
+ See for HTML fragment details.
+ + + ClipboardHelper.CopyToClipboard("Hello World", "Hello World"); + + a html fragment + the plain text + + + + Clears clipboard and sets the given plain text fragment to the clipboard.
+ + the plain text + + + + Generate HTML fragment data string with header that is required for the clipboard. + + the html to generate for + the resulted string + + + + Calculates the number of bytes produced by encoding the string in the string builder in UTF-8 and not .NET default string encoding. + + the string builder to count its string + optional: the start index to calculate from (default - start of string) + optional: the end index to calculate to (default - end of string) + the number of bytes required to encode the string in UTF-8 + + + + Utilities for converting WinForms entities to HtmlRenderer core entities. + + + + + Convert from WinForms point to core point. + + + + + Convert from WinForms point to core point. + + + + + Convert from core point to WinForms point. + + + + + Convert from core point to WinForms point. + + + + + Convert from WinForms size to core size. + + + + + Convert from core size to WinForms size. + + + + + Convert from core size to WinForms size. + + + + + Convert from WinForms rectangle to core rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from WinForms color to core color. + + + + + Convert from core color to WinForms color. + + + + + Utility for Win32 API. + + + + + Const for BitBlt copy raster-operation code. + + + + + Const for BitBlt paint raster-operation code. + + + + + Create a compatible memory HDC from the given HDC.
+ The memory HDC can be rendered into without effecting the original HDC.
+ The returned memory HDC and must be released using . + + the HDC to create memory HDC from + the width of the memory HDC to create + the height of the memory HDC to create + returns used bitmap memory section that must be released when done with memory HDC + memory HDC + + + + Release the given memory HDC and dib section created from . + + Memory HDC to release + bitmap section to release + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + A pointer to a RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + If the function succeeds, the return value is nonzero. + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ARGB (alpha, red, green, blue) color. + + + + + Represents a color that is null. + + 1 + + + + Gets a system-defined color. + + + + + Gets a system-defined color that has an ARGB value of #FF000000. + + + + + Gets a system-defined color that has an ARGB value of #FFFFFFFF. + + + + + Gets a system-defined color that has an ARGB value of #FFF5F5F5. + + + + + Gets a system-defined color that has an ARGB value of #FFD3D3D3. + + + + + Gets the red component value of this structure. + + + + + Gets the green component value of this structure. + + + + + Gets the blue component value of this structure. + + + + + Gets the alpha component value of this structure. + + + + + Specifies whether this structure is uninitialized. + + + This property returns true if this color is uninitialized; otherwise, false. + + 1 + + + + Tests whether two specified structures are equivalent. + + + true if the two structures are equal; otherwise, false. + + + The that is to the left of the equality operator. + + + The that is to the right of the equality operator. + + 3 + + + + Tests whether two specified structures are different. + + + true if the two structures are different; otherwise, false. + + + The that is to the left of the inequality operator. + + + The that is to the right of the inequality operator. + + 3 + + + + Creates a structure from the four ARGB component (alpha, red, green, and blue) values. Although this method allows a 32-bit value to be passed for each component, the value of each component is limited to 8 bits. + + + The that this method creates. + + The alpha component. Valid values are 0 through 255. + The red component. Valid values are 0 through 255. + The green component. Valid values are 0 through 255. + The blue component. Valid values are 0 through 255. + + , , , or is less than 0 or greater than 255. + + 1 + + + + Creates a structure from the specified 8-bit color values (red, green, and blue). The alpha value is implicitly 255 (fully opaque). Although this method allows a 32-bit value to be passed for each color component, the value of each component is limited to 8 bits. + + + The that this method creates. + + + The red component value for the new . Valid values are 0 through 255. + + + The green component value for the new . Valid values are 0 through 255. + + + The blue component value for the new . Valid values are 0 through 255. + + + , , or is less than 0 or greater than 255. + + 1 + + + + Tests whether the specified object is a structure and is equivalent to this + + structure. + + + true if is a structure equivalent to this + + structure; otherwise, false. + + The object to test. + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies the hash code for this . + + 1 + + + + Converts this structure to a human-readable string. + + + + + Specifies the style of dashed lines drawn with a object. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 自定义 + + + + + Specifies style information applied to text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + Init. + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + Is the left mouse button participated in the event + + + + + Init. + + + + + Is the left mouse button participated in the event + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ordered pair of floating-point x- and y-coordinates that defines a point in a two-dimensional plane. + + + + + Represents a new instance of the class with member data left uninitialized. + + 1 + + + + Initializes a new instance of the class with the specified coordinates. + + The horizontal position of the point. + The vertical position of the point. + + + + + + Gets a value indicating whether this is empty. + + + true if both and + + are 0; otherwise, false. + + 1 + + + + Gets or sets the x-coordinate of this . + + + The x-coordinate of this . + + 1 + + + + Gets or sets the y-coordinate of this . + + + The y-coordinate of this . + + 1 + + + + Translates the by the specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the x- and y-coordinates of the + + . + + + + + Translates a by the negative of a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Compares two structures. The result specifies whether the values of the + + and properties of the two + + structures are equal. + + + true if the and + + values of the left and right + + structures are equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Determines whether the coordinates of the specified points are not equal. + + + true to indicate the and + + values of and + + are not equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Translates a given by a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the coordinates of + + . + + + + + Translates a by the negative of a specified size. + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Specifies whether this contains the same coordinates as the specified + + . + + + This method returns true if is a and has the same coordinates as this + + . + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts this to a human readable string. + + + A string that represents this . + + 1 + + + + Stores a set of four floating-point numbers that represent the location and size of a rectangle. + + + + + Represents an instance of the class with its members uninitialized. + + + + + Initializes a new instance of the class with the specified location and size. + + The x-coordinate of the upper-left corner of the rectangle. + The y-coordinate of the upper-left corner of the rectangle. + The width of the rectangle. + The height of the rectangle. + + + + Initializes a new instance of the class with the specified location and size. + + A that represents the upper-left corner of the rectangular region. + A that represents the width and height of the rectangular region. + + + + Gets or sets the coordinates of the upper-left corner of this structure. + + A that represents the upper-left corner of this structure. + + + + Gets or sets the size of this . + + A that represents the width and height of this structure. + + + + Gets or sets the x-coordinate of the upper-left corner of this structure. + + + The x-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the y-coordinate of the upper-left corner of this structure. + + + The y-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the width of this structure. + + + The width of this structure. + + + + + Gets or sets the height of this structure. + + + The height of this structure. + + + + + Gets the x-coordinate of the left edge of this structure. + + + The x-coordinate of the left edge of this structure. + + + + + Gets the y-coordinate of the top edge of this structure. + + + The y-coordinate of the top edge of this structure. + + + + + Gets the x-coordinate that is the sum of and + + of this structure. + + + The x-coordinate that is the sum of and + + of this structure. + + + + + Gets the y-coordinate that is the sum of and + + of this structure. + + + The y-coordinate that is the sum of and + + of this structure. + + + + + Tests whether the or + + property of this has a value of zero. + + + This property returns true if the or + + property of this has a value of zero; otherwise, false. + + + + + Tests whether two structures have equal location and size. + + + This operator returns true if the two specified structures have equal + , , , and properties. + + + The structure that is to the left of the equality operator. + + + The structure that is to the right of the equality operator. + + + + + Tests whether two structures differ in location or size. + + + This operator returns true if any of the , + , , or + properties of the two structures are unequal; otherwise false. + + + The structure that is to the left of the inequality operator. + + + The structure that is to the right of the inequality operator. + + + + + Creates a structure with upper-left corner and lower-right corner at the specified locations. + + + The new that this method creates. + + The x-coordinate of the upper-left corner of the rectangular region. + The y-coordinate of the upper-left corner of the rectangular region. + The x-coordinate of the lower-right corner of the rectangular region. + The y-coordinate of the lower-right corner of the rectangular region. + + + + Tests whether is a with the same location and size of this + . + + + This method returns true if is a and its X, Y, Width, and Height properties are equal to the corresponding properties of this + ; otherwise, false. + + + The to test. + + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point defined by and is contained within this + + structure; otherwise false. + + The x-coordinate of the point to test. + The y-coordinate of the point to test. + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point represented by the parameter is contained within this + + structure; otherwise false. + + The to test. + + + + Determines if the rectangular region represented by is entirely contained within this + + structure. + + + This method returns true if the rectangular region represented by is entirely contained within the rectangular region represented by this + + ; otherwise false. + + + The to test. + + + + + Inflates this structure by the specified amount. + + + The amount to inflate this structure horizontally. + + + The amount to inflate this structure vertically. + + + + + Inflates this by the specified amount. + + The amount to inflate this rectangle. + + + + Creates and returns an inflated copy of the specified structure. The copy is inflated by the specified amount. The original rectangle remains unmodified. + + + The inflated . + + + The to be copied. This rectangle is not modified. + + The amount to inflate the copy of the rectangle horizontally. + The amount to inflate the copy of the rectangle vertically. + + + + Replaces this structure with the intersection of itself and the specified + + structure. + + The rectangle to intersect. + + + + Returns a structure that represents the intersection of two rectangles. If there is no intersection, and empty + + is returned. + + + A third structure the size of which represents the overlapped area of the two specified rectangles. + + A rectangle to intersect. + A rectangle to intersect. + + + + Determines if this rectangle intersects with . + + + This method returns true if there is any intersection. + + The rectangle to test. + + + + Creates the smallest possible third rectangle that can contain both of two rectangles that form a union. + + + A third structure that contains both of the two rectangles that form the union. + + A rectangle to union. + A rectangle to union. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location horizontally. + The amount to offset the location vertically. + + + + Gets the hash code for this structure. For information about the use of hash codes, see Object.GetHashCode. + + The hash code for this + + + + Converts the Location and Size of this to a human-readable string. + + + A string that contains the position, width, and height of this structure for example, "{X=20, Y=20, Width=100, Height=50}". + + + + + Stores an ordered pair of floating-point numbers, typically the width and height of a rectangle. + + + + + Gets a structure that has a + + and + + value of 0. + + + A structure that has a + + and + + value of 0. + + 1 + + + + Initializes a new instance of the structure from the specified existing + + structure. + + + The structure from which to create the new + + structure. + + + + + Initializes a new instance of the structure from the specified structure. + + The structure from which to initialize this structure. + + + + Initializes a new instance of the structure from the specified dimensions. + + + The width component of the new structure. + + + The height component of the new structure. + + + + + Gets a value that indicates whether this structure has zero width and height. + + + This property returns true when this structure has both a width and height of zero; otherwise, false. + + 1 + + + + Gets or sets the horizontal component of this structure. + + + The horizontal component of this structure, typically measured in pixels. + + 1 + + + + Gets or sets the vertical component of this structure. + + + The vertical component of this structure, typically measured in pixels. + + 1 + + + + Converts the specified structure to a + structure. + + The structure to which this operator converts. + The structure to be converted + + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + 3 + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A that is the result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + 3 + + + + Tests whether two structures are equal. + + + This operator returns true if and have equal width and height; otherwise, false. + + + The structure on the left side of the equality operator. + + + The structure on the right of the equality operator. + + 3 + + + + Tests whether two structures are different. + + + This operator returns true if and differ either in width or height; false if + + and are equal. + + + The structure on the left of the inequality operator. + + + The structure on the right of the inequality operator. + + 3 + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A structure that is a result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + + + + Tests to see whether the specified object is a structure with the same dimensions as this + + structure. + + + This method returns true if is a and has the same width and height as this + + ; otherwise, false. + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts a structure to a structure. + + + Returns a structure. + + + + + Creates a human-readable string that represents this structure. + + + A string that represents this structure. + + 1 + + + + + + + Platform adapter to bridge platform specific objects to HTML Renderer core library.
+ Core uses abstract renderer objects (RAdapter/RControl/REtc...) to access platform specific functionality, the concrete platforms + implements those objects to provide concrete platform implementation. Those allowing the core library to be platform agnostic. + + Platforms: WinForms, WPF, Metro, PDF renders, etc.
+ Objects: UI elements(Controls), Graphics(Render context), Colors, Brushes, Pens, Fonts, Images, Clipboard, etc.
+ + + + It is best to have a singleton instance of this class for concrete implementation!
+ This is because it holds caches of default CssData, Images, Fonts and Brushes. + + + + + cache of brush color to brush instance + + + + + cache of pen color to pen instance + + + + + cache of all the font used not to create same font again and again + + + + + default CSS parsed data singleton + + + + + image used to draw loading image icon + + + + + image used to draw error image icon + + + + + Init. + + + + + Get the default CSS stylesheet data. + + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Check if the given font exists in the system by font family name. + + the font name to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get image to be used while HTML image is loading. + + + + + Get image to be used if HTML image load failed. + + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard
+ Not relevant for platforms that don't render HTML on UI element. + + the text to set + + + + Set the given html and plain text data to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + + + + Set the given image to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the image object to set to clipboard + + + + Create a context menu that can be used on the control
+ Not relevant for platforms that don't render HTML on UI element. + + new context menu + + + + Save the given image to file by showing save dialog to the client.
+ Not relevant for platforms that don't render HTML on UI element. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard + + the text to set + + + + Set the given html and plain text data to clipboard. + + the html data + the plain text data + + + + Set the given image to clipboard. + + + + + + Create a context menu that can be used on the control + + new context menu + + + + Save the given image to file by showing save dialog to the client. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Adapter for platform specific brush objects - used to fill graphics (rectangles, polygons and paths).
+ The brush can be solid color, gradient or image. + + + + + + + + + + Adapter for platform specific context menu - used to create and show context menu at specific location.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The total number of items in the context menu + + + + + Add divider item to the context menu.
+ The divider is a non clickable place holder used to separate items. + + + + + Add item to the context menu with the given text that will raise the given event when clicked. + the text to set on the new context menu itemif to set the item as enabled or disabledthe event to raise when the item is clicked + + + + Remove the last item from the context menu iff it is a divider + + + + + Show the context menu in the given parent control at the given location. + the parent control to show inthe location to show at relative to the parent control + + + + + + + + + Adapter for platform specific control object - used to handle updating the control that the html is rendered on.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The platform adapter. + + + + + Init control with platform adapter. + + + + + The platform adapter. + + + + + Is the left mouse button is currently in pressed state + + + + + Is the right mouse button is currently in pressed state + + + + + Get the current location of the mouse relative to the control + + + + + Set the cursor over the control to default cursor + + + + + Set the cursor over the control to hand cursor + + + + + Set the cursor over the control to I beam cursor + + + + + Do drag-drop copy operation for the given data object. + + the drag-drop data object + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Invalidates the entire surface of the control and causes the control to be redrawn. + + + + + Adapter for platform specific font object - used to render text using specific font. + + + + + Gets the em-size of this Font measured in the units specified by the Unit property. + + + + + The line spacing, in pixels, of this font. + + + + + Get the vertical offset of the font underline location from the top of the font. + + + + + Get the left padding, in pixels, of the font. + + + + + + + + + + + + Adapter for platform specific font family object - define the available font families to use.
+ Required for custom fonts handling: fonts that are not installed on the system. + + + + + Gets the name of this Font Family. + + + + + Adapter for platform specific graphics rendering object - used to render graphics and text in platform specific context.
+ The core HTML Renderer components use this class for rendering logic, extending this + class in different platform: WinForms, WPF, Metro, PDF, etc. + + + + + the global adapter + + + + + Te clipping bound stack as clips are pushed/poped to/from the graphics + + + + + Init. + + + + + Get color pen. + + the color to get the pen for + pen instance + + + + Get solid color brush. + + the color to get the brush for + solid color brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Gets a Rectangle structure that bounds the clipping region of this Graphics. + + A rectangle structure that represents a bounding rectangle for the clipping region of this Graphics. + + + + Pop the latest clip push. + + + + + Push the clipping region of this Graphics to interception of current clipping rectangle and the given rectangle. + + Rectangle to clip to. + + + + Push the clipping region of this Graphics to exclude the given rectangle from the current clipping rectangle. + + Rectangle to exclude clipping in. + + + + Set the graphics smooth mode to use anti-alias.
+ Use to return back the mode used. + + the previous smooth mode before the change + + + + Return to previous smooth mode before anti-alias was set as returned from . + + the previous mode to set + + + + Get TextureBrush object that uses the specified image and bounding rectangle. + + The Image object with which this TextureBrush object fills interiors. + A Rectangle structure that represents the bounding rectangle for this TextureBrush object. + The dimension by which to translate the transformation + + + + Get GraphicsPath object. + + graphics path instance + + + + Measure the width and height of string when drawn on device context HDC + using the given font . + + the string to measure + the font to measure string with + the size of the string + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ Not relevant for platforms that don't render HTML on UI element. + + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Draw the given string using the given font and foreground color at given location. + + the string to draw + the font to use to draw the string + the text color to set + the location to start string draw (top-left) + used to know the size of the rendered text for transparent text support + is to render the string right-to-left (true - RTL, false - LTR) + + + + Draws a line connecting the two points specified by the coordinate pairs. + + Pen that determines the color, width, and style of the line. + The x-coordinate of the first point. + The y-coordinate of the first point. + The x-coordinate of the second point. + The y-coordinate of the second point. + + + + Draws a rectangle specified by a coordinate pair, a width, and a height. + + A Pen that determines the color, width, and style of the rectangle. + The x-coordinate of the upper-left corner of the rectangle to draw. + The y-coordinate of the upper-left corner of the rectangle to draw. + The width of the rectangle to draw. + The height of the rectangle to draw. + + + + Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height. + + Brush that determines the characteristics of the fill. + The x-coordinate of the upper-left corner of the rectangle to fill. + The y-coordinate of the upper-left corner of the rectangle to fill. + Width of the rectangle to fill. + Height of the rectangle to fill. + + + + Draws the specified portion of the specified at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. The image is scaled to fit the rectangle. + Rectangle structure that specifies the portion of the object to draw. + + + + Draws the specified Image at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. + + + + Draws a GraphicsPath. + + Pen that determines the color, width, and style of the path. + GraphicsPath to draw. + + + + Fills the interior of a GraphicsPath. + + Brush that determines the characteristics of the fill. + GraphicsPath that represents the path to fill. + + + + Fills the interior of a polygon defined by an array of points specified by Point structures. + + Brush that determines the characteristics of the fill. + Array of Point structures that represent the vertices of the polygon to fill. + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Adapter for platform specific graphics path object - used to render (draw/fill) path shape. + + + + + Start path at the given point. + + + + + Add stright line to the given point from te last point. + + + + + Add circular arc of the given size to the given point from the last point. + + + + + Release path resources. + + + + + The 4 corners that are handled in arc rendering. + + + + + + + + + + + + + + + + + + + + + + + + + Adapter for platform specific image object - used to render images. + + + + + Get the width, in pixels, of the image. + + + + + Get the height, in pixels, of the image. + + + + + + + + + + Adapter for platform specific pen objects - used to draw graphics (lines, rectangles and paths) + + + + + Gets or sets the width of this Pen, in units of the Graphics object used for drawing. + + + + + Gets or sets the style used for dashed lines drawn with this Pen. + + + + + Holds parsed stylesheet css blocks arranged by media and classes.
+ + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + used to return empty array + + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data. + + + + + Init. + + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + Platform adapter + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data + + + + + Check if there are css blocks for the given class selector. + + the class selector to check for css blocks by + optional: the css media type (default - all) + true - has css blocks for the class, false - otherwise + + + + Get collection of css blocks for the requested class selector.
+ the can be: class name, html element name, html element and + class name (elm.class), hash tag with element id (#id).
+ returned all the blocks that word on the requested class selector, it can contain simple + selector or hierarchy selector. + + the class selector to get css blocks by + optional: the css media type (default - all) + collection of css blocks, empty collection if no blocks exists (never null) + + + + Add the given css block to the css data, merging to existing block if required. + + + If there is no css blocks for the same class it will be added to data collection.
+ If there is already css blocks for the same class it will check for each existing block + if the hierarchical selectors match (or not exists). if do the two css blocks will be merged into + one where the new block properties overwrite existing if needed. if the new block doesn't mach any + existing it will be added either to the beginning of the list if it has no hierarchical selectors or at the end.
+ Css block without hierarchical selectors must be added to the beginning of the list so more specific block + can overwrite it when the style is applied. + + the media type to add the CSS to + the css block to add + + + + Combine this CSS data blocks with CSS blocks for each media.
+ Merge blocks if exists in both. + + the CSS data to combine with + + + + Create deep copy of the css data with cloned css blocks. + + cloned object + + + + CSS Specification's Default Style Sheet for HTML 4 + + + http://www.w3.org/TR/CSS21/sample.html + + + + + Border types + + + + + Represents a CSS Box of text or replaced elements. + + + The Box can contains other boxes, that's the way that the CSS Tree + is composed. + + To know more about boxes visit CSS spec: + http://www.w3.org/TR/CSS21/box.html + + + + + the parent css box of this css box in the hierarchy + + + + + the root container for the hierarchy + + + + + the html tag that is associated with this css box, null if anonymous box + + + + + the inner text of the box + + + + + Do not use or alter this flag + + + Flag that indicates that CssTable algorithm already made fixes on it. + + + + + handler for loading background image + + + + + Init. + + optional: the parent of this css box in html + optional: the html tag associated with this css box + + + + Gets the HtmlContainer of the Box. + WARNING: May be null. + + + + + Gets or sets the parent box of this box + + + + + Gets the children boxes of this box + + + + + Is the box is of "br" element. + + + + + is the box "Display" is "Inline", is this is an inline box and not block. + + + + + is the box "Display" is "Block", is this is an block box and not inline. + + + + + Is the css box clickable (by default only "a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + Gets the containing block-box of this box. (The nearest parent box with display=block) + + + + + Gets the HTMLTag that hosts this box + + + + + Gets if this box represents an image + + + + + Tells if the box is empty or contains just blank spaces + + + + + Gets or sets the inner text of the box + + + + + Gets the line-boxes of this box (if block box) + + + + + Gets the linebox(es) that contains words of this box (if inline) + + + + + Gets the rectangles where this box should be painted + + + + + Gets the BoxWords of text in the box + + + + + Gets the first word of the box + + + + + Gets or sets the first linebox where content of this box appear + + + + + Gets or sets the last linebox where content of this box appear + + + + + Create new css box for the given parent with the given html tag.
+ + the html tag to define the box + the box to add the new box to it as child + the new box + + + + Create new css box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous inline boxes visit: http://www.w3.org/TR/CSS21/visuren.html#anonymous + + the box to add the new box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new box + + + + Create new css block box. + + the new block box + + + + Create new css block box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous block boxes visit CSS spec: + http://www.w3.org/TR/CSS21/visuren.html#anonymous-block-level + + the box to add the new block box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new block box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + Device context to use + + + + Prints the fragment + + Device context to use + + + + + + Set this box in + + + + + + Move all child boxes from to this box. + + the box to move all its child boxes from + + + + Splits the text into words and saves the result + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions.
+ + Device context to use + + + + Assigns words its width and height + + + + + + Get the parent of this css properties instance. + + + + + + Gets the index of the box to be used on a (ordered) list + + + + + + Creates the + + + + + + Searches for the first word occurrence inside the box, on the specified linebox + + + + + + + + Gets the specified Attribute, returns string.Empty if no attribute specified + + Attribute to retrieve + Attribute value or string.Empty if no attribute specified + + + + Gets the value of the specified attribute of the source HTML tag. + + Attribute to retrieve + Value to return if attribute is not specified + Attribute value or defaultValue if no attribute specified + + + + Gets the minimum width that the box can be.
+ The box can be as thin as the longest word plus padding.
+ The check is deep thru box tree.
+ + the min width of the box + + + + Gets the longest word (in width) inside the box, deeply. + + + + + + + + + Get the total margin value (left and right) from the given box to the given end box.
+ + the box to start calculation from. + the total margin + + + + Gets the maximum bottom of the boxes inside the startBox + + + + + + + + Get the and width of the box content.
+ + The minimum width the content must be so it won't overflow (largest word + padding). + The total width the content can take without line wrapping (with padding). + + + + Get the and of the box words content and .
+ + the box to calculate for + the width that allows for each word to fit (width of the longest word) + the max width a single line of words can take without wrapping + the total amount of padding the content has + + + + + + Gets if this box has only inline siblings (including itself) + + + + + + Gets the rectangles where inline box will be drawn. See Remarks for more info. + + Rectangles where content should be placed + + Inline boxes can be split across different LineBoxes, that's why this method + Delivers a rectangle for each LineBox related to this box, if inline. + + + Inherits inheritable values from parent. + + + + + Gets the result of collapsing the vertical margins of the two boxes + + the previous box under the same parent + Resulting top margin + + + + Calculate the actual right of the box by the actual right of the child boxes if this box actual right is not set. + + the calculated actual right value + + + + Gets the result of collapsing the vertical margins of the two boxes + + Resulting bottom margin + + + + Deeply offsets the top of the box and its contents + + + + + + Paints the fragment + + the device to draw to + + + + Prints the fragment + + the device to draw to + + + + + + Paints the background of the box + + the device to draw into + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Paint all the words in the box. + + the device to draw into + the current scroll offset to offset the words + + + + Paints the text decoration (underline/strike-through/over-line) + + the device to draw into + + + + + + + Offsets the rectangle of the specified linebox by the specified gap, + and goes deep for rectangles of children in that linebox. + + + + + + + Resets the array + + + + + On image load process complete with image request refresh for it to be painted. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Get brush for the text depending if there is selected text color set. + + + + + Get brush for selection background depending if it has external and if alpha is required for images. + + + used for images so they will have alpha effect + + + + ToString override. + + + + + + CSS box for iframe element.
+ If the iframe is of embedded YouTube or Vimeo video it will show image with play. + + + + + the image word of this image box + + + + + is the iframe is of embeded video + + + + + the title of the video + + + + + the url of the video thumbnail image + + + + + link to the video on the site + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Is the css box clickable ("a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + is the iframe is of embeded video + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Load YouTube video data (title, image, link) by calling YouTube API. + + + + + Parse YouTube API response to get video data (title, image, link). + + + + + Load Vimeo video data (title, image, link) by calling Vimeo API. + + + + + Parse Vimeo API response to get video data (title, image, link). + + + + + Handle error occurred during video data load to handle if the video was not found. + + the exception that occurred during data load web request + the name of the video source (YouTube/Vimeo/Etc.) + + + + Create image handler for downloading video image if found and release the WebClient instance used for API call. + + + + + Paints the fragment + + the device to draw to + + + + Draw video image over the iframe if found. + + + + + Draw video title on top of the iframe if found. + + + + + Draw play over the iframe if we found link url. + + + + + Assigns words its width and height + + the device to use + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + CSS box for hr element. + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + the device to draw to + + + + CSS box for image element. + + + + + the image word of this image box + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Get the image of this image box. + + + + + Paints the fragment + + the device to draw to + + + + Assigns words its width and height + + the device to use + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Base class for css box to handle the css properties.
+ Has field and property for every css property that can be set, the properties add additional parsing like + setting the correct border depending what border value was set (single, two , all four).
+ Has additional fields to control the location and size of the box and 'actual' css values for some properties + that require additional calculations and parsing.
+ + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + the width of whitespace between words + + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + Gets the bounds of the box + + + + + Gets the width available on the box, counting padding and margin. + + + + + Gets the right of the box. When setting, it will affect only the width of the box. + + + + + Gets or sets the bottom of the box. + (When setting, alters only the Size.Height of the box) + + + + + Gets the left of the client rectangle (Where content starts rendering) + + + + + Gets the top of the client rectangle (Where content starts rendering) + + + + + Gets the right of the client rectangle + + + + + Gets the bottom of the client rectangle + + + + + Gets the client rectangle + + + + + Gets the actual height + + + + + Gets the actual height + + + + + Gets the actual top's padding + + + + + Gets the actual padding on the left + + + + + Gets the actual Padding of the bottom + + + + + Gets the actual padding on the right + + + + + Gets the actual top's Margin + + + + + The margin top value if was effected by margin collapse. + + + + + Gets the actual Margin on the left + + + + + Gets the actual Margin of the bottom + + + + + Gets the actual Margin on the right + + + + + Gets the actual top border width + + + + + Gets the actual Left border width + + + + + Gets the actual Bottom border width + + + + + Gets the actual Right border width + + + + + Gets the actual top border Color + + + + + Gets the actual Left border Color + + + + + Gets the actual Bottom border Color + + + + + Gets the actual Right border Color + + + + + Gets the actual length of the north west corner + + + + + Gets the actual length of the north east corner + + + + + Gets the actual length of the south east corner + + + + + Gets the actual length of the south west corner + + + + + Gets a value indicating if at least one of the corners of the box is rounded + + + + + Gets the actual width of whitespace between words. + + + + + + Gets the actual color for the text. + + + + + Gets the actual background color of the box + + + + + Gets the second color that creates a gradient for the background + + + + + Gets the actual angle specified for the background gradient + + + + + Gets the actual font of the parent + + + + + Gets the font that should be actually used to paint the text of the box + + + + + Gets the line height + + + + + Gets the text indentation (on first line only) + + + + + Gets the actual horizontal border spacing for tables + + + + + Gets the actual vertical border spacing for tables + + + + + Get the parent of this css properties instance. + + + + + + Gets the height of the font in the specified units + + + + + + Ensures that the specified length is converted to pixels if necessary + + + + + + Set the style/width/color for all 4 borders on the box.
+ if null is given for a value it will not be set. + + optional: the style to set + optional: the width to set + optional: the color to set + + + + Measures the width of whitespace between words (set ). + + + + + Inherits inheritable values from specified box. + + Set to true to inherit all CSS properties instead of only the ineritables + Box to inherit the properties + + + + Helps on CSS Layout. + + + + + Measure image box size by the width\height set on the box and the actual rendered image size.
+ If no image exists for the box error icon will be set. + + the image word to measure + + + + Creates line boxes for the specified blockbox + + + + + + + Applies special vertical alignment for table-cells + + + + + + + Recursively flows the content of the box using the inline model + + Device Info + Blockbox that contains the text flow + Current box to flow its content + Maximum reached right + Space to use between rows of text + x starting coordinate for when breaking lines of text + Current linebox being used + Current x coordinate that will be the left of the next word + Current y coordinate that will be the top of the next word + Maximum right reached so far + Maximum bottom reached so far + + + + Adjust the position of absolute elements by letf and top margins. + + + + + Recursively creates the rectangles of the blockBox, by bubbling from deep to outside of the boxes + in the rectangle structure + + + + + Applies vertical and horizontal alignment to words in lineboxes + + + + + + + Applies right to left direction to words + + + + + + + Applies RTL direction to all the words on the line. + + the line to apply RTL to + + + + Applies RTL direction to specific box words on the line. + + + + + + + Applies vertical alignment to the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies right alignment to the text on the linebox + + + + + + + Simplest alignment, just arrange words. + + + + + + + Layout engine for tables executing the complex layout of tables with rows/columns/headers/etc. + + + + + the main box of the table + + + + + + + + + + collection of all rows boxes + + + + + collection of all columns boxes + + + + + + + + + + Init. + + + + + + Get the table cells spacing for all the cells in the table.
+ Used to calculate the spacing the table has in addition to regular padding and borders. + + the table box to calculate the spacing for + the calculated spacing + + + + + + + + + + + Analyzes the Table and assigns values to this CssTable object. + To be called from the constructor + + + + + Get the table boxes into the proper fields. + + + + + Insert EmptyBoxes for vertical cell spanning. + + + + + Determine Row and Column Count, and ColumnWidths + + + + + + + + + + + + While table width is larger than it should, and width is reductable.
+ If table max width is limited by we need to lower the columns width even if it will result in clipping
+ + + + + Check for minimum sizes (increment widths if necessary) + + + + + Layout the cells by the calculated table layout + + + + + + Gets the spanned width of a cell (With of all columns it spans minus one). + + + + + Gets the cell column index checking its position and other cells colspans + + + + + + + + Gets the cells width, taking colspan and being in the specified column + + + + + + + + Gets the colspan of the specified box + + + + + + Gets the rowspan of the specified box + + + + + + Recursively measures words inside the box + + the box to measure + Device to use + + + + Tells if the columns widths can be reduced, + by checking the minimum widths of all cells + + + + + + Tells if the specified column can be reduced, + by checking its minimum width + + + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Calculate the min and max width for each column of the table by the content in all rows.
+ the min width possible without clipping content
+ the max width the cell content can take without wrapping
+ + if to measure only columns that have no calculated width + return the min width for each column - the min width possible without clipping content + return the max width for each column - the max width the cell content can take without wrapping + + + + Gets the width available for cells + + + + It takes away the cell-spacing from + + + + + Gets the current sum of column widths + + + + + + Gets the span attribute of the tag of the specified box + + + + + + Gets the minimum width of each column + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual vertical spacing of the table + + + + + Represents and gets info about a CSS Length + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + Creates a new CssLength from a length specified on a CSS style sheet or fragment + + Length as specified in the Style Sheet or style fragment + + + + Gets the number in the length + + + + + Gets if the length has some parsing error + + + + + Gets if the length represents a precentage (not actually a length) + + + + + Gets if the length is specified in relative units + + + + + Gets the unit of the length + + + + + Gets the length as specified in the string + + + + + If length is in Ems, returns its value in points + + Em size factor to multiply + Points size of this em + If length has an error or isn't in ems + + + + If length is in Ems, returns its value in pixels + + Pixel size factor to multiply + Pixels size of this em + If length has an error or isn't in ems + + + + Returns the length formatted ready for CSS interpreting. + + + + + + Represents a line of text. + + + To learn more about line-boxes see CSS spec: + http://www.w3.org/TR/CSS21/visuren.html + + + + + Creates a new LineBox + + + + + Gets a list of boxes related with the linebox. + To know the words of the box inside this linebox, use the method. + + + + + Gets the words inside the linebox + + + + + Gets the owner box + + + + + Gets a List of rectangles that are to be painted on this linebox + + + + + Get the height of this box line (the max height of all the words) + + + + + Get the bottom of this box line (the max bottom of all the words) + + + + + Lets the linebox add the word an its box to their lists if necessary. + + + + + + Return the words of the specified box that live in this linebox + + + + + + + Updates the specified rectangle of the specified box. + + + + + + + + + + Copies the rectangles to their specified box + + + + + Sets the baseline of the words of the specified box to certain height + + Device info + box to check words + baseline + + + + Check if the given word is the last selected word in the line.
+ It can either be the last word in the line or the next word has no selection. + + the word to check + + + + + Returns the words of the linebox + + + + + + Represents a word inside an inline box + + + Because of performance, words of text are the most atomic + element in the project. It should be characters, but come on, + imagine the performance when drawing char by char on the device.
+ It may change for future versions of the library. + + + + + the CSS box owner of the word + + + + + Rectangle + + + + + If the word is selected this points to the selection handler for more data + + + + + Init. + + the CSS box owner of the word + + + + Gets the Box where this word belongs. + + + + + Gets or sets the bounds of the rectangle + + + + + Left of the rectangle + + + + + Top of the rectangle + + + + + Width of the rectangle + + + + + Get the full width of the word including the spacing. + + + + + Gets the actual width of whitespace between words. + + + + + Height of the rectangle + + + + + Gets or sets the right of the rectangle. When setting, it only affects the Width of the rectangle. + + + + + Gets or sets the bottom of the rectangle. When setting, it only affects the Height of the rectangle. + + + + + If the word is selected this points to the selection handler for more data + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + is the word is currently selected + + + + + the selection start index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the word is partially selected (-1 if not selected or fully selected) + + + + + Gets or sets an offset to be considered in measurements + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + the image object if it is image word (can be null if not loaded) + + + + + the image rectangle restriction as returned from image load event + + + + + Creates a new BoxWord which represents an image + + the CSS box owner of the word + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + the image rectange restriction as returned from image load event + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + The word text + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Init. + + the CSS box owner of the word + the word chars + was there a whitespace before the word chars (before trim) + was there a whitespace after the word chars (before trim) + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + Represents this word for debugging purposes + + + + + + Used to make space on vertical cell combination + + + + + the index of the row where box starts + + + + + the index of the row where box ends + + + + + Gets the index of the row where box starts + + + + + Gets the index of the row where box ends + + + + + Represents the possible units of the CSS lengths + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + CSS boxes that have ":hover" selector on them. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + Init. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + the name of the html tag + + + + + if the tag is single placed; in other words it doesn't have a separate closing tag; + + + + + collection of attributes and their value the html tag has + + + + + Init. + + the name of the html tag + if the tag is single placed; in other words it doesn't have a separate closing tag; + collection of attributes and their value the html tag has + + + + Gets the name of this tag + + + + + Gets collection of attributes and their value the html tag has + + + + + Gets if the tag is single placed; in other words it doesn't have a separate closing tag;
+ e.g. <br> + + + + + is the html tag has attributes. + + true - has attributes, false - otherwise + + + + Gets a boolean indicating if the attribute list has the specified attribute + + attribute name to check if exists + true - attribute exists, false - otherwise + + + + Get attribute value for given attribute name or null if not exists. + + attribute name to get by + optional: value to return if attribute is not specified + attribute value or null if not found + + + + Represents a block of CSS property values.
+ Contains collection of key-value pairs that are CSS properties for specific css class.
+ Css class can be either custom or html tag name. + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + the name of the css class of the block + + + + + the CSS block properties and values + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + is the css block has :hover pseudo-class + + + + + Creates a new block from the block's source + + the name of the css class of the block + the CSS block properties and values + optional: additional selectors to used in hierarchy + optional: is the css block has :hover pseudo-class + + + + the name of the css class of the block + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + Gets the CSS block properties and its values + + + + + is the css block has :hover pseudo-class + + + + + Merge the other block properties into this css block.
+ Other block properties can overwrite this block properties. + + the css block to merge with + + + + Create deep copy of the CssBlock. + + new CssBlock with same data + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Check if the selectors of the css blocks is the same. + + the other block to compare to + true - the selectors on blocks are the same, false - otherwise + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Serves as a hash function for a particular type. + + A hash code for the current . + + + + Returns a that represents the current . + + + + + Holds single class selector in css block hierarchical selection (p class1 > div.class2) + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Creates a new block from the block's source + + the name of the css class of the block + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Returns a that represents the current . + + + + + Controls the way styles are generated when html is generated. + + + + + styles are not generated at all + + + + + style are inserted in style attribute for each html tag + + + + + style section is generated in the head of the html + + + + + Callback used in to allow setting image externally and async.
+ The callback can provide path to image file path, URL or the actual image to use.
+ If is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + the image to use + optional: limit to specific rectangle in the loaded image + + + + Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and + provide file path to load the image from. Can also use the asynchronous image overwrite not to block HTML rendering is applicable.
+ If no alternative data is provided the original source will be used.
+ + + + + use to cancel the image loading by html renderer, the provided image will be used. + + + + + the source of the image (file path or uri) + + + + + collection of all the attributes that are defined on the image element + + + + + Callback used to allow setting image externally and async. + + + + + Init. + + the source of the image (file path or Uri) + collection of all the attributes that are defined on the image element + Callback used to allow setting image externally and async. + + + + the source of the image (file path, URL or inline data) + + + + + collection of all the attributes that are defined on the image element or CSS style + + + + + Indicate the image load is handled asynchronously. + Cancel this image loading and overwrite the image asynchronously using callback method.
+ + + + + Callback to overwrite the loaded image with error image.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + the path to the image to load (file path or URL) + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + + + + + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ If imageRectangle is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + + + + + Raised when the user clicks on a link in the html. + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + Init. + + the link href that was clicked + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + + + + + + + Exception thrown when client code subscribed to LinkClicked event thrown exception. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a specified error message. + + The message that describes the error. + + + + Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ It can happen if some async event has occurred that requires re-paint and re-layout of the html.
+ Example: async download of image is complete. + + + + + is re-layout is required for the refresh + + + + + Init. + + is re-layout is required for the refresh + + + + is re-layout is required for the refresh + + + + + + + + + + + Raised when an error occurred during html rendering. + + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + Init. + + the type of error to report + the error message + optional: the exception that occurred + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + + + + + + + Enum of possible error types that can be reported. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + the location to scroll to + + + + + Init. + + the location to scroll to + + + + the x location to scroll to + + + + + the x location to scroll to + + + + + + + + + + + Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Init. + + the source of the image (file path or URL) + collection of all the attributes that are defined on the image element + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Holds data on link element in HTML.
+ Used to expose data outside of HTML Renderer internal structure. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Init. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Is the link is directed to another element in the html + + + + + Return the id of the element this anchor link is referencing. + + + + + + + + + + + Contains all the paint code to paint different background images. + + + + + Draw the background image of the given box in the given rectangle.
+ Handle background-repeat and background-position values. + + the device to draw into + the box to draw its background image + the handler that loads image to draw + the rectangle to draw image in + + + + Get top-left location to start drawing the image at depending on background-position value. + + the background-position value + the rectangle to position image in + the size of the image + the top-left location + + + + Draw the background image at the required location repeating it over the X axis.
+ Adjust location to left if starting location doesn't include all the range (adjusted to center or right). + + + + + Draw the background image at the required location repeating it over the Y axis.
+ Adjust location to top if starting location doesn't include all the range (adjusted to center or bottom). + + + + + Draw the background image at the required location repeating it over the X and Y axis.
+ Adjust location to left-top if starting location doesn't include all the range (adjusted to center or bottom/right). + + + + + Contains all the complex paint code to paint different style borders. + + + + + used for all border paint to use the same points and not create new array each time. + + + + + Draws all the border of the box with respect to style, width, etc. + + the device to draw into + the box to draw borders for + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Draw simple border. + + Desired border + the device to draw to + Box which the border corresponds + the brush to use + the bounding rectangle to draw in + Beveled border path, null if there is no rounded corners + + + + Draw specific border (top/bottom/left/right) with the box data (style/width/rounded).
+ + desired border to draw + the box to draw its borders, contain the borders data + the device to draw into + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + + + + Set rectangle for inset/outset border as it need diagonal connection to other borders. + + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + Beveled border path, null if there is no rounded corners + + + + Makes a border path for rounded borders.
+ To support rounded dotted/dashed borders we need to use arc in the border path.
+ Return null if the border is not rounded.
+ + the device to draw into + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Beveled border path, null if there is no rounded corners + + + + Get pen to be used for border draw respecting its style. + + + + + Get the border color for the given box border. + + + + + Get the border width for the given box border. + + + + + Get the border style for the given box border. + + + + + Makes the specified color darker for inset/outset borders. + + + + + Handle context menu. + + + + + select all text + + + + + copy selected text + + + + + copy the link source + + + + + open link (as left mouse click) + + + + + copy the source of the image + + + + + copy image to clipboard + + + + + save image to disk + + + + + open video in browser + + + + + copy video url to browser + + + + + the selection handler linked to the context menu handler + + + + + the html container the handler is on + + + + + the last context menu shown + + + + + the control that the context menu was shown on + + + + + the css rectangle that context menu shown on + + + + + the css link box that context menu shown on + + + + + Init context menu items strings. + + + + + Init. + + the selection handler linked to the context menu handler + the html container the handler is on + + + + Show context menu clicked on given rectangle. + + the parent control to show the context menu on + the rectangle that was clicked to show context menu + the link that was clicked to show context menu on + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Dispose of the last used context menu. + + + + + Handle link click. + + + + + Copy the href of a link to clipboard. + + + + + Open save as dialog to save the image + + + + + Copy the image source to clipboard. + + + + + Copy image object to clipboard. + + + + + Copy selected text. + + + + + Select all text. + + + + + Utilities for fonts and fonts families handling. + + + + + + + + + + Allow to map not installed fonts to different + + + + + collection of all installed and added font families to check if font exists + + + + + cache of all the font used not to create same font again and again + + + + + Init. + + + + + Check if the given font family exists by name + + the font to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get cached font instance for the given font properties.
+ Improve performance not to create same font multiple times. + + cached font instance + + + + Get cached font if it exists in cache or null if it is not. + + + + + create font (try using existing font family to support custom fonts) + + + + + Handler for all loading image logic.
+

+ Loading by .
+ Loading by file path.
+ Loading by URI.
+

+ + + + Supports sync and async image loading. + + + If the image object is created by the handler on calling dispose of the handler the image will be released, this + makes release of unused images faster as they can be large.
+ Disposing image load handler will also cancel download of image from the web. + + + + + + the container of the html to handle load image for + + + + + callback raised when image load process is complete with image or without + + + + + the web client used to download image from URL (to cancel on dispose) + + + + + Must be open as long as the image is in use + + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + to know if image load event callback was sync or async raised + + + + + flag to indicate if to release the image object on box dispose (only if image was loaded by the box) + + + + + is the handler has been disposed + + + + + Init. + + the container of the html to handle load image for + callback raised when image load process is complete with image or without + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + Set image of this image box by analyzing the src attribute.
+ Load the image from inline base64 encoded string.
+ Or from calling property/method on the bridge object that returns image or URL to image.
+ Or from file path
+ Or from URI. + + + File path and URI image loading is executed async and after finishing calling + on the main thread and not thread-pool. + + the source of the image to load + the collection of attributes on the element to use in event + the image object (null if failed) + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set the image using callback from load image event, use the given data. + + the path to the image to load (file path or uri) + the image to load + optional: limit to specific rectangle of the image and not all of it + + + + Load the image from inline base64 encoded string data. + + the source that has the base64 encoded image + + + + Extract image object from inline base64 encoded data in the src of the html img element. + + the source that has the base64 encoded image + image from base64 data string or null if failed + + + + Load image from path of image file or URL. + + the file path or uri to load image from + + + + Load the image file on thread-pool thread and calling after. + + the file path to get the image from + + + + Load the image file on thread-pool thread and calling after.
+ Calling on the main thread and not thread-pool. + + the file path to get the image from + + + + Load image from the given URI by downloading it.
+ Create local file name in temp folder from the URI, if the file already exists use it as it has already been downloaded. + If not download the file using . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + key value pair of URL and file info to download the file to + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + Flag image load complete and request refresh for re-layout and invalidate. + + + + + Release the image and client objects. + + + + + Handler for text selection in the html. + + + + + the root of the handled html tree + + + + + handler for showing context menu on right click + + + + + the mouse location when selection started used to ignore small selections + + + + + the starting word of html selection
+ where the user started the selection, if the selection is backwards then it will be the last selected word. + + + + + the ending word of html selection
+ where the user ended the selection, if the selection is backwards then it will be the first selected word. + + + + + the selection start index if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + is the selection goes backward in the html, the starting word comes after the ending word in DFS traversing.
+ + + + + used to ignore mouse up after selection + + + + + current selection process is after double click (full word selection) + + + + + used to know if selection is in the control or started outside so it needs to be ignored + + + + + used to handle drag and drop + + + + + is the cursor on the control has been changed by the selection handler + + + + + used to know if double click selection is requested + + + + + used to know if drag and drop was already started not to execute the same operation over + + + + + Init. + + the root of the handled html tree + + + + Select all the words in the html. + + the control hosting the html to invalidate + + + + Select the word at the given location if found. + + the control hosting the html to invalidate + the location to select word at + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse on the html + + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + is the left mouse button has been released + is the mouse up should be ignored + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse on the html + + + + On mouse leave change the cursor back to default. + + the control hosting the html to set cursor and invalidate + + + + Copy the currently selected html segment to clipboard.
+ Copy rich html text and plain text. + + + + + Get the currently selected text segment in the html.
+ + + + + Copy the currently selected html segment with style.
+ + + + + The selection start index if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start index for + data value or -1 if not applicable + + + + The selection end index if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end index for + + + + The selection start offset if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start offset for + + + + The selection end offset if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end offset for + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Handle html text selection by mouse move over the html with left mouse button pressed.
+ Calculate the words in the selected range and set their selected property. + + the control hosting the html to invalidate + the mouse location + true - partial word selection allowed, false - only full words selection + + + + Clear the current selection. + + + + + Clear the selection from all the words in the css box recursively. + + the css box to selectionStart clear at + + + + Start drag and drop operation on the currently selected html segment. + + the control to start the drag and drop on + + + + Select all the words that are under DOM hierarchy.
+ + the box to start select all at + + + + Check if the current selection is non empty, has some selection data. + + + true - partial word selection allowed, false - only full words selection + true - is non empty selection, false - empty selection + + + + Select all the words that are between word and word in the DOM hierarchy.
+ + the root of the DOM sub-tree the selection is in + selection start word limit + selection end word limit + + + + Select all the words that are between word and word in the DOM hierarchy. + + the current traversal node + selection start word limit + selection end word limit + used to know the traversal is currently in selected range + + + + + Calculate the character index and offset by characters for the given word and given offset.
+ . + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + to set the starting or ending char and offset data + + + + Calculate the character index and offset by characters for the given word and given offset.
+ If the location is below the word line then set the selection to the end.
+ If the location is to the right of the word then set the selection to the end.
+ If the offset is to the left of the word set the selection to the beginning.
+ Otherwise calculate the width of each substring to find the char the location is on. + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + is to include the first character in the calculation + return the index of the char under the location + return the offset of the char under the location + + + + Check if the selection direction is forward or backward.
+ Is the selection start word is before the selection end word in DFS traversal. + + + + + Handler for loading a stylesheet data. + + + + + Load stylesheet data from the given source.
+ The source can be local file or web URI.
+ First raise event to allow the client to overwrite the stylesheet loading.
+ If the stylesheet is downloaded from URI we will try to correct local URIs to absolute.
+ + the container of the html to handle load stylesheet for + the source of the element to load the stylesheet by + the attributes of the link element + return the stylesheet string that has been loaded (null if failed or is given) + return stylesheet data object that was provided by overwrite (null if failed or is given) + + + + Load stylesheet string from given source (file path or uri). + + the container of the html to handle load stylesheet for + the file path or uri to load the stylesheet from + the stylesheet string + + + + Load the stylesheet from local file by given path. + + the container of the html to handle load stylesheet for + the stylesheet file to load + the loaded stylesheet string + + + + Load the stylesheet from uri by downloading the string. + + the container of the html to handle load stylesheet for + the uri to download from + the loaded stylesheet string + + + + Make relative URLs absolute in the stylesheet using the URI of the stylesheet. + + the stylesheet to correct + the stylesheet uri to use to create absolute URLs + Corrected stylesheet + + + + Low level handling of Html Renderer logic.
+ Allows html layout and rendering without association to actual control, those allowing to handle html rendering on any graphics object.
+ Using this class will require the client to handle all propagation's of mouse/keyboard events, layout/paint calls, scrolling offset, + location/size/rectangle handling and UI refresh requests.
+ + + + MaxSize and ActualSize:
+ The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can exceed the max size by layout restrictions (unwrap-able line, set image size, etc.).
+ Set zero for unlimited (width/height separately).
+ + + ScrollOffset:
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ Element that is rendered at location (50,100) with offset of (0,200) will not be rendered + at -100, therefore outside the client rectangle. + + + LinkClicked event
+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link to overwrite by custom logic.
+ If error occurred in event handler it will propagate up the stack. + + + StylesheetLoad event:
+ Raised when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + ImageLoad event:
+ Raised when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ + + Refresh event:
+ Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + RenderError event:
+ Raised when an error occurred during html rendering.
+ + + + + + + + + + + + + + + + parser for CSS data + + + + + the root css box of the parsed html + + + + + list of all css boxes that have ":hover" selector on them + + + + + Handler for text selection in the html. + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + the parsed stylesheet data used for handling the html + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled (default - true) + + + + + Gets or sets a value indicating if anti-aliasing should be avoided + for geometry like backgrounds and borders + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ + + + + the top-left most location of the rendered html + + + + + the max width and height of the rendered html, effects layout, actual size cannot exceed this values.
+ Set zero for unlimited.
+ + + + + Gets or sets the scroll offset of the document for scroll controls + + + + + The actual size of the rendered html (after layout) + + + + + Init. + + + + + + + + + + parser for CSS data + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrapable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + the root css box of the parsed html + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + + + + + + + Clear the content of the HTML container releasing any resources used to render previously existing content. + + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given device. + + the device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the location of the mouse + the mouse event data + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + Raise the stylesheet load event with the given event args. + + the event args + + + + Raise the image load event with the given event args. + + the event args + + + + Request invalidation and re-layout of the control hosting the renderer. + + is re-layout is required for the refresh + + + + Report error in html render process. + + the type of error to report + the error message + optional: the exception that occured + + + + Handle link clicked going over event and using if not canceled. + + the control hosting the html to invalidate + the location of the mouse + the link that was clicked + + + + Add css box that has ":hover" selector to be handled on mouse hover. + + the box that has the hover selector + the css block with the css data with the selector + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Adjust the offset of the given location by the current scroll offset. + + the location to adjust + the adjusted location + + + + Check if the mouse is currently on the html container.
+ Relevant if the html container is not filled in the hosted control (location is not zero and the size is not the full size of the control). + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + General utilities. + + + + + Measure the size of the html by performing layout under the given restrictions. + + the graphics to use + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Perform the layout of the html container by given size restrictions returning the final size.
+ The layout can be effected by the HTML content in the if or + is set to true.
+ Handle minimum and maximum size restrictions.
+ Handle auto size and auto size for height only. if is true + is ignored.
+ + the graphics used for layout + the html container to layout + the current size + the min size restriction - can be empty for no restriction + the max size restriction - can be empty for no restriction + if to modify the size (width and height) by html content layout + if to modify the height by html content layout + + + + Parser to parse CSS stylesheet source string into CSS objects. + + + + + split CSS rule + + + + + + + + + + Utility for value parsing. + + + + + The chars to trim the css class name by + + + + + Init. + + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + raw css stylesheet to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the CSS data with parsed CSS objects (never null) + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ The parsed css blocks are added to the given css data, merged if class name already exists. + + the CSS data to fill with parsed CSS objects + raw css stylesheet to parse + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the font-family value to parse + parsed font-family value + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + color value + + + + Remove comments from the given stylesheet. + + the stylesheet to remove comments from + stylesheet without comments + + + + Parse given stylesheet for CSS blocks
+ This blocks are added under the "all" keyword. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Parse given stylesheet for media CSS blocks
+ This blocks are added under the specific media block they are found. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Feeds the style with a block about the specific media.
+ When no media is specified, "all" will be used. + + + the CSS block to handle + optional: the media (default - all) + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse css block selector to support hierarchical selector (p class1 > class2). + + the class selector to parse + return the main class the css block is on + returns the hierarchy of classes or null if single class selector + + + + Parse the properties of the given css block into a key-value dictionary. + + the raw css block to parse + dictionary with parsed css block properties + + + + Add the given property to the given properties collection, if the property is complex containing + multiple css properties then parse them and add the inner properties. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse length property to add only valid lengths. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse color property to add only valid color. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse a complex font property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + + + the value of the property to parse + parsed value + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the value of the property to parse + parsed font-family value + + + + Parse a complex border property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the left, top, right or bottom direction of the border to parse + the properties collection to add the specific properties to + + + + Parse a complex margin property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border style property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border width property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border color property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex padding property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Split multi direction value into the proper direction values (left, top, right, bottom). + + + + + Split the value by the specified separator; e.g. Useful in values like 'padding:5 4 3 inherit' + + Value to be splitted + + Splitted and trimmed values + + + + + + + + + + + + + Parse the given substring to extract border width substring. + Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse CSS properties values like numbers, Urls, etc. + + + + + + + + + + Init. + + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid double number, false - otherwise + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid int number, false - otherwise + + + + Check if the given string is a valid length value. + + the string value to check + true - valid, false - invalid + + + + Evals a number and returns it. If number is a percentage, it will be multiplied by hundredPercent + + Number to be parsed + Number that represents the 100% if parsed number is a percentage + Parsed number. Zero if error while parsing. + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + if the length is in pixels and the length is font related it needs to use 72/96 factor + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + if the length is in pixels and the length is font related it needs to use 72/96 factor + Allows the return double to be in points. If false, result will be pixels + the parsed length value with adjustments + + + + Get the unit to use for the length, use default if no unit found in length string. + + + + + Check if the given color string value is valid. + + color string value to parse + true - valid, false - invalid + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + Color value + + + + Parses a color value in CSS style; e.g. #ff0000, RED, RGB(255,0,0), RGB(100%, 0, 0) + + color substring value to parse + substring start idx + substring length + return the parsed color + true - valid color, false - otherwise + + + + Parses a border value in CSS style; e.g. 1px, 1, thin, thick, medium + + + + + + + + Get color by parsing given hex value color string (#A28B34). + + true - valid color, false - otherwise + + + + Get color by parsing given RGB value color string (RGB(255,180,90)) + + true - valid color, false - otherwise + + + + Get color by parsing given RGBA value color string (RGBA(255,180,90,180)) + + true - valid color, false - otherwise + + + + Get color by given name, including .NET name. + + true - valid color, false - otherwise + + + + Parse the given decimal number string to positive int value.
+ Start at given , ignore whitespaces and take + as many digits as possible to parse to int. + + the string to parse + the index to start parsing at + parsed int or 0 + + + + Parse the given decimal number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Parse the given hex number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Handle css DOM tree generation from raw html and stylesheet. + + + + + Parser for CSS + + + + + Init. + + + + + Generate css tree by parsing the given html and applying the given css style data on it. + + the html to parse + the html container to use for reference resolve + the css data to use + the root of the generated tree + + + + Read styles defined inside the dom structure in links and style elements.
+ If the html tag is "style" tag parse it content and add to the css data for all future tags parsing.
+ If the html tag is "link" that point to style data parse it content and add to the css data for all future tags parsing.
+ + the box to parse style data in + the html container to use for reference resolve + the style data to fill with found styles + check if the css data has been modified by the handled html not to change the base css data + + + + Applies style to all boxes in the tree.
+ If the html tag has style defined for each apply that style to the css box of the tag.
+ If the html tag has "class" attribute and the class name has style defined apply that style on the tag css box.
+ If the html tag has "style" attribute parse it and apply the parsed style on the tag css box.
+ + the box to apply the style to + the style data for the html + + + + Set the selected text style (selection text color and background color). + + + the style data + + + + Assigns the given css classes to the given css box checking if matching.
+ Support multiple classes in single attribute separated by whitespace. + + the css box to assign css to + the css data to use to get the matching css blocks + + + + Assigns the given css style blocks to the given css box checking if matching. + + the css box to assign css to + the css data to use to get the matching css blocks + the class selector to search for css blocks + + + + Check if the given css block is assignable to the given css box.
+ the block is assignable if it has no hierarchical selectors or if the hierarchy matches.
+ Special handling for ":hover" pseudo-class.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Check if the given css block is assignable to the given css box by validating the selector.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Assigns the given css style block properties to the given css box. + + the css box to assign css to + the css block to assign + + + + Check if the given style is allowed to be set on the given css box.
+ Used to prevent invalid CssBoxes creation like table with inline display style. + + the css box to assign css to + the style key to cehck + the style value to check + true - style allowed, false - not allowed + + + + Clone css data if it has not already been cloned.
+ Used to preserve the base css data used when changed by style inside html. + + + + + + + + + + + + Converts an HTML length into a Css length + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Execute action on all the "td" cells of the table.
+ Handle if there is "theader" or "tbody" exists. + + the table element + the action to execute + + + + Go over all the text boxes (boxes that have some text that will be rendered) and + remove all boxes that have only white-spaces but are not 'preformatted' so they do not effect + the rendered html. + + the current box to correct its sub-tree + + + + Go over all image boxes and if its display style is set to block, put it inside another block but set the image to inline. + + the current box to correct its sub-tree + + + + Correct the DOM tree recursively by replacing "br" html boxes with anonymous blocks that respect br spec.
+ If the "br" tag is after inline box then the anon block will have zero height only acting as newline, + but if it is after block box then it will have min-height of the font size so it will create empty line. + + the current box to correct its sub-tree + used to know if the br is following a box so it should create an empty line or not so it only + move to a new line + + + + Correct DOM tree if there is block boxes that are inside inline blocks.
+ Need to rearrange the tree so block box will be only the child of other block box. + + the current box to correct its sub-tree + + + + Rearrange the DOM of the box to have block box with boxes before the inner block box and after. + + the box that has the problem + + + + Split bad box that has inline and block boxes into two parts, the left - before the block box + and right - after the block box. + + the parent box that has the problem + the box to split into different boxes + the left block box that is created for the split + + + + Makes block boxes be among only block boxes and all inline boxes have block parent box.
+ Inline boxes should live in a pool of Inline boxes only so they will define a single block.
+ At the end of this process a block box will have only block siblings and inline box will have + only inline siblings. + + the current box to correct its sub-tree + + + + Check if the given box contains only inline child boxes in all subtree. + + the box to check + true - only inline child boxes, false - otherwise + + + + Check if the given box contains inline and block child boxes. + + the box to check + true - has variant child boxes, false - otherwise + + + + + + + + + Parses the source html to css boxes tree structure. + + the html source to parse + + + + Add html text anon box to the current box, this box will have the rendered text
+ Adding box also for text that contains only whitespaces because we don't know yet if + the box is preformatted. At later stage they will be removed if not relevant. + + the html source to parse + the start of the html part + the index of the next html tag + the current box in html tree parsing + + + + Parse the html part, the part from prev parsing index to the beginning of the next html tag.
+ + the html source to parse + the index of the next html tag + the current box in html tree parsing + the end of the parsed part, the new start index + + + + Parse raw html tag source to object.
+ Extract attributes found on the tag. + + the html source to parse + the start index of the tag in the source + the length of the tag from the start index in the source + return the name of the html tag + return the dictionary of tag attributes + true - the tag is closing tag, false - otherwise + + + + Extract html tag attributes from the given sub-string. + + the html source to parse + the start index of the tag attributes in the source + the length of the tag attributes from the start index in the source + return the dictionary of tag attributes + + + + Collection of regular expressions used when parsing + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + Static class that contains argument-checking methods + + + + + Validate given condition is true, otherwise throw exception. + + Exception type to throw. + Condition to assert. + Exception message in-case of assert failure. + + + + Validate given argument isn't Null. + + argument to validate + Name of the argument checked + if is Null + + + + Validate given argument isn't . + + argument to validate + Name of the argument checked + if is + + + + Validate given argument isn't Null or empty. + + argument to validate + Name of the argument checked + if is Null or empty + + + + Validate given argument isn't Null. + + Type expected of arg + argument to validate + Name of the argument checked + if is Null + arg cast as T + + + + Validate given argument isn't Null or empty AND argument value is the path of existing file. + + argument to validate + Name of the argument checked + if is Null or empty + if arg file-path not exist + + + + Utility methods for general stuff. + + + + + Table to convert numbers into roman digits + + + + + Check if the given char is of Asian range. + + the character to check + true - Asian char, false - otherwise + + + + Check if the given char is a digit character (0-9) and (0-9, a-f for HEX) + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Convert the given char to digit. + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Get size that is max of and for width and height separately. + + + + + Get Uri object for the given path if it is valid uri path. + + the path to get uri for + uri or null if not valid + + + + Get the first value in the given dictionary. + + the type of dictionary key + the type of dictionary value + the dictionary + optional: the default value to return of no elements found in dictionary + first element or default value + + + + Get file info object for the given path if it is valid file path. + + the path to get file info for + file info or null if not valid + + + + Get web client response content type. + + the web client to get the response content type from + response content type or null + + + + Gets the representation of the online uri on the local disk. + + The online image uri. + The path of the file on the disk. + + + + Get substring seperated by whitespace starting from the given idex. + + the string to get substring in + the index to start substring search from + return the length of the found string + the index of the substring, -1 if no valid sub-string found + + + + Compare that the substring of is equal to + Assume given substring is not empty and all indexes are valid!
+ + true - equals, false - not equals + + + + Replaces invalid filename chars to '_' + + The possibly-not-valid filename + A valid filename. + + + + Convert number to alpha numeric system by the requested style (UpperAlpha, LowerRoman, Hebrew, etc.). + + the number to convert + the css style to convert by + converted string + + + + Convert the given integer into alphabetic numeric format (D, AU, etc.) + + the number to convert + is to use lowercase + the roman number string + + + + Convert the given integer into alphabetic numeric format (alpha, AU, etc.) + + the number to convert + the roman number string + + + + Convert the given integer into roman numeric format (II, VI, IX, etc.) + + the number to convert + if to use lowercase letters for roman digits + the roman number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + String constants to avoid typing errors. + + + + + Centimeters + + + + + Millimeters + + + + + Pixels + + + + + Inches + + + + + Em - The font size of the relevant font + + + + + The 'x-height' of the relevan font + + + + + Points + + + + + Picas + + + + + Default font size in points. Change this value to modify the default font size. + + + + + Default font used for the generic 'serif' family + + + + + Utility method for handling CSS stuff. + + + + + Brush for selection background + + + + + Brush for selection background + + + + + Gets the white space width of the specified box + + + + + + + + Get CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to get it's property value + the name of the CSS property + the value of the property, null if no such property exists + + + + Set CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to set it's property value + the name of the CSS property + the value to set + + + + Utility class for traversing DOM structure and execution stuff on it. + + + + + Check if the given location is inside the given box deep.
+ Check inner boxes and all lines that the given box spans to. + + the box to check + the location to check + true - location inside the box, false - otherwise + + + + Check if the given box contains only inline child boxes. + + the box to check + true - only inline child boxes, false - otherwise + + + + Recursively searches for the parent with the specified HTML Tag name + + + + + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + fix word space for first word in inline tag. + + the box to check + + + + Gets the next sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Get attribute value by given key starting search from given box, search up the tree until + attribute found or root. + + the box to start lookup at + the attribute to get + the value of the attribute or null if not found + + + + Get css box under the given sub-tree at the given x,y location, get the inner most.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + Optional: if to get only visible boxes (default - true) + css link box if exists or null + + + + Collect all link boxes found in the HTML tree. + + the box to start search from + collection to add all link boxes to + + + + Get css link box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + css link box if exists or null + + + + Get css box under the given sub-tree with the given id.
+ + the box to start search from + the id to find the box by + css box if exists or null + + + + Get css line box under the given sub-tree at the given y location or the nearest line from the top.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the line box to search in + the location to find the box at + css word box if exists or null + + + + Find the css line box that the given word is in. + + the word to search for it's line box + line box that the word is in + + + + Get selected plain text of the given html sub-tree. + + the DOM box to get selected text from its sub-tree + the selected plain text string + + + + Generate html from the given DOM tree.
+ Generate all the style inside the html, in header or for every tag depending on value. + + the box of the html generate html from + Optional: controls the way styles are generated when html is generated + Optional: true - generate only selected html subset, false - generate all (default - false) + generated html + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the root to generate tree from + generated tree + + + + Get selected plain text of the given html sub-tree.
+ Append all the selected words. + + the builder to append the selected text to + the DOM box to get selected text from its sub-tree + the index of the last word appended + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ + the box to check its sub-tree + the collection to add the selected tags to + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ Use to handle boxes that are between selected words but don't have selected word inside.
+ + the box to check its sub-tree + the hash to add the selected boxes to + used to handle boxes that are between selected words but don't have selected word inside + is the current box is in selected sub-tree + + + + find the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + the root of the boxes tree + the selected boxes to find selection root in + the box that is the root of selected boxes + + + + Check if the given box has a names child box (has html tag) recursively. + + the box to check + true - in sub-tree there is a named box, false - otherwise + + + + Write the given html DOM sub-tree into the given string builder.
+ If are given write html only from those tags. + + used to parse CSS data + the string builder to write html into + the html sub-tree to write + Controls the way styles are generated when html is generated + Control if to generate only selected boxes, if given only boxes found in hash will be generated + the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + + + Write the given html tag with all its attributes and styles. + + used to parse CSS data + the string builder to write html into + the css box with the html tag to write + Controls the way styles are generated when html is generated + + + + Clean the given style collection by removing default styles so only custom styles remain.
+ Return new collection where the old remains unchanged. + + the box the styles apply to, used to know the default style + the collection of styles to clean + new cleaned styles collection + + + + Write stylesheet data inline into the html. + + the string builder to write stylesheet into + the css data to write to the head + + + + Get the selected word with respect to partial selected words. + + the word to append + is to get selected text or all the text in the word + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the box to generate for + the string builder to generate to + the current indent level to set indent of generated text + + + + Defines HTML strings + + + + + List of html tags that don't have content + + + + + the html encode\decode pairs + + + + + the html decode only pairs + + + + + Init. + + + + + Is the given html tag is single tag or can have content. + + the tag to check (must be lower case) + true - is single tag, false - otherwise + + + + Decode html encoded string to regular string.
+ Handles <, >, "&. + + the string to decode + decoded string + + + + Encode regular string into html encoded string.
+ Handles <, >, "&. + + the string to encode + encoded string + + + + Decode html special charecters encoded using char entity code (€) + + the string to decode + decoded string + + + + Decode html special charecters encoded using char entity name + + the string to decode + decoded string + + + + Provides some drawing functionality + + + + + Check if the given color is visible if painted (has alpha and color values) + + the color to check + true - visible, false - not visible + + + + Clip the region the graphics will draw on by the overflow style of the containing block.
+ Recursively travel up the tree to find containing block that has overflow style set to hidden. if not + block found there will be no clipping and null will be returned. + + the graphics to clip + the box that is rendered to get containing blocks + true - was clipped, false - not clipped + + + + Draw image loading icon. + + the device to draw into + + the rectangle to draw icon in + + + + Draw image failed to load icon. + + the device to draw into + + the rectangle to draw icon in + + + + Creates a rounded rectangle using the specified corner radius
+ NW-----NE + | | + | | + SW-----SE + + the device to draw into + Rectangle to round + Radius of the north east corner + Radius of the north west corner + Radius of the south east corner + Radius of the south west corner + GraphicsPath with the lines of the rounded rectangle ready to be painted + + + + Represents sub-string of a full string starting at specific location with a specific length. + + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Init sub-string that is the full string. + + the full string that this sub-string is part of + + + + Init. + + the full string that this sub-string is part of + the start index of the sub-string + the length of the sub-string starting at + is null + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Get string char at specific index. + + the idx to get the char at + char at index + + + + Is the sub-string is empty string. + + true - empty string, false - otherwise + + + + Is the sub-string is empty string or contains only whitespaces. + + true - empty or whitespace string, false - otherwise + + + + Is the sub-string contains only whitespaces (at least one). + + true - empty or whitespace string, false - otherwise + + + + Get a string of the sub-string.
+ This will create a new string object! + + new string that is the sub-string represented by this instance + + + + Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length. + + The zero-based starting character position of a substring in this instance. + The number of characters in the substring. + A String equivalent to the substring of length length that begins at startIndex in this instance, or + Empty if startIndex is equal to the length of this instance and length is zero. + + + + Collection of regular expressions used when parsing + + + + + Extracts CSS style comments; e.g. /* comment */ + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts CSS colors; e.g. black white #fff #fe98cd rgb(5,5,5) rgb(45%, 0, 0) + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts CSS border styles; e.g. solid none dotted + + + + + Extracts CSS border widthe; e.g. 1px thin 3em + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + Extracts HTML tags + + + + + Extracts attributes from a HTML tag; e.g. att=value, att="value" + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + 线条图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + 初始化参数 + + + + + 返回或设置X轴间隔 + + + + + 标题 + + + + + 返回图片的宽度 + + + + + 返回或设置图片的高度 + + + + + X轴的间距 + + + + + Y轴的间距 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 背景颜色 + + + + + X轴的颜色 + + + + + Y轴的颜色 + + + + + 返回X轴数据的最大值(供给Painter调用) + + + + + 返回图片数据 + + + + + 画布 + + + + + 作图器 + + + + + 释放内容资源 + + + + + 获取X轴中的最大值 + + + + + + + 获取所有X轴列中的最大值 + + + + + + + 初始化图片 + + X轴的数据 + + + + + 画一条走势图 + + + + + + 画多条走势图 + + + + + + 作图器的基础类 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 返回此作图器的相关链走势图 + + + + + 获取某值在Y轴上的位置 + + 当前点的值 + 点坐标 + + + + 画XY轴线 + + 画布 + X轴的数据 + + + + 画标题 + + + + + + 画走势线 + + 画布 + X轴数据 + + + + 方块图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图的X轴数据 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + + + 标题 + + + + + 值 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 值的颜色 + + + + + 值的字体 + + + + + 绘制颜色 + + + + + 值是否可见 + + + + + 克隆自身 + + + + + + 定义X轴的数据集合 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + 添加一批数据 + + 轴的标题 + + + + 添加一批数据 + + 轴的标题 + 轴的值 + + + + 重置轴的值 + + 轴的值 + + + + 克隆数据 + + + + + + Indicates the behavior of a key when a cell "on the edge" is being edited. + and the normal behavior of that key would exceed the edge. For example, + for a key that normally moves one column to the left, the "edge" would be + the left most column, since the normal action of the key cannot be taken + (since there are no more columns to the left). + + + + + 按键将被忽略 + + + + + 按键将导致单元格编辑环绕到相对边缘的单元格。 + + + + + 按键将Wrap，但该列将更改为相应的相邻列。这只对正常操作为ChangeRow的键有意义。 + + + + + 按键将Wrap，但该行将更改为相应的相邻行。这只对正常操作为ChangeColumn的键有意义. + + + + + 该键将导致当前编辑操作结束。 + + + + + Indicates the normal behaviour of a key when used during a cell edit + operation. + + + + + The key press will be ignored + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the left. + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the right. + + + + + The key press will end the current edit and begin an edit + operation on the row above. + + + + + The key press will end the current edit and begin an edit + operation on the row below + + + + + The key press will cancel the current edit + + + + + The key press will finish the current edit operation + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Instances of this class handle key presses during a cell edit operation. + + + + + 设置给定键的行为 + + + + + + + + 处理按键操作 + + + + True if the key was completely handled. + + + + Gets or sets the ObjectListView on which the current key is being handled. + This cannot be null. + + + + + Gets the row of the cell that is currently being edited + + + + + Gets the index of the column of the cell that is being edited + + + + + Gets or sets the map that remembers the normal behaviour of keys + + + + + Gets or sets the map that remembers the desired behaviour of keys + on edge cases. + + + + + Setup the default key mapping + + + + + Handle the end edit command + + + + + Handle the cancel edit command + + + + + Placeholder that subclasses can override to handle any custom verbs + + + + + + + + Handle a change row command + + + + + + + Handle a change column command + + + + + + + Start editing the indicated cell if that cell is not already being edited + + The row to edit + The cell within that row to edit + + + + Gets the adjacent item to the given item in the given direction. + If that item is disabled, continue in that direction until an enabled item is found. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more enabled items in that direction. + + + + Gets the adjacent item to the given item in the given direction, wrapping if needed. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more items in that direction. + + + + Gets a collection of columns that are editable in the order they are shown to the user + + + + + These items allow combo boxes to remember a value and its description. + + + + + + + + + + + + + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + This editor shows and auto completes values from the given listview column. + + + + + Create an AutoCompleteCellEditor + + + + + + + This combo box is specialised to allow editing of an enum. + + + + + + + + + + + This editor simply shows and edits integer values. + + + + + + + + + + Gets or sets the value shown by this editor + + + + + This editor simply shows and edits unsigned integer values. + + This class can't be made public because unsigned int is not a + CLS-compliant type. If you want to use, just copy the code to this class + into your project and use it from there. + + + + This editor simply shows and edits boolean values. + + + + + + + + + + This editor simply shows and edits boolean values using a checkbox + + + + + Gets or sets the value shown by this editor + + + + + Gets or sets how the checkbox will be aligned + + + + + This editor simply shows and edits floating point values. + + You can intercept the CellEditStarting event if you want + to change the characteristics of the editor. For example, by increasing + the number of decimal places. + + + + + + + + + Gets or sets the value shown by this editor + + + + + A delegate that creates an editor for the given value + + The model from which that value came + The column for which the editor is being created + A representative value of the type to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A control which can edit the given value + + + + An editor registry gives a way to decide what cell editor should be used to edit + the value of a cell. Programmers can register non-standard types and the control that + should be used to edit instances of that type. + + + All ObjectListViews share the same editor registry. + + + + + Create an EditorRegistry + + + + + Register that values of 'type' should be edited by instances of 'controlType'. + + The type of value to be edited + The type of the Control that will edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), typeof(MySpecialColorEditor)); + + + + + Register the given delegate so that it is called to create editors + for values of the given type + + The type of value to be edited + The delegate that will create a control that can edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), CreateColorEditor); + ... + public Control CreateColorEditor(Object model, OLVColumn column, Object value) + { + return new MySpecialColorEditor(); + } + + + + + Register a delegate that will be called to create an editor for values + that have not been handled. + + The delegate that will create a editor for all other types + + + + Register a delegate that will be given a chance to create a control + before any other option is considered. + + The delegate that will create a control + + + + Remove the registered handler for the given type + + Does nothing if the given type doesn't exist + The type whose registration is to be removed + + + + Create and return an editor that is appropriate for the given value. + Return null if no appropriate editor can be found. + + The model involved + The column to be edited + The value to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A Control that can edit the given type of values + + + + Create and return an editor that will edit values of the given type + + A enum type + + + + A DataListView is a ListView that can be bound to a datasource (which would normally be a DataTable or DataView). + + + This listview keeps itself in sync with its source datatable by listening for change events. + The DataListView will automatically create columns to show all of the data source's columns/properties, if there is not already + a column showing that property. This allows you to define one or two columns in the designer and then have the others generated automatically. + If you don't want any column to be auto generated, set to false. + These generated columns will be only the simplest view of the world, and would look more interesting with a few delegates installed. + This listview will also automatically generate missing aspect getters to fetch the values from the data view. + Changing data sources is possible, but error prone. Before changing data sources, the programmer is responsible for modifying/resetting + the column collection to be valid for the new data source. + Internally, a CurrencyManager controls keeping the data source in-sync with other users of the data source (as per normal .NET + behavior). This means that the model objects in the DataListView are DataRowView objects. If you write your own AspectGetters/Setters, + they will be given DataRowView objects. + + + + + Make a DataListView + + + + + + + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + When a DataSource is set, the control will create OLVColumns to show any + data source columns that are not already shown. + If the DataSource is changed, you will have to remove any previously + created columns, since they will be configured for the previous DataSource. + . + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + Adaptors cannot be shared between controls. Each DataListView needs its own adapter. + + + + + Add the given collection of model objects to this control. + + A collection of model objects + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Insert the given collection of objects before the given position + + Where to insert the objects + The objects to be inserted + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Remove the given collection of model objects from this control. + + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Change the Unfreeze behaviour + + + + + Handles parent binding context changes + + Unused EventArgs. + + + + A DataTreeListView is a TreeListView that calculates its hierarchy based on + information in the data source. + + + Like a , a DataTreeListView sources all its information + from a combination of and . + can be a DataTable, DataSet, + or anything that implements . + + + To function properly, the DataTreeListView requires: + + the table to have a column which holds a unique for the row. The name of this column must be set in . + the table to have a column which holds id of the hierarchical parent of the row. The name of this column must be set in . + a value which identifies which rows are the roots of the tree (). + + The hierarchy structure is determined finding all the rows where the parent key is equal to . These rows + become the root objects of the hierarchy. + + Like a TreeListView, the hierarchy must not contain cycles. Bad things will happen if the data is cyclic. + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. Actually, it can be any value that can + be compared for equality against a basic type. + If this is set to the wrong value (i.e. to a value that no row + has in the parent id column), the list will be empty. + + + + + Gets or sets the value that identifies a row as a root object. + . The RootKeyValue can be of any type, + but the IDE cannot sensibly represent a value of any type, + so this is a typed wrapper around that property. + + + If you want the root value to be something other than a string, + you will have set it yourself. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + An IDragSource controls how drag out from the ObjectListView will behave + + + + + A drag operation is beginning. Return the data object that will be used + for data transfer. Return null to prevent the drag from starting. The data + object will normally include all the selected objects. + + + The returned object is later passed to the GetAllowedEffect() and EndDrag() + methods. + + What ObjectListView is being dragged from. + Which mouse button is down? + What item was directly dragged by the user? There may be more than just this + item selected. + The data object that will be used for data transfer. This will often be a subclass + of DataObject, but does not need to be. + + + + What operations are possible for this drag? This controls the icon shown during the drag + + The data object returned by StartDrag() + A combination of DragDropEffects flags + + + + The drag operation is complete. Do whatever is necessary to complete the action. + + The data object returned by StartDrag() + The value returned from GetAllowedEffects() + + + + A do-nothing implementation of IDragSource that can be safely subclassed. + + + + + See IDragSource documentation + + + + + + + + + See IDragSource documentation + + + + + + + See IDragSource documentation + + + + + + + A reasonable implementation of IDragSource that provides normal + drag source functionality. It creates a data object that supports + inter-application dragging of text and HTML representation of + the dragged rows. It can optionally force a refresh of all dragged + rows when the drag is complete. + + Subclasses can override GetDataObject() to add new + data formats to the data transfer object. + + + + Construct a SimpleDragSource + + + + + Construct a SimpleDragSource that refreshes the dragged rows when + the drag is complete + + + + + + Gets or sets whether the dragged rows should be refreshed when the + drag operation is complete. + + + + + Create a DataObject when the user does a left mouse drag operation. + See IDragSource for further information. + + + + + + + + + Which operations are allowed in the operation? By default, all operations are supported. + + + All opertions are supported + + + + The drag operation is finished. Refreshe the dragged rows if so configured. + + + + + + + Create a data object that will be used to as the data object + for the drag operation. + + + Subclasses can override this method add new formats to the data object. + + The ObjectListView that is the source of the drag + A data object for the drag + + + + Objects that implement this interface can acts as the receiver for drop + operation for an ObjectListView. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Should the drag be allowed to continue? + + + + + + This is a do-nothing implementation of IDropSink that is a useful + base class for more sophisticated implementations. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Change the cursor to reflect the current drag operation. + + You only need to override this if you want non-standard cursors. + The standard cursors are supplied automatically. + + + + + Should the drag be allowed to continue? + + + You only need to override this if you want the user to be able + to end the drop in some non-standard way, e.g. dragging to a + certain point even without releasing the mouse, or going outside + the bounds of the application. + + + + + + This is called when the mouse leaves the drop region and after the + drop has completed. + + + + + The enum indicates which target has been found for a drop operation + + + + + No applicable target has been found + + + + + The list itself is the target of the drop + + + + + An item is the target + + + + + Between two items (or above the top item or below the bottom item) + can be the target. This is not actually ever a target, only a value indicate + that it is valid to drop between items + + + + + Above an item is the target + + + + + Below an item is the target + + + + + A subitem is the target of the drop + + + + + On the right of an item is the target (not currently used) + + + + + On the left of an item is the target (not currently used) + + + + + This class represents a simple implementation of a drop sink. + + + Actually, it should be called CleverDropSink -- it's far from simple and can do quite a lot in its own right. + + + + + Make a new drop sink + + + + + Get or set the locations where a drop is allowed to occur (OR-ed together) + + + + + Gets or sets whether this sink allows model objects to be dragged from other lists. Defaults to true. + + + + + Gets or sets whether the ObjectListView should scroll when the user drags + something near to the top or bottom rows. Defaults to true. + + AutoScroll does not scroll horizontally. + + + + Gets the billboard overlay that will be used to display feedback + messages during a drag operation. + + Set this to null to stop the feedback. + + + + Get or set whether a drop can occur between items of the list + + + + + Get or set whether a drop can occur on the listview itself + + + + + Get or set whether a drop can occur on items in the list + + + + + Get or set whether a drop can occur on a subitem in the list + + + + + Gets or sets whether the drop sink should draw feedback onto the given list + during the drag operation. Defaults to true. + + If this is false, you will have to give the user feedback in some + other fashion, like cursor changes + + + + Get or set the index of the item that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get or set the color that will be used to provide drop feedback + + + + + Get whether the alt key was down during this drop event + + + + + Get whether any modifier key was down during this drop event + + + + + Get whether the control key was down during this drop event + + + + + Get whether the left mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the shift key was down during this drop event + + + + + Get or set the state of the keys during this drop event + + + + + Gets or sets whether the drop sink will automatically use cursors + based on the drop effect. By default, this is true. If this is + set to false, you must set the Cursor yourself. + + + + + Triggered when the sink needs to know if a drop can occur. + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + + + + + Triggered when the sink needs to know if a drop can occur + AND the source is an ObjectListView + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + AND the source is an ObjectListView + + + + + Cleanup the drop sink when the mouse has left the control or + the drag has finished. + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag is moving over this control. + + + + + + Trigger the Dropped events + + + + + + Trigger CanDrop + + + + + + Trigger Dropped + + + + + + Trigger ModelCanDrop + + + + + + Trigger ModelDropped + + + + + + Handle the timer tick event, which is sent when the listview should + scroll + + + + + When the mouse is at the given point, what should the target of the drop be? + + This method should update the DropTarget* members of the given arg block + + The mouse point, in client co-ordinates + + + + What sort of action is possible when the mouse is at the given point? + + + + + + + + + + Based solely on the state of the modifier keys, what drop operation should + be used? + + The drop operation that matches the state of the keys + + + + Should the listview be made to scroll when the mouse is at the given point? + + + + + + Update the state of our sink to reflect the information that + may have been written into the drop event args. + + + + + + Draw the feedback that shows that the background is the target + + + + + + + Draw the feedback that shows that an item (or a subitem) is the target + + + + + DropTargetItem and DropTargetSubItemIndex tells what is the target + + + + + Draw the feedback that shows the drop will occur before target + + + + + + + Draw the feedback that shows the drop will occur after target + + + + + + + Return a GraphicPath that is round corner rectangle. + + + + + + + + Calculate the target rectangle when the given item (and possible subitem) + is the target of the drop. + + + + + + + + Draw a "between items" line at the given co-ordinates + + + + + + + + + + This drop sink allows items within the same list to be rearranged, + as well as allowing items to be dropped from other lists. + + + + This class can only be used on plain ObjectListViews and FastObjectListViews. + The other flavours have no way to implement the insert operation that is required. + + + This class does not work with grouping. + + + This class works when the OLV is sorted, but it is up to the programmer + to decide what rearranging such lists "means". Example: if the control is sorting + students by academic grade, and the user drags a "Fail" grade student up amonst the "A+" + students, it is the responsibility of the programmer to makes the appropriate changes + to the model and redraw/rebuild the control so that the users action makes sense. + + + Users of this class should listen for the CanDrop event to decide + if models from another OLV can be moved to OLV under this sink. + + + + + + Create a RearrangingDropSink + + + + + Create a RearrangingDropSink + + + + + + Trigger OnModelCanDrop + + + + + + Trigger OnModelDropped + + + + + + Do the work of processing the dropped items + + + + + + When a drop sink needs to know if something can be dropped, or + to notify that a drop has occured, it uses an instance of this class. + + + + + Create a OlvDropEventArgs + + + + + Get the original drag-drop event args + + + + + Get the data object that is being dragged + + + + + Get the drop sink that originated this event + + + + + Get or set the index of the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the drag effect that should be used for this operation + + + + + Get or set if this event was handled. No further processing will be done for a handled event. + + + + + Get or set the feedback message for this operation + + + If this is not null, it will be displayed as a feedback message + during the drag. + + + + + Get the ObjectListView that is being dropped on + + + + + Get the location of the mouse (in target ListView co-ords) + + + + + Get the drop action indicated solely by the state of the modifier keys + + + + + These events are triggered when the drag source is an ObjectListView. + + + + + Create a ModelDropEventArgs + + + + + Gets the model objects that are being dragged. + + + + + Gets the ObjectListView that is the source of the dragged objects. + + + + + Get the model object that is being dropped upon. + + This is only value for TargetLocation == Item + + + + Refresh all the objects involved in the operation + + + + + A data transfer object that knows how to transform a list of model + objects into a text and HTML representation. + + + + + Create a data object from the selected objects in the given ObjectListView + + The source of the data object + + + + Create a data object which operates on the given model objects + in the given ObjectListView + + The source of the data object + The model objects to be put into the data object + + + + Gets or sets whether hidden columns will also be included in the text + and HTML representation. If this is false, only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. + + + + + Gets the ObjectListView that is being used as the source of the data + + + + + Gets the model objects that are to be placed in the data object + + + + + Put a text and HTML representation of our model objects + into the data object. + + + + + Create an exporter for the data contained in this object + + + + + + Make a HTML representation of our model objects + + + + + Convert the fragment of HTML into the Clipboards HTML format. + + The HTML format is found here http://msdn2.microsoft.com/en-us/library/aa767917.aspx + + The HTML to put onto the clipboard. It must be valid HTML! + A string that can be put onto the clipboard and will be recognized as HTML + + + + A FastDataListView virtualizes the display of data from a DataSource. It operates on + DataSets and DataTables in the same way as a DataListView, but does so much more efficiently. + + + + A FastDataListView still has to load all its data from the DataSource. If you have SQL statement + that returns 1 million rows, all 1 million rows will still need to read from the database. + However, once the rows are loaded, the FastDataListView will only build rows as they are displayed. + + + + + + + + + + + + 获取或设置在设置DataSource时是否自动生成列以显示列。 + + 必须在设置DataSource之前设置此设置。之后就没有效果了。 + + + + 获取或设置将在此列表视图中显示的VirtualListDataSource。 + + VirtualListDataSource应实现 , , + 或 . 以下是一些常见的对象类型 + + + + + + + + 绑定到列表容器时 (即，实现 接口, 比如 ) + 您还必须实现 属性，以便标识要显示的特定列表。您也可以设置 属性， + 即使当VirtualListDataSource引用列表时也是如此, 因为 还可以用于导航列表之间的关系. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + Create the DataSourceAdapter that this control will use. + + A DataSourceAdapter configured for this list + Subclasses should override this to create their + own specialized adapters + + + + Change the Unfreeze behaviour + + + + + A FastObjectListView trades function for speed. + + + On my mid-range laptop, this view builds a list of 10,000 objects in 0.1 seconds, + as opposed to a normal ObjectListView which takes 10-15 seconds. Lists of up to 50,000 items should be + able to be handled with sub-second response times even on low end machines. + + A FastObjectListView is implemented as a virtual list with many of the virtual modes limits (e.g. no sorting) + fixed through coding. There are some functions that simply cannot be provided. Specifically, a FastObjectListView cannot: + + use Tile view + show groups on XP + + + + + + + Make a FastObjectListView + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + This method preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code and performance is O(n) where n is the number of selected rows. + This method is not thread safe. + + + + + Move the given collection of objects to the given index. + + This operation only makes sense on non-grouped ObjectListViews. + + + + + + 删除任何排序并恢复到模型对象的给定顺序 + + To be really honest, Unsort() doesn't work on FastObjectListViews since + the original ordering of model objects is lost when Sort() is called. So this method + effectively just turns off sorting. + + + + 为FastObjectListView提供数据源 + + + This class isn't intended to be used directly, but it is left as a public + class just in case someone wants to subclass it. + + + + + Create a FastObjectListDataSource + + + + + + Get n'th object + + + + + + + How many items are in the data source + + + + + + Get the index of the given model + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Remove the given collection of models from this source. + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + Apply the given filters to this data source. One or both may be null. + + + + + + + Gets the full list of objects being used for this fast list. + This list is unfiltered. + + + + + Gets the list of objects from ObjectList which survive any installed filters. + + + + + Rebuild the map that remembers which model object is displayed at which line + + + + + Build our filtered list from our full list. + + + + + Concrete implementation of the ICluster interface. + + + + + Create a cluster + + The key for the cluster + + + + Return a string representation of this cluster + + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Return an indication of the ordering between this object and the given one + + + + + + + This class provides a useful base implemention of a clustering + strategy where the clusters are grouped around the value of a given column. + + + + + This field is the text that will be shown to the user when a cluster + key is null. It is exposed so it can be localized. + + + + + This field is the text that will be shown to the user when a cluster + key is empty (i.e. a string of zero length). It is exposed so it can be localized. + + + + + Gets or sets the format that will be used by default for clusters that only + contain 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + + + + Gets or sets the format that will be used by default for clusters that + contain 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + + + + Create a clustering strategy + + + + + Gets or sets the column upon which this strategy is operating + + + + + Gets or sets the format that will be used when the cluster + contains only 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatSingular will be used + + + + Gets or sets the format that will be used when the cluster + contains 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatPlural will be used + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Create a label that combines the string representation of the cluster + key with a format string that holds an "X [N items in cluster]" type layout. + + + + + + + + This class calculates clusters from the groups that the column uses. + + + + This is the default strategy for all non-date, filterable columns. + + + This class does not strictly mimic the groups created by the given column. + In particular, if the programmer changes the default grouping technique + by listening for grouping events, this class will not mimic that behaviour. + + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + This enum is used to indicate various portions of a datetime + + + + + Year + + + + + Month + + + + + Day of the month + + + + + Hour + + + + + Minute + + + + + Second + + + + + This class implements a strategy where the model objects are clustered + according to some portion of the datetime value in the configured column. + + To create a strategy that grouped people who were born in + the same month, you would create a strategy that extracted just + the month, and formatted it to show just the month's name. Like this: + + + someColumn.ClusteringStrategy = new DateTimeClusteringStrategy(DateTimePortion.Month, "MMMM"); + + + + + Create a strategy that clusters by month/year + + + + + Create a strategy that clusters around the given parts + + + + + + + Gets or sets the format string will will be used to create a user-presentable + version of the cluster key. + + The format should use the date/time format strings, as documented + in the Windows SDK. Both standard formats and custom format will work. + "D" - long date pattern + "MMMM, yyyy" - "January, 1999" + + + + Gets or sets the parts of the DateTime that will be extracted when + determining the clustering key for an object. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Convert the given date into a user presentable string + + + + + + + Instances of this class know how to build a Filter menu. + It is responsible for clustering the values in the target column, + build a menu that shows those clusters, and then constructing + a filter that will enact the users choices. + + + Almost all of the methods in this class are declared as "virtual protected" + so that subclasses can provide alternative behaviours. + + + + + Gets or sets the string that labels the Apply button. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Clear All menu item. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Filtering menu as a whole.. + Exposed so it can be localized. + + + + + Gets or sets the string that represents Select All values. + If this is set to null or empty, no Select All option will be included. + Exposed so it can be localized. + + + + + Gets or sets the image that will be placed next to the Clear Filtering menu item + + + + + Gets or sets the image that will be placed next to all "Apply" menu items on the filtering menu + + + + + Gets or sets whether null should be considered as a valid data value. + If this is true (the default), then a cluster will null as a key will be allow. + If this is false, object that return a cluster key of null will ignored. + + + + + Gets or sets the maximum number of objects that the clustering strategy + will consider. This should be large enough to collect all unique clusters, + but small enough to finish in a reasonable time. + + The default value is 10,000. This should be perfectly + acceptable for almost all lists. + + + + Create a Filter menu on the given tool tip for the given column in the given ObjectListView. + + This is the main entry point into this class. + + + + The strip that should be shown to the user + + + + Create a collection of clusters that should be presented to the user + + + + + + + + + Order the given list of clusters in the manner in which they should be presented to the user. + + + + + + + Do the work of making a menu that shows the clusters to the users + + + + + + + + Wrap a protected section around the real HandleItemChecked method, so that if + that method tries to change a "checkedness" of an item, we don't get a recursive + stack error. Effectively, this ensure that HandleItemChecked is only called + in response to a user action. + + + + + + + Handle a user-generated ItemCheck event + + + + + + + Handle any checking/unchecking of the Select All option, and keep + its checkedness in sync with everything else that is checked. + + + + + + + + Clear all the filters that are applied to the given column + + The column from which filters are to be removed + + + + Apply the selected values from the given list as a filter on the given column + + A list in which the checked items should be used as filters + The column for which a filter should be generated + + + + Interface for model-by-model filtering + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + Interface for whole list filtering + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Base class for model-by-model filters + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + This filter calls a given Predicate to decide if a model object should be included + + + + + Create a filter based on the given predicate + + The function that will filter objects + + + + Gets or sets the predicate used to filter model objects + + + + + Should the given model object be included? + + + + + + + A CompositeFilter joins several other filters together. + If there are no filters, all model objects are included + + + + + Create an empty filter + + + + + Create a composite filter from the given list of filters + + A list of filters + + + + Gets or sets the filters used by this composite + + + + + Get the sub filters that are text match filters + + + + + Decide whether or not the given model should be included by the filter + + + True if the object is included by the filter + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must satisfy all filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must only satisfy one of the filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter from the given filters + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + Instances of this class extract a value from the model object + and compare that value to a list of fixed values. The model + object is included if the extracted value is in the list + + If there is no delegate installed or there are + no values to match, no model objects will be matched + + + + Create a filter that will use the given delegate to extract values + + + + + + Create a filter that will extract values using the given delegate + and compare them to the values in the given list. + + + + + + + Gets or sets the delegate that will be used to extract values + from model objects + + + + + Gets or sets the list of values that the value extracted from + the model object must match in order to be included. + + + + + Should the given model object be included? + + + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Instances of this class match a property of a model objects against + a list of bit flags. The property should be an xor-ed collection + of bits flags. + + Both the property compared and the list of possible values + must be convertible to ulongs. + + + + Create an instance + + + + + + + Gets or sets the collection of values that will be matched. + These must be ulongs (or convertible to ulongs). + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Base class for whole list filters + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Instance of this class implement delegate based whole list filtering + + + + + A delegate that filters on a whole list + + + + + + + Create a ListFilter + + + + + + Gets or sets the delegate that will filter the list + + + + + Do the actual work of filtering + + + + + + + Filter the list so only the last N entries are displayed + + + + + Create a no-op tail filter + + + + + Create a filter that includes on the last N model objects + + + + + + Gets or sets the number of model objects that will be + returned from the tail of the list + + + + + Return the last N subset of the model objects + + + + + + + Instances of this class cluster model objects on the basis of a + property that holds an xor-ed collection of bit flags. + + + + + Create a clustering strategy that operates on the flags of the given enum + + + + + + Create a clustering strategy around the given collections of flags and their display labels. + There must be the same number of elements in both collections. + + The list of flags. + + + + + Gets the value that will be xor-ed to test for the presence of a particular value. + + + + + Gets the labels that will be used when the corresponding Value is XOR present in the data. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + A cluster is a like collection of objects that can be usefully filtered + as whole using the filtering UI provided by the ObjectListView. + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Implementation of this interface control the selecting of cluster keys + and how those clusters will be presented to the user + + + + + Gets or sets the column upon which this strategy will operate + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + If the returned value is an IEnumerable, the given model is considered + to belong to multiple clusters + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Instances of this class include only those rows of the listview + that match one or more given strings. + + This class can match strings by prefix, regex, or simple containment. + There are factory methods for each of these matching strategies. + + + + Create a text filter that will include rows where any cell matches + any of the given regex expressions. + + + + + Any string that is not a valid regex expression will be ignored. + + + + Create a text filter that includes rows where any cell begins with one of the given strings + + + + + + + + Create a text filter that includes rows where any cell contains any of the given strings. + + + + + + + + Create a TextFilter + + + + + + Create a TextFilter that finds the given string + + + + + + + Create a TextFilter that finds the given string using the given comparison + + + + + + + + Gets or sets which columns will be used for the comparisons? If this is null, all columns will be used + + + + + Gets or sets additional columns which will be used in the comparison. These will be used + in addition to either the Columns property or to all columns taken from the control. + + + + + Gets or sets the collection of strings that will be used for + contains matching. Setting this replaces all previous texts + of any kind. + + + + + Gets whether or not this filter has any search criteria + + + + + Gets or set the ObjectListView upon which this filter will work + + + You cannot really rebase a filter after it is created, so do not change this value. + It is included so that it can be set in an object initializer. + + + + + Gets or sets the collection of strings that will be used for + prefix matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + This is only used when doing Regex matching (obviously). + If this is not set specifically, the appropriate options are chosen to match the + StringComparison setting (culture invariant, case sensitive). + + + + + Gets or sets the collection of strings that will be used for + regex pattern matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets how the filter will match text + + + + + Loop over the columns that are being considering by the filter + + + + + + Do the actual work of filtering + + + + + + + Find all the ways in which this filter matches the given string. + + This is used by the renderer to decide which bits of + the string should be highlighted + + A list of character ranges indicating the matched substrings + + + + Is the given column one of the columns being used by this filter? + + + + + + + Base class for the various types of string matching that TextMatchFilter provides + + + + + Gets how the filter will match text + + + + + Gets the text filter to which this component belongs + + + + + Gets or sets the text that will be matched + + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + This component provides text contains matching strategy. + + + + + Create a text contains strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides text begins with matching strategy. + + + + + Create a text begins strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides regex matching strategy. + + + + + Creates a regex strategy + + + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + + + Gets or sets a compilex regular expression, based on our current Text and RegexOptions. + + + If Text fails to compile as a regular expression, this will return a Regex object + that will match all strings. + + + + + Gets whether or not our current regular expression is a valid regex + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This attribute is used to mark a property of a model + class that should be noticed by Generator class. + + + All the attributes of this class match their equivilent properties on OLVColumn. + + + + + Create a new OLVColumnAttribute + + + + + Create a new OLVColumnAttribute with the given title + + The title of the column + + + + + + + + + + + + + + + + + + + + + + + + + + + + + An array of IComparables that mark the cutoff points for values when + grouping on this column. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Properties marked with [OLVChildren] will be used as the children source in a TreeListView. + + + + + Properties marked with [OLVIgnore] will not have columns generated for them. + + + + + ColumnComparer is the workhorse for all comparison between two values of a particular column. + If the column has a specific comparer, use that to compare the values. Otherwise, do + a case insensitive string compare of the string representations of the values. + + This class inherits from both IComparer and its generic counterpart + so that it can be used on untyped and typed collections. + This is used by normal (non-virtual) ObjectListViews. Virtual lists use + ModelObjectComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column + + The column whose values will be compared + The ordering for column values + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column, and by a secondary column if the primary + column is equal. + + The column whose values will be compared + The ordering for column values + The column whose values will be compared for secondary sorting + The ordering for secondary column values + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare the actual values to be used for sorting + + The aspect extracted from the first row + The aspect extracted from the second row + An ordering indication: -1, 0, 1 + + + + This comparer sort list view groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + + + + Create a group comparer + + The ordering for column values + + + + Compare the two groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + group1 + group2 + An ordering indication: -1, 0, 1 + + + + This comparer can be used to sort a collection of model objects by a given column + + + This is used by virtual ObjectListViews. Non-virtual lists use + ColumnComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a model object comparer + + + + + + + Create a model object comparer with a secondary sorting column + + + + + + + + + Compare the two model objects + + + + + + + + Compare the actual values + + + + + + + + A helper class that translates DataSource events for an ObjectListView + + + + + Make a DataSourceAdapter + + + + + Finalize this object + + + + + Release all the resources used by this instance + + + + + Release all the resources used by this instance + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets the ObjectListView upon which this adaptor will operate + + + + + Gets or sets the currency manager which is handling our binding context + + + + + + + + + + + + + + + + + + + + + + + + + + + Our data source has changed. Figure out how to handle the new source + + + + + Our data source has changed. Figure out how to handle the new source + + + + + The data source for this control has changed. Reconfigure the control for the new source + + + + + Take the contents of the currently bound list and put them into the control + + + + + Create columns for the listview based on what properties are available in the data source + + + This method will create columns if there is not already a column displaying that property. + + + + + Decide if a new column should be added to the control to display + the given property + + + + + + + Configure the given column to show the given property. + The title and aspect name of the column are already filled in. + + + + + + + Generate aspect getters and putters for any columns that are missing them (and for which we have + enough information to actually generate a getter) + + + + + CurrencyManager ListChanged event handler. + Deals with fine-grained changes to list items. + + + It's actually difficult to deal with these changes in a fine-grained manner. + If our listview is grouped, then any change may make a new group appear or + an old group disappear. It is rarely enough to simply update the affected row. + + + + + + + Handle PropertyDescriptor* events + + + + + + Handle ItemMoved event + + + + + + Handle the ItemDeleted event + + + + + + Handle an ItemAdded event. + + + + + + Handle the Reset event + + + + + + Handle ItemChanged event. This is triggered when a single item + has changed, so just refresh that one item. + + + Even in this simple case, we should probably rebuild the list. + For example, the change could put the item into its own new group. + + + + The CurrencyManager calls this if the data source looks + different. We just reload everything. + + + + + CHECK: Do we need this if we are handle ListChanged metadata events? + + + + + Called by the CurrencyManager when the currently selected item + changes. We update the ListView selection so that we stay in sync + with any other controls bound to the same source. + + + + + + + Change the control's position (which is it's currently selected row) + to the nth row in the dataset + + The index of the row to be selected + + + + Handle the selection changing in our ListView. + We need to tell our currency manager about the new position. + + + + + + + Handle the frozenness of our ListView changing. + + + + + + + Handle a change to the BindingContext of our ListView. + + + + + + + These delegates are used to extract an aspect from a row object + + + + + These delegates are used to put a changed value back into a model object + + + + + These delegates can be used to convert an aspect value to a display string, + instead of using the default ToString() + + + + + These delegates are used to get the tooltip for a cell + + + + + These delegates are used to the state of the checkbox for a row object. + + + For reasons known only to someone in Microsoft, we can only set + a boolean on the ListViewItem to indicate it's "checked-ness", but when + we receive update events, we have to use a tristate CheckState. So we can + be told about an indeterminate state, but we can't set it ourselves. + + As of version 2.0, we can now return indeterminate state. + + + + + These delegates are used to get the state of the checkbox for a row object. + + + + + + + These delegates are used to put a changed check state back into a model object + + + + + These delegates are used to put a changed check state back into a model object + + + + + + + + These delegates are used to get the renderer for a particular cell + + + + + The callbacks for RightColumnClick events + + + + + This delegate will be used to own draw header column. + + + + + This delegate is called when a group has been created but not yet made + into a real ListViewGroup. The user can take this opportunity to fill + in lots of other details about the group. + + + + + These delegates are used to retrieve the object that is the key of the group to which the given row belongs. + + + + + These delegates are used to convert a group key into a title for the group + + + + + These delegates are used to get the tooltip for a column header + + + + + These delegates are used to fetch the image selector that should be used + to choose an image for this column. + + + + + These delegates are used to draw a cell + + + + + These delegates are used to fetch a row object for virtual lists + + + + + These delegates are used to format a listviewitem before it is added to the control. + + + + + These delegates can be used to return the array of texts that should be searched for text filtering + + + + + These delegates are used to sort the listview in some custom fashion + + + + + These delegates are used to order two strings. + x cannot be null. y can be null. + + + + + An ObjectListView is a much easier to use, and much more powerful, version of the ListView. + + + + An ObjectListView automatically populates a ListView control with information taken + from a given collection of objects. It can do this because each column is configured + to know which bit of the model object (the "aspect") it should be displaying. Columns similarly + understand how to sort the list based on their aspect, and how to construct groups + using their aspect. + + + Aspects are extracted by giving the name of a method to be called or a + property to be fetched. These names can be simple names or they can be dotted + to chain property access e.g. "Owner.Address.Postcode". + Aspects can also be extracted by installing a delegate. + + + An ObjectListView can show a "this list is empty" message when there is nothing to show in the list, + so that the user knows the control is supposed to be empty. + + + Right clicking on a column header should present a menu which can contain: + commands (sort, group, ungroup); filtering; and column selection. Whether these + parts of the menu appear is controlled by ShowCommandMenuOnRightClick, + ShowFilterMenuOnRightClick and SelectColumnsOnRightClick respectively. + + + The groups created by an ObjectListView can be configured to include other formatting + information, including a group icon, subtitle and task button. Using some undocumented + interfaces, these groups can even on virtual lists. + + + ObjectListView supports dragging rows to other places, including other application. + Special support is provide for drops from other ObjectListViews in the same application. + In many cases, an ObjectListView becomes a full drag source by setting to + true. Similarly, to accept drops, it is usually enough to set to true, + and then handle the and events (or the and + events, if you only want to handle drops from other ObjectListViews in your application). + + + For these classes to build correctly, the project must have references to these assemblies: + + + System + System.Data + System.Design + System.Drawing + System.Windows.Forms (obviously) + + + + + + How does a user indicate that they want to edit cells? + + + + + 列表将不支持编辑(同时F2按键无效) + + + + + 单击 单元格 将编辑值. + 选择该行，就像正常选择行一样。用户必须按F2键才能编辑主列。 + + + + + 双击子项或主列将编辑该单元格。 + F2键将编辑主列。 + + + + + 按F2键是编辑单元格的唯一方法。一旦主列被编辑， + 行中的其他单元格可以通过按Tab键进行编辑。 + + + + + 只需单击任意单元格即可编辑值，即使是主列也是如此。 + + + + + 这些值指定向用户显示列选择的方式 + + + + + 不会显示任何列选择 + + + + + 这些列将显示在主菜单中 + + + + + 这些列将显示在子菜单中 + + + + + 将显示一个模式对话框，允许用户选择列 + + + + + Triggered after a ObjectListView has been searched by the user typing into the list + + + + + Triggered after a ObjectListView has been sorted + + + + + Triggered before a ObjectListView is searched by the user typing into the list + + + Set Cancelled to true to prevent the searching from taking place. + Changing StringToFind or StartSearchFrom will change the subsequent search. + + + + + Triggered before a ObjectListView is sorted + + + Set Cancelled to true to prevent the sort from taking place. + Changing ColumnToSort or SortOrder will change the subsequent sort. + + + + + Triggered after a ObjectListView has created groups + + + + + Triggered before a ObjectListView begins to create groups + + + Set Groups to prevent the default group creation process + + + + + Triggered just before a ObjectListView creates groups + + + You can make changes to the groups, which have been created, before those + groups are created within the listview. + + + + + Triggered when a button in a cell is left clicked. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when a cell has finished being edited. + + + + + Triggered when a cell is about to finish being edited. + + If Cancel is already true, the user is cancelling the edit operation. + Set Cancel to true to prevent the value from the cell being written into the model. + You cannot prevent the editing from finishing within this event -- you need + the CellEditValidating event for that. + + + + Triggered when a cell is about to be edited. + + Set Cancel to true to prevent the cell being edited. + You can change the the Control to be something completely different. + + + + Triggered when a cell editor needs to be validated + + + If this event is cancelled, focus will remain on the cell editor. + + + + + Triggered when a cell is left clicked. + + + + + Triggered when the mouse is above a cell. + + + + + Triggered when a cell is right clicked. + + + + + This event is triggered when a cell needs a tool tip. + + + + + This event is triggered when a checkbox is checked/unchecked on a subitem + + + + + Triggered when a column header is right clicked. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + + + This event is triggered when the control needs to filter its collection of objects. + + + + + This event is triggered when a cell needs to be formatted. + + + + + This event is triggered when the frozeness of the control changes. + + + + + This event is triggered when a row needs to be formatted. + + + + + This event is triggered when a group is about to collapse or expand. + This can be cancelled to prevent the expansion. + + + + + This event is triggered when a group changes state. + + + + + This event is triggered when a header checkbox is changing value + + + + + This event is triggered when a header needs a tool tip. + + + + + Triggered when the "hot" item changes + + + + + Triggered when a hyperlink cell is clicked. + + + + + Triggered when the task text of a group is clicked. + + + + + Is the value in the given cell a hyperlink. + + + + + Some new objects are about to be added to an ObjectListView. + + + + + The contents of the ObjectListView has changed. + + + + + The contents of the ObjectListView is about to change via a SetObjects call + + + Set Cancelled to true to prevent the contents of the list changing. This does not work with virtual lists. + + + + + Some objects are about to be removed from an ObjectListView. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler, and when the source control + for the drag was an ObjectListView. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler and when the source control + for the drag was an ObjectListView. + + + + + This event is triggered once per user action that changes the selection state + of one or more rows. + + + + + This event is triggered when the contents of the ObjectListView has scrolled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Tell the world when a cell is about to be edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell has finished being edited. + + + + + 创建一个 ObjectListView + + + + + Dispose of any resources this instance has been using + + + + + + 获取鼠标左键是否在此时按下。 + + + + + 获取该程序是否在Vista或更高版本上运行 + + + + + 获取该程序是否在Win7或更高版本上运行 + + + + + Gets or sets how what smoothing mode will be applied to graphic operations. + + + + + Gets or sets how should text be renderered. + + + + + 获取或设置当组Key为Null时将用于标题组的字符串。将其公开以使其可以本地化。 + + + + + Convert the given enumerable into an ArrayList as efficiently as possible + + The source collection + If true, this method will always create a new + collection. + An ArrayList with the same contents as the given collection. + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Return the count of items in the given enumerable + + + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + Return whether or not the given enumerable is empty. A string is regarded as + an empty collection. + + + True if the given collection is null or empty + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Gets or sets whether all ObjectListViews will silently ignore missing aspect errors. + + + + By default, if an ObjectListView is asked to display an aspect + (i.e. a field/property/method) + that does not exist from a model, it displays an error message in that cell, since that + condition is normally a programming error. There are some use cases where + this is not an error -- in those cases, set this to true and ObjectListView will + simply display an empty cell. + + Be warned: if you set this to true, it can be very difficult to track down + typing mistakes or name changes in AspectNames. + + + + + Gets or sets whether the control will draw a rectangle in each cell showing the cell padding. + + + + This can help with debugging display problems from cell padding. + + As with all cell padding, this setting only takes effect when the control is owner drawn. + + + + + Gets the style that will be used by default to format disabled rows + + + + + Gets the style that will be used by default to format hot rows + + + + + Gets or sets an model filter that is combined with any column filtering that the end-user specifies. + + This is different from the ModelFilter property, since setting that will replace + any column filtering, whereas setting this will combine this filter with the column filtering + + + + Get or set all the columns that this control knows about. + Only those columns where IsVisible is true will be seen by the user. + + + + If you want to add new columns programmatically, add them to + AllColumns and then call RebuildColumns(). Normally, you do not have to + deal with this property directly. Just use the IDE. + + If you do add or remove columns from the AllColumns collection, + you have to call RebuildColumns() to make those changes take effect. + + + + + 获取或设置每隔一行的背景色 + + + + + 获取已设置的交替行背景色或默认颜色 + + + + + 此属性强制ObjectListView始终按给定列对项进行分组。 + + + + + 如果AlwaysGroupByColumn不为空，则此属性将用于确定如何对这些组进行排序。 + 如果此属性的值为SortOrder.None，则排序顺序将根据用户上次单击的标题切换。 + + + + + Give access to the image list that is actually being used by the control + + + Normally, it is preferable to use SmallImageList. Only use this property + if you know exactly what you are doing. + + + + + 获取或设置编辑单元格的方式 + + Columns can also be marked as editable. + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + 默认值为 true. + + + This is always treated as true when the control is NOT owner drawn. + + When this is false and the control is owner drawn, + ObjectListView will try to calculate the width of the cell's + actual contents, and then size the editing control to be just the right width. If this is true, + the whole width of the cell will be used, regardless of the cell's contents. + + Each column can have a different value for property. This value from the control is only + used when a column is not specified one way or another. + Regardless of this setting, developers can specify the exact size of the editing control + by listening for the CellEditStarting event. + + + + + Gets or sets the engine that will handle key presses during a cell edit operation. + Settings this to null will reset it to default value. + + + + + 获取当前用于编辑单元格的控件。 + + This will obviously be null if no cell is being edited. + + + + 获取或设置编辑控件左边缘或右边缘的单元格时Tab键的行为。 + 如果为False(默认值)，则按Tab键将换行到同一行的另一侧。 + 如果为True，编辑最右边的单元格时按Tab键将前进到下一行， + 编辑最左边的单元格时按Shift-Tab组合键将更改为上一行。 + + + + + 获取或设置编辑单元格时Enter键的行为。 + 如果为False(默认值)，则按Enter键将简单地完成编辑操作。 + 如果为True，则Enter将完成编辑操作，并在当前单元格下方的单元格上启动新的编辑操作，在位于底部单元格时换行到下一行的顶部。 + + + + + 获取显示单元格提示的工具提示控件 + + + + + 获取或设置该项的每个单元格周围将留空的像素数。单元格内容在考虑填充后对齐。 + + + Each value of the given rectangle will be treated as an inset from + the corresponding side. The width of the rectangle is the padding for the + right cell edge. The height of the rectangle is the padding for the bottom + cell edge. + + + So, this.olv1.CellPadding = new Rectangle(1, 2, 3, 4); will leave one pixel + of space to the left of the cell, 2 pixels at the top, 3 pixels of space + on the right edge, and 4 pixels of space at the bottom of each cell. + + + This setting only takes effect when the control is owner drawn. + + This setting only affects the contents of the cell. The background is + not affected. + If you set this to a foolish value, your control will appear to be empty. + + + + + 获取或设置默认情况下单元格垂直对齐的方式。 + + This setting only takes effect when the control is owner drawn. It will only be noticable + when RowHeight has been set such that there is some vertical space in each row. + + + + Should this list show checkboxes? + + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + .NET's CheckedItems property is not helpful. It is just a short-hand for + iterating through the list looking for items that are checked. + + + The performance of the get method is O(n), where n is the number of items + in the control. The performance of the set method is + O(n + m) where m is the number of objects being checked. Be careful on long lists. + + + + + + 获取或设置可枚举对象中的选中对象。 + + + Useful for checking all objects in the list. + + + this.olv1.CheckedObjectsEnumerable = this.olv1.Objects; + + + + + Gets Columns for this list. We hide the original so we can associate + a specialised editor with it. + + + + + 获取/设置当列表切换到TileView(平铺视图)时应使用的列的列表。 + + + + + 按向用户显示的顺序返回可见列 + + + + + 获取显示列表的控件区域，减去任何标题控件 + + + + + 获取或设置当用户按Ctrl+C组合键时是否应将选定行复制到剪贴板 + + + + + 获取或设置按Ctrl+C键复制到剪贴板功能是否应使用安装的DragSource创建放置到剪贴板上的数据对象。 + + This is normally what is desired, unless a custom DragSource is installed + that does some very specialized drag-drop behaviour. + + + + Gets the list of decorations that will be drawn the ListView + + + + Do not modify the contents of this list directly. Use the AddDecoration() and RemoveDecoration() methods. + + + A decoration scrolls with the list contents. An overlay is fixed in place. + + + + + + 所有者绘制时，此渲染器将绘制未指定特定渲染器的列 + + 如果尝试将其设置为NULL，则它将恢复为HighlightTextRenende + + + + 获取用于绘制给定单元格的渲染器。 + + The row model for the row + The column to be drawn + The renderer used for drawing a cell. Must not return null. + + + + 获取或设置将应用于禁用项的样式。 + + If this is not set explicitly, will be used. + + + + 获取或设置已禁用的模型对象的列表。无法选择或激活已禁用的对象。 + + + + + 判断此给定模型对象是否已禁用 + + + + + + + 禁用给定的模型对象。禁用的对象无法选择或激活。 + + Must not be null + + + + 禁用所有给定的模型对象 + + + + + + 启用给定的模型对象，以便可以再次选择并激活它。 + + Must not be null + + + + 启用所有给定的模型对象 + + + + + + 忽略所有禁用的对象。这不会触发重绘或重建 + + + + + Gets or sets the object that controls how drags start from this control + + + + + Gets or sets the object that controls how drops are accepted and processed + by this ListView. + + + + If the given sink is an instance of SimpleDropSink, then events from the drop sink + will be automatically forwarded to the ObjectListView (which means that handlers + for those event can be configured within the IDE). + + If this is set to null, the control will not accept drops. + + + + + This registry decides what control should be used to edit what cells, based + on the type of the value in the cell. + + + All instances of ObjectListView share the same editor registry. + + + + 获取或设置在此列表视图中没有项时应显示的文本。 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 获取或设置绘制列表空消息时应使用的字体 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 返回“列表为空”消息的字体或合理的默认值 + + + + + Gets or sets the overlay responsible for drawing the List Empty msg. + + + + + 获取在筛选中幸存下来的对象的集合。 + + + + This collection is the result of filtering the current list of objects. + It is not a snapshot of the filtered list that was last used to build the control. + + + Normal warnings apply when using this with virtual lists. It will work, but it + may take a while. + + + + + + 获取或设置将用于生成筛选器菜单的策略对象 + + 如果为NULL，则不会生成筛选器菜单。 + + + + 获取或设置具有键盘焦点的行 + + + + Setting an object to be focused does *not* select it. If you want to select and focus a row, + use . + + + This property is not generally used and is only useful in specialized situations. + + + + + + 隐藏Groups集合，使其在“属性”网格中不可见。 + + + + + 获取或设置分组使用的ImageList + + 如果未设置此选项，则分组标题将不会显示任何图像。 + + + + 获取在组为空或包含多个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 + + + "[{0} [{1} 项]" + + + + 返回this.GroupWithItemCountFormat或合理的默认值 + + + + + 获取在组仅包含单个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 (总是1) + + + "[{0} [{1} 项]" + + + + 获取GroupWithItemCountSingularFormat或合理的默认值 + + + + + 获取或设置此ObjectListView中的组是否应可折叠。 + + + 此特性只支持Vista或之后的系统. + + + + + 获取当前列表是否存在当列表为空时显示的文本 + + + + + 获取是否有要绘制的叠加层 + + + + + 获取ListView的列头控件 + + + + + 获取或设置列标题文本的绘制字体 + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + 获取或设置将用于绘制列表视图的列标题的样式 + + + + 仅当HeaderUsesThemes为false时才使用此选项。 + + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + + + 获取或设置标题的最大高度。-1表示没有最大值。 + + + + + 获取或设置标题的最小高度。-1表示没有最小值。 + + + + + 获取或设置是否严格按照操作系统的主题绘制标题。 + + + + 如果设置为true，则列头将完全由系统呈现，不需要ObjectListViews的任何特殊处理。 + 页眉中将没有图像、没有过滤器指示符、没有文字换行、没有页眉样式、没有复选框。 + + 如果将其设置为False，ObjectListView将以其认为最好的方式呈现标题。 + 如果不需要特殊功能，则ObjectListView会将渲染委托给操作系统。 + 否则，ObjectListView将根据配置设置绘制标题。 + + + 没有主题的效果会因操作系统不同而不同。至少，分类指示器不会是标准的。 + + + + + + 获取或设置列头标题中的文本是否自动换行。 + + + 将在单词之间应用换行符。过长的单词仍将被省略。 + + 与所有使列头看起来不同的设置一样，HeaderUsesThemes必须设置为false，否则操作系统将负责绘制列头，并且不允许自动换行文本。 + + + + + + 获取显示列标题提示的工具提示 + + + + + 获取鼠标当前所在行的索引。 + + + + + 获取鼠标当前所在列的索引 + + + + + 获取鼠标当前所在的项/子项的一部分 + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + 获取鼠标所在的组。 + + + + + 处于“热”状态的项的索引，即在光标下方。-1表示没有项目。 + + + + + 获取和设置对游标下的行应用哪种格式 + + + + 这仅在UseHotItem为true时生效。 + + 如果样式具有叠加层，则必须对其进行设置。*之前* 将其分配给此属性。之后添加它将被忽略。 + + + + + 获取已安装的热点项样式或合理的默认值。 + + + + + 获取和设置应将哪种格式应用于超链接 + + + + + 获取和设置所选行的背景应该使用什么颜色 + + + + + 返回应用于选定行的背景颜色或合理的默认值 + + + + + 获取和设置所选行的字体应该使用什么颜色 + + + + + 返回应用于选定行的字体颜色或合理的默认值 + + + + + 使用 SelectedBackColor 代替 + + + + + 使用 SelectedBackColorOrDefault 代替 + + + + + 使用 SelectedForeColor 代替 + + + + + 使用 SelectedForeColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedBackColor 代替 + + + + + 使用 UnfocusedSelectedBackColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedForeColor 代替 + + + + + 使用 UnfocusedSelectedForeColorOrDefault 代替 + + + + + 获取或设置是否应将隐藏列包括在复制或拖动到其他应用程序的行的文本表示形式中。 + 如果为False(默认值)，则仅包括可见列。 + + + + + 获取或设置复制行时，列标题是否在文本中。 + 如果为False(默认值)，在文本中将不会显示列标题。 + + + + + 如果当前正在进行单元格编辑操作，则返回TRUE + + + + + 如果在开发环境中使用ObjectListView，则返回true。 + + + + + 获取当前列表是否正在筛选其内容 + + + + + 当用户在列表中键入内容时，是否应该搜索当前排序列中的值以查找匹配项？ + 如果为False，则无论排序列是什么，都将始终使用主列。 + + When this is true, the behavior is like that of ITunes. + + + + 获取或设置此控件是否将使用SimpleDropSink接收拖动 + + + + 此设置将替换任何以前的DropSink。 + + + 将其设置为true后，SimpleDropSink仍需要配置为说明它何时可以接受拖动， + 以及在拖动某些内容时应该执行什么操作。需要执行这些操作使此属性几乎毫无用处 :( + + + + + + 获取或设置此控件是否将使用SimpleDragSource来启动拖动 + + 此设置将替换之前的任何DragSource + + + + 隐藏Items集合，使其在“属性”网格中不可见。 + + + + + 当列表中的项目处于非详细视图中时，此渲染器会绘制项目。在详细信息视图中，负责个体列的呈现器。 + + + + + 获取或设置最后一次排序的列 + + 这是PrimarySortColumn的别名 + + + + 获取或设置最后一次排序的方向 + + 这是 PrimarySortOrder的别名 + + + + 获取或设置应用于整个对象列表的筛选器。 + + + 列表将立即更新以反映此筛选器。 + + + + + 获取或设置应用于列表中每个模型对象的筛选器 + + + 您可能需要考虑使用 而不是此属性， + 因为AdditionalFilter在运行时与列筛选相结合。 + 设置此属性只是替换用户可能已给出的任何列筛选器。 + + The list is updated immediately to reflect this filter. + + + + + + Gets the hit test info last time the mouse was moved. + + Useful for hot item processing. + + + + 获取或设置列表显示的组列表。 + + + 此属性与.NET Groups属性的工作方式不同，应将其视为只读属性。 + 对列表所做的更改不会反映在ListView本身中。 + 在此列表中添加或删除组是没有意义的，这样的修改不会起到任何作用。 + 要执行此类操作，必须侦听BeforeCreatingGroups或AboutToCreateGroups事件， + 并更改这些事件中的组列表。 + + + + + 获取或设置折叠的OLVGroups的集合。 + + + + + Gets or sets whether the user wants to owner draw the header control + themselves. If this is false (the default), ObjectListView will use + custom drawing to render the header, if needed. + + + If you listen for the DrawColumnHeader event, you need to set this to true, + otherwise your event handler will not be called. + + + + + 获取/设置此列表将显示的对象集合 + + + + 设置此属性后，控件的内容将立即更新。 + + 如果可能，此方法将保留所选内容。使用 if + 如果您不想保留所选内容，请执行以下操作。 + 保留选择是该代码中最慢的部分，性能为O(N)，其中n是选定的行数。 + 此方法不是线程安全的。 + 该属性确实适用于虚拟列表：设置是没有问题的，但如果您尝试获取它， + 并且列表有1000万个对象，则可能需要一些时间才能返回。 + 此集合未经过筛选。使用 只访问那些在任何已安装的筛选器中幸存下来的对象。 + + + + + 获取当前控件所有对象组成的列表 + + + + + 获取创建群集时将考虑的对象集合。 + (用于生成类似Excel的列筛选器) + + + + + 获取或设置将在ListView顶部绘制的图像 + + + + + 获取或设置将在ListView顶部绘制的文本 + + + + + 获取或设置所有覆盖图的透明度。0表示完全透明，255表示完全不透明。 + + + 这已经过时了，请在每个覆盖上使用Transparency。 + + + + + 获取将在ListView顶部绘制的覆盖列表 + + + You can add new overlays and remove overlays that you have added, but + don't mess with the overlays that you didn't create. + + + + + Gets or sets whether the ObjectListView will be owner drawn. Defaults to true. + + + + When this is true, all of ObjectListView's neat features are available. + + We have to reimplement this property, even though we just call the base + property, in order to change the [DefaultValue] to true. + + + + + + 获取或设置主复选框是否在列表重新生成和筛选操作中保持其值。 + + + + 此属性仅在未显式设置CheckStateGetter/Putter时才有用。 + 如果您使用CheckStateGetter/Putter，那么这些方法已经持久化了行的检查性。 + + 此默认值为true。如果为False，则在重新生成或筛选列表时，复选框将丢失其值。 + 如果在虚拟列表中将其设置为false，则必须安装CheckStateGetter/Putters。 + + + + + 获取或设置记住模型对象的复选框状态的字典 + + 当PersistentCheckBoxs值为TRUE时，此选项用于虚拟列表. + + + + 获取或设置最后一次排序的列 + + + + + 获取或设置最后一次排序的方向 + + + + + 获取或设置不可编辑复选框是否绘制为禁用。默认是false。 + + + 这仅在所有者描述模式(owner drawn mode)下有效。 + + + + + 以像素为单位指定控件中每行的高度。 + + 列表视图中的行高通常由字体大小和小图像列表大小决定。 + 此设置允许覆盖该计算(原因是：您仍然不能将行高设置为小于控件中使用的字体的行高)。 + 将其设置为-1表示使用正常计算方法。 + 此功能是体验功能！如果您使用此功能，您的程序可能会发生意想不到的事情。 + + + + + 获取每行有多少像素高 + + + + + 获取此控件的每页上显示多少行 + + + + + 获取/设置将用于解析排序时相等的比较的列(第二排序列)。 + + 此设置没有用户界面。它必须以编程方式设置。 + + + + 获取或设置当使用Second darySortColumn时，它将以什么顺序比较结果 + + + + + 获取或设置当用户按Ctrl+A组合键时是否应选择所有行 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许用户选择视图中将显示哪些列 + + 这只是SelectColumnsOnRightClickBehaviour的兼容性包装属性. + + + + 获取或设置当右键单击标题时用户如何能够选择列 + + + + + 当列选择菜单打开时，是否应在选择项目后保持打开状态？保持打开状态允许用户一次打开或关闭多个列。 + + SelectColumnsOnRightClickBehaviour设置为InlineMenu时才有效。当行为设置为SubMenu菜单时，该选项不起作用。 + + + + 获取或设置选定列 + + + + 如果TintSortColumn为true，则排序列将自动成为选定列。 + + + 色调的颜色由SelectedColumnTint控制。 + + + + + + Gets or sets the decoration that will be drawn on all selected rows + + + + + 获取或设置应该使用什么颜色来给选定的列着色 + + + 色调颜色必须是Alpha可混合的，因此如果给定的颜色是纯色(即Alpha=255)，则会将其更改为具有合理的Alpha值。 + + + + + 获取或设置当前选定行的索引。 + 获取索引时，如果没有选择任何行，或者选择了多个行，则返回-1。 + + + + + 获取或设置当前选定的ListViewItem。如果未选择任何行，或者选择了多个行，则返回NULL。 + + + + + 如果只选择了一行，则从当前选定的行获取模型对象。 + 如果未选择任何行，或选择了多个行，则返回NULL。 + 设置时，这将选择显示给定模型对象的行，并将焦点放在该行上，取消选择所有其他行。 + + + + + 从当前选定的行中获取模型对象。 + 如果未选中任何行，则返回的列表为空。 + 设置此值时，请选择显示给定模型对象的行，取消选择所有其他行。 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许他们选择要在列表视图上执行的常见任务 + + + + + 获取或设置当右键单击标题控件时，此ObjectListView是否像筛选菜单一样显示表格 + + + + + 获取或设置是否应按组显示其项目 + + + + + 列表视图是否应该在列标题中显示位图以显示排序方向 + + + The only reason for not wanting to have sort indicators is that, on pre-XP versions of + Windows, having sort indicators required the ListView to have a small image list, and + as soon as you give a ListView a SmallImageList, the text of column 0 is bumped 16 + pixels to the right, even if you never used an image. + + + + + 列表视图是否应该显示子项上的图像 + + + 虚拟列表必须是所有者绘制的，才能在子项上显示图像 + + + + + 此属性控制分组标签是否显示该分组项目数量 + + + 后缀的格式由GroupWithItemCountFormat/GroupWithItemCountSingularFormat属性控制 + + + + + 获取或设置控件是在所有视图中显示列标题(True)，还是仅在详细信息视图中显示列标题(False) + + + + 此属性工作不正常。JPP 2010/04/06。 + 如果它是在创建控件之前设置的，则可以正常工作。 + 但是，如果在创建控件后将其关闭，则控件将丢失其复选框(奇怪！) + + + 要在创建控件后更改此设置，事情会很复杂。 + 如果它是关闭的，而我们想要打开它，我们必须更改视图，标题就会出现。 + 如果它当前处于打开状态，而我们想要将其关闭，则必须更改视图并重新创建控制柄。 + 重新创建句柄是一个问题，因为它会使我们的复选框样式消失。 + + + 该属性不能工作在 Win XP 系统. + + + + + 重写SmallImageList属性，以便我们可以正确地隐藏其操作。 + + 如果使用RowHeight属性指定行高，则必须在设置/更改RowHeight之前完全初始化SmallImageList。 + 如果在设置行高之后将新图像添加到图像列表，则必须再次将图像列表分配给控件。像这样简单的事情会奏效的： + listView1.SmallImageList = listView1.SmallImageList; + + + + + 返回小图像列表中图像的大小或合理的默认值 + + + + + 当列表视图分组时，项是否应该按主列排序？如果为False，则项目将按分组时的同一列进行排序。 + + + + + 当列表视图分组时，一个组的末尾和下一个组的开头之间应该有多少像素 + + + + + 排序列是否应该显示轻微的色调？ + + + + + 获取或设置是否使用三态复选框？ + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + 否则，用户在选中和取消选中之间交替单击。 + 当此设置为False时，CheckStateGetter仍可以返回不确定。 + + + + + 获取或设置列表顶部项目的索引 + + + + 此属性仅在列表视图处于详细信息视图中且不显示组时才起作用。 + + + 显示组时不起作用的原因是，当启用组时，无论滚动位置如何， + Windows msg LVM_GETTOPINDEX总是返回0。 + + + + + + 获取或设置将鼠标移到标题上是否会触发CellOver事件。 + 默认为true。 + + + 将鼠标移动到标题上之前不会触发CellOver事件，因为Header被视为单独的控件。 + 如果此行为更改导致您的应用程序出现问题，请将其设置为False。 + 如果您想知道鼠标何时在标题上移动，请将此属性设置为true(默认值)。 + + + + + 通过拖动分隔线调整列的大小时，是否应在每次鼠标移动时调整填充空格的列的大小？ + 如果为False，则释放鼠标时将更新填充栏。 + + + + 如果空间填充列位于正在调整大小的列的左侧，这看起来会很奇怪：该列的右边缘将被拖动，但由于空间填充列正在收缩，其左边缘将会移动。 + + 这是合乎逻辑的行为--只是看起来不对。 + + + 考虑到上述行为，如果空间填充列不是最右边的列，最好关闭该属性。 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的背景 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的背景的颜色 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的字体颜色。 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的字体颜色 + + + + + 获取或设置列表是否每隔一行提供不同的背景色？默认值为false。 + + 交替行的颜色由AlternateRowBackColor提供。 + 在.NET中，列表视图在非整行选择模式下有一个“功能”，在这种模式下，所选行不会使用正确的背景色绘制。 + + + + 是否应该为控件中的每个单元格调用FormatCell事件？ + + + 在许多情况下，不执行单元格级格式设置。 + 如果除非需要，ObjectListView不会为每个单元格触发Format Cell事件，则它的运行速度会稍快一些。 + 因此，默认情况下，它不会为每个单元格引发事件。 + + ObjectListView*确实*在每次重新生成行时引发FormatRow事件。各行可以决定是否对行中的每个单元格引发FormatCell事件。 + + + 无论此设置如何，只有当ObjectListView处于详细视图中时才会引发FormatCell事件。 + + + + + 所选行是否应使用非标准前景色和背景色绘制？ + + V2.9不再需要此属性 + + + + 获取或设置此ObjectListView是否将使用与Vista资源管理器相同的热项和选择机制。 + + + + 此属性有许多缺陷： + + 这仅适用于Vista及更高版本 + 它不能很好地与AlternateRowBackColors配合使用。 + 它不能很好地与HotItemStyles配合使用。 + 如果FullRowSelect为false，这看起来有点傻。 + 当列表是所有者绘制的时，它根本不起作用(因为所有的绘制都是由渲染器完成的)。 + 因此，它不能与TreeListView一起工作，因为它们“必须”是所有者绘制的。你仍然可以设置它，但它不会生效。 + + 但如果你一定要看起来像Vista/Win7，这是你的权限。如果这项设置搞砸了其他事情，请不要抱怨。 + + + 当此属性设置为True时，ObjectListView将不是所有者描述的。 + 这将禁用ObjectListView的许多漂亮的基于绘图的功能。 + + + + + + 获取或设置列表是否应启用筛选 + + + + + 获取或设置列表是否应将指示符放入列的标题中，以表明它正在筛选该列 + + 如果将其设置为true，HeaderUsesThemes将自动设置为false，因为我们只能在不使用主题标题时绘制筛选器指示器。 + + + + 鼠标下方的控件(复选框或按钮)是否应该被绘制为“Hot” + + + 如果为False，则当鼠标悬停在控件上时，控件的绘制方式不会有所不同。 + + 如果为False，且UseHotItem和UseHyperLinks为False，则ObjectListView可以跳过鼠标移动的某些处理。这使得鼠标移动处理几乎不使用CPU。 + + + + + + 光标下的项是否应以特殊方式设置格式？ + + + + + 获取或设置此列表视图是否应在单元格中显示超链接。 + + + + + 此控件是否应显示覆盖(Overlays) + + 覆盖(Overlays)在默认情况下是启用的，只有在它们在您的开发环境中造成问题时才需要禁用。 + + + + 是否应将此控件配置为在子项上显示复选框？ + + 如果将其设置为True，则将为该控件提供一个SmallImageList(如果它还没有一个SmallImageList)。 + 此外，如果它是一个虚拟列表，它将被设置为所有者描述的，因为虚拟列表不能在没有所有者描述的情况下绘制复选框。 + + + + 获取或设置ObjectListView是否将使用类似Vista的半透明选择机制。 + + + + 与UseExplorerTheme不同的是，这个类似Vista的方案可以在XP上运行，并且既适用于所有者描述的列表，也适用于非所有者描述的列表。 + + + 这将替换任何已安装的SelectedRowDecory。 + + + 如果您不喜欢用于选择的颜色，请忽略此属性， + 只需创建您自己的RowBorderDecory并将其分配给SelectedRowDecory， + 就像此属性设置器所做的那样。 + + + + + + 获取或设置ObjectListView是否将使用类似于Vista的半透明热行突出显示机制。 + + + + 设置此项将替换任何已安装的HotItemStyle。 + + + 如果您不喜欢热项目使用的颜色，请忽略此属性， + 只需创建您自己的HotItemStyle，填充所需的值， + 并将其分配给HotItemStyle属性，就像此属性设置器所做的那样。 + + + + + + 获取/设置此列表视图正在使用的视图样式 + + 切换到平铺(Tile)或详细信息(Details)视图会安装适合该视图的列。令人困惑的是，在平铺视图中，每列都显示为一行信息。 + + + + 此委托仅将对象的检查性作为布尔值获取。 + + 如果您永远不想担心不确定状态(这是相当常见的)，请使用此选项。 + + 这是CheckStateGetter属性的便捷包装。 + + + + + + This delegate sets the checkedness of an object as a boolean only. It must return + true or false indicating if the object was checked or not. + + Use this if you never want to worry about the + Indeterminate state (which is fairly common). + + This is a convenience wrapper around the CheckStatePutter property. + + + + + + 获取此列表视图是否能够显示组 + + + + + 获取或设置ObjectListView是否可以依赖正在引发的Application.Idle事件。 + + 在某些主机环境中(例如，在VisualStudio和Office中作为扩展运行时)，从不引发Application.Idle事件。 + 如果不会引发Idle事件，则将其设置为False，ObjectListView将自行引发这些事件。 + + + + + This delegate fetches the renderer for a particular cell. + + + + If this returns null (or is not installed), the renderer for the column will be used. + If the column renderer is null, then will be used. + + + This is called every time any cell is drawn. It must be efficient! + + + + + + This delegate is called when the list wants to show a tooltip for a particular cell. + The delegate should return the text to display, or null to use the default behavior + (which is to show the full text of truncated cell values). + + + Displaying the full text of truncated cell values only work for FullRowSelect listviews. + This is MS's behavior, not mine. Don't complain to me :) + + + + + 保存是否选中模型的属性(或字段)的名称。 + + + 该属性是可修改的。它必须具有bool(或bool？)返回类型。如果TriStateCheckBooks为真)。 + 设置此属性将替换任何已安装的CheckStateGetter或CheckStatePutter。 + 相反，稍后设置CheckStateGetter或CheckStatePutter属性将优先于此属性的行为。 + + + + + 只要ObjectListView需要知道与给定模型对象关联的行的检查状态，就会调用此委托。 + + + .NET has no support for indeterminate values, but as of v2.0, this class allows + indeterminate values. + + + + + This delegate will be called whenever the user tries to change the check state of a row. + The delegate should return the state that was actually set, which may be different + to the state given. + + + + + 此委托可用于以自定义方式对表进行排序。 + + + + 委托必须在ObjectListView上安装ListViewItemSorter。 + 安装ItemSorter会执行对ListViewItems进行排序的实际工作。 + 有关ItemSorter必须执行的操作的示例，请参见代码中的ColumnCompeller。 + + + 请勿在VirtualObjectListView上安装CustomSorter。改为重写IVirtualListDataSource的SortObjects()方法。 + + + + + + This delegate is called when the list wants to show a tooltip for a particular header. + The delegate should return the text to display, or null to use the default behavior + (which is to not show any tooltip). + + + Installing a HeaderToolTipGetter takes precedence over any text in OLVColumn.ToolTipText. + + + + + This delegate can be used to format a OLVListItem before it is added to the control. + + + The model object for the row can be found through the RowObject property of the OLVListItem object. + All subitems normally have the same style as list item, so setting the forecolor on one + subitem changes the forecolor of all subitems. + To allow subitems to have different attributes, do this: + myListViewItem.UseItemStyleForSubItems = false;. + + If UseAlternatingBackColors is true, the backcolor of the listitem will be calculated + by the control and cannot be controlled by the RowFormatter delegate. + In general, trying to use a RowFormatter + when UseAlternatingBackColors is true does not work well. + As it says in the summary, this is called before the item is added to the control. + Many properties of the OLVListItem itself are not available at that point, including: + Index, Selected, Focused, Bounds, Checked, DisplayIndex. + + + + + 将给定的模型对象添加到此控件。 + + 要显示的模型对象 + See AddObjects() for more details + + + + 将给定的模型对象集合添加到此控件。 + + 要显示的模型对象集合 + + 如果排序处于活动状态(即，如果PrimarySortColumn不为空)，则添加的对象将出现在其正确的排序位置。否则，它们将出现在列表的末尾。 + 不执行任何检查以查看是否有任何对象已在ListView中。 + 空对象将被静默忽略。 + + + + + 将列的大小调整到页眉宽度和数据的最大值。 + + + + + 设置任何自动初始化的列宽(宽度为0或-1的列将分别调整为其内容或标题的宽度)。 + + + 显然，这只会起作用一次。一旦运行，列宽将更改为其他值(不是0或-1)，因此第二次运行时不会执行任何操作。 + 若要强制所有列更改其大小，请使用 。 + + + + + 根据最后一个排序列或第一列(如果没有最后一个排序列)将视图项组织到组中 + + + + + 根据给定列将视图项组织成组 + + + + 如果AlwaysGroupByColumn属性不为Null，则列表视图项将按该列组织，并且将忽略‘Column’参数。 + + 此方法触发排序事件：BeforeSorting和AfterSorting。 + + 其值应用于排序的列。 + + + + + 根据给定列将视图项组织成组 + + 将使用哪一列进行分组 + 组将使用什么顺序 + 其值应用于排序的列。不能为空 + 列中值的排序顺序 + 当‘column’中的值相等时，请使用此列提供的值 + 次级值将如何排序 + 此方法不会触发排序事件。使用BuildGroups()执行此操作 + + + + 收集并返回影响组创建的所有变量 + + + + + + Make a list of groups that should be shown according to the given parameters + + + The list of groups to be created + This should not change the state of the control. It is possible that the + groups created will not be used. They may simply be discarded. + + + + 生成/重新生成列表中的所有列表视图项，尽可能多地保留状态 + + + + + 生成/重新生成列表中的所有列表视图项 + + If this is true, the control will try to preserve the selection, + focused item, and the scroll position (see Remarks) + + + + Use this method in situations were the contents of the list is basically the same + as previously. + + + + + + 清除此列表可能一直在使用的所有缓存信息 + + + + + Apply all required extended styles to our control. + + + + Whenever .NET code sets an extended style, it erases all other extended styles + that it doesn't use. So, we have to explicit reapply the styles that we have + added. + + + Normally, we would override CreateParms property and update + the ExStyle member, but ListView seems to ignore all ExStyles that + it doesn't already know about. Worse, when we set the LVS_EX_HEADERINALLVIEWS + value, bad things happen (the control crashes!). + + + + + + Give the listview a reasonable size of its tiles, based on the number of lines of + information that each tile is going to display. + + + + + Rebuild this list for the given view + + + + + + 移除所有对象(线程安全) + + This method can safely be called from background threads. + + + + 重置已访问其URL的内存 + + + + + 将选定行的文本和HTML表示复制到剪贴板上。 + + Be careful when using this with virtual lists. If the user has selected + 10,000,000 rows, this method will faithfully try to copy all of them to the clipboard. + From the user's point of view, your program will appear to have hung. + + + + 将给定对象的文本和HTML表示复制到剪贴板上。 + + + + + 将所有对象的文本和HTML表示复制到剪贴板上。 + + + + + 返回给定对象的html表示形式 + + + + + 取消选择列表视图中的所有行 + + + + + 返回紧跟在给定项后面的ListViewItem。 + 如果给定项为空，则返回列表中的第一个项。 + 如果给定项是最后一项，则返回NULL。 + + The item that is before the item that is returned, or null + A ListViewItem + + + + 按向用户显示的顺序返回最后一项。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + 按向用户显示的顺序返回第n项(从0开始)。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回给定listviewitem索引的显示索引。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回紧接在给定项之前出现的ListViewItem。 + 如果给定项为空，则返回列表中的最后一项。 + 如果给定项是第一项，则返回NULL。 + + The item that is before the item that is returned + A ListViewItem + + + + 在给定位置之前插入给定的对象集合 + + Where to insert the objects + The objects to be inserted + + + This operation only makes sense of non-sorted, non-grouped + lists, since any subsequent sort/group operation will rearrange + the list. + + This method only works on ObjectListViews and FastObjectListViews. + + + + + 如果选择了表示给定模型的行，则返回TRUE + + The model object to look for + Is the row selected + + + + 给定的URL是否已被访问 + + The string to be consider + Has it been visited + + + + 按给定的值增量滚动ListView。 + + Horizontal delta + Vertical delta + + + + Return a point that represents the current horizontal and vertical scroll positions + + + + + 记住给定的URL已被访问 + + The url to be remembered + This does not cause the control be redrawn + + + + 将给定的对象集合移动到给定的索引。 + + 此操作仅对未分组的ObjectListViews有意义。 + + + + + + 计算在给定点下的项目是什么？ + + + + + + + + 使用Windows控件的SUBITEMHITTEST消息执行点击测试。 + 这提供了标准ListView.HitTest()不提供的有关组点击的信息。 + + + + + + + + What is under the given point? This takes the various parts of a cell into accout, including + any custom parts that a custom renderer might use + + + + An information block about what is under the point + + + + Perform a hit test when the control is not owner drawn + + + + + + + + Perform a hit test when the control is owner drawn. This hands off responsibility + to the renderer. + + + + + + + + Pause (or unpause) all animations in the list + + true to pause, false to unpause + + + + Rebuild the columns based upon its current view and column visibility settings + + + + + 从ListView中删除给定的模型对象 + + The model to be removed + See RemoveObjects() for more details + This method is thread-safe. + + + + + 从控件中移除所有给定对象。 + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + This method is thread-safe. + + + + + 选择列表视图中的所有行 + + + + + 在列表视图的右下角设置要固定的给定图像。 + 当列表视图滚动时，此图像不会滚动。 + + + + 此方法使用ListView的原生功能显示背景图像。 + 它有几个限制： + + + 它在owner drawn模式下不能很好地工作。在owner drawn绘制模式下， + 每个单元格都会绘制自身，包括覆盖背景图像的背景。 + 启用网格线时看起来不是很好，因为网格线是在图像上绘制的。 + 它在XP上完全不起作用。 + 显然，当启用交替行背景色时，效果不佳。 + + + 如果你能忍受这些限制，原生水印就相当不错了。 + 它们是真实的背景，而不是像OverlayImage使用的半透明覆盖。 + 与覆盖相比，它们也有明显的优势，因为即使在MDI应用程序中，它们也可以正常工作。 + + 设置此选项将清除所有背景图像。 + + The image to be drawn. If null, any existing image will be removed. + + + + 将给定的图像设置为ListView的背景，以便它在列表中以给定的百分比偏移量显示。 + + + 这具有与 中所述的相同限制. + 在使用该方法之前，请确保了解这些限制。 + 这非常类似于 属性， + 但标准Backround Image不能正确处理具有透明区域的图像--它将透明区域呈现为黑色。这种方法没有这个问题。 + 设置此选项将清除所有背景水印。 + + The image to be drawn. If null, any existing image will be removed. + The horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + The vertical percentage where the image will be placed. + + + + 将给定图像设置为ListView的平铺背景。 + + + 这具有与 和 相同的限制. + 在使用该方法之前，请确保了解这些限制。 + + 要绘制的图像。如果为null，则将删除所有现有图像。 + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法。 + 该列表将立即更新 + The objects to be displayed + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法. + 该列表将立即更新 + The objects to be displayed + 是否应尽可能保留列表的状态。 + + + + 将给定的模型对象更新到ListView中。 + 如果该模型尚不存在，则会添加该模型。 + + The model to be updated + + + See for more details + + 此方法是线程安全的。 + 此方法将导致重新排序列表。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更新与给定对象相等的预先存在的模型。 + 如果控件中不存在任何模型，则会添加它们。 + + Collection of objects to be updated/added + + 此方法将导致重新排序列表。 + null值将被静默忽略。 + 此方法是线程安全的。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更改当前模型对象上对INotifyPropertyChanged事件的任何订阅， + 以便我们不再侦听旧模型上的事件，而侦听给定集合上的事件。 + + This does nothing if UseNotifyPropertyChanged is false. + + + + + 获取或设置ObjectListView是否应订阅它给定的模型对象上的INotifyPropertyChanged事件。 + + + + 这应该在调用SetObjects()之前设置。如果将其设置为False，ObjectListView将取消订阅所有当前模型对象。 + + 如果在虚拟列表上将其设置为true，ObjectListView将遍历列表中尝试订阅更改通知的所有对象。 + 如果您的虚拟列表中有10,000,000个项目，这可能需要一些时间。 + + + + + Subscribe to INotifyPropertyChanges on the given collection of objects. + + + + + + Unsubscribe from INotifyPropertyChanges on the given collection of objects. + If the given collection is null, unsubscribe from all current subscriptions + + + + + + Return a byte array that represents the current state of the ObjectListView, such + that the state can be restored by RestoreState() + + + The state of an ObjectListView includes the attributes that the user can modify: + + current view (i.e. Details, Tile, Large Icon...) + sort column and direction + column order + column widths + column visibility + + + + It does not include selection or the scroll position. + + + A byte array representing the state of the ObjectListView + + + + Restore the state of the control from the given string, which must have been + produced by SaveState() + + A byte array returned from SaveState() + Returns true if the state was restored + + + + Instances of this class are used to store the state of an ObjectListView. + + + + + The application is idle. Trigger a SelectionChanged event. + + + + + + + The application is idle. Handle the column resizing event. + + + + + + + Handle the BeginScroll listview notification + + + True if the event was completely handled + + + + Handle the EndScroll listview notification + + + True if the event was completely handled + + + + Handle the LinkClick listview notification + + + True if the event was completely handled + + + + The cell tooltip control wants information about the tool tip that it should show. + + + + + + + Allow the HeaderControl to call back into HandleHeaderToolTipShowing without making that method public + + + + + + + The header tooltip control wants information about the tool tip that it should show. + + + + + + + Event handler for the column click event + + + + + Override the basic message pump for this control + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user wants to see the context menu. + + The windows m + A bool indicating if this m has been handled + + We want to ignore context menu requests that are triggered by right clicks on the header + + + + + Handle the Custom draw series of notifications + + The message + True if the message has been handled + + + + Handle the underlying control being destroyed + + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + Find the first row after the given start in which the text value in the + comparison column begins with the given text. The comparison column is column 0, + unless IsSearchOnSortColumn is true, in which case the current sort column is used. + + The text to be prefix matched + The index of the first row to consider + Which direction should be searched? + The index of the first row that matched, or -1 + The text comparison is a case-insensitive, prefix match. The search will + search the every row until a match is found, wrapping at the end if needed. + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + 是否只匹配开头 + The index of the matched row, or -1 + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + Handle the Group Info series of notifications + + The message + True if the message has been handled + + + + Handle a key down message + + + True if the msg has been handled + + + + Toggle the checkedness of the selected rows + + + + Actually, this doesn't actually toggle all rows. It toggles the first row, and + all other rows get the check state of that first row. This is actually a much + more useful behaviour. + + + If no rows are selected, this method does nothing. + + + + + + Catch the Left Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button up event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Trigger a GroupExpandCollapse event and return true if the action was cancelled + + + + + + + Catch the Right Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the right Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a right mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the MouseMove event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle notifications that have been reflected back from the parent window + + The m to be processed + bool to indicate if the msg has been handled + + + + In the notification messages, we handle attempts to change the width of our columns + + The m to be processed + bool to indicate if the msg has been handled + + + + Create a ToolTipControl to manage the tooltip control used by the listview control + + + + + Update the handle used by our cell tooltip to be the tooltip used by + the underlying Windows listview control. + + + + + Handle the WM_PAINT event + + + Return true if the msg has been handled and nothing further should be done + + + + Perform any steps needed before painting the control + + + + + Perform any steps needed after painting the control + + + + + Handle the window position changing. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a menu that is appropriate when the given column header is clicked. + + The index of the header that was clicked. This + can be -1, indicating that the header was clicked outside of a column + Where should the menu be shown + True if a menu was displayed + + + + Create the menu that should be displayed when the user right clicks + on the given column header. + + Index of the column that was right clicked. + This can be negative, which indicates a click outside of any header. + The toolstrip that should be displayed + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + Where should the menu be placed + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + + Where should the menu be placed + + + + 获取或设置要用于升序排序命令的文本 + + + + + 获取或设置要用于降序排序命令的文本 + + + + + 获取或设置要用于分组命令的文本 + + + + + 获取或设置要用于锁定分组命令的文本 + + + + + 获取或设置要用于不锁定分组命令的文本 + + + + + 获取或设置要用于关闭分组命令的文本 + + + + + 获取或设置要用于不排序命令的文本 + + + + + 获取或设置要用于列描述的文本 + + + + + 获取或设置要用于选择列描述的文本 + + + + + Gets or sets the image that will be place next to the Sort Ascending command + + + + + Gets or sets the image that will be placed next to the Sort Descending command + + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + + Return the menu to which the items were added + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + Return the menu to which the items were added + + + + Create the menu items that will allow columns to be choosen and add them to the + given collection + + + + + + Create a Filtering menu + + + + + + + + Override the OnColumnReordered method to do what we want + + + + + + When the column widths are changing, resize the space filling columns + + + + + + + When the column widths change, resize the space filling columns + + + + + + + When the size of the control changes, we have to resize our space filling columns. + + + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Check all rows + + + + + Check the checkbox in the given column header + + If the given columns header check box is linked to the cell check boxes, + then checkboxes in all cells will also be checked. + + + + + Mark the checkbox in the given column header as having an indeterminate value + + + + + + Mark the given object as indeterminate check state + + The model object to be marked indeterminate + + + + Mark the given object as checked in the list + + The model object to be checked + + + + Mark the given objects as checked in the list + + The model object to be checked + + + + Put a check into the check box at the given cell + + + + + + + Put an indeterminate check into the check box at the given cell + + + + + + + Return true of the given object is checked + + The model object whose checkedness is returned + Is the given object checked? + If the given object is not in the list, this method returns false. + + + + Return true of the given object is indeterminately checked + + The model object whose checkedness is returned + Is the given object indeterminately checked? + If the given object is not in the list, this method returns false. + + + + Is there a check at the check box at the given cell + + + + + + + Get the checkedness of an object from the model. Returning null means the + model does not know and the value from the control will be used. + + + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the checkedness of the given object. A checked object becomes + unchecked; an unchecked or indeterminate object becomes checked. + If the list has tristate checkboxes, the order is: + unchecked -> checked -> indeterminate -> unchecked ... + + The model object to be checked + + + + Toggle the checkbox in the header of the given column + + Obviously, this is only useful if the column actually has a header checkbox. + + + + + Toggle the check at the check box of the given cell + + + + + + + Uncheck all rows + + + + + Mark the given object as unchecked in the list + + The model object to be unchecked + + + + Mark the given objects as unchecked in the list + + The model object to be checked + + + + Uncheck the checkbox in the given column header + + + + + + Uncheck the check at the given cell + + + + + + + 返回给定索引处的列 + + Index of the column to be returned + An OLVColumn + + + + 返回给定标题处的列,如果有多个符合要求的标题,则默认只返回第一个 + + 要返回的列的名称 + An OLVColumn + + + + 返回给定视图可见的列的集合。只有Tile和Details有列；所有其他视图都有0列。 + + 正在为哪个视图计算列？ + A list of columns + + + + 返回列表中的项目数 + + 列表中的项目数 + 如果安装了筛选器，这将返回与筛选器匹配的项目数。 + + + + 返回给定索引处的项 + + Index of the item to be returned + An OLVListItem + + + + 返回给定索引处的模型对象 + + Index of the model object to be returned + A model object + + + + 找出在给定的坐标下的行和列 + X 坐标 + Y 坐标 + 给定点下的列项 + 在给定坐标点下的行项。可以为null。 + + + + 返回给定索引/列的子项 + + Index of the item to be returned + Index of the subitem to be returned + An OLVListSubItem + + + + 滚动列表视图，使给定组位于顶部。 + + The group to be revealed + + 如果该组可见，如果可能，列表仍将滚动以将该组移至顶部。 + + 这只在列表显示分组时才有效(显然)。 + 这在虚拟列表上不起作用，因为虚拟列表不使用ListViewGroups进行分组。使用 代替. + + + + + 使给定的模型对象可见 + + The model object to be revealed + + + + 返回选定行的模型对象，如果没有选择或有多个选择，则返回null + + Model object or null + + + + 返回选定行的模型对象，如果没有选择，则返回空集合 + + ArrayList + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + Model object or null + 使用 CheckedObject 属性代替本方法 + + + + 获取选中的模型对象的集合。 + + 使用 CheckedObjects 属性代替本方法 + + + + 在列表视图中查找给定的模型对象并返回其索引 + + The model object to be found + The index of the object. -1 means the object was not present + + + + Rebuild the given ListViewItem with the data from its associated model. + + This method does not resort or regroup the view. It simply updates + the displayed data of the given item + + + + Rebuild the data on the row that is showing the given object. + + + + This method does not resort or regroup the view. + + + The given object is *not* used as the source of data for the rebuild. + It is only used to locate the matching model in the collection, + then that matching model is used as the data source. This distinction is + only important in model classes that have overridden the Equals() method. + + + If you want the given model object to replace the pre-existing model, + use . + + + + + + Update the rows that are showing the given objects + + + This method does not resort or regroup the view. + This method can safely be called from background threads. + + + + + 更新选定的行 + + This method does not resort or regroup the view. + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + Use the property to deselect all other rows + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + 对象是否也应该被聚焦 + Use the property to deselect all other rows + + + + 选择显示任意给定模型对象的行。取消选择所有其他行。 + + A collection of model objects + + + + 获取或设置是否冻结列表视图。当列表视图被冻结时，它不会自我更新。 + + Frozen属性与Freeze()/UnFreeze()方法类似， + 不同之处在于将Frozen属性设置为False会立即解冻控件， + 而不管有多少未完成的Freeze()调用。 + objectListView1.Frozen = false; // unfreeze the control now! + + + + + 冻结列表视图，使其不再自我更新。 + + Freeze()/Unfreeze() calls nest correctly + + + + 解冻列表视图。如果此调用是最外层的unFreeze()，则将重新构建listview的内容。 + + Freeze()/Unfreeze() calls nest correctly + + + + 在冻结列表视图时执行所需的实际工作 + + + + + 解冻列表视图时执行所需的实际工作 + + + + + 如果选择事件当前挂起，则返回TRUE。在挂起选择事件时，不会引发SelectedIndexChanged或SelectionChanged事件。 + + + + + Suspend selection events until a matching ResumeSelectionEvents() + is called. + + Calls to this method nest correctly. Every call to SuspendSelectionEvents() + must have a matching ResumeSelectionEvents(). + + + + Resume raising selection events. + + + + + Returns a disposable that will disable selection events + during a using() block. + + + + + + Implementation only class that suspends and resumes selection + events on instance creation and disposal. + + + + + 按最后一个排序列和顺序对项目进行排序 + + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的名称 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的索引 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + The column whose values will be used for the sorting. + If null, the first column will be used. + The ordering to be used for sorting. If this is None, + this.Sorting and then SortOrder.Ascending will be used + If ShowGroups is true, the rows will be grouped by the given column. + If AlwaysGroupsByColumn is not null, the rows will be grouped by that column, + and the rows within each group will be sorted by the given column. + + + + Put a sort indicator next to the text of the sort column + + + + + Put a sort indicator next to the text of the given given column + + The column to be marked + The sort order in effect on that column + + + + The name of the image used when a column is sorted ascending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + The name of the image used when a column is sorted descending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + If the sort indicator images don't already exist, this method will make and install them + + + + + Remove any sorting and revert to the given order of the model objects + + + + + Do the actual work of creating the given list of groups + + + + + + For some reason, UseItemStyleForSubItems doesn't work for the colors + when owner drawing the list, so we have to specifically give each subitem + the desired colors + + The item whose subitems are to be corrected + Cells drawn via BaseRenderer don't need this, but it is needed + when an owner drawn cell uses DrawDefault=true + + + + Fill in the given OLVListItem with values of the given row + + the OLVListItem that is to be stuff with values + the model object from which values will be taken + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + + + + Convert the given image selector to an index into our image list. + Return -1 if that's not possible + + + Index of the image in the imageList, or -1 + + + + Return the tooltip that should be shown when the mouse is hovered over the given column + + The column index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回当鼠标悬停在给定单元格上时应显示的工具提示 + + The column index whose tool tip is to be fetched + The row index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回显示给定模型对象的OLVListItem + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Do the work required after the items in a listview have been created + + + + + Do the work required after one item in a listview have been created + + + + + 准备列表视图以显示交替的行背景色 + + We cannot rely on lvi.Index in this method. + In a straight list, lvi.Index is the display index, and can be used to determine + whether the row should be colored. But when organised by groups, lvi.Index is not + useable because it still refers to the position in the overall list, not the display order. + + + + + Setup all subitem images on all rows + + + + + 告诉基础列表控件针对子项显示哪些图像 + + the index at which the item occurs + the item whose subitems are to be set + + + + Tell the underlying list control which images to show against the subitems + + the index at which the item occurs + the item whose subitems are to be set + will existing images be cleared if no new image is provided? + + + + Set the subitem image natively + + + + + + + + + Take ownership of the 'objects' collection. This separats our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + This method has the intentional side-effect of converting our list of objects to an ArrayList. + + + + + + 触发给定项目的FormatRow和可能的FormatCell事件 + + + + + + + + 触发给定项目的FormatCell事件 + + + + + + + + Make the list forget everything -- all rows and all columns + + Use if you want to remove just the rows. + + + + Update our externally visible image list so it holds the same images as our shadow list, but sized correctly + + + + + Return a copy of the given source image list, where each image has been resized to be height x height in size. + If source is null, an empty image list of the given size is returned + + Height and width of the new images + Height and width of the new images + Source of the images (can be null) + A new image list + + + + Return a bitmap of the given height x height, which shows the given image, centred. + + Height and width of new bitmap + Height and width of new bitmap + Image to be centred + The background color + A new bitmap + + + + Initialize the state image list with the required checkbox images + + + + + The name of the image used when a check box is checked + + + + + The name of the image used when a check box is unchecked + + + + + The name of the image used when a check box is Indeterminate + + + + + Setup this control so it can display check boxes on subitems + (or primary checkboxes in virtual mode) + + This gives the ListView a small image list, if it doesn't already have one. + + + + Make sure the small image list for this control has checkbox images + (used for sub-item checkboxes). + + + + This gives the ListView a small image list, if it doesn't already have one. + + + ObjectListView has to manage checkboxes on subitems separate from the checkboxes on each row. + The underlying ListView knows about the per-row checkboxes, and to make them work, OLV has to + correctly configure the StateImageList. However, the ListView cannot do checkboxes in subitems, + so ObjectListView has to handle them in a differnt fashion. So, per-row checkboxes are controlled + by images in the StateImageList, but per-cell checkboxes are handled by images in the SmallImageList. + + + + + + Owner draw the column header + + + + + + Owner draw the item + + + + + + Owner draw a single subitem + + + + + + We need the click count in the mouse up event, but that is always 1. + So we have to remember the click count from the preceding mouse down event. + + + + + + When the mouse leaves the control, remove any hot item highlighting + + + + + + When the mouse moves, we might need to change the hot item. + + + + + + Check to see if we need to start editing a cell + + + + + + Tell the world that a hyperlink was clicked and if the event isn't handled, + do the default processing. + + + + + + Do the default processing for a hyperlink clicked event, which + is to try and open the url. + + + + + + The user right clicked on the control + + + + + + This method is called every time a row is selected or deselected. This can be + a pain if the user shift-clicks 100 rows. We override this method so we can + trigger one event for any number of select/deselects that come from one user action + + + + + + Called when the handle of the underlying control is created + + + + + + This method is called after the control has been fully created. + + + + + Should we start editing the cell in response to the given mouse button event? + + + + + + + Handle a key press on this control. We specifically look for F2 which edits the primary column, + or a Tab character during an edit operation, which tries to start editing on the next (or previous) cell. + + + + + + + Start an editing operation on the first editable column of the given model. + + + + + If the model doesn't exist, or there are no editable columns, this method + will do nothing. + + This will start an edit operation regardless of CellActivationMode. + + + + + + Begin an edit operation on the given cell. + + This performs various sanity checks and passes off the real work to StartCellEdit(). + The row to be edited + The index of the cell to be edited + + + + Really start an edit operation on a given cell. The parameters are assumed to be sane. + + The row to be edited + The index of the cell to be edited + + + + Calculate the bounds of the edit control for the given item/column + + + + + + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is not being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Try to give the given value to the provided control. Fall back to assigning a string + if the value assignment fails. + + A control + The value to be given to the control + The string to be given if the value doesn't work + + + + Setup the given control to be a cell editor + + + + + Return the value that the given control is showing + + + + + + + Called when the cell editor could be about to lose focus. Time to commit the change + + + + + + + Return the bounds of the given cell + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Return the bounds of the given cell only until the edge of the current text + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Calculate the visible bounds of the given column. The column's bottom edge is + either the bottom of the last row or the bottom of the control. + + The bounds of the control itself + The column + A Rectangle + This returns an empty rectnage if the control isn't in Details mode, + OR has doesn't have any rows, OR if the given column is hidden. + + + + Return a control that can be used to edit the value of the given cell. + + The row to be edited + The index of the cell to be edited + A Control to edit the given cell + + + + Get the first non-null value of the given column. + At most 1000 rows will be considered. + + + The first non-null value, or null if no non-null values were found + + + + Return a TextBox that can be used as a default cell editor. + + What column does the cell belong to? + + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + Consider only this many rows + + + + Stop editing a cell and throw away any changes. + + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Remove all trace of any existing cell edit operation + + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + True if the cell editor should be disposed + + + + Force the hot item to be recalculated + + + + + Force the hot item to be recalculated + + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + Where is the mouse? + This is the main entry point for hot item handling + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + + This is the main entry point for hot item handling + + + + Update the given row using the current hot item information + + + + + + Update the given row using the given hot item information + + + + + + + + + Apply a style to the given row + + + + + + + Apply a style to a cell + + + + + + + + Remove hot item styling from the given row + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Add the given decoration to those on this list and make it appear + + The decoration + + A decoration scrolls with the listview. An overlay stays fixed in place. + + + + + Add the given overlay to those on this list and make it appear + + The overlay + + + + Draw all the decorations + + A Graphics + The items that were redrawn and whose decorations should also be redrawn + + + + Is the given decoration shown on this list + + The overlay + + + + Is the given overlay shown on this list? + + The overlay + + + + Hide any overlays. + + + This is only a temporary hiding -- the overlays will be shown + the next time the ObjectListView redraws. + + + + + Create and configure the empty list msg overlay + + + + + Initialize the standard image and text overlays + + + + + Make sure that any overlays are visible. + + + + + Refresh the display of the overlays + + + + + Refresh the display of just one overlays + + + + + Remove the given decoration from this list + + The decoration to remove + + + + Remove the given overlay to those on this list + + The overlay + + + + 创建一个筛选器，该筛选器将执行当前安装在可见列上的所有筛选。 + + + + + Do the actual work of filtering + + + + + + + + + 删除所有列筛选。 + + + + + 根据每列中定义的值筛选更新此ObjectListView的筛选 + + + + + When some setting related to filtering changes, this method is called. + + + + + 使用当前安装的模型过滤器更新所有渲染器 + + + + + 获取给定模型的复选框状态。 + + The model + 模型的复选框状态。默认为未选中。 + + + + 设置给定模型对象的复选框状态 + + The model to be remembered + The model's checkedness + The state given to the method + + + + 忽略任何持久复选框状态 + + + + + The callbacks for CellEditing events + + this + We could replace this with EventHandler<CellEditEventArgs> but that would break all + cell editing event code from v1.x. + + + + + A TreeListView combines an expandable tree structure with list view columns. + + + To support tree operations, two delegates must be provided: + + + + CanExpandGetter + + + This delegate must accept a model object and return a boolean indicating + if that model should be expandable. + + + + + ChildrenGetter + + + This delegate must accept a model object and return an IEnumerable of model + objects that will be displayed as children of the parent model. This delegate will only be called + for a model object if the CanExpandGetter has already returned true for that model. + + + + + ParentGetter + + + This delegate must accept a model object and return the parent model. + This delegate will only be called when HierarchicalCheckboxes is true OR when Reveal() is called. + + + + + The top level branches of the tree are set via the Roots property. SetObjects(), AddObjects() + and RemoveObjects() are interpreted as operations on this collection of roots. + + + To add new children to an existing branch, make changes to your model objects and then + call RefreshObject() on the parent. + + The tree must be a directed acyclic graph -- no cycles are allowed. Put more mundanely, + each model object must appear only once in the tree. If the same model object appears in two + places in the tree, the control will become confused. + + + + + This event is triggered when user input requests the expansion of a list item. + + + + + This event is triggered when user input requests the collapse of a list item. + + + + + This event is triggered after the expansion of a list item due to user input. + + + + + This event is triggered after the collapse of a list item due to user input. + + + + + Trigger the expanding event + + + + + + Trigger the collapsing event + + + + + + Trigger the expanded event + + + + + + Trigger the collapsed event + + + + + + This class handles drawing the tree structure of the primary column. + + + + + Create a TreeRenderer + + + + + Should the renderer draw glyphs at the expansion points? + + The expansion points will still function to expand/collapse even if this is false. + + + + Should the renderer draw lines connecting siblings? + + + + + Return the pen that will be used to draw the lines between branches + + + + + Should the renderer draw triangles as the expansion glyphs? + + + This looks best with ShowLines = false + + + + + Return the branch that the renderer is currently drawing. + + + + + Return the TreeListView for which the renderer is being used. + + + + + How many pixels will be reserved for each level of indentation? + + + + + The real work of drawing the tree is done in this method + + + + + + + Draw the expansion indicator + + + + + + + + Gets whether or not we should render using styles + + + + + Draw the expansion indicator using styles + + + + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the expansion indicator without using styles + + + + + + + + Draw the lines of the tree + + + + + + + + + + Do the hit test + + + + + + + + + Calculate the edit rect + + + + + + + + + + + Make a default TreeListView + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + This is called *often* -- on every mouse move when required. It must be fast. + Don't do database lookups, linear searches, or pi calculations. Just return the + value of a property. + + + When this delegate is called, the TreeListView is not in a stable state. Don't make + calls back into the control. + + + + + + Gets whether or not this listview is capable of showing groups + + + + + This is the delegate that will be used to fetch the children of a model object + + + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + When this delegate is called, the TreeListView is not in a stable state. Don't do anything + that will result in calls being made back into the control. + + + + + + This is the delegate that will be used to fetch the parent of a model object + + The parent of the given model, or null if the model doesn't exist or + if the model is a root + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivalent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + + + + Gets or sets the model objects that are expanded. + + + This can be used to expand model objects before they are seen. + + Setting this does *not* force the control to rebuild + its display. You need to call RebuildAll(true). + + + + + + Gets or sets the filter that is applied to our whole list of objects. + TreeListViews do not currently support whole list filters. + + + + + Gets or sets whether this tree list view will display hierarchical checkboxes. + Hierarchical checkboxes is when a parent's "checkedness" is calculated from + the "checkedness" of its children. If all children are checked, the parent + will be checked. If all children are unchecked, the parent will also be unchecked. + If some children are checked and others are not, the parent will be indeterminate. + + + Hierarchical checkboxes don't work with either CheckStateGetters or CheckedAspectName + (which is basically the same thing). This is because it is too expensive to build the + initial state of the control if these are installed, since the control would have to walk + *every* branch recursively since a single bottom level leaf could change the checkedness + of the top root. + + + + + Gets or sets the collection of root objects of the tree + + + + + Gets the collection of objects that will be considered when creating clusters + (which are used to generate Excel-like column filters) + + + + + After expanding a branch, should the TreeListView attempts to show as much of the + revealed descendents as possible. + + + + + The model objects that form the top level branches of the tree. + + Setting this does NOT reset the state of the control. + In particular, it does not collapse branches. + + + + Make sure that at least one column is displaying a tree. + If no columns is showing the tree, make column 0 do it. + + + + + Gets or sets the renderer that will be used to draw the tree structure. + Setting this to null resets the renderer to default. + + If a column is currently rendering the tree, the renderer + for that column will be replaced. If no column is rendering the tree, + column 0 will be given this renderer. + + + + This is the delegate that will be used to create the underlying Tree structure + that the TreeListView uses to manage the information about the tree. + + + The factory must not return null. + + Most users of TreeListView will never have to use this delegate. + + + + + + Should a wait cursor be shown when a branch is being expanded? + + When this is true, the wait cursor will be shown whilst the children of the + branch are being fetched. If the children of the branch have already been cached, + the cursor will not change. + + + + Gets the model that is used to manage the tree structure + + + Don't mess with this property unless you really know what you are doing. + If you don't already know what it's for, you don't need it. + + + + Return true if the branch at the given model is expanded + + + + + + + Collapse the subtree underneath the given model + + + + + + Collapse all subtrees within this control + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Collapse all roots and forget everything we know about all models + + + + + Expand the subtree underneath the given model object + + + + + + Expand all the branches within this tree recursively. + + Be careful: this method could take a long time for large trees. + + + + Completely rebuild the tree structure + + If true, the control will try to preserve selection and expansion + + + + Completely rebuild the tree structure + + If not null, this list of objects will be selected after the tree is rebuilt + If not null, this collection of objects will be expanded after the tree is rebuilt + If not null, this collection of objects will be checked after the tree is rebuilt + + + + Unroll all the ancestors of the given model and make sure it is then visible. + + This works best when a ParentGetter is installed. + The object to be revealed + If true, the model will be selected and focused after being revealed + True if the object was found and revealed. False if it was not found. + + + + Update the rows that are showing the given objects + + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the expanded state of the branch at the given model object + + + + + + Return whether or not the given model can expand. + + + The given model must have already been seen in the tree + + + + Return the model object that is the parent of the given model object. + + + + The given model must have already been seen in the tree. + + + + Return the collection of model objects that are the children of the + given model as they exist in the tree at the moment. + + + + + This method returns the collection of children as the tree knows them. If the given + model has never been presented to the user (e.g. it belongs to a parent that has + never been expanded), then this method will return an empty collection. + + Because of this, if you want to traverse the whole tree, this is not the method to use. + It's better to traverse the your data model directly. + + + If the given model has not already been seen in the tree or + if it is not expandable, an empty collection will be returned. + + + + + + Delegates of this type are use to decide if the given model object can be expanded + + The model under consideration + Can the given model be expanded? + + + + Delegates of this type are used to fetch the children of the given model object + + The parent whose children should be fetched + An enumerable over the children + + + + Delegates of this type are used to fetch the parent of the given model object. + + The child whose parent should be fetched + The parent of the child or null if the child is a root + + + + Delegates of this type are used to create a new underlying Tree structure. + + The view for which the Tree is being created + A subclass of Tree + + + + Handle a left button down event + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + This differs from the base method by also setting up the IndentCount property. + + + + Reinitialize the Tree structure + + + + + Recalculate the state of the checkboxes of all the items in the given list + and their ancestors. + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Recalculate the hierarchy state of the given item and its ancestors + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Yield the unique ancestors of the given collection of objects. + The order of the ancestors is guaranteed to be deeper objects first. + Roots will always be last. + + + Unique ancestors of the given objects + + + + Return all the ancestors of the given model + + + + This uses ParentGetter if possible. + + If the given model is a root OR if the model doesn't exist, the collection will be empty + + The model whose ancestors should be calculated + Return a collection of ancestors of the given model. + + + + The application is idle and a SelectionChanged event has been scheduled + + + + + + + Decide if the given key event should be handled as a normal key input to the control? + + + + + + + Handle focus being lost, including making sure that the whole control is redrawn. + + + + + + Handle the keyboard input to mimic a TreeView. + + + Was the key press handled? + + + + A Tree object represents a tree structure data model that supports both + tree and flat list operations as well as fast access to branches. + + If you create a subclass of Tree, you must install it in the TreeListView + via the TreeFactory delegate. + + + + Create a Tree + + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + + This is the delegate that will be used to fetch the children of a model object + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + + Get or return the top level model objects in the tree + + + + + What tree view is this Tree the model for? + + + + + Collapse the subtree underneath the given model + + The model to be collapsed. If the model isn't in the tree, + or if it is already collapsed, the command does nothing. + The index of the model in flat list version of the tree + + + + Collapse all branches in this tree + + Nothing useful + + + + Expand the subtree underneath the given model object + + The model to be expanded. + The index of the model in flat list version of the tree + + If the model isn't in the tree, + if it cannot be expanded or if it is already expanded, the command does nothing. + + + + + Expand all branches in this tree + + Return the index of the first branch that was expanded + + + + Return the Branch object that represents the given model in the tree + + The model whose branches is to be returned + The branch that represents the given model, or null if the model + isn't in the tree. + + + + Return the number of visible descendents that are below the given model. + + The model whose descendent count is to be returned + The number of visible descendents. 0 if the model doesn't exist or is collapsed + + + + Rebuild the children of the given model, refreshing any cached information held about the given object + + + The index of the model in flat list version of the tree + + + + Is the given model expanded? + + + + + + + Remember whether or not the given model was expanded + + + + + + + Insert the children of the given branch into the given position + + The branch whose children should be inserted + The index where the children should be inserted + + + + Rebuild our flat internal list of objects. + + + + + Rebuild our reverse index that maps an object to its location + in the filteredObjectList array. + + + + + + Create a new branch within this tree + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Sort the tree on the given column and in the given order + + + + + + + + + + + + + Add the given collection of objects to the roots of this tree + + + + + + + + + + + + + Remove all of the given objects from the roots of the tree. + Any objects that is not already in the roots collection is ignored. + + + + + + Set the roots of this tree to be the given collection + + + + + + Update/replace the nth object with the given object + + + + + + + + + + + + + + Is this list currently being filtered? + + + + + Should the given model be included in this control? + + The model to consider + True if it will be included + + + + + + + + + + + + + + A Branch represents a sub-tree within a tree + + + + + Indicators for branches + + + + + FirstBranch of tree + + + + + LastChild of parent + + + + + OnlyBranch of tree + + + + + Create a Branch + + + + + + + + Get the ancestor branches of this branch, with the 'oldest' ancestor first. + + + + + Can this branch be expanded? + + + + + Gets or sets our children + + + + + Get/set the model objects that are beneath this branch + + + + + Gets a list of all the branches that survive filtering + + + + + Gets or set whether this branch is expanded + + + + + Return true if this branch is the first branch of the entire tree + + + + + Return true if this branch is the last child of its parent + + + + + Return true if this branch is the only top level branch + + + + + Gets the depth level of this branch + + + + + Gets or sets which model is represented by this branch + + + + + Return the number of descendents of this branch that are currently visible + + + + + + Gets or sets our parent branch + + + + + Gets or sets our overall tree + + + + + Is this branch currently visible? A branch is visible + if it has no parent (i.e. it's a root), or its parent + is visible and expanded. + + + + + Clear any cached information that this branch is holding + + + + + Collapse this branch + + + + + Expand this branch + + + + + Expand this branch recursively + + + + + Collapse all branches in this tree + + Nothing useful + + + + Fetch the children of this branch. + + This should only be called when CanExpand is true. + + + + Collapse the visible descendents of this branch into list of model objects + + + + + + Flatten this branch's visible descendents onto the given list. + + + The branch itself is not included in the list. + + + + Force a refresh of all children recursively + + + + + Sort the sub-branches and their descendents so they are ordered according + to the given comparer. + + The comparer that orders the branches + + + + This class sorts branches according to how their respective model objects are sorted + + + + + Create a BranchComparer + + + + + + Order the two branches + + + + + + + + Let the world know that a cell edit operation is beginning or ending + + + + + Create an event args + + + + + + + + + + Change this to true to cancel the cell editing operation. + + + During the CellEditStarting event, setting this to true will prevent the cell from being edited. + During the CellEditFinishing event, if this value is already true, this indicates that the user has + cancelled the edit operation and that the handler should perform cleanup only. Setting this to true, + will prevent the ObjectListView from trying to write the new value into the model object. + + + + + During the CellEditStarting event, this can be modified to be the control that you want + to edit the value. You must fully configure the control before returning from the event, + including its bounds and the value it is showing. + During the CellEditFinishing event, you can use this to get the value that the user + entered and commit that value to the model. Changing the control during the finishing + event has no effect. + + + + + The column of the cell that is going to be or has been edited. + + + + + The model object of the row of the cell that is going to be or has been edited. + + + + + The listview item of the cell that is going to be or has been edited. + + + + + The data value of the cell as it stands in the control. + + Only validate during Validating and Finishing events. + + + + The index of the cell that is going to be or has been edited. + + + + + The data value of the cell before the edit operation began. + + + + + The bounds of the cell that is going to be or has been edited. + + + + + Gets or sets whether the control used for editing should be auto matically disposed + when the cell edit operation finishes. Defaults to true + + If the control is expensive to create, you might want to cache it and reuse for + for various cells. If so, you don't want ObjectListView to dispose of the control automatically + + + + Event blocks for events that can be cancelled + + + + + Has this event been cancelled by the event handler? + + + + + BeforeSorting + + + + + Create BeforeSortingEventArgs + + + + + + + + + Create BeforeSortingEventArgs + + + + + + + + + + + Did the event handler already do the sorting for us? + + + + + What column will be used for grouping + + + + + How will groups be ordered + + + + + What column will be used for sorting + + + + + What order will be used for sorting. None means no sorting. + + + + + What column will be used for secondary sorting? + + + + + What order will be used for secondary sorting? + + + + + Sorting has just occurred. + + + + + Create a AfterSortingEventArgs + + + + + + + + + + + Create a AfterSortingEventArgs + + + + + + What column was used for grouping? + + + + + What ordering was used for grouping? + + + + + What column was used for sorting? + + + + + What ordering was used for sorting? + + + + + What column was used for secondary sorting? + + + + + What order was used for secondary sorting? + + + + + This event is triggered when the contents of a list have changed + and we want the world to have a chance to filter the list. + + + + + Create a FilterEventArgs + + + + + + Gets or sets what objects are being filtered + + + + + Gets or sets what objects survived the filtering + + + + + This event is triggered after the items in the list have been changed, + either through SetObjects, AddObjects or RemoveObjects. + + + + + Create a ItemsChangedEventArgs + + + + + Constructor for this event when used by a virtual list + + + + + + + Gets how many items were in the list before it changed + + + + + Gets how many objects are in the list after the change. + + + + + This event is triggered by AddObjects before any change has been made to the list. + + + + + Create an ItemsAddingEventArgs + + + + + + Create an ItemsAddingEventArgs + + + + + + + Gets or sets where the collection is going to be inserted. + + + + + Gets or sets the objects to be added to the list + + + + + This event is triggered by SetObjects before any change has been made to the list. + + + When used with a virtual list, OldObjects will always be null. + + + + + Create ItemsChangingEventArgs + + + + + + + Gets the objects that were in the list before it change. + For virtual lists, this will always be null. + + + + + Gets or sets the objects that will be in the list after it changes. + + + + + This event is triggered by RemoveObjects before any change has been made to the list. + + + + + Create an ItemsRemovingEventArgs + + + + + + Gets or sets the objects that will be removed + + + + + Triggered after the user types into a list + + + + + Create an AfterSearchingEventArgs + + + + + + + Gets the string that was actually searched for + + + + + Gets or sets whether an the event handler already handled this event + + + + + Gets the index of the row that was selected by the search. + -1 means that no row was matched + + + + + Triggered when the user types into a list + + + + + Create BeforeSearchingEventArgs + + + + + + + Gets or sets the string that will be found by the search routine + + Modifying this value does not modify the memory of what the user has typed. + When the user next presses a character, the search string will revert to what + the user has actually typed. + + + + Gets or sets the index of the first row that will be considered to matching. + + + + + The parameter block when telling the world about a cell based event + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + This is null for events triggered by the header. + + + + Gets the row index of the cell + + This is -1 for events triggered by the header. + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the location of the mouse at the time of the event + + + + + Gets the state of the modifier keys at the time of the event + + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view and + for event triggered by the header + + + + Gets the HitTest object that determined which cell was hit + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Tells the world that a cell was clicked + + + + + Gets or sets the number of clicks associated with this event + + + + + Tells the world that a cell was right clicked + + + + + Gets or sets the menu that should be displayed as a result of this event. + + The menu will be positioned at Location, so changing that property changes + where the menu will be displayed. + + + + Tell the world that the mouse is over a given cell + + + + + Tells the world that the frozen-ness of the ObjectListView has changed. + + + + + Make a FreezeEventArgs + + + + + + How frozen is the control? 0 means that the control is unfrozen, + more than 0 indicates froze. + + + + + The parameter block when telling the world that a tool tip is about to be shown. + + + + + Gets the tooltip control that is triggering the tooltip event + + + + + Gets or sets the text should be shown on the tooltip for this event + + Setting this to empty or null prevents any tooltip from showing + + + + In what direction should the text for this tooltip be drawn? + + + + + Should the tooltip for this event been shown in bubble style? + + This doesn't work reliable under Vista + + + + What color should be used for the background of the tooltip + + Setting this does nothing under Vista + + + + What color should be used for the foreground of the tooltip + + Setting this does nothing under Vista + + + + What string should be used as the title for the tooltip for this event? + + + + + Which standard icon should be used for the tooltip for this event + + + + + How many milliseconds should the tooltip remain before it automatically + disappears. + + + + + What font should be used to draw the text of the tooltip? + + + + + Common information to all hyperlink events + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the ObjectListView that is the source of the event + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the text of the cell + + + + + Gets or sets whether or not this cell is a hyperlink. + Defaults to true for enabled rows and false for disabled rows. + + + + + Gets or sets the url that should be invoked when this cell is clicked. + + Setting this to None or String.Empty means that this cell is not a hyperlink + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the item of the cell + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the display index of the row + + + + + Should events be triggered for each cell in this row? + + + + + Parameter block for FormatCellEvent + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the model value that is being displayed by the cell. + + This is null when the view is not in details view + + + + The event args when a hyperlink is clicked + + + + + Gets the url that was associated with this cell. + + + + + The event args when the check box in a column header is changing + + + + + Get the column whose checkbox is changing + + + + + Get or set the new state that should be used by the column + + + + + The event args when the hot item changed + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Gets the part of the cell that the mouse is over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + Gets the index of the column that the mouse is over + + In non-details view, this will always be 0. + + + + Gets the index of the row that the mouse is over + + + + + Gets the group that the mouse is over + + + + + Gets the part of the cell that the mouse used to be over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse used to be over + + + + + Gets the index of the column that the mouse used to be over + + + + + Gets the index of the row that the mouse used to be over + + + + + Gets the group that the mouse used to be over + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + Let the world know that a checkbox on a subitem is changing + + + + + Create a new event block + + + + + + + + + + The column of the cell that is having its checkbox changed. + + + + + The model object of the row of the cell that is having its checkbox changed. + + + + + The listview item of the cell that is having its checkbox changed. + + + + + The current check state of the cell. + + + + + The proposed new check state of the cell. + + + + + The index of the cell that is going to be or has been edited. + + + + + This event argument block is used when groups are created for a list. + + + + + Create a CreateGroupsEventArgs + + + + + + Gets the settings that control the creation of groups + + + + + Gets or sets the groups that should be used + + + + + Has this event been cancelled by the event handler? + + + + + This event argument block is used when the text of a group task is clicked + + + + + Create a GroupTaskClickedEventArgs + + + + + + Gets which group was clicked + + + + + This event argument block is used when a group is about to expand or collapse + + + + + Create a GroupExpandingCollapsingEventArgs + + + + + + Gets which group is expanding/collapsing + + + + + Gets whether this event is going to expand the group. + If this is false, the group must be collapsing. + + + + + This event argument block is used when the state of group has changed (collapsed, selected) + + + + + Create a GroupStateChangedEventArgs + + + + + + + + Gets whether the group was collapsed by this event + + + + + Gets whether the group was focused by this event + + + + + Gets whether the group was selected by this event + + + + + Gets whether the group was uncollapsed by this event + + + + + Gets whether the group was unfocused by this event + + + + + Gets whether the group was unselected by this event + + + + + Gets which group had its state changed + + + + + Gets the previous state of the group + + + + + Gets the new state of the group + + + + + This event argument block is used when a branch of a tree is about to be expanded + + + + + Create a new event args + + + + + + + Gets the model that is about to expand. If null, all branches are going to be expanded. + + + + + Gets the OLVListItem that is about to be expanded + + + + + This event argument block is used when a branch of a tree has just been expanded + + + + + Create a new event args + + + + + + + Gets the model that is was expanded. If null, all branches were expanded. + + + + + Gets the OLVListItem that was expanded + + + + + This event argument block is used when a branch of a tree is about to be collapsed + + + + + Create a new event args + + + + + + + Gets the model that is about to collapse. If this is null, all models are going to collapse. + + + + + Gets the OLVListItem that is about to be collapsed. Can be null + + + + + This event argument block is used when a branch of a tree has just been collapsed + + + + + Create a new event args + + + + + + + Gets the model that is was collapsed. If null, all branches were collapsed + + + + + Gets the OLVListItem that was collapsed + + + + + This class contains all the settings used when groups are created + + + + + Create a GroupingParameters + + + + + + + + + + + + + + + Gets or sets the ObjectListView being grouped + + + + + Gets or sets the column used to create groups + + + + + In what order will the groups themselves be sorted? + + + + + If this is set, this comparer will be used to order the groups + + + + + If this is set, this comparer will be used to order items within each group + + + + + Gets or sets the column that will be the primary sort + + + + + Gets or sets the ordering for the primary sort + + + + + Gets or sets the column used for secondary sorting + + + + + Gets or sets the ordering for the secondary sort + + + + + Gets or sets the title format used for groups with zero or more than one element + + + + + Gets or sets the title format used for groups with only one element + + + + + Gets or sets whether the items should be sorted by the primary column + + + + + These values indicate what is the state of the group. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + Normal + + + + + Collapsed + + + + + Hidden + + + + + NoHeader + + + + + Can be collapsed + + + + + Has focus + + + + + Is Selected + + + + + Is subsetted + + + + + Subset link has focus + + + + + All styles + + + + + This mask indicates which members of a LVGROUP have valid data. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + No mask + + + + + Group has header + + + + + Group has footer + + + + + Group has state + + + + + + + + + + + + + + + pszSubtitle is valid + + + + + pszTask is valid + + + + + pszDescriptionTop is valid + + + + + pszDescriptionBottom is valid + + + + + iTitleImage is valid + + + + + iExtendedImage is valid + + + + + iFirstItem and cItems are valid + + + + + pszSubsetTitle is valid + + + + + readonly, cItems holds count of items in visible subset, iFirstItem is valid + + + + + This mask indicates which members of a GROUPMETRICS structure are valid + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class enhance the capabilities of a normal ListViewGroup, + enabling the functionality that was released in v6 of the common controls. + + + + In this implementation (2009-09), these objects are essentially passive. + Setting properties does not automatically change the associated group in + the listview. Collapsed and Collapsible are two exceptions to this and + give immediate results. + + + This really should be a subclass of ListViewGroup, but that class is + sealed (why is that?). So this class provides the same interface as a + ListViewGroup, plus many other new properties. + + + + + + Create an OLVGroup + + + + + 按指定标题创建分组 + + 分组标题 + + + + Gets or sets the bottom description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets whether or not this group is collapsed + + + + + Gets or sets whether or not this group can be collapsed + + + + + Gets or sets some representation of the contents of this group + + This is user defined (like Tag) + + + + Gets whether this group has been created. + + + + + Gets or sets the int or string that will select the extended image to be shown against the title + + + + + Gets or sets the footer of the group + + + + + Gets the internal id of our associated ListViewGroup. + + + + + Gets or sets the header of the group + + + + + Gets or sets the horizontal alignment of the group header + + + + + Gets or sets the internally created id of the group + + + + + Gets or sets ListViewItems that are members of this group + + Listener of the BeforeCreatingGroups event can populate this collection. + It is only used on non-virtual lists. + + + + Gets or sets the key that was used to partition objects into this group + + This is user defined (like Tag) + + + + Gets the ObjectListView that this group belongs to + + If this is null, the group has not yet been created. + + + + Gets or sets the name of the group + + As of 2009-09-01, this property is not used. + + + + Gets or sets whether this group is focused + + + + + Gets or sets whether this group is selected + + + + + Gets or sets the text that will show that this group is subsetted + + + As of WinSDK v7.0, subsetting of group is officially unimplemented. + We can get around this using undocumented interfaces and may do so. + + + + + Gets or set the subtitleof the task + + + + + Gets or sets the value by which this group will be sorted. + + + + + Gets or sets the state of the group + + + + + Gets or sets which bits of State are valid + + + + + Gets or sets whether this group is showing only a subset of its elements + + + As of WinSDK v7.0, this property officially does nothing. + + + + + Gets or sets the user-defined data attached to this group + + + + + Gets or sets the task of this group + + This task is the clickable text that appears on the right margin + of the group header. + + + + Gets or sets the int or string that will select the image to be shown against the title + + + + + Gets or sets the top description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets the number of items that are within this group. + + This should only be used for virtual groups. + + + + Gets or sets the ListViewGroup that is shadowed by this group. + + For virtual groups, this will always be null. + + + + Calculate the index into the group image list of the given image selector + + + + + + + Convert this object to a string representation + + + + + + Insert a native group into the underlying Windows control, + *without* using a ListViewGroup + + + This is used when creating virtual groups + + + + Insert a native group into the underlying control via a ListViewGroup + + + + + + Change the members of the group to match the current contents of Items, + using a ListViewGroup + + + + + Create a native LVGROUP structure that matches this group + + + + + Get the current state of this group from the underlying control + + + + + Get the current state of this group from the underlying control + + + + + An instance of Munger gets a value from or puts a value into a target object. The property + to be peeked (or poked) is determined from a string. The peeking or poking is done using reflection. + + + Name of the aspect to be peeked can be a field, property or parameterless method. The name of an + aspect to poke can be a field, writable property or single parameter method. + + Aspect names can be dotted to chain a series of references. + + Order.Customer.HomeAddress.State + + + + + Create a do nothing Munger + + + + + Create a Munger that works on the given aspect name + + The name of the + + + + A helper method to put the given value into the given aspect of the given object. + + This method catches and silently ignores any errors that occur + while modifying the target object + The object to be modified + The name of the property/field to be modified + The value to be assigned + Did the modification work? + + + + Gets or sets whether Mungers will silently ignore missing aspect errors. + + + + By default, if a Munger is asked to fetch a field/property/method + that does not exist from a model, it returns an error message, since that + condition is normally a programming error. There are some use cases where + this is not an error, and the munger should simply keep quiet. + + By default this is true during release builds. + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or parameter-less method. + + + The name can be dotted, which chains references. If any link in the chain returns + null, the entire chain is considered to return null. + + + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + Extract the value indicated by our AspectName from the given target. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Extract the value indicated by our AspectName from the given target, raising exceptions + if the munger fails. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Poke the given value into the given target indicated by our AspectName. + + + + If the AspectName is a dotted path, all the selectors bar the last + are used to find the object that should be updated, and the last + selector is used as the property to update on that object. + + + So, if 'target' is a Person and the AspectName is "HomeAddress.Postcode", + this method will first fetch "HomeAddress" property, and then try to set the + "Postcode" property on the home address object. + + + The object that will be poked + The value that will be poked into the target + bool indicating whether the put worked + + + + Gets the list of SimpleMungers that match our AspectName + + + + + Convert a possibly dotted AspectName into a list of SimpleMungers + + + + + + + Evaluate the given chain of SimpleMungers against an initial target. + + + + + + + + A SimpleMunger deals with a single property/field/method on its target. + + + Munger uses a chain of these resolve a dotted aspect name. + + + + + Create a SimpleMunger + + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or method. + When using a method to get a value, the method must be parameter-less. + When using a method to set a value, the method must accept 1 parameter. + + + It cannot be a dotted name. + + + + + + Get a value from the given target + + + + + + + Poke the given value into the given target indicated by our AspectName. + + The object that will be poked + The value that will be poked into the target + bool indicating if the put worked + + + + These exceptions are raised when a munger finds something it cannot process + + + + + Create a MungerException + + + + + + + + Get the munger that raised the exception + + + + + Gets the target that threw the exception + + + + + Wrapper for all native method calls on ListView controls + + + + + Put an image under the ListView. + + + + The ListView must have its handle created before calling this. + + + This doesn't work very well. Specifically, it doesn't play well with owner drawn, + and grid lines are drawn over it. + + + + The image to be used as the background. If this is null, any existing background image will be cleared. + If this is true, the image is pinned to the bottom right and does not scroll. The other parameters are ignored + If this is true, the image will be tiled to fill the whole control background. The offset parameters will be ignored. + If both watermark and tiled are false, this indicates the horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + If both watermark and tiled are false, this indicates the vertical percentage where the image will be placed. + + + + + Flags controlling how the Image List item is + drawn + + + + + Draw item normally. + + + + + Draw item transparently. + + + + + Draw item blended with 25% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw item blended with 50% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw the icon's mask + + + + + Draw the icon image without using the mask + + + + + Draw the icon using the ROP specified. + + + + + Preserves the alpha channel in dest. XP only. + + + + + Scale the image to cx, cy instead of clipping it. XP only. + + + + + Scale the image to the current DPI of the display. XP only. + + + + + Enumeration containing XP ImageList Draw State options + + + + + The image state is not modified. + + + + + Adds a glow effect to the icon, which causes the icon to appear to glow + with a given color around the edges. (Note: does not appear to be implemented) + + + + + Adds a drop shadow effect to the icon. (Note: does not appear to be implemented) + + + + + Saturates the icon by increasing each color component + of the RGB triplet for each pixel in the icon. (Note: only ever appears to result in a completely unsaturated icon) + + + + + Alpha blends the icon. Alpha blending controls the transparency + level of an icon, according to the value of its alpha channel. + (Note: does not appear to be implemented). + + + + + Draws an image using the specified flags and state on XP systems. + + The image list from which an item will be drawn + Device context to draw to + Index of image to draw + X Position to draw at + Y Position to draw at + Drawing flags + Width to draw + Height to draw + State flags + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + Change the virtual list size of the given ListView (which must be in virtual mode) + + This will not change the scroll position + The listview to send a message to + How many rows should the list have? + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + + + Calculates the number of items that can fit vertically in the visible area of a list-view (which + must be in details or list view. + + The listView + Number of visible items per page + + + + For the given item and subitem, make it display the given image + + The listview to send a m to + row number (0 based) + subitem (0 is the item itself) + index into the image list + + + + Setup the given column of the listview to show the given image to the right of the text. + If the image index is -1, any previous image is cleared + + The listview to send a m to + Index of the column to modifiy + + Index into the small image list + + + + Does this version of the operating system have builtin sort indicators? + + Are there builtin sort indicators + XP and later have these + + + + Return the bounds of the update region on the given control. + + The BeginPaint() system call validates the update region, effectively wiping out this information. + So this call has to be made before the BeginPaint() call. + The control whose update region is be calculated + A rectangle + + + + Validate an area of the given control. A validated area will not be repainted at the next redraw. + + The control to be validated + The area of the control to be validated + + + + Select all rows on the given listview + + The listview whose items are to be selected + + + + Deselect all rows on the given listview + + The listview whose items are to be deselected + + + + Deselect a single row + + + + + + + Set the item state on the given item + + The listview whose item's state is to be changed + The index of the item to be changed + Which bits of the value are to be set? + The value to be set + + + + Scroll the given listview by the given deltas + + + + + true if the scroll succeeded + + + + Return the handle to the header control on the given list + + The listview whose header control is to be returned + The handle to the header control + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the index of the column of the header that is under the given point. + Return -1 if no column is under the pt + + The list we are interested in + The client co-ords + The index of the column under the point, or -1 if no column header is under that point + + + + Return the index of the divider under the given point. Return -1 if no divider is under the pt + + The list we are interested in + The client co-ords + The index of the divider under the point, or -1 if no divider is under that point + + + + Get the scroll position of the given scroll bar + + + + + + + + Change the z-order to the window 'toBeMoved' so it appear directly on top of 'reference' + + + + + + + + Make the given control/window a topmost window + + + + + + + Change the size of the window without affecting any other attributes + + + + + + + + + Show the given window without activating it + + The window to show + + + + Mark the given column as being selected. + + + The OLVColumn or null to clear + + This method works, but it prevents subitems in the given column from having + back colors. + + + + + A simple-minded implementation of a Dictionary that can handle null as a key. + + The type of the dictionary key + The type of the values to be stored + This is not a full implementation and is only meant to handle + collecting groups by their keys, since groups can have null as a key value. + + + + OLVListItems are specialized ListViewItems that know which row object they came from, + and the row index at which they are displayed, even when in group view mode. They + also know the image they should draw against themselves + + + + + Create a OLVListItem for the given row object + + + + + Create a OLVListItem for the given row object, represented by the given string and image + + + + + Gets the bounding rectangle of the item, including all subitems + + + + + Gets or sets how many pixels will be left blank around each cell of this item + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how the cells of this item will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the checkedness of this item. + + + Virtual lists don't handle checkboxes well, so we have to intercept attempts to change them + through the items, and change them into something that will work. + Unfortunately, this won't work if this property is set through the base class, since + the property is not declared as virtual. + + + + + Enable tri-state checkbox. + + .NET's Checked property was not built to handle tri-state checkboxes, + and will return True for both Checked and Indeterminate states. + + + + Gets if this item has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Gets whether or not this row can be selected and activated + + + + + Gets whether any cell on this item is showing a hyperlink + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the the model object that is source of the data for this list item. + + + + + Gets or sets the color that will be used for this row's background when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection BackColor will be used. + + + + + + Gets or sets the color that will be used for this row's foreground when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection ForeColor will be used. + + + + + + Return the sub item at the given index + + Index of the subitem to be returned + An OLVListSubItem + + + + Return bounds of the given subitem + + This correctly calculates the bounds even for column 0. + + + + A ListViewSubItem that knows which image should be drawn against it. + + + + + Create a OLVListSubItem + + + + + Create a OLVListSubItem that shows the given string and image + + + + + Gets or sets how many pixels will be left blank around this cell + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how this cell will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the model value is being displayed by this subitem. + + + + + Gets if this subitem has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the url that should be invoked when this subitem is clicked + + + + + Gets or sets whether this cell is selected + + + + + Return the state of the animatation of the image on this subitem. + Null means there is either no image, or it is not an animation + + + + + An indication of where a hit was within ObjectListView cell + + + + + Nowhere + + + + + On the text + + + + + On the image + + + + + On the checkbox + + + + + On the expand button (TreeListView) + + + + + in a button (cell must have ButtonRenderer) + + + + + in the cell but not in any more specific location + + + + + UserDefined location1 (used for custom renderers) + + + + + On the expand/collapse widget of the group + + + + + Somewhere on a group + + + + + Somewhere in a column header + + + + + Somewhere in a column header checkbox + + + + + Somewhere in a header divider + + + + + A collection of ListViewHitTest constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class encapsulate the information gathered during a OlvHitTest() + operation. + + Custom renderers can use HitTestLocation.UserDefined and the UserData + object to store more specific locations for use during event handlers. + + + + Create a OlvListViewHitTestInfo + + + + + Create a OlvListViewHitTestInfo when the header was hit + + + + + Where is the hit location? + + + + + Where is the hit location? + + + + + Which group was hit? + + + + + Custom renderers can use this information to supply more details about the hit location + + + + + Gets the item that was hit + + + + + Gets the subitem that was hit + + + + + Gets the part of the subitem that was hit + + + + + Gets the ObjectListView that was tested + + + + + Gets the model object that was hit + + + + + Gets the index of the row under the hit point or -1 + + + + + Gets the index of the column under the hit point + + + + + Gets the index of the header divider + + + + + Gets the column that was hit + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + A TreeDataSourceAdapter knows how to build a tree structure from a binding list. + + To build a tree + + + + Create a data source adaptor that knows how to build a tree structure + + + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets the DataTreeListView that is being managed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A IVirtualGroups is the interface that a virtual list must implement to support virtual groups + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + This is a safe, do nothing implementation of a grouping strategy + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + Provides grouping functionality to a FastObjectListView + + + + + Create groups for FastListView + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This is the COM interface that a ListView must be given in order for groups in virtual lists to work. + + + This interface is NOT documented by MS. It was found on Greg Chapell's site. This means that there is + no guarantee that it will work on future versions of Windows, nor continue to work on current ones. + + + + + Not sure what this does + + + + + + + Not sure what this does + + + + + + + Get the index of the item that occurs at the n'th position of the indicated group. + + Index of the group + Index within the group + Index of the item within the whole list + + + + Get the index of the group to which the given item belongs + + Index of the item within the whole list + Which occurences of the item is wanted + Index of the group + + + + Get the number of groups that contain the given item + + Index of the item within the whole list + How many groups does it occur within + + + + A hint to prepare any cache for the given range of requests + + + + + + + A default implementation of the IOwnerDataCallback interface + + + + + A VirtualListDataSource is a complete manner to provide functionality to a virtual list. + An object that implements this interface provides a VirtualObjectListView with all the + information it needs to be fully functional. + + Implementors must provide functioning implementations of at least GetObjectCount() + and GetNthObject(), otherwise nothing will appear in the list. + + + + Return the object that should be displayed at the n'th row. + + The index of the row whose object is to be returned. + The model object at the n'th row, or null if the fetching was unsuccessful. + + + + Return the number of rows that should be visible in the virtual list + + The number of rows the list view should have. + + + + Get the index of the row that is showing the given model object + + The model object sought + The index of the row showing the model, or -1 if the object could not be found. + + + + The ListView is about to request the given range of items. Do + whatever caching seems appropriate. + + + + + + + Find the first row that "matches" the given text in the given range. + + The text typed by the user + Start searching from this index. This may be greater than the 'to' parameter, + in which case the search should descend + Do not search beyond this index. This may be less than the 'from' parameter. + The column that should be considered when looking for a match. + Return the index of row that was matched, or -1 if no match was found + + + + Sort the model objects in the data source. + + + + + + + Add the given collection of model objects to this control. + + A collection of model objects + + + + Insert the given collection of model objects to this control at the position + + Index where the collection will be added + A collection of model objects + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + + + Set the collection of objects that this control will show. + + + + + + Update/replace the nth object with the given object + + + + + + + This extension allow virtual lists to filter their contents + + + + + All subsequent retrievals on this data source should be filtered + through the given filters. null means no filtering of that kind. + + + + + + + A do-nothing implementation of the VirtualListDataSource interface. + + + + + Creates an AbstractVirtualListDataSource + + + + + + The list view that this data source is giving information to. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + This is a useful default implementation of SearchText method, intended to be called + by implementors of IVirtualListDataSource. + + + + + + + + + + + + + + + + + + This class mimics the behavior of VirtualObjectListView v1.x. + + + + + Creates a VirtualListVersion1DataSource + + + + + + How will the n'th object of the data source be fetched? + + + + + + + + + + + + + + + + + + + + + + Designer for and its subclasses. + + + + This designer removes properties and events that are available on ListView but that are not + useful on ObjectListView. + + + We can't inherit from System.Windows.Forms.Design.ListViewDesigner, since it is marked internal. + So, this class uses reflection to create a ListViewDesigner and then forwards messages to that designer. + + + + + + Initializes the designer with the specified component. + + The to associate the designer with. This component must always be an instance of, or derive from, . + + + + Initializes a newly created component. + + A name/value dictionary of default values to apply to properties. May be null if no default values are specified. + + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Removes the duplicate DockingActionList added by this designer to the . + + + adds an internal DockingActionList : 'Dock/Undock in Parent Container'. + But the default designer has already added that action list. So we need to remove one. + + + + + Adjusts the set of properties the component exposes through a . + + An containing the properties for the class of the component. + + + + Allows a designer to add to the set of events that it exposes through a . + + The events for the class of the component. + + + + Allows a designer to change or remove items from the set of attributes that it exposes through a . + + The attributes for the class of the component. + + + + Allows a designer to change or remove items from the set of events that it exposes through a . + + The events for the class of the component. + + + + Gets the design-time action lists supported by the component associated with the designer. + + + The design-time action lists supported by the component associated with the designer. + + + + + Gets the collection of components associated with the component managed by the designer. + + + The components that are associated with the component managed by the designer. + + + + + Indicates whether a mouse click at the specified point should be handled by the control. + + + true if a click at the specified point is to be handled by the control; otherwise, false. + + A indicating the position at which the mouse was clicked, in screen coordinates. + + + + Processes Windows messages and optionally routes them to the control. + + The to process. + + + + This class modifies a ListViewActionList, by removing the "Edit Items" and "Edit Groups" actions. + + + + That class is internal, so we cannot simply subclass it, which would be simplier. + + + Action lists use reflection to determine if that action can be executed, so we not + only have to modify the returned collection of actions, but we have to implement + the properties and commands that the returned actions use. + + + + + This class works in conjunction with the OLVColumns property to allow OLVColumns + to be added to the ObjectListView. + + + + + Create a OLVColumnCollectionEditor + + + + + + What type of object does this editor create? + + + + + + Edit a given value + + + + + + + + + What text should be shown in the list for the given object? + + + + + + + Control how the overlay is presented in the IDE + + + + + An OLVColumn knows which aspect of an object it should present. + + + The column knows how to: + + extract its aspect from the row object + convert an aspect to a string + calculate the image for the row object + extract a group "key" from the row object + convert a group "key" into a title for the group + + For sorting to work correctly, aspects from the same column + must be of the same type, that is, the same aspect cannot sometimes + return strings and other times integers. + + + + + How should the button be sized? + + + + + 每个单元格都将具有相同大小的按钮，如ButtonSize属性所示 + + + + + 每个单元格都将绘制一个填充单元格的按钮，该按钮由ButtonPadding插入 + + + + + 将调整每个按钮的大小以包含文本内容 + + + + + Create an OLVColumn + + + + + Initialize a column to have the given title, and show the given aspect + + The title of the column + The aspect to be shown in the column + + + + 此委托将用于提取要在此列中显示的值。 + + + 如果设置, AspectName属性将被忽略. + + + + + 请记住，如果当前列的AspectGetter是内部生成的，依旧可以随意重新生成 + + + + + 应调用以获取要在此列中显示的值的属性或方法的名称。 + 仅当未指定ValueGetterDelegate时才使用此选项。 + + 此名称可以用来表示对属性或无参数方法的链引用。 + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + 此委托将用于将编辑后的值放回模型对象中。 + + + 如果IsEdable==false，则不执行任何操作。 + + + + + 用于将要在此列中显示的Aspect转换为字符串的委托。 + + 如果设置了此值，AspectToStringFormat将被忽略。 + + + + 将Aspect转换成字符串的格式文本 + + + 此字符串作为第一个参数传递给String.Format()方法。 + 仅当尚未设置AspectToStringConverter时才使用此选项。 + "{0:C}" 表示转换数字到货币 + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取用户操作是否可以隐藏此列 + + 这会同时考虑Hideable属性以及此列是否为列表视图的主列(列0)。 + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + + + 如果控件不是所有者绘制(owner drawn)的，则始终将其视为true。 + + 如果该值为False(默认值)并且控件是所有者绘制(owner drawn)的， + ObjectListView将尝试计算单元格实际内容的宽度，然后将编辑控件的大小调整为恰到好处的宽度。 + 如果为真，则无论单元格的内容如何，都将使用单元格的整个宽度。 + + 如果未在列上设置此属性，则将使用控件中的值 + + 仅当控件处于详细信息视图中时才使用此值。 + 无论此设置如何，开发人员都可以通过侦听CellEditStarting事件来指定编辑控件的确切大小。 + + + + + 获取编辑此列中的单元格时是否应使用整个单元格 + + 这将计算当前有效值，该值可能与CellEditUseWholeCell不同 + + + + 获取或设置此列中此单元格周围将留空的像素数 + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + + 获取或设置此列中的单元格垂直对齐的方式。 + + + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + 如果未设置，将使用控件本身的值。 + + + + + + 获取或设置此列是否显示复选框。 + + + 在第0列上设置此选项不起作用。列0复选框由ObjectListView本身的CheckBox属性控制。 + + + + + Gets or sets the clustering strategy used for this column. + + + + The clustering strategy is used to build a Filtering menu for this item. + If this is null, a useful default will be chosen. + + + To disable filtering on this colummn, set UseFiltering to false. + + + Cluster strategies belong to a particular column. The same instance + cannot be shared between multiple columns. + + + + + + 获取或设置是否启用此列中的按钮(如果此列是按钮)，即使该行本身被禁用 + + + + + 此列是否应该调整大小以填充列表视图中的空闲空间？ + + + + 如果希望两列(或更多列)平均共享可用空间，请将此属性设置为True。 + 如果希望此列具有更大或更小的可用空间份额，则必须显式设置FreeSpaceProportion属性。 + + + 空间填充列仍然由MinimumWidth和MaximumWidth属性控制。 + + /// + + + + 控件中未占用的水平空间应分配给此列的比例是多少？ + + + + 在某些情况下，如果列(通常是最右边的列)可以随着列表视图的扩展而扩展， + 这样就可以在不必水平滚动的情况下尽可能多地看到列(您永远不应该让用户必须水平滚动任何内容！)。 + + + 调整空间填充列的大小以占据列表视图的未占用宽度的一部分(未占用宽度是一旦所有非填充列都被赋予其空间后剩余的宽度)。 + 此属性指示将分配给此列的未占用空间的相对比例。此属性的实际值并不重要，重要的是它的值相对于其他列中的值。 + 例子: + + + 如果只有一个空间填充列，则无论FreeSpaceProportion中的值如何，都将为其提供所有可用空间。 + + + 如果有两个或多个空间填充列，并且它们的FreeSpaceProportion值都相同，则它们将平等地共享空闲空间。 + + + 如果FreeSpaceProportion有三个值为3、2和1的空间填充列，则第一列将占用一半的空闲空间，第二列将占用三分之一的空闲空间，第三列将占用六分之一的空闲空间。 + + + + + + + + 获取或设置在单击此列的标题时是否对此列值重新生成组。 + + + 此设置仅在ShowGroups为true时使用。 + + 如果为False，则单击标题不会重建组。 + + 如果为false，则仍会激发BeforeCreatingGroups事件，这些事件可用于根据具体情况进行分组或提供反馈。 + + + + + 当组已创建但尚未成为真正的ListViewGroup时，将调用此委托。用户可以利用此机会填写有关该组的许多其他详细信息。 + + + + + 调用此委托以获取对象，该对象是给定行所属的组的键。 + + + + + 调用此委托将组键转换为该组的标题。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，应如何设置标签的格式 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 + + + "{0} [{1} items]" + + + + 获取this.GroupWithItemCountFormat或默认值 + + + 如果未设置GroupWithItemCountFormat，则如果可能，将从ObjectListView中获取其值。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，如果组中只有一个项目，标签应该如何格式化 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 (始终为1) + + + "{0} [{1} item]" + + + + 获取this.GroupWithItemCountSingularFormat或默认值 + + + 如果未设置此值，将使用列表视图中的值 + + + + + 获取是否应在列标题中使用筛选器指示符绘制此列。 + + + + + 获取或设置将用于所有者绘制标题列的委托。 + + + + + 获取或设置将用于绘制此列标题的样式 + + 仅当拥有的ObjectListView将HeaderUsesThemes设置为False时才使用此选项。 + + + + 获取或设置绘制此列的标题时使用的字体 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置绘制此列标题文本的颜色 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置将在列标题中显示的图像键 + + 这仅在HeaderUsesThemes为false时使用 + + + + 获取或设置Header文本的对齐方式 + + + + + 返回Header的文本对齐方式。这将是显式设置的，或者将遵循列中文本的对齐方式 + + + + + 获取转换为StringAlignment的Header对齐方式 + + + + + 获取此列的标题中是否有图像 + + + + + 获取或设置此Header是否在Header中放置复选框 + + + + + 获取或设置此Header是否在Header中放置三态复选框 + + + + + 获取或设置此列Header中复选框的选中状态 + + + + + 获取或设置选中/取消选中标题复选框的值是否会导致将此列中所有单元格的复选框设置为相同的选中/取消选中。 + 默认值为true. + + + + 当单元格的复选框状态改变时，该函数不会与自动更新标题的功能相反。 + + + 此属性在TreeListView上的行为最好描述为未定义，应该避免。 + + + 此操作(检查/取消检查所有行)的性能为O(n)，其中n是行数。它将在大型虚拟列表上工作，但可能需要一些时间。 + + + + + + 获取或设置是否禁用标题中的复选框 + + + 单击禁用的复选框不会更改其值，但会引发HeaderCheckBoxChanging事件，使程序员有机会执行适当的操作。 + + + + 获取或设置用户是否可以隐藏此列。 + + + 无论此设置如何，列0永远不能隐藏。 + + + + + 获取或设置此列中的文本值是否类似于超链接 + + + + + 这是属性的名称，将调用该属性来获取应该在此列中显示的图像的图像选择器。 + 它可以返回int、String、Image或NULL。 + + + 如果ImageGetter不为空，则忽略此项。 + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 调用此委托以获取应该在此列中显示的图像的图像选择器。它可以返回int、String、Image或NULL。 + + + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 获取或设置此列是否在其单元格中绘制按钮 + + + + 如果将其设置为true，则列的呈现器将成为ColumnButtonRenender(如果尚未成为ColumnButtonRenender)。如果设置为False，则将丢弃以前的任何按钮渲染器 + + 如果单元格的Aspect为Null或空，则不会在单元格中绘制任何内容。 + + + + Create a ColumnButtonRenderer to draw buttons in this column + + + + + + Fill in details to our ColumnButtonRenderer based on the properties set on the column + + + + + 获取或设置按钮可以占用的最大宽度。 + -1 表示不限制最大宽度 + + 仅当SizingMode为TextBound时才生效 + + + + 获取或设置当SizingMode为TextBound时单元格周围的额外空间 + + + + + 获取或设置SizingMode为FixedBound时按钮的大小 + + 如果未设置，将使用单元格的边界 + + + + 获取或设置此列显示按钮时如何调整每个按钮的大小 + + + + + 此列中显示的值是否可以编辑 + + 此默认值为false，因为控制列表视图的可编辑性的主要方法是列表视图本身。 + 列表视图可编辑后，所有列也可编辑，除非程序员显式将它们标记为不可编辑 + + + + 是否是固定宽度 + + + + + 获取/设置当视图切换到平铺视图(TileView)时是否使用此列。 + + 无论此设置如何，第0列始终包含在平铺视图中。平铺视图不能很好地处理许多“列”信息。两三个最好。 + + + + 获取或设置Header的文本是否应垂直呈现。 + + + 如果为True，最好将ToolTipText设置为列的名称，以便于阅读。 + 垂直Header仅为文本。他们不会画出图像。 + + + + + 该列是否可见 + + 更改此值后，必须调用RebuildColumns()才能使更改生效。 + + + + 此列最后一次定位在详细信息视图列中的位置是什么 + + DisplayIndex是易失性的。一旦从控件中移除列，就无法发现它在显示顺序中的位置。 + 即使列不在列表视图的活动列中，此属性也会保护该信息。 + + + + 列最大宽度 + + -1表示不限制. 将该值指定为与MinimumWidth相同的值，以生成固定宽度的列。 + + + + 列最小宽度 + + -1表示不限制. 将该值指定为与MaximumWidth相同的值，以生成固定宽度的列。 + + + + Get/set the renderer that will be invoked when a cell needs to be redrawn + + + + + This delegate is called when a cell needs to be drawn in OwnerDrawn mode. + + This method is kept primarily for backwards compatibility. + New code should implement an IRenderer, though this property will be maintained. + + + + 获取或设置执行文本搜索时是否使用此列的单元格中的文本。 + + + + 如果为False，则文本筛选器在查找匹配项时不会尝试搜索此列单元格。 + + + + + + 获取或设置一个委托，该委托将返回在使用基于文本的筛选器时应考虑进行文本匹配的文本值数组。 + + + + + 获取或设置此列的标题是否将包括该列的文本。 + + + + 如果为false，则列标题中呈现的唯一内容将是来自 . + + 只有在以下情况下才会考虑此设置: ObjectListView中的 为false . + + + + + 获取或设置当用户单击此列的标题时是否重新排序列表内容。 + + + + 如果为False，则单击标题将不会对列表进行排序，但也不会提供有关列表未排序原因的任何反馈。提供适当的反馈是程序员的责任。 + + 如果为false，则仍会触发BeforeSorting事件，该事件可用于根据具体情况进行排序或提供反馈。 + + + + + 获取或设置列内容的水平对齐方式。 + + NET将不允许列0具有除左对齐以外的任何对齐方式。我们不能更改列表视图的基本行为，但当所有者绘制时，列0现在可以有其他对齐方式。 + + + + 获取列文本对齐的StringAlignment等效项 + + + + + 当鼠标悬停在该列的标题上时，应该显示什么字符串？ + + 如果拥有的ObjectListView上安装了HeaderToolTipGetter，则将忽略此值。 + + + + 此列是否应该有一个三态复选框 + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + + + + + 按列纵横比的首字母对对象进行分组 + + + 一种常见的模式是按该组的值的首字母对列进行分组。aspect必须是字符串(显然)。 + + + + + 获取或设置此列是否应为用户可筛选的列 + + + + + Gets or sets a filter that will only include models where the model's value + for this column is one of the values in ValuesChosenForFiltering + + + + + Gets or sets the values that will be used to generate a filter for this + column. For a model to be included by the generated filter, its value for this column + must be in this list. If the list is null or empty, this column will + not be used for filtering. + + + + + 列宽 + + + + + 获取或设置此列单元格的内容是否应自动换行 + + 如果此列使用自定义IRenender(即，不是从BaseRenender派生的)，则该呈现器负责实现自动换行。 + + + + For a given group value, return the string that should be used as the groups title. + + The group key that is being converted to a title + string + + + + Get the checkedness of the given object for this column + + The row object that is being displayed + The checkedness of the object + + + + Put the checkedness of the given object for this column + + The row object that is being displayed + + The checkedness of the object + + + + For a given row object, extract the value indicated by the AspectName property of this column. + + The row object that is being displayed + An object, which is the aspect named by AspectName + + + + For a given row object, return the object that is the key of the group that this row belongs to. + + The row object that is being displayed + Group key object + + + + For a given row object, return the image selector of the image that should displayed in this column. + + The row object that is being displayed + int or string or Image. int or string will be used as index into image list. null or -1 means no image + + + + Return the image that represents the check box for the given model + + + + + + + For a given row object, return the strings that will be searched when trying to filter by string. + + + This will normally be the simple GetStringValue result, but if this column is non-textual (e.g. image) + you might want to install a SearchValueGetter delegate which can return something that could be used + for text filtering. + + + The array of texts to be searched. If this returns null, search will not match that object. + + + + For a given row object, return the string representation of the value shown in this column. + + + For aspects that are string (e.g. aPerson.Name), the aspect and its string representation are the same. + For non-strings (e.g. aPerson.DateOfBirth), the string representation is very different. + + + + + + + For a given row object, return the object that is to be displayed in this column. + + The row object that is being displayed + An object, which is the aspect to be displayed + + + + Update the given model object with the given value using the column's + AspectName. + + The model object to be updated + The value to be put into the model + + + + Update the given model object with the given value + + The model object to be updated + The value to be put into the model + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Decide the clustering strategy that will be used for this column + + + + + + Gets or sets the type of data shown in this column. + + If this is not set, it will try to get the type + by looking through the rows of the listview. + + + + This event is triggered when the visibility of this column changes. + + + + + Tell the world when visibility of a column changes. + + + + + Create groupies + This is an untyped version to help with Generator and OLVColumn attributes + + + + + + + Create groupies + + + + + + + + Create groupies + + + + + + + + + Create groupies + + + + + + + + + + Create groupies. + Install delegates that will group the columns aspects into progressive partitions. + If an aspect is less than value[n], it will be grouped with description[n]. + If an aspect has a value greater than the last element in "values", it will be grouped + with the last element in "descriptions". + + Array of values. Values must be able to be + compared to the aspect (using IComparable) + The description for the matching value. The last element is the default description. + If there are n values, there must be n+1 descriptions. + + this.salaryColumn.MakeGroupies( + new UInt32[] { 20000, 100000 }, + new string[] { "Lowly worker", "Middle management", "Rarified elevation"}); + + + + + + + + + Create groupies based on exact value matches. + + + Install delegates that will group rows into partitions based on equality of this columns aspects. + If an aspect is equal to value[n], it will be grouped with description[n]. + If an aspect is not equal to any value, it will be grouped with "[other]". + + Array of values. Values must be able to be + equated to the aspect + The description for the matching value. + + this.marriedColumn.MakeEqualGroupies( + new MaritalStatus[] { MaritalStatus.Single, MaritalStatus.Married, MaritalStatus.Divorced, MaritalStatus.Partnered }, + new string[] { "Looking", "Content", "Looking again", "Mostly content" }); + + + + + + + + + An adorment is the common base for overlays and decorations. + + + + + Gets or sets the corner of the adornment that will be positioned at the reference corner + + + + + Gets or sets location within the reference rectange where the adornment will be drawn + + This is a simplied interface to ReferenceCorner and AdornmentCorner + + + + Gets or sets the offset by which the position of the adornment will be adjusted + + + + + Gets or sets the point of the reference rectangle to which the adornment will be aligned. + + + + + Gets or sets the degree of rotation by which the adornment will be transformed. + The centre of rotation will be the center point of the adornment. + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + Calculate the location of rectangle of the given size, + so that it's indicated corner would be at the given point. + + The point + + Which corner will be positioned at the reference point + + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.TopLeft) -> Point(50, 100) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.MiddleCenter) -> Point(45, 90) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.BottomRight) -> Point(40, 80) + + + + Calculate a rectangle that has the given size which is positioned so that + its alignment point is at the reference location of the given rect. + + + + + + + + Create a rectangle of the given size which is positioned so that + its indicated corner is at the indicated corner of the reference rect. + + + + + + + + + Creates a rectangle so that its bottom left is at the centre of the reference: + corner=BottomLeft, referenceCorner=MiddleCenter + This is a powerful concept that takes some getting used to, but is + very neat once you understand it. + + + + + Return the point at the indicated corner of the given rectangle (it doesn't + have to be a corner, but a named location) + + The reference rectangle + Which point of the rectangle should be returned? + A point + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.TopLeft) -> Point(0, 0) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.MiddleCenter) -> Point(25, 50) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.BottomRight) -> Point(50, 100) + + + + Given the item and the subitem, calculate its bounds. + + + + + + + + Apply any specified rotation to the Graphic content. + + The Graphics to be transformed + The rotation will be around the centre of this rect + + + + Reverse the rotation created by ApplyRotation() + + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Gets or sets the image that will be drawn + + + + + Gets or sets if the image will be shrunk to fit with its horizontal bounds + + + + + Draw the image in its specified location + + The Graphics used for drawing + The bounds of the rendering + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How big should the image be? + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location, scaled so that it is not wider + than the given rectangle. Height is scaled proportional to the width. + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Utility to draw a bitmap transparenly. + + + + + + + + + An adornment that will draw text + + + + + Gets or sets the background color of the text + Set this to Color.Empty to not draw a background + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the border around the billboard. + Set this to Color.Empty to remove the border + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the width of the border around the text + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the font that will be used to draw the text + + + + + Gets the font that will be used to draw the text or a reasonable default + + + + + Does this text have a background? + + + + + Does this overlay have a border? + + + + + Gets or sets the maximum width of the text. Text longer than this will wrap. + 0 means no maximum. + + + + + Gets or sets the formatting that should be used on the text + + + + + Gets or sets the text that will be drawn + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the text + + + + + Gets or sets whether the text will wrap when it exceeds its bounds + + + + + Draw our text with our stored configuration in relation to the given + reference rectangle + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + + + + Draw the given text with our stored configuration + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + The text to draw + How opaque should be text be + + + + Draw the text with a border + + The Graphics used for drawing + The bounds within which the text should be drawn + The text to draw + How opaque should be text be + + + + Return the rectangle that will be the precise bounds of the displayed text + + + + + The bounds of the text + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectagle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + A decoration is an overlay that draws itself in relation to a given row or cell. + Decorations scroll when the listview scrolls. + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + An AbstractDecoration is a safe do-nothing implementation of the IDecoration interface + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + Gets the bounds of the decorations row + + + + + Get the bounds of the decorations cell + + + + + Draw the decoration + + + + + + + + This decoration draws a slight tint over a column of the + owning listview. If no column is explicitly set, the selected + column in the listview will be used. + The selected column is normally the sort column, but does not have to be. + + + + + Create a TintedColumnDecoration + + + + + Create a TintedColumnDecoration + + + + + + Gets or sets the column that will be tinted + + + + + Gets or sets the color that will be 'tinted' over the selected column + + + + + Draw a slight colouring over our tinted column + + + This overlay only works when: + - the list is in Details view + - there is at least one row + - there is a selected column (or a specified tint column) + + + + + + + + This decoration draws an optionally filled border around a rectangle. + Subclasses must override CalculateBounds(). + + + + + Create a BorderDecoration + + + + + Create a BorderDecoration + + The pen used to draw the border + + + + Create a BorderDecoration + + The pen used to draw the border + The brush used to fill the rectangle + + + + Gets or sets the pen that will be used to draw the border + + + + + Gets or sets the padding that will be added to the bounds of the item + before drawing the border and fill. + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the brush that will be used to fill the border + + This value is ignored when using gradient brush + + + + Gets or sets the color that will be used as the start of a gradient fill. + + This and FillGradientTo must be given value to show a gradient + + + + Gets or sets the color that will be used as the end of a gradient fill. + + This and FillGradientFrom must be given value to show a gradient + + + + Gets or sets the fill mode that will be used for the gradient. + + + + + Draw a filled border + + + + + + + + Subclasses should override this to say where the border should be drawn + + + + + + Do the actual work of drawing the filled border + + + + + + + Create a GraphicsPath that represents a round cornered rectangle. + + + If this is 0 or less, the rectangle will not be rounded. + + + + + Instances of this class draw a border around the decorated row + + + + + Gets or sets the index of the left most column to be used for the border + + + + + Gets or sets the index of the right most column to be used for the border + + + + + Calculate the boundaries of the border + + + + + + Instances of this class draw a border around the decorated subitem. + + + + + Calculate the boundaries of the border + + + + + + This decoration puts a border around the cell being edited and + optionally "lightboxes" the cell (makes the rest of the control dark). + + + + + Create a EditingCellBorderDecoration + + + + + Create a EditingCellBorderDecoration + + Should the decoration use a lighbox display style? + + + + Gets or set whether the decoration should make the rest of + the control dark when a cell is being edited + + If this is true, FillBrush is used to overpaint + the control. + + + + Draw the decoration + + + + + + + + This decoration causes everything *except* the row under the mouse to be overpainted + with a tint, making the row under the mouse stand out in comparison. + The darker and more opaque the fill color, the more obvious the + decorated row becomes. + + + + + Create a LightBoxDecoration + + + + + Draw a tint over everything in the ObjectListView except the + row under the mouse. + + + + + + + + Instances of this class put an Image over the row/cell that it is decorating + + + + + Create an image decoration + + + + + Create an image decoration + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Instances of this class draw some text over the row/cell that they are decorating + + + + + Create a TextDecoration + + + + + Create a TextDecoration + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + The interface for an object which can draw itself over the top of + an ObjectListView. + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + An interface for an overlay that supports variable levels of transparency + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + A null implementation of the IOverlay interface + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + How transparent should this overlay be? + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Create an ImageOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + An overlay that will draw text over the top of the ObjectListView + + + + + Create a TextOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Gets or sets whether the border will be drawn with rounded corners + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + A Billboard overlay is a TextOverlay positioned at an absolute point + + + + + Create a BillboardOverlay + + + + + Gets or sets where should the top left of the billboard be placed + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Renderers are the mechanism used for owner drawing cells. As such, they can also handle + hit detection and positioning of cell editing rectangles. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + Renderers that implement this interface will have the filter property updated, + each time the filter on the ObjectListView is updated. + + + + + + + + + + An AbstractRenderer is a do-nothing implementation of the IRenderer interface. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + This class provides compatibility for v1 RendererDelegates + + + + + The renderer delegate that this renderer wraps + + + + + A BaseRenderer provides useful base level functionality for any custom renderer. + + + Subclasses will normally override the Render or OptionalRender method, and use the other + methods as helper functions. + + + + + Can the renderer wrap lines that do not fit completely within the cell? + + Wrapping text doesn't work with the GDI renderer. + + + + Gets or sets how many pixels will be left blank around this cell + + + + This setting only takes effect when the control is owner drawn. + + for more details. + + + + + Gets the horiztonal alignment of the column + + + + + Gets or sets how cells drawn by this renderer will be vertically aligned. + + + + If this is not set, the value from the column or control itself will be used. + + + + + + Gets the optional padding that this renderer should apply before drawing. + This property considers all possible sources of padding + + + + + Gets the vertical cell alignment that should govern the rendering. + This property considers all possible sources. + + + + + Gets or sets the image list from which keyed images will be fetched + + + + + When rendering multiple images, how many pixels should be between each image? + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Get or set the aspect of the model object that this renderer should draw + + + + + What are the bounds of the cell that is being drawn? + + + + + Get or set the OLVColumn that this renderer will draw + + + + + Get/set the event that caused this renderer to be called + + + + + Get/set the event that caused this renderer to be called + + + + + Gets or sets the font to be used for text in this cell + + + + + Gets the image list from which keyed images will be fetched + + + + + Should this renderer fill in the background before drawing? + + + + + Cache whether or not our item is selected + + + + + Is this renderer being used on a printer context? + + + + + Get or set the listitem that this renderer will be drawing + + + + + Get/set the listview for which the drawing is to be done + + + + + Get the specialized OLVSubItem that this renderer is drawing + + This returns null for column 0. + + + + Get or set the model object that this renderer should draw + + + + + Get or set the list subitem that this renderer will be drawing + + + + + The brush that will be used to paint the text + + + + + Will this renderer use the custom images from the parent ObjectListView + to draw the checkbox images. + + + + If this is true, the renderer will use the images from the + StateImageList to represent checkboxes. 0 - unchecked, 1 - checked, 2 - indeterminate. + + If this is false (the default), then the renderer will use .NET's standard + CheckBoxRenderer. + + + + + Align the second rectangle with the first rectangle, + according to the alignment of the column + + The cell's bounds + The rectangle to be aligned within the bounds + An aligned rectangle + + + + Calculate the left edge of the rectangle that aligns the outer rectangle with the inner one + according to this renderer's horizontal alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with the inner rectangle + according to this renders vertical alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with a rectangle of the given height + according to this renderer's vertical alignment + + + + + + + + Calculate the space that our rendering will occupy and then align that space + with the given rectangle, according to the Column alignment + + + Pre-padded bounds of the cell + + + + + Calculate the size of the content of this cell. + + + Pre-padded bounds of the cell + The width and height of the content + + + + Calculate the bounds of a checkbox given the (pre-padded) cell bounds + + + Pre-padded cell bounds + + + + + How much space will the check box for this cell occupy? + + Only column 0 can have check boxes. Sub item checkboxes are + treated as images + + + + + + How much space will the check box for this row occupy? + If the list doesn't have checkboxes, or this isn't the primary column, + this returns an empty size. + + + + + + + How much horizontal space will the image of this cell occupy? + + + + + + + + How much vertical space will the image of this cell occupy? + + + + + + + + How much space will the image of this cell occupy? + + + + + + + + How much horizontal space will the text of this cell occupy? + + + + + + + + + How much space will the text of this cell occupy? + + + + + + + + + Return the Color that is the background color for this item's cell + + The background color of the subitem + + + + Return the color of the background color when the item is selected + + The background color of the subitem + + + + Return the color to be used for text in this cell + + The text color of the subitem + + + + Return the color of the foreground color when the item is selected + + The foreground color of the subitem + + + + Return the image that should be drawn against this subitem + + An Image or null if no image should be drawn. + + + + Return the actual image that should be drawn when keyed by the given image selector. + An image selector can be: + an int, giving the index into the image list + a string, giving the image key into the image list + an Image, being the image itself + + + The value that indicates the image to be used + An Image or null + + + + + + + + Return the string that should be drawn within this + + + + + + Return the Color that is the background color for this item's text + + The background color of the subitem's text + + + + Render the whole item in a non-details view. + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Render one cell + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Calculate which part of this cell was hit + + + + + + + + Calculate the edit rectangle + + + + + + + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method. + The graphics context that should be used for drawing + The bounds of the subitem cell + Returns whether the rendering has already taken place. + If this returns false, the default processing will take over. + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method if they never want + to fall back on the default processing + The graphics context that should be used for drawing + The bounds of the subitem cell + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw the standard "[checkbox] [image] [text]" cell after the state properties have been initialized. + + + + + + + Change the bounds of the given rectangle to take any cell padding into account + + + + + + + Perform normal hit testing relative to the given aligned content bounds + + + + + + + + + + This method calculates the bounds of the text within a standard layout + (i.e. optional checkbox, optional image, text) + + This method only works correctly if the state of the renderer + has been fully initialized (see BaseRenderer.GetEditRectangle) + + + + + + + + Apply any padding to the given bounds, and then align a rectangle of the given + size within that padded area. + + + + + + + + + Draw the given image aligned horizontally within the column. + + + Over tall images are scaled to fit. Over-wide images are + truncated. This is by design! + + Graphics context to use for drawing + Bounds of the cell + The image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Pre-padded bounds of the cell + + + + Fill in the background of this cell + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the primary check box of this row (checkboxes in other sub items use a different method) + + Graphics context to use for drawing + The pre-aligned and padded target rectangle + + + + Calculate the CheckBoxState we need to correctly draw the given state + + + + + + + Should this checkbox be drawn as disabled? + + + + + Is the current item hot (i.e. under the mouse)? + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The optional image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the given collection of image selectors + + + + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The string to be drawn + + + + Print the given text in the given rectangle using only GDI routines + + + + + + The native list control uses GDI routines to do its drawing, so using them + here makes the owner drawn mode looks more natural. + This method doesn't honour the CanWrap setting on the renderer. All + text is single line + + + + + Gets the cell's vertical alignment as a TextFormatFlag + + + + + + Gets the StringFormat needed when drawing text using GDI+ + + + + + Print the given text in the given rectangle using normal GDI+ .NET methods + + Printing to a printer dc has to be done using this method. + + + + This renderer highlights substrings that match a given text filter. + + + + + Create a HighlightTextRenderer + + + + + Create a HighlightTextRenderer + + + + + + Create a HighlightTextRenderer + + + + + + Gets or set how rounded will be the corners of the text match frame + + + + + Gets or set the brush will be used to paint behind the matched substrings. + Set this to null to not fill the frame. + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Gets or set the pen will be used to frame the matched substrings. + Set this to null to not draw a frame. + + + + + Gets or sets whether the frame around a text match will have rounded corners + + + + + Gets or set the text that will be highlighted + + + + + Gets or sets the manner in which substring will be compared. + + + Use this to control if substring matches are case sensitive or insensitive. + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw text using GDI + + + + + + + + Draw the highlighted text using GDI + + + + + + + + Draw an indication around the given frame that shows a text match + + + + + + + + + + Draw the text using GDI+ + + + + + + + + Draw the highlighted text using GDI+ + + + + + + + + Gets whether the renderer should actually draw highlighting + + + + + Return a GraphicPath that is a round cornered rectangle + + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + + + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + This class maps a data value to an image that should be drawn for that value. + + It is useful for drawing data that is represented as an enum or boolean. + + + + Return a renderer that draw boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + A Renderer + + + + Return a renderer that draw tristate boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + Draw this when our data value is null + A Renderer + + + + Make a new empty renderer + + + + + Make a new renderer that will show the given image when the given key is the aspect value + + The data value to be matched + The image to be shown when the key is matched + + + + Make a new renderer that will show the given images when it receives the given keys + + + + + + + + + Build a renderer from the given array of keys and their matching images + + An array of key/image pairs + + + + Register the image that should be drawn when our Aspect has the data value. + + Value that the Aspect must match + An ImageSelector -- an int, string or image + + + + Render our value + + + + + + + Draw a collection of images + + + + + + + + Draw one image + + + + + + + + This renderer draws just a checkbox to match the check state of our model object. + + + + + Draw our cell + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + Handle the HitTest request + + + + + + + + + Render an image that comes from our data source. + + The image can be sourced from: + + a byte-array (normally when the image to be shown is + stored as a value in a database) + an int, which is treated as an index into the image list + a string, which is treated first as a file name, and failing that as an index into the image list + an ICollection of ints or strings, which will be drawn as consecutive images + + If an image is an animated GIF, it's state is stored in the SubItem object. + By default, the image renderer does not render animations (it begins life with animations paused). + To enable animations, you must call Unpause(). + In the current implementation (2009-09), each column showing animated gifs must have a + different instance of ImageRenderer assigned to it. You cannot share the same instance of + an image renderer between two animated gif columns. If you do, only the last column will be + animated. + + + + + Make an empty image renderer + + + + + Make an empty image renderer that begins life ready for animations + + + + + Finalizer + + + + + Should the animations in this renderer be paused? + + + + + Gets a timer that can be used to trigger redraws on animations + + + + + Pause any animations + + + + + Unpause any animations + + + + + Draw our image + + + + + + + Translate our Aspect into an image. + + The strategy is: + If its a byte array, we treat it as an in-memory image + If it's an int, we use that as an index into our image list + If it's a string, we try to load a file by that name. If we can't, + we use the string as an index into our image list. + + An image + + + + This is the method that is invoked by the timer. It basically switches control to the listview thread. + + not used + + + + This is the OnTimer callback, but invoked in the same thread as the creator of the ListView. + This method can use all of ListViews methods without creating a CrossThread exception. + + + + + Instances of this class kept track of the animation state of a single image. + + + + + Is the given image an animation + + The image to be tested + Is the image an animation? + + + + Create an AnimationState in a quiet state + + + + + Create an animation state for the given image, which may or may not + be an animation + + The image to be rendered + + + + Does this state represent a valid animation + + + + + Advance our images current frame and calculate when it will expire + + + + + Render our Aspect as a progress bar + + + + + Make a BarRenderer + + + + + Make a BarRenderer for the given range of data values + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + 此栏是否应以系统样式绘制？ + + + + + 将从我们的单元格边框开始绘制多少像素的条形图 + + + + + 在绘制进度条之前，将使用什么颜色填充控件内部？ + + + + + 进度条边框颜色 + + + + + 进度条的边框像素宽 + + + + + 进度条的“填充”部分应该是什么颜色？ + + 仅当GradientStartColor为Color.Empty时才使用此选项 + + + + 进度条中是否显示文本百分比进度显示 + + + + + + 使用渐变以此颜色开始填充进度条 + + + + + 使用渐变填充以此颜色结尾的进度条 + + + + + 使用渐变以此颜色开始填充渐满进度条 + + + + + 使用渐变填充以此颜色结尾的渐满进度条 + + + + + 无论列变得多宽，进度条都不会比这个宽。 + + + + + 无论单元格有多高，进度条都不会比这个高 + + + + + 预期的最小数据值。小于此值的值将显示一个空条。 + + + + + 接近满时的值,高于该值时，显示不同颜色，小于等于MinimumValue或大于MaximumValue值，则表示未设置该值 + + + + + 范围的最大值。大于此值的值将给出一个完整的条形。 + + + + + The Pen that will draw the frame surrounding this bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the background of the bar + + + + + Draw this progress bar using a gradient + + + + + + + Draw our aspect + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + An ImagesRenderer draws zero or more images depending on the data returned by its Aspect. + + This renderer's Aspect must return a ICollection of ints, strings or Images, + each of which will be drawn horizontally one after the other. + As of v2.1, this functionality has been absorbed into ImageRenderer and this is now an + empty shell, solely for backwards compatibility. + + + + + A MultiImageRenderer draws the same image a number of times based on our data value + + The stars in the Rating column of iTunes is a good example of this type of renderer. + + + + Make a quiet renderer + + + + + Make an image renderer that will draw the indicated image, at most maxImages times. + + + + + + + + + The index of the image that should be drawn + + + + + The name of the image that should be drawn + + + + + The image selector that will give the image to be drawn + + Like all image selectors, this can be an int, string or Image + + + + What is the maximum number of images that this renderer should draw? + + + + + Values less than or equal to this will have 0 images drawn + + + + + Values greater than or equal to this will have MaxNumberImages images drawn + + + + + Draw our data value + + + + + + + A class to render a value that contains a bitwise-OR'ed collection of values. + + + + + Register the given image to the given value + + When this flag is present... + ...draw this image + + + + Draw the flags + + + + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + This renderer draws an image, a single line title, and then multi-line description + under the title. + + + This class works best with FullRowSelect = true. + It's not designed to work with cell editing -- it will work but will look odd. + + It's not RightToLeft friendly. + + + + + + Create a DescribedTaskRenderer + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Gets or set the font that will be used to draw the title of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the title of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the title of the task or a reasonable default + + + + + Gets or set the font that will be used to draw the description of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the description of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the description of the task or a reasonable default + + + + + Gets or sets the number of pixels that will be left between the image and the text + + + + + 顶部留白像素 + + + + + Gets or sets the number of pixels that will be left between the title and the description + + + + + Gets or sets the name of the aspect of the model object that contains the task description + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Fetch the description from the model class + + + + + + + + + + + + + + + Draw our item + + + + + + + Draw the task + + + + + + + + + + Handle the HitTest request + + + + + + + + + This renderer draws a functioning button in its cell + + + + + Gets or sets how each button will be sized + + + + + 获取或设置SizingMode为FixedBounds时按钮的大小 + + If this is not set, the bounds of the cell will be used + + + + 获取或设置SizingMode为TextBounds时单元格周围的额外空间 + + + + + Gets or sets the maximum width that a button can occupy. + -1 means there is no maximum width. + + This is only considered when the SizingMode is TextBounds + + + + Gets or sets the minimum width that a button can occupy. + -1 means there is no minimum width. + + This is only considered when the SizingMode is TextBounds + + + + 获取或设置此列按钮的字体颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的背景颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的内边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮是否画边框(如果有按钮的话) + + + + + Calculate the size of the contents + + + + + + + + Draw the button + + + + + + + What part of the control is under the given point? + + + + + + + + + + What is the state of the button? + + + + + + Is the mouse over the button? + + + + + The common interface supported by all style objects + + + + + Gets or set the font that will be used by this style + + + + + Gets or set the font style + + + + + Gets or sets the ForeColor + + + + + Gets or sets the BackColor + + + + + Basic implementation of IItemStyle + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class specify how should "hot items" (non-selected + rows under the cursor) be renderered. + + + + + Gets or sets the overlay that should be drawn as part of the hot item + + + + + Gets or sets the decoration that should be drawn as part of the hot item + + A decoration is different from an overlay in that an decoration + scrolls with the listview contents, whilst an overlay does not. + + + + This class defines how a cell should be formatted + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class describe how hyperlinks will appear + + + + + Create a HyperlinkStyle + + + + + What sort of formatting should be applied to hyperlinks in their normal state? + + + + + What sort of formatting should be applied to hyperlinks when the mouse is over them? + + + + + What sort of formatting should be applied to hyperlinks after they have been clicked? + + + + + Gets or sets the cursor that should be shown when the mouse is over a hyperlink. + + + + + Instances of this class control one the styling of one particular state + (normal, hot, pressed) of a header control + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Gets or sets the color in which a frame will be drawn around the header for this column + + + + + Gets or sets the width of the frame that will be drawn around the header for this column + + + + + This class defines how a header should be formatted in its various states. + + + + + Create a new HeaderFormatStyle + + + + + What sort of formatting should be applied to a column header when the mouse is over it? + + + + + What sort of formatting should be applied to a column header in its normal state? + + + + + What sort of formatting should be applied to a column header when pressed? + + + + + Set the font for all three states + + + + + + Set the fore color for all three states + + + + + + Set the back color for all three states + + + + + + 正常为选中按钮 + + + + + 获得焦点的按钮 + + + + + 鼠标经过样式 + + + + + 获得焦点并鼠标经过 + + + + + 自定义GDI工具，绘制按钮 + + + + + 绘制圆形按钮（用法同矩形按钮） + + + + + + + + + + 绘制圆角按钮 + + 要绘制的文字 + Graphics 对象 + 要填充的矩形 + + + + + 根据普通矩形得到圆角矩形的路径 + + 原始矩形 + 半径 + 图形路径 + + + + A GlassPanelForm sits transparently over an ObjectListView to show overlays. + + + + + Get the low-level windows flag that will be given to CreateWindow. + + + + + Attach this form to the given ObjectListView + + + + + Made the overlay panel invisible + + + + + Show the overlay panel in its correctly location + + + If the panel is always shown, this method does nothing. + If the panel is being resized, this method also does nothing. + + + + + Detach this glass panel from its previous ObjectListView + + + You should unbind the overlay panel before making any changes to the + widget hierarchy. + + + + + Handle when the form that owns the ObjectListView begins to be resized + + + + + + + Handle when the form that owns the ObjectListView finished to be resized + + + + + + + The owning form has moved. Move the overlay panel too. + + + + + + + The owning form is resizing. Hide our overlay panel until the resizing stops + + + + + + + Handle when the bound OLV changes its location. The overlay panel must + be moved too, IFF it is currently visible. + + + + + + + Handle when the bound OLV changes size. The overlay panel must + resize too, IFF it is currently visible. + + + + + + + Handle when the bound OLV is part of a TabControl and that + TabControl changes tabs. The overlay panel is hidden. The + first time the bound OLV is redrawn, the overlay panel will + be shown again. + + + + + + + Somewhere the parent of the bound OLV has changed. Update + our events. + + + + + + + Handle when the bound OLV changes its visibility. + The overlay panel should match the OLV's visibility. + + + + + + + Class used to capture window messages for the header of the list view + control. + + + + + Create a header control for the given ObjectListView. + + + + + + Return the index of the column under the current cursor position, + or -1 if the cursor is not over a column + + Index of the column under the cursor, or -1 + + + + 返回此控件的Windows句柄 + + + 当ObjectListView被初始化为UserControl的一部分时，GetHeaderControl()方法返回0，直到UserControl完全初始化。 + 因此，构造函数中的AssignHandle()调用不起作用。因此，我们覆盖了Handle属性，以便值始终为当前值。 + + + + + Gets or sets a style that should be applied to the font of the + column's header text when the mouse is over that column + + THIS IS EXPERIMENTAL. USE AT OWN RISK. August 2009 + + + + 如果光标位于其复选框上，则获取光标下列的索引 + + + + + Gets the client rectangle for the header + + + + + 如果给定坐标点在给定列的复选框上方，则返回TRUE。 + + + + + + + + 获取光标是否位于“锁定”的分隔线上，即用户无法拖动的分隔线。 + + + + + 获取或设置此标头所属的列表视图 + + + + + 获取标题的最大高度。-1表示没有最大值。 + + + + + 获取标题的最小高度。-1表示没有最低要求。 + + + + + Get or set the ToolTip that shows tips for the header + + + + + 获取或设置当列标题中的文本太长而无法放入列中时，是否应对其进行自动换行 + + + + + Calculate how height the header needs to be + + Height in pixels + + + + Get the bounds of the checkbox against the given column + + + + + + + Should the given column be drawn with a checkbox against it? + + + + + + + Should the given column show a sort indicator? + + + + + + + Should the given column be drawn with a filter indicator against it? + + + + + + + Should the given column show a non-themed sort indicator? + + + + + + + Return the bounds of the item with the given index + + + + + + + Return the bounds within which the given column will be drawn + + + + + + + Force the header to redraw by invalidating it + + + + + Force the header to redraw a single column by invalidating it + + + + + Create a native tool tip control for this listview + + + + + Override the basic message pump + + + + + + Handle the LButtonDown windows message + + + + + + + Handle the LButtonUp windows message + + + + + + + Handle the SetCursor windows message + + + + + + + Handle the MouseMove windows message + + + + + + + Handle the MouseLeave windows message + + + + + + + Handle the Notify windows message + + + + + + + Handle the CustomDraw windows message + + + + + + + The message divides a ListView's space between the header and the rows of the listview. + The WINDOWPOS structure controls the headers bounds, the RECT controls the listview bounds. + + + + + + + Handle when the underlying header control is destroyed + + + + + + + Does this header need to be custom drawn? + + Word wrapping and colored text require custom drawning. Funnily enough, we + can change the font natively. + + + + Draw one cell of the header + + + + + + + + Draw a background for the header, without using Themes. + + + + + + + + + + + Draw a more-or-less pure themed header background. + + + + + + + + + + Draw a sort indicator using themes + + + + + + + Draw a sort indicator without using themes + + + + + + + + Draw an indication that this column has a filter applied to it + + + + + + + + Draw the header's image and text + + + + + + + + + Return the header format that should be used for the given column + + + + + + + What style should be applied to the header? + + + + + + + + + What font should be used to draw the header text? + + + + + + + + + What flags will be used when drawing text + + + + + Perform a HitTest for the header control + + + + Null if the given point isn't over the header + + + + Instances of this class put a CheckedListBox into a tool strip menu item. + + + + + Create a ToolStripCheckedListBox + + + + + Gets the control embedded in the menu + + + + + Gets the items shown in the checkedlistbox + + + + + Gets or sets whether an item should be checked when it is clicked + + + + + Gets a collection of the checked items + + + + + Add a possibly checked item to the control + + + + + + + Add an item with the given state to the control + + + + + + + Gets the checkedness of the i'th item + + + + + + + Set the checkedness of the i'th item + + + + + + + Check all the items in the control + + + + + Unchecked all the items in the control + + + + + Listen for events on the underlying control + + + + + + Stop listening for events on the underlying control + + + + + + Tell the world that an item was checked + + + + + Trigger the ItemCheck event + + + + + + + A limited wrapper around a Windows tooltip window. + + + + + These are the standard icons that a tooltip can display. + + + + + No icon + + + + + Info + + + + + Warning + + + + + Error + + + + + Large info (Vista and later only) + + + + + Large warning (Vista and later only) + + + + + Large error (Vista and later only) + + + + + + + + + + + + + + + + + + + + + + + + + Get or set if the style of the tooltip control + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set the background color of the tooltip + + + + + Get or set the color of the text and border on the tooltip. + + + + + Get or set the title that will be shown on the tooltip. + + + + + Get or set the icon that will be shown on the tooltip. + + + + + Gets or sets the font that will be used to draw this control. + is still. + + Setting this to null reverts to the default font. + + + + Gets or sets how many milliseconds the tooltip will remain visible while the mouse + is still. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown again. + + + + + Create the underlying control. + + The parent of the tooltip + This does nothing if the control has already been created + + + + Take a copy of the current settings and restore them when the + tooltip is poppped. + + + This call cannot be nested. Subsequent calls to this method will be ignored + until PopSettings() is called. + + + + + Restore the settings of the tooltip as they were when PushSettings() + was last called. + + + + + Add the given window to those for whom this tooltip will show tips + + The window + + + + Hide any currently visible tooltip + + + + + + Remove the given window from those managed by this tooltip + + + + + + Set the maximum width of a tooltip string. + + + + + Set the maximum width of a tooltip string. + + Setting this ensures that line breaks in the tooltip are honoured. + + + + Make a TOOLINFO structure for the given window + + + A filled in TOOLINFO + + + + Handle a WmNotify message + + The msg + True if the message has been handled + + + + Handle a get display info message + + The msg + True if the message has been handled + + + + Handle a TTN_LINKCLICK message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_POP message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_SHOW message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a reflected notify message + + The msg + True if the message has been handled + + + + Mess with the basic message pump of the tooltip + + + + + + Tell the world that a tooltip is about to show + + + + + Tell the world that a tooltip is about to disappear + + + + + + + + + + + + + + + + + This form is an example of how an application could allows the user to select which columns + an ObjectListView will display, as well as select which order the columns are displayed in. + + + In Tile view, ColumnHeader.DisplayIndex does nothing. To reorder the columns you have + to change the order of objects in the Columns property. + Remember that the first column is special! + It has to remain the first column. + + + + + Make a new ColumnSelectionForm + + + + + Open this form so it will edit the columns that are available in the listview's current view + + The ObjectListView whose columns are to be altered + + + + Open this form so it will edit the columns that are available in the given listview + when the listview is showing the given type of view. + + The ObjectListView whose columns are to be altered + The view that is to be altered. Must be View.Details or View.Tile + + + + Initialize the form to show the columns of the given view + + + + + + + The user has pressed OK. Do what's requied. + + + + + + + Enable the controls on the dialog to match the current state + + + + + A Comparer that will sort a list of columns so that visible ones come before hidden ones, + and that are ordered by their display order. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + An object that implements the IGenerator interface provides the ability + to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + The Generator class provides methods to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + For a given type, a Generator can create columns to match the public properties + of that type. The generator can consider all public properties or only those public properties marked with + [OLVColumn] attribute. + + + + + Gets or sets the actual generator used by the static convinence methods. + + If you subclass the standard generator or implement IGenerator yourself, + you should install an instance of your subclass/implementation here. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the public properties of the given type + that have a OLVColumn attribute. + + + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Replace all the columns in the given listview with the given list of columns. + + + + + + + Post process columns after creating them and adding them to the AllColumns collection. + + + + + + Create a column from the given PropertyInfo and OLVColumn attribute + + + + + + + + Make a column from the given PropertyInfo + + + + + + + Make a column from the given PropertyDescriptor + + + + + + + Create a column with all the given information + + + + + + + + + + + Create a column. + + + + + + + + + Convert a property name to a displayable title. + + + + + + + Configure the given column to show a checkbox if appropriate + + + + + + + If this given type has an property marked with [OLVChildren], make delegates that will + traverse that property as the children of an instance of the model + + + + + + + Generate CanExpand and ChildrenGetter delegates from the given property. + + + + + + + An OLVExporter converts a collection of rows from an ObjectListView + into a variety of textual formats. + + + + + What format will be used for exporting + + + + + Tab separated values, according to http://www.iana.org/assignments/media-types/text/tab-separated-values + + + + + Alias for TabSeparated + + + + + Comma separated values, according to http://www.ietf.org/rfc/rfc4180.txt + + + + + HTML table, according to me + + + + + Create an empty exporter + + + + + Create an exporter that will export all the rows of the given ObjectListView + + + + + + Create an exporter that will export all the given rows from the given ObjectListView + + + + + + + Gets or sets whether hidden columns will also be included in the textual + representation. If this is false (the default), only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. Default is true. + + + + + Gets the ObjectListView that is being used as the source of the data + to be exported + + + + + Gets the model objects that are to be placed in the data object + + + + + Export the nominated rows from the nominated ObjectListView. + Returns the result in the expected format. + + + + This will perform only one conversion, even if called multiple times with different formats. + + + + Convert + + + + + Encode a string such that it can be used as a value in a CSV file. + This basically means replacing any quote mark with two quote marks, + and enclosing the whole string in quotes. + + + + + + + HTML-encodes a string and returns the encoded string. + + The text string to encode. + The HTML-encoded text. + Taken from http://www.west-wind.com/weblog/posts/2009/Feb/05/Html-and-Uri-String-Encoding-without-SystemWeb + + + + A TypedObjectListView is a type-safe wrapper around an ObjectListView. + + + VCS does not support generics on controls. It can be faked to some degree, but it + cannot be completely overcome. In our case in particular, there is no way to create + the custom OLVColumn's that we need to truly be generic. So this wrapper is an + experiment in providing some type-safe access in a way that is useful and available today. + A TypedObjectListView is not more efficient than a normal ObjectListView. + Underneath, the same name of casts are performed. But it is easier to use since you + do not have to write the casts yourself. + + + The class of model object that the list will manage + + To use a TypedObjectListView, you write code like this: + + TypedObjectListView<Person> tlist = new TypedObjectListView<Person>(this.listView1); + tlist.CheckStateGetter = delegate(Person x) { return x.IsActive; }; + tlist.GetColumn(0).AspectGetter = delegate(Person x) { return x.Name; }; + ... + + To iterate over the selected objects, you can write something elegant like this: + + foreach (Person x in tlist.SelectedObjects) { + x.GrantSalaryIncrease(); + } + + + + + + Create a typed wrapper around the given list. + + The listview to be wrapped + + + + Return the model object that is checked, if only one row is checked. + If zero rows are checked, or more than one row, null is returned. + + + + + Return the list of all the checked model objects + + + + + The ObjectListView that is being wrapped + + + + + Get or set the list of all model objects + + + + + Return the model object that is selected, if only one row is selected. + If zero rows are selected, or more than one row, null is returned. + + + + + The list of model objects that are selected. + + + + + Return a typed wrapper around the column at the given index + + The index of the column + A typed column or null + + + + Return a typed wrapper around the column with the given name + + The name of the column + A typed column or null + + + + Return the model object at the given index + + The index of the model object + The model object or null + + + + CheckStateGetter + + + + + + + Gets or sets the check state getter + + + + + BooleanCheckStateGetter + + + + + + + Gets or sets the boolean check state getter + + + + + CheckStatePutter + + + + + + + + Gets or sets the check state putter delegate + + + + + BooleanCheckStatePutter + + + + + + + + Gets or sets the boolean check state putter + + + + + ToolTipGetter + + + + + + + + Gets or sets the cell tooltip getter + + + + + Gets or sets the header tool tip getter + + + + + This method will generate AspectGetters for any column that has an AspectName. + + + + + A type-safe wrapper around an OLVColumn + + + + + + Creates a TypedColumn + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Generate an aspect getter that does the same thing as the AspectName, + except without using reflection. + + + + If you have an AspectName of "Owner.Address.Postcode", this will generate + the equivilent of: this.AspectGetter = delegate (object x) { + return x.Owner.Address.Postcode; + } + + + + If AspectName is empty, this method will do nothing, otherwise + this will replace any existing AspectGetter. + + + + + + Generates an aspect getter method dynamically. The method will execute + the given dotted chain of selectors against a model object given at runtime. + + The type of model object to be passed to the generated method + A dotted chain of selectors. Each selector can be the name of a + field, property or parameter-less method. + A typed delegate + + + + This method generates the actual IL for the method. + + + + + + + + A virtual object list view operates in virtual mode, that is, it only gets model objects for + a row when it is needed. This gives it the ability to handle very large numbers of rows with + minimal resources. + + A listview is not a great user interface for a large number of items. But if you've + ever wanted to have a list with 10 million items, go ahead, knock yourself out. + Virtual lists can never iterate their contents. That would defeat the whole purpose. + Animated GIFs should not be used in virtual lists. Animated GIFs require some state + information to be stored for each animation, but virtual lists specifically do not keep any state information. + In any case, you really do not want to keep state information for 10 million animations! + + Although it isn't documented, .NET virtual lists cannot have checkboxes. This class codes around this limitation, + but you must use the functions provided by ObjectListView: CheckedObjects, CheckObject(), UncheckObject() and their friends. + If you use the normal check box properties (CheckedItems or CheckedIndicies), they will throw an exception, since the + list is in virtual mode, and .NET "knows" it can't handle checkboxes in virtual mode. + + Due to the limits of the underlying Windows control, virtual lists do not trigger ItemCheck/ItemChecked events. + Use a CheckStatePutter instead. + To enable grouping, you must provide an implmentation of IVirtualGroups interface, via the GroupingStrategy property. + Similarly, to enable filtering on the list, your VirtualListDataSource must also implement the IFilterableDataSource interface. + + + + + Create a VirtualObjectListView + + + + + Gets whether or not this listview is capabale of showing groups + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + This class optimizes the management of CheckStates so that it will work efficiently even on + large lists of item. However, those optimizations are impossible if you install a CheckStateGetter. + With a CheckStateGetter installed, the performance of this method is O(n) where n is the size + of the list. This could be painfully slow. + + + + + Gets or sets whether or not an object will be included in the CheckedObjects + collection, even if it is not present in the control at the moment + + + This property is an implementation detail and should not be altered. + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Gets or sets the strategy that will be used to create groups + + + This must be provided for a virtual list to show groups. + + + + + Gets whether or not the current list is filtering its contents + + + This is only possible if our underlying data source supports filtering. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + Setting this property preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code -- performance is O(n) where n is the number of selected rows. + This method is not thread safe. + The property DOES work on virtual lists, but if you try to iterate through a list + of 10 million objects, it may take some time :) + + + + + This delegate is used to fetch a rowObject, given it's index within the list + + Only use this property if you are not using a VirtualListDataSource. + + + + Should this list show its items in groups? + + + + + Get/set the data source that is behind this virtual list + + Setting this will cause the list to redraw. + + + + Gets or sets the number of rows in this virtual list. + + + There is an annoying feature/bug in the .NET ListView class. + When you change the VirtualListSize property, it always scrolls so + that the focused item is the top item. This is annoying since it makes + the virtual list seem to flicker as the control scrolls to show the focused + item and then scrolls back to where ObjectListView wants it to be. + + + + + Return the number of items in the list + + the number of items in the list + + + + Return the model object at the given index + + Index of the model object to be returned + A model object + + + + Find the given model object within the listview and return its index + + The model object to be found + The index of the object. -1 means the object was not present + + + + Return the OLVListItem that displays the given model object + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Add the given collection of model objects to this control. + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the end of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Scroll the listview so that the given group is at the top. + + The index of the group to be revealed + + If the group is already visible, the list will still be scrolled to move + the group to the top, if that is possible. + + This only works when the list is showing groups (obviously). + + + + + Inserts the given collection of model objects to this control at hte given location + + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the given position of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Update the rows that are showing the given objects + + This method does not resort the items. + + + + Update the rows that are selected + + This method does not resort or regroup the view. + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + Due to problems in the underlying ListView, if you remove all the objects from + the control using this method and the list scroll vertically when you do so, + then when you subsequenially add more objects to the control, + the vertical scroll bar will become confused and the control will draw one or more + blank lines at the top of the list. + + + + + Select the row that is displaying the given model object. All other rows are deselected. + + Model object to select + Should the object be focused as well? + + + + Select the rows that is displaying any of the given model object. All other rows are deselected. + + A collection of model objects + This method has O(n) performance where n is the number of model objects passed. + Do not use this to select all the rows in the list -- use SelectAll() for that. + + + + Set the collection of objects that this control will show. + + + Should the state of the list be preserved as far as is possible. + + + + Get the checkedness of an object from the model. Returning null means the + model does know and the value from the control will be used. + + + + + + + Rebuild the list with its current contents. + + + Invalidate any cached information when we rebuild the list. + + + + + Clear any cached info this list may have been using + + + + + Do the work of creating groups for this control + + + + + + Do the plumbing to disable groups on a virtual list + + + + + Do the plumbing to enable groups on a virtual list + + + + + Return the position of the given itemIndex in the list as it currently shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the last item in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + Return the n'th item (0-based) in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the ListViewItem that appears immediately after the given item. + If the given item is null, the first item in the list will be returned. + Return null if the given item is the last item. + + The item that is before the item that is returned, or null + A OLVListItem + + + + Return the ListViewItem that appears immediately before the given item. + If the given item is null, the last item in the list will be returned. + Return null if the given item is the first item. + + The item that is before the item that is returned + A ListViewItem + + + + Make a list of groups that should be shown according to the given parameters + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + + + + On virtual lists, this cannot work. + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Refresh the given item in the list + + The item to refresh + + + + Change the size of the list + + + + + + Take ownership of the 'objects' collection. This separates our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + VirtualObjectListViews always own their collections, so this is a no-op. + + + + + + Change the state of the control to reflect changes in filtering + + + + + Change the size of the virtual list so that it matches its data source + + + + + Handle the CacheVirtualItems event + + + + + + + Handle a RetrieveVirtualItem + + + + + + + Handle the SearchForVirtualList event, which is called when the user types into a virtual list + + + + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 初始化的时候给个alpha值,这样在灰图片的时候可以半透明 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使图片单色化 + + + + + + + + + + + + 自定义 + + + + + 预置 + + + + + 系统 + + + + + 颜色表示法 + + + + + 根据颜色表示字符串获取对应的颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 从文件中获取Image对象 + 这个函数的主要功能是处理一些ico文件 + 一些ico文件的格式可能比较新，直接Image.FormFile，会报内存不足的异常 + + + 是否将文件读入内存操作，如果为false,将直接返回Image.FromFile，在此情况下， + 必须手动释放Image对象，否则文件将一直处于占用状态，如果为true,则在内存中拷贝副本 + + + + + + 将图像转为Icon对象,使用png格式 + + + + + + + 将图像转为Icon对象 + + + + + + + + 返回适应指定容器大小的图像 + 如果图像的尺寸(长或宽)超出了容器范围,将按比例获取图像的缩略图返回,否则直接返回图像 + 此方法最终调用 Image.GetThumbnailImage + 但是注意,在指定的容器尺寸过小时,返回的Image尺寸不可知,是在为了显示16x16的小缩略图是发现了此问题 + 使用 GetScaleImage + + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + + The source image. + The rectangle to fit in to. + Horizontal image aligment in percent. + Vertical image aligment in percent. + New image size. + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + The image will be centered in the fit box. + + The source image. + The rectangle to fit in to. + New image size. + + + + Gets the scaled size of an image required to fit + in to the given size keeping the image aspect ratio. + + The source image. + The size to fit in to. + New image size. + + + + 获取一个圆角矩形 + + + + 角度 + + + + + 获取一个圆角矩形 + + + 角度 + + + + + + + + + + + + + + + + + + + + + + 返回一个表示箭头的Path + 如果开始坐标和结束坐标之间的距离大于箭头的大小，箭头向结束坐标对齐，顶着结束坐标 + + 开始坐标 + 结束坐标（顶点，方向） + 箭头的长短，大小 + 箭头的粗细 + + + + + 在指定的Image上绘制特定标记 + + + + + 文件不存在 + + + + + + 文件不存在 + + + + + + 无法读取文件 + + + + + + + + + + + + + + + + + + + + + 验证失败中显示错误信息时用的标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + 验证控件的输入 + + + + + + + 自定义验证方法 + 在基础验证都通过后，才会调用自定义验证方法（如果有） + + + + + + + + + + 是否支持 Windows Vista 以上的玻璃效果 + + + + + 是否打开了玻璃效果 + + + + + 获取应用程序主窗体 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 这个缓存是全局的 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 所对应的绑定数据类型 + + + + + 是否对 DataBoundType 的子类型有效 + 默认无效 + 如果设置为 true，又同时添加了基类与子类的 codon，则运行时会取到哪个codon不确定 + 通常取先添加的那个 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取授予该组件的许可证密钥 + + + + + 0:未验证 + 1:验证失败 + 2:验证通过 + + + + + 获取组件的实例或类型的许可证（如果已给定上下文并确定拒绝许可证是否引发异常）。 + + + + + + + + + + 强类型资源类，用于查找本地化字符串等。 + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + Returns a System.String that represents the current System.Object. + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + + + + + + Call GetLanguages() to retrieve a list of possible languages that can be used to set this property. + The default value is the default language. + + + + + Gets a list of available languages defined in this assembly. + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Determines which animation to use while showing the pop-up window. + + + + + Determines which animation to use while hiding the pop-up window. + + + + + Determines the duration of the animation. + + + + + Gets or sets a value indicating whether the content should receive the focus after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether the is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets a minimum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets a maximum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows the pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows the pop-up window below the specified area of the specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the sizing grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Types of animation of the pop-up window. + + + + + Uses no animation. + + + + + Animates the window from left to right. This flag can be used with roll or slide animation. + + + + + Animates the window from right to left. This flag can be used with roll or slide animation. + + + + + Animates the window from top to bottom. This flag can be used with roll or slide animation. + + + + + Animates the window from bottom to top. This flag can be used with roll or slide animation. + + + + + Makes the window appear to collapse inward if it is hiding or expand outward if the window is showing. + + + + + Uses a slide animation. + + + + + Uses a fade effect. + + + + + Uses a roll animation. + + + + + Uses a default animation. + + + + + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the class. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Gets or sets a value indicating whether the combo box is displaying its drop-down portion. + + + true if the drop-down portion is displayed; otherwise, false. The default is false. + + + + + Occurs when the drop-down portion of a is shown. + + + + + Shows the drop down. + + + + + Occurs when the drop-down portion of the is no longer visible. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Represents a Windows combo box control which can be used in a popup's content control. + + + + + Initializes a new instance of the PopupControl.ComboBox class. + + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 白色到灰色的垂直渐变 + + + + + + + + + + This method handles the RenderToolStripBorder event. + + + + + + + + + + + + A ToolstripManager rendering class with advanced control features + + + + + Creates a new EasyRender class for modifications + + + + + + + + + + + + + + + + + + + + Gets the manager to edit and change the appearance of the Toolstrip + + + + + Gets the manager to edit and change the appearance of Toolstrip buttons + + + + + Gets the manager to edit and change the appearance of other Toolstrip controls + + + + + Gets the manager to edit and change the appearance of the Panels + + + + + Gets the manager to edit and change the appearance of the Toolstrip split buttons + + + + + Gets the manager to edit and change the appearance of the Status-bar + + + + + Gets or sets whether to smooth the font text on all controls + + + + + Gets or sets the color of the text if the AlterColor is set to true + + + + + Gets or sets whether to override the font-color on all controls + + + + + Creates a GraphicsPath that appreciates an area where things can be drawn + + The rectangular area which will serve as the base + The curve amount of the corners + + + + + Creates a triangle based on the size and bounds sectors + + The area which the triangle is confined to + The size of the triangle + The direction which the triangle is pointing + + + + + Gets a color array based on the state of a normal button + + The button to check the state of + + + + + + Gets a color array based on the state of a split-button + + The button to check the state of + + + + + + Gets a color array based on the state of a menu-item + + The button to check the state of + + + + + + Gets a color array based on the state of a drop-down button + + The button to check the state of + + + + + + Gets a blending property for a specified type of Toolstrip item + + The Toolstrip item + The type of item this is + + + + + Fills a specified boundary with color + + The Graphics object to draw onto + The boundaries to draw the color + The brush to fill the color + + + + Fills a specified boundary with a gradient with specified colors + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + + + + Fills a specified boundary with a gradient with specified colors at a given angle + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Fills a specified boundary with a gradient with specified colors at a given angle and with blending properties + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a set path with a defined brush + + The Graphics object to draw onto + The path to draw along + The brush to fill the color + + + + Draws a set path with specified colors + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + + + + Draws a set path with specified colors at a given angle + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Draws a set path with specified colors at a given angle with blending properties + + The Graphics object to draw onto + The path to draw along + + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Toolstrip background + + The Toolstrip being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Toolstrip split-button + + The Toolstrip split-button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Statusbar background + + The Statusbar being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Menustrip item + + The Menustrip item + The Graphics object to handle + The parent Toolstrip + + + + Covers the button background rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Applies any and all changes made to the Renderer + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Toolstrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IToolstrip class for customization + + The IToolstrip to import the settings from + + + + Disposes of the IToolstrip class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip background gradient from the top + + + + + Gets or sets the color of the Toolstrip background gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip background + If set to null, the Toolstrip will simply draw the gradient + + + + + Gets or sets the angle which the Toolstrip background will be drawn + + + + + Gets or sets the color of the Toolstrip border gradient from the top + + + + + Gets or sets the color of the Toolstrip border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip border + If set to null, the Toolstrip will simply draw the border + + + + + Gets or sets the angle which the Toolstrip border will be drawn + + + + + Gets or sets the curve of the border of the Toolstrip + + + + + Imports the settings from a previous or pre-defined IToolstrip and applies it to the current + + The IToolstrip to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IToolstripControls class for customization + + + + + Disposes of the IToolstripControls class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip seperator on the dark side + + + + + Gets or sets the color of the Toolstrip seperator on the light side + + + + + Gets or sets the height of the Toolstrip seperator control + + + + + Gets or sets the color of the grip dots/line at the top + + + + + Gets or sets the color of the grip shadow + + + + + Gets or sets in what mode the grip will be drawn + + + + + Gets or sets the distance, in pixels, between each grip dot + + + + + Gets or sets the size of the dots or lines for the grip + + + + + Imports the settings from a previous or pre-defined IToolstripControls and applies it to the current + + The IToolstripControls to import the settings from + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IButton and applies it to the current + + The IButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" and "Click" do not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IDropDownButton and applies it to the current + + The IDropDownButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new ISplitButton class for customization + + + + + Disposes of the ISplitButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Gets or sets when to display the drop-down arrow + + + + + Gets or sets the color of the drop-down arrow + + + + + Imports the settings from a previous or pre-defined ISplitButton and applies it to the current + + The ISplitButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IPanel class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient at the top of the content panel + + + + + Gets or sets the color of the gradient at the bottom of the content panel + + + + + Gets or sets whether each panel inherits the shading from the content panel + + + + + Gets or sets the angle which the background gradient is drawn + + + + + Gets or sets the blend of the background + + + + + Gets or sets a mode to render the background in + + + + + + + + + + Creates a new IStatusBar class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient of the background at the top + + + + + Gets or sets the color of the gradient of the background at the bottom + + + + + Gets or sets the blending that will apply to the background + + + + + Gets or sets the angle which the background gradient will be drawn + + + + + Gets or sets the color of the dark border + + + + + Gets or sets the color of the light border + + + + + Gets or sets the color of the grip at the top-most + + + + + Gets or sets the color of the grip at the bottom-most + + + + + Gets or sets the spacing of the grip blocks + + + + + Imports the settings from a previous or pre-defined IStatusBar and applies it to the current + + The IStatusBar to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Menustrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IMenustrip class for customization + + The IMenustrip to import the settings from + + + + Disposes of the IMenustrip class and clears all resources related to it + + + + + Gets or sets the color of the menu-strip border (dark) + + + + + Gets or sets the color of the menu-strip border (light) + + + + + Gets or sets how the background of the menu-strip is inherited + + + + + If inheritence is set to none, the color of the background gradient at the top + + + + + If inheritence is set to none, the color of the background gradient at the bottom + + + + + If inheritence is set to none, the blending option for the background + + + + + Gets or sets the color of the margin gradient at the left + + + + + Gets or sets the color of the margin gradient at the right + + + + + Gets or sets the color of the margin border (displayed to the right) + + + + + Gets or sets the color of the root menu-strip button background when it is selected + + + + + Gets or sets the color of the root menu-strip button border when it is selected + + + + + Gets or sets the color of the seperator dark color + + + + + Gets or sets the color of the seperator light color + + + + + Gets or sets the inset position of the seperator from the left + + + + + Gets the class that handles the look and feel of the menu-strip items + + + + + Imports the settings from a previous or pre-defined IMenustrip and applies it to the current + + The IMenustrip to import the settings from + + + + Sets the blending for the background to it's default + + + + + Defines when to show an arrow + + + + + + + + + + + + + + + + + + + + Defines when to use a blend property + + + + + Use the blend when the object is drawn + + + + + Use the blend when the object is hovered over + + + + + Use the blend when the object is clicked + + + + + Use the blend when the object is checked + + + + + Always use the blend regardless of the state of the object + + + + + Defines a method of drawing a grip on a control + + + + + Draws the grip as a set of dots + + + + + Draws the grip as two lines + + + + + Does not draw the grip at all, but the object remains moveable + + + + + Defines a specific type of button to search by + + + + + + + + + + + + + + + + + + + + + + + + + Defines a method for background or object inheritence + + + + + + + + + + + + + + + Defines a method of rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 主菜单 + + + + + 背景透明的工具条 + + + + + 银白色至白色渐变 + + + + + 白色至银白色渐变 + + + + + + + + + + + + + + + 当前工作区窗体所关联并激活的工具栏 + + + + + 模拟运行时的外观 + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 鼠标滑过 + + + + + 控件的高度根据内容自动调整，忽略外部设置 + + + + + 边框宽度 + + + + + 文本和description文本之间的间距 + + + + + 最大显示的项数 + + + + + + + + + + 是否显示说明字段，此属性不影响弹出面板是否显示 + 弹出面板是否显示由DescriptionMember是否设置决定 + + + + + + + + + + + + + + + 下拉列表的布局模式 + + + + + + + + + + 是否允许空 + + + + + + + + + + 测量当前控件应该的高度 + + + + + + 整个可用的绘图表面 + + + + + 右边按钮的绘图表面 + + + + + 绘制边框 + + + + + + 绘制背景 + + + + + + 绘制文本 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前热点项生改变 + + + + + + + + + + + + + + + + + + + + + 通过外能事件获取用于绘制项的文本 + + + + + + + + + + + + + + + + + + + + + + + + + + 标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + + + + + + + + + + + + + + + + + + 排序箭头开始颜色 + + + + + 排序箭头开始颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 控件的背景画布颜色 + 因为控件的边框和过度色都有依靠改变透明度实现渐变，所以一个白色的底版就非常重要 + 使过度色不受控件本身背景色的影响，光不绘制背景不行，要刷上白色背景 + + + + + 控件背景色 + + + + + + + + + + + + + + + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 该项具有输入焦点 + + + + + 鼠标滑过 + + + + + + + + + + The item is not visible. + + + + + The item is partially visible. + + + + + The item is fully visible. + + + + + 布局方式 + + + + + 标准布局 + + + + + 使项带有描述的布局 + + + + + 双击项事件参数 + + + + + + + + + + + + + + + + 项被删除事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 为项绘制带有描述信息的渲染器 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + 默认布局引擎，以类似微软ListView的方式按行排列项 + + + + + 框选的最短开始长度 + + + + + 框选时滚动条的自动滚动速度 + + + + + 用于鼠标框选时，框出了控件中项的显示范围时，自动滚动滚动条 + + + + + 自动滚动时，滚动值 + + + + + 是否处于框选状态中 + + + + + 内框offset，内框offset是绝对相对于滚动条的 + + + + + 整个可显示项的边界的offset，包括上下padding部分 + + + + + 鼠标按下时项区域边界的offset，即 _itemsAreaOffset + 用于框选时，跨越可视部队画框 + + + + + 当前所能显示的最大行数 + + + + + + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + + + + + + + + + + + + + + + + + + + + + 没有任何项 + + + + + 没有任何项处于可显示状态 + + + + + 整个控件区域 + + + + + 整个可用于绘制项的可视区域 + 去除左右Padding部分，去除滚动条 + + + + + 用于绘制项的区域 + 考虑边距间隔大小和滚动条区域 + + + + + 项的尺寸 + 不放在ListView本身中定义而是放在LayoutManager中定义，是因为不同的布局方式 + 可能会是带长宽的Size做为itemSize，比如平铺的方式 + + + + + 项周围的边距 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新整个布局引擎的状态 + + + + + 判断指定的项是否处于可见状态 + + + + + + + 获取项的呈现区域 + + + + + + + + + + + + + + + + + + + + 获取当前所有可见项 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculates the maximum number of rows and columns + that can be fully displayed. + + + + + 计算当前可见项的index范围 + + + + + 更新滚动条状态 + + + + + 创建框选框 + + + + + + 根据矩形区域选择项 + + + + + + 应用导航键，如上下左右，返回应用导航键之后的项的坐标 + + + + + 使指定下标的项处于可见状态 + + + + + + 默认渲染器，不绘制项的实际内容，但是绘制DEBUG信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 用于子类重写时删除相应的缓存 + + + + + + 绘制项的背景 + + The System.Drawing.Graphics to draw on. + The client coordinates of the item area. + + + + 绘制最终的前景 + + + + + + 绘制选择边框 + + The System.Drawing.Graphics to draw on. + The client coordinates of the selection rectangle. + + + + 绘制项的边框 + + + + + + + + 绘制项 + + + + + + + 绘制项的背景 + + + + + + + 绘制项的内容 + + + + + + + + 绘制背景 + + + + + + 绘制当前所有可见项 + + + + + + Renders the selection rectangle. + + The graphics to draw on. + + + + 默认渲染器，以类似微软ListView的方式按行绘制项，只绘制简单的文本 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + + + + + + + + + + + + + + + 项的背景色 + + + + + 控件背景色 + + + + + 项的边框色 + + + + + 选择框颜色 + + + + + 选择框的边框色 + + + + + 当控件具有焦点时选定项的背景色 + + + + + + + + + + 控件失去焦点时选定项的背景色 + + + + + + + + + + 热点项的背景色 + + + + + + + + + + 图像内边框颜色 + + + + + 图像外边框颜色 + + + + + + + + + + Creates a control with a border. + + + + + Specifies that the control has a border with a sunken edge. + + + + + + + + + + 是否需要在调用 ResumeLayout 时重绘 + + + + + 为项扩展的用于呈现的属性 + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + 鼠标左键是否处于按下状态 + + + + + 鼠标右键是否处于按下状态 + + + + + 鼠标最后点击的位置 + + + + + 当前鼠标经过的项 + + + + + + + + + + + + + + + 配色方案 + + + + + 当前布局中项的高度 + + + + + + + + + + 是否没有任何项 + + + + + + + + + + 获取当前具有输入焦点的项 + + + + + 默认的用于呈现为项中文本的Property + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + + 请求在下次调用 ResumeLayout 时重绘 + + + + + 获取当前选中的所有项 + + + + + + + + + + + + 设置扩展属性供特定LayoutEngine使用 + 如果指定的 ExtendMember 已存在，覆盖之 + 用String.Empty 或 null 做为 propertyName传入，表示删除指定的 member + + + + + + + + + + + + + + + + + + + + + 恢复正常的布局逻辑。 + + + + + + + + + + + 临时挂起控件的布局逻辑。 + + + + + + + + + + 获取当前选中项所绑定的对象 + 如果没有选中项，返回null，如果选中多项，返回选中项集合中的第一个 + + + + + + 根据指定的绑定项对象 + 设置当前列表中选定的项 + + + + + + 获取当前选中的所有项的绑定对象集合 + 如果当前没有选中任何项，返回空集合 + + + + + + 取消所有项的选择 + + + + + + + + + + + + + + + + 获取创建控件句柄时所需要的创建参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + 项被删除 + + + + + 通过外能事件获取用于绘制项的文本 + + + + + Represents the color palette of the image list view. + + + + + Gets or sets the background color of the ImageListView control. + + + + + Gets or sets the background color of the ImageListViewItem. + + + + + Gets or sets the background color of alternating cells in Details View. + + + + + Gets or sets the border color of the ImageListViewItem. + + + + + Gets or sets the foreground color of the ImageListViewItem. + + + + + Gets or sets the background gradient color1 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color2 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the border color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the fore color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is hovered. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is hovered. + + + + + Gets or sets the border color of the ImageListViewItem if the item is hovered. + + + + + Gets or sets the color of the insertion caret. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is selected. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is selected. + + + + + Gets or sets the border color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the fore color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the background gradient color1 of the column header. + + + + + Gets or sets the background gradient color2 of the column header. + + + + + Gets or sets the background hover gradient color1 of the column header. + + + + + Gets or sets the background hover gradient color2 of the column header. + + + + + Gets or sets the cells foreground color of the column header text. + + + + + Gets or sets the cells background color if column is selected in Details View. + + + + + Gets or sets the color of the separator in Details View. + + + + + Gets or sets the foreground color of the cell text in Details View. + + + + + Gets or sets the foreground color of alternating cells text in Details View. + + + + + Gets or sets the background color of the image pane. + + + + + Gets or sets the separator line color between image pane and thumbnail view. + + + + + Gets or sets the color of labels in pane view. + + + + + Gets or sets the image inner border color for thumbnails and pane. + + + + + Gets or sets the image outer border color for thumbnails and pane. + + + + + Gets or sets the background color1 of the selection rectangle. + + + + + Gets or sets the background color2 of the selection rectangle. + + + + + Gets or sets the color of the selection rectangle border. + + + + + Initializes a new instance of the ImageListViewColor class. + + + + + Initializes a new instance of the ImageListViewColor class + from its string representation. + + String representation of the object. + + + + Copies color values from the given object. + + The source object. + + + + Represents the default color theme. + + + + + Represents the noir color theme. + + + + + Represents the mandarin color theme. + + + + + Sets the color palette to default colors. + + + + + Sets the color palette to mandarin colors. + + + + + Sets the color palette to noir colors. + + + + + Determines whether all color values of the specified + ImageListViewColor are equal to this instance. + + The object to compare with this instance. + true if the two instances have the same color values; + otherwise false. + + + + Returns a hash code for this instance. + + + A hash code for this instance, suitable for use in + hashing algorithms and data structures like a hash table. + + + + + Returns a string that represents this instance. + + + A string that represents this instance. + + + + + 测试坐标 + + + + + 项的坐标 + + + + + 是否点击了项 + + + + + + + + + + + + + + + + + + + + + + 该项当前的选中状态 + + + + + + + + + + + + + + + + + + + + 所绑定的对象 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将指定的事件移动到(紧邻)另一个事件之前 + + + + + + + 将指定的事件移动到(紧邻)另一个事件之后 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Modify a WinForms TreeView control to use the new Explorer style theme + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + WM_COPYDATA消息所要求的数据结构 + + + + + + + + + + + + + + + + + + + + + + + + + 通过窗口的标题来查找窗口的句柄 + + + + + + + + 发送 Windows 消息 + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 发送消息，只能传递一个自定义的消息ID和消息字符串，想传一个结构，但没成功 + + 目标进程名称，如果有多个，则给每个都发送 + 自定义数据，可以通过这个来决定如何解析下面的strMsg + 传递的消息，是一个字符串 + + + + 接收消息，得到消息字符串 + + System.Windows.Forms.Message m + 接收到的消息字符串 + + + + + + + + + 最大圆角半径 + + + + + 最小矩形边长，用于自动处理圆角大小 + + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + 填充区域针对矩形的缩进距离 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + + + + 使图片单色化 + + + + + + + 获取颜色 + + + + + + + + + + + + + 颜色变化时激发 + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + The top left rectangle in auto hide strip area. + + + + + The top right rectangle in auto hide strip area. + + + + + The bottom left rectangle in auto hide strip area. + + + + + The bottom right rectangle in auto hide strip area. + + + + + Gets one of the four auto hide strip rectangles. + + Dock state. + The desired rectangle. + + As the corners are represented by , , , and , + the four strips can be easily calculated out as the borders. + + + + + Context menu. + + + This property should be obsolete as it does not support theming. Please use instead. + + + + + Context menu strip. + + + + + Overridden to avoid resize issues with nested controls + + + http://blogs.msdn.com/b/alejacma/archive/2008/11/20/controls-won-t-get-resized-once-the-nesting-hierarchy-of-windows-exceeds-a-certain-depth-x64.aspx + http://support.microsoft.com/kb/953934 + + + + + Determines whether the close button is visible on the content + + + + + There's a bug in the WinForms layout engine + that can result in a deferred layout to not + properly clear out the cached layout args after + the layout operation is performed. + Specifically, this bug is hit when the bounds of + the Pane change, initiating a layout on the parent + (DockWindow) which is where the bug hits. + To work around it, when a pane loses the DockWindow + as its parent, that parent DockWindow needs to + perform a layout to flush the cached args, if they exist. + + + + + Gets a value indicating whether dock panel can be dragged when in auto hide mode. + Default is false. + + + + + Determines the color with which the client rectangle will be drawn. + If this property is used instead of the BackColor it will not have any influence on the borders to the surrounding controls (DockPane). + The BackColor property changes the borders of surrounding controls (DockPane). + Alternatively both properties may be used (BackColor to draw and define the color of the borders and DockBackColor to define the color of the client rectangle). + For Backgroundimages: Set your prefered Image, then set the DockBackColor and the BackColor to the same Color (Control) + + + + + Dock area. + + + This is the center rectangle of control. + + Excluded spaces are for the following visual elements, + * Auto hide strips on four sides. + * Necessary paddings defined in themes. + + Therefore, all dock contents mainly fall into this area (except auto hide window, which might slightly move beyond this area). + + + + + Flag to show autohide content on mouse hover. Default value is true. + + + This flag is ignored in VS2012/2013 themes. Such themes assume it is always false. + + + + + DragHandlerBase is the base class for drag handlers. The derived class should: + 1. Define its public method BeginDrag. From within this public BeginDrag method, + DragHandlerBase.BeginDrag should be called to initialize the mouse capture + and message filtering. + 2. Override the OnDragging and OnEndDrag methods. + + + + + Loads layout from XML file. + + The file name. + Deserialization handler. + Deserialization might throw exceptions. + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + Deserialization might throw exceptions. + + The stream is closed after deserialization. + + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + The flag to close the stream after deserialization. + Deserialization might throw exceptions. + + + + Deserialization handler of layout file/stream. + + Strings stored in layout file/stream. + Dock content deserialized from layout/stream. + + The deserialization handler method should handle all possible exceptions. + + If any exception happens during deserialization and is not handled, the program might crash or experience other issues. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The skin to use when displaying the DockPanel. + The skin allows custom gradient color schemes to be used when drawing the + DockStrips and Tabs. + + + + + The skin used to display the auto hide strips and tabs. + + + + + The skin used to display the Document and ToolWindow style DockStrips and Tabs. + + + + + The skin used to display the auto hide strip and tabs. + + + + + The gradient color skin for the DockStrips. + + + + + The gradient color skin for the Tabs. + + + + + The gradient color skin for the Tabs. + + + + + Font used in AutoHideStrip elements. + + + + + The skin used to display the document and tool strips and tabs. + + + + + The skin used to display the Document style DockPane strip and tab. + + + + + The skin used to display the ToolWindow style DockPane strip and tab. + + + + + Font used in DockPaneStrip elements. + + + + + The skin used to display the DockPane ToolWindow strip and tab. + + + + + The skin used to display the active ToolWindow caption. + + + + + The skin used to display the inactive ToolWindow caption. + + + + + The skin used to display the DockPane strip and tab. + + + + + The gradient color skin for the DockStrip. + + + + + The skin used to display the active DockPane tabs. + + + + + The skin used to display the inactive DockPane tabs. + + + + + The skin used to display the dock pane tab + + + + + The text color. + + + + + The skin used to display the dock pane tab + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient color skin. + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient mode to display the colors. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Dock window base class. + + + + + Dock window of Visual Studio 2003/2005 theme. + + + + + The location to draw the DockPaneStrip for Document style windows. + + + + + + + + + + + + + + + Gets images for tabs and captions. + + + + + + + + + + Gets images for docking indicators. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Switches a pane with its first child in the pane hierarchy. (The actual hiding happens elsewhere.) + + Pane to switch + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Determines whether the close button is visible on the content + + + + + Calculate which tabs are displayed and in what order. + + + + + Visual Studio 2005 theme (default theme). + + + + + + + + + + X for this inside the logical strip rectangle. + + + + + Width of this . + + + + + Dock window of Visual Studio 2012 Light theme. + + + + + Initializes a new instance of the class. + + The dock panel. + State of the dock. + + + + Determines whether the close button is visible on the content + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculate which tabs are displayed and in what order. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 theme base. + + + + + + + + + + + + + + + + diff --git a/Bin/Debug/CommonControls/.NET4 示例/RaUIV4.dll b/Bin/Debug/CommonControls/.NET4 示例/RaUIV4.dll new file mode 100644 index 0000000..4607f95 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/RaUIV4.dll differ diff --git a/Bin/Release/CommonControls/.NET4/ryControls.xml b/Bin/Debug/CommonControls/.NET4 示例/RaUIV4.xml similarity index 53% rename from Bin/Release/CommonControls/.NET4/ryControls.xml rename to Bin/Debug/CommonControls/.NET4 示例/RaUIV4.xml index b1b565f..25ba2fa 100644 --- a/Bin/Release/CommonControls/.NET4/ryControls.xml +++ b/Bin/Debug/CommonControls/.NET4 示例/RaUIV4.xml @@ -1,32830 +1,60010 @@ - - - - ryControls - - - - - Martin Lottering : 2007-10-27 - -------------------------------- - This is a usefull control in Filters. Allows you to save space and can replace a Grouped Box of CheckBoxes. - Currently used on the TasksFilter for TaskStatusses, which means the user can select which Statusses to include - in the "Search". - This control does not implement a CheckBoxListBox, instead it adds a wrapper for the normal ComboBox and Items. - See the CheckBoxItems property. - ---------------- - ALSO IMPORTANT: In Data Binding when setting the DataSource. The ValueMember must be a bool type property, because it will - be binded to the Checked property of the displayed CheckBox. Also see the DisplayMemberSingleItem for more information. - ---------------- - Extends the CodeProject PopupComboBox "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp" - by Lukasz Swiatkowski. - - - - - - - - - - The checkbox list control. The public CheckBoxItems property provides a direct reference to its Items. - - - - - In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. - The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display - a concatenated Text of the items selected. This concatenation and its formatting however is controlled - by the Binded object, since it owns that property. - - - - - Builds a CSV string of the items selected. - - - - - A direct reference to the Items of CheckBoxComboBoxListControl. - You can use it to Get or Set the Checked status of items manually if you want. - But do not manipulate the List itself directly, e.g. Adding and Removing, - since the list is synchronised when shown with the ComboBox.Items. So for changing - the list contents, use Items instead. - - - - - The DataSource of the combobox. Refreshes the CheckBox wrappers when this is set. - - - - - The ValueMember of the combobox. Refreshes the CheckBox wrappers when this is set. - - - - - In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. - The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display - a concatenated Text of the items selected. This concatenation however is controlled by the Binded - object, since it owns that property. - - - - - Made this property Browsable again, since the Base Popup hides it. This class uses it again. - Gets an object representing the collection of the items contained in this - System.Windows.Forms.ComboBox. - - A System.Windows.Forms.ComboBox.ObjectCollection representing the items in - the System.Windows.Forms.ComboBox. - - - - - - - - - - - - - - - - - Will add an invisible item when the style is DropDownList, - to help maintain the correct text in main TextBox. - - - - - - - - - - - - A function to clear/reset the list. - (Ubiklou : http://www.codeproject.com/KB/combobox/extending_combobox.aspx?msg=2526813#xx2526813xx) - - - - - Uncheck all items. - - - - - The properties that will be assigned to the checkboxes as default values. - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - A container control for the ListControl to ensure the ScrollBar on the ListControl does not - Paint over the Size grip. Setting the Padding or Margin on the Popup or host control does - not work as I expected. - - - - - - - - - - Prescribed by the Popup class to ensure Resize operations work correctly. - - - - - - This ListControl that pops up to the User. It contains the CheckBoxComboBoxItems. - The items are docked DockStyle.Top in this control. - - - - - - - - - - - Simply a reference to the CheckBoxComboBox. - - - - - A Typed list of ComboBoxCheckBoxItems. - - - - - - - - - - Prescribed by the Popup control to enable Resize operations. - - - - - - - - - - - - Maintains the controls displayed in the list by keeping them in sync with the actual - items in the combobox. (e.g. removing and adding as well as ordering) - - - - - The CheckBox items displayed in the Popup of the ComboBox. - - - - - - - A reference to the CheckBoxComboBox. - A reference to the item in the ComboBox.Items that this object is extending. - - - - A reference to the CheckBoxComboBox. - - - - - A reference to the Item in ComboBox.Items that this object is extending. - - - - - A reference to the Item in ComboBox.Items that this object is extending. - - - - - When using Data Binding operations via the DataSource property of the ComboBox. This - adds the required Bindings for the CheckBoxes. - - - - - - - - - - - Added this handler because the control doesn't seem - to initialize correctly until shown for the first - time, which also means the summary text value - of the combo is out of sync initially. - - - - - A Typed List of the CheckBox items. - Simply a wrapper for the CheckBoxComboBox.Items. A list of CheckBoxComboBoxItem objects. - This List is automatically synchronised with the Items of the ComboBox and extended to - handle the additional boolean value. That said, do not Add or Remove using this List, - it will be lost or regenerated from the ComboBox.Items. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Returns the item with the specified displayName or Text. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Called when any property changes. - - - - - - - - - - CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". - - - - - CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". - - - - - CodeProject.com Simple pop-up control http://www.codeproject.com/cs/miscctrl/simplepopup.asp. - Represents a pop-up window. - - - - - Gets the content of the pop-up. - - - - - Gets a value indicating whether the PopupControl.Popup uses the fade effect. - - true if pop-up uses the fade effect; otherwise, false. - To use the fade effect, the FocusOnOpen property also has to be set to true. - - - - Gets or sets a value indicating whether to focus the content after the pop-up has been opened. - - true if the content should be focused after the pop-up has been opened; otherwise, false. - If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. - - - - Gets or sets a value indicating whether presing the alt key should close the pop-up. - - true if presing the alt key does not close the pop-up; otherwise, false. - - - - Gets or sets a value indicating whether this PopupControl.Popup is resizable. - - true if resizable; otherwise, false. - - - - Gets or sets the size that is the lower limit that can specify. - - An ordered pair of type representing the width and height of a rectangle. - - - - Gets or sets the size that is the upper limit that can specify. - - An ordered pair of type representing the width and height of a rectangle. - - - - Gets parameters of a new window. - - An object of type used when creating a new window. - - - - Initializes a new instance of the PopupControl.Popup class. - - The content of the pop-up. - - Pop-up will be disposed immediately after disposion of the content control. - - is null. - - - - Processes a dialog box key. - - One of the values that represents the key to process. - - true if the key was processed by the control; otherwise, false. - - - - - Updates the pop-up region. - - - - - Shows pop-up window below the specified control. - - The control below which the pop-up will be shown. - - When there is no space below the specified control, the pop-up control is shown above it. - - is null. - - - - Shows pop-up window below the specified area of specified control. - - The control used to compute screen location of specified area. - The area of control below which the pop-up will be shown. - - When there is no space below specified area, the pop-up control is shown above it. - - is null. - - - - Adjusts the size of the owner to accommodate the if the owner is currently displayed, or clears and resets active child controls of the if the is not currently displayed. - - true if the owner is currently displayed; otherwise, false. - - - - Raises the event. - - An that contains the event data. - - - - Raises the event. - - A that contains the event data. - - - - Raises the event. - - An that contains the event data. - - - - - - - - - - - - - - - - - - - - - Processes Windows messages. - - The Windows to process. - - - - Processes the resizing messages. - - The message. - true, if the WndProc method from the base class shouldn't be invoked. - - - - Paints the size grip. - - The instance containing the event data. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". - Represents a Windows combo box control with a custom popup control attached. - - - - - Initializes a new instance of the PopupControl.PopupComboBox class. - - - - - The pop-up wrapper for the dropDownControl. - Made PROTECTED instead of PRIVATE so descendent classes can set its Resizable property. - Note however the pop-up properties must be set after the dropDownControl is assigned, since this - popup wrapper is recreated when the dropDownControl is assigned. - - - - - Gets or sets the drop down control. - - The drop down control. - - - - Shows the drop down. - - - - - Hides the drop down. - - - - - Processes Windows messages. - - The Windows to process. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - Maintains an additional "Selected" and "Count" value for each item in a List. - Useful in the CheckBoxComboBox. It holds a reference to the List[Index] Item and - whether it is selected or not. - It also caters for a Count, if needed. - - - - - No property on the object is specified for display purposes, so simple ToString() operation - will be performed. And no Counts will be displayed - - - - - No property on the object is specified for display purposes, so simple ToString() operation - will be performed. - - - - - A Display "Name" property is specified. ToString() will not be performed on items. - This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. - If a PropertyDescriptor is not found, a Property will be used. - - - - - A Display "Name" property is specified. ToString() will not be performed on items. - This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. - If a PropertyDescriptor is not found, a Property will be used. - - - - - Is a Count indicator used. - - - - - The original List of values wrapped. A "Selected" and possibly "Count" functionality is added. - - - - - Used to indicate NOT to use ToString(), but read this property instead as a display value. - - - - - When specified, indicates that ToString() should not be performed on the items. - This property will be read instead. - This is specifically useful on DataTable implementations, where PropertyDescriptors are used to read the values. - - - - - Builds a concatenation list of selected items in the list. - - - - - Indicates whether the Item display value (Name) should include a count. - - - - - Reset all counts to zero. - - - - - Creates a ObjectSelectionWrapper item. - Note that the constructor signature of sub classes classes are important. - - - - - - - - - - - - - - Used together with the ListSelectionWrapper in order to wrap data sources for a CheckBoxComboBox. - It helps to ensure you don't add an extra "Selected" property to a class that don't really need or want that information. - - - - - - - - - - - - Used as a count indicator for the item. Not necessarily displayed. - - - - - Is this item selected. - - - - - A reference to the wrapped item. - - - - - The containing list for these selections. - - - - - An indicator of how many items with the specified status is available for the current filter level. - Thaught this would make the app a bit more user-friendly and help not to miss items in Statusses - that are not often used. - - - - - A reference to the item wrapped. - - - - - The item display value. If ShowCount is true, it displays the "Name [Count]". - - - - - The textbox display value. The names concatenated. - - - - - Indicates whether the item is selected. - - - - - - - - - - - - - - - - 控件状态 - - - - - 无 - - - - - 获得焦点 - - - - - 失去焦点 - - - - - 鼠标指针进入控件 - - - - - Toolbar控件 - - - - - - - - - - - - - - - 获取或设置控件显示的图片 - - - - - 重写控件焦点属性 - - - - - 自定义绘制 - - - - - - 焦点进入 - - - - - - 失去焦点 - - - - - - 禁止调整大小 - - - - - - - - - - - - - - - - - - 只响应单击鼠标左键事件 - - - - - - 按比例缩放图片 - - - - - - - 图片缩放 - - 源图片 - 缩放图片的宽度 - 缩放图片的高度 - 缩放的图片 - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 绘图对像 - - 绘图对像 - 图片 - 绘置的图片大小、坐标 - 绘置的图片边界 - 当前状态 - 状态总数 - - - - 绘图对像 - - 绘图对像 - 图片对像 - 绘置的图片大小、坐标 - 当前状态 - 状态总数 - - - - - - - - - 得到要绘置的图片对像 - - 图像在程序集中的地址 - - - - - 得到要绘置的图片对像 - - 图像在程序集中的路径 - 图像在程序集中的地址 - - - - - 获取资源图标 - - - - - - - 得到图程序集中的图片对像 - - 图像在程序集中的地址 - - - - - 得到图程序集中的图片对像 - - 图像在程序集中的路径 - 图像在程序集中的地址 - - - - - 控件的状态。 - - - - - 正常 - - - - - 鼠标经过 - - - - - 鼠标按下 - - - - - 鼠标的当前位置 - - - - - - - - - - - - - - - - - - - - 美化按钮 - - - - - 普通按钮矩形位置 - - - - - 美化按钮 - - - - - 分割按钮的宽度 - - - - - 是否启用分割按钮 - - - - - 优先使用默认皮肤 - - - - - 按钮基础背景色 - - - - - 按钮字体颜色 - - - - - 图片宽度,默认值为18px，最小12px - - - - - 圆角的位置,默认全部都是圆角 - - - - - 设置圆角半径 - - - - - 背景色是否渐变 - - - - - 图片高度 - - - - - 图片与文字之间的间距 - - - - - 当鼠标按下时图片和文字是否产生偏移 - - - - - 鼠标进入时 - - - - - - 鼠标离开 - - - - - - 鼠标按下 - - - - - - 鼠标弹起 - - - - - - 鼠标当前所在位置 - - - - - 获取图像以及文字的位置 - - - - - - - - - - - - - - - - - - - - - - - - 添加菜单分隔线 - - - - - - 添加菜单 - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 增强版Label(禁用了双击Label会自动复制文本到剪切板的功能) - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 增强富文本控件 - - - - - 开始更新 - - - - - 结束更新 - - - - - RichTextBox - - - - - - - - - - - - - - - - - - - - - - - 在自带菜单弹出前激发 - - - - - 根据标签获得菜单项 - - - - - - - 只允许输入文本(只对设置之后的人工输入有效) - - - - - 按下按键 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 鼠标按下 - - - - - - - - - - - - - - - - - - 当文本框为空时,显示的内容。 - - - - - 添加菜单分隔线 - - - - - - 添加菜单 - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - 消息列表控件 - - - - - 最大高度 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 建立圆角路径的样式。 - - - - - 四个角都不是圆角。 - - - - - 四个角都为圆角。 - - - - - 左边两个角为圆角。 - - - - - 右边两个角为圆角。 - - - - - 上边两个角为圆角。 - - - - - 下边两个角为圆角。 - - - - - 左下角为圆角。 - - - - - 右下角为圆角。 - - - - - 画图相关API - - - - - 建立带有圆角样式的路径。 - - 用来建立路径的矩形。 - 圆角的大小。 - 圆角的样式。 - 是否把矩形长宽减 1,以便画出边框。 - 建立的路径。 - - - - 窗体皮肤 - - - - - 窗体皮肤 - - - - - 标题属性 - - - - - 是否使用父窗口的图标 - - - - - 点击最小化按钮是最小化还是隐藏 - - - - - 最大化按钮 - - - - - 最小化按钮 - - - - - 标题栏关闭按钮是否显示 - - - - - 当窗口位于后台时，是否标注显示。 - - - - - - - - - - 标题栏字体颜色 - - - - - 标题栏不处于活动状态时的字体颜色 - - - - - 标题栏背景颜色 - - - - - 标题栏不处于活动状态时的背景颜色 - - - - - 是否允许拖拉窗体边缘来改变窗体大小 - - - - - - - - - - - 画边框 - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - 热键文本框 - - - - - 热键文本框 - - - - - - - - - - - - - - - - - 在控件大小变化时发生 - - - - - - 此属性无效 - - - - - 载入热键配置 - - - - - - 保存热键 - - - - - - 是否含义热键 - - - - - 读取或设置热键 - - - - - 功能键 - - - - - 热键按键 - - - - - KeyDown事件 - - - - - - KeyDown事件 - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 图标列表控件 - - - - - 图标列表控件 - - - - - 图标大小 - - - - - 文本显示高度(从底部算起) - - - - - 默认图标 - - - - - 是否显示图标 - - - - - 是否显示网格线 - - - - - 角标图标合集 - - - - - 画项 - - - - - - 选择项的背景开始颜色 - - - - - 选择项的背景结束颜色 - - - - - 选择项的边框颜色 - - - - - 选择项的字体颜色 - - - - - 重绘选中时背景 - - - - - 重绘图标 - - - 区域大小 - - - - - - - - 重绘文本 - - - - - 获取文本对齐 - - - - - 水平滚动条滚动事件 - - - - - 垂直滚动条滚动事件 - - - - - - - - - - - 列表项 - - - - - 图标 - - - - - 角标图片序号,为-1表示无角标 - - - - - - - - - - - - - - - 最大高度 - - - - - 标题 - - - - - 是否显示时间 - - - - - 添加时间 - - - - - - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 最大高度 - - - - - 标题 - - - - - 是否显示时间 - - - - - 添加时间 - - - - - 内容 - - - - - 网址 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 图标 - - - - - 标题 - - - - - 悬浮提示 - - - - - 标题颜色 - - - - - 设置按钮 - - - - - - - 判断和设置是否选择 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 绘制边框 - - 消息 - - - - 类说明：CContextMenuStrip控件的实现用来代替系统的ContextMenuStrip控件 - - - - - - - - - - - - - - - - 重写OnCreateControl - - - - - 重写OnPaint事件 - - - - - - CreateRoundedRectanglePath - - Rectangle - - - - - - 系统热键数据类。 - - - - - 系统热键数据类 - - - - - 使多行属性失效掉 - - - - - 使只读属性失效掉 - - - - - 获取热键文本 - - - - - 功能键 - - - - - 热键按键 - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 增强时间控件 - - - - - 增强时间控件 - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 选择文本框 - - - - - 选择文本框 - - - - - 按钮基础背景色 - - - - - 优先使用默认皮肤 - - - - - 选择的id - - - - - 选择的名称 - - - - - 选择的名称 - - - - - 字体 - - - - - 重新设置大小 - - - - - 在选择时激发 - - - - - 点击选择 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 可以改变文本行距（行间距）的Label - - - - - 行间距 - - - - - 可以改变文本行距（行间距）的Label - - - - - - - - - - 字体高度 - - - - - - - - - - 文本 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 计算两个日期的时间间隔,返回的是日期值+ - - 时间值,将显示在返回的值里 - 参照时间 - - - - - - - - - - - - - - - 控件边框颜色 - - - - - 控件背景颜色 - - - - - 圆角弧度大小 - - - - - 圆角风格 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - 在搜索时激发 - - - - - 文本变化时激发 - - - - - 文本变化时激发 - - - - - 双击时激发 - - - - - - - - - - - - - - - 文本为空时的显示效果 - - - - - 文本不选中 - - - - - 有内容时的显示效果 - - - - - 当文本框为空时,显示的内容。 - - - - - 字体 - - - - - 优先使用默认皮肤 - - - - - 背景色是否渐变 - - - - - 按钮基础背景色 - - - - - 按钮圆角部分背景颜色 - - - - - - - - - - 重新设置大小 - - - - - 点击搜索按钮 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 使用公共皮肤 - - - - - 按钮颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - 皮肤公共类 - - - - - 是否使用默认皮肤 - - - - - 按钮皮肤 - - - - - 按钮皮肤类 - - - - - 背景颜色 - - - - - 字体颜色 - - - - - 是否颜色渐变 - - - - - 类说明：帮助类 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 修改控件或窗体的边框，例如Textbox或是Form窗体 - - 消息 - 控件对象 - 边框像素 - 边框颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 超级图片控件,支持加载工程内部图片、异步加载网络图片 - - - - - 超级图片控件,支持加载工程内部图片、异步加载网络图片 - - - - - 图片所在上级域名 - - - - - 图片资源所在上级文件夹 - - - - - 根据不同前缀，加载不同格式图片。i:表示工程内置图片;s:表示T_ImageDomain域名下的图片,u:表示指定url的图片;f:表示本地图片 - - - - - - 加载本地图片,加载完毕不会占用本地图片 - - - - - - 加载指定url图片 - - url位置 - 是否异步 - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 多标签控件 - - - - - - - - - - 选项发生变化时激发 - - - - - 标签选择的序号 - - - - - - - - - - 选择的颜色 - - - - - 多标签控件颜色 - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 多标签控件 - - - - - - - - - - 获取对应的标签 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 美化文本框控件 - - - - - 文本变化时激发 - - - - - 文本变化时激发 - - - - - 双击时激发 - - - - - - - - - - 是否只能输入数字 - - - - - 是否多行 - - - - - 是否在显示不下时换行 - - - - - 最大长度 - - - - - - - - - - 背景颜色 - - - - - 右键菜单 - - - - - 字体颜色 - - - - - 选择的开始位置 - - - - - 选择的长度 - - - - - 选择的文本 - - - - - 提示文本 - - - - - 选择全部 - - - - - 密码 - - - - - 是否只读 - - - - - - - - - - - 文本为空时的显示效果 - - - - - 字体 - - - - - 有内容时的显示效果 - - - - - 当文本框为空时,显示的内容。 - - - - - - - - - - 选择文本框中的文本范围 - - 文本框中当前选定文本的第一个字符的位置。 - 要选择的字符数 - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - Define some Windows message constants - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This class adds to the functionality provided in System.Windows.Forms.MenuStrip. - - It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to - bring the form into focus and once more to take the desired action - - It also implements a SuppressHighlighting property to turn off the highlighting - that occures on mouseover when the form is not active - - - - - Gets or sets whether the control honors item clicks when its containing form does - not have input focus. - - - Default value is false, which is the same behavior provided by the base ToolStrip class. - - - - - Gets or sets whether the control shows highlighting on mouseover - - - Default value is true, which is the same behavior provided by the base MenuStrip class. - - - - - This method overrides the procedure that responds to Windows messages. - - It intercepts the WM_MOUSEMOVE message - and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. - Otherwise, it calls the base class procedure to handle the message. - - It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with - an "Activate" result if ClickThrough is enabled. - - - - - - This class adds to the functionality provided in System.Windows.Forms.ToolStrip. - - It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to - bring the form into focus and once more to take the desired action - - It also implements a SuppressHighlighting property to turn off the highlighting - that occures on mouseover when the form is not active - - - - - Gets or sets whether the control honors item clicks when its containing form does - not have input focus. - - - Default value is false, which is the same behavior provided by the base ToolStrip class. - - - - - Gets or sets whether the control shows highlighting on mouseover - - - Default value is true, which is the same behavior provided by the base MenuStrip class. - - - - - This method overrides the procedure that responds to Windows messages. - - It intercepts the WM_MOUSEMOVE message - and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. - Otherwise, it calls the base class procedure to handle the message. - - It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with - an "Activate" result if ClickThrough is enabled. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 还原 - - - - - 移动 - - - - - 大小 - - - - - 最小化 - - - - - 最大化 - - - - - 关闭 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 透明图片控件 - - - - - 是否使用透明,默认为True - - - - - 设置透明度 - - - - - 要绑定的控件 - - - - - 透明图片控件 - - - - - 图片 - - - - - 初始化加载控件 - - 透明度 - 是否显示加载图片 - 图片 - - - - - - - - - - - - - - - 显示加载 - - - - - 隐藏加载 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - 获得当前进程，以便重绘控件 - - - - - - - 是否启用热点效果 - - - - - 边框颜色 - - - - - 热点边框颜色 - - - - - 是否鼠标MouseOver状态 - - - - - 是否启用热点效果 - - - - - 边框颜色 - - - - - 热点时边框颜色 - - - - - - - - - - 鼠标移动到该控件上时 - - - - - - 当鼠标从该控件移开时 - - - - - - 当该控件获得焦点时 - - - - - - 当该控件失去焦点时 - - - - - - 获得操作系统消息 - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 一个强类型的资源类，用于查找本地化的字符串等。 - - - - - 返回此类使用的缓存的 ResourceManager 实例。 - - - - - 重写当前线程的 CurrentUICulture 属性，对 - 使用此强类型资源类的所有资源查找执行重写。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 日控件 - - - - - 日控件 - - - - - 当前日期 - - - - - 在发生页码变化前激发 - - - - - 设置休息状态,1为休息,-1为上班，其它为不显示 - - - - - - 日期 - - - - - 农历 - - - - - 阳历日期字体颜色 - - - - - 阳历日期字体 - - - - - 农历日期字体 - - - - - 农历部分字体颜色 - - - - - 是否选中 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 日历控件 - - - - - 单击事件 - - - - - - - 单击某个日期事件 - - - - - 日历控件 - - - - - 设置日期 - - - - - 放假数据表 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 设置管理类,快速添加设置。 - - - - - 设置管理类,快速添加设置。 - - - - - 设置管理类,快速添加设置。 - - - - - - 存储类型 - - - - - 配置存储路径 - - - - - 设置XML内容 - - - - - 添加控件 - - - - - - - - 设置值 - - - - - - - - 添加控件 - - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 读取配置 - - - - - 保存配置 - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - 类 名:ColorHSL - 功 能:H 色相 \ S 饱和度(纯度) \ L 亮度 颜色模型 - 日 期:2015-02-08 - 修 改:2015-03-20 - 作 者:ls9512 - - - - - HSL颜色 - - - - - - - - 色相 - - - - - 饱和度(纯度) - - - - - 饱和度 - - - - - 类 名:ColorHSV - 功 能:H 色相 \ S 饱和度(纯度) \ V 明度 颜色模型 - 日 期:2015-01-22 - 修 改:2015-03-20 - 作 者:ls9512 - - - - - 构造方法 - - - - - - - - 色相 - - - - - 饱和度(纯度) - - - - - 明度 - - - - - 类 名:ColorRGB - 功 能:R 红色 \ G 绿色 \ B 蓝色 颜色模型 - 所有颜色模型的基类,RGB是用于输出到屏幕的颜色模式,所以所有模型都将转换成RGB输出 - 日 期:2015-01-22 - 修 改:2015-03-20 - 作 者:ls9512 - - - - - 构造方法 - - - - - - - - - - - - - - 红色 - - - - - 绿色 - - - - - 蓝色 - - - - - 获取实际颜色 - - - - - - 类 名:ColorHelper - 功 能:提供从RGB到HSV/HSL色彩空间的相互转换 - 日 期:2015-02-08 - 修 改:2015-03-20 - 作 者:ls9512 - - - - - RGB转换HSV - - - - - - - HSV转换RGB - - - - - - - RGB转换HSL - - - - - - - HSL转换RGB - - H, S and L input range = 0 -1.0 - - - - - RGB转CMYK - - - - - - - - - - RGB转CMYK - - - - - - - - - - - - CMYK转RGB - - - - - - - - - - Standard-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源. - - - - - - - - - XYZ → Standard-RGB,X、Y、Z 使用 D65/2°标准光源. - - - - - - - - - XYZ → Adobe-RGB,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 - - - - - - - - - Adobe-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 - - - - - - - - - Yxy转RGB - - - - - - - - - RGB转Yxy - - - - - - - - - 超级颜色选择控件 - - - - - - - - - - - - - - - - - - - - - - - - - - 获取网页颜色 - - - - - 超级颜色选择控件 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - Chrome风格的多标签控件 - - - - - 设置选项卡处于选中状态时第一背景色. - - - - - 设置选项卡处于选中状态时第二背景色. - - - - - 设置选项卡处于非选中状态时第一背景色. - - - - - 设置选项卡处于非选中状态时第二背景色. - - - - - 设置鼠标移动到非选中状态选项卡时第一背景色. - - - - - 设置鼠标移动到非选中状态选项卡时第二背景色. - - - - - 设置选项卡工作区背景色. - - - - - 设置选项卡工作区背景图. - - - - - 是否显示关闭按钮 - - - - - 是否显示新增按钮 - - - - - 是否允许拖拽标签 - - - - - 标签最大宽度 - - - - - 标签右键菜单 - - - - - 鼠标按下标签时激发 - - - - - 鼠标放开标签时激发 - - - - - Chrome风格的多标签控件 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 设置圆角半径 - - - - - Tab文字左边距离 - - - - - - - - - - - - - - 画标签文字 - - - - - - - - - 画标签图标 - - - - - - - 画关闭按钮 - - - - - - - - 获取所有选项卡合起来的宽度 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 添加新标签 - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - The position is not over a tab. - - - - - The position is over a tab's icon. - - - - - The position is over a tab's text. - - - - - The position is over a tab but not over its icon or its text. For owner-drawn tab controls, this value is specified if the position is anywhere over a tab. - TCHT_ONITEM is a bitwise-OR operation on TCHT_ONITEMICON and TCHT_ONITEMLABEL. - - - - - Specifies values from SetWindowPosZ enumeration. - - - - - Specified HWND_TOP enumeration value. - - - - - Specified HWND_BOTTOM enumeration value. - - - - - Specified HWND_TOPMOST enumeration value. - - - - - Specified HWND_NOTOPMOST enumeration value. - - - - - Invalidates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. - You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_INVALIDATE invalidates the entire window. - - - - Causes the OS to post a WM_PAINT message to the window regardless of whether a portion of the window is invalid. - - - - Causes the window to receive a WM_ERASEBKGND message when the window is repainted. - Specify this value in combination with the RDW_INVALIDATE value; otherwise, RDW_ERASE has no effect. - - - - - Validates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. - You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_VALIDATE validates the entire window. - This value does not affect internal WM_PAINT messages. - - - - Suppresses any pending WM_ERASEBKGND messages. - - - Excludes child windows, if any, from the repainting operation. - - - Includes child windows, if any, in the repainting operation. - - - Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND and WM_PAINT messages before the RedrawWindow returns, if necessary. - - - - Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND messages before RedrawWindow returns, if necessary. - The affected windows receive WM_PAINT messages at the ordinary time. - - - - - Specifies values from Msgs enumeration. - - - - - Specified WM_NULL enumeration value. - - - - - Specified WM_CREATE enumeration value. - - - - - Specified WM_DESTROY enumeration value. - - - - - Specified WM_MOVE enumeration value. - - - - - Specified WM_SIZE enumeration value. - - - - - Specified WM_ACTIVATE enumeration value. - - - - - Specified WM_SETFOCUS enumeration value. - - - - - Specified WM_KILLFOCUS enumeration value. - - - - - Specified WM_ENABLE enumeration value. - - - - - Specified WM_SETREDRAW enumeration value. - - - - - Specified WM_SETTEXT enumeration value. - - - - - Specified WM_GETTEXT enumeration value. - - - - - Specified WM_GETTEXTLENGTH enumeration value. - - - - - Specified WM_PAINT enumeration value. - - - - - Specified WM_CLOSE enumeration value. - - - - - Specified WM_QUERYENDSESSION enumeration value. - - - - - Specified WM_QUIT enumeration value. - - - - - Specified WM_QUERYOPEN enumeration value. - - - - - Specified WM_ERASEBKGND enumeration value. - - - - - Specified WM_SYSCOLORCHANGE enumeration value. - - - - - Specified WM_ENDSESSION enumeration value. - - - - - Specified WM_SHOWWINDOW enumeration value. - - - - - Specified WM_WININICHANGE enumeration value. - - - - - Specified WM_SETTINGCHANGE enumeration value. - - - - - Specified WM_DEVMODECHANGE enumeration value. - - - - - Specified WM_ACTIVATEAPP enumeration value. - - - - - Specified WM_FONTCHANGE enumeration value. - - - - - Specified WM_TIMECHANGE enumeration value. - - - - - Specified WM_CANCELMODE enumeration value. - - - - - Specified WM_SETCURSOR enumeration value. - - - - - Specified WM_MOUSEACTIVATE enumeration value. - - - - - Specified WM_CHILDACTIVATE enumeration value. - - - - - Specified WM_QUEUESYNC enumeration value. - - - - - Specified WM_GETMINMAXINFO enumeration value. - - - - - Specified WM_PAINTICON enumeration value. - - - - - Specified WM_ICONERASEBKGND enumeration value. - - - - - Specified WM_NEXTDLGCTL enumeration value. - - - - - Specified WM_SPOOLERSTATUS enumeration value. - - - - - Specified WM_DRAWITEM enumeration value. - - - - - Specified WM_MEASUREITEM enumeration value. - - - - - Specified WM_DELETEITEM enumeration value. - - - - - Specified WM_VKEYTOITEM enumeration value. - - - - - Specified WM_CHARTOITEM enumeration value. - - - - - Specified WM_SETFONT enumeration value. - - - - - Specified WM_GETFONT enumeration value. - - - - - Specified WM_SETHOTKEY enumeration value. - - - - - Specified WM_GETHOTKEY enumeration value. - - - - - Specified WM_QUERYDRAGICON enumeration value. - - - - - Specified WM_COMPAREITEM enumeration value. - - - - - Specified WM_GETOBJECT enumeration value. - - - - - Specified WM_COMPACTING enumeration value. - - - - - Specified WM_COMMNOTIFY enumeration value. - - - - - Specified WM_WINDOWPOSCHANGING enumeration value. - - - - - Specified WM_WINDOWPOSCHANGED enumeration value. - - - - - Specified WM_POWER enumeration value. - - - - - Specified WM_COPYDATA enumeration value. - - - - - Specified WM_CANCELJOURNAL enumeration value. - - - - - Specified WM_NOTIFY enumeration value. - - - - - Specified WM_INPUTLANGCHANGEREQUEST enumeration value. - - - - - Specified WM_INPUTLANGCHANGE enumeration value. - - - - - Specified WM_TCARD enumeration value. - - - - - Specified WM_HELP enumeration value. - - - - - Specified WM_USERCHANGED enumeration value. - - - - - Specified WM_NOTIFYFORMAT enumeration value. - - - - - Specified WM_CONTEXTMENU enumeration value. - - - - - Specified WM_STYLECHANGING enumeration value. - - - - - Specified WM_STYLECHANGED enumeration value. - - - - - Specified WM_DISPLAYCHANGE enumeration value. - - - - - Specified WM_GETICON enumeration value. - - - - - Specified WM_SETICON enumeration value. - - - - - Specified WM_NCCREATE enumeration value. - - - - - Specified VK_RMENU enumeration value. - - - - - Specified WM_NCCALCSIZE enumeration value. - - - - - Specified WM_NCHITTEST enumeration value. - - - - - Specified WM_NCPAINT enumeration value. - - - - - Specified WM_NCACTIVATE enumeration value. - - - - - Specified WM_GETDLGCODE enumeration value. - - - - - Specified WM_SYNCPAINT enumeration value. - - - - - Specified WM_NCMOUSEMOVE enumeration value. - - - - - Specified WM_NCLBUTTONDOWN enumeration value. - - - - - Specified WM_NCLBUTTONUP enumeration value. - - - - - Specified WM_NCLBUTTONDBLCLK enumeration value. - - - - - Specified WM_NCRBUTTONDOWN enumeration value. - - - - - Specified WM_NCRBUTTONUP enumeration value. - - - - - Specified WM_NCRBUTTONDBLCLK enumeration value. - - - - - Specified WM_NCMBUTTONDOWN enumeration value. - - - - - Specified WM_NCMBUTTONUP enumeration value. - - - - - Specified WM_NCMBUTTONDBLCLK enumeration value. - - - - - Specified WM_NCXBUTTONDOWN enumeration value. - - - - - Specified WM_NCXBUTTONUP enumeration value. - - - - - Specified WM_KEYDOWN enumeration value. - - - - - Specified WM_KEYUP enumeration value. - - - - - Specified WM_CHAR enumeration value. - - - - - Specified WM_DEADCHAR enumeration value. - - - - - Specified WM_SYSKEYDOWN enumeration value. - - - - - Specified WM_SYSKEYUP enumeration value. - - - - - Specified WM_SYSCHAR enumeration value. - - - - - Specified WM_SYSDEADCHAR enumeration value. - - - - - Specified WM_KEYLAST enumeration value. - - - - - Specified WM_IME_STARTCOMPOSITION enumeration value. - - - - - Specified WM_IME_ENDCOMPOSITION enumeration value. - - - - - Specified WM_IME_COMPOSITION enumeration value. - - - - - Specified WM_IME_KEYLAST enumeration value. - - - - - Specified WM_INITDIALOG enumeration value. - - - - - Specified WM_COMMAND enumeration value. - - - - - Specified WM_SYSCOMMAND enumeration value. - - - - - Specified WM_TIMER enumeration value. - - - - - Specified WM_HSCROLL enumeration value. - - - - - Specified WM_VSCROLL enumeration value. - - - - - Specified WM_INITMENU enumeration value. - - - - - Specified WM_INITMENUPOPUP enumeration value. - - - - - Specified WM_MENUSELECT enumeration value. - - - - - Specified WM_MENUCHAR enumeration value. - - - - - Specified WM_ENTERIDLE enumeration value. - - - - - Specified WM_MENURBUTTONUP enumeration value. - - - - - Specified WM_MENUDRAG enumeration value. - - - - - Specified WM_MENUGETOBJECT enumeration value. - - - - - Specified WM_UNINITMENUPOPUP enumeration value. - - - - - Specified WM_MENUCOMMAND enumeration value. - - - - - Specified WM_CTLCOLORMSGBOX enumeration value. - - - - - Specified WM_CTLCOLOREDIT enumeration value. - - - - - Specified WM_CTLCOLORLISTBOX enumeration value. - - - - - Specified WM_CTLCOLORBTN enumeration value. - - - - - Specified WM_CTLCOLORDLG enumeration value. - - - - - Specified WM_CTLCOLORSCROLLBAR enumeration value. - - - - - Specified WM_CTLCOLORSTATIC enumeration value. - - - - - Specified WM_MOUSEMOVE enumeration value. - - - - - Specified WM_LBUTTONDOWN enumeration value. - - - - - Specified WM_LBUTTONUP enumeration value. - - - - - Specified WM_LBUTTONDBLCLK enumeration value. - - - - - Specified WM_RBUTTONDOWN enumeration value. - - - - - Specified WM_RBUTTONUP enumeration value. - - - - - Specified WM_RBUTTONDBLCLK enumeration value. - - - - - Specified WM_MBUTTONDOWN enumeration value. - - - - - Specified WM_MBUTTONUP enumeration value. - - - - - Specified WM_MBUTTONDBLCLK enumeration value. - - - - - Specified WM_MOUSEWHEEL enumeration value. - - - - - Specified WM_XBUTTONDOWN enumeration value. - - - - - Specified WM_XBUTTONUP enumeration value. - - - - - Specified WM_XBUTTONDBLCLK enumeration value. - - - - - Specified WM_PARENTNOTIFY enumeration value. - - - - - Specified WM_ENTERMENULOOP enumeration value. - - - - - Specified WM_EXITMENULOOP enumeration value. - - - - - Specified WM_NEXTMENU enumeration value. - - - - - Specified WM_SIZING enumeration value. - - - - - Specified WM_CAPTURECHANGED enumeration value. - - - - - Specified WM_MOVING enumeration value. - - - - - Specified WM_DEVICECHANGE enumeration value. - - - - - Specified WM_MDICREATE enumeration value. - - - - - Specified WM_MDIDESTROY enumeration value. - - - - - Specified WM_MDIACTIVATE enumeration value. - - - - - Specified WM_MDIRESTORE enumeration value. - - - - - Specified WM_MDINEXT enumeration value. - - - - - Specified WM_MDIMAXIMIZE enumeration value. - - - - - Specified WM_MDITILE enumeration value. - - - - - Specified WM_MDICASCADE enumeration value. - - - - - Specified WM_MDIICONARRANGE enumeration value. - - - - - Specified WM_MDIGETACTIVE enumeration value. - - - - - Specified WM_MDISETMENU enumeration value. - - - - - Specified WM_ENTERSIZEMOVE enumeration value. - - - - - Specified WM_EXITSIZEMOVE enumeration value. - - - - - Specified WM_DROPFILES enumeration value. - - - - - Specified WM_MDIREFRESHMENU enumeration value. - - - - - Specified WM_IME_SETCONTEXT enumeration value. - - - - - Specified WM_IME_NOTIFY enumeration value. - - - - - Specified WM_IME_CONTROL enumeration value. - - - - - Specified WM_IME_COMPOSITIONFULL enumeration value. - - - - - Specified WM_IME_SELECT enumeration value. - - - - - Specified WM_IME_CHAR enumeration value. - - - - - Specified WM_IME_REQUEST enumeration value. - - - - - Specified WM_IME_KEYDOWN enumeration value. - - - - - Specified WM_IME_KEYUP enumeration value. - - - - - Specified WM_MOUSEHOVER enumeration value. - - - - - Specified WM_UNDO enumeration value. - - - - - Specified WM_RENDERFORMAT enumeration value. - - - - - Specified WM_RENDERALLFORMATS enumeration value. - - - - - Specified WM_DESTROYCLIPBOARD enumeration value. - - - - - Specified WM_DRAWCLIPBOARD enumeration value. - - - - - Specified WM_PAINTCLIPBOARD enumeration value. - - - - - Specified WM_VSCROLLCLIPBOARD enumeration value. - - - - - Specified WM_SIZECLIPBOARD enumeration value. - - - - - Specified WM_ASKCBFORMATNAME enumeration value. - - - - - Specified WM_CHANGECBCHAIN enumeration value. - - - - - Specified WM_HSCROLLCLIPBOARD enumeration value. - - - - - Specified WM_QUERYNEWPALETTE enumeration value. - - - - - Specified WM_PALETTEISCHANGING enumeration value. - - - - - Specified WM_PALETTECHANGED enumeration value. - - - - - Specified WM_HOTKEY enumeration value. - - - - - Specified WM_PRINT enumeration value. - - - - - Specified WM_PRINTCLIENT enumeration value. - - - - - Specified WM_HANDHELDFIRST enumeration value. - - - - - Specified WM_HANDHELDLAST enumeration value. - - - - - Specified WM_AFXFIRST enumeration value. - - - - - Specified WM_AFXLAST enumeration value. - - - - - Specified WM_PENWINFIRST enumeration value. - - - - - Specified WM_PENWINLAST enumeration value. - - - - - Specified WM_APP enumeration value. - - - - - Specified WM_USER enumeration value. - - - - - Specified WM_REFLECT enumeration value. - - - - - Specified WM_THEMECHANGED enumeration value. - - - - - - - - - - 关键词 - - - - - 密码 - - - - - 权限用户id - - - - - - - - - - - - - 返回关键词 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 树形控件，用于分类用 - - - - - 显示在第一位的名称 - - - - - 是否显示菜单 - - - - - 树形控件 - - - - - 判断指定节点是否是目标节点的子节点 - - - - - - - - - 判断当前节点，当前用户是否有权限访问 - - - - - - - - - 权限事件 - - - - - - - - 选择权限用户时发生 - - - - - 数据变化时发生 - - - - - 数据变化前发生 - - - - - 操作事件 - - - - - - - 在添加分组前发生 - - - - - 在修改分组前发生 - - - - - 在删除分组前发生 - - - - - 在设置密码前发生 - - - - - 在设置权限前发生 - - - - - 获取新的关键词分类 - - - - - - 根据id获取节点 - - - - - - - 根据节点获取节点信息 - - - - - - - 设置节点信息 - - - - - - - 设置节点关键词和密码 - - - - - - - - 设置节点密码 - - - - - - - 设置节点关键词 - - - - - - - 设置节点用户 - - - - - - - RecursionTreeControl:表示将XML文件的内容显示在TreeView控件中 - - 将要加载的XML文件中的节点元素 - 将要加载的XML文件中的节点集合 - - - - 把XML文本载入到列表中 - - - - - - 把XML文件载入到列表中 - - - - - - 将列表保存为xml文本 - - - - - - 改变所有子节点的状态 - - - - - - - 反选子节点 - - - - - - 根据关键词来选中列表 - - - - - - 根据关键词来选中列表 - - - - - - 格式化关键字(会去除重复项)，以便存入数据库 - - - - - - - 去除掉重复项 - - - - - - - 获取当前选中项以及所有父项的关键词组合 - - - - - - 获取选中的 - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - 是否为添加 - - - - - 选择的文本 - - - - - 选择的Tag - - - - - 选择的图片序号 - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - 旧密码 - - - - - 新密码 - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - 颜色标签 - - - - - 行间距 - - - - - 颜色标签 - - - - - 更新 - - - - - 字体高度 - - - - - 控件高 - - - - - 控件文本 - - - - - 获取过滤掉颜色的字 - - - - - - - 改变字体 - - - - - - - - - - - - - - 密码控件 - - - - - - - - - - 密码 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 分页控件 - - - - - 首页文本 - - - - - 上一页文本 - - - - - 下一页文本 - - - - - 末页文本 - - - - - 跳页文本 - - - - - 页面信息文本 - - - - - 存储SQL参数 - - - - - 最后一页的页码 - - - - - 在发生页码变化时激发 - - - - - 在发生页码变化前激发 - - - - - 设置/返回每页显示的量大小 - - - - - 设置/返回记录总数 - - - - - 设置/返回分页SQL语句,{pagecount}表示页数,{recordcount}表示记录总数,{pagesize}表示页面大小, - {pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 - - - - - 设置/返回当{recordnum}小于等于0时的分页SQL语句(比如第一页),如果为空，则默认使用SQLText值。{pagecount}表示页数, - {recordcount}表示记录总数,{pagesize}表示页面大小,{pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 - - - - - 获取当前页码 - - - - - - 设置分页语句 - - 数据库类型 - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 获取数据库指定条件的记录总数 - - 数据库类型 - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - - - - - 设置分页语句为MySQL分页语句 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 获取MySQL数据库指定条件的记录总数 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - - - - - 设置分页语句为MSSQL分页语句 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 获取MSSQL数据库指定条件的记录总数 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 设置分页语句为SQLite分页语句 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 设置分页语句为SQLite分页语句 - - 表名 - 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 - - - - - 获取SQLite数据库指定条件的记录总数 - - 表名 - 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 - - - - - 返回分页SQL语句 - - - - - 分页控件 - - - - - 设置当前页为指定页 - - - - - - 下一页 - - - - - 上一页 - - - - - 末页 - - - - - 首页 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 自动排列控件 - - - - - 最大列数 - - - - - 开始排列的坐标 - - - - - 下一项的位置 - - - - - 下一项的右下角坐标 - - - - - 竖向间隔像素 - - - - - 横向间隔像素 - - - - - 最小保留右边距,只对ReDraw2有效 - - - - - 自动排列控件构造函数 - - - - - - 自动排列控件构造函数 - - - - - - - - 开始排列控件 - - - - - 开始排列控件,当列数超过显示空间时，自动换行 - - - - - 加入的控件列表 - - - - - 初始化添加,自动将容器设置为滚动条自动显示 - - - - - - 添加控件 - - - - - - - 删除控件 - - - - - - 删除控件 - - - - - - 清空所有控件 - - - - - This enum represents the possible browser commands - - - - - Used when no commans are available - - - - - Used in the new navigation events - - - - - The URL to navigate to - - - - - The name of the frame to navigate to - - - - - The flags when opening a new window - - - - - The pointer to ppDisp - - - - - Creates a new instance of WebBrowserExtendedNavigatingEventArgs - - Pointer to the automation object of the browser - The URL to go to - The name of the frame - The new window flags - - - - - - - - - Used in the new navigation events - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 查看源码 - - - - - 复制当前选中区 - - - - - 粘贴当前选中区 - - - - - 剪切当前选中区 - - - - - 全选 - - - - - 清除当前选中区的选中状态。 - - - - - 从当前选中区中删除全部超级链接。 - - - - - 从当前选中区中删除全部书签。 - - - - - 删除当前选中区 - - - - - 重做 - - - - - 撤销 - - - - - 从当前选中区中删除格式化标签。 - - - - - 点击节点 - - - - - - - - 点击节点 - - - - - - - - - 点击元素 - - 节点名 - 属性 - 属性值 - 等待毫秒数 - 第几个符合的元素,从1开始 - - - - 等待多时毫秒 - - - - - - Represents event information for the main form, when the command state of the active browser changes - - - - - Creates a new instance of the class - - A list of commands that are available - - - - Gets a list of commands that are available - - - - - An extended version of the control. - - - - - - - - - - - - 在页面弹出消息对话框时激发 - - - - - - - - - - - - - - - - - - - - - - 打开页面并等待页面加载完毕 - - 要打开的页面地址 - 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 - - - - 等待页面加载完毕 - - 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 - - - - 等待指定毫秒 - - 等待指定毫秒 - - - - 获取网页源代码,可以自动去除乱码 - - - - - - 加载html文本到浏览器中 - - - - - - - 加载html文本到浏览器中 - - - - - - 强制用本窗体打开新链接 - - - - - - - - - - - This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. - Called by the control when the underlying ActiveX control is created. - - - - - - This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. - Called by the control when the underlying ActiveX control is discarded. - - - - - Returns the automation object for the web browser - - - - - This method will be called to give you a chance to create your own event sink - - - - - Detaches the event sink - - - - - 在文档下载开始时激发 - - - - - Raises the event - - Empty - - You could start an animation or a notification that downloading is starting - - - - - 下载完成后触发 - - - Here you could start monitoring for script errors. - - - - - Raises the event - - Empty - - - - 在开始浏览新网页时激发. - - - - - 在打开新的网页窗口时激发 - - - - - Raises the event - - Thrown when BrowserExtendedNavigatingEventArgs is null - - - - Raises the event - - Thrown when BrowserExtendedNavigatingEventArgs is null - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 新窗口事件,只限Window XP SP2或以上系统支持 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - / - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Overridden - - The send to this procedure - - - - A list of all the available window messages - - - - - Raises the event - - - - - 在网页窗口关闭时激发 - - - Do not confuse this with DWebBrowserEvents2.Quit... That's something else. - - - - - Flags used by INewWindowManager::EvaluateNewWindow. - These values are taken into account in the decision of whether to display a pop-up window. - - - - - No information Present - - - - - The page is unloading. This flag is set in response to the onbeforeunload and onunload events. - Some pages load pop-up windows when you leave them rather than when you enter. This flag is used to identify those situations. - - - - - The call to INewWindowManager::EvaluateNewWindow is the result of a user-initiated action - (a mouse click or key press). Use this flag in conjunction with the NWMF_FIRST_USERINITED flag - to determine whether the call is a direct or indirect result of the user-initiated action. - - - - - When NWMF_USERINITED is present, this flag indicates that the call to - INewWindowManager::EvaluateNewWindow is the first query that results from this user-initiated action. - Always use this flag in conjunction with NWMF_USERINITED. - - - - - The override key (ALT) was pressed. The override key is used to bypass the pop-up manager梐llowing - all pop-up windows to display梐nd must be held down at the time that INewWindowManager::EvaluateNewWindow is called. - - - - - The new window attempting to load is the result of a call to the showHelp method. Help is sometimes displayed in a separate window, - and this flag is valuable in those cases. - - - - - The new window is a dialog box that displays HTML content. - - - - - Indicates that the EvaluateNewWindow method is being called through a marshalled Component Object Model (COM) proxy - from another thread. In this situation, the method should make a decision and return immediately without performing - blocking operations such as showing modal user interface (UI). Lengthy operations will cause the calling thread to - appear unresponsive. - - - - - HRESULT constants - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - a form that supports custom theme - - - - - 标签新建按钮事件 - - - - - 标签关闭按钮事件 - - - - - 标签创建时事件 - - - - - 在标签栏创建时激发 - - - - - - - 内边距 - - - - - 默认内边距 - - - - - 标题 - - - - - 皮肤/主题 - - - - - 是否可拖动改变窗体大小 - - - - - 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 - - - - - 窗体边框大小 - - - - - 标题栏高度 - - - - - 窗体圆角程度 - - - - - 窗体圆角样式 - - - - - 控制按钮相对于右上角的偏移量 - - - - - 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 - - - - - 标题栏图标尺寸 - - - - - 窗体图标,如果设置本项,将不使用Icon属性 - - - - - 标题栏图标与窗体左边框的距离 - - - - - 标题距离左边的距离 - - - - - 窗体关闭按钮的尺寸 - - - - - 窗体最大化/还原按钮的大小 - - - - - 窗体最小化按钮的大小 - - - - - 是否显示阴影 - - - - - 窗体阴影宽度 - - - - - 使用阴影来缩放 - - - - - 窗体阴影颜色 - - - - - 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 - - - - - 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 - - - - - 表示去掉自画的边框及标题栏后，剩下的可用的客户区区域，坐标相对于窗体左上角 - - - - - 表示去掉自画的边框及标题栏后，剩下的可用的客户区大小 - - - - - 表示MDI标签栏的区域，包括bottom-region - - - - - MGdUI皮肤 - - - - - 获取子窗体 - - - - - - 通过sendmessage方式激活子窗体以避免闪烁 - - - - - - 当子窗体关闭时激发 - - - - - - - 子窗体可视化变化 - - - - - - - 获取当前的子窗体列表 - - - - - - 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最小化 - - - - - 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最大化 - - - - - to make the client area to have 3D view - - - - - 消息 - - - - - - 画UI - - - - - - 在画背景时激发 - - - - - - 重写该方法解决在VS设计器中，每次保存一个新的尺寸，再打开尺寸会变大的问题 - - - - - 创建控件时激发 - - - - - 窗体可见变化时激发 - - - - - - 大小改变时激发 - - - - - - 在位置变化时激发 - - - - - - 窗体激活 - - - - - - 窗体关闭后激发 - - - - - - 加载时 - - - - - - 在子窗体激活时激发 - - - - - - 标签菜单 - - - - - 窗体上移动鼠标时激发 - - - - - - 获取当前点击的标签项 - - - - - 在窗体上按下鼠标时激发 - - - - - - 在窗体上放开鼠标时激发 - - - - - - 在鼠标离开窗体时激发 - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - 该类处理mdi-bar的绘制及鼠标事件管理 - - - - - use left,top,right to location the bar in owner form, - the margin is from Form.ClientRectangle - - - - - 整个标签栏高度,包含标签栏底部区域、标签、标签顶部空隙 - - - - - 标签栏底部区域的高度 - - - - - 是否显示标签栏边框 - - - - - 是否显示标签栏背景 - - - - - 标签栏左内边距 - - - - - 标签栏右内边距 - - - - - 标签高度 - - - - - 激活的标签高度 - - - - - tab顶部与bar顶部的空间,这个值用来计算 BarHeight - - - - - 每个标签的左右边界可以不是垂直的，而是都有一个斜度 - - - - - tab与tab之间的距离，用负值可以使tab有重叠的效果 - - - - - 标签是否显示图标 - - - - - 是否显示标签关闭按钮 - - - - - 标签图标大小 - - - - - 标签图标距离左边的距离 - - - - - 标签文字距离左边的距离 - - - - - 标签关闭按钮的大小 - - - - - 标签关闭按钮距离右边的距离 - - - - - 是否显示新建标签按钮 - - - - - 新建标签按钮的大小 - - - - - 新建标签距离左边的距离 - - - - - 按钮与Bar底部的距离 - - - - - 一个tab允许的最小宽度 - - - - - 一个tab允许的最大显示宽度 - - - - - 标签正常宽度 - - - - - 同步_listTabItems与mdi主窗体实际存在的子form - - - - - 为每个tab分配空间，如果tab数目太多，则有些会被隐藏 - - - - - 重绘整个标签栏 - - - - - - 处理鼠标事件。该方法会触发一些click事件，重刷一些按钮等 - - - - - - - 该类表示一个单独的标签项 - - - - - 该标签所对应的窗体 - - - - - 最终分配到的整个tab的宽度 - - - - - 表示所对应的form是否仍未被关闭 - - - - - 是否因空间不足而被隐藏 - - - - - 返回全部显示该标签文本所需的长度 - - - - - - 返回显示全部文本时该tab所需的宽度,该宽度不超过bar-container - 规定的tabmaxwidth - - - - - - 居左 - - - - - 显示在最后一个标签后面 - - - - - 该类封装设置一个主题所需的信息，可以继承该类实现不同的主题 - - - - - 主题名称，用于标识主题，对主题进行简单描述 - - - - - 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 - - - - - 窗体边框大小 - - - - - 窗体标题栏高度 - - - - - 标题栏图标与窗体左边框的距离 - - - - - 标题栏图标尺寸 - - - - - 标题栏文本左边距 - - - - - 控制按钮（关闭按钮）相对于窗体右上角的偏移量 - - - - - 窗体关闭按钮的尺寸 - - - - - 窗体最大化/还原按钮的大小 - - - - - 窗体最小化按钮的大小 - - - - - 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 - - - - - 窗体圆角程度 - - - - - 窗体圆角样式 - - - - - 是否使用默认的圆角样式，该样式为左上角和右上角圆角， - 最好在窗体边框较粗时才使用该样式 - - - - - 是否在标题栏上绘制图标 - - - - - 是否在标题栏上绘制文本 - - - - - 是否显示窗体阴影 - - - - - 窗体阴影大小 - - - - - 拖动窗体阴影是否可以改变窗体大小 - - - - - 阴影的颜色，可以设置成其他颜色而不一定是黑色 - - - - - 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 - - - - - 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 - - - - - 是否在客户区边界画线使其看起来有立体感 - - - - - 窗体标题栏文字是否居中显示 - - - - - 窗体边框最外一像素的颜色 - - - - - 窗体边框第二最外像素的颜色 - - - - - 窗体边框其他部分颜色，如果窗体边框大小大于2，则其他像素将用此颜色画出 - - - - - 标题栏颜色是从上到下渐变的，这个值设置上边的颜色值 - - - - - 标题栏颜色是从上到下渐变的，这个值设置下边的颜色值 - - - - - 标题栏文字颜色 - - - - - 窗体背景颜色，该值将覆盖窗体自带的BackColor属性值 - - - - - 窗体关闭按钮的颜色集合 - - - - - 窗体最大化/还原按钮的颜色集合 - - - - - 窗体最小化按钮的颜色集合 - - - - - 默认状态下关闭按钮背景图片 - - - - - 鼠标移过去时关闭按钮背景图片 - - - - - 鼠标按下时关闭按钮背景图片 - - - - - 默认状态下最大化按钮背景图片 - - - - - 鼠标移过去时最大化按钮背景图片 - - - - - 鼠标按下时最大化按钮背景图片 - - - - - 默认状态下恢复按钮背景图片 - - - - - 鼠标移过去时恢复按钮背景图片 - - - - - 鼠标按下时恢复按钮背景图片 - - - - - 默认状态下最小化按钮背景图片 - - - - - 鼠标移过去时最小化按钮背景图片 - - - - - 鼠标按下时最小化按钮背景图片 - - - - - 是否用SendMessage的方式切换子窗体，以避免子窗体切换时产生的闪烁 - - - - - Mdi-Bar与窗体左、上、右边界的距离，只用到这三个值，Bottom值没用到。 - 用这三个值来确定Mdi-Bar的宽度及其在窗体中的位置 - - - - - 内部左边空白，第一个标签将从这个空白距离之后开始 - - - - - 标签栏内部右边空白 - - - - - 标签栏背景颜色 - - - - - 标签栏边框颜色 - - - - - 标签栏背景图片 - - - - - 是否显示标签栏边框 - - - - - 标签栏下边区域的背景颜色 - - - - - 标签栏下边区域的高度 - - - - - 标签高度 - - - - - 被选中的标签高度，可以设置成与TabHeight不一样的值，以突出显示被选中状态 - - - - - 标签之间的距离，设成负值可以使标签有重叠的效果 - - - - - 标签的最大宽度，任何情况下标签都不能超过这个宽度 - - - - - 标签正常宽度，如果标签需要很短的宽度（比如20像素）就可以显示完上面的文字， - 但是Mdi-Bar上有足够的空间时，标签会以正常宽度（比如100像素）显示 - - - - - 标签最小宽度，当标签小于这个宽度时将被隐藏 - - - - - 标签梯度大小，标签可以不以矩形方式显示，而是有一个梯度/斜度。 - - - - - 标签顶部空白，这个值用于参与计算Mdi-Bar高度，计算方式为： - Mdi-Bar Height = BottomRegionHeight + TabHeight + TabTopSpace - - - - - 标签上是否显示子窗体图标 - - - - - 标签上是否显示子窗体关闭图标 - - - - - 选中状态的标签的上部背景色，与下部背景色不同时，标签背景色就有渐变效果 - - - - - 选中状态的标签的下部背景色，与上部背景色不同时，标签背景色就有渐变效果 - - - - - 标签激活时字体颜色 - - - - - 非选中状态的标签的字体颜色 - - - - - 非选中状态的标签的上部背景色 - - - - - 非选中状态的标签的下部背景色 - - - - - 标签外边框颜色 - - - - - 标签内边框颜色，这个颜色一般具有一定的透明度 - - - - - 是否显示标签边框 - - - - - 是否显示默认的新建标签按钮(NewTabBtn) - - - - - NewTabBtn与下边框的距离，这个值用来定位按钮的Y坐标 - - - - - 新建标签按钮与左边框的距离，这个值用来定位按钮的X坐标 - - - - - 新建标签按钮大小 - - - - - 按钮颜色集合 - - - - - 是否一直显示ListAllBtn，即使在没有标签被隐藏的情况下 - - - - - 《显示全部标签》按钮的位置 - - - - - 《显示全部标签》按钮与下边框的距离，这个值用来定位按钮的Y坐标 - - - - - 《显示全部标签》按钮与左边框的距离，这个值用来定位按钮的X坐标 - - - - - 《显示全部标签》按钮的颜色 - - - - - 《显示全部标签》按钮的大小 - - - - - 皮肤主题 - - - - - 设置百分比 - - - - - - - - - 引发 ValueChanged 事件 - - - - - - 引发 ThemeChanged 事件 - - - - - - 指示鼠标位于哪个区域 - - - - - 控件Value值发生变化后引发 - - - - - 控件绘制MainLine前引发, 可以设置Cancel参数来取消默认的绘制 - - - - - 控件绘制Button前引发 - - - - - 引发 ValueChanged 事件 - - - - - 引发 BeforePaintMainLine 事件 - - - - - 引发 BeforePaintButton 事件 - - - - - 将Value值加一个LargeChange量 - - - - - 将Value值减一个LargeChange量 - - - - - 将Value值加一个SmallChange量 - - - - - 将Value值减一个SmallChange量 - - - - - 提供产生各种路径的静态方法，比如圆角路径、关闭按钮上的x路径、+号路径 - - - - - 圆角样式 - - - - - 无 - - - - - 所有 - - - - - 上 - - - - - 下 - - - - - 左 - - - - - 右 - - - - - SimpleObject指的是只有一种状态（不像普通按钮一样有三种状态），并且其上的元素 - 布局比较简单的Object - - - - - - - - - - - - - - - - - - - - DevExpress风格皮肤 - - - - - DevExpress风格皮肤 - - - - - 新风格皮肤 - - - - - 新风格皮肤 - - - - - 基础皮肤 - - - - - VS2013风格皮肤 - - - - - this theme is just for chrome one quarter style - - - - - for diamond ring style only - - - - - Location of cursor hot spot returnet in WM_NCHITTEST. - - - - - On the screen background or on a dividing line between windows - (same as HTNOWHERE, except that the DefWindowProc function produces a system beep to indicate an error). - - - - - In a window currently covered by another window in the same thread - (the message will be sent to underlying windows in the same thread until one of them returns a code that is not HTTRANSPARENT). - - - - - On the screen background or on a dividing line between windows. - - - - In a client area. - - - In a title bar. - - - In a window menu or in a Close button in a child window. - - - In a size box (same as HTSIZE). - - - In a menu. - - - In a horizontal scroll bar. - - - In the vertical scroll bar. - - - In a Minimize button. - - - In a Maximize button. - - - In the left border of a resizable window - (the user can click the mouse to resize the window horizontally). - - - - In the right border of a resizable window - (the user can click the mouse to resize the window horizontally). - - - - In the upper-horizontal border of a window. - - - In the upper-left corner of a window border. - - - In the upper-right corner of a window border. - - - In the lower-horizontal border of a resizable window - (the user can click the mouse to resize the window vertically). - - - In the lower-left corner of a border of a resizable window - (the user can click the mouse to resize the window diagonally). - - - In the lower-right corner of a border of a resizable window - (the user can click the mouse to resize the window diagonally). - - - In the border of a window that does not have a sizing border. - - - In a Close button. - - - In a Help button. - - - - Contains the new coordinates of a window that has been moved or resized, that is, it is the proposed new window coordinates. - - - - - Contains the coordinates of the window before it was moved or resized. - - - - - Contains the coordinates of the window's client area before the window was moved or resized. - - - - - Pointer to a WINDOWPOS structure that contains the size and position values specified in the operation that moved or resized the window. - - - - - - - - - - 是否在这个按钮上按下了鼠标未释放 - - - - - 是否可见 - - - - - - - - - - 画两次可以加深颜色 - - - - - 用于在click事件中传回数据 - - - - - 获取或设置是否将绘制完全限制在指定的区域内 - - - - - - - - - - - - - - - - - 线条图 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - 画值 - - 画布 - X轴数据 - - - - 走势图 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - 初始化参数 - - - - - 返回或设置X轴间隔 - - - - - 标题 - - - - - 返回图片的宽度 - - - - - 返回或设置图片的高度 - - - - - X轴的间距 - - - - - Y轴的间距 - - - - - 标题的颜色 - - - - - 标题的字体 - - - - - 背景颜色 - - - - - X轴的颜色 - - - - - Y轴的颜色 - - - - - 返回X轴数据的最大值(供给Painter调用) - - - - - 返回图片数据 - - - - - 画布 - - - - - 作图器 - - - - - 释放内容资源 - - - - - 获取X轴中的最大值 - - - - - - - 获取所有X轴列中的最大值 - - - - - - - 初始化图片 - - X轴的数据 - - - - - 画一条走势图 - - - - - - 画多条走势图 - - - - - - 作图器的基础类 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - 返回此作图器的相关链走势图 - - - - - 获取某值在Y轴上的位置 - - 当前点的值 - 点坐标 - - - - 画XY轴线 - - 画布 - X轴的数据 - - - - 画标题 - - - - - - 画走势线 - - 画布 - X轴数据 - - - - 方块图 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - 画值 - - 画布 - X轴数据 - - - - 走势图的X轴数据 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - - - - - - - - 标题 - - - - - 值 - - - - - 标题的颜色 - - - - - 标题的字体 - - - - - 值的颜色 - - - - - 值的字体 - - - - - 绘制颜色 - - - - - 值是否可见 - - - - - 克隆自身 - - - - - - 定义X轴的数据集合 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - - - - - - 添加一批数据 - - 轴的标题 - - - - 添加一批数据 - - 轴的标题 - 轴的值 - - - - 重置轴的值 - - 轴的值 - - - - 克隆数据 - - - - - - Indicates the behavior of a key when a cell "on the edge" is being edited. - and the normal behavior of that key would exceed the edge. For example, - for a key that normally moves one column to the left, the "edge" would be - the left most column, since the normal action of the key cannot be taken - (since there are no more columns to the left). - - - - - 按键将被忽略 - - - - - 按键将导致单元格编辑环绕到相对边缘的单元格。 - - - - - 按键将Wrap，但该列将更改为相应的相邻列。这只对正常操作为ChangeRow的键有意义。 - - - - - 按键将Wrap，但该行将更改为相应的相邻行。这只对正常操作为ChangeColumn的键有意义. - - - - - 该键将导致当前编辑操作结束。 - - - - - Indicates the normal behaviour of a key when used during a cell edit - operation. - - - - - The key press will be ignored - - - - - The key press will end the current edit and begin an edit - operation on the next editable cell to the left. - - - - - The key press will end the current edit and begin an edit - operation on the next editable cell to the right. - - - - - The key press will end the current edit and begin an edit - operation on the row above. - - - - - The key press will end the current edit and begin an edit - operation on the row below - - - - - The key press will cancel the current edit - - - - - The key press will finish the current edit operation - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Instances of this class handle key presses during a cell edit operation. - - - - - 设置给定键的行为 - - - - - - - - 处理按键操作 - - - - True if the key was completely handled. - - - - Gets or sets the ObjectListView on which the current key is being handled. - This cannot be null. - - - - - Gets the row of the cell that is currently being edited - - - - - Gets the index of the column of the cell that is being edited - - - - - Gets or sets the map that remembers the normal behaviour of keys - - - - - Gets or sets the map that remembers the desired behaviour of keys - on edge cases. - - - - - Setup the default key mapping - - - - - Handle the end edit command - - - - - Handle the cancel edit command - - - - - Placeholder that subclasses can override to handle any custom verbs - - - - - - - - Handle a change row command - - - - - - - Handle a change column command - - - - - - - Start editing the indicated cell if that cell is not already being edited - - The row to edit - The cell within that row to edit - - - - Gets the adjacent item to the given item in the given direction. - If that item is disabled, continue in that direction until an enabled item is found. - - The row whose neighbour is sought - The direction of the adjacentness - An OLVListView adjacent to the given item, or null if there are no more enabled items in that direction. - - - - Gets the adjacent item to the given item in the given direction, wrapping if needed. - - The row whose neighbour is sought - The direction of the adjacentness - An OLVListView adjacent to the given item, or null if there are no more items in that direction. - - - - Gets a collection of columns that are editable in the order they are shown to the user - - - - - These items allow combo boxes to remember a value and its description. - - - - - - - - - - - - - - - - - Returns a string that represents the current object. - - - A string that represents the current object. - - 2 - - - - This editor shows and auto completes values from the given listview column. - - - - - Create an AutoCompleteCellEditor - - - - - - - This combo box is specialised to allow editing of an enum. - - - - - - - - - - - This editor simply shows and edits integer values. - - - - - - - - - - Gets or sets the value shown by this editor - - - - - This editor simply shows and edits unsigned integer values. - - This class can't be made public because unsigned int is not a - CLS-compliant type. If you want to use, just copy the code to this class - into your project and use it from there. - - - - This editor simply shows and edits boolean values. - - - - - - - - - - This editor simply shows and edits boolean values using a checkbox - - - - - Gets or sets the value shown by this editor - - - - - Gets or sets how the checkbox will be aligned - - - - - This editor simply shows and edits floating point values. - - You can intercept the CellEditStarting event if you want - to change the characteristics of the editor. For example, by increasing - the number of decimal places. - - - - - - - - - Gets or sets the value shown by this editor - - - - - A delegate that creates an editor for the given value - - The model from which that value came - The column for which the editor is being created - A representative value of the type to be edited. This value may not be the exact - value for the column/model combination. It could be simply representative of - the appropriate type of value. - A control which can edit the given value - - - - An editor registry gives a way to decide what cell editor should be used to edit - the value of a cell. Programmers can register non-standard types and the control that - should be used to edit instances of that type. - - - All ObjectListViews share the same editor registry. - - - - - Create an EditorRegistry - - - - - Register that values of 'type' should be edited by instances of 'controlType'. - - The type of value to be edited - The type of the Control that will edit values of 'type' - - ObjectListView.EditorRegistry.Register(typeof(Color), typeof(MySpecialColorEditor)); - - - - - Register the given delegate so that it is called to create editors - for values of the given type - - The type of value to be edited - The delegate that will create a control that can edit values of 'type' - - ObjectListView.EditorRegistry.Register(typeof(Color), CreateColorEditor); - ... - public Control CreateColorEditor(Object model, OLVColumn column, Object value) - { - return new MySpecialColorEditor(); - } - - - - - Register a delegate that will be called to create an editor for values - that have not been handled. - - The delegate that will create a editor for all other types - - - - Register a delegate that will be given a chance to create a control - before any other option is considered. - - The delegate that will create a control - - - - Remove the registered handler for the given type - - Does nothing if the given type doesn't exist - The type whose registration is to be removed - - - - Create and return an editor that is appropriate for the given value. - Return null if no appropriate editor can be found. - - The model involved - The column to be edited - The value to be edited. This value may not be the exact - value for the column/model combination. It could be simply representative of - the appropriate type of value. - A Control that can edit the given type of values - - - - Create and return an editor that will edit values of the given type - - A enum type - - - - A DataListView is a ListView that can be bound to a datasource (which would normally be a DataTable or DataView). - - - This listview keeps itself in sync with its source datatable by listening for change events. - The DataListView will automatically create columns to show all of the data source's columns/properties, if there is not already - a column showing that property. This allows you to define one or two columns in the designer and then have the others generated automatically. - If you don't want any column to be auto generated, set to false. - These generated columns will be only the simplest view of the world, and would look more interesting with a few delegates installed. - This listview will also automatically generate missing aspect getters to fetch the values from the data view. - Changing data sources is possible, but error prone. Before changing data sources, the programmer is responsible for modifying/resetting - the column collection to be valid for the new data source. - Internally, a CurrencyManager controls keeping the data source in-sync with other users of the data source (as per normal .NET - behavior). This means that the model objects in the DataListView are DataRowView objects. If you write your own AspectGetters/Setters, - they will be given DataRowView objects. - - - - - Make a DataListView - - - - - - - - - - - Gets or sets whether or not columns will be automatically generated to show the - columns when the DataSource is set. - - This must be set before the DataSource is set. It has no effect afterwards. - - - - Get or set the DataSource that will be displayed in this list view. - - The DataSource should implement either , , - or . Some common examples are the following types of objects: - - - - - - - - When binding to a list container (i.e. one that implements the - interface, such as ) - you must also set the property in order - to identify which particular list you would like to display. You - may also set the property even when - DataSource refers to a list, since can - also be used to navigate relations between lists. - When a DataSource is set, the control will create OLVColumns to show any - data source columns that are not already shown. - If the DataSource is changed, you will have to remove any previously - created columns, since they will be configured for the previous DataSource. - . - - - - - Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. - - If the data source is not a DataSet or DataViewManager, this property has no effect - - - - Gets or sets the DataSourceAdaptor that does the bulk of the work needed - for data binding. - - - Adaptors cannot be shared between controls. Each DataListView needs its own adapter. - - - - - Add the given collection of model objects to this control. - - A collection of model objects - This is a no-op for data lists, since the data - is controlled by the DataSource. Manipulate the data source - rather than this view of the data source. - - - - Insert the given collection of objects before the given position - - Where to insert the objects - The objects to be inserted - This is a no-op for data lists, since the data - is controlled by the DataSource. Manipulate the data source - rather than this view of the data source. - - - - Remove the given collection of model objects from this control. - - This is a no-op for data lists, since the data - is controlled by the DataSource. Manipulate the data source - rather than this view of the data source. - - - - Change the Unfreeze behaviour - - - - - Handles parent binding context changes - - Unused EventArgs. - - - - A DataTreeListView is a TreeListView that calculates its hierarchy based on - information in the data source. - - - Like a , a DataTreeListView sources all its information - from a combination of and . - can be a DataTable, DataSet, - or anything that implements . - - - To function properly, the DataTreeListView requires: - - the table to have a column which holds a unique for the row. The name of this column must be set in . - the table to have a column which holds id of the hierarchical parent of the row. The name of this column must be set in . - a value which identifies which rows are the roots of the tree (). - - The hierarchy structure is determined finding all the rows where the parent key is equal to . These rows - become the root objects of the hierarchy. - - Like a TreeListView, the hierarchy must not contain cycles. Bad things will happen if the data is cyclic. - - - - - Gets or sets whether or not columns will be automatically generated to show the - columns when the DataSource is set. - - This must be set before the DataSource is set. It has no effect afterwards. - - - - Get or set the DataSource that will be displayed in this list view. - - The DataSource should implement either , , - or . Some common examples are the following types of objects: - - - - - - - - When binding to a list container (i.e. one that implements the - interface, such as ) - you must also set the property in order - to identify which particular list you would like to display. You - may also set the property even when - DataSource refers to a list, since can - also be used to navigate relations between lists. - - - - - Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. - - If the data source is not a DataSet or DataViewManager, this property has no effect - - - - Gets or sets the name of the property/column that uniquely identifies each row. - - - - The value contained by this column must be unique across all rows - in the data source. Odd and unpredictable things will happen if two - rows have the same id. - - Null cannot be a valid key value. - - - - - Gets or sets the name of the property/column that contains the key of - the parent of a row. - - - - The test condition for deciding if one row is the parent of another is functionally - equivilent to this: - - Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) - - - Unlike key value, parent keys can be null but a null parent key can only be used - to identify root objects. - - - - - Gets or sets the value that identifies a row as a root object. - When the ParentKey of a row equals the RootKeyValue, that row will - be treated as root of the TreeListView. - - - - The test condition for deciding a root object is functionally - equivilent to this: - - Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) - - - The RootKeyValue can be null. Actually, it can be any value that can - be compared for equality against a basic type. - If this is set to the wrong value (i.e. to a value that no row - has in the parent id column), the list will be empty. - - - - - Gets or sets the value that identifies a row as a root object. - . The RootKeyValue can be of any type, - but the IDE cannot sensibly represent a value of any type, - so this is a typed wrapper around that property. - - - If you want the root value to be something other than a string, - you will have set it yourself. - - - - - Gets or sets whether or not the key columns (id and parent id) should - be shown to the user. - - This must be set before the DataSource is set. It has no effect - afterwards. - - - - Gets or sets the DataSourceAdaptor that does the bulk of the work needed - for data binding. - - - - - An IDragSource controls how drag out from the ObjectListView will behave - - - - - A drag operation is beginning. Return the data object that will be used - for data transfer. Return null to prevent the drag from starting. The data - object will normally include all the selected objects. - - - The returned object is later passed to the GetAllowedEffect() and EndDrag() - methods. - - What ObjectListView is being dragged from. - Which mouse button is down? - What item was directly dragged by the user? There may be more than just this - item selected. - The data object that will be used for data transfer. This will often be a subclass - of DataObject, but does not need to be. - - - - What operations are possible for this drag? This controls the icon shown during the drag - - The data object returned by StartDrag() - A combination of DragDropEffects flags - - - - The drag operation is complete. Do whatever is necessary to complete the action. - - The data object returned by StartDrag() - The value returned from GetAllowedEffects() - - - - A do-nothing implementation of IDragSource that can be safely subclassed. - - - - - See IDragSource documentation - - - - - - - - - See IDragSource documentation - - - - - - - See IDragSource documentation - - - - - - - A reasonable implementation of IDragSource that provides normal - drag source functionality. It creates a data object that supports - inter-application dragging of text and HTML representation of - the dragged rows. It can optionally force a refresh of all dragged - rows when the drag is complete. - - Subclasses can override GetDataObject() to add new - data formats to the data transfer object. - - - - Construct a SimpleDragSource - - - - - Construct a SimpleDragSource that refreshes the dragged rows when - the drag is complete - - - - - - Gets or sets whether the dragged rows should be refreshed when the - drag operation is complete. - - - - - Create a DataObject when the user does a left mouse drag operation. - See IDragSource for further information. - - - - - - - - - Which operations are allowed in the operation? By default, all operations are supported. - - - All opertions are supported - - - - The drag operation is finished. Refreshe the dragged rows if so configured. - - - - - - - Create a data object that will be used to as the data object - for the drag operation. - - - Subclasses can override this method add new formats to the data object. - - The ObjectListView that is the source of the drag - A data object for the drag - - - - Objects that implement this interface can acts as the receiver for drop - operation for an ObjectListView. - - - - - Gets or sets the ObjectListView that is the drop sink - - - - - Draw any feedback that is appropriate to the current drop state. - - - Any drawing is done over the top of the ListView. This operation should disturb - the Graphic as little as possible. Specifically, do not erase the area into which - you draw. - - A Graphic for drawing - The contents bounds of the ListView (not including any header) - - - - The user has released the drop over this control - - - Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned - to the originator of the drag. - - - - - - A drag has entered this control. - - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - Change the cursor to reflect the current drag operation. - - - - - - The drag has left the bounds of this control - - - - - The drag is moving over this control. - - This is where any drop target should be calculated. - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - - Should the drag be allowed to continue? - - - - - - This is a do-nothing implementation of IDropSink that is a useful - base class for more sophisticated implementations. - - - - - Gets or sets the ObjectListView that is the drop sink - - - - - Draw any feedback that is appropriate to the current drop state. - - - Any drawing is done over the top of the ListView. This operation should disturb - the Graphic as little as possible. Specifically, do not erase the area into which - you draw. - - A Graphic for drawing - The contents bounds of the ListView (not including any header) - - - - The user has released the drop over this control - - - Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned - to the originator of the drag. - - - - - - A drag has entered this control. - - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - The drag has left the bounds of this control - - - - - The drag is moving over this control. - - This is where any drop target should be calculated. - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - - Change the cursor to reflect the current drag operation. - - You only need to override this if you want non-standard cursors. - The standard cursors are supplied automatically. - - - - - Should the drag be allowed to continue? - - - You only need to override this if you want the user to be able - to end the drop in some non-standard way, e.g. dragging to a - certain point even without releasing the mouse, or going outside - the bounds of the application. - - - - - - This is called when the mouse leaves the drop region and after the - drop has completed. - - - - - The enum indicates which target has been found for a drop operation - - - - - No applicable target has been found - - - - - The list itself is the target of the drop - - - - - An item is the target - - - - - Between two items (or above the top item or below the bottom item) - can be the target. This is not actually ever a target, only a value indicate - that it is valid to drop between items - - - - - Above an item is the target - - - - - Below an item is the target - - - - - A subitem is the target of the drop - - - - - On the right of an item is the target (not currently used) - - - - - On the left of an item is the target (not currently used) - - - - - This class represents a simple implementation of a drop sink. - - - Actually, it should be called CleverDropSink -- it's far from simple and can do quite a lot in its own right. - - - - - Make a new drop sink - - - - - Get or set the locations where a drop is allowed to occur (OR-ed together) - - - - - Gets or sets whether this sink allows model objects to be dragged from other lists. Defaults to true. - - - - - Gets or sets whether the ObjectListView should scroll when the user drags - something near to the top or bottom rows. Defaults to true. - - AutoScroll does not scroll horizontally. - - - - Gets the billboard overlay that will be used to display feedback - messages during a drag operation. - - Set this to null to stop the feedback. - - - - Get or set whether a drop can occur between items of the list - - - - - Get or set whether a drop can occur on the listview itself - - - - - Get or set whether a drop can occur on items in the list - - - - - Get or set whether a drop can occur on a subitem in the list - - - - - Gets or sets whether the drop sink should draw feedback onto the given list - during the drag operation. Defaults to true. - - If this is false, you will have to give the user feedback in some - other fashion, like cursor changes - - - - Get or set the index of the item that is the target of the drop - - - - - Get the item that is the target of the drop - - - - - Get or set the location of the target of the drop - - - - - Get or set the index of the subitem that is the target of the drop - - - - - Get or set the color that will be used to provide drop feedback - - - - - Get whether the alt key was down during this drop event - - - - - Get whether any modifier key was down during this drop event - - - - - Get whether the control key was down during this drop event - - - - - Get whether the left mouse button was down during this drop event - - - - - Get whether the right mouse button was down during this drop event - - - - - Get whether the right mouse button was down during this drop event - - - - - Get whether the shift key was down during this drop event - - - - - Get or set the state of the keys during this drop event - - - - - Gets or sets whether the drop sink will automatically use cursors - based on the drop effect. By default, this is true. If this is - set to false, you must set the Cursor yourself. - - - - - Triggered when the sink needs to know if a drop can occur. - - - Handlers should set Effect to indicate what is possible. - Handlers can change any of the DropTarget* setttings to change - the target of the drop. - - - - - Triggered when the drop is made. - - - - - Triggered when the sink needs to know if a drop can occur - AND the source is an ObjectListView - - - Handlers should set Effect to indicate what is possible. - Handlers can change any of the DropTarget* setttings to change - the target of the drop. - - - - - Triggered when the drop is made. - AND the source is an ObjectListView - - - - - Cleanup the drop sink when the mouse has left the control or - the drag has finished. - - - - - Draw any feedback that is appropriate to the current drop state. - - - Any drawing is done over the top of the ListView. This operation should disturb - the Graphic as little as possible. Specifically, do not erase the area into which - you draw. - - A Graphic for drawing - The contents bounds of the ListView (not including any header) - - - - The user has released the drop over this control - - - - - - A drag has entered this control. - - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - Change the cursor to reflect the current drag operation. - - - - - - The drag is moving over this control. - - - - - - Trigger the Dropped events - - - - - - Trigger CanDrop - - - - - - Trigger Dropped - - - - - - Trigger ModelCanDrop - - - - - - Trigger ModelDropped - - - - - - Handle the timer tick event, which is sent when the listview should - scroll - - - - - When the mouse is at the given point, what should the target of the drop be? - - This method should update the DropTarget* members of the given arg block - - The mouse point, in client co-ordinates - - - - What sort of action is possible when the mouse is at the given point? - - - - - - - - - - Based solely on the state of the modifier keys, what drop operation should - be used? - - The drop operation that matches the state of the keys - - - - Should the listview be made to scroll when the mouse is at the given point? - - - - - - Update the state of our sink to reflect the information that - may have been written into the drop event args. - - - - - - Draw the feedback that shows that the background is the target - - - - - - - Draw the feedback that shows that an item (or a subitem) is the target - - - - - DropTargetItem and DropTargetSubItemIndex tells what is the target - - - - - Draw the feedback that shows the drop will occur before target - - - - - - - Draw the feedback that shows the drop will occur after target - - - - - - - Return a GraphicPath that is round corner rectangle. - - - - - - - - Calculate the target rectangle when the given item (and possible subitem) - is the target of the drop. - - - - - - - - Draw a "between items" line at the given co-ordinates - - - - - - - - - - This drop sink allows items within the same list to be rearranged, - as well as allowing items to be dropped from other lists. - - - - This class can only be used on plain ObjectListViews and FastObjectListViews. - The other flavours have no way to implement the insert operation that is required. - - - This class does not work with grouping. - - - This class works when the OLV is sorted, but it is up to the programmer - to decide what rearranging such lists "means". Example: if the control is sorting - students by academic grade, and the user drags a "Fail" grade student up amonst the "A+" - students, it is the responsibility of the programmer to makes the appropriate changes - to the model and redraw/rebuild the control so that the users action makes sense. - - - Users of this class should listen for the CanDrop event to decide - if models from another OLV can be moved to OLV under this sink. - - - - - - Create a RearrangingDropSink - - - - - Create a RearrangingDropSink - - - - - - Trigger OnModelCanDrop - - - - - - Trigger OnModelDropped - - - - - - Do the work of processing the dropped items - - - - - - When a drop sink needs to know if something can be dropped, or - to notify that a drop has occured, it uses an instance of this class. - - - - - Create a OlvDropEventArgs - - - - - Get the original drag-drop event args - - - - - Get the data object that is being dragged - - - - - Get the drop sink that originated this event - - - - - Get or set the index of the item that is the target of the drop - - - - - Get or set the location of the target of the drop - - - - - Get or set the index of the subitem that is the target of the drop - - - - - Get the item that is the target of the drop - - - - - Get or set the drag effect that should be used for this operation - - - - - Get or set if this event was handled. No further processing will be done for a handled event. - - - - - Get or set the feedback message for this operation - - - If this is not null, it will be displayed as a feedback message - during the drag. - - - - - Get the ObjectListView that is being dropped on - - - - - Get the location of the mouse (in target ListView co-ords) - - - - - Get the drop action indicated solely by the state of the modifier keys - - - - - These events are triggered when the drag source is an ObjectListView. - - - - - Create a ModelDropEventArgs - - - - - Gets the model objects that are being dragged. - - - - - Gets the ObjectListView that is the source of the dragged objects. - - - - - Get the model object that is being dropped upon. - - This is only value for TargetLocation == Item - - - - Refresh all the objects involved in the operation - - - - - A data transfer object that knows how to transform a list of model - objects into a text and HTML representation. - - - - - Create a data object from the selected objects in the given ObjectListView - - The source of the data object - - - - Create a data object which operates on the given model objects - in the given ObjectListView - - The source of the data object - The model objects to be put into the data object - - - - Gets or sets whether hidden columns will also be included in the text - and HTML representation. If this is false, only visible columns will - be included. - - - - - Gets or sets whether column headers will also be included in the text - and HTML representation. - - - - - Gets the ObjectListView that is being used as the source of the data - - - - - Gets the model objects that are to be placed in the data object - - - - - Put a text and HTML representation of our model objects - into the data object. - - - - - Create an exporter for the data contained in this object - - - - - - Make a HTML representation of our model objects - - - - - Convert the fragment of HTML into the Clipboards HTML format. - - The HTML format is found here http://msdn2.microsoft.com/en-us/library/aa767917.aspx - - The HTML to put onto the clipboard. It must be valid HTML! - A string that can be put onto the clipboard and will be recognized as HTML - - - - A FastDataListView virtualizes the display of data from a DataSource. It operates on - DataSets and DataTables in the same way as a DataListView, but does so much more efficiently. - - - - A FastDataListView still has to load all its data from the DataSource. If you have SQL statement - that returns 1 million rows, all 1 million rows will still need to read from the database. - However, once the rows are loaded, the FastDataListView will only build rows as they are displayed. - - - - - - - - - - - - 获取或设置在设置DataSource时是否自动生成列以显示列。 - - 必须在设置DataSource之前设置此设置。之后就没有效果了。 - - - - 获取或设置将在此列表视图中显示的VirtualListDataSource。 - - VirtualListDataSource应实现 , , - 或 . 以下是一些常见的对象类型 - - - - - - - - 绑定到列表容器时 (即，实现 接口, 比如 ) - 您还必须实现 属性，以便标识要显示的特定列表。您也可以设置 属性， - 即使当VirtualListDataSource引用列表时也是如此, 因为 还可以用于导航列表之间的关系. - - - - - Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. - - If the data source is not a DataSet or DataViewManager, this property has no effect - - - - Gets or sets the DataSourceAdaptor that does the bulk of the work needed - for data binding. - - - - - Create the DataSourceAdapter that this control will use. - - A DataSourceAdapter configured for this list - Subclasses should override this to create their - own specialized adapters - - - - Change the Unfreeze behaviour - - - - - A FastObjectListView trades function for speed. - - - On my mid-range laptop, this view builds a list of 10,000 objects in 0.1 seconds, - as opposed to a normal ObjectListView which takes 10-15 seconds. Lists of up to 50,000 items should be - able to be handled with sub-second response times even on low end machines. - - A FastObjectListView is implemented as a virtual list with many of the virtual modes limits (e.g. no sorting) - fixed through coding. There are some functions that simply cannot be provided. Specifically, a FastObjectListView cannot: - - use Tile view - show groups on XP - - - - - - - Make a FastObjectListView - - - - - Gets the collection of objects that survive any filtering that may be in place. - - - - - Get/set the collection of objects that this list will show - - - - The contents of the control will be updated immediately after setting this property. - - This method preserves selection, if possible. Use SetObjects() if - you do not want to preserve the selection. Preserving selection is the slowest part of this - code and performance is O(n) where n is the number of selected rows. - This method is not thread safe. - - - - - Move the given collection of objects to the given index. - - This operation only makes sense on non-grouped ObjectListViews. - - - - - - 删除任何排序并恢复到模型对象的给定顺序 - - To be really honest, Unsort() doesn't work on FastObjectListViews since - the original ordering of model objects is lost when Sort() is called. So this method - effectively just turns off sorting. - - - - 为FastObjectListView提供数据源 - - - This class isn't intended to be used directly, but it is left as a public - class just in case someone wants to subclass it. - - - - - Create a FastObjectListDataSource - - - - - - Get n'th object - - - - - - - How many items are in the data source - - - - - - Get the index of the given model - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Remove the given collection of models from this source. - - - - - - - - - - - - Update/replace the nth object with the given object - - - - - - - Apply the given filters to this data source. One or both may be null. - - - - - - - Gets the full list of objects being used for this fast list. - This list is unfiltered. - - - - - Gets the list of objects from ObjectList which survive any installed filters. - - - - - Rebuild the map that remembers which model object is displayed at which line - - - - - Build our filtered list from our full list. - - - - - Concrete implementation of the ICluster interface. - - - - - Create a cluster - - The key for the cluster - - - - Return a string representation of this cluster - - - - - - Gets or sets how many items belong to this cluster - - - - - Gets or sets the label that will be shown to the user to represent - this cluster - - - - - Gets or sets the actual data object that all members of this cluster - have commonly returned. - - - - - Return an indication of the ordering between this object and the given one - - - - - - - This class provides a useful base implemention of a clustering - strategy where the clusters are grouped around the value of a given column. - - - - - This field is the text that will be shown to the user when a cluster - key is null. It is exposed so it can be localized. - - - - - This field is the text that will be shown to the user when a cluster - key is empty (i.e. a string of zero length). It is exposed so it can be localized. - - - - - Gets or sets the format that will be used by default for clusters that only - contain 1 item. The format string must accept two placeholders: - - {0} is the cluster key converted to a string - - {1} is the number of items in the cluster (always 1 in this case) - - - - - Gets or sets the format that will be used by default for clusters that - contain 0 or two or more items. The format string must accept two placeholders: - - {0} is the cluster key converted to a string - - {1} is the number of items in the cluster - - - - - Create a clustering strategy - - - - - Gets or sets the column upon which this strategy is operating - - - - - Gets or sets the format that will be used when the cluster - contains only 1 item. The format string must accept two placeholders: - - {0} is the cluster key converted to a string - - {1} is the number of items in the cluster (always 1 in this case) - - If this is not set, the value from - ClusteringStrategy.DefaultDisplayLabelFormatSingular will be used - - - - Gets or sets the format that will be used when the cluster - contains 0 or two or more items. The format string must accept two placeholders: - - {0} is the cluster key converted to a string - - {1} is the number of items in the cluster - - If this is not set, the value from - ClusteringStrategy.DefaultDisplayLabelFormatPlural will be used - - - - Get the cluster key by which the given model will be partitioned by this strategy - - - - - - - Create a cluster to hold the given cluster key - - - - - - - Gets the display label that the given cluster should use - - - - - - - Create a filter that will include only model objects that - match one or more of the given values. - - - - - - - Create a label that combines the string representation of the cluster - key with a format string that holds an "X [N items in cluster]" type layout. - - - - - - - - This class calculates clusters from the groups that the column uses. - - - - This is the default strategy for all non-date, filterable columns. - - - This class does not strictly mimic the groups created by the given column. - In particular, if the programmer changes the default grouping technique - by listening for grouping events, this class will not mimic that behaviour. - - - - - - Get the cluster key by which the given model will be partitioned by this strategy - - - - - - - Gets the display label that the given cluster should use - - - - - - - This enum is used to indicate various portions of a datetime - - - - - Year - - - - - Month - - - - - Day of the month - - - - - Hour - - - - - Minute - - - - - Second - - - - - This class implements a strategy where the model objects are clustered - according to some portion of the datetime value in the configured column. - - To create a strategy that grouped people who were born in - the same month, you would create a strategy that extracted just - the month, and formatted it to show just the month's name. Like this: - - - someColumn.ClusteringStrategy = new DateTimeClusteringStrategy(DateTimePortion.Month, "MMMM"); - - - - - Create a strategy that clusters by month/year - - - - - Create a strategy that clusters around the given parts - - - - - - - Gets or sets the format string will will be used to create a user-presentable - version of the cluster key. - - The format should use the date/time format strings, as documented - in the Windows SDK. Both standard formats and custom format will work. - "D" - long date pattern - "MMMM, yyyy" - "January, 1999" - - - - Gets or sets the parts of the DateTime that will be extracted when - determining the clustering key for an object. - - - - - Get the cluster key by which the given model will be partitioned by this strategy - - - - - - - Gets the display label that the given cluster should use - - - - - - - Convert the given date into a user presentable string - - - - - - - Instances of this class know how to build a Filter menu. - It is responsible for clustering the values in the target column, - build a menu that shows those clusters, and then constructing - a filter that will enact the users choices. - - - Almost all of the methods in this class are declared as "virtual protected" - so that subclasses can provide alternative behaviours. - - - - - Gets or sets the string that labels the Apply button. - Exposed so it can be localized. - - - - - Gets or sets the string that labels the Clear All menu item. - Exposed so it can be localized. - - - - - Gets or sets the string that labels the Filtering menu as a whole.. - Exposed so it can be localized. - - - - - Gets or sets the string that represents Select All values. - If this is set to null or empty, no Select All option will be included. - Exposed so it can be localized. - - - - - Gets or sets the image that will be placed next to the Clear Filtering menu item - - - - - Gets or sets the image that will be placed next to all "Apply" menu items on the filtering menu - - - - - Gets or sets whether null should be considered as a valid data value. - If this is true (the default), then a cluster will null as a key will be allow. - If this is false, object that return a cluster key of null will ignored. - - - - - Gets or sets the maximum number of objects that the clustering strategy - will consider. This should be large enough to collect all unique clusters, - but small enough to finish in a reasonable time. - - The default value is 10,000. This should be perfectly - acceptable for almost all lists. - - - - Create a Filter menu on the given tool tip for the given column in the given ObjectListView. - - This is the main entry point into this class. - - - - The strip that should be shown to the user - - - - Create a collection of clusters that should be presented to the user - - - - - - - - - Order the given list of clusters in the manner in which they should be presented to the user. - - - - - - - Do the work of making a menu that shows the clusters to the users - - - - - - - - Wrap a protected section around the real HandleItemChecked method, so that if - that method tries to change a "checkedness" of an item, we don't get a recursive - stack error. Effectively, this ensure that HandleItemChecked is only called - in response to a user action. - - - - - - - Handle a user-generated ItemCheck event - - - - - - - Handle any checking/unchecking of the Select All option, and keep - its checkedness in sync with everything else that is checked. - - - - - - - - Clear all the filters that are applied to the given column - - The column from which filters are to be removed - - - - Apply the selected values from the given list as a filter on the given column - - A list in which the checked items should be used as filters - The column for which a filter should be generated - - - - Interface for model-by-model filtering - - - - - Should the given model be included when this filter is installed - - The model object to consider - Returns true if the model will be included by the filter - - - - Interface for whole list filtering - - - - - Return a subset of the given list of model objects as the new - contents of the ObjectListView - - The collection of model objects that the list will possibly display - The filtered collection that holds the model objects that will be displayed. - - - - Base class for model-by-model filters - - - - - Should the given model be included when this filter is installed - - The model object to consider - Returns true if the model will be included by the filter - - - - This filter calls a given Predicate to decide if a model object should be included - - - - - Create a filter based on the given predicate - - The function that will filter objects - - - - Gets or sets the predicate used to filter model objects - - - - - Should the given model object be included? - - - - - - - A CompositeFilter joins several other filters together. - If there are no filters, all model objects are included - - - - - Create an empty filter - - - - - Create a composite filter from the given list of filters - - A list of filters - - - - Gets or sets the filters used by this composite - - - - - Get the sub filters that are text match filters - - - - - Decide whether or not the given model should be included by the filter - - - True if the object is included by the filter - - - - Decide whether or not the given model should be included by the filter - - Filters is guaranteed to be non-empty when this method is called - The model object under consideration - True if the object is included by the filter - - - - A CompositeAllFilter joins several other filters together. - A model object must satisfy all filters to be included. - If there are no filters, all model objects are included - - - - - Create a filter - - - - - - Decide whether or not the given model should be included by the filter - - Filters is guaranteed to be non-empty when this method is called - The model object under consideration - True if the object is included by the filter - - - - A CompositeAllFilter joins several other filters together. - A model object must only satisfy one of the filters to be included. - If there are no filters, all model objects are included - - - - - Create a filter from the given filters - - - - - - Decide whether or not the given model should be included by the filter - - Filters is guaranteed to be non-empty when this method is called - The model object under consideration - True if the object is included by the filter - - - - Instances of this class extract a value from the model object - and compare that value to a list of fixed values. The model - object is included if the extracted value is in the list - - If there is no delegate installed or there are - no values to match, no model objects will be matched - - - - Create a filter that will use the given delegate to extract values - - - - - - Create a filter that will extract values using the given delegate - and compare them to the values in the given list. - - - - - - - Gets or sets the delegate that will be used to extract values - from model objects - - - - - Gets or sets the list of values that the value extracted from - the model object must match in order to be included. - - - - - Should the given model object be included? - - - - - - - Decides if the given property is a match for the values in the PossibleValues collection - - - - - - - Instances of this class match a property of a model objects against - a list of bit flags. The property should be an xor-ed collection - of bits flags. - - Both the property compared and the list of possible values - must be convertible to ulongs. - - - - Create an instance - - - - - - - Gets or sets the collection of values that will be matched. - These must be ulongs (or convertible to ulongs). - - - - - Decides if the given property is a match for the values in the PossibleValues collection - - - - - - - Base class for whole list filters - - - - - Return a subset of the given list of model objects as the new - contents of the ObjectListView - - The collection of model objects that the list will possibly display - The filtered collection that holds the model objects that will be displayed. - - - - Instance of this class implement delegate based whole list filtering - - - - - A delegate that filters on a whole list - - - - - - - Create a ListFilter - - - - - - Gets or sets the delegate that will filter the list - - - - - Do the actual work of filtering - - - - - - - Filter the list so only the last N entries are displayed - - - - - Create a no-op tail filter - - - - - Create a filter that includes on the last N model objects - - - - - - Gets or sets the number of model objects that will be - returned from the tail of the list - - - - - Return the last N subset of the model objects - - - - - - - Instances of this class cluster model objects on the basis of a - property that holds an xor-ed collection of bit flags. - - - - - Create a clustering strategy that operates on the flags of the given enum - - - - - - Create a clustering strategy around the given collections of flags and their display labels. - There must be the same number of elements in both collections. - - The list of flags. - - - - - Gets the value that will be xor-ed to test for the presence of a particular value. - - - - - Gets the labels that will be used when the corresponding Value is XOR present in the data. - - - - - Get the cluster key by which the given model will be partitioned by this strategy - - - - - - - Gets the display label that the given cluster should use - - - - - - - Create a filter that will include only model objects that - match one or more of the given values. - - - - - - - A cluster is a like collection of objects that can be usefully filtered - as whole using the filtering UI provided by the ObjectListView. - - - - - Gets or sets how many items belong to this cluster - - - - - Gets or sets the label that will be shown to the user to represent - this cluster - - - - - Gets or sets the actual data object that all members of this cluster - have commonly returned. - - - - - Implementation of this interface control the selecting of cluster keys - and how those clusters will be presented to the user - - - - - Gets or sets the column upon which this strategy will operate - - - - - Get the cluster key by which the given model will be partitioned by this strategy - - If the returned value is an IEnumerable, the given model is considered - to belong to multiple clusters - - - - - - Create a cluster to hold the given cluster key - - - - - - - Gets the display label that the given cluster should use - - - - - - - Create a filter that will include only model objects that - match one or more of the given values. - - - - - - - Instances of this class include only those rows of the listview - that match one or more given strings. - - This class can match strings by prefix, regex, or simple containment. - There are factory methods for each of these matching strategies. - - - - Create a text filter that will include rows where any cell matches - any of the given regex expressions. - - - - - Any string that is not a valid regex expression will be ignored. - - - - Create a text filter that includes rows where any cell begins with one of the given strings - - - - - - - - Create a text filter that includes rows where any cell contains any of the given strings. - - - - - - - - Create a TextFilter - - - - - - Create a TextFilter that finds the given string - - - - - - - Create a TextFilter that finds the given string using the given comparison - - - - - - - - Gets or sets which columns will be used for the comparisons? If this is null, all columns will be used - - - - - Gets or sets additional columns which will be used in the comparison. These will be used - in addition to either the Columns property or to all columns taken from the control. - - - - - Gets or sets the collection of strings that will be used for - contains matching. Setting this replaces all previous texts - of any kind. - - - - - Gets whether or not this filter has any search criteria - - - - - Gets or set the ObjectListView upon which this filter will work - - - You cannot really rebase a filter after it is created, so do not change this value. - It is included so that it can be set in an object initializer. - - - - - Gets or sets the collection of strings that will be used for - prefix matching. Setting this replaces all previous texts - of any kind. - - - - - Gets or sets the options that will be used when compiling the regular expression. - - - This is only used when doing Regex matching (obviously). - If this is not set specifically, the appropriate options are chosen to match the - StringComparison setting (culture invariant, case sensitive). - - - - - Gets or sets the collection of strings that will be used for - regex pattern matching. Setting this replaces all previous texts - of any kind. - - - - - Gets or sets how the filter will match text - - - - - Loop over the columns that are being considering by the filter - - - - - - Do the actual work of filtering - - - - - - - Find all the ways in which this filter matches the given string. - - This is used by the renderer to decide which bits of - the string should be highlighted - - A list of character ranges indicating the matched substrings - - - - Is the given column one of the columns being used by this filter? - - - - - - - Base class for the various types of string matching that TextMatchFilter provides - - - - - Gets how the filter will match text - - - - - Gets the text filter to which this component belongs - - - - - Gets or sets the text that will be matched - - - - - Find all the ways in which this filter matches the given string. - - - - This is used by the renderer to decide which bits of - the string should be highlighted. - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - A list of character ranges indicating the matched substrings - - - - Does the given text match the filter - - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - Return true if the given cellText matches our strategy - - - - This component provides text contains matching strategy. - - - - - Create a text contains strategy - - - - - - - Does the given text match the filter - - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - Return true if the given cellText matches our strategy - - - - Find all the ways in which this filter matches the given string. - - - - This is used by the renderer to decide which bits of - the string should be highlighted. - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - A list of character ranges indicating the matched substrings - - - - This component provides text begins with matching strategy. - - - - - Create a text begins strategy - - - - - - - Does the given text match the filter - - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - Return true if the given cellText matches our strategy - - - - Find all the ways in which this filter matches the given string. - - - - This is used by the renderer to decide which bits of - the string should be highlighted. - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - A list of character ranges indicating the matched substrings - - - - This component provides regex matching strategy. - - - - - Creates a regex strategy - - - - - - - Gets or sets the options that will be used when compiling the regular expression. - - - - - Gets or sets a compilex regular expression, based on our current Text and RegexOptions. - - - If Text fails to compile as a regular expression, this will return a Regex object - that will match all strings. - - - - - Gets whether or not our current regular expression is a valid regex - - - - - Does the given text match the filter - - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - Return true if the given cellText matches our strategy - - - - Find all the ways in which this filter matches the given string. - - - - This is used by the renderer to decide which bits of - the string should be highlighted. - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - A list of character ranges indicating the matched substrings - - - - This attribute is used to mark a property of a model - class that should be noticed by Generator class. - - - All the attributes of this class match their equivilent properties on OLVColumn. - - - - - Create a new OLVColumnAttribute - - - - - Create a new OLVColumnAttribute with the given title - - The title of the column - - - - - - - - - - - - - - - - - - - - - - - - - - - - - An array of IComparables that mark the cutoff points for values when - grouping on this column. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Properties marked with [OLVChildren] will be used as the children source in a TreeListView. - - - - - Properties marked with [OLVIgnore] will not have columns generated for them. - - - - - ColumnComparer is the workhorse for all comparison between two values of a particular column. - If the column has a specific comparer, use that to compare the values. Otherwise, do - a case insensitive string compare of the string representations of the values. - - This class inherits from both IComparer and its generic counterpart - so that it can be used on untyped and typed collections. - This is used by normal (non-virtual) ObjectListViews. Virtual lists use - ModelObjectComparer - - - - - Gets or sets the method that will be used to compare two strings. - The default is to compare on the current culture, case-insensitive - - - - - Create a ColumnComparer that will order the rows in a list view according - to the values in a given column - - The column whose values will be compared - The ordering for column values - - - - Create a ColumnComparer that will order the rows in a list view according - to the values in a given column, and by a secondary column if the primary - column is equal. - - The column whose values will be compared - The ordering for column values - The column whose values will be compared for secondary sorting - The ordering for secondary column values - - - - Compare two rows - - row1 - row2 - An ordering indication: -1, 0, 1 - - - - Compare two rows - - row1 - row2 - An ordering indication: -1, 0, 1 - - - - Compare the actual values to be used for sorting - - The aspect extracted from the first row - The aspect extracted from the second row - An ordering indication: -1, 0, 1 - - - - This comparer sort list view groups. OLVGroups have a "SortValue" property, - which is used if present. Otherwise, the titles of the groups will be compared. - - - - - Create a group comparer - - The ordering for column values - - - - Compare the two groups. OLVGroups have a "SortValue" property, - which is used if present. Otherwise, the titles of the groups will be compared. - - group1 - group2 - An ordering indication: -1, 0, 1 - - - - This comparer can be used to sort a collection of model objects by a given column - - - This is used by virtual ObjectListViews. Non-virtual lists use - ColumnComparer - - - - - Gets or sets the method that will be used to compare two strings. - The default is to compare on the current culture, case-insensitive - - - - - Create a model object comparer - - - - - - - Create a model object comparer with a secondary sorting column - - - - - - - - - Compare the two model objects - - - - - - - - Compare the actual values - - - - - - - - A helper class that translates DataSource events for an ObjectListView - - - - - Make a DataSourceAdapter - - - - - Finalize this object - - - - - Release all the resources used by this instance - - - - - Release all the resources used by this instance - - - - - Gets or sets whether or not columns will be automatically generated to show the - columns when the DataSource is set. - - This must be set before the DataSource is set. It has no effect afterwards. - - - - Get or set the DataSource that will be displayed in this list view. - - - - - Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. - - If the data source is not a DataSet or DataViewManager, this property has no effect - - - - Gets the ObjectListView upon which this adaptor will operate - - - - - Gets or sets the currency manager which is handling our binding context - - - - - - - - - - - - - - - - - - - - - - - - - - - Our data source has changed. Figure out how to handle the new source - - - - - Our data source has changed. Figure out how to handle the new source - - - - - The data source for this control has changed. Reconfigure the control for the new source - - - - - Take the contents of the currently bound list and put them into the control - - - - - Create columns for the listview based on what properties are available in the data source - - - This method will create columns if there is not already a column displaying that property. - - - - - Decide if a new column should be added to the control to display - the given property - - - - - - - Configure the given column to show the given property. - The title and aspect name of the column are already filled in. - - - - - - - Generate aspect getters and putters for any columns that are missing them (and for which we have - enough information to actually generate a getter) - - - - - CurrencyManager ListChanged event handler. - Deals with fine-grained changes to list items. - - - It's actually difficult to deal with these changes in a fine-grained manner. - If our listview is grouped, then any change may make a new group appear or - an old group disappear. It is rarely enough to simply update the affected row. - - - - - - - Handle PropertyDescriptor* events - - - - - - Handle ItemMoved event - - - - - - Handle the ItemDeleted event - - - - - - Handle an ItemAdded event. - - - - - - Handle the Reset event - - - - - - Handle ItemChanged event. This is triggered when a single item - has changed, so just refresh that one item. - - - Even in this simple case, we should probably rebuild the list. - For example, the change could put the item into its own new group. - - - - The CurrencyManager calls this if the data source looks - different. We just reload everything. - - - - - CHECK: Do we need this if we are handle ListChanged metadata events? - - - - - Called by the CurrencyManager when the currently selected item - changes. We update the ListView selection so that we stay in sync - with any other controls bound to the same source. - - - - - - - Change the control's position (which is it's currently selected row) - to the nth row in the dataset - - The index of the row to be selected - - - - Handle the selection changing in our ListView. - We need to tell our currency manager about the new position. - - - - - - - Handle the frozenness of our ListView changing. - - - - - - - Handle a change to the BindingContext of our ListView. - - - - - - - These delegates are used to extract an aspect from a row object - - - - - These delegates are used to put a changed value back into a model object - - - - - These delegates can be used to convert an aspect value to a display string, - instead of using the default ToString() - - - - - These delegates are used to get the tooltip for a cell - - - - - These delegates are used to the state of the checkbox for a row object. - - - For reasons known only to someone in Microsoft, we can only set - a boolean on the ListViewItem to indicate it's "checked-ness", but when - we receive update events, we have to use a tristate CheckState. So we can - be told about an indeterminate state, but we can't set it ourselves. - - As of version 2.0, we can now return indeterminate state. - - - - - These delegates are used to get the state of the checkbox for a row object. - - - - - - - These delegates are used to put a changed check state back into a model object - - - - - These delegates are used to put a changed check state back into a model object - - - - - - - - These delegates are used to get the renderer for a particular cell - - - - - The callbacks for RightColumnClick events - - - - - This delegate will be used to own draw header column. - - - - - This delegate is called when a group has been created but not yet made - into a real ListViewGroup. The user can take this opportunity to fill - in lots of other details about the group. - - - - - These delegates are used to retrieve the object that is the key of the group to which the given row belongs. - - - - - These delegates are used to convert a group key into a title for the group - - - - - These delegates are used to get the tooltip for a column header - - - - - These delegates are used to fetch the image selector that should be used - to choose an image for this column. - - - - - These delegates are used to draw a cell - - - - - These delegates are used to fetch a row object for virtual lists - - - - - These delegates are used to format a listviewitem before it is added to the control. - - - - - These delegates can be used to return the array of texts that should be searched for text filtering - - - - - These delegates are used to sort the listview in some custom fashion - - - - - These delegates are used to order two strings. - x cannot be null. y can be null. - - - - - An ObjectListView is a much easier to use, and much more powerful, version of the ListView. - - - - An ObjectListView automatically populates a ListView control with information taken - from a given collection of objects. It can do this because each column is configured - to know which bit of the model object (the "aspect") it should be displaying. Columns similarly - understand how to sort the list based on their aspect, and how to construct groups - using their aspect. - - - Aspects are extracted by giving the name of a method to be called or a - property to be fetched. These names can be simple names or they can be dotted - to chain property access e.g. "Owner.Address.Postcode". - Aspects can also be extracted by installing a delegate. - - - An ObjectListView can show a "this list is empty" message when there is nothing to show in the list, - so that the user knows the control is supposed to be empty. - - - Right clicking on a column header should present a menu which can contain: - commands (sort, group, ungroup); filtering; and column selection. Whether these - parts of the menu appear is controlled by ShowCommandMenuOnRightClick, - ShowFilterMenuOnRightClick and SelectColumnsOnRightClick respectively. - - - The groups created by an ObjectListView can be configured to include other formatting - information, including a group icon, subtitle and task button. Using some undocumented - interfaces, these groups can even on virtual lists. - - - ObjectListView supports dragging rows to other places, including other application. - Special support is provide for drops from other ObjectListViews in the same application. - In many cases, an ObjectListView becomes a full drag source by setting to - true. Similarly, to accept drops, it is usually enough to set to true, - and then handle the and events (or the and - events, if you only want to handle drops from other ObjectListViews in your application). - - - For these classes to build correctly, the project must have references to these assemblies: - - - System - System.Data - System.Design - System.Drawing - System.Windows.Forms (obviously) - - - - - - How does a user indicate that they want to edit cells? - - - - - 列表将不支持编辑(同时F2按键无效) - - - - - 单击 单元格 将编辑值. - 选择该行，就像正常选择行一样。用户必须按F2键才能编辑主列。 - - - - - 双击子项或主列将编辑该单元格。 - F2键将编辑主列。 - - - - - 按F2键是编辑单元格的唯一方法。一旦主列被编辑， - 行中的其他单元格可以通过按Tab键进行编辑。 - - - - - 只需单击任意单元格即可编辑值，即使是主列也是如此。 - - - - - 这些值指定向用户显示列选择的方式 - - - - - 不会显示任何列选择 - - - - - 这些列将显示在主菜单中 - - - - - 这些列将显示在子菜单中 - - - - - 将显示一个模式对话框，允许用户选择列 - - - - - Triggered after a ObjectListView has been searched by the user typing into the list - - - - - Triggered after a ObjectListView has been sorted - - - - - Triggered before a ObjectListView is searched by the user typing into the list - - - Set Cancelled to true to prevent the searching from taking place. - Changing StringToFind or StartSearchFrom will change the subsequent search. - - - - - Triggered before a ObjectListView is sorted - - - Set Cancelled to true to prevent the sort from taking place. - Changing ColumnToSort or SortOrder will change the subsequent sort. - - - - - Triggered after a ObjectListView has created groups - - - - - Triggered before a ObjectListView begins to create groups - - - Set Groups to prevent the default group creation process - - - - - Triggered just before a ObjectListView creates groups - - - You can make changes to the groups, which have been created, before those - groups are created within the listview. - - - - - Triggered when a button in a cell is left clicked. - - - - - This event is triggered when the user moves a drag over an ObjectListView that - has a SimpleDropSink installed as the drop handler. - - - Handlers for this event should set the Effect argument and optionally the - InfoMsg property. They can also change any of the DropTarget* setttings to change - the target of the drop. - - - - - Triggered when a cell has finished being edited. - - - - - Triggered when a cell is about to finish being edited. - - If Cancel is already true, the user is cancelling the edit operation. - Set Cancel to true to prevent the value from the cell being written into the model. - You cannot prevent the editing from finishing within this event -- you need - the CellEditValidating event for that. - - - - Triggered when a cell is about to be edited. - - Set Cancel to true to prevent the cell being edited. - You can change the the Control to be something completely different. - - - - Triggered when a cell editor needs to be validated - - - If this event is cancelled, focus will remain on the cell editor. - - - - - Triggered when a cell is left clicked. - - - - - Triggered when the mouse is above a cell. - - - - - Triggered when a cell is right clicked. - - - - - This event is triggered when a cell needs a tool tip. - - - - - This event is triggered when a checkbox is checked/unchecked on a subitem - - - - - Triggered when a column header is right clicked. - - - - - This event is triggered when the user releases a drag over an ObjectListView that - has a SimpleDropSink installed as the drop handler. - - - - - This event is triggered when the control needs to filter its collection of objects. - - - - - This event is triggered when a cell needs to be formatted. - - - - - This event is triggered when the frozeness of the control changes. - - - - - This event is triggered when a row needs to be formatted. - - - - - This event is triggered when a group is about to collapse or expand. - This can be cancelled to prevent the expansion. - - - - - This event is triggered when a group changes state. - - - - - This event is triggered when a header checkbox is changing value - - - - - This event is triggered when a header needs a tool tip. - - - - - Triggered when the "hot" item changes - - - - - Triggered when a hyperlink cell is clicked. - - - - - Triggered when the task text of a group is clicked. - - - - - Is the value in the given cell a hyperlink. - - - - - Some new objects are about to be added to an ObjectListView. - - - - - The contents of the ObjectListView has changed. - - - - - The contents of the ObjectListView is about to change via a SetObjects call - - - Set Cancelled to true to prevent the contents of the list changing. This does not work with virtual lists. - - - - - Some objects are about to be removed from an ObjectListView. - - - - - This event is triggered when the user moves a drag over an ObjectListView that - has a SimpleDropSink installed as the drop handler, and when the source control - for the drag was an ObjectListView. - - - Handlers for this event should set the Effect argument and optionally the - InfoMsg property. They can also change any of the DropTarget* setttings to change - the target of the drop. - - - - - This event is triggered when the user releases a drag over an ObjectListView that - has a SimpleDropSink installed as the drop handler and when the source control - for the drag was an ObjectListView. - - - - - This event is triggered once per user action that changes the selection state - of one or more rows. - - - - - This event is triggered when the contents of the ObjectListView has scrolled. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Tell the world when a cell is about to be edited. - - - - - Tell the world when a cell is about to finish being edited. - - - - - Tell the world when a cell is about to finish being edited. - - - - - Tell the world when a cell has finished being edited. - - - - - 创建一个 ObjectListView - - - - - Dispose of any resources this instance has been using - - - - - - 获取鼠标左键是否在此时按下。 - - - - - 获取该程序是否在Vista或更高版本上运行 - - - - - 获取该程序是否在Win7或更高版本上运行 - - - - - Gets or sets how what smoothing mode will be applied to graphic operations. - - - - - Gets or sets how should text be renderered. - - - - - 获取或设置当组Key为Null时将用于标题组的字符串。将其公开以使其可以本地化。 - - - - - Convert the given enumerable into an ArrayList as efficiently as possible - - The source collection - If true, this method will always create a new - collection. - An ArrayList with the same contents as the given collection. - - When we move to .NET 3.5, we can use LINQ and not need this method. - - - - - Return the count of items in the given enumerable - - - - When we move to .NET 3.5, we can use LINQ and not need this method. - - - - Return whether or not the given enumerable is empty. A string is regarded as - an empty collection. - - - True if the given collection is null or empty - - When we move to .NET 3.5, we can use LINQ and not need this method. - - - - - Gets or sets whether all ObjectListViews will silently ignore missing aspect errors. - - - - By default, if an ObjectListView is asked to display an aspect - (i.e. a field/property/method) - that does not exist from a model, it displays an error message in that cell, since that - condition is normally a programming error. There are some use cases where - this is not an error -- in those cases, set this to true and ObjectListView will - simply display an empty cell. - - Be warned: if you set this to true, it can be very difficult to track down - typing mistakes or name changes in AspectNames. - - - - - Gets or sets whether the control will draw a rectangle in each cell showing the cell padding. - - - - This can help with debugging display problems from cell padding. - - As with all cell padding, this setting only takes effect when the control is owner drawn. - - - - - Gets the style that will be used by default to format disabled rows - - - - - Gets the style that will be used by default to format hot rows - - - - - Gets or sets an model filter that is combined with any column filtering that the end-user specifies. - - This is different from the ModelFilter property, since setting that will replace - any column filtering, whereas setting this will combine this filter with the column filtering - - - - Get or set all the columns that this control knows about. - Only those columns where IsVisible is true will be seen by the user. - - - - If you want to add new columns programmatically, add them to - AllColumns and then call RebuildColumns(). Normally, you do not have to - deal with this property directly. Just use the IDE. - - If you do add or remove columns from the AllColumns collection, - you have to call RebuildColumns() to make those changes take effect. - - - - - 获取或设置每隔一行的背景色 - - - - - 获取已设置的交替行背景色或默认颜色 - - - - - 此属性强制ObjectListView始终按给定列对项进行分组。 - - - - - 如果AlwaysGroupByColumn不为空，则此属性将用于确定如何对这些组进行排序。 - 如果此属性的值为SortOrder.None，则排序顺序将根据用户上次单击的标题切换。 - - - - - Give access to the image list that is actually being used by the control - - - Normally, it is preferable to use SmallImageList. Only use this property - if you know exactly what you are doing. - - - - - 获取或设置编辑单元格的方式 - - Columns can also be marked as editable. - - - - 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ - 默认值为 true. - - - This is always treated as true when the control is NOT owner drawn. - - When this is false and the control is owner drawn, - ObjectListView will try to calculate the width of the cell's - actual contents, and then size the editing control to be just the right width. If this is true, - the whole width of the cell will be used, regardless of the cell's contents. - - Each column can have a different value for property. This value from the control is only - used when a column is not specified one way or another. - Regardless of this setting, developers can specify the exact size of the editing control - by listening for the CellEditStarting event. - - - - - Gets or sets the engine that will handle key presses during a cell edit operation. - Settings this to null will reset it to default value. - - - - - 获取当前用于编辑单元格的控件。 - - This will obviously be null if no cell is being edited. - - - - 获取或设置编辑控件左边缘或右边缘的单元格时Tab键的行为。 - 如果为False(默认值)，则按Tab键将换行到同一行的另一侧。 - 如果为True，编辑最右边的单元格时按Tab键将前进到下一行， - 编辑最左边的单元格时按Shift-Tab组合键将更改为上一行。 - - - - - 获取或设置编辑单元格时Enter键的行为。 - 如果为False(默认值)，则按Enter键将简单地完成编辑操作。 - 如果为True，则Enter将完成编辑操作，并在当前单元格下方的单元格上启动新的编辑操作，在位于底部单元格时换行到下一行的顶部。 - - - - - 获取显示单元格提示的工具提示控件 - - - - - 获取或设置该项的每个单元格周围将留空的像素数。单元格内容在考虑填充后对齐。 - - - Each value of the given rectangle will be treated as an inset from - the corresponding side. The width of the rectangle is the padding for the - right cell edge. The height of the rectangle is the padding for the bottom - cell edge. - - - So, this.olv1.CellPadding = new Rectangle(1, 2, 3, 4); will leave one pixel - of space to the left of the cell, 2 pixels at the top, 3 pixels of space - on the right edge, and 4 pixels of space at the bottom of each cell. - - - This setting only takes effect when the control is owner drawn. - - This setting only affects the contents of the cell. The background is - not affected. - If you set this to a foolish value, your control will appear to be empty. - - - - - 获取或设置默认情况下单元格垂直对齐的方式。 - - This setting only takes effect when the control is owner drawn. It will only be noticable - when RowHeight has been set such that there is some vertical space in each row. - - - - Should this list show checkboxes? - - - - - 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL - - - - - Get or set the collection of model objects that are checked. - When setting this property, any row whose model object isn't - in the given collection will be unchecked. Setting to null is - equivilent to unchecking all. - - - - This property returns a simple collection. Changes made to the returned - collection do NOT affect the list. This is different to the behaviour of - CheckedIndicies collection. - - - .NET's CheckedItems property is not helpful. It is just a short-hand for - iterating through the list looking for items that are checked. - - - The performance of the get method is O(n), where n is the number of items - in the control. The performance of the set method is - O(n + m) where m is the number of objects being checked. Be careful on long lists. - - - - - - 获取或设置可枚举对象中的选中对象。 - - - Useful for checking all objects in the list. - - - this.olv1.CheckedObjectsEnumerable = this.olv1.Objects; - - - - - Gets Columns for this list. We hide the original so we can associate - a specialised editor with it. - - - - - 获取/设置当列表切换到TileView(平铺视图)时应使用的列的列表。 - - - - - 按向用户显示的顺序返回可见列 - - - - - 获取显示列表的控件区域，减去任何标题控件 - - - - - 获取或设置当用户按Ctrl+C组合键时是否应将选定行复制到剪贴板 - - - - - 获取或设置按Ctrl+C键复制到剪贴板功能是否应使用安装的DragSource创建放置到剪贴板上的数据对象。 - - This is normally what is desired, unless a custom DragSource is installed - that does some very specialized drag-drop behaviour. - - - - Gets the list of decorations that will be drawn the ListView - - - - Do not modify the contents of this list directly. Use the AddDecoration() and RemoveDecoration() methods. - - - A decoration scrolls with the list contents. An overlay is fixed in place. - - - - - - 所有者绘制时，此渲染器将绘制未指定特定渲染器的列 - - 如果尝试将其设置为NULL，则它将恢复为HighlightTextRenende - - - - 获取用于绘制给定单元格的渲染器。 - - The row model for the row - The column to be drawn - The renderer used for drawing a cell. Must not return null. - - - - 获取或设置将应用于禁用项的样式。 - - If this is not set explicitly, will be used. - - - - 获取或设置已禁用的模型对象的列表。无法选择或激活已禁用的对象。 - - - - - 判断此给定模型对象是否已禁用 - - - - - - - 禁用给定的模型对象。禁用的对象无法选择或激活。 - - Must not be null - - - - 禁用所有给定的模型对象 - - - - - - 启用给定的模型对象，以便可以再次选择并激活它。 - - Must not be null - - - - 启用所有给定的模型对象 - - - - - - 忽略所有禁用的对象。这不会触发重绘或重建 - - - - - Gets or sets the object that controls how drags start from this control - - - - - Gets or sets the object that controls how drops are accepted and processed - by this ListView. - - - - If the given sink is an instance of SimpleDropSink, then events from the drop sink - will be automatically forwarded to the ObjectListView (which means that handlers - for those event can be configured within the IDE). - - If this is set to null, the control will not accept drops. - - - - - This registry decides what control should be used to edit what cells, based - on the type of the value in the cell. - - - All instances of ObjectListView share the same editor registry. - - - - 获取或设置在此列表视图中没有项时应显示的文本。 - - If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, - this property does nothing - - - - 获取或设置绘制列表空消息时应使用的字体 - - If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, - this property does nothing - - - - 返回“列表为空”消息的字体或合理的默认值 - - - - - Gets or sets the overlay responsible for drawing the List Empty msg. - - - - - 获取在筛选中幸存下来的对象的集合。 - - - - This collection is the result of filtering the current list of objects. - It is not a snapshot of the filtered list that was last used to build the control. - - - Normal warnings apply when using this with virtual lists. It will work, but it - may take a while. - - - - - - 获取或设置将用于生成筛选器菜单的策略对象 - - 如果为NULL，则不会生成筛选器菜单。 - - - - 获取或设置具有键盘焦点的行 - - - - Setting an object to be focused does *not* select it. If you want to select and focus a row, - use . - - - This property is not generally used and is only useful in specialized situations. - - - - - - 隐藏Groups集合，使其在“属性”网格中不可见。 - - - - - 获取或设置分组使用的ImageList - - 如果未设置此选项，则分组标题将不会显示任何图像。 - - - - 获取在组为空或包含多个项目时应如何设置组标签的格式 - - - 给定的格式字符串必须有两个占位符： - - {0} - 原来的组标题 - {1} - 组中的项目数 - - - "[{0} [{1} 项]" - - - - 返回this.GroupWithItemCountFormat或合理的默认值 - - - - - 获取在组仅包含单个项目时应如何设置组标签的格式 - - - 给定的格式字符串必须有两个占位符： - - {0} - 原来的组标题 - {1} - 组中的项目数 (总是1) - - - "[{0} [{1} 项]" - - - - 获取GroupWithItemCountSingularFormat或合理的默认值 - - - - - 获取或设置此ObjectListView中的组是否应可折叠。 - - - 此特性只支持Vista或之后的系统. - - - - - 获取当前列表是否存在当列表为空时显示的文本 - - - - - 获取是否有要绘制的叠加层 - - - - - 获取ListView的列头控件 - - - - - 获取或设置列标题文本的绘制字体 - - 单个列可以通过其HeaderFormatStyle属性重写此设置。 - - - - 获取或设置将用于绘制列表视图的列标题的样式 - - - - 仅当HeaderUsesThemes为false时才使用此选项。 - - - 单个列可以通过其HeaderFormatStyle属性重写此设置。 - - - - - - 获取或设置标题的最大高度。-1表示没有最大值。 - - - - - 获取或设置标题的最小高度。-1表示没有最小值。 - - - - - 获取或设置是否严格按照操作系统的主题绘制标题。 - - - - 如果设置为true，则列头将完全由系统呈现，不需要ObjectListViews的任何特殊处理。 - 页眉中将没有图像、没有过滤器指示符、没有文字换行、没有页眉样式、没有复选框。 - - 如果将其设置为False，ObjectListView将以其认为最好的方式呈现标题。 - 如果不需要特殊功能，则ObjectListView会将渲染委托给操作系统。 - 否则，ObjectListView将根据配置设置绘制标题。 - - - 没有主题的效果会因操作系统不同而不同。至少，分类指示器不会是标准的。 - - - - - - 获取或设置列头标题中的文本是否自动换行。 - - - 将在单词之间应用换行符。过长的单词仍将被省略。 - - 与所有使列头看起来不同的设置一样，HeaderUsesThemes必须设置为false，否则操作系统将负责绘制列头，并且不允许自动换行文本。 - - - - - - 获取显示列标题提示的工具提示 - - - - - 获取鼠标当前所在行的索引。 - - - - - 获取鼠标当前所在列的索引 - - - - - 获取鼠标当前所在的项/子项的一部分 - - - - - Gets an extended indication of the part of item/subitem/group that the mouse is currently over - - - - - 获取鼠标所在的组。 - - - - - 处于“热”状态的项的索引，即在光标下方。-1表示没有项目。 - - - - - 获取和设置对游标下的行应用哪种格式 - - - - 这仅在UseHotItem为true时生效。 - - 如果样式具有叠加层，则必须对其进行设置。*之前* 将其分配给此属性。之后添加它将被忽略。 - - - - - 获取已安装的热点项样式或合理的默认值。 - - - - - 获取和设置应将哪种格式应用于超链接 - - - - - 获取和设置所选行的背景应该使用什么颜色 - - - - - 返回应用于选定行的背景颜色或合理的默认值 - - - - - 获取和设置所选行的字体应该使用什么颜色 - - - - - 返回应用于选定行的字体颜色或合理的默认值 - - - - - 使用 SelectedBackColor 代替 - - - - - 使用 SelectedBackColorOrDefault 代替 - - - - - 使用 SelectedForeColor 代替 - - - - - 使用 SelectedForeColorOrDefault 代替 - - - - - 使用 UnfocusedSelectedBackColor 代替 - - - - - 使用 UnfocusedSelectedBackColorOrDefault 代替 - - - - - 使用 UnfocusedSelectedForeColor 代替 - - - - - 使用 UnfocusedSelectedForeColorOrDefault 代替 - - - - - 获取或设置是否应将隐藏列包括在复制或拖动到其他应用程序的行的文本表示形式中。 - 如果为False(默认值)，则仅包括可见列。 - - - - - 获取或设置复制行时，列标题是否在文本中。 - 如果为False(默认值)，在文本中将不会显示列标题。 - - - - - 如果当前正在进行单元格编辑操作，则返回TRUE - - - - - 如果在开发环境中使用ObjectListView，则返回true。 - - - - - 获取当前列表是否正在筛选其内容 - - - - - 当用户在列表中键入内容时，是否应该搜索当前排序列中的值以查找匹配项？ - 如果为False，则无论排序列是什么，都将始终使用主列。 - - When this is true, the behavior is like that of ITunes. - - - - 获取或设置此控件是否将使用SimpleDropSink接收拖动 - - - - 此设置将替换任何以前的DropSink。 - - - 将其设置为true后，SimpleDropSink仍需要配置为说明它何时可以接受拖动， - 以及在拖动某些内容时应该执行什么操作。需要执行这些操作使此属性几乎毫无用处 :( - - - - - - 获取或设置此控件是否将使用SimpleDragSource来启动拖动 - - 此设置将替换之前的任何DragSource - - - - 隐藏Items集合，使其在“属性”网格中不可见。 - - - - - 当列表中的项目处于非详细视图中时，此渲染器会绘制项目。在详细信息视图中，负责个体列的呈现器。 - - - - - 获取或设置最后一次排序的列 - - 这是PrimarySortColumn的别名 - - - - 获取或设置最后一次排序的方向 - - 这是 PrimarySortOrder的别名 - - - - 获取或设置应用于整个对象列表的筛选器。 - - - 列表将立即更新以反映此筛选器。 - - - - - 获取或设置应用于列表中每个模型对象的筛选器 - - - 您可能需要考虑使用 而不是此属性， - 因为AdditionalFilter在运行时与列筛选相结合。 - 设置此属性只是替换用户可能已给出的任何列筛选器。 - - The list is updated immediately to reflect this filter. - - - - - - Gets the hit test info last time the mouse was moved. - - Useful for hot item processing. - - - - 获取或设置列表显示的组列表。 - - - 此属性与.NET Groups属性的工作方式不同，应将其视为只读属性。 - 对列表所做的更改不会反映在ListView本身中。 - 在此列表中添加或删除组是没有意义的，这样的修改不会起到任何作用。 - 要执行此类操作，必须侦听BeforeCreatingGroups或AboutToCreateGroups事件， - 并更改这些事件中的组列表。 - - - - - 获取或设置折叠的OLVGroups的集合。 - - - - - Gets or sets whether the user wants to owner draw the header control - themselves. If this is false (the default), ObjectListView will use - custom drawing to render the header, if needed. - - - If you listen for the DrawColumnHeader event, you need to set this to true, - otherwise your event handler will not be called. - - - - - 获取/设置此列表将显示的对象集合 - - - - 设置此属性后，控件的内容将立即更新。 - - 如果可能，此方法将保留所选内容。使用 if - 如果您不想保留所选内容，请执行以下操作。 - 保留选择是该代码中最慢的部分，性能为O(N)，其中n是选定的行数。 - 此方法不是线程安全的。 - 该属性确实适用于虚拟列表：设置是没有问题的，但如果您尝试获取它， - 并且列表有1000万个对象，则可能需要一些时间才能返回。 - 此集合未经过筛选。使用 只访问那些在任何已安装的筛选器中幸存下来的对象。 - - - - - 获取当前控件所有对象组成的列表 - - - - - 获取创建群集时将考虑的对象集合。 - (用于生成类似Excel的列筛选器) - - - - - 获取或设置将在ListView顶部绘制的图像 - - - - - 获取或设置将在ListView顶部绘制的文本 - - - - - 获取或设置所有覆盖图的透明度。0表示完全透明，255表示完全不透明。 - - - 这已经过时了，请在每个覆盖上使用Transparency。 - - - - - 获取将在ListView顶部绘制的覆盖列表 - - - You can add new overlays and remove overlays that you have added, but - don't mess with the overlays that you didn't create. - - - - - Gets or sets whether the ObjectListView will be owner drawn. Defaults to true. - - - - When this is true, all of ObjectListView's neat features are available. - - We have to reimplement this property, even though we just call the base - property, in order to change the [DefaultValue] to true. - - - - - - 获取或设置主复选框是否在列表重新生成和筛选操作中保持其值。 - - - - 此属性仅在未显式设置CheckStateGetter/Putter时才有用。 - 如果您使用CheckStateGetter/Putter，那么这些方法已经持久化了行的检查性。 - - 此默认值为true。如果为False，则在重新生成或筛选列表时，复选框将丢失其值。 - 如果在虚拟列表中将其设置为false，则必须安装CheckStateGetter/Putters。 - - - - - 获取或设置记住模型对象的复选框状态的字典 - - 当PersistentCheckBoxs值为TRUE时，此选项用于虚拟列表. - - - - 获取或设置最后一次排序的列 - - - - - 获取或设置最后一次排序的方向 - - - - - 获取或设置不可编辑复选框是否绘制为禁用。默认是false。 - - - 这仅在所有者描述模式(owner drawn mode)下有效。 - - - - - 以像素为单位指定控件中每行的高度。 - - 列表视图中的行高通常由字体大小和小图像列表大小决定。 - 此设置允许覆盖该计算(原因是：您仍然不能将行高设置为小于控件中使用的字体的行高)。 - 将其设置为-1表示使用正常计算方法。 - 此功能是体验功能！如果您使用此功能，您的程序可能会发生意想不到的事情。 - - - - - 获取每行有多少像素高 - - - - - 获取此控件的每页上显示多少行 - - - - - 获取/设置将用于解析排序时相等的比较的列(第二排序列)。 - - 此设置没有用户界面。它必须以编程方式设置。 - - - - 获取或设置当使用Second darySortColumn时，它将以什么顺序比较结果 - - - - - 获取或设置当用户按Ctrl+A组合键时是否应选择所有行 - - - - - 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许用户选择视图中将显示哪些列 - - 这只是SelectColumnsOnRightClickBehaviour的兼容性包装属性. - - - - 获取或设置当右键单击标题时用户如何能够选择列 - - - - - 当列选择菜单打开时，是否应在选择项目后保持打开状态？保持打开状态允许用户一次打开或关闭多个列。 - - SelectColumnsOnRightClickBehaviour设置为InlineMenu时才有效。当行为设置为SubMenu菜单时，该选项不起作用。 - - - - 获取或设置选定列 - - - - 如果TintSortColumn为true，则排序列将自动成为选定列。 - - - 色调的颜色由SelectedColumnTint控制。 - - - - - - Gets or sets the decoration that will be drawn on all selected rows - - - - - 获取或设置应该使用什么颜色来给选定的列着色 - - - 色调颜色必须是Alpha可混合的，因此如果给定的颜色是纯色(即Alpha=255)，则会将其更改为具有合理的Alpha值。 - - - - - 获取或设置当前选定行的索引。 - 获取索引时，如果没有选择任何行，或者选择了多个行，则返回-1。 - - - - - 获取或设置当前选定的ListViewItem。如果未选择任何行，或者选择了多个行，则返回NULL。 - - - - - 如果只选择了一行，则从当前选定的行获取模型对象。 - 如果未选择任何行，或选择了多个行，则返回NULL。 - 设置时，这将选择显示给定模型对象的行，并将焦点放在该行上，取消选择所有其他行。 - - - - - 从当前选定的行中获取模型对象。 - 如果未选中任何行，则返回的列表为空。 - 设置此值时，请选择显示给定模型对象的行，取消选择所有其他行。 - - - - - 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许他们选择要在列表视图上执行的常见任务 - - - - - 获取或设置当右键单击标题控件时，此ObjectListView是否像筛选菜单一样显示表格 - - - - - 获取或设置是否应按组显示其项目 - - - - - 列表视图是否应该在列标题中显示位图以显示排序方向 - - - The only reason for not wanting to have sort indicators is that, on pre-XP versions of - Windows, having sort indicators required the ListView to have a small image list, and - as soon as you give a ListView a SmallImageList, the text of column 0 is bumped 16 - pixels to the right, even if you never used an image. - - - - - 列表视图是否应该显示子项上的图像 - - - 虚拟列表必须是所有者绘制的，才能在子项上显示图像 - - - - - 此属性控制分组标签是否显示该分组项目数量 - - - 后缀的格式由GroupWithItemCountFormat/GroupWithItemCountSingularFormat属性控制 - - - - - 获取或设置控件是在所有视图中显示列标题(True)，还是仅在详细信息视图中显示列标题(False) - - - - 此属性工作不正常。JPP 2010/04/06。 - 如果它是在创建控件之前设置的，则可以正常工作。 - 但是，如果在创建控件后将其关闭，则控件将丢失其复选框(奇怪！) - - - 要在创建控件后更改此设置，事情会很复杂。 - 如果它是关闭的，而我们想要打开它，我们必须更改视图，标题就会出现。 - 如果它当前处于打开状态，而我们想要将其关闭，则必须更改视图并重新创建控制柄。 - 重新创建句柄是一个问题，因为它会使我们的复选框样式消失。 - - - 该属性不能工作在 Win XP 系统. - - - - - 重写SmallImageList属性，以便我们可以正确地隐藏其操作。 - - 如果使用RowHeight属性指定行高，则必须在设置/更改RowHeight之前完全初始化SmallImageList。 - 如果在设置行高之后将新图像添加到图像列表，则必须再次将图像列表分配给控件。像这样简单的事情会奏效的： - listView1.SmallImageList = listView1.SmallImageList; - - - - - 返回小图像列表中图像的大小或合理的默认值 - - - - - 当列表视图分组时，项是否应该按主列排序？如果为False，则项目将按分组时的同一列进行排序。 - - - - - 当列表视图分组时，一个组的末尾和下一个组的开头之间应该有多少像素 - - - - - 排序列是否应该显示轻微的色调？ - - - - - 获取或设置是否使用三态复选框？ - - - 如果为True，用户可以选择第三种状态(通常是不确定的)。 - 否则，用户在选中和取消选中之间交替单击。 - 当此设置为False时，CheckStateGetter仍可以返回不确定。 - - - - - 获取或设置列表顶部项目的索引 - - - - 此属性仅在列表视图处于详细信息视图中且不显示组时才起作用。 - - - 显示组时不起作用的原因是，当启用组时，无论滚动位置如何， - Windows msg LVM_GETTOPINDEX总是返回0。 - - - - - - 获取或设置将鼠标移到标题上是否会触发CellOver事件。 - 默认为true。 - - - 将鼠标移动到标题上之前不会触发CellOver事件，因为Header被视为单独的控件。 - 如果此行为更改导致您的应用程序出现问题，请将其设置为False。 - 如果您想知道鼠标何时在标题上移动，请将此属性设置为true(默认值)。 - - - - - 通过拖动分隔线调整列的大小时，是否应在每次鼠标移动时调整填充空格的列的大小？ - 如果为False，则释放鼠标时将更新填充栏。 - - - - 如果空间填充列位于正在调整大小的列的左侧，这看起来会很奇怪：该列的右边缘将被拖动，但由于空间填充列正在收缩，其左边缘将会移动。 - - 这是合乎逻辑的行为--只是看起来不对。 - - - 考虑到上述行为，如果空间填充列不是最右边的列，最好关闭该属性。 - - - - - 当控件没有焦点时，应该使用什么颜色作为选定行的背景 - - - - - 当控件没有焦点或合理的默认值时，返回应用于选定行的背景的颜色 - - - - - 当控件没有焦点时，应该使用什么颜色作为选定行的字体颜色。 - - - - - 当控件没有焦点或合理的默认值时，返回应用于选定行的字体颜色 - - - - - 获取或设置列表是否每隔一行提供不同的背景色？默认值为false。 - - 交替行的颜色由AlternateRowBackColor提供。 - 在.NET中，列表视图在非整行选择模式下有一个“功能”，在这种模式下，所选行不会使用正确的背景色绘制。 - - - - 是否应该为控件中的每个单元格调用FormatCell事件？ - - - 在许多情况下，不执行单元格级格式设置。 - 如果除非需要，ObjectListView不会为每个单元格触发Format Cell事件，则它的运行速度会稍快一些。 - 因此，默认情况下，它不会为每个单元格引发事件。 - - ObjectListView*确实*在每次重新生成行时引发FormatRow事件。各行可以决定是否对行中的每个单元格引发FormatCell事件。 - - - 无论此设置如何，只有当ObjectListView处于详细视图中时才会引发FormatCell事件。 - - - - - 所选行是否应使用非标准前景色和背景色绘制？ - - V2.9不再需要此属性 - - - - 获取或设置此ObjectListView是否将使用与Vista资源管理器相同的热项和选择机制。 - - - - 此属性有许多缺陷： - - 这仅适用于Vista及更高版本 - 它不能很好地与AlternateRowBackColors配合使用。 - 它不能很好地与HotItemStyles配合使用。 - 如果FullRowSelect为false，这看起来有点傻。 - 当列表是所有者绘制的时，它根本不起作用(因为所有的绘制都是由渲染器完成的)。 - 因此，它不能与TreeListView一起工作，因为它们“必须”是所有者绘制的。你仍然可以设置它，但它不会生效。 - - 但如果你一定要看起来像Vista/Win7，这是你的权限。如果这项设置搞砸了其他事情，请不要抱怨。 - - - 当此属性设置为True时，ObjectListView将不是所有者描述的。 - 这将禁用ObjectListView的许多漂亮的基于绘图的功能。 - - - - - - 获取或设置列表是否应启用筛选 - - - - - 获取或设置列表是否应将指示符放入列的标题中，以表明它正在筛选该列 - - 如果将其设置为true，HeaderUsesThemes将自动设置为false，因为我们只能在不使用主题标题时绘制筛选器指示器。 - - - - 鼠标下方的控件(复选框或按钮)是否应该被绘制为“Hot” - - - 如果为False，则当鼠标悬停在控件上时，控件的绘制方式不会有所不同。 - - 如果为False，且UseHotItem和UseHyperLinks为False，则ObjectListView可以跳过鼠标移动的某些处理。这使得鼠标移动处理几乎不使用CPU。 - - - - - - 光标下的项是否应以特殊方式设置格式？ - - - - - 获取或设置此列表视图是否应在单元格中显示超链接。 - - - - - 此控件是否应显示覆盖(Overlays) - - 覆盖(Overlays)在默认情况下是启用的，只有在它们在您的开发环境中造成问题时才需要禁用。 - - - - 是否应将此控件配置为在子项上显示复选框？ - - 如果将其设置为True，则将为该控件提供一个SmallImageList(如果它还没有一个SmallImageList)。 - 此外，如果它是一个虚拟列表，它将被设置为所有者描述的，因为虚拟列表不能在没有所有者描述的情况下绘制复选框。 - - - - 获取或设置ObjectListView是否将使用类似Vista的半透明选择机制。 - - - - 与UseExplorerTheme不同的是，这个类似Vista的方案可以在XP上运行，并且既适用于所有者描述的列表，也适用于非所有者描述的列表。 - - - 这将替换任何已安装的SelectedRowDecory。 - - - 如果您不喜欢用于选择的颜色，请忽略此属性， - 只需创建您自己的RowBorderDecory并将其分配给SelectedRowDecory， - 就像此属性设置器所做的那样。 - - - - - - 获取或设置ObjectListView是否将使用类似于Vista的半透明热行突出显示机制。 - - - - 设置此项将替换任何已安装的HotItemStyle。 - - - 如果您不喜欢热项目使用的颜色，请忽略此属性， - 只需创建您自己的HotItemStyle，填充所需的值， - 并将其分配给HotItemStyle属性，就像此属性设置器所做的那样。 - - - - - - 获取/设置此列表视图正在使用的视图样式 - - 切换到平铺(Tile)或详细信息(Details)视图会安装适合该视图的列。令人困惑的是，在平铺视图中，每列都显示为一行信息。 - - - - 此委托仅将对象的检查性作为布尔值获取。 - - 如果您永远不想担心不确定状态(这是相当常见的)，请使用此选项。 - - 这是CheckStateGetter属性的便捷包装。 - - - - - - This delegate sets the checkedness of an object as a boolean only. It must return - true or false indicating if the object was checked or not. - - Use this if you never want to worry about the - Indeterminate state (which is fairly common). - - This is a convenience wrapper around the CheckStatePutter property. - - - - - - 获取此列表视图是否能够显示组 - - - - - 获取或设置ObjectListView是否可以依赖正在引发的Application.Idle事件。 - - 在某些主机环境中(例如，在VisualStudio和Office中作为扩展运行时)，从不引发Application.Idle事件。 - 如果不会引发Idle事件，则将其设置为False，ObjectListView将自行引发这些事件。 - - - - - This delegate fetches the renderer for a particular cell. - - - - If this returns null (or is not installed), the renderer for the column will be used. - If the column renderer is null, then will be used. - - - This is called every time any cell is drawn. It must be efficient! - - - - - - This delegate is called when the list wants to show a tooltip for a particular cell. - The delegate should return the text to display, or null to use the default behavior - (which is to show the full text of truncated cell values). - - - Displaying the full text of truncated cell values only work for FullRowSelect listviews. - This is MS's behavior, not mine. Don't complain to me :) - - - - - 保存是否选中模型的属性(或字段)的名称。 - - - 该属性是可修改的。它必须具有bool(或bool？)返回类型。如果TriStateCheckBooks为真)。 - 设置此属性将替换任何已安装的CheckStateGetter或CheckStatePutter。 - 相反，稍后设置CheckStateGetter或CheckStatePutter属性将优先于此属性的行为。 - - - - - 只要ObjectListView需要知道与给定模型对象关联的行的检查状态，就会调用此委托。 - - - .NET has no support for indeterminate values, but as of v2.0, this class allows - indeterminate values. - - - - - This delegate will be called whenever the user tries to change the check state of a row. - The delegate should return the state that was actually set, which may be different - to the state given. - - - - - 此委托可用于以自定义方式对表进行排序。 - - - - 委托必须在ObjectListView上安装ListViewItemSorter。 - 安装ItemSorter会执行对ListViewItems进行排序的实际工作。 - 有关ItemSorter必须执行的操作的示例，请参见代码中的ColumnCompeller。 - - - 请勿在VirtualObjectListView上安装CustomSorter。改为重写IVirtualListDataSource的SortObjects()方法。 - - - - - - This delegate is called when the list wants to show a tooltip for a particular header. - The delegate should return the text to display, or null to use the default behavior - (which is to not show any tooltip). - - - Installing a HeaderToolTipGetter takes precedence over any text in OLVColumn.ToolTipText. - - - - - This delegate can be used to format a OLVListItem before it is added to the control. - - - The model object for the row can be found through the RowObject property of the OLVListItem object. - All subitems normally have the same style as list item, so setting the forecolor on one - subitem changes the forecolor of all subitems. - To allow subitems to have different attributes, do this: - myListViewItem.UseItemStyleForSubItems = false;. - - If UseAlternatingBackColors is true, the backcolor of the listitem will be calculated - by the control and cannot be controlled by the RowFormatter delegate. - In general, trying to use a RowFormatter - when UseAlternatingBackColors is true does not work well. - As it says in the summary, this is called before the item is added to the control. - Many properties of the OLVListItem itself are not available at that point, including: - Index, Selected, Focused, Bounds, Checked, DisplayIndex. - - - - - 将给定的模型对象添加到此控件。 - - 要显示的模型对象 - See AddObjects() for more details - - - - 将给定的模型对象集合添加到此控件。 - - 要显示的模型对象集合 - - 如果排序处于活动状态(即，如果PrimarySortColumn不为空)，则添加的对象将出现在其正确的排序位置。否则，它们将出现在列表的末尾。 - 不执行任何检查以查看是否有任何对象已在ListView中。 - 空对象将被静默忽略。 - - - - - 将列的大小调整到页眉宽度和数据的最大值。 - - - - - 设置任何自动初始化的列宽(宽度为0或-1的列将分别调整为其内容或标题的宽度)。 - - - 显然，这只会起作用一次。一旦运行，列宽将更改为其他值(不是0或-1)，因此第二次运行时不会执行任何操作。 - 若要强制所有列更改其大小，请使用 。 - - - - - 根据最后一个排序列或第一列(如果没有最后一个排序列)将视图项组织到组中 - - - - - 根据给定列将视图项组织成组 - - - - 如果AlwaysGroupByColumn属性不为Null，则列表视图项将按该列组织，并且将忽略‘Column’参数。 - - 此方法触发排序事件：BeforeSorting和AfterSorting。 - - 其值应用于排序的列。 - - - - - 根据给定列将视图项组织成组 - - 将使用哪一列进行分组 - 组将使用什么顺序 - 其值应用于排序的列。不能为空 - 列中值的排序顺序 - 当‘column’中的值相等时，请使用此列提供的值 - 次级值将如何排序 - 此方法不会触发排序事件。使用BuildGroups()执行此操作 - - - - 收集并返回影响组创建的所有变量 - - - - - - Make a list of groups that should be shown according to the given parameters - - - The list of groups to be created - This should not change the state of the control. It is possible that the - groups created will not be used. They may simply be discarded. - - - - 生成/重新生成列表中的所有列表视图项，尽可能多地保留状态 - - - - - 生成/重新生成列表中的所有列表视图项 - - If this is true, the control will try to preserve the selection, - focused item, and the scroll position (see Remarks) - - - - Use this method in situations were the contents of the list is basically the same - as previously. - - - - - - 清除此列表可能一直在使用的所有缓存信息 - - - - - Apply all required extended styles to our control. - - - - Whenever .NET code sets an extended style, it erases all other extended styles - that it doesn't use. So, we have to explicit reapply the styles that we have - added. - - - Normally, we would override CreateParms property and update - the ExStyle member, but ListView seems to ignore all ExStyles that - it doesn't already know about. Worse, when we set the LVS_EX_HEADERINALLVIEWS - value, bad things happen (the control crashes!). - - - - - - Give the listview a reasonable size of its tiles, based on the number of lines of - information that each tile is going to display. - - - - - Rebuild this list for the given view - - - - - - 移除所有对象(线程安全) - - This method can safely be called from background threads. - - - - 重置已访问其URL的内存 - - - - - 将选定行的文本和HTML表示复制到剪贴板上。 - - Be careful when using this with virtual lists. If the user has selected - 10,000,000 rows, this method will faithfully try to copy all of them to the clipboard. - From the user's point of view, your program will appear to have hung. - - - - 将给定对象的文本和HTML表示复制到剪贴板上。 - - - - - 将所有对象的文本和HTML表示复制到剪贴板上。 - - - - - 返回给定对象的html表示形式 - - - - - 取消选择列表视图中的所有行 - - - - - 返回紧跟在给定项后面的ListViewItem。 - 如果给定项为空，则返回列表中的第一个项。 - 如果给定项是最后一项，则返回NULL。 - - The item that is before the item that is returned, or null - A ListViewItem - - - - 按向用户显示的顺序返回最后一项。 - 如果控件未分组，则显示顺序与排序的列表顺序相同。 - 但如果列表是分组的，则显示顺序不同。 - - - - - - 按向用户显示的顺序返回第n项(从0开始)。 - 如果控件未分组，则显示顺序与排序的列表顺序相同。 - 但如果列表是分组的，则显示顺序不同。 - - - - - - - 返回给定listviewitem索引的显示索引。 - 如果控件未分组，则显示顺序与排序的列表顺序相同。 - 但如果列表是分组的，则显示顺序不同。 - - - - - - - 返回紧接在给定项之前出现的ListViewItem。 - 如果给定项为空，则返回列表中的最后一项。 - 如果给定项是第一项，则返回NULL。 - - The item that is before the item that is returned - A ListViewItem - - - - 在给定位置之前插入给定的对象集合 - - Where to insert the objects - The objects to be inserted - - - This operation only makes sense of non-sorted, non-grouped - lists, since any subsequent sort/group operation will rearrange - the list. - - This method only works on ObjectListViews and FastObjectListViews. - - - - - 如果选择了表示给定模型的行，则返回TRUE - - The model object to look for - Is the row selected - - - - 给定的URL是否已被访问 - - The string to be consider - Has it been visited - - - - 按给定的值增量滚动ListView。 - - Horizontal delta - Vertical delta - - - - Return a point that represents the current horizontal and vertical scroll positions - - - - - 记住给定的URL已被访问 - - The url to be remembered - This does not cause the control be redrawn - - - - 将给定的对象集合移动到给定的索引。 - - 此操作仅对未分组的ObjectListViews有意义。 - - - - - - 计算在给定点下的项目是什么？ - - - - - - - - 使用Windows控件的SUBITEMHITTEST消息执行点击测试。 - 这提供了标准ListView.HitTest()不提供的有关组点击的信息。 - - - - - - - - What is under the given point? This takes the various parts of a cell into accout, including - any custom parts that a custom renderer might use - - - - An information block about what is under the point - - - - Perform a hit test when the control is not owner drawn - - - - - - - - Perform a hit test when the control is owner drawn. This hands off responsibility - to the renderer. - - - - - - - - Pause (or unpause) all animations in the list - - true to pause, false to unpause - - - - Rebuild the columns based upon its current view and column visibility settings - - - - - 从ListView中删除给定的模型对象 - - The model to be removed - See RemoveObjects() for more details - This method is thread-safe. - - - - - 从控件中移除所有给定对象。 - - Collection of objects to be removed - - Nulls and model objects that are not in the ListView are silently ignored. - This method is thread-safe. - - - - - 选择列表视图中的所有行 - - - - - 在列表视图的右下角设置要固定的给定图像。 - 当列表视图滚动时，此图像不会滚动。 - - - - 此方法使用ListView的原生功能显示背景图像。 - 它有几个限制： - - - 它在owner drawn模式下不能很好地工作。在owner drawn绘制模式下， - 每个单元格都会绘制自身，包括覆盖背景图像的背景。 - 启用网格线时看起来不是很好，因为网格线是在图像上绘制的。 - 它在XP上完全不起作用。 - 显然，当启用交替行背景色时，效果不佳。 - - - 如果你能忍受这些限制，原生水印就相当不错了。 - 它们是真实的背景，而不是像OverlayImage使用的半透明覆盖。 - 与覆盖相比，它们也有明显的优势，因为即使在MDI应用程序中，它们也可以正常工作。 - - 设置此选项将清除所有背景图像。 - - The image to be drawn. If null, any existing image will be removed. - - - - 将给定的图像设置为ListView的背景，以便它在列表中以给定的百分比偏移量显示。 - - - 这具有与 中所述的相同限制. - 在使用该方法之前，请确保了解这些限制。 - 这非常类似于 属性， - 但标准Backround Image不能正确处理具有透明区域的图像--它将透明区域呈现为黑色。这种方法没有这个问题。 - 设置此选项将清除所有背景水印。 - - The image to be drawn. If null, any existing image will be removed. - The horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. - The vertical percentage where the image will be placed. - - - - 将给定图像设置为ListView的平铺背景。 - - - 这具有与 和 相同的限制. - 在使用该方法之前，请确保了解这些限制。 - - 要绘制的图像。如果为null，则将删除所有现有图像。 - - - - 设置将在此列表视图中显示的对象集合。 - - 可以从后台线程安全地调用此方法。 - 该列表将立即更新 - The objects to be displayed - - - - 设置将在此列表视图中显示的对象集合。 - - 可以从后台线程安全地调用此方法. - 该列表将立即更新 - The objects to be displayed - 是否应尽可能保留列表的状态。 - - - - 将给定的模型对象更新到ListView中。 - 如果该模型尚不存在，则会添加该模型。 - - The model to be updated - - - See for more details - - 此方法是线程安全的。 - 此方法将导致重新排序列表。 - 此方法仅适用于ObjectListViews和FastObjectListViews。 - - - - - 更新与给定对象相等的预先存在的模型。 - 如果控件中不存在任何模型，则会添加它们。 - - Collection of objects to be updated/added - - 此方法将导致重新排序列表。 - null值将被静默忽略。 - 此方法是线程安全的。 - 此方法仅适用于ObjectListViews和FastObjectListViews。 - - - - - 更改当前模型对象上对INotifyPropertyChanged事件的任何订阅， - 以便我们不再侦听旧模型上的事件，而侦听给定集合上的事件。 - - This does nothing if UseNotifyPropertyChanged is false. - - - - - 获取或设置ObjectListView是否应订阅它给定的模型对象上的INotifyPropertyChanged事件。 - - - - 这应该在调用SetObjects()之前设置。如果将其设置为False，ObjectListView将取消订阅所有当前模型对象。 - - 如果在虚拟列表上将其设置为true，ObjectListView将遍历列表中尝试订阅更改通知的所有对象。 - 如果您的虚拟列表中有10,000,000个项目，这可能需要一些时间。 - - - - - Subscribe to INotifyPropertyChanges on the given collection of objects. - - - - - - Unsubscribe from INotifyPropertyChanges on the given collection of objects. - If the given collection is null, unsubscribe from all current subscriptions - - - - - - Return a byte array that represents the current state of the ObjectListView, such - that the state can be restored by RestoreState() - - - The state of an ObjectListView includes the attributes that the user can modify: - - current view (i.e. Details, Tile, Large Icon...) - sort column and direction - column order - column widths - column visibility - - - - It does not include selection or the scroll position. - - - A byte array representing the state of the ObjectListView - - - - Restore the state of the control from the given string, which must have been - produced by SaveState() - - A byte array returned from SaveState() - Returns true if the state was restored - - - - Instances of this class are used to store the state of an ObjectListView. - - - - - The application is idle. Trigger a SelectionChanged event. - - - - - - - The application is idle. Handle the column resizing event. - - - - - - - Handle the BeginScroll listview notification - - - True if the event was completely handled - - - - Handle the EndScroll listview notification - - - True if the event was completely handled - - - - Handle the LinkClick listview notification - - - True if the event was completely handled - - - - The cell tooltip control wants information about the tool tip that it should show. - - - - - - - Allow the HeaderControl to call back into HandleHeaderToolTipShowing without making that method public - - - - - - - The header tooltip control wants information about the tool tip that it should show. - - - - - - - Event handler for the column click event - - - - - Override the basic message pump for this control - - - - - - Handle the search for item m if possible. - - The m to be processed - bool to indicate if the msg has been handled - - - - The user wants to see the context menu. - - The windows m - A bool indicating if this m has been handled - - We want to ignore context menu requests that are triggered by right clicks on the header - - - - - Handle the Custom draw series of notifications - - The message - True if the message has been handled - - - - Handle the underlying control being destroyed - - - - - - - Handle the search for item m if possible. - - The m to be processed - bool to indicate if the msg has been handled - - - - Find the first row after the given start in which the text value in the - comparison column begins with the given text. The comparison column is column 0, - unless IsSearchOnSortColumn is true, in which case the current sort column is used. - - The text to be prefix matched - The index of the first row to consider - Which direction should be searched? - The index of the first row that matched, or -1 - The text comparison is a case-insensitive, prefix match. The search will - search the every row until a match is found, wrapping at the end if needed. - - - - Find the first row in the given range of rows that prefix matches the string value of the given column. - - - - - - The index of the matched row, or -1 - - - - Handle the Group Info series of notifications - - The message - True if the message has been handled - - - - Handle a key down message - - - True if the msg has been handled - - - - Toggle the checkedness of the selected rows - - - - Actually, this doesn't actually toggle all rows. It toggles the first row, and - all other rows get the check state of that first row. This is actually a much - more useful behaviour. - - - If no rows are selected, this method does nothing. - - - - - - Catch the Left Button down event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle a left mouse down at the given hit test location - - Subclasses can override this to do something unique - - True if the message has been handled - - - - Catch the Left Button up event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Trigger a GroupExpandCollapse event and return true if the action was cancelled - - - - - - - Catch the Right Button down event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle a left mouse down at the given hit test location - - Subclasses can override this to do something unique - - True if the message has been handled - - - - Catch the Left Button double click event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle a mouse double click at the given hit test location - - Subclasses can override this to do something unique - - True if the message has been handled - - - - Catch the right Button double click event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle a right mouse double click at the given hit test location - - Subclasses can override this to do something unique - - True if the message has been handled - - - - Catch the MouseMove event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle notifications that have been reflected back from the parent window - - The m to be processed - bool to indicate if the msg has been handled - - - - In the notification messages, we handle attempts to change the width of our columns - - The m to be processed - bool to indicate if the msg has been handled - - - - Create a ToolTipControl to manage the tooltip control used by the listview control - - - - - Update the handle used by our cell tooltip to be the tooltip used by - the underlying Windows listview control. - - - - - Handle the WM_PAINT event - - - Return true if the msg has been handled and nothing further should be done - - - - Perform any steps needed before painting the control - - - - - Perform any steps needed after painting the control - - - - - Handle the window position changing. - - The m to be processed - bool to indicate if the msg has been handled - - - - The user has right clicked on the column headers. Do whatever is required - - Return true if this event has been handle - - - - Show a menu that is appropriate when the given column header is clicked. - - The index of the header that was clicked. This - can be -1, indicating that the header was clicked outside of a column - Where should the menu be shown - True if a menu was displayed - - - - Create the menu that should be displayed when the user right clicks - on the given column header. - - Index of the column that was right clicked. - This can be negative, which indicates a click outside of any header. - The toolstrip that should be displayed - - - - The user has right clicked on the column headers. Do whatever is required - - Return true if this event has been handle - - - - Show a popup menu at the given point which will allow the user to choose which columns - are visible on this listview - - Where should the menu be placed - - - - Show a popup menu at the given point which will allow the user to choose which columns - are visible on this listview - - - Where should the menu be placed - - - - 获取或设置要用于升序排序命令的文本 - - - - - 获取或设置要用于降序排序命令的文本 - - - - - 获取或设置要用于分组命令的文本 - - - - - 获取或设置要用于锁定分组命令的文本 - - - - - 获取或设置要用于不锁定分组命令的文本 - - - - - 获取或设置要用于关闭分组命令的文本 - - - - - 获取或设置要用于不排序命令的文本 - - - - - 获取或设置要用于列描述的文本 - - - - - 获取或设置要用于选择列描述的文本 - - - - - Gets or sets the image that will be place next to the Sort Ascending command - - - - - Gets or sets the image that will be placed next to the Sort Descending command - - - - - Append the column selection menu items to the given menu strip. - - The menu to which the items will be added. - - Return the menu to which the items were added - - - - Append the column selection menu items to the given menu strip. - - The menu to which the items will be added. - Return the menu to which the items were added - - - - Create the menu items that will allow columns to be choosen and add them to the - given collection - - - - - - Create a Filtering menu - - - - - - - - Override the OnColumnReordered method to do what we want - - - - - - When the column widths are changing, resize the space filling columns - - - - - - - When the column widths change, resize the space filling columns - - - - - - - When the size of the control changes, we have to resize our space filling columns. - - - - - - - Resize our space filling columns so they fill any unoccupied width in the control - - - - - Resize our space filling columns so they fill any unoccupied width in the control - - - - - Check all rows - - - - - Check the checkbox in the given column header - - If the given columns header check box is linked to the cell check boxes, - then checkboxes in all cells will also be checked. - - - - - Mark the checkbox in the given column header as having an indeterminate value - - - - - - Mark the given object as indeterminate check state - - The model object to be marked indeterminate - - - - Mark the given object as checked in the list - - The model object to be checked - - - - Mark the given objects as checked in the list - - The model object to be checked - - - - Put a check into the check box at the given cell - - - - - - - Put an indeterminate check into the check box at the given cell - - - - - - - Return true of the given object is checked - - The model object whose checkedness is returned - Is the given object checked? - If the given object is not in the list, this method returns false. - - - - Return true of the given object is indeterminately checked - - The model object whose checkedness is returned - Is the given object indeterminately checked? - If the given object is not in the list, this method returns false. - - - - Is there a check at the check box at the given cell - - - - - - - Get the checkedness of an object from the model. Returning null means the - model does not know and the value from the control will be used. - - - - - - - Record the change of checkstate for the given object in the model. - This does not update the UI -- only the model - - - - The check state that was recorded and that should be used to update - the control. - - - - Change the check state of the given object to be the given state. - - - If the given model object isn't in the list, we still try to remember - its state, in case it is referenced in the future. - - - True if the checkedness of the model changed - - - - Toggle the checkedness of the given object. A checked object becomes - unchecked; an unchecked or indeterminate object becomes checked. - If the list has tristate checkboxes, the order is: - unchecked -> checked -> indeterminate -> unchecked ... - - The model object to be checked - - - - Toggle the checkbox in the header of the given column - - Obviously, this is only useful if the column actually has a header checkbox. - - - - - Toggle the check at the check box of the given cell - - - - - - - Uncheck all rows - - - - - Mark the given object as unchecked in the list - - The model object to be unchecked - - - - Mark the given objects as unchecked in the list - - The model object to be checked - - - - Uncheck the checkbox in the given column header - - - - - - Uncheck the check at the given cell - - - - - - - 返回给定索引处的列 - - Index of the column to be returned - An OLVColumn - - - - 返回给定标题处的列,如果有多个符合要求的标题,则默认只返回第一个 - - 要返回的列的名称 - An OLVColumn - - - - 返回给定视图可见的列的集合。只有Tile和Details有列；所有其他视图都有0列。 - - 正在为哪个视图计算列？ - A list of columns - - - - 返回列表中的项目数 - - 列表中的项目数 - 如果安装了筛选器，这将返回与筛选器匹配的项目数。 - - - - 返回给定索引处的项 - - Index of the item to be returned - An OLVListItem - - - - 返回给定索引处的模型对象 - - Index of the model object to be returned - A model object - - - - 找出在给定的坐标下的行和列 - X 坐标 - Y 坐标 - 给定点下的列项 - 在给定坐标点下的行项。可以为null。 - - - - 返回给定索引/列的子项 - - Index of the item to be returned - Index of the subitem to be returned - An OLVListSubItem - - - - 滚动列表视图，使给定组位于顶部。 - - The group to be revealed - - 如果该组可见，如果可能，列表仍将滚动以将该组移至顶部。 - - 这只在列表显示分组时才有效(显然)。 - 这在虚拟列表上不起作用，因为虚拟列表不使用ListViewGroups进行分组。使用 代替. - - - - - 使给定的模型对象可见 - - The model object to be revealed - - - - 返回选定行的模型对象，如果没有选择或有多个选择，则返回null - - Model object or null - - - - 返回选定行的模型对象，如果没有选择，则返回空集合 - - ArrayList - - - - 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL - - Model object or null - 使用 CheckedObject 属性代替本方法 - - - - 获取选中的模型对象的集合。 - - 使用 CheckedObjects 属性代替本方法 - - - - 在列表视图中查找给定的模型对象并返回其索引 - - The model object to be found - The index of the object. -1 means the object was not present - - - - Rebuild the given ListViewItem with the data from its associated model. - - This method does not resort or regroup the view. It simply updates - the displayed data of the given item - - - - Rebuild the data on the row that is showing the given object. - - - - This method does not resort or regroup the view. - - - The given object is *not* used as the source of data for the rebuild. - It is only used to locate the matching model in the collection, - then that matching model is used as the data source. This distinction is - only important in model classes that have overridden the Equals() method. - - - If you want the given model object to replace the pre-existing model, - use . - - - - - - Update the rows that are showing the given objects - - - This method does not resort or regroup the view. - This method can safely be called from background threads. - - - - - 更新选定的行 - - This method does not resort or regroup the view. - - - - 除任何当前选择外，还选择显示给定模型对象的行。 - - The object to be selected - Use the property to deselect all other rows - - - - 除任何当前选择外，还选择显示给定模型对象的行。 - - The object to be selected - 对象是否也应该被聚焦 - Use the property to deselect all other rows - - - - 选择显示任意给定模型对象的行。取消选择所有其他行。 - - A collection of model objects - - - - 获取或设置是否冻结列表视图。当列表视图被冻结时，它不会自我更新。 - - Frozen属性与Freeze()/UnFreeze()方法类似， - 不同之处在于将Frozen属性设置为False会立即解冻控件， - 而不管有多少未完成的Freeze()调用。 - objectListView1.Frozen = false; // unfreeze the control now! - - - - - 冻结列表视图，使其不再自我更新。 - - Freeze()/Unfreeze() calls nest correctly - - - - 解冻列表视图。如果此调用是最外层的unFreeze()，则将重新构建listview的内容。 - - Freeze()/Unfreeze() calls nest correctly - - - - 在冻结列表视图时执行所需的实际工作 - - - - - 解冻列表视图时执行所需的实际工作 - - - - - 如果选择事件当前挂起，则返回TRUE。在挂起选择事件时，不会引发SelectedIndexChanged或SelectionChanged事件。 - - - - - Suspend selection events until a matching ResumeSelectionEvents() - is called. - - Calls to this method nest correctly. Every call to SuspendSelectionEvents() - must have a matching ResumeSelectionEvents(). - - - - Resume raising selection events. - - - - - Returns a disposable that will disable selection events - during a using() block. - - - - - - Implementation only class that suspends and resumes selection - events on instance creation and disposal. - - - - - 按最后一个排序列和顺序对项目进行排序 - - - - - 按给定列中的值和上次排序顺序对列表视图中的项进行排序 - - 其值将用于排序的列的名称 - - - - 按给定列中的值和上次排序顺序对列表视图中的项进行排序 - - 其值将用于排序的列的索引 - - - - 按给定列中的值和上次排序顺序对列表视图中的项进行排序 - - 其值将用于排序的列 - - - - 按给定列中的值和上次排序顺序对列表视图中的项进行排序 - - The column whose values will be used for the sorting. - If null, the first column will be used. - The ordering to be used for sorting. If this is None, - this.Sorting and then SortOrder.Ascending will be used - If ShowGroups is true, the rows will be grouped by the given column. - If AlwaysGroupsByColumn is not null, the rows will be grouped by that column, - and the rows within each group will be sorted by the given column. - - - - Put a sort indicator next to the text of the sort column - - - - - Put a sort indicator next to the text of the given given column - - The column to be marked - The sort order in effect on that column - - - - The name of the image used when a column is sorted ascending - - This image is only used on pre-XP systems. System images are used for XP and later - - - - The name of the image used when a column is sorted descending - - This image is only used on pre-XP systems. System images are used for XP and later - - - - If the sort indicator images don't already exist, this method will make and install them - - - - - Remove any sorting and revert to the given order of the model objects - - - - - Do the actual work of creating the given list of groups - - - - - - For some reason, UseItemStyleForSubItems doesn't work for the colors - when owner drawing the list, so we have to specifically give each subitem - the desired colors - - The item whose subitems are to be corrected - Cells drawn via BaseRenderer don't need this, but it is needed - when an owner drawn cell uses DrawDefault=true - - - - Fill in the given OLVListItem with values of the given row - - the OLVListItem that is to be stuff with values - the model object from which values will be taken - - - - Make sure the ListView has the extended style that says to display subitem images. - - This method must be called after any .NET call that update the extended styles - since they seem to erase this setting. - - - - Convert the given image selector to an index into our image list. - Return -1 if that's not possible - - - Index of the image in the imageList, or -1 - - - - Return the tooltip that should be shown when the mouse is hovered over the given column - - The column index whose tool tip is to be fetched - A string or null if no tool tip is to be shown - - - - 返回当鼠标悬停在给定单元格上时应显示的工具提示 - - The column index whose tool tip is to be fetched - The row index whose tool tip is to be fetched - A string or null if no tool tip is to be shown - - - - 返回显示给定模型对象的OLVListItem - - The modelObject whose item is to be found - The OLVListItem that displays the model, or null - This method has O(n) performance. - - - - Do the work required after the items in a listview have been created - - - - - Do the work required after one item in a listview have been created - - - - - 准备列表视图以显示交替的行背景色 - - We cannot rely on lvi.Index in this method. - In a straight list, lvi.Index is the display index, and can be used to determine - whether the row should be colored. But when organised by groups, lvi.Index is not - useable because it still refers to the position in the overall list, not the display order. - - - - - Setup all subitem images on all rows - - - - - 告诉基础列表控件针对子项显示哪些图像 - - the index at which the item occurs - the item whose subitems are to be set - - - - Tell the underlying list control which images to show against the subitems - - the index at which the item occurs - the item whose subitems are to be set - will existing images be cleared if no new image is provided? - - - - Set the subitem image natively - - - - - - - - - Take ownership of the 'objects' collection. This separats our collection from the source. - - - - This method - separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject - calls will modify our collection and not the original colleciton. - - - This method has the intentional side-effect of converting our list of objects to an ArrayList. - - - - - - 触发给定项目的FormatRow和可能的FormatCell事件 - - - - - - - - 触发给定项目的FormatCell事件 - - - - - - - - Make the list forget everything -- all rows and all columns - - Use if you want to remove just the rows. - - - - Update our externally visible image list so it holds the same images as our shadow list, but sized correctly - - - - - Return a copy of the given source image list, where each image has been resized to be height x height in size. - If source is null, an empty image list of the given size is returned - - Height and width of the new images - Height and width of the new images - Source of the images (can be null) - A new image list - - - - Return a bitmap of the given height x height, which shows the given image, centred. - - Height and width of new bitmap - Height and width of new bitmap - Image to be centred - The background color - A new bitmap - - - - Initialize the state image list with the required checkbox images - - - - - The name of the image used when a check box is checked - - - - - The name of the image used when a check box is unchecked - - - - - The name of the image used when a check box is Indeterminate - - - - - Setup this control so it can display check boxes on subitems - (or primary checkboxes in virtual mode) - - This gives the ListView a small image list, if it doesn't already have one. - - - - Make sure the small image list for this control has checkbox images - (used for sub-item checkboxes). - - - - This gives the ListView a small image list, if it doesn't already have one. - - - ObjectListView has to manage checkboxes on subitems separate from the checkboxes on each row. - The underlying ListView knows about the per-row checkboxes, and to make them work, OLV has to - correctly configure the StateImageList. However, the ListView cannot do checkboxes in subitems, - so ObjectListView has to handle them in a differnt fashion. So, per-row checkboxes are controlled - by images in the StateImageList, but per-cell checkboxes are handled by images in the SmallImageList. - - - - - - Owner draw the column header - - - - - - Owner draw the item - - - - - - Owner draw a single subitem - - - - - - We need the click count in the mouse up event, but that is always 1. - So we have to remember the click count from the preceding mouse down event. - - - - - - When the mouse leaves the control, remove any hot item highlighting - - - - - - When the mouse moves, we might need to change the hot item. - - - - - - Check to see if we need to start editing a cell - - - - - - Tell the world that a hyperlink was clicked and if the event isn't handled, - do the default processing. - - - - - - Do the default processing for a hyperlink clicked event, which - is to try and open the url. - - - - - - The user right clicked on the control - - - - - - This method is called every time a row is selected or deselected. This can be - a pain if the user shift-clicks 100 rows. We override this method so we can - trigger one event for any number of select/deselects that come from one user action - - - - - - Called when the handle of the underlying control is created - - - - - - This method is called after the control has been fully created. - - - - - Should we start editing the cell in response to the given mouse button event? - - - - - - - Handle a key press on this control. We specifically look for F2 which edits the primary column, - or a Tab character during an edit operation, which tries to start editing on the next (or previous) cell. - - - - - - - Start an editing operation on the first editable column of the given model. - - - - - If the model doesn't exist, or there are no editable columns, this method - will do nothing. - - This will start an edit operation regardless of CellActivationMode. - - - - - - Begin an edit operation on the given cell. - - This performs various sanity checks and passes off the real work to StartCellEdit(). - The row to be edited - The index of the cell to be edited - - - - Really start an edit operation on a given cell. The parameters are assumed to be sane. - - The row to be edited - The index of the cell to be edited - - - - Calculate the bounds of the edit control for the given item/column - - - - - - - - - Calculate the bounds of the edit control for the given item/column, when the listview - is being owner drawn. - - - - - - A rectangle that is the bounds of the cell editor - - - - Calculate the bounds of the edit control for the given item/column, when the listview - is not being owner drawn. - - - - - - A rectangle that is the bounds of the cell editor - - - - Try to give the given value to the provided control. Fall back to assigning a string - if the value assignment fails. - - A control - The value to be given to the control - The string to be given if the value doesn't work - - - - Setup the given control to be a cell editor - - - - - Return the value that the given control is showing - - - - - - - Called when the cell editor could be about to lose focus. Time to commit the change - - - - - - - Return the bounds of the given cell - - The row to be edited - The index of the cell to be edited - A Rectangle - - - - Return the bounds of the given cell only until the edge of the current text - - The row to be edited - The index of the cell to be edited - A Rectangle - - - - Calculate the visible bounds of the given column. The column's bottom edge is - either the bottom of the last row or the bottom of the control. - - The bounds of the control itself - The column - A Rectangle - This returns an empty rectnage if the control isn't in Details mode, - OR has doesn't have any rows, OR if the given column is hidden. - - - - Return a control that can be used to edit the value of the given cell. - - The row to be edited - The index of the cell to be edited - A Control to edit the given cell - - - - Get the first non-null value of the given column. - At most 1000 rows will be considered. - - - The first non-null value, or null if no non-null values were found - - - - Return a TextBox that can be used as a default cell editor. - - What column does the cell belong to? - - - - - Configure the given text box to autocomplete unique values - from the given column. At most 1000 rows will be considered. - - The textbox to configure - The column used to calculate values - - - - Configure the given text box to autocomplete unique values - from the given column. At most 1000 rows will be considered. - - The textbox to configure - The column used to calculate values - Consider only this many rows - - - - Stop editing a cell and throw away any changes. - - - - - If a cell edit is in progress, finish the edit. - - Returns false if the finishing process was cancelled - (i.e. the cell editor is still on screen) - This method does not guarantee that the editing will finish. The validation - process can cause the finishing to be aborted. Developers should check the return value - or use IsCellEditing property after calling this method to see if the user is still - editing a cell. - - - - If a cell edit is in progress, finish the edit. - - Returns false if the finishing process was cancelled - (i.e. the cell editor is still on screen) - This method does not guarantee that the editing will finish. The validation - process can cause the finishing to be aborted. Developers should check the return value - or use IsCellEditing property after calling this method to see if the user is still - editing a cell. - True if it is likely that another cell is going to be - edited immediately after this cell finishes editing - - - - Finish the cell edit operation, writing changed data back to the model object - - This method does not trigger a Validating event, so it always finishes - the cell edit. - - - - Finish the cell edit operation, writing changed data back to the model object - - This method does not trigger a Validating event, so it always finishes - the cell edit. - True if it is likely that another cell is going to be - edited immediately after this cell finishes editing - - - - Remove all trace of any existing cell edit operation - - True if it is likely that another cell is going to be - edited immediately after this cell finishes editing - True if the cell editor should be disposed - - - - Force the hot item to be recalculated - - - - - Force the hot item to be recalculated - - - - - The mouse has moved to the given pt. See if the hot item needs to be updated - - Where is the mouse? - This is the main entry point for hot item handling - - - - The mouse has moved to the given pt. See if the hot item needs to be updated - - - This is the main entry point for hot item handling - - - - Update the given row using the current hot item information - - - - - - Update the given row using the given hot item information - - - - - - - - - Apply a style to the given row - - - - - - - Apply a style to a cell - - - - - - - - Remove hot item styling from the given row - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Add the given decoration to those on this list and make it appear - - The decoration - - A decoration scrolls with the listview. An overlay stays fixed in place. - - - - - Add the given overlay to those on this list and make it appear - - The overlay - - - - Draw all the decorations - - A Graphics - The items that were redrawn and whose decorations should also be redrawn - - - - Is the given decoration shown on this list - - The overlay - - - - Is the given overlay shown on this list? - - The overlay - - - - Hide any overlays. - - - This is only a temporary hiding -- the overlays will be shown - the next time the ObjectListView redraws. - - - - - Create and configure the empty list msg overlay - - - - - Initialize the standard image and text overlays - - - - - Make sure that any overlays are visible. - - - - - Refresh the display of the overlays - - - - - Refresh the display of just one overlays - - - - - Remove the given decoration from this list - - The decoration to remove - - - - Remove the given overlay to those on this list - - The overlay - - - - 创建一个筛选器，该筛选器将执行当前安装在可见列上的所有筛选。 - - - - - Do the actual work of filtering - - - - - - - - - 删除所有列筛选。 - - - - - 根据每列中定义的值筛选更新此ObjectListView的筛选 - - - - - When some setting related to filtering changes, this method is called. - - - - - 使用当前安装的模型过滤器更新所有渲染器 - - - - - 获取给定模型的复选框状态。 - - The model - 模型的复选框状态。默认为未选中。 - - - - 设置给定模型对象的复选框状态 - - The model to be remembered - The model's checkedness - The state given to the method - - - - 忽略任何持久复选框状态 - - - - - The callbacks for CellEditing events - - this - We could replace this with EventHandler<CellEditEventArgs> but that would break all - cell editing event code from v1.x. - - - - - A TreeListView combines an expandable tree structure with list view columns. - - - To support tree operations, two delegates must be provided: - - - - CanExpandGetter - - - This delegate must accept a model object and return a boolean indicating - if that model should be expandable. - - - - - ChildrenGetter - - - This delegate must accept a model object and return an IEnumerable of model - objects that will be displayed as children of the parent model. This delegate will only be called - for a model object if the CanExpandGetter has already returned true for that model. - - - - - ParentGetter - - - This delegate must accept a model object and return the parent model. - This delegate will only be called when HierarchicalCheckboxes is true OR when Reveal() is called. - - - - - The top level branches of the tree are set via the Roots property. SetObjects(), AddObjects() - and RemoveObjects() are interpreted as operations on this collection of roots. - - - To add new children to an existing branch, make changes to your model objects and then - call RefreshObject() on the parent. - - The tree must be a directed acyclic graph -- no cycles are allowed. Put more mundanely, - each model object must appear only once in the tree. If the same model object appears in two - places in the tree, the control will become confused. - - - - - This event is triggered when user input requests the expansion of a list item. - - - - - This event is triggered when user input requests the collapse of a list item. - - - - - This event is triggered after the expansion of a list item due to user input. - - - - - This event is triggered after the collapse of a list item due to user input. - - - - - Trigger the expanding event - - - - - - Trigger the collapsing event - - - - - - Trigger the expanded event - - - - - - Trigger the collapsed event - - - - - - This class handles drawing the tree structure of the primary column. - - - - - Create a TreeRenderer - - - - - Should the renderer draw glyphs at the expansion points? - - The expansion points will still function to expand/collapse even if this is false. - - - - Should the renderer draw lines connecting siblings? - - - - - Return the pen that will be used to draw the lines between branches - - - - - Should the renderer draw triangles as the expansion glyphs? - - - This looks best with ShowLines = false - - - - - Return the branch that the renderer is currently drawing. - - - - - Return the TreeListView for which the renderer is being used. - - - - - How many pixels will be reserved for each level of indentation? - - - - - The real work of drawing the tree is done in this method - - - - - - - Draw the expansion indicator - - - - - - - - Gets whether or not we should render using styles - - - - - Draw the expansion indicator using styles - - - - - - - - Is the mouse over a checkbox in this cell? - - - - - Draw the expansion indicator without using styles - - - - - - - - Draw the lines of the tree - - - - - - - - - - Do the hit test - - - - - - - - - Calculate the edit rect - - - - - - - - - - - Make a default TreeListView - - - - - This is the delegate that will be used to decide if a model object can be expanded. - - - - This is called *often* -- on every mouse move when required. It must be fast. - Don't do database lookups, linear searches, or pi calculations. Just return the - value of a property. - - - When this delegate is called, the TreeListView is not in a stable state. Don't make - calls back into the control. - - - - - - Gets whether or not this listview is capable of showing groups - - - - - This is the delegate that will be used to fetch the children of a model object - - - - This delegate will only be called if the CanExpand delegate has - returned true for the model object. - - - When this delegate is called, the TreeListView is not in a stable state. Don't do anything - that will result in calls being made back into the control. - - - - - - This is the delegate that will be used to fetch the parent of a model object - - The parent of the given model, or null if the model doesn't exist or - if the model is a root - - - - Get or set the collection of model objects that are checked. - When setting this property, any row whose model object isn't - in the given collection will be unchecked. Setting to null is - equivalent to unchecking all. - - - - This property returns a simple collection. Changes made to the returned - collection do NOT affect the list. This is different to the behaviour of - CheckedIndicies collection. - - - When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. - When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus - the number of objects to be checked. - - - If the ListView is not currently showing CheckBoxes, this property does nothing. It does - not remember any check box settings made. - - - - - - Gets or sets the model objects that are expanded. - - - This can be used to expand model objects before they are seen. - - Setting this does *not* force the control to rebuild - its display. You need to call RebuildAll(true). - - - - - - Gets or sets the filter that is applied to our whole list of objects. - TreeListViews do not currently support whole list filters. - - - - - Gets or sets whether this tree list view will display hierarchical checkboxes. - Hierarchical checkboxes is when a parent's "checkedness" is calculated from - the "checkedness" of its children. If all children are checked, the parent - will be checked. If all children are unchecked, the parent will also be unchecked. - If some children are checked and others are not, the parent will be indeterminate. - - - Hierarchical checkboxes don't work with either CheckStateGetters or CheckedAspectName - (which is basically the same thing). This is because it is too expensive to build the - initial state of the control if these are installed, since the control would have to walk - *every* branch recursively since a single bottom level leaf could change the checkedness - of the top root. - - - - - Gets or sets the collection of root objects of the tree - - - - - Gets the collection of objects that will be considered when creating clusters - (which are used to generate Excel-like column filters) - - - - - After expanding a branch, should the TreeListView attempts to show as much of the - revealed descendents as possible. - - - - - The model objects that form the top level branches of the tree. - - Setting this does NOT reset the state of the control. - In particular, it does not collapse branches. - - - - Make sure that at least one column is displaying a tree. - If no columns is showing the tree, make column 0 do it. - - - - - Gets or sets the renderer that will be used to draw the tree structure. - Setting this to null resets the renderer to default. - - If a column is currently rendering the tree, the renderer - for that column will be replaced. If no column is rendering the tree, - column 0 will be given this renderer. - - - - This is the delegate that will be used to create the underlying Tree structure - that the TreeListView uses to manage the information about the tree. - - - The factory must not return null. - - Most users of TreeListView will never have to use this delegate. - - - - - - Should a wait cursor be shown when a branch is being expanded? - - When this is true, the wait cursor will be shown whilst the children of the - branch are being fetched. If the children of the branch have already been cached, - the cursor will not change. - - - - Gets the model that is used to manage the tree structure - - - Don't mess with this property unless you really know what you are doing. - If you don't already know what it's for, you don't need it. - - - - Return true if the branch at the given model is expanded - - - - - - - Collapse the subtree underneath the given model - - - - - - Collapse all subtrees within this control - - - - - Remove all items from this list - - This method can safely be called from background threads. - - - - Collapse all roots and forget everything we know about all models - - - - - Expand the subtree underneath the given model object - - - - - - Expand all the branches within this tree recursively. - - Be careful: this method could take a long time for large trees. - - - - Completely rebuild the tree structure - - If true, the control will try to preserve selection and expansion - - - - Completely rebuild the tree structure - - If not null, this list of objects will be selected after the tree is rebuilt - If not null, this collection of objects will be expanded after the tree is rebuilt - If not null, this collection of objects will be checked after the tree is rebuilt - - - - Unroll all the ancestors of the given model and make sure it is then visible. - - This works best when a ParentGetter is installed. - The object to be revealed - If true, the model will be selected and focused after being revealed - True if the object was found and revealed. False if it was not found. - - - - Update the rows that are showing the given objects - - - - - Change the check state of the given object to be the given state. - - - If the given model object isn't in the list, we still try to remember - its state, in case it is referenced in the future. - - - True if the checkedness of the model changed - - - - Toggle the expanded state of the branch at the given model object - - - - - - Return whether or not the given model can expand. - - - The given model must have already been seen in the tree - - - - Return the model object that is the parent of the given model object. - - - - The given model must have already been seen in the tree. - - - - Return the collection of model objects that are the children of the - given model as they exist in the tree at the moment. - - - - - This method returns the collection of children as the tree knows them. If the given - model has never been presented to the user (e.g. it belongs to a parent that has - never been expanded), then this method will return an empty collection. - - Because of this, if you want to traverse the whole tree, this is not the method to use. - It's better to traverse the your data model directly. - - - If the given model has not already been seen in the tree or - if it is not expandable, an empty collection will be returned. - - - - - - Delegates of this type are use to decide if the given model object can be expanded - - The model under consideration - Can the given model be expanded? - - - - Delegates of this type are used to fetch the children of the given model object - - The parent whose children should be fetched - An enumerable over the children - - - - Delegates of this type are used to fetch the parent of the given model object. - - The child whose parent should be fetched - The parent of the child or null if the child is a root - - - - Delegates of this type are used to create a new underlying Tree structure. - - The view for which the Tree is being created - A subclass of Tree - - - - Handle a left button down event - - - - - - - Create a OLVListItem for given row index - - The index of the row that is needed - An OLVListItem - This differs from the base method by also setting up the IndentCount property. - - - - Reinitialize the Tree structure - - - - - Recalculate the state of the checkboxes of all the items in the given list - and their ancestors. - - This only makes sense when HierarchicalCheckboxes is true. - - - - - Recalculate the hierarchy state of the given item and its ancestors - - This only makes sense when HierarchicalCheckboxes is true. - - - - - Yield the unique ancestors of the given collection of objects. - The order of the ancestors is guaranteed to be deeper objects first. - Roots will always be last. - - - Unique ancestors of the given objects - - - - Return all the ancestors of the given model - - - - This uses ParentGetter if possible. - - If the given model is a root OR if the model doesn't exist, the collection will be empty - - The model whose ancestors should be calculated - Return a collection of ancestors of the given model. - - - - The application is idle and a SelectionChanged event has been scheduled - - - - - - - Decide if the given key event should be handled as a normal key input to the control? - - - - - - - Handle focus being lost, including making sure that the whole control is redrawn. - - - - - - Handle the keyboard input to mimic a TreeView. - - - Was the key press handled? - - - - A Tree object represents a tree structure data model that supports both - tree and flat list operations as well as fast access to branches. - - If you create a subclass of Tree, you must install it in the TreeListView - via the TreeFactory delegate. - - - - Create a Tree - - - - - - This is the delegate that will be used to decide if a model object can be expanded. - - - - - This is the delegate that will be used to fetch the children of a model object - - This delegate will only be called if the CanExpand delegate has - returned true for the model object. - - - - Get or return the top level model objects in the tree - - - - - What tree view is this Tree the model for? - - - - - Collapse the subtree underneath the given model - - The model to be collapsed. If the model isn't in the tree, - or if it is already collapsed, the command does nothing. - The index of the model in flat list version of the tree - - - - Collapse all branches in this tree - - Nothing useful - - - - Expand the subtree underneath the given model object - - The model to be expanded. - The index of the model in flat list version of the tree - - If the model isn't in the tree, - if it cannot be expanded or if it is already expanded, the command does nothing. - - - - - Expand all branches in this tree - - Return the index of the first branch that was expanded - - - - Return the Branch object that represents the given model in the tree - - The model whose branches is to be returned - The branch that represents the given model, or null if the model - isn't in the tree. - - - - Return the number of visible descendents that are below the given model. - - The model whose descendent count is to be returned - The number of visible descendents. 0 if the model doesn't exist or is collapsed - - - - Rebuild the children of the given model, refreshing any cached information held about the given object - - - The index of the model in flat list version of the tree - - - - Is the given model expanded? - - - - - - - Remember whether or not the given model was expanded - - - - - - - Insert the children of the given branch into the given position - - The branch whose children should be inserted - The index where the children should be inserted - - - - Rebuild our flat internal list of objects. - - - - - Rebuild our reverse index that maps an object to its location - in the filteredObjectList array. - - - - - - Create a new branch within this tree - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Sort the tree on the given column and in the given order - - - - - - - - - - - - - Add the given collection of objects to the roots of this tree - - - - - - - - - - - - - Remove all of the given objects from the roots of the tree. - Any objects that is not already in the roots collection is ignored. - - - - - - Set the roots of this tree to be the given collection - - - - - - Update/replace the nth object with the given object - - - - - - - - - - - - - - Is this list currently being filtered? - - - - - Should the given model be included in this control? - - The model to consider - True if it will be included - - - - - - - - - - - - - - A Branch represents a sub-tree within a tree - - - - - Indicators for branches - - - - - FirstBranch of tree - - - - - LastChild of parent - - - - - OnlyBranch of tree - - - - - Create a Branch - - - - - - - - Get the ancestor branches of this branch, with the 'oldest' ancestor first. - - - - - Can this branch be expanded? - - - - - Gets or sets our children - - - - - Get/set the model objects that are beneath this branch - - - - - Gets a list of all the branches that survive filtering - - - - - Gets or set whether this branch is expanded - - - - - Return true if this branch is the first branch of the entire tree - - - - - Return true if this branch is the last child of its parent - - - - - Return true if this branch is the only top level branch - - - - - Gets the depth level of this branch - - - - - Gets or sets which model is represented by this branch - - - - - Return the number of descendents of this branch that are currently visible - - - - - - Gets or sets our parent branch - - - - - Gets or sets our overall tree - - - - - Is this branch currently visible? A branch is visible - if it has no parent (i.e. it's a root), or its parent - is visible and expanded. - - - - - Clear any cached information that this branch is holding - - - - - Collapse this branch - - - - - Expand this branch - - - - - Expand this branch recursively - - - - - Collapse all branches in this tree - - Nothing useful - - - - Fetch the children of this branch. - - This should only be called when CanExpand is true. - - - - Collapse the visible descendents of this branch into list of model objects - - - - - - Flatten this branch's visible descendents onto the given list. - - - The branch itself is not included in the list. - - - - Force a refresh of all children recursively - - - - - Sort the sub-branches and their descendents so they are ordered according - to the given comparer. - - The comparer that orders the branches - - - - This class sorts branches according to how their respective model objects are sorted - - - - - Create a BranchComparer - - - - - - Order the two branches - - - - - - - - Let the world know that a cell edit operation is beginning or ending - - - - - Create an event args - - - - - - - - - - Change this to true to cancel the cell editing operation. - - - During the CellEditStarting event, setting this to true will prevent the cell from being edited. - During the CellEditFinishing event, if this value is already true, this indicates that the user has - cancelled the edit operation and that the handler should perform cleanup only. Setting this to true, - will prevent the ObjectListView from trying to write the new value into the model object. - - - - - During the CellEditStarting event, this can be modified to be the control that you want - to edit the value. You must fully configure the control before returning from the event, - including its bounds and the value it is showing. - During the CellEditFinishing event, you can use this to get the value that the user - entered and commit that value to the model. Changing the control during the finishing - event has no effect. - - - - - The column of the cell that is going to be or has been edited. - - - - - The model object of the row of the cell that is going to be or has been edited. - - - - - The listview item of the cell that is going to be or has been edited. - - - - - The data value of the cell as it stands in the control. - - Only validate during Validating and Finishing events. - - - - The index of the cell that is going to be or has been edited. - - - - - The data value of the cell before the edit operation began. - - - - - The bounds of the cell that is going to be or has been edited. - - - - - Gets or sets whether the control used for editing should be auto matically disposed - when the cell edit operation finishes. Defaults to true - - If the control is expensive to create, you might want to cache it and reuse for - for various cells. If so, you don't want ObjectListView to dispose of the control automatically - - - - Event blocks for events that can be cancelled - - - - - Has this event been cancelled by the event handler? - - - - - BeforeSorting - - - - - Create BeforeSortingEventArgs - - - - - - - - - Create BeforeSortingEventArgs - - - - - - - - - - - Did the event handler already do the sorting for us? - - - - - What column will be used for grouping - - - - - How will groups be ordered - - - - - What column will be used for sorting - - - - - What order will be used for sorting. None means no sorting. - - - - - What column will be used for secondary sorting? - - - - - What order will be used for secondary sorting? - - - - - Sorting has just occurred. - - - - - Create a AfterSortingEventArgs - - - - - - - - - - - Create a AfterSortingEventArgs - - - - - - What column was used for grouping? - - - - - What ordering was used for grouping? - - - - - What column was used for sorting? - - - - - What ordering was used for sorting? - - - - - What column was used for secondary sorting? - - - - - What order was used for secondary sorting? - - - - - This event is triggered when the contents of a list have changed - and we want the world to have a chance to filter the list. - - - - - Create a FilterEventArgs - - - - - - Gets or sets what objects are being filtered - - - - - Gets or sets what objects survived the filtering - - - - - This event is triggered after the items in the list have been changed, - either through SetObjects, AddObjects or RemoveObjects. - - - - - Create a ItemsChangedEventArgs - - - - - Constructor for this event when used by a virtual list - - - - - - - Gets how many items were in the list before it changed - - - - - Gets how many objects are in the list after the change. - - - - - This event is triggered by AddObjects before any change has been made to the list. - - - - - Create an ItemsAddingEventArgs - - - - - - Create an ItemsAddingEventArgs - - - - - - - Gets or sets where the collection is going to be inserted. - - - - - Gets or sets the objects to be added to the list - - - - - This event is triggered by SetObjects before any change has been made to the list. - - - When used with a virtual list, OldObjects will always be null. - - - - - Create ItemsChangingEventArgs - - - - - - - Gets the objects that were in the list before it change. - For virtual lists, this will always be null. - - - - - Gets or sets the objects that will be in the list after it changes. - - - - - This event is triggered by RemoveObjects before any change has been made to the list. - - - - - Create an ItemsRemovingEventArgs - - - - - - Gets or sets the objects that will be removed - - - - - Triggered after the user types into a list - - - - - Create an AfterSearchingEventArgs - - - - - - - Gets the string that was actually searched for - - - - - Gets or sets whether an the event handler already handled this event - - - - - Gets the index of the row that was selected by the search. - -1 means that no row was matched - - - - - Triggered when the user types into a list - - - - - Create BeforeSearchingEventArgs - - - - - - - Gets or sets the string that will be found by the search routine - - Modifying this value does not modify the memory of what the user has typed. - When the user next presses a character, the search string will revert to what - the user has actually typed. - - - - Gets or sets the index of the first row that will be considered to matching. - - - - - The parameter block when telling the world about a cell based event - - - - - Gets the ObjectListView that is the source of the event - - - - - Gets the model object under the cell - - This is null for events triggered by the header. - - - - Gets the row index of the cell - - This is -1 for events triggered by the header. - - - - Gets the column index of the cell - - This is -1 when the view is not in details view. - - - - Gets the column of the cell - - This is null when the view is not in details view. - - - - Gets the location of the mouse at the time of the event - - - - - Gets the state of the modifier keys at the time of the event - - - - - Gets the item of the cell - - - - - Gets the subitem of the cell - - This is null when the view is not in details view and - for event triggered by the header - - - - Gets the HitTest object that determined which cell was hit - - - - - Gets or set if this event completelely handled. If it was, no further processing - will be done for it. - - - - - Tells the world that a cell was clicked - - - - - Gets or sets the number of clicks associated with this event - - - - - Tells the world that a cell was right clicked - - - - - Gets or sets the menu that should be displayed as a result of this event. - - The menu will be positioned at Location, so changing that property changes - where the menu will be displayed. - - - - Tell the world that the mouse is over a given cell - - - - - Tells the world that the frozen-ness of the ObjectListView has changed. - - - - - Make a FreezeEventArgs - - - - - - How frozen is the control? 0 means that the control is unfrozen, - more than 0 indicates froze. - - - - - The parameter block when telling the world that a tool tip is about to be shown. - - - - - Gets the tooltip control that is triggering the tooltip event - - - - - Gets or sets the text should be shown on the tooltip for this event - - Setting this to empty or null prevents any tooltip from showing - - - - In what direction should the text for this tooltip be drawn? - - - - - Should the tooltip for this event been shown in bubble style? - - This doesn't work reliable under Vista - - - - What color should be used for the background of the tooltip - - Setting this does nothing under Vista - - - - What color should be used for the foreground of the tooltip - - Setting this does nothing under Vista - - - - What string should be used as the title for the tooltip for this event? - - - - - Which standard icon should be used for the tooltip for this event - - - - - How many milliseconds should the tooltip remain before it automatically - disappears. - - - - - What font should be used to draw the text of the tooltip? - - - - - Common information to all hyperlink events - - - - - Gets the ObjectListView that is the source of the event - - - - - Gets the model object under the cell - - - - - Gets the row index of the cell - - - - - Gets the column index of the cell - - This is -1 when the view is not in details view. - - - - Gets the column of the cell - - This is null when the view is not in details view. - - - - Gets the item of the cell - - - - - Gets the subitem of the cell - - This is null when the view is not in details view - - - - Gets the ObjectListView that is the source of the event - - - - - Gets or set if this event completelely handled. If it was, no further processing - will be done for it. - - - - - - - - - - Gets the ObjectListView that is the source of the event - - - - - Gets the model object under the cell - - - - - Gets the column of the cell - - This is null when the view is not in details view. - - - - Gets the text of the cell - - - - - Gets or sets whether or not this cell is a hyperlink. - Defaults to true for enabled rows and false for disabled rows. - - - - - Gets or sets the url that should be invoked when this cell is clicked. - - Setting this to None or String.Empty means that this cell is not a hyperlink - - - - - - - - Gets the ObjectListView that is the source of the event - - - - - Gets the item of the cell - - - - - Gets the model object under the cell - - - - - Gets the row index of the cell - - - - - Gets the display index of the row - - - - - Should events be triggered for each cell in this row? - - - - - Parameter block for FormatCellEvent - - - - - Gets the column index of the cell - - This is -1 when the view is not in details view. - - - - Gets the column of the cell - - This is null when the view is not in details view. - - - - Gets the subitem of the cell - - This is null when the view is not in details view - - - - Gets the model value that is being displayed by the cell. - - This is null when the view is not in details view - - - - The event args when a hyperlink is clicked - - - - - Gets the url that was associated with this cell. - - - - - The event args when the check box in a column header is changing - - - - - Get the column whose checkbox is changing - - - - - Get or set the new state that should be used by the column - - - - - The event args when the hot item changed - - - - - Gets or set if this event completelely handled. If it was, no further processing - will be done for it. - - - - - Gets the part of the cell that the mouse is over - - - - - Gets an extended indication of the part of item/subitem/group that the mouse is currently over - - - - - Gets the index of the column that the mouse is over - - In non-details view, this will always be 0. - - - - Gets the index of the row that the mouse is over - - - - - Gets the group that the mouse is over - - - - - Gets the part of the cell that the mouse used to be over - - - - - Gets an extended indication of the part of item/subitem/group that the mouse used to be over - - - - - Gets the index of the column that the mouse used to be over - - - - - Gets the index of the row that the mouse used to be over - - - - - Gets the group that the mouse used to be over - - - - - Returns a string that represents the current object. - - - A string that represents the current object. - - 2 - - - - Let the world know that a checkbox on a subitem is changing - - - - - Create a new event block - - - - - - - - - - The column of the cell that is having its checkbox changed. - - - - - The model object of the row of the cell that is having its checkbox changed. - - - - - The listview item of the cell that is having its checkbox changed. - - - - - The current check state of the cell. - - - - - The proposed new check state of the cell. - - - - - The index of the cell that is going to be or has been edited. - - - - - This event argument block is used when groups are created for a list. - - - - - Create a CreateGroupsEventArgs - - - - - - Gets the settings that control the creation of groups - - - - - Gets or sets the groups that should be used - - - - - Has this event been cancelled by the event handler? - - - - - This event argument block is used when the text of a group task is clicked - - - - - Create a GroupTaskClickedEventArgs - - - - - - Gets which group was clicked - - - - - This event argument block is used when a group is about to expand or collapse - - - - - Create a GroupExpandingCollapsingEventArgs - - - - - - Gets which group is expanding/collapsing - - - - - Gets whether this event is going to expand the group. - If this is false, the group must be collapsing. - - - - - This event argument block is used when the state of group has changed (collapsed, selected) - - - - - Create a GroupStateChangedEventArgs - - - - - - - - Gets whether the group was collapsed by this event - - - - - Gets whether the group was focused by this event - - - - - Gets whether the group was selected by this event - - - - - Gets whether the group was uncollapsed by this event - - - - - Gets whether the group was unfocused by this event - - - - - Gets whether the group was unselected by this event - - - - - Gets which group had its state changed - - - - - Gets the previous state of the group - - - - - Gets the new state of the group - - - - - This event argument block is used when a branch of a tree is about to be expanded - - - - - Create a new event args - - - - - - - Gets the model that is about to expand. If null, all branches are going to be expanded. - - - - - Gets the OLVListItem that is about to be expanded - - - - - This event argument block is used when a branch of a tree has just been expanded - - - - - Create a new event args - - - - - - - Gets the model that is was expanded. If null, all branches were expanded. - - - - - Gets the OLVListItem that was expanded - - - - - This event argument block is used when a branch of a tree is about to be collapsed - - - - - Create a new event args - - - - - - - Gets the model that is about to collapse. If this is null, all models are going to collapse. - - - - - Gets the OLVListItem that is about to be collapsed. Can be null - - - - - This event argument block is used when a branch of a tree has just been collapsed - - - - - Create a new event args - - - - - - - Gets the model that is was collapsed. If null, all branches were collapsed - - - - - Gets the OLVListItem that was collapsed - - - - - This class contains all the settings used when groups are created - - - - - Create a GroupingParameters - - - - - - - - - - - - - - - Gets or sets the ObjectListView being grouped - - - - - Gets or sets the column used to create groups - - - - - In what order will the groups themselves be sorted? - - - - - If this is set, this comparer will be used to order the groups - - - - - If this is set, this comparer will be used to order items within each group - - - - - Gets or sets the column that will be the primary sort - - - - - Gets or sets the ordering for the primary sort - - - - - Gets or sets the column used for secondary sorting - - - - - Gets or sets the ordering for the secondary sort - - - - - Gets or sets the title format used for groups with zero or more than one element - - - - - Gets or sets the title format used for groups with only one element - - - - - Gets or sets whether the items should be sorted by the primary column - - - - - These values indicate what is the state of the group. These values - are taken directly from the SDK and many are not used by ObjectListView. - - - - - Normal - - - - - Collapsed - - - - - Hidden - - - - - NoHeader - - - - - Can be collapsed - - - - - Has focus - - - - - Is Selected - - - - - Is subsetted - - - - - Subset link has focus - - - - - All styles - - - - - This mask indicates which members of a LVGROUP have valid data. These values - are taken directly from the SDK and many are not used by ObjectListView. - - - - - No mask - - - - - Group has header - - - - - Group has footer - - - - - Group has state - - - - - - - - - - - - - - - pszSubtitle is valid - - - - - pszTask is valid - - - - - pszDescriptionTop is valid - - - - - pszDescriptionBottom is valid - - - - - iTitleImage is valid - - - - - iExtendedImage is valid - - - - - iFirstItem and cItems are valid - - - - - pszSubsetTitle is valid - - - - - readonly, cItems holds count of items in visible subset, iFirstItem is valid - - - - - This mask indicates which members of a GROUPMETRICS structure are valid - - - - - - - - - - - - - - - - - - - - - - - - - Instances of this class enhance the capabilities of a normal ListViewGroup, - enabling the functionality that was released in v6 of the common controls. - - - - In this implementation (2009-09), these objects are essentially passive. - Setting properties does not automatically change the associated group in - the listview. Collapsed and Collapsible are two exceptions to this and - give immediate results. - - - This really should be a subclass of ListViewGroup, but that class is - sealed (why is that?). So this class provides the same interface as a - ListViewGroup, plus many other new properties. - - - - - - Create an OLVGroup - - - - - 按指定标题创建分组 - - 分组标题 - - - - Gets or sets the bottom description of the group - - - Descriptions only appear when group is centered and there is a title image - - - - - Gets or sets whether or not this group is collapsed - - - - - Gets or sets whether or not this group can be collapsed - - - - - Gets or sets some representation of the contents of this group - - This is user defined (like Tag) - - - - Gets whether this group has been created. - - - - - Gets or sets the int or string that will select the extended image to be shown against the title - - - - - Gets or sets the footer of the group - - - - - Gets the internal id of our associated ListViewGroup. - - - - - Gets or sets the header of the group - - - - - Gets or sets the horizontal alignment of the group header - - - - - Gets or sets the internally created id of the group - - - - - Gets or sets ListViewItems that are members of this group - - Listener of the BeforeCreatingGroups event can populate this collection. - It is only used on non-virtual lists. - - - - Gets or sets the key that was used to partition objects into this group - - This is user defined (like Tag) - - - - Gets the ObjectListView that this group belongs to - - If this is null, the group has not yet been created. - - - - Gets or sets the name of the group - - As of 2009-09-01, this property is not used. - - - - Gets or sets whether this group is focused - - - - - Gets or sets whether this group is selected - - - - - Gets or sets the text that will show that this group is subsetted - - - As of WinSDK v7.0, subsetting of group is officially unimplemented. - We can get around this using undocumented interfaces and may do so. - - - - - Gets or set the subtitleof the task - - - - - Gets or sets the value by which this group will be sorted. - - - - - Gets or sets the state of the group - - - - - Gets or sets which bits of State are valid - - - - - Gets or sets whether this group is showing only a subset of its elements - - - As of WinSDK v7.0, this property officially does nothing. - - - - - Gets or sets the user-defined data attached to this group - - - - - Gets or sets the task of this group - - This task is the clickable text that appears on the right margin - of the group header. - - - - Gets or sets the int or string that will select the image to be shown against the title - - - - - Gets or sets the top description of the group - - - Descriptions only appear when group is centered and there is a title image - - - - - Gets or sets the number of items that are within this group. - - This should only be used for virtual groups. - - - - Gets or sets the ListViewGroup that is shadowed by this group. - - For virtual groups, this will always be null. - - - - Calculate the index into the group image list of the given image selector - - - - - - - Convert this object to a string representation - - - - - - Insert a native group into the underlying Windows control, - *without* using a ListViewGroup - - - This is used when creating virtual groups - - - - Insert a native group into the underlying control via a ListViewGroup - - - - - - Change the members of the group to match the current contents of Items, - using a ListViewGroup - - - - - Create a native LVGROUP structure that matches this group - - - - - Get the current state of this group from the underlying control - - - - - Get the current state of this group from the underlying control - - - - - An instance of Munger gets a value from or puts a value into a target object. The property - to be peeked (or poked) is determined from a string. The peeking or poking is done using reflection. - - - Name of the aspect to be peeked can be a field, property or parameterless method. The name of an - aspect to poke can be a field, writable property or single parameter method. - - Aspect names can be dotted to chain a series of references. - - Order.Customer.HomeAddress.State - - - - - Create a do nothing Munger - - - - - Create a Munger that works on the given aspect name - - The name of the - - - - A helper method to put the given value into the given aspect of the given object. - - This method catches and silently ignores any errors that occur - while modifying the target object - The object to be modified - The name of the property/field to be modified - The value to be assigned - Did the modification work? - - - - Gets or sets whether Mungers will silently ignore missing aspect errors. - - - - By default, if a Munger is asked to fetch a field/property/method - that does not exist from a model, it returns an error message, since that - condition is normally a programming error. There are some use cases where - this is not an error, and the munger should simply keep quiet. - - By default this is true during release builds. - - - - - The name of the aspect that is to be peeked or poked. - - - - This name can be a field, property or parameter-less method. - - - The name can be dotted, which chains references. If any link in the chain returns - null, the entire chain is considered to return null. - - - "DateOfBirth" - "Owner.HomeAddress.Postcode" - - - - Extract the value indicated by our AspectName from the given target. - - If the aspect name is null or empty, this will return null. - The object that will be peeked - The value read from the target - - - - Extract the value indicated by our AspectName from the given target, raising exceptions - if the munger fails. - - If the aspect name is null or empty, this will return null. - The object that will be peeked - The value read from the target - - - - Poke the given value into the given target indicated by our AspectName. - - - - If the AspectName is a dotted path, all the selectors bar the last - are used to find the object that should be updated, and the last - selector is used as the property to update on that object. - - - So, if 'target' is a Person and the AspectName is "HomeAddress.Postcode", - this method will first fetch "HomeAddress" property, and then try to set the - "Postcode" property on the home address object. - - - The object that will be poked - The value that will be poked into the target - bool indicating whether the put worked - - - - Gets the list of SimpleMungers that match our AspectName - - - - - Convert a possibly dotted AspectName into a list of SimpleMungers - - - - - - - Evaluate the given chain of SimpleMungers against an initial target. - - - - - - - - A SimpleMunger deals with a single property/field/method on its target. - - - Munger uses a chain of these resolve a dotted aspect name. - - - - - Create a SimpleMunger - - - - - - The name of the aspect that is to be peeked or poked. - - - - This name can be a field, property or method. - When using a method to get a value, the method must be parameter-less. - When using a method to set a value, the method must accept 1 parameter. - - - It cannot be a dotted name. - - - - - - Get a value from the given target - - - - - - - Poke the given value into the given target indicated by our AspectName. - - The object that will be poked - The value that will be poked into the target - bool indicating if the put worked - - - - These exceptions are raised when a munger finds something it cannot process - - - - - Create a MungerException - - - - - - - - Get the munger that raised the exception - - - - - Gets the target that threw the exception - - - - - Wrapper for all native method calls on ListView controls - - - - - Put an image under the ListView. - - - - The ListView must have its handle created before calling this. - - - This doesn't work very well. Specifically, it doesn't play well with owner drawn, - and grid lines are drawn over it. - - - - The image to be used as the background. If this is null, any existing background image will be cleared. - If this is true, the image is pinned to the bottom right and does not scroll. The other parameters are ignored - If this is true, the image will be tiled to fill the whole control background. The offset parameters will be ignored. - If both watermark and tiled are false, this indicates the horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. - If both watermark and tiled are false, this indicates the vertical percentage where the image will be placed. - - - - - Flags controlling how the Image List item is - drawn - - - - - Draw item normally. - - - - - Draw item transparently. - - - - - Draw item blended with 25% of the specified foreground colour - or the Highlight colour if no foreground colour specified. - - - - - Draw item blended with 50% of the specified foreground colour - or the Highlight colour if no foreground colour specified. - - - - - Draw the icon's mask - - - - - Draw the icon image without using the mask - - - - - Draw the icon using the ROP specified. - - - - - Preserves the alpha channel in dest. XP only. - - - - - Scale the image to cx, cy instead of clipping it. XP only. - - - - - Scale the image to the current DPI of the display. XP only. - - - - - Enumeration containing XP ImageList Draw State options - - - - - The image state is not modified. - - - - - Adds a glow effect to the icon, which causes the icon to appear to glow - with a given color around the edges. (Note: does not appear to be implemented) - - - - - Adds a drop shadow effect to the icon. (Note: does not appear to be implemented) - - - - - Saturates the icon by increasing each color component - of the RGB triplet for each pixel in the icon. (Note: only ever appears to result in a completely unsaturated icon) - - - - - Alpha blends the icon. Alpha blending controls the transparency - level of an icon, according to the value of its alpha channel. - (Note: does not appear to be implemented). - - - - - Draws an image using the specified flags and state on XP systems. - - The image list from which an item will be drawn - Device context to draw to - Index of image to draw - X Position to draw at - Y Position to draw at - Drawing flags - Width to draw - Height to draw - State flags - - - - Make sure the ListView has the extended style that says to display subitem images. - - This method must be called after any .NET call that update the extended styles - since they seem to erase this setting. - The listview to send a m to - - - - Change the virtual list size of the given ListView (which must be in virtual mode) - - This will not change the scroll position - The listview to send a message to - How many rows should the list have? - - - - Make sure the ListView has the extended style that says to display subitem images. - - This method must be called after any .NET call that update the extended styles - since they seem to erase this setting. - The listview to send a m to - - - - - - Calculates the number of items that can fit vertically in the visible area of a list-view (which - must be in details or list view. - - The listView - Number of visible items per page - - - - For the given item and subitem, make it display the given image - - The listview to send a m to - row number (0 based) - subitem (0 is the item itself) - index into the image list - - - - Setup the given column of the listview to show the given image to the right of the text. - If the image index is -1, any previous image is cleared - - The listview to send a m to - Index of the column to modifiy - - Index into the small image list - - - - Does this version of the operating system have builtin sort indicators? - - Are there builtin sort indicators - XP and later have these - - - - Return the bounds of the update region on the given control. - - The BeginPaint() system call validates the update region, effectively wiping out this information. - So this call has to be made before the BeginPaint() call. - The control whose update region is be calculated - A rectangle - - - - Validate an area of the given control. A validated area will not be repainted at the next redraw. - - The control to be validated - The area of the control to be validated - - - - Select all rows on the given listview - - The listview whose items are to be selected - - - - Deselect all rows on the given listview - - The listview whose items are to be deselected - - - - Deselect a single row - - - - - - - Set the item state on the given item - - The listview whose item's state is to be changed - The index of the item to be changed - Which bits of the value are to be set? - The value to be set - - - - Scroll the given listview by the given deltas - - - - - true if the scroll succeeded - - - - Return the handle to the header control on the given list - - The listview whose header control is to be returned - The handle to the header control - - - - Return the edges of the given column. - - - - A Point holding the left and right co-ords of the column. - -1 means that the sides could not be retrieved. - - - - Return the edges of the given column. - - - - A Point holding the left and right co-ords of the column. - -1 means that the sides could not be retrieved. - - - - Return the index of the column of the header that is under the given point. - Return -1 if no column is under the pt - - The list we are interested in - The client co-ords - The index of the column under the point, or -1 if no column header is under that point - - - - Return the index of the divider under the given point. Return -1 if no divider is under the pt - - The list we are interested in - The client co-ords - The index of the divider under the point, or -1 if no divider is under that point - - - - Get the scroll position of the given scroll bar - - - - - - - - Change the z-order to the window 'toBeMoved' so it appear directly on top of 'reference' - - - - - - - - Make the given control/window a topmost window - - - - - - - Change the size of the window without affecting any other attributes - - - - - - - - - Show the given window without activating it - - The window to show - - - - Mark the given column as being selected. - - - The OLVColumn or null to clear - - This method works, but it prevents subitems in the given column from having - back colors. - - - - - A simple-minded implementation of a Dictionary that can handle null as a key. - - The type of the dictionary key - The type of the values to be stored - This is not a full implementation and is only meant to handle - collecting groups by their keys, since groups can have null as a key value. - - - - OLVListItems are specialized ListViewItems that know which row object they came from, - and the row index at which they are displayed, even when in group view mode. They - also know the image they should draw against themselves - - - - - Create a OLVListItem for the given row object - - - - - Create a OLVListItem for the given row object, represented by the given string and image - - - - - Gets the bounding rectangle of the item, including all subitems - - - - - Gets or sets how many pixels will be left blank around each cell of this item - - This setting only takes effect when the control is owner drawn. - - - - Gets or sets how the cells of this item will be vertically aligned - - This setting only takes effect when the control is owner drawn. - - - - Gets or sets the checkedness of this item. - - - Virtual lists don't handle checkboxes well, so we have to intercept attempts to change them - through the items, and change them into something that will work. - Unfortunately, this won't work if this property is set through the base class, since - the property is not declared as virtual. - - - - - Enable tri-state checkbox. - - .NET's Checked property was not built to handle tri-state checkboxes, - and will return True for both Checked and Indeterminate states. - - - - Gets if this item has any decorations set for it. - - - - - Gets or sets the decoration that will be drawn over this item - - Setting this replaces all other decorations - - - - Gets the collection of decorations that will be drawn over this item - - - - - Gets whether or not this row can be selected and activated - - - - - Gets whether any cell on this item is showing a hyperlink - - - - - Get or set the image that should be shown against this item - - This can be an Image, a string or an int. A string or an int will - be used as an index into the small image list. - - - - Gets or sets the the model object that is source of the data for this list item. - - - - - Gets or sets the color that will be used for this row's background when it is selected and - the control is focused. - - - To work reliably, this property must be set during a FormatRow event. - - If this is not set, the normal selection BackColor will be used. - - - - - - Gets or sets the color that will be used for this row's foreground when it is selected and - the control is focused. - - - To work reliably, this property must be set during a FormatRow event. - - If this is not set, the normal selection ForeColor will be used. - - - - - - Return the sub item at the given index - - Index of the subitem to be returned - An OLVListSubItem - - - - Return bounds of the given subitem - - This correctly calculates the bounds even for column 0. - - - - A ListViewSubItem that knows which image should be drawn against it. - - - - - Create a OLVListSubItem - - - - - Create a OLVListSubItem that shows the given string and image - - - - - Gets or sets how many pixels will be left blank around this cell - - This setting only takes effect when the control is owner drawn. - - - - Gets or sets how this cell will be vertically aligned - - This setting only takes effect when the control is owner drawn. - - - - Gets or sets the model value is being displayed by this subitem. - - - - - Gets if this subitem has any decorations set for it. - - - - - Gets or sets the decoration that will be drawn over this item - - Setting this replaces all other decorations - - - - Gets the collection of decorations that will be drawn over this item - - - - - Get or set the image that should be shown against this item - - This can be an Image, a string or an int. A string or an int will - be used as an index into the small image list. - - - - Gets or sets the url that should be invoked when this subitem is clicked - - - - - Gets or sets whether this cell is selected - - - - - Return the state of the animatation of the image on this subitem. - Null means there is either no image, or it is not an animation - - - - - An indication of where a hit was within ObjectListView cell - - - - - Nowhere - - - - - On the text - - - - - On the image - - - - - On the checkbox - - - - - On the expand button (TreeListView) - - - - - in a button (cell must have ButtonRenderer) - - - - - in the cell but not in any more specific location - - - - - UserDefined location1 (used for custom renderers) - - - - - On the expand/collapse widget of the group - - - - - Somewhere on a group - - - - - Somewhere in a column header - - - - - Somewhere in a column header checkbox - - - - - Somewhere in a header divider - - - - - A collection of ListViewHitTest constants - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Instances of this class encapsulate the information gathered during a OlvHitTest() - operation. - - Custom renderers can use HitTestLocation.UserDefined and the UserData - object to store more specific locations for use during event handlers. - - - - Create a OlvListViewHitTestInfo - - - - - Create a OlvListViewHitTestInfo when the header was hit - - - - - Where is the hit location? - - - - - Where is the hit location? - - - - - Which group was hit? - - - - - Custom renderers can use this information to supply more details about the hit location - - - - - Gets the item that was hit - - - - - Gets the subitem that was hit - - - - - Gets the part of the subitem that was hit - - - - - Gets the ObjectListView that was tested - - - - - Gets the model object that was hit - - - - - Gets the index of the row under the hit point or -1 - - - - - Gets the index of the column under the hit point - - - - - Gets the index of the header divider - - - - - Gets the column that was hit - - - - - Returns a string that represents the current object. - - - A string that represents the current object. - - 2 - - - - A TreeDataSourceAdapter knows how to build a tree structure from a binding list. - - To build a tree - - - - Create a data source adaptor that knows how to build a tree structure - - - - - - Gets or sets the name of the property/column that uniquely identifies each row. - - - - The value contained by this column must be unique across all rows - in the data source. Odd and unpredictable things will happen if two - rows have the same id. - - Null cannot be a valid key value. - - - - - Gets or sets the name of the property/column that contains the key of - the parent of a row. - - - - The test condition for deciding if one row is the parent of another is functionally - equivilent to this: - - Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) - - - Unlike key value, parent keys can be null but a null parent key can only be used - to identify root objects. - - - - - Gets or sets the value that identifies a row as a root object. - When the ParentKey of a row equals the RootKeyValue, that row will - be treated as root of the TreeListView. - - - - The test condition for deciding a root object is functionally - equivilent to this: - - Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) - - - The RootKeyValue can be null. - - - - - Gets or sets whether or not the key columns (id and parent id) should - be shown to the user. - - This must be set before the DataSource is set. It has no effect - afterwards. - - - - Gets the DataTreeListView that is being managed - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - A IVirtualGroups is the interface that a virtual list must implement to support virtual groups - - - - - Return the list of groups that should be shown according to the given parameters - - - - - - - Return the index of the item that appears at the given position within the given group. - - - - - - - - Return the index of the group to which the given item belongs - - - - - - - Return the index at which the given item is shown in the given group - - - - - - - - A hint that the given range of items are going to be required - - - - - - - - - This is a safe, do nothing implementation of a grouping strategy - - - - - Return the list of groups that should be shown according to the given parameters - - - - - - - Return the index of the item that appears at the given position within the given group. - - - - - - - - Return the index of the group to which the given item belongs - - - - - - - Return the index at which the given item is shown in the given group - - - - - - - - A hint that the given range of items are going to be required - - - - - - - - - Provides grouping functionality to a FastObjectListView - - - - - Create groups for FastListView - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This is the COM interface that a ListView must be given in order for groups in virtual lists to work. - - - This interface is NOT documented by MS. It was found on Greg Chapell's site. This means that there is - no guarantee that it will work on future versions of Windows, nor continue to work on current ones. - - - - - Not sure what this does - - - - - - - Not sure what this does - - - - - - - Get the index of the item that occurs at the n'th position of the indicated group. - - Index of the group - Index within the group - Index of the item within the whole list - - - - Get the index of the group to which the given item belongs - - Index of the item within the whole list - Which occurences of the item is wanted - Index of the group - - - - Get the number of groups that contain the given item - - Index of the item within the whole list - How many groups does it occur within - - - - A hint to prepare any cache for the given range of requests - - - - - - - A default implementation of the IOwnerDataCallback interface - - - - - A VirtualListDataSource is a complete manner to provide functionality to a virtual list. - An object that implements this interface provides a VirtualObjectListView with all the - information it needs to be fully functional. - - Implementors must provide functioning implementations of at least GetObjectCount() - and GetNthObject(), otherwise nothing will appear in the list. - - - - Return the object that should be displayed at the n'th row. - - The index of the row whose object is to be returned. - The model object at the n'th row, or null if the fetching was unsuccessful. - - - - Return the number of rows that should be visible in the virtual list - - The number of rows the list view should have. - - - - Get the index of the row that is showing the given model object - - The model object sought - The index of the row showing the model, or -1 if the object could not be found. - - - - The ListView is about to request the given range of items. Do - whatever caching seems appropriate. - - - - - - - Find the first row that "matches" the given text in the given range. - - The text typed by the user - Start searching from this index. This may be greater than the 'to' parameter, - in which case the search should descend - Do not search beyond this index. This may be less than the 'from' parameter. - The column that should be considered when looking for a match. - Return the index of row that was matched, or -1 if no match was found - - - - Sort the model objects in the data source. - - - - - - - Add the given collection of model objects to this control. - - A collection of model objects - - - - Insert the given collection of model objects to this control at the position - - Index where the collection will be added - A collection of model objects - - - - Remove all of the given objects from the control - - Collection of objects to be removed - - - - Set the collection of objects that this control will show. - - - - - - Update/replace the nth object with the given object - - - - - - - This extension allow virtual lists to filter their contents - - - - - All subsequent retrievals on this data source should be filtered - through the given filters. null means no filtering of that kind. - - - - - - - A do-nothing implementation of the VirtualListDataSource interface. - - - - - Creates an AbstractVirtualListDataSource - - - - - - The list view that this data source is giving information to. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Update/replace the nth object with the given object - - - - - - - This is a useful default implementation of SearchText method, intended to be called - by implementors of IVirtualListDataSource. - - - - - - - - - - - - - - - - - - This class mimics the behavior of VirtualObjectListView v1.x. - - - - - Creates a VirtualListVersion1DataSource - - - - - - How will the n'th object of the data source be fetched? - - - - - - - - - - - - - - - - - - - - - - Designer for and its subclasses. - - - - This designer removes properties and events that are available on ListView but that are not - useful on ObjectListView. - - - We can't inherit from System.Windows.Forms.Design.ListViewDesigner, since it is marked internal. - So, this class uses reflection to create a ListViewDesigner and then forwards messages to that designer. - - - - - - Initializes the designer with the specified component. - - The to associate the designer with. This component must always be an instance of, or derive from, . - - - - Initializes a newly created component. - - A name/value dictionary of default values to apply to properties. May be null if no default values are specified. - - - - Releases the unmanaged resources used by the and optionally releases the managed resources. - - true to release both managed and unmanaged resources; false to release only unmanaged resources. - - - - Removes the duplicate DockingActionList added by this designer to the . - - - adds an internal DockingActionList : 'Dock/Undock in Parent Container'. - But the default designer has already added that action list. So we need to remove one. - - - - - Adjusts the set of properties the component exposes through a . - - An containing the properties for the class of the component. - - - - Allows a designer to add to the set of events that it exposes through a . - - The events for the class of the component. - - - - Allows a designer to change or remove items from the set of attributes that it exposes through a . - - The attributes for the class of the component. - - - - Allows a designer to change or remove items from the set of events that it exposes through a . - - The events for the class of the component. - - - - Gets the design-time action lists supported by the component associated with the designer. - - - The design-time action lists supported by the component associated with the designer. - - - - - Gets the collection of components associated with the component managed by the designer. - - - The components that are associated with the component managed by the designer. - - - - - Indicates whether a mouse click at the specified point should be handled by the control. - - - true if a click at the specified point is to be handled by the control; otherwise, false. - - A indicating the position at which the mouse was clicked, in screen coordinates. - - - - Processes Windows messages and optionally routes them to the control. - - The to process. - - - - This class modifies a ListViewActionList, by removing the "Edit Items" and "Edit Groups" actions. - - - - That class is internal, so we cannot simply subclass it, which would be simplier. - - - Action lists use reflection to determine if that action can be executed, so we not - only have to modify the returned collection of actions, but we have to implement - the properties and commands that the returned actions use. - - - - - This class works in conjunction with the OLVColumns property to allow OLVColumns - to be added to the ObjectListView. - - - - - Create a OLVColumnCollectionEditor - - - - - - What type of object does this editor create? - - - - - - Edit a given value - - - - - - - - - What text should be shown in the list for the given object? - - - - - - - Control how the overlay is presented in the IDE - - - - - An OLVColumn knows which aspect of an object it should present. - - - The column knows how to: - - extract its aspect from the row object - convert an aspect to a string - calculate the image for the row object - extract a group "key" from the row object - convert a group "key" into a title for the group - - For sorting to work correctly, aspects from the same column - must be of the same type, that is, the same aspect cannot sometimes - return strings and other times integers. - - - - - How should the button be sized? - - - - - 每个单元格都将具有相同大小的按钮，如ButtonSize属性所示 - - - - - 每个单元格都将绘制一个填充单元格的按钮，该按钮由ButtonPadding插入 - - - - - 将调整每个按钮的大小以包含文本内容 - - - - - Create an OLVColumn - - - - - Initialize a column to have the given title, and show the given aspect - - The title of the column - The aspect to be shown in the column - - - - 此委托将用于提取要在此列中显示的值。 - - - 如果设置, AspectName属性将被忽略. - - - - - 请记住，如果当前列的AspectGetter是内部生成的，依旧可以随意重新生成 - - - - - 应调用以获取要在此列中显示的值的属性或方法的名称。 - 仅当未指定ValueGetterDelegate时才使用此选项。 - - 此名称可以用来表示对属性或无参数方法的链引用。 - "DateOfBirth" - "Owner.HomeAddress.Postcode" - - - - 此委托将用于将编辑后的值放回模型对象中。 - - - 如果IsEdable==false，则不执行任何操作。 - - - - - 用于将要在此列中显示的Aspect转换为字符串的委托。 - - 如果设置了此值，AspectToStringFormat将被忽略。 - - - - 将Aspect转换成字符串的格式文本 - - - 此字符串作为第一个参数传递给String.Format()方法。 - 仅当尚未设置AspectToStringConverter时才使用此选项。 - "{0:C}" 表示转换数字到货币 - - - - 获取或设置单元格编辑器是否应使用自动完成 - - - - - 获取或设置单元格编辑器是否应使用自动完成 - - - - - 获取用户操作是否可以隐藏此列 - - 这会同时考虑Hideable属性以及此列是否为列表视图的主列(列0)。 - - - - 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ - - - 如果控件不是所有者绘制(owner drawn)的，则始终将其视为true。 - - 如果该值为False(默认值)并且控件是所有者绘制(owner drawn)的， - ObjectListView将尝试计算单元格实际内容的宽度，然后将编辑控件的大小调整为恰到好处的宽度。 - 如果为真，则无论单元格的内容如何，都将使用单元格的整个宽度。 - - 如果未在列上设置此属性，则将使用控件中的值 - - 仅当控件处于详细信息视图中时才使用此值。 - 无论此设置如何，开发人员都可以通过侦听CellEditStarting事件来指定编辑控件的确切大小。 - - - - - 获取编辑此列中的单元格时是否应使用整个单元格 - - 这将计算当前有效值，该值可能与CellEditUseWholeCell不同 - - - - 获取或设置此列中此单元格周围将留空的像素数 - - 此设置仅在控件为所有者绘制(owner drawn)时生效。 - - - - 获取或设置此列中的单元格垂直对齐的方式。 - - - - 此设置仅在控件为所有者绘制(owner drawn)时生效。 - - - 如果未设置，将使用控件本身的值。 - - - - - - 获取或设置此列是否显示复选框。 - - - 在第0列上设置此选项不起作用。列0复选框由ObjectListView本身的CheckBox属性控制。 - - - - - Gets or sets the clustering strategy used for this column. - - - - The clustering strategy is used to build a Filtering menu for this item. - If this is null, a useful default will be chosen. - - - To disable filtering on this colummn, set UseFiltering to false. - - - Cluster strategies belong to a particular column. The same instance - cannot be shared between multiple columns. - - - - - - 获取或设置是否启用此列中的按钮(如果此列是按钮)，即使该行本身被禁用 - - - - - 此列是否应该调整大小以填充列表视图中的空闲空间？ - - - - 如果希望两列(或更多列)平均共享可用空间，请将此属性设置为True。 - 如果希望此列具有更大或更小的可用空间份额，则必须显式设置FreeSpaceProportion属性。 - - - 空间填充列仍然由MinimumWidth和MaximumWidth属性控制。 - - /// - - - - 控件中未占用的水平空间应分配给此列的比例是多少？ - - - - 在某些情况下，如果列(通常是最右边的列)可以随着列表视图的扩展而扩展， - 这样就可以在不必水平滚动的情况下尽可能多地看到列(您永远不应该让用户必须水平滚动任何内容！)。 - - - 调整空间填充列的大小以占据列表视图的未占用宽度的一部分(未占用宽度是一旦所有非填充列都被赋予其空间后剩余的宽度)。 - 此属性指示将分配给此列的未占用空间的相对比例。此属性的实际值并不重要，重要的是它的值相对于其他列中的值。 - 例子: - - - 如果只有一个空间填充列，则无论FreeSpaceProportion中的值如何，都将为其提供所有可用空间。 - - - 如果有两个或多个空间填充列，并且它们的FreeSpaceProportion值都相同，则它们将平等地共享空闲空间。 - - - 如果FreeSpaceProportion有三个值为3、2和1的空间填充列，则第一列将占用一半的空闲空间，第二列将占用三分之一的空闲空间，第三列将占用六分之一的空闲空间。 - - - - - - - - 获取或设置在单击此列的标题时是否对此列值重新生成组。 - - - 此设置仅在ShowGroups为true时使用。 - - 如果为False，则单击标题不会重建组。 - - 如果为false，则仍会激发BeforeCreatingGroups事件，这些事件可用于根据具体情况进行分组或提供反馈。 - - - - - 当组已创建但尚未成为真正的ListViewGroup时，将调用此委托。用户可以利用此机会填写有关该组的许多其他详细信息。 - - - - - 调用此委托以获取对象，该对象是给定行所属的组的键。 - - - - - 调用此委托将组键转换为该组的标题。 - - - - - 当列表视图按此列分组并且组标题有项目计数时，应如何设置标签的格式 - - - 给定的格式字符串支持以下两个占位符： - - {0} - 原组标题 - {1} - 该组项目数 - - - "{0} [{1} items]" - - - - 获取this.GroupWithItemCountFormat或默认值 - - - 如果未设置GroupWithItemCountFormat，则如果可能，将从ObjectListView中获取其值。 - - - - - 当列表视图按此列分组并且组标题有项目计数时，如果组中只有一个项目，标签应该如何格式化 - - - 给定的格式字符串支持以下两个占位符： - - {0} - 原组标题 - {1} - 该组项目数 (始终为1) - - - "{0} [{1} item]" - - - - 获取this.GroupWithItemCountSingularFormat或默认值 - - - 如果未设置此值，将使用列表视图中的值 - - - - - 获取是否应在列标题中使用筛选器指示符绘制此列。 - - - - - 获取或设置将用于所有者绘制标题列的委托。 - - - - - 获取或设置将用于绘制此列标题的样式 - - 仅当拥有的ObjectListView将HeaderUsesThemes设置为False时才使用此选项。 - - - - 获取或设置绘制此列的标题时使用的字体 - - 您可能应该使用HeaderFormatStyle而不是此属性 - 这仅在HeaderUsesThemes为false时使用。 - - - - 获取或设置绘制此列标题文本的颜色 - - 您可能应该使用HeaderFormatStyle而不是此属性 - 这仅在HeaderUsesThemes为false时使用。 - - - - 获取或设置将在列标题中显示的图像键 - - 这仅在HeaderUsesThemes为false时使用 - - - - 获取或设置Header文本的对齐方式 - - - - - 返回Header的文本对齐方式。这将是显式设置的，或者将遵循列中文本的对齐方式 - - - - - 获取转换为StringAlignment的Header对齐方式 - - - - - 获取此列的标题中是否有图像 - - - - - 获取或设置此Header是否在Header中放置复选框 - - - - - 获取或设置此Header是否在Header中放置三态复选框 - - - - - 获取或设置此列Header中复选框的选中状态 - - - - - 获取或设置选中/取消选中标题复选框的值是否会导致将此列中所有单元格的复选框设置为相同的选中/取消选中。 - 默认值为true. - - - - 当单元格的复选框状态改变时，该函数不会与自动更新标题的功能相反。 - - - 此属性在TreeListView上的行为最好描述为未定义，应该避免。 - - - 此操作(检查/取消检查所有行)的性能为O(n)，其中n是行数。它将在大型虚拟列表上工作，但可能需要一些时间。 - - - - - - 获取或设置是否禁用标题中的复选框 - - - 单击禁用的复选框不会更改其值，但会引发HeaderCheckBoxChanging事件，使程序员有机会执行适当的操作。 - - - - 获取或设置用户是否可以隐藏此列。 - - - 无论此设置如何，列0永远不能隐藏。 - - - - - 获取或设置此列中的文本值是否类似于超链接 - - - - - 这是属性的名称，将调用该属性来获取应该在此列中显示的图像的图像选择器。 - 它可以返回int、String、Image或NULL。 - - - 如果ImageGetter不为空，则忽略此项。 - 该属性可以使用以下返回值来标识图像： - - null或-1 --表示无图像 - int -- Int值将用作图像列表的索引 - String -- 字符串值将用作图像列表的关键字 - Image -- 将直接绘制图像(仅在OwnerDrawn模式下) - - - - - - 调用此委托以获取应该在此列中显示的图像的图像选择器。它可以返回int、String、Image或NULL。 - - - 该属性可以使用以下返回值来标识图像： - - null或-1 --表示无图像 - int -- Int值将用作图像列表的索引 - String -- 字符串值将用作图像列表的关键字 - Image -- 将直接绘制图像(仅在OwnerDrawn模式下) - - - - - - 获取或设置此列是否在其单元格中绘制按钮 - - - - 如果将其设置为true，则列的呈现器将成为ColumnButtonRenender(如果尚未成为ColumnButtonRenender)。如果设置为False，则将丢弃以前的任何按钮渲染器 - - 如果单元格的Aspect为Null或空，则不会在单元格中绘制任何内容。 - - - - Create a ColumnButtonRenderer to draw buttons in this column - - - - - - Fill in details to our ColumnButtonRenderer based on the properties set on the column - - - - - 获取或设置按钮可以占用的最大宽度。 - -1 表示不限制最大宽度 - - 仅当SizingMode为TextBound时才生效 - - - - 获取或设置当SizingMode为TextBound时单元格周围的额外空间 - - - - - 获取或设置SizingMode为FixedBound时按钮的大小 - - 如果未设置，将使用单元格的边界 - - - - 获取或设置此列显示按钮时如何调整每个按钮的大小 - - - - - 此列中显示的值是否可以编辑 - - 此默认值为false，因为控制列表视图的可编辑性的主要方法是列表视图本身。 - 列表视图可编辑后，所有列也可编辑，除非程序员显式将它们标记为不可编辑 - - - - 是否是固定宽度 - - - - - 获取/设置当视图切换到平铺视图(TileView)时是否使用此列。 - - 无论此设置如何，第0列始终包含在平铺视图中。平铺视图不能很好地处理许多“列”信息。两三个最好。 - - - - 获取或设置Header的文本是否应垂直呈现。 - - - 如果为True，最好将ToolTipText设置为列的名称，以便于阅读。 - 垂直Header仅为文本。他们不会画出图像。 - - - - - 该列是否可见 - - 更改此值后，必须调用RebuildColumns()才能使更改生效。 - - - - 此列最后一次定位在详细信息视图列中的位置是什么 - - DisplayIndex是易失性的。一旦从控件中移除列，就无法发现它在显示顺序中的位置。 - 即使列不在列表视图的活动列中，此属性也会保护该信息。 - - - - 列最大宽度 - - -1表示不限制. 将该值指定为与MinimumWidth相同的值，以生成固定宽度的列。 - - - - 列最小宽度 - - -1表示不限制. 将该值指定为与MaximumWidth相同的值，以生成固定宽度的列。 - - - - Get/set the renderer that will be invoked when a cell needs to be redrawn - - - - - This delegate is called when a cell needs to be drawn in OwnerDrawn mode. - - This method is kept primarily for backwards compatibility. - New code should implement an IRenderer, though this property will be maintained. - - - - 获取或设置执行文本搜索时是否使用此列的单元格中的文本。 - - - - 如果为False，则文本筛选器在查找匹配项时不会尝试搜索此列单元格。 - - - - - - 获取或设置一个委托，该委托将返回在使用基于文本的筛选器时应考虑进行文本匹配的文本值数组。 - - - - - 获取或设置此列的标题是否将包括该列的文本。 - - - - 如果为false，则列标题中呈现的唯一内容将是来自 . - - 只有在以下情况下才会考虑此设置: ObjectListView中的 为false . - - - - - 获取或设置当用户单击此列的标题时是否重新排序列表内容。 - - - - 如果为False，则单击标题将不会对列表进行排序，但也不会提供有关列表未排序原因的任何反馈。提供适当的反馈是程序员的责任。 - - 如果为false，则仍会触发BeforeSorting事件，该事件可用于根据具体情况进行排序或提供反馈。 - - - - - 获取或设置列内容的水平对齐方式。 - - NET将不允许列0具有除左对齐以外的任何对齐方式。我们不能更改列表视图的基本行为，但当所有者绘制时，列0现在可以有其他对齐方式。 - - - - 获取列文本对齐的StringAlignment等效项 - - - - - 当鼠标悬停在该列的标题上时，应该显示什么字符串？ - - 如果拥有的ObjectListView上安装了HeaderToolTipGetter，则将忽略此值。 - - - - 此列是否应该有一个三态复选框 - - - 如果为True，用户可以选择第三种状态(通常是不确定的)。 - - - - - 按列纵横比的首字母对对象进行分组 - - - 一种常见的模式是按该组的值的首字母对列进行分组。aspect必须是字符串(显然)。 - - - - - 获取或设置此列是否应为用户可筛选的列 - - - - - Gets or sets a filter that will only include models where the model's value - for this column is one of the values in ValuesChosenForFiltering - - - - - Gets or sets the values that will be used to generate a filter for this - column. For a model to be included by the generated filter, its value for this column - must be in this list. If the list is null or empty, this column will - not be used for filtering. - - - - - 列宽 - - - - - 获取或设置此列单元格的内容是否应自动换行 - - 如果此列使用自定义IRenender(即，不是从BaseRenender派生的)，则该呈现器负责实现自动换行。 - - - - For a given group value, return the string that should be used as the groups title. - - The group key that is being converted to a title - string - - - - Get the checkedness of the given object for this column - - The row object that is being displayed - The checkedness of the object - - - - Put the checkedness of the given object for this column - - The row object that is being displayed - - The checkedness of the object - - - - For a given row object, extract the value indicated by the AspectName property of this column. - - The row object that is being displayed - An object, which is the aspect named by AspectName - - - - For a given row object, return the object that is the key of the group that this row belongs to. - - The row object that is being displayed - Group key object - - - - For a given row object, return the image selector of the image that should displayed in this column. - - The row object that is being displayed - int or string or Image. int or string will be used as index into image list. null or -1 means no image - - - - Return the image that represents the check box for the given model - - - - - - - For a given row object, return the strings that will be searched when trying to filter by string. - - - This will normally be the simple GetStringValue result, but if this column is non-textual (e.g. image) - you might want to install a SearchValueGetter delegate which can return something that could be used - for text filtering. - - - The array of texts to be searched. If this returns null, search will not match that object. - - - - For a given row object, return the string representation of the value shown in this column. - - - For aspects that are string (e.g. aPerson.Name), the aspect and its string representation are the same. - For non-strings (e.g. aPerson.DateOfBirth), the string representation is very different. - - - - - - - For a given row object, return the object that is to be displayed in this column. - - The row object that is being displayed - An object, which is the aspect to be displayed - - - - Update the given model object with the given value using the column's - AspectName. - - The model object to be updated - The value to be put into the model - - - - Update the given model object with the given value - - The model object to be updated - The value to be put into the model - - - - Convert the aspect object to its string representation. - - - If the column has been given a AspectToStringConverter, that will be used to do - the conversion, otherwise just use ToString(). - The returned value will not be null. Nulls are always converted - to empty strings. - - The value of the aspect that should be displayed - A string representation of the aspect - - - - Convert the aspect object to its string representation. - - - If the column has been given a AspectToStringConverter, that will be used to do - the conversion, otherwise just use ToString(). - The returned value will not be null. Nulls are always converted - to empty strings. - - - The value of the aspect that should be displayed - A string representation of the aspect - - - - Decide the clustering strategy that will be used for this column - - - - - - Gets or sets the type of data shown in this column. - - If this is not set, it will try to get the type - by looking through the rows of the listview. - - - - This event is triggered when the visibility of this column changes. - - - - - Tell the world when visibility of a column changes. - - - - - Create groupies - This is an untyped version to help with Generator and OLVColumn attributes - - - - - - - Create groupies - - - - - - - - Create groupies - - - - - - - - - Create groupies - - - - - - - - - - Create groupies. - Install delegates that will group the columns aspects into progressive partitions. - If an aspect is less than value[n], it will be grouped with description[n]. - If an aspect has a value greater than the last element in "values", it will be grouped - with the last element in "descriptions". - - Array of values. Values must be able to be - compared to the aspect (using IComparable) - The description for the matching value. The last element is the default description. - If there are n values, there must be n+1 descriptions. - - this.salaryColumn.MakeGroupies( - new UInt32[] { 20000, 100000 }, - new string[] { "Lowly worker", "Middle management", "Rarified elevation"}); - - - - - - - - - Create groupies based on exact value matches. - - - Install delegates that will group rows into partitions based on equality of this columns aspects. - If an aspect is equal to value[n], it will be grouped with description[n]. - If an aspect is not equal to any value, it will be grouped with "[other]". - - Array of values. Values must be able to be - equated to the aspect - The description for the matching value. - - this.marriedColumn.MakeEqualGroupies( - new MaritalStatus[] { MaritalStatus.Single, MaritalStatus.Married, MaritalStatus.Divorced, MaritalStatus.Partnered }, - new string[] { "Looking", "Content", "Looking again", "Mostly content" }); - - - - - - - - - An adorment is the common base for overlays and decorations. - - - - - Gets or sets the corner of the adornment that will be positioned at the reference corner - - - - - Gets or sets location within the reference rectange where the adornment will be drawn - - This is a simplied interface to ReferenceCorner and AdornmentCorner - - - - Gets or sets the offset by which the position of the adornment will be adjusted - - - - - Gets or sets the point of the reference rectangle to which the adornment will be aligned. - - - - - Gets or sets the degree of rotation by which the adornment will be transformed. - The centre of rotation will be the center point of the adornment. - - - - - Gets or sets the transparency of the overlay. - 0 is completely transparent, 255 is completely opaque. - - - - - Calculate the location of rectangle of the given size, - so that it's indicated corner would be at the given point. - - The point - - Which corner will be positioned at the reference point - - CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.TopLeft) -> Point(50, 100) - CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.MiddleCenter) -> Point(45, 90) - CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.BottomRight) -> Point(40, 80) - - - - Calculate a rectangle that has the given size which is positioned so that - its alignment point is at the reference location of the given rect. - - - - - - - - Create a rectangle of the given size which is positioned so that - its indicated corner is at the indicated corner of the reference rect. - - - - - - - - - Creates a rectangle so that its bottom left is at the centre of the reference: - corner=BottomLeft, referenceCorner=MiddleCenter - This is a powerful concept that takes some getting used to, but is - very neat once you understand it. - - - - - Return the point at the indicated corner of the given rectangle (it doesn't - have to be a corner, but a named location) - - The reference rectangle - Which point of the rectangle should be returned? - A point - CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.TopLeft) -> Point(0, 0) - CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.MiddleCenter) -> Point(25, 50) - CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.BottomRight) -> Point(50, 100) - - - - Given the item and the subitem, calculate its bounds. - - - - - - - - Apply any specified rotation to the Graphic content. - - The Graphics to be transformed - The rotation will be around the centre of this rect - - - - Reverse the rotation created by ApplyRotation() - - - - - - An overlay that will draw an image over the top of the ObjectListView - - - - - Gets or sets the image that will be drawn - - - - - Gets or sets if the image will be shrunk to fit with its horizontal bounds - - - - - Draw the image in its specified location - - The Graphics used for drawing - The bounds of the rendering - - - - Draw the image in its specified location - - The image to be drawn - The Graphics used for drawing - The bounds of the rendering - How transparent should the image be (0 is completely transparent, 255 is opaque) - - - - Draw the image in its specified location - - The image to be drawn - The Graphics used for drawing - The bounds of the rendering - How big should the image be? - How transparent should the image be (0 is completely transparent, 255 is opaque) - - - - Draw the image in its specified location, scaled so that it is not wider - than the given rectangle. Height is scaled proportional to the width. - - The image to be drawn - The Graphics used for drawing - The bounds of the rendering - How transparent should the image be (0 is completely transparent, 255 is opaque) - - - - Utility to draw a bitmap transparenly. - - - - - - - - - An adornment that will draw text - - - - - Gets or sets the background color of the text - Set this to Color.Empty to not draw a background - - - - - Gets the brush that will be used to paint the text - - - - - Gets or sets the color of the border around the billboard. - Set this to Color.Empty to remove the border - - - - - Gets the brush that will be used to paint the text - - - - - Gets or sets the width of the border around the text - - - - - How rounded should the corners of the border be? 0 means no rounding. - - If this value is too large, the edges of the border will appear odd. - - - - Gets or sets the font that will be used to draw the text - - - - - Gets the font that will be used to draw the text or a reasonable default - - - - - Does this text have a background? - - - - - Does this overlay have a border? - - - - - Gets or sets the maximum width of the text. Text longer than this will wrap. - 0 means no maximum. - - - - - Gets or sets the formatting that should be used on the text - - - - - Gets or sets the text that will be drawn - - - - - Gets the brush that will be used to paint the text - - - - - Gets or sets the color of the text - - - - - Gets or sets whether the text will wrap when it exceeds its bounds - - - - - Draw our text with our stored configuration in relation to the given - reference rectangle - - The Graphics used for drawing - The reference rectangle in relation to which the text will be drawn - - - - Draw the given text with our stored configuration - - The Graphics used for drawing - The reference rectangle in relation to which the text will be drawn - The text to draw - How opaque should be text be - - - - Draw the text with a border - - The Graphics used for drawing - The bounds within which the text should be drawn - The text to draw - How opaque should be text be - - - - Return the rectangle that will be the precise bounds of the displayed text - - - - - The bounds of the text - - - - Return a GraphicPath that is a round cornered rectangle - - The rectangle - The diameter of the corners - A round cornered rectagle path - If I could rely on people using C# 3.0+, this should be - an extension method of GraphicsPath. - - - - A decoration is an overlay that draws itself in relation to a given row or cell. - Decorations scroll when the listview scrolls. - - - - - Gets or sets the row that is to be decorated - - - - - Gets or sets the subitem that is to be decorated - - - - - An AbstractDecoration is a safe do-nothing implementation of the IDecoration interface - - - - - Gets or sets the row that is to be decorated - - - - - Gets or sets the subitem that is to be decorated - - - - - Gets the bounds of the decorations row - - - - - Get the bounds of the decorations cell - - - - - Draw the decoration - - - - - - - - This decoration draws a slight tint over a column of the - owning listview. If no column is explicitly set, the selected - column in the listview will be used. - The selected column is normally the sort column, but does not have to be. - - - - - Create a TintedColumnDecoration - - - - - Create a TintedColumnDecoration - - - - - - Gets or sets the column that will be tinted - - - - - Gets or sets the color that will be 'tinted' over the selected column - - - - - Draw a slight colouring over our tinted column - - - This overlay only works when: - - the list is in Details view - - there is at least one row - - there is a selected column (or a specified tint column) - - - - - - - - This decoration draws an optionally filled border around a rectangle. - Subclasses must override CalculateBounds(). - - - - - Create a BorderDecoration - - - - - Create a BorderDecoration - - The pen used to draw the border - - - - Create a BorderDecoration - - The pen used to draw the border - The brush used to fill the rectangle - - - - Gets or sets the pen that will be used to draw the border - - - - - Gets or sets the padding that will be added to the bounds of the item - before drawing the border and fill. - - - - - How rounded should the corners of the border be? 0 means no rounding. - - If this value is too large, the edges of the border will appear odd. - - - - Gets or sets the brush that will be used to fill the border - - This value is ignored when using gradient brush - - - - Gets or sets the color that will be used as the start of a gradient fill. - - This and FillGradientTo must be given value to show a gradient - - - - Gets or sets the color that will be used as the end of a gradient fill. - - This and FillGradientFrom must be given value to show a gradient - - - - Gets or sets the fill mode that will be used for the gradient. - - - - - Draw a filled border - - - - - - - - Subclasses should override this to say where the border should be drawn - - - - - - Do the actual work of drawing the filled border - - - - - - - Create a GraphicsPath that represents a round cornered rectangle. - - - If this is 0 or less, the rectangle will not be rounded. - - - - - Instances of this class draw a border around the decorated row - - - - - Gets or sets the index of the left most column to be used for the border - - - - - Gets or sets the index of the right most column to be used for the border - - - - - Calculate the boundaries of the border - - - - - - Instances of this class draw a border around the decorated subitem. - - - - - Calculate the boundaries of the border - - - - - - This decoration puts a border around the cell being edited and - optionally "lightboxes" the cell (makes the rest of the control dark). - - - - - Create a EditingCellBorderDecoration - - - - - Create a EditingCellBorderDecoration - - Should the decoration use a lighbox display style? - - - - Gets or set whether the decoration should make the rest of - the control dark when a cell is being edited - - If this is true, FillBrush is used to overpaint - the control. - - - - Draw the decoration - - - - - - - - This decoration causes everything *except* the row under the mouse to be overpainted - with a tint, making the row under the mouse stand out in comparison. - The darker and more opaque the fill color, the more obvious the - decorated row becomes. - - - - - Create a LightBoxDecoration - - - - - Draw a tint over everything in the ObjectListView except the - row under the mouse. - - - - - - - - Instances of this class put an Image over the row/cell that it is decorating - - - - - Create an image decoration - - - - - Create an image decoration - - - - - - Create an image decoration - - - - - - - Create an image decoration - - - - - - - Create an image decoration - - - - - - - - Gets or sets the item being decorated - - - - - Gets or sets the sub item being decorated - - - - - Draw this decoration - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - Instances of this class draw some text over the row/cell that they are decorating - - - - - Create a TextDecoration - - - - - Create a TextDecoration - - - - - - Create a TextDecoration - - - - - - - Create a TextDecoration - - - - - - - Create a TextDecoration - - - - - - - - Gets or sets the item being decorated - - - - - Gets or sets the sub item being decorated - - - - - Draw this decoration - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - The interface for an object which can draw itself over the top of - an ObjectListView. - - - - - Draw this overlay - - The ObjectListView that is being overlaid - The Graphics onto the given OLV - The content area of the OLV - - - - An interface for an overlay that supports variable levels of transparency - - - - - Gets or sets the transparency of the overlay. - 0 is completely transparent, 255 is completely opaque. - - - - - A null implementation of the IOverlay interface - - - - - Draw this overlay - - The ObjectListView that is being overlaid - The Graphics onto the given OLV - The content area of the OLV - - - - How transparent should this overlay be? - - - - - An overlay that will draw an image over the top of the ObjectListView - - - - - Create an ImageOverlay - - - - - Gets or sets the horizontal inset by which the position of the overlay will be adjusted - - - - - Gets or sets the vertical inset by which the position of the overlay will be adjusted - - - - - Draw this overlay - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - An overlay that will draw text over the top of the ObjectListView - - - - - Create a TextOverlay - - - - - Gets or sets the horizontal inset by which the position of the overlay will be adjusted - - - - - Gets or sets the vertical inset by which the position of the overlay will be adjusted - - - - - Gets or sets whether the border will be drawn with rounded corners - - - - - Draw this overlay - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - A Billboard overlay is a TextOverlay positioned at an absolute point - - - - - Create a BillboardOverlay - - - - - Gets or sets where should the top left of the billboard be placed - - - - - Draw this overlay - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - Renderers are the mechanism used for owner drawing cells. As such, they can also handle - hit detection and positioning of cell editing rectangles. - - - - - Render the whole item within an ObjectListView. This is only used in non-Details views. - - The event - A Graphics for rendering - The bounds of the item - The model object to be drawn - Return true to indicate that the event was handled and no further processing is needed. - - - - Render one cell within an ObjectListView when it is in Details mode. - - The event - A Graphics for rendering - The bounds of the cell - The model object to be drawn - Return true to indicate that the event was handled and no further processing is needed. - - - - What is under the given point? - - - x co-ordinate - y co-ordinate - This method should only alter HitTestLocation and/or UserData. - - - - When the value in the given cell is to be edited, where should the edit rectangle be placed? - - - - - - - - - - - Renderers that implement this interface will have the filter property updated, - each time the filter on the ObjectListView is updated. - - - - - - - - - - An AbstractRenderer is a do-nothing implementation of the IRenderer interface. - - - - - Render the whole item within an ObjectListView. This is only used in non-Details views. - - The event - A Graphics for rendering - The bounds of the item - The model object to be drawn - Return true to indicate that the event was handled and no further processing is needed. - - - - Render one cell within an ObjectListView when it is in Details mode. - - The event - A Graphics for rendering - The bounds of the cell - The model object to be drawn - Return true to indicate that the event was handled and no further processing is needed. - - - - What is under the given point? - - - x co-ordinate - y co-ordinate - This method should only alter HitTestLocation and/or UserData. - - - - When the value in the given cell is to be edited, where should the edit rectangle be placed? - - - - - - - - - - - This class provides compatibility for v1 RendererDelegates - - - - - The renderer delegate that this renderer wraps - - - - - A BaseRenderer provides useful base level functionality for any custom renderer. - - - Subclasses will normally override the Render or OptionalRender method, and use the other - methods as helper functions. - - - - - Can the renderer wrap lines that do not fit completely within the cell? - - Wrapping text doesn't work with the GDI renderer. - - - - Gets or sets how many pixels will be left blank around this cell - - - - This setting only takes effect when the control is owner drawn. - - for more details. - - - - - Gets the horiztonal alignment of the column - - - - - Gets or sets how cells drawn by this renderer will be vertically aligned. - - - - If this is not set, the value from the column or control itself will be used. - - - - - - Gets the optional padding that this renderer should apply before drawing. - This property considers all possible sources of padding - - - - - Gets the vertical cell alignment that should govern the rendering. - This property considers all possible sources. - - - - - Gets or sets the image list from which keyed images will be fetched - - - - - When rendering multiple images, how many pixels should be between each image? - - - - - Should text be rendered using GDI routines? This makes the text look more - like a native List view control. - - - - - Get or set the aspect of the model object that this renderer should draw - - - - - What are the bounds of the cell that is being drawn? - - - - - Get or set the OLVColumn that this renderer will draw - - - - - Get/set the event that caused this renderer to be called - - - - - Get/set the event that caused this renderer to be called - - - - - Gets or sets the font to be used for text in this cell - - - - - Gets the image list from which keyed images will be fetched - - - - - Should this renderer fill in the background before drawing? - - - - - Cache whether or not our item is selected - - - - - Is this renderer being used on a printer context? - - - - - Get or set the listitem that this renderer will be drawing - - - - - Get/set the listview for which the drawing is to be done - - - - - Get the specialized OLVSubItem that this renderer is drawing - - This returns null for column 0. - - - - Get or set the model object that this renderer should draw - - - - - Get or set the list subitem that this renderer will be drawing - - - - - The brush that will be used to paint the text - - - - - Will this renderer use the custom images from the parent ObjectListView - to draw the checkbox images. - - - - If this is true, the renderer will use the images from the - StateImageList to represent checkboxes. 0 - unchecked, 1 - checked, 2 - indeterminate. - - If this is false (the default), then the renderer will use .NET's standard - CheckBoxRenderer. - - - - - Align the second rectangle with the first rectangle, - according to the alignment of the column - - The cell's bounds - The rectangle to be aligned within the bounds - An aligned rectangle - - - - Calculate the left edge of the rectangle that aligns the outer rectangle with the inner one - according to this renderer's horizontal alignment - - - - - - - - Calculate the top of the rectangle that aligns the outer rectangle with the inner rectangle - according to this renders vertical alignment - - - - - - - - Calculate the top of the rectangle that aligns the outer rectangle with a rectangle of the given height - according to this renderer's vertical alignment - - - - - - - - Calculate the space that our rendering will occupy and then align that space - with the given rectangle, according to the Column alignment - - - Pre-padded bounds of the cell - - - - - Calculate the size of the content of this cell. - - - Pre-padded bounds of the cell - The width and height of the content - - - - Calculate the bounds of a checkbox given the (pre-padded) cell bounds - - - Pre-padded cell bounds - - - - - How much space will the check box for this cell occupy? - - Only column 0 can have check boxes. Sub item checkboxes are - treated as images - - - - - - How much space will the check box for this row occupy? - If the list doesn't have checkboxes, or this isn't the primary column, - this returns an empty size. - - - - - - - How much horizontal space will the image of this cell occupy? - - - - - - - - How much vertical space will the image of this cell occupy? - - - - - - - - How much space will the image of this cell occupy? - - - - - - - - How much horizontal space will the text of this cell occupy? - - - - - - - - - How much space will the text of this cell occupy? - - - - - - - - - Return the Color that is the background color for this item's cell - - The background color of the subitem - - - - Return the color of the background color when the item is selected - - The background color of the subitem - - - - Return the color to be used for text in this cell - - The text color of the subitem - - - - Return the color of the foreground color when the item is selected - - The foreground color of the subitem - - - - Return the image that should be drawn against this subitem - - An Image or null if no image should be drawn. - - - - Return the actual image that should be drawn when keyed by the given image selector. - An image selector can be: - an int, giving the index into the image list - a string, giving the image key into the image list - an Image, being the image itself - - - The value that indicates the image to be used - An Image or null - - - - - - - - Return the string that should be drawn within this - - - - - - Return the Color that is the background color for this item's text - - The background color of the subitem's text - - - - Render the whole item in a non-details view. - - - - - - - - - - Prepare this renderer to draw in response to the given event - - - - - Use this if you want to chain a second renderer within a primary renderer. - - - - Render one cell - - - - - - - - - - Prepare this renderer to draw in response to the given event - - - - - Use this if you want to chain a second renderer within a primary renderer. - - - - Calculate which part of this cell was hit - - - - - - - - Calculate the edit rectangle - - - - - - - - - - - Draw our data into the given rectangle using the given graphics context. - - - Subclasses should override this method. - The graphics context that should be used for drawing - The bounds of the subitem cell - Returns whether the rendering has already taken place. - If this returns false, the default processing will take over. - - - - - Draw our data into the given rectangle using the given graphics context. - - - Subclasses should override this method if they never want - to fall back on the default processing - The graphics context that should be used for drawing - The bounds of the subitem cell - - - - Do the actual work of hit testing. Subclasses should override this rather than HitTest() - - - - - - - - - Handle a HitTest request after all state information has been initialized - - - - - - - - - - - Draw the standard "[checkbox] [image] [text]" cell after the state properties have been initialized. - - - - - - - Change the bounds of the given rectangle to take any cell padding into account - - - - - - - Perform normal hit testing relative to the given aligned content bounds - - - - - - - - - - This method calculates the bounds of the text within a standard layout - (i.e. optional checkbox, optional image, text) - - This method only works correctly if the state of the renderer - has been fully initialized (see BaseRenderer.GetEditRectangle) - - - - - - - - Apply any padding to the given bounds, and then align a rectangle of the given - size within that padded area. - - - - - - - - - Draw the given image aligned horizontally within the column. - - - Over tall images are scaled to fit. Over-wide images are - truncated. This is by design! - - Graphics context to use for drawing - Bounds of the cell - The image to be drawn - - - - Draw our subitems image and text - - Graphics context to use for drawing - Pre-padded bounds of the cell - - - - Fill in the background of this cell - - Graphics context to use for drawing - Bounds of the cell - - - - Draw the primary check box of this row (checkboxes in other sub items use a different method) - - Graphics context to use for drawing - The pre-aligned and padded target rectangle - - - - Calculate the CheckBoxState we need to correctly draw the given state - - - - - - - Should this checkbox be drawn as disabled? - - - - - Is the current item hot (i.e. under the mouse)? - - - - - Is the mouse over a checkbox in this cell? - - - - - Draw the given text and optional image in the "normal" fashion - - Graphics context to use for drawing - Bounds of the cell - The optional image to be drawn - - - - Draw our subitems image and text - - Graphics context to use for drawing - Bounds of the cell - - - - Draw the given collection of image selectors - - - - - - - - Draw the given text and optional image in the "normal" fashion - - Graphics context to use for drawing - Bounds of the cell - The string to be drawn - - - - Print the given text in the given rectangle using only GDI routines - - - - - - The native list control uses GDI routines to do its drawing, so using them - here makes the owner drawn mode looks more natural. - This method doesn't honour the CanWrap setting on the renderer. All - text is single line - - - - - Gets the cell's vertical alignment as a TextFormatFlag - - - - - - Gets the StringFormat needed when drawing text using GDI+ - - - - - Print the given text in the given rectangle using normal GDI+ .NET methods - - Printing to a printer dc has to be done using this method. - - - - This renderer highlights substrings that match a given text filter. - - - - - Create a HighlightTextRenderer - - - - - Create a HighlightTextRenderer - - - - - - Create a HighlightTextRenderer - - - - - - Gets or set how rounded will be the corners of the text match frame - - - - - Gets or set the brush will be used to paint behind the matched substrings. - Set this to null to not fill the frame. - - - - - Gets or sets the filter that is filtering the ObjectListView and for - which this renderer should highlight text - - - - - When a filter changes, keep track of the text matching filters - - - - - Gets or set the pen will be used to frame the matched substrings. - Set this to null to not draw a frame. - - - - - Gets or sets whether the frame around a text match will have rounded corners - - - - - Gets or set the text that will be highlighted - - - - - Gets or sets the manner in which substring will be compared. - - - Use this to control if substring matches are case sensitive or insensitive. - - - - Handle a HitTest request after all state information has been initialized - - - - - - - - - - - Draw text using GDI - - - - - - - - Draw the highlighted text using GDI - - - - - - - - Draw an indication around the given frame that shows a text match - - - - - - - - - - Draw the text using GDI+ - - - - - - - - Draw the highlighted text using GDI+ - - - - - - - - Gets whether the renderer should actually draw highlighting - - - - - Return a GraphicPath that is a round cornered rectangle - - A round cornered rectangle path - If I could rely on people using C# 3.0+, this should be - an extension method of GraphicsPath. - - - - - - - - - Return a GraphicPath that is a round cornered rectangle - - The rectangle - The diameter of the corners - A round cornered rectangle path - If I could rely on people using C# 3.0+, this should be - an extension method of GraphicsPath. - - - - This class maps a data value to an image that should be drawn for that value. - - It is useful for drawing data that is represented as an enum or boolean. - - - - Return a renderer that draw boolean values using the given images - - Draw this when our data value is true - Draw this when our data value is false - A Renderer - - - - Return a renderer that draw tristate boolean values using the given images - - Draw this when our data value is true - Draw this when our data value is false - Draw this when our data value is null - A Renderer - - - - Make a new empty renderer - - - - - Make a new renderer that will show the given image when the given key is the aspect value - - The data value to be matched - The image to be shown when the key is matched - - - - Make a new renderer that will show the given images when it receives the given keys - - - - - - - - - Build a renderer from the given array of keys and their matching images - - An array of key/image pairs - - - - Register the image that should be drawn when our Aspect has the data value. - - Value that the Aspect must match - An ImageSelector -- an int, string or image - - - - Render our value - - - - - - - Draw a collection of images - - - - - - - - Draw one image - - - - - - - - This renderer draws just a checkbox to match the check state of our model object. - - - - - Draw our cell - - - - - - - Handle the GetEditRectangle request - - - - - - - - - - - Handle the HitTest request - - - - - - - - - Render an image that comes from our data source. - - The image can be sourced from: - - a byte-array (normally when the image to be shown is - stored as a value in a database) - an int, which is treated as an index into the image list - a string, which is treated first as a file name, and failing that as an index into the image list - an ICollection of ints or strings, which will be drawn as consecutive images - - If an image is an animated GIF, it's state is stored in the SubItem object. - By default, the image renderer does not render animations (it begins life with animations paused). - To enable animations, you must call Unpause(). - In the current implementation (2009-09), each column showing animated gifs must have a - different instance of ImageRenderer assigned to it. You cannot share the same instance of - an image renderer between two animated gif columns. If you do, only the last column will be - animated. - - - - - Make an empty image renderer - - - - - Make an empty image renderer that begins life ready for animations - - - - - Finalizer - - - - - Should the animations in this renderer be paused? - - - - - Gets a timer that can be used to trigger redraws on animations - - - - - Pause any animations - - - - - Unpause any animations - - - - - Draw our image - - - - - - - Translate our Aspect into an image. - - The strategy is: - If its a byte array, we treat it as an in-memory image - If it's an int, we use that as an index into our image list - If it's a string, we try to load a file by that name. If we can't, - we use the string as an index into our image list. - - An image - - - - This is the method that is invoked by the timer. It basically switches control to the listview thread. - - not used - - - - This is the OnTimer callback, but invoked in the same thread as the creator of the ListView. - This method can use all of ListViews methods without creating a CrossThread exception. - - - - - Instances of this class kept track of the animation state of a single image. - - - - - Is the given image an animation - - The image to be tested - Is the image an animation? - - - - Create an AnimationState in a quiet state - - - - - Create an animation state for the given image, which may or may not - be an animation - - The image to be rendered - - - - Does this state represent a valid animation - - - - - Advance our images current frame and calculate when it will expire - - - - - Render our Aspect as a progress bar - - - - - Make a BarRenderer - - - - - Make a BarRenderer for the given range of data values - - - - - Make a BarRenderer using a custom bar scheme - - - - - Make a BarRenderer using a custom bar scheme - - - - - Make a BarRenderer that uses a horizontal gradient - - - - - Make a BarRenderer that uses a horizontal gradient - - - - - 此栏是否应以系统样式绘制？ - - - - - 将从我们的单元格边框开始绘制多少像素的条形图 - - - - - 在绘制进度条之前，将使用什么颜色填充控件内部？ - - - - - 进度条边框颜色 - - - - - 进度条的边框像素宽 - - - - - 进度条的“填充”部分应该是什么颜色？ - - 仅当GradientStartColor为Color.Empty时才使用此选项 - - - - 使用渐变以此颜色开始填充进度条 - - - - - 使用渐变填充以此颜色结尾的进度条 - - - - - 使用渐变以此颜色开始填充渐满进度条 - - - - - 使用渐变填充以此颜色结尾的渐满进度条 - - - - - 无论列变得多宽，进度条都不会比这个宽。 - - - - - 无论单元格有多高，进度条都不会比这个高 - - - - - 预期的最小数据值。小于此值的值将显示一个空条。 - - - - - 接近满时的值,高于该值时，显示不同颜色，小于等于MinimumValue或大于MaximumValue值，则表示未设置该值 - - - - - 范围的最大值。大于此值的值将给出一个完整的条形。 - - - - - The Pen that will draw the frame surrounding this bar - - - - - The brush that will be used to fill the bar - - - - - The brush that will be used to fill the bar - - - - - The brush that will be used to fill the background of the bar - - - - - Draw this progress bar using a gradient - - - - - - - Draw our aspect - - - - - - - Handle the GetEditRectangle request - - - - - - - - - - - An ImagesRenderer draws zero or more images depending on the data returned by its Aspect. - - This renderer's Aspect must return a ICollection of ints, strings or Images, - each of which will be drawn horizontally one after the other. - As of v2.1, this functionality has been absorbed into ImageRenderer and this is now an - empty shell, solely for backwards compatibility. - - - - - A MultiImageRenderer draws the same image a number of times based on our data value - - The stars in the Rating column of iTunes is a good example of this type of renderer. - - - - Make a quiet renderer - - - - - Make an image renderer that will draw the indicated image, at most maxImages times. - - - - - - - - - The index of the image that should be drawn - - - - - The name of the image that should be drawn - - - - - The image selector that will give the image to be drawn - - Like all image selectors, this can be an int, string or Image - - - - What is the maximum number of images that this renderer should draw? - - - - - Values less than or equal to this will have 0 images drawn - - - - - Values greater than or equal to this will have MaxNumberImages images drawn - - - - - Draw our data value - - - - - - - A class to render a value that contains a bitwise-OR'ed collection of values. - - - - - Register the given image to the given value - - When this flag is present... - ...draw this image - - - - Draw the flags - - - - - - - Do the actual work of hit testing. Subclasses should override this rather than HitTest() - - - - - - - - - This renderer draws an image, a single line title, and then multi-line description - under the title. - - - This class works best with FullRowSelect = true. - It's not designed to work with cell editing -- it will work but will look odd. - - It's not RightToLeft friendly. - - - - - - Create a DescribedTaskRenderer - - - - - Should text be rendered using GDI routines? This makes the text look more - like a native List view control. - - - - - Gets or set the font that will be used to draw the title of the task - - If this is null, the ListView's font will be used - - - - Return a font that has been set for the title or a reasonable default - - - - - Gets or set the color of the title of the task - - This color is used when the task is not selected or when the listview - has a translucent selection mechanism. - - - - Return the color of the title of the task or a reasonable default - - - - - Gets or set the font that will be used to draw the description of the task - - If this is null, the ListView's font will be used - - - - Return a font that has been set for the title or a reasonable default - - - - - Gets or set the color of the description of the task - - This color is used when the task is not selected or when the listview - has a translucent selection mechanism. - - - - Return the color of the description of the task or a reasonable default - - - - - Gets or sets the number of pixels that will be left between the image and the text - - - - - 顶部留白像素 - - - - - Gets or sets the number of pixels that will be left between the title and the description - - - - - Gets or sets the name of the aspect of the model object that contains the task description - - - - - Gets or sets the filter that is filtering the ObjectListView and for - which this renderer should highlight text - - - - - When a filter changes, keep track of the text matching filters - - - - - Fetch the description from the model class - - - - - - - - - - - - - - - Draw our item - - - - - - - Draw the task - - - - - - - - - - Handle the HitTest request - - - - - - - - - This renderer draws a functioning button in its cell - - - - - Gets or sets how each button will be sized - - - - - Gets or sets the size of the button when the SizingMode is FixedBounds - - If this is not set, the bounds of the cell will be used - - - - Gets or sets the extra space that surrounds the cell when the SizingMode is TextBounds - - - - - Gets or sets the maximum width that a button can occupy. - -1 means there is no maximum width. - - This is only considered when the SizingMode is TextBounds - - - - Gets or sets the minimum width that a button can occupy. - -1 means there is no minimum width. - - This is only considered when the SizingMode is TextBounds - - - - 获取或设置此列按钮的字体颜色(如果有按钮的话) - - - - - 获取或设置此列按钮的背景颜色(如果有按钮的话) - - - - - 获取或设置此列按钮的边框颜色(如果有按钮的话) - - - - - 获取或设置此列按钮的内边框颜色(如果有按钮的话) - - - - - 获取或设置此列按钮是否画边框(如果有按钮的话) - - - - - Calculate the size of the contents - - - - - - - - Draw the button - - - - - - - What part of the control is under the given point? - - - - - - - - - - What is the state of the button? - - - - - - Is the mouse over the button? - - - - - The common interface supported by all style objects - - - - - Gets or set the font that will be used by this style - - - - - Gets or set the font style - - - - - Gets or sets the ForeColor - - - - - Gets or sets the BackColor - - - - - Basic implementation of IItemStyle - - - - - Gets or sets the font that will be applied by this style - - - - - Gets or sets the style of font that will be applied by this style - - - - - Gets or sets the color of the text that will be applied by this style - - - - - Gets or sets the background color that will be applied by this style - - - - - Instances of this class specify how should "hot items" (non-selected - rows under the cursor) be renderered. - - - - - Gets or sets the overlay that should be drawn as part of the hot item - - - - - Gets or sets the decoration that should be drawn as part of the hot item - - A decoration is different from an overlay in that an decoration - scrolls with the listview contents, whilst an overlay does not. - - - - This class defines how a cell should be formatted - - - - - Gets or sets the font that will be applied by this style - - - - - Gets or sets the style of font that will be applied by this style - - - - - Gets or sets the color of the text that will be applied by this style - - - - - Gets or sets the background color that will be applied by this style - - - - - Instances of this class describe how hyperlinks will appear - - - - - Create a HyperlinkStyle - - - - - What sort of formatting should be applied to hyperlinks in their normal state? - - - - - What sort of formatting should be applied to hyperlinks when the mouse is over them? - - - - - What sort of formatting should be applied to hyperlinks after they have been clicked? - - - - - Gets or sets the cursor that should be shown when the mouse is over a hyperlink. - - - - - Instances of this class control one the styling of one particular state - (normal, hot, pressed) of a header control - - - - - Gets or sets the font that will be applied by this style - - - - - Gets or sets the color of the text that will be applied by this style - - - - - Gets or sets the background color that will be applied by this style - - - - - Gets or sets the color in which a frame will be drawn around the header for this column - - - - - Gets or sets the width of the frame that will be drawn around the header for this column - - - - - This class defines how a header should be formatted in its various states. - - - - - Create a new HeaderFormatStyle - - - - - What sort of formatting should be applied to a column header when the mouse is over it? - - - - - What sort of formatting should be applied to a column header in its normal state? - - - - - What sort of formatting should be applied to a column header when pressed? - - - - - Set the font for all three states - - - - - - Set the fore color for all three states - - - - - - Set the back color for all three states - - - - - - 正常为选中按钮 - - - - - 获得焦点的按钮 - - - - - 鼠标经过样式 - - - - - 获得焦点并鼠标经过 - - - - - 自定义GDI工具，绘制按钮 - - - - - 绘制圆形按钮（用法同矩形按钮） - - - - - - - - - - 绘制圆角按钮 - - 要绘制的文字 - Graphics 对象 - 要填充的矩形 - - - - - 根据普通矩形得到圆角矩形的路径 - - 原始矩形 - 半径 - 图形路径 - - - - A GlassPanelForm sits transparently over an ObjectListView to show overlays. - - - - - Get the low-level windows flag that will be given to CreateWindow. - - - - - Attach this form to the given ObjectListView - - - - - Made the overlay panel invisible - - - - - Show the overlay panel in its correctly location - - - If the panel is always shown, this method does nothing. - If the panel is being resized, this method also does nothing. - - - - - Detach this glass panel from its previous ObjectListView - - - You should unbind the overlay panel before making any changes to the - widget hierarchy. - - - - - Handle when the form that owns the ObjectListView begins to be resized - - - - - - - Handle when the form that owns the ObjectListView finished to be resized - - - - - - - The owning form has moved. Move the overlay panel too. - - - - - - - The owning form is resizing. Hide our overlay panel until the resizing stops - - - - - - - Handle when the bound OLV changes its location. The overlay panel must - be moved too, IFF it is currently visible. - - - - - - - Handle when the bound OLV changes size. The overlay panel must - resize too, IFF it is currently visible. - - - - - - - Handle when the bound OLV is part of a TabControl and that - TabControl changes tabs. The overlay panel is hidden. The - first time the bound OLV is redrawn, the overlay panel will - be shown again. - - - - - - - Somewhere the parent of the bound OLV has changed. Update - our events. - - - - - - - Handle when the bound OLV changes its visibility. - The overlay panel should match the OLV's visibility. - - - - - - - Class used to capture window messages for the header of the list view - control. - - - - - Create a header control for the given ObjectListView. - - - - - - Return the index of the column under the current cursor position, - or -1 if the cursor is not over a column - - Index of the column under the cursor, or -1 - - - - 返回此控件的Windows句柄 - - - 当ObjectListView被初始化为UserControl的一部分时，GetHeaderControl()方法返回0，直到UserControl完全初始化。 - 因此，构造函数中的AssignHandle()调用不起作用。因此，我们覆盖了Handle属性，以便值始终为当前值。 - - - - - Gets or sets a style that should be applied to the font of the - column's header text when the mouse is over that column - - THIS IS EXPERIMENTAL. USE AT OWN RISK. August 2009 - - - - 如果光标位于其复选框上，则获取光标下列的索引 - - - - - Gets the client rectangle for the header - - - - - 如果给定坐标点在给定列的复选框上方，则返回TRUE。 - - - - - - - - 获取光标是否位于“锁定”的分隔线上，即用户无法拖动的分隔线。 - - - - - 获取或设置此标头所属的列表视图 - - - - - 获取标题的最大高度。-1表示没有最大值。 - - - - - 获取标题的最小高度。-1表示没有最低要求。 - - - - - Get or set the ToolTip that shows tips for the header - - - - - 获取或设置当列标题中的文本太长而无法放入列中时，是否应对其进行自动换行 - - - - - Calculate how height the header needs to be - - Height in pixels - - - - Get the bounds of the checkbox against the given column - - - - - - - Should the given column be drawn with a checkbox against it? - - - - - - - Should the given column show a sort indicator? - - - - - - - Should the given column be drawn with a filter indicator against it? - - - - - - - Should the given column show a non-themed sort indicator? - - - - - - - Return the bounds of the item with the given index - - - - - - - Return the bounds within which the given column will be drawn - - - - - - - Force the header to redraw by invalidating it - - - - - Force the header to redraw a single column by invalidating it - - - - - Create a native tool tip control for this listview - - - - - Override the basic message pump - - - - - - Handle the LButtonDown windows message - - - - - - - Handle the LButtonUp windows message - - - - - - - Handle the SetCursor windows message - - - - - - - Handle the MouseMove windows message - - - - - - - Handle the MouseLeave windows message - - - - - - - Handle the Notify windows message - - - - - - - Handle the CustomDraw windows message - - - - - - - The message divides a ListView's space between the header and the rows of the listview. - The WINDOWPOS structure controls the headers bounds, the RECT controls the listview bounds. - - - - - - - Handle when the underlying header control is destroyed - - - - - - - Does this header need to be custom drawn? - - Word wrapping and colored text require custom drawning. Funnily enough, we - can change the font natively. - - - - Draw one cell of the header - - - - - - - - Draw a background for the header, without using Themes. - - - - - - - - - - - Draw a more-or-less pure themed header background. - - - - - - - - - - Draw a sort indicator using themes - - - - - - - Draw a sort indicator without using themes - - - - - - - - Draw an indication that this column has a filter applied to it - - - - - - - - Draw the header's image and text - - - - - - - - - Return the header format that should be used for the given column - - - - - - - What style should be applied to the header? - - - - - - - - - What font should be used to draw the header text? - - - - - - - - - What flags will be used when drawing text - - - - - Perform a HitTest for the header control - - - - Null if the given point isn't over the header - - - - Instances of this class put a CheckedListBox into a tool strip menu item. - - - - - Create a ToolStripCheckedListBox - - - - - Gets the control embedded in the menu - - - - - Gets the items shown in the checkedlistbox - - - - - Gets or sets whether an item should be checked when it is clicked - - - - - Gets a collection of the checked items - - - - - Add a possibly checked item to the control - - - - - - - Add an item with the given state to the control - - - - - - - Gets the checkedness of the i'th item - - - - - - - Set the checkedness of the i'th item - - - - - - - Check all the items in the control - - - - - Unchecked all the items in the control - - - - - Listen for events on the underlying control - - - - - - Stop listening for events on the underlying control - - - - - - Tell the world that an item was checked - - - - - Trigger the ItemCheck event - - - - - - - A limited wrapper around a Windows tooltip window. - - - - - These are the standard icons that a tooltip can display. - - - - - No icon - - - - - Info - - - - - Warning - - - - - Error - - - - - Large info (Vista and later only) - - - - - Large warning (Vista and later only) - - - - - Large error (Vista and later only) - - - - - - - - - - - - - - - - - - - - - - - - - Get or set if the style of the tooltip control - - - - - Get or set if the tooltip should be shown as a ballon - - - - - Get or set if the tooltip should be shown as a ballon - - - - - Get or set the background color of the tooltip - - - - - Get or set the color of the text and border on the tooltip. - - - - - Get or set the title that will be shown on the tooltip. - - - - - Get or set the icon that will be shown on the tooltip. - - - - - Gets or sets the font that will be used to draw this control. - is still. - - Setting this to null reverts to the default font. - - - - Gets or sets how many milliseconds the tooltip will remain visible while the mouse - is still. - - - - - Gets or sets how many milliseconds the mouse must be still before the tooltip is shown. - - - - - Gets or sets how many milliseconds the mouse must be still before the tooltip is shown again. - - - - - Create the underlying control. - - The parent of the tooltip - This does nothing if the control has already been created - - - - Take a copy of the current settings and restore them when the - tooltip is poppped. - - - This call cannot be nested. Subsequent calls to this method will be ignored - until PopSettings() is called. - - - - - Restore the settings of the tooltip as they were when PushSettings() - was last called. - - - - - Add the given window to those for whom this tooltip will show tips - - The window - - - - Hide any currently visible tooltip - - - - - - Remove the given window from those managed by this tooltip - - - - - - Set the maximum width of a tooltip string. - - - - - Set the maximum width of a tooltip string. - - Setting this ensures that line breaks in the tooltip are honoured. - - - - Make a TOOLINFO structure for the given window - - - A filled in TOOLINFO - - - - Handle a WmNotify message - - The msg - True if the message has been handled - - - - Handle a get display info message - - The msg - True if the message has been handled - - - - Handle a TTN_LINKCLICK message - - The msg - True if the message has been handled - This cannot call base.WndProc() since the msg may have come from another control. - - - - Handle a TTN_POP message - - The msg - True if the message has been handled - This cannot call base.WndProc() since the msg may have come from another control. - - - - Handle a TTN_SHOW message - - The msg - True if the message has been handled - This cannot call base.WndProc() since the msg may have come from another control. - - - - Handle a reflected notify message - - The msg - True if the message has been handled - - - - Mess with the basic message pump of the tooltip - - - - - - Tell the world that a tooltip is about to show - - - - - Tell the world that a tooltip is about to disappear - - - - - - - - - - - - - - - - - This form is an example of how an application could allows the user to select which columns - an ObjectListView will display, as well as select which order the columns are displayed in. - - - In Tile view, ColumnHeader.DisplayIndex does nothing. To reorder the columns you have - to change the order of objects in the Columns property. - Remember that the first column is special! - It has to remain the first column. - - - - - Make a new ColumnSelectionForm - - - - - Open this form so it will edit the columns that are available in the listview's current view - - The ObjectListView whose columns are to be altered - - - - Open this form so it will edit the columns that are available in the given listview - when the listview is showing the given type of view. - - The ObjectListView whose columns are to be altered - The view that is to be altered. Must be View.Details or View.Tile - - - - Initialize the form to show the columns of the given view - - - - - - - The user has pressed OK. Do what's requied. - - - - - - - Enable the controls on the dialog to match the current state - - - - - A Comparer that will sort a list of columns so that visible ones come before hidden ones, - and that are ordered by their display order. - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - An object that implements the IGenerator interface provides the ability - to dynamically create columns - for an ObjectListView based on the characteristics of a given collection - of model objects. - - - - - Generate columns into the given ObjectListView that come from the given - model object type. - - The ObjectListView to modify - The model type whose attributes will be considered. - Will columns be generated for properties that are not marked with [OLVColumn]. - - - - Generate a list of OLVColumns based on the attributes of the given type - If allProperties to true, all public properties will have a matching column generated. - If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. - - - Will columns be generated for properties that are not marked with [OLVColumn]. - A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. - - - - The Generator class provides methods to dynamically create columns - for an ObjectListView based on the characteristics of a given collection - of model objects. - - - For a given type, a Generator can create columns to match the public properties - of that type. The generator can consider all public properties or only those public properties marked with - [OLVColumn] attribute. - - - - - Gets or sets the actual generator used by the static convinence methods. - - If you subclass the standard generator or implement IGenerator yourself, - you should install an instance of your subclass/implementation here. - - - - Replace all columns of the given ObjectListView with columns generated - from the first member of the given enumerable. If the enumerable is - empty or null, the ObjectListView will be cleared. - - The ObjectListView to modify - The collection whose first element will be used to generate columns. - - - - Replace all columns of the given ObjectListView with columns generated - from the first member of the given enumerable. If the enumerable is - empty or null, the ObjectListView will be cleared. - - The ObjectListView to modify - The collection whose first element will be used to generate columns. - Will columns be generated for properties that are not marked with [OLVColumn]. - - - - Generate columns into the given ObjectListView that come from the public properties of the given - model object type. - - The ObjectListView to modify - The model type whose attributes will be considered. - - - - Generate columns into the given ObjectListView that come from the public properties of the given - model object type. - - The ObjectListView to modify - The model type whose attributes will be considered. - Will columns be generated for properties that are not marked with [OLVColumn]. - - - - Generate a list of OLVColumns based on the public properties of the given type - that have a OLVColumn attribute. - - - A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. - - - - Generate columns into the given ObjectListView that come from the given - model object type. - - The ObjectListView to modify - The model type whose attributes will be considered. - Will columns be generated for properties that are not marked with [OLVColumn]. - - - - Generate a list of OLVColumns based on the attributes of the given type - If allProperties to true, all public properties will have a matching column generated. - If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. - - - Will columns be generated for properties that are not marked with [OLVColumn]. - A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. - - - - Replace all the columns in the given listview with the given list of columns. - - - - - - - Post process columns after creating them and adding them to the AllColumns collection. - - - - - - Create a column from the given PropertyInfo and OLVColumn attribute - - - - - - - - Make a column from the given PropertyInfo - - - - - - - Make a column from the given PropertyDescriptor - - - - - - - Create a column with all the given information - - - - - - - - - - - Create a column. - - - - - - - - - Convert a property name to a displayable title. - - - - - - - Configure the given column to show a checkbox if appropriate - - - - - - - If this given type has an property marked with [OLVChildren], make delegates that will - traverse that property as the children of an instance of the model - - - - - - - Generate CanExpand and ChildrenGetter delegates from the given property. - - - - - - - An OLVExporter converts a collection of rows from an ObjectListView - into a variety of textual formats. - - - - - What format will be used for exporting - - - - - Tab separated values, according to http://www.iana.org/assignments/media-types/text/tab-separated-values - - - - - Alias for TabSeparated - - - - - Comma separated values, according to http://www.ietf.org/rfc/rfc4180.txt - - - - - HTML table, according to me - - - - - Create an empty exporter - - - - - Create an exporter that will export all the rows of the given ObjectListView - - - - - - Create an exporter that will export all the given rows from the given ObjectListView - - - - - - - Gets or sets whether hidden columns will also be included in the textual - representation. If this is false (the default), only visible columns will - be included. - - - - - Gets or sets whether column headers will also be included in the text - and HTML representation. Default is true. - - - - - Gets the ObjectListView that is being used as the source of the data - to be exported - - - - - Gets the model objects that are to be placed in the data object - - - - - Export the nominated rows from the nominated ObjectListView. - Returns the result in the expected format. - - - - This will perform only one conversion, even if called multiple times with different formats. - - - - Convert - - - - - Encode a string such that it can be used as a value in a CSV file. - This basically means replacing any quote mark with two quote marks, - and enclosing the whole string in quotes. - - - - - - - HTML-encodes a string and returns the encoded string. - - The text string to encode. - The HTML-encoded text. - Taken from http://www.west-wind.com/weblog/posts/2009/Feb/05/Html-and-Uri-String-Encoding-without-SystemWeb - - - - A TypedObjectListView is a type-safe wrapper around an ObjectListView. - - - VCS does not support generics on controls. It can be faked to some degree, but it - cannot be completely overcome. In our case in particular, there is no way to create - the custom OLVColumn's that we need to truly be generic. So this wrapper is an - experiment in providing some type-safe access in a way that is useful and available today. - A TypedObjectListView is not more efficient than a normal ObjectListView. - Underneath, the same name of casts are performed. But it is easier to use since you - do not have to write the casts yourself. - - - The class of model object that the list will manage - - To use a TypedObjectListView, you write code like this: - - TypedObjectListView<Person> tlist = new TypedObjectListView<Person>(this.listView1); - tlist.CheckStateGetter = delegate(Person x) { return x.IsActive; }; - tlist.GetColumn(0).AspectGetter = delegate(Person x) { return x.Name; }; - ... - - To iterate over the selected objects, you can write something elegant like this: - - foreach (Person x in tlist.SelectedObjects) { - x.GrantSalaryIncrease(); - } - - - - - - Create a typed wrapper around the given list. - - The listview to be wrapped - - - - Return the model object that is checked, if only one row is checked. - If zero rows are checked, or more than one row, null is returned. - - - - - Return the list of all the checked model objects - - - - - The ObjectListView that is being wrapped - - - - - Get or set the list of all model objects - - - - - Return the model object that is selected, if only one row is selected. - If zero rows are selected, or more than one row, null is returned. - - - - - The list of model objects that are selected. - - - - - Return a typed wrapper around the column at the given index - - The index of the column - A typed column or null - - - - Return a typed wrapper around the column with the given name - - The name of the column - A typed column or null - - - - Return the model object at the given index - - The index of the model object - The model object or null - - - - CheckStateGetter - - - - - - - Gets or sets the check state getter - - - - - BooleanCheckStateGetter - - - - - - - Gets or sets the boolean check state getter - - - - - CheckStatePutter - - - - - - - - Gets or sets the check state putter delegate - - - - - BooleanCheckStatePutter - - - - - - - - Gets or sets the boolean check state putter - - - - - ToolTipGetter - - - - - - - - Gets or sets the cell tooltip getter - - - - - Gets or sets the header tool tip getter - - - - - This method will generate AspectGetters for any column that has an AspectName. - - - - - A type-safe wrapper around an OLVColumn - - - - - - Creates a TypedColumn - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Generate an aspect getter that does the same thing as the AspectName, - except without using reflection. - - - - If you have an AspectName of "Owner.Address.Postcode", this will generate - the equivilent of: this.AspectGetter = delegate (object x) { - return x.Owner.Address.Postcode; - } - - - - If AspectName is empty, this method will do nothing, otherwise - this will replace any existing AspectGetter. - - - - - - Generates an aspect getter method dynamically. The method will execute - the given dotted chain of selectors against a model object given at runtime. - - The type of model object to be passed to the generated method - A dotted chain of selectors. Each selector can be the name of a - field, property or parameter-less method. - A typed delegate - - - - This method generates the actual IL for the method. - - - - - - - - A virtual object list view operates in virtual mode, that is, it only gets model objects for - a row when it is needed. This gives it the ability to handle very large numbers of rows with - minimal resources. - - A listview is not a great user interface for a large number of items. But if you've - ever wanted to have a list with 10 million items, go ahead, knock yourself out. - Virtual lists can never iterate their contents. That would defeat the whole purpose. - Animated GIFs should not be used in virtual lists. Animated GIFs require some state - information to be stored for each animation, but virtual lists specifically do not keep any state information. - In any case, you really do not want to keep state information for 10 million animations! - - Although it isn't documented, .NET virtual lists cannot have checkboxes. This class codes around this limitation, - but you must use the functions provided by ObjectListView: CheckedObjects, CheckObject(), UncheckObject() and their friends. - If you use the normal check box properties (CheckedItems or CheckedIndicies), they will throw an exception, since the - list is in virtual mode, and .NET "knows" it can't handle checkboxes in virtual mode. - - Due to the limits of the underlying Windows control, virtual lists do not trigger ItemCheck/ItemChecked events. - Use a CheckStatePutter instead. - To enable grouping, you must provide an implmentation of IVirtualGroups interface, via the GroupingStrategy property. - Similarly, to enable filtering on the list, your VirtualListDataSource must also implement the IFilterableDataSource interface. - - - - - Create a VirtualObjectListView - - - - - Gets whether or not this listview is capabale of showing groups - - - - - Get or set the collection of model objects that are checked. - When setting this property, any row whose model object isn't - in the given collection will be unchecked. Setting to null is - equivilent to unchecking all. - - - - This property returns a simple collection. Changes made to the returned - collection do NOT affect the list. This is different to the behaviour of - CheckedIndicies collection. - - - When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. - When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus - the number of objects to be checked. - - - If the ListView is not currently showing CheckBoxes, this property does nothing. It does - not remember any check box settings made. - - - This class optimizes the management of CheckStates so that it will work efficiently even on - large lists of item. However, those optimizations are impossible if you install a CheckStateGetter. - With a CheckStateGetter installed, the performance of this method is O(n) where n is the size - of the list. This could be painfully slow. - - - - - Gets or sets whether or not an object will be included in the CheckedObjects - collection, even if it is not present in the control at the moment - - - This property is an implementation detail and should not be altered. - - - - - Gets the collection of objects that survive any filtering that may be in place. - - - - - Gets or sets the strategy that will be used to create groups - - - This must be provided for a virtual list to show groups. - - - - - Gets whether or not the current list is filtering its contents - - - This is only possible if our underlying data source supports filtering. - - - - - Get/set the collection of objects that this list will show - - - - The contents of the control will be updated immediately after setting this property. - - Setting this property preserves selection, if possible. Use SetObjects() if - you do not want to preserve the selection. Preserving selection is the slowest part of this - code -- performance is O(n) where n is the number of selected rows. - This method is not thread safe. - The property DOES work on virtual lists, but if you try to iterate through a list - of 10 million objects, it may take some time :) - - - - - This delegate is used to fetch a rowObject, given it's index within the list - - Only use this property if you are not using a VirtualListDataSource. - - - - Should this list show its items in groups? - - - - - Get/set the data source that is behind this virtual list - - Setting this will cause the list to redraw. - - - - Gets or sets the number of rows in this virtual list. - - - There is an annoying feature/bug in the .NET ListView class. - When you change the VirtualListSize property, it always scrolls so - that the focused item is the top item. This is annoying since it makes - the virtual list seem to flicker as the control scrolls to show the focused - item and then scrolls back to where ObjectListView wants it to be. - - - - - Return the number of items in the list - - the number of items in the list - - - - Return the model object at the given index - - Index of the model object to be returned - A model object - - - - Find the given model object within the listview and return its index - - The model object to be found - The index of the object. -1 means the object was not present - - - - Return the OLVListItem that displays the given model object - - The modelObject whose item is to be found - The OLVListItem that displays the model, or null - This method has O(n) performance. - - - - Add the given collection of model objects to this control. - - A collection of model objects - - The added objects will appear in their correct sort position, if sorting - is active. Otherwise, they will appear at the end of the list. - No check is performed to see if any of the objects are already in the ListView. - Null objects are silently ignored. - - - - - Remove all items from this list - - This method can safely be called from background threads. - - - - Scroll the listview so that the given group is at the top. - - The index of the group to be revealed - - If the group is already visible, the list will still be scrolled to move - the group to the top, if that is possible. - - This only works when the list is showing groups (obviously). - - - - - Inserts the given collection of model objects to this control at hte given location - - - A collection of model objects - - The added objects will appear in their correct sort position, if sorting - is active. Otherwise, they will appear at the given position of the list. - No check is performed to see if any of the objects are already in the ListView. - Null objects are silently ignored. - - - - - Update the rows that are showing the given objects - - This method does not resort the items. - - - - Update the rows that are selected - - This method does not resort or regroup the view. - - - - Remove all of the given objects from the control - - Collection of objects to be removed - - Nulls and model objects that are not in the ListView are silently ignored. - Due to problems in the underlying ListView, if you remove all the objects from - the control using this method and the list scroll vertically when you do so, - then when you subsequenially add more objects to the control, - the vertical scroll bar will become confused and the control will draw one or more - blank lines at the top of the list. - - - - - Select the row that is displaying the given model object. All other rows are deselected. - - Model object to select - Should the object be focused as well? - - - - Select the rows that is displaying any of the given model object. All other rows are deselected. - - A collection of model objects - This method has O(n) performance where n is the number of model objects passed. - Do not use this to select all the rows in the list -- use SelectAll() for that. - - - - Set the collection of objects that this control will show. - - - Should the state of the list be preserved as far as is possible. - - - - Get the checkedness of an object from the model. Returning null means the - model does know and the value from the control will be used. - - - - - - - Rebuild the list with its current contents. - - - Invalidate any cached information when we rebuild the list. - - - - - Clear any cached info this list may have been using - - - - - Do the work of creating groups for this control - - - - - - Do the plumbing to disable groups on a virtual list - - - - - Do the plumbing to enable groups on a virtual list - - - - - Return the position of the given itemIndex in the list as it currently shown to the user. - If the control is not grouped, the display order is the same as the - sorted list order. But if the list is grouped, the display order is different. - - - - - - - Return the last item in the order they are shown to the user. - If the control is not grouped, the display order is the same as the - sorted list order. But if the list is grouped, the display order is different. - - - - - - Return the n'th item (0-based) in the order they are shown to the user. - If the control is not grouped, the display order is the same as the - sorted list order. But if the list is grouped, the display order is different. - - - - - - - Return the ListViewItem that appears immediately after the given item. - If the given item is null, the first item in the list will be returned. - Return null if the given item is the last item. - - The item that is before the item that is returned, or null - A OLVListItem - - - - Return the ListViewItem that appears immediately before the given item. - If the given item is null, the last item in the list will be returned. - Return null if the given item is the first item. - - The item that is before the item that is returned - A ListViewItem - - - - Make a list of groups that should be shown according to the given parameters - - - - - - - Create a OLVListItem for given row index - - The index of the row that is needed - An OLVListItem - - - - On virtual lists, this cannot work. - - - - - Record the change of checkstate for the given object in the model. - This does not update the UI -- only the model - - - - The check state that was recorded and that should be used to update - the control. - - - - Refresh the given item in the list - - The item to refresh - - - - Change the size of the list - - - - - - Take ownership of the 'objects' collection. This separates our collection from the source. - - - - This method - separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject - calls will modify our collection and not the original colleciton. - - - VirtualObjectListViews always own their collections, so this is a no-op. - - - - - - Change the state of the control to reflect changes in filtering - - - - - Change the size of the virtual list so that it matches its data source - - - - - Handle the CacheVirtualItems event - - - - - - - Handle a RetrieveVirtualItem - - - - - - - Handle the SearchForVirtualList event, which is called when the user types into a virtual list - - - - - - - Find the first row in the given range of rows that prefix matches the string value of the given column. - - - - - - The index of the matched row, or -1 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 初始化的时候给个alpha值,这样在灰图片的时候可以半透明 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 使图片单色化 - - - - - - - - - - - - 自定义 - - - - - 预置 - - - - - 系统 - - - - - 颜色表示法 - - - - - 根据颜色表示字符串获取对应的颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - 从文件中获取Image对象 - 这个函数的主要功能是处理一些ico文件 - 一些ico文件的格式可能比较新，直接Image.FormFile，会报内存不足的异常 - - - 是否将文件读入内存操作，如果为false,将直接返回Image.FromFile，在此情况下， - 必须手动释放Image对象，否则文件将一直处于占用状态，如果为true,则在内存中拷贝副本 - - - - - - 将图像转为Icon对象,使用png格式 - - - - - - - 将图像转为Icon对象 - - - - - - - - 返回适应指定容器大小的图像 - 如果图像的尺寸(长或宽)超出了容器范围,将按比例获取图像的缩略图返回,否则直接返回图像 - 此方法最终调用 Image.GetThumbnailImage - 但是注意,在指定的容器尺寸过小时,返回的Image尺寸不可知,是在为了显示16x16的小缩略图是发现了此问题 - 使用 GetScaleImage - - - - - - - - - 返回适应指定容器大小的图像 - 在需要的情况下,此方法创建一个新对象,进行绘制 - - - - - - - - 返回适应指定容器大小的图像 - 在需要的情况下,此方法创建一个新对象,进行绘制 - - - - - - - - - Gets the bounding rectangle of an image required to fit - in to the given rectangle keeping the image aspect ratio. - - The source image. - The rectangle to fit in to. - Horizontal image aligment in percent. - Vertical image aligment in percent. - New image size. - - - - Gets the bounding rectangle of an image required to fit - in to the given rectangle keeping the image aspect ratio. - The image will be centered in the fit box. - - The source image. - The rectangle to fit in to. - New image size. - - - - Gets the scaled size of an image required to fit - in to the given size keeping the image aspect ratio. - - The source image. - The size to fit in to. - New image size. - - - - 获取一个圆角矩形 - - - - 角度 - - - - - 获取一个圆角矩形 - - - 角度 - - - - - - - - - - - - - - - - - - - - - - 返回一个表示箭头的Path - 如果开始坐标和结束坐标之间的距离大于箭头的大小，箭头向结束坐标对齐，顶着结束坐标 - - 开始坐标 - 结束坐标（顶点，方向） - 箭头的长短，大小 - 箭头的粗细 - - - - - 在指定的Image上绘制特定标记 - - - - - 文件不存在 - - - - - - 文件不存在 - - - - - - 无法读取文件 - - - - - - - - - - - - - - - - - - - - - 验证失败中显示错误信息时用的标题 - - - - - 验证失败时是否需要高亮显示（改变背景色） - - - - - 验证控件的输入 - - - - - - - 自定义验证方法 - 在基础验证都通过后，才会调用自定义验证方法（如果有） - - - - - - - - - - 是否支持 Windows Vista 以上的玻璃效果 - - - - - 是否打开了玻璃效果 - - - - - 获取应用程序主窗体 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 这个缓存是全局的 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 所对应的绑定数据类型 - - - - - 是否对 DataBoundType 的子类型有效 - 默认无效 - 如果设置为 true，又同时添加了基类与子类的 codon，则运行时会取到哪个codon不确定 - 通常取先添加的那个 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 获取授予该组件的许可证密钥 - - - - - 0:未验证 - 1:验证失败 - 2:验证通过 - - - - - 获取组件的实例或类型的许可证（如果已给定上下文并确定拒绝许可证是否引发异常）。 - - - - - - - - - - 强类型资源类，用于查找本地化字符串等。 - - - - - - - - - - 返回此类使用的缓存 ResourceManager 实例。 - - - - - 为使用此强类型资源类的所有资源查找 - 重写当前线程的 CurrentUICulture 属性。 - - - - - 查找类似 消息 的本地化字符串。 - - - - - 查找类似 底部 的本地化字符串。 - - - - - 查找类似 顶部 的本地化字符串。 - - - - - 查找类似 更大 (48x48) 的本地化字符串。 - - - - - 查找类似 大 (32x32) 的本地化字符串。 - - - - - 查找类似 中 (24x24) 的本地化字符串。 - - - - - 查找类似 小 (16x16) 的本地化字符串。 - - - - - Returns true if the current language is the default language. - - - - - Returns a System.String that represents the current System.Object. - - - - - - - - - - 返回此类使用的缓存 ResourceManager 实例。 - - - - - 为使用此强类型资源类的所有资源查找 - 重写当前线程的 CurrentUICulture 属性。 - - - - - 查找类似 消息 的本地化字符串。 - - - - - 查找类似 底部 的本地化字符串。 - - - - - 查找类似 顶部 的本地化字符串。 - - - - - 查找类似 更大 (48x48) 的本地化字符串。 - - - - - 查找类似 大 (32x32) 的本地化字符串。 - - - - - 查找类似 中 (24x24) 的本地化字符串。 - - - - - 查找类似 小 (16x16) 的本地化字符串。 - - - - - Returns true if the current language is the default language. - - - - - - - - - - Call GetLanguages() to retrieve a list of possible languages that can be used to set this property. - The default value is the default language. - - - - - Gets a list of available languages defined in this assembly. - - - - - - - - - - - - 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 - - - - - - - Represents a pop-up window. - - - - - Gets the content of the pop-up. - - - - - Determines which animation to use while showing the pop-up window. - - - - - Determines which animation to use while hiding the pop-up window. - - - - - Determines the duration of the animation. - - - - - Gets or sets a value indicating whether the content should receive the focus after the pop-up has been opened. - - true if the content should be focused after the pop-up has been opened; otherwise, false. - If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. - - - - Gets or sets a value indicating whether presing the alt key should close the pop-up. - - true if presing the alt key does not close the pop-up; otherwise, false. - - - - Gets or sets a value indicating whether the is resizable. - - true if resizable; otherwise, false. - - - - Gets or sets a minimum size of the pop-up. - - An ordered pair of type representing the width and height of a rectangle. - - - - Gets or sets a maximum size of the pop-up. - - An ordered pair of type representing the width and height of a rectangle. - - - - Gets parameters of a new window. - - An object of type used when creating a new window. - - - - Initializes a new instance of the class. - - The content of the pop-up. - - Pop-up will be disposed immediately after disposion of the content control. - - is null. - - - - Raises the event. - - An that contains the event data. - - - - Processes a dialog box key. - - One of the values that represents the key to process. - - true if the key was processed by the control; otherwise, false. - - - - - Updates the pop-up region. - - - - - Shows the pop-up window below the specified control. - - The control below which the pop-up will be shown. - - When there is no space below the specified control, the pop-up control is shown above it. - - is null. - - - - Shows the pop-up window below the specified area of the specified control. - - The control used to compute screen location of specified area. - The area of control below which the pop-up will be shown. - - When there is no space below specified area, the pop-up control is shown above it. - - is null. - - - - Raises the event. - - An that contains the event data. - - - - Raises the event. - - A that contains the event data. - - - - Raises the event. - - An that contains the event data. - - - - Raises the event. - - A that contains the event data. - - - - Processes Windows messages. - - The Windows to process. - - - - Processes the resizing messages. - - The message. - true, if the WndProc method from the base class shouldn't be invoked. - - - - Paints the sizing grip. - - The instance containing the event data. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - Types of animation of the pop-up window. - - - - - Uses no animation. - - - - - Animates the window from left to right. This flag can be used with roll or slide animation. - - - - - Animates the window from right to left. This flag can be used with roll or slide animation. - - - - - Animates the window from top to bottom. This flag can be used with roll or slide animation. - - - - - Animates the window from bottom to top. This flag can be used with roll or slide animation. - - - - - Makes the window appear to collapse inward if it is hiding or expand outward if the window is showing. - - - - - Uses a slide animation. - - - - - Uses a fade effect. - - - - - Uses a roll animation. - - - - - Uses a default animation. - - - - - Represents a Windows combo box control with a custom popup control attached. - - - - - Initializes a new instance of the class. - - - - - Gets or sets the drop down control. - - The drop down control. - - - - Gets or sets a value indicating whether the combo box is displaying its drop-down portion. - - - true if the drop-down portion is displayed; otherwise, false. The default is false. - - - - - Occurs when the drop-down portion of a is shown. - - - - - Shows the drop down. - - - - - Occurs when the drop-down portion of the is no longer visible. - - - - - Hides the drop down. - - - - - Processes Windows messages. - - The Windows to process. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - Represents a Windows combo box control which can be used in a popup's content control. - - - - - Initializes a new instance of the PopupControl.ComboBox class. - - - - - Raises the event. - - An that contains the event data. - - - - Raises the event. - - An that contains the event data. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 白色到灰色的垂直渐变 - - - - - - - - - - This method handles the RenderToolStripBorder event. - - - - - - - - - - - - A ToolstripManager rendering class with advanced control features - - - - - Creates a new EasyRender class for modifications - - - - - - - - - - - - - - - - - - - - Gets the manager to edit and change the appearance of the Toolstrip - - - - - Gets the manager to edit and change the appearance of Toolstrip buttons - - - - - Gets the manager to edit and change the appearance of other Toolstrip controls - - - - - Gets the manager to edit and change the appearance of the Panels - - - - - Gets the manager to edit and change the appearance of the Toolstrip split buttons - - - - - Gets the manager to edit and change the appearance of the Status-bar - - - - - Gets or sets whether to smooth the font text on all controls - - - - - Gets or sets the color of the text if the AlterColor is set to true - - - - - Gets or sets whether to override the font-color on all controls - - - - - Creates a GraphicsPath that appreciates an area where things can be drawn - - The rectangular area which will serve as the base - The curve amount of the corners - - - - - Creates a triangle based on the size and bounds sectors - - The area which the triangle is confined to - The size of the triangle - The direction which the triangle is pointing - - - - - Gets a color array based on the state of a normal button - - The button to check the state of - - - - - - Gets a color array based on the state of a split-button - - The button to check the state of - - - - - - Gets a color array based on the state of a menu-item - - The button to check the state of - - - - - - Gets a color array based on the state of a drop-down button - - The button to check the state of - - - - - - Gets a blending property for a specified type of Toolstrip item - - The Toolstrip item - The type of item this is - - - - - Fills a specified boundary with color - - The Graphics object to draw onto - The boundaries to draw the color - The brush to fill the color - - - - Fills a specified boundary with a gradient with specified colors - - The Graphics object to draw onto - The boundaries to draw the color - The color of the gradient at the top - The color of the gradient at the bottom - - - - Fills a specified boundary with a gradient with specified colors at a given angle - - The Graphics object to draw onto - The boundaries to draw the color - The color of the gradient at the top - The color of the gradient at the bottom - The angle which the gradient is drawn (null defaults to 90f) - - - - Fills a specified boundary with a gradient with specified colors at a given angle and with blending properties - - The Graphics object to draw onto - The boundaries to draw the color - The color of the gradient at the top - The color of the gradient at the bottom - The angle which the gradient is drawn (null defaults to 90f) - The blending options to draw the gradient - - - - Draws a set path with a defined brush - - The Graphics object to draw onto - The path to draw along - The brush to fill the color - - - - Draws a set path with specified colors - - The Graphics object to draw onto - The path to draw along - The area of span the border gradient covers - The color of the gradient at the top - The color of the gradient at the bottom - - - - Draws a set path with specified colors at a given angle - - The Graphics object to draw onto - The path to draw along - The area of span the border gradient covers - The color of the gradient at the top - The color of the gradient at the bottom - The angle which the gradient is drawn (null defaults to 90f) - - - - Draws a set path with specified colors at a given angle with blending properties - - The Graphics object to draw onto - The path to draw along - - The color of the gradient at the top - The color of the gradient at the bottom - The angle which the gradient is drawn (null defaults to 90f) - The blending options to draw the gradient - - - - Draws a Toolstrip button - - The Toolstrip button - The Graphics object to handle - The parent Toolstrip - - - - Draws a Toolstrip button - - The Toolstrip button - The Graphics object to handle - The parent Toolstrip - - - - Draws the Toolstrip background - - The Toolstrip being drawn - The Graphics object to handle - The affected bounds - - - - Draws a Toolstrip split-button - - The Toolstrip split-button - The Graphics object to handle - The parent Toolstrip - - - - Draws the Statusbar background - - The Statusbar being drawn - The Graphics object to handle - The affected bounds - - - - Draws a Menustrip item - - The Menustrip item - The Graphics object to handle - The parent Toolstrip - - - - Covers the button background rendering - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Applies any and all changes made to the Renderer - - - - - A class designed to be used in the EasyRender master control to customize the look and feel of the base Toolstrip - - - - - Creates a new IToolstrip class for customization - - - - - Creates a new IToolstrip class for customization - - The IToolstrip to import the settings from - - - - Disposes of the IToolstrip class and clears all resources related to it - - - - - Gets or sets the color of the Toolstrip background gradient from the top - - - - - Gets or sets the color of the Toolstrip background gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Toolstrip background - If set to null, the Toolstrip will simply draw the gradient - - - - - Gets or sets the angle which the Toolstrip background will be drawn - - - - - Gets or sets the color of the Toolstrip border gradient from the top - - - - - Gets or sets the color of the Toolstrip border gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Toolstrip border - If set to null, the Toolstrip will simply draw the border - - - - - Gets or sets the angle which the Toolstrip border will be drawn - - - - - Gets or sets the curve of the border of the Toolstrip - - - - - Imports the settings from a previous or pre-defined IToolstrip and applies it to the current - - The IToolstrip to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - - - - - - Creates a new IToolstripControls class for customization - - - - - Disposes of the IToolstripControls class and clears all resources related to it - - - - - Gets or sets the color of the Toolstrip seperator on the dark side - - - - - Gets or sets the color of the Toolstrip seperator on the light side - - - - - Gets or sets the height of the Toolstrip seperator control - - - - - Gets or sets the color of the grip dots/line at the top - - - - - Gets or sets the color of the grip shadow - - - - - Gets or sets in what mode the grip will be drawn - - - - - Gets or sets the distance, in pixels, between each grip dot - - - - - Gets or sets the size of the dots or lines for the grip - - - - - Imports the settings from a previous or pre-defined IToolstripControls and applies it to the current - - The IToolstripControls to import the settings from - - - - - - - - - Creates a new IButton class for customization - - - - - Creates a new IButton class for customization - - The IButton to import the settings from - - - - Disposes of the IButton class and clears all resources related to it - - - - - Gets or sets the color of the Button background at the top, when hovered over - - - - - Gets or sets the color of the Button background at the bottom, when hovered over - - - - - Gets or sets the color of the Button background at the top, when clicked - - - - - Gets or sets the color of the Button background at the bottom, when clicked - - - - - Gets or sets the blending that will occur when rendering the Button background - If set to null, the Button will simply draw the gradient - - - - - Gets or sets the angle which the Button background will be drawn - - - - - Gets or sets the color of the Button border gradient from the top - - - - - Gets or sets the color of the Button border gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Button border - If set to null, the Button will simply draw the border - - - - - Gets or sets the angle which the Button border will be drawn - - - - - Gets or sets the color of the inside border - - - - - Gets or sets when to apply the rendering ("Normal" does not apply here) - - - - - Gets or sets the curve of the border of the Button - - - - - Imports the settings from a previous or pre-defined IButton and applies it to the current - - The IButton to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - - - - - - Creates a new IButton class for customization - - - - - Creates a new IButton class for customization - - The IButton to import the settings from - - - - Disposes of the IButton class and clears all resources related to it - - - - - Gets or sets the color of the Button background at the top, when hovered over - - - - - Gets or sets the color of the Button background at the bottom, when hovered over - - - - - Gets or sets the blending that will occur when rendering the Button background - If set to null, the Button will simply draw the gradient - - - - - Gets or sets the angle which the Button background will be drawn - - - - - Gets or sets the color of the Button border gradient from the top - - - - - Gets or sets the color of the Button border gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Button border - If set to null, the Button will simply draw the border - - - - - Gets or sets the angle which the Button border will be drawn - - - - - Gets or sets the color of the inside border - - - - - Gets or sets when to apply the rendering ("Normal" and "Click" do not apply here) - - - - - Gets or sets the curve of the border of the Button - - - - - Imports the settings from a previous or pre-defined IDropDownButton and applies it to the current - - The IDropDownButton to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - - - - - - Creates a new ISplitButton class for customization - - - - - Disposes of the ISplitButton class and clears all resources related to it - - - - - Gets or sets the color of the Button background at the top, when hovered over - - - - - Gets or sets the color of the Button background at the bottom, when hovered over - - - - - Gets or sets the color of the Button background at the top, when clicked - - - - - Gets or sets the color of the Button background at the bottom, when clicked - - - - - Gets or sets the blending that will occur when rendering the Button background - If set to null, the Button will simply draw the gradient - - - - - Gets or sets the angle which the Button background will be drawn - - - - - Gets or sets the color of the Button border gradient from the top - - - - - Gets or sets the color of the Button border gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Button border - If set to null, the Button will simply draw the border - - - - - Gets or sets the angle which the Button border will be drawn - - - - - Gets or sets the color of the inside border - - - - - Gets or sets when to apply the rendering ("Normal" does not apply here) - - - - - Gets or sets the curve of the border of the Button - - - - - Gets or sets when to display the drop-down arrow - - - - - Gets or sets the color of the drop-down arrow - - - - - Imports the settings from a previous or pre-defined ISplitButton and applies it to the current - - The ISplitButton to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - - - - - - Creates a new IPanel class for customization - - - - - Disposes of the IButton class and clears all resources related to it - - - - - Gets or sets the color of the gradient at the top of the content panel - - - - - Gets or sets the color of the gradient at the bottom of the content panel - - - - - Gets or sets whether each panel inherits the shading from the content panel - - - - - Gets or sets the angle which the background gradient is drawn - - - - - Gets or sets the blend of the background - - - - - Gets or sets a mode to render the background in - - - - - - - - - - Creates a new IStatusBar class for customization - - - - - Disposes of the IButton class and clears all resources related to it - - - - - Gets or sets the color of the gradient of the background at the top - - - - - Gets or sets the color of the gradient of the background at the bottom - - - - - Gets or sets the blending that will apply to the background - - - - - Gets or sets the angle which the background gradient will be drawn - - - - - Gets or sets the color of the dark border - - - - - Gets or sets the color of the light border - - - - - Gets or sets the color of the grip at the top-most - - - - - Gets or sets the color of the grip at the bottom-most - - - - - Gets or sets the spacing of the grip blocks - - - - - Imports the settings from a previous or pre-defined IStatusBar and applies it to the current - - The IStatusBar to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - A class designed to be used in the EasyRender master control to customize the look and feel of the base Menustrip - - - - - Creates a new IToolstrip class for customization - - - - - Creates a new IMenustrip class for customization - - The IMenustrip to import the settings from - - - - Disposes of the IMenustrip class and clears all resources related to it - - - - - Gets or sets the color of the menu-strip border (dark) - - - - - Gets or sets the color of the menu-strip border (light) - - - - - Gets or sets how the background of the menu-strip is inherited - - - - - If inheritence is set to none, the color of the background gradient at the top - - - - - If inheritence is set to none, the color of the background gradient at the bottom - - - - - If inheritence is set to none, the blending option for the background - - - - - Gets or sets the color of the margin gradient at the left - - - - - Gets or sets the color of the margin gradient at the right - - - - - Gets or sets the color of the margin border (displayed to the right) - - - - - Gets or sets the color of the root menu-strip button background when it is selected - - - - - Gets or sets the color of the root menu-strip button border when it is selected - - - - - Gets or sets the color of the seperator dark color - - - - - Gets or sets the color of the seperator light color - - - - - Gets or sets the inset position of the seperator from the left - - - - - Gets the class that handles the look and feel of the menu-strip items - - - - - Imports the settings from a previous or pre-defined IMenustrip and applies it to the current - - The IMenustrip to import the settings from - - - - Sets the blending for the background to it's default - - - - - Defines when to show an arrow - - - - - - - - - - - - - - - - - - - - Defines when to use a blend property - - - - - Use the blend when the object is drawn - - - - - Use the blend when the object is hovered over - - - - - Use the blend when the object is clicked - - - - - Use the blend when the object is checked - - - - - Always use the blend regardless of the state of the object - - - - - Defines a method of drawing a grip on a control - - - - - Draws the grip as a set of dots - - - - - Draws the grip as two lines - - - - - Does not draw the grip at all, but the object remains moveable - - - - - Defines a specific type of button to search by - - - - - - - - - - - - - - - - - - - - - - - - - Defines a method for background or object inheritence - - - - - - - - - - - - - - - Defines a method of rendering - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 主菜单 - - - - - 背景透明的工具条 - - - - - 银白色至白色渐变 - - - - - 白色至银白色渐变 - - - - - - - - - - - - - - - 当前工作区窗体所关联并激活的工具栏 - - - - - 模拟运行时的外观 - - - - - Represents the visual state of an image list view item. - - - - - 没有任何选择状态，处于一般正常状态 - - - - - 项处于选中状态 - - - - - 鼠标滑过 - - - - - 控件的高度根据内容自动调整，忽略外部设置 - - - - - 边框宽度 - - - - - 文本和description文本之间的间距 - - - - - 最大显示的项数 - - - - - - - - - - 是否显示说明字段，此属性不影响弹出面板是否显示 - 弹出面板是否显示由DescriptionMember是否设置决定 - - - - - - - - - - - - - - - 下拉列表的布局模式 - - - - - - - - - - 是否允许空 - - - - - - - - - - 测量当前控件应该的高度 - - - - - - 整个可用的绘图表面 - - - - - 右边按钮的绘图表面 - - - - - 绘制边框 - - - - - - 绘制背景 - - - - - - 绘制文本 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 当前热点项生改变 - - - - - - - - - - - - - - - - - - - - - 通过外能事件获取用于绘制项的文本 - - - - - - - - - - - - - - - - - - - - - - - - - - 标题 - - - - - 验证失败时是否需要高亮显示（改变背景色） - - - - - - - - - - - - - - - - - - - - - - 排序箭头开始颜色 - - - - - 排序箭头开始颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 控件的背景画布颜色 - 因为控件的边框和过度色都有依靠改变透明度实现渐变，所以一个白色的底版就非常重要 - 使过度色不受控件本身背景色的影响，光不绘制背景不行，要刷上白色背景 - - - - - 控件背景色 - - - - - - - - - - - - - - - 边框颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Represents the visual state of an image list view item. - - - - - 没有任何选择状态，处于一般正常状态 - - - - - 项处于选中状态 - - - - - 该项具有输入焦点 - - - - - 鼠标滑过 - - - - - - - - - - The item is not visible. - - - - - The item is partially visible. - - - - - The item is fully visible. - - - - - 布局方式 - - - - - 标准布局 - - - - - 使项带有描述的布局 - - - - - 双击项事件参数 - - - - - - - - - - - - - - - - 项被删除事件参数 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 为项绘制带有描述信息的渲染器 - - - - - 字的高度是否已初始化 - 在第一次绘制时，测量文本的高度 - - - - - - - - - - - 默认布局引擎，以类似微软ListView的方式按行排列项 - - - - - 框选的最短开始长度 - - - - - 框选时滚动条的自动滚动速度 - - - - - 用于鼠标框选时，框出了控件中项的显示范围时，自动滚动滚动条 - - - - - 自动滚动时，滚动值 - - - - - 是否处于框选状态中 - - - - - 内框offset，内框offset是绝对相对于滚动条的 - - - - - 整个可显示项的边界的offset，包括上下padding部分 - - - - - 鼠标按下时项区域边界的offset，即 _itemsAreaOffset - 用于框选时，跨越可视部队画框 - - - - - 当前所能显示的最大行数 - - - - - - - - - - Gets whether the shift key is down. - - - - - Gets whether the control key is down. - - - - - - - - - - - - - - - - - - - - - - - - - 没有任何项 - - - - - 没有任何项处于可显示状态 - - - - - 整个控件区域 - - - - - 整个可用于绘制项的可视区域 - 去除左右Padding部分，去除滚动条 - - - - - 用于绘制项的区域 - 考虑边距间隔大小和滚动条区域 - - - - - 项的尺寸 - 不放在ListView本身中定义而是放在LayoutManager中定义，是因为不同的布局方式 - 可能会是带长宽的Size做为itemSize，比如平铺的方式 - - - - - 项周围的边距 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 更新整个布局引擎的状态 - - - - - 判断指定的项是否处于可见状态 - - - - - - - 获取项的呈现区域 - - - - - - - - - - - - - - - - - - - - 获取当前所有可见项 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Calculates the maximum number of rows and columns - that can be fully displayed. - - - - - 计算当前可见项的index范围 - - - - - 更新滚动条状态 - - - - - 创建框选框 - - - - - - 根据矩形区域选择项 - - - - - - 应用导航键，如上下左右，返回应用导航键之后的项的坐标 - - - - - 使指定下标的项处于可见状态 - - - - - - 默认渲染器，不绘制项的实际内容，但是绘制DEBUG信息 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 用于子类重写时删除相应的缓存 - - - - - - 绘制项的背景 - - The System.Drawing.Graphics to draw on. - The client coordinates of the item area. - - - - 绘制最终的前景 - - - - - - 绘制选择边框 - - The System.Drawing.Graphics to draw on. - The client coordinates of the selection rectangle. - - - - 绘制项的边框 - - - - - - - - 绘制项 - - - - - - - 绘制项的背景 - - - - - - - 绘制项的内容 - - - - - - - - 绘制背景 - - - - - - 绘制当前所有可见项 - - - - - - Renders the selection rectangle. - - The graphics to draw on. - - - - 默认渲染器，以类似微软ListView的方式按行绘制项，只绘制简单的文本 - - - - - 字的高度是否已初始化 - 在第一次绘制时，测量文本的高度 - - - - - - - - - - - - - - - - - - - - - - - - - 项的背景色 - - - - - 控件背景色 - - - - - 项的边框色 - - - - - 选择框颜色 - - - - - 选择框的边框色 - - - - - 当控件具有焦点时选定项的背景色 - - - - - - - - - - 控件失去焦点时选定项的背景色 - - - - - - - - - - 热点项的背景色 - - - - - - - - - - 图像内边框颜色 - - - - - 图像外边框颜色 - - - - - - - - - - Creates a control with a border. - - - - - Specifies that the control has a border with a sunken edge. - - - - - - - - - - 是否需要在调用 ResumeLayout 时重绘 - - - - - 为项扩展的用于呈现的属性 - - - - - Gets whether the shift key is down. - - - - - Gets whether the control key is down. - - - - - 鼠标左键是否处于按下状态 - - - - - 鼠标右键是否处于按下状态 - - - - - 鼠标最后点击的位置 - - - - - 当前鼠标经过的项 - - - - - - - - - - - - - - - 配色方案 - - - - - 当前布局中项的高度 - - - - - - - - - - 是否没有任何项 - - - - - - - - - - 获取当前具有输入焦点的项 - - - - - 默认的用于呈现为项中文本的Property - - - - - - - - - - 更改了选择的项 - - - - - 双击项 - - - - - - 请求在下次调用 ResumeLayout 时重绘 - - - - - 获取当前选中的所有项 - - - - - - - - - - - - 设置扩展属性供特定LayoutEngine使用 - 如果指定的 ExtendMember 已存在，覆盖之 - 用String.Empty 或 null 做为 propertyName传入，表示删除指定的 member - - - - - - - - - - - - - - - - - - - - - 恢复正常的布局逻辑。 - - - - - - - - - - - 临时挂起控件的布局逻辑。 - - - - - - - - - - 获取当前选中项所绑定的对象 - 如果没有选中项，返回null，如果选中多项，返回选中项集合中的第一个 - - - - - - 根据指定的绑定项对象 - 设置当前列表中选定的项 - - - - - - 获取当前选中的所有项的绑定对象集合 - 如果当前没有选中任何项，返回空集合 - - - - - - 取消所有项的选择 - - - - - - - - - - - - - - - - 获取创建控件句柄时所需要的创建参数 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 更改了选择的项 - - - - - 双击项 - - - - - 项被删除 - - - - - 通过外能事件获取用于绘制项的文本 - - - - - Represents the color palette of the image list view. - - - - - Gets or sets the background color of the ImageListView control. - - - - - Gets or sets the background color of the ImageListViewItem. - - - - - Gets or sets the background color of alternating cells in Details View. - - - - - Gets or sets the border color of the ImageListViewItem. - - - - - Gets or sets the foreground color of the ImageListViewItem. - - - - - Gets or sets the background gradient color1 of the ImageListViewItem if the control is not focused. - - - - - Gets or sets the background gradient color2 of the ImageListViewItem if the control is not focused. - - - - - Gets or sets the border color of the ImageListViewItem if the control is not focused. - - - - - Gets or sets the fore color of the ImageListViewItem if the control is not focused. - - - - - Gets or sets the background gradient color1 if the ImageListViewItem is hovered. - - - - - Gets or sets the background gradient color2 if the ImageListViewItem is hovered. - - - - - Gets or sets the border color of the ImageListViewItem if the item is hovered. - - - - - Gets or sets the color of the insertion caret. - - - - - Gets or sets the background gradient color1 if the ImageListViewItem is selected. - - - - - Gets or sets the background gradient color2 if the ImageListViewItem is selected. - - - - - Gets or sets the border color of the ImageListViewItem if the item is selected. - - - - - Gets or sets the fore color of the ImageListViewItem if the item is selected. - - - - - Gets or sets the background gradient color1 of the column header. - - - - - Gets or sets the background gradient color2 of the column header. - - - - - Gets or sets the background hover gradient color1 of the column header. - - - - - Gets or sets the background hover gradient color2 of the column header. - - - - - Gets or sets the cells foreground color of the column header text. - - - - - Gets or sets the cells background color if column is selected in Details View. - - - - - Gets or sets the color of the separator in Details View. - - - - - Gets or sets the foreground color of the cell text in Details View. - - - - - Gets or sets the foreground color of alternating cells text in Details View. - - - - - Gets or sets the background color of the image pane. - - - - - Gets or sets the separator line color between image pane and thumbnail view. - - - - - Gets or sets the color of labels in pane view. - - - - - Gets or sets the image inner border color for thumbnails and pane. - - - - - Gets or sets the image outer border color for thumbnails and pane. - - - - - Gets or sets the background color1 of the selection rectangle. - - - - - Gets or sets the background color2 of the selection rectangle. - - - - - Gets or sets the color of the selection rectangle border. - - - - - Initializes a new instance of the ImageListViewColor class. - - - - - Initializes a new instance of the ImageListViewColor class - from its string representation. - - String representation of the object. - - - - Copies color values from the given object. - - The source object. - - - - Represents the default color theme. - - - - - Represents the noir color theme. - - - - - Represents the mandarin color theme. - - - - - Sets the color palette to default colors. - - - - - Sets the color palette to mandarin colors. - - - - - Sets the color palette to noir colors. - - - - - Determines whether all color values of the specified - ImageListViewColor are equal to this instance. - - The object to compare with this instance. - true if the two instances have the same color values; - otherwise false. - - - - Returns a hash code for this instance. - - - A hash code for this instance, suitable for use in - hashing algorithms and data structures like a hash table. - - - - - Returns a string that represents this instance. - - - A string that represents this instance. - - - - - 测试坐标 - - - - - 项的坐标 - - - - - 是否点击了项 - - - - - - - - - - - - - - - - - - - - - - 该项当前的选中状态 - - - - - - - - - - - - - - - - - - - - 所绑定的对象 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 将指定的事件移动到(紧邻)另一个事件之前 - - - - - - - 将指定的事件移动到(紧邻)另一个事件之后 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Modify a WinForms TreeView control to use the new Explorer style theme - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - WM_COPYDATA消息所要求的数据结构 - - - - - - - - - - - - - - - - - - - - - - - - - 通过窗口的标题来查找窗口的句柄 - - - - - - - - 发送 Windows 消息 - - - - - - - - - - 还原 - - - - - 移动 - - - - - 大小 - - - - - 最小化 - - - - - 最大化 - - - - - 关闭 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 发送消息，只能传递一个自定义的消息ID和消息字符串，想传一个结构，但没成功 - - 目标进程名称，如果有多个，则给每个都发送 - 自定义数据，可以通过这个来决定如何解析下面的strMsg - 传递的消息，是一个字符串 - - - - 接收消息，得到消息字符串 - - System.Windows.Forms.Message m - 接收到的消息字符串 - - - - - - - - - 最大圆角半径 - - - - - 最小矩形边长，用于自动处理圆角大小 - - - - - 绘制一个圆角矩形. - - 当前屏幕的图形对象 - 画笔 - 矩形左上角X坐标 - 矩形左上角Y坐标 - 矩形右下角X坐标 - 矩形右下角Y坐标 - 圆角的半径长度 - - - - 绘制一个圆角矩形. - - 当前屏幕的图形对象 - 画笔 - 要绘制的矩形对象 - 圆角的半径长度 - - - - 绘制一个圆角矩形. - - 当前屏幕的图形对象 - 画笔 - 要绘制的矩形对象 - - - - 填充一个圆角矩形. - - 当前屏幕的图形对象 - 笔刷 - 矩形左上角X坐标 - 矩形左上角Y坐标 - 矩形右下角X坐标 - 矩形右下角Y坐标 - 圆角的半径长度 - - - - 填充一个圆角矩形. - - 当前屏幕的图形对象 - 笔刷 - 要填充的矩形 - 填充区域针对矩形的缩进距离 - 圆角的半径长度 - - - - 填充一个圆角矩形. - - 当前屏幕的图形对象 - 笔刷 - 要填充的矩形 - - - - 使图片单色化 - - - - - - - 获取颜色 - - - - - - - - - - - - - 颜色变化时激发 - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - + + + + RaUIV4 + + + + + 基于XML实现的权限类 + + + + + 用户名 + + + + + 用户id + + + + + 密码 + + + + + 权限控制Id + + + + + 用户备注 + + + + + 是否是管理员权限 + + + + + 是否是超级管理员权限 + + + + + 设置权限 + + 权限名称 + 权限值 + 返回是否设置成功 + + + + 获取权限 + + 权限名称 + 默认权限值 + 返回权限值 + + + + 获取权限 + + 权限名称 + 返回权限值 + + + + 批量导入权限 + + 权限相关的内容 + 返回是否执行成功 + + + + 导出权限 + + 返回导出文本 + + + + 清除所有权限 + + 返回是否执行成功 + + + + 汉字转拼音静态类,包括功能全拼和缩写，方法全部是静态的 + + + + + 汉字的机内码数组 + + + + + 机内码对应的拼音数组 + + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(首拼) + + 汉字字符串 + 转换后的拼音(首拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 用指定字符分隔 + 转换后的拼音(全拼)字符串 + + + + 汉字转拼音缩写 + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串) (小写) (空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (大写) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串)(大写)(空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 字符串操作类 + + + + + 字符串转Base64 + + + + + + + Base64转字符串 + + + + + + + 转换指定字符串为布尔类型 + + + + + 转换指定字符串为Double类型 + + + + + 已重载.计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 已重载.计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定布尔类型为Int类型,true为1，false为0 + + + + + 判断指定字符串是否是布尔类型 + + + + + 判断指定字符串是否是Double类型 + + + + + 判断指定字符串是否是Int类型 + + + + + 根据年月日转换成日期 + + + + + + + + + 追加字符 + + + + + 获取2个字符串中间的内容,point1为空表示从首位开始算，point2为空表示算到结尾。 + + + + + 判断字符串是否只包含数字或英文 + + + + + + + 判断字符串是否只包含英文 + + + + + + + 判断字符串是否只包含数字 + + + + + + + 判断字符串是否匹配,支持?*通配符 + + 待匹配的字符串 + 匹配的通配符 + + + + + 通配符替换 + + + + + + + + + 支持忽略大小写的替换功能 + + + + + 是否忽略大小写 + + + + + 获取匹配的内容 + + + + + + + + + Json扩展 + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 对变量的拓展 + + + + + 替换文本(忽略大小写) + + + 需要替换的内容 + 替换后的内容 + + + + + 替换文本(忽略大小写),可支持通配符 + + + + + 是否是通配符表达式,不是，则普通替换，忽略大小写，是，则启用通配符替换 + + + + + 将颜色转换为Html颜色格式 + + + + + + + 支持忽略大小写的替换文本功能 + + + + + 是否忽略大小写 + + + + + 获取符合要求的第一个结果 + + + + 是否是正则 + + + + + 查找字符串,忽略大小写 + + + + + + + + + 查找字符串,忽略大小写 + + + + + + + + 判断字符串是否是数字或英文 + + + + + + + 判断字符串是否是英文 + + + + + + + 判断字符串是否是数字(不同于IsInt,本函数是判断字符串是否只含有数字,对字符串长度没有限制) + + + + + + + 是否在指定范围内 + + + + + + + + + 是否在指定范围内 + + + + + + + + + 转换指定字符串为Int类型 + + + 最小值 + 最大值 + 如果字符串不在范围内，则使用本默认值 + + + + + 转换指定布尔类型到Int类型,true为1，false为0 + + + + + + + 将指定类型转换成整型 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将指定类型转换成整型 + + + + + + + 将指定类型转换成长整型,如果时间时间类型,则转换为Unix时间戳 + + + + + + + + 转换为Unix时间戳 + + + + + + + 转换为Js时间戳 + + + + + + + 转换为Unix时间戳 + + + + + + + 将指定类型转换成长整型 + + + + + + + 转换指定类型为Double类型 + + + + + + + + 转换指定类型为Double类型 + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + + 转换DateTime类型到日期时间字符串(例如 2000-01-01 08:08:08) + + + + + + + 转换DateTime类型到日期字符串(例如 2000-01-01) + + + + + + + 转换DateTime类型到日期星期字符串(例如 2000-01-01 星期六) + + + + + + + 转换DateTime类型到Unix时间戳 + + + + + + + 转换Unix时间戳到DateTime类型 + + + + + + + 判断字符串是否与内容匹配 + + + + + + + + 将变量值转换成Double类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换到文件大小字符串 + + + + + + + 转换到文件大小字符串 + + + + + + + 转换指定类型为Decimal类型 + + + + + + + + 将变量值转换成Decimal类型 + + + + + + + 将变量值转换成Decimal类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换指定类型为DateTime类型 + + + + + + + + 将变量值转换成DateTime类型 + + + + + + + 转换指定类型为布尔类型 + + + + + + + 追加字符 + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + + + + 判断指定字符串是否是Int类型 + + + + + + + 判断指定字符串是否是Double类型 + + + + + + + 判断是否是布尔类型 + + + + + + + 将字符串转换为Base64类型 + + + + + + + 判断字符串是否在指定长度 + + + + + + + + + 判断能否转换成日期格式 + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 大文件与批量文件操作类,支持中途取消操作,本类需要实例化操作 + + + + + 传输进度 + + 当前传输完成的值 + 全部值,为-1表示无法获取 + 当前传输的百分比,为-1表示无法获取 + + + + 传输进度 + + + + + 取消事件 + + + + + 大文件按流复制文件,支持自动创建目标文件夹。 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + + + + + 复制文件夹到目标文件夹,不支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持中途取消 + + 源文件夹 + 目标文件夹 + 初始的文件数量 + 总数量,如果不计算,则使用-1 + 操作的数量,包含成功的和失败的 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 获取文件夹中的文件数量 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 获取文件夹的大小 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 文件信息 + + + + + 获取版本号 + + + + + 获取版本号 + + + + + + + 根据版本字符串输出double类型的版本号 + + + + + + + + 比较两个版本号大小 + + + + oldVer小于newVer,返回1,大于则返回-1,相等返回0,不支持则返回-1000 + + + + 从字符串中提取版本号 + + + + + + + 比较版本号 + + + + + + old小于new,返回1,大于则返回-1,相等返回0 + + + + 判断是否是管理员方式运行 + + + + + + Hosts操作类 + + + + + 获取并转换hosts内容 + + hosts内容 + + + + + 获取hosts并转换hosts内容 + + + + + + 追加内容到hosts里 + + 要追加的内容列表，每一行为ip 域名的格式 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + write为true,追加内容到hosts里;为false,判断是否需要追加 + + 要追加的内容列表，每一行为ip 域名的格式 + 是否要写入,如果为false,则只判断是否需要追加,而不写入Hosts文件 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + 要追加的内容 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + ip地址 + 域名 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 从hosts文件里删除内容 + + 要删除的内容 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + 从hosts文件里删除内容 + + ip地址 + 域名 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + Host信息 + + + + + IP + + + + + 域名 + + + + + 注释 + + + + + 是否要删除 + + + + + Ini操作类 + + + + + 写入Ini + + + + + + + + + + 获取Ini + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 获取所有节点名称(Section) + + 存放节点名称的内存地址,每个节点之间用\0分隔 + 内存大小(characters) + Ini文件 + 内容的实际长度,为0表示没有内容,为nSize-2表示内存大小不够 + + + + 编码 + + + + + Ini操作类 + + + + + + 根据section取所有key和值 + + + + + + + 读取INI文件中指定INI文件中的所有节点名称(Section) + + 所有节点,没有内容返回string[0] + + + + 读取INI文件 + + 段，格式[] + 键 + 返回byte类型的section组或键值组 + + + + 根据section取所有key + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入Ini + + + + + + + + 读取Ini + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + + + 写入ini + + + + + + + + + 删除Ini的Key + + + + + + + 删除Ini节点 + + + + + + 控件信息 + + + + + id + + + + + 控件对象 + + + + + 控件值类型 + + + + + 默认值 + + + + + 值类型 + + + + + 默认 + + + + + 取列表顺序值 + + + + + 取当前选择的列表值 + + + + + 取对象值 + + + + + 保存的设置类型 + + + + + Ini + + + + + XML + + + + + 对象值 + + + + + 显示的文本 + + + + + 图片序号 + + + + + id + + + + + Tag值 + + + + + 显示文本值 + + + + + + 星期数据 + + + + + 一周的开始时间 + + + + + 一周的结束时间 + + + + + 图片类型 + + + + + Bmp图片 + + + + + Jpeg图片 + + + + + Png图片 + + + + + Gif动态图片 + + + + + Tiff图片 + + + + + 文件操作类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 永久删除单个文件。 + + 永久删除的文件名 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除一组文件。 + + 字符串数组，表示一组文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + + + + + 移动一个文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 移动一组文件到指定的路径下 + + 要移动的文件名数组 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制一组文件到指定的路径 + + 要复制的文件名数组 + 复制到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 大文件多次复制文件 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 重命名一个文件为新名称，建议您使用更方便的Microsoft.VisualBasic.FileSystem.ReName();替换该方法 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 删除单个或多个文件 + + 删除的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动或复制一个或多个文件到指定路径下 + + 操作类型，是移动操作还是复制操作 + 要移动或复制的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 移动到的目的位置 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 如果指定文件夹不存在，则创建文件夹 + + + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 解释错误代码 + + 代码号 + 返回关于错误代码的文字描述 + + + + 运行文件 + + + + + + + + /运行文件 + + + + + + + + + 运行程序 + + + + + + + 打开文件 + + + + + + + 打开文件夹并定位文件 + + + + + + + 打开网址 + + + + + + + 判断是否为空的文件夹 + + + + + + + 文件或文件夹是否存在 + + + + + + + 判断文件名是否有效 + + + + + + + 转换到有效文件名 + + + + + + + 追加日志 + + + + + + + 追加文件 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + + 写入所有文本行到文件,如果文件夹不存在，会自动创建 + + + + + + + + 写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + + 以UTF-8格式写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + 从文件中加载图片,使用本方法，不会导致图片文件被占用。 + + + + + + 获取文件大小 + + + + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 获取文件大小字符串 + + + + + + + 根据文件大小字符串获取长整型表示的文件大小 + + + + + + + 获取文件大小字符串 + + + + + + + 复制内容到剪切板 + + + + + + 添加某个控件为支持拖放属性 + + + + + + + 使管理员方式运行时支持拖放 + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 获取绝对路径 + + + + + + + 获取相对路径 + + + + + + + 获取图标 + + + + + + + + + + + + + + 销毁图标 + + + + + + + 获取文件图标 + + + + + + + + + + 图片相关API + + + + + 从文件或Url中加载图片,使用本方法，不会导致图片文件被占用。 + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 以逆时针为方向对图像进行旋转 + + 位图流 + 旋转角度[0,360](前台给的) + + + + + 是否包括透明像素 + + + + 操作失败 + + + + 矩形边界 + + + + + + + + 计算水印位置 + + + + + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 计算最大字体大小 + + + + + + + + + + + 计算旋转矩形大小 + + + + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + + + + + 缩放 + + + 宽 + 高 + 插值算法 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 缩放 + + + 宽 + 高 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 根据原边长和新边长计算绘制的起始点坐标 + + + + + + + + 获取缩放模式 + + + + + + 是否裁剪图片 + + + + + 裁剪或填充 + + + + + 背景色 + 插值算法 + + Image 不能为 null + 操作失败 + + + + 裁剪 + + + 宽度 + 高度 + + 返回裁剪后的图片 + Image 不能为 null + 新的图片尺寸的宽度和高度必须大于零 + 操作失败 + + + + 调整宽度 + + + + + + + + 根据最大宽度调整图片尺寸 + + + 最大宽度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最大高度调整图片尺寸 + + + 最大高度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 调整高度 + + + + + + + + 调整图片大小 + + + + + + + + + + 调整图片大小 + + + + + + + + + + + 调整图片大小 + + + + + + + + + + + + + 转换Image为Icon + + 要转换为图标的Image对象 + 当image为null时是否返回null。false则抛空引用异常 + + + + + 缩放模式 + + + + + 宽度优先(不裁剪宽) + + + + + 高度优先(不裁剪高) + + + + + 水印位置 + + + + + 左上角 + + + + + 中上 + + + + + 右上角 + + + + + 左中 + + + + + 居中 + + + + + 右中 + + + + + 左下角 + + + + + 中下 + + + + + 右下角 + + + + + 全屏平铺 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + 音频播放类 + + + + + 临时音频文件 + + + + + 父窗口句柄 + + + + + 声音标签 + + + + play synchronously (default) + + + play asynchronously + + + silence (!default) if sound not found + + + pszSound points to a memory file + + + loop the sound until next sndPlaySound + + + don’t stop any currently playing sound + + + Stop Playing Wave + + + don’t wait if the driver is busy + + + name is a registry alias + + + alias is a predefined id + + + name is file name + + + name is resource name or atom + + + + 音频播放类 + + embedded music file + 临时保存的文件位置 + 父窗口句柄 + + + + 音频播放类 + + 要播放的音频位置 + 父窗口句柄 + + + + 音频播放类 + + + 父窗口句柄 + + + + 播放音频 + + + + + + 播放音频 + + + + + 关闭音频 + + + + + XML操作类 + + + + + XML操作类 + + + + + 从XML文本中加载数据 + + + + + + 从指定的XML文本中加载 + + XML文本 + 如为1，表示加载成功，为0为失败 + + + + 载入空的XML文档 + + 如为1，表示加载成功，为0为失败 + + + + 从指定的文件中加载 + + XML文件路径 + 如为1，表示加载成功，为0为失败 + + + + 保存到指定文件中 + + 文件路径 + 如为1，表示保存成功，为0为失败 + + + + 判断节点是否存在 + + 属性名 + 属性值 + 返回1，表示存在，其它表示不存在 + + + + 定位节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 定位节点,如果找不到节点，就新建一个节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 + + 返回第一个符合要求的结果 + + + + 定位设置节点 + + 返回第一个符合要求的结果 + + + + 在节点后插入数据 + + + + + + + 在节点前插入数据 + + + + + + + 获取节点数量 + + 属性名 + 属性值 + 返回符合要求的结果数量 + + + + 获取节点数量 + + 返回符合要求的结果数量 + + + + 获取节点数量 + + 属性名 + 属性值 + + + + 返回符合要求的结果数量 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 读取指定节点的值(string) + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 获取属性值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取所有的节点名称 + + + + + + 读取指定节点的值(string) + + + + + + + + 读取指定节点的值(int) + + + + + + + + 读取指定节点的值(decimal) + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 获取XML文件的根元素 + + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 新增节点 + + + + + + + + 新增节点并定位到新节点 + + + + + + + + 新增设置节点并定位 + + + + + + 在指定节点前新增节点并定位到新节点 + + + + + + + + + 获取当前节点 + + + + + + 删除节点 + + + + + + 获取XML文本 + + + + + + 获取XML文本 + + + + + + 获取文本 + + + + + + 获取文本 + + + + + + 文件时间 + + + + + 创建时间 + + + + + 最后修改时间 + + + + + 访问时间 + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 取得一个文本文件的编码方式。如果无法在文件头部找到有效的前导符，Encoding.Default将被返回。 + + 文件名。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + + + + + 取得一个文本文件的编码方式。 + + 文件名。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 通过给定的文件流，判断文件的编码类型 + + 文件流 + 文件的编码类型 + + + + 判断是否是不带 BOM 的 UTF8 格式 + + + + + + + 数据库操作扩展 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据,如果没有数据,则返回null + + + + + + + 获取第一行第一列的值 + + + + + + + 获取第一张表的指定行数据 + + + 指定第几行 + + + + + 对鼠标或键盘的自动化操作 + + + + + 鼠标左键 + + + + + 鼠标中键 + + + + + 鼠标右键 + + + + + 模拟键盘按键 + + + + 按下还是抬起 + + + + 鼠标滚轮 + + + + + + + + 鼠标移动 + + + + + + + + 自定义鼠标按下或抬起 + + + + + + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 粘贴文本 + + + + + + 获取指定句柄的大小及位置 + + + + + + + + 设置指定句柄的大小 + + + + + + + 判断鼠标位置是不是在指定的矩形中 + + + + + + + + 判断2张图是否相似度超90 + + + + + + + + /获取2种颜色的相似度,范围为0~100 + + + + + + + + 新模态窗体 + + + + + 设置窗体返回的结果值，并关闭窗体。 + + 当前窗体 + 模态变量 + 防止 + + + + 窗体返回的结果事件 + + + + + + + 当打开的窗体返回结果时激发 + + + + + 窗体返回的状态 + + + + + 实例化类 + + 父窗体,如果为null,则取桌面为父窗体 + + + + + 获取最顶级的父窗口 + + + + + + 显示新模态窗体,会暂时禁用父窗体,关闭当前窗体后,父窗体会恢复。 + + + + + 只运行一个实例,打开后,所有窗体都依然有效。 + + + + + + 显示窗体 + + 显示的位置 + + + + 显示在父窗体中间 + + + + + 窗体显示位置 + + + + + 右上角 + + + + + 顶部中间 + + + + + 顶部右边 + + + + + 中间 + + + + + 左下角 + + + + + 底部中间 + + + + + 右下角 + + + + + 父窗体居中 + + + + + + + + + + + + + + + + + + + + + + + + + 设置线程数量 + + + + + 要计算的总数量 + + + + + 每个线程要计算的数量 + + + + + + + + + + 当前已使用的时间 + + + + + + + 线程数量 + 要计算的事务数量 + + + + + + + + + + + + + + + + + + + + + + + 多线程计算时激发 + + + + + 在所有线程执行完毕后发生 + + + + + 在线程执行完毕后发生,最后一个执行完毕的线程将不收到本事件通知 + + + + + 进程相关接口 + + + + + 获取进程路径 + + + + + + + 获取进程路径 + + + + + + + 获取命令行 + + + + + + + 获取命令行 + + + + + + + 运行库检测类 + + + + + 获取产品状态 + + + + + + + 判断是否已安装VC运行库 + + + + + + 判断是否已安装VC运行库 + + + + + + 安装状态 + + + + + 组件禁用 + + + + + 配置数据已损坏 + + + + + 安装已暂停或正在进行 + + + + + 从源运行，源不可用 + + + + + 返回缓冲区溢出 + + + + + 无效的参数传递给该函数。 + + + + + 不公布或者未安装该产品。 + + + + + 损坏 + + + + + 该产品已公布但尚未安装。 + + + + + 正在移除的组件（操作状态，不可设置） + + + + + 不同的用户安装该产品。 + + + + + 安装在本地驱动器上 + + + + + 从源代码、CD或网络运行 + + + + + 为当前用户安装该产品。 + + + + + 安装的版本,是x86还是x64，还是全部安装了 + + + + + 判断32位和64位运行库是否已安装 + + + + + 判断32位运行库是否已安装 + + + + + 判断64位运行库是否已安装 + + + + + 判断是否已安装VC2005运行库 + + + + + + 判断是否已安装VC2005SP1运行库 + + + + + + 判断是否已安装VC2008运行库 + + + + + + 判断是否已安装VC2008SP1运行库 + + + + + + 判断是否已安装VC2010运行库 + + + + + + 判断是否已安装VC2010SP1运行库 + + + + + + 判断是否已安装VC2012运行库 + + + + + + 判断是否已安装VC2013运行库 + + + + + + 判断是否已安装VC2015或以上运行库 + + + + + + 判断是否已安装VC2017运行库或以上运行库 + + + + + + 判断是否已安装VC2019运行库或以上运行库 + + + + + + 判断是否已安装VC2022运行库或以上运行库 + + + + + + 判断当前系统是否安装了WebView2组件 + + + + + + 判断当前系统是否安装了.NET 4.8 + + + + + + 日期时间的操作类 + + + + + 获取当前是周几,周一到周日，分别是1-7. + + + + + + + 获取当前是周几,1-7，分别是返回一到日. + + + + + + + 获取当前是周几,输入日期，根据周几，分别是返回一到日. + + + + + + + 获取一周的开始和结束,开始时间为第一天的0点，结束时间以最后一天的0点为结束时间 + + + + + + + 获取2个日期相差几周 + + + + + + + + 获取2个日期相差几个月 + + + + + + + + 获取一个月的开始 + + + + + + + 判断是否在同一个星期。 + + + + + + + + 判断是否在同一个月。 + + + + + + + + 判断是否在同一天 + + + + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + 是否显示秒 + + + + + 将秒数显示成中文表达式 + + + + + + + 计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 将c# DateTime时间格式转换为Unix时间戳格式 + + 时间 + long + + + + 时间戳转为C#格式时间 + + + + + + + 时间戳转为C#格式时间 + + + + + + + 将c# DateTime时间格式转换为js时间戳格式 + + 时间 + long + + + + JS时间戳转为C#格式时间 + + + + + + + JS时间戳转为C#格式时间 + + + + + + + 根据年月日转换成日期 + + + + + + + + + 根据日期和时间转换成日期时间 + + + + + + + + 将时间转换成当前分钟开始的时间 + + + + + + + 将时间转换成当前秒钟开始的时间 + + + + + + + 当前时间在这一天里的秒数 + + + + + + + 窗体操作类 + + + + + 设置Comobox的行间距 + + + + + + + 移除关闭按钮。返回值，非零表示成功，零表示失败。 + + 窗口的句柄 + 是否成功 + + + + 把窗体放到最前 + + + + + + 显示窗体 + + + + + + + + 设置窗体是否置顶 + + + + + + + 显示没有焦点的窗口 + + + + + + 根据句柄获取窗口文本 + + + + + + + 根据句柄获取窗口类 + + + + + + + 获取当前活动的窗口句柄 + + + + + + 获取当前前台的窗口句柄 + + + + + + 设置为当前活动窗口 + + + + + + + 根据窗口句柄来获得进程id + + + + + + + 显示窗体 + + + + + + 设置窗体父窗体为桌面,不会随着显示桌面而最小化,但无法设置窗体透明度 + + + + + + 结束进程 + + + + + + + 打开窗体,只打开一个实例(非模态) + + + + + + + 将窗体植入到容器控件中 + + + 作为窗体容器的控件 + + + + + 重新调整窗体大小以适配容器大小 + + + 作为窗体容器的控件 + + + + + 设置注册表操作,部分功能需要管理员权限 + + + + + 访问的注册表位置(64位还是32位) + + + + + 访问的注册表节点 + + + + + 判断注册表项是否存在 + + + + + + + + + 删除注册表键(如果存在子键,子键将一并被删除) + + + + + + + + + + 删除注册表键值 + + + + + + + + + + 获取注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + 启动命令 + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + + + + + 把指定文件设置为开机启动或取消开机启动 + + 是否开机启动 + 开机启动名称 + 要开机启动的文件路径 + + + + + 检查是否开机启动 + + 开机启动名称 + 开机启动命令 + + + + + 检查是否开机启动 + + 开机启动名称 + + + + + 判断指定文件是否是开机启动 + + 开机启动名称 + 文件路径 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + 启动命令行 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置文件关联 + + 扩展名(如.apk) + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 设置文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 在指定文件格式右键菜单中增加菜单 + + 扩展名(如.apk) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 删除文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 获取文件关联是否存在 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 采用的IE模式 + + + + + IE7兼容视图 + + + + + IE8 标准模式 + + + + + IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE9 标准模式 + + + + + IE9 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE10 标准模式 + + + + + IE10 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置当前软件的浏览器控件内核版本 + + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + IE内核版本 + + + + + 设置当前软件的浏览器控件内核版本 + + IE内核版本 + + + + + 系统音量操作类 + + + + + 判断系统是否正处于静音 + + + + + + 系统函数 + + + + + + + + + + 红 + + + + + 绿 + + + + + 蓝 + + + + + 获取屏幕伽马值 + + + + + + + + 设置屏幕伽马值 + + + + + + + + 获取键盘和鼠标没有操作的时间 + + + + + + 设置屏幕 Gamma值 + + + + + + + + + 设置屏幕亮度 + + + + + + + 获取系统名称,注意需要在app.manifest文件中设置兼容win10 + + + + + + SOURCE CODE FROM THE WEBSITE. + LAST UPDATE:WWW.VJSDN.COM易学论坛,2009/08/03 by Jonny Sun + + + + + Mutes the left hand channel and transfers audio fully to the right + + + + + Mutes the right hand channel and transfers audio fully to the left + + + + + SOURCE CODE FROM THE WEBSITE. + LAST UPDATE:WWW.VJSDN.COM易学论坛,2009/08/03 by Jonny Sun + + + + + Mutes the left hand channel and transfers audio fully to the right + + + + + Mutes the right hand channel and transfers audio fully to the left + + + + + 窗体操作类 + + + + + 构造函数 + + + + + + 析构 + + + + + 设置让窗体支持移动 + + + + + 是否允许可调节大小 + + + + + 可调节窗体大小的宽度 + + + + + + + + + + + + + + + + + + + + + + + 开始截图 + + 是否截取鼠标指针 + + + + + 自动排列控件 + + + + + 最大列数 + + + + + 开始排列的坐标 + + + + + 下一项的位置 + + + + + 下一项的右下角坐标 + + + + + 竖向间隔像素 + + + + + 横向间隔像素 + + + + + 最小保留右边距,只对ReDraw2有效 + + + + + 自动排列控件构造函数 + + + + + + 自动排列控件构造函数 + + + + + + + + 开始排列控件 + + + + + 开始排列控件,当列数超过显示空间时，自动换行 + + + + + 加入的控件列表 + + + + + 初始化添加,自动将容器设置为滚动条自动显示 + + + + + + 添加控件 + + + + + + + 删除控件 + + + + + + 删除控件 + + + + + + 清空所有控件 + + + + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据当前节点生成HtmlDocument + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据XPath来查找节点 + + + + + + + + 在当前节点下根据xpath来查找符合的第一个节点 + + + + + + + + 在当前节点下根据xpath来查找所有符合的节点 + + + + + + + + A utility class to compute CRC32. + + + + + Compute a checksum for a given array of bytes. + + The array of bytes to compute the checksum for. + The computed checksum. + + + + Compute a checksum for a given string. + + The string to compute the checksum for. + The computed checksum. + + + + Represents an HTML attribute. + + + + + Gets the line number of this attribute in the document. + + + + + Gets the column number of this attribute in the document. + + + + + Gets the stream position of the value of this attribute in the document, relative to the start of the document. + + + + + Gets the length of the value. + + + + + + + + + + Gets the qualified name of the attribute. + + + + + Name of attribute with original case + + + + + Gets the HTML document to which this attribute belongs. + + + + + Gets the HTML node to which this attribute belongs. + + + + + Specifies what type of quote the data should be wrapped in + + + + + Specifies what type of quote the data should be wrapped in (internal to keep backward compatibility) + + + + + Gets the stream position of this attribute in the document, relative to the start of the document. + + + + + Gets or sets the value of the attribute. + + + + + Gets the DeEntitized value of the attribute. + + + + + Gets a valid XPath string that points to this Attribute + + + + + Compares the current instance with another attribute. Comparison is based on attributes' name. + + An attribute to compare with this instance. + A 32-bit signed integer that indicates the relative order of the names comparison. + + + + Creates a duplicate of this attribute. + + The cloned attribute. + + + + Removes this attribute from it's parents collection + + + + + An Enum representing different types of Quotes used for surrounding attribute values + + + + + A single quote mark ' + + + + + A double quote mark " + + + + + No quote mark + + + + + The initial value (current value) + + + + + Represents a combined list and collection of HTML nodes. + + + + + Gets the number of elements actually contained in the list. + + + + + Gets readonly status of colelction + + + + + Gets the attribute at the specified index. + + + + + Gets a given attribute from the list using its name. + + + + + Adds a new attribute to the collection with the given values + + + + + + + Adds supplied item to collection + + + + + Adds a range supplied items to collection. + An IEnumerable<HtmlAttribute> of items to append to this. + + + Adds a range supplied items to collection using a dictionary. + A Dictionary<string,string> of items to append to this. + + + + Explicit clear + + + + + Retreives existence of supplied item + + + + + + + Copies collection to array + + + + + + + Get Explicit enumerator + + + + + + Explicit non-generic enumerator + + + + + + Retrieves the index for the supplied item, -1 if not found + + + + + + + Inserts given item into collection at supplied index + + + + + + + Explicit collection remove + + + + + + + Removes the attribute at the specified index. + + The index of the attribute to remove. + + + + Inserts the specified attribute as the last attribute in the collection. + + The attribute to insert. May not be null. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The value of the attribute to insert. + The appended attribute. + + + + Checks for existance of attribute with given name + + + + + + + Inserts the specified attribute as the first node in the collection. + + The attribute to insert. May not be null. + The prepended attribute. + + + + Removes a given attribute from the list. + + The attribute to remove. May not be null. + + + + Removes an attribute from the list, using its name. If there are more than one attributes with this name, they will all be removed. + + The attribute's name. May not be null. + + + + Remove all attributes in the list. + + + + + Returns all attributes with specified name. Handles case insentivity + + Name of the attribute + + + + + Removes all attributes from the collection + + + + + Clears the attribute collection + + + + + Represents an HTML comment. + + + + + Gets or Sets the comment text of the node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Represents a complete HTML document. + + + + True to disable, false to enable the behavior tag p. + + + Default builder to use in the HtmlDocument constructor + + + Action to execute before the Parse is executed + + + + Defines the max level we would go deep into the html document + + + + The HtmlDocument Text. Careful if you modify it. + + + True to stay backward compatible with previous version of HAP. This option does not guarantee 100% compatibility. + + + + Adds Debugging attributes to node. Default is false. + + + + + Defines if closing for non closed nodes must be done at the end or directly in the document. + Setting this to true can actually change how browsers render the page. Default is false. + + + + + Defines if non closed nodes will be checked at the end of parsing. Default is true. + + + + + Defines if a checksum must be computed for the document while parsing. Default is false. + + + + + Defines if SelectNodes method will return null or empty collection when no node matched the XPath expression. + Setting this to true will return empty collection and false will return null. Default is false. + + + + True to disable, false to enable the server side code. + + + + Defines the default stream encoding to use. Default is System.Text.Encoding.Default. + + + + + Force to take the original comment instead of creating it + + + + + Defines if source text must be extracted while parsing errors. + If the document has a lot of errors, or cascading errors, parsing performance can be dramatically affected if set to true. + Default is false. + + + + + Defines the maximum length of source text or parse errors. Default is 100. + + + + + Defines if LI, TR, TH, TD tags must be partially fixed when nesting errors are detected. Default is false. + + + + + Defines if output must conform to XML, instead of HTML. Default is false. + + + + + If used together with and enabled, Xml namespaces in element names are preserved. Default is false. + + + + + Defines if attribute value output must be optimized (not bound with double quotes if it is possible). Default is false. + + + + Defines the global attribute value quote. When specified, it will always win. + + + + Defines if name must be output with it's original case. Useful for asp.net tags and attributes. Default is false. + + + + + Defines if name must be output in uppercase. Default is false. + + + + + Defines if declared encoding must be read from the document. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node. + Default is true. + + + + + Defines the name of a node that will throw the StopperNodeException when found as an end node. Default is null. + + + + + Defines if the 'id' attribute must be specifically used. Default is true. + + + + + Defines if empty nodes must be written as closed during output. Default is false. + + + + + The max number of nested child nodes. + Added to prevent stackoverflow problem when a page has tens of thousands of opening html tags with no closing tags + + + + + Creates an instance of an HTML document. + + + + Gets the parsed text. + The parsed text. + + + + Defines the max level we would go deep into the html document. If this depth level is exceeded, and exception is + thrown. + + + + + Gets the document CRC32 checksum if OptionComputeChecksum was set to true before parsing, 0 otherwise. + + + + + Gets the document's declared encoding. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node (pre-HTML5) or the meta charset="XXXXX" html node (HTML5). + + + + + Gets the root node of the document. + + + + + Gets the document's output encoding. + + + + + Gets a list of parse errors found in the document. + + + + + Gets the remaining text. + Will always be null if OptionStopperNodeName is null. + + + + + Gets the offset of Remainder in the original Html text. + If OptionStopperNodeName is null, this will return the length of the original Html text. + + + + + Gets the document's stream encoding. + + + + + Gets a valid XML name. + + Any text. + A string that is a valid XML name. + + + + + + + + + + + + + + + + + + + Applies HTML encoding to a specified string. + + The input string to encode. May not be null. + The encoded string. + + + + Determines if the specified character is considered as a whitespace character. + + The character to check. + true if if the specified character is considered as a whitespace character. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The new HTML attribute. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The value of the attribute. + The new HTML attribute. + + + + Creates an HTML comment node. + + The new HTML comment node. + + + + Creates an HTML comment node with the specified comment text. + + The comment text. May not be null. + The new HTML comment node. + + + + Creates an HTML element node with the specified name. + + The qualified name of the element. May not be null. + The new HTML node. + + + + Creates an HTML text node. + + The new HTML text node. + + + + Creates an HTML text node with the specified text. + + The text of the node. May not be null. + The new HTML text node. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The html is checked. + The detected encoding. + + + + Detects the encoding of an HTML text provided on a TextReader. + + The TextReader used to feed the HTML. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML text. + + The input html text. May not be null. + The detected encoding. + + + + Gets the HTML node with the specified 'id' attribute value. + + The attribute id to match. May not be null. + The HTML node with the matching id or null if not found. + + + + Loads an HTML document from a stream. + + The input stream. + + + + Loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Loads the HTML document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. May not be null. + + + + Loads the HTML document from the specified string. + + String containing the HTML document to load. May not be null. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. May not be null. + The character encoding to use. May not be null. + + + + Saves the HTML document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the HTML document to the specified TextWriter. + + The TextWriter to which you want to save. May not be null. + + + + Saves the HTML document to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. May not be null. + true to detect encoding, false otherwise. + + + + Detects the encoding of an HTML file. + + Path for the file containing the HTML document to detect. May not be null. + The detected encoding. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. May not be null. + The character encoding to use. May not be null. + + + + Creates a new XPathNavigator object for navigating this HTML document. + + An XPathNavigator object. The XPathNavigator is positioned on the root of the document. + + + + Flags that describe the behavior of an Element node. + + + + + The node is a CDATA node. + + + + + The node is empty. META or IMG are example of such nodes. + + + + + The node will automatically be closed during parsing. + + + + + The node can overlap. + + + + + A utility class to replace special characters by entities and vice-versa. + Follows HTML 4.0 specification found at http://www.w3.org/TR/html4/sgml/entities.html + Follows Additional specification found at https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references + See also: https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references + + + + + + + + + + A collection of entities indexed by name. + + + + + A collection of entities indexed by value. + + + + + Replace known entities by characters. + + The source text. + The result text. + + + + Clone and entitize an HtmlNode. This will affect attribute values and nodes' text. It will also entitize all child nodes. + + The node to entitize. + An entitized cloned node. + + + + Replace characters above 127 by entities. + + The source text. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + If set to true, the [quote], [ampersand], [lower than] and [greather than] characters will be entitized. + The result text + + + + Represents an HTML node. + + + + + Gets the name of a comment node. It is actually defined as '#comment'. + + + + + Gets the name of the document node. It is actually defined as '#document'. + + + + + Gets the name of a text node. It is actually defined as '#text'. + + + + + Gets a collection of flags that define specific behaviors for specific element nodes. + The table contains a DictionaryEntry list with the lowercase tag name as the Key, and a combination of HtmlElementFlags as the Value. + + + + + Initialize HtmlNode. Builds a list of all tags that have special allowances + + + + + Initializes HtmlNode, providing type, owner and where it exists in a collection + + + + + + + + Gets the collection of HTML attributes for this node. May not be null. + + + + + Gets all the children of the node. + + + + + Gets a value indicating if this node has been closed or not. + + + + + Gets the collection of HTML attributes for the closing tag. May not be null. + + + + + Gets the closing tag of the node, null if the node is self-closing. + + + + + Gets the first child of the node. + + + + + Gets a value indicating whether the current node has any attributes. + + + + + Gets a value indicating whether this node has any child nodes. + + + + + Gets a value indicating whether the current node has any attributes on the closing tag. + + + + + Gets or sets the value of the 'id' HTML attribute. The document must have been parsed using the OptionUseIdAttribute set to true. + + + + + Gets or Sets the HTML between the start and end tags of the object. + + + + + Gets the text between the start and end tags of the object. + + + + Gets direct inner text. + The direct inner text. + + + + Gets the last child of the node. + + + + + Gets the line number of this node in the document. + + + + + Gets the column number of this node in the document. + + + + + Gets the stream position of the area between the opening and closing tag of the node, relative to the start of the document. + + + + + Gets the stream position of the area of the beginning of the tag, relative to the start of the document. + + + + + Gets the length of the area between the opening and closing tag of the node. + + + + + Gets the length of the entire node, opening and closing tag included. + + + + + Gets or sets this node's name. + + + + + Gets the HTML node immediately following this element. + + + + + Gets the type of this node. + + + + + The original unaltered name of the tag + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets the to which this node belongs. + + + + + Gets the parent of this node (for nodes that can have parents). + + + + + Gets the node immediately preceding this node. + + + + + Gets the stream position of this node in the document, relative to the start of the document. + + + + + Gets a valid XPath string that points to this node + + + + + The depth of the node relative to the opening root html element. This value is used to determine if a document has to many nested html nodes which can cause stack overflows + + + + + Determines if an element node can be kept overlapped. + + The name of the element node to check. May not be null. + true if the name is the name of an element node that can be kept overlapped, false otherwise. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The newly created node instance. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The HTML Document builder. + The newly created node instance. + + + + Determines if an element node is a CDATA element node. + + The name of the element node to check. May not be null. + true if the name is the name of a CDATA element node, false otherwise. + + + + Determines if an element node is closed. + + The name of the element node to check. May not be null. + true if the name is the name of a closed element node, false otherwise. + + + + Determines if an element node is defined as empty. + + The name of the element node to check. May not be null. + true if the name is the name of an empty element node, false otherwise. + + + + Determines if a text corresponds to the closing tag of an node that can be kept overlapped. + + The text to check. May not be null. + true or false. + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Get Ancestors with matching name + + + + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Gets all anscestor nodes and the current node + + + + + + + Adds the specified node to the end of the list of children of this node. + + The node to add. May not be null. + The node added. + + + Sets child nodes identifier. + The chil node. + + + + Adds the specified node to the end of the list of children of this node. + + The node list to add. May not be null. + + + + Gets all Attributes with name + + + + + + + Creates a duplicate of the node + + + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + The cloned node. + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node. + + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node and the subtree under it. + + The node to duplicate. May not be null. + + + + Creates a duplicate of the node. + + The node to duplicate. May not be null. + true to recursively clone the subtree under the specified node, false to clone only the node itself. + + + + Gets all Descendant nodes for this node and each of child nodes + + The depth level of the node to parse in the html tree + the current element as an HtmlNode + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Get all descendant nodes with matching name + + + + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all descendant nodes including this node + + + + + + + Gets first generation child node matching name + + + + + + + Gets matching first generation child nodes matching name + + + + + + Gets data attribute. + The key. + The data attribute. + + + Gets the data attributes in this collection. + + An enumerator that allows foreach to be used to process the data attributes in this + collection. + + + + Gets the attributes in this collection. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + Gets the attributes in this collection. + A variable-length parameters list containing attribute names. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, + the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Inserts the specified node immediately after the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newNode is placed after the refNode. + The node being inserted. + + + + Inserts the specified node immediately before the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newChild is placed before this node. + The node being inserted. + + + + Adds the specified node to the beginning of the list of children of this node. + + The node to add. May not be null. + The node added. + + + + Adds the specified node list to the beginning of the list of children of this node. + + The node list to add. May not be null. + + + + Removes node from parent collection + + + + + Removes all the children and/or attributes of the current node. + + + + + Removes all the children of the current node. + + + + Removes all id for node described by node. + The node. + + + Move a node already associated and append it to this node instead. + The child node to move. + + + Move a children collection already associated and append it to this node instead. + The children collection already associated to move to another node. + + + Removes the children collection for this node. + The old children collection to remove. + + + + Removes the specified child node. + + The node being removed. May not be null. + The node removed. + + + + Removes the specified child node. + + The node being removed. May not be null. + true to keep grand children of the node, false otherwise. + The node removed. + + + + Replaces the child node oldChild with newChild node. + + The new node to put in the child list. + The node being replaced in the list. + The node replaced. + + + + Helper method to set the value of an attribute of this node. If the attribute is not found, it will be created automatically. + + The name of the attribute to set. May not be null. + The value for the attribute. + The corresponding attribute instance. + + + + Saves all the children of the node to the specified TextWriter. + + The TextWriter to which you want to save. + Identifies the level we are in starting at root with 0 + + + + Saves all the children of the node to a string. + + The saved string. + + + + Saves the current node to the specified TextWriter. + + The TextWriter to which you want to save. + identifies the level we are in starting at root with 0 + + + + Saves the current node to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Saves the current node to a string. + + The saved string. + + + + Sets the parent Html node and properly determines the current node's depth using the parent node's depth. + + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + true to throw Error if class name exists, false otherwise. + + + + Removes the class attribute from the node. + + + + + Removes the class attribute from the node. + + true to throw Error if class name doesn't exist, false otherwise. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + true to throw Error if class name doesn't exist, false otherwise. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + true to throw Error if class name doesn't exist, false otherwise. + + + Gets the CSS Class from the node. + + The CSS Class from the node + + + + Check if the node class has the parameter class. + The class. + True if node class has the parameter class, false if not. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type targetType including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Creates a new XPathNavigator object for navigating this HTML node. + + An XPathNavigator object. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document. + + + + Creates an XPathNavigator using the root of this document. + + + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects the first XmlNode that matches the XPath expression. + + The XPath expression. May not be null. + The first that matches the XPath query or a null reference if no matching node was found. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Includes tools that GetEncapsulatedData method uses them. + + + + + Determine if a type define an attribute or not , supporting both .NetStandard and .NetFramework2.0 + + Type you want to test it. + Attribute that type must have or not. + If true , The type parameter define attributeType parameter. + + + + Retrive properties of type that defined . + + Type that you want to find it's XPath-Defined properties. + IEnumerable of property infos of a type , that defined specific attribute. + + + + Determine if a has implemented BUT is considered as NONE-IEnumerable ! + + The property info you want to test. + True if property info is IEnumerable. + + + + Returns T type(first generic type) of or . + + IEnumerable-Implemented property + List of generic types. + + + + Find and Return a mehtod that defined in a class by it's name. + + Type of class include requested method. + Name of requested method as string. + Method info of requested method. + + + + Create of given type. + + Type that you want to make a List of it. + Returns IList of given type. + + + + Returns the part of value of you want as . + + A htmlNode instance. + Attribute that includes ReturnType + String that choosen from HtmlNode as result. + + + + Returns parts of values of you want as . + + that you want to retrive each value. + A instnce incules . + Type of IList generic you want. + + + + + Simulate Func method to use in Lambada Expression. + + + + + + + + + This method works like Where method in LINQ. + + + + + + + + + Check if the type can instantiated. + + + + + + + Returns count of elements stored in IEnumerable of T + + + + + + + + Specify which part of is requested. + + + + + The text between the start and end tags of the object. + + + + + The HTML between the start and end tags of the object + + + + + The object and its content in HTML + + + + + Just mark and flag classes to show they have properties that defined . + + + + + Includes XPath and . XPath for finding html tags and for specify which part of you want to return. + + + + + XPath Expression that is used to find related html node. + + + + + Html Attribute name + + + + + The methode of output + + + + + Specify Xpath to find related Html Node. + + + + + + Specify Xpath to find related Html Node. + + + Specify you want the output include html text too. + + + + Specify Xpath and Attribute to find related Html Node and its attribute value. + + + + + + + Tagging a property with this Attribute make Encapsulator to ignore that property if it causes an error. + + + + + Exception that often occures when there is no way to bind a XPath to a Html Tag. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no way to bind a XPath to a HtmlTag Attribute. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no property that assigned with XPath Property in Class. + + + + + + + + + + + + + + + + + + + + + + + Represents a combined list and collection of HTML nodes. + + + + + Initialize the HtmlNodeCollection with the base parent node + + The base node of the collection + + + Gets the parent node associated to the collection. + + + + Gets a given node from the list. + + + + + Get node with tag name + + + + + + + Gets the number of elements actually contained in the list. + + + + + Is collection read only + + + + + Gets the node at the specified index. + + + + + Add node to the collection + + + + + + Add node to the collection + + + + + + + Clears out the collection of HtmlNodes. Removes each nodes reference to parentnode, nextnode and prevnode + + + + + Gets existence of node in collection + + + + + + + Copy collection to array + + + + + + + Get Enumerator + + + + + + Get Explicit Enumerator + + + + + + Get index of node + + + + + + + Insert node at index + + + + + + + Remove node + + + + + + + Remove at index + + + + + + Get first instance of node in supplied collection + + + + + + + + Add node to the end of the collection + + + + + + Get first instance of node with name + + + + + + + Get index of node + + + + + + + Add node to the beginning of the collection + + + + + + Remove node at index + + + + + + + Replace node at index + + + + + + + Get all node descended from this collection + + + + + + Get all node descended from this collection with matching name + + + + + + Gets all first generation elements in collection + + + + + + Gets all first generation elements matching name + + + + + + + All first generation nodes in collection + + + + + + Represents an HTML navigator on an HTML document seen as a data store. + + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Gets the base URI for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the current HTML document. + + + + + Gets the current HTML node. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node is an empty element. + + + + + Gets the name of the current HTML node without the namespace prefix. + + + + + Gets the qualified name of the current node. + + + + + Gets the namespace URI (as defined in the W3C Namespace Specification) of the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the associated with this implementation. + + + + + Gets the type of the current node. + + + + + Gets the prefix associated with the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the text value of the current node. + + + + + Gets the xml:lang scope for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Creates a new HtmlNavigator positioned at the same node as this HtmlNavigator. + + A new HtmlNavigator object positioned at the same node as the original HtmlNavigator. + + + + Gets the value of the HTML attribute with the specified LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + The value of the specified HTML attribute. String.Empty or null if a matching attribute is not found or if the navigator is not positioned on an element node. + + + + Returns the value of the namespace node corresponding to the specified local name. + Always returns string.Empty for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns string.Empty for the HtmlNavigator implementation. + + + + Determines whether the current HtmlNavigator is at the same position as the specified HtmlNavigator. + + The HtmlNavigator that you want to compare against. + true if the two navigators have the same position, otherwise, false. + + + + Moves to the same position as the specified HtmlNavigator. + + The HtmlNavigator positioned on the node that you want to move to. + true if successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves to the HTML attribute with matching LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + true if the HTML attribute is found, otherwise, false. If false, the position of the navigator does not change. + + + + Moves to the first sibling of the current node. + + true if the navigator is successful moving to the first sibling node, false if there is no first sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the first HTML attribute. + + true if the navigator is successful moving to the first HTML attribute, otherwise, false. + + + + Moves to the first child of the current node. + + true if there is a first child node, otherwise false. + + + + Moves the XPathNavigator to the first namespace node of the current element. + Always returns false for the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the node that has an attribute of type ID whose value matches the specified string. + + A string representing the ID value of the node to which you want to move. This argument does not need to be atomized. + true if the move was successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves the XPathNavigator to the namespace node with the specified local name. + Always returns false for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the next sibling of the current node. + + true if the navigator is successful moving to the next sibling node, false if there are no more siblings or if the navigator is currently positioned on an attribute node. If false, the position of the navigator is unchanged. + + + + Moves to the next HTML attribute. + + + + + + Moves the XPathNavigator to the next namespace node. + Always returns falsefor the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the parent of the current node. + + true if there is a parent node, otherwise false. + + + + Moves to the previous sibling of the current node. + + true if the navigator is successful moving to the previous sibling node, false if there is no previous sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the root node to which the current node belongs. + + + + + Represents the type of a node. + + + + + The root of a document. + + + + + An HTML element. + + + + + An HTML comment. + + + + + A text node is always the child of an element or a document node. + + + + + Represents a parsing error found during document parsing. + + + + + Gets the type of error. + + + + + Gets the line number of this error in the document. + + + + + Gets the column number of this error in the document. + + + + + Gets a description for the error. + + + + + Gets the the full text of the line containing the error. + + + + + Gets the absolute stream position of this error in the document, relative to the start of the document. + + + + + Represents the type of parsing error. + + + + + A tag was not closed. + + + + + A tag was not opened. + + + + + There is a charset mismatch between stream and declared (META) encoding. + + + + + An end tag was not required. + + + + + An end tag is invalid at this position. + + + + + Represents an HTML text node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets or Sets the text of the node. + + + + + A utility class to get HTML document from HTTP. + + + + + Represents the method that will handle the PostResponse event. + + + + + Represents the method that will handle the PreHandleDocument event. + + + + + Represents the method that will handle the PreRequest event. + + + + + Occurs after an HTTP request has been executed. + + + + + Occurs before an HTML document is handled. + + + + + Occurs before an HTTP request is executed. + + + + + Gets or Sets a value indicating if document encoding must be automatically detected. + + + + + Gets or sets the Encoding used to override the response stream from any web request + + + + + Gets or Sets a value indicating whether to get document only from the cache. + If this is set to true and document is not found in the cache, nothing will be loaded. + + + + + Gets or Sets a value indicating whether to get document from the cache if exists, otherwise from the web + A value indicating whether to get document from the cache if exists, otherwise from the web + + + + + Gets or Sets the cache path. If null, no caching mechanism will be used. + + + + + Gets a value indicating if the last document was retrieved from the cache. + + + + + Gets the last request duration in milliseconds. + + + + + Gets the URI of the Internet resource that actually responded to the request. + + + + + Gets the last request status. + + + + + Gets or Sets the size of the buffer used for memory operations. + + + + + Gets or Sets a value indicating if cookies will be stored. + + + + Gets or sets a value indicating whether redirect should be captured instead of the current location. + True if capture redirect, false if not. + + + + Gets or Sets the User Agent HTTP 1.1 header sent on any webrequest + + + + + Gets or Sets a value indicating whether the caching mechanisms should be used or not. + + + + + Gets the MIME content type for a given path extension. + + The input path extension. + The default content type to return if any error occurs. + The path extension's MIME content type. + + + + Gets the path extension for a given MIME content type. + + The input MIME content type. + The default path extension to return if any error occurs. + The MIME content type's path extension. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The requested type. + An newly created instance. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. - Proxy aware + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. Understands Proxies + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + + Gets the cache file path for a specified url. + + The url fo which to retrieve the cache path. May not be null. + The cache file path. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The XmlTextWriter to which you want to save to. + + + Gets or sets the web browser timeout. + + + + Gets or sets the web browser delay. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + An newly created instance. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + An newly created instance. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". May not be null. + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + + + + Represents an exception thrown by the HtmlWeb utility class. + + + + + Creates an instance of the HtmlWebException. + + The exception's message. + + + + Represents a document with mixed code and text. ASP, ASPX, JSP, are good example of such documents. + + + + + Gets or sets the token representing code end. + + + + + Gets or sets the token representing code start. + + + + + Gets or sets the token representing code directive. + + + + + Gets or sets the token representing response write directive. + + + + + Creates a mixed code document instance. + + + + + Gets the code represented by the mixed code document seen as a template. + + + + + Gets the list of code fragments in the document. + + + + + Gets the list of all fragments in the document. + + + + + Gets the encoding of the stream used to read the document. + + + + + Gets the list of text fragments in the document. + + + + + Create a code fragment instances. + + The newly created code fragment instance. + + + + Create a text fragment instances. + + The newly created text fragment instance. + + + + Loads a mixed code document from a stream. + + The input stream. + + + + Loads a mixed code document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads the mixed code document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Loads a mixed document from a text + + The text to load. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + The character encoding to use. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + The character encoding to use. + + + + Saves the mixed document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the mixed document to the specified TextWriter. + + The TextWriter to which you want to save. + + + + Represents a fragment of code in a mixed code document. + + + + + Gets the fragment code text. + + + + + Represents a base class for fragments in a mixed code document. + + + + + Gets the fragement text. + + + + + Gets the type of fragment. + + + + + Gets the line number of the fragment. + + + + + Gets the line position (column) of the fragment. + + + + + Gets the fragment position in the document's stream. + + + + + Represents a list of mixed code fragments. + + + + + Gets the Document + + + + + Gets the number of fragments contained in the list. + + + + + Gets a fragment from the list using its index. + + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Appends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Prepends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Remove a fragment from the list of fragments. If this fragment was not in the list, an exception will be raised. + + The fragment to remove. May not be null. + + + + Remove all fragments from the list. + + + + + Remove a fragment from the list of fragments, using its index in the list. + + The index of the fragment to remove. + + + + Represents a fragment enumerator. + + + + + Gets the current element in the collection. + + + + + Gets the current element in the collection. + + + + + Advances the enumerator to the next element of the collection. + + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + + + + Sets the enumerator to its initial position, which is before the first element in the collection. + + + + + Represents the type of fragment in a mixed code document. + + + + + The fragment contains code. + + + + + The fragment contains text. + + + + + Represents a fragment of text in a mixed code document. + + + + + Gets the fragment text. + + + + + 给控件增加拖放功能的类 + + + + + 拖放实例 + + + + + 高级拖放事件 + + + + + + + + + + + + + + + + + + + + + + + + + 使管理员方式运行时支持拖放 + + + + + + 使支持拖放属性 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取WMI内容 + + + + + + + 获取WMI内容 + + + + + + + 获取内存信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取硬盘信息 + + + + + + 获取主板信息 + + + + + + 获取处理器信息 + + + + + + 获取主要硬件信息 + + + + + + 获取主要硬件信息 + + 是否获取XML格式 + + + + + 网络操作类 + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 根据mac字符串来获取最终的mac地址,可以是各种MAC地址格式,非法的内容将返回null + + + + + + + 远程唤醒 + + + + + + + + 远程唤醒 + + + + + + + + + 消息服务器 + + + + + 消息事件 + + + + + + + 大小改变事件 + + + + + + + + 即将关闭事件 + + + + + + + 当收到消息时激发 + + + + + 消息处理类 + + + + + + + + + + + + + + + + + + + + + + + 发送消息,采用单线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 发送消息，采用多线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 消息类 + + + + + 是否取消 + + + + + 来源句柄 + + + + + + + + + + 消息文本 + + + + + 需要回复的内容 + + + + + 消息客户端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 最后一次接收消息的时间,可用来判断服务端是否有响应 + + + + + 主句柄 + + + + + 当收到消息时激发 + + + + + 连接上主服务器时触发 + + + + + 收到服务端关闭通知 + + + + + 收到服务端关闭通知，即将关闭 + + + + + 服务端大小改变时激发 + + + + + 实例化客户端 + + 服务端ID + 当前客户端ID,会向服务器报告当前ID + 客户端 + + + + + + + + + 断开服务端连接 + + + + + 发送消息,采用多线程发送 + + + + + + + 向服务端发送心跳包 + + + + + 判断服务端句柄是否存在。 + + + + + + 消息服务端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 当收到消息时激发 + + + + + 当收到自定义消息时(非系统消息)激发 + + + + + 有消息客户端发起连接请求时激发 + + + + + 有消息客户端连接成功时激发 + + + + + 有消息客户端断开连接时激发 + + + + + + + 服务端ID,需要唯一性,共客户端识别 + 服务端 + + + + 释放资源 + + + + + 判断是否包含指定客户端 + + + + + + + + + + + + 设置客户端大小 + + + + + 根据客户端ID,获取客户端对象 + + + + + + + 根据客户端句柄,获取客户端对象 + + + + + + + 关闭所有客户端 + + + + + 关闭指定客户端 + + + + + + 关闭指定客户端 + + + + + + 向所有客户端发送消息，单线程 + + + + + + + 向指定客户端发送消息 + + + + + + + + 关闭在指定时间前失去响应的子客户端 + + + + + + 客户端信息 + + + + + 客户端句柄 + + + + + 客户端ID + + + + + 客户端连接时间 + + + + + 心跳时间 + + + + + 共享内存 + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 删除内存映射 + + + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + 发送消息的窗口句柄 + 发送消息 + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射对象 + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射字节数据 + + + + 数据库引擎 + + + + + 数据库枚举类型 + + + + + Odbc引擎 + + + + + OleDb引擎 + + + + + Oracle引擎 + + + + + MSSQL引擎 + + + + + SQLite引擎 + + + + + MySql引擎 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据 + + + + + + + 获取第一行第一列的值 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + + 数据库操作接口 + + + + + 连接数据库 + + + + + + 数据库是否已连接 + + + + + 断开数据库 + + + + + + 获取数量 + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + + 获取分页语句 + + + + + + + + + + 添加Parameter参数 + + + + + + + 清空Parameter参数 + + + + + + + 获取Parameter值 + + + + + + 根据RyQuickSQL类来获取Parameter值 + + + + + + + 开始执行事务 + + + + + 提交事务 + + + + + 判断是否包含数据 + + + + + + + + 返回-1000表示该数据库不支持本接口 + + + + + + + 读取数据 + + + + + + + 读取数据 + + + + + + + + 读取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + 执行SQL语句 + + + + + + + 根据id号删除数据 + + + + + + + + 根据id号删除数据 + + + + + + + + 创建数据库 + + + + + + + 释放资源 + + + + + 最后一个错误信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + SQL字段类型 + + + + + SQL字段类型 + + + + + + + SQL字段类型 + + + + + + + + SQL字段名 + + + + + SQL字段值 + + + + + SQL字段长度 + + + + + 不是真的值，而是用于计算的值 + + + + + SQL快速操作类 + + + + + SQL快速操作类 + + + + + + 表名 + + + + + 操作字段列表 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + 操作参数列表 + + + + + 操作参数列表 + + + + + 添加字符串字段 + + + + + + + 添加null值字段 + + + + + + 添加日期字段 + + + + + + + 添加int字段 + + + + + + + 添加double字段 + + + + + + + 添加decimal字段 + + + + + + + 添加byte[]字段 + + + + + + + 添加bool字段 + + + + + + + 添加用于计算的值 + + + + + + + 添加Int64字段 + + + + + + + 清空内容 + + + + + 数量 + + + + + + + + + + 输出多条件搜索。 + + 字段名,多个字段请用逗号分隔。 + 多个条件之间请用空格隔开 + + + + + 获取插入SQL语句 + + + + + + 获取更新SQL语句 + + + + + + 添加参数 + + + + + + + 获取Ole参数 + + + + + + 获取SQL参数 + + + + + + + + + + + + + + + + + + + + + + + 数据库路径 + 数据库密码 + + + + + + + 数据库路径 + + + + + + + + + + + + + + + + + + + + 连接数据库 + + + + + + 设置路径和密码 + + + + + + 连接数据库 + + + + + + + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 创建数据库 + + SQL语句 + + + + + 根据内置例子创建数据库 + + + + + + 保存信息，如果Name不存在，系统会自动创建 + + 返回1，表示成功，0表示失败 + + + + 获取信息 + + + + + + 获取信息 + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Http连接操作帮助类 + + + + + + + + + + + + 根据相传入的数据，得到相应页面数据 + + 参数类对象 + 返回HttpResult类型 + + + + 获取数据的并解析的方法 + + + + + + + 设置编码 + + HttpItem + HttpResult + byte[] + + + + 提取网页Byte + + + + + + 为请求准备参数 + + 参数列表 + + + + 设置证书 + + + + + + 设置多个证书 + + + + + + 设置Cookie + + Http参数 + + + + 设置Post数据 + + Http参数 + + + + 设置代理 + + 参数对象 + + + + 回调验证证书问题 + + 流对象 + 证书 + X509Chain + SslPolicyErrors + bool + + + + 通过设置这个属性，可以在发出连接的时候绑定客户端发出连接所使用的IP地址。 + + + + + + + + + Http请求参考类 + + + + + 请求URL必须填写 + + + + + 请求方式默认为GET方式,当为POST方式时必须设置Postdata的值 + + + + + 默认请求超时时间 + + + + + 默认写入Post数据超时间 + + + + + 设置Host的标头信息 + + + + + 获取或设置一个值，该值指示是否与 Internet 资源建立持久性连接默认为true。 + + + + + 请求标头值 默认为text/html, application/xhtml+xml, */* + + + + + 请求返回类型默认 text/html + + + + + 客户端访问信息默认Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0) + + + + + 返回数据编码默认为NUll,可以自动识别,一般为utf-8,gbk,gb2312 + + + + + Post的数据类型 + + + + + Post请求时要发送的字符串Post数据 + + + + + Post请求时要发送的Byte类型的Post数据 + + + + + Cookie对象集合 + + + + + 请求时的Cookie + + + + + 来源地址，上次访问地址 + + + + + 证书绝对路径 + + + + + 设置代理对象，不想使用IE默认配置就设置为Null，而且不要设置ProxyIp + + + + + 是否设置为全文小写，默认为不转化 + + + + + 获取或设置要在 HTTP 请求中使用的 Date HTTP 标头值。默认不填写 + + + + + 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 + + + + + 最大连接数 + + + + + 代理Proxy 服务器用户名 + + + + + 代理 服务器密码 + + + + + 代理 服务IP,如果要使用IE代理就设置为ieproxy + + + + + 设置返回类型String和Byte + + + + + header对象 + + + + + 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 + + + + + 获取或设置一个 System.Boolean 值，该值确定是否使用 100-Continue 行为。如果 POST 请求需要 100-Continue 响应，则为 true；否则为 false。默认值为 true。 + + + + + 设置509证书集合 + + + + + 设置或获取Post参数编码,默认的为Default编码 + + + + + Cookie返回类型,默认的是只返回字符串类型 + + + + + 获取或设置请求的身份验证信息。 + + + + + 设置请求将跟随的重定向的最大数目 + + + + + 获取和设置IfModifiedSince，默认为当前日期和时间 + + + + + 设置本地的出口ip和端口 + ] + + item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); + + + + + 是否重置request,response的值，默认不重置，当设置为True时request,response将被设置为Null + + + + + Http返回参数类 + + + + + Http请求返回的Cookie + + + + + Cookie对象集合 + + + + + 返回的String类型数据 只有ResultType.String时才返回数据，其它情况为空 + + + + + 返回的Byte数组 只有ResultType.Byte时才返回数据，其它情况为空 + + + + + header对象 + + + + + 返回状态说明 + + + + + 返回状态码,默认为OK + + + + + 最后访问的URl + + + + + 获取重定向的URl + + + + + 返回类型 + + + + + 表示只返回字符串 只有Html有数据 + + + + + 表示返回字符串和字节流 ResultByte和Html都有数据返回 + + + + + Post的数据格式默认为string + + + + + 字符串类型，这时编码Encoding可不设置 + + + + + Byte类型，需要设置PostdataByte参数的值编码Encoding可设置为空 + + + + + 传文件，Postdata必须设置为文件的绝对路径，必须设置Encoding的值 + + + + + Cookie返回类型 + + + + + 只返回字符串类型的Cookie + + + + + CookieCollection格式的Cookie集合同时也返回String类型的cookie + + + + + Http服务器类 + + + + + + + + + + + + 当收到Get事件时激发 + + + + + 当收到Post事件时激发 + + + + + 监听的主机,默认是localhost + + + + + 最后一次错误信息 + + + + + 在此端口建立Http服务类 + + 端口号 + + + + + + + + + + 开始服务 + + + + + 退出服务 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超时时间 + + + + 以post方式获取网页源码 + + + + + + + + + 以post方式提交json内容 + + + + + + + + + 以post方式提交json内容 + + + + + + + + 以post方式获取网页源码 + + + + + + + + + + 以post方式获取网页源码 + + + + + + + + 获取网址对应的文件大小 + + + + + + + 获取网址对应的文件大小 + + + + + + + + 代理 + + + + + + + + + + 是否自动跳转 + + + + + 获取网页源码 + + + + + + + + 获取网页源码 + + + + + + + + + 获取网页源码 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将相对网址转换成绝对网址 + + 相对网址 + 当前页面地址 + 转换后的绝对网址 + + + + WebDav接口 + + + + + WebDav初始化 + + + + + + + + 删除文件 + + 相对路径,不包括域名 + + + + + 下载文件 + + + + + + + + 下载文件 + + + + + + + + + 上传文件 + + + + + + + + 上传文件 + + + + + + + + + 新建文件夹 + + + + + + + 新建文件夹 + + 文件夹路径 + + + + + + 新建文件夹 + + + + + + + + 将文件或目录列出来 + + + + + + + + 定义每个文件或目录的属性 + + + + + 文件名 + + + + + 是否是文件夹 + + + + + 网址 + + + + + 最后修改时间 + + + + + + + + + + + + + + + url解密 + + + + + + + + url解密,按UTF8方式解密 + + + + + + + Url加密 + + + + + + + + Url加密,按UTF8方式加密 + + + + + + + 解密 + + + + + + + 加密 + + + + + + + + + + + + + + + + + + + + + + + + + url加密,Unicode + + + + + + + + + + + + + + + + + + + + + + Html解码,将html里未转义成功的重新转义。 + + + + + + + 将url里的字段分解成表单字典 + + + + + + + + + 根据表单字段名获取值 + + + + + + + + + AES加密解密类 + + + + + AES加密算法 + + 明文字符串 + 密钥 + 返回加密后的密文字节数组 + + + + AES解密 + + 密文字节数组 + 密钥 + 返回解密后的字符串 + + + + 加密 + + + + + + + + 解码 + + + + + + + + 转换密钥到合法密钥 + + + + + + + Base64编码类 + + + + + 编码 + + + + + + + 把字符串编码成Base64字符串 + + + + + + + + 解码 + + + + + + + MD5和SHA1操作类 + + + + + 计算文件MD5。 + 通过MD5CryptoServiceProvider类中的ComputeHash方法直接传入一个FileStream类实现计算MD5 + 操作简单，代码少，调用即可 + + 文件地址 + MD5Hash + + + + 计算文件MD5。 + 通过HashAlgorithm的TransformBlock方法对流进行叠加运算获得MD5 + 实现稍微复杂，但可使用与传输文件或接收文件时同步计算MD5值 + 可自定义缓冲区大小，计算速度较快 + + 文件地址 + MD5Hash + + + + 获取MD5 + + + + + + + 获取MD5 + + + + + + + 获取SHA1 + + + + + + + 获取SHA1 + + + + + + + 获取HmacSHA1 + + + + + + + + 获取SHA256 + + + + + + + 获取HmacSHA256 + + + + + + + + 获取SHA224 + + + + + + + 获取SHA512 + + + + + + + 获取HmacSHA512 + + + + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 内部类 + + + + 读写锁对象 + + + + 是否为写入模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 构造函数 + + 读写锁 + 写入模式为true,读取模式为false + + + 释放对象时退出指定锁定模式 + + + + 空的可释放对象,免去了调用时需要判断是否为null的问题 + 内部类 + + + + 空的可释放对象 + + + + 空的释放方法 + + + + 读写锁 + + + + 保存数据 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + 为Data属性设置初始值 + + + + 获取或设置当前对象中保存数据的值 + + 获取数据时未进入读取或写入锁定模式 + 设置数据时未进入写入锁定模式 + + + 是否启用,当该值为false时,Read()和Write()方法将返回 Disposable.Empty + + + + 进入读取锁定模式,该模式下允许多个读操作同时进行 + 退出读锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在读取或写入锁定模式下重复执行,返回Disposable.Empty; + + + + 进入写入锁定模式,该模式下只允许同时执行一个写操作 + 退出写锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在写入锁定模式下重复执行,返回Disposable.Empty; + + 读取模式下不能进入写入锁定状态 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Shell + + + + + 根据路径获取 IShellFolder 和 PIDL + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 弹出系统右键菜单 + + + + + + + + 中国农历类,最大支持公元0-9999年 + + 日期：2019-02-09 + 作者：http://www.cnblogs.com/zjfree/ + + + + 日历类型 + + + + + 无效 + + + + + Julian 日历 + + + + + Gregorian 日历 + + + + + 有效 + + + + + 公历节日 + + + + + 农历节日 + + + + + 某个月第n个星期几 + + + + + 获取农历 + + + + + + + 获取农历 + + + + + + + + + 获得某农历年的闰月，返回 1~12 对应一月到十二月，返回 0 表示无闰月 + + + + + + + 农历搜索方向 + + + + + 无效 + + + + + 向上 + + + + + 向下 + + + + + {* 日月食类型， 无， 日食， 月全食， 月偏食 } + + + + + 无 + + + + + 日食 + + + + + 月全食 + + + + + 月偏食 + + + + + {* 月相， 无， 朔， 望} + + + + + 无 + + + + + 朔 + + + + + 望 + + + + + 获得某公历年月日的农历日数和该日月相以及日月食类型和时刻 + + + + + + + + + + + + 获得某公历年月日的农历月数 + + + + + + + + + 获取阳历日期对应的农历日期 + + + + + + + + + + + + + 获得某公历年月日的农历月日和是否闰月的信息 + + + + + + + + + + + + 获得等效标准日数对应的某公历日，倒推而来 + + + + + + + + + + 比较两个农历日期（包括闰月信息），1 大于2返回1、1等于2返回0、1小于2返回-1 + + + + + + + + + + + + + + 获得某农历年月日（加是否闰月）的公历年月日 + 该函数采用反向二分法查找 + + + + + + + + + + + + + 获取农历某一个月的总天数 + + + + + + + + + 获取农历年份，范围约1901-2101年 + + + + + + + 获取农历年份，范围约0-9999年 + + + + + + + + + 获取农历月份，范围约1901-2101年 + + + + + + + 获取农历月份，范围约0-9999年 + + + + + + + + + 获取中文表示的农历月份 + + + + + + + 获取农历日，范围约1901-2101年 + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 返回y年第n个节气（如小寒为1）的日差天数值（pd取值真假，分别表示平气和定气） + + + + pd取值真假，分别表示平气和定气 + + + + + 获取等效标准日数 + + + + + + + + + 取本月天数，不考虑 1582 年 10 月的特殊情况 + + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 获取节气 + + + + + + + + + + + + 获取公历节日 + + + + + + + 获取公历节日 + + + + + + + + + 获取指定月份的第n个星期几的节日 + + + + + + + 返回星座，范围约1901-2101年 + + + + + 返回星座，范围约0-9999年 + + + + + 获取农历节日 + + + + + + + + + 获取农历节日 + + + + + + + 判断y年m月(1,2,..,12,下同)d日是Gregorian历还是Julian历（opt=1,2,3分别表示标准日历,Gregorge历和Julian历）,是则返回1，是Julian历则返回0，若是Gregorge历所删去的那10天则返回-1 + + + + + 返回阳历y年m月d日的日差天数（在y年年内所走过的天数，如2000年3月1日为61） + + + + + 返回阳历y年日差天数为x时所对应的月日数（如y=2000，x=274时，返回1001(表示10月1日，即返回100*m+d)） + + + + + 获取指定日期的节气。 + + 要获取的年 + 要获取的月 + + + 立春：立是开始的意思，春是蠢动，表示万物开始有生气，这一天春天开始。 + 雨水：降雨开始，雨水将多。 + 惊蛰：春雷响动，惊动蛰伏地下冬眠的生物，它们将开始出土活动。 + 春分：这是春季九十天的中分点，这一天昼夜相等，所以古代曾称春分秋分为昼夜分。 + 清明：明洁晴朗，气候温暖，草木开始萌发繁茂。 + 谷雨：雨生百谷的意思。雨水增多，适时的降雨对谷物生长很为有利。 + 立夏：夏天开始，万物渐将随温暖的气候而生长。 + 小满：满指籽粒饱满，麦类等夏热作物这时开始结籽灌浆，即将饱满。 + 芒种：有芒作物开始成熟，此时也是秋季作物播种的最繁忙时节。 + 夏至：白天最长，黑夜最短，这一天中午太阳位置最高，日影短至终极，古代又称这一天为日北至或长日至。 + 小暑：暑是炎热，此时还未到达最热。 + 大暑：炎热的程度到达高峰。 + 立秋：秋天开始，植物快成熟了。 + 处暑：处是住的意思，表示暑气到此为止。 + 白露：地面水气凝结为露，色白，是天气开始转凉了。 + 秋分：秋季九十天的中间，这一天昼夜相等，同春分一样，太阳从正东升起正西落下。 + 寒露：水露先白而后寒，是气候将逐渐转冷的意思。 + 霜降：水气开始凝结成霜。 + 立冬：冬是终了，作物收割后要收藏起来的意思，这一天起冬天开始。 + 小雪：开始降雪，但还不多。 + 大雪：雪量由小增大。 + 冬至：这一天中午太阳在天空中位置最低，日影最长，白天最短， 黑夜最长，古代又称短日至或日南至。 + 小寒：冷气积久而为寒，此时尚未冷到顶点。 + 大寒：天候达到最寒冷的程度 + + + + + 获取年柱。 + + + + + 获得月柱 + + + + + + + 获取日柱。 + + + + + 返回甲子数x对应的天干数（如33为3） + + + + + 返回甲子数x对应的地支数（如33为9） + + + + + 获取日的天干地支 + + + + + + + 返回甲子数x对应的天干字符串 + + + + + 返回甲子数x对应的地支字符串 + + + + + 返回甲子数x对应的干支字符串 + + + + + + + 获取三伏开始时间 + + + 0表示1伏，1表示2伏，2表示3伏 + + + + + 节气 + + + + + 节气的时间。 + + + + + 节气名。 + + + + + 热键转换类 + + + + + 功能键。 + + + + + 修改键。 + + + + + 转换功能键到谷歌浏览器专用 + + + + + 将chrome功能键转换为普通功能键 + + + + + + + 按键值。 + + + + + 初始化类 的新实例。 + + The modifiers. + The key code. + + + + + + + + + + + + + + + + + 初始化类 的新实例。 + + + + + 加载热键 + + + + + + + 加载热键 + + + + + + 加载热键 + + + + + + 判断是否是热键 + + + + + 获取当前热键 + + + + + 已重载，返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 功能键 + + + + + 无 + + + + + Alt键 + + + + + Ctrl键 + + + + + Alt+Ctrl键 + + + + + Shift键 + + + + + Shift+Alt键 + + + + + Shift+Ctrl键 + + + + + Alt+Shift+Ctrl键 + + + + + Win键 + + + + + 热键类 + + + + + 热键类 + + + + + + 热键注销 + + + + + 热键是否有效 + + + + + 释放热键 + + + + + 获取热键Tag + + + + + + + 获取热键id + + + + + + + 获取热键id + + + + + + + + 判断热键id是否存在 + + + + + + + 判断热键Tag是否存在 + + + + + + + 判断热键是否存在 + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + + 获取热键数量 + + + + + 删除热键 + + + + + + + 删除所有热键 + + + + + 删除所有热键 + + + + + 热键事件 + + + + + + 当使用热键时发生的事件 + + + + + 热键消息过滤 + + + + + + + 热键类型 + + + + + 热键id + + + + + 热键Tag + + + + + 功能键 + + + + + 普通键 + + + + + 热键类型 + + + + + + + + 热键类型 + + + + + + + + + 热键类型 + + + + + Win32 API + + + + + + + + + + WM_COPYDATA消息的主要目的是允许在进程间传递只读数据。 + + + + + 系统通道ID + + + + + 用户通道ID + + + + + 获取消息 + + + + + + + + 发送消息 + + + + + + + + + + 设置父窗口 + + + + + + + + + + + + + + 删除一个逻辑笔、画笔、字体、位图、区域或者调色板，释放所有与该对象有关的系统资源，在对象被删除之后，指定的句柄也就失效了。 + + + + + + + 选择一对象到指定的设备上下文环境中，该新对象替换先前的相同类型的对象。 + + + + + + + + 创建一个与指定设备兼容的内存设备上下文环境（DC）。 + + + + + + + 为一个设备创建设备上下文环境。 + + + + + + + + + + 删除指定的设备上下文环境（Dc）。 + + + + + + + + + + + + 结束进程 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 模拟鼠标点击 + + + + + + + + + + + 模拟按键 + + + + + + + + + 返回hWnd参数所指定的窗口的设备环境。 + + + + + + + 移动窗口 + + + + + + + + + + + + 将消息信息传送给指定的窗口过程的函数。使用函数CallWindowsProc可进行窗口子分类。 + 通常来说，同一类的所有窗口共享一个窗口过程。子类是一个窗口或者相同类的一套窗口， + 在其消息被传送到该类的窗口过程之前，这些消息是由另一个窗口过程进行解释和处理的。 + + + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 设置弹出式窗口，层叠窗口或子窗口的父窗口 + + + + + + + + 获得一个指定子窗口的父窗口句柄 + + Handle to the window whose parent window handle is to be retrieved. + If the window is a child window, the return value is a handle to the parent window. If the window is a top-level window, the return value is a handle to the owner window. If the window is a top-level unowned window or if the function fails, the return value is NULL. + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作 + + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作。 + 如果此参数为FALSE，GetSystemMenu返回当前使用窗口菜单的拷贝的句柄。该拷贝初始时与窗口菜单相同，但可以被修改。 + 如果此参数为TRUE，GetSystemMenu重置窗口菜单到缺省状态。如果存在先前的窗口菜单，将被销毁。 + + 如果参数bRevert为FALSE，返回值是窗口菜单的拷贝的句柄：如果参数bRevert为TRUE，返回值是NULL。 + + + + 从指定菜单删除一个菜单项或分离一个子菜单。 + 备注：只要一个菜单被修改，无论它是否在显示窗口里，应用程序都必须调用函数DrawMenuBar。 + + 将被修改的菜单的句柄。 + 指定将被删除的菜单项，其含义由参数wFlags决定。 + + 如果函数调用成功，返回非零值；如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。 + + + + 设置前台窗口 + + + + + + + 获取当前前台窗口句柄 + + + + + + 获得当前活动窗体 + + 活动窗口的句柄。如没有窗口处于活动状态或处于活动状态的窗口非当前线程创建，则返回零。 + + + + 设置活动窗体 + + + + + + + 获取类名 + + + + + + + + + 获取当前线程对应的进程ID + + + + + + + + 判断指定句柄是否是一个窗口 + + + + + + + 获取窗口标题 + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + 从文件中载入指针 + + + + + + + 判断窗口是否可见 + + + + + + + 查找窗口 + + + + + + + + The FindWindowEx function retrieves a handle to a window whose class name and window name match the specified strings. The function searches child windows, beginning with the one following the specified child window. + + Handle to the parent window whose child windows are to be searched. + Handle to a child window. + Specifies class name. + Pointer to a null-terminated string that specifies the window name (the window's title). + If the function succeeds, the return value is a handle to the window that has the specified class and window names.If the function fails, the return value is NULL. + + + + The InvalidateRect function adds a rectangle to the specified window's update region. + + Handle to window. + Rectangle coordinates. + Erase state. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + The ValidateRect function validates the client area within a rectangle by removing the rectangle from the update region of the specified window. + + Handle to window. + Validation rectangle coordinates. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + 获取指定窗口的有关信息，也可用于获取窗口内存中指定偏移的32位度整型值。 + + + + + + + + 检索一指定窗口的客户区域或整个屏幕的显示设备上下文环境的句柄，以后可以在GDI函数中使用该句柄来在设备上下文环境中绘图。 + + + + + + + 释放设备上下文环境（DC）供其他应用程序使用。函数的效果与设备上下文环境类型有关。它只释放公用的和设备上下文环境，对于类或私有的则无效。 + + + + + + + + 获取桌面句柄 + + + + + + 获取窗口客户区的大小。注意一下：窗口的客户区为窗口中除标题栏、菜单栏之外的地方。 + + + + + + + + 返回指定窗口的边框矩形的尺寸。该尺寸以相对于屏幕坐标左上角的屏幕坐标给出。 + + + + + + + + 更新一个分层窗口的位置，大小，形状，内容和半透明度 + + + + + + + + + + + + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + + + + + + + + + + + + 设置指针位置 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使用的数据库接口 + + + + + 使用的数据库连接字符串 + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 使用的数据库接口 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + FTP数据管理类(不含上传下载功能) + + + + + + + + + + + + 获取指定id的FTP信息 + + + + + + + 获取指定name的FTP信息 + + + + + + + 打开FTP管理界面 + + + + + 创建SQLite数据库表 + + + + + FTP信息 + + + + + id + + + + + 名称 + + + + + IP + + + + + 端口 + + + + + 用户名 + + + + + 密码 + + + + + 远程目录 + + + + + 加密方式 + + + + + 添加时间 + + + + + + + + + + 备注 + + + + + 添加时间字符串 + + + + + 设置 + + + + + 部门列表 + + + + + + + + + + 远程文件信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 升级地址 + + + + + + + + + + 隔多久后再次检查更新 + + + + + 本地保存的配置信息 + + + + + 当前安装的软件版本 + + + + + 当前安装的软件修正版本 + + + + + 当前安装的数据库版本 + + + + + + + + + + + + + + + + + + + + 获取当前更新的类型 + + + + + 每隔n小时检测一次更新 + + + + + 读取版本信息完成后激发 + + + + + 没有版本更新时激发 + + + + + 发现新版本时激发 + + + + + 发生错误后激发 + + + + + 更新进度变化后激发 + + + + + 开始检测新版本 + + + + + + + + + + 初始化升级函数 + + 为null,则表示事件运行在多线程模式下，否则,事件是在窗体所在线程下 + + + + + + + + + + + + + + 获取版本信息 + + + + + 开始下载 + + + + + 开始下载 + + + + + 下载,不使用多线程 + + + + + 结束下载 + + + + + + + + + + + + + + + 设置升级 + + + + + 是否是在线更新 + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + 提示文本 + + + + + 更新日期 + + + + + 更新版本 + + + + + 更新描述 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新类型,soft或者data + + + + + 更新描述Url + + + + + 更新描述 + + + + + 版本 + + + + + 更新日期 + + + + + 更新地址 + + + + + 在下载升级包前首先要下载的内容 + + + + + 升级程序要使用的设置xml + + + + + + + + + + 错误字符串 + + + + + 错误id + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前登陆用户 + + + + + + + + + + 没有版本更新时激发 + + + + + + + + + + + 取消更新。 + + + + + + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 Docking 的本地化字符串。 + + + + + 查找类似 Docking Notification 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 Property Changed 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 Determines if end user drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 Enable/Disable the close button of the content. 的本地化字符串。 + + + + + 查找类似 Shows or hides the close button of the content. This property does not function with System MDI Document Style. 的本地化字符串。 + + + + + 查找类似 The form must be of type IDockContent. 的本地化字符串。 + + + + + 查找类似 Gets or sets a value indicating in which area of the DockPanel the content allowed to show. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of DockState property changed. 的本地化字符串。 + + + + + 查找类似 Indicates the content will be hidden instead of being closed. 的本地化字符串。 + + + + + 查找类似 The desired docking state when first showing. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找类似 The tab text displayed in the dock pane. If not set, the Text property will be used. 的本地化字符串。 + + + + + 查找类似 The text displayed when mouse hovers over the tab. 的本地化字符串。 + + + + + 查找类似 The provided value is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Value: The value of DockAreas conflicts with current DockState. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 Invalid value, conflicts with DockableAreas property. 的本地化字符串。 + + + + + 查找类似 The dock state is invalid. 的本地化字符串。 + + + + + 查找类似 The dock panel is null. 的本地化字符串。 + + + + + 查找类似 Invalid beforeContent, it must be contained by the pane. 的本地化字符串。 + + + + + 查找类似 Invalid DockState: Content can not be showed as "Unknown" or "Hidden". 的本地化字符串。 + + + + + 查找类似 The previous pane is invalid. It can not be null, and its docking state must not be auto-hide. 的本地化字符串。 + + + + + 查找类似 DockPanel can not be null. 的本地化字符串。 + + + + + 查找类似 The Pane can not be null. 的本地化字符串。 + + + + + 查找类似 Invalid value, check DockableAreas property. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Press SHIFT for docking to full side. 的本地化字符串。 + + + + + 查找类似 Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid argument: Content can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid argument: The content's DockPanel can not be "null". 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 The specified container conflicts with the IsFloat property. 的本地化字符串。 + + + + + 查找类似 The previous pane does not exist in the nested docking pane collection. 的本地化字符串。 + + + + + 查找类似 The container can not be null. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be null when the nested docking pane collection is not empty. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be itself. 的本地化字符串。 + + + + + 查找类似 FloatWindow property can not be set to "null" when DockState is DockState.Float. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid Content: Content not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 The state for the dock pane is invalid. 的本地化字符串。 + + + + + 查找类似 Auto Hide 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window Position 的本地化字符串。 + + + + + 查找类似 Invalid Content: The content must be auto-hide state and associates with this DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of the AutoHideWindow's ActiveContent changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveContentProperty changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveDocument property changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActivePane property changed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop nested docking is allowed. 的本地化字符串。 + + + + + 查找类似 Occurs when a content added to the DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when a content removed from the DockPanel. 的本地化字符串。 + + + + + 查找类似 The default size of float window. 的本地化字符串。 + + + + + 查找类似 Provides Visual Studio .Net style docking. 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The visual skin to use when displaying the docked windows. 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The style of the document window. 的本地化字符串。 + + + + + 查找类似 Determines where the tab strip for Document style content is drawn. 的本地化字符串。 + + + + + 查找类似 The DockPanel has already been initialized. 的本地化字符串。 + + + + + 查找类似 The configuration file's version is invalid. 的本地化字符串。 + + + + + 查找类似 The XML file format is invalid. 的本地化字符串。 + + + + + 查找类似 Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form. 的本地化字符串。 + + + + + 查找类似 DockPanel configuration file. Author: Weifen Luo, all rights reserved. 的本地化字符串。 + + + + + 查找类似 !!! AUTOMATICALLY GENERATED FILE. DO NOT MODIFY !!! 的本地化字符串。 + + + + + 查找类似 Indicates whether the control layout is right-to-left when the RightToLeft property is set to Yes. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Shows the hidden autohide content when hovering over the tab. When disabled, the tab must be clicked to show the content. 的本地化字符串。 + + + + + 查找类似 Show close button on each tab 的本地化字符串。 + + + + + 查找类似 Determines if the document icon will be displayed in the tab strip. 的本地化字符串。 + + + + + 查找类似 Support deeply nested controls. Disabling this setting may improve resize performance but may cause heavily nested content not to resize. 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window List 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid argument: DockPanel can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid DockPanel. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 停靠 的本地化字符串。 + + + + + 查找类似 停靠通知 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 属性已更改 的本地化字符串。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 确定是否允许最终用户拖放停靠 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 启用/禁用DockContent的关闭按钮。 的本地化字符串。 + + + + + 查找类似 显示或隐藏DockContent的关闭按钮。此属性不适用于系统MDI文档样式。 的本地化字符串。 + + + + + 查找类似 窗体的类型必须为IDockContent。 的本地化字符串。 + + + + + 查找类似 获取或设置一个值，该值指示允许在DockPanel的哪个区域显示内容。 的本地化字符串。 + + + + + 查找类似 当DockState属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 指示DockContent将隐藏而不是关闭。 的本地化字符串。 + + + + + 查找类似 首次显示时所需的停靠状态。 的本地化字符串。 + + + + + 查找类似 显示停靠窗格选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 停靠窗格中显示的选项卡文本。如果未设置，将使用Text属性。 的本地化字符串。 + + + + + 查找类似 鼠标悬停在选项卡上时显示的文本。 的本地化字符串。 + + + + + 查找类似 提供的值超出范围。 的本地化字符串。 + + + + + 查找类似 无效值：DockAreas的值与当前DockState冲突。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 无效值，与DockableAreas属性冲突。 的本地化字符串。 + + + + + 查找类似 停靠状态无效。 的本地化字符串。 + + + + + 查找类似 DockPanel 为 null 的本地化字符串。 + + + + + 查找类似 beforeContent无效，它必须包含在pane中。 的本地化字符串。 + + + + + 查找类似 DockState无效：DockContent不能显示为“未知”或“隐藏”。 的本地化字符串。 + + + + + 查找类似 上一个Pane无效。它不能为null，其停靠状态不能自动隐藏。 的本地化字符串。 + + + + + 查找类似 DockPanel不能为null。 的本地化字符串。 + + + + + 查找类似 Pane不能为null。 的本地化字符串。 + + + + + 查找类似 无效值，请检查DockableAreas属性。 的本地化字符串。 + + + + + 查找类似 显示DockPanel选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 按SHIFT键以停靠到完全侧。 的本地化字符串。 + + + + + 查找类似 无效内容：ActiveContent必须是可见内容之一，如果没有可见内容，则为null。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent的DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 指定的容器与IsFloat属性冲突。 的本地化字符串。 + + + + + 查找类似 嵌套DockPanel集合中不存在上一个Pane。 的本地化字符串。 + + + + + 查找类似 容器不能为空。 的本地化字符串。 + + + + + 查找类似 当嵌套DockPanel集合不为空时，上一个Pane不能为空。 的本地化字符串。 + + + + + 查找类似 上一个Pane不能是其本身。 的本地化字符串。 + + + + + 查找类似 当DockState为DockState.Float时，FloatWindow属性不能设置为“null”。 的本地化字符串。 + + + + + 查找类似 无效内容：内容不在集合中。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 DockPanel的状态无效。 的本地化字符串。 + + + + + 查找类似 自动隐藏 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 属性 的本地化字符串。 + + + + + 查找类似 无效DockContent：DockContent必须为自动隐藏状态并与此DockPanel关联。 的本地化字符串。 + + + + + 查找类似 当AutoHideWindow的ActiveContent值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveContentProperty值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveDocument属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActivePane属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放停靠。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放嵌套停靠。 的本地化字符串。 + + + + + 查找类似 当DockContent添加到DockPanel时发生。 的本地化字符串。 + + + + + 查找类似 从DockPanel中删除DockContent时发生。 的本地化字符串。 + + + + + 查找类似 浮动窗口的默认大小。 的本地化字符串。 + + + + + 查找类似 提供Visual Studio.Net样式的停靠。 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 显示停靠窗口时要使用的视觉外观。 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 在停靠面板中拖动文档或Pane时发生。 的本地化字符串。 + + + + + 查找类似 文档窗口的样式。 的本地化字符串。 + + + + + 查找类似 确定绘制文档样式内容的选项卡栏的位置。 的本地化字符串。 + + + + + 查找类似 DockPanel已初始化。 的本地化字符串。 + + + + + 查找类似 配置文件的版本无效。 的本地化字符串。 + + + + + 查找类似 XML文件格式无效。 的本地化字符串。 + + + + + 查找类似 父窗体无效。使用DockingMdi或SystemMdi文档样式时，DockPanel控件必须是主MDI容器窗体的子控件。 的本地化字符串。 + + + + + 查找类似 DockPanel配置文件。作者：罗伟芬，版权所有。 的本地化字符串。 + + + + + 查找类似 !!! 自动生成的文件。不要修改！！！ 的本地化字符串。 + + + + + 查找类似 指示当RightToLeft属性设置为“是”时，控件布局是否从右向左。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 悬停在选项卡上时显示隐藏的自动隐藏内容。禁用时，必须单击选项卡才能显示内容。 的本地化字符串。 + + + + + 查找类似 在每个选项卡上显示关闭按钮 的本地化字符串。 + + + + + 查找类似 确定是否在选项卡栏中显示文档图标。 的本地化字符串。 + + + + + 查找类似 支持深度嵌套控件。禁用此设置可能会提高调整大小的性能，但可能会导致嵌套严重的内容无法调整大小。 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 窗口列表 的本地化字符串。 + + + + + 查找类似 无效参数：DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 无效DockPanel. 的本地化字符串。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置是否捕获鼠标 + + + + + 获取或设置是否显示图像信息 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框边框颜色 + + + + + 获取或设置放大图形的原始尺寸 + + + + + 获取或设置放大图像的倍数 + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置用于被操作的图像 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框线条的颜色 + + + + + 获取当前选中的区域 + + + + + 获取或设置放大图像的原图大小尺寸 + + + + + 获取或设置图像放大的倍数 + + + + + 获取或设置是否绘制操作框点 + + + + + 获取或设置是否限制鼠标操作区域 + + + + + 获取或设置是否绘制信息展示 + + + + + 获取或设置是否根据图像大小自动调整控件尺寸 + + + + + 获取当前是否绘制的有区域 + + + + + 获取当前是否开始绘制 + + + + + 获取当前操作框是否正在移动 + + + + + 获取或设置操作框是否锁定 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 响应四个按键实现精确移动 + + + + + + + + + + + + 绘制操作框 + + + + + + 绘制图像放大信息 + + + + + + 清空所有操作 + + + + + 手动设置一个块选中区域 + + 要选中区域 + + + + 手动设置一个块选中区域 + + 要选中区域的坐标 + 要选中区域的大小 + + + + 手动设置一个块选中区域 + + 要选中区域的x坐标 + 要选中区域的y坐标 + 要选中区域的宽度 + 要选中区域的高度 + + + + 手动设置信息显示的位置 + + 要显示的位置 + + + + 手动设置信息显示的位置 + + 要显示位置的x坐标 + 要显示位置的y坐标 + + + + 获取操作框内的图像 + + 结果图像 + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标结构信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置Hook + + + + + + 卸载Hook + + + + + + 鼠标状态枚举值 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Martin Lottering : 2007-10-27 + -------------------------------- + This is a usefull control in Filters. Allows you to save space and can replace a Grouped Box of CheckBoxes. + Currently used on the TasksFilter for TaskStatusses, which means the user can select which Statusses to include + in the "Search". + This control does not implement a CheckBoxListBox, instead it adds a wrapper for the normal ComboBox and Items. + See the CheckBoxItems property. + ---------------- + ALSO IMPORTANT: In Data Binding when setting the DataSource. The ValueMember must be a bool type property, because it will + be binded to the Checked property of the displayed CheckBox. Also see the DisplayMemberSingleItem for more information. + ---------------- + Extends the CodeProject PopupComboBox "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp" + by Lukasz Swiatkowski. + + + + + + + + + + The checkbox list control. The public CheckBoxItems property provides a direct reference to its Items. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation and its formatting however is controlled + by the Binded object, since it owns that property. + + + + + Builds a CSV string of the items selected. + + + + + A direct reference to the Items of CheckBoxComboBoxListControl. + You can use it to Get or Set the Checked status of items manually if you want. + But do not manipulate the List itself directly, e.g. Adding and Removing, + since the list is synchronised when shown with the ComboBox.Items. So for changing + the list contents, use Items instead. + + + + + The DataSource of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + The ValueMember of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation however is controlled by the Binded + object, since it owns that property. + + + + + Made this property Browsable again, since the Base Popup hides it. This class uses it again. + Gets an object representing the collection of the items contained in this + System.Windows.Forms.ComboBox. + + A System.Windows.Forms.ComboBox.ObjectCollection representing the items in + the System.Windows.Forms.ComboBox. + + + + + + + + + + + + + + + + + Will add an invisible item when the style is DropDownList, + to help maintain the correct text in main TextBox. + + + + + + + + + + + + A function to clear/reset the list. + (Ubiklou : http://www.codeproject.com/KB/combobox/extending_combobox.aspx?msg=2526813#xx2526813xx) + + + + + Uncheck all items. + + + + + The properties that will be assigned to the checkboxes as default values. + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + A container control for the ListControl to ensure the ScrollBar on the ListControl does not + Paint over the Size grip. Setting the Padding or Margin on the Popup or host control does + not work as I expected. + + + + + + + + + + Prescribed by the Popup class to ensure Resize operations work correctly. + + + + + + This ListControl that pops up to the User. It contains the CheckBoxComboBoxItems. + The items are docked DockStyle.Top in this control. + + + + + + + + + + + Simply a reference to the CheckBoxComboBox. + + + + + A Typed list of ComboBoxCheckBoxItems. + + + + + + + + + + Prescribed by the Popup control to enable Resize operations. + + + + + + + + + + + + Maintains the controls displayed in the list by keeping them in sync with the actual + items in the combobox. (e.g. removing and adding as well as ordering) + + + + + The CheckBox items displayed in the Popup of the ComboBox. + + + + + + + A reference to the CheckBoxComboBox. + A reference to the item in the ComboBox.Items that this object is extending. + + + + A reference to the CheckBoxComboBox. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + When using Data Binding operations via the DataSource property of the ComboBox. This + adds the required Bindings for the CheckBoxes. + + + + + + + + + + + Added this handler because the control doesn't seem + to initialize correctly until shown for the first + time, which also means the summary text value + of the combo is out of sync initially. + + + + + A Typed List of the CheckBox items. + Simply a wrapper for the CheckBoxComboBox.Items. A list of CheckBoxComboBoxItem objects. + This List is automatically synchronised with the Items of the ComboBox and extended to + handle the additional boolean value. That said, do not Add or Remove using this List, + it will be lost or regenerated from the ComboBox.Items. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Returns the item with the specified displayName or Text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Called when any property changes. + + + + + + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com Simple pop-up control http://www.codeproject.com/cs/miscctrl/simplepopup.asp. + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Gets a value indicating whether the PopupControl.Popup uses the fade effect. + + true if pop-up uses the fade effect; otherwise, false. + To use the fade effect, the FocusOnOpen property also has to be set to true. + + + + Gets or sets a value indicating whether to focus the content after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether this PopupControl.Popup is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets the size that is the lower limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the size that is the upper limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the PopupControl.Popup class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows pop-up window below the specified area of specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Adjusts the size of the owner to accommodate the if the owner is currently displayed, or clears and resets active child controls of the if the is not currently displayed. + + true if the owner is currently displayed; otherwise, false. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + + + + + + + + + + + + + + + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the size grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the PopupControl.PopupComboBox class. + + + + + The pop-up wrapper for the dropDownControl. + Made PROTECTED instead of PRIVATE so descendent classes can set its Resizable property. + Note however the pop-up properties must be set after the dropDownControl is assigned, since this + popup wrapper is recreated when the dropDownControl is assigned. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Shows the drop down. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Maintains an additional "Selected" and "Count" value for each item in a List. + Useful in the CheckBoxComboBox. It holds a reference to the List[Index] Item and + whether it is selected or not. + It also caters for a Count, if needed. + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. And no Counts will be displayed + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + Is a Count indicator used. + + + + + The original List of values wrapped. A "Selected" and possibly "Count" functionality is added. + + + + + Used to indicate NOT to use ToString(), but read this property instead as a display value. + + + + + When specified, indicates that ToString() should not be performed on the items. + This property will be read instead. + This is specifically useful on DataTable implementations, where PropertyDescriptors are used to read the values. + + + + + Builds a concatenation list of selected items in the list. + + + + + Indicates whether the Item display value (Name) should include a count. + + + + + Reset all counts to zero. + + + + + Creates a ObjectSelectionWrapper item. + Note that the constructor signature of sub classes classes are important. + + + + + + + + + + + + + + Used together with the ListSelectionWrapper in order to wrap data sources for a CheckBoxComboBox. + It helps to ensure you don't add an extra "Selected" property to a class that don't really need or want that information. + + + + + + + + + + + + Used as a count indicator for the item. Not necessarily displayed. + + + + + Is this item selected. + + + + + A reference to the wrapped item. + + + + + The containing list for these selections. + + + + + An indicator of how many items with the specified status is available for the current filter level. + Thaught this would make the app a bit more user-friendly and help not to miss items in Statusses + that are not often used. + + + + + A reference to the item wrapped. + + + + + The item display value. If ShowCount is true, it displays the "Name [Count]". + + + + + The textbox display value. The names concatenated. + + + + + Indicates whether the item is selected. + + + + + + + + + + + + + + + + 控件的状态。 + + + + + 正常 + + + + + 鼠标经过 + + + + + 鼠标按下 + + + + + 鼠标的当前位置 + + + + + + + + + + + + + + + + + + + + 美化按钮 + + + + + 普通按钮矩形位置 + + + + + 美化按钮 + + + + + 分割按钮的宽度 + + + + + 是否启用分割按钮 + + + + + 优先使用默认皮肤 + + + + + 按钮基础背景色 + + + + + 按钮字体颜色 + + + + + 图片宽度,默认值为18px，最小12px + + + + + 圆角的位置,默认全部都是圆角 + + + + + 设置圆角半径 + + + + + 背景色是否渐变 + + + + + 图片高度 + + + + + 图片与文字之间的间距 + + + + + 当鼠标按下时图片和文字是否产生偏移 + + + + + 鼠标进入时 + + + + + + 鼠标离开 + + + + + + 鼠标按下 + + + + + + 鼠标弹起 + + + + + + 鼠标当前所在位置 + + + + + 获取图像以及文字的位置 + + + + + + + + + + + + + + + + + + + + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强版Label(禁用了双击Label会自动复制文本到剪切板的功能) + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强富文本控件 + + + + + 开始更新 + + + + + 结束更新 + + + + + RichTextBox + + + + + + + + + + + + + + + + + + + + + + + 在自带菜单弹出前激发 + + + + + 根据标签获得菜单项 + + + + + + + 只允许输入文本(只对设置之后的人工输入有效) + + + + + 按下按键 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标按下 + + + + + + + + + + + + + + + + + + 当文本框为空时,显示的内容。 + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 消息列表控件 + + + + + 最大高度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 增强时间控件 + + + + + 增强时间控件 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 选择文本框 + + + + + 选择文本框 + + + + + 按钮基础背景色 + + + + + 优先使用默认皮肤 + + + + + 选择的id + + + + + 选择的名称 + + + + + 选择的名称 + + + + + 字体 + + + + + 重新设置大小 + + + + + 在选择时激发 + + + + + 点击选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 建立圆角路径的样式。 + + + + + 四个角都不是圆角。 + + + + + 四个角都为圆角。 + + + + + 左边两个角为圆角。 + + + + + 右边两个角为圆角。 + + + + + 上边两个角为圆角。 + + + + + 下边两个角为圆角。 + + + + + 左下角为圆角。 + + + + + 右下角为圆角。 + + + + + 画图相关API + + + + + 建立带有圆角样式的路径。 + + 用来建立路径的矩形。 + 圆角的大小。 + 圆角的样式。 + 是否把矩形长宽减 1,以便画出边框。 + 建立的路径。 + + + + 窗体皮肤 + + + + + 窗体皮肤 + + + + + 标题属性 + + + + + 是否使用父窗口的图标 + + + + + 点击最小化按钮是最小化还是隐藏 + + + + + 最大化按钮 + + + + + 最小化按钮 + + + + + 标题栏关闭按钮是否显示 + + + + + 当窗口位于后台时，是否标注显示。 + + + + + + + + + + 标题栏字体颜色 + + + + + 标题栏不处于活动状态时的字体颜色 + + + + + 标题栏背景颜色 + + + + + 标题栏不处于活动状态时的背景颜色 + + + + + 是否允许拖拉窗体边缘来改变窗体大小 + + + + + + + + + + + 画边框 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 热键文本框 + + + + + 热键文本框 + + + + + + + + + + + + + + + + + 在控件大小变化时发生 + + + + + + 此属性无效 + + + + + 载入热键配置 + + + + + + 保存热键 + + + + + + 是否含义热键 + + + + + 读取或设置热键 + + + + + 功能键 + + + + + 热键按键 + + + + + KeyDown事件 + + + + + + KeyDown事件 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 可以改变文本行距（行间距）的Label + + + + + 行间距 + + + + + 可以改变文本行距（行间距）的Label + + + + + + + + + + 字体高度 + + + + + + + + + + 文本 + + + + + + + + + + + + + + + + + + + 图标列表控件 + + + + + 图标列表控件 + + + + + 图标大小 + + + + + 文本显示高度(从底部算起) + + + + + 默认图标 + + + + + 是否显示图标 + + + + + 是否显示网格线 + + + + + 角标图标合集 + + + + + 画项 + + + + + + 选择项的背景开始颜色 + + + + + 选择项的背景结束颜色 + + + + + 选择项的边框颜色 + + + + + 选择项的字体颜色 + + + + + 重绘选中时背景 + + + + + 重绘图标 + + + 区域大小 + + + + + + + + 重绘文本 + + + + + 获取文本对齐 + + + + + 水平滚动条滚动事件 + + + + + 垂直滚动条滚动事件 + + + + + + + + + + + 列表项 + + + + + 图标 + + + + + 角标图片序号,为-1表示无角标 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + 内容 + + + + + 网址 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 计算两个日期的时间间隔,返回的是日期值+ + + 时间值,将显示在返回的值里 + 参照时间 + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 控件边框颜色 + + + + + 控件背景颜色 + + + + + 圆角弧度大小 + + + + + 圆角风格 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 图标 + + + + + 标题 + + + + + 悬浮提示 + + + + + 标题颜色 + + + + + 设置按钮 + + + + + + + 判断和设置是否选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 绘制边框 + + 消息 + + + + 类说明：CContextMenuStrip控件的实现用来代替系统的ContextMenuStrip控件 + + + + + + + + + + + + + + + + 重写OnCreateControl + + + + + 重写OnPaint事件 + + + + + + CreateRoundedRectanglePath + + Rectangle + + + + + + 系统热键数据类。 + + + + + 系统热键数据类 + + + + + 使多行属性失效掉 + + + + + 使只读属性失效掉 + + + + + 获取热键文本 + + + + + 功能键 + + + + + 热键按键 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 在搜索时激发 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + + + + + + 文本为空时的显示效果 + + + + + 文本不选中 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + 字体 + + + + + 优先使用默认皮肤 + + + + + 背景色是否渐变 + + + + + 按钮基础背景色 + + + + + 按钮圆角部分背景颜色 + + + + + + + + + + 重新设置大小 + + + + + 点击搜索按钮 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 使用公共皮肤 + + + + + 按钮颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 皮肤公共类 + + + + + 是否使用默认皮肤 + + + + + 按钮皮肤 + + + + + 按钮皮肤类 + + + + + 背景颜色 + + + + + 字体颜色 + + + + + 是否颜色渐变 + + + + + 类说明：帮助类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 修改控件或窗体的边框，例如Textbox或是Form窗体 + + 消息 + 控件对象 + 边框像素 + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 图片所在上级域名 + + + + + 图片资源所在上级文件夹 + + + + + 根据不同前缀，加载不同格式图片。i:表示工程内置图片;s:表示T_ImageDomain域名下的图片,u:表示指定url的图片;f:表示本地图片 + + + + + + 加载本地图片,加载完毕不会占用本地图片 + + + + + + 加载指定url图片 + + url位置 + 是否异步 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 选项发生变化时激发 + + + + + 标签选择的序号 + + + + + + + + + + 选择的颜色 + + + + + 多标签控件颜色 + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 获取对应的标签 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获得当前进程，以便重绘控件 + + + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点边框颜色 + + + + + 是否鼠标MouseOver状态 + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点时边框颜色 + + + + + + + + + + 鼠标移动到该控件上时 + + + + + + 当鼠标从该控件移开时 + + + + + + 当该控件获得焦点时 + + + + + + 当该控件失去焦点时 + + + + + + 获得操作系统消息 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 美化文本框控件 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + 是否只能输入数字 + + + + + 是否多行 + + + + + 是否在显示不下时换行 + + + + + 最大长度 + + + + + + + + + + 背景颜色 + + + + + 右键菜单 + + + + + 字体颜色 + + + + + 选择的开始位置 + + + + + 选择的长度 + + + + + 选择的文本 + + + + + 提示文本 + + + + + 选择全部 + + + + + 密码 + + + + + 是否只读 + + + + + + + + + + + 文本为空时的显示效果 + + + + + 字体 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + + + + + + 选择文本框中的文本范围 + + 文本框中当前选定文本的第一个字符的位置。 + 要选择的字符数 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Define some Windows message constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This class adds to the functionality provided in System.Windows.Forms.MenuStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + This class adds to the functionality provided in System.Windows.Forms.ToolStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 透明图片控件 + + + + + 是否使用透明,默认为True + + + + + 设置透明度 + + + + + 要绑定的控件 + + + + + 透明图片控件 + + + + + 图片 + + + + + 初始化加载控件 + + 透明度 + 是否显示加载图片 + 图片 + + + + + + + + + + + + + + + 显示加载 + + + + + 隐藏加载 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日历控件 + + + + + 单击事件 + + + + + + + 单击某个日期事件 + + + + + 日历控件 + + + + + 设置日期 + + + + + 放假数据表 + + + + + 是否处于设计模式 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日控件 + + + + + 日控件 + + + + + 当前日期 + + + + + 在发生页码变化前激发 + + + + + 设置休息状态,1为休息,-1为上班，其它为不显示 + + + + + + 日期 + + + + + 农历 + + + + + 阳历日期字体颜色 + + + + + 阳历日期字体 + + + + + 农历日期字体 + + + + + 农历部分字体颜色 + + + + + 是否选中 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + 类 名:ColorHSL + 功 能:H 色相 \ S 饱和度(纯度) \ L 亮度 颜色模型 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + HSL颜色 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 饱和度 + + + + + 类 名:ColorHSV + 功 能:H 色相 \ S 饱和度(纯度) \ V 明度 颜色模型 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 明度 + + + + + 类 名:ColorRGB + 功 能:R 红色 \ G 绿色 \ B 蓝色 颜色模型 + 所有颜色模型的基类,RGB是用于输出到屏幕的颜色模式,所以所有模型都将转换成RGB输出 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + + + + + + + 红色 + + + + + 绿色 + + + + + 蓝色 + + + + + 获取实际颜色 + + + + + + 类 名:ColorHelper + 功 能:提供从RGB到HSV/HSL色彩空间的相互转换 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + RGB转换HSV + + + + + + + HSV转换RGB + + + + + + + RGB转换HSL + + + + + + + HSL转换RGB + + H, S and L input range = 0 -1.0 + + + + + RGB转CMYK + + + + + + + + + + RGB转CMYK + + + + + + + + + + + + CMYK转RGB + + + + + + + + + + Standard-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Standard-RGB,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Adobe-RGB,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Adobe-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Yxy转RGB + + + + + + + + + RGB转Yxy + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 超级颜色选择控件 + + + 分页控件 + + + + + + + + + + + + + + + + + + + + + + + + + + 获取网页颜色 + + + + + 超级颜色选择控件 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Chrome风格的多标签控件 + + + + + 设置选项卡处于选中状态时第一背景色. + + + + + 设置选项卡处于选中状态时第二背景色. + + + + + 设置选项卡处于非选中状态时第一背景色. + + + + + 设置选项卡处于非选中状态时第二背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第一背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第二背景色. + + + + + 设置选项卡工作区背景色. + + + + + 设置选项卡工作区背景图. + + + + + 是否显示关闭按钮 + + + + + 是否显示新增按钮 + + + + + 是否允许拖拽标签 + + + + + 标签最大宽度 + + + + + 标签右键菜单 + + + + + 鼠标按下标签时激发 + + + + + 鼠标放开标签时激发 + + + + + Chrome风格的多标签控件 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置圆角半径 + + + + + Tab文字左边距离 + + + + + + + + + + + + + + 画标签文字 + + + + + + + + + 画标签图标 + + + + + + + 画关闭按钮 + + + + + + + + 获取所有选项卡合起来的宽度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 添加新标签 + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + The position is not over a tab. + + + + + The position is over a tab's icon. + + + + + The position is over a tab's text. + + + + + The position is over a tab but not over its icon or its text. For owner-drawn tab controls, this value is specified if the position is anywhere over a tab. + TCHT_ONITEM is a bitwise-OR operation on TCHT_ONITEMICON and TCHT_ONITEMLABEL. + + + + + Specifies values from SetWindowPosZ enumeration. + + + + + Specified HWND_TOP enumeration value. + + + + + Specified HWND_BOTTOM enumeration value. + + + + + Specified HWND_TOPMOST enumeration value. + + + + + Specified HWND_NOTOPMOST enumeration value. + + + + + Invalidates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_INVALIDATE invalidates the entire window. + + + + Causes the OS to post a WM_PAINT message to the window regardless of whether a portion of the window is invalid. + + + + Causes the window to receive a WM_ERASEBKGND message when the window is repainted. + Specify this value in combination with the RDW_INVALIDATE value; otherwise, RDW_ERASE has no effect. + + + + + Validates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_VALIDATE validates the entire window. + This value does not affect internal WM_PAINT messages. + + + + Suppresses any pending WM_ERASEBKGND messages. + + + Excludes child windows, if any, from the repainting operation. + + + Includes child windows, if any, in the repainting operation. + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND and WM_PAINT messages before the RedrawWindow returns, if necessary. + + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND messages before RedrawWindow returns, if necessary. + The affected windows receive WM_PAINT messages at the ordinary time. + + + + + Specifies values from Msgs enumeration. + + + + + Specified WM_NULL enumeration value. + + + + + Specified WM_CREATE enumeration value. + + + + + Specified WM_DESTROY enumeration value. + + + + + Specified WM_MOVE enumeration value. + + + + + Specified WM_SIZE enumeration value. + + + + + Specified WM_ACTIVATE enumeration value. + + + + + Specified WM_SETFOCUS enumeration value. + + + + + Specified WM_KILLFOCUS enumeration value. + + + + + Specified WM_ENABLE enumeration value. + + + + + Specified WM_SETREDRAW enumeration value. + + + + + Specified WM_SETTEXT enumeration value. + + + + + Specified WM_GETTEXT enumeration value. + + + + + Specified WM_GETTEXTLENGTH enumeration value. + + + + + Specified WM_PAINT enumeration value. + + + + + Specified WM_CLOSE enumeration value. + + + + + Specified WM_QUERYENDSESSION enumeration value. + + + + + Specified WM_QUIT enumeration value. + + + + + Specified WM_QUERYOPEN enumeration value. + + + + + Specified WM_ERASEBKGND enumeration value. + + + + + Specified WM_SYSCOLORCHANGE enumeration value. + + + + + Specified WM_ENDSESSION enumeration value. + + + + + Specified WM_SHOWWINDOW enumeration value. + + + + + Specified WM_WININICHANGE enumeration value. + + + + + Specified WM_SETTINGCHANGE enumeration value. + + + + + Specified WM_DEVMODECHANGE enumeration value. + + + + + Specified WM_ACTIVATEAPP enumeration value. + + + + + Specified WM_FONTCHANGE enumeration value. + + + + + Specified WM_TIMECHANGE enumeration value. + + + + + Specified WM_CANCELMODE enumeration value. + + + + + Specified WM_SETCURSOR enumeration value. + + + + + Specified WM_MOUSEACTIVATE enumeration value. + + + + + Specified WM_CHILDACTIVATE enumeration value. + + + + + Specified WM_QUEUESYNC enumeration value. + + + + + Specified WM_GETMINMAXINFO enumeration value. + + + + + Specified WM_PAINTICON enumeration value. + + + + + Specified WM_ICONERASEBKGND enumeration value. + + + + + Specified WM_NEXTDLGCTL enumeration value. + + + + + Specified WM_SPOOLERSTATUS enumeration value. + + + + + Specified WM_DRAWITEM enumeration value. + + + + + Specified WM_MEASUREITEM enumeration value. + + + + + Specified WM_DELETEITEM enumeration value. + + + + + Specified WM_VKEYTOITEM enumeration value. + + + + + Specified WM_CHARTOITEM enumeration value. + + + + + Specified WM_SETFONT enumeration value. + + + + + Specified WM_GETFONT enumeration value. + + + + + Specified WM_SETHOTKEY enumeration value. + + + + + Specified WM_GETHOTKEY enumeration value. + + + + + Specified WM_QUERYDRAGICON enumeration value. + + + + + Specified WM_COMPAREITEM enumeration value. + + + + + Specified WM_GETOBJECT enumeration value. + + + + + Specified WM_COMPACTING enumeration value. + + + + + Specified WM_COMMNOTIFY enumeration value. + + + + + Specified WM_WINDOWPOSCHANGING enumeration value. + + + + + Specified WM_WINDOWPOSCHANGED enumeration value. + + + + + Specified WM_POWER enumeration value. + + + + + Specified WM_COPYDATA enumeration value. + + + + + Specified WM_CANCELJOURNAL enumeration value. + + + + + Specified WM_NOTIFY enumeration value. + + + + + Specified WM_INPUTLANGCHANGEREQUEST enumeration value. + + + + + Specified WM_INPUTLANGCHANGE enumeration value. + + + + + Specified WM_TCARD enumeration value. + + + + + Specified WM_HELP enumeration value. + + + + + Specified WM_USERCHANGED enumeration value. + + + + + Specified WM_NOTIFYFORMAT enumeration value. + + + + + Specified WM_CONTEXTMENU enumeration value. + + + + + Specified WM_STYLECHANGING enumeration value. + + + + + Specified WM_STYLECHANGED enumeration value. + + + + + Specified WM_DISPLAYCHANGE enumeration value. + + + + + Specified WM_GETICON enumeration value. + + + + + Specified WM_SETICON enumeration value. + + + + + Specified WM_NCCREATE enumeration value. + + + + + Specified VK_RMENU enumeration value. + + + + + Specified WM_NCCALCSIZE enumeration value. + + + + + Specified WM_NCHITTEST enumeration value. + + + + + Specified WM_NCPAINT enumeration value. + + + + + Specified WM_NCACTIVATE enumeration value. + + + + + Specified WM_GETDLGCODE enumeration value. + + + + + Specified WM_SYNCPAINT enumeration value. + + + + + Specified WM_NCMOUSEMOVE enumeration value. + + + + + Specified WM_NCLBUTTONDOWN enumeration value. + + + + + Specified WM_NCLBUTTONUP enumeration value. + + + + + Specified WM_NCLBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCRBUTTONDOWN enumeration value. + + + + + Specified WM_NCRBUTTONUP enumeration value. + + + + + Specified WM_NCRBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCMBUTTONDOWN enumeration value. + + + + + Specified WM_NCMBUTTONUP enumeration value. + + + + + Specified WM_NCMBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCXBUTTONDOWN enumeration value. + + + + + Specified WM_NCXBUTTONUP enumeration value. + + + + + Specified WM_KEYDOWN enumeration value. + + + + + Specified WM_KEYUP enumeration value. + + + + + Specified WM_CHAR enumeration value. + + + + + Specified WM_DEADCHAR enumeration value. + + + + + Specified WM_SYSKEYDOWN enumeration value. + + + + + Specified WM_SYSKEYUP enumeration value. + + + + + Specified WM_SYSCHAR enumeration value. + + + + + Specified WM_SYSDEADCHAR enumeration value. + + + + + Specified WM_KEYLAST enumeration value. + + + + + Specified WM_IME_STARTCOMPOSITION enumeration value. + + + + + Specified WM_IME_ENDCOMPOSITION enumeration value. + + + + + Specified WM_IME_COMPOSITION enumeration value. + + + + + Specified WM_IME_KEYLAST enumeration value. + + + + + Specified WM_INITDIALOG enumeration value. + + + + + Specified WM_COMMAND enumeration value. + + + + + Specified WM_SYSCOMMAND enumeration value. + + + + + Specified WM_TIMER enumeration value. + + + + + Specified WM_HSCROLL enumeration value. + + + + + Specified WM_VSCROLL enumeration value. + + + + + Specified WM_INITMENU enumeration value. + + + + + Specified WM_INITMENUPOPUP enumeration value. + + + + + Specified WM_MENUSELECT enumeration value. + + + + + Specified WM_MENUCHAR enumeration value. + + + + + Specified WM_ENTERIDLE enumeration value. + + + + + Specified WM_MENURBUTTONUP enumeration value. + + + + + Specified WM_MENUDRAG enumeration value. + + + + + Specified WM_MENUGETOBJECT enumeration value. + + + + + Specified WM_UNINITMENUPOPUP enumeration value. + + + + + Specified WM_MENUCOMMAND enumeration value. + + + + + Specified WM_CTLCOLORMSGBOX enumeration value. + + + + + Specified WM_CTLCOLOREDIT enumeration value. + + + + + Specified WM_CTLCOLORLISTBOX enumeration value. + + + + + Specified WM_CTLCOLORBTN enumeration value. + + + + + Specified WM_CTLCOLORDLG enumeration value. + + + + + Specified WM_CTLCOLORSCROLLBAR enumeration value. + + + + + Specified WM_CTLCOLORSTATIC enumeration value. + + + + + Specified WM_MOUSEMOVE enumeration value. + + + + + Specified WM_LBUTTONDOWN enumeration value. + + + + + Specified WM_LBUTTONUP enumeration value. + + + + + Specified WM_LBUTTONDBLCLK enumeration value. + + + + + Specified WM_RBUTTONDOWN enumeration value. + + + + + Specified WM_RBUTTONUP enumeration value. + + + + + Specified WM_RBUTTONDBLCLK enumeration value. + + + + + Specified WM_MBUTTONDOWN enumeration value. + + + + + Specified WM_MBUTTONUP enumeration value. + + + + + Specified WM_MBUTTONDBLCLK enumeration value. + + + + + Specified WM_MOUSEWHEEL enumeration value. + + + + + Specified WM_XBUTTONDOWN enumeration value. + + + + + Specified WM_XBUTTONUP enumeration value. + + + + + Specified WM_XBUTTONDBLCLK enumeration value. + + + + + Specified WM_PARENTNOTIFY enumeration value. + + + + + Specified WM_ENTERMENULOOP enumeration value. + + + + + Specified WM_EXITMENULOOP enumeration value. + + + + + Specified WM_NEXTMENU enumeration value. + + + + + Specified WM_SIZING enumeration value. + + + + + Specified WM_CAPTURECHANGED enumeration value. + + + + + Specified WM_MOVING enumeration value. + + + + + Specified WM_DEVICECHANGE enumeration value. + + + + + Specified WM_MDICREATE enumeration value. + + + + + Specified WM_MDIDESTROY enumeration value. + + + + + Specified WM_MDIACTIVATE enumeration value. + + + + + Specified WM_MDIRESTORE enumeration value. + + + + + Specified WM_MDINEXT enumeration value. + + + + + Specified WM_MDIMAXIMIZE enumeration value. + + + + + Specified WM_MDITILE enumeration value. + + + + + Specified WM_MDICASCADE enumeration value. + + + + + Specified WM_MDIICONARRANGE enumeration value. + + + + + Specified WM_MDIGETACTIVE enumeration value. + + + + + Specified WM_MDISETMENU enumeration value. + + + + + Specified WM_ENTERSIZEMOVE enumeration value. + + + + + Specified WM_EXITSIZEMOVE enumeration value. + + + + + Specified WM_DROPFILES enumeration value. + + + + + Specified WM_MDIREFRESHMENU enumeration value. + + + + + Specified WM_IME_SETCONTEXT enumeration value. + + + + + Specified WM_IME_NOTIFY enumeration value. + + + + + Specified WM_IME_CONTROL enumeration value. + + + + + Specified WM_IME_COMPOSITIONFULL enumeration value. + + + + + Specified WM_IME_SELECT enumeration value. + + + + + Specified WM_IME_CHAR enumeration value. + + + + + Specified WM_IME_REQUEST enumeration value. + + + + + Specified WM_IME_KEYDOWN enumeration value. + + + + + Specified WM_IME_KEYUP enumeration value. + + + + + Specified WM_MOUSEHOVER enumeration value. + + + + + Specified WM_UNDO enumeration value. + + + + + Specified WM_RENDERFORMAT enumeration value. + + + + + Specified WM_RENDERALLFORMATS enumeration value. + + + + + Specified WM_DESTROYCLIPBOARD enumeration value. + + + + + Specified WM_DRAWCLIPBOARD enumeration value. + + + + + Specified WM_PAINTCLIPBOARD enumeration value. + + + + + Specified WM_VSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_SIZECLIPBOARD enumeration value. + + + + + Specified WM_ASKCBFORMATNAME enumeration value. + + + + + Specified WM_CHANGECBCHAIN enumeration value. + + + + + Specified WM_HSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_QUERYNEWPALETTE enumeration value. + + + + + Specified WM_PALETTEISCHANGING enumeration value. + + + + + Specified WM_PALETTECHANGED enumeration value. + + + + + Specified WM_HOTKEY enumeration value. + + + + + Specified WM_PRINT enumeration value. + + + + + Specified WM_PRINTCLIENT enumeration value. + + + + + Specified WM_HANDHELDFIRST enumeration value. + + + + + Specified WM_HANDHELDLAST enumeration value. + + + + + Specified WM_AFXFIRST enumeration value. + + + + + Specified WM_AFXLAST enumeration value. + + + + + Specified WM_PENWINFIRST enumeration value. + + + + + Specified WM_PENWINLAST enumeration value. + + + + + Specified WM_APP enumeration value. + + + + + Specified WM_USER enumeration value. + + + + + Specified WM_REFLECT enumeration value. + + + + + Specified WM_THEMECHANGED enumeration value. + + + + + + + + + + 关键词 + + + + + 密码 + + + + + 权限用户id + + + + + + + + + + + + + 返回关键词 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 树形控件，用于分类用 + + + + + 显示在第一位的名称 + + + + + 是否显示菜单 + + + + + 树形控件 + + + + + 判断指定节点是否是目标节点的子节点 + + + + + + + + + 判断当前节点，当前用户是否有权限访问 + + + + + + + + + 权限事件 + + + + + + + + 选择权限用户时发生 + + + + + 数据变化时发生 + + + + + 数据变化前发生 + + + + + 操作事件 + + + + + + + 在添加分组前发生 + + + + + 在修改分组前发生 + + + + + 在删除分组前发生 + + + + + 在设置密码前发生 + + + + + 在设置权限前发生 + + + + + 获取新的关键词分类 + + + + + + 根据id获取节点 + + + + + + + 根据节点获取节点信息 + + + + + + + 设置节点信息 + + + + + + + 设置节点关键词和密码 + + + + + + + + 设置节点密码 + + + + + + + 设置节点关键词 + + + + + + + 设置节点用户 + + + + + + + RecursionTreeControl:表示将XML文件的内容显示在TreeView控件中 + + 将要加载的XML文件中的节点元素 + 将要加载的XML文件中的节点集合 + + + + 把XML文本载入到列表中 + + + + + + 把XML文件载入到列表中 + + + + + + 将列表保存为xml文本 + + + + + + 改变所有子节点的状态 + + + + + + + 反选子节点 + + + + + + 根据关键词来选中列表 + + + + + + 根据关键词来选中列表 + + + + + + 格式化关键字(会去除重复项)，以便存入数据库 + + + + + + + 去除掉重复项 + + + + + + + 获取当前选中项以及所有父项的关键词组合 + + + + + + 获取选中的 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 是否为添加 + + + + + 选择的文本 + + + + + 选择的Tag + + + + + 选择的图片序号 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + 旧密码 + + + + + 新密码 + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 控件状态 + + + + + 无 + + + + + 获得焦点 + + + + + 失去焦点 + + + + + 鼠标指针进入控件 + + + + + Toolbar控件 + + + + + + + + + + + + + + + 获取或设置控件显示的图片 + + + + + 重写控件焦点属性 + + + + + 自定义绘制 + + + + + + 焦点进入 + + + + + + 失去焦点 + + + + + + 禁止调整大小 + + + + + + + + + + + + + + + + + + 只响应单击鼠标左键事件 + + + + + + 按比例缩放图片 + + + + + + + 图片缩放 + + 源图片 + 缩放图片的宽度 + 缩放图片的高度 + 缩放的图片 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 绘图对像 + + 绘图对像 + 图片 + 绘置的图片大小、坐标 + 绘置的图片边界 + 当前状态 + 状态总数 + + + + 绘图对像 + + 绘图对像 + 图片对像 + 绘置的图片大小、坐标 + 当前状态 + 状态总数 + + + + + + + + + 得到要绘置的图片对像 + + 图像在程序集中的地址 + + + + + 得到要绘置的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 获取资源图标 + + + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的地址 + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 颜色标签 + + + + + 行间距 + + + + + 颜色标签 + + + + + 更新 + + + + + 字体高度 + + + + + 控件高 + + + + + 控件文本 + + + + + 获取过滤掉颜色的字 + + + + + + + 改变字体 + + + + + + + + + + + + + + 分页控件 + + + + + 首页文本 + + + + + 上一页文本 + + + + + 下一页文本 + + + + + 末页文本 + + + + + 跳页文本 + + + + + 页面信息文本 + + + + + 存储SQL参数 + + + + + 最后一页的页码 + + + + + 在发生页码变化时激发 + + + + + 在发生页码变化前激发 + + + + + 设置/返回每页显示的量大小 + + + + + 设置/返回记录总数 + + + + + 设置/返回分页SQL语句,{pagecount}表示页数,{recordcount}表示记录总数,{pagesize}表示页面大小, + {pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 设置/返回当{recordnum}小于等于0时的分页SQL语句(比如第一页),如果为空，则默认使用SQLText值。{pagecount}表示页数, + {recordcount}表示记录总数,{pagesize}表示页面大小,{pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 获取当前页码 + + + + + + 设置分页语句 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取数据库指定条件的记录总数 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MySQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MySQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MSSQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MSSQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 获取SQLite数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 返回分页SQL语句 + + + + + 分页控件 + + + + + 设置当前页为指定页 + + + + + + 下一页 + + + + + 上一页 + + + + + 末页 + + + + + 首页 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 密码控件 + + + + + + + + + + 密码 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + This enum represents the possible browser commands + + + + + Used when no commans are available + + + + + Used in the new navigation events + + + + + The URL to navigate to + + + + + The name of the frame to navigate to + + + + + The flags when opening a new window + + + + + The pointer to ppDisp + + + + + Creates a new instance of WebBrowserExtendedNavigatingEventArgs + + Pointer to the automation object of the browser + The URL to go to + The name of the frame + The new window flags + + + + + + + + + Used in the new navigation events + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 查看源码 + + + + + 复制当前选中区 + + + + + 粘贴当前选中区 + + + + + 剪切当前选中区 + + + + + 全选 + + + + + 清除当前选中区的选中状态。 + + + + + 从当前选中区中删除全部超级链接。 + + + + + 从当前选中区中删除全部书签。 + + + + + 删除当前选中区 + + + + + 重做 + + + + + 撤销 + + + + + 从当前选中区中删除格式化标签。 + + + + + 点击节点 + + + + + + + + 点击节点 + + + + + + + + + 点击元素 + + 节点名 + 属性 + 属性值 + 等待毫秒数 + 第几个符合的元素,从1开始 + + + + 等待多时毫秒 + + + + + + Represents event information for the main form, when the command state of the active browser changes + + + + + Creates a new instance of the class + + A list of commands that are available + + + + Gets a list of commands that are available + + + + + An extended version of the control. + + + + + + + + + + + + 在页面弹出消息对话框时激发 + + + + + + + + + + + + + + + + + + + + + + 打开页面并等待页面加载完毕 + + 要打开的页面地址 + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待页面加载完毕 + + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待指定毫秒 + + 等待指定毫秒 + + + + 获取网页源代码,可以自动去除乱码 + + + + + + 加载html文本到浏览器中 + + + + + + + 加载html文本到浏览器中 + + + + + + 强制用本窗体打开新链接 + + + + + + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is created. + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is discarded. + + + + + Returns the automation object for the web browser + + + + + This method will be called to give you a chance to create your own event sink + + + + + Detaches the event sink + + + + + 在文档下载开始时激发 + + + + + Raises the event + + Empty + + You could start an animation or a notification that downloading is starting + + + + + 下载完成后触发 + + + Here you could start monitoring for script errors. + + + + + Raises the event + + Empty + + + + 在开始浏览新网页时激发. + + + + + 在打开新的网页窗口时激发 + + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 新窗口事件,只限Window XP SP2或以上系统支持 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Overridden + + The send to this procedure + + + + A list of all the available window messages + + + + + Raises the event + + + + + 在网页窗口关闭时激发 + + + Do not confuse this with DWebBrowserEvents2.Quit... That's something else. + + + + + Flags used by INewWindowManager::EvaluateNewWindow. + These values are taken into account in the decision of whether to display a pop-up window. + + + + + No information Present + + + + + The page is unloading. This flag is set in response to the onbeforeunload and onunload events. + Some pages load pop-up windows when you leave them rather than when you enter. This flag is used to identify those situations. + + + + + The call to INewWindowManager::EvaluateNewWindow is the result of a user-initiated action + (a mouse click or key press). Use this flag in conjunction with the NWMF_FIRST_USERINITED flag + to determine whether the call is a direct or indirect result of the user-initiated action. + + + + + When NWMF_USERINITED is present, this flag indicates that the call to + INewWindowManager::EvaluateNewWindow is the first query that results from this user-initiated action. + Always use this flag in conjunction with NWMF_USERINITED. + + + + + The override key (ALT) was pressed. The override key is used to bypass the pop-up manager梐llowing + all pop-up windows to display梐nd must be held down at the time that INewWindowManager::EvaluateNewWindow is called. + + + + + The new window attempting to load is the result of a call to the showHelp method. Help is sometimes displayed in a separate window, + and this flag is valuable in those cases. + + + + + The new window is a dialog box that displays HTML content. + + + + + Indicates that the EvaluateNewWindow method is being called through a marshalled Component Object Model (COM) proxy + from another thread. In this situation, the method should make a decision and return immediately without performing + blocking operations such as showing modal user interface (UI). Lengthy operations will cause the calling thread to + appear unresponsive. + + + + + HRESULT constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + a form that supports custom theme + + + + + 标签新建按钮事件 + + + + + 标签关闭按钮事件 + + + + + 标签创建时事件 + + + + + 标签激活前事件 + + + + + 标签激活后事件 + + + + + 在标签栏创建时激发 + + + + + + + 内边距 + + + + + 默认内边距 + + + + + 标题 + + + + + 皮肤/主题 + + + + + 是否可拖动改变窗体大小 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 标题栏高度 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 控制按钮相对于右上角的偏移量 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 标题栏图标尺寸 + + + + + 窗体图标,如果设置本项,将不使用Icon属性 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题距离左边的距离 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 是否显示阴影 + + + + + 窗体阴影宽度 + + + + + 使用阴影来缩放 + + + + + 窗体阴影颜色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区区域，坐标相对于窗体左上角 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区大小 + + + + + 表示MDI标签栏的区域，包括bottom-region + + + + + MGdUI皮肤 + + + + + + + + + + + + + + + + + 获取子窗体 + + + + + + 通过sendmessage方式激活子窗体以避免闪烁 + + + + + + 当子窗体关闭时激发 + + + + + + + 子窗体可视化变化 + + + + + + + 获取当前的子窗体列表 + + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最小化 + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最大化 + + + + + to make the client area to have 3D view + + + + + 双击事件 + + + + + 消息 + + + + + + 画UI + + + + + + 在画背景时激发 + + + + + + 重写该方法解决在VS设计器中，每次保存一个新的尺寸，再打开尺寸会变大的问题 + + + + + 创建控件时激发 + + + + + 窗体可见变化时激发 + + + + + + 大小改变时激发 + + + + + + 在位置变化时激发 + + + + + + 窗体激活 + + + + + + 窗体关闭后激发 + + + + + + 加载时 + + + + + + 在子窗体激活时激发 + + + + + + 标签菜单 + + + + + 窗体上移动鼠标时激发 + + + + + + 获取当前点击的标签项 + + + + + 在窗体上按下鼠标时激发 + + + + + + 在窗体上放开鼠标时激发 + + + + + + 在鼠标离开窗体时激发 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 该类处理mdi-bar的绘制及鼠标事件管理 + + + + + use left,top,right to location the bar in owner form, + the margin is from Form.ClientRectangle + + + + + 整个标签栏高度,包含标签栏底部区域、标签、标签顶部空隙 + + + + + 标签栏底部区域的高度 + + + + + 是否显示标签栏边框 + + + + + 是否显示标签栏背景 + + + + + 标签栏左内边距 + + + + + 标签栏右内边距 + + + + + 标签高度 + + + + + 激活的标签高度 + + + + + tab顶部与bar顶部的空间,这个值用来计算 BarHeight + + + + + 每个标签的左右边界可以不是垂直的，而是都有一个斜度 + + + + + tab与tab之间的距离，用负值可以使tab有重叠的效果 + + + + + 标签是否显示图标 + + + + + 是否显示标签关闭按钮 + + + + + 标签图标大小 + + + + + 标签图标距离左边的距离 + + + + + 标签文字距离左边的距离 + + + + + 标签关闭按钮的大小 + + + + + 标签关闭按钮距离右边的距离 + + + + + 是否显示新建标签按钮 + + + + + 新建标签按钮的大小 + + + + + 新建标签距离左边的距离 + + + + + 按钮与Bar底部的距离 + + + + + 一个tab允许的最小宽度 + + + + + 一个tab允许的最大显示宽度 + + + + + 标签正常宽度 + + + + + 同步_listTabItems与mdi主窗体实际存在的子form + + + + + 为每个tab分配空间，如果tab数目太多，则有些会被隐藏 + + + + + 重绘整个标签栏 + + + + + + 处理鼠标事件。该方法会触发一些click事件，重刷一些按钮等 + + + + + + + 该类表示一个单独的标签项 + + + + + 该标签所对应的窗体 + + + + + 最终分配到的整个tab的宽度 + + + + + 表示所对应的form是否仍未被关闭 + + + + + 是否因空间不足而被隐藏 + + + + + 返回全部显示该标签文本所需的长度 + + + + + + 返回显示全部文本时该tab所需的宽度,该宽度不超过bar-container + 规定的tabmaxwidth + + + + + + 居左 + + + + + 显示在最后一个标签后面 + + + + + 该类封装设置一个主题所需的信息，可以继承该类实现不同的主题 + + + + + 主题名称，用于标识主题，对主题进行简单描述 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 窗体标题栏高度 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题栏图标尺寸 + + + + + 标题栏文本左边距 + + + + + 控制按钮（关闭按钮）相对于窗体右上角的偏移量 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 是否使用默认的圆角样式，该样式为左上角和右上角圆角， + 最好在窗体边框较粗时才使用该样式 + + + + + 是否在标题栏上绘制图标 + + + + + 是否在标题栏上绘制文本 + + + + + 是否显示窗体阴影 + + + + + 窗体阴影大小 + + + + + 拖动窗体阴影是否可以改变窗体大小 + + + + + 阴影的颜色，可以设置成其他颜色而不一定是黑色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 是否在客户区边界画线使其看起来有立体感 + + + + + 窗体标题栏文字是否居中显示 + + + + + 窗体边框最外一像素的颜色 + + + + + 窗体边框第二最外像素的颜色 + + + + + 窗体边框其他部分颜色，如果窗体边框大小大于2，则其他像素将用此颜色画出 + + + + + 标题栏颜色是从上到下渐变的，这个值设置上边的颜色值 + + + + + 标题栏颜色是从上到下渐变的，这个值设置下边的颜色值 + + + + + 标题栏文字颜色 + + + + + 窗体背景颜色，该值将覆盖窗体自带的BackColor属性值 + + + + + 窗体关闭按钮的颜色集合 + + + + + 窗体最大化/还原按钮的颜色集合 + + + + + 窗体最小化按钮的颜色集合 + + + + + 默认状态下关闭按钮背景图片 + + + + + 鼠标移过去时关闭按钮背景图片 + + + + + 鼠标按下时关闭按钮背景图片 + + + + + 默认状态下最大化按钮背景图片 + + + + + 鼠标移过去时最大化按钮背景图片 + + + + + 鼠标按下时最大化按钮背景图片 + + + + + 默认状态下恢复按钮背景图片 + + + + + 鼠标移过去时恢复按钮背景图片 + + + + + 鼠标按下时恢复按钮背景图片 + + + + + 默认状态下最小化按钮背景图片 + + + + + 鼠标移过去时最小化按钮背景图片 + + + + + 鼠标按下时最小化按钮背景图片 + + + + + 是否用SendMessage的方式切换子窗体，以避免子窗体切换时产生的闪烁 + + + + + Mdi-Bar与窗体左、上、右边界的距离，只用到这三个值，Bottom值没用到。 + 用这三个值来确定Mdi-Bar的宽度及其在窗体中的位置 + + + + + 内部左边空白，第一个标签将从这个空白距离之后开始 + + + + + 标签栏内部右边空白 + + + + + 标签栏背景颜色 + + + + + 标签栏边框颜色 + + + + + 标签栏背景图片 + + + + + 是否显示标签栏边框 + + + + + 标签栏下边区域的背景颜色 + + + + + 标签栏下边区域的高度 + + + + + 标签高度 + + + + + 被选中的标签高度，可以设置成与TabHeight不一样的值，以突出显示被选中状态 + + + + + 标签之间的距离，设成负值可以使标签有重叠的效果 + + + + + 标签的最大宽度，任何情况下标签都不能超过这个宽度 + + + + + 标签正常宽度，如果标签需要很短的宽度（比如20像素）就可以显示完上面的文字， + 但是Mdi-Bar上有足够的空间时，标签会以正常宽度（比如100像素）显示 + + + + + 标签最小宽度，当标签小于这个宽度时将被隐藏 + + + + + 标签梯度大小，标签可以不以矩形方式显示，而是有一个梯度/斜度。 + + + + + 标签顶部空白，这个值用于参与计算Mdi-Bar高度，计算方式为： + Mdi-Bar Height = BottomRegionHeight + TabHeight + TabTopSpace + + + + + 标签上是否显示子窗体图标 + + + + + 标签上是否显示子窗体关闭图标 + + + + + 选中状态的标签的上部背景色，与下部背景色不同时，标签背景色就有渐变效果 + + + + + 选中状态的标签的下部背景色，与上部背景色不同时，标签背景色就有渐变效果 + + + + + 标签激活时字体颜色 + + + + + 非选中状态的标签的字体颜色 + + + + + 非选中状态的标签的上部背景色 + + + + + 非选中状态的标签的下部背景色 + + + + + 标签外边框颜色 + + + + + 标签内边框颜色，这个颜色一般具有一定的透明度 + + + + + 是否显示标签边框 + + + + + 是否显示默认的新建标签按钮(NewTabBtn) + + + + + NewTabBtn与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 新建标签按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 新建标签按钮大小 + + + + + 按钮颜色集合 + + + + + 是否一直显示ListAllBtn，即使在没有标签被隐藏的情况下 + + + + + 《显示全部标签》按钮的位置 + + + + + 《显示全部标签》按钮与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 《显示全部标签》按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 《显示全部标签》按钮的颜色 + + + + + 《显示全部标签》按钮的大小 + + + + + 皮肤主题 + + + + + 设置百分比 + + + + + + + + + 引发 ValueChanged 事件 + + + + + + 引发 ThemeChanged 事件 + + + + + + 指示鼠标位于哪个区域 + + + + + 控件Value值发生变化后引发 + + + + + 控件绘制MainLine前引发, 可以设置Cancel参数来取消默认的绘制 + + + + + 控件绘制Button前引发 + + + + + 引发 ValueChanged 事件 + + + + + 引发 BeforePaintMainLine 事件 + + + + + 引发 BeforePaintButton 事件 + + + + + 将Value值加一个LargeChange量 + + + + + 将Value值减一个LargeChange量 + + + + + 将Value值加一个SmallChange量 + + + + + 将Value值减一个SmallChange量 + + + + + 提供产生各种路径的静态方法，比如圆角路径、关闭按钮上的x路径、+号路径 + + + + + 圆角样式 + + + + + 无 + + + + + 所有 + + + + + 上 + + + + + 下 + + + + + 左 + + + + + 右 + + + + + SimpleObject指的是只有一种状态（不像普通按钮一样有三种状态），并且其上的元素 + 布局比较简单的Object + + + + + + + + + + + + + + + + + + + + DevExpress风格皮肤 + + + + + DevExpress风格皮肤 + + + + + 新风格皮肤 + + + + + 新风格皮肤 + + + + + 基础皮肤 + + + + + VS2013风格皮肤 + + + + + this theme is just for chrome one quarter style + + + + + for diamond ring style only + + + + + Location of cursor hot spot returnet in WM_NCHITTEST. + + + + + On the screen background or on a dividing line between windows + (same as HTNOWHERE, except that the DefWindowProc function produces a system beep to indicate an error). + + + + + In a window currently covered by another window in the same thread + (the message will be sent to underlying windows in the same thread until one of them returns a code that is not HTTRANSPARENT). + + + + + On the screen background or on a dividing line between windows. + + + + In a client area. + + + In a title bar. + + + In a window menu or in a Close button in a child window. + + + In a size box (same as HTSIZE). + + + In a menu. + + + In a horizontal scroll bar. + + + In the vertical scroll bar. + + + In a Minimize button. + + + In a Maximize button. + + + In the left border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the right border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the upper-horizontal border of a window. + + + In the upper-left corner of a window border. + + + In the upper-right corner of a window border. + + + In the lower-horizontal border of a resizable window + (the user can click the mouse to resize the window vertically). + + + In the lower-left corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the lower-right corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the border of a window that does not have a sizing border. + + + In a Close button. + + + In a Help button. + + + + Contains the new coordinates of a window that has been moved or resized, that is, it is the proposed new window coordinates. + + + + + Contains the coordinates of the window before it was moved or resized. + + + + + Contains the coordinates of the window's client area before the window was moved or resized. + + + + + Pointer to a WINDOWPOS structure that contains the size and position values specified in the operation that moved or resized the window. + + + + + + + + + + 是否在这个按钮上按下了鼠标未释放 + + + + + 是否可见 + + + + + + + + + + 画两次可以加深颜色 + + + + + 用于在click事件中传回数据 + + + + + 获取或设置是否将绘制完全限制在指定的区域内 + + + + + + + + + + + + + + + + + Adapter for WinForms brushes objects for core. + + + + + The actual WinForms brush instance. + + + + + If to dispose the brush when is called.
+ Ignore dispose for cached brushes. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms context menu for core. + + + + + the underline win forms context menu + + + + + Init. + + + + + Adapter for WinForms Control for core. + + + + + the underline win forms control. + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Get the underline win forms control + + + + + Adapter for WinForms Font object for core. + + + + + the underline win-forms font. + + + + + a handle to this Font. + + + + + the vertical offset of the font underline location from the top of the font. + + + + + Cached font height. + + + + + Cached font whitespace width. + + + + + Init. + + + + + the underline win-forms font. + + + + + Get the handle to this Font. + + + + + Set font metrics to be cached for the font for future use. + + the full height of the font + the vertical offset of the font underline location from the top of the font. + + + + Adapter for WinForms Font family object for core. + + + + + the underline win-forms font. + + + + + Init. + + + + + the underline win-forms font family. + + + + + Adapter for WinForms Graphics for core. + + + + + used for calculation. + + + + + used for calculation. + + + + + Used for GDI+ measure string. + + + + + The string format to use for measuring strings for GDI+ text rendering + + + + + The string format to use for rendering strings for GDI+ text rendering + + + + + The wrapped WinForms graphics object + + + + + Use GDI+ text rendering to measure/draw text. + + + + + the initialized HDC used + + + + + if to release the graphics object on dispose + + + + + If text alignment was set to RTL + + + + + Init static resources. + + + + + Init. + + the win forms graphics object to use + Use GDI+ text rendering to measure/draw text + optional: if to release the graphics object on dispose (default - false) + + + + Release current HDC to be able to use methods. + + + + + Init HDC for the current graphics object to be used to call GDI directly. + + + + + Set a resource (e.g. a font) for the specified device context. + WARNING: Calling Font.ToHfont() many times without releasing the font handle crashes the app. + + + + + Set the text color of the device context. + + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Special draw logic to draw transparent text using GDI.
+ 1. Create in-memory DC
+ 2. Copy background to in-memory DC
+ 3. Draw the text to in-memory DC
+ 4. Copy the in-memory DC to the proper location with alpha blend
+ + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Adapter for WinForms graphics path object for core. + + + + + The actual WinForms graphics path instance. + + + + + the last point added to the path to begin next segment from + + + + + The actual WinForms graphics path instance. + + + + + Get arc start angle for the given corner. + + + + + Adapter for WinForms Image object for core. + + + + + the underline win-forms image. + + + + + Initializes a new instance of the class. + + + + + the underline win-forms image. + + + + + Adapter for WinForms pens objects for core. + + + + + The actual WinForms brush instance. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms platforms. + + + + + Singleton instance of global adapter. + + + + + Init installed font families and set default font families mapping. + + + + + Singleton instance of global adapter. + + + + + Low level handling of Html Renderer logic, this class is used by , + , and .
+ + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + returns page list + + + + + returns page list count + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrappable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given printer device. + + the printer device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + mouse event args + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the mouse event args + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + + + + + + Create HtmlRenderer mouse event from win forms mouse event. + + + + + Create HtmlRenderer key event from win forms key event. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ Using and client can control how the html content effects the + size of the label. Either case scrollbars are never shown and html content outside of client bounds will be clipped. + and with AutoSize can limit the max/min size of the control
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoSize:

+ AutoSize = AutoSizeHeightOnly = false
+ The label size will not change by the html content. MaximumSize and MinimumSize are ignored.
+
+ AutoSize = true
+ The width and height is adjustable by the html content, the width will be longest line in the html, MaximumSize.Width will restrict it but it can be lower than that.
+
+ AutoSizeHeightOnly = true
+ The width of the label is set and will not change by the content, the height is adjustable by the html content with restrictions to the MaximumSize.Height and MinimumSize.Height values.
+ + +

LinkClicked event

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + the current html text set in the control + + + + + is to handle auto size of the control height only + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + Creates a new HTML Label + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Automatically sets the size of the label by content size + + + + + Automatically sets the height of the label by content height (width is not effected). + + + + + Gets or sets the max size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the min size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the html of this control. + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform paint of the html in the control. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ If is true and the layout of the html resulted in its content beyond the client bounds + of the panel it will show scrollbars (horizontal/vertical) allowing to scroll the content.
+ If is false html content outside the client bounds will be clipped.
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoScroll:

+ Allows showing scrollbars if html content is placed outside the visible boundaries of the panel. + + +

LinkClicked event:

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the control + + + + + the current html text set in the control + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + The last position of the scrollbars to know if it has changed to update mouse + + + + + Creates a new HtmlPanel and sets a basic css for it's styling. + + + + + + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. + + + + + Gets or sets the text of this panel + + + + + + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Adjust the scrollbar of the panel on html element by the given id.
+ The top of the html element rectangle will be at the top of the panel, if there + is not enough height to scroll to the top the scroll will be at maximum.
+ + the id of the element to scroll to + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform html container layout by the current panel client size. + + + + + Perform paint of the html in the control. + + + + + Set focus on the control for keyboard scrollbars handling. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Handle key down event for selection, copy and scrollbars handling. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + On html renderer scroll request adjust the scrolling of the panel to the requested location. + + + + + Adjust the scrolling of the panel to the requested location. + + the location to adjust the scroll to + + + + call mouse move to handle paint after scroll or html change affecting mouse cursor. + + + + + Used to add arrow keys to the handled keys in . + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Standalone static class for simple and direct HTML rendering.
+ For WinForms UI prefer using HTML controls: or .
+ For low-level control and performance consider using .
+ + + + GDI vs. GDI+ text rendering
+ Windows supports two text rendering technologies: GDI and GDI+.
+ GDI is older, has better performance and looks better on standard monitors but doesn't support alpha channel for transparency.
+ GDI+ is newer, device independent so work better for printers but is slower and looks worse on monitors.
+ HtmlRender supports both GDI and GDI+ text rendering to accommodate different needs, GDI+ text rendering methods have "GdiPlus" suffix + in their name where GDI do not.
+ + + Rendering to image
+ See https://htmlrenderer.codeplex.com/wikipage?title=Image%20generation
+ Because of GDI text rendering issue with alpha channel clear type text rendering rendering to image requires special handling.
+ Solid color background - generate an image where the background is filled with solid color and all the html is rendered on top + of the background color, GDI text rendering will be used. (RenderToImage method where the first argument is html string)
+ Image background - render html on top of existing image with whatever currently exist but it cannot have transparent pixels, + GDI text rendering will be used. (RenderToImage method where the first argument is Image object)
+ Transparent background - render html to empty image using GDI+ text rendering, the generated image can be transparent. + Text rendering can be controlled using , note that + doesn't render well on transparent background. (RenderToImageGdiPlus method)
+ + + Overwrite stylesheet resolution
+ Exposed by optional "stylesheetLoad" delegate argument.
+ Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + Overwrite image resolution
+ Exposed by optional "imageLoad" delegate argument.
+ Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ Note: Cannot use asynchronous scheme overwrite scheme.
+ + + + + Simple rendering
+ HtmlRender.Render(g, "Hello World]]>");
+ HtmlRender.Render(g, "Hello World]]>", 10, 10, 500, CssData.Parse("body {font-size: 20px}")");
+ + + Image rendering
+ HtmlRender.RenderToImage("Hello World]]>", new Size(600,400));
+ HtmlRender.RenderToImage("Hello World]]>", 600);
+ HtmlRender.RenderToImage(existingImage, "Hello World]]>");
+ + + + + + Adds a font family to be used in html rendering.
+ The added font will be used by all rendering function including and all WinForms controls. + + + The given font family instance must be remain alive while the renderer is in use.
+ If loaded to then the collection must be alive.
+ If loaded from file then the file must not be deleted. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + + This fonts mapping can be used as a fallback in case the requested font is not installed in the client system. + + the font family to replace + the font family to replace with + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI text rendering, note has no effect. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI+ text rending, use to control text rendering. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Renders the specified HTML source on the specified location and max width restriction.
+ Use GDI text rendering, note has no effect.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI text rendering, note has no effect.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ The HTML will be layout by the given image size but may be clipped if cannot fit.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + optional: the top-left most location to start render the html at (default - 0,0) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Measure the size (width and height) required to draw the given html under given width and height restrictions.
+ + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size of the html by performing layout under the given restrictions. + + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Clip the graphics so the html will not be rendered outside the max height bound given.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Copy all the bitmap bits from memory bitmap buffer to the given image. + + the source memory bitmap buffer to copy from + the destination bitmap image to copy to + + + + Provides HTML rendering on the tooltips. + + + + + the container to render and handle the html shown in the tooltip + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + The text rendering hint to be used for text rendering. + + + + + The CSS class used for tooltip html root div + + + + + the control that the tooltip is currently showing on.
+ Used for link handling. + + + + + timer used to handle mouse move events when mouse is over the tooltip.
+ Used for link handling. + + + + + the handle of the actual tooltip window used to know when the tooltip is hidden
+ Used for link handling. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + The CSS class used for tooltip html root div (default: htmltooltip)
+ Setting to 'null' clear base style on the tooltip.
+ Set custom class found in to change the base style of the tooltip. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Gets or sets the max size the tooltip. + + An ordered pair of type representing the width and height of a rectangle. + + + + On tooltip appear set the html by the associated control, layout and set the tooltip size by the html size. + + + + + Draw the html using the tooltip graphics. + + + + + Adjust the location of the tooltip window to the location of the mouse and handle + if the tooltip window will try to appear outside the boundaries of the control. + + the control the tooltip is appearing on + the size of the tooltip window + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Raised on link handling timer tick, used for: + 1. Know when the tooltip is hidden by checking the visibility of the tooltip window. + 2. Call HandleMouseMove so the mouse cursor will react if over a link element. + 3. Call HandleMouseDown and HandleMouseUp to simulate click on a link if one was clicked. + + + + + Unsubscribe from events and dispose of . + + + + + Helper to encode and set HTML fragment to clipboard.
+ See http://theartofdev.wordpress.com/2012/11/11/setting-html-and-plain-text-formatting-to-clipboard/.
+ . + + + The MIT License (MIT) Copyright (c) 2014 Arthur Teplitzki. + + + + + The string contains index references to other spots in the string, so we need placeholders so we can compute the offsets.
+ The _ strings are just placeholders. We'll back-patch them actual values afterwards.
+ The string layout () also ensures that it can't appear in the body of the html because the
+ character must be escaped.
+ + + + + html comment to point the beginning of html fragment + + + + + html comment to point the end of html fragment + + + + + Used to calculate characters byte count in UTF-8 + + + + + Create with given html and plain-text ready to be used for clipboard or drag and drop.
+ Handle missing ]]> tags, specified start\end segments and Unicode characters. + + + + Windows Clipboard works with UTF-8 Unicode encoding while .NET strings use with UTF-16 so for clipboard to correctly + decode Unicode string added to it from .NET we needs to be re-encoded it using UTF-8 encoding. + + + Builds the CF_HTML header correctly for all possible HTMLs
+ If given html contains start/end fragments then it will use them in the header: + hello world]]> + If given html contains html/body tags then it will inject start/end fragments to exclude html/body tags: + hello world]]> + If given html doesn't contain html/body tags then it will inject the tags and start/end fragments properly: + world]]> + In all cases creating a proper CF_HTML header:
+ + + hello world + ]]> + + See format specification here: http://msdn.microsoft.com/library/default.asp?url=/workshop/networking/clipboard/htmlclipboard.asp + + + a html fragment + the plain text + + + + Clears clipboard and sets the given HTML and plain text fragment to the clipboard, providing additional meta-information for HTML.
+ See for HTML fragment details.
+ + + ClipboardHelper.CopyToClipboard("Hello World", "Hello World"); + + a html fragment + the plain text + + + + Clears clipboard and sets the given plain text fragment to the clipboard.
+ + the plain text + + + + Generate HTML fragment data string with header that is required for the clipboard. + + the html to generate for + the resulted string + + + + Calculates the number of bytes produced by encoding the string in the string builder in UTF-8 and not .NET default string encoding. + + the string builder to count its string + optional: the start index to calculate from (default - start of string) + optional: the end index to calculate to (default - end of string) + the number of bytes required to encode the string in UTF-8 + + + + Utilities for converting WinForms entities to HtmlRenderer core entities. + + + + + Convert from WinForms point to core point. + + + + + Convert from WinForms point to core point. + + + + + Convert from core point to WinForms point. + + + + + Convert from core point to WinForms point. + + + + + Convert from WinForms size to core size. + + + + + Convert from core size to WinForms size. + + + + + Convert from core size to WinForms size. + + + + + Convert from WinForms rectangle to core rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from WinForms color to core color. + + + + + Convert from core color to WinForms color. + + + + + Utility for Win32 API. + + + + + Const for BitBlt copy raster-operation code. + + + + + Const for BitBlt paint raster-operation code. + + + + + Create a compatible memory HDC from the given HDC.
+ The memory HDC can be rendered into without effecting the original HDC.
+ The returned memory HDC and must be released using . + + the HDC to create memory HDC from + the width of the memory HDC to create + the height of the memory HDC to create + returns used bitmap memory section that must be released when done with memory HDC + memory HDC + + + + Release the given memory HDC and dib section created from . + + Memory HDC to release + bitmap section to release + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + A pointer to a RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + If the function succeeds, the return value is nonzero. + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ARGB (alpha, red, green, blue) color. + + + + + Represents a color that is null. + + 1 + + + + Gets a system-defined color. + + + + + Gets a system-defined color that has an ARGB value of #FF000000. + + + + + Gets a system-defined color that has an ARGB value of #FFFFFFFF. + + + + + Gets a system-defined color that has an ARGB value of #FFF5F5F5. + + + + + Gets a system-defined color that has an ARGB value of #FFD3D3D3. + + + + + Gets the red component value of this structure. + + + + + Gets the green component value of this structure. + + + + + Gets the blue component value of this structure. + + + + + Gets the alpha component value of this structure. + + + + + Specifies whether this structure is uninitialized. + + + This property returns true if this color is uninitialized; otherwise, false. + + 1 + + + + Tests whether two specified structures are equivalent. + + + true if the two structures are equal; otherwise, false. + + + The that is to the left of the equality operator. + + + The that is to the right of the equality operator. + + 3 + + + + Tests whether two specified structures are different. + + + true if the two structures are different; otherwise, false. + + + The that is to the left of the inequality operator. + + + The that is to the right of the inequality operator. + + 3 + + + + Creates a structure from the four ARGB component (alpha, red, green, and blue) values. Although this method allows a 32-bit value to be passed for each component, the value of each component is limited to 8 bits. + + + The that this method creates. + + The alpha component. Valid values are 0 through 255. + The red component. Valid values are 0 through 255. + The green component. Valid values are 0 through 255. + The blue component. Valid values are 0 through 255. + + , , , or is less than 0 or greater than 255. + + 1 + + + + Creates a structure from the specified 8-bit color values (red, green, and blue). The alpha value is implicitly 255 (fully opaque). Although this method allows a 32-bit value to be passed for each color component, the value of each component is limited to 8 bits. + + + The that this method creates. + + + The red component value for the new . Valid values are 0 through 255. + + + The green component value for the new . Valid values are 0 through 255. + + + The blue component value for the new . Valid values are 0 through 255. + + + , , or is less than 0 or greater than 255. + + 1 + + + + Tests whether the specified object is a structure and is equivalent to this + + structure. + + + true if is a structure equivalent to this + + structure; otherwise, false. + + The object to test. + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies the hash code for this . + + 1 + + + + Converts this structure to a human-readable string. + + + + + Specifies the style of dashed lines drawn with a object. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 自定义 + + + + + Specifies style information applied to text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + Init. + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + Is the left mouse button participated in the event + + + + + Init. + + + + + Is the left mouse button participated in the event + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ordered pair of floating-point x- and y-coordinates that defines a point in a two-dimensional plane. + + + + + Represents a new instance of the class with member data left uninitialized. + + 1 + + + + Initializes a new instance of the class with the specified coordinates. + + The horizontal position of the point. + The vertical position of the point. + + + + + + Gets a value indicating whether this is empty. + + + true if both and + + are 0; otherwise, false. + + 1 + + + + Gets or sets the x-coordinate of this . + + + The x-coordinate of this . + + 1 + + + + Gets or sets the y-coordinate of this . + + + The y-coordinate of this . + + 1 + + + + Translates the by the specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the x- and y-coordinates of the + + . + + + + + Translates a by the negative of a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Compares two structures. The result specifies whether the values of the + + and properties of the two + + structures are equal. + + + true if the and + + values of the left and right + + structures are equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Determines whether the coordinates of the specified points are not equal. + + + true to indicate the and + + values of and + + are not equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Translates a given by a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the coordinates of + + . + + + + + Translates a by the negative of a specified size. + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Specifies whether this contains the same coordinates as the specified + + . + + + This method returns true if is a and has the same coordinates as this + + . + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts this to a human readable string. + + + A string that represents this . + + 1 + + + + Stores a set of four floating-point numbers that represent the location and size of a rectangle. + + + + + Represents an instance of the class with its members uninitialized. + + + + + Initializes a new instance of the class with the specified location and size. + + The x-coordinate of the upper-left corner of the rectangle. + The y-coordinate of the upper-left corner of the rectangle. + The width of the rectangle. + The height of the rectangle. + + + + Initializes a new instance of the class with the specified location and size. + + A that represents the upper-left corner of the rectangular region. + A that represents the width and height of the rectangular region. + + + + Gets or sets the coordinates of the upper-left corner of this structure. + + A that represents the upper-left corner of this structure. + + + + Gets or sets the size of this . + + A that represents the width and height of this structure. + + + + Gets or sets the x-coordinate of the upper-left corner of this structure. + + + The x-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the y-coordinate of the upper-left corner of this structure. + + + The y-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the width of this structure. + + + The width of this structure. + + + + + Gets or sets the height of this structure. + + + The height of this structure. + + + + + Gets the x-coordinate of the left edge of this structure. + + + The x-coordinate of the left edge of this structure. + + + + + Gets the y-coordinate of the top edge of this structure. + + + The y-coordinate of the top edge of this structure. + + + + + Gets the x-coordinate that is the sum of and + + of this structure. + + + The x-coordinate that is the sum of and + + of this structure. + + + + + Gets the y-coordinate that is the sum of and + + of this structure. + + + The y-coordinate that is the sum of and + + of this structure. + + + + + Tests whether the or + + property of this has a value of zero. + + + This property returns true if the or + + property of this has a value of zero; otherwise, false. + + + + + Tests whether two structures have equal location and size. + + + This operator returns true if the two specified structures have equal + , , , and properties. + + + The structure that is to the left of the equality operator. + + + The structure that is to the right of the equality operator. + + + + + Tests whether two structures differ in location or size. + + + This operator returns true if any of the , + , , or + properties of the two structures are unequal; otherwise false. + + + The structure that is to the left of the inequality operator. + + + The structure that is to the right of the inequality operator. + + + + + Creates a structure with upper-left corner and lower-right corner at the specified locations. + + + The new that this method creates. + + The x-coordinate of the upper-left corner of the rectangular region. + The y-coordinate of the upper-left corner of the rectangular region. + The x-coordinate of the lower-right corner of the rectangular region. + The y-coordinate of the lower-right corner of the rectangular region. + + + + Tests whether is a with the same location and size of this + . + + + This method returns true if is a and its X, Y, Width, and Height properties are equal to the corresponding properties of this + ; otherwise, false. + + + The to test. + + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point defined by and is contained within this + + structure; otherwise false. + + The x-coordinate of the point to test. + The y-coordinate of the point to test. + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point represented by the parameter is contained within this + + structure; otherwise false. + + The to test. + + + + Determines if the rectangular region represented by is entirely contained within this + + structure. + + + This method returns true if the rectangular region represented by is entirely contained within the rectangular region represented by this + + ; otherwise false. + + + The to test. + + + + + Inflates this structure by the specified amount. + + + The amount to inflate this structure horizontally. + + + The amount to inflate this structure vertically. + + + + + Inflates this by the specified amount. + + The amount to inflate this rectangle. + + + + Creates and returns an inflated copy of the specified structure. The copy is inflated by the specified amount. The original rectangle remains unmodified. + + + The inflated . + + + The to be copied. This rectangle is not modified. + + The amount to inflate the copy of the rectangle horizontally. + The amount to inflate the copy of the rectangle vertically. + + + + Replaces this structure with the intersection of itself and the specified + + structure. + + The rectangle to intersect. + + + + Returns a structure that represents the intersection of two rectangles. If there is no intersection, and empty + + is returned. + + + A third structure the size of which represents the overlapped area of the two specified rectangles. + + A rectangle to intersect. + A rectangle to intersect. + + + + Determines if this rectangle intersects with . + + + This method returns true if there is any intersection. + + The rectangle to test. + + + + Creates the smallest possible third rectangle that can contain both of two rectangles that form a union. + + + A third structure that contains both of the two rectangles that form the union. + + A rectangle to union. + A rectangle to union. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location horizontally. + The amount to offset the location vertically. + + + + Gets the hash code for this structure. For information about the use of hash codes, see Object.GetHashCode. + + The hash code for this + + + + Converts the Location and Size of this to a human-readable string. + + + A string that contains the position, width, and height of this structure for example, "{X=20, Y=20, Width=100, Height=50}". + + + + + Stores an ordered pair of floating-point numbers, typically the width and height of a rectangle. + + + + + Gets a structure that has a + + and + + value of 0. + + + A structure that has a + + and + + value of 0. + + 1 + + + + Initializes a new instance of the structure from the specified existing + + structure. + + + The structure from which to create the new + + structure. + + + + + Initializes a new instance of the structure from the specified structure. + + The structure from which to initialize this structure. + + + + Initializes a new instance of the structure from the specified dimensions. + + + The width component of the new structure. + + + The height component of the new structure. + + + + + Gets a value that indicates whether this structure has zero width and height. + + + This property returns true when this structure has both a width and height of zero; otherwise, false. + + 1 + + + + Gets or sets the horizontal component of this structure. + + + The horizontal component of this structure, typically measured in pixels. + + 1 + + + + Gets or sets the vertical component of this structure. + + + The vertical component of this structure, typically measured in pixels. + + 1 + + + + Converts the specified structure to a + structure. + + The structure to which this operator converts. + The structure to be converted + + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + 3 + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A that is the result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + 3 + + + + Tests whether two structures are equal. + + + This operator returns true if and have equal width and height; otherwise, false. + + + The structure on the left side of the equality operator. + + + The structure on the right of the equality operator. + + 3 + + + + Tests whether two structures are different. + + + This operator returns true if and differ either in width or height; false if + + and are equal. + + + The structure on the left of the inequality operator. + + + The structure on the right of the inequality operator. + + 3 + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A structure that is a result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + + + + Tests to see whether the specified object is a structure with the same dimensions as this + + structure. + + + This method returns true if is a and has the same width and height as this + + ; otherwise, false. + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts a structure to a structure. + + + Returns a structure. + + + + + Creates a human-readable string that represents this structure. + + + A string that represents this structure. + + 1 + + + + + + + Platform adapter to bridge platform specific objects to HTML Renderer core library.
+ Core uses abstract renderer objects (RAdapter/RControl/REtc...) to access platform specific functionality, the concrete platforms + implements those objects to provide concrete platform implementation. Those allowing the core library to be platform agnostic. + + Platforms: WinForms, WPF, Metro, PDF renders, etc.
+ Objects: UI elements(Controls), Graphics(Render context), Colors, Brushes, Pens, Fonts, Images, Clipboard, etc.
+ + + + It is best to have a singleton instance of this class for concrete implementation!
+ This is because it holds caches of default CssData, Images, Fonts and Brushes. + + + + + cache of brush color to brush instance + + + + + cache of pen color to pen instance + + + + + cache of all the font used not to create same font again and again + + + + + default CSS parsed data singleton + + + + + image used to draw loading image icon + + + + + image used to draw error image icon + + + + + Init. + + + + + Get the default CSS stylesheet data. + + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Check if the given font exists in the system by font family name. + + the font name to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get image to be used while HTML image is loading. + + + + + Get image to be used if HTML image load failed. + + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard
+ Not relevant for platforms that don't render HTML on UI element. + + the text to set + + + + Set the given html and plain text data to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + + + + Set the given image to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the image object to set to clipboard + + + + Create a context menu that can be used on the control
+ Not relevant for platforms that don't render HTML on UI element. + + new context menu + + + + Save the given image to file by showing save dialog to the client.
+ Not relevant for platforms that don't render HTML on UI element. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard + + the text to set + + + + Set the given html and plain text data to clipboard. + + the html data + the plain text data + + + + Set the given image to clipboard. + + + + + + Create a context menu that can be used on the control + + new context menu + + + + Save the given image to file by showing save dialog to the client. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Adapter for platform specific brush objects - used to fill graphics (rectangles, polygons and paths).
+ The brush can be solid color, gradient or image. + + + + + + + + + + Adapter for platform specific context menu - used to create and show context menu at specific location.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The total number of items in the context menu + + + + + Add divider item to the context menu.
+ The divider is a non clickable place holder used to separate items. + + + + + Add item to the context menu with the given text that will raise the given event when clicked. + the text to set on the new context menu itemif to set the item as enabled or disabledthe event to raise when the item is clicked + + + + Remove the last item from the context menu iff it is a divider + + + + + Show the context menu in the given parent control at the given location. + the parent control to show inthe location to show at relative to the parent control + + + + + + + + + Adapter for platform specific control object - used to handle updating the control that the html is rendered on.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The platform adapter. + + + + + Init control with platform adapter. + + + + + The platform adapter. + + + + + Is the left mouse button is currently in pressed state + + + + + Is the right mouse button is currently in pressed state + + + + + Get the current location of the mouse relative to the control + + + + + Set the cursor over the control to default cursor + + + + + Set the cursor over the control to hand cursor + + + + + Set the cursor over the control to I beam cursor + + + + + Do drag-drop copy operation for the given data object. + + the drag-drop data object + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Invalidates the entire surface of the control and causes the control to be redrawn. + + + + + Adapter for platform specific font object - used to render text using specific font. + + + + + Gets the em-size of this Font measured in the units specified by the Unit property. + + + + + The line spacing, in pixels, of this font. + + + + + Get the vertical offset of the font underline location from the top of the font. + + + + + Get the left padding, in pixels, of the font. + + + + + + + + + + + + Adapter for platform specific font family object - define the available font families to use.
+ Required for custom fonts handling: fonts that are not installed on the system. + + + + + Gets the name of this Font Family. + + + + + Adapter for platform specific graphics rendering object - used to render graphics and text in platform specific context.
+ The core HTML Renderer components use this class for rendering logic, extending this + class in different platform: WinForms, WPF, Metro, PDF, etc. + + + + + the global adapter + + + + + Te clipping bound stack as clips are pushed/poped to/from the graphics + + + + + Init. + + + + + Get color pen. + + the color to get the pen for + pen instance + + + + Get solid color brush. + + the color to get the brush for + solid color brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Gets a Rectangle structure that bounds the clipping region of this Graphics. + + A rectangle structure that represents a bounding rectangle for the clipping region of this Graphics. + + + + Pop the latest clip push. + + + + + Push the clipping region of this Graphics to interception of current clipping rectangle and the given rectangle. + + Rectangle to clip to. + + + + Push the clipping region of this Graphics to exclude the given rectangle from the current clipping rectangle. + + Rectangle to exclude clipping in. + + + + Set the graphics smooth mode to use anti-alias.
+ Use to return back the mode used. + + the previous smooth mode before the change + + + + Return to previous smooth mode before anti-alias was set as returned from . + + the previous mode to set + + + + Get TextureBrush object that uses the specified image and bounding rectangle. + + The Image object with which this TextureBrush object fills interiors. + A Rectangle structure that represents the bounding rectangle for this TextureBrush object. + The dimension by which to translate the transformation + + + + Get GraphicsPath object. + + graphics path instance + + + + Measure the width and height of string when drawn on device context HDC + using the given font . + + the string to measure + the font to measure string with + the size of the string + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ Not relevant for platforms that don't render HTML on UI element. + + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Draw the given string using the given font and foreground color at given location. + + the string to draw + the font to use to draw the string + the text color to set + the location to start string draw (top-left) + used to know the size of the rendered text for transparent text support + is to render the string right-to-left (true - RTL, false - LTR) + + + + Draws a line connecting the two points specified by the coordinate pairs. + + Pen that determines the color, width, and style of the line. + The x-coordinate of the first point. + The y-coordinate of the first point. + The x-coordinate of the second point. + The y-coordinate of the second point. + + + + Draws a rectangle specified by a coordinate pair, a width, and a height. + + A Pen that determines the color, width, and style of the rectangle. + The x-coordinate of the upper-left corner of the rectangle to draw. + The y-coordinate of the upper-left corner of the rectangle to draw. + The width of the rectangle to draw. + The height of the rectangle to draw. + + + + Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height. + + Brush that determines the characteristics of the fill. + The x-coordinate of the upper-left corner of the rectangle to fill. + The y-coordinate of the upper-left corner of the rectangle to fill. + Width of the rectangle to fill. + Height of the rectangle to fill. + + + + Draws the specified portion of the specified at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. The image is scaled to fit the rectangle. + Rectangle structure that specifies the portion of the object to draw. + + + + Draws the specified Image at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. + + + + Draws a GraphicsPath. + + Pen that determines the color, width, and style of the path. + GraphicsPath to draw. + + + + Fills the interior of a GraphicsPath. + + Brush that determines the characteristics of the fill. + GraphicsPath that represents the path to fill. + + + + Fills the interior of a polygon defined by an array of points specified by Point structures. + + Brush that determines the characteristics of the fill. + Array of Point structures that represent the vertices of the polygon to fill. + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Adapter for platform specific graphics path object - used to render (draw/fill) path shape. + + + + + Start path at the given point. + + + + + Add stright line to the given point from te last point. + + + + + Add circular arc of the given size to the given point from the last point. + + + + + Release path resources. + + + + + The 4 corners that are handled in arc rendering. + + + + + + + + + + + + + + + + + + + + + + + + + Adapter for platform specific image object - used to render images. + + + + + Get the width, in pixels, of the image. + + + + + Get the height, in pixels, of the image. + + + + + + + + + + Adapter for platform specific pen objects - used to draw graphics (lines, rectangles and paths) + + + + + Gets or sets the width of this Pen, in units of the Graphics object used for drawing. + + + + + Gets or sets the style used for dashed lines drawn with this Pen. + + + + + Holds parsed stylesheet css blocks arranged by media and classes.
+ + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + used to return empty array + + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data. + + + + + Init. + + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + Platform adapter + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data + + + + + Check if there are css blocks for the given class selector. + + the class selector to check for css blocks by + optional: the css media type (default - all) + true - has css blocks for the class, false - otherwise + + + + Get collection of css blocks for the requested class selector.
+ the can be: class name, html element name, html element and + class name (elm.class), hash tag with element id (#id).
+ returned all the blocks that word on the requested class selector, it can contain simple + selector or hierarchy selector. + + the class selector to get css blocks by + optional: the css media type (default - all) + collection of css blocks, empty collection if no blocks exists (never null) + + + + Add the given css block to the css data, merging to existing block if required. + + + If there is no css blocks for the same class it will be added to data collection.
+ If there is already css blocks for the same class it will check for each existing block + if the hierarchical selectors match (or not exists). if do the two css blocks will be merged into + one where the new block properties overwrite existing if needed. if the new block doesn't mach any + existing it will be added either to the beginning of the list if it has no hierarchical selectors or at the end.
+ Css block without hierarchical selectors must be added to the beginning of the list so more specific block + can overwrite it when the style is applied. + + the media type to add the CSS to + the css block to add + + + + Combine this CSS data blocks with CSS blocks for each media.
+ Merge blocks if exists in both. + + the CSS data to combine with + + + + Create deep copy of the css data with cloned css blocks. + + cloned object + + + + CSS Specification's Default Style Sheet for HTML 4 + + + http://www.w3.org/TR/CSS21/sample.html + + + + + Border types + + + + + Represents a CSS Box of text or replaced elements. + + + The Box can contains other boxes, that's the way that the CSS Tree + is composed. + + To know more about boxes visit CSS spec: + http://www.w3.org/TR/CSS21/box.html + + + + + the parent css box of this css box in the hierarchy + + + + + the root container for the hierarchy + + + + + the html tag that is associated with this css box, null if anonymous box + + + + + the inner text of the box + + + + + Do not use or alter this flag + + + Flag that indicates that CssTable algorithm already made fixes on it. + + + + + handler for loading background image + + + + + Init. + + optional: the parent of this css box in html + optional: the html tag associated with this css box + + + + Gets the HtmlContainer of the Box. + WARNING: May be null. + + + + + Gets or sets the parent box of this box + + + + + Gets the children boxes of this box + + + + + Is the box is of "br" element. + + + + + is the box "Display" is "Inline", is this is an inline box and not block. + + + + + is the box "Display" is "Block", is this is an block box and not inline. + + + + + Is the css box clickable (by default only "a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + Gets the containing block-box of this box. (The nearest parent box with display=block) + + + + + Gets the HTMLTag that hosts this box + + + + + Gets if this box represents an image + + + + + Tells if the box is empty or contains just blank spaces + + + + + Gets or sets the inner text of the box + + + + + Gets the line-boxes of this box (if block box) + + + + + Gets the linebox(es) that contains words of this box (if inline) + + + + + Gets the rectangles where this box should be painted + + + + + Gets the BoxWords of text in the box + + + + + Gets the first word of the box + + + + + Gets or sets the first linebox where content of this box appear + + + + + Gets or sets the last linebox where content of this box appear + + + + + Create new css box for the given parent with the given html tag.
+ + the html tag to define the box + the box to add the new box to it as child + the new box + + + + Create new css box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous inline boxes visit: http://www.w3.org/TR/CSS21/visuren.html#anonymous + + the box to add the new box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new box + + + + Create new css block box. + + the new block box + + + + Create new css block box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous block boxes visit CSS spec: + http://www.w3.org/TR/CSS21/visuren.html#anonymous-block-level + + the box to add the new block box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new block box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + Device context to use + + + + Prints the fragment + + Device context to use + + + + + + Set this box in + + + + + + Move all child boxes from to this box. + + the box to move all its child boxes from + + + + Splits the text into words and saves the result + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions.
+ + Device context to use + + + + Assigns words its width and height + + + + + + Get the parent of this css properties instance. + + + + + + Gets the index of the box to be used on a (ordered) list + + + + + + Creates the + + + + + + Searches for the first word occurrence inside the box, on the specified linebox + + + + + + + + Gets the specified Attribute, returns string.Empty if no attribute specified + + Attribute to retrieve + Attribute value or string.Empty if no attribute specified + + + + Gets the value of the specified attribute of the source HTML tag. + + Attribute to retrieve + Value to return if attribute is not specified + Attribute value or defaultValue if no attribute specified + + + + Gets the minimum width that the box can be.
+ The box can be as thin as the longest word plus padding.
+ The check is deep thru box tree.
+ + the min width of the box + + + + Gets the longest word (in width) inside the box, deeply. + + + + + + + + + Get the total margin value (left and right) from the given box to the given end box.
+ + the box to start calculation from. + the total margin + + + + Gets the maximum bottom of the boxes inside the startBox + + + + + + + + Get the and width of the box content.
+ + The minimum width the content must be so it won't overflow (largest word + padding). + The total width the content can take without line wrapping (with padding). + + + + Get the and of the box words content and .
+ + the box to calculate for + the width that allows for each word to fit (width of the longest word) + the max width a single line of words can take without wrapping + the total amount of padding the content has + + + + + + Gets if this box has only inline siblings (including itself) + + + + + + Gets the rectangles where inline box will be drawn. See Remarks for more info. + + Rectangles where content should be placed + + Inline boxes can be split across different LineBoxes, that's why this method + Delivers a rectangle for each LineBox related to this box, if inline. + + + Inherits inheritable values from parent. + + + + + Gets the result of collapsing the vertical margins of the two boxes + + the previous box under the same parent + Resulting top margin + + + + Calculate the actual right of the box by the actual right of the child boxes if this box actual right is not set. + + the calculated actual right value + + + + Gets the result of collapsing the vertical margins of the two boxes + + Resulting bottom margin + + + + Deeply offsets the top of the box and its contents + + + + + + Paints the fragment + + the device to draw to + + + + Prints the fragment + + the device to draw to + + + + + + Paints the background of the box + + the device to draw into + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Paint all the words in the box. + + the device to draw into + the current scroll offset to offset the words + + + + Paints the text decoration (underline/strike-through/over-line) + + the device to draw into + + + + + + + Offsets the rectangle of the specified linebox by the specified gap, + and goes deep for rectangles of children in that linebox. + + + + + + + Resets the array + + + + + On image load process complete with image request refresh for it to be painted. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Get brush for the text depending if there is selected text color set. + + + + + Get brush for selection background depending if it has external and if alpha is required for images. + + + used for images so they will have alpha effect + + + + ToString override. + + + + + + CSS box for iframe element.
+ If the iframe is of embedded YouTube or Vimeo video it will show image with play. + + + + + the image word of this image box + + + + + is the iframe is of embeded video + + + + + the title of the video + + + + + the url of the video thumbnail image + + + + + link to the video on the site + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Is the css box clickable ("a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + is the iframe is of embeded video + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Load YouTube video data (title, image, link) by calling YouTube API. + + + + + Parse YouTube API response to get video data (title, image, link). + + + + + Load Vimeo video data (title, image, link) by calling Vimeo API. + + + + + Parse Vimeo API response to get video data (title, image, link). + + + + + Handle error occurred during video data load to handle if the video was not found. + + the exception that occurred during data load web request + the name of the video source (YouTube/Vimeo/Etc.) + + + + Create image handler for downloading video image if found and release the WebClient instance used for API call. + + + + + Paints the fragment + + the device to draw to + + + + Draw video image over the iframe if found. + + + + + Draw video title on top of the iframe if found. + + + + + Draw play over the iframe if we found link url. + + + + + Assigns words its width and height + + the device to use + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + CSS box for hr element. + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + the device to draw to + + + + CSS box for image element. + + + + + the image word of this image box + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Get the image of this image box. + + + + + Paints the fragment + + the device to draw to + + + + Assigns words its width and height + + the device to use + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Base class for css box to handle the css properties.
+ Has field and property for every css property that can be set, the properties add additional parsing like + setting the correct border depending what border value was set (single, two , all four).
+ Has additional fields to control the location and size of the box and 'actual' css values for some properties + that require additional calculations and parsing.
+ + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + the width of whitespace between words + + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + Gets the bounds of the box + + + + + Gets the width available on the box, counting padding and margin. + + + + + Gets the right of the box. When setting, it will affect only the width of the box. + + + + + Gets or sets the bottom of the box. + (When setting, alters only the Size.Height of the box) + + + + + Gets the left of the client rectangle (Where content starts rendering) + + + + + Gets the top of the client rectangle (Where content starts rendering) + + + + + Gets the right of the client rectangle + + + + + Gets the bottom of the client rectangle + + + + + Gets the client rectangle + + + + + Gets the actual height + + + + + Gets the actual height + + + + + Gets the actual top's padding + + + + + Gets the actual padding on the left + + + + + Gets the actual Padding of the bottom + + + + + Gets the actual padding on the right + + + + + Gets the actual top's Margin + + + + + The margin top value if was effected by margin collapse. + + + + + Gets the actual Margin on the left + + + + + Gets the actual Margin of the bottom + + + + + Gets the actual Margin on the right + + + + + Gets the actual top border width + + + + + Gets the actual Left border width + + + + + Gets the actual Bottom border width + + + + + Gets the actual Right border width + + + + + Gets the actual top border Color + + + + + Gets the actual Left border Color + + + + + Gets the actual Bottom border Color + + + + + Gets the actual Right border Color + + + + + Gets the actual length of the north west corner + + + + + Gets the actual length of the north east corner + + + + + Gets the actual length of the south east corner + + + + + Gets the actual length of the south west corner + + + + + Gets a value indicating if at least one of the corners of the box is rounded + + + + + Gets the actual width of whitespace between words. + + + + + + Gets the actual color for the text. + + + + + Gets the actual background color of the box + + + + + Gets the second color that creates a gradient for the background + + + + + Gets the actual angle specified for the background gradient + + + + + Gets the actual font of the parent + + + + + Gets the font that should be actually used to paint the text of the box + + + + + Gets the line height + + + + + Gets the text indentation (on first line only) + + + + + Gets the actual horizontal border spacing for tables + + + + + Gets the actual vertical border spacing for tables + + + + + Get the parent of this css properties instance. + + + + + + Gets the height of the font in the specified units + + + + + + Ensures that the specified length is converted to pixels if necessary + + + + + + Set the style/width/color for all 4 borders on the box.
+ if null is given for a value it will not be set. + + optional: the style to set + optional: the width to set + optional: the color to set + + + + Measures the width of whitespace between words (set ). + + + + + Inherits inheritable values from specified box. + + Set to true to inherit all CSS properties instead of only the ineritables + Box to inherit the properties + + + + Helps on CSS Layout. + + + + + Measure image box size by the width\height set on the box and the actual rendered image size.
+ If no image exists for the box error icon will be set. + + the image word to measure + + + + Creates line boxes for the specified blockbox + + + + + + + Applies special vertical alignment for table-cells + + + + + + + Recursively flows the content of the box using the inline model + + Device Info + Blockbox that contains the text flow + Current box to flow its content + Maximum reached right + Space to use between rows of text + x starting coordinate for when breaking lines of text + Current linebox being used + Current x coordinate that will be the left of the next word + Current y coordinate that will be the top of the next word + Maximum right reached so far + Maximum bottom reached so far + + + + Adjust the position of absolute elements by letf and top margins. + + + + + Recursively creates the rectangles of the blockBox, by bubbling from deep to outside of the boxes + in the rectangle structure + + + + + Applies vertical and horizontal alignment to words in lineboxes + + + + + + + Applies right to left direction to words + + + + + + + Applies RTL direction to all the words on the line. + + the line to apply RTL to + + + + Applies RTL direction to specific box words on the line. + + + + + + + Applies vertical alignment to the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies right alignment to the text on the linebox + + + + + + + Simplest alignment, just arrange words. + + + + + + + Layout engine for tables executing the complex layout of tables with rows/columns/headers/etc. + + + + + the main box of the table + + + + + + + + + + collection of all rows boxes + + + + + collection of all columns boxes + + + + + + + + + + Init. + + + + + + Get the table cells spacing for all the cells in the table.
+ Used to calculate the spacing the table has in addition to regular padding and borders. + + the table box to calculate the spacing for + the calculated spacing + + + + + + + + + + + Analyzes the Table and assigns values to this CssTable object. + To be called from the constructor + + + + + Get the table boxes into the proper fields. + + + + + Insert EmptyBoxes for vertical cell spanning. + + + + + Determine Row and Column Count, and ColumnWidths + + + + + + + + + + + + While table width is larger than it should, and width is reductable.
+ If table max width is limited by we need to lower the columns width even if it will result in clipping
+ + + + + Check for minimum sizes (increment widths if necessary) + + + + + Layout the cells by the calculated table layout + + + + + + Gets the spanned width of a cell (With of all columns it spans minus one). + + + + + Gets the cell column index checking its position and other cells colspans + + + + + + + + Gets the cells width, taking colspan and being in the specified column + + + + + + + + Gets the colspan of the specified box + + + + + + Gets the rowspan of the specified box + + + + + + Recursively measures words inside the box + + the box to measure + Device to use + + + + Tells if the columns widths can be reduced, + by checking the minimum widths of all cells + + + + + + Tells if the specified column can be reduced, + by checking its minimum width + + + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Calculate the min and max width for each column of the table by the content in all rows.
+ the min width possible without clipping content
+ the max width the cell content can take without wrapping
+ + if to measure only columns that have no calculated width + return the min width for each column - the min width possible without clipping content + return the max width for each column - the max width the cell content can take without wrapping + + + + Gets the width available for cells + + + + It takes away the cell-spacing from + + + + + Gets the current sum of column widths + + + + + + Gets the span attribute of the tag of the specified box + + + + + + Gets the minimum width of each column + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual vertical spacing of the table + + + + + Represents and gets info about a CSS Length + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + Creates a new CssLength from a length specified on a CSS style sheet or fragment + + Length as specified in the Style Sheet or style fragment + + + + Gets the number in the length + + + + + Gets if the length has some parsing error + + + + + Gets if the length represents a precentage (not actually a length) + + + + + Gets if the length is specified in relative units + + + + + Gets the unit of the length + + + + + Gets the length as specified in the string + + + + + If length is in Ems, returns its value in points + + Em size factor to multiply + Points size of this em + If length has an error or isn't in ems + + + + If length is in Ems, returns its value in pixels + + Pixel size factor to multiply + Pixels size of this em + If length has an error or isn't in ems + + + + Returns the length formatted ready for CSS interpreting. + + + + + + Represents a line of text. + + + To learn more about line-boxes see CSS spec: + http://www.w3.org/TR/CSS21/visuren.html + + + + + Creates a new LineBox + + + + + Gets a list of boxes related with the linebox. + To know the words of the box inside this linebox, use the method. + + + + + Gets the words inside the linebox + + + + + Gets the owner box + + + + + Gets a List of rectangles that are to be painted on this linebox + + + + + Get the height of this box line (the max height of all the words) + + + + + Get the bottom of this box line (the max bottom of all the words) + + + + + Lets the linebox add the word an its box to their lists if necessary. + + + + + + Return the words of the specified box that live in this linebox + + + + + + + Updates the specified rectangle of the specified box. + + + + + + + + + + Copies the rectangles to their specified box + + + + + Sets the baseline of the words of the specified box to certain height + + Device info + box to check words + baseline + + + + Check if the given word is the last selected word in the line.
+ It can either be the last word in the line or the next word has no selection. + + the word to check + + + + + Returns the words of the linebox + + + + + + Represents a word inside an inline box + + + Because of performance, words of text are the most atomic + element in the project. It should be characters, but come on, + imagine the performance when drawing char by char on the device.
+ It may change for future versions of the library. + + + + + the CSS box owner of the word + + + + + Rectangle + + + + + If the word is selected this points to the selection handler for more data + + + + + Init. + + the CSS box owner of the word + + + + Gets the Box where this word belongs. + + + + + Gets or sets the bounds of the rectangle + + + + + Left of the rectangle + + + + + Top of the rectangle + + + + + Width of the rectangle + + + + + Get the full width of the word including the spacing. + + + + + Gets the actual width of whitespace between words. + + + + + Height of the rectangle + + + + + Gets or sets the right of the rectangle. When setting, it only affects the Width of the rectangle. + + + + + Gets or sets the bottom of the rectangle. When setting, it only affects the Height of the rectangle. + + + + + If the word is selected this points to the selection handler for more data + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + is the word is currently selected + + + + + the selection start index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the word is partially selected (-1 if not selected or fully selected) + + + + + Gets or sets an offset to be considered in measurements + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + the image object if it is image word (can be null if not loaded) + + + + + the image rectangle restriction as returned from image load event + + + + + Creates a new BoxWord which represents an image + + the CSS box owner of the word + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + the image rectange restriction as returned from image load event + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + The word text + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Init. + + the CSS box owner of the word + the word chars + was there a whitespace before the word chars (before trim) + was there a whitespace after the word chars (before trim) + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + Represents this word for debugging purposes + + + + + + Used to make space on vertical cell combination + + + + + the index of the row where box starts + + + + + the index of the row where box ends + + + + + Gets the index of the row where box starts + + + + + Gets the index of the row where box ends + + + + + Represents the possible units of the CSS lengths + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + CSS boxes that have ":hover" selector on them. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + Init. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + the name of the html tag + + + + + if the tag is single placed; in other words it doesn't have a separate closing tag; + + + + + collection of attributes and their value the html tag has + + + + + Init. + + the name of the html tag + if the tag is single placed; in other words it doesn't have a separate closing tag; + collection of attributes and their value the html tag has + + + + Gets the name of this tag + + + + + Gets collection of attributes and their value the html tag has + + + + + Gets if the tag is single placed; in other words it doesn't have a separate closing tag;
+ e.g. <br> + + + + + is the html tag has attributes. + + true - has attributes, false - otherwise + + + + Gets a boolean indicating if the attribute list has the specified attribute + + attribute name to check if exists + true - attribute exists, false - otherwise + + + + Get attribute value for given attribute name or null if not exists. + + attribute name to get by + optional: value to return if attribute is not specified + attribute value or null if not found + + + + Represents a block of CSS property values.
+ Contains collection of key-value pairs that are CSS properties for specific css class.
+ Css class can be either custom or html tag name. + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + the name of the css class of the block + + + + + the CSS block properties and values + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + is the css block has :hover pseudo-class + + + + + Creates a new block from the block's source + + the name of the css class of the block + the CSS block properties and values + optional: additional selectors to used in hierarchy + optional: is the css block has :hover pseudo-class + + + + the name of the css class of the block + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + Gets the CSS block properties and its values + + + + + is the css block has :hover pseudo-class + + + + + Merge the other block properties into this css block.
+ Other block properties can overwrite this block properties. + + the css block to merge with + + + + Create deep copy of the CssBlock. + + new CssBlock with same data + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Check if the selectors of the css blocks is the same. + + the other block to compare to + true - the selectors on blocks are the same, false - otherwise + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Serves as a hash function for a particular type. + + A hash code for the current . + + + + Returns a that represents the current . + + + + + Holds single class selector in css block hierarchical selection (p class1 > div.class2) + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Creates a new block from the block's source + + the name of the css class of the block + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Returns a that represents the current . + + + + + Controls the way styles are generated when html is generated. + + + + + styles are not generated at all + + + + + style are inserted in style attribute for each html tag + + + + + style section is generated in the head of the html + + + + + Callback used in to allow setting image externally and async.
+ The callback can provide path to image file path, URL or the actual image to use.
+ If is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + the image to use + optional: limit to specific rectangle in the loaded image + + + + Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and + provide file path to load the image from. Can also use the asynchronous image overwrite not to block HTML rendering is applicable.
+ If no alternative data is provided the original source will be used.
+ + + + + use to cancel the image loading by html renderer, the provided image will be used. + + + + + the source of the image (file path or uri) + + + + + collection of all the attributes that are defined on the image element + + + + + Callback used to allow setting image externally and async. + + + + + Init. + + the source of the image (file path or Uri) + collection of all the attributes that are defined on the image element + Callback used to allow setting image externally and async. + + + + the source of the image (file path, URL or inline data) + + + + + collection of all the attributes that are defined on the image element or CSS style + + + + + Indicate the image load is handled asynchronously. + Cancel this image loading and overwrite the image asynchronously using callback method.
+ + + + + Callback to overwrite the loaded image with error image.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + the path to the image to load (file path or URL) + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + + + + + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ If imageRectangle is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + + + + + Raised when the user clicks on a link in the html. + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + Init. + + the link href that was clicked + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + + + + + + + Exception thrown when client code subscribed to LinkClicked event thrown exception. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a specified error message. + + The message that describes the error. + + + + Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ It can happen if some async event has occurred that requires re-paint and re-layout of the html.
+ Example: async download of image is complete. + + + + + is re-layout is required for the refresh + + + + + Init. + + is re-layout is required for the refresh + + + + is re-layout is required for the refresh + + + + + + + + + + + Raised when an error occurred during html rendering. + + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + Init. + + the type of error to report + the error message + optional: the exception that occurred + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + + + + + + + Enum of possible error types that can be reported. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + the location to scroll to + + + + + Init. + + the location to scroll to + + + + the x location to scroll to + + + + + the x location to scroll to + + + + + + + + + + + Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Init. + + the source of the image (file path or URL) + collection of all the attributes that are defined on the image element + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Holds data on link element in HTML.
+ Used to expose data outside of HTML Renderer internal structure. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Init. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Is the link is directed to another element in the html + + + + + Return the id of the element this anchor link is referencing. + + + + + + + + + + + Contains all the paint code to paint different background images. + + + + + Draw the background image of the given box in the given rectangle.
+ Handle background-repeat and background-position values. + + the device to draw into + the box to draw its background image + the handler that loads image to draw + the rectangle to draw image in + + + + Get top-left location to start drawing the image at depending on background-position value. + + the background-position value + the rectangle to position image in + the size of the image + the top-left location + + + + Draw the background image at the required location repeating it over the X axis.
+ Adjust location to left if starting location doesn't include all the range (adjusted to center or right). + + + + + Draw the background image at the required location repeating it over the Y axis.
+ Adjust location to top if starting location doesn't include all the range (adjusted to center or bottom). + + + + + Draw the background image at the required location repeating it over the X and Y axis.
+ Adjust location to left-top if starting location doesn't include all the range (adjusted to center or bottom/right). + + + + + Contains all the complex paint code to paint different style borders. + + + + + used for all border paint to use the same points and not create new array each time. + + + + + Draws all the border of the box with respect to style, width, etc. + + the device to draw into + the box to draw borders for + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Draw simple border. + + Desired border + the device to draw to + Box which the border corresponds + the brush to use + the bounding rectangle to draw in + Beveled border path, null if there is no rounded corners + + + + Draw specific border (top/bottom/left/right) with the box data (style/width/rounded).
+ + desired border to draw + the box to draw its borders, contain the borders data + the device to draw into + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + + + + Set rectangle for inset/outset border as it need diagonal connection to other borders. + + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + Beveled border path, null if there is no rounded corners + + + + Makes a border path for rounded borders.
+ To support rounded dotted/dashed borders we need to use arc in the border path.
+ Return null if the border is not rounded.
+ + the device to draw into + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Beveled border path, null if there is no rounded corners + + + + Get pen to be used for border draw respecting its style. + + + + + Get the border color for the given box border. + + + + + Get the border width for the given box border. + + + + + Get the border style for the given box border. + + + + + Makes the specified color darker for inset/outset borders. + + + + + Handle context menu. + + + + + select all text + + + + + copy selected text + + + + + copy the link source + + + + + open link (as left mouse click) + + + + + copy the source of the image + + + + + copy image to clipboard + + + + + save image to disk + + + + + open video in browser + + + + + copy video url to browser + + + + + the selection handler linked to the context menu handler + + + + + the html container the handler is on + + + + + the last context menu shown + + + + + the control that the context menu was shown on + + + + + the css rectangle that context menu shown on + + + + + the css link box that context menu shown on + + + + + Init context menu items strings. + + + + + Init. + + the selection handler linked to the context menu handler + the html container the handler is on + + + + Show context menu clicked on given rectangle. + + the parent control to show the context menu on + the rectangle that was clicked to show context menu + the link that was clicked to show context menu on + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Dispose of the last used context menu. + + + + + Handle link click. + + + + + Copy the href of a link to clipboard. + + + + + Open save as dialog to save the image + + + + + Copy the image source to clipboard. + + + + + Copy image object to clipboard. + + + + + Copy selected text. + + + + + Select all text. + + + + + Utilities for fonts and fonts families handling. + + + + + + + + + + Allow to map not installed fonts to different + + + + + collection of all installed and added font families to check if font exists + + + + + cache of all the font used not to create same font again and again + + + + + Init. + + + + + Check if the given font family exists by name + + the font to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get cached font instance for the given font properties.
+ Improve performance not to create same font multiple times. + + cached font instance + + + + Get cached font if it exists in cache or null if it is not. + + + + + create font (try using existing font family to support custom fonts) + + + + + Handler for all loading image logic.
+

+ Loading by .
+ Loading by file path.
+ Loading by URI.
+

+ + + + Supports sync and async image loading. + + + If the image object is created by the handler on calling dispose of the handler the image will be released, this + makes release of unused images faster as they can be large.
+ Disposing image load handler will also cancel download of image from the web. + + + + + + the container of the html to handle load image for + + + + + callback raised when image load process is complete with image or without + + + + + the web client used to download image from URL (to cancel on dispose) + + + + + Must be open as long as the image is in use + + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + to know if image load event callback was sync or async raised + + + + + flag to indicate if to release the image object on box dispose (only if image was loaded by the box) + + + + + is the handler has been disposed + + + + + Init. + + the container of the html to handle load image for + callback raised when image load process is complete with image or without + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + Set image of this image box by analyzing the src attribute.
+ Load the image from inline base64 encoded string.
+ Or from calling property/method on the bridge object that returns image or URL to image.
+ Or from file path
+ Or from URI. + + + File path and URI image loading is executed async and after finishing calling + on the main thread and not thread-pool. + + the source of the image to load + the collection of attributes on the element to use in event + the image object (null if failed) + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set the image using callback from load image event, use the given data. + + the path to the image to load (file path or uri) + the image to load + optional: limit to specific rectangle of the image and not all of it + + + + Load the image from inline base64 encoded string data. + + the source that has the base64 encoded image + + + + Extract image object from inline base64 encoded data in the src of the html img element. + + the source that has the base64 encoded image + image from base64 data string or null if failed + + + + Load image from path of image file or URL. + + the file path or uri to load image from + + + + Load the image file on thread-pool thread and calling after. + + the file path to get the image from + + + + Load the image file on thread-pool thread and calling after.
+ Calling on the main thread and not thread-pool. + + the file path to get the image from + + + + Load image from the given URI by downloading it.
+ Create local file name in temp folder from the URI, if the file already exists use it as it has already been downloaded. + If not download the file using . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + key value pair of URL and file info to download the file to + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + Flag image load complete and request refresh for re-layout and invalidate. + + + + + Release the image and client objects. + + + + + Handler for text selection in the html. + + + + + the root of the handled html tree + + + + + handler for showing context menu on right click + + + + + the mouse location when selection started used to ignore small selections + + + + + the starting word of html selection
+ where the user started the selection, if the selection is backwards then it will be the last selected word. + + + + + the ending word of html selection
+ where the user ended the selection, if the selection is backwards then it will be the first selected word. + + + + + the selection start index if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + is the selection goes backward in the html, the starting word comes after the ending word in DFS traversing.
+ + + + + used to ignore mouse up after selection + + + + + current selection process is after double click (full word selection) + + + + + used to know if selection is in the control or started outside so it needs to be ignored + + + + + used to handle drag and drop + + + + + is the cursor on the control has been changed by the selection handler + + + + + used to know if double click selection is requested + + + + + used to know if drag and drop was already started not to execute the same operation over + + + + + Init. + + the root of the handled html tree + + + + Select all the words in the html. + + the control hosting the html to invalidate + + + + Select the word at the given location if found. + + the control hosting the html to invalidate + the location to select word at + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse on the html + + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + is the left mouse button has been released + is the mouse up should be ignored + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse on the html + + + + On mouse leave change the cursor back to default. + + the control hosting the html to set cursor and invalidate + + + + Copy the currently selected html segment to clipboard.
+ Copy rich html text and plain text. + + + + + Get the currently selected text segment in the html.
+ + + + + Copy the currently selected html segment with style.
+ + + + + The selection start index if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start index for + data value or -1 if not applicable + + + + The selection end index if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end index for + + + + The selection start offset if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start offset for + + + + The selection end offset if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end offset for + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Handle html text selection by mouse move over the html with left mouse button pressed.
+ Calculate the words in the selected range and set their selected property. + + the control hosting the html to invalidate + the mouse location + true - partial word selection allowed, false - only full words selection + + + + Clear the current selection. + + + + + Clear the selection from all the words in the css box recursively. + + the css box to selectionStart clear at + + + + Start drag and drop operation on the currently selected html segment. + + the control to start the drag and drop on + + + + Select all the words that are under DOM hierarchy.
+ + the box to start select all at + + + + Check if the current selection is non empty, has some selection data. + + + true - partial word selection allowed, false - only full words selection + true - is non empty selection, false - empty selection + + + + Select all the words that are between word and word in the DOM hierarchy.
+ + the root of the DOM sub-tree the selection is in + selection start word limit + selection end word limit + + + + Select all the words that are between word and word in the DOM hierarchy. + + the current traversal node + selection start word limit + selection end word limit + used to know the traversal is currently in selected range + + + + + Calculate the character index and offset by characters for the given word and given offset.
+ . + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + to set the starting or ending char and offset data + + + + Calculate the character index and offset by characters for the given word and given offset.
+ If the location is below the word line then set the selection to the end.
+ If the location is to the right of the word then set the selection to the end.
+ If the offset is to the left of the word set the selection to the beginning.
+ Otherwise calculate the width of each substring to find the char the location is on. + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + is to include the first character in the calculation + return the index of the char under the location + return the offset of the char under the location + + + + Check if the selection direction is forward or backward.
+ Is the selection start word is before the selection end word in DFS traversal. + + + + + Handler for loading a stylesheet data. + + + + + Load stylesheet data from the given source.
+ The source can be local file or web URI.
+ First raise event to allow the client to overwrite the stylesheet loading.
+ If the stylesheet is downloaded from URI we will try to correct local URIs to absolute.
+ + the container of the html to handle load stylesheet for + the source of the element to load the stylesheet by + the attributes of the link element + return the stylesheet string that has been loaded (null if failed or is given) + return stylesheet data object that was provided by overwrite (null if failed or is given) + + + + Load stylesheet string from given source (file path or uri). + + the container of the html to handle load stylesheet for + the file path or uri to load the stylesheet from + the stylesheet string + + + + Load the stylesheet from local file by given path. + + the container of the html to handle load stylesheet for + the stylesheet file to load + the loaded stylesheet string + + + + Load the stylesheet from uri by downloading the string. + + the container of the html to handle load stylesheet for + the uri to download from + the loaded stylesheet string + + + + Make relative URLs absolute in the stylesheet using the URI of the stylesheet. + + the stylesheet to correct + the stylesheet uri to use to create absolute URLs + Corrected stylesheet + + + + Low level handling of Html Renderer logic.
+ Allows html layout and rendering without association to actual control, those allowing to handle html rendering on any graphics object.
+ Using this class will require the client to handle all propagation's of mouse/keyboard events, layout/paint calls, scrolling offset, + location/size/rectangle handling and UI refresh requests.
+ + + + MaxSize and ActualSize:
+ The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can exceed the max size by layout restrictions (unwrap-able line, set image size, etc.).
+ Set zero for unlimited (width/height separately).
+ + + ScrollOffset:
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ Element that is rendered at location (50,100) with offset of (0,200) will not be rendered + at -100, therefore outside the client rectangle. + + + LinkClicked event
+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link to overwrite by custom logic.
+ If error occurred in event handler it will propagate up the stack. + + + StylesheetLoad event:
+ Raised when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + ImageLoad event:
+ Raised when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ + + Refresh event:
+ Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + RenderError event:
+ Raised when an error occurred during html rendering.
+ + + + + + + + + + + + + + + + parser for CSS data + + + + + the root css box of the parsed html + + + + + list of all css boxes that have ":hover" selector on them + + + + + Handler for text selection in the html. + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + the parsed stylesheet data used for handling the html + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled (default - true) + + + + + Gets or sets a value indicating if anti-aliasing should be avoided + for geometry like backgrounds and borders + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ + + + + the top-left most location of the rendered html + + + + + the max width and height of the rendered html, effects layout, actual size cannot exceed this values.
+ Set zero for unlimited.
+ + + + + Gets or sets the scroll offset of the document for scroll controls + + + + + The actual size of the rendered html (after layout) + + + + + Init. + + + + + + + + + + parser for CSS data + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrapable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + the root css box of the parsed html + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + + + + + + + Clear the content of the HTML container releasing any resources used to render previously existing content. + + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given device. + + the device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the location of the mouse + the mouse event data + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + Raise the stylesheet load event with the given event args. + + the event args + + + + Raise the image load event with the given event args. + + the event args + + + + Request invalidation and re-layout of the control hosting the renderer. + + is re-layout is required for the refresh + + + + Report error in html render process. + + the type of error to report + the error message + optional: the exception that occured + + + + Handle link clicked going over event and using if not canceled. + + the control hosting the html to invalidate + the location of the mouse + the link that was clicked + + + + Add css box that has ":hover" selector to be handled on mouse hover. + + the box that has the hover selector + the css block with the css data with the selector + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Adjust the offset of the given location by the current scroll offset. + + the location to adjust + the adjusted location + + + + Check if the mouse is currently on the html container.
+ Relevant if the html container is not filled in the hosted control (location is not zero and the size is not the full size of the control). + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + General utilities. + + + + + Measure the size of the html by performing layout under the given restrictions. + + the graphics to use + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Perform the layout of the html container by given size restrictions returning the final size.
+ The layout can be effected by the HTML content in the if or + is set to true.
+ Handle minimum and maximum size restrictions.
+ Handle auto size and auto size for height only. if is true + is ignored.
+ + the graphics used for layout + the html container to layout + the current size + the min size restriction - can be empty for no restriction + the max size restriction - can be empty for no restriction + if to modify the size (width and height) by html content layout + if to modify the height by html content layout + + + + Parser to parse CSS stylesheet source string into CSS objects. + + + + + split CSS rule + + + + + + + + + + Utility for value parsing. + + + + + The chars to trim the css class name by + + + + + Init. + + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + raw css stylesheet to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the CSS data with parsed CSS objects (never null) + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ The parsed css blocks are added to the given css data, merged if class name already exists. + + the CSS data to fill with parsed CSS objects + raw css stylesheet to parse + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the font-family value to parse + parsed font-family value + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + color value + + + + Remove comments from the given stylesheet. + + the stylesheet to remove comments from + stylesheet without comments + + + + Parse given stylesheet for CSS blocks
+ This blocks are added under the "all" keyword. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Parse given stylesheet for media CSS blocks
+ This blocks are added under the specific media block they are found. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Feeds the style with a block about the specific media.
+ When no media is specified, "all" will be used. + + + the CSS block to handle + optional: the media (default - all) + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse css block selector to support hierarchical selector (p class1 > class2). + + the class selector to parse + return the main class the css block is on + returns the hierarchy of classes or null if single class selector + + + + Parse the properties of the given css block into a key-value dictionary. + + the raw css block to parse + dictionary with parsed css block properties + + + + Add the given property to the given properties collection, if the property is complex containing + multiple css properties then parse them and add the inner properties. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse length property to add only valid lengths. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse color property to add only valid color. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse a complex font property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + + + the value of the property to parse + parsed value + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the value of the property to parse + parsed font-family value + + + + Parse a complex border property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the left, top, right or bottom direction of the border to parse + the properties collection to add the specific properties to + + + + Parse a complex margin property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border style property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border width property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border color property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex padding property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Split multi direction value into the proper direction values (left, top, right, bottom). + + + + + Split the value by the specified separator; e.g. Useful in values like 'padding:5 4 3 inherit' + + Value to be splitted + + Splitted and trimmed values + + + + + + + + + + + + + Parse the given substring to extract border width substring. + Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse CSS properties values like numbers, Urls, etc. + + + + + + + + + + Init. + + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid double number, false - otherwise + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid int number, false - otherwise + + + + Check if the given string is a valid length value. + + the string value to check + true - valid, false - invalid + + + + Evals a number and returns it. If number is a percentage, it will be multiplied by hundredPercent + + Number to be parsed + Number that represents the 100% if parsed number is a percentage + Parsed number. Zero if error while parsing. + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + if the length is in pixels and the length is font related it needs to use 72/96 factor + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + if the length is in pixels and the length is font related it needs to use 72/96 factor + Allows the return double to be in points. If false, result will be pixels + the parsed length value with adjustments + + + + Get the unit to use for the length, use default if no unit found in length string. + + + + + Check if the given color string value is valid. + + color string value to parse + true - valid, false - invalid + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + Color value + + + + Parses a color value in CSS style; e.g. #ff0000, RED, RGB(255,0,0), RGB(100%, 0, 0) + + color substring value to parse + substring start idx + substring length + return the parsed color + true - valid color, false - otherwise + + + + Parses a border value in CSS style; e.g. 1px, 1, thin, thick, medium + + + + + + + + Get color by parsing given hex value color string (#A28B34). + + true - valid color, false - otherwise + + + + Get color by parsing given RGB value color string (RGB(255,180,90)) + + true - valid color, false - otherwise + + + + Get color by parsing given RGBA value color string (RGBA(255,180,90,180)) + + true - valid color, false - otherwise + + + + Get color by given name, including .NET name. + + true - valid color, false - otherwise + + + + Parse the given decimal number string to positive int value.
+ Start at given , ignore whitespaces and take + as many digits as possible to parse to int. + + the string to parse + the index to start parsing at + parsed int or 0 + + + + Parse the given decimal number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Parse the given hex number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Handle css DOM tree generation from raw html and stylesheet. + + + + + Parser for CSS + + + + + Init. + + + + + Generate css tree by parsing the given html and applying the given css style data on it. + + the html to parse + the html container to use for reference resolve + the css data to use + the root of the generated tree + + + + Read styles defined inside the dom structure in links and style elements.
+ If the html tag is "style" tag parse it content and add to the css data for all future tags parsing.
+ If the html tag is "link" that point to style data parse it content and add to the css data for all future tags parsing.
+ + the box to parse style data in + the html container to use for reference resolve + the style data to fill with found styles + check if the css data has been modified by the handled html not to change the base css data + + + + Applies style to all boxes in the tree.
+ If the html tag has style defined for each apply that style to the css box of the tag.
+ If the html tag has "class" attribute and the class name has style defined apply that style on the tag css box.
+ If the html tag has "style" attribute parse it and apply the parsed style on the tag css box.
+ + the box to apply the style to + the style data for the html + + + + Set the selected text style (selection text color and background color). + + + the style data + + + + Assigns the given css classes to the given css box checking if matching.
+ Support multiple classes in single attribute separated by whitespace. + + the css box to assign css to + the css data to use to get the matching css blocks + + + + Assigns the given css style blocks to the given css box checking if matching. + + the css box to assign css to + the css data to use to get the matching css blocks + the class selector to search for css blocks + + + + Check if the given css block is assignable to the given css box.
+ the block is assignable if it has no hierarchical selectors or if the hierarchy matches.
+ Special handling for ":hover" pseudo-class.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Check if the given css block is assignable to the given css box by validating the selector.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Assigns the given css style block properties to the given css box. + + the css box to assign css to + the css block to assign + + + + Check if the given style is allowed to be set on the given css box.
+ Used to prevent invalid CssBoxes creation like table with inline display style. + + the css box to assign css to + the style key to cehck + the style value to check + true - style allowed, false - not allowed + + + + Clone css data if it has not already been cloned.
+ Used to preserve the base css data used when changed by style inside html. + + + + + + + + + + + + Converts an HTML length into a Css length + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Execute action on all the "td" cells of the table.
+ Handle if there is "theader" or "tbody" exists. + + the table element + the action to execute + + + + Go over all the text boxes (boxes that have some text that will be rendered) and + remove all boxes that have only white-spaces but are not 'preformatted' so they do not effect + the rendered html. + + the current box to correct its sub-tree + + + + Go over all image boxes and if its display style is set to block, put it inside another block but set the image to inline. + + the current box to correct its sub-tree + + + + Correct the DOM tree recursively by replacing "br" html boxes with anonymous blocks that respect br spec.
+ If the "br" tag is after inline box then the anon block will have zero height only acting as newline, + but if it is after block box then it will have min-height of the font size so it will create empty line. + + the current box to correct its sub-tree + used to know if the br is following a box so it should create an empty line or not so it only + move to a new line + + + + Correct DOM tree if there is block boxes that are inside inline blocks.
+ Need to rearrange the tree so block box will be only the child of other block box. + + the current box to correct its sub-tree + + + + Rearrange the DOM of the box to have block box with boxes before the inner block box and after. + + the box that has the problem + + + + Split bad box that has inline and block boxes into two parts, the left - before the block box + and right - after the block box. + + the parent box that has the problem + the box to split into different boxes + the left block box that is created for the split + + + + Makes block boxes be among only block boxes and all inline boxes have block parent box.
+ Inline boxes should live in a pool of Inline boxes only so they will define a single block.
+ At the end of this process a block box will have only block siblings and inline box will have + only inline siblings. + + the current box to correct its sub-tree + + + + Check if the given box contains only inline child boxes in all subtree. + + the box to check + true - only inline child boxes, false - otherwise + + + + Check if the given box contains inline and block child boxes. + + the box to check + true - has variant child boxes, false - otherwise + + + + + + + + + Parses the source html to css boxes tree structure. + + the html source to parse + + + + Add html text anon box to the current box, this box will have the rendered text
+ Adding box also for text that contains only whitespaces because we don't know yet if + the box is preformatted. At later stage they will be removed if not relevant. + + the html source to parse + the start of the html part + the index of the next html tag + the current box in html tree parsing + + + + Parse the html part, the part from prev parsing index to the beginning of the next html tag.
+ + the html source to parse + the index of the next html tag + the current box in html tree parsing + the end of the parsed part, the new start index + + + + Parse raw html tag source to object.
+ Extract attributes found on the tag. + + the html source to parse + the start index of the tag in the source + the length of the tag from the start index in the source + return the name of the html tag + return the dictionary of tag attributes + true - the tag is closing tag, false - otherwise + + + + Extract html tag attributes from the given sub-string. + + the html source to parse + the start index of the tag attributes in the source + the length of the tag attributes from the start index in the source + return the dictionary of tag attributes + + + + Collection of regular expressions used when parsing + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + Static class that contains argument-checking methods + + + + + Validate given condition is true, otherwise throw exception. + + Exception type to throw. + Condition to assert. + Exception message in-case of assert failure. + + + + Validate given argument isn't Null. + + argument to validate + Name of the argument checked + if is Null + + + + Validate given argument isn't . + + argument to validate + Name of the argument checked + if is + + + + Validate given argument isn't Null or empty. + + argument to validate + Name of the argument checked + if is Null or empty + + + + Validate given argument isn't Null. + + Type expected of arg + argument to validate + Name of the argument checked + if is Null + arg cast as T + + + + Validate given argument isn't Null or empty AND argument value is the path of existing file. + + argument to validate + Name of the argument checked + if is Null or empty + if arg file-path not exist + + + + Utility methods for general stuff. + + + + + Table to convert numbers into roman digits + + + + + Check if the given char is of Asian range. + + the character to check + true - Asian char, false - otherwise + + + + Check if the given char is a digit character (0-9) and (0-9, a-f for HEX) + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Convert the given char to digit. + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Get size that is max of and for width and height separately. + + + + + Get Uri object for the given path if it is valid uri path. + + the path to get uri for + uri or null if not valid + + + + Get the first value in the given dictionary. + + the type of dictionary key + the type of dictionary value + the dictionary + optional: the default value to return of no elements found in dictionary + first element or default value + + + + Get file info object for the given path if it is valid file path. + + the path to get file info for + file info or null if not valid + + + + Get web client response content type. + + the web client to get the response content type from + response content type or null + + + + Gets the representation of the online uri on the local disk. + + The online image uri. + The path of the file on the disk. + + + + Get substring seperated by whitespace starting from the given idex. + + the string to get substring in + the index to start substring search from + return the length of the found string + the index of the substring, -1 if no valid sub-string found + + + + Compare that the substring of is equal to + Assume given substring is not empty and all indexes are valid!
+ + true - equals, false - not equals + + + + Replaces invalid filename chars to '_' + + The possibly-not-valid filename + A valid filename. + + + + Convert number to alpha numeric system by the requested style (UpperAlpha, LowerRoman, Hebrew, etc.). + + the number to convert + the css style to convert by + converted string + + + + Convert the given integer into alphabetic numeric format (D, AU, etc.) + + the number to convert + is to use lowercase + the roman number string + + + + Convert the given integer into alphabetic numeric format (alpha, AU, etc.) + + the number to convert + the roman number string + + + + Convert the given integer into roman numeric format (II, VI, IX, etc.) + + the number to convert + if to use lowercase letters for roman digits + the roman number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + String constants to avoid typing errors. + + + + + Centimeters + + + + + Millimeters + + + + + Pixels + + + + + Inches + + + + + Em - The font size of the relevant font + + + + + The 'x-height' of the relevan font + + + + + Points + + + + + Picas + + + + + Default font size in points. Change this value to modify the default font size. + + + + + Default font used for the generic 'serif' family + + + + + Utility method for handling CSS stuff. + + + + + Brush for selection background + + + + + Brush for selection background + + + + + Gets the white space width of the specified box + + + + + + + + Get CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to get it's property value + the name of the CSS property + the value of the property, null if no such property exists + + + + Set CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to set it's property value + the name of the CSS property + the value to set + + + + Utility class for traversing DOM structure and execution stuff on it. + + + + + Check if the given location is inside the given box deep.
+ Check inner boxes and all lines that the given box spans to. + + the box to check + the location to check + true - location inside the box, false - otherwise + + + + Check if the given box contains only inline child boxes. + + the box to check + true - only inline child boxes, false - otherwise + + + + Recursively searches for the parent with the specified HTML Tag name + + + + + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + fix word space for first word in inline tag. + + the box to check + + + + Gets the next sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Get attribute value by given key starting search from given box, search up the tree until + attribute found or root. + + the box to start lookup at + the attribute to get + the value of the attribute or null if not found + + + + Get css box under the given sub-tree at the given x,y location, get the inner most.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + Optional: if to get only visible boxes (default - true) + css link box if exists or null + + + + Collect all link boxes found in the HTML tree. + + the box to start search from + collection to add all link boxes to + + + + Get css link box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + css link box if exists or null + + + + Get css box under the given sub-tree with the given id.
+ + the box to start search from + the id to find the box by + css box if exists or null + + + + Get css line box under the given sub-tree at the given y location or the nearest line from the top.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the line box to search in + the location to find the box at + css word box if exists or null + + + + Find the css line box that the given word is in. + + the word to search for it's line box + line box that the word is in + + + + Get selected plain text of the given html sub-tree. + + the DOM box to get selected text from its sub-tree + the selected plain text string + + + + Generate html from the given DOM tree.
+ Generate all the style inside the html, in header or for every tag depending on value. + + the box of the html generate html from + Optional: controls the way styles are generated when html is generated + Optional: true - generate only selected html subset, false - generate all (default - false) + generated html + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the root to generate tree from + generated tree + + + + Get selected plain text of the given html sub-tree.
+ Append all the selected words. + + the builder to append the selected text to + the DOM box to get selected text from its sub-tree + the index of the last word appended + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ + the box to check its sub-tree + the collection to add the selected tags to + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ Use to handle boxes that are between selected words but don't have selected word inside.
+ + the box to check its sub-tree + the hash to add the selected boxes to + used to handle boxes that are between selected words but don't have selected word inside + is the current box is in selected sub-tree + + + + find the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + the root of the boxes tree + the selected boxes to find selection root in + the box that is the root of selected boxes + + + + Check if the given box has a names child box (has html tag) recursively. + + the box to check + true - in sub-tree there is a named box, false - otherwise + + + + Write the given html DOM sub-tree into the given string builder.
+ If are given write html only from those tags. + + used to parse CSS data + the string builder to write html into + the html sub-tree to write + Controls the way styles are generated when html is generated + Control if to generate only selected boxes, if given only boxes found in hash will be generated + the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + + + Write the given html tag with all its attributes and styles. + + used to parse CSS data + the string builder to write html into + the css box with the html tag to write + Controls the way styles are generated when html is generated + + + + Clean the given style collection by removing default styles so only custom styles remain.
+ Return new collection where the old remains unchanged. + + the box the styles apply to, used to know the default style + the collection of styles to clean + new cleaned styles collection + + + + Write stylesheet data inline into the html. + + the string builder to write stylesheet into + the css data to write to the head + + + + Get the selected word with respect to partial selected words. + + the word to append + is to get selected text or all the text in the word + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the box to generate for + the string builder to generate to + the current indent level to set indent of generated text + + + + Defines HTML strings + + + + + List of html tags that don't have content + + + + + the html encode\decode pairs + + + + + the html decode only pairs + + + + + Init. + + + + + Is the given html tag is single tag or can have content. + + the tag to check (must be lower case) + true - is single tag, false - otherwise + + + + Decode html encoded string to regular string.
+ Handles <, >, "&. + + the string to decode + decoded string + + + + Encode regular string into html encoded string.
+ Handles <, >, "&. + + the string to encode + encoded string + + + + Decode html special charecters encoded using char entity code (€) + + the string to decode + decoded string + + + + Decode html special charecters encoded using char entity name + + the string to decode + decoded string + + + + Provides some drawing functionality + + + + + Check if the given color is visible if painted (has alpha and color values) + + the color to check + true - visible, false - not visible + + + + Clip the region the graphics will draw on by the overflow style of the containing block.
+ Recursively travel up the tree to find containing block that has overflow style set to hidden. if not + block found there will be no clipping and null will be returned. + + the graphics to clip + the box that is rendered to get containing blocks + true - was clipped, false - not clipped + + + + Draw image loading icon. + + the device to draw into + + the rectangle to draw icon in + + + + Draw image failed to load icon. + + the device to draw into + + the rectangle to draw icon in + + + + Creates a rounded rectangle using the specified corner radius
+ NW-----NE + | | + | | + SW-----SE + + the device to draw into + Rectangle to round + Radius of the north east corner + Radius of the north west corner + Radius of the south east corner + Radius of the south west corner + GraphicsPath with the lines of the rounded rectangle ready to be painted + + + + Represents sub-string of a full string starting at specific location with a specific length. + + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Init sub-string that is the full string. + + the full string that this sub-string is part of + + + + Init. + + the full string that this sub-string is part of + the start index of the sub-string + the length of the sub-string starting at + is null + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Get string char at specific index. + + the idx to get the char at + char at index + + + + Is the sub-string is empty string. + + true - empty string, false - otherwise + + + + Is the sub-string is empty string or contains only whitespaces. + + true - empty or whitespace string, false - otherwise + + + + Is the sub-string contains only whitespaces (at least one). + + true - empty or whitespace string, false - otherwise + + + + Get a string of the sub-string.
+ This will create a new string object! + + new string that is the sub-string represented by this instance + + + + Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length. + + The zero-based starting character position of a substring in this instance. + The number of characters in the substring. + A String equivalent to the substring of length length that begins at startIndex in this instance, or + Empty if startIndex is equal to the length of this instance and length is zero. + + + + Collection of regular expressions used when parsing + + + + + Extracts CSS style comments; e.g. /* comment */ + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts CSS colors; e.g. black white #fff #fe98cd rgb(5,5,5) rgb(45%, 0, 0) + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts CSS border styles; e.g. solid none dotted + + + + + Extracts CSS border widthe; e.g. 1px thin 3em + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + Extracts HTML tags + + + + + Extracts attributes from a HTML tag; e.g. att=value, att="value" + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + 线条图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + 初始化参数 + + + + + 返回或设置X轴间隔 + + + + + 标题 + + + + + 返回图片的宽度 + + + + + 返回或设置图片的高度 + + + + + X轴的间距 + + + + + Y轴的间距 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 背景颜色 + + + + + X轴的颜色 + + + + + Y轴的颜色 + + + + + 返回X轴数据的最大值(供给Painter调用) + + + + + 返回图片数据 + + + + + 画布 + + + + + 作图器 + + + + + 释放内容资源 + + + + + 获取X轴中的最大值 + + + + + + + 获取所有X轴列中的最大值 + + + + + + + 初始化图片 + + X轴的数据 + + + + + 画一条走势图 + + + + + + 画多条走势图 + + + + + + 作图器的基础类 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 返回此作图器的相关链走势图 + + + + + 获取某值在Y轴上的位置 + + 当前点的值 + 点坐标 + + + + 画XY轴线 + + 画布 + X轴的数据 + + + + 画标题 + + + + + + 画走势线 + + 画布 + X轴数据 + + + + 方块图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图的X轴数据 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + + + 标题 + + + + + 值 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 值的颜色 + + + + + 值的字体 + + + + + 绘制颜色 + + + + + 值是否可见 + + + + + 克隆自身 + + + + + + 定义X轴的数据集合 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + 添加一批数据 + + 轴的标题 + + + + 添加一批数据 + + 轴的标题 + 轴的值 + + + + 重置轴的值 + + 轴的值 + + + + 克隆数据 + + + + + + Indicates the behavior of a key when a cell "on the edge" is being edited. + and the normal behavior of that key would exceed the edge. For example, + for a key that normally moves one column to the left, the "edge" would be + the left most column, since the normal action of the key cannot be taken + (since there are no more columns to the left). + + + + + 按键将被忽略 + + + + + 按键将导致单元格编辑环绕到相对边缘的单元格。 + + + + + 按键将Wrap，但该列将更改为相应的相邻列。这只对正常操作为ChangeRow的键有意义。 + + + + + 按键将Wrap，但该行将更改为相应的相邻行。这只对正常操作为ChangeColumn的键有意义. + + + + + 该键将导致当前编辑操作结束。 + + + + + Indicates the normal behaviour of a key when used during a cell edit + operation. + + + + + The key press will be ignored + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the left. + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the right. + + + + + The key press will end the current edit and begin an edit + operation on the row above. + + + + + The key press will end the current edit and begin an edit + operation on the row below + + + + + The key press will cancel the current edit + + + + + The key press will finish the current edit operation + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Instances of this class handle key presses during a cell edit operation. + + + + + 设置给定键的行为 + + + + + + + + 处理按键操作 + + + + True if the key was completely handled. + + + + Gets or sets the ObjectListView on which the current key is being handled. + This cannot be null. + + + + + Gets the row of the cell that is currently being edited + + + + + Gets the index of the column of the cell that is being edited + + + + + Gets or sets the map that remembers the normal behaviour of keys + + + + + Gets or sets the map that remembers the desired behaviour of keys + on edge cases. + + + + + Setup the default key mapping + + + + + Handle the end edit command + + + + + Handle the cancel edit command + + + + + Placeholder that subclasses can override to handle any custom verbs + + + + + + + + Handle a change row command + + + + + + + Handle a change column command + + + + + + + Start editing the indicated cell if that cell is not already being edited + + The row to edit + The cell within that row to edit + + + + Gets the adjacent item to the given item in the given direction. + If that item is disabled, continue in that direction until an enabled item is found. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more enabled items in that direction. + + + + Gets the adjacent item to the given item in the given direction, wrapping if needed. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more items in that direction. + + + + Gets a collection of columns that are editable in the order they are shown to the user + + + + + These items allow combo boxes to remember a value and its description. + + + + + + + + + + + + + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + This editor shows and auto completes values from the given listview column. + + + + + Create an AutoCompleteCellEditor + + + + + + + This combo box is specialised to allow editing of an enum. + + + + + + + + + + + This editor simply shows and edits integer values. + + + + + + + + + + Gets or sets the value shown by this editor + + + + + This editor simply shows and edits unsigned integer values. + + This class can't be made public because unsigned int is not a + CLS-compliant type. If you want to use, just copy the code to this class + into your project and use it from there. + + + + This editor simply shows and edits boolean values. + + + + + + + + + + This editor simply shows and edits boolean values using a checkbox + + + + + Gets or sets the value shown by this editor + + + + + Gets or sets how the checkbox will be aligned + + + + + This editor simply shows and edits floating point values. + + You can intercept the CellEditStarting event if you want + to change the characteristics of the editor. For example, by increasing + the number of decimal places. + + + + + + + + + Gets or sets the value shown by this editor + + + + + A delegate that creates an editor for the given value + + The model from which that value came + The column for which the editor is being created + A representative value of the type to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A control which can edit the given value + + + + An editor registry gives a way to decide what cell editor should be used to edit + the value of a cell. Programmers can register non-standard types and the control that + should be used to edit instances of that type. + + + All ObjectListViews share the same editor registry. + + + + + Create an EditorRegistry + + + + + Register that values of 'type' should be edited by instances of 'controlType'. + + The type of value to be edited + The type of the Control that will edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), typeof(MySpecialColorEditor)); + + + + + Register the given delegate so that it is called to create editors + for values of the given type + + The type of value to be edited + The delegate that will create a control that can edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), CreateColorEditor); + ... + public Control CreateColorEditor(Object model, OLVColumn column, Object value) + { + return new MySpecialColorEditor(); + } + + + + + Register a delegate that will be called to create an editor for values + that have not been handled. + + The delegate that will create a editor for all other types + + + + Register a delegate that will be given a chance to create a control + before any other option is considered. + + The delegate that will create a control + + + + Remove the registered handler for the given type + + Does nothing if the given type doesn't exist + The type whose registration is to be removed + + + + Create and return an editor that is appropriate for the given value. + Return null if no appropriate editor can be found. + + The model involved + The column to be edited + The value to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A Control that can edit the given type of values + + + + Create and return an editor that will edit values of the given type + + A enum type + + + + A DataListView is a ListView that can be bound to a datasource (which would normally be a DataTable or DataView). + + + This listview keeps itself in sync with its source datatable by listening for change events. + The DataListView will automatically create columns to show all of the data source's columns/properties, if there is not already + a column showing that property. This allows you to define one or two columns in the designer and then have the others generated automatically. + If you don't want any column to be auto generated, set to false. + These generated columns will be only the simplest view of the world, and would look more interesting with a few delegates installed. + This listview will also automatically generate missing aspect getters to fetch the values from the data view. + Changing data sources is possible, but error prone. Before changing data sources, the programmer is responsible for modifying/resetting + the column collection to be valid for the new data source. + Internally, a CurrencyManager controls keeping the data source in-sync with other users of the data source (as per normal .NET + behavior). This means that the model objects in the DataListView are DataRowView objects. If you write your own AspectGetters/Setters, + they will be given DataRowView objects. + + + + + Make a DataListView + + + + + + + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + When a DataSource is set, the control will create OLVColumns to show any + data source columns that are not already shown. + If the DataSource is changed, you will have to remove any previously + created columns, since they will be configured for the previous DataSource. + . + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + Adaptors cannot be shared between controls. Each DataListView needs its own adapter. + + + + + Add the given collection of model objects to this control. + + A collection of model objects + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Insert the given collection of objects before the given position + + Where to insert the objects + The objects to be inserted + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Remove the given collection of model objects from this control. + + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Change the Unfreeze behaviour + + + + + Handles parent binding context changes + + Unused EventArgs. + + + + A DataTreeListView is a TreeListView that calculates its hierarchy based on + information in the data source. + + + Like a , a DataTreeListView sources all its information + from a combination of and . + can be a DataTable, DataSet, + or anything that implements . + + + To function properly, the DataTreeListView requires: + + the table to have a column which holds a unique for the row. The name of this column must be set in . + the table to have a column which holds id of the hierarchical parent of the row. The name of this column must be set in . + a value which identifies which rows are the roots of the tree (). + + The hierarchy structure is determined finding all the rows where the parent key is equal to . These rows + become the root objects of the hierarchy. + + Like a TreeListView, the hierarchy must not contain cycles. Bad things will happen if the data is cyclic. + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. Actually, it can be any value that can + be compared for equality against a basic type. + If this is set to the wrong value (i.e. to a value that no row + has in the parent id column), the list will be empty. + + + + + Gets or sets the value that identifies a row as a root object. + . The RootKeyValue can be of any type, + but the IDE cannot sensibly represent a value of any type, + so this is a typed wrapper around that property. + + + If you want the root value to be something other than a string, + you will have set it yourself. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + An IDragSource controls how drag out from the ObjectListView will behave + + + + + A drag operation is beginning. Return the data object that will be used + for data transfer. Return null to prevent the drag from starting. The data + object will normally include all the selected objects. + + + The returned object is later passed to the GetAllowedEffect() and EndDrag() + methods. + + What ObjectListView is being dragged from. + Which mouse button is down? + What item was directly dragged by the user? There may be more than just this + item selected. + The data object that will be used for data transfer. This will often be a subclass + of DataObject, but does not need to be. + + + + What operations are possible for this drag? This controls the icon shown during the drag + + The data object returned by StartDrag() + A combination of DragDropEffects flags + + + + The drag operation is complete. Do whatever is necessary to complete the action. + + The data object returned by StartDrag() + The value returned from GetAllowedEffects() + + + + A do-nothing implementation of IDragSource that can be safely subclassed. + + + + + See IDragSource documentation + + + + + + + + + See IDragSource documentation + + + + + + + See IDragSource documentation + + + + + + + A reasonable implementation of IDragSource that provides normal + drag source functionality. It creates a data object that supports + inter-application dragging of text and HTML representation of + the dragged rows. It can optionally force a refresh of all dragged + rows when the drag is complete. + + Subclasses can override GetDataObject() to add new + data formats to the data transfer object. + + + + Construct a SimpleDragSource + + + + + Construct a SimpleDragSource that refreshes the dragged rows when + the drag is complete + + + + + + Gets or sets whether the dragged rows should be refreshed when the + drag operation is complete. + + + + + Create a DataObject when the user does a left mouse drag operation. + See IDragSource for further information. + + + + + + + + + Which operations are allowed in the operation? By default, all operations are supported. + + + All opertions are supported + + + + The drag operation is finished. Refreshe the dragged rows if so configured. + + + + + + + Create a data object that will be used to as the data object + for the drag operation. + + + Subclasses can override this method add new formats to the data object. + + The ObjectListView that is the source of the drag + A data object for the drag + + + + Objects that implement this interface can acts as the receiver for drop + operation for an ObjectListView. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Should the drag be allowed to continue? + + + + + + This is a do-nothing implementation of IDropSink that is a useful + base class for more sophisticated implementations. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Change the cursor to reflect the current drag operation. + + You only need to override this if you want non-standard cursors. + The standard cursors are supplied automatically. + + + + + Should the drag be allowed to continue? + + + You only need to override this if you want the user to be able + to end the drop in some non-standard way, e.g. dragging to a + certain point even without releasing the mouse, or going outside + the bounds of the application. + + + + + + This is called when the mouse leaves the drop region and after the + drop has completed. + + + + + The enum indicates which target has been found for a drop operation + + + + + No applicable target has been found + + + + + The list itself is the target of the drop + + + + + An item is the target + + + + + Between two items (or above the top item or below the bottom item) + can be the target. This is not actually ever a target, only a value indicate + that it is valid to drop between items + + + + + Above an item is the target + + + + + Below an item is the target + + + + + A subitem is the target of the drop + + + + + On the right of an item is the target (not currently used) + + + + + On the left of an item is the target (not currently used) + + + + + This class represents a simple implementation of a drop sink. + + + Actually, it should be called CleverDropSink -- it's far from simple and can do quite a lot in its own right. + + + + + Make a new drop sink + + + + + Get or set the locations where a drop is allowed to occur (OR-ed together) + + + + + Gets or sets whether this sink allows model objects to be dragged from other lists. Defaults to true. + + + + + Gets or sets whether the ObjectListView should scroll when the user drags + something near to the top or bottom rows. Defaults to true. + + AutoScroll does not scroll horizontally. + + + + Gets the billboard overlay that will be used to display feedback + messages during a drag operation. + + Set this to null to stop the feedback. + + + + Get or set whether a drop can occur between items of the list + + + + + Get or set whether a drop can occur on the listview itself + + + + + Get or set whether a drop can occur on items in the list + + + + + Get or set whether a drop can occur on a subitem in the list + + + + + Gets or sets whether the drop sink should draw feedback onto the given list + during the drag operation. Defaults to true. + + If this is false, you will have to give the user feedback in some + other fashion, like cursor changes + + + + Get or set the index of the item that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get or set the color that will be used to provide drop feedback + + + + + Get whether the alt key was down during this drop event + + + + + Get whether any modifier key was down during this drop event + + + + + Get whether the control key was down during this drop event + + + + + Get whether the left mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the shift key was down during this drop event + + + + + Get or set the state of the keys during this drop event + + + + + Gets or sets whether the drop sink will automatically use cursors + based on the drop effect. By default, this is true. If this is + set to false, you must set the Cursor yourself. + + + + + Triggered when the sink needs to know if a drop can occur. + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + + + + + Triggered when the sink needs to know if a drop can occur + AND the source is an ObjectListView + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + AND the source is an ObjectListView + + + + + Cleanup the drop sink when the mouse has left the control or + the drag has finished. + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag is moving over this control. + + + + + + Trigger the Dropped events + + + + + + Trigger CanDrop + + + + + + Trigger Dropped + + + + + + Trigger ModelCanDrop + + + + + + Trigger ModelDropped + + + + + + Handle the timer tick event, which is sent when the listview should + scroll + + + + + When the mouse is at the given point, what should the target of the drop be? + + This method should update the DropTarget* members of the given arg block + + The mouse point, in client co-ordinates + + + + What sort of action is possible when the mouse is at the given point? + + + + + + + + + + Based solely on the state of the modifier keys, what drop operation should + be used? + + The drop operation that matches the state of the keys + + + + Should the listview be made to scroll when the mouse is at the given point? + + + + + + Update the state of our sink to reflect the information that + may have been written into the drop event args. + + + + + + Draw the feedback that shows that the background is the target + + + + + + + Draw the feedback that shows that an item (or a subitem) is the target + + + + + DropTargetItem and DropTargetSubItemIndex tells what is the target + + + + + Draw the feedback that shows the drop will occur before target + + + + + + + Draw the feedback that shows the drop will occur after target + + + + + + + Return a GraphicPath that is round corner rectangle. + + + + + + + + Calculate the target rectangle when the given item (and possible subitem) + is the target of the drop. + + + + + + + + Draw a "between items" line at the given co-ordinates + + + + + + + + + + This drop sink allows items within the same list to be rearranged, + as well as allowing items to be dropped from other lists. + + + + This class can only be used on plain ObjectListViews and FastObjectListViews. + The other flavours have no way to implement the insert operation that is required. + + + This class does not work with grouping. + + + This class works when the OLV is sorted, but it is up to the programmer + to decide what rearranging such lists "means". Example: if the control is sorting + students by academic grade, and the user drags a "Fail" grade student up amonst the "A+" + students, it is the responsibility of the programmer to makes the appropriate changes + to the model and redraw/rebuild the control so that the users action makes sense. + + + Users of this class should listen for the CanDrop event to decide + if models from another OLV can be moved to OLV under this sink. + + + + + + Create a RearrangingDropSink + + + + + Create a RearrangingDropSink + + + + + + Trigger OnModelCanDrop + + + + + + Trigger OnModelDropped + + + + + + Do the work of processing the dropped items + + + + + + When a drop sink needs to know if something can be dropped, or + to notify that a drop has occured, it uses an instance of this class. + + + + + Create a OlvDropEventArgs + + + + + Get the original drag-drop event args + + + + + Get the data object that is being dragged + + + + + Get the drop sink that originated this event + + + + + Get or set the index of the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the drag effect that should be used for this operation + + + + + Get or set if this event was handled. No further processing will be done for a handled event. + + + + + Get or set the feedback message for this operation + + + If this is not null, it will be displayed as a feedback message + during the drag. + + + + + Get the ObjectListView that is being dropped on + + + + + Get the location of the mouse (in target ListView co-ords) + + + + + Get the drop action indicated solely by the state of the modifier keys + + + + + These events are triggered when the drag source is an ObjectListView. + + + + + Create a ModelDropEventArgs + + + + + Gets the model objects that are being dragged. + + + + + Gets the ObjectListView that is the source of the dragged objects. + + + + + Get the model object that is being dropped upon. + + This is only value for TargetLocation == Item + + + + Refresh all the objects involved in the operation + + + + + A data transfer object that knows how to transform a list of model + objects into a text and HTML representation. + + + + + Create a data object from the selected objects in the given ObjectListView + + The source of the data object + + + + Create a data object which operates on the given model objects + in the given ObjectListView + + The source of the data object + The model objects to be put into the data object + + + + Gets or sets whether hidden columns will also be included in the text + and HTML representation. If this is false, only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. + + + + + Gets the ObjectListView that is being used as the source of the data + + + + + Gets the model objects that are to be placed in the data object + + + + + Put a text and HTML representation of our model objects + into the data object. + + + + + Create an exporter for the data contained in this object + + + + + + Make a HTML representation of our model objects + + + + + Convert the fragment of HTML into the Clipboards HTML format. + + The HTML format is found here http://msdn2.microsoft.com/en-us/library/aa767917.aspx + + The HTML to put onto the clipboard. It must be valid HTML! + A string that can be put onto the clipboard and will be recognized as HTML + + + + A FastDataListView virtualizes the display of data from a DataSource. It operates on + DataSets and DataTables in the same way as a DataListView, but does so much more efficiently. + + + + A FastDataListView still has to load all its data from the DataSource. If you have SQL statement + that returns 1 million rows, all 1 million rows will still need to read from the database. + However, once the rows are loaded, the FastDataListView will only build rows as they are displayed. + + + + + + + + + + + + 获取或设置在设置DataSource时是否自动生成列以显示列。 + + 必须在设置DataSource之前设置此设置。之后就没有效果了。 + + + + 获取或设置将在此列表视图中显示的VirtualListDataSource。 + + VirtualListDataSource应实现 , , + 或 . 以下是一些常见的对象类型 + + + + + + + + 绑定到列表容器时 (即，实现 接口, 比如 ) + 您还必须实现 属性，以便标识要显示的特定列表。您也可以设置 属性， + 即使当VirtualListDataSource引用列表时也是如此, 因为 还可以用于导航列表之间的关系. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + Create the DataSourceAdapter that this control will use. + + A DataSourceAdapter configured for this list + Subclasses should override this to create their + own specialized adapters + + + + Change the Unfreeze behaviour + + + + + A FastObjectListView trades function for speed. + + + On my mid-range laptop, this view builds a list of 10,000 objects in 0.1 seconds, + as opposed to a normal ObjectListView which takes 10-15 seconds. Lists of up to 50,000 items should be + able to be handled with sub-second response times even on low end machines. + + A FastObjectListView is implemented as a virtual list with many of the virtual modes limits (e.g. no sorting) + fixed through coding. There are some functions that simply cannot be provided. Specifically, a FastObjectListView cannot: + + use Tile view + show groups on XP + + + + + + + Make a FastObjectListView + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + This method preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code and performance is O(n) where n is the number of selected rows. + This method is not thread safe. + + + + + Move the given collection of objects to the given index. + + This operation only makes sense on non-grouped ObjectListViews. + + + + + + 删除任何排序并恢复到模型对象的给定顺序 + + To be really honest, Unsort() doesn't work on FastObjectListViews since + the original ordering of model objects is lost when Sort() is called. So this method + effectively just turns off sorting. + + + + 为FastObjectListView提供数据源 + + + This class isn't intended to be used directly, but it is left as a public + class just in case someone wants to subclass it. + + + + + Create a FastObjectListDataSource + + + + + + Get n'th object + + + + + + + How many items are in the data source + + + + + + Get the index of the given model + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Remove the given collection of models from this source. + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + Apply the given filters to this data source. One or both may be null. + + + + + + + Gets the full list of objects being used for this fast list. + This list is unfiltered. + + + + + Gets the list of objects from ObjectList which survive any installed filters. + + + + + Rebuild the map that remembers which model object is displayed at which line + + + + + Build our filtered list from our full list. + + + + + Concrete implementation of the ICluster interface. + + + + + Create a cluster + + The key for the cluster + + + + Return a string representation of this cluster + + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Return an indication of the ordering between this object and the given one + + + + + + + This class provides a useful base implemention of a clustering + strategy where the clusters are grouped around the value of a given column. + + + + + This field is the text that will be shown to the user when a cluster + key is null. It is exposed so it can be localized. + + + + + This field is the text that will be shown to the user when a cluster + key is empty (i.e. a string of zero length). It is exposed so it can be localized. + + + + + Gets or sets the format that will be used by default for clusters that only + contain 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + + + + Gets or sets the format that will be used by default for clusters that + contain 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + + + + Create a clustering strategy + + + + + Gets or sets the column upon which this strategy is operating + + + + + Gets or sets the format that will be used when the cluster + contains only 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatSingular will be used + + + + Gets or sets the format that will be used when the cluster + contains 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatPlural will be used + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Create a label that combines the string representation of the cluster + key with a format string that holds an "X [N items in cluster]" type layout. + + + + + + + + This class calculates clusters from the groups that the column uses. + + + + This is the default strategy for all non-date, filterable columns. + + + This class does not strictly mimic the groups created by the given column. + In particular, if the programmer changes the default grouping technique + by listening for grouping events, this class will not mimic that behaviour. + + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + This enum is used to indicate various portions of a datetime + + + + + Year + + + + + Month + + + + + Day of the month + + + + + Hour + + + + + Minute + + + + + Second + + + + + This class implements a strategy where the model objects are clustered + according to some portion of the datetime value in the configured column. + + To create a strategy that grouped people who were born in + the same month, you would create a strategy that extracted just + the month, and formatted it to show just the month's name. Like this: + + + someColumn.ClusteringStrategy = new DateTimeClusteringStrategy(DateTimePortion.Month, "MMMM"); + + + + + Create a strategy that clusters by month/year + + + + + Create a strategy that clusters around the given parts + + + + + + + Gets or sets the format string will will be used to create a user-presentable + version of the cluster key. + + The format should use the date/time format strings, as documented + in the Windows SDK. Both standard formats and custom format will work. + "D" - long date pattern + "MMMM, yyyy" - "January, 1999" + + + + Gets or sets the parts of the DateTime that will be extracted when + determining the clustering key for an object. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Convert the given date into a user presentable string + + + + + + + Instances of this class know how to build a Filter menu. + It is responsible for clustering the values in the target column, + build a menu that shows those clusters, and then constructing + a filter that will enact the users choices. + + + Almost all of the methods in this class are declared as "virtual protected" + so that subclasses can provide alternative behaviours. + + + + + Gets or sets the string that labels the Apply button. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Clear All menu item. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Filtering menu as a whole.. + Exposed so it can be localized. + + + + + Gets or sets the string that represents Select All values. + If this is set to null or empty, no Select All option will be included. + Exposed so it can be localized. + + + + + Gets or sets the image that will be placed next to the Clear Filtering menu item + + + + + Gets or sets the image that will be placed next to all "Apply" menu items on the filtering menu + + + + + Gets or sets whether null should be considered as a valid data value. + If this is true (the default), then a cluster will null as a key will be allow. + If this is false, object that return a cluster key of null will ignored. + + + + + Gets or sets the maximum number of objects that the clustering strategy + will consider. This should be large enough to collect all unique clusters, + but small enough to finish in a reasonable time. + + The default value is 10,000. This should be perfectly + acceptable for almost all lists. + + + + Create a Filter menu on the given tool tip for the given column in the given ObjectListView. + + This is the main entry point into this class. + + + + The strip that should be shown to the user + + + + Create a collection of clusters that should be presented to the user + + + + + + + + + Order the given list of clusters in the manner in which they should be presented to the user. + + + + + + + Do the work of making a menu that shows the clusters to the users + + + + + + + + Wrap a protected section around the real HandleItemChecked method, so that if + that method tries to change a "checkedness" of an item, we don't get a recursive + stack error. Effectively, this ensure that HandleItemChecked is only called + in response to a user action. + + + + + + + Handle a user-generated ItemCheck event + + + + + + + Handle any checking/unchecking of the Select All option, and keep + its checkedness in sync with everything else that is checked. + + + + + + + + Clear all the filters that are applied to the given column + + The column from which filters are to be removed + + + + Apply the selected values from the given list as a filter on the given column + + A list in which the checked items should be used as filters + The column for which a filter should be generated + + + + Interface for model-by-model filtering + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + Interface for whole list filtering + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Base class for model-by-model filters + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + This filter calls a given Predicate to decide if a model object should be included + + + + + Create a filter based on the given predicate + + The function that will filter objects + + + + Gets or sets the predicate used to filter model objects + + + + + Should the given model object be included? + + + + + + + A CompositeFilter joins several other filters together. + If there are no filters, all model objects are included + + + + + Create an empty filter + + + + + Create a composite filter from the given list of filters + + A list of filters + + + + Gets or sets the filters used by this composite + + + + + Get the sub filters that are text match filters + + + + + Decide whether or not the given model should be included by the filter + + + True if the object is included by the filter + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must satisfy all filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must only satisfy one of the filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter from the given filters + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + Instances of this class extract a value from the model object + and compare that value to a list of fixed values. The model + object is included if the extracted value is in the list + + If there is no delegate installed or there are + no values to match, no model objects will be matched + + + + Create a filter that will use the given delegate to extract values + + + + + + Create a filter that will extract values using the given delegate + and compare them to the values in the given list. + + + + + + + Gets or sets the delegate that will be used to extract values + from model objects + + + + + Gets or sets the list of values that the value extracted from + the model object must match in order to be included. + + + + + Should the given model object be included? + + + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Instances of this class match a property of a model objects against + a list of bit flags. The property should be an xor-ed collection + of bits flags. + + Both the property compared and the list of possible values + must be convertible to ulongs. + + + + Create an instance + + + + + + + Gets or sets the collection of values that will be matched. + These must be ulongs (or convertible to ulongs). + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Base class for whole list filters + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Instance of this class implement delegate based whole list filtering + + + + + A delegate that filters on a whole list + + + + + + + Create a ListFilter + + + + + + Gets or sets the delegate that will filter the list + + + + + Do the actual work of filtering + + + + + + + Filter the list so only the last N entries are displayed + + + + + Create a no-op tail filter + + + + + Create a filter that includes on the last N model objects + + + + + + Gets or sets the number of model objects that will be + returned from the tail of the list + + + + + Return the last N subset of the model objects + + + + + + + Instances of this class cluster model objects on the basis of a + property that holds an xor-ed collection of bit flags. + + + + + Create a clustering strategy that operates on the flags of the given enum + + + + + + Create a clustering strategy around the given collections of flags and their display labels. + There must be the same number of elements in both collections. + + The list of flags. + + + + + Gets the value that will be xor-ed to test for the presence of a particular value. + + + + + Gets the labels that will be used when the corresponding Value is XOR present in the data. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + A cluster is a like collection of objects that can be usefully filtered + as whole using the filtering UI provided by the ObjectListView. + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Implementation of this interface control the selecting of cluster keys + and how those clusters will be presented to the user + + + + + Gets or sets the column upon which this strategy will operate + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + If the returned value is an IEnumerable, the given model is considered + to belong to multiple clusters + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Instances of this class include only those rows of the listview + that match one or more given strings. + + This class can match strings by prefix, regex, or simple containment. + There are factory methods for each of these matching strategies. + + + + Create a text filter that will include rows where any cell matches + any of the given regex expressions. + + + + + Any string that is not a valid regex expression will be ignored. + + + + Create a text filter that includes rows where any cell begins with one of the given strings + + + + + + + + Create a text filter that includes rows where any cell contains any of the given strings. + + + + + + + + Create a TextFilter + + + + + + Create a TextFilter that finds the given string + + + + + + + Create a TextFilter that finds the given string using the given comparison + + + + + + + + Gets or sets which columns will be used for the comparisons? If this is null, all columns will be used + + + + + Gets or sets additional columns which will be used in the comparison. These will be used + in addition to either the Columns property or to all columns taken from the control. + + + + + Gets or sets the collection of strings that will be used for + contains matching. Setting this replaces all previous texts + of any kind. + + + + + Gets whether or not this filter has any search criteria + + + + + Gets or set the ObjectListView upon which this filter will work + + + You cannot really rebase a filter after it is created, so do not change this value. + It is included so that it can be set in an object initializer. + + + + + Gets or sets the collection of strings that will be used for + prefix matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + This is only used when doing Regex matching (obviously). + If this is not set specifically, the appropriate options are chosen to match the + StringComparison setting (culture invariant, case sensitive). + + + + + Gets or sets the collection of strings that will be used for + regex pattern matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets how the filter will match text + + + + + Loop over the columns that are being considering by the filter + + + + + + Do the actual work of filtering + + + + + + + Find all the ways in which this filter matches the given string. + + This is used by the renderer to decide which bits of + the string should be highlighted + + A list of character ranges indicating the matched substrings + + + + Is the given column one of the columns being used by this filter? + + + + + + + Base class for the various types of string matching that TextMatchFilter provides + + + + + Gets how the filter will match text + + + + + Gets the text filter to which this component belongs + + + + + Gets or sets the text that will be matched + + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + This component provides text contains matching strategy. + + + + + Create a text contains strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides text begins with matching strategy. + + + + + Create a text begins strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides regex matching strategy. + + + + + Creates a regex strategy + + + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + + + Gets or sets a compilex regular expression, based on our current Text and RegexOptions. + + + If Text fails to compile as a regular expression, this will return a Regex object + that will match all strings. + + + + + Gets whether or not our current regular expression is a valid regex + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This attribute is used to mark a property of a model + class that should be noticed by Generator class. + + + All the attributes of this class match their equivilent properties on OLVColumn. + + + + + Create a new OLVColumnAttribute + + + + + Create a new OLVColumnAttribute with the given title + + The title of the column + + + + + + + + + + + + + + + + + + + + + + + + + + + + + An array of IComparables that mark the cutoff points for values when + grouping on this column. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Properties marked with [OLVChildren] will be used as the children source in a TreeListView. + + + + + Properties marked with [OLVIgnore] will not have columns generated for them. + + + + + ColumnComparer is the workhorse for all comparison between two values of a particular column. + If the column has a specific comparer, use that to compare the values. Otherwise, do + a case insensitive string compare of the string representations of the values. + + This class inherits from both IComparer and its generic counterpart + so that it can be used on untyped and typed collections. + This is used by normal (non-virtual) ObjectListViews. Virtual lists use + ModelObjectComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column + + The column whose values will be compared + The ordering for column values + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column, and by a secondary column if the primary + column is equal. + + The column whose values will be compared + The ordering for column values + The column whose values will be compared for secondary sorting + The ordering for secondary column values + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare the actual values to be used for sorting + + The aspect extracted from the first row + The aspect extracted from the second row + An ordering indication: -1, 0, 1 + + + + This comparer sort list view groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + + + + Create a group comparer + + The ordering for column values + + + + Compare the two groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + group1 + group2 + An ordering indication: -1, 0, 1 + + + + This comparer can be used to sort a collection of model objects by a given column + + + This is used by virtual ObjectListViews. Non-virtual lists use + ColumnComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a model object comparer + + + + + + + Create a model object comparer with a secondary sorting column + + + + + + + + + Compare the two model objects + + + + + + + + Compare the actual values + + + + + + + + A helper class that translates DataSource events for an ObjectListView + + + + + Make a DataSourceAdapter + + + + + Finalize this object + + + + + Release all the resources used by this instance + + + + + Release all the resources used by this instance + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets the ObjectListView upon which this adaptor will operate + + + + + Gets or sets the currency manager which is handling our binding context + + + + + + + + + + + + + + + + + + + + + + + + + + + Our data source has changed. Figure out how to handle the new source + + + + + Our data source has changed. Figure out how to handle the new source + + + + + The data source for this control has changed. Reconfigure the control for the new source + + + + + Take the contents of the currently bound list and put them into the control + + + + + Create columns for the listview based on what properties are available in the data source + + + This method will create columns if there is not already a column displaying that property. + + + + + Decide if a new column should be added to the control to display + the given property + + + + + + + Configure the given column to show the given property. + The title and aspect name of the column are already filled in. + + + + + + + Generate aspect getters and putters for any columns that are missing them (and for which we have + enough information to actually generate a getter) + + + + + CurrencyManager ListChanged event handler. + Deals with fine-grained changes to list items. + + + It's actually difficult to deal with these changes in a fine-grained manner. + If our listview is grouped, then any change may make a new group appear or + an old group disappear. It is rarely enough to simply update the affected row. + + + + + + + Handle PropertyDescriptor* events + + + + + + Handle ItemMoved event + + + + + + Handle the ItemDeleted event + + + + + + Handle an ItemAdded event. + + + + + + Handle the Reset event + + + + + + Handle ItemChanged event. This is triggered when a single item + has changed, so just refresh that one item. + + + Even in this simple case, we should probably rebuild the list. + For example, the change could put the item into its own new group. + + + + The CurrencyManager calls this if the data source looks + different. We just reload everything. + + + + + CHECK: Do we need this if we are handle ListChanged metadata events? + + + + + Called by the CurrencyManager when the currently selected item + changes. We update the ListView selection so that we stay in sync + with any other controls bound to the same source. + + + + + + + Change the control's position (which is it's currently selected row) + to the nth row in the dataset + + The index of the row to be selected + + + + Handle the selection changing in our ListView. + We need to tell our currency manager about the new position. + + + + + + + Handle the frozenness of our ListView changing. + + + + + + + Handle a change to the BindingContext of our ListView. + + + + + + + These delegates are used to extract an aspect from a row object + + + + + These delegates are used to put a changed value back into a model object + + + + + These delegates can be used to convert an aspect value to a display string, + instead of using the default ToString() + + + + + These delegates are used to get the tooltip for a cell + + + + + These delegates are used to the state of the checkbox for a row object. + + + For reasons known only to someone in Microsoft, we can only set + a boolean on the ListViewItem to indicate it's "checked-ness", but when + we receive update events, we have to use a tristate CheckState. So we can + be told about an indeterminate state, but we can't set it ourselves. + + As of version 2.0, we can now return indeterminate state. + + + + + These delegates are used to get the state of the checkbox for a row object. + + + + + + + These delegates are used to put a changed check state back into a model object + + + + + These delegates are used to put a changed check state back into a model object + + + + + + + + These delegates are used to get the renderer for a particular cell + + + + + The callbacks for RightColumnClick events + + + + + This delegate will be used to own draw header column. + + + + + This delegate is called when a group has been created but not yet made + into a real ListViewGroup. The user can take this opportunity to fill + in lots of other details about the group. + + + + + These delegates are used to retrieve the object that is the key of the group to which the given row belongs. + + + + + These delegates are used to convert a group key into a title for the group + + + + + These delegates are used to get the tooltip for a column header + + + + + These delegates are used to fetch the image selector that should be used + to choose an image for this column. + + + + + These delegates are used to draw a cell + + + + + These delegates are used to fetch a row object for virtual lists + + + + + These delegates are used to format a listviewitem before it is added to the control. + + + + + These delegates can be used to return the array of texts that should be searched for text filtering + + + + + These delegates are used to sort the listview in some custom fashion + + + + + These delegates are used to order two strings. + x cannot be null. y can be null. + + + + + An ObjectListView is a much easier to use, and much more powerful, version of the ListView. + + + + An ObjectListView automatically populates a ListView control with information taken + from a given collection of objects. It can do this because each column is configured + to know which bit of the model object (the "aspect") it should be displaying. Columns similarly + understand how to sort the list based on their aspect, and how to construct groups + using their aspect. + + + Aspects are extracted by giving the name of a method to be called or a + property to be fetched. These names can be simple names or they can be dotted + to chain property access e.g. "Owner.Address.Postcode". + Aspects can also be extracted by installing a delegate. + + + An ObjectListView can show a "this list is empty" message when there is nothing to show in the list, + so that the user knows the control is supposed to be empty. + + + Right clicking on a column header should present a menu which can contain: + commands (sort, group, ungroup); filtering; and column selection. Whether these + parts of the menu appear is controlled by ShowCommandMenuOnRightClick, + ShowFilterMenuOnRightClick and SelectColumnsOnRightClick respectively. + + + The groups created by an ObjectListView can be configured to include other formatting + information, including a group icon, subtitle and task button. Using some undocumented + interfaces, these groups can even on virtual lists. + + + ObjectListView supports dragging rows to other places, including other application. + Special support is provide for drops from other ObjectListViews in the same application. + In many cases, an ObjectListView becomes a full drag source by setting to + true. Similarly, to accept drops, it is usually enough to set to true, + and then handle the and events (or the and + events, if you only want to handle drops from other ObjectListViews in your application). + + + For these classes to build correctly, the project must have references to these assemblies: + + + System + System.Data + System.Design + System.Drawing + System.Windows.Forms (obviously) + + + + + + How does a user indicate that they want to edit cells? + + + + + 列表将不支持编辑(同时F2按键无效) + + + + + 单击 单元格 将编辑值. + 选择该行，就像正常选择行一样。用户必须按F2键才能编辑主列。 + + + + + 双击子项或主列将编辑该单元格。 + F2键将编辑主列。 + + + + + 按F2键是编辑单元格的唯一方法。一旦主列被编辑， + 行中的其他单元格可以通过按Tab键进行编辑。 + + + + + 只需单击任意单元格即可编辑值，即使是主列也是如此。 + + + + + 这些值指定向用户显示列选择的方式 + + + + + 不会显示任何列选择 + + + + + 这些列将显示在主菜单中 + + + + + 这些列将显示在子菜单中 + + + + + 将显示一个模式对话框，允许用户选择列 + + + + + Triggered after a ObjectListView has been searched by the user typing into the list + + + + + Triggered after a ObjectListView has been sorted + + + + + Triggered before a ObjectListView is searched by the user typing into the list + + + Set Cancelled to true to prevent the searching from taking place. + Changing StringToFind or StartSearchFrom will change the subsequent search. + + + + + Triggered before a ObjectListView is sorted + + + Set Cancelled to true to prevent the sort from taking place. + Changing ColumnToSort or SortOrder will change the subsequent sort. + + + + + Triggered after a ObjectListView has created groups + + + + + Triggered before a ObjectListView begins to create groups + + + Set Groups to prevent the default group creation process + + + + + Triggered just before a ObjectListView creates groups + + + You can make changes to the groups, which have been created, before those + groups are created within the listview. + + + + + Triggered when a button in a cell is left clicked. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when a cell has finished being edited. + + + + + Triggered when a cell is about to finish being edited. + + If Cancel is already true, the user is cancelling the edit operation. + Set Cancel to true to prevent the value from the cell being written into the model. + You cannot prevent the editing from finishing within this event -- you need + the CellEditValidating event for that. + + + + Triggered when a cell is about to be edited. + + Set Cancel to true to prevent the cell being edited. + You can change the the Control to be something completely different. + + + + Triggered when a cell editor needs to be validated + + + If this event is cancelled, focus will remain on the cell editor. + + + + + Triggered when a cell is left clicked. + + + + + Triggered when the mouse is above a cell. + + + + + Triggered when a cell is right clicked. + + + + + This event is triggered when a cell needs a tool tip. + + + + + This event is triggered when a checkbox is checked/unchecked on a subitem + + + + + Triggered when a column header is right clicked. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + + + This event is triggered when the control needs to filter its collection of objects. + + + + + This event is triggered when a cell needs to be formatted. + + + + + This event is triggered when the frozeness of the control changes. + + + + + This event is triggered when a row needs to be formatted. + + + + + This event is triggered when a group is about to collapse or expand. + This can be cancelled to prevent the expansion. + + + + + This event is triggered when a group changes state. + + + + + This event is triggered when a header checkbox is changing value + + + + + This event is triggered when a header needs a tool tip. + + + + + Triggered when the "hot" item changes + + + + + Triggered when a hyperlink cell is clicked. + + + + + Triggered when the task text of a group is clicked. + + + + + Is the value in the given cell a hyperlink. + + + + + Some new objects are about to be added to an ObjectListView. + + + + + The contents of the ObjectListView has changed. + + + + + The contents of the ObjectListView is about to change via a SetObjects call + + + Set Cancelled to true to prevent the contents of the list changing. This does not work with virtual lists. + + + + + Some objects are about to be removed from an ObjectListView. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler, and when the source control + for the drag was an ObjectListView. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler and when the source control + for the drag was an ObjectListView. + + + + + This event is triggered once per user action that changes the selection state + of one or more rows. + + + + + This event is triggered when the contents of the ObjectListView has scrolled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Tell the world when a cell is about to be edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell has finished being edited. + + + + + 创建一个 ObjectListView + + + + + Dispose of any resources this instance has been using + + + + + + 获取鼠标左键是否在此时按下。 + + + + + 获取该程序是否在Vista或更高版本上运行 + + + + + 获取该程序是否在Win7或更高版本上运行 + + + + + Gets or sets how what smoothing mode will be applied to graphic operations. + + + + + Gets or sets how should text be renderered. + + + + + 获取或设置当组Key为Null时将用于标题组的字符串。将其公开以使其可以本地化。 + + + + + Convert the given enumerable into an ArrayList as efficiently as possible + + The source collection + If true, this method will always create a new + collection. + An ArrayList with the same contents as the given collection. + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Return the count of items in the given enumerable + + + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + Return whether or not the given enumerable is empty. A string is regarded as + an empty collection. + + + True if the given collection is null or empty + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Gets or sets whether all ObjectListViews will silently ignore missing aspect errors. + + + + By default, if an ObjectListView is asked to display an aspect + (i.e. a field/property/method) + that does not exist from a model, it displays an error message in that cell, since that + condition is normally a programming error. There are some use cases where + this is not an error -- in those cases, set this to true and ObjectListView will + simply display an empty cell. + + Be warned: if you set this to true, it can be very difficult to track down + typing mistakes or name changes in AspectNames. + + + + + Gets or sets whether the control will draw a rectangle in each cell showing the cell padding. + + + + This can help with debugging display problems from cell padding. + + As with all cell padding, this setting only takes effect when the control is owner drawn. + + + + + Gets the style that will be used by default to format disabled rows + + + + + Gets the style that will be used by default to format hot rows + + + + + Gets or sets an model filter that is combined with any column filtering that the end-user specifies. + + This is different from the ModelFilter property, since setting that will replace + any column filtering, whereas setting this will combine this filter with the column filtering + + + + Get or set all the columns that this control knows about. + Only those columns where IsVisible is true will be seen by the user. + + + + If you want to add new columns programmatically, add them to + AllColumns and then call RebuildColumns(). Normally, you do not have to + deal with this property directly. Just use the IDE. + + If you do add or remove columns from the AllColumns collection, + you have to call RebuildColumns() to make those changes take effect. + + + + + 获取或设置每隔一行的背景色 + + + + + 获取已设置的交替行背景色或默认颜色 + + + + + 此属性强制ObjectListView始终按给定列对项进行分组。 + + + + + 如果AlwaysGroupByColumn不为空，则此属性将用于确定如何对这些组进行排序。 + 如果此属性的值为SortOrder.None，则排序顺序将根据用户上次单击的标题切换。 + + + + + Give access to the image list that is actually being used by the control + + + Normally, it is preferable to use SmallImageList. Only use this property + if you know exactly what you are doing. + + + + + 获取或设置编辑单元格的方式 + + Columns can also be marked as editable. + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + 默认值为 true. + + + This is always treated as true when the control is NOT owner drawn. + + When this is false and the control is owner drawn, + ObjectListView will try to calculate the width of the cell's + actual contents, and then size the editing control to be just the right width. If this is true, + the whole width of the cell will be used, regardless of the cell's contents. + + Each column can have a different value for property. This value from the control is only + used when a column is not specified one way or another. + Regardless of this setting, developers can specify the exact size of the editing control + by listening for the CellEditStarting event. + + + + + Gets or sets the engine that will handle key presses during a cell edit operation. + Settings this to null will reset it to default value. + + + + + 获取当前用于编辑单元格的控件。 + + This will obviously be null if no cell is being edited. + + + + 获取或设置编辑控件左边缘或右边缘的单元格时Tab键的行为。 + 如果为False(默认值)，则按Tab键将换行到同一行的另一侧。 + 如果为True，编辑最右边的单元格时按Tab键将前进到下一行， + 编辑最左边的单元格时按Shift-Tab组合键将更改为上一行。 + + + + + 获取或设置编辑单元格时Enter键的行为。 + 如果为False(默认值)，则按Enter键将简单地完成编辑操作。 + 如果为True，则Enter将完成编辑操作，并在当前单元格下方的单元格上启动新的编辑操作，在位于底部单元格时换行到下一行的顶部。 + + + + + 获取显示单元格提示的工具提示控件 + + + + + 获取或设置该项的每个单元格周围将留空的像素数。单元格内容在考虑填充后对齐。 + + + Each value of the given rectangle will be treated as an inset from + the corresponding side. The width of the rectangle is the padding for the + right cell edge. The height of the rectangle is the padding for the bottom + cell edge. + + + So, this.olv1.CellPadding = new Rectangle(1, 2, 3, 4); will leave one pixel + of space to the left of the cell, 2 pixels at the top, 3 pixels of space + on the right edge, and 4 pixels of space at the bottom of each cell. + + + This setting only takes effect when the control is owner drawn. + + This setting only affects the contents of the cell. The background is + not affected. + If you set this to a foolish value, your control will appear to be empty. + + + + + 获取或设置默认情况下单元格垂直对齐的方式。 + + This setting only takes effect when the control is owner drawn. It will only be noticable + when RowHeight has been set such that there is some vertical space in each row. + + + + Should this list show checkboxes? + + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + .NET's CheckedItems property is not helpful. It is just a short-hand for + iterating through the list looking for items that are checked. + + + The performance of the get method is O(n), where n is the number of items + in the control. The performance of the set method is + O(n + m) where m is the number of objects being checked. Be careful on long lists. + + + + + + 获取或设置可枚举对象中的选中对象。 + + + Useful for checking all objects in the list. + + + this.olv1.CheckedObjectsEnumerable = this.olv1.Objects; + + + + + Gets Columns for this list. We hide the original so we can associate + a specialised editor with it. + + + + + 获取/设置当列表切换到TileView(平铺视图)时应使用的列的列表。 + + + + + 按向用户显示的顺序返回可见列 + + + + + 获取显示列表的控件区域，减去任何标题控件 + + + + + 获取或设置当用户按Ctrl+C组合键时是否应将选定行复制到剪贴板 + + + + + 获取或设置按Ctrl+C键复制到剪贴板功能是否应使用安装的DragSource创建放置到剪贴板上的数据对象。 + + This is normally what is desired, unless a custom DragSource is installed + that does some very specialized drag-drop behaviour. + + + + Gets the list of decorations that will be drawn the ListView + + + + Do not modify the contents of this list directly. Use the AddDecoration() and RemoveDecoration() methods. + + + A decoration scrolls with the list contents. An overlay is fixed in place. + + + + + + 所有者绘制时，此渲染器将绘制未指定特定渲染器的列 + + 如果尝试将其设置为NULL，则它将恢复为HighlightTextRenende + + + + 获取用于绘制给定单元格的渲染器。 + + The row model for the row + The column to be drawn + The renderer used for drawing a cell. Must not return null. + + + + 获取或设置将应用于禁用项的样式。 + + If this is not set explicitly, will be used. + + + + 获取或设置已禁用的模型对象的列表。无法选择或激活已禁用的对象。 + + + + + 判断此给定模型对象是否已禁用 + + + + + + + 禁用给定的模型对象。禁用的对象无法选择或激活。 + + Must not be null + + + + 禁用所有给定的模型对象 + + + + + + 启用给定的模型对象，以便可以再次选择并激活它。 + + Must not be null + + + + 启用所有给定的模型对象 + + + + + + 忽略所有禁用的对象。这不会触发重绘或重建 + + + + + Gets or sets the object that controls how drags start from this control + + + + + Gets or sets the object that controls how drops are accepted and processed + by this ListView. + + + + If the given sink is an instance of SimpleDropSink, then events from the drop sink + will be automatically forwarded to the ObjectListView (which means that handlers + for those event can be configured within the IDE). + + If this is set to null, the control will not accept drops. + + + + + This registry decides what control should be used to edit what cells, based + on the type of the value in the cell. + + + All instances of ObjectListView share the same editor registry. + + + + 获取或设置在此列表视图中没有项时应显示的文本。 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 获取或设置绘制列表空消息时应使用的字体 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 返回“列表为空”消息的字体或合理的默认值 + + + + + Gets or sets the overlay responsible for drawing the List Empty msg. + + + + + 获取在筛选中幸存下来的对象的集合。 + + + + This collection is the result of filtering the current list of objects. + It is not a snapshot of the filtered list that was last used to build the control. + + + Normal warnings apply when using this with virtual lists. It will work, but it + may take a while. + + + + + + 获取或设置将用于生成筛选器菜单的策略对象 + + 如果为NULL，则不会生成筛选器菜单。 + + + + 获取或设置具有键盘焦点的行 + + + + Setting an object to be focused does *not* select it. If you want to select and focus a row, + use . + + + This property is not generally used and is only useful in specialized situations. + + + + + + 隐藏Groups集合，使其在“属性”网格中不可见。 + + + + + 获取或设置分组使用的ImageList + + 如果未设置此选项，则分组标题将不会显示任何图像。 + + + + 获取在组为空或包含多个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 + + + "[{0} [{1} 项]" + + + + 返回this.GroupWithItemCountFormat或合理的默认值 + + + + + 获取在组仅包含单个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 (总是1) + + + "[{0} [{1} 项]" + + + + 获取GroupWithItemCountSingularFormat或合理的默认值 + + + + + 获取或设置此ObjectListView中的组是否应可折叠。 + + + 此特性只支持Vista或之后的系统. + + + + + 获取当前列表是否存在当列表为空时显示的文本 + + + + + 获取是否有要绘制的叠加层 + + + + + 获取ListView的列头控件 + + + + + 获取或设置列标题文本的绘制字体 + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + 获取或设置将用于绘制列表视图的列标题的样式 + + + + 仅当HeaderUsesThemes为false时才使用此选项。 + + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + + + 获取或设置标题的最大高度。-1表示没有最大值。 + + + + + 获取或设置标题的最小高度。-1表示没有最小值。 + + + + + 获取或设置是否严格按照操作系统的主题绘制标题。 + + + + 如果设置为true，则列头将完全由系统呈现，不需要ObjectListViews的任何特殊处理。 + 页眉中将没有图像、没有过滤器指示符、没有文字换行、没有页眉样式、没有复选框。 + + 如果将其设置为False，ObjectListView将以其认为最好的方式呈现标题。 + 如果不需要特殊功能，则ObjectListView会将渲染委托给操作系统。 + 否则，ObjectListView将根据配置设置绘制标题。 + + + 没有主题的效果会因操作系统不同而不同。至少，分类指示器不会是标准的。 + + + + + + 获取或设置列头标题中的文本是否自动换行。 + + + 将在单词之间应用换行符。过长的单词仍将被省略。 + + 与所有使列头看起来不同的设置一样，HeaderUsesThemes必须设置为false，否则操作系统将负责绘制列头，并且不允许自动换行文本。 + + + + + + 获取显示列标题提示的工具提示 + + + + + 获取鼠标当前所在行的索引。 + + + + + 获取鼠标当前所在列的索引 + + + + + 获取鼠标当前所在的项/子项的一部分 + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + 获取鼠标所在的组。 + + + + + 处于“热”状态的项的索引，即在光标下方。-1表示没有项目。 + + + + + 获取和设置对游标下的行应用哪种格式 + + + + 这仅在UseHotItem为true时生效。 + + 如果样式具有叠加层，则必须对其进行设置。*之前* 将其分配给此属性。之后添加它将被忽略。 + + + + + 获取已安装的热点项样式或合理的默认值。 + + + + + 获取和设置应将哪种格式应用于超链接 + + + + + 获取和设置所选行的背景应该使用什么颜色 + + + + + 返回应用于选定行的背景颜色或合理的默认值 + + + + + 获取和设置所选行的字体应该使用什么颜色 + + + + + 返回应用于选定行的字体颜色或合理的默认值 + + + + + 使用 SelectedBackColor 代替 + + + + + 使用 SelectedBackColorOrDefault 代替 + + + + + 使用 SelectedForeColor 代替 + + + + + 使用 SelectedForeColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedBackColor 代替 + + + + + 使用 UnfocusedSelectedBackColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedForeColor 代替 + + + + + 使用 UnfocusedSelectedForeColorOrDefault 代替 + + + + + 获取或设置是否应将隐藏列包括在复制或拖动到其他应用程序的行的文本表示形式中。 + 如果为False(默认值)，则仅包括可见列。 + + + + + 获取或设置复制行时，列标题是否在文本中。 + 如果为False(默认值)，在文本中将不会显示列标题。 + + + + + 如果当前正在进行单元格编辑操作，则返回TRUE + + + + + 如果在开发环境中使用ObjectListView，则返回true。 + + + + + 获取当前列表是否正在筛选其内容 + + + + + 当用户在列表中键入内容时，是否应该搜索当前排序列中的值以查找匹配项？ + 如果为False，则无论排序列是什么，都将始终使用主列。 + + When this is true, the behavior is like that of ITunes. + + + + 获取或设置此控件是否将使用SimpleDropSink接收拖动 + + + + 此设置将替换任何以前的DropSink。 + + + 将其设置为true后，SimpleDropSink仍需要配置为说明它何时可以接受拖动， + 以及在拖动某些内容时应该执行什么操作。需要执行这些操作使此属性几乎毫无用处 :( + + + + + + 获取或设置此控件是否将使用SimpleDragSource来启动拖动 + + 此设置将替换之前的任何DragSource + + + + 隐藏Items集合，使其在“属性”网格中不可见。 + + + + + 当列表中的项目处于非详细视图中时，此渲染器会绘制项目。在详细信息视图中，负责个体列的呈现器。 + + + + + 获取或设置最后一次排序的列 + + 这是PrimarySortColumn的别名 + + + + 获取或设置最后一次排序的方向 + + 这是 PrimarySortOrder的别名 + + + + 获取或设置应用于整个对象列表的筛选器。 + + + 列表将立即更新以反映此筛选器。 + + + + + 获取或设置应用于列表中每个模型对象的筛选器 + + + 您可能需要考虑使用 而不是此属性， + 因为AdditionalFilter在运行时与列筛选相结合。 + 设置此属性只是替换用户可能已给出的任何列筛选器。 + + The list is updated immediately to reflect this filter. + + + + + + Gets the hit test info last time the mouse was moved. + + Useful for hot item processing. + + + + 获取或设置列表显示的组列表。 + + + 此属性与.NET Groups属性的工作方式不同，应将其视为只读属性。 + 对列表所做的更改不会反映在ListView本身中。 + 在此列表中添加或删除组是没有意义的，这样的修改不会起到任何作用。 + 要执行此类操作，必须侦听BeforeCreatingGroups或AboutToCreateGroups事件， + 并更改这些事件中的组列表。 + + + + + 获取或设置折叠的OLVGroups的集合。 + + + + + Gets or sets whether the user wants to owner draw the header control + themselves. If this is false (the default), ObjectListView will use + custom drawing to render the header, if needed. + + + If you listen for the DrawColumnHeader event, you need to set this to true, + otherwise your event handler will not be called. + + + + + 获取/设置此列表将显示的对象集合 + + + + 设置此属性后，控件的内容将立即更新。 + + 如果可能，此方法将保留所选内容。使用 if + 如果您不想保留所选内容，请执行以下操作。 + 保留选择是该代码中最慢的部分，性能为O(N)，其中n是选定的行数。 + 此方法不是线程安全的。 + 该属性确实适用于虚拟列表：设置是没有问题的，但如果您尝试获取它， + 并且列表有1000万个对象，则可能需要一些时间才能返回。 + 此集合未经过筛选。使用 只访问那些在任何已安装的筛选器中幸存下来的对象。 + + + + + 获取当前控件所有对象组成的列表 + + + + + 获取创建群集时将考虑的对象集合。 + (用于生成类似Excel的列筛选器) + + + + + 获取或设置将在ListView顶部绘制的图像 + + + + + 获取或设置将在ListView顶部绘制的文本 + + + + + 获取或设置所有覆盖图的透明度。0表示完全透明，255表示完全不透明。 + + + 这已经过时了，请在每个覆盖上使用Transparency。 + + + + + 获取将在ListView顶部绘制的覆盖列表 + + + You can add new overlays and remove overlays that you have added, but + don't mess with the overlays that you didn't create. + + + + + Gets or sets whether the ObjectListView will be owner drawn. Defaults to true. + + + + When this is true, all of ObjectListView's neat features are available. + + We have to reimplement this property, even though we just call the base + property, in order to change the [DefaultValue] to true. + + + + + + 获取或设置主复选框是否在列表重新生成和筛选操作中保持其值。 + + + + 此属性仅在未显式设置CheckStateGetter/Putter时才有用。 + 如果您使用CheckStateGetter/Putter，那么这些方法已经持久化了行的检查性。 + + 此默认值为true。如果为False，则在重新生成或筛选列表时，复选框将丢失其值。 + 如果在虚拟列表中将其设置为false，则必须安装CheckStateGetter/Putters。 + + + + + 获取或设置记住模型对象的复选框状态的字典 + + 当PersistentCheckBoxs值为TRUE时，此选项用于虚拟列表. + + + + 获取或设置最后一次排序的列 + + + + + 获取或设置最后一次排序的方向 + + + + + 获取或设置不可编辑复选框是否绘制为禁用。默认是false。 + + + 这仅在所有者描述模式(owner drawn mode)下有效。 + + + + + 以像素为单位指定控件中每行的高度。 + + 列表视图中的行高通常由字体大小和小图像列表大小决定。 + 此设置允许覆盖该计算(原因是：您仍然不能将行高设置为小于控件中使用的字体的行高)。 + 将其设置为-1表示使用正常计算方法。 + 此功能是体验功能！如果您使用此功能，您的程序可能会发生意想不到的事情。 + + + + + 获取每行有多少像素高 + + + + + 获取此控件的每页上显示多少行 + + + + + 获取/设置将用于解析排序时相等的比较的列(第二排序列)。 + + 此设置没有用户界面。它必须以编程方式设置。 + + + + 获取或设置当使用Second darySortColumn时，它将以什么顺序比较结果 + + + + + 获取或设置当用户按Ctrl+A组合键时是否应选择所有行 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许用户选择视图中将显示哪些列 + + 这只是SelectColumnsOnRightClickBehaviour的兼容性包装属性. + + + + 获取或设置当右键单击标题时用户如何能够选择列 + + + + + 当列选择菜单打开时，是否应在选择项目后保持打开状态？保持打开状态允许用户一次打开或关闭多个列。 + + SelectColumnsOnRightClickBehaviour设置为InlineMenu时才有效。当行为设置为SubMenu菜单时，该选项不起作用。 + + + + 获取或设置选定列 + + + + 如果TintSortColumn为true，则排序列将自动成为选定列。 + + + 色调的颜色由SelectedColumnTint控制。 + + + + + + Gets or sets the decoration that will be drawn on all selected rows + + + + + 获取或设置应该使用什么颜色来给选定的列着色 + + + 色调颜色必须是Alpha可混合的，因此如果给定的颜色是纯色(即Alpha=255)，则会将其更改为具有合理的Alpha值。 + + + + + 获取或设置当前选定行的索引。 + 获取索引时，如果没有选择任何行，或者选择了多个行，则返回-1。 + + + + + 获取或设置当前选定的ListViewItem。如果未选择任何行，或者选择了多个行，则返回NULL。 + + + + + 如果只选择了一行，则从当前选定的行获取模型对象。 + 如果未选择任何行，或选择了多个行，则返回NULL。 + 设置时，这将选择显示给定模型对象的行，并将焦点放在该行上，取消选择所有其他行。 + + + + + 从当前选定的行中获取模型对象。 + 如果未选中任何行，则返回的列表为空。 + 设置此值时，请选择显示给定模型对象的行，取消选择所有其他行。 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许他们选择要在列表视图上执行的常见任务 + + + + + 获取或设置当右键单击标题控件时，此ObjectListView是否像筛选菜单一样显示表格 + + + + + 获取或设置是否应按组显示其项目 + + + + + 列表视图是否应该在列标题中显示位图以显示排序方向 + + + The only reason for not wanting to have sort indicators is that, on pre-XP versions of + Windows, having sort indicators required the ListView to have a small image list, and + as soon as you give a ListView a SmallImageList, the text of column 0 is bumped 16 + pixels to the right, even if you never used an image. + + + + + 列表视图是否应该显示子项上的图像 + + + 虚拟列表必须是所有者绘制的，才能在子项上显示图像 + + + + + 此属性控制分组标签是否显示该分组项目数量 + + + 后缀的格式由GroupWithItemCountFormat/GroupWithItemCountSingularFormat属性控制 + + + + + 获取或设置控件是在所有视图中显示列标题(True)，还是仅在详细信息视图中显示列标题(False) + + + + 此属性工作不正常。JPP 2010/04/06。 + 如果它是在创建控件之前设置的，则可以正常工作。 + 但是，如果在创建控件后将其关闭，则控件将丢失其复选框(奇怪！) + + + 要在创建控件后更改此设置，事情会很复杂。 + 如果它是关闭的，而我们想要打开它，我们必须更改视图，标题就会出现。 + 如果它当前处于打开状态，而我们想要将其关闭，则必须更改视图并重新创建控制柄。 + 重新创建句柄是一个问题，因为它会使我们的复选框样式消失。 + + + 该属性不能工作在 Win XP 系统. + + + + + 重写SmallImageList属性，以便我们可以正确地隐藏其操作。 + + 如果使用RowHeight属性指定行高，则必须在设置/更改RowHeight之前完全初始化SmallImageList。 + 如果在设置行高之后将新图像添加到图像列表，则必须再次将图像列表分配给控件。像这样简单的事情会奏效的： + listView1.SmallImageList = listView1.SmallImageList; + + + + + 返回小图像列表中图像的大小或合理的默认值 + + + + + 当列表视图分组时，项是否应该按主列排序？如果为False，则项目将按分组时的同一列进行排序。 + + + + + 当列表视图分组时，一个组的末尾和下一个组的开头之间应该有多少像素 + + + + + 排序列是否应该显示轻微的色调？ + + + + + 获取或设置是否使用三态复选框？ + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + 否则，用户在选中和取消选中之间交替单击。 + 当此设置为False时，CheckStateGetter仍可以返回不确定。 + + + + + 获取或设置列表顶部项目的索引 + + + + 此属性仅在列表视图处于详细信息视图中且不显示组时才起作用。 + + + 显示组时不起作用的原因是，当启用组时，无论滚动位置如何， + Windows msg LVM_GETTOPINDEX总是返回0。 + + + + + + 获取或设置将鼠标移到标题上是否会触发CellOver事件。 + 默认为true。 + + + 将鼠标移动到标题上之前不会触发CellOver事件，因为Header被视为单独的控件。 + 如果此行为更改导致您的应用程序出现问题，请将其设置为False。 + 如果您想知道鼠标何时在标题上移动，请将此属性设置为true(默认值)。 + + + + + 通过拖动分隔线调整列的大小时，是否应在每次鼠标移动时调整填充空格的列的大小？ + 如果为False，则释放鼠标时将更新填充栏。 + + + + 如果空间填充列位于正在调整大小的列的左侧，这看起来会很奇怪：该列的右边缘将被拖动，但由于空间填充列正在收缩，其左边缘将会移动。 + + 这是合乎逻辑的行为--只是看起来不对。 + + + 考虑到上述行为，如果空间填充列不是最右边的列，最好关闭该属性。 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的背景 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的背景的颜色 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的字体颜色。 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的字体颜色 + + + + + 获取或设置列表是否每隔一行提供不同的背景色？默认值为false。 + + 交替行的颜色由AlternateRowBackColor提供。 + 在.NET中，列表视图在非整行选择模式下有一个“功能”，在这种模式下，所选行不会使用正确的背景色绘制。 + + + + 是否应该为控件中的每个单元格调用FormatCell事件？ + + + 在许多情况下，不执行单元格级格式设置。 + 如果除非需要，ObjectListView不会为每个单元格触发Format Cell事件，则它的运行速度会稍快一些。 + 因此，默认情况下，它不会为每个单元格引发事件。 + + ObjectListView*确实*在每次重新生成行时引发FormatRow事件。各行可以决定是否对行中的每个单元格引发FormatCell事件。 + + + 无论此设置如何，只有当ObjectListView处于详细视图中时才会引发FormatCell事件。 + + + + + 所选行是否应使用非标准前景色和背景色绘制？ + + V2.9不再需要此属性 + + + + 获取或设置此ObjectListView是否将使用与Vista资源管理器相同的热项和选择机制。 + + + + 此属性有许多缺陷： + + 这仅适用于Vista及更高版本 + 它不能很好地与AlternateRowBackColors配合使用。 + 它不能很好地与HotItemStyles配合使用。 + 如果FullRowSelect为false，这看起来有点傻。 + 当列表是所有者绘制的时，它根本不起作用(因为所有的绘制都是由渲染器完成的)。 + 因此，它不能与TreeListView一起工作，因为它们“必须”是所有者绘制的。你仍然可以设置它，但它不会生效。 + + 但如果你一定要看起来像Vista/Win7，这是你的权限。如果这项设置搞砸了其他事情，请不要抱怨。 + + + 当此属性设置为True时，ObjectListView将不是所有者描述的。 + 这将禁用ObjectListView的许多漂亮的基于绘图的功能。 + + + + + + 获取或设置列表是否应启用筛选 + + + + + 获取或设置列表是否应将指示符放入列的标题中，以表明它正在筛选该列 + + 如果将其设置为true，HeaderUsesThemes将自动设置为false，因为我们只能在不使用主题标题时绘制筛选器指示器。 + + + + 鼠标下方的控件(复选框或按钮)是否应该被绘制为“Hot” + + + 如果为False，则当鼠标悬停在控件上时，控件的绘制方式不会有所不同。 + + 如果为False，且UseHotItem和UseHyperLinks为False，则ObjectListView可以跳过鼠标移动的某些处理。这使得鼠标移动处理几乎不使用CPU。 + + + + + + 光标下的项是否应以特殊方式设置格式？ + + + + + 获取或设置此列表视图是否应在单元格中显示超链接。 + + + + + 此控件是否应显示覆盖(Overlays) + + 覆盖(Overlays)在默认情况下是启用的，只有在它们在您的开发环境中造成问题时才需要禁用。 + + + + 是否应将此控件配置为在子项上显示复选框？ + + 如果将其设置为True，则将为该控件提供一个SmallImageList(如果它还没有一个SmallImageList)。 + 此外，如果它是一个虚拟列表，它将被设置为所有者描述的，因为虚拟列表不能在没有所有者描述的情况下绘制复选框。 + + + + 获取或设置ObjectListView是否将使用类似Vista的半透明选择机制。 + + + + 与UseExplorerTheme不同的是，这个类似Vista的方案可以在XP上运行，并且既适用于所有者描述的列表，也适用于非所有者描述的列表。 + + + 这将替换任何已安装的SelectedRowDecory。 + + + 如果您不喜欢用于选择的颜色，请忽略此属性， + 只需创建您自己的RowBorderDecory并将其分配给SelectedRowDecory， + 就像此属性设置器所做的那样。 + + + + + + 获取或设置ObjectListView是否将使用类似于Vista的半透明热行突出显示机制。 + + + + 设置此项将替换任何已安装的HotItemStyle。 + + + 如果您不喜欢热项目使用的颜色，请忽略此属性， + 只需创建您自己的HotItemStyle，填充所需的值， + 并将其分配给HotItemStyle属性，就像此属性设置器所做的那样。 + + + + + + 获取/设置此列表视图正在使用的视图样式 + + 切换到平铺(Tile)或详细信息(Details)视图会安装适合该视图的列。令人困惑的是，在平铺视图中，每列都显示为一行信息。 + + + + 此委托仅将对象的检查性作为布尔值获取。 + + 如果您永远不想担心不确定状态(这是相当常见的)，请使用此选项。 + + 这是CheckStateGetter属性的便捷包装。 + + + + + + This delegate sets the checkedness of an object as a boolean only. It must return + true or false indicating if the object was checked or not. + + Use this if you never want to worry about the + Indeterminate state (which is fairly common). + + This is a convenience wrapper around the CheckStatePutter property. + + + + + + 获取此列表视图是否能够显示组 + + + + + 获取或设置ObjectListView是否可以依赖正在引发的Application.Idle事件。 + + 在某些主机环境中(例如，在VisualStudio和Office中作为扩展运行时)，从不引发Application.Idle事件。 + 如果不会引发Idle事件，则将其设置为False，ObjectListView将自行引发这些事件。 + + + + + This delegate fetches the renderer for a particular cell. + + + + If this returns null (or is not installed), the renderer for the column will be used. + If the column renderer is null, then will be used. + + + This is called every time any cell is drawn. It must be efficient! + + + + + + This delegate is called when the list wants to show a tooltip for a particular cell. + The delegate should return the text to display, or null to use the default behavior + (which is to show the full text of truncated cell values). + + + Displaying the full text of truncated cell values only work for FullRowSelect listviews. + This is MS's behavior, not mine. Don't complain to me :) + + + + + 保存是否选中模型的属性(或字段)的名称。 + + + 该属性是可修改的。它必须具有bool(或bool？)返回类型。如果TriStateCheckBooks为真)。 + 设置此属性将替换任何已安装的CheckStateGetter或CheckStatePutter。 + 相反，稍后设置CheckStateGetter或CheckStatePutter属性将优先于此属性的行为。 + + + + + 只要ObjectListView需要知道与给定模型对象关联的行的检查状态，就会调用此委托。 + + + .NET has no support for indeterminate values, but as of v2.0, this class allows + indeterminate values. + + + + + This delegate will be called whenever the user tries to change the check state of a row. + The delegate should return the state that was actually set, which may be different + to the state given. + + + + + 此委托可用于以自定义方式对表进行排序。 + + + + 委托必须在ObjectListView上安装ListViewItemSorter。 + 安装ItemSorter会执行对ListViewItems进行排序的实际工作。 + 有关ItemSorter必须执行的操作的示例，请参见代码中的ColumnCompeller。 + + + 请勿在VirtualObjectListView上安装CustomSorter。改为重写IVirtualListDataSource的SortObjects()方法。 + + + + + + This delegate is called when the list wants to show a tooltip for a particular header. + The delegate should return the text to display, or null to use the default behavior + (which is to not show any tooltip). + + + Installing a HeaderToolTipGetter takes precedence over any text in OLVColumn.ToolTipText. + + + + + This delegate can be used to format a OLVListItem before it is added to the control. + + + The model object for the row can be found through the RowObject property of the OLVListItem object. + All subitems normally have the same style as list item, so setting the forecolor on one + subitem changes the forecolor of all subitems. + To allow subitems to have different attributes, do this: + myListViewItem.UseItemStyleForSubItems = false;. + + If UseAlternatingBackColors is true, the backcolor of the listitem will be calculated + by the control and cannot be controlled by the RowFormatter delegate. + In general, trying to use a RowFormatter + when UseAlternatingBackColors is true does not work well. + As it says in the summary, this is called before the item is added to the control. + Many properties of the OLVListItem itself are not available at that point, including: + Index, Selected, Focused, Bounds, Checked, DisplayIndex. + + + + + 将给定的模型对象添加到此控件。 + + 要显示的模型对象 + See AddObjects() for more details + + + + 将给定的模型对象集合添加到此控件。 + + 要显示的模型对象集合 + + 如果排序处于活动状态(即，如果PrimarySortColumn不为空)，则添加的对象将出现在其正确的排序位置。否则，它们将出现在列表的末尾。 + 不执行任何检查以查看是否有任何对象已在ListView中。 + 空对象将被静默忽略。 + + + + + 将列的大小调整到页眉宽度和数据的最大值。 + + + + + 设置任何自动初始化的列宽(宽度为0或-1的列将分别调整为其内容或标题的宽度)。 + + + 显然，这只会起作用一次。一旦运行，列宽将更改为其他值(不是0或-1)，因此第二次运行时不会执行任何操作。 + 若要强制所有列更改其大小，请使用 。 + + + + + 根据最后一个排序列或第一列(如果没有最后一个排序列)将视图项组织到组中 + + + + + 根据给定列将视图项组织成组 + + + + 如果AlwaysGroupByColumn属性不为Null，则列表视图项将按该列组织，并且将忽略‘Column’参数。 + + 此方法触发排序事件：BeforeSorting和AfterSorting。 + + 其值应用于排序的列。 + + + + + 根据给定列将视图项组织成组 + + 将使用哪一列进行分组 + 组将使用什么顺序 + 其值应用于排序的列。不能为空 + 列中值的排序顺序 + 当‘column’中的值相等时，请使用此列提供的值 + 次级值将如何排序 + 此方法不会触发排序事件。使用BuildGroups()执行此操作 + + + + 收集并返回影响组创建的所有变量 + + + + + + Make a list of groups that should be shown according to the given parameters + + + The list of groups to be created + This should not change the state of the control. It is possible that the + groups created will not be used. They may simply be discarded. + + + + 生成/重新生成列表中的所有列表视图项，尽可能多地保留状态 + + + + + 生成/重新生成列表中的所有列表视图项 + + If this is true, the control will try to preserve the selection, + focused item, and the scroll position (see Remarks) + + + + Use this method in situations were the contents of the list is basically the same + as previously. + + + + + + 清除此列表可能一直在使用的所有缓存信息 + + + + + Apply all required extended styles to our control. + + + + Whenever .NET code sets an extended style, it erases all other extended styles + that it doesn't use. So, we have to explicit reapply the styles that we have + added. + + + Normally, we would override CreateParms property and update + the ExStyle member, but ListView seems to ignore all ExStyles that + it doesn't already know about. Worse, when we set the LVS_EX_HEADERINALLVIEWS + value, bad things happen (the control crashes!). + + + + + + Give the listview a reasonable size of its tiles, based on the number of lines of + information that each tile is going to display. + + + + + Rebuild this list for the given view + + + + + + 移除所有对象(线程安全) + + This method can safely be called from background threads. + + + + 重置已访问其URL的内存 + + + + + 将选定行的文本和HTML表示复制到剪贴板上。 + + Be careful when using this with virtual lists. If the user has selected + 10,000,000 rows, this method will faithfully try to copy all of them to the clipboard. + From the user's point of view, your program will appear to have hung. + + + + 将给定对象的文本和HTML表示复制到剪贴板上。 + + + + + 将所有对象的文本和HTML表示复制到剪贴板上。 + + + + + 返回给定对象的html表示形式 + + + + + 取消选择列表视图中的所有行 + + + + + 返回紧跟在给定项后面的ListViewItem。 + 如果给定项为空，则返回列表中的第一个项。 + 如果给定项是最后一项，则返回NULL。 + + The item that is before the item that is returned, or null + A ListViewItem + + + + 按向用户显示的顺序返回最后一项。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + 按向用户显示的顺序返回第n项(从0开始)。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回给定listviewitem索引的显示索引。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回紧接在给定项之前出现的ListViewItem。 + 如果给定项为空，则返回列表中的最后一项。 + 如果给定项是第一项，则返回NULL。 + + The item that is before the item that is returned + A ListViewItem + + + + 在给定位置之前插入给定的对象集合 + + Where to insert the objects + The objects to be inserted + + + This operation only makes sense of non-sorted, non-grouped + lists, since any subsequent sort/group operation will rearrange + the list. + + This method only works on ObjectListViews and FastObjectListViews. + + + + + 如果选择了表示给定模型的行，则返回TRUE + + The model object to look for + Is the row selected + + + + 给定的URL是否已被访问 + + The string to be consider + Has it been visited + + + + 按给定的值增量滚动ListView。 + + Horizontal delta + Vertical delta + + + + Return a point that represents the current horizontal and vertical scroll positions + + + + + 记住给定的URL已被访问 + + The url to be remembered + This does not cause the control be redrawn + + + + 将给定的对象集合移动到给定的索引。 + + 此操作仅对未分组的ObjectListViews有意义。 + + + + + + 计算在给定点下的项目是什么？ + + + + + + + + 使用Windows控件的SUBITEMHITTEST消息执行点击测试。 + 这提供了标准ListView.HitTest()不提供的有关组点击的信息。 + + + + + + + + What is under the given point? This takes the various parts of a cell into accout, including + any custom parts that a custom renderer might use + + + + An information block about what is under the point + + + + Perform a hit test when the control is not owner drawn + + + + + + + + Perform a hit test when the control is owner drawn. This hands off responsibility + to the renderer. + + + + + + + + Pause (or unpause) all animations in the list + + true to pause, false to unpause + + + + Rebuild the columns based upon its current view and column visibility settings + + + + + 从ListView中删除给定的模型对象 + + The model to be removed + See RemoveObjects() for more details + This method is thread-safe. + + + + + 从控件中移除所有给定对象。 + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + This method is thread-safe. + + + + + 选择列表视图中的所有行 + + + + + 在列表视图的右下角设置要固定的给定图像。 + 当列表视图滚动时，此图像不会滚动。 + + + + 此方法使用ListView的原生功能显示背景图像。 + 它有几个限制： + + + 它在owner drawn模式下不能很好地工作。在owner drawn绘制模式下， + 每个单元格都会绘制自身，包括覆盖背景图像的背景。 + 启用网格线时看起来不是很好，因为网格线是在图像上绘制的。 + 它在XP上完全不起作用。 + 显然，当启用交替行背景色时，效果不佳。 + + + 如果你能忍受这些限制，原生水印就相当不错了。 + 它们是真实的背景，而不是像OverlayImage使用的半透明覆盖。 + 与覆盖相比，它们也有明显的优势，因为即使在MDI应用程序中，它们也可以正常工作。 + + 设置此选项将清除所有背景图像。 + + The image to be drawn. If null, any existing image will be removed. + + + + 将给定的图像设置为ListView的背景，以便它在列表中以给定的百分比偏移量显示。 + + + 这具有与 中所述的相同限制. + 在使用该方法之前，请确保了解这些限制。 + 这非常类似于 属性， + 但标准Backround Image不能正确处理具有透明区域的图像--它将透明区域呈现为黑色。这种方法没有这个问题。 + 设置此选项将清除所有背景水印。 + + The image to be drawn. If null, any existing image will be removed. + The horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + The vertical percentage where the image will be placed. + + + + 将给定图像设置为ListView的平铺背景。 + + + 这具有与 和 相同的限制. + 在使用该方法之前，请确保了解这些限制。 + + 要绘制的图像。如果为null，则将删除所有现有图像。 + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法。 + 该列表将立即更新 + The objects to be displayed + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法. + 该列表将立即更新 + The objects to be displayed + 是否应尽可能保留列表的状态。 + + + + 将给定的模型对象更新到ListView中。 + 如果该模型尚不存在，则会添加该模型。 + + The model to be updated + + + See for more details + + 此方法是线程安全的。 + 此方法将导致重新排序列表。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更新与给定对象相等的预先存在的模型。 + 如果控件中不存在任何模型，则会添加它们。 + + Collection of objects to be updated/added + + 此方法将导致重新排序列表。 + null值将被静默忽略。 + 此方法是线程安全的。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更改当前模型对象上对INotifyPropertyChanged事件的任何订阅， + 以便我们不再侦听旧模型上的事件，而侦听给定集合上的事件。 + + This does nothing if UseNotifyPropertyChanged is false. + + + + + 获取或设置ObjectListView是否应订阅它给定的模型对象上的INotifyPropertyChanged事件。 + + + + 这应该在调用SetObjects()之前设置。如果将其设置为False，ObjectListView将取消订阅所有当前模型对象。 + + 如果在虚拟列表上将其设置为true，ObjectListView将遍历列表中尝试订阅更改通知的所有对象。 + 如果您的虚拟列表中有10,000,000个项目，这可能需要一些时间。 + + + + + Subscribe to INotifyPropertyChanges on the given collection of objects. + + + + + + Unsubscribe from INotifyPropertyChanges on the given collection of objects. + If the given collection is null, unsubscribe from all current subscriptions + + + + + + Return a byte array that represents the current state of the ObjectListView, such + that the state can be restored by RestoreState() + + + The state of an ObjectListView includes the attributes that the user can modify: + + current view (i.e. Details, Tile, Large Icon...) + sort column and direction + column order + column widths + column visibility + + + + It does not include selection or the scroll position. + + + A byte array representing the state of the ObjectListView + + + + Restore the state of the control from the given string, which must have been + produced by SaveState() + + A byte array returned from SaveState() + Returns true if the state was restored + + + + Instances of this class are used to store the state of an ObjectListView. + + + + + The application is idle. Trigger a SelectionChanged event. + + + + + + + The application is idle. Handle the column resizing event. + + + + + + + Handle the BeginScroll listview notification + + + True if the event was completely handled + + + + Handle the EndScroll listview notification + + + True if the event was completely handled + + + + Handle the LinkClick listview notification + + + True if the event was completely handled + + + + The cell tooltip control wants information about the tool tip that it should show. + + + + + + + Allow the HeaderControl to call back into HandleHeaderToolTipShowing without making that method public + + + + + + + The header tooltip control wants information about the tool tip that it should show. + + + + + + + Event handler for the column click event + + + + + Override the basic message pump for this control + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user wants to see the context menu. + + The windows m + A bool indicating if this m has been handled + + We want to ignore context menu requests that are triggered by right clicks on the header + + + + + Handle the Custom draw series of notifications + + The message + True if the message has been handled + + + + Handle the underlying control being destroyed + + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + Find the first row after the given start in which the text value in the + comparison column begins with the given text. The comparison column is column 0, + unless IsSearchOnSortColumn is true, in which case the current sort column is used. + + The text to be prefix matched + The index of the first row to consider + Which direction should be searched? + The index of the first row that matched, or -1 + The text comparison is a case-insensitive, prefix match. The search will + search the every row until a match is found, wrapping at the end if needed. + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + 是否只匹配开头 + The index of the matched row, or -1 + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + Handle the Group Info series of notifications + + The message + True if the message has been handled + + + + Handle a key down message + + + True if the msg has been handled + + + + Toggle the checkedness of the selected rows + + + + Actually, this doesn't actually toggle all rows. It toggles the first row, and + all other rows get the check state of that first row. This is actually a much + more useful behaviour. + + + If no rows are selected, this method does nothing. + + + + + + Catch the Left Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button up event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Trigger a GroupExpandCollapse event and return true if the action was cancelled + + + + + + + Catch the Right Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the right Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a right mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the MouseMove event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle notifications that have been reflected back from the parent window + + The m to be processed + bool to indicate if the msg has been handled + + + + In the notification messages, we handle attempts to change the width of our columns + + The m to be processed + bool to indicate if the msg has been handled + + + + Create a ToolTipControl to manage the tooltip control used by the listview control + + + + + Update the handle used by our cell tooltip to be the tooltip used by + the underlying Windows listview control. + + + + + Handle the WM_PAINT event + + + Return true if the msg has been handled and nothing further should be done + + + + Perform any steps needed before painting the control + + + + + Perform any steps needed after painting the control + + + + + Handle the window position changing. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a menu that is appropriate when the given column header is clicked. + + The index of the header that was clicked. This + can be -1, indicating that the header was clicked outside of a column + Where should the menu be shown + True if a menu was displayed + + + + Create the menu that should be displayed when the user right clicks + on the given column header. + + Index of the column that was right clicked. + This can be negative, which indicates a click outside of any header. + The toolstrip that should be displayed + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + Where should the menu be placed + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + + Where should the menu be placed + + + + 获取或设置要用于升序排序命令的文本 + + + + + 获取或设置要用于降序排序命令的文本 + + + + + 获取或设置要用于分组命令的文本 + + + + + 获取或设置要用于锁定分组命令的文本 + + + + + 获取或设置要用于不锁定分组命令的文本 + + + + + 获取或设置要用于关闭分组命令的文本 + + + + + 获取或设置要用于不排序命令的文本 + + + + + 获取或设置要用于列描述的文本 + + + + + 获取或设置要用于选择列描述的文本 + + + + + Gets or sets the image that will be place next to the Sort Ascending command + + + + + Gets or sets the image that will be placed next to the Sort Descending command + + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + + Return the menu to which the items were added + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + Return the menu to which the items were added + + + + Create the menu items that will allow columns to be choosen and add them to the + given collection + + + + + + Create a Filtering menu + + + + + + + + Override the OnColumnReordered method to do what we want + + + + + + When the column widths are changing, resize the space filling columns + + + + + + + When the column widths change, resize the space filling columns + + + + + + + When the size of the control changes, we have to resize our space filling columns. + + + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Check all rows + + + + + Check the checkbox in the given column header + + If the given columns header check box is linked to the cell check boxes, + then checkboxes in all cells will also be checked. + + + + + Mark the checkbox in the given column header as having an indeterminate value + + + + + + Mark the given object as indeterminate check state + + The model object to be marked indeterminate + + + + Mark the given object as checked in the list + + The model object to be checked + + + + Mark the given objects as checked in the list + + The model object to be checked + + + + Put a check into the check box at the given cell + + + + + + + Put an indeterminate check into the check box at the given cell + + + + + + + Return true of the given object is checked + + The model object whose checkedness is returned + Is the given object checked? + If the given object is not in the list, this method returns false. + + + + Return true of the given object is indeterminately checked + + The model object whose checkedness is returned + Is the given object indeterminately checked? + If the given object is not in the list, this method returns false. + + + + Is there a check at the check box at the given cell + + + + + + + Get the checkedness of an object from the model. Returning null means the + model does not know and the value from the control will be used. + + + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the checkedness of the given object. A checked object becomes + unchecked; an unchecked or indeterminate object becomes checked. + If the list has tristate checkboxes, the order is: + unchecked -> checked -> indeterminate -> unchecked ... + + The model object to be checked + + + + Toggle the checkbox in the header of the given column + + Obviously, this is only useful if the column actually has a header checkbox. + + + + + Toggle the check at the check box of the given cell + + + + + + + Uncheck all rows + + + + + Mark the given object as unchecked in the list + + The model object to be unchecked + + + + Mark the given objects as unchecked in the list + + The model object to be checked + + + + Uncheck the checkbox in the given column header + + + + + + Uncheck the check at the given cell + + + + + + + 返回给定索引处的列 + + Index of the column to be returned + An OLVColumn + + + + 返回给定标题处的列,如果有多个符合要求的标题,则默认只返回第一个 + + 要返回的列的名称 + An OLVColumn + + + + 返回给定视图可见的列的集合。只有Tile和Details有列；所有其他视图都有0列。 + + 正在为哪个视图计算列？ + A list of columns + + + + 返回列表中的项目数 + + 列表中的项目数 + 如果安装了筛选器，这将返回与筛选器匹配的项目数。 + + + + 返回给定索引处的项 + + Index of the item to be returned + An OLVListItem + + + + 返回给定索引处的模型对象 + + Index of the model object to be returned + A model object + + + + 找出在给定的坐标下的行和列 + X 坐标 + Y 坐标 + 给定点下的列项 + 在给定坐标点下的行项。可以为null。 + + + + 返回给定索引/列的子项 + + Index of the item to be returned + Index of the subitem to be returned + An OLVListSubItem + + + + 滚动列表视图，使给定组位于顶部。 + + The group to be revealed + + 如果该组可见，如果可能，列表仍将滚动以将该组移至顶部。 + + 这只在列表显示分组时才有效(显然)。 + 这在虚拟列表上不起作用，因为虚拟列表不使用ListViewGroups进行分组。使用 代替. + + + + + 使给定的模型对象可见 + + The model object to be revealed + + + + 返回选定行的模型对象，如果没有选择或有多个选择，则返回null + + Model object or null + + + + 返回选定行的模型对象，如果没有选择，则返回空集合 + + ArrayList + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + Model object or null + 使用 CheckedObject 属性代替本方法 + + + + 获取选中的模型对象的集合。 + + 使用 CheckedObjects 属性代替本方法 + + + + 在列表视图中查找给定的模型对象并返回其索引 + + The model object to be found + The index of the object. -1 means the object was not present + + + + Rebuild the given ListViewItem with the data from its associated model. + + This method does not resort or regroup the view. It simply updates + the displayed data of the given item + + + + Rebuild the data on the row that is showing the given object. + + + + This method does not resort or regroup the view. + + + The given object is *not* used as the source of data for the rebuild. + It is only used to locate the matching model in the collection, + then that matching model is used as the data source. This distinction is + only important in model classes that have overridden the Equals() method. + + + If you want the given model object to replace the pre-existing model, + use . + + + + + + Update the rows that are showing the given objects + + + This method does not resort or regroup the view. + This method can safely be called from background threads. + + + + + 更新选定的行 + + This method does not resort or regroup the view. + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + Use the property to deselect all other rows + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + 对象是否也应该被聚焦 + Use the property to deselect all other rows + + + + 选择显示任意给定模型对象的行。取消选择所有其他行。 + + A collection of model objects + + + + 获取或设置是否冻结列表视图。当列表视图被冻结时，它不会自我更新。 + + Frozen属性与Freeze()/UnFreeze()方法类似， + 不同之处在于将Frozen属性设置为False会立即解冻控件， + 而不管有多少未完成的Freeze()调用。 + objectListView1.Frozen = false; // unfreeze the control now! + + + + + 冻结列表视图，使其不再自我更新。 + + Freeze()/Unfreeze() calls nest correctly + + + + 解冻列表视图。如果此调用是最外层的unFreeze()，则将重新构建listview的内容。 + + Freeze()/Unfreeze() calls nest correctly + + + + 在冻结列表视图时执行所需的实际工作 + + + + + 解冻列表视图时执行所需的实际工作 + + + + + 如果选择事件当前挂起，则返回TRUE。在挂起选择事件时，不会引发SelectedIndexChanged或SelectionChanged事件。 + + + + + Suspend selection events until a matching ResumeSelectionEvents() + is called. + + Calls to this method nest correctly. Every call to SuspendSelectionEvents() + must have a matching ResumeSelectionEvents(). + + + + Resume raising selection events. + + + + + Returns a disposable that will disable selection events + during a using() block. + + + + + + Implementation only class that suspends and resumes selection + events on instance creation and disposal. + + + + + 按最后一个排序列和顺序对项目进行排序 + + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的名称 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的索引 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + The column whose values will be used for the sorting. + If null, the first column will be used. + The ordering to be used for sorting. If this is None, + this.Sorting and then SortOrder.Ascending will be used + If ShowGroups is true, the rows will be grouped by the given column. + If AlwaysGroupsByColumn is not null, the rows will be grouped by that column, + and the rows within each group will be sorted by the given column. + + + + Put a sort indicator next to the text of the sort column + + + + + Put a sort indicator next to the text of the given given column + + The column to be marked + The sort order in effect on that column + + + + The name of the image used when a column is sorted ascending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + The name of the image used when a column is sorted descending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + If the sort indicator images don't already exist, this method will make and install them + + + + + Remove any sorting and revert to the given order of the model objects + + + + + Do the actual work of creating the given list of groups + + + + + + For some reason, UseItemStyleForSubItems doesn't work for the colors + when owner drawing the list, so we have to specifically give each subitem + the desired colors + + The item whose subitems are to be corrected + Cells drawn via BaseRenderer don't need this, but it is needed + when an owner drawn cell uses DrawDefault=true + + + + Fill in the given OLVListItem with values of the given row + + the OLVListItem that is to be stuff with values + the model object from which values will be taken + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + + + + Convert the given image selector to an index into our image list. + Return -1 if that's not possible + + + Index of the image in the imageList, or -1 + + + + Return the tooltip that should be shown when the mouse is hovered over the given column + + The column index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回当鼠标悬停在给定单元格上时应显示的工具提示 + + The column index whose tool tip is to be fetched + The row index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回显示给定模型对象的OLVListItem + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Do the work required after the items in a listview have been created + + + + + Do the work required after one item in a listview have been created + + + + + 准备列表视图以显示交替的行背景色 + + We cannot rely on lvi.Index in this method. + In a straight list, lvi.Index is the display index, and can be used to determine + whether the row should be colored. But when organised by groups, lvi.Index is not + useable because it still refers to the position in the overall list, not the display order. + + + + + Setup all subitem images on all rows + + + + + 告诉基础列表控件针对子项显示哪些图像 + + the index at which the item occurs + the item whose subitems are to be set + + + + Tell the underlying list control which images to show against the subitems + + the index at which the item occurs + the item whose subitems are to be set + will existing images be cleared if no new image is provided? + + + + Set the subitem image natively + + + + + + + + + Take ownership of the 'objects' collection. This separats our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + This method has the intentional side-effect of converting our list of objects to an ArrayList. + + + + + + 触发给定项目的FormatRow和可能的FormatCell事件 + + + + + + + + 触发给定项目的FormatCell事件 + + + + + + + + Make the list forget everything -- all rows and all columns + + Use if you want to remove just the rows. + + + + Update our externally visible image list so it holds the same images as our shadow list, but sized correctly + + + + + Return a copy of the given source image list, where each image has been resized to be height x height in size. + If source is null, an empty image list of the given size is returned + + Height and width of the new images + Height and width of the new images + Source of the images (can be null) + A new image list + + + + Return a bitmap of the given height x height, which shows the given image, centred. + + Height and width of new bitmap + Height and width of new bitmap + Image to be centred + The background color + A new bitmap + + + + Initialize the state image list with the required checkbox images + + + + + The name of the image used when a check box is checked + + + + + The name of the image used when a check box is unchecked + + + + + The name of the image used when a check box is Indeterminate + + + + + Setup this control so it can display check boxes on subitems + (or primary checkboxes in virtual mode) + + This gives the ListView a small image list, if it doesn't already have one. + + + + Make sure the small image list for this control has checkbox images + (used for sub-item checkboxes). + + + + This gives the ListView a small image list, if it doesn't already have one. + + + ObjectListView has to manage checkboxes on subitems separate from the checkboxes on each row. + The underlying ListView knows about the per-row checkboxes, and to make them work, OLV has to + correctly configure the StateImageList. However, the ListView cannot do checkboxes in subitems, + so ObjectListView has to handle them in a differnt fashion. So, per-row checkboxes are controlled + by images in the StateImageList, but per-cell checkboxes are handled by images in the SmallImageList. + + + + + + Owner draw the column header + + + + + + Owner draw the item + + + + + + Owner draw a single subitem + + + + + + We need the click count in the mouse up event, but that is always 1. + So we have to remember the click count from the preceding mouse down event. + + + + + + When the mouse leaves the control, remove any hot item highlighting + + + + + + When the mouse moves, we might need to change the hot item. + + + + + + Check to see if we need to start editing a cell + + + + + + Tell the world that a hyperlink was clicked and if the event isn't handled, + do the default processing. + + + + + + Do the default processing for a hyperlink clicked event, which + is to try and open the url. + + + + + + The user right clicked on the control + + + + + + This method is called every time a row is selected or deselected. This can be + a pain if the user shift-clicks 100 rows. We override this method so we can + trigger one event for any number of select/deselects that come from one user action + + + + + + Called when the handle of the underlying control is created + + + + + + This method is called after the control has been fully created. + + + + + Should we start editing the cell in response to the given mouse button event? + + + + + + + Handle a key press on this control. We specifically look for F2 which edits the primary column, + or a Tab character during an edit operation, which tries to start editing on the next (or previous) cell. + + + + + + + Start an editing operation on the first editable column of the given model. + + + + + If the model doesn't exist, or there are no editable columns, this method + will do nothing. + + This will start an edit operation regardless of CellActivationMode. + + + + + + Begin an edit operation on the given cell. + + This performs various sanity checks and passes off the real work to StartCellEdit(). + The row to be edited + The index of the cell to be edited + + + + Really start an edit operation on a given cell. The parameters are assumed to be sane. + + The row to be edited + The index of the cell to be edited + + + + Calculate the bounds of the edit control for the given item/column + + + + + + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is not being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Try to give the given value to the provided control. Fall back to assigning a string + if the value assignment fails. + + A control + The value to be given to the control + The string to be given if the value doesn't work + + + + Setup the given control to be a cell editor + + + + + Return the value that the given control is showing + + + + + + + Called when the cell editor could be about to lose focus. Time to commit the change + + + + + + + Return the bounds of the given cell + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Return the bounds of the given cell only until the edge of the current text + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Calculate the visible bounds of the given column. The column's bottom edge is + either the bottom of the last row or the bottom of the control. + + The bounds of the control itself + The column + A Rectangle + This returns an empty rectnage if the control isn't in Details mode, + OR has doesn't have any rows, OR if the given column is hidden. + + + + Return a control that can be used to edit the value of the given cell. + + The row to be edited + The index of the cell to be edited + A Control to edit the given cell + + + + Get the first non-null value of the given column. + At most 1000 rows will be considered. + + + The first non-null value, or null if no non-null values were found + + + + Return a TextBox that can be used as a default cell editor. + + What column does the cell belong to? + + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + Consider only this many rows + + + + Stop editing a cell and throw away any changes. + + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Remove all trace of any existing cell edit operation + + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + True if the cell editor should be disposed + + + + Force the hot item to be recalculated + + + + + Force the hot item to be recalculated + + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + Where is the mouse? + This is the main entry point for hot item handling + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + + This is the main entry point for hot item handling + + + + Update the given row using the current hot item information + + + + + + Update the given row using the given hot item information + + + + + + + + + Apply a style to the given row + + + + + + + Apply a style to a cell + + + + + + + + Remove hot item styling from the given row + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Add the given decoration to those on this list and make it appear + + The decoration + + A decoration scrolls with the listview. An overlay stays fixed in place. + + + + + Add the given overlay to those on this list and make it appear + + The overlay + + + + Draw all the decorations + + A Graphics + The items that were redrawn and whose decorations should also be redrawn + + + + Is the given decoration shown on this list + + The overlay + + + + Is the given overlay shown on this list? + + The overlay + + + + Hide any overlays. + + + This is only a temporary hiding -- the overlays will be shown + the next time the ObjectListView redraws. + + + + + Create and configure the empty list msg overlay + + + + + Initialize the standard image and text overlays + + + + + Make sure that any overlays are visible. + + + + + Refresh the display of the overlays + + + + + Refresh the display of just one overlays + + + + + Remove the given decoration from this list + + The decoration to remove + + + + Remove the given overlay to those on this list + + The overlay + + + + 创建一个筛选器，该筛选器将执行当前安装在可见列上的所有筛选。 + + + + + Do the actual work of filtering + + + + + + + + + 删除所有列筛选。 + + + + + 根据每列中定义的值筛选更新此ObjectListView的筛选 + + + + + When some setting related to filtering changes, this method is called. + + + + + 使用当前安装的模型过滤器更新所有渲染器 + + + + + 获取给定模型的复选框状态。 + + The model + 模型的复选框状态。默认为未选中。 + + + + 设置给定模型对象的复选框状态 + + The model to be remembered + The model's checkedness + The state given to the method + + + + 忽略任何持久复选框状态 + + + + + The callbacks for CellEditing events + + this + We could replace this with EventHandler<CellEditEventArgs> but that would break all + cell editing event code from v1.x. + + + + + A TreeListView combines an expandable tree structure with list view columns. + + + To support tree operations, two delegates must be provided: + + + + CanExpandGetter + + + This delegate must accept a model object and return a boolean indicating + if that model should be expandable. + + + + + ChildrenGetter + + + This delegate must accept a model object and return an IEnumerable of model + objects that will be displayed as children of the parent model. This delegate will only be called + for a model object if the CanExpandGetter has already returned true for that model. + + + + + ParentGetter + + + This delegate must accept a model object and return the parent model. + This delegate will only be called when HierarchicalCheckboxes is true OR when Reveal() is called. + + + + + The top level branches of the tree are set via the Roots property. SetObjects(), AddObjects() + and RemoveObjects() are interpreted as operations on this collection of roots. + + + To add new children to an existing branch, make changes to your model objects and then + call RefreshObject() on the parent. + + The tree must be a directed acyclic graph -- no cycles are allowed. Put more mundanely, + each model object must appear only once in the tree. If the same model object appears in two + places in the tree, the control will become confused. + + + + + This event is triggered when user input requests the expansion of a list item. + + + + + This event is triggered when user input requests the collapse of a list item. + + + + + This event is triggered after the expansion of a list item due to user input. + + + + + This event is triggered after the collapse of a list item due to user input. + + + + + Trigger the expanding event + + + + + + Trigger the collapsing event + + + + + + Trigger the expanded event + + + + + + Trigger the collapsed event + + + + + + This class handles drawing the tree structure of the primary column. + + + + + Create a TreeRenderer + + + + + Should the renderer draw glyphs at the expansion points? + + The expansion points will still function to expand/collapse even if this is false. + + + + Should the renderer draw lines connecting siblings? + + + + + Return the pen that will be used to draw the lines between branches + + + + + Should the renderer draw triangles as the expansion glyphs? + + + This looks best with ShowLines = false + + + + + Return the branch that the renderer is currently drawing. + + + + + Return the TreeListView for which the renderer is being used. + + + + + How many pixels will be reserved for each level of indentation? + + + + + The real work of drawing the tree is done in this method + + + + + + + Draw the expansion indicator + + + + + + + + Gets whether or not we should render using styles + + + + + Draw the expansion indicator using styles + + + + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the expansion indicator without using styles + + + + + + + + Draw the lines of the tree + + + + + + + + + + Do the hit test + + + + + + + + + Calculate the edit rect + + + + + + + + + + + Make a default TreeListView + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + This is called *often* -- on every mouse move when required. It must be fast. + Don't do database lookups, linear searches, or pi calculations. Just return the + value of a property. + + + When this delegate is called, the TreeListView is not in a stable state. Don't make + calls back into the control. + + + + + + Gets whether or not this listview is capable of showing groups + + + + + This is the delegate that will be used to fetch the children of a model object + + + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + When this delegate is called, the TreeListView is not in a stable state. Don't do anything + that will result in calls being made back into the control. + + + + + + This is the delegate that will be used to fetch the parent of a model object + + The parent of the given model, or null if the model doesn't exist or + if the model is a root + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivalent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + + + + Gets or sets the model objects that are expanded. + + + This can be used to expand model objects before they are seen. + + Setting this does *not* force the control to rebuild + its display. You need to call RebuildAll(true). + + + + + + Gets or sets the filter that is applied to our whole list of objects. + TreeListViews do not currently support whole list filters. + + + + + Gets or sets whether this tree list view will display hierarchical checkboxes. + Hierarchical checkboxes is when a parent's "checkedness" is calculated from + the "checkedness" of its children. If all children are checked, the parent + will be checked. If all children are unchecked, the parent will also be unchecked. + If some children are checked and others are not, the parent will be indeterminate. + + + Hierarchical checkboxes don't work with either CheckStateGetters or CheckedAspectName + (which is basically the same thing). This is because it is too expensive to build the + initial state of the control if these are installed, since the control would have to walk + *every* branch recursively since a single bottom level leaf could change the checkedness + of the top root. + + + + + Gets or sets the collection of root objects of the tree + + + + + Gets the collection of objects that will be considered when creating clusters + (which are used to generate Excel-like column filters) + + + + + After expanding a branch, should the TreeListView attempts to show as much of the + revealed descendents as possible. + + + + + The model objects that form the top level branches of the tree. + + Setting this does NOT reset the state of the control. + In particular, it does not collapse branches. + + + + Make sure that at least one column is displaying a tree. + If no columns is showing the tree, make column 0 do it. + + + + + Gets or sets the renderer that will be used to draw the tree structure. + Setting this to null resets the renderer to default. + + If a column is currently rendering the tree, the renderer + for that column will be replaced. If no column is rendering the tree, + column 0 will be given this renderer. + + + + This is the delegate that will be used to create the underlying Tree structure + that the TreeListView uses to manage the information about the tree. + + + The factory must not return null. + + Most users of TreeListView will never have to use this delegate. + + + + + + Should a wait cursor be shown when a branch is being expanded? + + When this is true, the wait cursor will be shown whilst the children of the + branch are being fetched. If the children of the branch have already been cached, + the cursor will not change. + + + + Gets the model that is used to manage the tree structure + + + Don't mess with this property unless you really know what you are doing. + If you don't already know what it's for, you don't need it. + + + + Return true if the branch at the given model is expanded + + + + + + + Collapse the subtree underneath the given model + + + + + + Collapse all subtrees within this control + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Collapse all roots and forget everything we know about all models + + + + + Expand the subtree underneath the given model object + + + + + + Expand all the branches within this tree recursively. + + Be careful: this method could take a long time for large trees. + + + + Completely rebuild the tree structure + + If true, the control will try to preserve selection and expansion + + + + Completely rebuild the tree structure + + If not null, this list of objects will be selected after the tree is rebuilt + If not null, this collection of objects will be expanded after the tree is rebuilt + If not null, this collection of objects will be checked after the tree is rebuilt + + + + Unroll all the ancestors of the given model and make sure it is then visible. + + This works best when a ParentGetter is installed. + The object to be revealed + If true, the model will be selected and focused after being revealed + True if the object was found and revealed. False if it was not found. + + + + Update the rows that are showing the given objects + + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the expanded state of the branch at the given model object + + + + + + Return whether or not the given model can expand. + + + The given model must have already been seen in the tree + + + + Return the model object that is the parent of the given model object. + + + + The given model must have already been seen in the tree. + + + + Return the collection of model objects that are the children of the + given model as they exist in the tree at the moment. + + + + + This method returns the collection of children as the tree knows them. If the given + model has never been presented to the user (e.g. it belongs to a parent that has + never been expanded), then this method will return an empty collection. + + Because of this, if you want to traverse the whole tree, this is not the method to use. + It's better to traverse the your data model directly. + + + If the given model has not already been seen in the tree or + if it is not expandable, an empty collection will be returned. + + + + + + Delegates of this type are use to decide if the given model object can be expanded + + The model under consideration + Can the given model be expanded? + + + + Delegates of this type are used to fetch the children of the given model object + + The parent whose children should be fetched + An enumerable over the children + + + + Delegates of this type are used to fetch the parent of the given model object. + + The child whose parent should be fetched + The parent of the child or null if the child is a root + + + + Delegates of this type are used to create a new underlying Tree structure. + + The view for which the Tree is being created + A subclass of Tree + + + + Handle a left button down event + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + This differs from the base method by also setting up the IndentCount property. + + + + Reinitialize the Tree structure + + + + + Recalculate the state of the checkboxes of all the items in the given list + and their ancestors. + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Recalculate the hierarchy state of the given item and its ancestors + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Yield the unique ancestors of the given collection of objects. + The order of the ancestors is guaranteed to be deeper objects first. + Roots will always be last. + + + Unique ancestors of the given objects + + + + Return all the ancestors of the given model + + + + This uses ParentGetter if possible. + + If the given model is a root OR if the model doesn't exist, the collection will be empty + + The model whose ancestors should be calculated + Return a collection of ancestors of the given model. + + + + The application is idle and a SelectionChanged event has been scheduled + + + + + + + Decide if the given key event should be handled as a normal key input to the control? + + + + + + + Handle focus being lost, including making sure that the whole control is redrawn. + + + + + + Handle the keyboard input to mimic a TreeView. + + + Was the key press handled? + + + + A Tree object represents a tree structure data model that supports both + tree and flat list operations as well as fast access to branches. + + If you create a subclass of Tree, you must install it in the TreeListView + via the TreeFactory delegate. + + + + Create a Tree + + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + + This is the delegate that will be used to fetch the children of a model object + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + + Get or return the top level model objects in the tree + + + + + What tree view is this Tree the model for? + + + + + Collapse the subtree underneath the given model + + The model to be collapsed. If the model isn't in the tree, + or if it is already collapsed, the command does nothing. + The index of the model in flat list version of the tree + + + + Collapse all branches in this tree + + Nothing useful + + + + Expand the subtree underneath the given model object + + The model to be expanded. + The index of the model in flat list version of the tree + + If the model isn't in the tree, + if it cannot be expanded or if it is already expanded, the command does nothing. + + + + + Expand all branches in this tree + + Return the index of the first branch that was expanded + + + + Return the Branch object that represents the given model in the tree + + The model whose branches is to be returned + The branch that represents the given model, or null if the model + isn't in the tree. + + + + Return the number of visible descendents that are below the given model. + + The model whose descendent count is to be returned + The number of visible descendents. 0 if the model doesn't exist or is collapsed + + + + Rebuild the children of the given model, refreshing any cached information held about the given object + + + The index of the model in flat list version of the tree + + + + Is the given model expanded? + + + + + + + Remember whether or not the given model was expanded + + + + + + + Insert the children of the given branch into the given position + + The branch whose children should be inserted + The index where the children should be inserted + + + + Rebuild our flat internal list of objects. + + + + + Rebuild our reverse index that maps an object to its location + in the filteredObjectList array. + + + + + + Create a new branch within this tree + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Sort the tree on the given column and in the given order + + + + + + + + + + + + + Add the given collection of objects to the roots of this tree + + + + + + + + + + + + + Remove all of the given objects from the roots of the tree. + Any objects that is not already in the roots collection is ignored. + + + + + + Set the roots of this tree to be the given collection + + + + + + Update/replace the nth object with the given object + + + + + + + + + + + + + + Is this list currently being filtered? + + + + + Should the given model be included in this control? + + The model to consider + True if it will be included + + + + + + + + + + + + + + A Branch represents a sub-tree within a tree + + + + + Indicators for branches + + + + + FirstBranch of tree + + + + + LastChild of parent + + + + + OnlyBranch of tree + + + + + Create a Branch + + + + + + + + Get the ancestor branches of this branch, with the 'oldest' ancestor first. + + + + + Can this branch be expanded? + + + + + Gets or sets our children + + + + + Get/set the model objects that are beneath this branch + + + + + Gets a list of all the branches that survive filtering + + + + + Gets or set whether this branch is expanded + + + + + Return true if this branch is the first branch of the entire tree + + + + + Return true if this branch is the last child of its parent + + + + + Return true if this branch is the only top level branch + + + + + Gets the depth level of this branch + + + + + Gets or sets which model is represented by this branch + + + + + Return the number of descendents of this branch that are currently visible + + + + + + Gets or sets our parent branch + + + + + Gets or sets our overall tree + + + + + Is this branch currently visible? A branch is visible + if it has no parent (i.e. it's a root), or its parent + is visible and expanded. + + + + + Clear any cached information that this branch is holding + + + + + Collapse this branch + + + + + Expand this branch + + + + + Expand this branch recursively + + + + + Collapse all branches in this tree + + Nothing useful + + + + Fetch the children of this branch. + + This should only be called when CanExpand is true. + + + + Collapse the visible descendents of this branch into list of model objects + + + + + + Flatten this branch's visible descendents onto the given list. + + + The branch itself is not included in the list. + + + + Force a refresh of all children recursively + + + + + Sort the sub-branches and their descendents so they are ordered according + to the given comparer. + + The comparer that orders the branches + + + + This class sorts branches according to how their respective model objects are sorted + + + + + Create a BranchComparer + + + + + + Order the two branches + + + + + + + + Let the world know that a cell edit operation is beginning or ending + + + + + Create an event args + + + + + + + + + + Change this to true to cancel the cell editing operation. + + + During the CellEditStarting event, setting this to true will prevent the cell from being edited. + During the CellEditFinishing event, if this value is already true, this indicates that the user has + cancelled the edit operation and that the handler should perform cleanup only. Setting this to true, + will prevent the ObjectListView from trying to write the new value into the model object. + + + + + During the CellEditStarting event, this can be modified to be the control that you want + to edit the value. You must fully configure the control before returning from the event, + including its bounds and the value it is showing. + During the CellEditFinishing event, you can use this to get the value that the user + entered and commit that value to the model. Changing the control during the finishing + event has no effect. + + + + + The column of the cell that is going to be or has been edited. + + + + + The model object of the row of the cell that is going to be or has been edited. + + + + + The listview item of the cell that is going to be or has been edited. + + + + + The data value of the cell as it stands in the control. + + Only validate during Validating and Finishing events. + + + + The index of the cell that is going to be or has been edited. + + + + + The data value of the cell before the edit operation began. + + + + + The bounds of the cell that is going to be or has been edited. + + + + + Gets or sets whether the control used for editing should be auto matically disposed + when the cell edit operation finishes. Defaults to true + + If the control is expensive to create, you might want to cache it and reuse for + for various cells. If so, you don't want ObjectListView to dispose of the control automatically + + + + Event blocks for events that can be cancelled + + + + + Has this event been cancelled by the event handler? + + + + + BeforeSorting + + + + + Create BeforeSortingEventArgs + + + + + + + + + Create BeforeSortingEventArgs + + + + + + + + + + + Did the event handler already do the sorting for us? + + + + + What column will be used for grouping + + + + + How will groups be ordered + + + + + What column will be used for sorting + + + + + What order will be used for sorting. None means no sorting. + + + + + What column will be used for secondary sorting? + + + + + What order will be used for secondary sorting? + + + + + Sorting has just occurred. + + + + + Create a AfterSortingEventArgs + + + + + + + + + + + Create a AfterSortingEventArgs + + + + + + What column was used for grouping? + + + + + What ordering was used for grouping? + + + + + What column was used for sorting? + + + + + What ordering was used for sorting? + + + + + What column was used for secondary sorting? + + + + + What order was used for secondary sorting? + + + + + This event is triggered when the contents of a list have changed + and we want the world to have a chance to filter the list. + + + + + Create a FilterEventArgs + + + + + + Gets or sets what objects are being filtered + + + + + Gets or sets what objects survived the filtering + + + + + This event is triggered after the items in the list have been changed, + either through SetObjects, AddObjects or RemoveObjects. + + + + + Create a ItemsChangedEventArgs + + + + + Constructor for this event when used by a virtual list + + + + + + + Gets how many items were in the list before it changed + + + + + Gets how many objects are in the list after the change. + + + + + This event is triggered by AddObjects before any change has been made to the list. + + + + + Create an ItemsAddingEventArgs + + + + + + Create an ItemsAddingEventArgs + + + + + + + Gets or sets where the collection is going to be inserted. + + + + + Gets or sets the objects to be added to the list + + + + + This event is triggered by SetObjects before any change has been made to the list. + + + When used with a virtual list, OldObjects will always be null. + + + + + Create ItemsChangingEventArgs + + + + + + + Gets the objects that were in the list before it change. + For virtual lists, this will always be null. + + + + + Gets or sets the objects that will be in the list after it changes. + + + + + This event is triggered by RemoveObjects before any change has been made to the list. + + + + + Create an ItemsRemovingEventArgs + + + + + + Gets or sets the objects that will be removed + + + + + Triggered after the user types into a list + + + + + Create an AfterSearchingEventArgs + + + + + + + Gets the string that was actually searched for + + + + + Gets or sets whether an the event handler already handled this event + + + + + Gets the index of the row that was selected by the search. + -1 means that no row was matched + + + + + Triggered when the user types into a list + + + + + Create BeforeSearchingEventArgs + + + + + + + Gets or sets the string that will be found by the search routine + + Modifying this value does not modify the memory of what the user has typed. + When the user next presses a character, the search string will revert to what + the user has actually typed. + + + + Gets or sets the index of the first row that will be considered to matching. + + + + + The parameter block when telling the world about a cell based event + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + This is null for events triggered by the header. + + + + Gets the row index of the cell + + This is -1 for events triggered by the header. + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the location of the mouse at the time of the event + + + + + Gets the state of the modifier keys at the time of the event + + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view and + for event triggered by the header + + + + Gets the HitTest object that determined which cell was hit + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Tells the world that a cell was clicked + + + + + Gets or sets the number of clicks associated with this event + + + + + Tells the world that a cell was right clicked + + + + + Gets or sets the menu that should be displayed as a result of this event. + + The menu will be positioned at Location, so changing that property changes + where the menu will be displayed. + + + + Tell the world that the mouse is over a given cell + + + + + Tells the world that the frozen-ness of the ObjectListView has changed. + + + + + Make a FreezeEventArgs + + + + + + How frozen is the control? 0 means that the control is unfrozen, + more than 0 indicates froze. + + + + + The parameter block when telling the world that a tool tip is about to be shown. + + + + + Gets the tooltip control that is triggering the tooltip event + + + + + Gets or sets the text should be shown on the tooltip for this event + + Setting this to empty or null prevents any tooltip from showing + + + + In what direction should the text for this tooltip be drawn? + + + + + Should the tooltip for this event been shown in bubble style? + + This doesn't work reliable under Vista + + + + What color should be used for the background of the tooltip + + Setting this does nothing under Vista + + + + What color should be used for the foreground of the tooltip + + Setting this does nothing under Vista + + + + What string should be used as the title for the tooltip for this event? + + + + + Which standard icon should be used for the tooltip for this event + + + + + How many milliseconds should the tooltip remain before it automatically + disappears. + + + + + What font should be used to draw the text of the tooltip? + + + + + Common information to all hyperlink events + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the ObjectListView that is the source of the event + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the text of the cell + + + + + Gets or sets whether or not this cell is a hyperlink. + Defaults to true for enabled rows and false for disabled rows. + + + + + Gets or sets the url that should be invoked when this cell is clicked. + + Setting this to None or String.Empty means that this cell is not a hyperlink + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the item of the cell + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the display index of the row + + + + + Should events be triggered for each cell in this row? + + + + + Parameter block for FormatCellEvent + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the model value that is being displayed by the cell. + + This is null when the view is not in details view + + + + The event args when a hyperlink is clicked + + + + + Gets the url that was associated with this cell. + + + + + The event args when the check box in a column header is changing + + + + + Get the column whose checkbox is changing + + + + + Get or set the new state that should be used by the column + + + + + The event args when the hot item changed + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Gets the part of the cell that the mouse is over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + Gets the index of the column that the mouse is over + + In non-details view, this will always be 0. + + + + Gets the index of the row that the mouse is over + + + + + Gets the group that the mouse is over + + + + + Gets the part of the cell that the mouse used to be over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse used to be over + + + + + Gets the index of the column that the mouse used to be over + + + + + Gets the index of the row that the mouse used to be over + + + + + Gets the group that the mouse used to be over + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + Let the world know that a checkbox on a subitem is changing + + + + + Create a new event block + + + + + + + + + + The column of the cell that is having its checkbox changed. + + + + + The model object of the row of the cell that is having its checkbox changed. + + + + + The listview item of the cell that is having its checkbox changed. + + + + + The current check state of the cell. + + + + + The proposed new check state of the cell. + + + + + The index of the cell that is going to be or has been edited. + + + + + This event argument block is used when groups are created for a list. + + + + + Create a CreateGroupsEventArgs + + + + + + Gets the settings that control the creation of groups + + + + + Gets or sets the groups that should be used + + + + + Has this event been cancelled by the event handler? + + + + + This event argument block is used when the text of a group task is clicked + + + + + Create a GroupTaskClickedEventArgs + + + + + + Gets which group was clicked + + + + + This event argument block is used when a group is about to expand or collapse + + + + + Create a GroupExpandingCollapsingEventArgs + + + + + + Gets which group is expanding/collapsing + + + + + Gets whether this event is going to expand the group. + If this is false, the group must be collapsing. + + + + + This event argument block is used when the state of group has changed (collapsed, selected) + + + + + Create a GroupStateChangedEventArgs + + + + + + + + Gets whether the group was collapsed by this event + + + + + Gets whether the group was focused by this event + + + + + Gets whether the group was selected by this event + + + + + Gets whether the group was uncollapsed by this event + + + + + Gets whether the group was unfocused by this event + + + + + Gets whether the group was unselected by this event + + + + + Gets which group had its state changed + + + + + Gets the previous state of the group + + + + + Gets the new state of the group + + + + + This event argument block is used when a branch of a tree is about to be expanded + + + + + Create a new event args + + + + + + + Gets the model that is about to expand. If null, all branches are going to be expanded. + + + + + Gets the OLVListItem that is about to be expanded + + + + + This event argument block is used when a branch of a tree has just been expanded + + + + + Create a new event args + + + + + + + Gets the model that is was expanded. If null, all branches were expanded. + + + + + Gets the OLVListItem that was expanded + + + + + This event argument block is used when a branch of a tree is about to be collapsed + + + + + Create a new event args + + + + + + + Gets the model that is about to collapse. If this is null, all models are going to collapse. + + + + + Gets the OLVListItem that is about to be collapsed. Can be null + + + + + This event argument block is used when a branch of a tree has just been collapsed + + + + + Create a new event args + + + + + + + Gets the model that is was collapsed. If null, all branches were collapsed + + + + + Gets the OLVListItem that was collapsed + + + + + This class contains all the settings used when groups are created + + + + + Create a GroupingParameters + + + + + + + + + + + + + + + Gets or sets the ObjectListView being grouped + + + + + Gets or sets the column used to create groups + + + + + In what order will the groups themselves be sorted? + + + + + If this is set, this comparer will be used to order the groups + + + + + If this is set, this comparer will be used to order items within each group + + + + + Gets or sets the column that will be the primary sort + + + + + Gets or sets the ordering for the primary sort + + + + + Gets or sets the column used for secondary sorting + + + + + Gets or sets the ordering for the secondary sort + + + + + Gets or sets the title format used for groups with zero or more than one element + + + + + Gets or sets the title format used for groups with only one element + + + + + Gets or sets whether the items should be sorted by the primary column + + + + + These values indicate what is the state of the group. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + Normal + + + + + Collapsed + + + + + Hidden + + + + + NoHeader + + + + + Can be collapsed + + + + + Has focus + + + + + Is Selected + + + + + Is subsetted + + + + + Subset link has focus + + + + + All styles + + + + + This mask indicates which members of a LVGROUP have valid data. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + No mask + + + + + Group has header + + + + + Group has footer + + + + + Group has state + + + + + + + + + + + + + + + pszSubtitle is valid + + + + + pszTask is valid + + + + + pszDescriptionTop is valid + + + + + pszDescriptionBottom is valid + + + + + iTitleImage is valid + + + + + iExtendedImage is valid + + + + + iFirstItem and cItems are valid + + + + + pszSubsetTitle is valid + + + + + readonly, cItems holds count of items in visible subset, iFirstItem is valid + + + + + This mask indicates which members of a GROUPMETRICS structure are valid + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class enhance the capabilities of a normal ListViewGroup, + enabling the functionality that was released in v6 of the common controls. + + + + In this implementation (2009-09), these objects are essentially passive. + Setting properties does not automatically change the associated group in + the listview. Collapsed and Collapsible are two exceptions to this and + give immediate results. + + + This really should be a subclass of ListViewGroup, but that class is + sealed (why is that?). So this class provides the same interface as a + ListViewGroup, plus many other new properties. + + + + + + Create an OLVGroup + + + + + 按指定标题创建分组 + + 分组标题 + + + + Gets or sets the bottom description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets whether or not this group is collapsed + + + + + Gets or sets whether or not this group can be collapsed + + + + + Gets or sets some representation of the contents of this group + + This is user defined (like Tag) + + + + Gets whether this group has been created. + + + + + Gets or sets the int or string that will select the extended image to be shown against the title + + + + + Gets or sets the footer of the group + + + + + Gets the internal id of our associated ListViewGroup. + + + + + Gets or sets the header of the group + + + + + Gets or sets the horizontal alignment of the group header + + + + + Gets or sets the internally created id of the group + + + + + Gets or sets ListViewItems that are members of this group + + Listener of the BeforeCreatingGroups event can populate this collection. + It is only used on non-virtual lists. + + + + Gets or sets the key that was used to partition objects into this group + + This is user defined (like Tag) + + + + Gets the ObjectListView that this group belongs to + + If this is null, the group has not yet been created. + + + + Gets or sets the name of the group + + As of 2009-09-01, this property is not used. + + + + Gets or sets whether this group is focused + + + + + Gets or sets whether this group is selected + + + + + Gets or sets the text that will show that this group is subsetted + + + As of WinSDK v7.0, subsetting of group is officially unimplemented. + We can get around this using undocumented interfaces and may do so. + + + + + Gets or set the subtitleof the task + + + + + Gets or sets the value by which this group will be sorted. + + + + + Gets or sets the state of the group + + + + + Gets or sets which bits of State are valid + + + + + Gets or sets whether this group is showing only a subset of its elements + + + As of WinSDK v7.0, this property officially does nothing. + + + + + Gets or sets the user-defined data attached to this group + + + + + Gets or sets the task of this group + + This task is the clickable text that appears on the right margin + of the group header. + + + + Gets or sets the int or string that will select the image to be shown against the title + + + + + Gets or sets the top description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets the number of items that are within this group. + + This should only be used for virtual groups. + + + + Gets or sets the ListViewGroup that is shadowed by this group. + + For virtual groups, this will always be null. + + + + Calculate the index into the group image list of the given image selector + + + + + + + Convert this object to a string representation + + + + + + Insert a native group into the underlying Windows control, + *without* using a ListViewGroup + + + This is used when creating virtual groups + + + + Insert a native group into the underlying control via a ListViewGroup + + + + + + Change the members of the group to match the current contents of Items, + using a ListViewGroup + + + + + Create a native LVGROUP structure that matches this group + + + + + Get the current state of this group from the underlying control + + + + + Get the current state of this group from the underlying control + + + + + An instance of Munger gets a value from or puts a value into a target object. The property + to be peeked (or poked) is determined from a string. The peeking or poking is done using reflection. + + + Name of the aspect to be peeked can be a field, property or parameterless method. The name of an + aspect to poke can be a field, writable property or single parameter method. + + Aspect names can be dotted to chain a series of references. + + Order.Customer.HomeAddress.State + + + + + Create a do nothing Munger + + + + + Create a Munger that works on the given aspect name + + The name of the + + + + A helper method to put the given value into the given aspect of the given object. + + This method catches and silently ignores any errors that occur + while modifying the target object + The object to be modified + The name of the property/field to be modified + The value to be assigned + Did the modification work? + + + + Gets or sets whether Mungers will silently ignore missing aspect errors. + + + + By default, if a Munger is asked to fetch a field/property/method + that does not exist from a model, it returns an error message, since that + condition is normally a programming error. There are some use cases where + this is not an error, and the munger should simply keep quiet. + + By default this is true during release builds. + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or parameter-less method. + + + The name can be dotted, which chains references. If any link in the chain returns + null, the entire chain is considered to return null. + + + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + Extract the value indicated by our AspectName from the given target. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Extract the value indicated by our AspectName from the given target, raising exceptions + if the munger fails. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Poke the given value into the given target indicated by our AspectName. + + + + If the AspectName is a dotted path, all the selectors bar the last + are used to find the object that should be updated, and the last + selector is used as the property to update on that object. + + + So, if 'target' is a Person and the AspectName is "HomeAddress.Postcode", + this method will first fetch "HomeAddress" property, and then try to set the + "Postcode" property on the home address object. + + + The object that will be poked + The value that will be poked into the target + bool indicating whether the put worked + + + + Gets the list of SimpleMungers that match our AspectName + + + + + Convert a possibly dotted AspectName into a list of SimpleMungers + + + + + + + Evaluate the given chain of SimpleMungers against an initial target. + + + + + + + + A SimpleMunger deals with a single property/field/method on its target. + + + Munger uses a chain of these resolve a dotted aspect name. + + + + + Create a SimpleMunger + + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or method. + When using a method to get a value, the method must be parameter-less. + When using a method to set a value, the method must accept 1 parameter. + + + It cannot be a dotted name. + + + + + + Get a value from the given target + + + + + + + Poke the given value into the given target indicated by our AspectName. + + The object that will be poked + The value that will be poked into the target + bool indicating if the put worked + + + + These exceptions are raised when a munger finds something it cannot process + + + + + Create a MungerException + + + + + + + + Get the munger that raised the exception + + + + + Gets the target that threw the exception + + + + + Wrapper for all native method calls on ListView controls + + + + + Put an image under the ListView. + + + + The ListView must have its handle created before calling this. + + + This doesn't work very well. Specifically, it doesn't play well with owner drawn, + and grid lines are drawn over it. + + + + The image to be used as the background. If this is null, any existing background image will be cleared. + If this is true, the image is pinned to the bottom right and does not scroll. The other parameters are ignored + If this is true, the image will be tiled to fill the whole control background. The offset parameters will be ignored. + If both watermark and tiled are false, this indicates the horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + If both watermark and tiled are false, this indicates the vertical percentage where the image will be placed. + + + + + Flags controlling how the Image List item is + drawn + + + + + Draw item normally. + + + + + Draw item transparently. + + + + + Draw item blended with 25% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw item blended with 50% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw the icon's mask + + + + + Draw the icon image without using the mask + + + + + Draw the icon using the ROP specified. + + + + + Preserves the alpha channel in dest. XP only. + + + + + Scale the image to cx, cy instead of clipping it. XP only. + + + + + Scale the image to the current DPI of the display. XP only. + + + + + Enumeration containing XP ImageList Draw State options + + + + + The image state is not modified. + + + + + Adds a glow effect to the icon, which causes the icon to appear to glow + with a given color around the edges. (Note: does not appear to be implemented) + + + + + Adds a drop shadow effect to the icon. (Note: does not appear to be implemented) + + + + + Saturates the icon by increasing each color component + of the RGB triplet for each pixel in the icon. (Note: only ever appears to result in a completely unsaturated icon) + + + + + Alpha blends the icon. Alpha blending controls the transparency + level of an icon, according to the value of its alpha channel. + (Note: does not appear to be implemented). + + + + + Draws an image using the specified flags and state on XP systems. + + The image list from which an item will be drawn + Device context to draw to + Index of image to draw + X Position to draw at + Y Position to draw at + Drawing flags + Width to draw + Height to draw + State flags + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + Change the virtual list size of the given ListView (which must be in virtual mode) + + This will not change the scroll position + The listview to send a message to + How many rows should the list have? + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + + + Calculates the number of items that can fit vertically in the visible area of a list-view (which + must be in details or list view. + + The listView + Number of visible items per page + + + + For the given item and subitem, make it display the given image + + The listview to send a m to + row number (0 based) + subitem (0 is the item itself) + index into the image list + + + + Setup the given column of the listview to show the given image to the right of the text. + If the image index is -1, any previous image is cleared + + The listview to send a m to + Index of the column to modifiy + + Index into the small image list + + + + Does this version of the operating system have builtin sort indicators? + + Are there builtin sort indicators + XP and later have these + + + + Return the bounds of the update region on the given control. + + The BeginPaint() system call validates the update region, effectively wiping out this information. + So this call has to be made before the BeginPaint() call. + The control whose update region is be calculated + A rectangle + + + + Validate an area of the given control. A validated area will not be repainted at the next redraw. + + The control to be validated + The area of the control to be validated + + + + Select all rows on the given listview + + The listview whose items are to be selected + + + + Deselect all rows on the given listview + + The listview whose items are to be deselected + + + + Deselect a single row + + + + + + + Set the item state on the given item + + The listview whose item's state is to be changed + The index of the item to be changed + Which bits of the value are to be set? + The value to be set + + + + Scroll the given listview by the given deltas + + + + + true if the scroll succeeded + + + + Return the handle to the header control on the given list + + The listview whose header control is to be returned + The handle to the header control + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the index of the column of the header that is under the given point. + Return -1 if no column is under the pt + + The list we are interested in + The client co-ords + The index of the column under the point, or -1 if no column header is under that point + + + + Return the index of the divider under the given point. Return -1 if no divider is under the pt + + The list we are interested in + The client co-ords + The index of the divider under the point, or -1 if no divider is under that point + + + + Get the scroll position of the given scroll bar + + + + + + + + Change the z-order to the window 'toBeMoved' so it appear directly on top of 'reference' + + + + + + + + Make the given control/window a topmost window + + + + + + + Change the size of the window without affecting any other attributes + + + + + + + + + Show the given window without activating it + + The window to show + + + + Mark the given column as being selected. + + + The OLVColumn or null to clear + + This method works, but it prevents subitems in the given column from having + back colors. + + + + + A simple-minded implementation of a Dictionary that can handle null as a key. + + The type of the dictionary key + The type of the values to be stored + This is not a full implementation and is only meant to handle + collecting groups by their keys, since groups can have null as a key value. + + + + OLVListItems are specialized ListViewItems that know which row object they came from, + and the row index at which they are displayed, even when in group view mode. They + also know the image they should draw against themselves + + + + + Create a OLVListItem for the given row object + + + + + Create a OLVListItem for the given row object, represented by the given string and image + + + + + Gets the bounding rectangle of the item, including all subitems + + + + + Gets or sets how many pixels will be left blank around each cell of this item + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how the cells of this item will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the checkedness of this item. + + + Virtual lists don't handle checkboxes well, so we have to intercept attempts to change them + through the items, and change them into something that will work. + Unfortunately, this won't work if this property is set through the base class, since + the property is not declared as virtual. + + + + + Enable tri-state checkbox. + + .NET's Checked property was not built to handle tri-state checkboxes, + and will return True for both Checked and Indeterminate states. + + + + Gets if this item has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Gets whether or not this row can be selected and activated + + + + + Gets whether any cell on this item is showing a hyperlink + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the the model object that is source of the data for this list item. + + + + + Gets or sets the color that will be used for this row's background when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection BackColor will be used. + + + + + + Gets or sets the color that will be used for this row's foreground when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection ForeColor will be used. + + + + + + Return the sub item at the given index + + Index of the subitem to be returned + An OLVListSubItem + + + + Return bounds of the given subitem + + This correctly calculates the bounds even for column 0. + + + + A ListViewSubItem that knows which image should be drawn against it. + + + + + Create a OLVListSubItem + + + + + Create a OLVListSubItem that shows the given string and image + + + + + Gets or sets how many pixels will be left blank around this cell + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how this cell will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the model value is being displayed by this subitem. + + + + + Gets if this subitem has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the url that should be invoked when this subitem is clicked + + + + + Gets or sets whether this cell is selected + + + + + Return the state of the animatation of the image on this subitem. + Null means there is either no image, or it is not an animation + + + + + An indication of where a hit was within ObjectListView cell + + + + + Nowhere + + + + + On the text + + + + + On the image + + + + + On the checkbox + + + + + On the expand button (TreeListView) + + + + + in a button (cell must have ButtonRenderer) + + + + + in the cell but not in any more specific location + + + + + UserDefined location1 (used for custom renderers) + + + + + On the expand/collapse widget of the group + + + + + Somewhere on a group + + + + + Somewhere in a column header + + + + + Somewhere in a column header checkbox + + + + + Somewhere in a header divider + + + + + A collection of ListViewHitTest constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class encapsulate the information gathered during a OlvHitTest() + operation. + + Custom renderers can use HitTestLocation.UserDefined and the UserData + object to store more specific locations for use during event handlers. + + + + Create a OlvListViewHitTestInfo + + + + + Create a OlvListViewHitTestInfo when the header was hit + + + + + Where is the hit location? + + + + + Where is the hit location? + + + + + Which group was hit? + + + + + Custom renderers can use this information to supply more details about the hit location + + + + + Gets the item that was hit + + + + + Gets the subitem that was hit + + + + + Gets the part of the subitem that was hit + + + + + Gets the ObjectListView that was tested + + + + + Gets the model object that was hit + + + + + Gets the index of the row under the hit point or -1 + + + + + Gets the index of the column under the hit point + + + + + Gets the index of the header divider + + + + + Gets the column that was hit + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + A TreeDataSourceAdapter knows how to build a tree structure from a binding list. + + To build a tree + + + + Create a data source adaptor that knows how to build a tree structure + + + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets the DataTreeListView that is being managed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A IVirtualGroups is the interface that a virtual list must implement to support virtual groups + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + This is a safe, do nothing implementation of a grouping strategy + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + Provides grouping functionality to a FastObjectListView + + + + + Create groups for FastListView + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This is the COM interface that a ListView must be given in order for groups in virtual lists to work. + + + This interface is NOT documented by MS. It was found on Greg Chapell's site. This means that there is + no guarantee that it will work on future versions of Windows, nor continue to work on current ones. + + + + + Not sure what this does + + + + + + + Not sure what this does + + + + + + + Get the index of the item that occurs at the n'th position of the indicated group. + + Index of the group + Index within the group + Index of the item within the whole list + + + + Get the index of the group to which the given item belongs + + Index of the item within the whole list + Which occurences of the item is wanted + Index of the group + + + + Get the number of groups that contain the given item + + Index of the item within the whole list + How many groups does it occur within + + + + A hint to prepare any cache for the given range of requests + + + + + + + A default implementation of the IOwnerDataCallback interface + + + + + A VirtualListDataSource is a complete manner to provide functionality to a virtual list. + An object that implements this interface provides a VirtualObjectListView with all the + information it needs to be fully functional. + + Implementors must provide functioning implementations of at least GetObjectCount() + and GetNthObject(), otherwise nothing will appear in the list. + + + + Return the object that should be displayed at the n'th row. + + The index of the row whose object is to be returned. + The model object at the n'th row, or null if the fetching was unsuccessful. + + + + Return the number of rows that should be visible in the virtual list + + The number of rows the list view should have. + + + + Get the index of the row that is showing the given model object + + The model object sought + The index of the row showing the model, or -1 if the object could not be found. + + + + The ListView is about to request the given range of items. Do + whatever caching seems appropriate. + + + + + + + Find the first row that "matches" the given text in the given range. + + The text typed by the user + Start searching from this index. This may be greater than the 'to' parameter, + in which case the search should descend + Do not search beyond this index. This may be less than the 'from' parameter. + The column that should be considered when looking for a match. + Return the index of row that was matched, or -1 if no match was found + + + + Sort the model objects in the data source. + + + + + + + Add the given collection of model objects to this control. + + A collection of model objects + + + + Insert the given collection of model objects to this control at the position + + Index where the collection will be added + A collection of model objects + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + + + Set the collection of objects that this control will show. + + + + + + Update/replace the nth object with the given object + + + + + + + This extension allow virtual lists to filter their contents + + + + + All subsequent retrievals on this data source should be filtered + through the given filters. null means no filtering of that kind. + + + + + + + A do-nothing implementation of the VirtualListDataSource interface. + + + + + Creates an AbstractVirtualListDataSource + + + + + + The list view that this data source is giving information to. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + This is a useful default implementation of SearchText method, intended to be called + by implementors of IVirtualListDataSource. + + + + + + + + + + + + + + + + + + This class mimics the behavior of VirtualObjectListView v1.x. + + + + + Creates a VirtualListVersion1DataSource + + + + + + How will the n'th object of the data source be fetched? + + + + + + + + + + + + + + + + + + + + + + Designer for and its subclasses. + + + + This designer removes properties and events that are available on ListView but that are not + useful on ObjectListView. + + + We can't inherit from System.Windows.Forms.Design.ListViewDesigner, since it is marked internal. + So, this class uses reflection to create a ListViewDesigner and then forwards messages to that designer. + + + + + + Initializes the designer with the specified component. + + The to associate the designer with. This component must always be an instance of, or derive from, . + + + + Initializes a newly created component. + + A name/value dictionary of default values to apply to properties. May be null if no default values are specified. + + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Removes the duplicate DockingActionList added by this designer to the . + + + adds an internal DockingActionList : 'Dock/Undock in Parent Container'. + But the default designer has already added that action list. So we need to remove one. + + + + + Adjusts the set of properties the component exposes through a . + + An containing the properties for the class of the component. + + + + Allows a designer to add to the set of events that it exposes through a . + + The events for the class of the component. + + + + Allows a designer to change or remove items from the set of attributes that it exposes through a . + + The attributes for the class of the component. + + + + Allows a designer to change or remove items from the set of events that it exposes through a . + + The events for the class of the component. + + + + Gets the design-time action lists supported by the component associated with the designer. + + + The design-time action lists supported by the component associated with the designer. + + + + + Gets the collection of components associated with the component managed by the designer. + + + The components that are associated with the component managed by the designer. + + + + + Indicates whether a mouse click at the specified point should be handled by the control. + + + true if a click at the specified point is to be handled by the control; otherwise, false. + + A indicating the position at which the mouse was clicked, in screen coordinates. + + + + Processes Windows messages and optionally routes them to the control. + + The to process. + + + + This class modifies a ListViewActionList, by removing the "Edit Items" and "Edit Groups" actions. + + + + That class is internal, so we cannot simply subclass it, which would be simplier. + + + Action lists use reflection to determine if that action can be executed, so we not + only have to modify the returned collection of actions, but we have to implement + the properties and commands that the returned actions use. + + + + + This class works in conjunction with the OLVColumns property to allow OLVColumns + to be added to the ObjectListView. + + + + + Create a OLVColumnCollectionEditor + + + + + + What type of object does this editor create? + + + + + + Edit a given value + + + + + + + + + What text should be shown in the list for the given object? + + + + + + + Control how the overlay is presented in the IDE + + + + + An OLVColumn knows which aspect of an object it should present. + + + The column knows how to: + + extract its aspect from the row object + convert an aspect to a string + calculate the image for the row object + extract a group "key" from the row object + convert a group "key" into a title for the group + + For sorting to work correctly, aspects from the same column + must be of the same type, that is, the same aspect cannot sometimes + return strings and other times integers. + + + + + How should the button be sized? + + + + + 每个单元格都将具有相同大小的按钮，如ButtonSize属性所示 + + + + + 每个单元格都将绘制一个填充单元格的按钮，该按钮由ButtonPadding插入 + + + + + 将调整每个按钮的大小以包含文本内容 + + + + + Create an OLVColumn + + + + + Initialize a column to have the given title, and show the given aspect + + The title of the column + The aspect to be shown in the column + + + + 此委托将用于提取要在此列中显示的值。 + + + 如果设置, AspectName属性将被忽略. + + + + + 请记住，如果当前列的AspectGetter是内部生成的，依旧可以随意重新生成 + + + + + 应调用以获取要在此列中显示的值的属性或方法的名称。 + 仅当未指定ValueGetterDelegate时才使用此选项。 + + 此名称可以用来表示对属性或无参数方法的链引用。 + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + 此委托将用于将编辑后的值放回模型对象中。 + + + 如果IsEdable==false，则不执行任何操作。 + + + + + 用于将要在此列中显示的Aspect转换为字符串的委托。 + + 如果设置了此值，AspectToStringFormat将被忽略。 + + + + 将Aspect转换成字符串的格式文本 + + + 此字符串作为第一个参数传递给String.Format()方法。 + 仅当尚未设置AspectToStringConverter时才使用此选项。 + "{0:C}" 表示转换数字到货币 + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取用户操作是否可以隐藏此列 + + 这会同时考虑Hideable属性以及此列是否为列表视图的主列(列0)。 + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + + + 如果控件不是所有者绘制(owner drawn)的，则始终将其视为true。 + + 如果该值为False(默认值)并且控件是所有者绘制(owner drawn)的， + ObjectListView将尝试计算单元格实际内容的宽度，然后将编辑控件的大小调整为恰到好处的宽度。 + 如果为真，则无论单元格的内容如何，都将使用单元格的整个宽度。 + + 如果未在列上设置此属性，则将使用控件中的值 + + 仅当控件处于详细信息视图中时才使用此值。 + 无论此设置如何，开发人员都可以通过侦听CellEditStarting事件来指定编辑控件的确切大小。 + + + + + 获取编辑此列中的单元格时是否应使用整个单元格 + + 这将计算当前有效值，该值可能与CellEditUseWholeCell不同 + + + + 获取或设置此列中此单元格周围将留空的像素数 + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + + 获取或设置此列中的单元格垂直对齐的方式。 + + + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + 如果未设置，将使用控件本身的值。 + + + + + + 获取或设置此列是否显示复选框。 + + + 在第0列上设置此选项不起作用。列0复选框由ObjectListView本身的CheckBox属性控制。 + + + + + Gets or sets the clustering strategy used for this column. + + + + The clustering strategy is used to build a Filtering menu for this item. + If this is null, a useful default will be chosen. + + + To disable filtering on this colummn, set UseFiltering to false. + + + Cluster strategies belong to a particular column. The same instance + cannot be shared between multiple columns. + + + + + + 获取或设置是否启用此列中的按钮(如果此列是按钮)，即使该行本身被禁用 + + + + + 此列是否应该调整大小以填充列表视图中的空闲空间？ + + + + 如果希望两列(或更多列)平均共享可用空间，请将此属性设置为True。 + 如果希望此列具有更大或更小的可用空间份额，则必须显式设置FreeSpaceProportion属性。 + + + 空间填充列仍然由MinimumWidth和MaximumWidth属性控制。 + + /// + + + + 控件中未占用的水平空间应分配给此列的比例是多少？ + + + + 在某些情况下，如果列(通常是最右边的列)可以随着列表视图的扩展而扩展， + 这样就可以在不必水平滚动的情况下尽可能多地看到列(您永远不应该让用户必须水平滚动任何内容！)。 + + + 调整空间填充列的大小以占据列表视图的未占用宽度的一部分(未占用宽度是一旦所有非填充列都被赋予其空间后剩余的宽度)。 + 此属性指示将分配给此列的未占用空间的相对比例。此属性的实际值并不重要，重要的是它的值相对于其他列中的值。 + 例子: + + + 如果只有一个空间填充列，则无论FreeSpaceProportion中的值如何，都将为其提供所有可用空间。 + + + 如果有两个或多个空间填充列，并且它们的FreeSpaceProportion值都相同，则它们将平等地共享空闲空间。 + + + 如果FreeSpaceProportion有三个值为3、2和1的空间填充列，则第一列将占用一半的空闲空间，第二列将占用三分之一的空闲空间，第三列将占用六分之一的空闲空间。 + + + + + + + + 获取或设置在单击此列的标题时是否对此列值重新生成组。 + + + 此设置仅在ShowGroups为true时使用。 + + 如果为False，则单击标题不会重建组。 + + 如果为false，则仍会激发BeforeCreatingGroups事件，这些事件可用于根据具体情况进行分组或提供反馈。 + + + + + 当组已创建但尚未成为真正的ListViewGroup时，将调用此委托。用户可以利用此机会填写有关该组的许多其他详细信息。 + + + + + 调用此委托以获取对象，该对象是给定行所属的组的键。 + + + + + 调用此委托将组键转换为该组的标题。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，应如何设置标签的格式 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 + + + "{0} [{1} items]" + + + + 获取this.GroupWithItemCountFormat或默认值 + + + 如果未设置GroupWithItemCountFormat，则如果可能，将从ObjectListView中获取其值。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，如果组中只有一个项目，标签应该如何格式化 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 (始终为1) + + + "{0} [{1} item]" + + + + 获取this.GroupWithItemCountSingularFormat或默认值 + + + 如果未设置此值，将使用列表视图中的值 + + + + + 获取是否应在列标题中使用筛选器指示符绘制此列。 + + + + + 获取或设置将用于所有者绘制标题列的委托。 + + + + + 获取或设置将用于绘制此列标题的样式 + + 仅当拥有的ObjectListView将HeaderUsesThemes设置为False时才使用此选项。 + + + + 获取或设置绘制此列的标题时使用的字体 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置绘制此列标题文本的颜色 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置将在列标题中显示的图像键 + + 这仅在HeaderUsesThemes为false时使用 + + + + 获取或设置Header文本的对齐方式 + + + + + 返回Header的文本对齐方式。这将是显式设置的，或者将遵循列中文本的对齐方式 + + + + + 获取转换为StringAlignment的Header对齐方式 + + + + + 获取此列的标题中是否有图像 + + + + + 获取或设置此Header是否在Header中放置复选框 + + + + + 获取或设置此Header是否在Header中放置三态复选框 + + + + + 获取或设置此列Header中复选框的选中状态 + + + + + 获取或设置选中/取消选中标题复选框的值是否会导致将此列中所有单元格的复选框设置为相同的选中/取消选中。 + 默认值为true. + + + + 当单元格的复选框状态改变时，该函数不会与自动更新标题的功能相反。 + + + 此属性在TreeListView上的行为最好描述为未定义，应该避免。 + + + 此操作(检查/取消检查所有行)的性能为O(n)，其中n是行数。它将在大型虚拟列表上工作，但可能需要一些时间。 + + + + + + 获取或设置是否禁用标题中的复选框 + + + 单击禁用的复选框不会更改其值，但会引发HeaderCheckBoxChanging事件，使程序员有机会执行适当的操作。 + + + + 获取或设置用户是否可以隐藏此列。 + + + 无论此设置如何，列0永远不能隐藏。 + + + + + 获取或设置此列中的文本值是否类似于超链接 + + + + + 这是属性的名称，将调用该属性来获取应该在此列中显示的图像的图像选择器。 + 它可以返回int、String、Image或NULL。 + + + 如果ImageGetter不为空，则忽略此项。 + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 调用此委托以获取应该在此列中显示的图像的图像选择器。它可以返回int、String、Image或NULL。 + + + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 获取或设置此列是否在其单元格中绘制按钮 + + + + 如果将其设置为true，则列的呈现器将成为ColumnButtonRenender(如果尚未成为ColumnButtonRenender)。如果设置为False，则将丢弃以前的任何按钮渲染器 + + 如果单元格的Aspect为Null或空，则不会在单元格中绘制任何内容。 + + + + Create a ColumnButtonRenderer to draw buttons in this column + + + + + + Fill in details to our ColumnButtonRenderer based on the properties set on the column + + + + + 获取或设置按钮可以占用的最大宽度。 + -1 表示不限制最大宽度 + + 仅当SizingMode为TextBound时才生效 + + + + 获取或设置当SizingMode为TextBound时单元格周围的额外空间 + + + + + 获取或设置SizingMode为FixedBound时按钮的大小 + + 如果未设置，将使用单元格的边界 + + + + 获取或设置此列显示按钮时如何调整每个按钮的大小 + + + + + 此列中显示的值是否可以编辑 + + 此默认值为false，因为控制列表视图的可编辑性的主要方法是列表视图本身。 + 列表视图可编辑后，所有列也可编辑，除非程序员显式将它们标记为不可编辑 + + + + 是否是固定宽度 + + + + + 获取/设置当视图切换到平铺视图(TileView)时是否使用此列。 + + 无论此设置如何，第0列始终包含在平铺视图中。平铺视图不能很好地处理许多“列”信息。两三个最好。 + + + + 获取或设置Header的文本是否应垂直呈现。 + + + 如果为True，最好将ToolTipText设置为列的名称，以便于阅读。 + 垂直Header仅为文本。他们不会画出图像。 + + + + + 该列是否可见 + + 更改此值后，必须调用RebuildColumns()才能使更改生效。 + + + + 此列最后一次定位在详细信息视图列中的位置是什么 + + DisplayIndex是易失性的。一旦从控件中移除列，就无法发现它在显示顺序中的位置。 + 即使列不在列表视图的活动列中，此属性也会保护该信息。 + + + + 列最大宽度 + + -1表示不限制. 将该值指定为与MinimumWidth相同的值，以生成固定宽度的列。 + + + + 列最小宽度 + + -1表示不限制. 将该值指定为与MaximumWidth相同的值，以生成固定宽度的列。 + + + + Get/set the renderer that will be invoked when a cell needs to be redrawn + + + + + This delegate is called when a cell needs to be drawn in OwnerDrawn mode. + + This method is kept primarily for backwards compatibility. + New code should implement an IRenderer, though this property will be maintained. + + + + 获取或设置执行文本搜索时是否使用此列的单元格中的文本。 + + + + 如果为False，则文本筛选器在查找匹配项时不会尝试搜索此列单元格。 + + + + + + 获取或设置一个委托，该委托将返回在使用基于文本的筛选器时应考虑进行文本匹配的文本值数组。 + + + + + 获取或设置此列的标题是否将包括该列的文本。 + + + + 如果为false，则列标题中呈现的唯一内容将是来自 . + + 只有在以下情况下才会考虑此设置: ObjectListView中的 为false . + + + + + 获取或设置当用户单击此列的标题时是否重新排序列表内容。 + + + + 如果为False，则单击标题将不会对列表进行排序，但也不会提供有关列表未排序原因的任何反馈。提供适当的反馈是程序员的责任。 + + 如果为false，则仍会触发BeforeSorting事件，该事件可用于根据具体情况进行排序或提供反馈。 + + + + + 获取或设置列内容的水平对齐方式。 + + NET将不允许列0具有除左对齐以外的任何对齐方式。我们不能更改列表视图的基本行为，但当所有者绘制时，列0现在可以有其他对齐方式。 + + + + 获取列文本对齐的StringAlignment等效项 + + + + + 当鼠标悬停在该列的标题上时，应该显示什么字符串？ + + 如果拥有的ObjectListView上安装了HeaderToolTipGetter，则将忽略此值。 + + + + 此列是否应该有一个三态复选框 + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + + + + + 按列纵横比的首字母对对象进行分组 + + + 一种常见的模式是按该组的值的首字母对列进行分组。aspect必须是字符串(显然)。 + + + + + 获取或设置此列是否应为用户可筛选的列 + + + + + Gets or sets a filter that will only include models where the model's value + for this column is one of the values in ValuesChosenForFiltering + + + + + Gets or sets the values that will be used to generate a filter for this + column. For a model to be included by the generated filter, its value for this column + must be in this list. If the list is null or empty, this column will + not be used for filtering. + + + + + 列宽 + + + + + 获取或设置此列单元格的内容是否应自动换行 + + 如果此列使用自定义IRenender(即，不是从BaseRenender派生的)，则该呈现器负责实现自动换行。 + + + + For a given group value, return the string that should be used as the groups title. + + The group key that is being converted to a title + string + + + + Get the checkedness of the given object for this column + + The row object that is being displayed + The checkedness of the object + + + + Put the checkedness of the given object for this column + + The row object that is being displayed + + The checkedness of the object + + + + For a given row object, extract the value indicated by the AspectName property of this column. + + The row object that is being displayed + An object, which is the aspect named by AspectName + + + + For a given row object, return the object that is the key of the group that this row belongs to. + + The row object that is being displayed + Group key object + + + + For a given row object, return the image selector of the image that should displayed in this column. + + The row object that is being displayed + int or string or Image. int or string will be used as index into image list. null or -1 means no image + + + + Return the image that represents the check box for the given model + + + + + + + For a given row object, return the strings that will be searched when trying to filter by string. + + + This will normally be the simple GetStringValue result, but if this column is non-textual (e.g. image) + you might want to install a SearchValueGetter delegate which can return something that could be used + for text filtering. + + + The array of texts to be searched. If this returns null, search will not match that object. + + + + For a given row object, return the string representation of the value shown in this column. + + + For aspects that are string (e.g. aPerson.Name), the aspect and its string representation are the same. + For non-strings (e.g. aPerson.DateOfBirth), the string representation is very different. + + + + + + + For a given row object, return the object that is to be displayed in this column. + + The row object that is being displayed + An object, which is the aspect to be displayed + + + + Update the given model object with the given value using the column's + AspectName. + + The model object to be updated + The value to be put into the model + + + + Update the given model object with the given value + + The model object to be updated + The value to be put into the model + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Decide the clustering strategy that will be used for this column + + + + + + Gets or sets the type of data shown in this column. + + If this is not set, it will try to get the type + by looking through the rows of the listview. + + + + This event is triggered when the visibility of this column changes. + + + + + Tell the world when visibility of a column changes. + + + + + Create groupies + This is an untyped version to help with Generator and OLVColumn attributes + + + + + + + Create groupies + + + + + + + + Create groupies + + + + + + + + + Create groupies + + + + + + + + + + Create groupies. + Install delegates that will group the columns aspects into progressive partitions. + If an aspect is less than value[n], it will be grouped with description[n]. + If an aspect has a value greater than the last element in "values", it will be grouped + with the last element in "descriptions". + + Array of values. Values must be able to be + compared to the aspect (using IComparable) + The description for the matching value. The last element is the default description. + If there are n values, there must be n+1 descriptions. + + this.salaryColumn.MakeGroupies( + new UInt32[] { 20000, 100000 }, + new string[] { "Lowly worker", "Middle management", "Rarified elevation"}); + + + + + + + + + Create groupies based on exact value matches. + + + Install delegates that will group rows into partitions based on equality of this columns aspects. + If an aspect is equal to value[n], it will be grouped with description[n]. + If an aspect is not equal to any value, it will be grouped with "[other]". + + Array of values. Values must be able to be + equated to the aspect + The description for the matching value. + + this.marriedColumn.MakeEqualGroupies( + new MaritalStatus[] { MaritalStatus.Single, MaritalStatus.Married, MaritalStatus.Divorced, MaritalStatus.Partnered }, + new string[] { "Looking", "Content", "Looking again", "Mostly content" }); + + + + + + + + + An adorment is the common base for overlays and decorations. + + + + + Gets or sets the corner of the adornment that will be positioned at the reference corner + + + + + Gets or sets location within the reference rectange where the adornment will be drawn + + This is a simplied interface to ReferenceCorner and AdornmentCorner + + + + Gets or sets the offset by which the position of the adornment will be adjusted + + + + + Gets or sets the point of the reference rectangle to which the adornment will be aligned. + + + + + Gets or sets the degree of rotation by which the adornment will be transformed. + The centre of rotation will be the center point of the adornment. + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + Calculate the location of rectangle of the given size, + so that it's indicated corner would be at the given point. + + The point + + Which corner will be positioned at the reference point + + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.TopLeft) -> Point(50, 100) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.MiddleCenter) -> Point(45, 90) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.BottomRight) -> Point(40, 80) + + + + Calculate a rectangle that has the given size which is positioned so that + its alignment point is at the reference location of the given rect. + + + + + + + + Create a rectangle of the given size which is positioned so that + its indicated corner is at the indicated corner of the reference rect. + + + + + + + + + Creates a rectangle so that its bottom left is at the centre of the reference: + corner=BottomLeft, referenceCorner=MiddleCenter + This is a powerful concept that takes some getting used to, but is + very neat once you understand it. + + + + + Return the point at the indicated corner of the given rectangle (it doesn't + have to be a corner, but a named location) + + The reference rectangle + Which point of the rectangle should be returned? + A point + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.TopLeft) -> Point(0, 0) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.MiddleCenter) -> Point(25, 50) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.BottomRight) -> Point(50, 100) + + + + Given the item and the subitem, calculate its bounds. + + + + + + + + Apply any specified rotation to the Graphic content. + + The Graphics to be transformed + The rotation will be around the centre of this rect + + + + Reverse the rotation created by ApplyRotation() + + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Gets or sets the image that will be drawn + + + + + Gets or sets if the image will be shrunk to fit with its horizontal bounds + + + + + Draw the image in its specified location + + The Graphics used for drawing + The bounds of the rendering + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How big should the image be? + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location, scaled so that it is not wider + than the given rectangle. Height is scaled proportional to the width. + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Utility to draw a bitmap transparenly. + + + + + + + + + An adornment that will draw text + + + + + Gets or sets the background color of the text + Set this to Color.Empty to not draw a background + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the border around the billboard. + Set this to Color.Empty to remove the border + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the width of the border around the text + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the font that will be used to draw the text + + + + + Gets the font that will be used to draw the text or a reasonable default + + + + + Does this text have a background? + + + + + Does this overlay have a border? + + + + + Gets or sets the maximum width of the text. Text longer than this will wrap. + 0 means no maximum. + + + + + Gets or sets the formatting that should be used on the text + + + + + Gets or sets the text that will be drawn + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the text + + + + + Gets or sets whether the text will wrap when it exceeds its bounds + + + + + Draw our text with our stored configuration in relation to the given + reference rectangle + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + + + + Draw the given text with our stored configuration + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + The text to draw + How opaque should be text be + + + + Draw the text with a border + + The Graphics used for drawing + The bounds within which the text should be drawn + The text to draw + How opaque should be text be + + + + Return the rectangle that will be the precise bounds of the displayed text + + + + + The bounds of the text + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectagle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + A decoration is an overlay that draws itself in relation to a given row or cell. + Decorations scroll when the listview scrolls. + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + An AbstractDecoration is a safe do-nothing implementation of the IDecoration interface + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + Gets the bounds of the decorations row + + + + + Get the bounds of the decorations cell + + + + + Draw the decoration + + + + + + + + This decoration draws a slight tint over a column of the + owning listview. If no column is explicitly set, the selected + column in the listview will be used. + The selected column is normally the sort column, but does not have to be. + + + + + Create a TintedColumnDecoration + + + + + Create a TintedColumnDecoration + + + + + + Gets or sets the column that will be tinted + + + + + Gets or sets the color that will be 'tinted' over the selected column + + + + + Draw a slight colouring over our tinted column + + + This overlay only works when: + - the list is in Details view + - there is at least one row + - there is a selected column (or a specified tint column) + + + + + + + + This decoration draws an optionally filled border around a rectangle. + Subclasses must override CalculateBounds(). + + + + + Create a BorderDecoration + + + + + Create a BorderDecoration + + The pen used to draw the border + + + + Create a BorderDecoration + + The pen used to draw the border + The brush used to fill the rectangle + + + + Gets or sets the pen that will be used to draw the border + + + + + Gets or sets the padding that will be added to the bounds of the item + before drawing the border and fill. + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the brush that will be used to fill the border + + This value is ignored when using gradient brush + + + + Gets or sets the color that will be used as the start of a gradient fill. + + This and FillGradientTo must be given value to show a gradient + + + + Gets or sets the color that will be used as the end of a gradient fill. + + This and FillGradientFrom must be given value to show a gradient + + + + Gets or sets the fill mode that will be used for the gradient. + + + + + Draw a filled border + + + + + + + + Subclasses should override this to say where the border should be drawn + + + + + + Do the actual work of drawing the filled border + + + + + + + Create a GraphicsPath that represents a round cornered rectangle. + + + If this is 0 or less, the rectangle will not be rounded. + + + + + Instances of this class draw a border around the decorated row + + + + + Gets or sets the index of the left most column to be used for the border + + + + + Gets or sets the index of the right most column to be used for the border + + + + + Calculate the boundaries of the border + + + + + + Instances of this class draw a border around the decorated subitem. + + + + + Calculate the boundaries of the border + + + + + + This decoration puts a border around the cell being edited and + optionally "lightboxes" the cell (makes the rest of the control dark). + + + + + Create a EditingCellBorderDecoration + + + + + Create a EditingCellBorderDecoration + + Should the decoration use a lighbox display style? + + + + Gets or set whether the decoration should make the rest of + the control dark when a cell is being edited + + If this is true, FillBrush is used to overpaint + the control. + + + + Draw the decoration + + + + + + + + This decoration causes everything *except* the row under the mouse to be overpainted + with a tint, making the row under the mouse stand out in comparison. + The darker and more opaque the fill color, the more obvious the + decorated row becomes. + + + + + Create a LightBoxDecoration + + + + + Draw a tint over everything in the ObjectListView except the + row under the mouse. + + + + + + + + Instances of this class put an Image over the row/cell that it is decorating + + + + + Create an image decoration + + + + + Create an image decoration + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Instances of this class draw some text over the row/cell that they are decorating + + + + + Create a TextDecoration + + + + + Create a TextDecoration + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + The interface for an object which can draw itself over the top of + an ObjectListView. + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + An interface for an overlay that supports variable levels of transparency + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + A null implementation of the IOverlay interface + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + How transparent should this overlay be? + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Create an ImageOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + An overlay that will draw text over the top of the ObjectListView + + + + + Create a TextOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Gets or sets whether the border will be drawn with rounded corners + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + A Billboard overlay is a TextOverlay positioned at an absolute point + + + + + Create a BillboardOverlay + + + + + Gets or sets where should the top left of the billboard be placed + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Renderers are the mechanism used for owner drawing cells. As such, they can also handle + hit detection and positioning of cell editing rectangles. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + Renderers that implement this interface will have the filter property updated, + each time the filter on the ObjectListView is updated. + + + + + + + + + + An AbstractRenderer is a do-nothing implementation of the IRenderer interface. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + This class provides compatibility for v1 RendererDelegates + + + + + The renderer delegate that this renderer wraps + + + + + A BaseRenderer provides useful base level functionality for any custom renderer. + + + Subclasses will normally override the Render or OptionalRender method, and use the other + methods as helper functions. + + + + + Can the renderer wrap lines that do not fit completely within the cell? + + Wrapping text doesn't work with the GDI renderer. + + + + Gets or sets how many pixels will be left blank around this cell + + + + This setting only takes effect when the control is owner drawn. + + for more details. + + + + + Gets the horiztonal alignment of the column + + + + + Gets or sets how cells drawn by this renderer will be vertically aligned. + + + + If this is not set, the value from the column or control itself will be used. + + + + + + Gets the optional padding that this renderer should apply before drawing. + This property considers all possible sources of padding + + + + + Gets the vertical cell alignment that should govern the rendering. + This property considers all possible sources. + + + + + Gets or sets the image list from which keyed images will be fetched + + + + + When rendering multiple images, how many pixels should be between each image? + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Get or set the aspect of the model object that this renderer should draw + + + + + What are the bounds of the cell that is being drawn? + + + + + Get or set the OLVColumn that this renderer will draw + + + + + Get/set the event that caused this renderer to be called + + + + + Get/set the event that caused this renderer to be called + + + + + Gets or sets the font to be used for text in this cell + + + + + Gets the image list from which keyed images will be fetched + + + + + Should this renderer fill in the background before drawing? + + + + + Cache whether or not our item is selected + + + + + Is this renderer being used on a printer context? + + + + + Get or set the listitem that this renderer will be drawing + + + + + Get/set the listview for which the drawing is to be done + + + + + Get the specialized OLVSubItem that this renderer is drawing + + This returns null for column 0. + + + + Get or set the model object that this renderer should draw + + + + + Get or set the list subitem that this renderer will be drawing + + + + + The brush that will be used to paint the text + + + + + Will this renderer use the custom images from the parent ObjectListView + to draw the checkbox images. + + + + If this is true, the renderer will use the images from the + StateImageList to represent checkboxes. 0 - unchecked, 1 - checked, 2 - indeterminate. + + If this is false (the default), then the renderer will use .NET's standard + CheckBoxRenderer. + + + + + Align the second rectangle with the first rectangle, + according to the alignment of the column + + The cell's bounds + The rectangle to be aligned within the bounds + An aligned rectangle + + + + Calculate the left edge of the rectangle that aligns the outer rectangle with the inner one + according to this renderer's horizontal alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with the inner rectangle + according to this renders vertical alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with a rectangle of the given height + according to this renderer's vertical alignment + + + + + + + + Calculate the space that our rendering will occupy and then align that space + with the given rectangle, according to the Column alignment + + + Pre-padded bounds of the cell + + + + + Calculate the size of the content of this cell. + + + Pre-padded bounds of the cell + The width and height of the content + + + + Calculate the bounds of a checkbox given the (pre-padded) cell bounds + + + Pre-padded cell bounds + + + + + How much space will the check box for this cell occupy? + + Only column 0 can have check boxes. Sub item checkboxes are + treated as images + + + + + + How much space will the check box for this row occupy? + If the list doesn't have checkboxes, or this isn't the primary column, + this returns an empty size. + + + + + + + How much horizontal space will the image of this cell occupy? + + + + + + + + How much vertical space will the image of this cell occupy? + + + + + + + + How much space will the image of this cell occupy? + + + + + + + + How much horizontal space will the text of this cell occupy? + + + + + + + + + How much space will the text of this cell occupy? + + + + + + + + + Return the Color that is the background color for this item's cell + + The background color of the subitem + + + + Return the color of the background color when the item is selected + + The background color of the subitem + + + + Return the color to be used for text in this cell + + The text color of the subitem + + + + Return the color of the foreground color when the item is selected + + The foreground color of the subitem + + + + Return the image that should be drawn against this subitem + + An Image or null if no image should be drawn. + + + + Return the actual image that should be drawn when keyed by the given image selector. + An image selector can be: + an int, giving the index into the image list + a string, giving the image key into the image list + an Image, being the image itself + + + The value that indicates the image to be used + An Image or null + + + + + + + + Return the string that should be drawn within this + + + + + + Return the Color that is the background color for this item's text + + The background color of the subitem's text + + + + Render the whole item in a non-details view. + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Render one cell + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Calculate which part of this cell was hit + + + + + + + + Calculate the edit rectangle + + + + + + + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method. + The graphics context that should be used for drawing + The bounds of the subitem cell + Returns whether the rendering has already taken place. + If this returns false, the default processing will take over. + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method if they never want + to fall back on the default processing + The graphics context that should be used for drawing + The bounds of the subitem cell + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw the standard "[checkbox] [image] [text]" cell after the state properties have been initialized. + + + + + + + Change the bounds of the given rectangle to take any cell padding into account + + + + + + + Perform normal hit testing relative to the given aligned content bounds + + + + + + + + + + This method calculates the bounds of the text within a standard layout + (i.e. optional checkbox, optional image, text) + + This method only works correctly if the state of the renderer + has been fully initialized (see BaseRenderer.GetEditRectangle) + + + + + + + + Apply any padding to the given bounds, and then align a rectangle of the given + size within that padded area. + + + + + + + + + Draw the given image aligned horizontally within the column. + + + Over tall images are scaled to fit. Over-wide images are + truncated. This is by design! + + Graphics context to use for drawing + Bounds of the cell + The image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Pre-padded bounds of the cell + + + + Fill in the background of this cell + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the primary check box of this row (checkboxes in other sub items use a different method) + + Graphics context to use for drawing + The pre-aligned and padded target rectangle + + + + Calculate the CheckBoxState we need to correctly draw the given state + + + + + + + Should this checkbox be drawn as disabled? + + + + + Is the current item hot (i.e. under the mouse)? + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The optional image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the given collection of image selectors + + + + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The string to be drawn + + + + Print the given text in the given rectangle using only GDI routines + + + + + + The native list control uses GDI routines to do its drawing, so using them + here makes the owner drawn mode looks more natural. + This method doesn't honour the CanWrap setting on the renderer. All + text is single line + + + + + Gets the cell's vertical alignment as a TextFormatFlag + + + + + + Gets the StringFormat needed when drawing text using GDI+ + + + + + Print the given text in the given rectangle using normal GDI+ .NET methods + + Printing to a printer dc has to be done using this method. + + + + This renderer highlights substrings that match a given text filter. + + + + + Create a HighlightTextRenderer + + + + + Create a HighlightTextRenderer + + + + + + Create a HighlightTextRenderer + + + + + + Gets or set how rounded will be the corners of the text match frame + + + + + Gets or set the brush will be used to paint behind the matched substrings. + Set this to null to not fill the frame. + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Gets or set the pen will be used to frame the matched substrings. + Set this to null to not draw a frame. + + + + + Gets or sets whether the frame around a text match will have rounded corners + + + + + Gets or set the text that will be highlighted + + + + + Gets or sets the manner in which substring will be compared. + + + Use this to control if substring matches are case sensitive or insensitive. + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw text using GDI + + + + + + + + Draw the highlighted text using GDI + + + + + + + + Draw an indication around the given frame that shows a text match + + + + + + + + + + Draw the text using GDI+ + + + + + + + + Draw the highlighted text using GDI+ + + + + + + + + Gets whether the renderer should actually draw highlighting + + + + + Return a GraphicPath that is a round cornered rectangle + + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + + + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + This class maps a data value to an image that should be drawn for that value. + + It is useful for drawing data that is represented as an enum or boolean. + + + + Return a renderer that draw boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + A Renderer + + + + Return a renderer that draw tristate boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + Draw this when our data value is null + A Renderer + + + + Make a new empty renderer + + + + + Make a new renderer that will show the given image when the given key is the aspect value + + The data value to be matched + The image to be shown when the key is matched + + + + Make a new renderer that will show the given images when it receives the given keys + + + + + + + + + Build a renderer from the given array of keys and their matching images + + An array of key/image pairs + + + + Register the image that should be drawn when our Aspect has the data value. + + Value that the Aspect must match + An ImageSelector -- an int, string or image + + + + Render our value + + + + + + + Draw a collection of images + + + + + + + + Draw one image + + + + + + + + This renderer draws just a checkbox to match the check state of our model object. + + + + + Draw our cell + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + Handle the HitTest request + + + + + + + + + Render an image that comes from our data source. + + The image can be sourced from: + + a byte-array (normally when the image to be shown is + stored as a value in a database) + an int, which is treated as an index into the image list + a string, which is treated first as a file name, and failing that as an index into the image list + an ICollection of ints or strings, which will be drawn as consecutive images + + If an image is an animated GIF, it's state is stored in the SubItem object. + By default, the image renderer does not render animations (it begins life with animations paused). + To enable animations, you must call Unpause(). + In the current implementation (2009-09), each column showing animated gifs must have a + different instance of ImageRenderer assigned to it. You cannot share the same instance of + an image renderer between two animated gif columns. If you do, only the last column will be + animated. + + + + + Make an empty image renderer + + + + + Make an empty image renderer that begins life ready for animations + + + + + Finalizer + + + + + Should the animations in this renderer be paused? + + + + + Gets a timer that can be used to trigger redraws on animations + + + + + Pause any animations + + + + + Unpause any animations + + + + + Draw our image + + + + + + + Translate our Aspect into an image. + + The strategy is: + If its a byte array, we treat it as an in-memory image + If it's an int, we use that as an index into our image list + If it's a string, we try to load a file by that name. If we can't, + we use the string as an index into our image list. + + An image + + + + This is the method that is invoked by the timer. It basically switches control to the listview thread. + + not used + + + + This is the OnTimer callback, but invoked in the same thread as the creator of the ListView. + This method can use all of ListViews methods without creating a CrossThread exception. + + + + + Instances of this class kept track of the animation state of a single image. + + + + + Is the given image an animation + + The image to be tested + Is the image an animation? + + + + Create an AnimationState in a quiet state + + + + + Create an animation state for the given image, which may or may not + be an animation + + The image to be rendered + + + + Does this state represent a valid animation + + + + + Advance our images current frame and calculate when it will expire + + + + + Render our Aspect as a progress bar + + + + + Make a BarRenderer + + + + + Make a BarRenderer for the given range of data values + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + 此栏是否应以系统样式绘制？ + + + + + 将从我们的单元格边框开始绘制多少像素的条形图 + + + + + 在绘制进度条之前，将使用什么颜色填充控件内部？ + + + + + 进度条边框颜色 + + + + + 进度条的边框像素宽 + + + + + 进度条的“填充”部分应该是什么颜色？ + + 仅当GradientStartColor为Color.Empty时才使用此选项 + + + + 使用渐变以此颜色开始填充进度条 + + + + + 使用渐变填充以此颜色结尾的进度条 + + + + + 使用渐变以此颜色开始填充渐满进度条 + + + + + 使用渐变填充以此颜色结尾的渐满进度条 + + + + + 无论列变得多宽，进度条都不会比这个宽。 + + + + + 无论单元格有多高，进度条都不会比这个高 + + + + + 预期的最小数据值。小于此值的值将显示一个空条。 + + + + + 接近满时的值,高于该值时，显示不同颜色，小于等于MinimumValue或大于MaximumValue值，则表示未设置该值 + + + + + 范围的最大值。大于此值的值将给出一个完整的条形。 + + + + + The Pen that will draw the frame surrounding this bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the background of the bar + + + + + Draw this progress bar using a gradient + + + + + + + Draw our aspect + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + An ImagesRenderer draws zero or more images depending on the data returned by its Aspect. + + This renderer's Aspect must return a ICollection of ints, strings or Images, + each of which will be drawn horizontally one after the other. + As of v2.1, this functionality has been absorbed into ImageRenderer and this is now an + empty shell, solely for backwards compatibility. + + + + + A MultiImageRenderer draws the same image a number of times based on our data value + + The stars in the Rating column of iTunes is a good example of this type of renderer. + + + + Make a quiet renderer + + + + + Make an image renderer that will draw the indicated image, at most maxImages times. + + + + + + + + + The index of the image that should be drawn + + + + + The name of the image that should be drawn + + + + + The image selector that will give the image to be drawn + + Like all image selectors, this can be an int, string or Image + + + + What is the maximum number of images that this renderer should draw? + + + + + Values less than or equal to this will have 0 images drawn + + + + + Values greater than or equal to this will have MaxNumberImages images drawn + + + + + Draw our data value + + + + + + + A class to render a value that contains a bitwise-OR'ed collection of values. + + + + + Register the given image to the given value + + When this flag is present... + ...draw this image + + + + Draw the flags + + + + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + This renderer draws an image, a single line title, and then multi-line description + under the title. + + + This class works best with FullRowSelect = true. + It's not designed to work with cell editing -- it will work but will look odd. + + It's not RightToLeft friendly. + + + + + + Create a DescribedTaskRenderer + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Gets or set the font that will be used to draw the title of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the title of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the title of the task or a reasonable default + + + + + Gets or set the font that will be used to draw the description of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the description of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the description of the task or a reasonable default + + + + + Gets or sets the number of pixels that will be left between the image and the text + + + + + 顶部留白像素 + + + + + Gets or sets the number of pixels that will be left between the title and the description + + + + + Gets or sets the name of the aspect of the model object that contains the task description + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Fetch the description from the model class + + + + + + + + + + + + + + + Draw our item + + + + + + + Draw the task + + + + + + + + + + Handle the HitTest request + + + + + + + + + This renderer draws a functioning button in its cell + + + + + Gets or sets how each button will be sized + + + + + Gets or sets the size of the button when the SizingMode is FixedBounds + + If this is not set, the bounds of the cell will be used + + + + Gets or sets the extra space that surrounds the cell when the SizingMode is TextBounds + + + + + Gets or sets the maximum width that a button can occupy. + -1 means there is no maximum width. + + This is only considered when the SizingMode is TextBounds + + + + Gets or sets the minimum width that a button can occupy. + -1 means there is no minimum width. + + This is only considered when the SizingMode is TextBounds + + + + 获取或设置此列按钮的字体颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的背景颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的内边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮是否画边框(如果有按钮的话) + + + + + Calculate the size of the contents + + + + + + + + Draw the button + + + + + + + What part of the control is under the given point? + + + + + + + + + + What is the state of the button? + + + + + + Is the mouse over the button? + + + + + The common interface supported by all style objects + + + + + Gets or set the font that will be used by this style + + + + + Gets or set the font style + + + + + Gets or sets the ForeColor + + + + + Gets or sets the BackColor + + + + + Basic implementation of IItemStyle + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class specify how should "hot items" (non-selected + rows under the cursor) be renderered. + + + + + Gets or sets the overlay that should be drawn as part of the hot item + + + + + Gets or sets the decoration that should be drawn as part of the hot item + + A decoration is different from an overlay in that an decoration + scrolls with the listview contents, whilst an overlay does not. + + + + This class defines how a cell should be formatted + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class describe how hyperlinks will appear + + + + + Create a HyperlinkStyle + + + + + What sort of formatting should be applied to hyperlinks in their normal state? + + + + + What sort of formatting should be applied to hyperlinks when the mouse is over them? + + + + + What sort of formatting should be applied to hyperlinks after they have been clicked? + + + + + Gets or sets the cursor that should be shown when the mouse is over a hyperlink. + + + + + Instances of this class control one the styling of one particular state + (normal, hot, pressed) of a header control + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Gets or sets the color in which a frame will be drawn around the header for this column + + + + + Gets or sets the width of the frame that will be drawn around the header for this column + + + + + This class defines how a header should be formatted in its various states. + + + + + Create a new HeaderFormatStyle + + + + + What sort of formatting should be applied to a column header when the mouse is over it? + + + + + What sort of formatting should be applied to a column header in its normal state? + + + + + What sort of formatting should be applied to a column header when pressed? + + + + + Set the font for all three states + + + + + + Set the fore color for all three states + + + + + + Set the back color for all three states + + + + + + 正常为选中按钮 + + + + + 获得焦点的按钮 + + + + + 鼠标经过样式 + + + + + 获得焦点并鼠标经过 + + + + + 自定义GDI工具，绘制按钮 + + + + + 绘制圆形按钮（用法同矩形按钮） + + + + + + + + + + 绘制圆角按钮 + + 要绘制的文字 + Graphics 对象 + 要填充的矩形 + + + + + 根据普通矩形得到圆角矩形的路径 + + 原始矩形 + 半径 + 图形路径 + + + + A GlassPanelForm sits transparently over an ObjectListView to show overlays. + + + + + Get the low-level windows flag that will be given to CreateWindow. + + + + + Attach this form to the given ObjectListView + + + + + Made the overlay panel invisible + + + + + Show the overlay panel in its correctly location + + + If the panel is always shown, this method does nothing. + If the panel is being resized, this method also does nothing. + + + + + Detach this glass panel from its previous ObjectListView + + + You should unbind the overlay panel before making any changes to the + widget hierarchy. + + + + + Handle when the form that owns the ObjectListView begins to be resized + + + + + + + Handle when the form that owns the ObjectListView finished to be resized + + + + + + + The owning form has moved. Move the overlay panel too. + + + + + + + The owning form is resizing. Hide our overlay panel until the resizing stops + + + + + + + Handle when the bound OLV changes its location. The overlay panel must + be moved too, IFF it is currently visible. + + + + + + + Handle when the bound OLV changes size. The overlay panel must + resize too, IFF it is currently visible. + + + + + + + Handle when the bound OLV is part of a TabControl and that + TabControl changes tabs. The overlay panel is hidden. The + first time the bound OLV is redrawn, the overlay panel will + be shown again. + + + + + + + Somewhere the parent of the bound OLV has changed. Update + our events. + + + + + + + Handle when the bound OLV changes its visibility. + The overlay panel should match the OLV's visibility. + + + + + + + Class used to capture window messages for the header of the list view + control. + + + + + Create a header control for the given ObjectListView. + + + + + + Return the index of the column under the current cursor position, + or -1 if the cursor is not over a column + + Index of the column under the cursor, or -1 + + + + 返回此控件的Windows句柄 + + + 当ObjectListView被初始化为UserControl的一部分时，GetHeaderControl()方法返回0，直到UserControl完全初始化。 + 因此，构造函数中的AssignHandle()调用不起作用。因此，我们覆盖了Handle属性，以便值始终为当前值。 + + + + + Gets or sets a style that should be applied to the font of the + column's header text when the mouse is over that column + + THIS IS EXPERIMENTAL. USE AT OWN RISK. August 2009 + + + + 如果光标位于其复选框上，则获取光标下列的索引 + + + + + Gets the client rectangle for the header + + + + + 如果给定坐标点在给定列的复选框上方，则返回TRUE。 + + + + + + + + 获取光标是否位于“锁定”的分隔线上，即用户无法拖动的分隔线。 + + + + + 获取或设置此标头所属的列表视图 + + + + + 获取标题的最大高度。-1表示没有最大值。 + + + + + 获取标题的最小高度。-1表示没有最低要求。 + + + + + Get or set the ToolTip that shows tips for the header + + + + + 获取或设置当列标题中的文本太长而无法放入列中时，是否应对其进行自动换行 + + + + + Calculate how height the header needs to be + + Height in pixels + + + + Get the bounds of the checkbox against the given column + + + + + + + Should the given column be drawn with a checkbox against it? + + + + + + + Should the given column show a sort indicator? + + + + + + + Should the given column be drawn with a filter indicator against it? + + + + + + + Should the given column show a non-themed sort indicator? + + + + + + + Return the bounds of the item with the given index + + + + + + + Return the bounds within which the given column will be drawn + + + + + + + Force the header to redraw by invalidating it + + + + + Force the header to redraw a single column by invalidating it + + + + + Create a native tool tip control for this listview + + + + + Override the basic message pump + + + + + + Handle the LButtonDown windows message + + + + + + + Handle the LButtonUp windows message + + + + + + + Handle the SetCursor windows message + + + + + + + Handle the MouseMove windows message + + + + + + + Handle the MouseLeave windows message + + + + + + + Handle the Notify windows message + + + + + + + Handle the CustomDraw windows message + + + + + + + The message divides a ListView's space between the header and the rows of the listview. + The WINDOWPOS structure controls the headers bounds, the RECT controls the listview bounds. + + + + + + + Handle when the underlying header control is destroyed + + + + + + + Does this header need to be custom drawn? + + Word wrapping and colored text require custom drawning. Funnily enough, we + can change the font natively. + + + + Draw one cell of the header + + + + + + + + Draw a background for the header, without using Themes. + + + + + + + + + + + Draw a more-or-less pure themed header background. + + + + + + + + + + Draw a sort indicator using themes + + + + + + + Draw a sort indicator without using themes + + + + + + + + Draw an indication that this column has a filter applied to it + + + + + + + + Draw the header's image and text + + + + + + + + + Return the header format that should be used for the given column + + + + + + + What style should be applied to the header? + + + + + + + + + What font should be used to draw the header text? + + + + + + + + + What flags will be used when drawing text + + + + + Perform a HitTest for the header control + + + + Null if the given point isn't over the header + + + + Instances of this class put a CheckedListBox into a tool strip menu item. + + + + + Create a ToolStripCheckedListBox + + + + + Gets the control embedded in the menu + + + + + Gets the items shown in the checkedlistbox + + + + + Gets or sets whether an item should be checked when it is clicked + + + + + Gets a collection of the checked items + + + + + Add a possibly checked item to the control + + + + + + + Add an item with the given state to the control + + + + + + + Gets the checkedness of the i'th item + + + + + + + Set the checkedness of the i'th item + + + + + + + Check all the items in the control + + + + + Unchecked all the items in the control + + + + + Listen for events on the underlying control + + + + + + Stop listening for events on the underlying control + + + + + + Tell the world that an item was checked + + + + + Trigger the ItemCheck event + + + + + + + A limited wrapper around a Windows tooltip window. + + + + + These are the standard icons that a tooltip can display. + + + + + No icon + + + + + Info + + + + + Warning + + + + + Error + + + + + Large info (Vista and later only) + + + + + Large warning (Vista and later only) + + + + + Large error (Vista and later only) + + + + + + + + + + + + + + + + + + + + + + + + + Get or set if the style of the tooltip control + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set the background color of the tooltip + + + + + Get or set the color of the text and border on the tooltip. + + + + + Get or set the title that will be shown on the tooltip. + + + + + Get or set the icon that will be shown on the tooltip. + + + + + Gets or sets the font that will be used to draw this control. + is still. + + Setting this to null reverts to the default font. + + + + Gets or sets how many milliseconds the tooltip will remain visible while the mouse + is still. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown again. + + + + + Create the underlying control. + + The parent of the tooltip + This does nothing if the control has already been created + + + + Take a copy of the current settings and restore them when the + tooltip is poppped. + + + This call cannot be nested. Subsequent calls to this method will be ignored + until PopSettings() is called. + + + + + Restore the settings of the tooltip as they were when PushSettings() + was last called. + + + + + Add the given window to those for whom this tooltip will show tips + + The window + + + + Hide any currently visible tooltip + + + + + + Remove the given window from those managed by this tooltip + + + + + + Set the maximum width of a tooltip string. + + + + + Set the maximum width of a tooltip string. + + Setting this ensures that line breaks in the tooltip are honoured. + + + + Make a TOOLINFO structure for the given window + + + A filled in TOOLINFO + + + + Handle a WmNotify message + + The msg + True if the message has been handled + + + + Handle a get display info message + + The msg + True if the message has been handled + + + + Handle a TTN_LINKCLICK message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_POP message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_SHOW message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a reflected notify message + + The msg + True if the message has been handled + + + + Mess with the basic message pump of the tooltip + + + + + + Tell the world that a tooltip is about to show + + + + + Tell the world that a tooltip is about to disappear + + + + + + + + + + + + + + + + + This form is an example of how an application could allows the user to select which columns + an ObjectListView will display, as well as select which order the columns are displayed in. + + + In Tile view, ColumnHeader.DisplayIndex does nothing. To reorder the columns you have + to change the order of objects in the Columns property. + Remember that the first column is special! + It has to remain the first column. + + + + + Make a new ColumnSelectionForm + + + + + Open this form so it will edit the columns that are available in the listview's current view + + The ObjectListView whose columns are to be altered + + + + Open this form so it will edit the columns that are available in the given listview + when the listview is showing the given type of view. + + The ObjectListView whose columns are to be altered + The view that is to be altered. Must be View.Details or View.Tile + + + + Initialize the form to show the columns of the given view + + + + + + + The user has pressed OK. Do what's requied. + + + + + + + Enable the controls on the dialog to match the current state + + + + + A Comparer that will sort a list of columns so that visible ones come before hidden ones, + and that are ordered by their display order. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + An object that implements the IGenerator interface provides the ability + to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + The Generator class provides methods to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + For a given type, a Generator can create columns to match the public properties + of that type. The generator can consider all public properties or only those public properties marked with + [OLVColumn] attribute. + + + + + Gets or sets the actual generator used by the static convinence methods. + + If you subclass the standard generator or implement IGenerator yourself, + you should install an instance of your subclass/implementation here. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the public properties of the given type + that have a OLVColumn attribute. + + + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Replace all the columns in the given listview with the given list of columns. + + + + + + + Post process columns after creating them and adding them to the AllColumns collection. + + + + + + Create a column from the given PropertyInfo and OLVColumn attribute + + + + + + + + Make a column from the given PropertyInfo + + + + + + + Make a column from the given PropertyDescriptor + + + + + + + Create a column with all the given information + + + + + + + + + + + Create a column. + + + + + + + + + Convert a property name to a displayable title. + + + + + + + Configure the given column to show a checkbox if appropriate + + + + + + + If this given type has an property marked with [OLVChildren], make delegates that will + traverse that property as the children of an instance of the model + + + + + + + Generate CanExpand and ChildrenGetter delegates from the given property. + + + + + + + An OLVExporter converts a collection of rows from an ObjectListView + into a variety of textual formats. + + + + + What format will be used for exporting + + + + + Tab separated values, according to http://www.iana.org/assignments/media-types/text/tab-separated-values + + + + + Alias for TabSeparated + + + + + Comma separated values, according to http://www.ietf.org/rfc/rfc4180.txt + + + + + HTML table, according to me + + + + + Create an empty exporter + + + + + Create an exporter that will export all the rows of the given ObjectListView + + + + + + Create an exporter that will export all the given rows from the given ObjectListView + + + + + + + Gets or sets whether hidden columns will also be included in the textual + representation. If this is false (the default), only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. Default is true. + + + + + Gets the ObjectListView that is being used as the source of the data + to be exported + + + + + Gets the model objects that are to be placed in the data object + + + + + Export the nominated rows from the nominated ObjectListView. + Returns the result in the expected format. + + + + This will perform only one conversion, even if called multiple times with different formats. + + + + Convert + + + + + Encode a string such that it can be used as a value in a CSV file. + This basically means replacing any quote mark with two quote marks, + and enclosing the whole string in quotes. + + + + + + + HTML-encodes a string and returns the encoded string. + + The text string to encode. + The HTML-encoded text. + Taken from http://www.west-wind.com/weblog/posts/2009/Feb/05/Html-and-Uri-String-Encoding-without-SystemWeb + + + + A TypedObjectListView is a type-safe wrapper around an ObjectListView. + + + VCS does not support generics on controls. It can be faked to some degree, but it + cannot be completely overcome. In our case in particular, there is no way to create + the custom OLVColumn's that we need to truly be generic. So this wrapper is an + experiment in providing some type-safe access in a way that is useful and available today. + A TypedObjectListView is not more efficient than a normal ObjectListView. + Underneath, the same name of casts are performed. But it is easier to use since you + do not have to write the casts yourself. + + + The class of model object that the list will manage + + To use a TypedObjectListView, you write code like this: + + TypedObjectListView<Person> tlist = new TypedObjectListView<Person>(this.listView1); + tlist.CheckStateGetter = delegate(Person x) { return x.IsActive; }; + tlist.GetColumn(0).AspectGetter = delegate(Person x) { return x.Name; }; + ... + + To iterate over the selected objects, you can write something elegant like this: + + foreach (Person x in tlist.SelectedObjects) { + x.GrantSalaryIncrease(); + } + + + + + + Create a typed wrapper around the given list. + + The listview to be wrapped + + + + Return the model object that is checked, if only one row is checked. + If zero rows are checked, or more than one row, null is returned. + + + + + Return the list of all the checked model objects + + + + + The ObjectListView that is being wrapped + + + + + Get or set the list of all model objects + + + + + Return the model object that is selected, if only one row is selected. + If zero rows are selected, or more than one row, null is returned. + + + + + The list of model objects that are selected. + + + + + Return a typed wrapper around the column at the given index + + The index of the column + A typed column or null + + + + Return a typed wrapper around the column with the given name + + The name of the column + A typed column or null + + + + Return the model object at the given index + + The index of the model object + The model object or null + + + + CheckStateGetter + + + + + + + Gets or sets the check state getter + + + + + BooleanCheckStateGetter + + + + + + + Gets or sets the boolean check state getter + + + + + CheckStatePutter + + + + + + + + Gets or sets the check state putter delegate + + + + + BooleanCheckStatePutter + + + + + + + + Gets or sets the boolean check state putter + + + + + ToolTipGetter + + + + + + + + Gets or sets the cell tooltip getter + + + + + Gets or sets the header tool tip getter + + + + + This method will generate AspectGetters for any column that has an AspectName. + + + + + A type-safe wrapper around an OLVColumn + + + + + + Creates a TypedColumn + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Generate an aspect getter that does the same thing as the AspectName, + except without using reflection. + + + + If you have an AspectName of "Owner.Address.Postcode", this will generate + the equivilent of: this.AspectGetter = delegate (object x) { + return x.Owner.Address.Postcode; + } + + + + If AspectName is empty, this method will do nothing, otherwise + this will replace any existing AspectGetter. + + + + + + Generates an aspect getter method dynamically. The method will execute + the given dotted chain of selectors against a model object given at runtime. + + The type of model object to be passed to the generated method + A dotted chain of selectors. Each selector can be the name of a + field, property or parameter-less method. + A typed delegate + + + + This method generates the actual IL for the method. + + + + + + + + A virtual object list view operates in virtual mode, that is, it only gets model objects for + a row when it is needed. This gives it the ability to handle very large numbers of rows with + minimal resources. + + A listview is not a great user interface for a large number of items. But if you've + ever wanted to have a list with 10 million items, go ahead, knock yourself out. + Virtual lists can never iterate their contents. That would defeat the whole purpose. + Animated GIFs should not be used in virtual lists. Animated GIFs require some state + information to be stored for each animation, but virtual lists specifically do not keep any state information. + In any case, you really do not want to keep state information for 10 million animations! + + Although it isn't documented, .NET virtual lists cannot have checkboxes. This class codes around this limitation, + but you must use the functions provided by ObjectListView: CheckedObjects, CheckObject(), UncheckObject() and their friends. + If you use the normal check box properties (CheckedItems or CheckedIndicies), they will throw an exception, since the + list is in virtual mode, and .NET "knows" it can't handle checkboxes in virtual mode. + + Due to the limits of the underlying Windows control, virtual lists do not trigger ItemCheck/ItemChecked events. + Use a CheckStatePutter instead. + To enable grouping, you must provide an implmentation of IVirtualGroups interface, via the GroupingStrategy property. + Similarly, to enable filtering on the list, your VirtualListDataSource must also implement the IFilterableDataSource interface. + + + + + Create a VirtualObjectListView + + + + + Gets whether or not this listview is capabale of showing groups + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + This class optimizes the management of CheckStates so that it will work efficiently even on + large lists of item. However, those optimizations are impossible if you install a CheckStateGetter. + With a CheckStateGetter installed, the performance of this method is O(n) where n is the size + of the list. This could be painfully slow. + + + + + Gets or sets whether or not an object will be included in the CheckedObjects + collection, even if it is not present in the control at the moment + + + This property is an implementation detail and should not be altered. + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Gets or sets the strategy that will be used to create groups + + + This must be provided for a virtual list to show groups. + + + + + Gets whether or not the current list is filtering its contents + + + This is only possible if our underlying data source supports filtering. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + Setting this property preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code -- performance is O(n) where n is the number of selected rows. + This method is not thread safe. + The property DOES work on virtual lists, but if you try to iterate through a list + of 10 million objects, it may take some time :) + + + + + This delegate is used to fetch a rowObject, given it's index within the list + + Only use this property if you are not using a VirtualListDataSource. + + + + Should this list show its items in groups? + + + + + Get/set the data source that is behind this virtual list + + Setting this will cause the list to redraw. + + + + Gets or sets the number of rows in this virtual list. + + + There is an annoying feature/bug in the .NET ListView class. + When you change the VirtualListSize property, it always scrolls so + that the focused item is the top item. This is annoying since it makes + the virtual list seem to flicker as the control scrolls to show the focused + item and then scrolls back to where ObjectListView wants it to be. + + + + + Return the number of items in the list + + the number of items in the list + + + + Return the model object at the given index + + Index of the model object to be returned + A model object + + + + Find the given model object within the listview and return its index + + The model object to be found + The index of the object. -1 means the object was not present + + + + Return the OLVListItem that displays the given model object + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Add the given collection of model objects to this control. + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the end of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Scroll the listview so that the given group is at the top. + + The index of the group to be revealed + + If the group is already visible, the list will still be scrolled to move + the group to the top, if that is possible. + + This only works when the list is showing groups (obviously). + + + + + Inserts the given collection of model objects to this control at hte given location + + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the given position of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Update the rows that are showing the given objects + + This method does not resort the items. + + + + Update the rows that are selected + + This method does not resort or regroup the view. + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + Due to problems in the underlying ListView, if you remove all the objects from + the control using this method and the list scroll vertically when you do so, + then when you subsequenially add more objects to the control, + the vertical scroll bar will become confused and the control will draw one or more + blank lines at the top of the list. + + + + + Select the row that is displaying the given model object. All other rows are deselected. + + Model object to select + Should the object be focused as well? + + + + Select the rows that is displaying any of the given model object. All other rows are deselected. + + A collection of model objects + This method has O(n) performance where n is the number of model objects passed. + Do not use this to select all the rows in the list -- use SelectAll() for that. + + + + Set the collection of objects that this control will show. + + + Should the state of the list be preserved as far as is possible. + + + + Get the checkedness of an object from the model. Returning null means the + model does know and the value from the control will be used. + + + + + + + Rebuild the list with its current contents. + + + Invalidate any cached information when we rebuild the list. + + + + + Clear any cached info this list may have been using + + + + + Do the work of creating groups for this control + + + + + + Do the plumbing to disable groups on a virtual list + + + + + Do the plumbing to enable groups on a virtual list + + + + + Return the position of the given itemIndex in the list as it currently shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the last item in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + Return the n'th item (0-based) in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the ListViewItem that appears immediately after the given item. + If the given item is null, the first item in the list will be returned. + Return null if the given item is the last item. + + The item that is before the item that is returned, or null + A OLVListItem + + + + Return the ListViewItem that appears immediately before the given item. + If the given item is null, the last item in the list will be returned. + Return null if the given item is the first item. + + The item that is before the item that is returned + A ListViewItem + + + + Make a list of groups that should be shown according to the given parameters + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + + + + On virtual lists, this cannot work. + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Refresh the given item in the list + + The item to refresh + + + + Change the size of the list + + + + + + Take ownership of the 'objects' collection. This separates our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + VirtualObjectListViews always own their collections, so this is a no-op. + + + + + + Change the state of the control to reflect changes in filtering + + + + + Change the size of the virtual list so that it matches its data source + + + + + Handle the CacheVirtualItems event + + + + + + + Handle a RetrieveVirtualItem + + + + + + + Handle the SearchForVirtualList event, which is called when the user types into a virtual list + + + + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 初始化的时候给个alpha值,这样在灰图片的时候可以半透明 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使图片单色化 + + + + + + + + + + + + 自定义 + + + + + 预置 + + + + + 系统 + + + + + 颜色表示法 + + + + + 根据颜色表示字符串获取对应的颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 从文件中获取Image对象 + 这个函数的主要功能是处理一些ico文件 + 一些ico文件的格式可能比较新，直接Image.FormFile，会报内存不足的异常 + + + 是否将文件读入内存操作，如果为false,将直接返回Image.FromFile，在此情况下， + 必须手动释放Image对象，否则文件将一直处于占用状态，如果为true,则在内存中拷贝副本 + + + + + + 将图像转为Icon对象,使用png格式 + + + + + + + 将图像转为Icon对象 + + + + + + + + 返回适应指定容器大小的图像 + 如果图像的尺寸(长或宽)超出了容器范围,将按比例获取图像的缩略图返回,否则直接返回图像 + 此方法最终调用 Image.GetThumbnailImage + 但是注意,在指定的容器尺寸过小时,返回的Image尺寸不可知,是在为了显示16x16的小缩略图是发现了此问题 + 使用 GetScaleImage + + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + + The source image. + The rectangle to fit in to. + Horizontal image aligment in percent. + Vertical image aligment in percent. + New image size. + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + The image will be centered in the fit box. + + The source image. + The rectangle to fit in to. + New image size. + + + + Gets the scaled size of an image required to fit + in to the given size keeping the image aspect ratio. + + The source image. + The size to fit in to. + New image size. + + + + 获取一个圆角矩形 + + + + 角度 + + + + + 获取一个圆角矩形 + + + 角度 + + + + + + + + + + + + + + + + + + + + + + 返回一个表示箭头的Path + 如果开始坐标和结束坐标之间的距离大于箭头的大小，箭头向结束坐标对齐，顶着结束坐标 + + 开始坐标 + 结束坐标（顶点，方向） + 箭头的长短，大小 + 箭头的粗细 + + + + + 在指定的Image上绘制特定标记 + + + + + 文件不存在 + + + + + + 文件不存在 + + + + + + 无法读取文件 + + + + + + + + + + + + + + + + + + + + + 验证失败中显示错误信息时用的标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + 验证控件的输入 + + + + + + + 自定义验证方法 + 在基础验证都通过后，才会调用自定义验证方法（如果有） + + + + + + + + + + 是否支持 Windows Vista 以上的玻璃效果 + + + + + 是否打开了玻璃效果 + + + + + 获取应用程序主窗体 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 这个缓存是全局的 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 所对应的绑定数据类型 + + + + + 是否对 DataBoundType 的子类型有效 + 默认无效 + 如果设置为 true，又同时添加了基类与子类的 codon，则运行时会取到哪个codon不确定 + 通常取先添加的那个 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取授予该组件的许可证密钥 + + + + + 0:未验证 + 1:验证失败 + 2:验证通过 + + + + + 获取组件的实例或类型的许可证（如果已给定上下文并确定拒绝许可证是否引发异常）。 + + + + + + + + + + 强类型资源类，用于查找本地化字符串等。 + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + Returns a System.String that represents the current System.Object. + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + + + + + + Call GetLanguages() to retrieve a list of possible languages that can be used to set this property. + The default value is the default language. + + + + + Gets a list of available languages defined in this assembly. + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Determines which animation to use while showing the pop-up window. + + + + + Determines which animation to use while hiding the pop-up window. + + + + + Determines the duration of the animation. + + + + + Gets or sets a value indicating whether the content should receive the focus after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether the is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets a minimum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets a maximum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows the pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows the pop-up window below the specified area of the specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the sizing grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Types of animation of the pop-up window. + + + + + Uses no animation. + + + + + Animates the window from left to right. This flag can be used with roll or slide animation. + + + + + Animates the window from right to left. This flag can be used with roll or slide animation. + + + + + Animates the window from top to bottom. This flag can be used with roll or slide animation. + + + + + Animates the window from bottom to top. This flag can be used with roll or slide animation. + + + + + Makes the window appear to collapse inward if it is hiding or expand outward if the window is showing. + + + + + Uses a slide animation. + + + + + Uses a fade effect. + + + + + Uses a roll animation. + + + + + Uses a default animation. + + + + + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the class. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Gets or sets a value indicating whether the combo box is displaying its drop-down portion. + + + true if the drop-down portion is displayed; otherwise, false. The default is false. + + + + + Occurs when the drop-down portion of a is shown. + + + + + Shows the drop down. + + + + + Occurs when the drop-down portion of the is no longer visible. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Represents a Windows combo box control which can be used in a popup's content control. + + + + + Initializes a new instance of the PopupControl.ComboBox class. + + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 白色到灰色的垂直渐变 + + + + + + + + + + This method handles the RenderToolStripBorder event. + + + + + + + + + + + + A ToolstripManager rendering class with advanced control features + + + + + Creates a new EasyRender class for modifications + + + + + + + + + + + + + + + + + + + + Gets the manager to edit and change the appearance of the Toolstrip + + + + + Gets the manager to edit and change the appearance of Toolstrip buttons + + + + + Gets the manager to edit and change the appearance of other Toolstrip controls + + + + + Gets the manager to edit and change the appearance of the Panels + + + + + Gets the manager to edit and change the appearance of the Toolstrip split buttons + + + + + Gets the manager to edit and change the appearance of the Status-bar + + + + + Gets or sets whether to smooth the font text on all controls + + + + + Gets or sets the color of the text if the AlterColor is set to true + + + + + Gets or sets whether to override the font-color on all controls + + + + + Creates a GraphicsPath that appreciates an area where things can be drawn + + The rectangular area which will serve as the base + The curve amount of the corners + + + + + Creates a triangle based on the size and bounds sectors + + The area which the triangle is confined to + The size of the triangle + The direction which the triangle is pointing + + + + + Gets a color array based on the state of a normal button + + The button to check the state of + + + + + + Gets a color array based on the state of a split-button + + The button to check the state of + + + + + + Gets a color array based on the state of a menu-item + + The button to check the state of + + + + + + Gets a color array based on the state of a drop-down button + + The button to check the state of + + + + + + Gets a blending property for a specified type of Toolstrip item + + The Toolstrip item + The type of item this is + + + + + Fills a specified boundary with color + + The Graphics object to draw onto + The boundaries to draw the color + The brush to fill the color + + + + Fills a specified boundary with a gradient with specified colors + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + + + + Fills a specified boundary with a gradient with specified colors at a given angle + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Fills a specified boundary with a gradient with specified colors at a given angle and with blending properties + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a set path with a defined brush + + The Graphics object to draw onto + The path to draw along + The brush to fill the color + + + + Draws a set path with specified colors + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + + + + Draws a set path with specified colors at a given angle + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Draws a set path with specified colors at a given angle with blending properties + + The Graphics object to draw onto + The path to draw along + + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Toolstrip background + + The Toolstrip being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Toolstrip split-button + + The Toolstrip split-button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Statusbar background + + The Statusbar being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Menustrip item + + The Menustrip item + The Graphics object to handle + The parent Toolstrip + + + + Covers the button background rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Applies any and all changes made to the Renderer + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Toolstrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IToolstrip class for customization + + The IToolstrip to import the settings from + + + + Disposes of the IToolstrip class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip background gradient from the top + + + + + Gets or sets the color of the Toolstrip background gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip background + If set to null, the Toolstrip will simply draw the gradient + + + + + Gets or sets the angle which the Toolstrip background will be drawn + + + + + Gets or sets the color of the Toolstrip border gradient from the top + + + + + Gets or sets the color of the Toolstrip border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip border + If set to null, the Toolstrip will simply draw the border + + + + + Gets or sets the angle which the Toolstrip border will be drawn + + + + + Gets or sets the curve of the border of the Toolstrip + + + + + Imports the settings from a previous or pre-defined IToolstrip and applies it to the current + + The IToolstrip to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IToolstripControls class for customization + + + + + Disposes of the IToolstripControls class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip seperator on the dark side + + + + + Gets or sets the color of the Toolstrip seperator on the light side + + + + + Gets or sets the height of the Toolstrip seperator control + + + + + Gets or sets the color of the grip dots/line at the top + + + + + Gets or sets the color of the grip shadow + + + + + Gets or sets in what mode the grip will be drawn + + + + + Gets or sets the distance, in pixels, between each grip dot + + + + + Gets or sets the size of the dots or lines for the grip + + + + + Imports the settings from a previous or pre-defined IToolstripControls and applies it to the current + + The IToolstripControls to import the settings from + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IButton and applies it to the current + + The IButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" and "Click" do not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IDropDownButton and applies it to the current + + The IDropDownButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new ISplitButton class for customization + + + + + Disposes of the ISplitButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Gets or sets when to display the drop-down arrow + + + + + Gets or sets the color of the drop-down arrow + + + + + Imports the settings from a previous or pre-defined ISplitButton and applies it to the current + + The ISplitButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IPanel class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient at the top of the content panel + + + + + Gets or sets the color of the gradient at the bottom of the content panel + + + + + Gets or sets whether each panel inherits the shading from the content panel + + + + + Gets or sets the angle which the background gradient is drawn + + + + + Gets or sets the blend of the background + + + + + Gets or sets a mode to render the background in + + + + + + + + + + Creates a new IStatusBar class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient of the background at the top + + + + + Gets or sets the color of the gradient of the background at the bottom + + + + + Gets or sets the blending that will apply to the background + + + + + Gets or sets the angle which the background gradient will be drawn + + + + + Gets or sets the color of the dark border + + + + + Gets or sets the color of the light border + + + + + Gets or sets the color of the grip at the top-most + + + + + Gets or sets the color of the grip at the bottom-most + + + + + Gets or sets the spacing of the grip blocks + + + + + Imports the settings from a previous or pre-defined IStatusBar and applies it to the current + + The IStatusBar to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Menustrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IMenustrip class for customization + + The IMenustrip to import the settings from + + + + Disposes of the IMenustrip class and clears all resources related to it + + + + + Gets or sets the color of the menu-strip border (dark) + + + + + Gets or sets the color of the menu-strip border (light) + + + + + Gets or sets how the background of the menu-strip is inherited + + + + + If inheritence is set to none, the color of the background gradient at the top + + + + + If inheritence is set to none, the color of the background gradient at the bottom + + + + + If inheritence is set to none, the blending option for the background + + + + + Gets or sets the color of the margin gradient at the left + + + + + Gets or sets the color of the margin gradient at the right + + + + + Gets or sets the color of the margin border (displayed to the right) + + + + + Gets or sets the color of the root menu-strip button background when it is selected + + + + + Gets or sets the color of the root menu-strip button border when it is selected + + + + + Gets or sets the color of the seperator dark color + + + + + Gets or sets the color of the seperator light color + + + + + Gets or sets the inset position of the seperator from the left + + + + + Gets the class that handles the look and feel of the menu-strip items + + + + + Imports the settings from a previous or pre-defined IMenustrip and applies it to the current + + The IMenustrip to import the settings from + + + + Sets the blending for the background to it's default + + + + + Defines when to show an arrow + + + + + + + + + + + + + + + + + + + + Defines when to use a blend property + + + + + Use the blend when the object is drawn + + + + + Use the blend when the object is hovered over + + + + + Use the blend when the object is clicked + + + + + Use the blend when the object is checked + + + + + Always use the blend regardless of the state of the object + + + + + Defines a method of drawing a grip on a control + + + + + Draws the grip as a set of dots + + + + + Draws the grip as two lines + + + + + Does not draw the grip at all, but the object remains moveable + + + + + Defines a specific type of button to search by + + + + + + + + + + + + + + + + + + + + + + + + + Defines a method for background or object inheritence + + + + + + + + + + + + + + + Defines a method of rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 主菜单 + + + + + 背景透明的工具条 + + + + + 银白色至白色渐变 + + + + + 白色至银白色渐变 + + + + + + + + + + + + + + + 当前工作区窗体所关联并激活的工具栏 + + + + + 模拟运行时的外观 + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 鼠标滑过 + + + + + 控件的高度根据内容自动调整，忽略外部设置 + + + + + 边框宽度 + + + + + 文本和description文本之间的间距 + + + + + 最大显示的项数 + + + + + + + + + + 是否显示说明字段，此属性不影响弹出面板是否显示 + 弹出面板是否显示由DescriptionMember是否设置决定 + + + + + + + + + + + + + + + 下拉列表的布局模式 + + + + + + + + + + 是否允许空 + + + + + + + + + + 测量当前控件应该的高度 + + + + + + 整个可用的绘图表面 + + + + + 右边按钮的绘图表面 + + + + + 绘制边框 + + + + + + 绘制背景 + + + + + + 绘制文本 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前热点项生改变 + + + + + + + + + + + + + + + + + + + + + 通过外能事件获取用于绘制项的文本 + + + + + + + + + + + + + + + + + + + + + + + + + + 标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + + + + + + + + + + + + + + + + + + 排序箭头开始颜色 + + + + + 排序箭头开始颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 控件的背景画布颜色 + 因为控件的边框和过度色都有依靠改变透明度实现渐变，所以一个白色的底版就非常重要 + 使过度色不受控件本身背景色的影响，光不绘制背景不行，要刷上白色背景 + + + + + 控件背景色 + + + + + + + + + + + + + + + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 该项具有输入焦点 + + + + + 鼠标滑过 + + + + + + + + + + The item is not visible. + + + + + The item is partially visible. + + + + + The item is fully visible. + + + + + 布局方式 + + + + + 标准布局 + + + + + 使项带有描述的布局 + + + + + 双击项事件参数 + + + + + + + + + + + + + + + + 项被删除事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 为项绘制带有描述信息的渲染器 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + 默认布局引擎，以类似微软ListView的方式按行排列项 + + + + + 框选的最短开始长度 + + + + + 框选时滚动条的自动滚动速度 + + + + + 用于鼠标框选时，框出了控件中项的显示范围时，自动滚动滚动条 + + + + + 自动滚动时，滚动值 + + + + + 是否处于框选状态中 + + + + + 内框offset，内框offset是绝对相对于滚动条的 + + + + + 整个可显示项的边界的offset，包括上下padding部分 + + + + + 鼠标按下时项区域边界的offset，即 _itemsAreaOffset + 用于框选时，跨越可视部队画框 + + + + + 当前所能显示的最大行数 + + + + + + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + + + + + + + + + + + + + + + + + + + + + 没有任何项 + + + + + 没有任何项处于可显示状态 + + + + + 整个控件区域 + + + + + 整个可用于绘制项的可视区域 + 去除左右Padding部分，去除滚动条 + + + + + 用于绘制项的区域 + 考虑边距间隔大小和滚动条区域 + + + + + 项的尺寸 + 不放在ListView本身中定义而是放在LayoutManager中定义，是因为不同的布局方式 + 可能会是带长宽的Size做为itemSize，比如平铺的方式 + + + + + 项周围的边距 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新整个布局引擎的状态 + + + + + 判断指定的项是否处于可见状态 + + + + + + + 获取项的呈现区域 + + + + + + + + + + + + + + + + + + + + 获取当前所有可见项 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculates the maximum number of rows and columns + that can be fully displayed. + + + + + 计算当前可见项的index范围 + + + + + 更新滚动条状态 + + + + + 创建框选框 + + + + + + 根据矩形区域选择项 + + + + + + 应用导航键，如上下左右，返回应用导航键之后的项的坐标 + + + + + 使指定下标的项处于可见状态 + + + + + + 默认渲染器，不绘制项的实际内容，但是绘制DEBUG信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 用于子类重写时删除相应的缓存 + + + + + + 绘制项的背景 + + The System.Drawing.Graphics to draw on. + The client coordinates of the item area. + + + + 绘制最终的前景 + + + + + + 绘制选择边框 + + The System.Drawing.Graphics to draw on. + The client coordinates of the selection rectangle. + + + + 绘制项的边框 + + + + + + + + 绘制项 + + + + + + + 绘制项的背景 + + + + + + + 绘制项的内容 + + + + + + + + 绘制背景 + + + + + + 绘制当前所有可见项 + + + + + + Renders the selection rectangle. + + The graphics to draw on. + + + + 默认渲染器，以类似微软ListView的方式按行绘制项，只绘制简单的文本 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + + + + + + + + + + + + + + + 项的背景色 + + + + + 控件背景色 + + + + + 项的边框色 + + + + + 选择框颜色 + + + + + 选择框的边框色 + + + + + 当控件具有焦点时选定项的背景色 + + + + + + + + + + 控件失去焦点时选定项的背景色 + + + + + + + + + + 热点项的背景色 + + + + + + + + + + 图像内边框颜色 + + + + + 图像外边框颜色 + + + + + + + + + + Creates a control with a border. + + + + + Specifies that the control has a border with a sunken edge. + + + + + + + + + + 是否需要在调用 ResumeLayout 时重绘 + + + + + 为项扩展的用于呈现的属性 + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + 鼠标左键是否处于按下状态 + + + + + 鼠标右键是否处于按下状态 + + + + + 鼠标最后点击的位置 + + + + + 当前鼠标经过的项 + + + + + + + + + + + + + + + 配色方案 + + + + + 当前布局中项的高度 + + + + + + + + + + 是否没有任何项 + + + + + + + + + + 获取当前具有输入焦点的项 + + + + + 默认的用于呈现为项中文本的Property + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + + 请求在下次调用 ResumeLayout 时重绘 + + + + + 获取当前选中的所有项 + + + + + + + + + + + + 设置扩展属性供特定LayoutEngine使用 + 如果指定的 ExtendMember 已存在，覆盖之 + 用String.Empty 或 null 做为 propertyName传入，表示删除指定的 member + + + + + + + + + + + + + + + + + + + + + 恢复正常的布局逻辑。 + + + + + + + + + + + 临时挂起控件的布局逻辑。 + + + + + + + + + + 获取当前选中项所绑定的对象 + 如果没有选中项，返回null，如果选中多项，返回选中项集合中的第一个 + + + + + + 根据指定的绑定项对象 + 设置当前列表中选定的项 + + + + + + 获取当前选中的所有项的绑定对象集合 + 如果当前没有选中任何项，返回空集合 + + + + + + 取消所有项的选择 + + + + + + + + + + + + + + + + 获取创建控件句柄时所需要的创建参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + 项被删除 + + + + + 通过外能事件获取用于绘制项的文本 + + + + + Represents the color palette of the image list view. + + + + + Gets or sets the background color of the ImageListView control. + + + + + Gets or sets the background color of the ImageListViewItem. + + + + + Gets or sets the background color of alternating cells in Details View. + + + + + Gets or sets the border color of the ImageListViewItem. + + + + + Gets or sets the foreground color of the ImageListViewItem. + + + + + Gets or sets the background gradient color1 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color2 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the border color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the fore color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is hovered. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is hovered. + + + + + Gets or sets the border color of the ImageListViewItem if the item is hovered. + + + + + Gets or sets the color of the insertion caret. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is selected. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is selected. + + + + + Gets or sets the border color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the fore color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the background gradient color1 of the column header. + + + + + Gets or sets the background gradient color2 of the column header. + + + + + Gets or sets the background hover gradient color1 of the column header. + + + + + Gets or sets the background hover gradient color2 of the column header. + + + + + Gets or sets the cells foreground color of the column header text. + + + + + Gets or sets the cells background color if column is selected in Details View. + + + + + Gets or sets the color of the separator in Details View. + + + + + Gets or sets the foreground color of the cell text in Details View. + + + + + Gets or sets the foreground color of alternating cells text in Details View. + + + + + Gets or sets the background color of the image pane. + + + + + Gets or sets the separator line color between image pane and thumbnail view. + + + + + Gets or sets the color of labels in pane view. + + + + + Gets or sets the image inner border color for thumbnails and pane. + + + + + Gets or sets the image outer border color for thumbnails and pane. + + + + + Gets or sets the background color1 of the selection rectangle. + + + + + Gets or sets the background color2 of the selection rectangle. + + + + + Gets or sets the color of the selection rectangle border. + + + + + Initializes a new instance of the ImageListViewColor class. + + + + + Initializes a new instance of the ImageListViewColor class + from its string representation. + + String representation of the object. + + + + Copies color values from the given object. + + The source object. + + + + Represents the default color theme. + + + + + Represents the noir color theme. + + + + + Represents the mandarin color theme. + + + + + Sets the color palette to default colors. + + + + + Sets the color palette to mandarin colors. + + + + + Sets the color palette to noir colors. + + + + + Determines whether all color values of the specified + ImageListViewColor are equal to this instance. + + The object to compare with this instance. + true if the two instances have the same color values; + otherwise false. + + + + Returns a hash code for this instance. + + + A hash code for this instance, suitable for use in + hashing algorithms and data structures like a hash table. + + + + + Returns a string that represents this instance. + + + A string that represents this instance. + + + + + 测试坐标 + + + + + 项的坐标 + + + + + 是否点击了项 + + + + + + + + + + + + + + + + + + + + + + 该项当前的选中状态 + + + + + + + + + + + + + + + + + + + + 所绑定的对象 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将指定的事件移动到(紧邻)另一个事件之前 + + + + + + + 将指定的事件移动到(紧邻)另一个事件之后 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Modify a WinForms TreeView control to use the new Explorer style theme + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + WM_COPYDATA消息所要求的数据结构 + + + + + + + + + + + + + + + + + + + + + + + + + 通过窗口的标题来查找窗口的句柄 + + + + + + + + 发送 Windows 消息 + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 发送消息，只能传递一个自定义的消息ID和消息字符串，想传一个结构，但没成功 + + 目标进程名称，如果有多个，则给每个都发送 + 自定义数据，可以通过这个来决定如何解析下面的strMsg + 传递的消息，是一个字符串 + + + + 接收消息，得到消息字符串 + + System.Windows.Forms.Message m + 接收到的消息字符串 + + + + + + + + + 最大圆角半径 + + + + + 最小矩形边长，用于自动处理圆角大小 + + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + 填充区域针对矩形的缩进距离 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + + + + 使图片单色化 + + + + + + + 获取颜色 + + + + + + + + + + + + + 颜色变化时激发 + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + The top left rectangle in auto hide strip area. + + + + + The top right rectangle in auto hide strip area. + + + + + The bottom left rectangle in auto hide strip area. + + + + + The bottom right rectangle in auto hide strip area. + + + + + Gets one of the four auto hide strip rectangles. + + Dock state. + The desired rectangle. + + As the corners are represented by , , , and , + the four strips can be easily calculated out as the borders. + + + + + Context menu. + + + This property should be obsolete as it does not support theming. Please use instead. + + + + + Context menu strip. + + + + + Overridden to avoid resize issues with nested controls + + + http://blogs.msdn.com/b/alejacma/archive/2008/11/20/controls-won-t-get-resized-once-the-nesting-hierarchy-of-windows-exceeds-a-certain-depth-x64.aspx + http://support.microsoft.com/kb/953934 + + + + + Determines whether the close button is visible on the content + + + + + There's a bug in the WinForms layout engine + that can result in a deferred layout to not + properly clear out the cached layout args after + the layout operation is performed. + Specifically, this bug is hit when the bounds of + the Pane change, initiating a layout on the parent + (DockWindow) which is where the bug hits. + To work around it, when a pane loses the DockWindow + as its parent, that parent DockWindow needs to + perform a layout to flush the cached args, if they exist. + + + + + Gets a value indicating whether dock panel can be dragged when in auto hide mode. + Default is false. + + + + + Determines the color with which the client rectangle will be drawn. + If this property is used instead of the BackColor it will not have any influence on the borders to the surrounding controls (DockPane). + The BackColor property changes the borders of surrounding controls (DockPane). + Alternatively both properties may be used (BackColor to draw and define the color of the borders and DockBackColor to define the color of the client rectangle). + For Backgroundimages: Set your prefered Image, then set the DockBackColor and the BackColor to the same Color (Control) + + + + + Dock area. + + + This is the center rectangle of control. + + Excluded spaces are for the following visual elements, + * Auto hide strips on four sides. + * Necessary paddings defined in themes. + + Therefore, all dock contents mainly fall into this area (except auto hide window, which might slightly move beyond this area). + + + + + Flag to show autohide content on mouse hover. Default value is true. + + + This flag is ignored in VS2012/2013 themes. Such themes assume it is always false. + + + + + DragHandlerBase is the base class for drag handlers. The derived class should: + 1. Define its public method BeginDrag. From within this public BeginDrag method, + DragHandlerBase.BeginDrag should be called to initialize the mouse capture + and message filtering. + 2. Override the OnDragging and OnEndDrag methods. + + + + + Loads layout from XML file. + + The file name. + Deserialization handler. + Deserialization might throw exceptions. + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + Deserialization might throw exceptions. + + The stream is closed after deserialization. + + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + The flag to close the stream after deserialization. + Deserialization might throw exceptions. + + + + Deserialization handler of layout file/stream. + + Strings stored in layout file/stream. + Dock content deserialized from layout/stream. + + The deserialization handler method should handle all possible exceptions. + + If any exception happens during deserialization and is not handled, the program might crash or experience other issues. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The skin to use when displaying the DockPanel. + The skin allows custom gradient color schemes to be used when drawing the + DockStrips and Tabs. + + + + + The skin used to display the auto hide strips and tabs. + + + + + The skin used to display the Document and ToolWindow style DockStrips and Tabs. + + + + + The skin used to display the auto hide strip and tabs. + + + + + The gradient color skin for the DockStrips. + + + + + The gradient color skin for the Tabs. + + + + + The gradient color skin for the Tabs. + + + + + Font used in AutoHideStrip elements. + + + + + The skin used to display the document and tool strips and tabs. + + + + + The skin used to display the Document style DockPane strip and tab. + + + + + The skin used to display the ToolWindow style DockPane strip and tab. + + + + + Font used in DockPaneStrip elements. + + + + + The skin used to display the DockPane ToolWindow strip and tab. + + + + + The skin used to display the active ToolWindow caption. + + + + + The skin used to display the inactive ToolWindow caption. + + + + + The skin used to display the DockPane strip and tab. + + + + + The gradient color skin for the DockStrip. + + + + + The skin used to display the active DockPane tabs. + + + + + The skin used to display the inactive DockPane tabs. + + + + + The skin used to display the dock pane tab + + + + + The text color. + + + + + The skin used to display the dock pane tab + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient color skin. + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient mode to display the colors. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Dock window base class. + + + + + Dock window of Visual Studio 2003/2005 theme. + + + + + The location to draw the DockPaneStrip for Document style windows. + + + + + + + + + + + + + + + Gets images for tabs and captions. + + + + + + + + + + Gets images for docking indicators. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Switches a pane with its first child in the pane hierarchy. (The actual hiding happens elsewhere.) + + Pane to switch + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Determines whether the close button is visible on the content + + + + + Calculate which tabs are displayed and in what order. + + + + + Visual Studio 2005 theme (default theme). + + + + + + + + + + X for this inside the logical strip rectangle. + + + + + Width of this . + + + + + Dock window of Visual Studio 2012 Light theme. + + + + + Initializes a new instance of the class. + + The dock panel. + State of the dock. + + + + Determines whether the close button is visible on the content + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculate which tabs are displayed and in what order. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 theme base. + + + + + + + + + + + + + + + + diff --git a/Bin/Debug/CommonControls/.NET4 示例/RyPrint.dll b/Bin/Debug/CommonControls/.NET4 示例/RyPrint.dll index c639d9e..4d5e46b 100644 Binary files a/Bin/Debug/CommonControls/.NET4 示例/RyPrint.dll and b/Bin/Debug/CommonControls/.NET4 示例/RyPrint.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/System.dll b/Bin/Debug/CommonControls/.NET4 示例/System.dll new file mode 100644 index 0000000..d7ad7de Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/System.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/System.xml b/Bin/Debug/CommonControls/.NET4 示例/System.xml new file mode 100644 index 0000000..8a75a56 --- /dev/null +++ b/Bin/Debug/CommonControls/.NET4 示例/System.xml @@ -0,0 +1,46205 @@ + + + + System + + + + Provides access to instances of the C# code generator and code compiler. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class by using the specified provider options. + A object that contains the provider options from the configuration file. + + is null. + + + Gets an instance of the C# code compiler. + An instance of the C# implementation. + + + Gets an instance of the C# code generator. + An instance of the C# implementation. + + + Gets the file name extension to use when creating source code files. + The file name extension to use for generated source code files. + + + Generates code for the specified class member using the specified text writer and code generator options. + A to generate code for. + The to write to. + The to use when generating the code. + + + Gets a for the specified type of object. + A for the specified type. + The type of object to retrieve a type converter for. + + + Provides access to instances of the Visual Basic code generator and code compiler. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class by using the specified provider options. + A object that contains the provider options from the configuration file. + + is null. + + + Gets an instance of the Visual Basic code compiler. + An instance of the Visual Basic implementation. + 2 + + + Gets an instance of the Visual Basic code generator. + An instance of the Visual Basic implementation. + 2 + + + Gets the file name extension to use when creating source code files. + The file name extension to use for generated source code files. + 2 + + + Generates code for the specified class member using the specified text writer and code generator options. + A to generate code for. + The to write to. + The to use when generating the code. + 1 + + + Gets a for the specified type of object. + A for the specified type. + The type of object to retrieve a type converter for. + 2 + + + Gets a language features identifier. + A that indicates special features of the language. + 2 + + + Defines a credential policy to be used for resource requests that are made using and its derived classes. + + + Initializes a new instance of the class. + + + Returns a that indicates whether the client's credentials are sent with a request for a resource that was made using . + true if the requested resource is in the same domain as the client making the request; otherwise, false. + The that will receive the request. + The that represents the resource being requested. + The that will be sent with the request if this method returns true. + The that will conduct the authentication, if authentication is required. + + + Provides data for the event. + + + Initializes a new instance of the class using the specified power mode event type. + One of the values that represents the type of power mode event. + + + Gets an identifier that indicates the type of the power mode event that has occurred. + One of the values. + + + Represents the method that will handle the event. + The source of the event. When this event is raised by the class, this object is always null. + A that contains the event data. + + + Defines identifiers for power mode events reported by the operating system. + + + The operating system is about to resume from a suspended state. + + + A power mode status notification event has been raised by the operating system. This might indicate a weak or charging battery, a transition between AC power and battery, or another change in the status of the system power supply. + + + The operating system is about to be suspended. + + + Provides data for the event. + + + Initializes a new instance of the class. + One of the values indicating how the session ended. + + + Gets an identifier that indicates how the session ended. + One of the values that indicates how the session ended. + + + Represents the method that will handle the event. + The source of the event. When this event is raised by the class, this object is always null. + A that contains the event data. + + + Provides data for the event. + + + Initializes a new instance of the class using the specified value indicating the type of session close event that is occurring. + One of the that specifies how the session ends. + + + Gets or sets a value indicating whether to cancel the user request to end the session. + true to cancel the user request to end the session; otherwise, false. + + + Gets the reason the session is ending. + One of the values that specifies how the session is ending. + + + Represents the method that will handle the event from the operating system. + The source of the event. When this event is raised by the class, this object is always null. + A that contains the event data. + + + Defines identifiers that represent how the current logon session is ending. + + + The user is logging off and ending the current user session. The operating system continues to run. + + + The operating system is shutting down. + + + Provides data for the event. + + + Initializes a new instance of the class using the specified session change event type identifer. + A that indicates the type of session change event. + + + Gets an identifier that indicates the type of session change event. + A indicating the type of the session change event. + + + Represents the method that will handle the event. + The source of the event. + A indicating the type of the session change event. + + + Defines identifiers used to represent the type of a session switch event. + + + A session has been connected from the console. + + + A session has been disconnected from the console. + + + A session has been connected from a remote connection. + + + A session has been disconnected from a remote connection. + + + A user has logged on to a session. + + + A user has logged off from a session. + + + A session has been locked. + + + A session has been unlocked. + + + A session has changed its status to or from remote controlled mode. + + + Provides access to system event notifications. This class cannot be inherited. + + + Creates a new window timer associated with the system events window. + The ID of the new timer. + Specifies the interval between timer notifications, in milliseconds. + The interval is less than or equal to zero. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed, or the attempt to create the timer did not succeed. + + + Occurs when the user changes the display settings. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when the display settings are changing. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs before the thread that listens for system events is terminated. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when the user adds fonts to or removes fonts from the system. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Invokes the specified delegate using the thread that listens for system events. + A delegate to invoke using the thread that listens for system events. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Terminates the timer specified by the given id. + The ID of the timer to terminate. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed, or the attempt to terminate the timer did not succeed. + + + Occurs when the system is running out of available RAM. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when the user switches to an application that uses a different palette. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when the user suspends or resumes the system. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when the user is logging off or shutting down the system. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when the user is trying to log off or shut down the system. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when the currently logged-in user has changed. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when the user changes the time on the system clock. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when a windows timer interval has expired. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when a user preference has changed. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Occurs when a user preference is changing. + System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications. + The attempt to create a system events window thread did not succeed. + + + Provides data for the event. + + + Initializes a new instance of the class. + The ID number for the timer. + + + Gets the ID number for the timer. + The ID number for the timer. + + + Represents the method that will handle the event. + The source of the event. When this event is raised by the class, this object is always null. + A that contains the event data. + + + Defines identifiers that represent categories of user preferences. + + + Indicates user preferences associated with accessibility features of the system for users with disabilities. + + + Indicates user preferences associated with system colors. This category includes such as the default color of windows or menus. + + + Indicates user preferences associated with the system desktop. This category includes the background image or background image layout of the desktop. + + + Indicates user preferences that are not associated with any other category. + + + Indicates user preferences for icon settings, including icon height and spacing. + + + Indicates user preferences for keyboard settings, such as the key down repeat rate and delay. + + + Indicates user preferences for menu settings, such as menu delays and text alignment. + + + Indicates user preferences for mouse settings, such as double-click time and mouse sensitivity. + + + Indicates user preferences for policy settings, such as user rights and access levels. + + + Indicates the user preferences for system power settings. This category includes power feature settings, such as the idle time before the system automatically enters low power mode. + + + Indicates user preferences associated with the screensaver. + + + Indicates user preferences associated with the dimensions and characteristics of windows on the system. + + + Indicates changes in user preferences for regional settings, such as the character encoding and culture strings. + + + Indicates user preferences associated with visual styles, such as enabling or disabling visual styles and switching from one visual style to another. + + + Provides data for the event. + + + Initializes a new instance of the class using the specified user preference category identifier. + One of the values that indicates the user preference category that has changed. + + + Gets the category of user preferences that has changed. + One of the values that indicates the category of user preferences that has changed. + + + Represents the method that will handle the event. + The source of the event. When this event is raised by the class, this object is always null. + A that contains the event data. + + + Provides data for the event. + + + Initializes a new instance of the class using the specified user preference category identifier. + One of the values that indicate the user preference category that is changing. + + + Gets the category of user preferences that is changing. + One of the values that indicates the category of user preferences that is changing. + + + Represents the method that will handle the event. + The source of the event. When this event is raised by the class, this object is always null. + A that contains the event data. + + + A customizable parser based on the File scheme. + + + Creates a customizable parser based on the File scheme. + + + A customizable parser based on the File Transfer Protocol (FTP) scheme. + + + Creates a customizable parser based on the File Transfer Protocol (FTP) scheme. + + + A customizable parser for a hierarchical URI. + + + Create a customizable parser for a hierarchical URI. + Specify the options for this . + + + Specifies options for a . + + + The parser: + + + The parser allows a registry-based authority. + + + The parser allows a URI with no authority. + + + The scheme does not define a user information part. + + + The scheme does not define a port. + + + The scheme does not define a query part. + + + The scheme does not define a fragment part. + + + The parser does not convert back slashes into forward slashes. + + + The parser does not canonicalize the URI. + + + The parser does not unescape path dots, forward slashes, or back slashes. + + + The parser supports Internationalized Domain Name (IDN) parsing (IDN) of host names. Whether IDN is used is dictated by configuration values. See the Remarks for more information. + + + The parser supports the parsing rules specified in RFC 3987 for International Resource Identifiers (IRI). Whether IRI is used is dictated by configuration values. See the Remarks for more information. + + + A customizable parser based on the Gopher scheme. + + + Creates a customizable parser based on the Gopher scheme. + + + A customizable parser based on the HTTP scheme. + + + Create a customizable parser based on the HTTP scheme. + + + A customizable parser based on the Lightweight Directory Access Protocol (LDAP) scheme. + + + Creates a customizable parser based on the Lightweight Directory Access Protocol (LDAP) scheme. + + + A parser based on the NetPipe scheme for the "Indigo" system. + + + Create a parser based on the NetPipe scheme for the "Indigo" system. + + + A parser based on the NetTcp scheme for the "Indigo" system. + + + Create a parser based on the NetTcp scheme for the "Indigo" system. + + + A customizable parser based on the news scheme using the Network News Transfer Protocol (NNTP). + + + Create a customizable parser based on the news scheme using the Network News Transfer Protocol (NNTP). + + + Provides an object representation of a uniform resource identifier (URI) and easy access to the parts of the URI. + 1 + + + Initializes a new instance of the class from the specified instances of the and classes. + An instance of the class containing the information required to serialize the new instance. + An instance of the class containing the source of the serialized stream associated with the new instance. + The parameter contains a null URI. + The parameter contains a URI that is empty.-or- The scheme specified is not correctly formed. See .-or- The URI contains too many slashes.-or- The password specified in the URI is not valid.-or- The host name specified in URI is not valid.-or- The file name specified in the URI is not valid. -or- The user name specified in the URI is not valid.-or- The host or authority name specified in the URI cannot be terminated by backslashes.-or- The port number specified in the URI is not valid or cannot be parsed.-or- The length of URI exceeds 65519 characters.-or- The length of the scheme specified in the URI exceeds 1023 characters.-or- There is an invalid character sequence in the URI.-or- The MS-DOS path specified in the URI must start with c:\\. + + + Initializes a new instance of the class with the specified URI. + A URI. + + is null. + + is empty.-or- The scheme specified in is not correctly formed. See .-or- contains too many slashes.-or- The password specified in is not valid.-or- The host name specified in is not valid.-or- The file name specified in is not valid. -or- The user name specified in is not valid.-or- The host or authority name specified in cannot be terminated by backslashes.-or- The port number specified in is not valid or cannot be parsed.-or- The length of exceeds 65519 characters.-or- The length of the scheme specified in exceeds 1023 characters.-or- There is an invalid character sequence in .-or- The MS-DOS path specified in must start with c:\\. + + + Initializes a new instance of the class with the specified URI, with explicit control of character escaping. + The URI. + true if is completely escaped; otherwise, false. See Remarks. + + is null. + + is empty or contains only spaces.-or- The scheme specified in is not valid.-or- contains too many slashes.-or- The password specified in is not valid.-or- The host name specified in is not valid.-or- The file name specified in is not valid. -or- The user name specified in is not valid.-or- The host or authority name specified in cannot be terminated by backslashes.-or- The port number specified in is not valid or cannot be parsed.-or- The length of exceeds 65519 characters.-or- The length of the scheme specified in exceeds 1023 characters.-or- There is an invalid character sequence in .-or- The MS-DOS path specified in must start with c:\\. + + + Initializes a new instance of the class with the specified URI. This constructor allows you to specify if the URI string is a relative URI, absolute URI, or is indeterminate. + A string that identifies the resource to be represented by the instance. + Specifies whether the URI string is a relative URI, absolute URI, or is indeterminate. + + is invalid. + + is null. + + contains a relative URI and is .or contains an absolute URI and is .or is empty.-or- The scheme specified in is not correctly formed. See .-or- contains too many slashes.-or- The password specified in is not valid.-or- The host name specified in is not valid.-or- The file name specified in is not valid. -or- The user name specified in is not valid.-or- The host or authority name specified in cannot be terminated by backslashes.-or- The port number specified in is not valid or cannot be parsed.-or- The length of exceeds 65519 characters.-or- The length of the scheme specified in exceeds 1023 characters.-or- There is an invalid character sequence in .-or- The MS-DOS path specified in must start with c:\\. + + + Initializes a new instance of the class based on the specified base URI and relative URI string. + The base URI. + The relative URI to add to the base URI. + + is null. + + is not an absolute instance. + The URI formed by combining and is empty or contains only spaces.-or- The scheme specified in the URI formed by combining and is not valid.-or- The URI formed by combining and contains too many slashes.-or- The password specified in the URI formed by combining and is not valid.-or- The host name specified in the URI formed by combining and is not valid.-or- The file name specified in the URI formed by combining and is not valid. -or- The user name specified in the URI formed by combining and is not valid.-or- The host or authority name specified in the URI formed by combining and cannot be terminated by backslashes.-or- The port number specified in the URI formed by combining and is not valid or cannot be parsed.-or- The length of the URI formed by combining and exceeds 65519 characters.-or- The length of the scheme specified in the URI formed by combining and exceeds 1023 characters.-or- There is an invalid character sequence in the URI formed by combining and .-or- The MS-DOS path specified in must start with c:\\. + + + Initializes a new instance of the class based on the specified base and relative URIs, with explicit control of character escaping. + The base URI. + The relative URI to add to the base URI. + true if is completely escaped; otherwise, false. See Remarks. + + is null. + + is not an absolute instance. + The URI formed by combining and is empty or contains only spaces.-or- The scheme specified in the URI formed by combining and is not valid.-or- The URI formed by combining and contains too many slashes.-or- The password specified in the URI formed by combining and is not valid.-or- The host name specified in the URI formed by combining and is not valid.-or- The file name specified in the URI formed by combining and is not valid. -or- The user name specified in the URI formed by combining and is not valid.-or- The host or authority name specified in the URI formed by combining and cannot be terminated by backslashes.-or- The port number specified in the URI formed by combining and is not valid or cannot be parsed.-or- The length of the URI formed by combining and exceeds 65519 characters.-or- The length of the scheme specified in the URI formed by combining and exceeds 1023 characters.-or- There is an invalid character sequence in the URI formed by combining and .-or- The MS-DOS path specified in must start with c:\\. + + + Initializes a new instance of the class based on the combination of a specified base instance and a relative instance. + An absolute that is the base for the new instance. + A relative instance that is combined with . + + is not an absolute instance. + + is null. + + is not an absolute instance. + The URI formed by combining and is empty or contains only spaces.-or- The scheme specified in the URI formed by combining and is not valid.-or- The URI formed by combining and contains too many slashes.-or- The password specified in the URI formed by combining and is not valid.-or- The host name specified in the URI formed by combining and is not valid.-or- The file name specified in the URI formed by combining and is not valid. -or- The user name specified in the URI formed by combining and is not valid.-or- The host or authority name specified in the URI formed by combining and cannot be terminated by backslashes.-or- The port number specified in the URI formed by combining and is not valid or cannot be parsed.-or- The length of the URI formed by combining and exceeds 65519 characters.-or- The length of the scheme specified in the URI formed by combining and exceeds 1023 characters.-or- There is an invalid character sequence in the URI formed by combining and .-or- The MS-DOS path specified in must start with c:\\. + + + Gets the absolute path of the URI. + A containing the absolute path to the resource. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 1 + + + + + + Gets the absolute URI. + A containing the entire URI. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 1 + + + + + + Gets the Domain Name System (DNS) host name or IP address and the port number for a server. + A containing the authority component of the URI represented by this instance. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 1 + + + + + + Converts the internally stored URI to canonical form. + This instance represents a relative URI, and this method is valid only for absolute URIs. + The URI is incorrectly formed. + + + Determines whether the specified host name is a valid DNS name. + A that indicates the type of the host name. If the type of the host name cannot be determined or if the host name is null or a zero-length string, this method returns . + The host name to validate. This can be an IPv4 or IPv6 address or an Internet host name. + 1 + + + Determines whether the specified scheme name is valid. + A value that is true if the scheme name is valid; otherwise, false. + The scheme name to validate. + 1 + + + Calling this method has no effect. + + + Compares the specified parts of two URIs using the specified comparison rules. + An value that indicates the lexical relationship between the compared components.ValueMeaningLess than zero is less than .Zero equals .Greater than zero is greater than . + The first . + The second . + A bitwise combination of the values that specifies the parts of and to compare. + One of the values that specifies the character escaping used when the URI components are compared. + One of the values. + + is not a valid value. + 1 + + + Gets an unescaped host name that is safe to use for DNS resolution. + A that contains the unescaped host part of the URI that is suitable for DNS resolution; or the original unescaped host string, if it is already suitable for resolution. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Compares two instances for equality. + A value that is true if the two instances represent the same URI; otherwise, false. + The instance or a URI identifier to compare with the current instance. + 2 + + + Converts any unsafe or reserved characters in the path component to their hexadecimal character representations. + The URI passed from the constructor is invalid. This exception can occur if a URI has too many characters or the URI is relative. + + + Converts a string to its escaped representation. + A that contains the escaped representation of . + The string to escape. + + is null. + The length of exceeds 32766 characters. + + + Converts a string to its escaped representation. + The escaped representation of the string. + The string to transform to its escaped representation. + + + Converts a URI string to its escaped representation. + A that contains the escaped representation of . + The string to escape. + + is null. + The length of exceeds 32766 characters. + + + Gets the escaped URI fragment. + A that contains any URI fragment information. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Gets the decimal value of a hexadecimal digit. + An value that contains a number from 0 to 15 that corresponds to the specified hexadecimal digit. + The hexadecimal digit (0-9, a-f, A-F) to convert. + + is not a valid hexadecimal digit (0-9, a-f, A-F). + 1 + + + Gets the specified components of the current instance using the specified escaping for special characters. + A that contains the components. + A bitwise combination of the values that specifies which parts of the current instance to return to the caller. + One of the values that controls how special characters are escaped. + + is not a combination of valid values. + The current is not an absolute URI. Relative URIs cannot be used with this method. + 1 + + + Gets the hash code for the URI. + An containing the hash value generated for this URI. + 2 + + + + + + Gets the specified portion of a instance. + A that contains the specified portion of the instance. + One of the values that specifies the end of the URI portion to return. + The current instance is not an absolute instance. + The specified is not valid. + 2 + + + + + + Returns the data needed to serialize the current instance. + A object containing the information required to serialize the . + A object containing the source and destination of the serialized stream associated with the . + + + Converts a specified character into its hexadecimal equivalent. + The hexadecimal representation of the specified character. + The character to convert to hexadecimal representation. + + is greater than 255. + 1 + + + Converts a specified hexadecimal representation of a character to the character. + The character represented by the hexadecimal encoding at position . If the character at is not hexadecimal encoded, the character at is returned. The value of is incremented to point to the character following the one returned. + The hexadecimal representation of a character. + The location in where the hexadecimal representation of a character begins. + + is less than 0 or greater than or equal to the number of characters in . + 1 + + + Gets the host component of this instance. + A that contains the host name. This is usually the DNS host name or IP address of the server. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 1 + + + + + + Gets the type of the host name specified in the URI. + A member of the enumeration. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 1 + + + + + + Gets whether the instance is absolute. + A value that is true if the instance is absolute; otherwise, false. + 1 + + + Gets whether a character is invalid in a file system name. + A value that is true if the specified character is invalid; otherwise false. + The to test. + + + Determines whether the current instance is a base of the specified instance. + true if the current instance is a base of ; otherwise, false. + The specified instance to test. + + is null. + 2 + + + + + + Gets whether the port value of the URI is the default for this scheme. + A value that is true if the value in the property is the default port for this scheme; otherwise, false. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 1 + + + + + + Gets whether the specified character should be escaped. + A value that is true if the specified character should be escaped; otherwise, false. + The to test. + + + Gets a value indicating whether the specified is a file URI. + A value that is true if the is a file URI; otherwise, false. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 1 + + + + + + Determines whether a specified character is a valid hexadecimal digit. + A value that is true if the character is a valid hexadecimal digit; otherwise false. + The character to validate. + 1 + + + Determines whether a character in a string is hexadecimal encoded. + A value that is true if is hexadecimal encoded at the specified location; otherwise, false. + The string to check. + The location in to check for hexadecimal encoding. + 1 + + + Gets whether the specified references the local host. + A value that is true if this references the local host; otherwise, false. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Gets whether the specified character is a reserved character. + A value that is true if the specified character is a reserved character otherwise, false. + The to test. + + + Gets whether the specified is a universal naming convention (UNC) path. + A value that is true if the is a UNC path; otherwise, false. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Indicates whether the string used to construct this was well-formed and is not required to be further escaped. + A value that is true if the string was well-formed; else false. + + + Indicates whether the string is well-formed by attempting to construct a URI with the string and ensures that the string does not require further escaping. + A value that is true if the string was well-formed; else false. + The string used to attempt to construct a . + The type of the in . + + + Gets a local operating-system representation of a file name. + A that contains the local operating-system representation of a file name. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Determines the difference between two instances. + If the hostname and scheme of this URI instance and are the same, then this method returns a that represents a relative URI that, when appended to the current URI instance, yields the parameter.If the hostname or scheme is different, then this method returns a that represents the parameter. + The URI to compare to the current URI. + + is null. + This instance represents a relative URI, and this method is valid only for absolute URIs. + 2 + + + + + + Determines the difference between two instances. + If the hostname and scheme of this URI instance and are the same, then this method returns a relative that, when appended to the current URI instance, yields .If the hostname or scheme is different, then this method returns a that represents the parameter. + The URI to compare to the current URI. + + is null. + This instance represents a relative URI, and this property is valid only for absolute URIs. + + + Determines whether two instances have the same value. + A value that is true if the instances are equivalent; otherwise, false. + A instance to compare with . + A instance to compare with . + 3 + + + + + + Determines whether two instances do not have the same value. + A value that is true if the two instances are not equal; otherwise, false. If either parameter is null, this method returns true. + A instance to compare with . + A instance to compare with . + 3 + + + + + + Gets the original URI string that was passed to the constructor. + A containing the exact URI specified when this instance was constructed; otherwise, . + This instance represents a relative URI, and this property is valid only for absolute URIs. + 1 + + + + + + Parses the URI of the current instance to ensure it contains all the parts required for a valid URI. + The Uri passed from the constructor is invalid. + + + Gets the and properties separated by a question mark (?). + A that contains the and properties separated by a question mark (?). + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Gets the port number of this URI. + An value that contains the port number for this URI. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Gets any query information included in the specified URI. + A that contains any query information included in the specified URI. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Gets the scheme name for this URI. + A that contains the scheme for this URI, converted to lowercase. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Specifies the characters that separate the communication protocol scheme from the address portion of the URI. This field is read-only. + 1 + + + Gets an array containing the path segments that make up the specified URI. + A array that contains the path segments that make up the specified URI. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 2 + + + + + + Returns the data needed to serialize the current instance. + A object containing the information required to serialize the . + A object containing the source and destination of the serialized stream associated with the . + + + Gets a canonical string representation for the specified instance. + A instance that contains the unescaped canonical representation of the instance. All characters are unescaped except #, ?, and %. + 2 + + + + + + Creates a new using the specified instance and a . + A value that is true if the was successfully created; otherwise, false. + The representing the . + The type of the Uri. + When this method returns, contains the constructed . + + + Creates a new using the specified base and relative instances. + A value that is true if the was successfully created; otherwise, false. + The base . + The relative , represented as a , to add to the base . + When this method returns, contains a constructed from and . This parameter is passed uninitialized. + + + Creates a new using the specified base and relative instances. + A value that is true if the was successfully created; otherwise, false. + The base . + The relative to add to the base . + When this method returns, contains a constructed from and . This parameter is passed uninitialized. + + is null. + 1 + + + Converts the specified string by replacing any escape sequences with their unescaped representation. + A that contains the unescaped value of the parameter. + The to convert. + + + Converts a string to its unescaped representation. + A that contains the unescaped representation of . + The string to unescape. + + is null. + + + Specifies that the URI is a pointer to a file. This field is read-only. + 1 + + + Specifies that the URI is accessed through the File Transfer Protocol (FTP). This field is read-only. + 1 + + + Specifies that the URI is accessed through the Gopher protocol. This field is read-only. + 1 + + + Specifies that the URI is accessed through the Hypertext Transfer Protocol (HTTP). This field is read-only. + 1 + + + Specifies that the URI is accessed through the Secure Hypertext Transfer Protocol (HTTPS). This field is read-only. + 1 + + + Specifies that the URI is an e-mail address and is accessed through the Simple Mail Transport Protocol (SMTP). This field is read-only. + 1 + + + Specifies that the URI is accessed through the NetPipe scheme used by Windows Communication Foundation (WCF). This field is read-only. + + + Specifies that the URI is accessed through the NetTcp scheme used by Windows Communication Foundation (WCF). This field is read-only. + + + Specifies that the URI is an Internet news group and is accessed through the Network News Transport Protocol (NNTP). This field is read-only. + 1 + + + Specifies that the URI is an Internet news group and is accessed through the Network News Transport Protocol (NNTP). This field is read-only. + 1 + + + Indicates that the URI string was completely escaped before the instance was created. + A value that is true if the parameter was set to true when the instance was created; otherwise, false. + 2 + + + Gets the user name, password, or other user-specific information associated with the specified URI. + A that contains the user information associated with the URI. The returned value does not include the '@' character reserved for delimiting the user information part of the URI. + This instance represents a relative URI, and this property is valid only for absolute URIs. + 1 + + + + + + Provides a custom constructor for uniform resource identifiers (URIs) and modifies URIs for the class. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified URI. + A URI string. + + is null. + + is a zero length string or contains only spaces.-or- The parsing routine detected a scheme in an invalid form.-or- The parser detected more than two consecutive slashes in a URI that does not use the "file" scheme.-or- is not a valid URI. + + + Initializes a new instance of the class with the specified scheme and host. + An Internet access protocol. + A DNS-style domain name or IP address. + + + Initializes a new instance of the class with the specified scheme, host, and port. + An Internet access protocol. + A DNS-style domain name or IP address. + An IP port number for the service. + + is less than -1 or greater than 65,535. + + + Initializes a new instance of the class with the specified scheme, host, port number, and path. + An Internet access protocol. + A DNS-style domain name or IP address. + An IP port number for the service. + The path to the Internet resource. + + is less than -1 or greater than 65,535. + + + Initializes a new instance of the class with the specified scheme, host, port number, path and query string or fragment identifier. + An Internet access protocol. + A DNS-style domain name or IP address. + An IP port number for the service. + The path to the Internet resource. + A query string or fragment identifier. + + is neither null nor , nor does a valid fragment identifier begin with a number sign (#), nor a valid query string begin with a question mark (?). + + is less than -1 or greater than 65,535. + + + Initializes a new instance of the class with the specified instance. + An instance of the class. + + is null. + + + Compares an existing instance with the contents of the for equality. + true if represents the same as the constructed by this instance; otherwise, false. + The object to compare with the current instance. + 2 + + + Gets or sets the fragment portion of the URI. + The fragment portion of the URI. The fragment identifier ("#") is added to the beginning of the fragment. + 2 + + + Returns the hash code for the URI. + The hash code generated for the URI. + 2 + + + + + + Gets or sets the Domain Name System (DNS) host name or IP address of a server. + The DNS host name or IP address of the server. + 1 + + + Gets or sets the password associated with the user that accesses the URI. + The password of the user that accesses the URI. + 1 + + + Gets or sets the path to the resource referenced by the URI. + The path to the resource referenced by the URI. + 1 + + + Gets or sets the port number of the URI. + The port number of the URI. + The port cannot be set to a value less than -1 or greater than 65,535. + 1 + + + Gets or sets any query information included in the URI. + The query information included in the URI. + 1 + + + Gets or sets the scheme name of the URI. + The scheme of the URI. + The scheme cannot be set to an invalid scheme name. + 1 + + + Returns the display string for the specified instance. + The string that contains the unescaped display string of the . + The instance has a bad password. + 1 + + + + + + Gets the instance constructed by the specified instance. + A that contains the URI constructed by the . + The URI constructed by the properties is invalid. + 1 + + + The user name associated with the user that accesses the URI. + The user name of the user that accesses the URI. + 1 + + + Specifies the parts of a . + 1 + + + The data. + + + The data. + + + The data. + + + The data. + + + The data. + + + The data. + + + The data. + + + The data. If no port data is in the and a default port has been assigned to the , the default port is returned. If there is no default port, -1 is returned. + + + Specifies that the delimiter should be included. + + + The complete context that is needed for Uri Serializers. The context includes the IPv6 scope. + + + The , , , , , , and data. + + + The and data. If no port data is in the Uri and a default port has been assigned to the , the default port is returned. If there is no default port, -1 is returned. + + + The , , and data. If no port data is in the and a default port has been assigned to the , the default port is returned. If there is no default port, -1 is returned. + + + The , , and data. + + + The , , , , and data. + + + The and data. Also see . + + + Controls how URI information is escaped. + 1 + + + Escaping is performed according to the rules in RFC 2396. + + + No escaping is performed. + + + Characters that have a reserved meaning in the requested URI components remain escaped. All others are not escaped. See Remarks. + + + The exception that is thrown when an invalid Uniform Resource Identifier (URI) is detected. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class from the specified and instances. + A that contains the information that is required to serialize the new . + A that contains the source of the serialized stream that is associated with the new . + + + Initializes a new instance of the class with the specified message. + The error message string. + + + Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception. + The message that describes the exception. The caller of this constructor is required to ensure that this string has been localized for the current system culture. + The exception that is the cause of the current exception. If the parameter is not null, the current exception is raised in a catch block that handles the inner exception. + + + Populates a instance with the data that is needed to serialize the . + A that will hold the serialized data for the . + A that contains the destination of the serialized stream that is associated with the new . + + + Defines host name types for the method. + 2 + + + The type of the host name is not supplied. + + + The host is set, but the type cannot be determined. + + + The host name is a domain name system (DNS) style host name. + + + The host name is an Internet Protocol (IP) version 4 host address. + + + The host name is an Internet Protocol (IP) version 6 host address. + + + Provides the possible values for the configuration setting of the in the namespace. + + + This value will not convert any Unicode domain names to use Punycode. This is the default value which is consistent with the .NET Framework 2.0 behavior. + + + This value will convert all external Unicode domain names to use the Punycode equivalents (IDN names). In this case to handle international names on the local Intranet, the DNS servers that are used for the Intranet should support Unicode names. + + + This value will convert any Unicode domain names to their Punycode equivalents (IDN names). + + + Defines the kinds of s for the and several methods. + + + The kind of the Uri is indeterminate. + + + The Uri is an absolute Uri. + + + The Uri is a relative Uri. + + + Parses a new URI scheme. This is an abstract class. + + + Constructs a default URI parser. + + + Gets the components from a URI. + A string that contains the components. + The URI to parse. + The to retrieve from . + One of the values that controls how special characters are escaped. + + is invalid.- or - is not a combination of valid values. + + requires user-driven parsing- or - is not an absolute URI. Relative URIs cannot be used with this method. + + + Initialize the state of the parser and validate the URI. + The T:System.Uri to validate. + Validation errors, if any. + + + Determines whether is a base URI for . + true if is a base URI for ; otherwise, false. + The base URI. + The URI to test. + + + Indicates whether the parser for a scheme is registered. + true if has been registered; otherwise, false. + The scheme name to check. + The parameter is null. + The parameter is not valid. + + + Indicates whether a URI is well-formed. + true if is well-formed; otherwise, false. + The URI to check. + + + Invoked by a constructor to get a instance + A for the constructed . + + + Invoked by the Framework when a method is registered. + The scheme that is associated with this . + The port number of the scheme. + + + Associates a scheme and port number with a . + The URI parser to register. + The name of the scheme that is associated with this parser. + The default port number for the specified scheme. + + parameter is null- or - parameter is null. + + parameter is not valid- or - parameter is not valid. The parameter is less than -1 or greater than 65,534. + + + Called by constructors and to resolve a relative URI. + The string of the resolved relative . + A base URI. + A relative URI. + Errors during the resolve process, if any. + + parameter is not an absolute - or - parameter requires user-driven parsing. + + + Defines the parts of a URI for the method. + 2 + + + The scheme segment of the URI. + + + The scheme and authority segments of the URI. + + + The scheme, authority, and path segments of the URI. + + + The scheme, authority, path, and query segments of the URI. + + + Converts a type to a type, and vice versa. + + + Initializes a new instance of the class. + + + Returns whether this converter can convert an object of the given type to the type of this converter. + true if is a type or a type can be assigned from ; otherwise, false. + An that provides a format context. + A that represents the type that you want to convert from. + The parameter is null. + + + Returns whether this converter can convert the object to the specified type, using the specified context. + true if is of type , , or ; otherwise, false. + An that provides a format context. + A that represents the type that you want to convert to. + + + Converts the given object to the type of this converter, using the specified context and culture information. + An that represents the converted value. + An that provides a format context. + The to use as the current culture. + The to convert. + The conversion cannot be performed. + + + Converts a given value object to the specified type, using the specified context and culture information. + An that represents the converted value. + An that provides a format context. + A . If null is passed, the current culture is assumed. + The to convert. + The to convert the parameter to. + The parameter is null. + The conversion cannot be performed. + + + Returns whether the given value object is a or a can be created from it. + true if is a or a from which a can be created; otherwise, false. + An that provides a format context. + The to test for validity. + + + Represents a reference to the value of an argument passed to a method. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified parameter name. + The name of the parameter to reference. + + + Gets or sets the name of the parameter this expression references. + The name of the parameter to reference. + + + Represents an expression that creates an array. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified array data type and code expression indicating the number of indexes for the array. + A indicating the data type of the array to create. + An expression that indicates the number of indexes of the array to create. + + + Initializes a new instance of the class using the specified array data type and initialization expressions. + A that indicates the data type of the array to create. + An array of expressions to use to initialize the array. + + + Initializes a new instance of the class using the specified array data type and number of indexes for the array. + A indicating the data type of the array to create. + The number of indexes of the array to create. + + + Initializes a new instance of the class using the specified array data type name and code expression indicating the number of indexes for the array. + The name of the data type of the array to create. + An expression that indicates the number of indexes of the array to create. + + + Initializes a new instance of the class using the specified array data type name and initializers. + The name of the data type of the array to create. + An array of expressions to use to initialize the array. + + + Initializes a new instance of the class using the specified array data type name and number of indexes for the array. + The name of the data type of the array to create. + The number of indexes of the array to create. + + + Initializes a new instance of the class using the specified array data type and code expression indicating the number of indexes for the array. + The data type of the array to create. + An expression that indicates the number of indexes of the array to create. + + + Initializes a new instance of the class using the specified array data type and initializers. + The data type of the array to create. + An array of expressions to use to initialize the array. + + + Initializes a new instance of the class using the specified array data type and number of indexes for the array. + The data type of the array to create. + The number of indexes of the array to create. + + + Gets or sets the type of array to create. + A that indicates the type of the array. + + + Gets the initializers with which to initialize the array. + A that indicates the initialization values. + + + Gets or sets the number of indexes in the array. + The number of indexes in the array. + + + Gets or sets the expression that indicates the size of the array. + A that indicates the size of the array. + + + Represents a reference to an index of an array. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified target object and indexes. + A that indicates the array the indexer targets. + The index or indexes to reference. + + + Gets or sets the index or indexes of the indexer expression. + A that indicates the index or indexes of the indexer expression. + + + Gets or sets the target object of the array indexer. + A that represents the array being indexed. + + + Represents a simple assignment statement. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified expressions. + The variable to assign to. + The value to assign. + + + Gets or sets the expression representing the object or reference to assign to. + A that indicates the object or reference to assign to. + + + Gets or sets the expression representing the object or reference to assign. + A that indicates the object or reference to assign. + + + Represents a statement that attaches an event-handler delegate to an event. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified event and delegate. + A that indicates the event to attach an event handler to. + A that indicates the new event handler. + + + Initializes a new instance of the class using the specified object containing the event, event name, and event-handler delegate. + A that indicates the object that contains the event. + The name of the event to attach an event handler to. + A that indicates the new event handler. + + + Gets or sets the event to attach an event-handler delegate to. + A that indicates the event to attach an event handler to. + + + Gets or sets the new event-handler delegate to attach to the event. + A that indicates the new event handler to attach. + + + Represents an argument used in a metadata attribute declaration. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified value. + A that represents the value of the argument. + + + Initializes a new instance of the class using the specified name and value. + The name of the attribute property the argument applies to. + A that represents the value of the argument. + + + Gets or sets the name of the attribute. + The name of the attribute property the argument is for. + + + Gets or sets the value for the attribute argument. + A that indicates the value for the attribute argument. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class containing the specified array of objects. + An array of objects with which to initialize the collection. + One or more objects in the array are null. + + + Initializes a new instance of the class containing the elements of the specified source collection. + A with which to initialize the collection. + + is null. + + + Adds the specified object to the collection. + The index at which the new element was inserted. + The object to add. + + + Copies the elements of the specified array to the end of the collection. + An array of type that contains the objects to add to the collection. + + is null. + + + Copies the contents of another object to the end of the collection. + A that contains the objects to add to the collection. + + is null. + + + Gets a value that indicates whether the collection contains the specified object. + true if the collection contains the specified object; otherwise, false. + The object to locate in the collection. + + + Copies the collection objects to a one-dimensional instance beginning at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index of the specified object in the collection, if it exists in the collection. + The index of the specified object, if found, in the collection; otherwise, -1. + The object to locate in the collection. + + + Inserts the specified object into the collection at the specified index. + The zero-based index where the specified object should be inserted. + The object to insert. + + + Gets or sets the object at the specified index in the collection. + A at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified object from the collection. + The object to remove from the collection. + The specified object is not found in the collection. + + + Represents an attribute declaration. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified code type reference. + The that identifies the attribute. + + + Initializes a new instance of the class using the specified code type reference and arguments. + The that identifies the attribute. + An array of type that contains the arguments for the attribute. + + + Initializes a new instance of the class using the specified name. + The name of the attribute. + + + Initializes a new instance of the class using the specified name and arguments. + The name of the attribute. + An array of type that contains the arguments for the attribute. + + + Gets the arguments for the attribute. + A that contains the arguments for the attribute. + + + Gets the code type reference for the code attribute declaration. + A that identifies the . + + + Gets or sets the name of the attribute being declared. + The name of the attribute. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class containing the specified array of objects. + An array of objects with which to initialize the collection. + One or more objects in the array are null. + + + Initializes a new instance of the class containing the elements of the specified source collection. + A with which to initialize the collection. + + is null. + + + Adds a object with the specified value to the collection. + The index at which the new element was inserted. + The object to add. + + + Copies the elements of the specified array to the end of the collection. + An array of type that contains the objects to add to the collection. + + is null. + + + Copies the contents of another object to the end of the collection. + A that contains the objects to add to the collection. + + is null. + + + Gets or sets a value that indicates whether the collection contains the specified object. + true if the collection contains the specified object; otherwise, false. + The object to locate. + + + Copies the collection objects to a one-dimensional instance beginning at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index of the specified object in the collection, if it exists in the collection. + The index in the collection of the specified object, if found; otherwise, -1. + The object to locate in the collection. + + + Inserts the specified object into the collection at the specified index. + The zero-based index where the specified object should be inserted. + The object to insert. + + + Gets or sets the object at the specified index. + A at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified object from the collection. + The object to remove from the collection. + The specified object is not found in the collection. + + + Represents a reference to the base class. + + + Initializes a new instance of the class. + + + Represents an expression that consists of a binary operation between two expressions. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified parameters. + The on the left of the operator. + A indicating the type of operator. + The on the right of the operator. + + + Gets or sets the code expression on the left of the operator. + A that indicates the left operand. + + + Gets or sets the operator in the binary operator expression. + A that indicates the type of operator in the expression. + + + Gets or sets the code expression on the right of the operator. + A that indicates the right operand. + + + Defines identifiers for supported binary operators. + + + Addition operator. + + + Subtraction operator. + + + Multiplication operator. + + + Division operator. + + + Modulus operator. + + + Assignment operator. + + + Identity not equal operator. + + + Identity equal operator. + + + Value equal operator. + + + Bitwise or operator. + + + Bitwise and operator. + + + Boolean or operator. This represents a short circuiting operator. A short circuiting operator will evaluate only as many expressions as necessary before returning a correct value. + + + Boolean and operator. This represents a short circuiting operator. A short circuiting operator will evaluate only as many expressions as necessary before returning a correct value. + + + Less than operator. + + + Less than or equal operator. + + + Greater than operator. + + + Greater than or equal operator. + + + Represents an expression cast to a data type or interface. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified destination type and expression. + A that indicates the destination type of the cast. + The to cast. + + + Initializes a new instance of the class using the specified destination type and expression. + The name of the destination type of the cast. + The to cast. + + + Initializes a new instance of the class using the specified destination type and expression. + The destination data type of the cast. + The to cast. + + + Gets or sets the expression to cast. + A that indicates the code to cast. + + + Gets or sets the destination type of the cast. + A that indicates the destination type to cast to. + + + Represents a catch exception block of a try/catch statement. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified local variable name for the exception. + The name of the local variable declared in the catch clause for the exception. This is optional. + + + Initializes a new instance of the class using the specified local variable name for the exception and exception type. + The name of the local variable declared in the catch clause for the exception. This is optional. + A that indicates the type of exception to catch. + + + Initializes a new instance of the class using the specified local variable name for the exception, exception type and statement collection. + The name of the local variable declared in the catch clause for the exception. This is optional. + A that indicates the type of exception to catch. + An array of objects that represent the contents of the catch block. + + + Gets or sets the type of the exception to handle with the catch block. + A that indicates the type of the exception to handle. + + + Gets or sets the variable name of the exception that the catch clause handles. + The name for the exception variable that the catch clause handles. + + + Gets the statements within the catch block. + A containing the statements within the catch block. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class containing the specified array of objects. + An array of objects with which to initialize the collection. + One or more objects in the array are null. + + + Initializes a new instance of the class containing the elements of the specified source collection. + A with which to initialize the collection. + + is null. + + + Adds the specified object to the collection. + The index at which the new element was inserted. + The object to add. + + + Copies the elements of the specified array to the end of the collection. + An array of type that contains the objects to add to the collection. + + is null. + + + Copies the contents of another object to the end of the collection. + A that contains the objects to add to the collection. + + is null. + + + Gets a value that indicates whether the collection contains the specified object. + true if the collection contains the specified object; otherwise, false. + The object to locate in the collection. + + + Copies the collection objects to a one-dimensional instance beginning at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index of the specified object in the collection, if it exists in the collection. + The index of the specified object, if found, in the collection; otherwise, -1. + The object to locate in the collection. + + + Inserts the specified object into the collection at the specified index. + The zero-based index where the specified object should be inserted. + The object to insert. + + + Gets or sets the object at the specified index in the collection. + A object at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified object from the collection. + The object to remove from the collection. + The specified object is not found in the collection. + + + Represents a code checksum pragma code entity. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using a file name, a GUID representing the checksum algorithm, and a byte stream representing the checksum data. + The path to the checksum file. + A that identifies the checksum algorithm to use. + A byte array that contains the checksum data. + + + Gets or sets a GUID that identifies the checksum algorithm to use. + A that identifies the checksum algorithm to use. + + + Gets or sets the value of the data for the checksum calculation. + A byte array that contains the data for the checksum calculation. + + + Gets or sets the path to the checksum file. + The path to the checksum file. + + + Represents a comment. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified text as contents. + The contents of the comment. + + + Initializes a new instance of the class using the specified text and documentation comment flag. + The contents of the comment. + true if the comment is a documentation comment; otherwise, false. + + + Gets or sets a value that indicates whether the comment is a documentation comment. + true if the comment is a documentation comment; otherwise, false. + + + Gets or sets the text of the comment. + A string containing the comment text. + + + Represents a statement consisting of a single comment. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified comment. + A that indicates the comment. + + + Initializes a new instance of the class using the specified text as contents. + The contents of the comment. + + + Initializes a new instance of the class using the specified text and documentation comment flag. + The contents of the comment. + true if the comment is a documentation comment; otherwise, false. + + + Gets or sets the contents of the comment. + A that indicates the comment. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class containing the specified array of objects. + An array of objects with which to initialize the collection. + One or more objects in the array are null. + + + Initializes a new instance of the class containing the elements of the specified source collection. + A with which to initialize the collection. + + is null. + + + Adds the specified object to the collection. + The index at which the new element was inserted. + The object to add. + + + Copies the elements of the specified array to the end of the collection. + An array of type that contains the objects to add to the collection. + + is null. + + + Copies the contents of another object to the end of the collection. + A that contains the objects to add to the collection. + + is null. + + + Gets a value that indicates whether the collection contains the specified object. + true if the collection contains the specified object; otherwise, false. + The to search for in the collection. + + + Copies the collection objects to the specified one-dimensional beginning at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index of the specified object in the collection, if it exists in the collection. + The index of the specified object, if found, in the collection; otherwise, -1. + The object to locate. + + + Inserts a object into the collection at the specified index. + The zero-based index where the item should be inserted. + The object to insert. + + + Gets or sets the object at the specified index in the collection. + A object at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified object from the collection. + The object to remove from the collection. + The specified object is not found in the collection. + + + Provides a container for a CodeDOM program graph. + + + Initializes a new instance of the class. + + + Gets a collection of custom attributes for the generated assembly. + A that indicates the custom attributes for the generated assembly. + + + Gets a object containing end directives. + A object containing end directives. + + + Gets the collection of namespaces. + A that indicates the namespaces that the compile unit uses. + + + Gets the referenced assemblies. + A that contains the file names of the referenced assemblies. + + + Gets a object containing start directives. + A object containing start directives. + + + Represents a conditional branch statement, typically represented as an if statement. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified condition and statements. + A that indicates the expression to evaluate. + An array of type containing the statements to execute if the condition is true. + + + Initializes a new instance of the class using the specified condition and statements. + A that indicates the condition to evaluate. + An array of type containing the statements to execute if the condition is true. + An array of type containing the statements to execute if the condition is false. + + + Gets or sets the expression to evaluate true or false. + A to evaluate true or false. + + + Gets the collection of statements to execute if the conditional expression evaluates to false. + A containing the statements to execute if the conditional expression evaluates to false. + + + Gets the collection of statements to execute if the conditional expression evaluates to true. + A containing the statements to execute if the conditional expression evaluates to true. + + + Represents a declaration for an instance constructor of a type. + + + Initializes a new instance of the class. + + + Gets the collection of base constructor arguments. + A that contains the base constructor arguments. + + + Gets the collection of chained constructor arguments. + A that contains the chained constructor arguments. + + + Represents a reference to a default value. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified code type reference. + A that specifies the reference to a value type. + + + Gets or sets the data type reference for a default value. + A object representing a data type that has a default value. + + + Represents an expression that creates a delegate. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + A that indicates the data type of the delegate. + A that indicates the object containing the event-handler method. + The name of the event-handler method. + + + Gets or sets the data type of the delegate. + A that indicates the data type of the delegate. + + + Gets or sets the name of the event handler method. + The name of the event handler method. + + + Gets or sets the object that contains the event-handler method. + A that indicates the object containing the event-handler method. + + + Represents an expression that raises an event. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified target object. + A that indicates the target object. + + + Initializes a new instance of the class using the specified target object and parameters. + A that indicates the target object. + An array of objects that indicate the parameters. + + + Gets or sets the parameters to pass to the event handling methods attached to the event. + A that indicates the parameters to pass to the event handling methods attached to the event. + + + Gets or sets the event to invoke. + A that indicates the event to invoke. + + + Represents an expression used as a method invoke parameter along with a reference direction indicator. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified field direction and expression. + A that indicates the field direction of the expression. + A that indicates the code expression to represent. + + + Gets or sets the field direction for this direction expression. + A that indicates the field direction for this direction expression. + + + Gets or sets the code expression to represent. + A that indicates the expression to represent. + + + Serves as the base class for code directive classes. + + + Initializes a new instance of the class. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the code directive objects in the specified array. + An array of objects with which to initialize the collection. + + is null. + + + Initializes a new instance of the class with the elements in the specified code directive collection. + A object with which to initialize the collection. + + is null. + + + Adds the specified object to the collection. + The index position at which the new element was inserted. + The object to add. + + + Adds an array of objects to the end of the collection. + An array of objects to add to the collection. + + is null. + + + Adds the contents of the specified object to the end of the collection. + A object containing the objects to add to the collection. + + is null. + + + Gets a value indicating whether the collection contains the specified object. + true if the collection contains the specified object; otherwise, false. + The object to search for in the collection. + + + Copies the contents of the collection to a one-dimensional array beginning at the specified index. + An array of type that is the destination of the values copied from the collection. + The index in the array at which to begin inserting collection objects. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by and the end of the target array. + + is null. + + is less than the target array's minimum index. + + + Gets the index in the collection of the specified object, if it exists in the collection. + The index position in the collection of the specified object, if found; otherwise, -1. + The object to locate in the collection. + + + Inserts the specified object into the collection at the specified index. + The zero-based index position where the specified object should be inserted. + The object to insert. + + is less than 0. -or- is greater than . + + + Gets or sets the object at the specified index in the collection. + The at the index position. + The index position to access. + + is outside the valid range of index positions for the collection. + + + Removes the specified object from the collection. + The object to remove from the collection. + The specified object is not found in the collection. + + + Represents the entry point method of an executable. + + + Initializes a new instance of the class. + + + Represents a reference to an event. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified target object and event name. + A that indicates the object that contains the event. + The name of the event to reference. + + + Gets or sets the name of the event. + The name of the event. + + + Gets or sets the object that contains the event. + A that indicates the object that contains the event. + + + Represents a code expression. This is a base class for other code expression objects that is never instantiated. + + + Initializes a new instance of the class. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class containing the specified array of objects. + An array of objects with which to initialize the collection. + One or more objects in the array are null. + + + Initializes a new instance of the class containing the elements of the specified source collection. + A with which to initialize the collection. + + is null. + + + Adds the specified object to the collection. + The index at which the new element was inserted. + The object to add. + + + Copies the elements of the specified array to the end of the collection. + An array of type that contains the objects to add to the collection. + + is null. + + + Copies the contents of another object to the end of the collection. + A that contains the objects to add to the collection. + + is null. + + + Gets a value that indicates whether the collection contains the specified object. + true if the collection contains the specified object; otherwise, false. + The object to locate in the collection. + + + Copies the collection objects to a one-dimensional instance beginning at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index of the specified object in the collection, if it exists in the collection. + The index of the specified object, if found, in the collection; otherwise, -1. + The object to locate in the collection. + + + Inserts the specified object into the collection at the specified index. + The zero-based index where the specified object should be inserted. + The object to insert. + + + Gets or sets the object at the specified index in the collection. + A object at each valid index. + The zero-based index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified object from the collection. + The object to remove from the collection. + The specified object is not found in the collection. + + + Represents a statement that consists of a single expression. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class by using the specified expression. + A for the statement. + + + Gets or sets the expression for the statement. + A that indicates the expression for the statement. + + + Represents a reference to a field. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified target object and field name. + A that indicates the object that contains the field. + The name of the field. + + + Gets or sets the name of the field to reference. + A string containing the field name. + + + Gets or sets the object that contains the field to reference. + A that indicates the object that contains the field to reference. + + + Represents a goto statement. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified label name. + The name of the label at which to continue program execution. + + is null. + + + Gets or sets the name of the label at which to continue program execution. + A string that indicates the name of the label at which to continue program execution. + The label cannot be set because is null or an empty string. + + + Represents a reference to an indexer property of an object. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified target object and index. + The target object. + The index or indexes of the indexer expression. + + + Gets the collection of indexes of the indexer expression. + A that indicates the index or indexes of the indexer expression. + + + Gets or sets the target object that can be indexed. + A that indicates the indexer object. + + + Represents a for statement, or a loop through a block of statements, using a test expression as a condition for continuing to loop. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified parameters. + A containing the loop initialization statement. + A containing the expression to test for exit condition. + A containing the per-cycle increment statement. + An array of type containing the statements within the loop. + + + Gets or sets the statement that is called after each loop cycle. + A that indicates the per cycle increment statement. + + + Gets or sets the loop initialization statement. + A that indicates the loop initialization statement. + + + Gets the collection of statements to be executed within the loop. + An array of type that indicates the statements within the loop. + + + Gets or sets the expression to test as the condition that continues the loop. + A that indicates the expression to test. + + + Represents a labeled statement or a stand-alone label. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified label name. + The name of the label. + + + Initializes a new instance of the class using the specified label name and statement. + The name of the label. + The to associate with the label. + + + Gets or sets the name of the label. + The name of the label. + + + Gets or sets the optional associated statement. + A that indicates the statement associated with the label. + + + Represents a specific location within a specific file. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + The file name of the associated file. + The line number to store a reference to. + + + Gets or sets the name of the associated file. + The file name of the associated file. + + + Gets or sets the line number of the associated reference. + The line number. + + + Represents a declaration for an event of a type. + + + Initializes a new instance of the class. + + + Gets or sets the data type that the member event implements. + A that indicates the data type or types that the member event implements. + + + Gets or sets the privately implemented data type, if any. + A that indicates the data type that the event privately implements. + + + Gets or sets the data type of the delegate type that handles the event. + A that indicates the delegate type that handles the event. + + + Represents a declaration for a field of a type. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified field type and field name. + An object that indicates the type of the field. + The name of the field. + + + Initializes a new instance of the class using the specified field type and field name. + The type of the field. + The name of the field. + + + Initializes a new instance of the class using the specified field type and field name. + The type of the field. + The name of the field. + + + Gets or sets the initialization expression for the field. + The initialization expression for the field. + + + Gets or sets the type of the field. + The type of the field. + + + Represents a declaration for a method of a type. + + + Initializes a new instance of the class. + + + Gets the data types of the interfaces implemented by this method, unless it is a private method implementation, which is indicated by the property. + A that indicates the interfaces implemented by this method. + + + Gets the parameter declarations for the method. + A that indicates the method parameters. + + + An event that will be raised the first time the collection is accessed. + + + An event that will be raised the first time the collection is accessed. + + + An event that will be raised the first time the collection is accessed. + + + Gets or sets the data type of the interface this method, if private, implements a method of, if any. + A that indicates the data type of the interface with the method that the private method whose declaration is represented by this implements. + + + Gets or sets the data type of the return value of the method. + A that indicates the data type of the value returned by the method. + + + Gets the custom attributes of the return type of the method. + A that indicates the custom attributes. + + + Gets the statements within the method. + A that indicates the statements within the method. + + + Gets the type parameters for the current generic method. + A that contains the type parameters for the generic method. + + + Represents a declaration for a property of a type. + + + Initializes a new instance of the class. + + + Gets the collection of get statements for the property. + A that contains the get statements for the member property. + + + Gets or sets a value indicating whether the property has a get method accessor. + true if the Count property of the collection is non-zero, or if the value of this property has been set to true; otherwise, false. + + + Gets or sets a value indicating whether the property has a set method accessor. + true if the property of the collection is non-zero; otherwise, false. + + + Gets the data types of any interfaces that the property implements. + A that indicates the data types the property implements. + + + Gets the collection of declaration expressions for the property. + A that indicates the declaration expressions for the property. + + + Gets or sets the data type of the interface, if any, this property, if private, implements. + A that indicates the data type of the interface, if any, the property, if private, implements. + + + Gets the collection of set statements for the property. + A that contains the set statements for the member property. + + + Gets or sets the data type of the property. + A that indicates the data type of the property. + + + Represents an expression that invokes a method. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified target object, method name, and parameters. + A that indicates the target object with the method to invoke. + The name of the method to invoke. + An array of objects that indicate the parameters to call the method with. + + + Initializes a new instance of the class using the specified method and parameters. + A that indicates the method to invoke. + An array of objects that indicate the parameters with which to invoke the method. + + + Gets or sets the method to invoke. + A that indicates the method to invoke. + + + Gets the parameters to invoke the method with. + A that indicates the parameters to invoke the method with. + + + Represents a reference to a method. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified target object and method name. + A that indicates the object to target. + The name of the method to call. + + + Initializes a new instance of the class using the specified target object, method name, and generic type arguments. + A that indicates the object to target. + The name of the method to call. + An array of values that specify the for this . + + + Gets or sets the name of the method to reference. + The name of the method to reference. + + + Gets or sets the expression that indicates the method to reference. + A that represents the method to reference. + + + Gets the type arguments for the current generic method reference expression. + A containing the type arguments for the current code . + + + Represents a return value statement. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified expression. + A that indicates the return value. + + + Gets or sets the return value. + A that indicates the value to return for the return statement, or null if the statement is part of a subroutine. + + + Represents a namespace declaration. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified name. + The name of the namespace being declared. + + + Gets the comments for the namespace. + A that indicates the comments for the namespace. + + + Gets the collection of namespace import directives used by the namespace. + A that indicates the namespace import directives used by the namespace. + + + Gets or sets the name of the namespace. + The name of the namespace. + + + An event that will be raised the first time the collection is accessed. + + + An event that will be raised the first time the collection is accessed. + + + An event that will be raised the first time the collection is accessed. + + + Gets the collection of types that the namespace contains. + A that indicates the types contained in the namespace. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class that contains the specified array of objects. + An array of objects with which to initialize the collection. + One or more objects in the array are null. + + + Initializes a new instance of the class that contains the elements of the specified source collection. + The with which to initialize the collection. + + is null. + + + Adds the specified object to the collection. + The index at which the new element was inserted. + The to add. + + + Copies the elements of the specified array to the end of the collection. + An array of type that contains the objects to add to the collection. + + is null. + + + Adds the contents of the specified object to the end of the collection. + A that contains the objects to add to the collection. + + is null. + + + Gets a value that indicates whether the collection contains the specified object. + true if the is contained in the collection; otherwise, false. + The to search for in the collection. + + + Copies the collection objects to a one-dimensional instance, starting at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index of the specified object in the , if it exists in the collection. + The index of the specified , if it is found, in the collection; otherwise, -1. + The to locate. + + + Inserts the specified object into the collection at the specified index. + The zero-based index where the new item should be inserted. + The to insert. + + + Gets or sets the object at the specified index in the collection. + A at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified object from the collection. + The to remove from the collection. + The specified object is not found in the collection. + + + Represents a namespace import directive that indicates a namespace to use. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified namespace to import. + The name of the namespace to import. + + + Gets or sets the line and file the statement occurs on. + A that indicates the context of the statement. + + + Gets or sets the namespace to import. + The name of the namespace to import. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Adds a object to the collection. + The object to add to the collection. + + + Adds a set of objects to the collection. + An array of type that contains the objects to add to the collection. + + is null. + + + Clears the collection of members. + + + Gets the number of namespaces in the collection. + The number of namespaces in the collection. + + + Gets an enumerator that enumerates the collection members. + An that indicates the collection members. + + + Gets or sets the object at the specified index in the collection. + A object at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Copies the elements of the to an , starting at a particular index. + The one-dimensional that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + + + Gets the number of elements contained in the . + The number of elements contained in the . + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. This property always returns false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . This property always returns null. + + + Returns an enumerator that can iterate through a collection. + An that can be used to iterate through the collection. + + + Adds an object to the . + The position at which the new element was inserted. + The to add to the . + + + Removes all items from the . + + + Determines whether the contains a specific value. + true if the value is in the list; otherwise, false. + The to locate in the . + + + Determines the index of a specific item in the . + The index of if it is found in the list; otherwise, -1. + The to locate in the . + + + Inserts an item in the at the specified position. + The zero-based index at which should be inserted. + The to insert into the . + + + Gets a value indicating whether the has a fixed size. + true if the has a fixed size; otherwise, false. This property always returns false. + + + Gets a value indicating whether the is read-only. + true if the is read-only; otherwise, false. This property always returns false. + + + Gets or sets the element at the specified index. + The element at the specified index. + The zero-based index of the element to get or set. + + + Removes the first occurrence of a specific object from the . + The to remove from the . + + + Removes the element at the specified index of the . + The zero-based index of the element to remove. + + + Provides a common base class for most Code Document Object Model (CodeDOM) objects. + + + Initializes a new instance of the class. + + + Gets the user-definable data for the current object. + An containing user data for the current object. + + + Represents an expression that creates a new instance of a type. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified type and parameters. + A that indicates the data type of the object to create. + An array of objects that indicates the parameters to use to create the object. + + + Initializes a new instance of the class using the specified type and parameters. + The name of the data type of object to create. + An array of objects that indicates the parameters to use to create the object. + + + Initializes a new instance of the class using the specified type and parameters. + The data type of the object to create. + An array of objects that indicates the parameters to use to create the object. + + + Gets or sets the data type of the object to create. + A to the data type of the object to create. + + + Gets or sets the parameters to use in creating the object. + A that indicates the parameters to use when creating the object. + + + Represents a parameter declaration for a method, property, or constructor. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified parameter type and name. + An object that indicates the type of the parameter to declare. + The name of the parameter to declare. + + + Initializes a new instance of the class using the specified parameter type and name. + The type of the parameter to declare. + The name of the parameter to declare. + + + Initializes a new instance of the class using the specified parameter type and name. + The type of the parameter to declare. + The name of the parameter to declare. + + + Gets or sets the custom attributes for the parameter declaration. + An object that indicates the custom attributes. + + + Gets or sets the direction of the field. + An object that indicates the direction of the field. + + + Gets or sets the name of the parameter. + The name of the parameter. + + + Gets or sets the type of the parameter. + The type of the parameter. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class containing the specified array of objects. + An array of objects with which to initialize the collection. + one or more objects in the array are null. + + + Initializes a new instance of the class containing the elements of the specified source collection. + A with which to initialize the collection. + + is null. + + + Adds the specified to the collection. + The index at which the new element was inserted. + The to add. + + + Copies the elements of the specified array to the end of the collection. + An array of type containing the objects to add to the collection. + + is null. + + + Adds the contents of another to the end of the collection. + A containing the objects to add to the collection. + + is null. + + + Gets a value indicating whether the collection contains the specified . + true if the collection contains the specified object; otherwise, false. + A to search for in the collection. + + + Copies the collection objects to a one-dimensional instance beginning at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index in the collection of the specified , if it exists in the collection. + The index in the collection of the specified object, if found; otherwise, -1. + The to locate in the collection. + + + Inserts the specified into the collection at the specified index. + The zero-based index where the specified object should be inserted. + The to insert. + + + Gets or sets the at the specified index in the collection. + A at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified from the collection. + The to remove from the collection. + The specified object is not found in the collection. + + + Represents a primitive data type value. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified object. + The object to represent. + + + Gets or sets the primitive data type to represent. + The primitive data type instance to represent the value of. + + + Represents a reference to the value of a property. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified target object and property name. + A that indicates the object that contains the property to reference. + The name of the property to reference. + + + Gets or sets the name of the property to reference. + The name of the property to reference. + + + Gets or sets the object that contains the property to reference. + A that indicates the object that contains the property to reference. + + + Represents the value argument of a property set method call within a property set method. + + + Initializes a new instance of the class. + + + Specifies the name and mode for a code region. + + + Initializes a new instance of the class with default values. + + + Initializes a new instance of the class, specifying its mode and name. + One of the values. + The name for the region. + + + Gets or sets the mode for the region directive. + One of the values. The default is . + + + Gets or sets the name of the region. + The name of the region. + + + Specifies the start or end of a code region. + + + Not used. + + + Start of the region. + + + End of the region. + + + Represents a statement that removes an event handler. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified event and event handler. + A that indicates the event to detach the event handler from. + A that indicates the event handler to remove. + + + Initializes a new instance of the class using the specified target object, event name, and event handler. + A that indicates the object that contains the event. + The name of the event. + A that indicates the event handler to remove. + + + Gets or sets the event to remove a listener from. + A that indicates the event to remove a listener from. + + + Gets or sets the event handler to remove. + A that indicates the event handler to remove. + + + Represents a literal code fragment that can be compiled. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + The literal code fragment to represent. + + + Gets or sets the line and file information about where the code is located in a source code document. + A that indicates the position of the code fragment. + + + Gets or sets the literal code fragment to represent. + The literal code fragment. + + + Represents a literal expression. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified literal expression. + The literal expression to represent. + + + Gets or sets the literal string of code. + The literal string. + + + Represents a statement using a literal code fragment. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified code fragment. + The literal code fragment of the statement to represent. + + + Gets or sets the literal code fragment statement. + The literal code fragment statement. + + + Represents a member of a type using a literal code fragment. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified text. + The literal code fragment for the type member. + + + Gets or sets the literal code fragment for the type member. + The literal code fragment for the type member. + + + Represents the abstract base class from which all code statements derive. + + + Initializes a new instance of the class. + + + Gets a object that contains end directives. + A object containing end directives. + + + Gets or sets the line on which the code statement occurs. + A object that indicates the context of the code statement. + + + Gets a object that contains start directives. + A object containing start directives. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class that contains the specified array of objects. + An array of objects with which to initialize the collection. + + is null. + + + Initializes a new instance of the class that contains the elements of the specified source collection. + A object with which to initialize the collection. + + is null. + + + Adds the specified object to the collection. + The index at which the new element was inserted. + The object to add. + + + Adds the specified object to the collection. + The index at which the new element was inserted. + The object to add. + + + Adds a set of objects to the collection. + An array of objects to add to the collection. + + is null. + + + Adds the contents of another object to the end of the collection. + A object that contains the objects to add to the collection. + + is null. + + + Gets a value that indicates whether the collection contains the specified object. + true if the collection contains the specified object; otherwise, false. + The object to search for in the collection. + + + Copies the elements of the object to a one-dimensional instance, starting at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index of the specified object in the , if it exists in the collection. + The index of the specified object, if it is found, in the collection; otherwise, -1. + The to locate in the collection. + + + Inserts the specified object into the collection at the specified index. + The zero-based index where the specified object should be inserted. + The object to insert. + + + Gets or sets the object at the specified index in the collection. + A at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified object from the collection. + The to remove from the collection. + The specified object is not found in the collection. + + + Represents a reference to the current local class instance. + + + Initializes a new instance of the class. + + + Represents a statement that throws an exception. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified exception type instance. + A that indicates the exception to throw. + + + Gets or sets the exception to throw. + A representing an instance of the exception to throw. + + + Represents a try block with any number of catch clauses and, optionally, a finally block. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified statements for try and catch clauses. + An array of objects that indicate the statements to try. + An array of objects that indicate the clauses to catch. + + + Initializes a new instance of the class using the specified statements for try, catch clauses, and finally statements. + An array of objects that indicate the statements to try. + An array of objects that indicate the clauses to catch. + An array of objects that indicate the finally statements to use. + + + Gets the catch clauses to use. + A that indicates the catch clauses to use. + + + Gets the finally statements to use. + A that indicates the finally statements. + + + Gets the statements to try. + A that indicates the statements to try. + + + Represents a static constructor for a class. + + + Initializes a new instance of the class. + + + Represents a type declaration for a class, structure, interface, or enumeration. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified name. + The name for the new type. + + + Gets the base types of the type. + A object that indicates the base types of the type. + + + Gets or sets a value indicating whether the type is a class or reference type. + true if the type is a class or reference type; otherwise, false. + + + Gets or sets a value indicating whether the type is an enumeration. + true if the type is an enumeration; otherwise, false. + + + Gets or sets a value indicating whether the type is an interface. + true if the type is an interface; otherwise, false. + + + Gets or sets a value indicating whether the type declaration is complete or partial. + true if the class or structure declaration is a partial representation of the implementation; false if the declaration is a complete implementation of the class or structure. The default is false. + + + Gets or sets a value indicating whether the type is a value type (struct). + true if the type is a value type; otherwise, false. + + + Gets the collection of class members for the represented type. + A object that indicates the class members. + + + Occurs when the collection is accessed for the first time. + + + Occurs when the collection is accessed for the first time. + + + Gets or sets the attributes of the type. + A object that indicates the attributes of the type. + + + Gets the type parameters for the type declaration. + A that contains the type parameters for the type declaration. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class that contains the specified array of objects. + An array of objects with which to initialize the collection. + + + Initializes a new instance of the class that contains the elements of the specified source collection. + A object with which to initialize the collection. + + + Adds the specified object to the collection. + The index at which the new element was inserted. + The object to add. + + + Copies the elements of the specified array to the end of the collection. + An array of type that contains the objects to add to the collection. + + is null. + + + Adds the contents of another object to the end of the collection. + A object that contains the objects to add to the collection. + + is null. + + + Gets a value that indicates whether the collection contains the specified object. + true if the collection contains the specified object; otherwise, false. + The object to search for in the collection. + + + Copies the elements in the object to a one-dimensional instance, starting at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index of the specified object in the , if it exists in the collection. + The index of the specified object, if it is found, in the collection; otherwise, -1. + The to locate in the collection. + + + Inserts the specified object into the collection at the specified index. + The zero-based index where the specified object should be inserted. + The object to insert. + + + Gets or sets the object at the specified index in the collection. + A at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified object from the collection. + The to remove from the collection. + The specified object is not found in the collection. + + + Represents a delegate declaration. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + The name of the delegate. + + + Gets the parameters of the delegate. + A that indicates the parameters of the delegate. + + + Gets or sets the return type of the delegate. + A that indicates the return type of the delegate. + + + Provides a base class for a member of a type. Type members include fields, methods, properties, constructors and nested types. + + + Initializes a new instance of the class. + + + Gets or sets the attributes of the member. + A bitwise combination of the values used to indicate the attributes of the member. The default value is | . + + + Gets the collection of comments for the type member. + A that indicates the comments for the member. + + + Gets or sets the custom attributes of the member. + A that indicates the custom attributes of the member. + + + Gets the end directives for the member. + A object containing end directives. + + + Gets or sets the line on which the type member statement occurs. + A object that indicates the location of the type member declaration. + + + Gets or sets the name of the member. + The name of the member. + + + Gets the start directives for the member. + A object containing start directives. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class containing the specified array of objects. + An array of objects with which to initialize the collection. + + + Initializes a new instance of the class containing the elements of the specified source collection. + A with which to initialize the collection. + + + Adds a with the specified value to the collection. + The index at which the new element was inserted. + The to add. + + + Copies the elements of the specified array to the end of the collection. + An array of type containing the objects to add to the collection. + + is null. + + + Adds the contents of another to the end of the collection. + A containing the objects to add to the collection. + + is null. + + + Gets a value indicating whether the collection contains the specified . + true if the collection contains the specified object; otherwise, false. + The to search for in the collection. + + + Copies the collection objects to a one-dimensional instance, beginning at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The destination array is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index in the collection of the specified , if it exists in the collection. + The index in the collection of the specified object, if found; otherwise, -1. + The to locate in the collection. + + + Inserts the specified into the collection at the specified index. + The zero-based index where the specified object should be inserted. + The to insert. + + + Gets or sets the at the specified index in the collection. + A at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes a specific from the collection. + The to remove from the collection. + The specified object is not found in the collection. + + + Represents a typeof expression, an expression that returns a for a specified type name. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + A that indicates the data type for the typeof expression. + + + Initializes a new instance of the class using the specified type. + The name of the data type for the typeof expression. + + + Initializes a new instance of the class using the specified type. + The data type of the data type of the typeof expression. + + + Gets or sets the data type referenced by the typeof expression. + A that indicates the data type referenced by the typeof expression. This property will never return null, and defaults to the type. + + + Represents a type parameter of a generic type or method. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified type parameter name. + The name of the type parameter. + + + Gets the constraints for the type parameter. + A object that contains the constraints for the type parameter. + + + Gets the custom attributes of the type parameter. + A that indicates the custom attributes of the type parameter. The default is null. + + + Gets or sets a value indicating whether the type parameter has a constructor constraint. + true if the type parameter has a constructor constraint; otherwise, false. The default is false. + + + Gets or sets the name of the type parameter. + The name of the type parameter. The default is an empty string (""). + + + Represents a collection of objects. + + + Initializes a new, empty instance of the class. + + + Initializes a new instance of the class containing the specified array of objects. + An array of objects with which to initialize the collection. + + + Initializes a new instance of the class containing the elements of the specified source collection. + A with which to initialize the collection. + + + Adds the specified object to the collection. + The zero-based index at which the new element was inserted. + The to add. + + + Adds the specified object to the collection using the specified data type name. + The name of a data type for which to add the object to the collection. + + + Copies the elements of the specified array to the end of the collection. + An array of type containing the objects to add to the collection. + + is null. + + + Copies the elements of the specified to the end of the collection. + A containing the objects to add to the collection. + + is null. + + + Determines whether the collection contains the specified object. + true if the object is contained in the collection; otherwise, false. + The object to search for in the collection. + + + Copies the items in the collection to the specified one-dimensional at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + + is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by and the end of the target array. + + is null. + + is less than the target array's lowest index. + + + Gets the index in the collection of the specified object, if it exists in the collection. + The zero-based index of the specified object in the collection if found; otherwise, -1. + The object to locate in the collection. + + + Inserts the specified object into the collection at the specified index. + The zero-based index at which to insert the item. + The object to insert. + + + Gets or sets the object at the specified index in the collection. + The object at the specified index. + The zero-based index of the collection object to access. + + is outside the valid range of indexes for the collection. + + + Removes the specified object from the collection. + The object to remove from the collection. + The specified object is not found in the collection. + + + Represents a reference to a type. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified code type parameter. + A that represents the type of the type parameter. + + + Initializes a new instance of the class using the specified array type and rank. + A that indicates the type of the array. + The number of dimensions in the array. + + + Initializes a new instance of the class using the specified type name. + The name of the type to reference. + + + Initializes a new instance of the class using the specified type name and type arguments. + The name of the type to reference. + An array of values. + + + Initializes a new instance of the class using the specified type name and code type reference option. + The name of the type to reference. + The code type reference option, one of the values. + + + Initializes a new instance of the class using the specified array type name and rank. + The name of the type of the elements of the array. + The number of dimensions of the array. + + + Initializes a new instance of the class using the specified type. + The to reference. + + is null. + + + Initializes a new instance of the class using the specified type and code type reference. + The to reference. + The code type reference option, one of the values. + + + Gets or sets the type of the elements in the array. + A that indicates the type of the array elements. + + + Gets or sets the array rank of the array. + The number of dimensions of the array. + + + Gets or sets the name of the type being referenced. + The name of the type being referenced. + + + Gets or sets the code type reference option. + A bitwise combination of the values. + + + Gets the type arguments for the current generic type reference. + A containing the type arguments for the current object. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class containing the specified array of objects. + An array of objects with which to initialize the collection. + + + Initializes a new instance of the class containing the elements of the specified source collection. + A with which to initialize the collection. + + + Adds the specified to the collection. + The index at which the new element was inserted. + The to add. + + + Adds a to the collection using the specified data type name. + The name of a data type for which to add a to the collection. + + + Adds a to the collection using the specified data type. + The data type for which to add a to the collection. + + + Copies the elements of the specified array to the end of the collection. + An array of type containing the objects to add to the collection. + + is null. + + + Adds the contents of the specified to the end of the collection. + A containing the objects to add to the collection. + + is null. + + + Gets a value indicating whether the collection contains the specified . + true if the is contained in the collection; otherwise, false. + The to search for in the collection. + + + Copies the items in the collection to the specified one-dimensional at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The index of the array at which to begin inserting. + The parameter is multidimensional.-or- The number of elements in the is greater than the available space between the index of the target array specified by the parameter and the end of the target array. + The parameter is null. + The parameter is less than the target array's minimum index. + + + Gets the index in the collection of the specified , if it exists in the collection. + The index of the specified in the collection if found; otherwise, -1. + The to locate in the collection. + + + Inserts a into the collection at the specified index. + The zero-based index where the item should be inserted. + The to insert. + + + Gets or sets the at the specified index in the collection. + A at each valid index. + The index of the collection to access. + The parameter is outside the valid range of indexes for the collection. + + + Removes the specified from the collection. + The to remove from the collection. + The specified object is not found in the collection. + + + Represents a reference to a data type. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified type. + A that indicates the data type to reference. + + + Initializes a new instance of the class using the specified data type name. + The name of the data type to reference. + + + Initializes a new instance of the class using the specified data type. + An instance of the data type to reference. + + + Gets or sets the data type to reference. + A that indicates the data type to reference. + + + Specifies how the code type reference is to be resolved. + + + Resolve the type from the root namespace. + + + Resolve the type from the type parameter. + + + Represents a variable declaration. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified type and name. + A that indicates the data type of the variable. + The name of the variable. + + + Initializes a new instance of the class using the specified data type, variable name, and initialization expression. + A that indicates the type of the variable. + The name of the variable. + A that indicates the initialization expression for the variable. + + + Initializes a new instance of the class using the specified data type name and variable name. + The name of the data type of the variable. + The name of the variable. + + + Initializes a new instance of the class using the specified data type, variable name, and initialization expression. + The name of the data type of the variable. + The name of the variable. + A that indicates the initialization expression for the variable. + + + Initializes a new instance of the class using the specified data type and variable name. + The data type for the variable. + The name of the variable. + + + Initializes a new instance of the class using the specified data type, variable name, and initialization expression. + The data type of the variable. + The name of the variable. + A that indicates the initialization expression for the variable. + + + Gets or sets the initialization expression for the variable. + A that indicates the initialization expression for the variable. + + + Gets or sets the name of the variable. + The name of the variable. + + + Gets or sets the data type of the variable. + A that indicates the data type of the variable. + + + Represents a reference to a local variable. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified local variable name. + The name of the local variable to reference. + + + Gets or sets the name of the local variable to reference. + The name of the local variable to reference. + + + Defines identifiers used to indicate the direction of parameter and argument declarations. + + + An incoming field. + + + An outgoing field. + + + A field by reference. + + + Defines member attribute identifiers for class members. + + + An abstract member. + + + A member that cannot be overridden in a derived class. + + + A static member. In Visual Basic, this is equivalent to the Shared keyword. + + + A member that overrides a base class member. + + + A constant member. + + + A new member. + + + An overloaded member. Some languages, such as Visual Basic, require overloaded members to be explicitly indicated. + + + A member that is accessible to any class within the same assembly. + + + A member that is accessible within its class, and derived classes in the same assembly. + + + A member that is accessible within the family of its class and derived classes. + + + A member that is accessible within its class, its derived classes in any assembly, and any class in the same assembly. + + + A private member. + + + A public member. + + + An access mask. + + + A scope mask. + + + A VTable mask. + + + Provides an example implementation of the interface. + + + Initializes a new instance of the class. + + + Gets the command arguments to be passed to the compiler from the specified . + The command arguments. + A that indicates the compiler options. + + + Gets the name of the compiler executable. + The name of the compiler executable. + + + Gets the file name extension to use for source files. + The file name extension to use for source files. + + + Compiles the specified compile unit using the specified options, and returns the results from the compilation. + The results of compilation. + A object that indicates the compiler options. + A object that indicates the source to compile. + + is null. + + + Compiles the specified compile units using the specified options, and returns the results from the compilation. + The results of compilation. + A object that indicates the compiler options. + An array of objects that indicates the source to compile. + + is null.-or- is null. + + + Compiles the specified file using the specified options, and returns the results from the compilation. + The results of compilation. + A object that indicates the compiler options. + The file name to compile. + + is null. -or- is null. + + + Compiles the specified files using the specified options, and returns the results from the compilation. + The results of compilation. + A object that indicates the compiler options. + An array of strings that indicates the file names of the files to compile. + + is null.-or- is null. + + + Compiles the specified source code string using the specified options, and returns the results from the compilation. + The results of compilation. + A object that indicates the compiler options. + The source code string to compile. + + is null. + + + Compiles the specified source code strings using the specified options, and returns the results from the compilation. + The results of compilation. + A object that indicates the compiler options. + An array of strings containing the source code to compile. + + is null.-or- is null. + + + Gets the command arguments to use when invoking the compiler to generate a response file. + The command arguments to use to generate a response file, or null if there are no response file arguments. + A object that indicates the compiler options. + A command arguments string. + + + Joins the specified string arrays. + The concatenated string. + The array of strings to join. + The separator to use. + + + Processes the specified line from the specified . + A that indicates the results of compilation. + The line to process. + + + For a description of this member, see . + The results of compilation. + A object that indicates the compiler options. + A that indicates the source to compile. + + is null. + + + For a description of this member, see . + The results of compilation. + A object that indicates the compiler options. + An array of objects that indicates the source to compile. + + + For a description of this member, see . + The results of compilation. + A object that indicates the compiler options. + The file name to compile. + + is null. + + + For a description of this member, see . + The results of compilation. + A object that indicates the compiler options. + An array of strings that indicates the file names to compile. + + + For a description of this member, see . + The results of compilation. + A object that indicates the compiler options. + A string that indicates the source code to compile. + + is null. + + + For a description of this member, see . + The results of compilation. + A object that indicates the compiler options. + An array of strings that indicates the source code to compile. + + is null. + + + Provides a base class for implementations. This class is abstract. + + + Initializes a new instance of the class. + + + Compiles an assembly based on the trees contained in the specified array of objects, using the specified compiler settings. + A object that indicates the results of the compilation. + A object that indicates the settings for the compilation. + An array of type that indicates the code to compile. + Neither this method nor the method is overridden in a derived class. + + + Compiles an assembly from the source code contained in the specified files, using the specified compiler settings. + A object that indicates the results of compilation. + A object that indicates the settings for the compilation. + An array of the names of the files to compile. + Neither this method nor the method is overridden in a derived class. + + + Compiles an assembly from the specified array of strings containing source code, using the specified compiler settings. + A object that indicates the results of compilation. + A object that indicates the compiler settings for this compilation. + An array of source code strings to compile. + Neither this method nor the method is overridden in a derived class. + + + When overridden in a derived class, creates a new code compiler. + An that can be used for compilation of based source code representations. + + + Creates an escaped identifier for the specified value. + The escaped identifier for the value. + The string for which to create an escaped identifier. + Neither this method nor the method is overridden in a derived class. + + + When overridden in a derived class, creates a new code generator. + An that can be used to generate based source code representations. + + + When overridden in a derived class, creates a new code generator using the specified for output. + An that can be used to generate based source code representations. + A to use to output. + + + When overridden in a derived class, creates a new code generator using the specified file name for output. + An that can be used to generate based source code representations. + The file name to output to. + + + When overridden in a derived class, creates a new code parser. + An that can be used to parse source code. The base implementation always returns null. + + + Gets a instance for the specified language. + A CodeDOM provider that is implemented for the specified language name. + The language name. + The does not have a configured provider on this computer. + The is null. + The caller does not have the required permission. + + + Gets a instance for the specified language and provider options. + A CodeDOM provider that is implemented for the specified language name and options. + The language name. + A collection of provider options from the configuration file. + + + Creates a valid identifier for the specified value. + A valid identifier for the specified value. + The string for which to generate a valid identifier. + Neither this method nor the method is overridden in a derived class. + + + Gets the default file name extension to use for source code files in the current language. + A file name extension corresponding to the extension of the source files of the current language. The base implementation always returns . + + + Generates code for the specified Code Document Object Model (CodeDOM) compilation unit and sends it to the specified text writer, using the specified options. + A for which to generate code. + The to which the output code is sent. + A that indicates the options to use for generating code. + Neither this method nor the method is overridden in a derived class. + + + Generates code for the specified Code Document Object Model (CodeDOM) expression and sends it to the specified text writer, using the specified options. + A object that indicates the expression for which to generate code. + The to which output code is sent. + A that indicates the options to use for generating code. + Neither this method nor the method is overridden in a derived class. + + + Generates code for the specified Code Document Object Model (CodeDOM) member declaration and sends it to the specified text writer, using the specified options. + A object that indicates the member for which to generate code. + The to which output code is sent. + A that indicates the options to use for generating code. + This method is not overridden in a derived class. + + + Generates code for the specified Code Document Object Model (CodeDOM) namespace and sends it to the specified text writer, using the specified options. + A object that indicates the namespace for which to generate code. + The to which output code is sent. + A that indicates the options to use for generating code. + Neither this method nor the method is overridden in a derived class. + + + Generates code for the specified Code Document Object Model (CodeDOM) statement and sends it to the specified text writer, using the specified options. + A containing the CodeDOM elements for which to generate code. + The to which output code is sent. + A that indicates the options to use for generating code. + Neither this method nor the method is overridden in a derived class. + + + Generates code for the specified Code Document Object Model (CodeDOM) type declaration and sends it to the specified text writer, using the specified options. + A object that indicates the type for which to generate code. + The to which output code is sent. + A that indicates the options to use for generating code. + Neither this method nor the method is overridden in a derived class. + + + Returns the language provider and compiler configuration settings for this computer. + An array of type representing the settings of all configured implementations. + The caller does not have the required permission. + + + Returns the language provider and compiler configuration settings for the specified language. + A object populated with settings of the configured implementation. + A language name. + The does not have a configured provider on this computer. + The is null. + The caller does not have the required permission. + + + Gets a for the specified data type. + A for the specified type, or null if a for the specified type cannot be found. + The type of object to retrieve a type converter for. + + + Returns a language name associated with the specified file name extension, as configured in the compiler configuration section. + A language name associated with the file name extension, as configured in the compiler configuration settings. + A file name extension. + The does not have a configured language provider on this computer. + The is null. + The caller does not have the required permission. + + + Gets the type indicated by the specified . + A text representation of the specified type, formatted for the language in which code is generated by this code generator. In Visual Basic, for example, passing in a for the type will return "Integer". + A that indicates the type to return. + Neither this method nor the method is overridden in a derived class. + + + Tests whether a file name extension has an associated implementation configured on the computer. + true if a implementation is configured for the specified file name extension; otherwise, false. + A file name extension. + The is null. + The caller does not have the required permission. + + + Tests whether a language has a implementation configured on the computer. + true if a implementation is configured for the specified language; otherwise, false. + The language name. + The is null. + The caller does not have the required permission. + + + Returns a value that indicates whether the specified value is a valid identifier for the current language. + true if the parameter is a valid identifier; otherwise, false. + The value to verify as a valid identifier. + Neither this method nor the method is overridden in a derived class. + + + Gets a language features identifier. + A that indicates special features of the language. + + + Compiles the code read from the specified text stream into a . + A that contains a representation of the parsed code. + A object that is used to read the code to be parsed. + Neither this method nor the method is overridden in a derived class. + + + Returns a value indicating whether the specified code generation support is provided. + true if the specified code generation support is provided; otherwise, false. + A object that indicates the type of code generation support to verify. + Neither this method nor the method is overridden in a derived class. + + + Provides an example implementation of the interface. This class is abstract. + + + Initializes a new instance of the class. + + + Generates a line-continuation character and outputs the specified string on a new line. + The string to write on the new line. + + + Creates an escaped identifier for the specified value. + The escaped identifier for the value. + The string to create an escaped identifier for. + + + Creates a valid identifier for the specified value. + A valid identifier for the value. + A string to create a valid identifier for. + + + Gets the code type declaration for the current class. + The code type declaration for the current class. + + + Gets the current member of the class. + The current member of the class. + + + Gets the current member name. + The name of the current member. + + + Gets the current class name. + The current class name. + + + Generates code for the specified argument reference expression. + A that indicates the expression to generate code for. + + + Generates code for the specified array creation expression. + A that indicates the expression to generate code for. + + + Generates code for the specified array indexer expression. + A that indicates the expression to generate code for. + + + Generates code for the specified assignment statement. + A that indicates the statement to generate code for. + + + Generates code for the specified attach event statement. + A that indicates the statement to generate code for. + + + Generates code for the specified attribute block end. + A that indicates the end of the attribute block to generate code for. + + + Generates code for the specified attribute block start. + A that indicates the start of the attribute block to generate code for. + + + Generates code for the specified base reference expression. + A that indicates the expression to generate code for. + + + Generates code for the specified binary operator expression. + A that indicates the expression to generate code for. + + is null. + + + Generates code for the specified cast expression. + A that indicates the expression to generate code for. + + + Generates code for the specified class member using the specified text writer and code generator options. + The class member to generate code for. + The text writer to output code to. + The options to use when generating the code. + The property is not null. + + + Generates code for the specified comment. + A to generate code for. + + + Generates code for the specified comment statement. + The statement to generate code for. + The property of is not set. + + + Generates code for the specified comment statements. + The expression to generate code for. + + + Generates code for the specified compile unit. + The compile unit to generate code for. + + + Generates code for the end of a compile unit. + The compile unit to generate code for. + + + Generates code for the start of a compile unit. + The compile unit to generate code for. + + + Generates code for the specified conditional statement. + The statement to generate code for. + + + Generates code for the specified constructor. + The constructor to generate code for. + The type of the object that this constructor constructs. + + + Generates code for the specified decimal value. + The decimal value to generate code for. + + + Generates code for the specified reference to a default value. + The reference to generate code for. + + + Generates code for the specified delegate creation expression. + The expression to generate code for. + + + Generates code for the specified delegate invoke expression. + The expression to generate code for. + + + Generates code for the specified direction expression. + The expression to generate code for. + + + Generates code for the specified code directives. + The code directives to generate code for. + + + Generates code for a double-precision floating point number. + The value to generate code for. + + + Generates code for the specified entry point method. + The entry point for the code. + The code that declares the type. + + + Generates code for the specified event. + The member event to generate code for. + The type of the object that this event occurs on. + + + Generates code for the specified event reference expression. + The expression to generate code for. + + + Generates code for the specified code expression. + The code expression to generate code for. + + is null. + + is not a valid . + + + Generates code for the specified expression statement. + The statement to generate code for. + + + Generates code for the specified member field. + The field to generate code for. + + + Generates code for the specified field reference expression. + The expression to generate code for. + + + Generates code for the specified goto statement. + The expression to generate code for. + + + Generates code for the specified indexer expression. + The expression to generate code for. + + + Generates code for the specified iteration statement. + The statement to generate code for. + + + Generates code for the specified labeled statement. + The statement to generate code for. + + + Generates code for the specified line pragma end. + The end of the line pragma to generate code for. + + + Generates code for the specified line pragma start. + The start of the line pragma to generate code for. + + + Generates code for the specified method. + The member method to generate code for. + The type of the object that this method occurs on. + + + Generates code for the specified method invoke expression. + The expression to generate code for. + + + Generates code for the specified method reference expression. + The expression to generate code for. + + + Generates code for the specified method return statement. + The statement to generate code for. + + + Generates code for the specified namespace. + The namespace to generate code for. + + + Generates code for the end of a namespace. + The namespace to generate code for. + + + Generates code for the specified namespace import. + The namespace import to generate code for. + + + Generates code for the specified namespace import. + The namespace import to generate code for. + + + Generates code for the namespaces in the specified compile unit. + The compile unit to generate namespaces for. + + + Generates code for the start of a namespace. + The namespace to generate code for. + + + Generates code for the specified object creation expression. + The expression to generate code for. + + + Generates code for the specified parameter declaration expression. + The expression to generate code for. + + + Generates code for the specified primitive expression. + The expression to generate code for. + + uses an invalid data type. Only the following data types are valid:stringcharbyteInt16Int32Int64SingleDoubleDecimal + + + Generates code for the specified property. + The property to generate code for. + The type of the object that this property occurs on. + + + Generates code for the specified property reference expression. + The expression to generate code for. + + + Generates code for the specified property set value reference expression. + The expression to generate code for. + + + Generates code for the specified remove event statement. + The statement to generate code for. + + + Generates code for a single-precision floating point number. + The value to generate code for. + + + Outputs the code of the specified literal code fragment compile unit. + The literal code fragment compile unit to generate code for. + + + Outputs the code of the specified literal code fragment expression. + The expression to generate code for. + + + Outputs the code of the specified literal code fragment class member. + The member to generate code for. + + + Outputs the code of the specified literal code fragment statement. + The statement to generate code for. + + + Generates code for the specified statement. + The statement to generate code for. + + is not a valid . + + + Generates code for the specified statement collection. + The statements to generate code for. + + + Generates code for the specified this reference expression. + The expression to generate code for. + + + Generates code for the specified throw exception statement. + The statement to generate code for. + + + Generates code for the specified try...catch...finally statement. + The statement to generate code for. + + + Generates code for the specified class constructor. + The class constructor to generate code for. + + + Generates code for the specified end of the class. + The end of the class to generate code for. + + + Generates code for the specified type of expression. + The expression to generate code for. + + + Generates code for the specified type reference expression. + The expression to generate code for. + + + Generates code for the specified namespace and the classes it contains. + The namespace to generate classes for. + + + Generates code for the specified start of the class. + The start of the class to generate code for. + + + Generates code for the specified variable declaration statement. + The statement to generate code for. + + + Generates code for the specified variable reference expression. + The expression to generate code for. + + + Gets the name of the specified data type. + The name of the data type reference. + The type whose name will be returned. + + + Gets or sets the amount of spaces to indent each indentation level. + The number of spaces to indent for each indentation level. + + + Gets a value indicating whether the current object being generated is a class. + true if the current object is a class; otherwise, false. + + + Gets a value indicating whether the current object being generated is a delegate. + true if the current object is a delegate; otherwise, false. + + + Gets a value indicating whether the current object being generated is an enumeration. + true if the current object is an enumeration; otherwise, false. + + + Gets a value indicating whether the current object being generated is an interface. + true if the current object is an interface; otherwise, false. + + + Gets a value indicating whether the current object being generated is a value type or struct. + true if the current object is a value type or struct; otherwise, false. + + + Gets a value indicating whether the specified value is a valid identifier. + true if the value is a valid identifier; otherwise, false. + The value to test for conflicts with valid identifiers. + + + Gets a value indicating whether the specified string is a valid identifier. + true if the specified string is a valid identifier; otherwise, false. + The string to test for validity. + + + Gets the token that represents null. + The token that represents null. + + + Gets the options to be used by the code generator. + An object that indicates the options for the code generator to use. + + + Gets the text writer to use for output. + The text writer to use for output. + + + Outputs an argument in an attribute block. + The attribute argument to generate code for. + + + Generates code for the specified attribute declaration collection. + The attributes to generate code for. + + + Generates code for the specified . + One of the enumeration values that indicates the attribute of the field. + + + Generates code for the specified expression list. + The expressions to generate code for. + + + Generates code for the specified expression list. + The expressions to generate code for. + true to insert a new line after each item; otherwise, false. + + + Outputs a field scope modifier that corresponds to the specified attributes. + One of the enumeration values that specifies the attributes. + + + Outputs the specified identifier. + The identifier to output. + + + Generates code for the specified member access modifier. + One of the enumeration values that indicates the member access modifier to generate code for. + + + Generates code for the specified member scope modifier. + One of the enumeration values that indicates the member scope modifier to generate code for. + + + Generates code for the specified operator. + The operator to generate code for. + + + Generates code for the specified parameters. + The parameter declaration expressions to generate code for. + + + Generates code for the specified type. + The type to generate code for. + + + Generates code for the specified type attributes. + One of the enumeration values that indicates the type attributes to generate code for. + true if the type is a struct; otherwise, false. + true if the type is an enum; otherwise, false. + + + Generates code for the specified object type and name pair. + The type. + The name for the object. + + + Converts the specified string by formatting it with escape codes. + The converted string. + The string to convert. + + + Gets a value indicating whether the specified code generation support is provided. + true if the specified code generation support is provided; otherwise, false. + The type of code generation support to test for. + + + Creates an escaped identifier for the specified value. + The escaped identifier for the value. + The string to create an escaped identifier for. + + + Creates a valid identifier for the specified value. + A valid identifier for the specified value. + The string to generate a valid identifier for. + + + Generates code for the specified Code Document Object Model (CodeDOM) compilation unit and outputs it to the specified text writer using the specified options. + The CodeDOM compilation unit to generate code for. + The text writer to output code to. + The options to use for generating code. + + is not available. may have been closed before the method call was made. + + + Generates code for the specified Code Document Object Model (CodeDOM) expression and outputs it to the specified text writer. + The expression to generate code for. + The text writer to output code to. + The options to use for generating code. + + is not available. may have been closed before the method call was made. + + + Generates code for the specified Code Document Object Model (CodeDOM) namespace and outputs it to the specified text writer using the specified options. + The namespace to generate code for. + The text writer to output code to. + The options to use for generating code. + + is not available. may have been closed before the method call was made. + + + Generates code for the specified Code Document Object Model (CodeDOM) statement and outputs it to the specified text writer using the specified options. + The statement that contains the CodeDOM elements to translate. + The text writer to output code to. + The options to use for generating code. + + is not available. may have been closed before the method call was made. + + + Generates code for the specified Code Document Object Model (CodeDOM) type declaration and outputs it to the specified text writer using the specified options. + The type to generate code for. + The text writer to output code to. + The options to use for generating code. + + is not available. may have been closed before the method call was made. + + + Gets the type indicated by the specified . + The name of the data type reference. + The type to return. + + + Gets a value that indicates whether the specified value is a valid identifier for the current language. + true if the parameter is a valid identifier; otherwise, false. + The value to test. + + + Gets a value indicating whether the generator provides support for the language features represented by the specified object. + true if the specified capabilities are supported; otherwise, false. + The capabilities to test the generator for. + + + Throws an exception if the specified value is not a valid identifier. + The identifier to validate. + + + Throws an exception if the specified string is not a valid identifier. + The identifier to test for validity as an identifier. + If the specified identifier is invalid or conflicts with reserved or language keywords. + + + Attempts to validate each identifier field contained in the specified or tree. + An object to test for invalid identifiers. + The specified contains an invalid identifier. + + + Represents a set of options used by a code generator. + + + Initializes a new instance of the class. + + + Gets or sets a value indicating whether to insert blank lines between members. + true if blank lines should be inserted; otherwise, false. By default, the value of this property is true. + + + Gets or sets the style to use for bracing. + A string containing the bracing style to use. + + + Gets or sets a value indicating whether to append an else, catch, or finally block, including brackets, at the closing line of each previous if or try block. + true if an else should be appended; otherwise, false. The default value of this property is false. + + + Gets or sets the string to use for indentations. + A string containing the characters to use for indentations. + + + Gets or sets the object at the specified index. + The object associated with the specified name. If no object associated with the specified name exists in the collection, null. + The name associated with the object to retrieve. + + + Gets or sets a value indicating whether to generate members in the order in which they occur in member collections. + true to generate the members in the order in which they occur in the member collection; otherwise, false. The default value of this property is false. + + + Provides an empty implementation of the interface. + + + Initializes a new instance of the class. + + + Compiles the specified text stream into a . + A containing the code model produced from parsing the code. + A that is used to read the code to be parsed. + + + Represents a compiler error or warning. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified file name, line, column, error number, and error text. + The file name of the file that the compiler was compiling when it encountered the error. + The line of the source of the error. + The column of the source of the error. + The error number of the error. + The error message text. + + + Gets or sets the column number where the source of the error occurs. + The column number of the source file where the compiler encountered the error. + + + Gets or sets the error number. + The error number as a string. + + + Gets or sets the text of the error message. + The text of the error message. + + + Gets or sets the file name of the source file that contains the code which caused the error. + The file name of the source file that contains the code which caused the error. + + + Gets or sets a value that indicates whether the error is a warning. + true if the error is a warning; otherwise, false. + + + Gets or sets the line number where the source of the error occurs. + The line number of the source file where the compiler encountered the error. + + + Provides an implementation of Object's method. + A string representation of the compiler error. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of that contains the specified array of objects. + An array of objects to initialize the collection with. + + is null. + + + Initializes a new instance of the class that contains the contents of the specified . + A object with which to initialize the collection. + + is null. + + + Adds the specified object to the error collection. + The index at which the new element was inserted. + The object to add. + + + Copies the elements of an array to the end of the error collection. + An array of type that contains the objects to add to the collection. + + is null. + + + Adds the contents of the specified compiler error collection to the end of the error collection. + A object that contains the objects to add to the collection. + + is null. + + + Gets a value that indicates whether the collection contains the specified object. + true if the is contained in the collection; otherwise, false. + The to locate. + + + Copies the collection values to a one-dimensional instance at the specified index. + The one-dimensional that is the destination of the values copied from . + The index in the array at which to start copying. + The array indicated by the parameter is multidimensional.-or- The number of elements in the is greater than the available space between the index value of the parameter in the array indicated by the parameter and the end of the array indicated by the parameter. + The parameter is null. + The parameter is less than the lowbound of the array indicated by the parameter. + + + Gets a value that indicates whether the collection contains errors. + true if the collection contains errors; otherwise, false. + + + Gets a value that indicates whether the collection contains warnings. + true if the collection contains warnings; otherwise, false. + + + Gets the index of the specified object in the collection, if it exists in the collection. + The index of the specified in the , if found; otherwise, -1. + The to locate. + + + Inserts the specified into the collection at the specified index. + The zero-based index where the compiler error should be inserted. + The to insert. + + + Gets or sets the at the specified index. + A at each valid index. + The zero-based index of the entry to locate in the collection. + The index value indicated by the parameter is outside the valid range of indexes for the collection. + + + Removes a specific from the collection. + The to remove from the . + The specified object is not found in the collection. + + + Represents the configuration settings of a language provider. This class cannot be inherited. + + + Gets the type of the configured implementation. + A read-only instance that represents the configured language provider type. + The language provider is not configured on this computer. + Cannot locate the type because it is a null or empty string.-or-Cannot locate the type because the name for the cannot be found in the configuration file. + + + Gets the configured compiler settings for the language provider implementation. + A read-only instance that contains the compiler options and settings configured for the language provider. + + + Returns a instance for the current language provider settings. + A CodeDOM provider associated with the language provider configuration. + + + Returns a instance for the current language provider settings and specified options. + A CodeDOM provider associated with the language provider configuration and specified options. + A collection of provider options from the configuration file. + + is null. + The provider does not support options. + + + Determines whether the specified object represents the same language provider and compiler settings as the current . + true if is a object and its value is the same as this instance; otherwise, false. + The object to compare with the current . + + + Returns the file name extensions supported by the language provider. + An array of file name extensions supported by the language provider. + + + Returns the hash code for the current instance. + A 32-bit signed integer hash code for the current instance, suitable for use in hashing algorithms and data structures such as a hash table. + + + Gets the language names supported by the language provider. + An array of language names supported by the language provider. + + + Returns a value indicating whether the language provider implementation is configured on the computer. + true if the language provider implementation type is configured on the computer; otherwise, false. + + + Represents the parameters used to invoke a compiler. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified assembly names. + The names of the assemblies to reference. + + + Initializes a new instance of the class using the specified assembly names and output file name. + The names of the assemblies to reference. + The output file name. + + + Initializes a new instance of the class using the specified assembly names, output name, and a value indicating whether to include debug information. + The names of the assemblies to reference. + The output file name. + true if debug information should be included; false if debug information should be excluded. + + + Gets or sets the optional additional-command line arguments string to use when invoking the compiler. + Any additional command line arguments for the compiler. + + + Gets the .NET Framework resource files to include when compiling the assembly output. + A containing the file paths of .NET Framework resources to include in the generated assembly. + + + Specifies an evidence object that represents the security policy permissions to grant the compiled assembly. + An object that represents the security policy permissions to grant the compiled assembly. + + + Gets or sets a value indicating whether to generate an executable. + true if an executable should be generated; otherwise, false. + + + Gets or sets a value indicating whether to generate the output in memory. + true if the compiler should generate the output in memory; otherwise, false. + + + Gets or sets a value indicating whether to include debug information in the compiled executable. + true if debug information should be generated; otherwise, false. + + + Gets the .NET Framework resource files that are referenced in the current source. + A containing the file paths of .NET Framework resources that are referenced by the source. + + + Gets or sets the name of the main class. + The name of the main class. + + + Gets or sets the name of the output assembly. + The name of the output assembly. + + + Gets the assemblies referenced by the current project. + A that contains the assembly names that are referenced by the source to compile. + + + Gets or sets the collection that contains the temporary files. + A that contains the temporary files. + + + Gets or sets a value indicating whether to treat warnings as errors. + true if warnings should be treated as errors; otherwise, false. + + + Gets or sets the user token to use when creating the compiler process. + The user token to use. + + + Gets or sets the warning level at which the compiler aborts compilation. + The warning level at which the compiler aborts compilation. + + + Gets or sets the file name of a Win32 resource file to link into the compiled assembly. + A Win32 resource file that will be linked into the compiled assembly. + + + Represents the results of compilation that are returned from a compiler. + + + Initializes a new instance of the class that uses the specified temporary files. + A with which to manage and store references to intermediate files generated during compilation. + + + Gets or sets the compiled assembly. + An that indicates the compiled assembly. + + + + + + Gets the collection of compiler errors and warnings. + A that indicates the errors and warnings resulting from compilation, if any. + + + Indicates the evidence object that represents the security policy permissions of the compiled assembly. + An object that represents the security policy permissions of the compiled assembly. + + + Gets or sets the compiler's return value. + The compiler's return value. + + + Gets the compiler output messages. + A that contains the output messages. + + + Gets or sets the path of the compiled assembly. + The path of the assembly, or null if the assembly was generated in memory. + + + Gets or sets the temporary file collection to use. + A with which to manage and store references to intermediate files generated during compilation. + + + Provides command execution functions for invoking compilers. This class cannot be inherited. + + + Executes the command using the specified temporary files and waits for the call to return. + The command to execute. + A with which to manage and store references to intermediate files generated during compilation. + + + Executes the specified command using the specified user token and temporary files, and waits for the call to return, storing output and error information from the compiler in the specified strings. + The return value from the compiler. + The token to start the compiler process with. + The command to execute. + A with which to manage and store references to intermediate files generated during compilation. + A reference to a string that will store the compiler's message output. + A reference to a string that will store the name of the error or errors encountered. + + + Executes the specified command using the specified user token, current directory, and temporary files; then waits for the call to return, storing output and error information from the compiler in the specified strings. + The return value from the compiler. + The token to start the compiler process with. + The command to execute. + The directory to start the process in. + A with which to manage and store references to intermediate files generated during compilation. + A reference to a string that will store the compiler's message output. + A reference to a string that will store the name of the error or errors encountered. + + + Executes the specified command using the specified temporary files and waits for the call to return, storing output and error information from the compiler in the specified strings. + The return value from the compiler. + The command to execute. + A with which to manage and store references to intermediate files generated during compilation. + A reference to a string that will store the compiler's message output. + A reference to a string that will store the name of the error or errors encountered. + + + Executes the specified command using the specified current directory and temporary files, and waits for the call to return, storing output and error information from the compiler in the specified strings. + The return value from the compiler. + The command to execute. + The current directory. + A with which to manage and store references to intermediate files generated during compilation. + A reference to a string that will store the compiler's message output. + A reference to a string that will store the name of the error or errors encountered. + + + Identifies code generated by a tool. This class cannot be inherited. + + + Initializes a new instance of the class specifying the name and version of the tool that generated the code. + The name of the tool that generated the code. + The version of the tool that generated the code. + + + Gets the name of the tool that generated the code. + The name of the tool that generated to code. + + + Gets the version of the tool that generated the code. + The version of the tool that generated the code. + + + Defines identifiers used to determine whether a code generator supports certain types of code elements. + + + Indicates the generator supports arrays of arrays. + + + Indicates the generator supports a program entry point method designation. This is used when building executables. + + + Indicates the generator supports goto statements. + + + Indicates the generator supports referencing multidimensional arrays. Currently, the CodeDom cannot be used to instantiate multidimensional arrays. + + + Indicates the generator supports static constructors. + + + Indicates the generator supports try...catch statements. + + + Indicates the generator supports return type attribute declarations. + + + Indicates the generator supports value type declarations. + + + Indicates the generator supports enumeration declarations. + + + Indicates the generator supports delegate declarations. + + + Indicates the generator supports interface declarations. + + + Indicates the generator supports event declarations. + + + Indicates the generator supports assembly attributes. + + + Indicates the generator supports parameter attributes. + + + Indicates the generator supports reference and out parameters. + + + Indicates the generator supports chained constructor arguments. + + + Indicates the generator supports the declaration of nested types. + + + Indicates the generator supports the declaration of members that implement multiple interfaces. + + + Indicates the generator supports public static members. + + + Indicates the generator supports complex expressions. + + + Indicates the generator supports compilation with Win32 resources. + + + Indicates the generator supports compilation with .NET Framework resources. These can be default resources compiled directly into an assembly, or resources referenced in a satellite assembly. + + + Indicates the generator supports partial type declarations. + + + Indicates the generator supports generic type references. + + + Indicates the generator supports generic type declarations. + + + Indicates the generator supports the declaration of indexer properties. + + + Defines an interface for invoking compilation of source code or a CodeDOM tree using a specific compiler. + + + Compiles an assembly from the tree contained in the specified , using the specified compiler settings. + A object that indicates the results of compilation. + A object that indicates the settings for compilation. + A that indicates the code to compile. + + + Compiles an assembly based on the trees contained in the specified array of objects, using the specified compiler settings. + A object that indicates the results of compilation. + A object that indicates the settings for compilation. + An array of type that indicates the code to compile. + + + Compiles an assembly from the source code contained within the specified file, using the specified compiler settings. + A object that indicates the results of compilation. + A object that indicates the settings for compilation. + The file name of the file that contains the source code to compile. + + + Compiles an assembly from the source code contained within the specified files, using the specified compiler settings. + A object that indicates the results of compilation. + A object that indicates the settings for compilation. + The file names of the files to compile. + + + Compiles an assembly from the specified string containing source code, using the specified compiler settings. + A object that indicates the results of compilation. + A object that indicates the settings for compilation. + The source code to compile. + + + Compiles an assembly from the specified array of strings containing source code, using the specified compiler settings. + A object that indicates the results of compilation. + A object that indicates the settings for compilation. + The source code strings to compile. + + + Defines an interface for generating code. + + + Creates an escaped identifier for the specified value. + The escaped identifier for the value. + The string to create an escaped identifier for. + + + Creates a valid identifier for the specified value. + A valid identifier for the specified value. + The string to generate a valid identifier for. + + + Generates code for the specified Code Document Object Model (CodeDOM) compilation unit and outputs it to the specified text writer using the specified options. + A to generate code for. + The to output code to. + A that indicates the options to use for generating code. + + + Generates code for the specified Code Document Object Model (CodeDOM) expression and outputs it to the specified text writer. + A that indicates the expression to generate code for. + The to output code to. + A that indicates the options to use for generating code. + + + Generates code for the specified Code Document Object Model (CodeDOM) namespace and outputs it to the specified text writer using the specified options. + A that indicates the namespace to generate code for. + The to output code to. + A that indicates the options to use for generating code. + + + Generates code for the specified Code Document Object Model (CodeDOM) statement and outputs it to the specified text writer using the specified options. + A containing the CodeDOM elements to translate. + The to output code to. + A that indicates the options to use for generating code. + + + Generates code for the specified Code Document Object Model (CodeDOM) type declaration and outputs it to the specified text writer using the specified options. + A that indicates the type to generate code for. + The to output code to. + A that indicates the options to use for generating code. + + + Gets the type indicated by the specified . + A text representation of the specified type for the language this code generator is designed to generate code in. For example, in Visual Basic, passing in type System.Int32 will return "Integer". + A that indicates the type to return. + + + Gets a value that indicates whether the specified value is a valid identifier for the current language. + true if the parameter is a valid identifier; otherwise, false. + The value to test for being a valid identifier. + + + Gets a value indicating whether the generator provides support for the language features represented by the specified object. + true if the specified capabilities are supported; otherwise, false. + The capabilities to test the generator for. + + + Throws an exception if the specified value is not a valid identifier. + The identifier to validate. + The identifier is not valid. + + + Defines an interface for parsing code into a . + + + When implemented in a derived class, compiles the specified text stream into a . + A that contains a representation of the parsed code. + A that can be used to read the code to be compiled. + + + Provides a text writer that can indent new lines by a tab string token. + + + Initializes a new instance of the class using the specified text writer and default tab string. + The to use for output. + + + Initializes a new instance of the class using the specified text writer and tab string. + The to use for output. + The tab string to use for indentation. + + + Closes the document being written to. + + + Specifies the default tab string. This field is constant. + + + Gets the encoding for the text writer to use. + An that indicates the encoding for the text writer to use. + + + Flushes the stream. + + + Gets or sets the number of spaces to indent. + The number of spaces to indent. + + + Gets the to use. + The to use. + + + Gets or sets the new line character to use. + The new line character to use. + + + Outputs the tab string once for each level of indentation according to the property. + + + Writes the text representation of a Boolean value to the text stream. + The Boolean value to write. + + + Writes a character to the text stream. + The character to write. + + + Writes a character array to the text stream. + The character array to write. + + + Writes a subarray of characters to the text stream. + The character array to write data from. + Starting index in the buffer. + The number of characters to write. + + + Writes the text representation of a Double to the text stream. + The double to write. + + + Writes the text representation of an integer to the text stream. + The integer to write. + + + Writes the text representation of an 8-byte integer to the text stream. + The 8-byte integer to write. + + + Writes the text representation of an object to the text stream. + The object to write. + + + Writes the text representation of a Single to the text stream. + The single to write. + + + Writes the specified string to the text stream. + The string to write. + + + Writes out a formatted string, using the same semantics as specified. + The formatting string. + The object to write into the formatted string. + + + Writes out a formatted string, using the same semantics as specified. + The formatting string to use. + The first object to write into the formatted string. + The second object to write into the formatted string. + + + Writes out a formatted string, using the same semantics as specified. + The formatting string to use. + The argument array to output. + + + Writes a line terminator. + + + Writes the text representation of a Boolean, followed by a line terminator, to the text stream. + The Boolean to write. + + + Writes a character, followed by a line terminator, to the text stream. + The character to write. + + + Writes a character array, followed by a line terminator, to the text stream. + The character array to write. + + + Writes a subarray of characters, followed by a line terminator, to the text stream. + The character array to write data from. + Starting index in the buffer. + The number of characters to write. + + + Writes the text representation of a Double, followed by a line terminator, to the text stream. + The double to write. + + + Writes the text representation of an integer, followed by a line terminator, to the text stream. + The integer to write. + + + Writes the text representation of an 8-byte integer, followed by a line terminator, to the text stream. + The 8-byte integer to write. + + + Writes the text representation of an object, followed by a line terminator, to the text stream. + The object to write. + + + Writes the text representation of a Single, followed by a line terminator, to the text stream. + The single to write. + + + Writes the specified string, followed by a line terminator, to the text stream. + The string to write. + + + Writes out a formatted string, followed by a line terminator, using the same semantics as specified. + The formatting string. + The object to write into the formatted string. + + + Writes out a formatted string, followed by a line terminator, using the same semantics as specified. + The formatting string to use. + The first object to write into the formatted string. + The second object to write into the formatted string. + + + Writes out a formatted string, followed by a line terminator, using the same semantics as specified. + The formatting string to use. + The argument array to output. + + + Writes the text representation of a UInt32, followed by a line terminator, to the text stream. + A UInt32 to output. + + + Writes the specified string to a line without tabs. + The string to write. + + + Defines identifiers that indicate special features of a language. + + + The language has default characteristics. + + + The language is case-insensitive. + + + Represents a collection of temporary files. + + + Initializes a new instance of the class with default values. + + + Initializes a new instance of the class using the specified temporary directory that is set to delete the temporary files after their generation and use, by default. + A path to the temporary directory to use for storing the temporary files. + + + Initializes a new instance of the class using the specified temporary directory and specified value indicating whether to keep or delete the temporary files after their generation and use, by default. + A path to the temporary directory to use for storing the temporary files. + true if the temporary files should be kept after use; false if the temporary files should be deleted. + + + Adds a file name with the specified file name extension to the collection. + A file name with the specified extension that was just added to the collection. + The file name extension for the auto-generated temporary file name to add to the collection. + + + Adds a file name with the specified file name extension to the collection, using the specified value indicating whether the file should be deleted or retained. + A file name with the specified extension that was just added to the collection. + The file name extension for the auto-generated temporary file name to add to the collection. + true if the file should be kept after use; false if the file should be deleted. + + is null or an empty string. + + + Adds the specified file to the collection, using the specified value indicating whether to keep the file after the collection is disposed or when the method is called. + The name of the file to add to the collection. + true if the file should be kept after use; false if the file should be deleted. + + is null or an empty string.-or- is a duplicate. + + + Gets the full path to the base file name, without a file name extension, on the temporary directory path, that is used to generate temporary file names for the collection. + The full path to the base file name, without a file name extension, on the temporary directory path, that is used to generate temporary file names for the collection. + If the property has not been set or is set to null, and is not granted for the temporary directory indicated by the property. + + + Copies the members of the collection to the specified string, beginning at the specified index. + The array of strings to copy to. + The index of the array to begin copying to. + + + Gets the number of files in the collection. + The number of files in the collection. + + + Deletes the temporary files within this collection that were not marked to be kept. + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Attempts to delete the temporary files before this object is reclaimed by garbage collection. + + + Gets an enumerator that can enumerate the members of the collection. + An that contains the collection's members. + + + Gets or sets a value indicating whether to keep the files, by default, when the method is called or the collection is disposed. + true if the files should be kept; otherwise, false. + + + Copies the elements of the collection to an array, starting at the specified index of the target array. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in array at which copying begins. + + + Gets the number of elements contained in the collection. + The number of elements contained in the . + + + Gets a value indicating whether access to the collection is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the . + + + Returns an enumerator that iterates through a collection. + An that can be used to iterate through the collection. + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + Gets the temporary directory to store the temporary files in. + The temporary directory to store the temporary files in. + + + Provides blocking and bounding capabilities for thread-safe collections that implement . + The type of elements in the collection. + + + Initializes a new instance of the class without an upper-bound. + + + Initializes a new instance of the class without an upper-bound and using the provided as its underlying data store. + The collection to use as the underlying data store. + The argument is null. + + + Initializes a new instance of the class with the specified upper-bound and using the provided as its underlying data store. + The collection to use as the underlying data store. + The bounded size of the collection. + The argument is null. + The is not a positive value. + The supplied contains more values than is permitted by . + + + Initializes a new instance of the class with the specified upper-bound. + The bounded size of the collection. + The is not a positive value. + + + Adds the item to the . + The item to be added to the collection. The value can be a null reference. + The has been disposed. + The has been marked as complete with regards to additions.-or-The underlying collection didn't accept the item. + + + Adds the item to the . + The item to be added to the collection. The value can be a null reference. + A cancellation token to observe. + If the is canceled. + The has been disposed or the that owns has been disposed. + The has been marked as complete with regards to additions.-or-The underlying collection didn't accept the item. + + + Adds the specified item to any one of the specified instances. + The index of the collection in the array to which the item was added. + The array of collections. + The item to be added to one of the collections. + At least one of the instances has been disposed. + The argument is null. + The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element, or at least one of collections has been marked as complete for adding. + At least one underlying collection didn't accept the item. + + + Adds the specified item to any one of the specified instances. + The index of the collection in the array to which the item was added. + The array of collections. + The item to be added to one of the collections. + A cancellation token to observe. + If the is canceled. + At least one underlying collection didn't accept the item. + The argument is null. + The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element, or at least one of collections has been marked as complete for adding. + At least one of the instances has been disposed, or the that created has been disposed. + + + Gets the bounded capacity of this instance. + The bounded capacity of this collection, or int.MaxValue if no bound was supplied. + The has been disposed. + + + Marks the instances as not accepting any more additions. + The has been disposed. + + + Copies all of the items in the instance to a compatible one-dimensional array, starting at the specified index of the target array. + The one-dimensional array that is the destination of the elements copied from the instance. The array must have zero-based indexing. + The zero-based index in at which copying begins. + The has been disposed. + The argument is null. + The argument is less than zero. + The argument is equal to or greater than the length of the .The destination array is too small to hold all of the BlockingCcollection elements.The array rank doesn't match.The array type is incompatible with the type of the BlockingCollection elements. + + + Gets the number of items contained in the . + The number of items contained in the . + The has been disposed. + + + Releases all resources used by the current instance of the class. + + + Releases resources used by the instance. + Whether being disposed explicitly (true) or due to a finalizer (false). + + + Provides a consuming for items in the collection. + An that removes and returns items from the collection. + The has been disposed. + + + Provides a consuming for items in the collection. + An that removes and returns items from the collection. + A cancellation token to observe. + If the is canceled. + The has been disposed or the that created has been disposed + + + Gets whether this has been marked as complete for adding. + Whether this collection has been marked as complete for adding. + The has been disposed. + + + Gets whether this has been marked as complete for adding and is empty. + Whether this collection has been marked as complete for adding and is empty. + The has been disposed. + + + + Copies all of the items in the instance to a compatible one-dimensional array, starting at the specified index of the target array. + The one-dimensional array that is the destination of the elements copied from the instance. The array must have zero-based indexing. + The zero-based index in at which copying begins. + The has been disposed. + The argument is null. + The argument is less than zero. + The argument is equal to or greater than the length of the , the array is multidimensional, or the type parameter for the collection cannot be cast automatically to the type of the destination array. + + + Gets a value indicating whether access to the is synchronized. + always returns false. + The has been disposed. + + + Gets an object that can be used to synchronize access to the . This property is not supported. + returns null. + The SyncRoot property is not supported. + + + Provides an for items in the collection. + An for the items in the collection. + The has been disposed. + + + Takes an item from the . + The item removed from the collection. + The has been disposed. + The underlying collection was modified outside of this instance, or the is empty and the collection has been marked as complete for adding. + + + Takes an item from the . + The item removed from the collection. + Object that can be used to cancel the take operation. + The is canceled. + The has been disposed or the that created the token was canceled. + The underlying collection was modified outside of this instance or the BlockingCollection is marked as complete for adding, or the is empty. + + + Takes an item from any one of the specified instances. + The index of the collection in the array from which the item was removed. + At least one of the instances has been disposed. + The argument is null. + The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element or has been called on the collection. + At least one of the underlying collections was modified outside of its instance. + + + Takes an item from any one of the specified instances while observing the specified cancellation token. + The index of the collection in the array from which the item was removed. + The array of collections. + The item removed from one of the collections. + A cancellation token to observe. + If the is canceled. + At least one of the underlying collections was modified outside of its instance. + The argument is null. + The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element, or has been called on the collection. + At least one of the instances has been disposed. + + + Copies the items from the instance into a new array. + An array containing copies of the elements of the collection. + The has been disposed. + + + Attempts to add the specified item to the . + true if could be added; otherwise false. If the item is a duplicate, and the underlying collection does not accept duplicate items, then an is thrown. + The item to be added to the collection. + The has been disposed. + The has been marked as complete with regards to additions.-or-The underlying collection didn't accept the item. + + + Attempts to add the specified item to the within the specified time period. + true if the could be added to the collection within the specified time; otherwise, false. If the item is a duplicate, and the underlying collection does not accept duplicate items, then an is thrown. + The item to be added to the collection. + The number of milliseconds to wait, or (-1) to wait indefinitely. + The has been disposed. + + is a negative number other than -1, which represents an infinite time-out. + The has been marked as complete with regards to additions.-or-The underlying collection didn't accept the item. + + + Attempts to add the specified item to the within the specified time period, while observing a cancellation token. + true if the could be added to the collection within the specified time; otherwise, false. If the item is a duplicate, and the underlying collection does not accept duplicate items, then an is thrown. + The item to be added to the collection. + The number of milliseconds to wait, or (-1) to wait indefinitely. + A cancellation token to observe. + If the is canceled. + The has been disposed or the underlying has been disposed. + + is a negative number other than -1, which represents an infinite time-out. + The has been marked as complete with regards to additions.-or-The underlying collection didn't accept the item. + + + Attempts to add the specified item to the . + true if the could be added to the collection within the specified time span; otherwise, false. + The item to be added to the collection. + A that represents the number of milliseconds to wait, or a that represents -1 milliseconds to wait indefinitely. + The has been disposed. + + is a negative number other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater than . + The has been marked as complete with regards to additions.-or-The underlying collection didn't accept the item. + + + Attempts to add the specified item to any one of the specified instances. + The index of the collection in the array to which the item was added, or -1 if the item could not be added. + The array of collections. + The item to be added to one of the collections. + At least one of the instances has been disposed. + The argument is null. + The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element, or at least one of collections has been marked as complete for adding. + At least one underlying collection didn't accept the item. + + + Attempts to add the specified item to any one of the specified instances. + The index of the collection in the array to which the item was added, or -1 if the item could not be added. + The array of collections. + The item to be added to one of the collections. + The number of milliseconds to wait, or (-1) to wait indefinitely. + At least one of the instances has been disposed. + The argument is null. + + is a negative number other than -1, which represents an infinite time-out.-or-The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element, or at least one of collections has been marked as complete for adding. + At least one underlying collection didn't accept the item. + + + Attempts to add the specified item to any one of the specified instances. + The index of the collection in the array to which the item was added, or -1 if the item could not be added. + The array of collections. + The item to be added to one of the collections. + The number of milliseconds to wait, or (-1) to wait indefinitely. + A cancellation token to observe. + If the is canceled. + At least one underlying collection didn't accept the item. + The argument is null. + + is a negative number other than -1, which represents an infinite time-out.-or-The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element, or at least one of collections has been marked as complete for adding. + At least one of the instances has been disposed. + + + Adds the specified item to any one of the specified instances while observing the specified cancellation token. + The index of the collection in the array to which the item was added, or -1 if the item could not be added. + The array of collections. + The item to be added to one of the collections. + A that represents the number of milliseconds to wait, or a that represents -1 milliseconds to wait indefinitely. + At least one of the instances or the that created has been disposed. + The argument is null. + + is a negative number other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater than .-or-The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element, or at least one of collections has been marked as complete for adding. + At least one underlying collection didn't accept the item. + + + Attempts to remove an item from the . + true if an item could be removed. + The item removed from the collection. + The has been disposed. + The underlying collection was modified outside of this instance. + + + Attempts to remove an item from the in the specified time period. + true if an item could be removed from the collection within the specified time; otherwise, false. + The item removed from the collection. + The number of milliseconds to wait, or (-1) to wait indefinitely. + The has been disposed. + + is a negative number other than -1, which represents an infinite time-out. + The underlying collection was modified outside of this instance. + + + Attempts to remove an item from the in the specified time period while observing a cancellation token. + true if an item could be removed from the collection within the specified time; otherwise, false. + The item removed from the collection. + The number of milliseconds to wait, or (-1) to wait indefinitely. + A cancellation token to observe. + If the is canceled. + The has been disposed or the underlying has been disposed. + + is a negative number other than -1, which represents an infinite time-out. + The underlying collection was modified outside of this instance. + + + Attempts to remove an item from the in the specified time period. + true if an item could be removed from the collection within the specified time; otherwise, false. + The item removed from the collection. + A that represents the number of milliseconds to wait, or a that represents -1 milliseconds to wait indefinitely. + The has been disposed. + + is a negative number other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater than . + The underlying collection was modified outside of this instance. + + + Attempts to remove an item from any one of the specified instances. + The index of the collection in the array from which the item was removed, or -1 if an item could not be removed. + The array of collections. + The item removed from one of the collections. + At least one of the instances has been disposed. + The argument is null. + The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element. + At least one of the underlying collections was modified outside of its instance. + + + Attempts to remove an item from any one of the specified instances. + The index of the collection in the array from which the item was removed, or -1 if an item could not be removed. + The array of collections. + The item removed from one of the collections. + The number of milliseconds to wait, or (-1) to wait indefinitely. + At least one of the instances has been disposed. + The argument is null. + + is a negative number other than -1, which represents an infinite time-out.-or-The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element. + At least one of the underlying collections was modified outside of its instance. + + + Attempts to remove an item from any one of the specified instances. + The index of the collection in the array from which the item was removed, or -1 if an item could not be removed. + The array of collections. + The item removed from one of the collections. + The number of milliseconds to wait, or (-1) to wait indefinitely. + A cancellation token to observe. + If the is canceled. + At least one of the underlying collections was modified outside of its instance. + The argument is null. + + is a negative number other than -1, which represents an infinite time-out.-or-The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element. + At least one of the instances has been disposed. + + + Attempts to remove an item from any one of the specified instances. + The index of the collection in the array from which the item was removed, or -1 if an item could not be removed. + The array of collections. + The item removed from one of the collections. + A that represents the number of milliseconds to wait, or a that represents -1 milliseconds to wait indefinitely. + At least one of the instances has been disposed. + The argument is null. + + is a negative number other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater than .-or-The count of is greater than the maximum size of 62 for STA and 63 for MTA. + The argument is a 0-length array or contains a null element. + At least one of the underlying collections was modified outside of its instance. + + + Represents a thread-safe, unordered collection of objects. + The type of the elements to be stored in the collection. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class that contains elements copied from the specified collection. + The collection whose elements are copied to the new . + + is a null reference (Nothing in Visual Basic). + + + Adds an object to the . + The object to be added to the . The value can be a null reference (Nothing in Visual Basic) for reference types. + + + Copies the elements to an existing one-dimensional , starting at the specified array index. + The one-dimensional that is the destination of the elements copied from the . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is a null reference (Nothing in Visual Basic). + + is less than zero. + + is equal to or greater than the length of the -or- the number of elements in the source is greater than the available space from to the end of the destination . + + + Gets the number of elements contained in the . + The number of elements contained in the . + + + Returns an enumerator that iterates through the . + An enumerator for the contents of the . + + + Gets a value that indicates whether the is empty. + true if the is empty; otherwise, false. + + + Attempts to add an object to the . + Always returns true + The object to be added to the . The value can be a null reference (Nothing in Visual Basic) for reference types. + + + Copies the elements of the to an , starting at a particular index. + The one-dimensional that is the destination of the elements copied from the . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is a null reference (Nothing in Visual Basic). + + is less than zero. + + is multidimensional. -or- does not have zero-based indexing. -or- is equal to or greater than the length of the -or- The number of elements in the source is greater than the available space from to the end of the destination . -or- The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the is synchronized with the SyncRoot. + true if access to the is synchronized with the SyncRoot; otherwise, false. For , this property always returns false. + + + Gets an object that can be used to synchronize access to the . This property is not supported. + Returns null (Nothing in Visual Basic). + The SyncRoot property is not supported. + + + Returns an enumerator that iterates through the . + An enumerator for the contents of the . + + + Copies the elements to a new array. + A new array containing a snapshot of elements copied from the . + + + Attempts to return an object from the without removing it. + true if and object was returned successfully; otherwise, false. + When this method returns, contains an object from the or the default value of if the operation failed. + + + Attempts to remove and return an object from the . + true if an object was removed successfully; otherwise, false. + When this method returns, contains the object removed from the or the default value of if the bag is empty. + + + Provides the base interface for the abstraction of sets. + The type of elements in the set. + + + Adds an element to the current set and returns a value to indicate if the element was successfully added. + true if the element is added to the set; false if the element is already in the set. + The element to add to the set. + + + Removes all elements in the specified collection from the current set. + The collection of items to remove from the set. + + is null. + + + Modifies the current set so that it contains only elements that are also in a specified collection. + The collection to compare to the current set. + + is null. + + + Determines whether the current set is a proper (strict) subset of a specified collection. + true if the current set is a proper subset of ; otherwise, false. + The collection to compare to the current set. + + is null. + + + Determines whether the current set is a proper (strict) superset of a specified collection. + true if the current set is a proper superset of ; otherwise, false. + The collection to compare to the current set. + + is null. + + + Determines whether a set is a subset of a specified collection. + true if the current set is a subset of ; otherwise, false. + The collection to compare to the current set. + + is null. + + + Determines whether the current set is a superset of a specified collection. + true if the current set is a superset of ; otherwise, false. + The collection to compare to the current set. + + is null. + + + Determines whether the current set overlaps with the specified collection. + true if the current set and share at least one common element; otherwise, false. + The collection to compare to the current set. + + is null. + + + Determines whether the current set and the specified collection contain the same elements. + true if the current set is equal to ; otherwise, false. + The collection to compare to the current set. + + is null. + + + Modifies the current set so that it contains only elements that are present either in the current set or in the specified collection, but not both. + The collection to compare to the current set. + + is null. + + + Modifies the current set so that it contains all elements that are present in both the current set and in the specified collection. + The collection to compare to the current set. + + is null. + + + Represents a doubly linked list. + Specifies the element type of the linked list. + 1 + + + Initializes a new instance of the class that is empty. + + + Initializes a new instance of the class that contains elements copied from the specified and has sufficient capacity to accommodate the number of elements copied. + The whose elements are copied to the new . + + is null. + + + Initializes a new instance of the class that is serializable with the specified and . + A object containing the information required to serialize the . + A object containing the source and destination of the serialized stream associated with the . + + + Adds the specified new node after the specified existing node in the . + The after which to insert . + The new to add to the . + + is null.-or- is null. + + is not in the current .-or- belongs to another . + + + Adds a new node containing the specified value after the specified existing node in the . + The new containing . + The after which to insert a new containing . + The value to add to the . + + is null. + + is not in the current . + + + Adds the specified new node before the specified existing node in the . + The before which to insert . + The new to add to the . + + is null.-or- is null. + + is not in the current .-or- belongs to another . + + + Adds a new node containing the specified value before the specified existing node in the . + The new containing . + The before which to insert a new containing . + The value to add to the . + + is null. + + is not in the current . + + + Adds the specified new node at the start of the . + The new to add at the start of the . + + is null. + + belongs to another . + + + Adds a new node containing the specified value at the start of the . + The new containing . + The value to add at the start of the . + + + Adds the specified new node at the end of the . + The new to add at the end of the . + + is null. + + belongs to another . + + + Adds a new node containing the specified value at the end of the . + The new containing . + The value to add at the end of the . + + + Removes all nodes from the . + + + Determines whether a value is in the . + true if is found in the ; otherwise, false. + The value to locate in the . The value can be null for reference types. + + + Copies the entire to a compatible one-dimensional , starting at the specified index of the target array. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + The number of elements in the source is greater than the available space from to the end of the destination . + + + Gets the number of nodes actually contained in the . + The number of nodes actually contained in the . + + + Finds the first node that contains the specified value. + The first that contains the specified value, if found; otherwise, null. + The value to locate in the . + + + Finds the last node that contains the specified value. + The last that contains the specified value, if found; otherwise, null. + The value to locate in the . + + + Gets the first node of the . + The first of the . + + + Returns an enumerator that iterates through the . + An for the . + + + Implements the interface and returns the data needed to serialize the instance. + A object that contains the information required to serialize the instance. + A object that contains the source and destination of the serialized stream associated with the instance. + + is null. + + + Gets the last node of the . + The last of the . + + + Implements the interface and raises the deserialization event when the deserialization is complete. + The source of the deserialization event. + The object associated with the current instance is invalid. + + + Removes the specified node from the . + The to remove from the . + + is null. + + is not in the current . + + + Removes the first occurrence of the specified value from the . + true if the element containing is successfully removed; otherwise, false. This method also returns false if was not found in the original . + The value to remove from the . + + + Removes the node at the start of the . + The is empty. + + + Removes the node at the end of the . + The is empty. + + + Adds an item at the end of the . + The value to add at the end of the . + + + Gets a value indicating whether the is read-only. + true if the is read-only; otherwise, false. In the default implementation of , this property always returns false. + + + Returns an enumerator that iterates through a collection. + An that can be used to iterate through the collection. + + + Copies the elements of the to an , starting at a particular index. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- does not have zero-based indexing.-or-The number of elements in the source is greater than the available space from to the end of the destination .-or-The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. In the default implementation of , this property always returns false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . In the default implementation of , this property always returns the current instance. + + + Returns an enumerator that iterates through the linked list as a collection. + An that can be used to iterate through the linked list as a collection. + + + Enumerates the elements of a . + + + Gets the element at the current position of the enumerator. + The element in the at the current position of the enumerator. + + + Releases all resources used by the . + + + Advances the enumerator to the next element of the . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Gets the element at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Sets the enumerator to its initial position, which is before the first element in the collection. This class cannot be inherited. + The collection was modified after the enumerator was created. + + + Implements the interface and raises the deserialization event when the deserialization is complete. + The source of the deserialization event. + The object associated with the current instance is invalid. + + + Implements the interface and returns the data needed to serialize the instance. + A object that contains the information required to serialize the instance. + A object that contains the source and destination of the serialized stream associated with the instance. + + is null. + + + Represents a node in a . This class cannot be inherited. + Specifies the element type of the linked list. + 1 + + + Initializes a new instance of the class, containing the specified value. + The value to contain in the . + + + Gets the that the belongs to. + A reference to the that the belongs to, or null if the is not linked. + + + Gets the next node in the . + A reference to the next node in the , or null if the current node is the last element () of the . + + + Gets the previous node in the . + A reference to the previous node in the , or null if the current node is the first element () of the . + + + Gets the value contained in the node. + The value contained in the node. + + + Represents a first-in, first-out collection of objects. + Specifies the type of elements in the queue. + 1 + + + Initializes a new instance of the class that is empty and has the default initial capacity. + + + Initializes a new instance of the class that contains elements copied from the specified collection and has sufficient capacity to accommodate the number of elements copied. + The collection whose elements are copied to the new . + + is null. + + + Initializes a new instance of the class that is empty and has the specified initial capacity. + The initial number of elements that the can contain. + + is less than zero. + + + Removes all objects from the . + 1 + + + Determines whether an element is in the . + true if is found in the ; otherwise, false. + The object to locate in the . The value can be null for reference types. + + + Copies the elements to an existing one-dimensional , starting at the specified array index. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + The number of elements in the source is greater than the available space from to the end of the destination . + + + Gets the number of elements contained in the . + The number of elements contained in the . + + + Removes and returns the object at the beginning of the . + The object that is removed from the beginning of the . + The is empty. + + + Adds an object to the end of the . + The object to add to the . The value can be null for reference types. + + + Returns an enumerator that iterates through the . + An for the . + + + Returns the object at the beginning of the without removing it. + The object at the beginning of the . + The is empty. + + + Returns an enumerator that iterates through a collection. + An that can be used to iterate through the collection. + + + Copies the elements of the to an , starting at a particular index. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- does not have zero-based indexing.-or-The number of elements in the source is greater than the available space from to the end of the destination .-or-The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. In the default implementation of , this property always returns false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . In the default implementation of , this property always returns the current instance. + + + Returns an enumerator that iterates through a collection. + An that can be used to iterate through the collection. + + + Copies the elements to a new array. + A new array containing elements copied from the . + + + Sets the capacity to the actual number of elements in the , if that number is less than 90 percent of current capacity. + + + Enumerates the elements of a . + + + Gets the element at the current position of the enumerator. + The element in the at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Releases all resources used by the . + + + Advances the enumerator to the next element of the . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Gets the element at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Sets the enumerator to its initial position, which is before the first element in the collection. + The collection was modified after the enumerator was created. + + + Represents a collection of key/value pairs that are sorted on the key. + The type of the keys in the dictionary. + The type of the values in the dictionary. + 1 + + + Initializes a new instance of the class that is empty and uses the default implementation for the key type. + + + Initializes a new instance of the class that is empty and uses the specified implementation to compare keys. + The implementation to use when comparing keys, or null to use the default for the type of the key. + + + Initializes a new instance of the class that contains elements copied from the specified and uses the default implementation for the key type. + The whose elements are copied to the new . + + is null. + + contains one or more duplicate keys. + + + Initializes a new instance of the class that contains elements copied from the specified and uses the specified implementation to compare keys. + The whose elements are copied to the new . + The implementation to use when comparing keys, or null to use the default for the type of the key. + + is null. + + contains one or more duplicate keys. + + + Adds an element with the specified key and value into the . + The key of the element to add. + The value of the element to add. The value can be null for reference types. + + is null. + An element with the same key already exists in the . + + + Removes all elements from the . + + + Gets the used to order the elements of the . + The used to order the elements of the + + + Determines whether the contains an element with the specified key. + true if the contains an element with the specified key; otherwise, false. + The key to locate in the . + + is null. + + + Determines whether the contains an element with the specified value. + true if the contains an element with the specified value; otherwise, false. + The value to locate in the . The value can be null for reference types. + + + Copies the elements of the to the specified array of structures, starting at the specified index. + The one-dimensional array of structures that is the destination of the elements copied from the current The array must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than 0. + The number of elements in the source is greater than the available space from to the end of the destination . + + + Gets the number of key/value pairs contained in the . + The number of key/value pairs contained in the . + + + Returns an enumerator that iterates through the . + A for the . + + + Gets or sets the value associated with the specified key. + The value associated with the specified key. If the specified key is not found, a get operation throws a , and a set operation creates a new element with the specified key. + The key of the value to get or set. + + is null. + The property is retrieved and does not exist in the collection. + + + Gets a collection containing the keys in the . + A containing the keys in the . + + + Removes the element with the specified key from the . + true if the element is successfully removed; otherwise, false. This method also returns false if is not found in the . + The key of the element to remove. + + is null. + + + Adds an item to the . + The structure to add to the . + + is null. + An element with the same key already exists in the . + + + Determines whether the contains a specific key and value. + true if is found in the ; otherwise, false. + The structure to locate in the . + + + Gets a value indicating whether the is read-only. + true if the is read-only; otherwise, false. In the default implementation of , this property always returns false. + + + Removes the first occurrence of the specified element from the . + true if was successfully removed from the ; otherwise, false. This method also returns false if was not found in the . + The structure to remove from the . + + + Gets an containing the keys of the . + An containing the keys of the . + + + Gets an containing the values in the . + An containing the values in the . + + + Returns an enumerator that iterates through a collection. + An that can be used to iterate through the collection. + + + Copies the elements of the to an array, starting at the specified array index. + The one-dimensional array that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than 0. + + is multidimensional.-or- does not have zero-based indexing.-or-The number of elements in the source is greater than the available space from to the end of the destination .-or-The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. In the default implementation of , this property always returns false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . + + + Adds an element with the provided key and value to the . + The object to use as the key of the element to add. + The object to use as the value of the element to add. + + is null. + + is of a type that is not assignable to the key type of the .-or- is of a type that is not assignable to the value type of the .-or-An element with the same key already exists in the . + + + Determines whether the contains an element with the specified key. + true if the contains an element with the key; otherwise, false. + The key to locate in the . + + is null. + + + Returns an for the . + An for the . + + + Gets a value indicating whether the has a fixed size. + true if the has a fixed size; otherwise, false. In the default implementation of , this property always returns false. + + + Gets a value indicating whether the is read-only. + true if the is read-only; otherwise, false. In the default implementation of , this property always returns false. + + + Gets or sets the element with the specified key. + The element with the specified key, or null if is not in the dictionary or is of a type that is not assignable to the key type of the . + The key of the element to get. + + is null. + A value is being assigned, and is of a type that is not assignable to the key type of the .-or-A value is being assigned, and is of a type that is not assignable to the value type of the . + + + Gets an containing the keys of the . + An containing the keys of the . + + + Removes the element with the specified key from the . + The key of the element to remove. + + is null. + + + Gets an containing the values in the . + An containing the values in the . + + + Returns an enumerator that iterates through the collection. + An that can be used to iterate through the collection. + + + Gets the value associated with the specified key. + true if the contains an element with the specified key; otherwise, false. + The key of the value to get. + When this method returns, the value associated with the specified key, if the key is found; otherwise, the default value for the type of the parameter. + + is null. + + + Gets a collection containing the values in the . + A containing the values in the . + + + Enumerates the elements of a . + + + Gets the element at the current position of the enumerator. + The element in the at the current position of the enumerator. + + + Releases all resources used by the . + + + Advances the enumerator to the next element of the . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Gets the element at the current position of the enumerator as a structure. + The element in the collection at the current position of the dictionary, as a structure. + The enumerator is positioned before the first element of the collection or after the last element. + + + Gets the key of the element at the current position of the enumerator. + The key of the element in the collection at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Gets the value of the element at the current position of the enumerator. + The value of the element in the collection at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Gets the element at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Sets the enumerator to its initial position, which is before the first element in the collection. + The collection was modified after the enumerator was created. + + + Represents the collection of keys in a . This class cannot be inherited. + + + Initializes a new instance of the class that reflects the keys in the specified . + The whose keys are reflected in the new . + + is null. + + + Copies the elements to an existing one-dimensional array, starting at the specified array index. + The one-dimensional array that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than 0. + The number of elements in the source is greater than the available space from to the end of the destination . + + + Gets the number of elements contained in the . + The number of elements contained in the . + + + Returns an enumerator that iterates through the . + A structure for the . + + + Adds an item to the . This implementation always throws a . + The object to add to the . + Always thrown; the collection is read-only. + + + Removes all items from the . This implementation always throws a . + Always thrown; the collection is read-only. + + + Determines whether the contains the specified value. + true if is found in the ; otherwise, false. + The object to locate in the . + + + Gets a value indicating whether the is read-only. + true if the is read-only; otherwise, false. In the default implementation of , this property always returns false. + + + Removes the first occurrence of a specific object from the . This implementation always throws a . + true if is successfully removed from the ; otherwise, false. This method also returns false if is not found in the . + The object to remove from the . + Always thrown; the collection is read-only. + + + Returns an enumerator that iterates through the collection. + An that can be used to iterate through the collection. + + + Copies the elements of the to an array, starting at a particular array index. + The one-dimensional array that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than 0. + + is multidimensional.-or- does not have zero-based indexing.-or-The number of elements in the source is greater than the available space from to the end of the destination .-or-The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. In the default implementation of , this property always returns false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . In the default implementation of , this property always returns the current instance. + + + Returns an enumerator that iterates through the collection. + An that can be used to iterate through the collection. + + + Enumerates the elements of a . + + + Gets the element at the current position of the enumerator. + The element in the at the current position of the enumerator. + + + Releases all resources used by the . + + + Advances the enumerator to the next element of the . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Gets the element at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Sets the enumerator to its initial position, which is before the first element in the collection. + The collection was modified after the enumerator was created. + + + Represents the collection of values in a . This class cannot be inherited + + + Initializes a new instance of the class that reflects the values in the specified . + The whose values are reflected in the new . + + is null. + + + Copies the elements to an existing one-dimensional array, starting at the specified array index. + The one-dimensional array that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than 0. + The number of elements in the source is greater than the available space from to the end of the destination . + + + Gets the number of elements contained in the . + The number of elements contained in the . + + + Returns an enumerator that iterates through the . + A structure for the . + + + Adds an item to the . This implementation always throws a . + The object to add to the . + Always thrown; the collection is read-only. + + + Removes all items from the . This implementation always throws a . + Always thrown; the collection is read-only. + + + Determines whether the contains a specified value. + true if is found in the ; otherwise, false. + The object to locate in the . + + + Gets a value indicating whether the is read-only. + true if the is read-only; otherwise, false. In the default implementation of , this property always returns false. + + + Removes the first occurrence of a specific object from the . This implementation always throws a . + true if is successfully removed from the ; otherwise, false. This method also returns false if is not found in the . + The object to remove from the . + Always thrown; the collection is read-only. + + + Removes the first occurrence of a specific object from the . This implementation always throws a . + true if is successfully removed from the ; otherwise, false. This method also returns false if is not found in the . + Always thrown; the collection is read-only. + + + Copies the elements of the to an array, starting at a particular array index. + The one-dimensional array that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than 0. + + is multidimensional.-or- does not have zero-based indexing.-or-The number of elements in the source is greater than the available space from to the end of the destination .-or-The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. In the default implementation of , this property always returns false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . In the default implementation of , this property always returns the current instance. + + + Returns an enumerator that iterates through the collection. + An that can be used to iterate through the collection. + + + Enumerates the elements of a . + + + Gets the element at the current position of the enumerator. + The element in the at the current position of the enumerator. + + + Releases all resources used by the . + + + Advances the enumerator to the next element of the . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Gets the element at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Sets the enumerator to its initial position, which is before the first element in the collection. + The collection was modified after the enumerator was created. + + + Represents a collection of key/value pairs that are sorted by key based on the associated implementation. + The type of keys in the collection. + The type of values in the collection. + + + Initializes a new instance of the class that is empty, has the default initial capacity, and uses the default . + + + Initializes a new instance of the class that is empty, has the default initial capacity, and uses the specified . + The implementation to use when comparing keys.-or-null to use the default for the type of the key. + + + Initializes a new instance of the class that contains elements copied from the specified , has sufficient capacity to accommodate the number of elements copied, and uses the default . + The whose elements are copied to the new . + + is null. + + contains one or more duplicate keys. + + + Initializes a new instance of the class that contains elements copied from the specified , has sufficient capacity to accommodate the number of elements copied, and uses the specified . + The whose elements are copied to the new . + The implementation to use when comparing keys.-or-null to use the default for the type of the key. + + is null. + + contains one or more duplicate keys. + + + Initializes a new instance of the class that is empty, has the specified initial capacity, and uses the default . + The initial number of elements that the can contain. + + is less than zero. + + + Initializes a new instance of the class that is empty, has the specified initial capacity, and uses the specified . + The initial number of elements that the can contain. + The implementation to use when comparing keys.-or-null to use the default for the type of the key. + + is less than zero. + + + Adds an element with the specified key and value into the . + The key of the element to add. + The value of the element to add. The value can be null for reference types. + + is null. + An element with the same key already exists in the . + + + Gets or sets the number of elements that the can contain. + The number of elements that the can contain. + + is set to a value that is less than . + There is not enough memory available on the system. + + + Removes all elements from the . + + + Gets the for the sorted list. + The for the current . + + + Determines whether the contains a specific key. + true if the contains an element with the specified key; otherwise, false. + The key to locate in the . + + is null. + + + Determines whether the contains a specific value. + true if the contains an element with the specified value; otherwise, false. + The value to locate in the . The value can be null for reference types. + + + Gets the number of key/value pairs contained in the . + The number of key/value pairs contained in the . + + + Returns an enumerator that iterates through the . + An of type for the . + + + Searches for the specified key and returns the zero-based index within the entire . + The zero-based index of within the entire , if found; otherwise, -1. + The key to locate in the . + + is null. + + + Searches for the specified value and returns the zero-based index of the first occurrence within the entire . + The zero-based index of the first occurrence of within the entire , if found; otherwise, -1. + The value to locate in the . The value can be null for reference types. + + + Gets or sets the value associated with the specified key. + The value associated with the specified key. If the specified key is not found, a get operation throws a and a set operation creates a new element using the specified key. + The key whose value to get or set. + + is null. + The property is retrieved and does not exist in the collection. + + + Gets a collection containing the keys in the . + A containing the keys in the . + + + Removes the element with the specified key from the . + true if the element is successfully removed; otherwise, false. This method also returns false if was not found in the original . + The key of the element to remove. + + is null. + + + Removes the element at the specified index of the . + The zero-based index of the element to remove. + + is less than zero.-or- is equal to or greater than . + + + Adds a key/value pair to the . + The to add to the . + + + Determines whether the contains a specific element. + true if is found in the ; otherwise, false. + The to locate in the . + + + Copies the elements of the to an , starting at a particular index. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + The number of elements in the source is greater than the available space from to the end of the destination . + + + Gets a value indicating whether the is read-only. + true if the is read-only; otherwise, false. In the default implementation of , this property always returns false. + + + Removes the first occurrence of a specific key/value pair from the . + true if was successfully removed from the ; otherwise, false. This method also returns false if was not found in the original . + The to remove from the . + + + Gets an containing the keys of the . + An containing the keys of the . + + + Gets an containing the values in the . + An containing the values in the . + + + Returns an enumerator that iterates through a collection. + An that can be used to iterate through the collection. + + + Copies the elements of the to an , starting at a particular index. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- does not have zero-based indexing.-or-The number of elements in the source is greater than the available space from to the end of the destination .-or-The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. In the default implementation of , this property always returns false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . In the default implementation of , this property always returns the current instance. + + + Adds an element with the provided key and value to the . + The to use as the key of the element to add. + The to use as the value of the element to add. + + is null. + + is of a type that is not assignable to the key type of the .-or- is of a type that is not assignable to the value type of the .-or-An element with the same key already exists in the . + + + Determines whether the contains an element with the specified key. + true if the contains an element with the key; otherwise, false. + The key to locate in the . + + is null. + + + Returns an for the . + An for the . + + + Gets a value indicating whether the has a fixed size. + true if the has a fixed size; otherwise, false. In the default implementation of , this property always returns false. + + + Gets a value indicating whether the is read-only. + true if the is read-only; otherwise, false. In the default implementation of , this property always returns false. + + + Gets or sets the element with the specified key. + The element with the specified key, or null if is not in the dictionary or is of a type that is not assignable to the key type of the . + The key of the element to get or set. + + is null. + A value is being assigned, and is of a type that is not assignable to the key type of the .-or-A value is being assigned, and is of a type that is not assignable to the value type of the . + + + Gets an containing the keys of the . + An containing the keys of the . + + + Removes the element with the specified key from the . + The key of the element to remove. + + is null. + + + Gets an containing the values in the . + An containing the values in the . + + + Returns an enumerator that iterates through a collection. + An that can be used to iterate through the collection. + + + Sets the capacity to the actual number of elements in the , if that number is less than 90 percent of current capacity. + + + Gets the value associated with the specified key. + true if the contains an element with the specified key; otherwise, false. + The key whose value to get. + When this method returns, the value associated with the specified key, if the key is found; otherwise, the default value for the type of the parameter. This parameter is passed uninitialized. + + is null. + + + Gets a collection containing the values in the . + A containing the values in the . + + + Represents a collection of objects that is maintained in sorted order. + The type of elements in the set. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class that uses a specified comparer. + The default comparer to use for comparing objects. + + is null. + + + Initializes a new instance of the class that contains elements copied from a specified enumerable collection. + The enumerable collection to be copied. + + + Initializes a new instance of the class that contains elements copied from a specified enumerable collection and that uses a specified comparer. + The enumerable collection to be copied. + The default comparer to use for comparing objects. + + is null. + + + Initializes a new instance of the class that contains serialized data. + The object that contains the information that is required to serialize the object. + The structure that contains the source and destination of the serialized stream associated with the object. + + + Adds an element to the set and returns a value that indicates if it was successfully added. + true if is added to the set; otherwise, false. + The element to add to the set. + + + Removes all elements from the set. + + + Gets the object that is used to determine equality for the values in the . + The comparer that is used to determine equality for the values in the . + + + Determines whether the set contains a specific element. + true if the set contains ; otherwise, false. + The element to locate in the set. + + + Copies the complete to a compatible one-dimensional array, starting at the beginning of the target array. + A one-dimensional array that is the destination of the elements copied from the . + The number of elements in the source exceeds the number of elements that the destination array can contain. + + is null. + + + Copies the complete to a compatible one-dimensional array, starting at the specified array index. + A one-dimensional array that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + The number of elements in the source array is greater than the available space from to the end of the destination array. + + is null. + + is less than zero. + + + Copies a specified number of elements from to a compatible one-dimensional array, starting at the specified array index. + A one-dimensional array that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + The number of elements to copy. + The number of elements in the source array is greater than the available space from to the end of the destination array. + + is null. + + is less than zero.-or- is less than zero. + + + Gets the number of elements in the . + The number of elements in the . + + + Returns an object that can be used to create a collection that contains individual sets. + A comparer for creating a collection of sets. + + + Returns an object, according to a specified comparer, that can be used to create a collection that contains individual sets. + A comparer for creating a collection of sets. + The comparer to use for creating the returned comparer. + + + Removes all elements that are in a specified collection from the current object. + The collection of items to remove from the object. + + is null. + + + Returns an enumerator that iterates through the . + An enumerator that iterates through the . + + + Implements the interface and returns the data that you must have to serialize a object. + A object that contains the information that is required to serialize the object. + A structure that contains the source and destination of the serialized stream associated with the object. + + is null. + + + Returns a view of a subset in a . + A subset view that contains only the values in the specified range. + The lowest desired value in the view. + The highest desired value in the view. + + is more than according to the comparer. + A tried operation on the view was outside the range specified by and . + + + Modifies the current object so that it contains only elements that are also in a specified collection. + The collection to compare to the current object. + + is null. + + + Determines whether a object is a proper subset of the specified collection. + true if the object is a proper subset of ; otherwise, false. + The collection to compare to the current object. + + is null. + + + Determines whether a object is a proper superset of the specified collection. + true if the object is a proper superset of ; otherwise, false. + The collection to compare to the current object. + + is null. + + + Determines whether a object is a subset of the specified collection. + true if the current object is a subset of ; otherwise, false. + The collection to compare to the current object. + + is null. + + + Determines whether a object is a superset of the specified collection. + true if the object is a superset of ; otherwise, false. + The collection to compare to the current object. + + is null. + + + Gets the maximum value in the , as defined by the comparer. + The maximum value in the set. + + + Gets the minimum value in the , as defined by the comparer. + The minimum value in the set. + + + Implements the interface, and raises the deserialization event when the deserialization is completed. + The source of the deserialization event. + The object associated with the current object is invalid. + + + Determines whether the current object and a specified collection share common elements. + true if the object and share at least one common element; otherwise, false. + The collection to compare to the current object. + + is null. + + + Removes a specified item from the . + true if the element is found and successfully removed; otherwise, false. + The element to remove. + + + Removes all elements that match the conditions defined by the specified predicate from a . + The number of elements that were removed from the collection.. + The delegate that defines the conditions of the elements to remove. + + is null. + + + Returns an that iterates over the in reverse order. + An enumerator that iterates over the in reverse order. + + + Determines whether the current object and the specified collection contain the same elements. + true if the current object is equal to ; otherwise, false. + The collection to compare to the current object. + + is null. + + + Modifies the current object so that it contains only elements that are present either in the current object or in the specified collection, but not both. + The collection to compare to the current object. + + is null. + + + Adds an item to an object. + The object to add to the object. + The is read-only. + + + Gets a value that indicates whether a is read-only. + true if the collection is read-only; otherwise, false. + + + Returns an enumerator that iterates through a collection. + An enumerator that can be used to iterate through the collection. + + + Copies the complete to a compatible one-dimensional array, starting at the specified array index. + A one-dimensional array that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + The number of elements in the source array is greater than the available space from to the end of the destination array. + + is null. + + is less than zero. + + + Gets a value that indicates whether access to the is synchronized (thread safe). + true if access to the is synchronized; otherwise, false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . In the default implementation of , this property always returns the current instance. + + + Returns an enumerator that iterates through a collection. + An enumerator that can be used to iterate through the collection. + + + Implements the interface, and raises the deserialization event when the deserialization is completed. + The source of the deserialization event. + The object associated with the current instance is invalid. + + + Implements the interface, and returns the data that you need to serialize the instance. + A object that contains the information that is required to serialize the instance. + A structure that contains the source and destination of the serialized stream associated with the instance. + + is null. + + + Modifies the current object so that it contains all elements that are present in both the current object and in the specified collection. + The collection to compare to the current object. + + is null. + + + Enumerates the elements of a object. + + + Gets the element at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + + + Releases all resources used by the . + + + Advances the enumerator to the next element of the collection. + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Gets the element at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Sets the enumerator to its initial position, which is before the first element in the collection. + The collection was modified after the enumerator was created. + + + Implements the interface and raises the deserialization event when the deserialization is complete. + The source of the deserialization event. + The object associated with the current instance is invalid. + + + Implements the interface and returns the data needed to serialize the instance. + A object that contains the information required to serialize the instance. + A object that contains the source and destination of the serialized stream associated with the instance. + + is null. + + + Represents a variable size last-in-first-out (LIFO) collection of instances of the same arbitrary type. + Specifies the type of elements in the stack. + 1 + + + Initializes a new instance of the class that is empty and has the default initial capacity. + + + Initializes a new instance of the class that contains elements copied from the specified collection and has sufficient capacity to accommodate the number of elements copied. + The collection to copy elements from. + + is null. + + + Initializes a new instance of the class that is empty and has the specified initial capacity or the default initial capacity, whichever is greater. + The initial number of elements that the can contain. + + is less than zero. + + + Removes all objects from the . + 1 + + + Determines whether an element is in the . + true if is found in the ; otherwise, false. + The object to locate in the . The value can be null for reference types. + + + Copies the to an existing one-dimensional , starting at the specified array index. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + The number of elements in the source is greater than the available space from to the end of the destination . + + + Gets the number of elements contained in the . + The number of elements contained in the . + + + Returns an enumerator for the . + An for the . + + + Returns the object at the top of the without removing it. + The object at the top of the . + The is empty. + + + Removes and returns the object at the top of the . + The object removed from the top of the . + The is empty. + + + Inserts an object at the top of the . + The object to push onto the . The value can be null for reference types. + + + Returns an enumerator that iterates through the collection. + An that can be used to iterate through the collection. + + + Copies the elements of the to an , starting at a particular index. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- does not have zero-based indexing.-or-The number of elements in the source is greater than the available space from to the end of the destination .-or-The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. In the default implementation of , this property always returns false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . In the default implementation of , this property always returns the current instance. + + + Returns an enumerator that iterates through a collection. + An that can be used to iterate through the collection. + + + Copies the to a new array. + A new array containing copies of the elements of the . + + + Sets the capacity to the actual number of elements in the , if that number is less than 90 percent of current capacity. + + + Enumerates the elements of a . + + + Gets the element at the current position of the enumerator. + The element in the at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Releases all resources used by the . + + + Advances the enumerator to the next element of the . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Gets the element at the current position of the enumerator. + The element in the collection at the current position of the enumerator. + The enumerator is positioned before the first element of the collection or after the last element. + + + Sets the enumerator to its initial position, which is before the first element in the collection. This class cannot be inherited. + The collection was modified after the enumerator was created. + + + Represents a dynamic data collection that provides notifications when items get added, removed, or when the whole list is refreshed. + The type of elements in the collection. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class that contains elements copied from the specified collection. + The collection from which the elements are copied. + The parameter cannot be null. + + + Initializes a new instance of the class that contains elements copied from the specified list. + The list from which the elements are copied. + The parameter cannot be null. + + + Disallows reentrant attempts to change this collection. + An object that can be used to dispose of the object. + + + Checks for reentrant attempts to change this collection. + If there was a call to of which the return value has not yet been disposed of. Typically, this means when there are additional attempts to change this collection during a event. However, it depends on when derived classes choose to call . + + + Removes all items from the collection. + + + Occurs when an item is added, removed, changed, moved, or the entire list is refreshed. + + + Inserts an item into the collection at the specified index. + The zero-based index at which should be inserted. + The object to insert. + + + Moves the item at the specified index to a new location in the collection. + The zero-based index specifying the location of the item to be moved. + The zero-based index specifying the new location of the item. + + + Moves the item at the specified index to a new location in the collection. + The zero-based index specifying the location of the item to be moved. + The zero-based index specifying the new location of the item. + + + Raises the event with the provided arguments. + Arguments of the event being raised. + + + Raises the event with the provided arguments. + Arguments of the event being raised. + + + Occurs when a property value changes. + + + Removes the item at the specified index of the collection. + The zero-based index of the element to remove. + + + Replaces the element at the specified index. + The zero-based index of the element to replace. + The new value for the element at the specified index. + + + Occurs when a property value changes. + + + Represents a read-only . + The type of elements in the collection. + + + Initializes a new instance of the class that serves as a wrapper around the specified . + The with which to create this instance of the class. + + is null. + + + Occurs when an item is added or removed. + + + Raises the event using the provided arguments. + Arguments of the event being raised. + + + Raises the event using the provided arguments. + Arguments of the event being raised. + + + Occurs when a property value changes. + + + Occurs when the collection changes. + + + Occurs when a property value changes. + + + Provides a simple structure that stores Boolean values and small integers in 32 bits of memory. + + + Initializes a new instance of the structure containing the data represented in an existing structure. + A structure that contains the data to copy. + + + Initializes a new instance of the structure containing the data represented in an integer. + An integer representing the data of the new . + + + Creates the first mask in a series of masks that can be used to retrieve individual bits in a that is set up as bit flags. + A mask that isolates the first bit flag in the . + + + + + + Creates an additional mask following the specified mask in a series of masks that can be used to retrieve individual bits in a that is set up as bit flags. + A mask that isolates the bit flag following the one that points to in . + The mask that indicates the previous bit flag. + + indicates the last bit flag in the . + + + Creates the first in a series of sections that contain small integers. + A that can hold a number from zero to . + A 16-bit signed integer that specifies the maximum value for the new . + + is less than 1. + + + Creates a new following the specified in a series of sections that contain small integers. + A that can hold a number from zero to . + A 16-bit signed integer that specifies the maximum value for the new . + The previous in the . + + is less than 1. + + includes the final bit in the .-or- is greater than the highest value that can be represented by the number of bits after . + + + Gets the value of the as an integer. + The value of the as an integer. + + + Determines whether the specified object is equal to the . + true if the specified object is equal to the ; otherwise, false. + The object to compare with the current . + + + Serves as a hash function for the . + A hash code for the . + + + Gets or sets the value stored in the specified . + The value stored in the specified . + A that contains the value to get or set. + + + Gets or sets the state of the bit flag indicated by the specified mask. + true if the specified bit flag is on (1); otherwise, false. + A mask that indicates the bit to get or set. + + + Returns a string that represents the current . + A string that represents the current . + + + Returns a string that represents the specified . + A string that represents the specified . + The to represent. + + + Represents a section of the vector that can contain an integer number. + + + Determines whether the specified object is the same as the current object. + true if the parameter is the same as the current object; otherwise false. + The object to compare with the current object. + + + Determines whether the specified object is the same as the current object. + true if the specified object is the same as the current object; otherwise, false. + The object to compare with the current . + + + Serves as a hash function for the current , suitable for hashing algorithms and data structures, such as a hash table. + A hash code for the current . + + + Gets a mask that isolates this section within the . + A mask that isolates this section within the . + + + Gets the offset of this section from the start of the . + The offset of this section from the start of the . + + + Determines whether two specified objects are equal. + true if the and parameters represent the same object, otherwise, false. + A object. + A object. + + + Determines whether two objects have different values. + true if the and parameters represent different objects; otherwise, false. + A object. + A object. + + + Returns a string that represents the current . + A string that represents the current . + + + Returns a string that represents the specified . + A string that represents the specified . + The to represent. + + + Creates collections that ignore the case in strings. + + + Initializes a new instance of the class. + + + Creates a new case-insensitive instance of the class with the default initial capacity. + A new case-insensitive instance of the class with the default initial capacity. + + + + + + Copies the entries from the specified dictionary to a new case-insensitive instance of the class with the same initial capacity as the number of entries copied. + A new case-insensitive instance of the class containing the entries from the specified . + The to copy to a new case-insensitive . + + is null. + + + Creates a new case-insensitive instance of the class with the specified initial capacity. + A new case-insensitive instance of the class with the specified initial capacity. + The approximate number of entries that the can initially contain. + + is less than zero. + + + Creates a new instance of the class that ignores the case of strings. + A new instance of the class that ignores the case of strings. + + + Implements IDictionary by using a while the collection is small, and then switching to a when the collection gets large. + + + Creates an empty case-sensitive . + + + Creates an empty with the specified case sensitivity. + A Boolean that denotes whether the is case-insensitive. + + + Creates a case-sensitive with the specified initial size. + The approximate number of entries that the can initially contain. + + + Creates a with the specified initial size and case sensitivity. + The approximate number of entries that the can initially contain. + A Boolean that denotes whether the is case-insensitive. + + + Adds an entry with the specified key and value into the . + The key of the entry to add. + The value of the entry to add. The value can be null. + + is null. + An entry with the same key already exists in the . + + + Removes all entries from the . + + + Determines whether the contains a specific key. + true if the contains an entry with the specified key; otherwise, false. + The key to locate in the . + + is null. + + + Copies the entries to a one-dimensional instance at the specified index. + The one-dimensional that is the destination of the objects copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in the source is greater than the available space from to the end of the destination . + The type of the source cannot be cast automatically to the type of the destination . + + + Gets the number of key/value pairs contained in the . + The number of key/value pairs contained in the .Retrieving the value of this property is an O(1) operation. + + + Returns an that iterates through the . + An for the . + + + Gets a value indicating whether the has a fixed size. + This property always returns false. + + + Gets a value indicating whether the is read-only. + This property always returns false. + + + Gets a value indicating whether the is synchronized (thread safe). + This property always returns false. + + + Gets or sets the value associated with the specified key. + The value associated with the specified key. If the specified key is not found, attempting to get it returns null, and attempting to set it creates a new entry using the specified key. + The key whose value to get or set. + + is null. + + + Gets an containing the keys in the . + An containing the keys in the . + + + Removes the entry with the specified key from the . + The key of the entry to remove. + + is null. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . + + + Returns an that iterates through the . + An for the . + + + Gets an containing the values in the . + An containing the values in the . + + + Notifies listeners of dynamic changes, such as when items get added and removed or the whole list is refreshed. + + + Occurs when the collection changes. + + + Represents an indexed collection of key/value pairs. + + + Returns an enumerator that iterates through the collection. + An for the entire collection. + + + Inserts a key/value pair into the collection at the specified index. + The zero-based index at which the key/value pair should be inserted. + The object to use as the key of the element to add. + The object to use as the value of the element to add. The value can be null. + + is less than 0.-or- is greater than . + + is null. + An element with the same key already exists in the collection. + The collection is read-only.-or-The collection has a fixed size. + + + Gets or sets the element at the specified index. + The element at the specified index. + The zero-based index of the element to get or set. + + is less than 0.-or- is equal to or greater than . + + + Removes the element at the specified index. + The zero-based index of the element to remove. + + is less than 0.-or- is equal to or greater than . + The collection is read-only.-or- The collection has a fixed size. + + + Implements IDictionary using a singly linked list. Recommended for collections that typically contain 10 items or less. + + + Creates an empty using the default comparer. + + + Creates an empty using the specified comparer. + The to use to determine whether two keys are equal.-or- null to use the default comparer, which is each key's implementation of . + + + Adds an entry with the specified key and value into the . + The key of the entry to add. + The value of the entry to add. The value can be null. + + is null. + An entry with the same key already exists in the . + + + Removes all entries from the . + + + Determines whether the contains a specific key. + true if the contains an entry with the specified key; otherwise, false. + The key to locate in the . + + is null. + + + Copies the entries to a one-dimensional instance at the specified index. + The one-dimensional that is the destination of the objects copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in the source is greater than the available space from to the end of the destination . + The type of the source cannot be cast automatically to the type of the destination . + + + Gets the number of key/value pairs contained in the . + The number of key/value pairs contained in the . + + + Returns an that iterates through the . + An for the . + + + Gets a value indicating whether the has a fixed size. + This property always returns false. + + + Gets a value indicating whether the is read-only. + This property always returns false. + + + Gets a value indicating whether the is synchronized (thread safe). + This property always returns false. + + + Gets or sets the value associated with the specified key. + The value associated with the specified key. If the specified key is not found, attempting to get it returns null, and attempting to set it creates a new entry using the specified key. + The key whose value to get or set. + + is null. + + + Gets an containing the keys in the . + An containing the keys in the . + + + Removes the entry with the specified key from the . + The key of the entry to remove. + + is null. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . + + + Returns an that iterates through the . + An for the . + + + Gets an containing the values in the . + An containing the values in the . + + + Provides the abstract base class for a collection of associated keys and values that can be accessed either with the key or with the index. + + + Initializes a new instance of the class that is empty. + + + Initializes a new instance of the class that is empty, has the default initial capacity, and uses the specified object. + The object to use to determine whether two keys are equal and to generate hash codes for the keys in the collection. + + + Initializes a new instance of the class that is empty, has the default initial capacity, and uses the specified hash code provider and the specified comparer. + The that will supply the hash codes for all keys in the instance. + The to use to determine whether two keys are equal. + + + Initializes a new instance of the class that is empty, has the specified initial capacity, and uses the default hash code provider and the default comparer. + The approximate number of entries that the instance can initially contain. + + is less than zero. + + + Initializes a new instance of the class that is empty, has the specified initial capacity, and uses the specified object. + The approximate number of entries that the object can initially contain. + The object to use to determine whether two keys are equal and to generate hash codes for the keys in the collection. + + is less than zero. + + + Initializes a new instance of the class that is empty, has the specified initial capacity and uses the specified hash code provider and the specified comparer. + The approximate number of entries that the instance can initially contain. + The that will supply the hash codes for all keys in the instance. + The to use to determine whether two keys are equal. + + is less than zero. + + + Initializes a new instance of the class that is serializable and uses the specified and . + A object that contains the information required to serialize the new instance. + A object that contains the source and destination of the serialized stream associated with the new instance. + + + Adds an entry with the specified key and value into the instance. + The key of the entry to add. The key can be null. + The value of the entry to add. The value can be null. + The collection is read-only. + + + Removes all entries from the instance. + The collection is read-only. + + + Gets the value of the entry at the specified index of the instance. + An that represents the value of the entry at the specified index. + The zero-based index of the value to get. + + is outside the valid range of indexes for the collection. + + + Gets the value of the first entry with the specified key from the instance. + An that represents the value of the first entry with the specified key, if found; otherwise, null. + The key of the entry to get. The key can be null. + + + Returns a array that contains all the keys in the instance. + A array that contains all the keys in the instance. + + + Returns an array that contains all the values in the instance. + An array that contains all the values in the instance. + + + Returns an array of the specified type that contains all the values in the instance. + An array of the specified type that contains all the values in the instance. + A that represents the type of array to return. + + is null. + + is not a valid . + + + Gets the key of the entry at the specified index of the instance. + A that represents the key of the entry at the specified index. + The zero-based index of the key to get. + + is outside the valid range of indexes for the collection. + + + Gets a value indicating whether the instance contains entries whose keys are not null. + true if the instance contains entries whose keys are not null; otherwise, false. + + + Removes the entries with the specified key from the instance. + The key of the entries to remove. The key can be null. + The collection is read-only. + + + Removes the entry at the specified index of the instance. + The zero-based index of the entry to remove. + + is outside the valid range of indexes for the collection. + The collection is read-only. + + + Sets the value of the entry at the specified index of the instance. + The zero-based index of the entry to set. + The that represents the new value of the entry to set. The value can be null. + The collection is read-only. + + is outside the valid range of indexes for the collection. + + + Sets the value of the first entry with the specified key in the instance, if found; otherwise, adds an entry with the specified key and value into the instance. + The key of the entry to set. The key can be null. + The that represents the new value of the entry to set. The value can be null. + The collection is read-only. + + + Gets the number of key/value pairs contained in the instance. + The number of key/value pairs contained in the instance. + + + Returns an enumerator that iterates through the . + An for the instance. + + + Implements the interface and returns the data needed to serialize the instance. + A object that contains the information required to serialize the instance. + A object that contains the source and destination of the serialized stream associated with the instance. + + is null. + + + Gets or sets a value indicating whether the instance is read-only. + true if the instance is read-only; otherwise, false. + + + Gets a instance that contains all the keys in the instance. + A instance that contains all the keys in the instance. + + + Implements the interface and raises the deserialization event when the deserialization is complete. + The source of the deserialization event. + The object associated with the current instance is invalid. + + + Copies the entire to a compatible one-dimensional , starting at the specified index of the target array. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or-The number of elements in the source is greater than the available space from to the end of the destination . + The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the object is synchronized (thread safe). + true if access to the object is synchronized (thread safe); otherwise, false. The default is false. + + + Gets an object that can be used to synchronize access to the object. + An object that can be used to synchronize access to the object. + + + Represents a collection of the keys of a collection. + + + Gets the number of keys in the . + The number of keys in the . + + + Gets the key at the specified index of the collection. + A that contains the key at the specified index of the collection. + The zero-based index of the key to get from the collection. + + is outside the valid range of indexes for the collection. + + + Returns an enumerator that iterates through the . + An for the . + + + Gets the entry at the specified index of the collection. + The key of the entry at the specified index of the collection. + The zero-based index of the entry to locate in the collection. + + is outside the valid range of indexes for the collection. + + + Copies the entire to a compatible one-dimensional , starting at the specified index of the target array. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in the source is greater than the available space from to the end of the destination . + The type of the source cannot be cast automatically to the type of the destination . + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. The default is false. + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . + + + Represents a collection of associated keys and values that can be accessed either with the key or with the index. + + + Initializes a new instance of the class that is empty, has the default initial capacity and uses the default case-insensitive hash code provider and the default case-insensitive comparer. + + + Initializes a new instance of the class that is empty, has the default initial capacity, and uses the specified object. + The object to use to determine whether two keys are equal and to generate hash codes for the keys in the collection. + + + Initializes a new instance of the class that is empty, has the default initial capacity and uses the specified hash code provider and the specified comparer. + The that will supply the hash codes for all keys in the . + The to use to determine whether two keys are equal. + + + Copies the entries from the specified to a new with the same initial capacity as the number of entries copied and using the same hash code provider and the same comparer as the source collection. + The to copy to the new instance. + + is null. + + + Initializes a new instance of the class that is empty, has the specified initial capacity and uses the default case-insensitive hash code provider and the default case-insensitive comparer. + The initial number of entries that the can contain. + + is less than zero. + + + Initializes a new instance of the class that is empty, has the specified initial capacity, and uses the specified object. + The initial number of entries that the object can contain. + The object to use to determine whether two keys are equal and to generate hash codes for the keys in the collection. + + is less than zero. + + + Initializes a new instance of the class that is empty, has the specified initial capacity and uses the specified hash code provider and the specified comparer. + The initial number of entries that the can contain. + The that will supply the hash codes for all keys in the . + The to use to determine whether two keys are equal. + + is less than zero. + + + Copies the entries from the specified to a new with the specified initial capacity or the same initial capacity as the number of entries copied, whichever is greater, and using the default case-insensitive hash code provider and the default case-insensitive comparer. + The initial number of entries that the can contain. + The to copy to the new instance. + + is less than zero. + + is null. + + + Initializes a new instance of the class that is serializable and uses the specified and . + A object that contains the information required to serialize the new instance. + A object that contains the source and destination of the serialized stream associated with the new instance. + + + Copies the entries in the specified to the current . + The to copy to the current . + The collection is read-only. + + is null. + + + Adds an entry with the specified name and value to the . + The key of the entry to add. The key can be null. + The value of the entry to add. The value can be null. + The collection is read-only. + + + Gets all the keys in the . + A array that contains all the keys of the . + + + Invalidates the cached arrays and removes all entries from the . + The collection is read-only. + + + + + + Copies the entire to a compatible one-dimensional , starting at the specified index of the target array. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in the source is greater than the available space from to the end of the destination . + The type of the source cannot be cast automatically to the type of the destination . + + + Gets the values at the specified index of the combined into one comma-separated list. + A that contains a comma-separated list of the values at the specified index of the , if found; otherwise, null. + The zero-based index of the entry that contains the values to get from the collection. + + is outside the valid range of indexes for the collection. + + + Gets the values associated with the specified key from the combined into one comma-separated list. + A that contains a comma-separated list of the values associated with the specified key from the , if found; otherwise, null. + The key of the entry that contains the values to get. The key can be null. + + + Gets the key at the specified index of the . + A that contains the key at the specified index of the , if found; otherwise, null. + The zero-based index of the key to get from the collection. + + is outside the valid range of indexes for the collection. + + + Gets the values at the specified index of the . + A array that contains the values at the specified index of the , if found; otherwise, null. + The zero-based index of the entry that contains the values to get from the collection. + + is outside the valid range of indexes for the collection. + + + Gets the values associated with the specified key from the . + A array that contains the values associated with the specified key from the , if found; otherwise, null. + The key of the entry that contains the values to get. The key can be null. + + + Gets a value indicating whether the contains keys that are not null. + true if the contains keys that are not null; otherwise, false. + + + Resets the cached arrays of the collection to null. + + + Gets the entry at the specified index of the . + A that contains the comma-separated list of values at the specified index of the collection. + The zero-based index of the entry to locate in the collection. + + is outside the valid range of indexes for the collection. + + + Gets or sets the entry with the specified key in the . + A that contains the comma-separated list of values associated with the specified key, if found; otherwise, null. + The key of the entry to locate. The key can be null. + The collection is read-only and the operation attempts to modify the collection. + + + Removes the entries with the specified key from the instance. + The key of the entry to remove. The key can be null. + The collection is read-only. + + + Sets the value of an entry in the . + The key of the entry to add the new value to. The key can be null. + The that represents the new value to add to the specified entry. The value can be null. + The collection is read-only. + + + Describes the action that caused a event. + + + One or more items were added to the collection. + + + One or more items were removed from the collection. + + + One or more items were replaced in the collection. + + + One or more items were moved within the collection. + + + The content of the collection changed dramatically. + + + Provides data for the event. + + + Initializes a new instance of the class that describes a change. + The action that caused the event. This must be set to . + + + Initializes a new instance of the class that describes a multi-item change. + The action that caused the event. This can be set to , , or . + The items that are affected by the change. + + + Initializes a new instance of the class that describes a multi-item change. + The action that caused the event. This can only be set to . + The new items that are replacing the original items. + The original items that are replaced. + If is not Replace. + If or is null. + + + Initializes a new instance of the class that describes a multi-item change. + The action that caused the event. This can only be set to . + The new items that are replacing the original items. + The original items that are replaced. + The index of the first item of the items that are being replaced. + If is not Replace. + If or is null. + + + Initializes a new instance of the class that describes a multi-item change or a change. + The action that caused the event. This can be set to , , or . + The items affected by the change. + The index where the change occurred. + If is not Reset, Add, or Remove, if is Reset and either is not null or is not -1, or if action is Add or Remove and is less than -1. + If is Add or Remove and is null. + + + Initializes a new instance of the class that describes a multi-item change. + The action that caused the event. This can only be set to . + The items affected by the change. + The new index for the changed items. + The old index for the changed items. + If is not Move or is less than 0. + + + Initializes a new instance of the class that describes a one-item change. + The action that caused the event. This can be set to , , or . + The item that is affected by the change. + If is not Reset, Add, or Remove, or if is Reset and is not null. + + + Initializes a new instance of the class that describes a one-item change. + The action that caused the event. This can be set to , , or . + The item that is affected by the change. + The index where the change occurred. + If is not Reset, Add, or Remove, or if is Reset and either is not null or is not -1. + + + Initializes a new instance of the class that describes a one-item change. + The action that caused the event. This can only be set to . + The item affected by the change. + The new index for the changed item. + The old index for the changed item. + If is not Move or is less than 0. + + + Initializes a new instance of the class that describes a one-item change. + The action that caused the event. This can only be set to . + The new item that is replacing the original item. + The original item that is replaced. + If is not Replace. + + + Initializes a new instance of the class that describes a one-item change. + The action that caused the event. This can be set to . + The new item that is replacing the original item. + The original item that is replaced. + The index of the item being replaced. + If is not Replace. + + + Gets the action that caused the event. + A value that describes the action that caused the event. + + + Gets the list of new items involved in the change. + The list of new items involved in the change. + + + Gets the index at which the change occurred. + The zero-based index at which the change occurred. + + + Gets the list of items affected by a , Remove, or Move action. + The list of items affected by a , Remove, or Move action. + + + Gets the index at which a , Remove, or Replace action occurred. + The zero-based index at which a , Remove, or Replace action occurred. + + + Represents the method that handles the event. + The object that raised the event. + Information about the event. + + + Represents a collection of key/value pairs that are accessible by the key or index. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified comparer. + The to use to determine whether two keys are equal.-or- null to use the default comparer, which is each key's implementation of . + + + Initializes a new instance of the class using the specified initial capacity. + The initial number of elements that the collection can contain. + + + Initializes a new instance of the class using the specified initial capacity and comparer. + The initial number of elements that the collection can contain. + The to use to determine whether two keys are equal.-or- null to use the default comparer, which is each key's implementation of . + + + Initializes a new instance of the class that is serializable using the specified and objects. + A object containing the information required to serialize the collection. + A object containing the source and destination of the serialized stream associated with the . + + + Adds an entry with the specified key and value into the collection with the lowest available index. + The key of the entry to add. + The value of the entry to add. This value can be null. + The collection is read-only. + + + Returns a read-only copy of the current collection. + A read-only copy of the current collection. + + + Removes all elements from the collection. + The collection is read-only. + + + Determines whether the collection contains a specific key. + true if the collection contains an element with the specified key; otherwise, false. + The key to locate in the collection. + + + Copies the elements to a one-dimensional object at the specified index. + The one-dimensional object that is the destination of the objects copied from collection. The must have zero-based indexing. + The zero-based index in at which copying begins. + + + Gets the number of key/values pairs contained in the collection. + The number of key/value pairs contained in the collection. + + + Returns an object that iterates through the collection. + An object for the collection. + + + Implements the interface and returns the data needed to serialize the collection. + A object containing the information required to serialize the collection. + A object containing the source and destination of the serialized stream associated with the . + + is null. + + + Inserts a new entry into the collection with the specified key and value at the specified index. + The zero-based index at which the element should be inserted. + The key of the entry to add. + The value of the entry to add. The value can be null. + + is out of range. + This collection is read-only. + + + Gets a value indicating whether the collection is read-only. + true if the collection is read-only; otherwise, false. The default is false. + + + Gets or sets the value at the specified index. + The value of the item at the specified index. + The zero-based index of the value to get or set. + The property is being set and the collection is read-only. + + is less than zero.-or- is equal to or greater than . + + + Gets or sets the value with the specified key. + The value associated with the specified key. If the specified key is not found, attempting to get it returns null, and attempting to set it creates a new element using the specified key. + The key of the value to get or set. + The property is being set and the collection is read-only. + + + Gets an object containing the keys in the collection. + An object containing the keys in the collection. + + + Implements the interface and is called back by the deserialization event when deserialization is complete. + The source of the deserialization event. + The object associated with the current collection is invalid. + + + Removes the entry with the specified key from the collection. + The key of the entry to remove. + The collection is read-only. + + is null. + + + Removes the entry at the specified index from the collection. + The zero-based index of the entry to remove. + The collection is read-only. + + is less than zero.- or - is equal to or greater than . + + + Gets a value indicating whether access to the object is synchronized (thread-safe). + This method always returns false. + + + Gets an object that can be used to synchronize access to the object. + An object that can be used to synchronize access to the object. + + + Gets a value indicating whether the has a fixed size. + true if the has a fixed size; otherwise, false. The default is false. + + + Returns an object that iterates through the collection. + An object for the collection. + + + Implements the interface and is called back by the deserialization event when deserialization is complete. + The source of the deserialization event. + + + Gets an object containing the values in the collection. + An object containing the values in the collection. + + + Represents a collection of strings. + + + Initializes a new instance of the class. + + + Adds a string to the end of the . + The zero-based index at which the new element is inserted. + The string to add to the end of the . The value can be null. + + + Copies the elements of a string array to the end of the . + An array of strings to add to the end of the . The array itself can not be null but it can contain elements that are null. + + is null. + + + Removes all the strings from the . + + + Determines whether the specified string is in the . + true if is found in the ; otherwise, false. + The string to locate in the . The value can be null. + + + Copies the entire values to a one-dimensional array of strings, starting at the specified index of the target array. + The one-dimensional array of strings that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in the source is greater than the available space from to the end of the destination . + The type of the source cannot be cast automatically to the type of the destination . + + + Gets the number of strings contained in the . + The number of strings contained in the . + + + Returns a that iterates through the . + A for the . + + + Searches for the specified string and returns the zero-based index of the first occurrence within the . + The zero-based index of the first occurrence of in the , if found; otherwise, -1. + The string to locate. The value can be null. + + + Inserts a string into the at the specified index. + The zero-based index at which is inserted. + The string to insert. The value can be null. + + is less than zero.-or- greater than . + + + Gets a value indicating whether the is read-only. + This property always returns false. + + + Gets a value indicating whether access to the is synchronized (thread safe). + This property always returns false. + + + Gets or sets the element at the specified index. + The element at the specified index. + The zero-based index of the entry to get or set. + + is less than zero.-or- is equal to or greater than . + + + Removes the first occurrence of a specific string from the . + The string to remove from the . The value can be null. + + + Removes the string at the specified index of the . + The zero-based index of the string to remove. + + is less than zero.-or- is equal to or greater than . + + + Gets an object that can be used to synchronize access to the . + An object that can be used to synchronize access to the . + + + Copies the entire to a compatible one-dimensional , starting at the specified index of the target array. + The one-dimensional that is the destination of the elements copied from . The must have zero-based indexing. + The zero-based index in at which copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in the source is greater than the available space from to the end of the destination . + The type of the source cannot be cast automatically to the type of the destination . + + + Returns a that iterates through the . + A for the . + + + Adds an object to the end of the . + The index at which the has been added. + The to be added to the end of the . The value can be null. + The is read-only.-or- The has a fixed size. + + + Determines whether an element is in the . + true if is found in the ; otherwise, false. + The to locate in the . The value can be null. + + + Searches for the specified and returns the zero-based index of the first occurrence within the entire . + The zero-based index of the first occurrence of within the entire , if found; otherwise, -1. + The to locate in the . The value can be null. + + + Inserts an element into the at the specified index. + The zero-based index at which should be inserted. + The to insert. The value can be null. + + is less than zero.-or- is greater than . + The is read-only.-or- The has a fixed size. + + + Gets a value indicating whether the object has a fixed size. + true if the object has a fixed size; otherwise, false. The default is false. + + + Gets a value indicating whether the object is read-only. + true if the object is read-only; otherwise, false. The default is false. + + + Gets or sets the element at the specified index. + The element at the specified index. + The zero-based index of the element to get or set. + + is less than zero.-or- is equal to or greater than . + + + Removes the first occurrence of a specific object from the . + The to remove from the . The value can be null. + The is read-only.-or- The has a fixed size. + + + Implements a hash table with the key and the value strongly typed to be strings rather than objects. + + + Initializes a new instance of the class. + + + Adds an entry with the specified key and value into the . + The key of the entry to add. + The value of the entry to add. The value can be null. + + is null. + An entry with the same key already exists in the . + The is read-only. + + + Removes all entries from the . + The is read-only. + + + Determines if the contains a specific key. + true if the contains an entry with the specified key; otherwise, false. + The key to locate in the . + The key is null. + + + Determines if the contains a specific value. + true if the contains an element with the specified value; otherwise, false. + The value to locate in the . The value can be null. + + + Copies the string dictionary values to a one-dimensional instance at the specified index. + The one-dimensional that is the destination of the values copied from the . + The index in the array where copying begins. + + is multidimensional.-or- The number of elements in the is greater than the available space from to the end of . + + is null. + + is less than the lower bound of . + + + Gets the number of key/value pairs in the . + The number of key/value pairs in the .Retrieving the value of this property is an O(1) operation. + + + Returns an enumerator that iterates through the string dictionary. + An that iterates through the string dictionary. + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. + + + Gets or sets the value associated with the specified key. + The value associated with the specified key. If the specified key is not found, Get returns null, and Set creates a new entry with the specified key. + The key whose value to get or set. + + is null. + + + Gets a collection of keys in the . + An that provides the keys in the . + + + Removes the entry with the specified key from the string dictionary. + The key of the entry to remove. + The key is null. + The is read-only. + + + Gets an object that can be used to synchronize access to the . + An that can be used to synchronize access to the . + + + Gets a collection of values in the . + An that provides the values in the . + + + Supports a simple iteration over a . + + + Gets the current element in the collection. + The current element in the collection. + The enumerator is positioned before the first element of the collection or after the last element. + + + Advances the enumerator to the next element of the collection. + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Sets the enumerator to its initial position, which is before the first element in the collection. + The collection was modified after the enumerator was created. + + + Provides data for the event. + + + Initializes a new instance of the class using no parameters. + + + Initializes a new instance of the class using the specified object as the new item. + An to use as the new item value. + + + Gets or sets the object to be added to the binding list. + The to be added as a new item to the associated collection. + + + Represents the method that will handle the event. + The source of the event, typically a data container or data-bound collection. + A that contains the event data. + + + Specifies the value to pass to a property to cause the property to get its value from another source. This is known as ambience. This class cannot be inherited. + + + Initializes a new instance of the class, given a Boolean value for its value. + The value of this attribute. + + + Initializes a new instance of the class, given an 8-bit unsigned integer for its value. + The value of this attribute. + + + Initializes a new instance of the class, given a Unicode character for its value. + The value of this attribute. + + + Initializes a new instance of the class, given a double-precision floating-point number for its value. + The value of this attribute. + + + Initializes a new instance of the class, given a 16-bit signed integer for its value. + The value of this attribute. + + + Initializes a new instance of the class, given a 32-bit signed integer for its value. + The value of this attribute. + + + Initializes a new instance of the class, given a 64-bit signed integer for its value. + The value of this attribute. + + + Initializes a new instance of the class, given an object for its value. + The value of this attribute. + + + Initializes a new instance of the class, given a single-precision floating point number for its value. + The value of this attribute. + + + Initializes a new instance of the class, given a string for its value. + The value of this attribute. + + + Initializes a new instance of the class, given the value and its type. + The of the parameter. + The value for this attribute. + + + Determines whether the specified is equal to the current . + true if the specified is equal to the current ; otherwise, false. + The to compare with the current . + + + Returns the hash code for this instance. + A hash code for the current . + + + Gets the object that is the value of this . + The object that is the value of this . + + + Provides a type converter to convert objects to and from various other representations. + + + Initializes a new instance of the class. + + + Converts the given value object to the specified destination type. + An that represents the converted value. + An that provides a format context. + The culture into which will be converted. + The to convert. + The to convert the value to. + + is null. + The conversion cannot be performed. + + + Gets a collection of properties for the type of array specified by the value parameter. + A with the properties that are exposed for an array, or null if there are no properties. + An that provides a format context. + An that specifies the type of array to get the properties for. + An array of type that will be used as a filter. + + + Gets a value indicating whether this object supports properties. + true because should be called to find the properties of this object. This method never returns false. + An that provides a format context. + + + Provides data for the MethodNameCompleted event. + + + Initializes a new instance of the class. + Any error that occurred during the asynchronous operation. + A value indicating whether the asynchronous operation was canceled. + The optional user-supplied state object passed to the method. + + + Gets a value indicating whether an asynchronous operation has been canceled. + true if the background operation has been canceled; otherwise false. The default is false. + + + Gets a value indicating which error occurred during an asynchronous operation. + An instance, if an error occurred during an asynchronous operation; otherwise null. + + + Raises a user-supplied exception if an asynchronous operation failed. + The property is true. + The property has been set by the asynchronous operation. The property holds a reference to . + + + Gets the unique identifier for the asynchronous task. + An object reference that uniquely identifies the asynchronous task; otherwise, null if no value has been set. + + + Represents the method that will handle the MethodNameCompleted event of an asynchronous operation. + The source of the event. + An that contains the event data. + + + Tracks the lifetime of an asynchronous operation. + + + Ends the lifetime of an asynchronous operation. + + has been called previously for this task. + + + + + + Invokes a delegate on the thread or context appropriate for the application model. + A object that wraps the delegate to be called when the operation ends. + An argument for the delegate contained in the parameter. + The method has been called previously for this task. + + is null. + + + Ends the lifetime of an asynchronous operation. + A object that wraps the delegate to be called when the operation ends. + An argument for the delegate contained in the parameter. + + has been called previously for this task. + + is null. + + + Gets the object that was passed to the constructor. + The object that was passed to the constructor. + + + Gets or sets an object used to uniquely identify an asynchronous operation. + The state object passed to the asynchronous method invocation. + + + Provides concurrency management for classes that support asynchronous method calls. This class cannot be inherited. + + + Returns an for tracking the duration of a particular asynchronous operation. + An that you can use to track the duration of an asynchronous method invocation. + An object used to associate a piece of client state, such as a task ID, with a particular asynchronous operation. + + + Gets or sets the synchronization context for the asynchronous operation. + The synchronization context for the asynchronous operation. + + + Represents a collection of attributes. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + An array of type that provides the attributes for this collection. + + is null. + + + Gets the attribute collection. + The attribute collection. + + + Determines whether this collection of attributes has the specified attribute. + true if the collection contains the attribute or is the default attribute for the type of attribute; otherwise, false. + An to find in the collection. + + + Determines whether this attribute collection contains all the specified attributes in the attribute array. + true if the collection contains all the attributes; otherwise, false. + An array of type to find in the collection. + + + Copies the collection to an array, starting at the specified index. + The to copy the collection to. + The index to start from. + + + Gets the number of attributes. + The number of attributes. + + + Specifies an empty collection that you can use, rather than creating a new one. This field is read-only. + + + Creates a new from an existing . + A new that is a copy of . + An from which to create the copy. + An array of type that provides the attributes for this collection. Can be null. + + is null. + + + Returns the default of a given . + An . + The of the attribute to retrieve. + + + Gets an enumerator for this collection. + An enumerator of type . + + + Gets the attribute with the specified index number. + The with the specified index number. + The zero-based index of . + + + Gets the attribute with the specified type. + The with the specified type or, if the attribute does not exist, the default value for the attribute type. + The of the to get from the collection. + + + Determines whether a specified attribute is the same as an attribute in the collection. + true if the attribute is contained within the collection and has the same value as the attribute in the collection; otherwise, false. + An instance of to compare with the attributes in this collection. + + + Determines whether the attributes in the specified array are the same as the attributes in the collection. + true if all the attributes in the array are contained in the collection and have the same values as the attributes in the collection; otherwise, false. + An array of to compare with the attributes in this collection. + + + Gets the number of elements contained in the collection. + The number of elements contained in the collection. + + + Gets a value indicating whether access to the collection is synchronized (thread-safe). + true if access to the collection is synchronized (thread-safe); otherwise, false. + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the collection. + + + Returns an for the . + An for the . + + + Enables attribute redirection. This class cannot be inherited. + + + Initializes a new instance of the class with the given type name. + The name of the type to specify. + + is null. + + + Initializes a new instance of the class with the given type name and property name. + The name of the type to specify. + The name of the property for which attributes will be retrieved. + + is null. + + is null. + + + Initializes a new instance of the class with the given type. + The type to specify. + + is null. + + + Gets the name of the property for which attributes will be retrieved. + The name of the property for which attributes will be retrieved. + + + Gets the assembly qualified type name passed into the constructor. + The assembly qualified name of the type specified in the constructor. + + + Executes an operation on a separate thread. + + + Initializes a new instance of the class. + + + Requests cancellation of a pending background operation. + + is false. + + + + + + Gets a value indicating whether the application has requested cancellation of a background operation. + true if the application has requested cancellation of a background operation; otherwise, false. The default is false. + + + Occurs when is called. + + + Gets a value indicating whether the is running an asynchronous operation. + true, if the is running an asynchronous operation; otherwise, false. + + + Raises the event. + An that contains the event data. + + + Raises the event. + An that contains the event data. + + + Raises the event. + An that contains the event data. + + + Occurs when is called. + + + Raises the event. + The percentage, from 0 to 100, of the background operation that is complete. + The property is set to false. + + + Raises the event. + The percentage, from 0 to 100, of the background operation that is complete. + The state object passed to . + The property is set to false. + + + Starts execution of a background operation. + + is true. + + + + + + Starts execution of a background operation. + A parameter for use by the background operation to be executed in the event handler. + + is true. + + + Occurs when the background operation has completed, has been canceled, or has raised an exception. + + + Gets or sets a value indicating whether the can report progress updates. + true if the supports progress updates; otherwise false. The default is false. + + + Gets or sets a value indicating whether the supports asynchronous cancellation. + true if the supports cancellation; otherwise false. The default is false. + + + Provides a base type converter for nonfloating-point numerical types. + + + Initializes a new instance of the class. + + + Determines if this converter can convert an object in the given source type to the native type of the converter. + true if this converter can perform the operation; otherwise, false. + An that provides a format context. + A that represents the type from which you want to convert. + + + Returns a value indicating whether this converter can convert an object to the given destination type using the context. + true if this converter can perform the operation; otherwise, false. + An that provides a format context. + A that represents the type to which you want to convert. + + + Converts the given object to the converter's native type. + An that represents the converted value. + An that provides a format context. + A that specifies the culture to represent the number. + The object to convert. + + is not a valid value for the target type. + The conversion cannot be performed. + + + Converts the specified object to another type. + An that represents the converted value. + An that provides a format context. + A that specifies the culture to represent the number. + The object to convert. + The type to convert the object to. + + is null. + The conversion cannot be performed. + + + Specifies whether a member is typically used for binding. This class cannot be inherited. + + + Initializes a new instance of the class with a Boolean value. + true to use property for binding; otherwise, false. + + + Initializes a new instance of the class. + true to use property for binding; otherwise, false. + One of the values. + + + Initializes a new instance of the class with one of the values. + One of the values. + + + Initializes a new instance of the class. + One of the values. + One of the values. + + + Gets a value indicating that a property is typically used for binding. + true if the property is typically used for binding; otherwise, false. + + + Specifies the default value for the , which is . This field is read-only. + + + Gets a value indicating the direction or directions of this property's data binding. + A . + + + Determines whether two objects are equal. + true if the specified is equal to the current ; false if it is not equal. + The object to compare. + + + Serves as a hash function for the class. + A hash code for the current . + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + Specifies that a property is not typically used for binding. This field is read-only. + + + Specifies that a property is typically used for binding. This field is read-only. + + + Specifies values to indicate whether a property can be bound to a data element or another property. + + + The property is not bindable at design time. + + + The property is bindable at design time. + + + The property is set to the default. + + + Specifies whether the template can be bound one way or two ways. + + + The template can only accept property values. Used with a generic . + + + The template can accept and expose property values. Used with an . + + + Provides a generic collection that supports data binding. + The type of elements in the list. + + + Initializes a new instance of the class using default values. + + + Initializes a new instance of the class with the specified list. + An of items to be contained in the . + + + Occurs before an item is added to the list. + + + Adds a new item to the collection. + The item added to the list. + The property is set to false. -or-A public default constructor could not be found for the current item type. + + + Adds a new item to the end of the collection. + The item that was added to the collection. + The new item is not the same type as the objects contained in the . + + + Gets or sets a value indicating whether items in the list can be edited. + true if list items can be edited; otherwise, false. The default is true. + + + Gets or sets a value indicating whether you can add items to the list using the method. + true if you can add items to the list with the method; otherwise, false. The default depends on the underlying type contained in the list. + + + Gets or sets a value indicating whether you can remove items from the collection. + true if you can remove items from the list with the method otherwise, false. The default is true. + + + Sorts the items if overridden in a derived class; otherwise, throws a . + A that specifies the property to sort on. + One of the values. + Method is not overridden in a derived class. + + + Discards a pending new item. + The index of the of the new item to be added + + + Removes all elements from the collection. + + + Commits a pending new item to the collection. + The index of the new item to be added. + + + Searches for the index of the item that has the specified property descriptor with the specified value, if searching is implemented in a derived class; otherwise, a . + The zero-based index of the item that matches the property descriptor and contains the specified value. + The to search for. + The value of to match. + + is not overridden in a derived class. + + + Inserts the specified item in the list at the specified index. + The zero-based index where the item is to be inserted. + The item to insert in the list. + + + Gets a value indicating whether the list is sorted. + true if the list is sorted; otherwise, false. The default is false. + + + Occurs when the list or an item in the list changes. + + + Raises the event. + An that contains the event data. + + + Raises the event. + A that contains the event data. + + + Gets or sets a value indicating whether adding or removing items within the list raises events. + true if adding or removing items raises events; otherwise, false. The default is true. + + + Removes the item at the specified index. + The zero-based index of the item to remove. + You are removing a newly added item and is set to false. + + + Removes any sort applied with if sorting is implemented in a derived class; otherwise, raises . + Method is not overridden in a derived class. + + + Raises a event of type . + + + Raises a event of type for the item at the specified position. + A zero-based index of the item to be reset. + + + Replaces the item at the specified index with the specified item. + The zero-based index of the item to replace. + The new value for the item at the specified index. The value can be null for reference types. + + is less than zero.-or- is greater than . + + + Gets the direction the list is sorted. + One of the values. The default is . + + + Gets the property descriptor that is used for sorting the list if sorting is implemented in a derived class; otherwise, returns null. + The used for sorting the list. + + + Gets a value indicating whether events are enabled. + true if events are supported; otherwise, false. The default is true. + + + Gets a value indicating whether the list supports searching. + true if the list supports searching; otherwise, false. The default is false. + + + Gets a value indicating whether the list supports sorting. + true if the list supports sorting; otherwise, false. The default is false. + + + For a description of this member, see . + The to add as a search criteria. + + + Adds a new item to the list. For more information, see . + The item added to the list. + This method is not supported. + + + Gets a value indicating whether items in the list can be edited. + true if list items can be edited; otherwise, false. The default is true. + + + Gets a value indicating whether new items can be added to the list using the method. + true if you can add items to the list with the method; otherwise, false. The default depends on the underlying type contained in the list. + + + Gets a value indicating whether items can be removed from the list. + true if you can remove items from the list with the method; otherwise, false. The default is true. + + + Sorts the list based on a and a . For a complete description of this member, see . + The to sort by. + One of the values. + + + For a description of this member, see . + The index of the row that has the given . + The to search on. + The value of the parameter to search for. + + + For a description of this member, see . + true if has been called and has not been called; otherwise, false. + + + For a description of this member, see . + A to remove from the indexes used for searching. + + + For a description of this member, see + + + For a description of this member, see . + One of the values. + + + For a description of this member, see . + The that is being used for sorting. + + + For a description of this member, see . + true if a event is raised when the list changes or when an item changes; otherwise, false. + + + For a description of this member, see . + true if the list supports searching using the method; otherwise, false. + + + For a description of this member, see . + true if the list supports sorting; otherwise, false. + + + Gets a value indicating whether item property value changes raise events of type . This member cannot be overridden in a derived class. + true if the list type implements , otherwise, false. The default is false. + + + Provides a type converter to convert objects to and from various other representations. + + + Initializes a new instance of the class. + + + Gets a value indicating whether this converter can convert an object in the given source type to a Boolean object using the specified context. + true if this object can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert from. + + + Converts the given value object to a Boolean object. + An that represents the converted . + An that provides a format context. + A that specifies the culture to which to convert. + The to convert. + + is not a valid value for the target type. + The conversion cannot be performed. + + + Gets a collection of standard values for the Boolean data type. + A that holds a standard set of valid values. + An that provides a format context. + + + Gets a value indicating whether the list of standard values returned from the method is an exclusive list. + true because the returned from is an exhaustive list of possible values. This method never returns false. + An that provides a format context. + + + Gets a value indicating whether this object supports a standard set of values that can be picked from a list. + true because can be called to find a common set of values the object supports. This method never returns false. + An that provides a format context. + + + Specifies whether a property or event should be displayed in a Properties window. + + + Initializes a new instance of the class. + true if a property or event can be modified at design time; otherwise, false. The default is true. + + + Gets a value indicating whether an object is browsable. + true if the object is browsable; otherwise, false. + + + Specifies the default value for the , which is . This static field is read-only. + + + Indicates whether this instance and a specified object are equal. + true if is equal to this instance; otherwise, false. + Another object to compare to. + + + Returns the hash code for this instance. + A 32-bit signed integer hash code. + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + Specifies that a property or event cannot be modified at design time. This static field is read-only. + + + Specifies that a property or event can be modified at design time. This static field is read-only. + + + Provides a type converter to convert 8-bit unsigned integer objects to and from various other representations. + + + Initializes a new instance of the class. + + + Provides data for a cancelable event. + + + Initializes a new instance of the class with the property set to false. + + + Initializes a new instance of the class with the property set to the given value. + true to cancel the event; otherwise, false. + + + Gets or sets a value indicating whether the event should be canceled. + true if the event should be canceled; otherwise, false. + + + Represents the method that handles a cancelable event. + The source of the event. + A that contains the event data. + + + Specifies the name of the category in which to group the property or event when displayed in a control set to Categorized mode. + + + Initializes a new instance of the class using the category name Default. + + + Initializes a new instance of the class using the specified category name. + The name of the category. + + + Gets a representing the Action category. + A for the action category. + + + Gets a representing the Appearance category. + A for the appearance category. + + + Gets a representing the Asynchronous category. + A for the asynchronous category. + + + Gets a representing the Behavior category. + A for the behavior category. + + + Gets the name of the category for the property or event that this attribute is applied to. + The name of the category for the property or event that this attribute is applied to. + + + Gets a representing the Data category. + A for the data category. + + + Gets a representing the Default category. + A for the default category. + + + Gets a representing the Design category. + A for the design category. + + + Gets a representing the DragDrop category. + A for the drag-and-drop category. + + + Returns whether the value of the given object is equal to the current .. + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + Gets a representing the Focus category. + A for the focus category. + + + Gets a representing the Format category. + A for the format category. + + + Returns the hash code for this attribute. + A 32-bit signed integer hash code. + + + + + + Looks up the localized name of the specified category. + The localized name of the category, or null if a localized name does not exist. + The identifer for the category to look up. + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + + + + Gets a representing the Key category. + A for the key category. + + + Gets a representing the Layout category. + A for the layout category. + + + Gets a representing the Mouse category. + A for the mouse category. + + + Gets a representing the WindowStyle category. + A for the window style category. + + + Provides a type converter to convert Unicode character objects to and from various other representations. + + + Initializes a new instance of the class. + + + Gets a value indicating whether this converter can convert an object in the given source type to a Unicode character object using the specified context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you want to convert from. + + + Converts the given object to a Unicode character object. + An that represents the converted . + An that provides a format context. + The culture into which will be converted. + The to convert. + + is not a valid value for the target type. + The conversion cannot be performed. + + + Converts the given value object to a Unicode character object using the arguments. + An that represents the converted value. + An that provides a format context. + The culture into which will be converted. + The to convert. + The to convert the value to. + The conversion cannot be performed. + + + Specifies how the collection is changed. + + + Specifies that an element was added to the collection. + + + Specifies that an element was removed from the collection. + + + Specifies that the entire collection has changed. This is caused by using methods that manipulate the entire collection, such as . + + + Provides data for the event. + + + Initializes a new instance of the class. + One of the values that specifies how the collection changed. + An that specifies the instance of the collection where the change occurred. + + + Gets an action that specifies how the collection changed. + One of the values. + + + Gets the instance of the collection with the change. + An that represents the instance of the collection with the change, or null if you refresh the collection. + + + Represents the method that handles the event raised when adding elements to or removing elements from a collection. + The source of the event. + A that contains the event data. + + + Provides a type converter to convert collection objects to and from various other representations. + + + Initializes a new instance of the class. + + + Converts the given value object to the specified destination type. + An that represents the converted value. + An that provides a format context. + The culture to which will be converted. + The to convert. This parameter must inherit from . + The to convert the value to. + + is null. + The conversion cannot be performed. + + + Gets a collection of properties for the type of array specified by the value parameter using the specified context and attributes. + A with the properties that are exposed for this data type, or null if there are no properties. This method always returns null. + An that provides a format context. + An that specifies the type of array to get the properties for. + An array of type that will be used as a filter. + + + Gets a value indicating whether this object supports properties. + false because should not be called to find the properties of this object. This method never returns true. + An that provides a format context. + + + Specifies the data source and data member properties for a component that supports complex data binding. This class cannot be inherited. + + + Initializes a new instance of the class using no parameters. + + + Initializes a new instance of the class using the specified data source. + The name of the property to be used as the data source. + + + Initializes a new instance of the class using the specified data source and data member. + The name of the property to be used as the data source. + The name of the property to be used as the source for data. + + + Gets the name of the data member property for the component to which the is bound. + The name of the data member property for the component to which is bound + + + Gets the name of the data source property for the component to which the is bound. + The name of the data source property for the component to which is bound. + + + Represents the default value for the class. + + + Determines whether the specified is equal to the current instance. + true if the object is equal to the current instance; otherwise, false, indicating they are not equal. + The to compare with the current instance + + + A 32-bit signed integer hash code. + + + Provides the base implementation for the interface and enables object sharing between applications. + + + Initializes a new instance of the class. + + + Gets a value indicating whether the component can raise an event. + true if the component can raise events; otherwise, false. The default is true. + + + Gets the that contains the . + The that contains the , if any, or null if the is not encapsulated in an . + + + Gets a value that indicates whether the is currently in design mode. + true if the is in design mode; otherwise, false. + + + Releases all resources used by the . + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Occurs when the component is disposed by a call to the method. + + + Gets the list of event handlers that are attached to this . + An that provides the delegates for this component. + + + Releases unmanaged resources and performs other cleanup operations before the is reclaimed by garbage collection. + + + Returns an object that represents a service provided by the or by its . + An that represents a service provided by the , or null if the does not provide the specified service. + A service provided by the . + + + Gets or sets the of the . + The associated with the , or null if the is not encapsulated in an , the does not have an associated with it, or the is removed from its . + + + Returns a containing the name of the , if any. This method should not be overridden. + A containing the name of the , if any, or null if the is unnamed. + + + Provides a read-only container for a collection of objects. + + + Initializes a new instance of the class using the specified array of components. + An array of objects to initialize the collection with. + + + Copies the entire collection to an array, starting writing at the specified array index. + An array to copy the objects in the collection to. + The index of the at which copying to should begin. + + + Gets the in the collection at the specified collection index. + The at the specified index. + The collection index of the to get. + If the specified index is not within the index range of the collection. + + + Gets any component in the collection matching the specified name. + A component with a name matching the name specified by the parameter, or null if the named component cannot be found in the collection. + The name of the to get. + + + Provides a type converter to convert components to and from various other representations. + + + Initializes a new instance of the class. + A that represents the type to associate with this component converter. + + + Gets a collection of properties for the type of component specified by the value parameter. + A with the properties that are exposed for the component, or null if there are no properties. + An that provides a format context. + An that specifies the type of component to get the properties for. + An array of type that will be used as a filter. + + + Gets a value indicating whether this object supports properties using the specified context. + true because should be called to find the properties of this object. This method never returns false. + An that provides a format context. + + + Provides the base class for a custom component editor. + + + Initializes a new instance of the class. + + + Edits the component and returns a value indicating whether the component was modified based upon a given context. + true if the component was modified; otherwise, false. + An optional context object that can be used to obtain further information about the edit. + The component to be edited. + + + Edits the component and returns a value indicating whether the component was modified. + true if the component was modified; otherwise, false. + The component to be edited. + + + Provides simple functionality for enumerating resources for a component or object. The class is a . + + + Initializes a new instance of the class with default values. + + + Creates a that looks up resources in satellite assemblies based on information from the specified . + A from which the derives all information for finding resource files. + + + Applies a resource's value to the corresponding property of the object. + An that contains the property value to be applied. + A that contains the name of the object to look up in the resources. + + or is null. + + + Applies a resource's value to the corresponding property of the object. + An that contains the property value to be applied. + A that contains the name of the object to look up in the resources. + The culture for which to apply resources. + + or is null. + + + Encapsulates zero or more components. + + + Initializes a new instance of the class. + + + Adds the specified to the . The component is unnamed. + The component to add. + + is null. + + + + + + Adds the specified to the and assigns it a name. + The component to add. + The unique, case-insensitive name to assign to the component.-or- null, which leaves the component unnamed. + + is null. + + is not unique. + + + Gets all the components in the . + A collection that contains the components in the . + + + Creates a site for the given and assigns the given name to the site. + The newly created site. + The to create a site for. + The name to assign to , or null to skip the name assignment. + + + Releases all resources used by the . + + + Releases the unmanaged resources used by the , and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Releases unmanaged resources and performs other cleanup operations before the is reclaimed by garbage collection. + + + Gets the service object of the specified type, if it is available. + An implementing the requested service, or null if the service cannot be resolved. + The of the service to retrieve. + + + Removes a component from the . + The component to remove. + + + Removes a component from the without setting to null. + The component to remove. + + + Determines whether the component name is unique for this container. + The named component. + The component name to validate. + + is null. + + is not unique. + + + Provides a base class for the container filter service. + + + Initializes a new instance of the class. + + + Filters the component collection. + A that represents a modified collection. + The component collection to filter. + + + Provides a type converter to convert objects to and from various other representations. + + + Initializes a new instance of the class. + + + Gets a value indicating whether this converter can convert an object in the given source type to a using the specified context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert from. + + + Gets a value indicating whether this converter can convert an object to the given destination type using the context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert to. + + + Converts the specified value object to a . + An that represents the converted value. + An that provides a format context. + A that specifies the culture to which to convert. + The to convert. + + specifies a culture that is not valid. + The conversion cannot be performed. + + + Converts the given value object to the specified destination type. + An that represents the converted . + An that provides a format context. + A that specifies the culture to which to convert. + The to convert. + The to convert the value to. + + is null. + The conversion cannot be performed. + + + Retrieves the name of the specified culture. + The name of the specified culture. + A that specifies the culture to get the name for. + + + Gets a collection of standard values for a object using the specified context. + A containing a standard set of valid values, or null if the data type does not support a standard set of values. + An that provides a format context. + + + Gets a value indicating whether the list of standard values returned from is an exhaustive list. + false because the returned from is not an exhaustive list of possible values (that is, other values are possible). This method never returns true. + An that provides a format context. + + + Gets a value indicating whether this object supports a standard set of values that can be picked from a list using the specified context. + true because should be called to find a common set of values the object supports. This method never returns false. + An that provides a format context. + + + Provides a simple default implementation of the interface. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using a parent custom type descriptor. + The parent custom type descriptor. + + + Returns a collection of custom attributes for the type represented by this type descriptor. + An containing the attributes for the type. The default is . + + + Returns the fully qualified name of the class represented by this type descriptor. + A containing the fully qualified class name of the type this type descriptor is describing. The default is null. + + + Returns the name of the class represented by this type descriptor. + A containing the name of the component instance this type descriptor is describing. The default is null. + + + Returns a type converter for the type represented by this type descriptor. + A for the type represented by this type descriptor. The default is a newly created . + + + Returns the event descriptor for the default event of the object represented by this type descriptor. + The for the default event on the object represented by this type descriptor. The default is null. + + + Returns the property descriptor for the default property of the object represented by this type descriptor. + A for the default property on the object represented by this type descriptor. The default is null. + + + Returns an editor of the specified type that is to be associated with the class represented by this type descriptor. + An editor of the given type that is to be associated with the class represented by this type descriptor. The default is null. + The base type of the editor to retrieve. + + + Returns a collection of event descriptors for the object represented by this type descriptor. + An containing the event descriptors for the object represented by this type descriptor. The default is . + + + Returns a filtered collection of event descriptors for the object represented by this type descriptor. + An containing the event descriptions for the object represented by this type descriptor. The default is . + An array of attributes to use as a filter. This can be null. + + + Returns a collection of property descriptors for the object represented by this type descriptor. + A containing the property descriptions for the object represented by this type descriptor. The default is . + + + Returns a filtered collection of property descriptors for the object represented by this type descriptor. + A containing the property descriptions for the object represented by this type descriptor. The default is . + An array of attributes to use as a filter. This can be null. + + + Returns an object that contains the property described by the specified property descriptor. + An that owns the given property specified by the type descriptor. The default is null. + The property descriptor for which to retrieve the owning object. + + + Identifies a type as an object suitable for binding to an object. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class and indicates whether an object is suitable for binding to an object. + true if the object is suitable for binding to an object; otherwise, false. + + + Indicates that the class is suitable for binding to an object at design time. This field is read-only. + + + Represents the default value of the class, which indicates that the class is suitable for binding to an object at design time. This field is read-only. + + + Determines whether this instance of fits the pattern of another object. + true if this instance is the same as the instance specified by the parameter; otherwise, false. + An object to compare with this instance of . + + + Returns the hash code for this instance. + A 32-bit signed integer hash code. + + + Gets a value indicating whether an object should be considered suitable for binding to an object at design time. + true if the object should be considered suitable for binding to an object; otherwise, false. + + + Gets a value indicating whether the current value of the attribute is the default value for the attribute. + true if the current value of the attribute is the default; otherwise, false. + + + Indicates that the class is not suitable for binding to an object at design time. This field is read-only. + + + Provides metadata for a property representing a data field. This class cannot be inherited. + + + Initializes a new instance of the class and indicates whether the field is the primary key for the data row. + true to indicate that the field is in the primary key of the data row; otherwise, false. + + + Initializes a new instance of the class and indicates whether the field is the primary key for the data row, and whether the field is a database identity field. + true to indicate that the field is in the primary key of the data row; otherwise, false. + true to indicate that the field is an identity field that uniquely identifies the data row; otherwise, false. + + + Initializes a new instance of the class and indicates whether the field is the primary key for the data row, whether the field is a database identity field, and whether the field can be null. + true to indicate that the field is in the primary key of the data row; otherwise, false. + true to indicate that the field is an identity field that uniquely identifies the data row; otherwise, false. + true to indicate that the field can be null in the data store; otherwise, false. + + + Initializes a new instance of the class and indicates whether the field is the primary key for the data row, whether it is a database identity field, and whether it can be null and sets the length of the field. + true to indicate that the field is in the primary key of the data row; otherwise, false. + true to indicate that the field is an identity field that uniquely identifies the data row; otherwise, false. + true to indicate that the field can be null in the data store; otherwise, false. + The length of the field in bytes. + + + Returns a value indicating whether this instance is equal to a specified object. + true if this instance is the same as the instance specified by the parameter; otherwise, false. + An object to compare with this instance of . + + + Returns the hash code for this instance. + A 32-bit signed integer hash code. + + + Gets a value indicating whether a property represents an identity field in the underlying data. + true if the property represents an identity field in the underlying data; otherwise, false. The default value is false. + + + Gets a value indicating whether a property represents a field that can be null in the underlying data store. + true if the property represents a field that can be null in the underlying data store; otherwise, false. + + + Gets the length of the property in bytes. + The length of the property in bytes, or -1 if not set. + + + Gets a value indicating whether a property is in the primary key in the underlying data. + true if the property is in the primary key of the data store; otherwise, false. + + + Identifies a data operation method exposed by a type, what type of operation the method performs, and whether the method is the default data method. This class cannot be inherited. + + + Initializes a new instance of the class and identifies the type of data operation the method performs. + One of the values that describes the data operation the method performs. + + + Initializes a new instance of the class, identifies the type of data operation the method performs, and identifies whether the method is the default data method that the data object exposes. + One of the values that describes the data operation the method performs. + true to indicate the method that the attribute is applied to is the default method of the data object for the specified ; otherwise, false. + + + Returns a value indicating whether this instance is equal to a specified object. + true if this instance is the same as the instance specified by the parameter; otherwise, false. + An object to compare with this instance of . + + + Returns the hash code for this instance. + A 32-bit signed integer hash code. + + + Gets a value indicating whether the method that the is applied to is the default data method exposed by the data object for a specific method type. + true if the method is the default method exposed by the object for a method type; otherwise, false. + + + Gets a value indicating whether this instance shares a common pattern with a specified attribute. + true if this instance is the same as the instance specified by the parameter; otherwise, false. + An object to compare with this instance of . + + + Gets a value indicating the type of data operation the method performs. + One of the values that identifies the type of data operation performed by the method to which the is applied. + + + Identifies the type of data operation performed by a method, as specified by the applied to the method. + + + Indicates that a method is used for a data operation that fills a object. + + + Indicates that a method is used for a data operation that retrieves data. + + + Indicates that a method is used for a data operation that updates data. + + + Indicates that a method is used for a data operation that inserts data. + + + Indicates that a method is used for a data operation that deletes data. + + + Provides a type converter to convert objects to and from various other representations. + + + Initializes a new instance of the class. + + + Gets a value indicating whether this converter can convert an object in the given source type to a using the specified context. + true if this object can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert from. + + + Gets a value indicating whether this converter can convert an object to the given destination type using the context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert to. + + + Converts the given value object to a . + An that represents the converted . + An that provides a format context. + An optional . If not supplied, the current culture is assumed. + The to convert. + + is not a valid value for the target type. + The conversion cannot be performed. + + + Converts the given value object to a using the arguments. + An that represents the converted . + An that provides a format context. + An optional . If not supplied, the current culture is assumed. + The to convert. + The to convert the value to. + The conversion cannot be performed. + + + Provides a type converter to convert structures to and from various other representations. + + + Initializes a new instance of the class. + + + Returns a value that indicates whether an object of the specified source type can be converted to a . + true if the specified type can be converted to a ; otherwise, false. + The date format context. + The source type to check. + + + Returns a value that indicates whether a can be converted to an object of the specified type. + true if a can be converted to the specified type; otherwise, false. + The date format context. + The destination type to check. + + + Converts the specified object to a . + A that represents the specified object. + The date format context. + The date culture. + The object to be converted. + The conversion cannot be performed. + + + Converts a to an object of the specified type. + An object of the specified type that represents the . + The date format context. + The date culture. + The to be converted. + The type to convert to. + The conversion cannot be performed. + + + Provides a type converter to convert objects to and from various other representations. + + + Initializes a new instance of the class. + + + Gets a value indicating whether this converter can convert an object to the given destination type using the context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert to. + + + Converts the given value object to a using the arguments. + An that represents the converted value. + An that provides a format context. + An optional . If not supplied, the current culture is assumed. + The to convert. + The to convert the value to. + The is null. + The conversion cannot be performed. + + + Specifies the default binding property for a component. This class cannot be inherited. + + + Initializes a new instance of the class using no parameters. + + + Initializes a new instance of the class using the specified property name. + The name of the default binding property. + + + Represents the default value for the class. + + + Determines whether the specified is equal to the current instance. + true if the object is equal to the current instance; otherwise, false, indicating they are not equal. + The to compare with the current instance + + + A 32-bit signed integer hash code. + + + Gets the name of the default binding property for the component to which the is bound. + The name of the default binding property for the component to which the is bound. + + + Specifies the default event for a component. + + + Initializes a new instance of the class. + The name of the default event for the component this attribute is bound to. + + + Specifies the default value for the , which is null. This static field is read-only. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + Returns the hash code for this instance. + A 32-bit signed integer hash code. + + + Gets the name of the default event for the component this attribute is bound to. + The name of the default event for the component this attribute is bound to. The default value is null. + + + Specifies the default property for a component. + + + Initializes a new instance of the class. + The name of the default property for the component this attribute is bound to. + + + Specifies the default value for the , which is null. This static field is read-only. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + Returns the hash code for this instance. + A 32-bit signed integer hash code. + + + Gets the name of the default property for the component this attribute is bound to. + The name of the default property for the component this attribute is bound to. The default value is null. + + + Specifies the default value for a property. + + + Initializes a new instance of the class using a value. + A that is the default value. + + + Initializes a new instance of the class using an 8-bit unsigned integer. + An 8-bit unsigned integer that is the default value. + + + Initializes a new instance of the class using a Unicode character. + A Unicode character that is the default value. + + + Initializes a new instance of the class using a double-precision floating point number. + A double-precision floating point number that is the default value. + + + Initializes a new instance of the class using a 16-bit signed integer. + A 16-bit signed integer that is the default value. + + + Initializes a new instance of the class using a 32-bit signed integer. + A 32-bit signed integer that is the default value. + + + Initializes a new instance of the class using a 64-bit signed integer. + A 64-bit signed integer that is the default value. + + + Initializes a new instance of the class. + An that represents the default value. + + + Initializes a new instance of the class using a single-precision floating point number. + A single-precision floating point number that is the default value. + + + Initializes a new instance of the class using a . + A that is the default value. + + + Initializes a new instance of the class, converting the specified value to the specified type, and using an invariant culture as the translation context. + A that represents the type to convert the value to. + A that can be converted to the type using the for the type and the U.S. English culture. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + + Sets the default value for the property to which this attribute is bound. + The default value. + + + Gets the default value of the property this attribute is bound to. + An that represents the default value of the property this attribute is bound to. + + + Specifies a description for a property or event. + + + Initializes a new instance of the class with no parameters. + + + Initializes a new instance of the class with a description. + The description text. + + + Specifies the default value for the , which is an empty string (""). This static field is read-only. + + + Gets the description stored in this attribute. + The description stored in this attribute. + + + Gets or sets the string stored as the description. + The string stored as the description. The default value is an empty string (""). + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + + Returns a value indicating whether this is the default instance. + true, if this is the default instance; otherwise, false. + + + Specifies the class used to implement design-time services for a component. + + + Initializes a new instance of the class using the name of the type that provides design-time services. + The concatenation of the fully qualified name of the type that provides design-time services for the component this attribute is bound to, and the name of the assembly this type resides in. + + + Initializes a new instance of the class using the designer type and the base class for the designer. + The concatenation of the fully qualified name of the type that provides design-time services for the component this attribute is bound to, and the name of the assembly this type resides in. + The fully qualified name of the base class to associate with the designer class. + + + Initializes a new instance of the class, using the name of the designer class and the base class for the designer. + The concatenation of the fully qualified name of the type that provides design-time services for the component this attribute is bound to, and the name of the assembly this type resides in. + A that represents the base class to associate with the . + + + Initializes a new instance of the class using the type that provides design-time services. + A that represents the class that provides design-time services for the component this attribute is bound to. + + + Initializes a new instance of the class using the types of the designer and designer base class. + A that represents the class that provides design-time services for the component this attribute is bound to. + A that represents the base class to associate with the . + + + Gets the name of the base type of this designer. + The name of the base type of this designer. + + + Gets the name of the designer type associated with this designer attribute. + The name of the designer type associated with this designer attribute. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + + Gets a unique ID for this attribute type. + A unique ID for this attribute type. + + + Specifies that the designer for a class belongs to a certain category. + + + Initializes a new instance of the class with an empty string (""). + + + Initializes a new instance of the class with the given category name. + The name of the category. + + + Gets the name of the category. + The name of the category. + + + Specifies that a component marked with this category use a component designer. This field is read-only. + + + Specifies that a component marked with this category cannot use a visual designer. This static field is read-only. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + Specifies that a component marked with this category use a form designer. This static field is read-only. + + + Specifies that a component marked with this category use a generic designer. This static field is read-only. + + + Returns the hash code for this instance. + A 32-bit signed integer hash code. + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + Gets a unique identifier for this attribute. + An that is a unique identifier for the attribute. + + + Specifies the visibility a property has to the design-time serializer. + + + The code generator does not produce code for the object. + + + The code generator produces code for the object. + + + The code generator produces code for the contents of the object, rather than for the object itself. + + + Specifies the type of persistence to use when serializing a property on a component at design time. + + + Initializes a new instance of the class using the specified value. + One of the values. + + + Specifies that a serializer should serialize the contents of the property, rather than the property itself. This field is read-only. + + + Specifies the default value, which is , that is, a visual designer uses default rules to generate the value of a property. This static field is read-only. + + + Indicates whether this instance and a specified object are equal. + true if is equal to this instance; otherwise, false. + Another object to compare to. + + + Returns the hash code for this object. + A 32-bit signed integer hash code. + + + Specifies that a serializer should not serialize the value of the property. This static field is read-only. + + + Gets a value indicating whether the current value of the attribute is the default value for the attribute. + true if the attribute is set to the default value; otherwise, false. + + + Gets a value indicating the basic serialization mode a serializer should use when determining whether and how to persist the value of a property. + One of the values. The default is . + + + Specifies that a serializer should be allowed to serialize the value of the property. This static field is read-only. + + + Specifies whether a property can only be set at design time. + + + Initializes a new instance of the class. + true if a property can be set only at design time; false if the property can be set at design time and at run time. + + + Specifies the default value for the , which is . This static field is read-only. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + Gets a value indicating whether a property can be set only at design time. + true if a property can be set only at design time; otherwise, false. + + + Specifies that a property can be set at design time or at run time. This static field is read-only. + + + Specifies that a property can be set only at design time. This static field is read-only. + + + + marks a component's visibility. If is present, a visual designer can show this component on a designer. + + + Creates a new set to the default value of false. + + + Creates a new with the property set to the given value in . + The value that the property will be set against. + + + The default visibility which is Yes. + + + The object to compare. + + + + Gets a value indicating if this instance is equal to the value. + true, if this instance is equal to the value; otherwise, false. + + + Marks a component as not visible in a visual designer. + + + Gets or sets whether the component should be shown at design time. + true if this component should be shown at design time, or false if it shouldn't. + + + Marks a component as visible in a visual designer. + + + Specifies the display name for a property, event, or public void method which takes no arguments. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the display name. + The display name. + + + Specifies the default value for the . This field is read-only. + + + Gets the display name for a property, event, or public void method that takes no arguments stored in this attribute. + The display name. + + + Gets or sets the display name. + The display name. + + + Determines whether two instances are equal. + true if the value of the given object is equal to that of the current object; otherwise, false. + The to test the value equality of. + + + Returns the hash code for this instance. + A hash code for the current . + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + Provides a type converter to convert double-precision, floating point number objects to and from various other representations. + + + Initializes a new instance of the class. + + + Provides data for the event handler. + + + Initializes a new instance of the class. + Specifies an argument for an asynchronous operation. + + + Gets a value that represents the argument of an asynchronous operation. + An representing the argument of an asynchronous operation. + + + Gets or sets a value that represents the result of an asynchronous operation. + An representing the result of an asynchronous operation. + + + Represents the method that will handle the event. This class cannot be inherited. + The source of the event. + A that contains the event data. + + + Specifies the editor to use to change a property. This class cannot be inherited. + + + Initializes a new instance of the class with the default editor, which is no editor. + + + Initializes a new instance of the class with the type name and base type name of the editor. + The fully qualified type name of the editor. + The fully qualified type name of the base class or interface to use as a lookup key for the editor. This class must be or derive from . + + + Initializes a new instance of the class with the type name and the base type. + The fully qualified type name of the editor. + The of the base class or interface to use as a lookup key for the editor. This class must be or derive from . + + + Initializes a new instance of the class with the type and the base type. + A that represents the type of the editor. + The of the base class or interface to use as a lookup key for the editor. This class must be or derive from . + + + Gets the name of the base class or interface serving as a lookup key for this editor. + The name of the base class or interface serving as a lookup key for this editor. + + + Gets the name of the editor class in the format. + The name of the editor class in the format. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current object; otherwise, false. + The object to test the value equality of. + + + + Gets a unique ID for this attribute type. + A unique ID for this attribute type. + + + Specifies that a property or method is viewable in an editor. This class cannot be inherited. + + + Initializes a new instance of the class with set to the default state. + + + Initializes a new instance of the class with an . + The to set to. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + + Gets the browsable state of the property or method. + An that is the browsable state of the property or method. + + + Specifies the browsable state of a property or method from within an editor. + + + The property or method is always browsable from within an editor. + + + The property or method is never browsable from within an editor. + + + The property or method is a feature that only advanced users should see. An editor can either show or hide such properties. + + + Provides a type converter to convert objects to and from various other representations. + + + Initializes a new instance of the class for the given type. + A that represents the type of enumeration to associate with this enumeration converter. + + + Gets a value indicating whether this converter can convert an object in the given source type to an enumeration object using the specified context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert from. + + + Gets a value indicating whether this converter can convert an object to the given destination type using the context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert to. + + + Gets an that can be used to sort the values of the enumeration. + An for sorting the enumeration values. + + + Converts the specified value object to an enumeration object. + An that represents the converted . + An that provides a format context. + An optional . If not supplied, the current culture is assumed. + The to convert. + + is not a valid value for the target type. + The conversion cannot be performed. + + + Converts the given value object to the specified destination type. + An that represents the converted . + An that provides a format context. + An optional . If not supplied, the current culture is assumed. + The to convert. + The to convert the value to. + + is null. + + is not a valid value for the enumeration. + The conversion cannot be performed. + + + Specifies the type of the enumerator this converter is associated with. + The type of the enumerator this converter is associated with. + + + Gets a collection of standard values for the data type this validator is designed for. + A that holds a standard set of valid values, or null if the data type does not support a standard set of values. + An that provides a format context. + + + Gets a value indicating whether the list of standard values returned from is an exclusive list using the specified context. + true if the returned from is an exhaustive list of possible values; false if other values are possible. + An that provides a format context. + + + Gets a value indicating whether this object supports a standard set of values that can be picked from a list using the specified context. + true because should be called to find a common set of values the object supports. This method never returns false. + An that provides a format context. + + + Gets a value indicating whether the given object value is valid for this type. + true if the specified value is valid for this object; otherwise, false. + An that provides a format context. + The to test. + + + Gets or sets a that specifies the possible values for the enumeration. + A that specifies the possible values for the enumeration. + + + Provides information about an event. + + + Initializes a new instance of the class with the name and attributes in the specified . + A that contains the name of the event and its attributes. + + + Initializes a new instance of the class with the name in the specified and the attributes in both the and the array. + A that has the name of the member and its attributes. + An array with the attributes you want to add to this event description. + + + Initializes a new instance of the class with the specified name and attribute array. + The name of the event. + An array of type that contains the event attributes. + + + When overridden in a derived class, binds the event to the component. + A component that provides events to the delegate. + A delegate that represents the method that handles the event. + + + When overridden in a derived class, gets the type of component this event is bound to. + A that represents the type of component the event is bound to. + + + When overridden in a derived class, gets the type of delegate for the event. + A that represents the type of delegate for the event. + + + When overridden in a derived class, gets a value indicating whether the event delegate is a multicast delegate. + true if the event delegate is multicast; otherwise, false. + + + When overridden in a derived class, unbinds the delegate from the component so that the delegate will no longer receive events from the component. + The component that the delegate is bound to. + The delegate to unbind from the component. + + + Represents a collection of objects. + + + Initializes a new instance of the class with the given array of objects. + An array of type that provides the events for this collection. + + + Initializes a new instance of the class with the given array of objects. The collection is optionally read-only. + An array of type that provides the events for this collection. + true to specify a read-only collection; otherwise, false. + + + Adds an to the end of the collection. + The position of the within the collection. + An to add to the collection. + The collection is read-only. + + + Removes all objects from the collection. + The collection is read-only. + + + Returns whether the collection contains the given . + true if the collection contains the parameter given; otherwise, false. + The to find within the collection. + + + Gets the number of event descriptors in the collection. + The number of event descriptors in the collection. + + + Specifies an empty collection to use, rather than creating a new one with no items. This static field is read-only. + + + Gets the description of the event with the specified name in the collection. + The with the specified name, or null if the event does not exist. + The name of the event to get from the collection. + true if you want to ignore the case of the event; otherwise, false. + + + Gets an enumerator for this . + An enumerator that implements . + + + Returns the index of the given . + The index of the given within the collection. + The to find within the collection. + + + Inserts an to the collection at a specified index. + The index within the collection in which to insert the parameter. + An to insert into the collection. + The collection is read-only. + + + Sorts the members of this , using the specified . + A comparer to use to sort the objects in this collection. + + + Sorts the members of this . The specified order is applied first, followed by the default sort for this collection, which is usually alphabetical. + An array of strings describing the order in which to sort the objects in this collection. + + + Gets or sets the event with the specified index number. + The with the specified index number. + The zero-based index number of the to get or set. + + is not a valid index for . + + + Gets or sets the event with the specified name. + The with the specified name, or null if the event does not exist. + The name of the to get or set. + + + Removes the specified from the collection. + The to remove from the collection. + The collection is read-only. + + + Removes the at the specified index from the collection. + The index of the to remove. + The collection is read-only. + + + Sorts the members of this , using the default sort for this collection, which is usually alphabetical. + The new . + + + Sorts the members of this , using the specified . + The new . + An to use to sort the objects in this collection. + + + Sorts the members of this , given a specified sort order. + The new . + An array of strings describing the order in which to sort the objects in the collection. + + + Sorts the members of this , given a specified sort order and an . + The new . + An array of strings describing the order in which to sort the objects in the collection. + An to use to sort the objects in this collection. + + + Copies the elements of the collection to an , starting at a particular index. + The one-dimensional that is the destination of the elements copied from collection. The must have zero-based indexing. + The zero-based index in at which copying begins. + + + Gets the number of elements contained in the collection. + The number of elements contained in the collection. + + + Gets a value indicating whether access to the collection is synchronized. + true if access to the collection is synchronized; otherwise, false. + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the collection. + + + Returns an enumerator that iterates through a collection. + An that can be used to iterate through the collection. + + + Adds an item to the collection. + The position into which the new element was inserted. + The to add to the collection. + The collection is read-only. + + + Removes all the items from the collection. + The collection is read-only. + + + Determines whether the collection contains a specific value. + true if the is found in the collection; otherwise, false. + The to locate in the collection. + + + Determines the index of a specific item in the collection. + The index of if found in the list; otherwise, -1. + The to locate in the collection. + + + Inserts an item to the collection at the specified index. + The zero-based index at which should be inserted. + The to insert into the collection. + The collection is read-only. + + + Gets a value indicating whether the collection has a fixed size. + true if the collection has a fixed size; otherwise, false. + + + Gets a value indicating whether the collection is read-only. + true if the collection is read-only; otherwise, false. + + + Gets or sets the element at the specified index. + The element at the specified index. + The zero-based index of the element to get or set. + The collection is read-only. + + is less than 0. -or- is equal to or greater than . + + + Removes the first occurrence of a specific object from the collection. + The to remove from the collection. + The collection is read-only. + + + Removes the item at the specified index. + The zero-based index of the item to remove. + The collection is read-only. + + + Provides a simple list of delegates. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Adds a delegate to the list. + The object that owns the event. + The delegate to add to the list. + + + Adds a list of delegates to the current list. + The list to add. + + + Disposes the delegate list. + + + Gets or sets the delegate for the specified object. + The delegate for the specified key, or null if a delegate does not exist. + An object to find in the list. + + + Removes a delegate from the list. + The object that owns the event. + The delegate to remove from the list. + + + Provides a type converter to convert expandable objects to and from various other representations. + + + Initializes a new instance of the class. + + + Gets a collection of properties for the type of object specified by the value parameter. + A with the properties that are exposed for the component, or null if there are no properties. + An that provides a format context. + An that specifies the type of object to get the properties for. + An array of type that will be used as a filter. + + + Gets a value indicating whether this object supports properties using the specified context. + true because should be called to find the properties of this object. This method never returns false. + An that provides a format context. + + + Specifies a property that is offered by an extender provider. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Determines whether the specified is equal to the current . + true if the specified is equal to the current ; otherwise, false. + An to compare with this instance or null. + + + Gets the property that is being provided. + A encapsulating the property that is being provided. + + + Returns the hash code for this instance. + A 32-bit signed integer hash code. + + + Provides an indication whether the value of this instance is the default value for the derived class. + true if this instance is the default attribute for the class; otherwise, false. + + + Gets the extender provider that is providing the property. + The that is providing the property. + + + Gets the type of object that can receive the property. + A describing the type of object that can receive the property. + + + Provides a type converter to convert objects to and from various other representations. + + + Initializes a new instance of the class. + + + Gets a value indicating whether this converter can convert an object in the given source type to a GUID object using the context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert from. + + + Gets a value indicating whether this converter can convert an object to the given destination type using the context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert to. + + + Converts the given object to a GUID object. + An that represents the converted . + An that provides a format context. + An optional . If not supplied, the current culture is assumed. + The to convert. + The conversion cannot be performed. + + + Converts the given object to another type. + The converted object. + A formatter context. + The culture into which will be converted. + The object to convert. + The type to convert the object to. + + is null. + The conversion cannot be performed. + + + Provides data for events that can be handled completely in an event handler. + + + Initializes a new instance of the class with a default property value of false. + + + Initializes a new instance of the class with the specified default value for the property. + The default value for the property. + + + Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing. + true if the event has been completely handled; otherwise, false. + + + Represents a method that can handle events which may or may not require further processing after the event handler has returned. + The source of the event. + A that contains the event data. + + + Provides the features required to support both complex and simple scenarios when binding to a data source. + + + Adds the to the indexes used for searching. + The to add to the indexes used for searching. + + + Adds a new item to the list. + The item added to the list. + + is false. + + + Gets whether you can update items in the list. + true if you can update the items in the list; otherwise, false. + + + Gets whether you can add items to the list using . + true if you can add items to the list using ; otherwise, false. + + + Gets whether you can remove items from the list, using or . + true if you can remove items from the list; otherwise, false. + + + Sorts the list based on a and a . + The to sort by. + One of the values. + + is false. + + + Returns the index of the row that has the given . + The index of the row that has the given . + The to search on. + The value of the parameter to search for. + + is false. + + + Gets whether the items in the list are sorted. + true if has been called and has not been called; otherwise, false. + + is false. + + + Occurs when the list changes or an item in the list changes. + + + Removes the from the indexes used for searching. + The to remove from the indexes used for searching. + + + Removes any sort applied using . + + is false. + + + Gets the direction of the sort. + One of the values. + + is false. + + + Gets the that is being used for sorting. + The that is being used for sorting. + + is false. + + + Gets whether a event is raised when the list changes or an item in the list changes. + true if a event is raised when the list changes or when an item changes; otherwise, false. + + + Gets whether the list supports searching using the method. + true if the list supports searching using the method; otherwise, false. + + + Gets whether the list supports sorting. + true if the list supports sorting; otherwise, false. + + + Extends the interface by providing advanced sorting and filtering capabilities. + + + Sorts the data source based on the given . + The containing the sorts to apply to the data source. + + + Gets or sets the filter to be used to exclude items from the collection of items returned by the data source + The string used to filter items out in the item collection returned by the data source. + + + Removes the current filter applied to the data source. + + + Gets the collection of sort descriptions currently applied to the data source. + The currently applied to the data source. + + + Gets a value indicating whether the data source supports advanced sorting. + true if the data source supports advanced sorting; otherwise, false. + + + Gets a value indicating whether the data source supports filtering. + true if the data source supports filtering; otherwise, false. + + + Adds transactional capability when adding a new item to a collection. + + + Discards a pending new item from the collection. + The index of the item that was previously added to the collection. + + + Commits a pending new item to the collection. + The index of the item that was previously added to the collection. + + + Defines the mechanism for querying the object for changes and resetting of the changed status. + + + Resets the object’s state to unchanged by accepting the modifications. + + + Gets the object's changed status. + true if the object’s content has changed since the last call to ; otherwise, false. + + + Provides a top-level mapping layer between a COM object and a . + + + Gets the attributes for the specified component. + A collection of attributes for . + The component to get attributes for. + + + Gets the class name for the specified component. + The name of the class that corresponds with . + The component to get the class name for. + + + Gets the type converter for the specified component. + The for . + The component to get the for. + + + Gets the default event for the specified component. + An that represents 's default event. + The component to get the default event for. + + + Gets the default property for the specified component. + A that represents 's default property. + The component to get the default property for. + + + Gets the editor for the specified component. + The editor for . + The component to get the editor for. + The base type of the editor for . + + + Gets the events for the specified component. + A collection of event descriptors for . + The component to get events for. + + + Gets the events with the specified attributes for the specified component. + A collection of event descriptors for . + The component to get events for. + The attributes used to filter events. + + + Gets the name of the specified component. + The name of . + The component to get the name of. + + + Gets the properties with the specified attributes for the specified component. + A collection of property descriptors for . + The component to get events for. + The attributes used to filter properties. + + + Gets the value of the property that has the specified dispatch identifier. + The value of the property that has the specified dispatch identifier. + The object to which the property belongs. + The dispatch identifier. + A , passed by reference, that represents whether the property was retrieved. + + + Gets the value of the property that has the specified name. + The value of the property that has the specified name. + The object to which the property belongs. + The name of the property. + A , passed by reference, that represents whether the property was retrieved. + + + Provides functionality required by all components. + + + Represents the method that handles the event of a component. + + + Gets or sets the associated with the . + The object associated with the component; or null, if the component does not have a site. + + + Provides functionality for containers. Containers are objects that logically contain zero or more components. + + + Adds the specified to the at the end of the list. + The to add. + + + Adds the specified to the at the end of the list, and assigns a name to the component. + The to add. + The unique, case-insensitive name to assign to the component.-or- null that leaves the component unnamed. + + + Gets all the components in the . + A collection of objects that represents all the components in the . + + + Removes a component from the . + The to remove. + + + Provides an interface that supplies dynamic custom type information for an object. + + + Returns a collection of custom attributes for this instance of a component. + An containing the attributes for this object. + + + Returns the class name of this instance of a component. + The class name of the object, or null if the class does not have a name. + + + Returns the name of this instance of a component. + The name of the object, or null if the object does not have a name. + + + Returns a type converter for this instance of a component. + A that is the converter for this object, or null if there is no for this object. + + + Returns the default event for this instance of a component. + An that represents the default event for this object, or null if this object does not have events. + + + Returns the default property for this instance of a component. + A that represents the default property for this object, or null if this object does not have properties. + + + Returns an editor of the specified type for this instance of a component. + An of the specified type that is the editor for this object, or null if the editor cannot be found. + A that represents the editor for this object. + + + Returns the events for this instance of a component. + An that represents the events for this component instance. + + + Returns the events for this instance of a component using the specified attribute array as a filter. + An that represents the filtered events for this component instance. + An array of type that is used as a filter. + + + Returns the properties for this instance of a component. + A that represents the properties for this component instance. + + + Returns the properties for this instance of a component using the attribute array as a filter. + A that represents the filtered properties for this component instance. + An array of type that is used as a filter. + + + Returns an object that contains the property described by the specified property descriptor. + An that represents the owner of the specified property. + A that represents the property whose owner is to be found. + + + Provides the functionality to offer custom error information that a user interface can bind to. + + + Gets an error message indicating what is wrong with this object. + An error message indicating what is wrong with this object. The default is an empty string (""). + + + Gets the error message for the property with the given name. + The error message for the property. The default is an empty string (""). + The name of the property whose error message to get. + + + Provides functionality to commit or rollback changes to an object that is used as a data source. + + + Begins an edit on an object. + + + Discards changes since the last call. + + + Pushes changes since the last or call into the underlying object. + + + Defines the interface for extending properties to other components in a container. + + + Specifies whether this object can provide its extender properties to the specified object. + true if this object can provide extender properties to the specified object; otherwise, false. + The to receive the extender properties. + + + Provides an interface to facilitate the retrieval of the builder's name and to display the builder. + + + Gets a localized name. + A localized name. + + + Shows the builder. + true if the value should be replaced with ; otherwise, false (if the user cancels, for example). + The language service that is calling the builder. + The expression being edited. + The new value. + + + Provides functionality to an object to return a list that can be bound to a data source. + + + Gets a value indicating whether the collection is a collection of objects. + true if the collection is a collection of objects; otherwise, false. + + + Returns an that can be bound to a data source from an object that does not implement an itself. + An that can be bound to a data source from the object. + + + Specifies that an object has no subproperties capable of being edited. This class cannot be inherited. + + + Initializes a new instance of the class. + true if the object is immutable; otherwise, false. + + + Represents the default value for . + + + true if equals the type and value of this instance; otherwise, false. + An to compare with this instance or null. + + + Returns the hash code for this instance. + A hash code for the current . + + + Gets whether the object is immutable. + true if the object is immutable; otherwise, false. + + + Indicates whether the value of this instance is the default value. + true if this instance is the default attribute for the class; otherwise, false. + + + Specifies that an object has at least one editable subproperty. This static field is read-only. + + + Specifies that an object has no subproperties that can be edited. This static field is read-only. + + + Provides functionality for nested containers, which logically contain zero or more other components and are owned by a parent component. + + + Gets the owning component for the nested container. + The that owns the nested container. + + + Provides the ability to retrieve the full nested name of a component. + + + Gets the full name of the component in this site. + The full name of the component in this site. + + + Indicates whether the component associated with this attribute has been inherited from a base class. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified inheritance level. + An that indicates the level of inheritance to set this attribute to. + + + Specifies that the default value for is . This field is read-only. + + + Override to test for equality. + true if the object is the same; otherwise, false. + The object to test. + + + Returns the hashcode for this object. + A hash code for the current . + + + Gets or sets the current inheritance level stored in this attribute. + The stored in this attribute. + + + Specifies that the component is inherited. This field is read-only. + + + Specifies that the component is inherited and is read-only. This field is read-only. + + + Gets a value indicating whether the current value of the attribute is the default value for the attribute. + true if the current value of the attribute is the default; otherwise, false. + + + Specifies that the component is not inherited. This field is read-only. + + + Converts this attribute to a string. + A string that represents this . + + + + + + Defines identifiers for types of inheritance levels. + + + The object is inherited. + + + The object is inherited, but has read-only access. + + + The object is not inherited. + + + Specifies which event is raised on initialization. This class cannot be inherited. + + + Initializes a new instance of the class. + The name of the initialization event. + + + Gets the name of the initialization event. + The name of the initialization event. + + + Notifies clients that a property value has changed. + + + Occurs when a property value changes. + + + Notifies clients that a property value is changing. + + + Occurs when a property value is changing. + + + Specifies the installer for a type that installs components. + + + Initializes a new instance of the class with the name of the component's installer type. + The name of a that represents the installer for the component this attribute is bound to. This class must implement . + + + Initializes a new instance of the class, when given a that represents the installer for a component. + A that represents the installer for the component this attribute is bound to. This class must implement . + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + Returns the hashcode for this object. + A hash code for the current . + + + Gets the type of installer associated with this attribute. + A that represents the type of installer associated with this attribute, or null if an installer does not exist. + + + Creates an instance of a particular type of property from a drop-down box within the . + + + Initializes a new instance of the class. + + + When overridden in a derived class, returns an instance of the specified type. + An instance of the specified type or null. + The context information. + The specified type. + + + Gets the specified text. + The specified text. + + + + + + Provides a type converter to convert 16-bit signed integer objects to and from other representations. + + + Initializes a new instance of the class. + + + Provides a type converter to convert 32-bit signed integer objects to and from other representations. + + + Initializes a new instance of the class. + + + Provides a type converter to convert 64-bit signed integer objects to and from various other representations. + + + Initializes a new instance of the class. + + + Thrown when a thread on which an operation should execute no longer exists or has no message loop. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the given and . + The to be used for deserialization. + The destination to be used for deserialization. + + + Initializes a new instance of the class with the specified detailed description. + A detailed description of the error. + + + Initializes a new instance of the class with the specified detailed description and the specified exception. + A detailed description of the error. + A reference to the inner exception that is the cause of this exception. + + + The exception thrown when using invalid arguments that are enumerators. + + + Initializes a new instance of the class without a message. + + + Initializes a new instance of the class using the specified serialization data and context. + The to be used for deserialization. + The destination to be used for deserialization. + + + Initializes a new instance of the class with the specified message. + The message to display with this exception. + + + Initializes a new instance of the class with the specified detailed description and the specified exception. + A detailed description of the error. + A reference to the inner exception that is the cause of this exception. + + + Initializes a new instance of the class with a message generated from the argument, the invalid value, and an enumeration class. + The name of the argument that caused the exception. + The value of the argument that failed. + A that represents the enumeration class with the valid values. + + + Indicates whether a class converts property change events to events. + + + Gets a value indicating whether the object raises events. + true if the object raises events when one of its property values changes; otherwise, false. + + + Provides support for rolling back the changes + + + Resets the object’s state to unchanged by rejecting the modifications. + + + Provides functionality required by sites. + + + Gets the component associated with the when implemented by a class. + The instance associated with the . + + + Gets the associated with the when implemented by a class. + The instance associated with the . + + + Determines whether the component is in design mode when implemented by a class. + true if the component is in design mode; otherwise, false. + + + Gets or sets the name of the component associated with the when implemented by a class. + The name of the component associated with the ; or null, if no name is assigned to the component. + + + Specifies that this object supports a simple, transacted notification for batch initialization. + + + Signals the object that initialization is starting. + + + Signals the object that initialization is complete. + + + Allows coordination of initialization for a component and its dependent properties. + + + Occurs when initialization of the component is completed. + + + Gets a value indicating whether the component is initialized. + true to indicate the component has completed initialization; otherwise, false. + + + Provides a way to synchronously or asynchronously execute a delegate. + + + Asynchronously executes the delegate on the thread that created this object. + An interface that represents the asynchronous operation started by calling this method. + A to a method that takes parameters of the same number and type that are contained in . + An array of type to pass as arguments to the given method. This can be null if no arguments are needed. + + + Waits until the process started by calling completes, and then returns the value generated by the process. + An that represents the return value generated by the asynchronous operation. + An interface that represents the asynchronous operation started by calling . + + + Synchronously executes the delegate on the thread that created this object and marshals the call to the creating thread. + An that represents the return value from the delegate being invoked, or null if the delegate has no return value. + A that contains a method to call, in the context of the thread for the control. + An array of type that represents the arguments to pass to the given method. This can be null if no arguments are needed. + + + Gets a value indicating whether the caller must call when calling an object that implements this interface. + true if the caller must call ; otherwise, false. + + + Provides contextual information about a component, such as its container and property descriptor. + + + Gets the container representing this request. + An with the set of objects for this ; otherwise, null if there is no container or if the does not use outside objects. + + + Gets the object that is connected with this type descriptor request. + The object that invokes the method on the ; otherwise, null if there is no object responsible for the call. + + + Raises the event. + + + Raises the event. + true if this object can be changed; otherwise, false. + + + Gets the that is associated with the given context item. + The that describes the given context item; otherwise, null if there is no responsible for the call. + + + Provides functionality to discover the schema for a bindable list, where the properties available for binding differ from the public properties of the object to bind to. + + + Returns the that represents the properties on each item used to bind data. + The that represents the properties on each item used to bind data. + An array of objects to find in the collection as bindable. This can be null. + + + Returns the name of the list. + The name of the list. + An array of objects, for which the list name is returned. This can be null. + + + Provides the abstract base class for all licenses. A license is granted to a specific instance of a component. + + + Initializes a new instance of the class. + + + When overridden in a derived class, disposes of the resources used by the license. + + + When overridden in a derived class, gets the license key granted to this component. + A license key granted to this component. + + + Specifies when you can use a licensed object and provides a way of obtaining additional services needed to support licenses running within its domain. + + + Initializes a new instance of the class. + + + When overridden in a derived class, returns a saved license key for the specified type, from the specified resource assembly. + The for the specified type. This method returns null unless you override it. + A that represents the type of component. + An with the license key. + + + Gets the requested service, if it is available. + An instance of the service, or null if the service cannot be found. + The type of service to retrieve. + + + When overridden in a derived class, sets a license key for the specified type. + A that represents the component associated with the license key. + The to save for the type of component. + + + When overridden in a derived class, gets a value that specifies when you can use a license. + One of the values that specifies when you can use a license. The default is . + + + Represents the exception thrown when a component cannot be granted a license. + + + Initializes a new instance of the class with the given and . + The to be used for deserialization. + The destination to be used for deserialization. + + + Initializes a new instance of the class for the type of component that was denied a license. + A that represents the type of component that was not granted a license. + + + Initializes a new instance of the class for the type and the instance of the component that was denied a license. + A that represents the type of component that was not granted a license. + The instance of the component that was not granted a license. + + + Initializes a new instance of the class for the type and the instance of the component that was denied a license, along with a message to display. + A that represents the type of component that was not granted a license. + The instance of the component that was not granted a license. + The exception message to display. + + + Initializes a new instance of the class for the type and the instance of the component that was denied a license, along with a message to display and the original exception thrown. + A that represents the type of component that was not granted a license. + The instance of the component that was not granted a license. + The exception message to display. + An that represents the original exception. + + + Sets the with information about the exception. + The to be used for deserialization. + The destination to be used for deserialization. + + is null. + + + Gets the type of the component that was not granted a license. + A that represents the type of component that was not granted a license. + + + Provides properties and methods to add a license to a component and to manage a . This class cannot be inherited. + + + Creates an instance of the specified type, given a context in which you can use the licensed instance. + An instance of the specified type. + A that represents the type to create. + A that specifies when you can use the licensed instance. + + + Creates an instance of the specified type with the specified arguments, given a context in which you can use the licensed instance. + An instance of the specified type with the given array of arguments. + A that represents the type to create. + A that specifies when you can use the licensed instance. + An array of type that represents the arguments for the type. + + + Gets or sets the current , which specifies when you can use the licensed object. + A that specifies when you can use the licensed object. + The property is currently locked and cannot be changed. + + + + + + Returns whether the given type has a valid license. + true if the given type is licensed; otherwise, false. + The to find a valid license for. + + + Determines whether a valid license can be granted for the specified type. + true if a valid license can be granted; otherwise, false. + A that represents the type of object that requests the . + + + Determines whether a valid license can be granted for the specified instance of the type. This method creates a valid . + true if a valid can be granted; otherwise, false. + A that represents the type of object that requests the license. + An object of the specified type or a type derived from the specified type. + A that is a valid license, or null if a valid license cannot be granted. + + + Prevents changes being made to the current of the given object. + The object whose current context you want to lock. + The context is already locked. + + + Allows changes to be made to the current of the given object. + The object whose current context you want to unlock. + + represents a different user than the one specified in a previous call to . + + + Gets the which specifies when you can use the licensed object for the . + One of the values, as specified in the property. + + + Determines whether a license can be granted for the specified type. + A that represents the type of object that requests the license. + A cannot be granted. + + + Determines whether a license can be granted for the instance of the specified type. + A valid . + A that represents the type of object that requests the license. + An of the specified type or a type derived from the specified type. + The type is licensed, but a cannot be granted. + + + Provides the abstract base class for implementing a license provider. + + + Initializes a new instance of the class. + + + When overridden in a derived class, gets a license for an instance or type of component, when given a context and whether the denial of a license throws an exception. + A valid . + A that specifies where you can use the licensed object. + A that represents the component requesting the license. + An object that is requesting the license. + true if a should be thrown when the component cannot be granted a license; otherwise, false. + + + Specifies the to use with a class. This class cannot be inherited. + + + Initializes a new instance of the class without a license provider. + + + Initializes a new instance of the class with the specified type. + The fully qualified name of the license provider class. + + + Initializes a new instance of the class with the specified type of license provider. + A that represents the type of the license provider class. + + + Specifies the default value, which is no provider. This static field is read-only. + + + Indicates whether this instance and a specified object are equal. + true if is equal to this instance; otherwise, false. + Another object to compare to. + + + Returns the hash code for this instance. + A hash code for the current . + + + Gets the license provider that must be used with the associated class. + A that represents the type of the license provider. The default value is null. + + + Indicates a unique ID for this attribute type. + A unique ID for this attribute type. + + + Specifies when the can be used. + + + Used during runtime. + + + Used during design time by a visual designer or the compiler. + + + Provides an implementation of a . The provider works in a similar fashion to the Microsoft .NET Framework standard licensing model. + + + Initializes a new instance of the class. + + + Returns a key for the specified type. + A confirmation that the parameter is licensed. + The object type to return the key. + + + Returns a license for the instance of the component, if one is available. + A valid . If this method cannot find a valid or a valid parameter, it returns null. + A that specifies where you can use the licensed object. + A that represents the component requesting the . + An object that requests the . + true if a should be thrown when a component cannot be granted a license; otherwise, false. + + + + + + Determines whether the key that the method retrieves is valid for the specified type. + true if the key is a valid for the specified type; otherwise, false. + The to check. + A that represents the component requesting the . + + + Specifies that a list can be used as a data source. A visual designer should use this attribute to determine whether to display a particular list in a data-binding picker. This class cannot be inherited. + + + Initializes a new instance of the class using a value to indicate whether the list is bindable. + true if the list is bindable; otherwise, false. + + + Initializes a new instance of the class using to indicate whether the list is bindable. + A that indicates whether the list is bindable. + + + Represents the default value for . + + + Returns whether the object passed is equal to this . + true if the object passed is equal to this ; otherwise, false. + The object to test equality with. + + + Returns the hash code for this instance. + A hash code for the current . + + + Returns whether is set to the default value. + true if is set to the default value; otherwise, false. + + + Gets whether the list is bindable. + true if the list is bindable; otherwise, false. + + + Specifies that the list is not bindable. This static field is read-only. + + + Specifies that the list is bindable. This static field is read-only. + + + Provides data for the event. + + + Initializes a new instance of the class given the type of change and the affected. + A value indicating the type of change. + The that was added, removed, or changed. + + + Initializes a new instance of the class given the type of change and the index of the affected item. + A value indicating the type of change. + The index of the item that was added, changed, or removed. + + + Initializes a new instance of the class given the type of change, the index of the affected item, and a describing the affected item. + A value indicating the type of change. + The index of the item that was added or changed. + The describing the item. + + + Initializes a new instance of the class given the type of change and the old and new index of the item that was moved. + A value indicating the type of change. + The new index of the item that was moved. + The old index of the item that was moved. + + + Gets the type of change. + A value indicating the type of change. + + + Gets the index of the item affected by the change. + The index of the affected by the change. + + + Gets the old index of an item that has been moved. + The old index of the moved item. + + + Gets the that was added, changed, or deleted. + The affected by the change. + + + Represents the method that will handle the event of the class. + The source of the event. + A that contains the event data. + + + Specifies how the list changed. + + + Much of the list has changed. Any listening controls should refresh all their data from the list. + + + An item added to the list. contains the index of the item that was added. + + + An item deleted from the list. contains the index of the item that was deleted. + + + An item moved within the list. contains the previous index for the item, whereas contains the new index for the item. + + + An item changed in the list. contains the index of the item that was changed. + + + A was added, which changed the schema. + + + A was deleted, which changed the schema. + + + A was changed, which changed the schema. + + + Provides a description of the sort operation applied to a data source. + + + Initializes a new instance of the class with the specified property description and direction. + The that describes the property by which the data source is sorted. + One of the values. + + + Gets or sets the abstract description of a class property associated with this + The associated with this . + + + Gets or sets the direction of the sort operation associated with this . + One of the values. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified array of objects. + The array of objects to be contained in the collection. + + + Determines if the contains a specific value. + true if the is found in the collection; otherwise, false. + The to locate in the collection. + + + Copies the contents of the collection to the specified array, starting at the specified destination array index. + The destination array for the items copied from the collection. + The index of the destination array at which copying begins. + + + Gets the number of items in the collection. + The number of items in the collection. + + + Returns the index of the specified item in the collection. + The index of if found in the list; otherwise, -1. + The to locate in the collection. + + + Gets or sets the specified . + The with the specified index. + The zero-based index of the to get or set in the collection. + An item is set in the , which is read-only. + + + Gets a value indicating whether access to the collection is thread safe. + true in all cases. + + + Gets the current instance that can be used to synchronize access to the collection. + The current instance of the . + + + Gets a that can be used to iterate through the collection. + An that can be used to iterate through the collection. + + + Adds an item to the collection. + The position into which the new element was inserted. + The item to add to the collection. + In all cases. + + + Removes all items from the collection. + In all cases. + + + Inserts an item into the collection at a specified index. + The zero-based index of the to get or set in the collection + The item to insert into the collection. + In all cases. + + + Gets a value indicating whether the collection has a fixed size. + true in all cases. + + + Gets a value indicating whether the collection is read-only. + true in all cases. + + + Gets the specified . + The with the specified index. + The zero-based index of the to get in the collection + + + Removes the first occurrence of an item from the collection. + The item to remove from the collection. + In all cases. + + + Removes an item from the collection at a specified index. + The zero-based index of the to remove from the collection + In all cases. + + + Specifies the direction of a sort operation. + + + Sorts in ascending order. + + + Sorts in descending order. + + + Specifies whether a property should be localized. This class cannot be inherited. + + + Initializes a new instance of the class. + true if a property should be localized; otherwise, false. + + + Specifies the default value, which is . This static field is read-only. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + Returns the hash code for this instance. + A hash code for the current . + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + Gets a value indicating whether a property should be localized. + true if a property should be localized; otherwise, false. + + + Specifies that a property should not be localized. This static field is read-only. + + + Specifies that a property should be localized. This static field is read-only. + + + Specifies the properties that support lookup-based binding. This class cannot be inherited. + + + Initializes a new instance of the class using no parameters. + + + Initializes a new instance of the class. + The name of the property to be used as the data source. + The name of the property to be used for the display name. + The name of the property to be used as the source for values. + The name of the property to be used for lookups. + + + Gets the name of the data source property for the component to which the is bound. + The data source property for the component to which the is bound. + + + Represents the default value for the class. + + + Gets the name of the display member property for the component to which the is bound. + The name of the display member property for the component to which the is bound. + + + Determines whether the specified is equal to the current instance. + true if the object is equal to the current instance; otherwise, false, indicating they are not equal. + The to compare with the current instance + + + Returns the hash code for this instance. + A hash code for the current . + + + Gets the name of the lookup member for the component to which this attribute is bound. + The name of the lookup member for the component to which the is bound. + + + Gets the name of the value member property for the component to which the is bound. + The name of the value member property for the component to which the is bound. + + + Implements and provides the base implementation for remotable components that are marshaled by value (a copy of the serialized object is passed). + + + Initializes a new instance of the class. + + + Gets the container for the component. + An object implementing the interface that represents the component's container, or null if the component does not have a site. + + + Gets a value indicating whether the component is currently in design mode. + true if the component is in design mode; otherwise, false. + + + Releases all resources used by the . + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Adds an event handler to listen to the event on the component. + + + Gets the list of event handlers that are attached to this component. + An that provides the delegates for this component. + + + + Gets the implementer of the . + An that represents the implementer of the . + A that represents the type of service you want. + + + Gets or sets the site of the component. + An object implementing the interface that represents the site of the component. + + + Returns a containing the name of the , if any. This method should not be overridden. + A containing the name of the , if any.null if the is unnamed. + + + Represents a mask-parsing service that can be used by any number of controls that support masking, such as the control. + + + Initializes a new instance of the class using the specified mask. + A that represents the input mask. + + + Initializes a new instance of the class using the specified mask and ASCII restriction value. + A that represents the input mask. + true to restrict input to ASCII-compatible characters; otherwise false to allow the entire Unicode set. + + + Initializes a new instance of the class using the specified mask, password character, and prompt usage value. + A that represents the input mask. + A that will be displayed for characters entered into a password string. + true to allow the prompt character as input; otherwise false. + + + Initializes a new instance of the class using the specified mask and culture. + A that represents the input mask. + A that is used to set region-sensitive separator characters. + + + Initializes a new instance of the class using the specified mask, culture, and ASCII restriction value. + A that represents the input mask. + A that is used to set region-sensitive separator characters. + true to restrict input to ASCII-compatible characters; otherwise false to allow the entire Unicode set. + + + Initializes a new instance of the class using the specified mask, culture, prompt usage value, prompt character, password character, and ASCII restriction value. + A that represents the input mask. + A that is used to set region-sensitive separator characters. + A value that specifies whether the prompt character should be allowed as a valid input character. + A that will be displayed as a placeholder for user input. + A that will be displayed for characters entered into a password string. + true to restrict input to ASCII-compatible characters; otherwise false to allow the entire Unicode set. + The mask parameter is null or .-or-The mask contains one or more non-printable characters. + + + Initializes a new instance of the class using the specified mask, culture, password character, and prompt usage value. + A that represents the input mask. + A that is used to set region-sensitive separator characters. + A that will be displayed for characters entered into a password string. + true to allow the prompt character as input; otherwise false. + + + Adds the specified input character to the end of the formatted string. + true if the input character was added successfully; otherwise false. + A value to be appended to the formatted string. + + + Adds the specified input character to the end of the formatted string, and then outputs position and descriptive information. + true if the input character was added successfully; otherwise false. + A value to be appended to the formatted string. + The zero-based position in the formatted string where the attempt was made to add the character. An output parameter. + A that succinctly describes the result of the operation. An output parameter. + + + Adds the characters in the specified input string to the end of the formatted string. + true if all the characters from the input string were added successfully; otherwise false to indicate that no characters were added. + A containing character values to be appended to the formatted string. + The parameter is null. + + + Adds the characters in the specified input string to the end of the formatted string, and then outputs position and descriptive information. + true if all the characters from the input string were added successfully; otherwise false to indicate that no characters were added. + A containing character values to be appended to the formatted string. + The zero-based position in the formatted string where the attempt was made to add the character. An output parameter. + A that succinctly describes the result of the operation. An output parameter. + + + Gets a value indicating whether the prompt character should be treated as a valid input character or not. + true if the user can enter into the control; otherwise, false. The default is true. + + + Gets a value indicating whether the mask accepts characters outside of the ASCII character set. + true if only ASCII is accepted; false if can accept any arbitrary Unicode character. The default is false. + + + Gets the number of editable character positions that have already been successfully assigned an input value. + An containing the number of editable character positions in the input mask that have already been assigned a character value in the formatted string. + + + Gets the number of editable character positions in the input mask that have not yet been assigned an input value. + An containing the number of editable character positions that not yet been assigned a character value. + + + Clears all the editable input characters from the formatted string, replacing them with prompt characters. + + + Clears all the editable input characters from the formatted string, replacing them with prompt characters, and then outputs descriptive information. + A that succinctly describes the result of the operation. An output parameter. + + + Creates a copy of the current . + The object this method creates, cast as an object. + + + Gets the culture that determines the value of the localizable separators and placeholders in the input mask. + A containing the culture information associated with the input mask. + + + Gets the default password character used obscure user input. + A that represents the default password character. + + + Gets the number of editable positions in the formatted string. + An containing the number of editable positions in the formatted string. + + + Gets a newly created enumerator for the editable positions in the formatted string. + An that supports enumeration over the editable positions in the formatted string. + + + Returns the position of the first assigned editable position after the specified position using the specified search direction. + If successful, an representing the zero-based position of the first assigned editable position encountered; otherwise . + The zero-based position in the formatted string to start the search. + A indicating the search direction; either true to search forward or false to search backward. + + + Returns the position of the first assigned editable position between the specified positions using the specified search direction. + If successful, an representing the zero-based position of the first assigned editable position encountered; otherwise . + The zero-based position in the formatted string where the search starts. + The zero-based position in the formatted string where the search ends. + A indicating the search direction; either true to search forward or false to search backward. + + + Returns the position of the first editable position after the specified position using the specified search direction. + If successful, an representing the zero-based position of the first editable position encountered; otherwise . + The zero-based position in the formatted string to start the search. + A indicating the search direction; either true to search forward or false to search backward. + + + Returns the position of the first editable position between the specified positions using the specified search direction. + If successful, an representing the zero-based position of the first editable position encountered; otherwise . + The zero-based position in the formatted string where the search starts. + The zero-based position in the formatted string where the search ends. + A indicating the search direction; either true to search forward or false to search backward. + + + Returns the position of the first non-editable position after the specified position using the specified search direction. + If successful, an representing the zero-based position of the first literal position encountered; otherwise . + The zero-based position in the formatted string to start the search. + A indicating the search direction; either true to search forward or false to search backward. + + + Returns the position of the first non-editable position between the specified positions using the specified search direction. + If successful, an representing the zero-based position of the first literal position encountered; otherwise . + The zero-based position in the formatted string where the search starts. + The zero-based position in the formatted string where the search ends. + A indicating the search direction; either true to search forward or false to search backward. + + + Returns the position of the first unassigned editable position after the specified position using the specified search direction. + If successful, an representing the zero-based position of the first unassigned editable position encountered; otherwise . + The zero-based position in the formatted string to start the search. + A indicating the search direction; either true to search forward or false to search backward. + + + Returns the position of the first unassigned editable position between the specified positions using the specified search direction. + If successful, an representing the zero-based position of the first unassigned editable position encountered; otherwise . + The zero-based position in the formatted string where the search starts. + The zero-based position in the formatted string where the search ends. + A indicating the search direction; either true to search forward or false to search backward. + + + Determines whether the specified denotes success or failure. + true if the specified value represents a success; otherwise, false if it represents failure. + A value typically obtained as an output parameter from a previous operation. + + + Gets or sets a value that indicates whether literal characters in the input mask should be included in the formatted string. + true if literals are included; otherwise, false. The default is true. + + + Gets or sets a value indicating whether is used to represent the absence of user input when displaying the formatted string. + true if the prompt character is used to represent the positions where no user input was provided; otherwise, false. The default is true. + + + Inserts the specified character at the specified position within the formatted string. + true if the insertion was successful; otherwise, false. + The to be inserted. + The zero-based position in the formatted string to insert the character. + + + Inserts the specified character at the specified position within the formatted string, returning the last insertion position and the status of the operation. + true if the insertion was successful; otherwise, false. + The to be inserted. + The zero-based position in the formatted string to insert the character. + If the method is successful, the last position where a character was inserted; otherwise, the first position where the insertion failed. An output parameter. + A that succinctly describes the result of the insertion operation. An output parameter. + + + Inserts the specified string at a specified position within the formatted string. + true if the insertion was successful; otherwise, false. + The to be inserted. + The zero-based position in the formatted string to insert the input string. + The parameter is null. + + + Inserts the specified string at a specified position within the formatted string, returning the last insertion position and the status of the operation. + true if the insertion was successful; otherwise, false. + The to be inserted. + The zero-based position in the formatted string to insert the input string. + If the method is successful, the last position where a character was inserted; otherwise, the first position where the insertion failed. An output parameter. + A that succinctly describes the result of the insertion operation. An output parameter. + The parameter is null. + + + Gets the upper bound of the range of invalid indexes. + A value representing the largest invalid index, as determined by the provider implementation. For example, if the lowest valid index is 0, this property will return -1. + + + Determines whether the specified position is available for assignment. + true if the specified position in the formatted string is editable and has not been assigned to yet; otherwise false. + The zero-based position in the mask to test. + + + Determines whether the specified position is editable. + true if the specified position in the formatted string is editable; otherwise false. + The zero-based position in the mask to test. + + + Gets or sets a value that determines whether password protection should be applied to the formatted string. + true if the input string is to be treated as a password string; otherwise, false. The default is false. + + + Determines whether the specified character is a valid input character. + true if the specified character contains a valid input value; otherwise false. + The value to test. + + + Determines whether the specified character is a valid mask character. + true if the specified character contains a valid mask value; otherwise false. + The value to test. + + + Determines whether the specified character is a valid password character. + true if the specified character contains a valid password value; otherwise false. + The value to test. + + + Gets the element at the specified position in the formatted string. + The at the specified position in the formatted string. + A zero-based index of the element to retrieve. + + is less than zero or greater than or equal to the of the mask. + + + Gets the index in the mask of the rightmost input character that has been assigned to the mask. + If at least one input character has been assigned to the mask, an containing the index of rightmost assigned position; otherwise, if no position has been assigned, . + + + Gets the length of the mask, absent any mask modifier characters. + An containing the number of positions in the mask, excluding characters that modify mask input. + + + Gets the input mask. + A containing the full mask. + + + Gets a value indicating whether all required inputs have been entered into the formatted string. + true if all required input has been entered into the mask; otherwise, false. + + + Gets a value indicating whether all required and optional inputs have been entered into the formatted string. + true if all required and optional inputs have been entered; otherwise, false. + + + Gets or sets the character to be substituted for the actual input characters. + The value used as the password character. + The password character specified when setting this property is the same as the current prompt character, . The two are required to be different. + The character specified when setting this property is not a valid password character, as determined by the method. + + + Gets or sets the character used to represent the absence of user input for all available edit positions. + The character used to prompt the user for input. The default is an underscore (_). + The prompt character specified when setting this property is the same as the current password character, . The two are required to be different. + The character specified when setting this property is not a valid password character, as determined by the method. + + + Removes the last assigned character from the formatted string. + true if the character was successfully removed; otherwise, false. + + + Removes the last assigned character from the formatted string, and then outputs the removal position and descriptive information. + true if the character was successfully removed; otherwise, false. + The zero-based position in the formatted string where the character was actually removed. An output parameter. + A that succinctly describes the result of the operation. An output parameter. + + + Removes the assigned character at the specified position from the formatted string. + true if the character was successfully removed; otherwise, false. + The zero-based position of the assigned character to remove. + + + Removes the assigned characters between the specified positions from the formatted string. + true if the character was successfully removed; otherwise, false. + The zero-based index of the first assigned character to remove. + The zero-based index of the last assigned character to remove. + + + Removes the assigned characters between the specified positions from the formatted string, and then outputs the removal position and descriptive information. + true if the character was successfully removed; otherwise, false. + The zero-based index of the first assigned character to remove. + The zero-based index of the last assigned character to remove. + If successful, the zero-based position in the formatted string of where the characters were actually removed; otherwise, the first position where the operation failed. An output parameter. + A that succinctly describes the result of the operation. An output parameter. + + + Replaces a single character at or beyond the specified position with the specified character value. + true if the character was successfully replaced; otherwise, false. + The value that replaces the existing value. + The zero-based position to search for the first editable character to replace. + + + Replaces a single character between the specified starting and ending positions with the specified character value, and then outputs the removal position and descriptive information. + true if the character was successfully replaced; otherwise, false. + The value that replaces the existing value. + The zero-based position in the formatted string where the replacement starts. + The zero-based position in the formatted string where the replacement ends. + If successful, the zero-based position in the formatted string where the last character was actually replaced; otherwise, the first position where the operation failed. An output parameter. + A that succinctly describes the result of the replacement operation. An output parameter. + + + Replaces a single character at or beyond the specified position with the specified character value, and then outputs the removal position and descriptive information. + true if the character was successfully replaced; otherwise, false. + The value that replaces the existing value. + The zero-based position to search for the first editable character to replace. + If successful, the zero-based position in the formatted string where the last character was actually replaced; otherwise, the first position where the operation failed. An output parameter. + A that succinctly describes the result of the replacement operation. An output parameter. + + + Replaces a range of editable characters starting at the specified position with the specified string. + true if all the characters were successfully replaced; otherwise, false. + The value used to replace the existing editable characters. + The zero-based position to search for the first editable character to replace. + The parameter is null. + + + Replaces a range of editable characters between the specified starting and ending positions with the specified string, and then outputs the removal position and descriptive information. + true if all the characters were successfully replaced; otherwise, false. + The value used to replace the existing editable characters. + The zero-based position in the formatted string where the replacement starts. + The zero-based position in the formatted string where the replacement ends. + If successful, the zero-based position in the formatted string where the last character was actually replaced; otherwise, the first position where the operation failed. An output parameter. + A that succinctly describes the result of the replacement operation. An output parameter. + + + Replaces a range of editable characters starting at the specified position with the specified string, and then outputs the removal position and descriptive information. + true if all the characters were successfully replaced; otherwise, false. + The value used to replace the existing editable characters. + The zero-based position to search for the first editable character to replace. + If successful, the zero-based position in the formatted string where the last character was actually replaced; otherwise, the first position where the operation failed. An output parameter. + A that succinctly describes the result of the replacement operation. An output parameter. + + + Gets or sets a value that determines how an input character that matches the prompt character should be handled. + true if the prompt character entered as input causes the current editable position in the mask to be reset; otherwise, false to indicate that the prompt character is to be processed as a normal input character. The default is true. + + + Gets or sets a value that determines how a space input character should be handled. + true if the space input character causes the current editable position in the mask to be reset; otherwise, false to indicate that it is to be processed as a normal input character. The default is true. + + + Sets the formatted string to the specified input string. + true if all the characters were successfully set; otherwise, false. + The value used to set the formatted string. + The parameter is null. + + + Sets the formatted string to the specified input string, and then outputs the removal position and descriptive information. + true if all the characters were successfully set; otherwise, false. + The value used to set the formatted string. + If successful, the zero-based position in the formatted string where the last character was actually set; otherwise, the first position where the operation failed. An output parameter. + A that succinctly describes the result of the set operation. An output parameter. + The parameter is null. + + + Gets or sets a value indicating whether literal character positions in the mask can be overwritten by their same values. + true to allow literals to be added back; otherwise, false to not allow the user to overwrite literal characters. The default is true. + + + Returns the formatted string in a displayable form. + The formatted that includes prompts and mask literals. + + + Returns the formatted string that includes all the assigned character values. + The formatted that includes all the assigned character values. + + + Returns the formatted string, optionally including password characters. + The formatted that includes literals, prompts, and optionally password characters. + true to return the actual editable characters; otherwise, false to indicate that the property is to be honored. + + + Returns the formatted string, optionally including prompt and literal characters. + The formatted that includes all the assigned character values and optionally includes literals and prompts. + true to include prompt characters in the return string; otherwise, false. + true to include literal characters in the return string; otherwise, false. + + + Returns a substring of the formatted string, optionally including prompt, literal, and password characters. + If successful, a substring of the formatted , which includes all the assigned character values and optionally includes literals, prompts, and password characters; otherwise the string. + true to return the actual editable characters; otherwise, false to indicate that the property is to be honored. + true to include prompt characters in the return string; otherwise, false. + true to return literal characters in the return string; otherwise, false. + The zero-based position in the formatted string where the output begins. + The number of characters to return. + + + Returns a substring of the formatted string, optionally including prompt and literal characters. + If successful, a substring of the formatted , which includes all the assigned character values and optionally includes literals and prompts; otherwise the string. + true to include prompt characters in the return string; otherwise, false. + true to include literal characters in the return string; otherwise, false. + The zero-based position in the formatted string where the output begins. + The number of characters to return. + + + Returns a substring of the formatted string, optionally including password characters. + If successful, a substring of the formatted , which includes literals, prompts, and optionally password characters; otherwise the string. + true to return the actual editable characters; otherwise, false to indicate that the property is to be honored. + The zero-based position in the formatted string where the output begins. + The number of characters to return. + + + Returns a substring of the formatted string. + If successful, a substring of the formatted , which includes all the assigned character values; otherwise the string. + The zero-based position in the formatted string where the output begins. + The number of characters to return. + + + Tests whether the specified character could be set successfully at the specified position. + true if the specified character is valid for the specified position; otherwise, false. + The value to test. + The position in the mask to test the input character against. + A that succinctly describes the result of the operation. An output parameter. + + + Tests whether the specified character would be escaped at the specified position. + true if the specified character would be escaped at the specified position; otherwise, false. + The value to test. + The position in the mask to test the input character against. + + + Tests whether the specified string could be set successfully. + true if the specified string represents valid input; otherwise, false. + The value to test. + + + Tests whether the specified string could be set successfully, and then outputs position and descriptive information. + true if the specified string represents valid input; otherwise, false. + The value to test. + If successful, the zero-based position of the last character actually tested; otherwise, the first position where the test failed. An output parameter. + A that succinctly describes the result of the test operation. An output parameter. + + + Specifies values that succinctly describe the results of a masked text parsing operation. + + + Unknown. The result of the operation could not be determined. + + + Success. The operation succeeded because a literal, prompt or space character was an escaped character. For more information about escaped characters, see the method. + + + Success. The primary operation was not performed because it was not needed; therefore, no side effect was produced. + + + Success. The primary operation was not performed because it was not needed, but the method produced a side effect. For example, the method can delete an unassigned edit position, which causes left-shifting of subsequent characters in the formatted string. + + + Success. The primary operation succeeded. + + + Operation did not succeed.An input character was encountered that was not a member of the ASCII character set. + + + Operation did not succeed.An input character was encountered that was not alphanumeric. . + + + Operation did not succeed. An input character was encountered that was not a digit. + + + Operation did not succeed. An input character was encountered that was not a letter. + + + Operation did not succeed. An input character was encountered that was not a signed digit. + + + Operation did not succeed. The program encountered an input character that was not valid. For more information about characters that are not valid, see the method. + + + Operation did not succeed. The prompt character is not valid at input, perhaps because the property is set to false. + + + Operation did not succeed. There were not enough edit positions available to fulfill the request. + + + Operation did not succeed. The current position in the formatted string is a literal character. + + + Operation did not succeed. The specified position is not in the range of the target string; typically it is either less than zero or greater then the length of the target string. + + + Represents a class member, such as a property or event. This is an abstract base class. + + + Initializes a new instance of the class with the specified . + A that contains the name of the member and its attributes. + + + Initializes a new instance of the class with the name in the specified and the attributes in both the old and the array. + A that has the name of the member and its attributes. + An array of objects with the attributes you want to add to the member. + + + Initializes a new instance of the class with the specified name of the member. + The name of the member. + The name is an empty string ("") or null. + + + Initializes a new instance of the class with the specified name of the member and an array of attributes. + The name of the member. + An array of type that contains the member attributes. + The name is an empty string ("") or null. + + + Gets or sets an array of attributes. + An array of type that contains the attributes of this member. + + + Gets the collection of attributes for this member. + An that provides the attributes for this member, or an empty collection if there are no attributes in the . + + + Gets the name of the category to which the member belongs, as specified in the . + The name of the category to which the member belongs. If there is no , the category name is set to the default category, Misc. + + + + + + Creates a collection of attributes using the array of attributes passed to the constructor. + A new that contains the attributes. + + + Gets the description of the member, as specified in the . + The description of the member. If there is no , the property value is set to the default, which is an empty string (""). + + + Gets whether this member should be set only at design time, as specified in the . + true if this member should be set only at design time; false if the member can be set during run time. + + + Gets the name that can be displayed in a window, such as a Properties window. + The name to display for the member. + + + Compares this instance to the given object to see if they are equivalent. + true if equivalent; otherwise, false. + The object to compare to the current instance. + + + When overridden in a derived class, adds the attributes of the inheriting class to the specified list of attributes in the parent class. + An that lists the attributes in the parent class. Initially, this is empty. + + + Finds the given method through reflection, searching only for public methods. + A that represents the method, or null if the method is not found. + The component that contains the method. + The name of the method to find. + An array of parameters for the method, used to choose between overloaded methods. + The type to return for the method. + + + Finds the given method through reflection, with an option to search only public methods. + A that represents the method, or null if the method is not found. + The component that contains the method. + The name of the method to find. + An array of parameters for the method, used to choose between overloaded methods. + The type to return for the method. + Whether to restrict search to public methods. + + + Returns the hash code for this instance. + A hash code for the current . + + + Retrieves the object that should be used during invocation of members. + The object to be used during member invocations. + The of the invocation target. + The potential invocation target. + + or is null. + + + Gets the component on which to invoke a method. + An instance of the component to invoke. This method returns a visual designer when the property is attached to a visual designer. + A representing the type of component this is bound to. For example, if this describes a property, this parameter should be the class that the property is declared on. + An instance of the object to call. + + or is null. + + + Gets a component site for the given component. + The site of the component, or null if a site does not exist. + The component for which you want to find a site. + + + Gets a value indicating whether the member is browsable, as specified in the . + true if the member is browsable; otherwise, false. If there is no , the property value is set to the default, which is true. + + + Gets the name of the member. + The name of the member. + + + Gets the hash code for the name of the member, as specified in . + The hash code for the name of the member. + + + Specifies that this property can be combined with properties belonging to other objects in a Properties window. + + + Initializes a new instance of the class. + true if this property can be combined with properties belonging to other objects in a Properties window; otherwise, false. + + + Gets a value indicating whether this property can be combined with properties belonging to other objects in a Properties window. + true if this property can be combined with properties belonging to other objects in a Properties window; otherwise, false. + + + Specifies the default value, which is , that is a property can be combined with properties belonging to other objects in a Properties window. This static field is read-only. + + + Indicates whether this instance and a specified object are equal. + true if is equal to this instance; otherwise, false. + Another object to compare to. + + + Returns the hash code for this instance. + A hash code for the current . + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + Specifies that a property cannot be combined with properties belonging to other objects in a Properties window. This static field is read-only. + + + Specifies that a property can be combined with properties belonging to other objects in a Properties window. This static field is read-only. + + + Provides a type converter to convert multiline strings to a simple string. + + + Initializes a new instance of the class. + + + Converts the given value object to the specified type, using the specified context and culture information. + An that represents the converted value. + An that provides a format context. + A . If null is passed, the current culture is assumed. + The to convert. + The to convert the value parameter to. + + is null. + The conversion cannot be performed. + + + Returns a collection of properties for the type of array specified by the parameter, using the specified context and attributes. + A with the properties that are exposed for this data type, or null if there are no properties. + An that provides a format context. + An that specifies the type of array for which to get properties. + An array of type that is used as a filter. + + + Returns whether this object supports properties, using the specified context. + true if should be called to find the properties of this object; otherwise, false. + An that provides a format context. + + + Provides the base implementation for the interface, which enables containers to have an owning component. + + + Initializes a new instance of the class. + The that owns this nested container. + + is null. + + + Creates a site for the component within the container. + The newly created . + The to create a site for. + The name to assign to , or null to skip the name assignment. + + is null. + + + Releases the resources used by the nested container. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets the service object of the specified type, if it is available. + An that implements the requested service, or null if the service cannot be resolved. + The of the service to retrieve. + + + Gets the owning component for this nested container. + The that owns this nested container. + + + Gets the name of the owning component. + The name of the owning component. + + + Indicates that the parent property is notified when the value of the property that this attribute is applied to is modified. This class cannot be inherited. + + + Initializes a new instance of the class, using the specified value to determine whether the parent property is notified of changes to the value of the property. + true if the parent should be notified of changes; otherwise, false. + + + Indicates the default attribute state, that the property should not notify the parent property of changes to its value. This field is read-only. + + + Gets a value indicating whether the specified object is the same as the current object. + true if the object is the same as this object; otherwise, false. + The object to test for equality. + + + Gets the hash code for this object. + The hash code for the object the attribute belongs to. + + + Gets a value indicating whether the current value of the attribute is the default value for the attribute. + true if the current value of the attribute is the default value of the attribute; otherwise, false. + + + Indicates that the parent property is not be notified of changes to the value of the property. This field is read-only. + + + Gets or sets a value indicating whether the parent property should be notified of changes to the value of the property. + true if the parent property should be notified of changes; otherwise, false. + + + Indicates that the parent property is notified of changes to the value of the property. This field is read-only. + + + Provides automatic conversion between a nullable type and its underlying primitive type. + + + Initializes a new instance of the class. + The specified nullable type. + + is not a nullable type. + + + Returns whether this converter can convert an object of the given type to the type of this converter, using the specified context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you want to convert from. + + + Returns whether this converter can convert the object to the specified type, using the specified context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you want to convert to. + + + Converts the given object to the type of this converter, using the specified context and culture information. + An that represents the converted value. + An that provides a format context. + The to use as the current culture. + The to convert. + The conversion cannot be performed. + + + Converts the given value object to the specified type, using the specified context and culture information. + An that represents the converted value. + An that provides a format context. + The to use as the current culture. + The to convert. + The to convert the value parameter to. + + is null. + The conversion cannot be performed. + + + An representing the given , or null if the object cannot be created. This method always returns null. + An that provides a format context. + An of new property values. + + + true if changing a property on this object requires a call to to create a new value; otherwise, false. + An that provides a format context. + + + A with the properties that are exposed for this data type, or null if there are no properties. + An that provides a format context. + An that specifies the type of array for which to get properties. + An array of type that is used as a filter. + + + true if should be called to find the properties of this object; otherwise, false. + An that provides a format context. + + + A that holds a standard set of valid values, or null if the data type does not support a standard set of values. + An that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null. + + + true if the returned from is an exhaustive list of possible values; false if other values are possible. + An that provides a format context. + + + true if should be called to find a common set of values the object supports; otherwise, false. + An that provides a format context. + + + An that provides a format context. + The to test for validity. + + + Gets the nullable type. + A that represents the nullable type. + + + Gets the underlying type. + A that represents the underlying type. + + + Gets the underlying type converter. + A that represents the underlying type converter. + + + Indicates whether the name of the associated property is displayed with parentheses in the Properties window. This class cannot be inherited. + + + Initializes a new instance of the class that indicates that the associated property should not be shown with parentheses. + + + Initializes a new instance of the class, using the specified value to indicate whether the attribute is displayed with parentheses. + true if the name should be enclosed in parentheses; otherwise, false. + + + Initializes a new instance of the class with a default value that indicates that the associated property should not be shown with parentheses. This field is read-only. + + + Compares the specified object to this object and tests for equality. + true if equal; otherwise, false. + The object to be compared. + + + Gets the hash code for this object. + The hash code for the object the attribute belongs to. + + + Gets a value indicating whether the current value of the attribute is the default value for the attribute. + true if the current value of the attribute is the default value of the attribute; otherwise, false. + + + Gets a value indicating whether the Properties window displays the name of the property in parentheses in the Properties window. + true if the property is displayed with parentheses; otherwise, false. + + + Indicates that an object's text representation is obscured by characters such as asterisks. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class, optionally showing password text. + true to indicate that the property should be shown as password text; otherwise, false. The default is false. + + + Specifies the default value for the . + + + Determines whether two instances are equal. + true if the specified is equal to the current ; otherwise, false. + The to compare with the current . + + + Returns the hash code for this instance. + A hash code for the current . + + + Returns an indication whether the value of this instance is the default value. + true if this instance is the default attribute for the class; otherwise, false. + + + Specifies that a text property is not used as a password. This static (Shared in Visual Basic) field is read-only. + + + Gets a value indicating if the property for which the is defined should be shown as password text. + true if the property should be shown as password text; otherwise, false. + + + Specifies that a text property is used as a password. This static (Shared in Visual Basic) field is read-only. + + + Provides data for the event. + + + Initializes a new instance of the class. + The percentage of an asynchronous task that has been completed. + A unique user state. + + + Gets the asynchronous task progress percentage. + A percentage value indicating the asynchronous task progress. + + + Gets a unique user state. + A unique indicating the user state. + + + Represents the method that will handle the event of the class. This class cannot be inherited. + The source of the event. + A that contains the event data. + + + Provides data for the event. + + + Initializes a new instance of the class. + The name of the property that changed. + + + Gets the name of the property that changed. + The name of the property that changed. + + + Represents the method that will handle the event raised when a property is changed on a component. + The source of the event. + A that contains the event data. + + + Provides data for the event. + + + Initializes a new instance of the class. + The name of the property whose value is changing. + + + Gets the name of the property whose value is changing. + The name of the property whose value is changing. + + + Represents the method that will handle the event of an interface. + The source of the event. + A that contains the event data. + + + Provides an abstraction of a property on a class. + + + Initializes a new instance of the class with the name and attributes in the specified . + A that contains the name of the property and its attributes. + + + Initializes a new instance of the class with the name in the specified and the attributes in both the and the array. + A containing the name of the member and its attributes. + An array containing the attributes you want to associate with the property. + + + Initializes a new instance of the class with the specified name and attributes. + The name of the property. + An array of type that contains the property attributes. + + + Enables other objects to be notified when this property changes. + The component to add the handler for. + The delegate to add as a listener. + + or is null. + + + When overridden in a derived class, returns whether resetting an object changes its value. + true if resetting the component changes its value; otherwise, false. + The component to test for reset capability. + + + When overridden in a derived class, gets the type of the component this property is bound to. + A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. + + + Gets the type converter for this property. + A that is used to convert the of this property. + + + + + + Creates an instance of the specified type. + A new instance of the type. + A that represents the type to create. + + + Compares this to another object to see if they are equivalent. + true if the values are equivalent; otherwise, false. + The object to compare to this . + + + Adds the attributes of the to the specified list of attributes in the parent class. + An that lists the attributes in the parent class. Initially, this is empty. + + + Returns the default . + A . + + + + + + Returns a using a specified array of attributes as a filter. + A with the properties that match the specified attributes. + An array of type to use as a filter. + + + Returns a for a given object. + A with the properties for the specified component. + A component to get the properties for. + + + Returns a for a given object using a specified array of attributes as a filter. + A with the properties that match the specified attributes for the specified component. + A component to get the properties for. + An array of type to use as a filter. + + + Gets an editor of the specified type. + An instance of the requested editor type, or null if an editor cannot be found. + The base type of editor, which is used to differentiate between multiple editors that a property supports. + + + Returns the hash code for this object. + The hash code for this object. + + + This method returns the object that should be used during invocation of members. + The that should be used during invocation of members. + The of the invocation target. + The potential invocation target. + + + Returns a type using its name. + A that matches the given type name, or null if a match cannot be found. + The assembly-qualified name of the type to retrieve. + + + When overridden in a derived class, gets the current value of the property on a component. + The value of a property for a given component. + The component with the property for which to retrieve the value. + + + Retrieves the current set of ValueChanged event handlers for a specific component + A combined multicast event handler, or null if no event handlers are currently assigned to . + The component for which to retrieve event handlers. + + + Gets a value indicating whether this property should be localized, as specified in the . + true if the member is marked with the set to true; otherwise, false. + + + When overridden in a derived class, gets a value indicating whether this property is read-only. + true if the property is read-only; otherwise, false. + + + Raises the ValueChanged event that you implemented. + The object that raises the event. + An that contains the event data. + + + When overridden in a derived class, gets the type of the property. + A that represents the type of the property. + + + Enables other objects to be notified when this property changes. + The component to remove the handler for. + The delegate to remove as a listener. + + or is null. + + + When overridden in a derived class, resets the value for this property of the component to the default value. + The component with the property value that is to be reset to the default value. + + + Gets a value indicating whether this property should be serialized, as specified in the . + One of the enumeration values that specifies whether this property should be serialized. + + + When overridden in a derived class, sets the value of the component to a different value. + The component with the property value that is to be set. + The new value. + + + When overridden in a derived class, determines a value indicating whether the value of this property needs to be persisted. + true if the property should be persisted; otherwise, false. + The component with the property to be examined for persistence. + + + Gets a value indicating whether value change notifications for this property may originate from outside the property descriptor. + true if value change notifications may originate from outside the property descriptor; otherwise, false. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + An array of type that provides the properties for this collection. + + + Initializes a new instance of the class, which is optionally read-only. + An array of type that provides the properties for this collection. + If true, specifies that the collection cannot be modified. + + + Adds the specified to the collection. + The index of the that was added to the collection. + The to add to the collection. + The collection is read-only. + + + Removes all objects from the collection. + The collection is read-only. + + + Returns whether the collection contains the given . + true if the collection contains the given ; otherwise, false. + The to find in the collection. + + + Copies the entire collection to an array, starting at the specified index number. + An array of objects to copy elements of the collection to. + The index of the parameter at which copying begins. + + + Gets the number of property descriptors in the collection. + The number of property descriptors in the collection. + + + Specifies an empty collection that you can use instead of creating a new one with no items. This static field is read-only. + + + Returns the with the specified name, using a Boolean to indicate whether to ignore case. + A with the specified name, or null if the property does not exist. + The name of the to return from the collection. + true if you want to ignore the case of the property name; otherwise, false. + + + Returns an enumerator for this class. + An enumerator of type . + + + Returns the index of the given . + The index of the given . + The to return the index of. + + + Adds the to the collection at the specified index number. + The index at which to add the parameter to the collection. + The to add to the collection. + The collection is read-only. + + + Sorts the members of this collection, using the specified . + A comparer to use to sort the objects in this collection. + + + Sorts the members of this collection. The specified order is applied first, followed by the default sort for this collection, which is usually alphabetical. + An array of strings describing the order in which to sort the objects in this collection. + + + Gets or sets the at the specified index number. + The with the specified index number. + The zero-based index of the to get or set. + The parameter is not a valid index for . + + + Gets or sets the with the specified name. + The with the specified name, or null if the property does not exist. + The name of the to get from the collection. + + + Removes the specified from the collection. + The to remove from the collection. + The collection is read-only. + + + Removes the at the specified index from the collection. + The index of the to remove from the collection. + The collection is read-only. + + + Sorts the members of this collection, using the default sort for this collection, which is usually alphabetical. + A new that contains the sorted objects. + + + Sorts the members of this collection, using the specified . + A new that contains the sorted objects. + A comparer to use to sort the objects in this collection. + + + Sorts the members of this collection. The specified order is applied first, followed by the default sort for this collection, which is usually alphabetical. + A new that contains the sorted objects. + An array of strings describing the order in which to sort the objects in this collection. + + + Sorts the members of this collection. The specified order is applied first, followed by the sort using the specified . + A new that contains the sorted objects. + An array of strings describing the order in which to sort the objects in this collection. + A comparer to use to sort the objects in this collection. + + + Gets the number of elements contained in the collection. + The number of elements contained in the collection. + + + Gets a value indicating whether access to the collection is synchronized (thread safe). + true if access to the collection is synchronized (thread safe); otherwise, false. + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the collection. + + + Adds an element with the provided key and value to the . + The to use as the key of the element to add. + The to use as the value of the element to add. + The collection is read-only. + + is null. + + + Removes all elements from the . + + + Determines whether the contains an element with the specified key. + true if the contains an element with the key; otherwise, false. + The key to locate in the . + + + Returns an enumerator for this class. + An enumerator of type . + + + Gets a value indicating whether the has a fixed size. + true if the has a fixed size; otherwise, false. + + + Gets a value indicating whether the is read-only. + true if the is read-only; otherwise, false. + + + Gets or sets the element with the specified key. + The element with the specified key. + The key of the element to get or set. + + + Gets an containing the keys of the . + An containing the keys of the . + + + Removes the element with the specified key from the . + The key of the element to remove. + + + Gets an containing the values in the . + An containing the values in the . + + + Returns an for the . + An for the . + + + Adds an item to the . + The position into which the new element was inserted. + The item to add to the collection. + + + Removes all items from the collection. + The collection is read-only. + + + Determines whether the collection contains a specific value. + true if the item is found in the collection; otherwise, false. + The item to locate in the collection. + + + Determines the index of a specified item in the collection. + The index of if found in the list, otherwise -1. + The item to locate in the collection. + + + Inserts an item into the collection at a specified index. + The zero-based index at which should be inserted. + The item to insert into the collection. + The collection is read-only. + + + Gets a value indicating whether the collection has a fixed size. + true if the collection has a fixed size; otherwise, false. + + + Gets a value indicating whether the collection is read-only. + true if the collection is read-only; otherwise, false. + + + Gets or sets an item from the collection at a specified index. + The element at the specified index. + The zero-based index of the item to get or set. + The collection is read-only. + + is not a . + + is less than 0. -or- is equal to or greater than . + + + Removes the first occurrence of a specified value from the collection. + The item to remove from the collection. + The collection is read-only. + + + Removes the item at the specified index. + The zero-based index of the item to remove. + The collection is read-only. + + + Identifies the property tab or tabs to display for the specified class or classes. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified tab class name. + The assembly qualified name of the type of tab to create. For an example of this format convention, see . + + + Initializes a new instance of the class using the specified tab class name and tab scope. + The assembly qualified name of the type of tab to create. For an example of this format convention, see . + A that indicates the scope of this tab. If the scope is , it is shown only for components with the corresponding . If it is , it is shown for all components on the document. + + is not or . + + + Initializes a new instance of the class using the specified type of tab. + The type of tab to create. + + + Initializes a new instance of the class using the specified type of tab and tab scope. + The type of tab to create. + A that indicates the scope of this tab. If the scope is , it is shown only for components with the corresponding . If it is , it is shown for all components on the document. + + is not or . + + + Returns a value indicating whether this instance is equal to a specified attribute. + true if the instances are equal; otherwise, false. + A to compare to this instance, or null. + The types specified by the property of the parameter cannot be found. + + + + + + + Returns a value indicating whether this instance is equal to a specified object. + true if refers to the same instance; otherwise, false. + An object to compare to this instance, or null. + The types specified by the property of the parameter could not be found. + + + + + + + Gets the hash code for this object. + The hash code for the object the attribute belongs to. + + + Initializes the attribute using the specified names of tab classes and array of tab scopes. + An array of fully qualified type names of the types to create for tabs on the Properties window. + The scope of each tab. If the scope is , it is shown only for components with the corresponding . If it is , it is shown for all components on the document. + One or more of the values in is not or .-or-The length of the and arrays do not match.-or- or is null. + + + Initializes the attribute using the specified names of tab classes and array of tab scopes. + The types of tabs to create. + The scope of each tab. If the scope is , it is shown only for components with the corresponding . If it is , it is shown for all components on the document. + One or more of the values in is not or .-or-The length of the and arrays do not match.-or- or is null. + + + Gets the types of tabs that this attribute uses. + An array of types indicating the types of tabs that this attribute uses. + The types specified by the property could not be found. + + + + + + + Gets the names of the tab classes that this attribute uses. + The names of the tab classes that this attribute uses. + + + Gets an array of tab scopes of each tab of this . + An array of objects that indicate the scopes of the tabs. + + + Defines identifiers that indicate the persistence scope of a tab in the Properties window. + + + This tab is added to the Properties window and cannot be removed. + + + This tab is added to the Properties window and can only be removed explicitly by a parent component. + + + This tab is specific to the current document. This tab is added to the Properties window and is removed when the currently selected document changes. + + + This tab is specific to the current component. This tab is added to the Properties window for the current component only and is removed when the component is no longer selected. + + + Specifies the name of the property that an implementer of offers to other components. This class cannot be inherited + + + Initializes a new instance of the class with the name of the property and the type of its receiver. + The name of the property extending to an object of the specified type. + The name of the data type this property can extend. + + + Initializes a new instance of the class with the name of the property and its . + The name of the property extending to an object of the specified type. + The of the data type of the object that can receive the property. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current; otherwise, false. + The object to test the value equality of. + + + Returns the hash code for this instance. + A hash code for the current . + + + Gets the name of a property that this class provides. + The name of a property that this class provides. + + + Gets the name of the data type this property can extend. + The name of the data type this property can extend. + + + Gets a unique identifier for this attribute. + An that is a unique identifier for the attribute. + + + Specifies whether the property this attribute is bound to is read-only or read/write. This class cannot be inherited + + + Initializes a new instance of the class. + true to show that the property this attribute is bound to is read-only; false to show that the property is read/write. + + + Specifies the default value for the , which is (that is, the property this attribute is bound to is read/write). This static field is read-only. + + + Indicates whether this instance and a specified object are equal. + true if is equal to this instance; otherwise, false. + Another object to compare to. + + + Returns the hash code for this instance. + A hash code for the current . + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + Gets a value indicating whether the property this attribute is bound to is read-only. + true if the property this attribute is bound to is read-only; false if the property is read/write. + + + Specifies that the property this attribute is bound to is read/write and can be modified. This static field is read-only. + + + Specifies that the property this attribute is bound to is read-only and cannot be modified in the server explorer. This static field is read-only. + + + Specifies that the property can be used as an application setting. + + + Initializes a new instance of the class. + true if the property this attribute is bound to can be used as an application setting; otherwise, false. + + + Specifies the default value for the , which is . This static field is read-only. + + + Indicates whether this instance and a specified object are equal. + true if is equal to this instance; otherwise, false. + Another object to compare to. + + + Returns the hash code for this instance. + A hash code for the current . + + + Indicates whether the value of this instance is the default value for the class. + true if this instance is the default attribute for the class; otherwise, false. + + + Specifies that a property cannot be used as an application setting. This static field is read-only. + + + Gets a value indicating whether the property this attribute is bound to can be used as an application setting. + true if the property this attribute is bound to can be used as an application setting; otherwise, false. + + + Specifies that a property can be used as an application setting. This static field is read-only. + + + Provides a type converter to convert object references to and from other representations. + + + Initializes a new instance of the class. + A that represents the type to associate with this reference converter. + + + Gets a value indicating whether this converter can convert an object in the given source type to a reference object using the specified context. + true if this object can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert from. + + + Converts the given object to the reference type. + An that represents the converted . + An that provides a format context. + A that specifies the culture used to represent the font. + The to convert. + The conversion cannot be performed. + + + Converts the given value object to the reference type using the specified context and arguments. + The converted object. + An that provides a format context. + A that specifies the culture used to represent the font. + The to convert. + The type to convert the object to. + + is null. + The conversion cannot be performed. + + + Gets a collection of standard values for the reference data type. + A that holds a standard set of valid values, or null if the data type does not support a standard set of values. + An that provides a format context. + + + Gets a value indicating whether the list of standard values returned from is an exclusive list. + true because the returned from is an exhaustive list of possible values. This method never returns false. + An that provides a format context. + + + Gets a value indicating whether this object supports a standard set of values that can be picked from a list. + true because can be called to find a common set of values the object supports. This method never returns false. + An that provides a format context. + + + Returns a value indicating whether a particular value can be added to the standard values collection. + true if the value is allowed and can be added to the standard values collection; false if the value cannot be added to the standard values collection. + An that provides an additional context. + The value to check. + + + Provides data for the event. + + + Initializes a new instance of the class with the component that has changed. + The component that changed. + + + Initializes a new instance of the class with the type of component that has changed. + The that changed. + + + Gets the component that changed its properties, events, or extenders. + The component that changed its properties, events, or extenders, or null if all components of the same type have changed. + + + Gets the that changed its properties or events. + The that changed its properties or events. + + + Represents the method that handles the event raised when a or component is changed during design time. + A that contains the component or that changed. + + + Defines identifiers that indicate the type of a refresh of the Properties window. + + + No refresh is necessary. + + + The properties should be requeried and the view should be refreshed. + + + The view should be refreshed. + + + Indicates that the property grid should refresh when the associated property value changes. This class cannot be inherited. + + + Initializes a new instance of the class. + A value indicating the nature of the refresh. + + + Indicates that all properties are queried again and refreshed if the property value is changed. This field is read-only. + + + Indicates that no other properties are refreshed if the property value is changed. This field is read-only. + + + Overrides the object's method. + true if the specified object is the same; otherwise, false. + The object to test for equality. + + + Returns the hash code for this object. + The hash code for the object that the attribute belongs to. + + + Gets a value indicating whether the current value of the attribute is the default value for the attribute. + true if the current value of the attribute is the default; otherwise, false. + + + Gets the refresh properties for the member. + A that indicates the current refresh properties for the member. + + + Indicates that all properties are repainted if the property value is changed. This field is read-only. + + + Specifies whether the Visual Studio Custom Action Installer or the Installutil.exe (Installer Tool) should be invoked when the assembly is installed. + + + Initializes a new instance of the class. + true if an installer should be invoked during installation of an assembly; otherwise, false. + + + Specifies the default visiblity, which is . This static field is read-only. + + + Determines whether the value of the specified is equivalent to the current . + true if the specified is equal to the current ; otherwise, false. + The object to compare. + + + Generates a hash code for the current . + A hash code for the current . + + + Determines if this attribute is the default. + true if the attribute is the default value for this attribute class; otherwise, false. + + + Specifies that the Visual Studio Custom Action Installer or the Installutil.exe (Installer Tool) should not be invoked when the assembly is installed. This static field is read-only. + + + Gets a value indicating whether an installer should be invoked during installation of an assembly. + true if an installer should be invoked during installation of an assembly; otherwise, false. + + + Specifies that the Visual Studio Custom Action Installer or the Installutil.exe (Installer Tool) should be invoked when the assembly is installed. This static field is read-only. + + + Provides data for the MethodNameCompleted event. + + + Initializes a new instance of the class. + The result of an asynchronous operation. + Any error that occurred during the asynchronous operation. + A value indicating whether the asynchronous operation was canceled. + + + Gets a value that represents the result of an asynchronous operation. + An representing the result of an asynchronous operation. + + is not null. The property holds a reference to . + + is true. + + + + + + Gets a value that represents the user state. + An representing the user state. + + + Represents the method that will handle the event of a class. + The source of the event. + A that contains the event data. + + + Provides a type converter to convert 8-bit unsigned integer objects to and from a string. + + + Initializes a new instance of the class. + + + Specifies when a component property can be bound to an application setting. + + + Initializes a new instance of the class. + true to specify that a property is appropriate to bind settings to; otherwise, false. + + + Gets a value indicating whether a property is appropriate to bind settings to. + true if the property is appropriate to bind settings to; otherwise, false. + + + Determines whether two objects are equal. + true if equals the type and value of this instance; otherwise, false. + The value to compare to. + + + A 32-bit signed integer hash code. + + + Specifies that a property is not appropriate to bind settings to. + + + Specifies that a property is appropriate to bind settings to. + + + Provides a type converter to convert single-precision, floating point number objects to and from various other representations. + + + Initializes a new instance of the class. + + + Provides a type converter to convert string objects to and from other representations. + + + Initializes a new instance of the class. + + + Gets a value indicating whether this converter can convert an object in the given source type to a string using the specified context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert from. + + + Converts the specified value object to a object. + An that represents the converted value. + An that provides a format context. + The to use. + The to convert. + The conversion could not be performed. + + + Provides methods to verify the machine name and path conform to a specific syntax. This class cannot be inherited. + + + Checks the syntax of the machine name to confirm that it does not contain "\". + true if matches the proper machine name format; otherwise, false. + A string containing the machine name to check. + + + Checks the syntax of the path to see whether it starts with "\\". + true if matches the proper path format; otherwise, false. + A string containing the path to check. + + + Checks the syntax of the path to see if it starts with "\" or drive letter "C:". + true if matches the proper path format; otherwise, false. + A string containing the path to check. + + + Provides a type converter to convert objects to and from other representations. + + + Initializes a new instance of the class. + + + Gets a value indicating whether this converter can convert an object in the given source type to a using the specified context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert from. + + + Gets a value indicating whether this converter can convert an object to the given destination type using the context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert to. + + is null. + + is not a valid value for the target type. + + + Converts the given object to a . + An that represents the converted value. + An that provides a format context. + An optional . If not supplied, the current culture is assumed. + The to convert. + The conversion cannot be performed. + + is not a valid value for the target type. + + + Converts the given object to another type. + The converted object. + A formatter context. + The culture into which will be converted. + The object to convert. + The type to convert the object to. + + + Represents an attribute of a toolbox item. + + + Initializes a new instance of the class and specifies whether to use default initialization values. + true to create a toolbox item attribute for a default type; false to associate no default toolbox item support for this attribute. + + + Initializes a new instance of the class using the specified name of the type. + The names of the type of the toolbox item and of the assembly that contains the type. + + + Initializes a new instance of the class using the specified type of the toolbox item. + The type of the toolbox item. + + + Initializes a new instance of the class and sets the type to the default, . This field is read-only. + + + The object to compare. + + + + Gets a value indicating whether the current value of the attribute is the default value for the attribute. + true if the current value of the attribute is the default; otherwise, false. + + + Initializes a new instance of the class and sets the type to null. This field is read-only. + + + Gets or sets the type of the toolbox item. + The type of the toolbox item. + The type cannot be found. + + + + + + Gets or sets the name of the type of the current . + The fully qualified type name of the current toolbox item. + + + Specifies the filter string and filter type to use for a toolbox item. + + + Initializes a new instance of the class using the specified filter string. + The filter string for the toolbox item. + + + Initializes a new instance of the class using the specified filter string and type. + The filter string for the toolbox item. + A indicating the type of the filter. + + + The object to compare. + + + Gets the filter string for the toolbox item. + The filter string for the toolbox item. + + + Gets the type of the filter. + A that indicates the type of the filter. + + + + Indicates whether the specified object has a matching filter string. + true if the specified object has a matching filter string; otherwise, false. + The object to test for a matching filter string. + + + + Gets the type ID for the attribute. + The type ID for this attribute. All objects with the same filter string return the same type ID. + + + Defines identifiers used to indicate the type of filter that a uses. + + + Indicates that a toolbox item filter string is allowed, but not required. + + + Indicates that custom processing is required to determine whether to use a toolbox item filter string. + + + Indicates that a toolbox item filter string is not allowed. + + + Indicates that a toolbox item filter string must be present for a toolbox item to be enabled. + + + Provides a unified way of converting types of values to other types, as well as for accessing standard values and subproperties. + + + Initializes a new instance of the class. + + + Returns whether this converter can convert an object of the given type to the type of this converter, using the specified context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you want to convert from. + + + Returns whether this converter can convert an object of the given type to the type of this converter. + true if this converter can perform the conversion; otherwise, false. + A that represents the type you want to convert from. + + + Returns whether this converter can convert the object to the specified type, using the specified context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you want to convert to. + + + Returns whether this converter can convert the object to the specified type. + true if this converter can perform the conversion; otherwise, false. + A that represents the type you want to convert to. + + + Converts the given object to the type of this converter, using the specified context and culture information. + An that represents the converted value. + An that provides a format context. + The to use as the current culture. + The to convert. + The conversion cannot be performed. + + + Converts the given value to the type of this converter. + An that represents the converted value. + The to convert. + The conversion cannot be performed. + + + Converts the given string to the type of this converter, using the invariant culture and the specified context. + An that represents the converted text. + An that provides a format context. + The to convert. + The conversion cannot be performed. + + + Converts the given string to the type of this converter, using the invariant culture. + An that represents the converted text. + The to convert. + The conversion cannot be performed. + + + Converts the given text to an object, using the specified context and culture information. + An that represents the converted text. + An that provides a format context. + A . If null is passed, the current culture is assumed. + The to convert. + The conversion cannot be performed. + + + Converts the given text to an object, using the specified context. + An that represents the converted text. + An that provides a format context. + The to convert. + The conversion cannot be performed. + + + Converts the specified text to an object. + An that represents the converted text. + The text representation of the object to convert. + The string cannot be converted into the appropriate object. + + + Converts the given value object to the specified type, using the specified context and culture information. + An that represents the converted value. + An that provides a format context. + A . If null is passed, the current culture is assumed. + The to convert. + The to convert the parameter to. + The parameter is null. + The conversion cannot be performed. + + + Converts the given value object to the specified type, using the arguments. + An that represents the converted value. + The to convert. + The to convert the parameter to. + The parameter is null. + The conversion cannot be performed. + + + Converts the specified value to a culture-invariant string representation, using the specified context. + A that represents the converted value. + An that provides a format context. + The to convert. + The conversion cannot be performed. + + + Converts the specified value to a culture-invariant string representation. + A that represents the converted value. + The to convert. + The conversion cannot be performed. + + + Converts the given value to a string representation, using the specified context and culture information. + An that represents the converted value. + An that provides a format context. + A . If null is passed, the current culture is assumed. + The to convert. + The conversion cannot be performed. + + + Converts the given value to a string representation, using the given context. + An that represents the converted value. + An that provides a format context. + The to convert. + The conversion cannot be performed. + + + Converts the specified value to a string representation. + An that represents the converted value. + The to convert. + The conversion cannot be performed. + + + Re-creates an given a set of property values for the object. + An representing the given , or null if the object cannot be created. This method always returns null. + An that represents a dictionary of new property values. + + + Creates an instance of the type that this is associated with, using the specified context, given a set of property values for the object. + An representing the given , or null if the object cannot be created. This method always returns null. + An that provides a format context. + An of new property values. + + + Returns an exception to throw when a conversion cannot be performed. + An that represents the exception to throw when a conversion cannot be performed. + The to convert, or null if the object is not available. + Automatically thrown by this method. + + + Returns an exception to throw when a conversion cannot be performed. + An that represents the exception to throw when a conversion cannot be performed. + The to convert, or null if the object is not available. + A that represents the type the conversion was trying to convert to. + Automatically thrown by this method. + + + Returns whether changing a value on this object requires a call to the method to create a new value. + true if changing a property on this object requires a call to to create a new value; otherwise, false. + + + Returns whether changing a value on this object requires a call to to create a new value, using the specified context. + true if changing a property on this object requires a call to to create a new value; otherwise, false. + An that provides a format context. + + + Returns a collection of properties for the type of array specified by the value parameter, using the specified context. + A with the properties that are exposed for this data type, or null if there are no properties. + An that provides a format context. + An that specifies the type of array for which to get properties. + + + Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes. + A with the properties that are exposed for this data type, or null if there are no properties. + An that provides a format context. + An that specifies the type of array for which to get properties. + An array of type that is used as a filter. + + + Returns a collection of properties for the type of array specified by the value parameter. + A with the properties that are exposed for this data type, or null if there are no properties. + An that specifies the type of array for which to get properties. + + + Returns whether this object supports properties. + true if should be called to find the properties of this object; otherwise, false. + + + Returns whether this object supports properties, using the specified context. + true if should be called to find the properties of this object; otherwise, false. + An that provides a format context. + + + Returns a collection of standard values from the default context for the data type this type converter is designed for. + A containing a standard set of valid values, or null if the data type does not support a standard set of values. + + + Returns a collection of standard values for the data type this type converter is designed for when provided with a format context. + A that holds a standard set of valid values, or null if the data type does not support a standard set of values. + An that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null. + + + Returns whether the collection of standard values returned from is an exclusive list. + true if the returned from is an exhaustive list of possible values; false if other values are possible. + + + Returns whether the collection of standard values returned from is an exclusive list of possible values, using the specified context. + true if the returned from is an exhaustive list of possible values; false if other values are possible. + An that provides a format context. + + + Returns whether this object supports a standard set of values that can be picked from a list. + true if should be called to find a common set of values the object supports; otherwise, false. + + + Returns whether this object supports a standard set of values that can be picked from a list, using the specified context. + true if should be called to find a common set of values the object supports; otherwise, false. + An that provides a format context. + + + Returns whether the given value object is valid for this type and for the specified context. + true if the specified value is valid for this object; otherwise, false. + An that provides a format context. + The to test for validity. + + + Returns whether the given value object is valid for this type. + true if the specified value is valid for this object; otherwise, false. + The object to test for validity. + + + Sorts a collection of properties. + A that contains the sorted properties. + A that has the properties to sort. + An array of names in the order you want the properties to appear in the collection. + + + Represents an abstract class that provides properties for objects that do not have properties. + + + Initializes a new instance of the class. + A that represents the type of component to which this property descriptor binds. + The name of the property. + A that represents the data type for this property. + + + Initializes a new instance of the class. + A that represents the type of component to which this property descriptor binds. + The name of the property. + A that represents the data type for this property. + An array with the attributes to associate with the property. + + + Returns whether resetting the component changes the value of the component. + true if resetting the component changes the value of the component; otherwise, false. + The component to test for reset capability. + + + Gets the type of component to which this property description binds. + A that represents the type of component to which this property binds. + + + Gets a value indicating whether this property is read-only. + true if the property is read-only; false if the property is read/write. + + + Gets the type of the property. + A that represents the type of the property. + + + Resets the value for this property of the component. + The component with the property value to be reset. + + + Returns whether the value of this property can persist. + true if the value of the property can persist; otherwise, false. + The component with the property that is to be examined for persistence. + + + Represents a collection of values. + + + Initializes a new instance of the class. + An that represents the objects to put into the collection. + + + Copies the contents of this collection to an array. + An that represents the array to copy to. + The index to start from. + + + Gets the number of objects in the collection. + The number of objects in the collection. + + + Returns an enumerator for this collection. + An enumerator of type . + + + Gets the object at the specified index number. + The with the specified index. + The zero-based index of the to get from the collection. + + + Copies the contents of this collection to an array. + The array to copy to. + The index in the array where copying should begin. + + + For a description of this member, see . + The number of elements contained in the . + + + For a description of this member, see . + false in all cases. + + + For a description of this member, see . + null in all cases. + + + For a description of this member, see . + An that can be used to iterate through the collection. + + + Specifies what type to use as a converter for the object this attribute is bound to. + + + Initializes a new instance of the class with the default type converter, which is an empty string (""). + + + Initializes a new instance of the class, using the specified type name as the data converter for the object this attribute is bound to. + The fully qualified name of the class to use for data conversion for the object this attribute is bound to. + + + Initializes a new instance of the class, using the specified type as the data converter for the object this attribute is bound to. + A that represents the type of the converter class to use for data conversion for the object this attribute is bound to. + + + Gets the fully qualified type name of the to use as a converter for the object this attribute is bound to. + The fully qualified type name of the to use as a converter for the object this attribute is bound to, or an empty string ("") if none exists. The default value is an empty string (""). + + + Specifies the type to use as a converter for the object this attribute is bound to. + + + Returns whether the value of the given object is equal to the current . + true if the value of the given object is equal to that of the current ; otherwise, false. + The object to test the value equality of. + + + Returns the hash code for this instance. + A hash code for the current . + + + Provides supplemental metadata to the . + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using a parent type description provider. + The parent type description provider. + + + Creates an object that can substitute for another data type. + The substitute . + An optional service provider. + The type of object to create. This parameter is never null. + An optional array of types that represent the parameter types to be passed to the object's constructor. This array can be null or of zero length. + An optional array of parameter values to pass to the object's constructor. + + + Gets a per-object cache, accessed as an of key/value pairs. + An if the provided object supports caching; otherwise, null. + The object for which to get the cache. + + + Gets an extended custom type descriptor for the given object. + An that can provide extended metadata for the object. + The object for which to get the extended type descriptor. + + + Gets the extender providers for the specified object. + An array of extender providers for . + The object to get extender providers for. + + is null. + + + Gets the name of the specified component, or null if the component has no name. + The name of the specified component. + The specified component. + + is null. + + + Performs normal reflection against the given object. + A . + An instance of the type (should not be null). + + is null. + + + Performs normal reflection against a type. + A . + The type of object for which to retrieve the . + + is null. + + + Performs normal reflection against the given object with the given type. + A . + The type of object for which to retrieve the . + An instance of the type. Can be null. + + + Converts a reflection type into a runtime type. + A that represents the runtime equivalent of . + The type to convert to its runtime equivalent. + + is null. + + + Gets a custom type descriptor for the given object. + An that can provide metadata for the type. + An instance of the type. Can be null if no instance was passed to the . + + is null. + + + Gets a custom type descriptor for the given type. + An that can provide metadata for the type. + The type of object for which to retrieve the type descriptor. + + + Gets a custom type descriptor for the given type and object. + An that can provide metadata for the type. + The type of object for which to retrieve the type descriptor. + An instance of the type. Can be null if no instance was passed to the . + + + Gets a value that indicates whether the specified type is compatible with the type description and its chain of type description providers. + true if is compatible with the type description and its chain of type description providers; otherwise, false. + The type to test for compatibility. + + is null. + + + Specifies the custom type description provider for a class. This class cannot be inherited. + + + Initializes a new instance of the class using the specified type name. + The qualified name of the type. + + is null. + + + Initializes a new instance of the class using the specified type. + The type to store in the attribute. + + is null. + + + Gets the type name for the type description provider. + A containing the qualified type name for the . + + + Provides information about the characteristics for a component, such as its attributes, properties, and events. This class cannot be inherited. + + + Adds class-level attributes to the target component instance. + The newly created that was used to add the specified attributes. + An instance of the target component. + An array of objects to add to the component's class. + One or both of the parameters is null. + + + Adds class-level attributes to the target component type. + The newly created that was used to add the specified attributes. + The of the target component. + An array of objects to add to the component's class. + One or both of the parameters is null. + + + Adds an editor table for the given editor base type. + The editor base type to add the editor table for. If a table already exists for this type, this method will do nothing. + The to add. + + + Adds a type description provider for a single instance of a component. + The to add. + An instance of the target component. + One or both of the parameters are null. + + + Adds a type description provider for a component class. + The to add. + The of the target component. + One or both of the parameters are null. + + + Adds a type description provider for a single instance of a component. + The to add. + An instance of the target component. + One or both of the parameters are null. + + + Adds a type description provider for a component class. + The to add. + The of the target component. + One or both of the parameters are null. + + + Gets or sets the provider for the Component Object Model (COM) type information for the target component. + An instance representing the COM type information provider. + + + Gets the type of the Component Object Model (COM) object represented by the target component. + The of the COM object represented by this component, or null for non-COM objects. + + + Creates a primary-secondary association between two objects. + The primary . + The secondary . + One or both of the parameters are null. + + is equal to . + + + Creates an instance of the designer associated with the specified component and of the specified type of designer. + An that is an instance of the designer for the component, or null if no designer can be found. + An that specifies the component to associate with the designer. + A that represents the type of designer to create. + + + Creates a new event descriptor that is identical to an existing event descriptor, when passed the existing . + A new that has merged the specified metadata attributes with the existing metadata attributes. + The type of the component for which to create the new event. + The existing event information. + The new attributes. + + + + + + Creates a new event descriptor that is identical to an existing event descriptor by dynamically generating descriptor information from a specified event on a type. + An that is bound to a type. + The type of the component the event lives on. + The name of the event. + The type of the delegate that handles the event. + The attributes for this event. + + + + + + Creates an object that can substitute for another data type. + An instance of the substitute data type if an associated is found; otherwise, null. + The service provider that provides a service. This parameter can be null. + The of object to create. + An optional array of parameter types to be passed to the object's constructor. This parameter can be null or an array of zero length. + An optional array of parameter values to pass to the object's constructor. If not null, the number of elements must be the same as . + + is null, or is null when is not null. + + and have different number of elements. + + + Creates a new property descriptor from an existing property descriptor, using the specified existing and attribute array. + A new that has the specified metadata attributes merged with the existing metadata attributes. + The of the component that the property is a member of. + The existing property descriptor. + The new attributes for this property. + + + + + + Creates and dynamically binds a property descriptor to a type, using the specified property name, type, and attribute array. + A that is bound to the specified type and that has the specified metadata attributes merged with the existing metadata attributes. + The of the component that the property is a member of. + The name of the property. + The of the property. + The new attributes for this property. + + + + + + Returns an instance of the type associated with the specified primary object. + An instance of the secondary type that has been associated with the primary object if an association exists; otherwise, if no specified association exists. + The of the target component. + The primary object of the association. + One or both of the parameters are null. + + + Returns the collection of attributes for the specified component. + An containing the attributes for the component. If is null, this method returns an empty collection. + The component for which you want to get attributes. + + + Returns a collection of attributes for the specified component and a Boolean indicating that a custom type descriptor has been created. + An with the attributes for the component. If the component is null, this method returns an empty collection. + The component for which you want to get attributes. + true to use a baseline set of attributes from the custom type descriptor if is of type ; otherwise, false. + + + Returns a collection of attributes for the specified type of component. + An with the attributes for the type of the component. If the component is null, this method returns an empty collection. + The of the target component. + + + Returns the name of the class for the specified component using the default type descriptor. + A containing the name of the class for the specified component. + The for which you want the class name. + + is null. + + + Returns the name of the class for the specified component using a custom type descriptor. + A containing the name of the class for the specified component. + The for which you want the class name. + true to consider custom type description information; otherwise, false. + + is null. + + is a cross-process remoted object. + + + Returns the name of the class for the specified type. + A containing the name of the class for the specified component type. + The of the target component. + + is null. + + + Returns the name of the specified component using the default type descriptor. + A containing the name of the specified component, or null if there is no component name. + The for which you want the class name. + + is null. + + is a cross-process remoted object. + + + Returns the name of the specified component using a custom type descriptor. + The name of the class for the specified component, or null if there is no component name. + The for which you want the class name. + true to consider custom type description information; otherwise, false. + + is null. + + is a cross-process remoted object. + + + Returns a type converter for the type of the specified component. + A for the specified component. + A component to get the converter for. + + is null. + + is a cross-process remoted object. + + + Returns a type converter for the type of the specified component with a custom type descriptor. + A for the specified component. + A component to get the converter for. + true to consider custom type description information; otherwise, false. + + is null. + + is a cross-process remoted object. + + + Returns a type converter for the specified type. + A for the specified type. + The of the target component. + + is null. + + + Returns the default event for the specified component. + An with the default event, or null if there are no events. + The component to get the event for. + + is null. + + is a cross-process remoted object. + + + Returns the default event for a component with a custom type descriptor. + An with the default event, or null if there are no events. + The component to get the event for. + true to consider custom type description information; otherwise, false. + + is null. + + is a cross-process remoted object. + + + Returns the default event for the specified type of component. + An with the default event, or null if there are no events. + The of the target component. + + is null. + + + Returns the default property for the specified component. + A with the default property, or null if there are no properties. + The component to get the default property for. + + is a cross-process remoted object. + + + Returns the default property for the specified component with a custom type descriptor. + A with the default property, or null if there are no properties. + The component to get the default property for. + true to consider custom type description information; otherwise, false. + + is a cross-process remoted object. + + + Returns the default property for the specified type of component. + A with the default property, or null if there are no properties. + A that represents the class to get the property for. + + + Gets an editor with the specified base type for the specified component. + An instance of the editor that can be cast to the specified editor type, or null if no editor of the requested type can be found. + The component to get the editor for. + A that represents the base type of the editor you want to find. + + or is null. + + is a cross-process remoted object. + + + Returns an editor with the specified base type and with a custom type descriptor for the specified component. + An instance of the editor that can be cast to the specified editor type, or null if no editor of the requested type can be found. + The component to get the editor for. + A that represents the base type of the editor you want to find. + A flag indicating whether custom type description information should be considered. + + or is null. + + is a cross-process remoted object. + + + Returns an editor with the specified base type for the specified type. + An instance of the editor object that can be cast to the given base type, or null if no editor of the requested type can be found. + The of the target component. + A that represents the base type of the editor you are trying to find. + + or is null. + + + Returns the collection of events for the specified component. + An with the events for this component. + A component to get the events for. + + is a cross-process remoted object. + + + Returns the collection of events for a specified component using a specified array of attributes as a filter. + An with the events that match the specified attributes for this component. + A component to get the events for. + An array of type that you can use as a filter. + + is a cross-process remoted object. + + + Returns the collection of events for a specified component using a specified array of attributes as a filter and using a custom type descriptor. + An with the events that match the specified attributes for this component. + A component to get the events for. + An array of type to use as a filter. + true to consider custom type description information; otherwise, false. + + is a cross-process remoted object. + + + Returns the collection of events for a specified component with a custom type descriptor. + An with the events for this component. + A component to get the events for. + true to consider custom type description information; otherwise, false. + + is a cross-process remoted object. + + + Returns the collection of events for a specified type of component. + An with the events for this component. + The of the target component. + + + Returns the collection of events for a specified type of component using a specified array of attributes as a filter. + An with the events that match the specified attributes for this component. + The of the target component. + An array of type that you can use as a filter. + + + Returns the fully qualified name of the component. + The fully qualified name of the specified component, or null if the component has no name. + The to find the name for. + + is null. + + + Returns the collection of properties for a specified component. + A with the properties for the specified component. + A component to get the properties for. + + is a cross-process remoted object. + + + Returns the collection of properties for a specified component using a specified array of attributes as a filter. + A with the properties that match the specified attributes for the specified component. + A component to get the properties for. + An array of type to use as a filter. + + is a cross-process remoted object. + + + Returns the collection of properties for a specified component using a specified array of attributes as a filter and using a custom type descriptor. + A with the events that match the specified attributes for the specified component. + A component to get the properties for. + An array of type to use as a filter. + true to consider custom type description information; otherwise, false. + + is a cross-process remoted object. + + + Returns the collection of properties for a specified component using the default type descriptor. + A with the properties for a specified component. + A component to get the properties for. + true to not consider custom type description information; otherwise, false. + + is a cross-process remoted object. + + + Returns the collection of properties for a specified type of component. + A with the properties for a specified type of component. + A that represents the component to get properties for. + + + Returns the collection of properties for a specified type of component using a specified array of attributes as a filter. + A with the properties that match the specified attributes for this type of component. + The of the target component. + An array of type to use as a filter. + + + Returns the type description provider for the specified component. + A associated with the specified component. + An instance of the target component. + + is null. + + + Returns the type description provider for the specified type. + A associated with the specified type. + The of the target component. + + is null. + + + Returns a that can be used to perform reflection, given an object. + A for the specified object. + An instance of the target component. + + is null. + + + Returns a that can be used to perform reflection, given a class type. + A of the specified class. + The of the target component. + + is null. + + + Gets a type that represents a type description provider for all interface types. + A that represents a custom type description provider for all interface types. + + + Clears the properties and events for the specified component from the cache. + A component for which the properties or events have changed. + + + Clears the properties and events for the specified assembly from the cache. + The that represents the assembly to refresh. Each in this assembly will be refreshed. + + + Clears the properties and events for the specified module from the cache. + The that represents the module to refresh. Each in this module will be refreshed. + + + Clears the properties and events for the specified type of component from the cache. + The of the target component. + + + Occurs when the cache for a component is cleared. + + + Removes an association between two objects. + The primary . + The secondary . + One or both of the parameters are null. + + + Removes all associations for a primary object. + The primary in an association. + + is null. + + + Removes a previously added type description provider that is associated with the specified object. + The to remove. + An instance of the target component. + One or both of the parameters are null. + + + Removes a previously added type description provider that is associated with the specified type. + The to remove. + The of the target component. + One or both of the parameters are null. + + + Removes a previously added type description provider that is associated with the specified object. + The to remove. + An instance of the target component. + One or both of the parameters are null. + + + Removes a previously added type description provider that is associated with the specified type. + The to remove. + The of the target component. + One or both of the parameters are null. + + + Sorts descriptors using the name of the descriptor. + An that contains the descriptors to sort. + + is null. + + + Provides a type converter that can be used to populate a list box with available types. + + + Initializes a new instance of the class using the type array as the available types. + The array of type to use as the available types. + + + Gets a value indicating whether this converter can convert the specified of the source object using the given context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + The of the source object. + + + Gets a value indicating whether this converter can convert an object to the given destination type using the context. + true if this converter can perform the conversion; otherwise, false. + An that provides a format context. + A that represents the type you wish to convert to. + + + Converts the specified object to the native type of the converter. + An that represents the converted value. + An that provides a format context. + A that specifies the culture used to represent the font. + The to convert. + + + Converts the given value object to the specified destination type. + An that represents the converted . + An that provides a format context. + An optional . If not supplied, the current culture is assumed. + The to convert. + The to convert the value to. + + is null. + The conversion cannot be performed. + + + Gets a collection of standard values for the data type this validator is designed for. + A that holds a standard set of valid values, or null if the data type does not support a standard set of values. + An that provides a format context. + + + Gets a value indicating whether the list of standard values returned from the method is an exclusive list. + true because the returned from is an exhaustive list of possible values. This method never returns false. + An that provides a format context. + + + Gets a value indicating whether this object supports a standard set of values that can be picked from a list using the specified context. + true because should be called to find a common set of values the object supports. This method never returns false. + An that provides a format context. + + + Provides a type converter to convert 16-bit unsigned integer objects to and from other representations. + + + Initializes a new instance of the class. + + + Provides a type converter to convert 32-bit unsigned integer objects to and from various other representations. + + + Initializes a new instance of the class. + + + Provides a type converter to convert 64-bit unsigned integer objects to and from other representations. + + + Initializes a new instance of the class. + + + Specifies an exception that is handled as a warning instead of an error. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified serialization data and context. + The to be used for deserialization. + The destination to be used for deserialization. + + + Initializes a new instance of the class with the specified message and no Help file. + The message to display to the end user. + + + Initializes a new instance of the class with the specified detailed description and the specified exception. + A detailed description of the error. + A reference to the inner exception that is the cause of this exception. + + + Initializes a new instance of the class with the specified message, and with access to the specified Help file. + The message to display to the end user. + The Help file to display if the user requests help. + + + Initializes a new instance of the class with the specified message, and with access to the specified Help file and topic. + The message to display to the end user. + The Help file to display if the user requests help. + The Help topic to display if the user requests help. + + + Sets the with the parameter name and additional exception information. + Stores the data that was being used to serialize or deserialize the object that the was serializing or deserializing. + Describes the source and destination of the stream that generated the exception, as well as a means for serialization to retain that context and an additional caller-defined context. + + is null. + + + Gets the Help topic associated with the warning. + The Help topic associated with the warning. + + + Gets the Help file associated with the warning. + The Help file associated with the warning. + + + Throws an exception for a Win32 error code. + + + Initializes a new instance of the class with the last Win32 error that occurred. + + + Initializes a new instance of the class with the specified error. + The Win32 error code associated with this exception. + + + Initializes a new instance of the class with the specified error and the specified detailed description. + The Win32 error code associated with this exception. + A detailed description of the error. + + + Initializes a new instance of the class with the specified context and the serialization information. + The associated with this exception. + A that represents the context of this exception. + + + Initializes a new instance of the class with the specified detailed description. + A detailed description of the error. + + + Initializes a new instance of the class with the specified detailed description and the specified exception. + A detailed description of the error. + A reference to the inner exception that is the cause of this exception. + + + Sets the object with the file name and line number at which this occurred. + A . + The contextual information about the source or destination. + + is null. + + + Gets the Win32 error code associated with this exception. + The Win32 error code associated with this exception. + + + Provides data for the event. + + + Initializes a new instance of the class. + The document that is losing activation. + The document that is gaining activation. + + + Gets the document that is gaining activation. + An that represents the document gaining activation. + + + Gets the document that is losing activation. + An that represents the document losing activation. + + + Represents the method that will handle the event. + The source of the event. + An that contains the event data. + + + The exception that is thrown when an attempt to check out a file that is checked into a source code management program is canceled or fails. + + + Initializes a new instance of the class with no associated message or error code. + + + Initializes a new instance of the class using the specified serialization data and context. + The to be used for deserialization. + The destination to be used for deserialization. + + + Initializes a new instance of the class with the specified message. + A message describing the exception. + + + Initializes a new instance of the class with the specified detailed description and the specified exception. + A detailed description of the error. + A reference to the inner exception that is the cause of this exception. + + + Initializes a new instance of the class with the specified message and error code. + A message describing the exception. + The error code to pass. + + + Initializes a new instance of the class that specifies that the check out was canceled. This field is read-only. + + + Represents a unique command identifier that consists of a numeric command ID and a GUID menu group identifier. + + + Initializes a new instance of the class using the specified menu group GUID and command ID number. + The GUID of the group that this menu command belongs to. + The numeric identifier of this menu command. + + + Determines whether two instances are equal. + true if the specified object is equivalent to this one; otherwise, false. + The object to compare. + + + A hash code for the current . + + + Gets the GUID of the menu group that the menu command identified by this belongs to. + The GUID of the command group for this command. + + + Gets the numeric command ID. + The command ID number. + + + Returns a that represents the current object. + A string that contains the command ID information, both the GUID and integer identifier. + + + Provides data for the event. This class cannot be inherited. + + + Initializes a new instance of the class. + The component that was changed. + A that represents the member that was changed. + The old value of the changed member. + The new value of the changed member. + + + Gets the component that was modified. + An that represents the component that was modified. + + + Gets the member that has been changed. + A that indicates the member that has been changed. + + + Gets the new value of the changed member. + The new value of the changed member. This property can be null. + + + Gets the old value of the changed member. + The old value of the changed member. This property can be null. + + + Represents the method that will handle a event. + The source of the event. + A that contains the event data. + + + Provides data for the event. This class cannot be inherited. + + + Initializes a new instance of the class. + The component that is about to be changed. + A indicating the member of the component that is about to be changed. + + + Gets the component that is about to be changed or the component that is the parent container of the member that is about to be changed. + The component that is about to have a member changed. + + + Gets the member that is about to be changed. + A indicating the member that is about to be changed, if known, or null otherwise. + + + Represents the method that will handle a event. + The source of the event. + A event that contains the event data. + + + Provides data for the , , , and events. + + + Initializes a new instance of the class. + The component that is the source of the event. + + + Gets the component associated with the event. + The component associated with the event. + + + Represents the method that will handle the , , , and events raised for component-level events. + The source of the event. + A that contains the event data. + + + Provides data for the event. + + + Initializes a new instance of the class. + The component to be renamed. + The old name of the component. + The new name of the component. + + + Gets the component that is being renamed. + The component that is being renamed. + + + Gets the name of the component after the rename event. + The name of the component after the rename event. + + + Gets the name of the component before the rename event. + The previous name of the component. + + + Represents the method that will handle a event. + The source of the event. + A that contains the event data. + + + Represents a collection of designers. + + + Initializes a new instance of the class that contains the specified set of designers. + A list that contains the collection of designers to add. + + + Initializes a new instance of the class that contains the specified designers. + An array of objects to store. + + + Gets the number of designers in the collection. + The number of designers in the collection. + + + Gets a new enumerator for this collection. + An that enumerates the collection. + + + Gets the designer at the specified index. + The designer at the specified index. + The index of the designer to return. + + + Copies the elements of the collection to an , starting at a particular index. + The one-dimensional that is the destination of the elements copied from collection. The must have zero-based indexing. + The zero-based index in at which copying begins. + + + Gets the number of elements contained in the collection. + The number of elements contained in the collection. + + + Gets a value indicating whether access to the is synchronized (thread safe). + true if access to the is synchronized (thread safe); otherwise, false. + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the collection. + + + Gets a new enumerator for this collection. + An that enumerates the collection. + + + Provides data for the and events. + + + Initializes a new instance of the class. + The of the document. + + + Gets the host of the document. + The of the document. + + + Represents the method that will handle the and events that are raised when a document is created or disposed of. + The source of the event. + A that contains the event data. + + + Provides a base class for getting and setting option values for a designer. + + + Initializes a new instance of the class. + + + Creates a new with the given name and adds it to the given parent. + A . + The parent designer option collection. All collections have a parent except the root object collection. + The name of this collection. + The object providing properties for this collection. Can be null if the collection should not provide any properties. + + or is null. + + is an empty string. + + + Gets the options collection for this service. + A populated with available designer options. + + + Populates a . + The collection to populate. + + + Shows the options dialog box for the given object. + true if the dialog box is shown; otherwise, false. + The options collection containing the object to be invoked. + The actual options object. + + + Gets the value of an option defined in this package. + The value of the option named . + The page to which the option is bound. + The name of the option value. + + or is null. + + + Sets the value of an option defined in this package. + The page to which the option is bound + The name of the option value. + The value of the option. + + or is null. + + + Contains a collection of designer options. This class cannot be inherited. + + + Copies the entire collection to a compatible one-dimensional , starting at the specified index of the target array. + The one-dimensional that is the destination of the elements copied from the collection. The must have zero-based indexing. + The zero-based index in at which copying begins. + + + Gets the number of child option collections this contains. + The number of child option collections this contains. + + + Returns an that can be used to iterate this collection. + An that can be used to iterate this collection. + + + Returns the index of the first occurrence of a given value in a range of this collection. + The index of the first occurrence of value within the entire collection, if found; otherwise, the lower bound of the collection minus 1. + The object to locate in the collection. + + + Gets the child collection at the given index. + The child collection at the specified index. + The zero-based index of the child collection to get. + + + Gets the child collection at the given name. + The child collection with the name specified by the parameter, or null if the name is not found. + The name of the child collection. + + + Gets the name of this . + The name of this . + + + Gets the parent collection object. + The parent collection object, or null if there is no parent. + + + Gets the collection of properties offered by this , along with all of its children. + The collection of properties offered by this , along with all of its children. + + + Displays a dialog box user interface (UI) with which the user can configure the options in this . + true if the dialog box can be displayed; otherwise, false. + + + Gets a value indicating whether access to the collection is synchronized and, therefore, thread safe. + true if the access to the collection is synchronized; otherwise, false. + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the collection. + + + Adds an item to the . + The position into which the new element was inserted. + The to add to the . + + + Removes all items from the collection. + + + Determines whether the collection contains a specific value. + true if the is found in the collection; otherwise, false. + The to locate in the collection + + + Determines the index of a specific item in the collection. + The index of if found in the list; otherwise, -1. + The to locate in the collection. + + + Inserts an item into the collection at the specified index. + The zero-based index at which should be inserted. + The to insert into the collection. + + + Gets a value indicating whether the collection has a fixed size. + true if the collection has a fixed size; otherwise, false. + + + Gets a value indicating whether the collection is read-only. + true if the collection is read-only; otherwise, false. + + + Gets or sets the element at the specified index. + The element at the specified index. + The zero-based index of the element to get or set. + + + Removes the first occurrence of a specific object from the collection. + The to remove from the collection. + + + Removes the collection item at the specified index. + The zero-based index of the item to remove. + + + Provides a way to group a series of design-time actions to improve performance and enable most types of changes to be undone. + + + Initializes a new instance of the class with no description. + + + Initializes a new instance of the class using the specified transaction description. + A description for this transaction. + + + Cancels the transaction and attempts to roll back the changes made by the events of the transaction. + + + Gets a value indicating whether the transaction was canceled. + true if the transaction was canceled; otherwise, false. + + + Commits this transaction. + + + Gets a value indicating whether the transaction was committed. + true if the transaction was committed; otherwise, false. + + + Gets a description for the transaction. + A description for the transaction. + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Releases the resources associated with this object. This override commits this transaction if it was not already committed. + + + Raises the Cancel event. + + + Performs the actual work of committing a transaction. + + + Releases all resources used by the . + + + Provides data for the and events. + + + Initializes a new instance of the class, using the specified value that indicates whether the designer called on the transaction. + A value indicating whether the transaction was committed. + + + Initializes a new instance of the class. + A value indicating whether the transaction was committed. + true if this is the last transaction to close; otherwise, false. + + + Gets a value indicating whether this is the last transaction to close. + true, if this is the last transaction to close; otherwise, false. + + + Indicates whether the designer called on the transaction. + true if the designer called on the transaction; otherwise, false. + + + Represents the method that handles the and events of a designer. + The source of the event. + A that contains the event data. + + + Represents a verb that can be invoked from a designer. + + + Initializes a new instance of the class. + The text of the menu command that is shown to the user. + The event handler that performs the actions of the verb. + + + Initializes a new instance of the class. + The text of the menu command that is shown to the user. + The event handler that performs the actions of the verb. + The starting command ID for this verb. By default, the designer architecture sets aside a range of command IDs for verbs. You can override this by providing a custom command ID. + + + Gets or sets the description of the menu item for the verb. + A string describing the menu item. + + + Gets the text description for the verb command on the menu. + A description for the verb command. + + + Overrides . + The verb's text, or an empty string ("") if the text field is empty. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified array of objects. + A array that indicates the verbs to contain within the collection. + + is null. + + + Adds the specified to the collection. + The index in the collection at which the verb was added. + The to add to the collection. + + + Adds the specified set of designer verbs to the collection. + An array of objects to add to the collection. + + is null. + + + Adds the specified collection of designer verbs to the collection. + A to add to the collection. + + is null. + + + Gets a value indicating whether the specified exists in the collection. + true if the specified object exists in the collection; otherwise, false. + The to search for in the collection. + + + Copies the collection members to the specified array beginning at the specified destination index. + The array to copy collection members to. + The destination index to begin copying to. + + + Gets the index of the specified . + The index of the specified object if it is found in the list; otherwise, -1. + The whose index to get in the collection. + + + Inserts the specified at the specified index. + The index in the collection at which to insert the verb. + The to insert in the collection. + + + Gets or sets the at the specified index. + A at each valid index in the collection. + The index at which to get or set the . + + + Raises the Clear event. + + + Raises the Insert event. + The index at which to insert an item. + The object to insert. + + + Raises the Remove event. + The index at which to remove the item. + The object to remove. + + + Raises the Set event. + The index at which to set the item. + The old object. + The new object. + + + Raises the Validate event. + The object to validate. + + + Removes the specified from the collection. + The to remove from the collection. + + + Represents a design-time license context that can support a license provider at design time. + + + Initializes a new instance of the class. + + + Gets a saved license key. + The saved license key that matches the specified type. + The type of the license key. + The assembly to get the key from. + + + Sets a saved license key. + The type of the license key. + The license key. + + + Gets the license usage mode. + A indicating the licensing mode for the context. + + + Provides support for design-time license context serialization. + + + Serializes the licenses within the specified design-time license context using the specified key and output stream. + The stream to output to. + The key to use for encryption. + A indicating the license context. + + + Defines identifiers that indicate information about the context in which a request for Help information originated. + + + A general context. + + + A window. + + + A selection. + + + A tool window selection. + + + Specifies the context keyword for a class or member. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + The Help keyword value. + + is null. + + + Initializes a new instance of the class from the given type. + The type from which the Help keyword will be taken. + + is null. + + + Represents the default value for . This field is read-only. + + + Determines whether two instances are equal. + true if the specified is equal to the current ; otherwise, false. + The to compare with the current . + + + Returns the hash code for this instance. + A hash code for the current . + + + Gets the Help keyword supplied by this attribute. + The Help keyword supplied by this attribute. + + + Determines whether the Help keyword is null. + true if the Help keyword is null; otherwise, false. + + + Defines identifiers that indicate the type of a Help keyword. + + + A keyword that F1 was pressed to request help about. + + + A general keyword. + + + A filter keyword. + + + Provides an interface to add and remove the event handlers for events that add, change, remove or rename components, and provides methods to raise a or event. + + + Occurs when a component has been added. + + + Occurs when a component is in the process of being added. + + + Occurs when a component has been changed. + + + Occurs when a component is in the process of being changed. + + + Occurs when a component has been removed. + + + Occurs when a component is in the process of being removed. + + + Occurs when a component is renamed. + + + Announces to the component change service that a particular component has changed. + The component that has changed. + The member that has changed. This is null if this change is not related to a single member. + The old value of the member. This is valid only if the member is not null. + The new value of the member. This is valid only if the member is not null. + + + Announces to the component change service that a particular component is changing. + The component that is about to change. + The member that is changing. This is null if this change is not related to a single member. + + + Enables enumeration of components at design time. + + + Gets the list of available component types. + The list of available component types. + The designer host providing design-time services. Can be null. + The base type specifying the components to retrieve. Can be null. + + + Provides a set of recommended default values during component creation. + + + Restores an instance of a component to its default state. + A dictionary of default property values, which are name/value pairs, with which to reset the component's state. + + + Initializes a new component using a set of recommended values. + A dictionary of default property values, which are name/value pairs, with which to initialize the component's state. + + + Provides the basic framework for building a custom designer. + + + Gets the base component that this designer is designing. + An indicating the base component that this designer is designing. + + + Performs the default action for this designer. + + + Initializes the designer with the specified component. + The component to associate with this designer. + + + Gets a collection of the design-time verbs supported by the designer. + A that contains the verbs supported by the designer, or null if the component has no verbs. + + + Provides event notifications when root designers are added and removed, when a selected component changes, and when the current root designer changes. + + + Gets the root designer for the currently active document. + The currently active document, or null if there is no active document. + + + Occurs when the current root designer changes. + + + Occurs when a root designer is created. + + + Occurs when a root designer for a document is disposed. + + + Gets a collection of root designers for design documents that are currently active in the development environment. + A containing the root designers that have been created and not yet disposed. + + + Occurs when the current design-view selection changes. + + + Provides an interface that enables a designer to access and filter the dictionaries of a that stores the property, attribute, and event descriptors that a component designer can expose to the design-time environment. + + + When overridden in a derived class, allows a designer to change or remove items from the set of attributes that it exposes through a . + The objects for the class of the component. The keys in the dictionary of attributes are the values of the attributes. + + + When overridden in a derived class, allows a designer to change or remove items from the set of events that it exposes through a . + The objects that represent the events of the class of the component. The keys in the dictionary of events are event names. + + + When overridden in a derived class, allows a designer to change or remove items from the set of properties that it exposes through a . + The objects that represent the properties of the class of the component. The keys in the dictionary of properties are property names. + + + When overridden in a derived class, allows a designer to add items to the set of attributes that it exposes through a . + The objects for the class of the component. The keys in the dictionary of attributes are the values of the attributes. + + + When overridden in a derived class, allows a designer to add items to the set of events that it exposes through a . + The objects that represent the events of the class of the component. The keys in the dictionary of events are event names. + + + When overridden in a derived class, allows a designer to add items to the set of properties that it exposes through a . + The objects that represent the properties of the class of the component. The keys in the dictionary of properties are property names. + + + Provides an interface for managing designer transactions and components. + + + Activates the designer that this host is hosting. + + + Occurs when this designer is activated. + + + Gets the container for this designer host. + The for this host. + + + Creates a component of the specified type and adds it to the design document. + The newly created component. + The type of the component to create. + + + Creates a component of the specified type and name, and adds it to the design document. + The newly created component. + The type of the component to create. + The name for the component. + + + Creates a that can encapsulate event sequences to improve performance and enable undo and redo support functionality. + A new instance of . When you complete the steps in your transaction, you should call on this object. + + + Creates a that can encapsulate event sequences to improve performance and enable undo and redo support functionality, using the specified transaction description. + A new . When you have completed the steps in your transaction, you should call on this object. + A title or description for the newly created transaction. + + + Occurs when this designer is deactivated. + + + Destroys the specified component and removes it from the designer container. + The component to destroy. + + + Gets the designer instance that contains the specified component. + An , or null if there is no designer for the specified component. + The to retrieve the designer for. + + + Gets an instance of the specified, fully qualified type name. + The type object for the specified type name, or null if the type cannot be found. + The name of the type to load. + + + Gets a value indicating whether the designer host is currently in a transaction. + true if a transaction is in progress; otherwise, false. + + + Occurs when this designer completes loading its document. + + + Gets a value indicating whether the designer host is currently loading the document. + true if the designer host is currently loading the document; otherwise, false. + + + Gets the instance of the base class used as the root component for the current design. + The instance of the root component class. + + + Gets the fully qualified name of the class being designed. + The fully qualified name of the base component class. + + + Adds an event handler for the event. + + + Adds an event handler for the event. + + + Gets the description of the current transaction. + A description of the current transaction. + + + Adds an event handler for the event. + + + Adds an event handler for the event. + + + Specifies methods for the designer host to report on the state of transactions. + + + Gets a value indicating whether the designer host is closing a transaction. + true if the designer is closing a transaction; otherwise, false. + + + Provides access to the designer options located on the Tools menu under the Options command in the Visual Studio development environment. + + + Gets the value of the specified Windows Forms Designer option. + The value of the specified option. + The name of the page that defines the option. + The name of the option property. + + + Sets the value of the specified Windows Forms Designer option. + The name of the page that defines the option. + The name of the option property. + The new value. + + + Provides a basic, component site-specific, key-value pair dictionary through a service that a designer can use to store user-defined data. + + + Gets the key corresponding to the specified value. + The associated key, or null if no key exists. + The value to look up in the dictionary. + + + Gets the value corresponding to the specified key. + The associated value, or null if no value exists. + The key to look up the value for. + + + Sets the specified key-value pair. + An object to use as the key to associate the value with. + The value to store. + + + Provides a service for registering event handlers for component events. + + + Creates a unique name for an event-handler method for the specified component and event. + The recommended name for the event-handler method for this event. + The component instance the event is connected to. + The event to create a name for. + + + Gets a collection of event-handler methods that have a method signature compatible with the specified event. + A collection of strings. + The event to get the compatible event-handler methods for. + + + Gets an for the event that the specified property descriptor represents, if it represents an event. + An for the event that the property represents, or null if the property does not represent an event. + The property that represents an event. + + + Converts a set of event descriptors to a set of property descriptors. + An array of objects that describe the event set. + The events to convert to properties. + + + Converts a single event descriptor to a property descriptor. + A that describes the event. + The event to convert. + + + Displays the user code for the designer. + true if the code is displayed; otherwise, false. + + + Displays the user code for the specified event. + true if the code is displayed; otherwise, false. + The component that the event is connected to. + The event to display. + + + Displays the user code for the designer at the specified line. + true if the code is displayed; otherwise, false. + The line number to place the caret on. + + + Provides an interface that can list extender providers. + + + Gets the set of extender providers for the component. + An array of type that lists the active extender providers. If there are no providers, an empty array is returned. + + + Provides an interface for adding and removing extender providers at design time. + + + Adds the specified extender provider. + The extender provider to add. + + + Removes the specified extender provider. + The extender provider to remove. + + + Provides methods for showing Help topics and adding and removing Help keywords at design time. + + + Adds a context attribute to the document. + The name of the attribute to add. + The value of the attribute. + The type of the keyword, from the enumeration . + + + Removes all existing context attributes from the document. + + + Creates a local to manage subcontexts. + The newly created . + The priority type of the subcontext to add. + + + Removes a previously added context attribute. + The name of the attribute to remove. + The value of the attribute to remove. + + + Removes a context created with . + The local context to remove. + + + Shows the Help topic that corresponds to the specified keyword. + The keyword of the Help topic to display. + + + Shows the Help topic that corresponds to the specified URL. + The URL of the Help topic to display. + + + Provides methods for identifying the components of a component. + + + Searches the specified component for fields that implement the interface and adds each to the specified container, storing the inheritance level of each which can be retrieved using the method. + The to search. Searching begins with this component. + The to add components to. + + + Gets the inheritance attribute for the specified component. + An instance of that describes the level of inheritance of the specified component. + The for which to retrieve the inheritance attribute. + + + Provides methods to manage the global designer verbs and menu commands available in design mode, and to show some types of shortcut menus. + + + Adds the specified standard menu command to the menu. + The to add. + The of the specified is already present on a menu. + + + Adds the specified designer verb to the set of global designer verbs. + The to add. + + + Searches for the specified command ID and returns the menu command associated with it. + The associated with the command ID, or null if no command is found. + The to search for. + + + Invokes a menu or designer verb command matching the specified command ID. + true if the command was found and invoked successfully; otherwise, false. + The of the command to search for and execute. + + + Removes the specified standard menu command from the menu. + The to remove. + + + Removes the specified designer verb from the collection of global designer verbs. + The to remove. + + + Shows the specified shortcut menu at the specified location. + The for the shortcut menu to show. + The x-coordinate at which to display the menu, in screen coordinates. + The y-coordinate at which to display the menu, in screen coordinates. + + + Gets a collection of the designer verbs that are currently available. + A that contains the designer verbs that are currently available. + + + Provides an interface for obtaining references to objects within a project by name or type, obtaining the name of a specified object, and for locating the parent of a specified object within a designer project. + + + Gets the component that contains the specified component. + The base that contains the specified object, or null if no parent component exists. + The object to retrieve the parent component for. + + + Gets the name of the specified component. + The name of the object referenced, or null if the object reference is not valid. + The object to return the name of. + + + Gets a reference to the component whose name matches the specified name. + An object the specified name refers to, or null if no reference is found. + The name of the component to return a reference to. + + + Gets all available references to project components. + An array of all objects with references available to the . + + + Gets all available references to components of the specified type. + An array of all available objects of the specified type. + The type of object to return references to instances of. + + + Provides an interface for designers to access resource readers and writers for specific resource types. + + + Locates the resource reader for the specified culture and returns it. + An interface that contains the resources for the culture, or null if no resources for the culture exist. + The of the resource for which to retrieve a resource reader. + + + Locates the resource writer for the specified culture and returns it. + An interface for the specified culture. + The of the resource for which to create a resource writer. + + + Provides support for root-level designer view technologies. + + + Gets a view object for the specified view technology. + An object that represents the view for this designer. + A that indicates a particular view technology. + The specified view technology is not supported or does not exist. + + + Gets the set of technologies that this designer can support for its display. + An array of supported values. + + + Provides an interface for a designer to select components. + + + Gets a value indicating whether the specified component is currently selected. + true if the component is part of the user's current selection; otherwise, false. + The component to test. + + + Gets a collection of components that are currently selected. + A collection that represents the current set of components that are selected. + + + Gets the object that is currently the primary selected object. + The object that is currently the primary selected object. + + + Occurs when the current selection changes. + + + Occurs when the current selection is about to change. + + + Gets the count of selected objects. + The number of selected objects. + + + Selects the specified collection of components. + The collection of components to select. + + + Selects the components from within the specified collection of components that match the specified selection type. + The collection of components to select. + A value from the enumeration. The default is . + + + Provides a container for services. + + + Adds the specified service to the service container. + The type of service to add. + A callback object that is used to create the service. This allows a service to be declared as available, but delays the creation of the object until the service is requested. + + + Adds the specified service to the service container, and optionally promotes the service to parent service containers. + The type of service to add. + A callback object that is used to create the service. This allows a service to be declared as available, but delays the creation of the object until the service is requested. + true to promote this request to any parent service containers; otherwise, false. + + + Adds the specified service to the service container. + The type of service to add. + An instance of the service type to add. This object must implement or inherit from the type indicated by the parameter. + + + Adds the specified service to the service container, and optionally promotes the service to any parent service containers. + The type of service to add. + An instance of the service type to add. This object must implement or inherit from the type indicated by the parameter. + true to promote this request to any parent service containers; otherwise, false. + + + Removes the specified service type from the service container. + The type of service to remove. + + + Removes the specified service type from the service container, and optionally promotes the service to parent service containers. + The type of service to remove. + true to promote this request to any parent service containers; otherwise, false. + + + Provides support for building a set of related custom designers. + + + Gets a collection of child designers. + An , containing the collection of child objects of the current designer. + + + Gets the parent designer. + An representing the parent designer, or null if there is no parent. + + + Provides an interface to modify the set of member descriptors for a component in design mode. + + + Filters the attributes that a component exposes through a . + true if the set of filtered attributes is to be cached; false if the filter service must query again. + The component to filter the attributes of. + A dictionary of attributes that can be modified. + + + Filters the events that a component exposes through a . + true if the set of filtered events is to be cached; false if the filter service must query again. + The component to filter events for. + A dictionary of events that can be modified. + + + Filters the properties that a component exposes through a . + true if the set of filtered properties is to be cached; false if the filter service must query again. + The component to filter properties for. + A dictionary of properties that can be modified. + + + Discovers available types at design time. + + + Retrieves the list of available types. + A collection of types that match the criteria specified by and . + The base type to match. Can be null. + Indicates whether types from all referenced assemblies should be checked. + + + Provides an interface to retrieve an assembly or type by name. + + + Gets the requested assembly. + An instance of the requested assembly, or null if no assembly can be located. + The name of the assembly to retrieve. + + + Gets the requested assembly. + An instance of the requested assembly, or null if no assembly can be located. + The name of the assembly to retrieve. + true if this method should throw an exception if the assembly cannot be located; otherwise, false, and this method returns null if the assembly cannot be located. + + + Gets the path to the file from which the assembly was loaded. + The path to the file from which the assembly was loaded. + The name of the assembly. + + + Loads a type with the specified name. + An instance of that corresponds to the specified name, or null if no type can be found. + The name of the type. If the type name is not a fully qualified name that indicates an assembly, this service will search its internal set of referenced assemblies. + + + Loads a type with the specified name. + An instance of that corresponds to the specified name, or null if no type can be found. + The name of the type. If the type name is not a fully qualified name that indicates an assembly, this service will search its internal set of referenced assemblies. + true if this method should throw an exception if the assembly cannot be located; otherwise, false, and this method returns null if the assembly cannot be located. + + + Loads a type with the specified name. + An instance of that corresponds to the specified name, or null if no type can be found. + The name of the type. If the type name is not a fully qualified name that indicates an assembly, this service will search its internal set of referenced assemblies. + true if this method should throw an exception if the assembly cannot be located; otherwise, false, and this method returns null if the assembly cannot be located. + true to ignore case when searching for types; otherwise, false. + + + Adds a reference to the specified assembly. + An that indicates the assembly to reference. + + + Represents a Windows menu or toolbar command item. + + + Initializes a new instance of the class. + The event to raise when the user selects the menu item or toolbar button. + The unique command ID that links this menu command to the environment's menu. + + + Gets or sets a value indicating whether this menu item is checked. + true if the item is checked; otherwise, false. + + + Occurs when the menu command changes. + + + Gets the associated with this menu command. + The associated with the menu command. + + + Gets a value indicating whether this menu item is available. + true if the item is enabled; otherwise, false. + + + Invokes the command. + + + Invokes the command with the given parameter. + An optional argument for use by the command. + + + Gets the OLE command status code for this menu item. + An integer containing a mixture of status flags that reflect the state of this menu item. + + + Raises the event. + An that contains the event data. + + + Gets the public properties associated with the . + An containing the public properties of the . + + + Gets or sets a value indicating whether this menu item is supported. + true if the item is supported, which is the default; otherwise, false. + + + Returns a string representation of this menu command. + A string containing the value of the property appended with the names of any flags that are set, separated by pipe bars (|). These flag properties include , , , and . + + + Gets or sets a value indicating whether this menu item is visible. + true if the item is visible; otherwise, false. + + + Defines identifiers that indicate the type of a selection. + + + Represents a regular selection. The selection service responds to the CTRL and SHIFT keys to support adding or removing components to or from the selection. + + + Represents a regular selection. The selection service responds to the CTRL and SHIFT keys to support adding or removing components to or from the selection. + + + Represents a selection that occurs when the content of a selection is replaced. The selection service replaces the current selection with the replacement. + + + Represents a selection that occurs when the user presses on the mouse button while the mouse pointer is over a component. If the component under the pointer is already selected, it is promoted to become the primary selected component rather than being canceled. + + + Represents a selection that occurs when the user releases the mouse button immediately after a component has been selected. If the newly selected component is already selected, it is promoted to be the primary selected component rather than being canceled. + + + Represents a selection that occurs when a user clicks a component. If the newly selected component is already selected, it is promoted to be the primary selected component rather than being canceled. + + + Represents a primary selection that occurs when a user clicks on a component. If a component in the selection list is already selected, the component is promoted to be the primary selection. + + + Represents a toggle selection that switches between the current selection and the provided selection. If a component is already selected and is passed into with a selection type of , the component selection will be canceled. + + + Represents an add selection that adds the selected components to the current selection, maintaining the current set of selected components. + + + Represents a remove selection that removes the selected components from the current selection, maintaining the current set of selected components. + + + Identifies the valid selection types as , , , , or . + + + Provides a simple implementation of the interface. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified parent service provider. + A parent service provider. + + + Adds the specified service to the service container. + The type of service to add. + A callback object that can create the service. This allows a service to be declared as available, but delays creation of the object until the service is requested. + + or is null. + A service of type already exists in the container. + + + Adds the specified service to the service container. + The type of service to add. + A callback object that can create the service. This allows a service to be declared as available, but delays creation of the object until the service is requested. + true if this service should be added to any parent service containers; otherwise, false. + + or is null. + A service of type already exists in the container. + + + Adds the specified service to the service container. + The type of service to add. + An instance of the service to add. This object must implement or inherit from the type indicated by the parameter. + + or is null. + A service of type already exists in the container. + + + Adds the specified service to the service container. + The type of service to add. + An instance of the service type to add. This object must implement or inherit from the type indicated by the parameter. + true if this service should be added to any parent service containers; otherwise, false. + + or is null. + A service of type already exists in the container. + + + Gets the default services implemented directly by . + The default services. + + + Disposes this service container. + + + Disposes this service container. + true if the is in the process of being disposed of; otherwise, false. + + + Gets the requested service. + An instance of the service if it could be found, or null if it could not be found. + The type of service to retrieve. + + + Removes the specified service type from the service container. + The type of service to remove. + + is null. + + + Removes the specified service type from the service container. + The type of service to remove. + true if this service should be removed from any parent service containers; otherwise, false. + + is null. + + + Provides a callback mechanism that can create an instance of a service on demand. + The service specified by , or null if the service could not be created. + The service container that requested the creation of the service. + The type of service to create. + + + Defines identifiers for the standard set of commands that are available to most applications. + + + Initializes a new instance of the class. + + + Gets the for the AlignBottom command. This field is read-only. + + + Gets the for the AlignHorizontalCenters command. This field is read-only. + + + Gets the for the AlignLeft command. This field is read-only. + + + Gets the for the AlignRight command. This field is read-only. + + + Gets the for the AlignToGrid command. This field is read-only. + + + Gets the for the AlignTop command. This field is read-only. + + + Gets the for the AlignVerticalCenters command. This field is read-only. + + + Gets the for the ArrangeBottom command. This field is read-only. + + + Gets the for the ArrangeIcons command. This field is read-only. + + + Gets the for the ArrangeRight command. This field is read-only. + + + Gets the for the BringForward command. This field is read-only. + + + Gets the for the BringToFront command. This field is read-only. + + + Gets the for the CenterHorizontally command. This field is read-only. + + + Gets the for the CenterVertically command. This field is read-only. + + + Gets the for the Copy command. This field is read-only. + + + Gets the for the Cut command. This field is read-only. + + + Gets the for the Delete command. This field is read-only. + + + Gets the for the Document Outline command. This field is read-only. + + + Gets the for the F1Help command. This field is read-only. + + + Gets the for the Group command. This field is read-only. + + + Gets the for the HorizSpaceConcatenate command. This field is read-only. + + + Gets the for the HorizSpaceDecrease command. This field is read-only. + + + Gets the for the HorizSpaceIncrease command. This field is read-only. + + + Gets the for the HorizSpaceMakeEqual command. This field is read-only. + + + Gets the for the LineupIcons command. This field is read-only. + + + Gets the for the LockControls command. This field is read-only. + + + Gets the for the MultiLevelRedo command. This field is read-only. + + + Gets the for the MultiLevelUndo command. This field is read-only. + + + Gets the for the Paste command. This field is read-only. + + + Gets the for the Properties command. This field is read-only. + + + Gets the for the PropertiesWindow command. This field is read-only. + + + Gets the for the Redo command. This field is read-only. + + + Gets the for the Replace command. This field is read-only. + + + Gets the for the SelectAll command. This field is read-only. + + + Gets the for the SendBackward command. This field is read-only. + + + Gets the for the SendToBack command. This field is read-only. + + + Gets the for the ShowGrid command. This field is read-only. + + + Gets the for the ShowLargeIcons command. This field is read-only. + + + Gets the for the SizeToControl command. This field is read-only. + + + Gets the for the SizeToControlHeight command. This field is read-only. + + + Gets the for the SizeToControlWidth command. This field is read-only. + + + Gets the for the SizeToFit command. This field is read-only. + + + Gets the for the SizeToGrid command. This field is read-only. + + + Gets the for the SnapToGrid command. This field is read-only. + + + Gets the for the TabOrder command. This field is read-only. + + + Gets the for the Undo command. This field is read-only. + + + Gets the for the Ungroup command. This field is read-only. + + + Gets the first of a set of verbs. This field is read-only. + + + Gets the last of a set of verbs. This field is read-only. + + + Gets the for the VertSpaceConcatenate command. This field is read-only. + + + Gets the for the VertSpaceDecrease command. This field is read-only. + + + Gets the for the VertSpaceIncrease command. This field is read-only. + + + Gets the for the VertSpaceMakeEqual command. This field is read-only. + + + Gets the for the ViewCode command. This field is read-only. + + + Gets the for the ViewGrid command. This field is read-only. + + + Defines GUID identifiers that correspond to the standard set of tool windows that are available in the design environment. + + + Initializes a new instance of the class. + + + Gets the GUID for the object browser. This field is read-only. + + + Gets the GUID for the output window. This field is read-only. + + + Gets the GUID for the solution explorer. This field is read-only. + + + Gets the GUID for the Properties window. This field is read-only. + + + Gets the GUID for the related links frame. This field is read-only. + + + Gets the GUID for the server explorer. This field is read-only. + + + Gets the GUID for the task list. This field is read-only. + + + Gets the GUID for the Toolbox. This field is read-only. + + + Provides a type description provider for a specified type. + + + Initializes a new instance of the class. + + + Gets a type description provider for the specified object. + A that corresponds with . + The object to get a type description provider for. + + + Gets a type description provider for the specified type. + A that corresponds with . + The type to get a type description provider for. + + + Defines identifiers for a set of technologies that designer hosts support. + + + Represents a mode in which the view object is passed directly to the development environment. + + + Represents a mode in which a Windows Forms control object provides the display for the root designer. + + + Specifies the default view technology support. + + + Provides the base class for serializing a set of components or serializable objects into a serialization store. + + + Initializes a new instance of the class. + + + Creates a new . + A new . + + + Deserializes the given store to produce a collection of objects. + A collection of objects created according to the stored state. + The to deserialize. + + is null. + + does not contain data in a format the serialization container can process. + + + Deserializes the given store and populates the given with deserialized objects. + A collection of objects created according to the stored state. + The to deserialize. + The to which objects will be added. + + or is null. + + does not contain data in a format the serialization container can process. + + + Deserializes the given to the given container. + The to deserialize. + The container to which objects will be added. + + or is null. + + does not contain data in a format the serialization container can process. + + + Deserializes the given to the given container, optionally validating recycled types. + The to deserialize. + The container to which objects will be added. + true to guarantee that the deserialization will only work if applied to an object of the same type. + + or is null. + + does not contain data in a format the serialization container can process. + + + Deserializes the given to the given container, optionally applying default property values. + The to deserialize. + The container to which objects will be added. + true to guarantee that the deserialization will only work if applied to an object of the same type. + true to indicate that the default property values should be applied. + + or is null. + + does not contain data in a format the serialization container can process. + + + Loads a from a stream. + A new instance. + The from which the store will be loaded. + + is null. + + does not contain data saved by a previous call to . + + + Serializes the given object to the given . + The to which the state of will be written. + The object to serialize. + + or is null. + + is closed, or is not a supported type of serialization store. Use a store returned by . + + + Serializes the given object, accounting for default property values. + The to which the state of will be serialized. + The object to serialize. + + or is null. + + is closed, or is not a supported type of serialization store. Use a store returned by . + + + Serializes the given member on the given object. + The to which the state of will be serialized. + The object to which is attached. + A specifying the member to serialize. + + or is null. + + is closed, or is not a supported type of serialization store. Use a store returned by . + + + Serializes the given member on the given object, accounting for the default property value. + The to which the state of will be serialized. + The object to which is attached. + The member to serialize. + + or is null. + + is closed, or is not a supported type of serialization store. Use a store returned by . + + + Provides a stack object that can be used by a serializer to make information available to nested serializers. + + + Initializes a new instance of the class. + + + Appends an object to the end of the stack, rather than pushing it onto the top of the stack. + A context object to append to the stack. + + is null. + + + Gets the current object on the stack. + The current object on the stack, or null if no objects were pushed. + + + Gets the object on the stack at the specified level. + The object on the stack at the specified level, or null if no object exists at that level. + The level of the object to retrieve on the stack. Level 0 is the top of the stack, level 1 is the next down, and so on. This level must be 0 or greater. If level is greater than the number of levels on the stack, it returns null. + + is less than 0. + + + Gets the first object on the stack that inherits from or implements the specified type. + The first object on the stack that inherits from or implements the specified type, or null if no object on the stack implements the type. + A type to retrieve from the context stack. + + is null. + + + Removes the current object off of the stack, returning its value. + The object removed from the stack; null if no objects are on the stack. + + + Pushes, or places, the specified object onto the stack. + The context object to push onto the stack. + + is null. + + + The attribute is placed on a serializer to indicate the class to use as a default provider of that type of serializer. + + + Initializes a new instance of the class with the named provider type. + The name of the serialization provider type. + + is null. + + + Initializes a new instance of the class with the given provider type. + The of the serialization provider. + + is null. + + + Gets the type name of the serialization provider. + A string containing the name of the provider. + + + Provides a basic designer loader interface that can be used to implement a custom designer loader. + + + Initializes a new instance of the class. + + + Begins loading a designer. + The loader host through which this loader loads components. + + + Releases all resources used by the . + + + Writes cached changes to the location that the designer was loaded from. + + + Gets a value indicating whether the loader is currently loading a document. + true if the loader is currently loading a document; otherwise, false. + + + Indicates a serializer for the serialization manager to use to serialize the values of the type this attribute is applied to. This class cannot be inherited. + + + Initializes a new instance of the class. + The fully qualified name of the data type of the serializer. + The fully qualified name of the base data type of the serializer. Multiple serializers can be supplied for a class as long as the serializers have different base types. + + + Initializes a new instance of the class. + The fully qualified name of the data type of the serializer. + The base data type of the serializer. Multiple serializers can be supplied for a class as long as the serializers have different base types. + + + Initializes a new instance of the class. + The data type of the serializer. + The base data type of the serializer. Multiple serializers can be supplied for a class as long as the serializers have different base types. + + + Gets the fully qualified type name of the serializer base type. + The fully qualified type name of the serializer base type. + + + Gets the fully qualified type name of the serializer. + The fully qualified type name of the serializer. + + + Indicates a unique ID for this attribute type. + A unique ID for this attribute type. + + + Provides an interface that can extend a designer host to support loading from a serialized state. + + + Ends the designer loading operation. + The fully qualified name of the base class of the document that this designer is designing. + true if the designer is successfully loaded; otherwise, false. + A collection containing the errors encountered during load, if any. If no errors were encountered, pass either an empty collection or null. + + + Reloads the design document. + + + Provides an interface that extends to specify whether errors are tolerated while loading a design document. + + + Gets or sets a value indicating whether it is possible to reload with errors. + true if the designer loader can reload the design document when errors are detected; otherwise, false. The default is false. + + + Gets or sets a value indicating whether errors should be ignored when is called. + true if the designer loader will ignore errors when it reloads; otherwise, false. The default is false. + + + Provides an interface that can extend a designer loader to support asynchronous loading of external components. + + + Registers an external component as part of the load process managed by this interface. + + + Signals that a dependent load has finished. + true if the load of the designer is successful; false if errors prevented the load from finishing. + A collection of errors that occurred during the load, if any. If no errors occurred, pass either an empty collection or null. + + + Reloads the design document. + true if the reload request is accepted, or false if the loader does not allow the reload. + + + Provides an interface that can manage design-time serialization. + + + Adds the specified serialization provider to the serialization manager. + The serialization provider to add. + + + Gets a stack-based, user-defined storage area that is useful for communication between serializers. + A that stores data. + + + Creates an instance of the specified type and adds it to a collection of named instances. + The newly created object instance. + The data type to create. + The arguments to pass to the constructor for this type. + The name of the object. This name can be used to access the object later through . If null is passed, the object is still created but cannot be accessed by name. + If true, this object is added to the design container. The object must implement for this to have any effect. + + + Gets an instance of a created object of the specified name, or null if that object does not exist. + An instance of the object with the given name, or null if no object by that name can be found. + The name of the object to retrieve. + + + Gets the name of the specified object, or null if the object has no name. + The name of the object, or null if the object is unnamed. + The object to retrieve the name for. + + + Gets a serializer of the requested type for the specified object type. + An instance of the requested serializer, or null if no appropriate serializer can be located. + The type of the object to get the serializer for. + The type of the serializer to retrieve. + + + Gets a type of the specified name. + An instance of the type, or null if the type cannot be loaded. + The fully qualified name of the type to load. + + + Indicates custom properties that can be serializable with available serializers. + A containing the properties to be serialized. + + + Removes a custom serialization provider from the serialization manager. + The provider to remove. This object must have been added using . + + + Reports an error in serialization. + The error to report. This information object can be of any object type. If it is an exception, the message of the exception is extracted and reported to the user. If it is any other type, is called to display the information to the user. + + + Occurs when cannot locate the specified name in the serialization manager's name table. + + + Occurs when serialization is complete. + + + Sets the name of the specified existing object. + The object instance to name. + The name to give the instance. + + + Provides an interface that enables access to a serializer. + + + Gets a serializer using the specified attributes. + An instance of a serializer of the type requested, or null if the request cannot be satisfied. + The serialization manager requesting the serializer. + An instance of the current serializer of the specified type. This can be null if no serializer of the specified type exists. + The data type of the object to serialize. + The data type of the serializer to create. + + + Provides an interface that can invoke serialization and deserialization. + + + Deserializes the specified serialization data object and returns a collection of objects represented by that data. + An of objects rebuilt from the specified serialization data object. + An object consisting of serialized data. + + + Serializes the specified collection of objects and stores them in a serialization data object. + An object that contains the serialized state of the specified collection of objects. + A collection of objects to serialize. + + + Provides a service that can generate unique names for objects. + + + Creates a new name that is unique to all components in the specified container. + A unique name for the data type. + The container where the new object is added. + The data type of the object that receives the name. + + + Gets a value indicating whether the specified name is valid. + true if the name is valid; otherwise, false. + The name to validate. + + + Gets a value indicating whether the specified name is valid. + The name to validate. + + + Provides the information necessary to create an instance of an object. This class cannot be inherited. + + + Initializes a new instance of the class using the specified member information and arguments. + The member information for the descriptor. This can be a , , , or . If this is a , , or , it must represent a static member. + The collection of arguments to pass to the member. This parameter can be null or an empty collection if there are no arguments. The collection can also consist of other instances of . + + is of type , , or , and it does not represent a static member. is of type and is not readable. is of type or , and the number of arguments in does not match the signature of is of type and represents a static member. is of type , and the number of arguments in is not zero. + + + Initializes a new instance of the class using the specified member information, arguments, and value indicating whether the specified information completely describes the instance. + The member information for the descriptor. This can be a , , , or . If this is a , , or , it must represent a static member. + The collection of arguments to pass to the member. This parameter can be null or an empty collection if there are no arguments. The collection can also consist of other instances of . + true if the specified information completely describes the instance; otherwise, false. + + is of type , , or , and it does not represent a static member is of type and is not readable. is of type or and the number of arguments in does not match the signature of . is of type and represents a static member is of type , and the number of arguments in is not zero. + + + Gets the collection of arguments that can be used to reconstruct an instance of the object that this instance descriptor represents. + An of arguments that can be used to create the object. + + + Invokes this instance descriptor and returns the object the descriptor describes. + The object this instance descriptor describes. + + + Gets a value indicating whether the contents of this completely identify the instance. + true if the instance is completely described; otherwise, false. + + + Gets the member information that describes the instance this descriptor is associated with. + A that describes the instance that this object is associated with. + + + Represents a single relationship between an object and a member. + + + Initializes a new instance of the class. + The object that owns . + The member which is to be related to . + + or is null. + + + Represents the empty member relationship. This field is read-only. + + + Determines whether two instances are equal. + true if the specified is equal to the current ; otherwise, false. + The to compare with the current . + + + Returns the hash code for this instance. + A hash code for the current . + + + Gets a value indicating whether this relationship is equal to the relationship. + true if this relationship is equal to the relationship; otherwise, false. + + + Gets the related member. + The member that is passed in to the . + + + Tests whether two specified structures are equivalent. + This operator returns true if the two structures are equal; otherwise, false. + The structure that is to the left of the equality operator. + The structure that is to the right of the equality operator. + + + Tests whether two specified structures are different. + This operator returns true if the two structures are different; otherwise, false. + The structure that is to the left of the inequality operator. + The structure that is to the right of the inequality operator. + + + Gets the owning object. + The owning object that is passed in to the . + + + Provides the base class for relating one member to another. + + + Initializes a new instance of the class. + + + Gets a relationship to the given source relationship. + A relationship to , or if no relationship exists. + The source relationship. + + + Establishes a relationship between a source and target object. + The current relationship associated with , or if there is no relationship. + The source relationship. This is the left-hand side of a relationship assignment. + + is null. + + is empty, or the relationship is not supported by the service. + + + Establishes a relationship between a source and target object. + A structure encapsulating the relationship between a source and target object, or null if there is no relationship. + The owner of a source relationship. + The member of a source relationship. + + or is null. + + or is empty, or the relationship is not supported by the service. + + + Creates a relationship between the source object and target relationship. + The source relationship. + The relationship to set into the source. + The relationship is not supported by the service. + + + Gets a value indicating whether the given relationship is supported. + true if a relationship between the given two objects is supported; otherwise, false. + The source relationship. + The relationship to set into the source. + + + Provides data for the event. + + + Initializes a new instance of the class. + The name to resolve. + + + Gets the name of the object to resolve. + The name of the object to resolve. + + + Gets or sets the object that matches the name. + The object that the name is associated with. + + + Represents the method that handles the event of a serialization manager. + The source of the event. + A that contains the event data. + + + Indicates the base serializer to use for a root designer object. This class cannot be inherited. + + + Initializes a new instance of the class using the specified attributes. + The fully qualified name of the data type of the serializer. + The name of the base type of the serializer. A class can include multiple serializers as they all have different base types. + true if this serializer supports dynamic reloading of the document; otherwise, false. + + + Initializes a new instance of the class using the specified attributes. + The fully qualified name of the data type of the serializer. + The name of the base type of the serializer. A class can include multiple serializers, as they all have different base types. + true if this serializer supports dynamic reloading of the document; otherwise, false. + + + Initializes a new instance of the class using the specified attributes. + The data type of the serializer. + The base type of the serializer. A class can include multiple serializers as they all have different base types. + true if this serializer supports dynamic reloading of the document; otherwise, false. + + + Gets a value indicating whether the root serializer supports reloading of the design document without first disposing the designer host. + true if the root serializer supports reloading; otherwise, false. + + + Gets the fully qualified type name of the base type of the serializer. + The name of the base type of the serializer. + + + Gets the fully qualified type name of the serializer. + The name of the type of the serializer. + + + Gets a unique ID for this attribute type. + An object containing a unique ID for this attribute type. + + + Provides the base class for storing serialization data for the . + + + Initializes a new instance of the class. + + + Closes the serialization store. + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets a collection of errors that occurred during serialization or deserialization. + An that contains errors that occurred during serialization or deserialization. + + + Saves the store to the given stream. + The stream to which the store will be serialized. + + + Releases all resources used by the . + + + Specifies that an application settings property has a common value for all users of an application. This class cannot be inherited. + 1 + + + Initializes a new instance of the class. + + + Acts as a base class for deriving concrete wrapper classes to implement the application settings feature in Window Forms applications. + 1 + + + Initializes an instance of the class to its default state. + + + Initializes an instance of the class using the supplied owner component. + The component that will act as the owner of the application settings object. + + is null. + + + Initializes an instance of the class using the supplied owner component and settings key. + The component that will act as the owner of the application settings object. + A that uniquely identifies separate instances of the wrapper class. + + is null. + + + Initializes an instance of the class using the supplied settings key. + A that uniquely identifies separate instances of the wrapper class. + + + Gets the application settings context associated with the settings group. + A associated with the settings group. + 2 + + + Returns the value of the named settings property for the previous version of the same application. + An containing the value of the specified if found; otherwise, null. + A containing the name of the settings property whose value is to be returned. + The property does not exist. The property count is zero or the property cannot be found in the data store. + 2 + + + + + + + + Gets or sets the value of the specified application settings property. + If found, the value of the named settings property; otherwise, null. + A containing the name of the property to access. + There are no properties associated with the current wrapper or the specified property could not be found. + An attempt was made to set a read-only property. + The value supplied is of a type incompatible with the settings property, during a set operation. + The configuration file could not be parsed. + 2 + + + Raises the event. + The source of the event. + A that contains the event data. + + + Raises the event. + The source of the event. + A that contains the event data. + + + Raises the event. + The source of the event. + A that contains the event data. + + + Raises the event. + The source of the event. + A that contains the event data. + + + Gets the collection of settings properties in the wrapper. + A containing all the objects used in the current wrapper. + The associated settings provider could not be found or its instantiation failed. + 2 + + + + + + + Occurs after the value of an application settings property is changed. + 2 + + + Gets a collection of property values. + A of property values. + 2 + + + Gets the collection of application settings providers used by the wrapper. + A containing all the objects used by the settings properties of the current settings wrapper. + 2 + + + + + + Refreshes the application settings property values from persistent storage. + 1 + + + Restores the persisted application settings values to their corresponding default properties. + The configuration file could not be parsed. + 2 + + + + + + + Stores the current values of the application settings properties. + 1 + + + Occurs before the value of an application settings property is changed. + 2 + + + Gets or sets the settings key for the application settings group. + A containing the settings key for the current settings group. + 2 + + + Occurs after the application settings are retrieved from storage. + + + Occurs before values are saved to the data store. + 2 + + + Updates application settings to reflect a more recent installation of the application. + The configuration file could not be parsed. + 2 + + + + + + + Represents a grouping of related application settings sections within a configuration file. This class cannot be inherited. + 2 + + + Initializes a new instance of the class. + + + Provides a method for reading values of a particular type from the configuration. + 2 + + + Initializes a new instance of the class. + + + Gets the value for a specified key from the property and returns an object of the specified type containing the value from the configuration. + The value of the specified key. + The key for which to get the value. + The type of the object to return. + + is null.- or - is null. + + does not exist in the <appSettings> configuration section.- or -The value in the <appSettings> configuration section for is not of type . + 2 + + + Represents a group of user-scoped application settings in a configuration file. + 2 + + + Initializes a new instance of the class. + + + Gets the collection of client settings for the section. + A containing all the client settings found in the current configuration section. + 2 + + + The exception that is thrown when a configuration system error has occurred. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + The object that holds the information to deserialize. + Contextual information about the source or destination. + + + Initializes a new instance of the class. + A message describing why this exception was thrown. + + + Initializes a new instance of the class. + A message describing why this exception was thrown. + The inner exception that caused this to be thrown, if any. + + + Initializes a new instance of the class. + A message describing why this exception was thrown. + The inner exception that caused this to be thrown, if any. + The path to the configuration file that caused this to be thrown. + The line number within the configuration file at which this was thrown. + + + Initializes a new instance of the class. + A message describing why this exception was thrown. + The inner exception that caused this to be thrown, if any. + The that caused this to be thrown. + + + Initializes a new instance of the class. + A message describing why this exception was thrown. + The path to the configuration file that caused this to be thrown. + The line number within the configuration file at which this was thrown. + + + Initializes a new instance of the class. + A message describing why this exception was thrown. + The that caused this to be thrown. + + + Gets a description of why this configuration exception was thrown. + A description of why this exception was thrown. + 2 + + + + + + Gets the path to the configuration file that caused this configuration exception to be thrown. + The path to the configuration file that caused this exception to be thrown. + 2 + + + + + + Sets the object with the file name and line number at which this configuration exception occurred. + The object that holds the information to be serialized. + The contextual information about the source or destination. + 2 + + + Gets the path to the configuration file from which the internal object was loaded when this configuration exception was thrown. + A string representing the node file name. + The that caused this exception to be thrown. + 1 + + + + + + Gets the line number within the configuration file that the internal object represented when this configuration exception was thrown. + An int representing the node line number. + The that caused this exception to be thrown. + 1 + + + Gets the line number within the configuration file at which this configuration exception was thrown. + The line number within the configuration file at which this exception was thrown. + 2 + + + Gets an extended description of why this configuration exception was thrown. + An extended description of why this exception was thrown. + 2 + + + + + + Provides runtime versions 1.0 and 1.1 support for reading configuration sections and common configuration settings. + 2 + + + Gets a read-only of the application settings section of the configuration file. + A read-only of the application settings section from the configuration file. + 1 + + + + + + + Returns the object for the passed configuration section name and path. + The object for the passed configuration section name and path.NoteThe class provides backward compatibility only. You should use the class or class instead. + A configuration name and path, such as "system.net/settings". + Unable to retrieve the requested section. + 1 + + + + + + + Wraps the corresponding type and also carries the necessary information for reporting file-name and line numbers. + 2 + + + Initializes a new instance of the class. + + + Creates a configuration element attribute. + The attribute. + The prefix definition. + The name that is used locally. + The URL that is assigned to the namespace. + 2 + + + Creates an XML CData section. + The value. + The data to use. + 2 + + + Create an XML comment. + The value. + The comment data. + 2 + + + Creates a configuration element. + The value. + The prefix definition. + The name used locally. + The namespace for the URL. + 2 + + + Creates white spaces. + The value. + The data to use. + 2 + + + Create a text node. + The value. + The text to use. + 2 + + + Creates white space. + The value. + The data to use. + 2 + + + Gets the configuration file name. + The configuration file name. + 2 + + + Gets the current node line number. + The line number for the current node. + 2 + + + Loads the configuration file. + The name of the file. + 2 + + + Loads a single configuration element. + The name of the file. + The source for the reader. + 2 + + + Gets the configuration file name. + The file name. + + + Gets the configuration line number. + The line number. + + + Specifies the default value for an application settings property. + 1 + + + Initializes an instance of the class. + A that represents the default value for the property. + + + Gets the default value for the application settings property. + A that represents the default value for the property. + 2 + + + Provides key/value pair configuration information from a configuration section. + 2 + + + Initializes a new instance of the class. + + + Creates a new configuration handler and adds it to the section-handler collection based on the specified parameters. + A configuration object. + Parent object. + Configuration context object. + Section XML node. + 2 + + + Gets the XML attribute name to use as the key in a key/value pair. + A string value containing the name of the key attribute. + + + Gets the XML attribute name to use as the value in a key/value pair. + A string value containing the name of the value attribute. + + + Defines extended capabilities for client-based application settings providers. + 2 + + + Returns the value of the specified settings property for the previous version of the same application. + A containing the value of the specified property setting as it was last set in the previous version of the application; or null if the setting cannot be found. + A describing the current application usage. + The whose value is to be returned. + 2 + + + Resets the application settings associated with the specified application to their default values. + A describing the current application usage. + 2 + + + Indicates to the provider that the application has been upgraded. This offers the provider an opportunity to upgrade its stored settings as appropriate. + A describing the current application usage. + A containing the settings property group whose values are to be retrieved. + 2 + + + Handles the access to certain configuration sections. + 2 + + + Creates a configuration section handler. + The created section handler object. + Parent object. + Configuration context object. + Section XML node. + 2 + + + Provides standard configuration methods. + 2 + + + Gets the specified configuration. + The object representing the configuration. + The configuration key. + 2 + + + Used for initialization. + 2 + + + Provides the configuration setting for International Domain Name (IDN) processing in the class. + + + Initializes a new instance of the class. + + + Gets or sets the value of the configuration setting. + A that contains the current configuration setting for IDN processing. + + + Provides a legacy section-handler definition for configuration sections that are not handled by the types. + 2 + + + Initializes a new instance of the class. + + + Creates a new configuration handler and adds the specified configuration object to the section-handler collection. + The created configuration handler object. + The configuration settings in a corresponding parent configuration section. + The virtual path for which the configuration section handler computes configuration values. Normally this parameter is reserved and is null. + An that contains the configuration information to be handled. Provides direct access to the XML contents of the configuration section. + 2 + + + Defines standard functionality for controls or libraries that store and retrieve application settings. + 2 + + + Reads the control's application settings into their corresponding properties and updates the control's state. + 2 + + + Resets the control's application settings properties to their default values. + 1 + + + Persists the control's application settings properties. + 2 + + + Gets or sets a value indicating whether the control should automatically persist its application settings properties. + true if the control should automatically persist its state; otherwise, false. + 2 + + + Gets or sets the value of the application settings key for the current instance of the control. + A containing the settings key for the current instance of the control. + 2 + + + Provides the configuration setting for International Resource Identifier (IRI) processing in the class. + + + Initializes a new instance of the class. + + + Gets or sets the value of the configuration setting. + A Boolean that indicates if International Resource Identifier (IRI) processing is enabled. + + + Provides an interface for defining an alternate application settings provider. + 2 + + + Returns the settings provider compatible with the specified settings property. + If found, the that can persist the specified settings property; otherwise, null. + The that requires serialization. + 2 + + + Provides persistence for application settings classes. + 2 + + + Initializes a new instance of the class. + + + Gets or sets the name of the currently running application. + A string that contains the application's display name. + 2 + + + Returns the value of the named settings property for the previous version of the same application. + A representing the application setting if found; otherwise, null. + A that describes where the application settings property is used. + The whose value is to be returned. + 2 + + + + + + + + Returns the collection of setting property values for the specified application instance and settings property group. + A containing the values for the specified settings property group. + A describing the current application usage. + A containing the settings property group whose values are to be retrieved. + A user-scoped setting was encountered but the current configuration only supports application-scoped settings. + 2 + + + + + + + + The name of the provider. + The values for initialization. + 2 + + + Resets all application settings properties associated with the specified application to their default values. + A describing the current application usage. + A user-scoped setting was encountered but the current configuration only supports application-scoped settings. + 2 + + + + + + + Sets the values of the specified group of property settings. + A describing the current application usage. + A representing the group of property settings to set. + A user-scoped setting was encountered but the current configuration only supports application-scoped settings.-or-There was a general failure saving the settings to the configuration file. + 2 + + + + + + + + Attempts to migrate previous user-scoped settings from a previous version of the same application. + A describing the current application usage. + A containing the settings property group whose values are to be retrieved. + A user-scoped setting was encountered but the current configuration only supports application-scoped settings.-or-The previous version of the configuration file could not be accessed. + 2 + + + + + + + + Provides access to a configuration file. This type supports the .NET Framework configuration infrastructure and is not intended to be used directly from your code. + 2 + + + Initializes a new instance of the class. + + + Creates a new configuration handler and adds it to the section-handler collection based on the specified parameters. + A configuration object. + The parent object. + The configuration context object. + The section XML node. + The file specified in the file attribute of exists but cannot be loaded.- or -The name attribute of does not match the root element of the file specified in the file attribute. + 2 + + + + + + Provides name/value-pair configuration information from a configuration section. + 2 + + + Initializes a new instance of the class. + + + Creates a new configuration handler and adds it to the section-handler collection based on the specified parameters. + A configuration object. + Parent object. + Configuration context object. + Section XML node. + 2 + + + Gets the XML attribute name to use as the key in a key/value pair. + A value containing the name of the key attribute. + + + Gets the XML attribute name to use as the value in a key/value pair. + A value containing the name of the value attribute. + + + Specifies that a settings provider should disable any logic that gets invoked when an application upgrade is detected. This class cannot be inherited. + 1 + + + Initializes a new instance of the class. + + + Represents an element in a class. + + + Initializes a new instance of the class. + + + Gets the value of the GenericUriParserOptions entry from a instance. + The value of GenericUriParserOptions entry. + + + Gets the value of the Name entry from a instance. + The protocol used by this schema setting. + + + Represents a collection of objects. + + + Initializes a new instance of the class. + + + Gets the default collection type of . + The default collection type of . + + + The index of the specified . + The index of the specified ; otherwise, -1. + The for the specified index location. + + + Gets an item at the specified index in the collection. + The specified . + The index of the to return. + The parameter is less than zero.-or- The item specified by the parameter is null or has been removed. + + + Gets an item from the collection. + A object contained in the collection. + A string reference to the object within the collection. + + + Represents a custom settings attribute used to associate settings information with a settings property. + + + Initializes a new instance of the class. + + + Provides data for the event. + 2 + + + Initializes an instance of the class. + A containing the name of the application setting. + A containing a category description of the setting. Often this parameter is set to the application settings group name. + A containing the application settings key. + An that contains the new value to be assigned to the application settings property. + true to cancel the event; otherwise, false. + + + Gets the new value being assigned to the application settings property. + An that contains the new value to be assigned to the application settings property. + 1 + + + Gets the application settings property category. + A containing a category description of the setting. Typically, this parameter is set to the application settings group name. + 2 + + + Gets the application settings key associated with the property. + A containing the application settings key. + 2 + + + Gets the name of the application setting associated with the application settings property. + A containing the name of the application setting. + 2 + + + Represents the method that will handle the event. + The source of the event, typically an application settings wrapper class derived from the class. + A containing the data for the event. + 2 + + + Represents a simplified configuration element used for updating elements in the configuration. This class cannot be inherited. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class based on supplied parameters. + The name of the object. + A object. This object is an enumeration used as the serialization scheme to store configuration settings. + + + Compares the current instance to the specified object. + true if the instance is equal to the specified object; otherwise, false. + The object to compare with. + 2 + + + Gets a unique value representing the current instance. + A unique value representing the current instance. + 2 + + + + + + Gets or sets the name of the object. + The name of the object. + 2 + + + + + + Gets or sets the serialization mechanism used to persist the values of the object. + A object. + 2 + + + + + + Gets or sets the value of a object by using a object. + A object containing the value of the object. + 2 + + + + + + Contains a collection of objects. This class cannot be inherited. + 2 + + + Initializes a new instance of the class. + + + Adds a object to the collection. + The object to add to the collection. + 2 + + + + + + Removes all objects from the collection. + + + Gets the type of the configuration collection. + The object of the collection. + + + Gets a object from the collection. + A object. + A string value representing the object in the collection. + 2 + + + Removes a object from the collection. + A object. + 2 + + + + + + Represents a collection of key/value pairs used to describe a configuration object as well as a object. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + A collection of key/value pairs that are related to configuration settings. + + + Provides the base class used to support user property settings. + 2 + + + Initializes a new instance of the class. + + + Gets the associated settings context. + A associated with the settings instance. + 2 + + + Initializes internal properties used by object. + The settings context related to the settings properties. + The settings properties that will be accessible from the instance. + The initialized providers that should be used when loading and saving property values. + 2 + + + Gets a value indicating whether access to the object is synchronized (thread safe). + true if access to the is synchronized; otherwise, false. + 2 + + + Gets or sets the value of the specified settings property. + If found, the value of the named settings property. + A containing the name of the property to access. + There are no properties associated with the current object, or the specified property could not be found. + An attempt was made to set a read-only property. + The value supplied is of a type incompatible with the settings property, during a set operation. + 2 + + + + + + + + Gets the collection of settings properties. + A collection containing all the objects. + 2 + + + Gets a collection of settings property values. + A collection of objects representing the actual data values for the properties managed by the instance. + 2 + + + Gets a collection of settings providers. + A containing objects. + 2 + + + Stores the current values of the settings properties. + 1 + + + + + + Provides a class that is synchronized (thread safe). + A class that is synchronized. + The class used to support user property settings. + + + Provides contextual information that the provider can use when persisting settings. + 2 + + + Initializes a new instance of the class. + + + Provides a string that describes an individual configuration property. This class cannot be inherited. + 1 + + + Initializes an instance of the class. + The used as descriptive text. + + + Gets the descriptive text for the associated configuration property. + A containing the descriptive text for the associated configuration property. + 2 + + + Provides a string that describes an application settings property group. This class cannot be inherited. + 1 + + + Initializes a new instance of the class. + A containing the descriptive text for the application settings group. + + + The descriptive text for the application settings properties group. + A containing the descriptive text for the application settings group. + 2 + + + Specifies a name for application settings property group. This class cannot be inherited. + 1 + + + Initializes a new instance of the class. + A containing the name of the application settings property group. + + + Gets the name of the application settings property group. + A containing the name of the application settings property group. + 2 + + + Provides data for the event. + + + Initializes a new instance of the class. + A object from which settings are loaded. + + + Gets the settings provider used to store configuration settings. + A settings provider. + + + Represents the method that will handle the event. + The source of the event, typically the settings class. + A object that contains the event data. + + + Provides values to indicate which services should be made available to application settings. + 2 + + + Enables application settings to be stored in roaming user profiles. For more information about roaming user profiles, see Isolated Storage and Roaming. + + + Specifies special services for application settings properties. This class cannot be inherited. + 1 + + + Initializes a new instance of the class. + A value that enumerates the services being requested. + + + Gets the set of special services that have been requested. + A value that results from using the logical OR operator to combine all the enumeration values corresponding to the requested services. + 2 + + + Used internally as the class that represents metadata about an individual configuration property. + 2 + + + Initializes a new instance of the class, based on the supplied parameter. + Specifies a copy of an existing object. + + + Initializes a new instance of the class. based on the supplied parameter. + Specifies the name of an existing object. + + + Creates a new instance of the class based on the supplied parameters. + The name of the object. + The type of object. + A object to use for persistence. + A value specifying whether the object is read-only. + The default value of the object. + A object. This object is an enumeration used to set the serialization scheme for storing application settings. + A object. + A Boolean value specifying whether an error will be thrown when the property is unsuccessfully deserialized. + A Boolean value specifying whether an error will be thrown when the property is unsuccessfully serialized. + + + Gets a object containing the attributes of the object. + A object. + 2 + + + Gets or sets the default value of the object. + An object containing the default value of the object. + 2 + + + Gets or sets a value specifying whether a object is read-only. + true if the is read-only; otherwise, false. + 2 + + + Gets or sets the name of the . + The name of the . + 2 + + + Gets or sets the type for the . + The type for the . + 2 + + + Gets or sets the provider for the . + A object. + 2 + + + Gets or sets a object for the . + A object. + 2 + + + Gets or sets a value specifying whether an error will be thrown when the property is unsuccessfully deserialized. + true if the error will be thrown when the property is unsuccessfully deserialized; otherwise, false. + + + Gets or sets a value specifying whether an error will be thrown when the property is unsuccessfully serialized. + true if the error will be thrown when the property is unsuccessfully serialized; otherwise, false. + + + Contains a collection of objects. + 2 + + + Initializes a new instance of the class. + + + Adds a object to the collection. + A object. + The collection is read-only. + 2 + + + Removes all objects from the collection. + The collection is read-only. + 2 + + + Creates a copy of the existing collection. + A class. + 2 + + + Copies this object to an array. + The array to copy the object to. + The index at which to begin copying. + 2 + + + Gets a value that specifies the number of objects in the collection. + The number of objects in the collection. + 2 + + + Gets the object as it applies to the collection. + The object as it applies to the collection. + 2 + + + Gets a value that indicates whether access to the collection is synchronized (thread safe). + true if access to the is synchronized; otherwise, false. + 2 + + + Gets the collection item with the specified name. + The object with the specified . + The name of the object. + 2 + + + Performs additional, custom processing when adding to the contents of the instance. + A object. + + + Performs additional, custom processing after adding to the contents of the instance. + A object. + + + Performs additional, custom processing when clearing the contents of the instance. + + + Performs additional, custom processing after clearing the contents of the instance. + + + Performs additional, custom processing when removing the contents of the instance. + A object. + + + Performs additional, custom processing after removing the contents of the instance. + A object. + + + Removes a object from the collection. + The name of the object. + The collection is read-only. + 2 + + + Sets the collection to be read-only. + 2 + + + Gets the object to synchronize access to the collection. + The object to synchronize access to the collection. + 2 + + + Provides an exception for read-only objects. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class based on the supplied parameters. + The object that holds the serialized object data about the exception being thrown. + The object that contains contextual information about the source or destination of the serialized stream. + + + Initializes a new instance of the class based on a supplied parameter. + A string containing an exception message. + + + Initializes a new instance of the class based on supplied parameters. + A string containing an exception message. + The exception that is the cause of the current exception. + + + Provides an exception for objects that are not found. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class, based on supplied parameters. + The object that holds the serialized object data about the exception being thrown. + The object that contains contextual information about the source or destination of the serialized stream. + + + Initializes a new instance of the class, based on a supplied parameter. + A string containing an exception message. + + + Initializes a new instance of the class, based on supplied parameters. + A string containing an exception message. + The exception that is the cause of the current exception. + + + Contains the value of a settings property that can be loaded and stored by an instance of . + 2 + + + Initializes a new instance of the class, based on supplied parameters. + Specifies a object. + + + Gets or sets whether the value of a object has been deserialized. + true if the value of a object has been deserialized; otherwise, false. + 2 + + + Gets or sets whether the value of a object has changed. + true if the value of a object has changed; otherwise, false. + 2 + + + Gets the name of the property from the associated object. + The name of the object. + 2 + + + Gets the object. + The object that describes the object. + 2 + + + Gets or sets the value of the object. + The value of the object. When this value is set, the property is set to true and is set to false.When a value is first accessed from the property, and if the value was initially stored into the object as a serialized representation using the property, the property will trigger deserialization of the underlying value. As a side effect, the property will be set to true.If this chain of events occurs in ASP.NET, and if an error occurs during the deserialization process, the error is logged using the health-monitoring feature of ASP.NET. By default, this means that deserialization errors will show up in the Application Event Log when running under ASP.NET. If this process occurs outside of ASP.NET, and if an error occurs during deserialization, the error is suppressed, and the remainder of the logic during deserialization occurs. If there is no serialized value to deserialize when the deserialization is attempted, then object will instead attempt to return a default value if one was configured as defined on the associated instance. In this case, if the property was set to either null, or to the string "[null]", then the object will initialize the property to either null for reference types, or to the default value for the associated value type. On the other hand, if property holds a valid object reference or string value (other than "[null]"), then the property is returned instead.If there is no serialized value to deserialize when the deserialization is attempted, and no default value was specified, then an empty string will be returned for string types. For all other types, a default instance will be returned by calling — for reference types this means an attempt will be made to create an object instance using the default constructor. If this attempt fails, then null is returned. + While attempting to use the default value from the property, an error occurred. Either the attempt to convert property to a valid type failed, or the resulting value was not compatible with the type defined by . + 2 + + + Gets or sets the serialized value of the object. + The serialized value of a object. + The serialization options for the property indicated the use of a string type converter, but a type converter was not available. + 2 + + + + + + + + Gets a Boolean value specifying whether the value of the object is the default value as defined by the property value on the associated object. + true if the value of the object is the default value; otherwise, false. + 1 + + + Contains a collection of settings property values that map objects to objects. + 2 + + + Initializes a new instance of the class. + + + Adds a object to the collection. + A object. + An attempt was made to add an item to the collection, but the collection was marked as read-only. + 2 + + + Removes all objects from the collection. + 2 + + + Creates a copy of the existing collection. + A class. + 2 + + + Copies this collection to an array. + The array to copy the collection to. + The index at which to begin copying. + 2 + + + Gets a value that specifies the number of objects in the collection. + The number of objects in the collection. + 2 + + + Gets the object as it applies to the collection. + The object as it applies to the collection. + 2 + + + Gets a value that indicates whether access to the collection is synchronized (thread safe). + true if access to the collection is synchronized; otherwise, false. + 2 + + + Gets an item from the collection. + The object with the specified . + A object. + 2 + + + Removes a object from the collection. + The name of the object. + An attempt was made to remove an item from the collection, but the collection was marked as read-only. + 2 + + + Sets the collection to be read-only. + 2 + + + Gets the object to synchronize access to the collection. + The object to synchronize access to the collection. + 2 + + + Provides an exception that is thrown when an invalid type is used with a object. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class based on the supplied parameters. + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination of the serialized stream. + + + Initializes a new instance of the class based on the supplied parameter. + A string containing an exception message. + + + Initializes a new instance of the class based on the supplied parameters. + A string containing an exception message. + The exception that is the cause of the current exception. + + + Acts as a base class for deriving custom settings providers in the application settings architecture. + 2 + + + Initializes an instance of the class. + + + Gets or sets the name of the currently running application. + A that contains the application's shortened name, which does not contain a full path or extension, for example, SimpleAppSettings. + 2 + + + Returns the collection of settings property values for the specified application instance and settings property group. + A containing the values for the specified settings property group. + A describing the current application use. + A containing the settings property group whose values are to be retrieved. + 2 + + + Sets the values of the specified group of property settings. + A describing the current application usage. + A representing the group of property settings to set. + 2 + + + Specifies the settings provider used to provide storage for the current application settings class or property. This class cannot be inherited. + 1 + + + Initializes an instance of the class. + A containing the name of the settings provider. + + + Initializes a new instance of the class. + A containing the settings provider type. + + + Gets the type name of the settings provider. + A containing the name of the settings provider. + 2 + + + Represents a collection of application settings providers. + 2 + + + Initializes a new instance of the class. + + + Adds a new settings provider to the collection. + A to add to the collection. + The parameter is not of type . -or-The property of the provider parameter is null or an empty string.-or-A settings provider with the same already exists in the collection. + The collection is read-only. + The parameter is null. + 2 + + + Gets the settings provider in the collection that matches the specified name. + If found, the whose name matches that specified by the name parameter; otherwise, null. + A containing the friendly name of the settings provider. + The parameter is null. + The collection is read-only when setting this value. + 2 + + + Represents the method that will handle the event. + The source of the event, typically a data container or data-bound collection. + A that contains the event data. + 2 + + + Determines the serialization scheme used to store application settings. + 2 + + + The settings property is serialized as plain text. + + + The settings property is serialized as XML using XML serialization. + + + The settings property is serialized using binary object serialization. + + + The settings provider has implicit knowledge of the property or its type and picks an appropriate serialization mechanism. Often used for custom serialization. + + + Specifies the serialization mechanism that the settings provider should use. This class cannot be inherited. + 1 + + + Initializes an instance of the class. + A enumerated value that specifies the serialization scheme. + + + Gets the enumeration value that specifies the serialization scheme. + A enumerated value that specifies the serialization scheme. + 2 + + + Contains the XML representing the serialized value of the setting. This class cannot be inherited. + 2 + + + Initializes a new instance of the class. + + + Compares the current instance to the specified object. + true if the instance is equal to the specified object; otherwise, false. + The object to compare. + 2 + + + Gets a unique value representing the current instance. + A unique value representing the current instance. + 2 + + + Gets or sets the value of a object by using an object. + An object containing the value of a . + 2 + + + Handles configuration sections that are represented by a single XML tag in the .config file. + 2 + + + Initializes a new instance of the class. + + + Used internally to create a new instance of this object. + The created object handler. + The parent of this object. + The context of this object. + The object in the configuration. + 2 + + + Specifies the special setting category of a application settings property. + 2 + + + The configuration property represents a connection string, typically for a data store or network resource. + + + The configuration property represents a Uniform Resource Locator (URL) to a Web service. + + + Indicates that an application settings property has a special significance. This class cannot be inherited. + 1 + + + Initializes a new instance of the class. + A enumeration value defining the category of the application settings property. + + + Gets the value describing the special setting category of the application settings property. + A enumeration value defining the category of the application settings property. + 2 + + + Represents the Uri section within a configuration file. + + + Initializes a new instance of the class. + + + Gets an object that contains the configuration setting for International Domain Name (IDN) processing in the class. + The configuration setting for International Domain Name (IDN) processing in the class. + + + Gets an object that contains the configuration setting for International Resource Identifiers (IRI) parsing in the class. + The configuration setting for International Resource Identifiers (IRI) parsing in the class. + + + Gets a object that contains the configuration settings for scheme parsing in the class. + The configuration settings for scheme parsing in the class + + + Specifies that an application settings group or property contains distinct values for each user of an application. This class cannot be inherited. + 1 + + + Initializes a new instance of the class. + + + Represents a grouping of related user settings sections within a configuration file. This class cannot be inherited. + 2 + + + Initializes a new instance of the class. + + + Provides a simple on/off switch that controls debugging and tracing output. + 2 + + + Initializes a new instance of the class with the specified display name and description. + The name to display on a user interface. + The description of the switch. + + + Initializes a new instance of the class with the specified display name, description, and default switch value. + The name to display on the user interface. + The description of the switch. + The default value of the switch. + + + Gets or sets a value indicating whether the switch is enabled or disabled. + true if the switch is enabled; otherwise, false. The default is false. + The caller does not have the correct permission. + 2 + + + + + + + Determines whether the new value of the property can be parsed as a Boolean value. + + + Directs tracing or debugging output to either the standard output or the standard error stream. + 2 + + + Initializes a new instance of the class with trace output written to the standard output stream. + + + Initializes a new instance of the class with an option to write trace output to the standard output stream or the standard error stream. + true to write tracing and debugging output to the standard error stream; false to write tracing and debugging output to the standard output stream. + + + Closes the output to the stream specified for this trace listener. + + + Correlates traces that are part of a logical transaction. + 2 + + + Gets or sets the identity for a global activity. + A structure that identifies the global activity. + 1 + + + Gets the logical operation stack from the call context. + A object that represents the logical operation stack for the call context. + 1 + + + Starts a logical operation on a thread. + 1 + + + Starts a logical operation with the specified identity on a thread. + An object identifying the operation. + The parameter is null. + 1 + + + Stops the current logical operation. + The property is an empty stack. + 1 + + + Defines the counter type, name, and Help string for a custom counter. + 2 + + + Initializes a new instance of the class, to a counter of type NumberOfItems32, and with empty name and help strings. + + + Initializes a new instance of the class, to a counter of the specified type, using the specified counter name and Help strings. + The name of the counter, which must be unique within its category. + The text that describes the counter's behavior. + A that identifies the counter's behavior. + You have specified a value for that is not a member of the enumeration. + + is null. + + + Gets or sets the custom counter's description. + The text that describes the counter's behavior. + The specified value is null. + 2 + + + Gets or sets the name of the custom counter. + A name for the counter, which is unique in its category. + The specified value is null. + The specified value is not between 1 and 80 characters long or contains double quotes, control characters or leading or trailing spaces. + 2 + + + Gets or sets the performance counter type of the custom counter. + A that defines the behavior of the performance counter. + You have specified a type that is not a member of the enumeration. + 2 + + + + + + Provides a strongly typed collection of objects. + 2 + + + Initializes a new instance of the class, with no associated instances. + + + Initializes a new instance of the class by using the specified array of instances. + An array of instances with which to initialize this . + + is null. + + + Initializes a new instance of the class by using the specified collection of instances. + A that holds instances with which to initialize this . + + is null. + + + Adds an instance of the class to the collection. + The index of the new object. + A object to append to the existing collection. + + is null. + + is not a object. + 2 + + + Adds the specified array of instances to the collection. + An array of instances to append to the existing collection. + + is null. + 2 + + + Adds the specified collection of instances to the collection. + A collection of instances to append to the existing collection. + + is null. + 2 + + + Determines whether a instance exists in the collection. + true if the specified object exists in the collection; otherwise, false. + The object to find in the collection. + 2 + + + Copies the elements of the to an array, starting at the specified index of the array. + An array of instances to add to the collection. + The location at which to add the new instances. + + is null. + + is less than 0. + The number of elements in the is greater than the available space from to the end of the destination array. + 2 + + + Returns the index of a object in the collection. + The zero-based index of the specified , if it is found, in the collection; otherwise, -1. + The object to locate in the collection. + 2 + + + Inserts a object into the collection, at the specified index. + The zero-based index of the location at which the is to be inserted. + The to insert into the collection. + + is null. + + is not a object. + + is less than 0. -or- is greater than the number of items in the collection. + 2 + + + Indexes the collection. + The collection index, which is used to access individual elements of the collection. + An index into the . + + is less than 0.-or- is equal to or greater than the number of items in the collection. + 2 + + + Checks the specified object to determine whether it is a valid type. + The object that will be validated. + + is null. + + is not a object. + + + Removes a object from the collection. + The to remove from the collection. + + is null. + + is not a object.-or- does not exist in the collection. + 2 + + + Defines a structure that holds the raw data for a performance counter. + 2 + + + Initializes a new instance of the structure and sets the property to 0 (zero). + The numeric value associated with the performance counter sample. + An optional, base raw value for the counter, to use only if the sample is based on multiple counters. + The frequency with which the counter is read. + The frequency with which the system reads from the counter. + The raw time stamp. + The raw, high-fidelity time stamp. + A object that indicates the type of the counter for which this sample is a snapshot. + + + Initializes a new instance of the structure and sets the property to the value that is passed in. + The numeric value associated with the performance counter sample. + An optional, base raw value for the counter, to use only if the sample is based on multiple counters. + The frequency with which the counter is read. + The frequency with which the system reads from the counter. + The raw time stamp. + The raw, high-fidelity time stamp. + A object that indicates the type of the counter for which this sample is a snapshot. + The time at which the sample was taken. + + + Gets an optional, base raw value for the counter. + The base raw value, which is used only if the sample is based on multiple counters. + 2 + + + Calculates the performance data of the counter, using a single sample point. This method is generally used for uncalculated performance counter types. + The calculated performance value. + The structure to use as a base point for calculating performance data. + 1 + + + + + + + Calculates the performance data of the counter, using two sample points. This method is generally used for calculated performance counter types, such as averages. + The calculated performance value. + The structure to use as a base point for calculating performance data. + The structure to use as an ending point for calculating performance data. + 1 + + + + + + + Gets the raw counter frequency. + The frequency with which the counter is read. + 2 + + + Gets the counter's time stamp. + The time at which the sample was taken. + 2 + + + Gets the performance counter type. + A object that indicates the type of the counter for which this sample is a snapshot. + 2 + + + Defines an empty, uninitialized performance counter sample of type NumberOfItems32. + 1 + + + Indicates whether the specified structure is equal to the current structure. + true if is equal to the current instance; otherwise, false. + The structure to be compared with this instance. + + + Indicates whether the specified structure is a structure and is identical to the current structure. + true if is a structure and is identical to the current instance; otherwise, false. + The structure to be compared with the current structure. + + + Gets a hash code for the current counter sample. + A hash code for the current counter sample. + + + Returns a value that indicates whether two structures are equal. + true if and are equal; otherwise, false. + A structure. + Another structure to be compared to the structure specified by the parameter. + + + Returns a value that indicates whether two structures are not equal. + true if and are not equal; otherwise, false + A structure. + Another structure to be compared to the structure specified by the parameter. + + + Gets the raw value of the counter. + The numeric value that is associated with the performance counter sample. + 2 + + + Gets the raw system frequency. + The frequency with which the system reads from the counter. + 2 + + + Gets the raw time stamp. + The system time stamp. + 2 + + + Gets the raw, high-fidelity time stamp. + The system time stamp, represented within 0.1 millisecond. + 2 + + + Provides a set of utility functions for interpreting performance counter data. + 2 + + + Computes the calculated value of a single raw counter sample. + A floating-point representation of the performance counter's calculated value. + A that indicates the most recent sample the system has taken. + 1 + + + + + + + Computes the calculated value of two raw counter samples. + A floating-point representation of the performance counter's calculated value. + A that indicates a previous sample the system has taken. + A that indicates the most recent sample the system has taken. + + uses a counter type that is different from . + + counter type has a Performance Data Helper (PDH) error. For more information, see "Checking PDH Interface Return Values" in the Win32 and COM Development section of this documentation. + 1 + + + + + + + Provides data for the and events. + 2 + + + Gets the line of characters that was written to a redirected output stream. + The line that was written by an associated to its redirected or stream. + 2 + + + Represents the method that will handle the event or event of a . + The source of the event. + A that contains the event data. + 2 + + + Provides a set of methods and properties that help debug your code. This class cannot be inherited. + 1 + + + Checks for a condition; if the condition is false, displays a message box that shows the call stack. + The conditional expression to evaluate. If the condition is true, a failure message is not sent and the message box is not displayed. + 1 + + + + + + + Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack. + The conditional expression to evaluate. If the condition is true, the specified message is not sent and the message box is not displayed. + The message to send to the collection. + 1 + + + + + + + Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack. + The conditional expression to evaluate. If the condition is true, the specified messages are not sent and the message box is not displayed. + The message to send to the collection. + The detailed message to send to the collection. + 1 + + + + + + + Checks for a condition; if the condition is false, outputs two messages (simple and formatted) and displays a message box that shows the call stack. + The conditional expression to evaluate. If the condition is true, the specified messages are not sent and the message box is not displayed. + The message to send to the collection. + The composite format string (see Remarks) to send to the collection. This message contains text intermixed with zero or more format items, which correspond to objects in the array. + An object array that contains zero or more objects to format. + + + Gets or sets a value indicating whether should be called on the after every write. + true if is called on the after every write; otherwise, false. + 2 + + + + + + + Flushes the output buffer and then calls the Close method on each of the . + 2 + + + + + + + Emits the specified error message. + A message to emit. + 2 + + + + + + + Emits an error message and a detailed error message. + A message to emit. + A detailed message to emit. + 2 + + + + + + + Flushes the output buffer and causes buffered data to write to the collection. + 2 + + + + + + + Increases the current by one. + 2 + + + + + + + Gets or sets the indent level. + The indent level. The default is 0. + 2 + + + + + + + Gets or sets the number of spaces in an indent. + The number of spaces in an indent. The default is four. + 2 + + + + + + + Gets the collection of listeners that is monitoring the debug output. + A representing a collection of type that monitors the debug output. + 2 + + + + + + + Writes a message followed by a line terminator to the trace listeners in the collection. + The message to write. + 1 + + + + + + + Writes a formatted string followed by a line terminator to the trace listeners in the collection. + A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the array. + An object array containing zero or more objects to format. + + is null. + + is invalid.-or- The number that indicates an argument to format is less than zero, or greater than or equal to the number of specified objects to format. + 1 + + + + + + + Decreases the current by one. + 2 + + + + + + + Writes the value of the object's method to the trace listeners in the collection. + An object whose name is sent to the . + 2 + + + + + + + Writes a category name and the value of the object's method to the trace listeners in the collection. + An object whose name is sent to the . + A category name used to organize the output. + 2 + + + + + + + Writes a message to the trace listeners in the collection. + A message to write. + 2 + + + + + + + Writes a category name and message to the trace listeners in the collection. + A message to write. + A category name used to organize the output. + 2 + + + + + + + Writes the value of the object's method to the trace listeners in the collection if a condition is true. + The conditional expression to evaluate. If the condition is true, the value is written to the trace listeners in the collection. + An object whose name is sent to the . + 2 + + + + + + + Writes a category name and the value of the object's method to the trace listeners in the collection if a condition is true. + The conditional expression to evaluate. If the condition is true, the category name and value are written to the trace listeners in the collection. + An object whose name is sent to the . + A category name used to organize the output. + 2 + + + + + + + Writes a message to the trace listeners in the collection if a condition is true. + The conditional expression to evaluate. If the condition is true, the message is written to the trace listeners in the collection. + A message to write. + 2 + + + + + + + Writes a category name and message to the trace listeners in the collection if a condition is true. + The conditional expression to evaluate. If the condition is true, the category name and message are written to the trace listeners in the collection. + A message to write. + A category name used to organize the output. + 2 + + + + + + + Writes the value of the object's method to the trace listeners in the collection. + An object whose name is sent to the . + 2 + + + + + + + Writes a category name and the value of the object's method to the trace listeners in the collection. + An object whose name is sent to the . + A category name used to organize the output. + 2 + + + + + + + Writes a message followed by a line terminator to the trace listeners in the collection. + A message to write. + 2 + + + + + + + Writes a formatted message followed by a line terminator to the trace listeners in the collection. + A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the array. + An object array containing zero or more objects to format. + + + Writes a category name and message to the trace listeners in the collection. + A message to write. + A category name used to organize the output. + 2 + + + + + + + Writes the value of the object's method to the trace listeners in the collection if a condition is true. + The conditional expression to evaluate. If the condition is true, the value is written to the trace listeners in the collection. + An object whose name is sent to the . + 2 + + + + + + + Writes a category name and the value of the object's method to the trace listeners in the collection if a condition is true. + The conditional expression to evaluate. If the condition is true, the category name and value are written to the trace listeners in the collection. + An object whose name is sent to the . + A category name used to organize the output. + 2 + + + + + + + Writes a message to the trace listeners in the collection if a condition is true. + The conditional expression to evaluate. If the condition is true, the message is written to the trace listeners in the collection. + A message to write. + 2 + + + + + + + Writes a category name and message to the trace listeners in the collection if a condition is true. + true to cause a message to be written; otherwise, false. + A message to write. + A category name used to organize the output. + 2 + + + + + + + Provides the default output methods and behavior for tracing. + 1 + + + Initializes a new instance of the class with "Default" as its property value. + + + Gets or sets a value indicating whether the application is running in user-interface mode. + true if user-interface mode is enabled; otherwise, false. + 2 + + + + + + + Emits or displays a message and a stack trace for an assertion that always fails. + The message to emit or display. + 2 + + + + + + + + Emits or displays detailed messages and a stack trace for an assertion that always fails. + The message to emit or display. + The detailed message to emit or display. + 2 + + + + + + + + Gets or sets the name of a log file to write trace or debug messages to. + The name of a log file to write trace or debug messages to. + 2 + + + + + + + Writes the output to the OutputDebugString function and to the method. + The message to write to OutputDebugString and . + 2 + + + + + + + Writes the output to the OutputDebugString function and to the method, followed by a carriage return and line feed (\r\n). + The message to write to OutputDebugString and . + 2 + + + + + + + Directs tracing or debugging output to a text writer, such as a stream writer, or to a stream, such as a file stream. + 1 + + + Initializes a new instance of the class that writes to the specified output stream. + The to receive the output. + + is null. + + + Initializes a new instance of the class that writes to the specified output stream and has the specified name. + The to receive the output. + The name of the new instance of the trace listener. + + is null. + + + Initializes a new instance of the class that writes to the specified text writer. + The to receive the output. + + is null. + + + Initializes a new instance of the class that writes to the specified text writer and has the specified name. + The to receive the output. + The name of the new instance of the trace listener. + + is null. + + + Initializes a new instance of the class that writes to the specified file. + The name of the file to receive the output. + + is null. + + + Initializes a new instance of the class that writes to the specified file and has the specified name. + The name of the file to receive the output. + The name of the new instance of the trace listener. + + is null. + + + Gets or sets the delimiter for the delimited list. + The delimiter for the delimited list. + + is set to null. + + is set to an empty string (""). + 1 + + + Returns the custom configuration file attribute supported by the delimited trace listener. + A string array that contains the single value "delimiter". + + + Writes trace information, a data object, and event information to the output file or stream. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + One of the values specifying the type of event that has caused the trace. + A numeric identifier for the event. + A data object to write to the output file or stream. + 1 + + + Writes trace information, an array of data objects, and event information to the output file or stream. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + One of the values specifying the type of event that has caused the trace. + A numeric identifier for the event. + An array of data objects to write to the output file or stream. + 1 + + + Writes trace information, a message, and event information to the output file or stream. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + One of the values specifying the type of event that has caused the trace. + A numeric identifier for the event. + The trace message to write to the output file or stream. + 1 + + + Writes trace information, a formatted array of objects, and event information to the output file or stream. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + One of the values specifying the type of event that has caused the trace. + A numeric identifier for the event. + A format string that contains zero or more format items that correspond to objects in the array. + An array containing zero or more objects to format. + 1 + + + Handles the diagnostics section of configuration files. + 2 + + + Initializes a new instance of the class. + + + Parses the configuration settings for the <system.diagnostics> Element section of configuration files. + A new configuration object, in the form of a . + The object inherited from the parent path + Reserved. Used in ASP.NET to convey the virtual path of the configuration being evaluated. + The root XML node at the section to handle. + Switches could not be found.-or-Assert could not be found.-or-Trace could not be found.-or-Performance counters could not be found. + 2 + + + + + + + Provides data for the event. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified event log entry. + An that represents the entry that was written. + + + Gets the event log entry that was written to the log. + An that represents the entry that was written to the event log. + 2 + + + Represents the method that will handle the event of an . + The source of the event. + An that contains the event data. + 2 + + + Represents language-neutral information for an event log entry. + 2 + + + Initializes a new instance of the class using the specified resource identifiers for the localized message and category text of the event entry. + A resource identifier that corresponds to a string defined in the message resource file of the event source. + A resource identifier that corresponds to a string defined in the category resource file of the event source, or zero to specify no category for the event. + The parameter is a negative value or a value larger than .-or- The parameter is a negative value or a value larger than . + + + Initializes a new instance of the class using the specified resource identifiers for the localized message and category text of the event entry and the specified event log entry type. + A resource identifier that corresponds to a string defined in the message resource file of the event source. + A resource identifier that corresponds to a string defined in the category resource file of the event source, or zero to specify no category for the event. + An value that indicates the event type. + + is not a valid value. + + is a negative value or a value larger than .-or- is a negative value or a value larger than . + + + Gets or sets the resource identifier that specifies the application-defined category of the event entry. + A numeric category value or resource identifier that corresponds to a string defined in the category resource file of the event source. The default is zero, which signifies that no category will be displayed for the event entry. + The property is set to a negative value or to a value larger than . + 2 + + + Gets or sets the event type of the event log entry. + An value that indicates the event entry type. The default value is . + The property is not set to a valid value. + 2 + + + Gets or sets the resource identifier that designates the message text of the event entry. + A resource identifier that corresponds to a string defined in the message resource file of the event source. + The property is set to a negative value or to a value larger than . + 2 + + + Provides interaction with Windows event logs. + 1 + + + Initializes a new instance of the class. Does not associate the instance with any log. + + + Initializes a new instance of the class. Associates the instance with a log on the local computer. + The name of the log on the local computer. + The log name is null. + The log name is invalid. + + + Initializes a new instance of the class. Associates the instance with a log on the specified computer. + The name of the log on the specified computer. + The computer on which the log exists. + The log name is null. + The log name is invalid.-or- The computer name is invalid. + + + Initializes a new instance of the class. Associates the instance with a log on the specified computer and creates or assigns the specified source to the . + The name of the log on the specified computer + The computer on which the log exists. + The source of event log entries. + The log name is null. + The log name is invalid.-or- The computer name is invalid. + + + Begins the initialization of an used on a form or used by another component. The initialization occurs at runtime. + + is already initialized. + 2 + + + + + + + Removes all entries from the event log. + The event log was not cleared successfully.-or- The log cannot be opened. A Windows error code is not available. + A value is not specified for the property. Make sure the log name is not an empty string. + The log does not exist. + 2 + + + + + + + Closes the event log and releases read and write handles. + The event log's read handle or write handle was not released successfully. + 1 + + + + + + + Establishes a valid event source for writing localized event messages, using the specified configuration properties for the event source and the corresponding event log. + The configuration properties for the event source and its target event log. + The computer name specified in is not valid.- or - The source name specified in is null.- or - The log name specified in is not valid. Event log names must consist of printable characters and cannot include the characters '*', '?', or '\'.- or - The log name specified in is not valid for user log creation. The Event log names AppEvent, SysEvent, and SecEvent are reserved for system use.- or - The log name matches an existing event source name.- or - The source name specified in results in a registry key path longer than 254 characters.- or - The first 8 characters of the log name specified in are not unique.- or - The source name specified in is already registered.- or - The source name specified in matches an existing event log name. + The registry key for the event log could not be opened. + + is null. + 2 + + + + + + + + Establishes the specified source name as a valid event source for writing entries to a log on the local computer. This method can also create a new custom log on the local computer. + The source name by which the application is registered on the local computer. + The name of the log the source's entries are written to. Possible values include Application, System, or a custom event log. + + is an empty string ("") or null.- or - is not a valid event log name. Event log names must consist of printable characters, and cannot include the characters '*', '?', or '\'.- or - is not valid for user log creation. The event log names AppEvent, SysEvent, and SecEvent are reserved for system use.- or - The log name matches an existing event source name.- or - The source name results in a registry key path longer than 254 characters.- or - The first 8 characters of match the first 8 characters of an existing event log name.- or - The source cannot be registered because it already exists on the local computer.- or - The source name matches an existing event log name. + The registry key for the event log could not be opened on the local computer. + 2 + + + + + + + + Establishes the specified source name as a valid event source for writing entries to a log on the specified computer. This method can also be used to create a new custom log on the specified computer. + The source by which the application is registered on the specified computer. + The name of the log the source's entries are written to. Possible values include Application, System, or a custom event log. If you do not specify a value, defaults to Application. + The name of the computer to register this event source with, or "." for the local computer. + The is not a valid computer name.- or - is an empty string ("") or null.- or - is not a valid event log name. Event log names must consist of printable characters, and cannot include the characters '*', '?', or '\'.- or - is not valid for user log creation. The event log names AppEvent, SysEvent, and SecEvent are reserved for system use.- or - The log name matches an existing event source name.- or - The source name results in a registry key path longer than 254 characters.- or - The first 8 characters of match the first 8 characters of an existing event log name on the specified computer.- or - The source cannot be registered because it already exists on the specified computer.- or - The source name matches an existing event source name. + The registry key for the event log could not be opened on the specified computer. + 2 + + + + + + + + Removes an event log from the local computer. + The name of the log to delete. Possible values include: Application, Security, System, and any custom event logs on the computer. + + is an empty string ("") or null. + The registry key for the event log could not be opened on the local computer.- or - The log does not exist on the local computer. + The event log was not cleared successfully.-or- The log cannot be opened. A Windows error code is not available. + 1 + + + + + + + + + Removes an event log from the specified computer. + The name of the log to delete. Possible values include: Application, Security, System, and any custom event logs on the specified computer. + The name of the computer to delete the log from, or "." for the local computer. + + is an empty string ("") or null. - or - is not a valid computer name. + The registry key for the event log could not be opened on the specified computer.- or - The log does not exist on the specified computer. + The event log was not cleared successfully.-or- The log cannot be opened. A Windows error code is not available. + 1 + + + + + + + + + Removes the event source registration from the event log of the local computer. + The name by which the application is registered in the event log system. + The parameter does not exist in the registry of the local computer.- or - You do not have write access on the registry key for the event log. + 2 + + + + + + + + Removes the application's event source registration from the specified computer. + The name by which the application is registered in the event log system. + The name of the computer to remove the registration from, or "." for the local computer. + The parameter is invalid. - or - The parameter does not exist in the registry of the specified computer.- or - You do not have write access on the registry key for the event log. + + cannot be deleted because in the registry, the parent registry key for does not contain a subkey with the same name. + 2 + + + + + + + + Releases the unmanaged resources used by the , and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets or sets a value indicating whether the receives event notifications. + true if the receives notification when an entry is written to the log; otherwise, false. + The event log is on a remote computer. + 2 + + + + + + + Ends the initialization of an used on a form or by another component. The initialization occurs at runtime. + 2 + + + + + + + Gets the contents of the event log. + An holding the entries in the event log. Each entry is associated with an instance of the class. + 1 + + + + + + Occurs when an entry is written to an event log on the local computer. + 2 + + + Determines whether the log exists on the local computer. + true if the log exists on the local computer; otherwise, false. + The name of the log to search for. Possible values include: Application, Security, System, other application-specific logs (such as those associated with Active Directory), or any custom log on the computer. + The logName is null or the value is empty. + 1 + + + + + + + Determines whether the log exists on the specified computer. + true if the log exists on the specified computer; otherwise, false. + The log for which to search. Possible values include: Application, Security, System, other application-specific logs (such as those associated with Active Directory), or any custom log on the computer. + The name of the computer on which to search for the log, or "." for the local computer. + The parameter is an invalid format. Make sure you have used proper syntax for the computer on which you are searching.-or- The is null or the value is empty. + 1 + + + + + + + Searches for all event logs on the local computer and creates an array of objects that contain the list. + An array of type that represents the logs on the local computer. + You do not have read access to the registry.-or- There is no event log service on the computer. + 1 + + + + + + + Searches for all event logs on the given computer and creates an array of objects that contain the list. + An array of type that represents the logs on the given computer. + The computer on which to search for event logs. + The parameter is an invalid computer name. + You do not have read access to the registry.-or- There is no event log service on the computer. + 1 + + + + + + + Gets or sets the name of the log to read from or write to. + The name of the log. This can be Application, System, Security, or a custom log name. The default is an empty string (""). + 1 + + + Gets the event log's friendly name. + A name that represents the event log in the system's event viewer. + The specified does not exist in the registry for this computer. + 1 + + + + + + + + Gets the name of the log to which the specified source is registered. + The name of the log associated with the specified source in the registry. + The name of the event source. + The name of the computer on which to look, or "." for the local computer. + 1 + + + + + + + Gets or sets the name of the computer on which to read or write events. + The name of the server on which the event log resides. The default is the local computer ("."). + The computer name is invalid. + 1 + + + + + + + Gets or sets the maximum event log size in kilobytes. + The maximum event log size in kilobytes. The default is 512, indicating a maximum file size of 512 kilobytes. + The specified value is less than 64, or greater than 4194240, or not an even multiple of 64. + The value is not a valid log name.- or -The registry key for the event log could not be opened on the target computer. + 2 + + + + + + + + Gets the number of days to retain entries in the event log. + The number of days that entries in the event log are retained. The default value is 7. + 2 + + + + + + + + Changes the configured behavior for writing new entries when the event log reaches its maximum file size. + The overflow behavior for writing new entries to the event log. + The minimum number of days each event log entry is retained. This parameter is used only if is set to . + + is not a valid value. + + is less than one, or larger than 365. + The value is not a valid log name.- or -The registry key for the event log could not be opened on the target computer. + 2 + + + + + + + Gets the configured behavior for storing new entries when the event log reaches its maximum log file size. + The value that specifies the configured behavior for storing new entries when the event log reaches its maximum log size. The default is . + 2 + + + + + + + + Specifies the localized name of the event log, which is displayed in the server Event Viewer. + The fully specified path to a localized resource file. + The resource identifier that indexes a localized string within the resource file. + The value is not a valid log name.- or -The registry key for the event log could not be opened on the target computer. + + is null. + 2 + + + + + + + Gets or sets the source name to register and use when writing to the event log. + The name registered with the event log as a source of entries. The default is an empty string (""). + The source name results in a registry key path longer than 254 characters. + 1 + + + + + + + Determines whether an event source is registered on the local computer. + true if the event source is registered on the local computer; otherwise, false. + The name of the event source. + + was not found, but some or all of the event logs could not be searched. + 1 + + + + + + + Determines whether an event source is registered on a specified computer. + true if the event source is registered on the given computer; otherwise, false. + The name of the event source. + The name the computer on which to look, or "." for the local computer. + + is an invalid computer name. + + was not found, but some or all of the event logs could not be searched. + 1 + + + + + + + Gets or sets the object used to marshal the event handler calls issued as a result of an entry written event. + The used to marshal event-handler calls issued as a result of an event on the event log. + 2 + + + + + + Writes an information type entry, with the given message text, to the event log. + The string to write to the event log. + The property of the has not been set.-or- The method attempted to register a new event source, but the computer name in is not valid.- or -The source is already registered for a different event log.- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + The registry key for the event log could not be opened. + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an error, warning, information, success audit, or failure audit entry with the given message text to the event log. + The string to write to the event log. + One of the values. + The property of the has not been set.-or- The method attempted to register a new event source, but the computer name in is not valid.- or -The source is already registered for a different event log.- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + + is not a valid . + The registry key for the event log could not be opened. + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an entry with the given message text and application-defined event identifier to the event log. + The string to write to the event log. + One of the values. + The application-specific identifier for the event. + The property of the has not been set.-or- The method attempted to register a new event source, but the computer name in is not valid.- or -The source is already registered for a different event log.- or - is less than zero or greater than .- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + The registry key for the event log could not be opened. + + is not a valid . + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log. + The string to write to the event log. + One of the values. + The application-specific identifier for the event. + The application-specific subcategory associated with the message. + The property of the has not been set.-or- The method attempted to register a new event source, but the computer name in is not valid.- or -The source is already registered for a different event log.- or - is less than zero or greater than .- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + The registry key for the event log could not be opened. + + is not a valid . + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log, and appends binary data to the message. + The string to write to the event log. + One of the values. + The application-specific identifier for the event. + The application-specific subcategory associated with the message. + An array of bytes that holds the binary data associated with the entry. + The property of the has not been set.-or- The method attempted to register a new event source, but the computer name in is not valid.- or -The source is already registered for a different event log.- or - is less than zero or greater than .- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + The registry key for the event log could not be opened. + + is not a valid . + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an information type entry with the given message text to the event log, using the specified registered event source. + The source by which the application is registered on the specified computer. + The string to write to the event log. + The value is an empty string ("").- or -The value is null.- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + The registry key for the event log could not be opened. + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an error, warning, information, success audit, or failure audit entry with the given message text to the event log, using the specified registered event source. + The source by which the application is registered on the specified computer. + The string to write to the event log. + One of the values. + The value is an empty string ("").- or -The value is null.- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + The registry key for the event log could not be opened. + + is not a valid . + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an entry with the given message text and application-defined event identifier to the event log, using the specified registered event source. + The source by which the application is registered on the specified computer. + The string to write to the event log. + One of the values. + The application-specific identifier for the event. + The value is an empty string ("").- or -The value is null.- or - is less than zero or greater than .- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + The registry key for the event log could not be opened. + + is not a valid . + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log, using the specified registered event source. The can be used by the Event Viewer to filter events in the log. + The source by which the application is registered on the specified computer. + The string to write to the event log. + One of the values. + The application-specific identifier for the event. + The application-specific subcategory associated with the message. + The value is an empty string ("").- or -The value is null.- or - is less than zero or greater than .- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + The registry key for the event log could not be opened. + + is not a valid . + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an entry with the given message text, application-defined event identifier, and application-defined category to the event log (using the specified registered event source) and appends binary data to the message. + The source by which the application is registered on the specified computer. + The string to write to the event log. + One of the values. + The application-specific identifier for the event. + The application-specific subcategory associated with the message. + An array of bytes that holds the binary data associated with the entry. + The value is an empty string ("").- or -The value is null.- or - is less than zero or greater than .- or -The message string is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + + is not a valid . + The registry key for the event log could not be opened. + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an event log entry with the given event data, message replacement strings, and associated binary data. + An instance that represents a localized event log entry. + An array of bytes that holds the binary data associated with the entry. + An array of strings to merge into the message text of the event log entry. + The property of the has not been set.-or- The method attempted to register a new event source, but the computer name in is not valid.- or -The source is already registered for a different event log.- or - is less than zero or greater than .- or - has more than 256 elements.- or -One of the elements is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + + is null. + The registry key for the event log could not be opened. + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 2 + + + + + + + + Writes a localized entry to the event log. + An instance that represents a localized event log entry. + An array of strings to merge into the message text of the event log entry. + The property of the has not been set.-or- The method attempted to register a new event source, but the computer name in is not valid.- or -The source is already registered for a different event log.- or - is less than zero or greater than .- or - has more than 256 elements.- or -One of the elements is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + + is null. + The registry key for the event log could not be opened. + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 2 + + + + + + + + Writes an event log entry with the given event data, message replacement strings, and associated binary data, and using the specified registered event source. + The name of the event source registered for the application on the specified computer. + An instance that represents a localized event log entry. + An array of bytes that holds the binary data associated with the entry. + An array of strings to merge into the message text of the event log entry. + The value is an empty string ("").- or -The value is null.- or - is less than zero or greater than .- or - has more than 256 elements.- or -One of the elements is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + + is null. + The registry key for the event log could not be opened. + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Writes an event log entry with the given event data and message replacement strings, using the specified registered event source. + The name of the event source registered for the application on the specified computer. + An instance that represents a localized event log entry. + An array of strings to merge into the message text of the event log entry. + The value is an empty string ("").- or -The value is null.- or - is less than zero or greater than .- or - has more than 256 elements.- or -One of the elements is longer than 32766 bytes.- or -The source name results in a registry key path longer than 254 characters. + + is null. + The registry key for the event log could not be opened. + The operating system reported an error when writing the event entry to the event log. A Windows error code is not available. + 1 + + + + + + + + Encapsulates a single record in the event log. This class cannot be inherited. + 1 + + + Gets the text associated with the property for this entry. + The application-specific category text. + The space could not be allocated for one of the insertion strings associated with the category. + 1 + + + + + + + + + Gets the category number of the event log entry. + The application-specific category number for this entry. + 1 + + + Gets the binary data associated with the entry. + An array of bytes that holds the binary data associated with the entry. + 1 + + + Gets the event type of this entry. + The event type that is associated with the entry in the event log. + 1 + + + Performs a comparison between two event log entries. + true if the objects are identical; otherwise, false. + The to compare. + 1 + + + Gets the application-specific event identifier for the current event entry. + The application-specific identifier for the event message. + 3 + + + Gets the index of this entry in the event log. + The index of this entry in the event log. + 2 + + + Gets the resource identifier that designates the message text of the event entry. + A resource identifier that corresponds to a string definition in the message resource file of the event source. + 1 + + + Gets the name of the computer on which this entry was generated. + The name of the computer that contains the event log. + 1 + + + Gets the localized message associated with this event entry. + The formatted, localized text for the message. This includes associated replacement strings. + The space could not be allocated for one of the insertion strings associated with the message. + 1 + + + + + + + + + Gets the replacement strings associated with the event log entry. + An array that holds the replacement strings stored in the event entry. + 2 + + + Gets the name of the application that generated this event. + The name registered with the event log as the source of this event. + 1 + + + Populates a with the data needed to serialize the target object. + The to populate with data. + The destination (see ) for this serialization. + + + Gets the local time at which this event was generated. + The local time at which this event was generated. + 2 + + + Gets the local time at which this event was written to the log. + The local time at which this event was written to the log. + 1 + + + Gets the name of the user who is responsible for this event. + The security identifier (SID) that uniquely identifies a user or group. + Account information could not be obtained for the user's SID. + 1 + + + Defines size and enumerators for a collection of instances. + 2 + + + Copies the elements of the to an array of instances, starting at a particular array index. + The one-dimensional array of instances that is the destination of the elements copied from the collection. The array must have zero-based indexing. + The zero-based index in the array at which copying begins. + 2 + + + Gets the number of entries in the event log (that is, the number of elements in the collection). + The number of entries currently in the event log. + 2 + + + + + + + Supports a simple iteration over the object. + An object that can be used to iterate over the collection. + 2 + + + Gets an entry in the event log, based on an index that starts at 0 (zero). + The event log entry at the location that is specified by the parameter. + The zero-based index that is associated with the event log entry. + 2 + + + + + + + Copies the elements of the collection to an , starting at a particular index. + The one-dimensional that is the destination of the elements that are copied from the collection. The must have zero-based indexing. + The zero-based index in at which copying begins. + + + Gets a value that indicates whether access to the is synchronized (thread-safe). + false if access to the collection is not synchronized (thread-safe). + + + Gets an object that can be used to synchronize access to the object. + An object that can be used to synchronize access to the collection. + + + Specifies the event type of an event log entry. + 2 + + + An error event. This indicates a significant problem the user should know about; usually a loss of functionality or data. + + + A warning event. This indicates a problem that is not immediately significant, but that may signify conditions that could cause future problems. + + + An information event. This indicates a significant, successful operation. + + + A success audit event. This indicates a security event that occurs when an audited access attempt is successful; for example, logging on successfully. + + + A failure audit event. This indicates a security event that occurs when an audited access attempt fails; for example, a failed attempt to open a file. + + + Controls code access permissions for event logging. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified access levels and the name of the computer to use. + One of the enumeration values that specifies an access level. + The name of the computer on which to read or write events. + + + Initializes a new instance of the class with the specified permission entries. + An array of objects that represent permission entries. The property is set to this value. + + is null. + + + Initializes a new instance of the class with the specified permission state. + One of the enumeration values that specifies the permission state (full access or no access to resources). + The parameter is not a valid value of . + + + Gets the collection of permission entries for this permissions request. + A collection that contains the permission entries for this permissions request. + 2 + + + Defines access levels used by permission classes. + 2 + + + The has no permissions. + + + The can write to existing logs, and create event sources and logs. + + + The can create an event source, read existing logs, delete event sources or logs, respond to entries, clear an event log, listen to events, and access a collection of all event logs. + + + The can read existing logs. Note This member is now obsolete, use instead. + + + The can read or write to existing logs, and create event sources and logs. Note This member is now obsolete, use instead. + + + The can read existing logs, delete event sources or logs, respond to entries, clear an event log, listen to events, and access a collection of all event logs. Note This member is now obsolete, use instead. + + + Allows declaritive permission checks for event logging. + 1 + + + Initializes a new instance of the class. + One of the values. + + + Creates the permission based on the property and the requested access levels that are set through the property on the attribute. + An that represents the created permission. + 2 + + + + + + Gets or sets the name of the computer on which events might be read. + The name of the computer on which events might be read. The default is ".". + The computer name is invalid. + 2 + + + Gets or sets the access levels used in the permissions request. + A bitwise combination of the values. The default is . + 2 + + + Defines the smallest unit of a code access security permission that is set for an . + 2 + + + Initializes a new instance of the class. + A bitwise combination of the values. The property is set to this value. + The name of the computer on which to read or write events. The property is set to this value. + The computer name is invalid. + + + Gets the name of the computer on which to read or write events. + The name of the computer on which to read or write events. + 2 + + + Gets the permission access levels used in the permissions request. + A bitwise combination of the values. + 2 + + + Contains a strongly typed collection of objects. + 2 + + + Adds a specified to this collection. + The zero-based index of the added . + The to add. + 2 + + + Appends a set of specified permission entries to this collection. + An array of type objects that contains the permission entries to add. + + is null. + 2 + + + Appends a set of specified permission entries to this collection. + A that contains the permission entries to add. + + is null. + 2 + + + Determines whether this collection contains a specified . + true if the specified belongs to this collection; otherwise, false. + The to find. + 2 + + + Copies the permission entries from this collection to an array, starting at a particular index of the array. + An array of type that receives this collection's permission entries. + The zero-based index at which to begin copying the permission entries. + 2 + + + Determines the index of a specified permission entry in this collection. + The zero-based index of the specified permission entry, or -1 if the permission entry was not found in the collection. + The permission entry to search for. + 2 + + + Inserts a permission entry into this collection at a specified index. + The zero-based index of the collection at which to insert the permission entry. + The permission entry to insert into this collection. + 2 + + + Gets or sets the object at a specified index. + The that exists at the specified index. + The zero-based index into the collection. + 2 + + + Performs additional custom processes after clearing the contents of the collection. + + + Performs additional custom processes before a new permission entry is inserted into the collection. + The zero-based index at which to insert . + The new value of the permission entry at . + + + Performs additional custom processes when removing a new permission entry from the collection. + The zero-based index at which can be found. + The permission entry to remove from . + + + Performs additional custom processes before setting a value in the collection. + The zero-based index at which can be found. + The value to replace with . + The new value of the permission entry at . + + + Removes a specified permission entry from this collection. + The permission entry to remove. + 2 + + + Provides a simple listener that directs tracing or debugging output to an . + 2 + + + Initializes a new instance of the class without a trace listener. + + + Initializes a new instance of the class using the specified event log. + The event log to write to. + + + Initializes a new instance of the class using the specified source. + The name of an existing event log source. + + + Closes the event log so that it no longer receives tracing or debugging output. + 2 + + + + + + + Gets or sets the event log to write to. + The event log to write to. + 2 + + + Gets or sets the name of this . + The name of this trace listener. + 2 + + + + + + Writes trace information, a data object, and event information to the event log. + An object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output; typically the name of the application that generated the trace event. + One of the enumeration values that specifies the type of event that has caused the trace. + A numeric identifier for the event. The combination of and uniquely identifies an event. + A data object to write to the output file or stream. + + is not specified.-or-The log entry string exceeds 32,766 characters. + + + Writes trace information, an array of data objects, and event information to the event log. + An object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output; typically the name of the application that generated the trace event. + One of the enumeration values that specifies the type of event that has caused the trace. + A numeric identifier for the event. The combination of and uniquely identifies an event. + An array of data objects. + + is not specified.-or-The log entry string exceeds 32,766 characters. + + + Writes trace information, a message, and event information to the event log. + An object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output; typically the name of the application that generated the trace event. + One of the enumeration values that specifies the type of event that has caused the trace. + A numeric identifier for the event. The combination of and uniquely identifies an event. + The trace message. + + is not specified.-or-The log entry string exceeds 32,766 characters. + 1 + + + + + + + + Writes trace information, a formatted array of objects, and event information to the event log. + An object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output; typically the name of the application that generated the trace event. + One of the enumeration values that specifies the type of event that has caused the trace. + A numeric identifier for the event. The combination of and uniquely identifies an event. + A format string that contains zero or more format items that correspond to objects in the array. + An object array containing zero or more objects to format. + + is not specified.-or-The log entry string exceeds 32,766 characters. + 1 + + + + + + + + Writes a message to the event log for this instance. + The message to write. + + exceeds 32,766 characters. + 2 + + + + + + + + Writes a message to the event log for this instance. + The message to write. + + exceeds 32,766 characters. + 2 + + + + + + + + Represents the configuration settings used to create an event log source on the local computer or a remote computer. + 2 + + + Initializes a new instance of the class with a specified event source and event log name. + The name to register with the event log as a source of entries. + The name of the log to which entries from the source are written. + + + Gets or sets the number of categories in the category resource file. + The number of categories in the category resource file. The default value is zero. + The property is set to a negative value or to a value larger than . + 2 + + + Gets or sets the path of the resource file that contains category strings for the source. + The path of the category resource file. The default is an empty string (""). + 2 + + + Gets or sets the name of the event log to which the source writes entries. + The name of the event log. This can be Application, System, or a custom log name. The default value is "Application." + 2 + + + Gets or sets the name of the computer on which to register the event source. + The name of the system on which to register the event source. The default is the local computer ("."). + The computer name is invalid. + 2 + + + Gets or sets the path of the message resource file that contains message formatting strings for the source. + The path of the message resource file. The default is an empty string (""). + 2 + + + Gets or sets the path of the resource file that contains message parameter strings for the source. + The path of the parameter resource file. The default is an empty string (""). + 2 + + + Gets or sets the name to register with the event log as an event source. + The name to register with the event log as a source of entries. The default is an empty string (""). + 2 + + + Indicates whether a listener should trace based on the event type. + + + Initializes a new instance of the class. + A bitwise combination of the values that specifies the event type of the messages to trace. + + + Gets or sets the event type of the messages to trace. + A bitwise combination of the values. + + + Determines whether the trace listener should trace the event. + trueif the trace should be produced; otherwise, false. + A that represents the information cache for the trace event. + The name of the source. + One of the values. + A trace identifier number. + The format to use for writing an array of arguments, or a message to write. + An array of argument objects. + A trace data object. + An array of trace data objects. + + + Provides version information for a physical file on disk. + 2 + + + Gets the comments associated with the file. + The comments associated with the file or null if the file did not contain version information. + 2 + + + Gets the name of the company that produced the file. + The name of the company that produced the file or null if the file did not contain version information. + 2 + + + Gets the build number of the file. + A value representing the build number of the file or null if the file did not contain version information. + 2 + + + Gets the description of the file. + The description of the file or null if the file did not contain version information. + 2 + + + Gets the major part of the version number. + A value representing the major part of the version number or 0 (zero) if the file did not contain version information. + 2 + + + Gets the minor part of the version number of the file. + A value representing the minor part of the version number of the file or 0 (zero) if the file did not contain version information. + 2 + + + Gets the name of the file that this instance of describes. + The name of the file described by this instance of . + 2 + + + Gets the file private part number. + A value representing the file private part number or null if the file did not contain version information. + 2 + + + Gets the file version number. + The version number of the file or null if the file did not contain version information. + 2 + + + Returns a representing the version information associated with the specified file. + A containing information about the file. If the file did not contain version information, the contains only the name of the file requested. + The fully qualified path and name of the file to retrieve the version information for. + The file specified cannot be found. + 1 + + + Gets the internal name of the file, if one exists. + The internal name of the file. If none exists, this property will contain the original name of the file without the extension. + 2 + + + Gets a value that specifies whether the file contains debugging information or is compiled with debugging features enabled. + true if the file contains debugging information or is compiled with debugging features enabled; otherwise, false. + 2 + + + Gets a value that specifies whether the file has been modified and is not identical to the original shipping file of the same version number. + true if the file is patched; otherwise, false. + 2 + + + Gets a value that specifies whether the file is a development version, rather than a commercially released product. + true if the file is prerelease; otherwise, false. + 2 + + + Gets a value that specifies whether the file was built using standard release procedures. + true if the file is a private build; false if the file was built using standard release procedures or if the file did not contain version information. + 2 + + + Gets a value that specifies whether the file is a special build. + true if the file is a special build; otherwise, false. + 2 + + + Gets the default language string for the version info block. + The description string for the Microsoft Language Identifier in the version resource or null if the file did not contain version information. + 2 + + + Gets all copyright notices that apply to the specified file. + The copyright notices that apply to the specified file. + 2 + + + Gets the trademarks and registered trademarks that apply to the file. + The trademarks and registered trademarks that apply to the file or null if the file did not contain version information. + 2 + + + Gets the name the file was created with. + The name the file was created with or null if the file did not contain version information. + 2 + + + Gets information about a private version of the file. + Information about a private version of the file or null if the file did not contain version information. + 2 + + + Gets the build number of the product this file is associated with. + A value representing the build number of the product this file is associated with or null if the file did not contain version information. + 2 + + + Gets the major part of the version number for the product this file is associated with. + A value representing the major part of the product version number or null if the file did not contain version information. + 2 + + + Gets the minor part of the version number for the product the file is associated with. + A value representing the minor part of the product version number or null if the file did not contain version information. + 2 + + + Gets the name of the product this file is distributed with. + The name of the product this file is distributed with or null if the file did not contain version information. + 2 + + + Gets the private part number of the product this file is associated with. + A value representing the private part number of the product this file is associated with or null if the file did not contain version information. + 2 + + + Gets the version of the product this file is distributed with. + The version of the product this file is distributed with or null if the file did not contain version information. + 2 + + + Gets the special build information for the file. + The special build information for the file or null if the file did not contain version information. + 2 + + + Returns a partial list of properties in the and their values. + A list of the following properties in this class and their values: , , , , , , , , , , , ,.If the file did not contain version information, this list will contain only the name of the requested file. Boolean values will be false, and all other entries will be null. + 2 + + + Prepares performance data for the performance DLL the system loads when working with performance counters. + 2 + + + Called by the performance DLL's close performance data function. + 2 + + + Collects the performance data for the performance DLL. + The call index. + A pointer to a Unicode string list with the requested object identifiers. + A pointer to the data buffer. + A pointer to a number of bytes. + When this method returns, contains a to the first byte after the data, -1 for an error, or -2 if a larger buffer is required. This parameter is passed uninitialized. + 2 + + + Holds instance data associated with a performance counter sample. + 2 + + + Initializes a new instance of the InstanceData class, using the specified sample and performance counter instance. + The name of an instance associated with the performance counter. + A taken from the instance specified by the parameter. + + + Gets the instance name associated with this instance data. + The name of an instance associated with the performance counter. + 2 + + + Gets the raw data value associated with the performance counter sample. + The raw value read by the performance counter sample associated with the property. + 2 + + + Gets the performance counter sample that generated this data. + A taken from the instance specified by the property. + 2 + + + Provides a strongly typed collection of objects. + 2 + + + Initializes a new instance of the class, using the specified performance counter (which defines a performance instance). + The name of the counter, which often describes the quantity that is being counted. + The parameter is null. + + + Determines whether a performance instance with a specified name (identified by one of the indexed objects) exists in the collection. + true if the instance exists in the collection; otherwise, false. + The name of the instance to find in this collection. + The parameter is null. + 2 + + + Copies the items in the collection to the specified one-dimensional array at the specified index. + The one-dimensional that is the destination of the values copied from the collection. + The zero-based index value at which to add the new instances. + 2 + + + Gets the name of the performance counter whose instance data you want to get. + The performance counter name. + 2 + + + Gets the instance data associated with this counter. This is typically a set of raw counter values. + An item, by which the object is indexed. + The name of the performance counter category instance, or an empty string ("") if the category contains a single instance. + The parameter is null. + 2 + + + Gets the object and counter registry keys for the objects associated with this instance data. + An that represents a set of object-specific registry keys. + 2 + + + Gets the raw counter values that comprise the instance data for the counter. + An that represents the counter's raw data values. + 2 + + + Provides a strongly typed collection of objects. + 2 + + + Initializes a new instance of the class. + + + Determines whether an instance data collection for the specified counter (identified by one of the indexed objects) exists in the collection. + true if an instance data collection containing the specified counter exists in the collection; otherwise, false. + The name of the performance counter. + The parameter is null. + 2 + + + Copies an array of instances to the collection, at the specified index. + An array of instances (identified by the counters they contain) to add to the collection. + The location at which to add the new instances. + 2 + + + Gets the instance data for the specified counter. + An item, by which the object is indexed. + The name of the performance counter. + The parameter is null. + 2 + + + Gets the object and counter registry keys for the objects associated with this instance data collection. + An that represents a set of object-specific registry keys. + 2 + + + Gets the instance data values that comprise the collection of instances for the counter. + An that represents the counter's instances and their associated data values. + 2 + + + Specifies a description for a property or event. + 1 + + + Initializes a new instance of the class, using the specified description. + The application-defined description text. + + + Gets description text associated with the item monitored. + An application-defined description. + 2 + + + Specifies how to handle entries in an event log that has reached its maximum file size. + 2 + + + Indicates that existing entries are retained when the event log is full and new entries are discarded. + + + Indicates that each new entry overwrites the oldest entry when the event log is full. + + + Indicates that new events overwrite events older than specified by the property value when the event log is full. New events are discarded if the event log is full and there are no events older than specified by the property value. + + + Represents a Windows NT performance counter component. + 1 + + + Initializes a new, read-only instance of the class, without associating the instance with any system or custom performance counter. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + + + Initializes a new, read-only instance of the class and associates it with the specified system or custom performance counter on the local computer. This constructor requires that the category have a single instance. + The name of the performance counter category (performance object) with which this performance counter is associated. + The name of the performance counter. + + is an empty string ("").-or- is an empty string ("").-or- The category specified does not exist. -or-The category specified is marked as multi-instance and requires the performance counter to be created with an instance name.-or- and have been localized into different languages. + + or is null. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + + + Initializes a new, read-only or read/write instance of the class and associates it with the specified system or custom performance counter on the local computer. This constructor requires that the category contain a single instance. + The name of the performance counter category (performance object) with which this performance counter is associated. + The name of the performance counter. + true to access the counter in read-only mode (although the counter itself could be read/write); false to access the counter in read/write mode. + The is an empty string ("").-or- The is an empty string ("").-or- The category specified does not exist. (if is true). -or- The category specified is not a .NET Framework custom category (if is false). -or-The category specified is marked as multi-instance and requires the performance counter to be created with an instance name.-or- and have been localized into different languages. + + or is null. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + + + Initializes a new, read-only instance of the class and associates it with the specified system or custom performance counter and category instance on the local computer. + The name of the performance counter category (performance object) with which this performance counter is associated. + The name of the performance counter. + The name of the performance counter category instance, or an empty string (""), if the category contains a single instance. + + is an empty string ("").-or- is an empty string ("").-or- The category specified is not valid. -or-The category specified is marked as multi-instance and requires the performance counter to be created with an instance name.-or- is longer than 127 characters.-or- and have been localized into different languages. + + or is null. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + + + Initializes a new, read-only or read/write instance of the class and associates it with the specified system or custom performance counter and category instance on the local computer. + The name of the performance counter category (performance object) with which this performance counter is associated. + The name of the performance counter. + The name of the performance counter category instance, or an empty string (""), if the category contains a single instance. + true to access a counter in read-only mode; false to access a counter in read/write mode. + + is an empty string ("").-or- is an empty string ("").-or- The read/write permission setting requested is invalid for this counter.-or- The category specified does not exist (if is true). -or- The category specified is not a .NET Framework custom category (if is false). -or-The category specified is marked as multi-instance and requires the performance counter to be created with an instance name.-or- is longer than 127 characters.-or- and have been localized into different languages. + + or is null. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + + + Initializes a new, read-only instance of the class and associates it with the specified system or custom performance counter and category instance, on the specified computer. + The name of the performance counter category (performance object) with which this performance counter is associated. + The name of the performance counter. + The name of the performance counter category instance, or an empty string (""), if the category contains a single instance. + The computer on which the performance counter and its associated category exist. + + is an empty string ("").-or- is an empty string ("").-or- The read/write permission setting requested is invalid for this counter.-or- The counter does not exist on the specified computer. -or-The category specified is marked as multi-instance and requires the performance counter to be created with an instance name.-or- is longer than 127 characters.-or- and have been localized into different languages. + The parameter is not valid. + + or is null. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + + + Begins the initialization of a instance used on a form or by another component. The initialization occurs at runtime. + 2 + + + Gets or sets the name of the performance counter category for this performance counter. + The name of the performance counter category (performance object) with which this performance counter is associated. + The is null. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + 1 + + + Closes the performance counter and frees all the resources allocated by this performance counter instance. + 2 + + + Frees the performance counter library shared state allocated by the counters. + 2 + + + + + + + + + + Gets the description for this performance counter. + A description of the item or quantity that this performance counter measures. + The instance is not associated with a performance counter. -or-The property is set to when using global shared memory. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + 2 + + + + + + + + + Gets or sets the name of the performance counter that is associated with this instance. + The name of the counter, which generally describes the quantity being counted. This name is displayed in the list of counters of the Performance Counter Manager MMC snap in's Add Counters dialog box. + The is null. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + 1 + + + Gets the counter type of the associated performance counter. + A that describes both how the counter interacts with a monitoring application and the nature of the values it contains (for example, calculated or uncalculated). + The instance is not correctly associated with a performance counter. -or-The property is set to when using global shared memory. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + + Decrements the associated performance counter by one through an efficient atomic operation. + The decremented counter value. + The counter is read-only, so the application cannot decrement it.-or- The instance is not correctly associated with a performance counter. -or-The property is set to when using global shared memory. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + 1 + + + + + + + + + Specifies the size, in bytes, of the global memory shared by performance counters. The default size is 524,288 bytes. + 1 + + + Ends the initialization of a instance that is used on a form or by another component. The initialization occurs at runtime. + 2 + + + + + + + + + Increments the associated performance counter by one through an efficient atomic operation. + The incremented counter value. + The counter is read-only, so the application cannot increment it.-or- The instance is not correctly associated with a performance counter. -or-The property is set to when using global shared memory. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + 1 + + + + + + + + + Increments or decrements the value of the associated performance counter by a specified amount through an efficient atomic operation. + The new counter value. + The value to increment by. (A negative value decrements the counter.) + The counter is read-only, so the application cannot increment it.-or- The instance is not correctly associated with a performance counter. -or-The property is set to when using global shared memory. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + 1 + + + + + + + + + Gets or sets the lifetime of a process. + One of the values. The default is . + The value set is not a member of the enumeration. + + is set after the has been initialized. + + + Gets or sets an instance name for this performance counter. + The name of the performance counter category instance, or an empty string (""), if the counter is a single-instance counter. + 1 + + + Gets or sets the computer name for this performance counter + The server on which the performance counter and its associated category reside. + The format is invalid. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + 1 + + + Obtains a counter sample, and returns the raw, or uncalculated, value for it. + A that represents the next raw value that the system obtains for this counter. + The instance is not correctly associated with a performance counter. -or-The property is set to when using global shared memory. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + 2 + + + + + + + + + Obtains a counter sample and returns the calculated value for it. + The next calculated value that the system obtains for this counter. + The instance is not correctly associated with a performance counter. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + + Gets or sets the raw, or uncalculated, value of this counter. + The raw value of the counter. + You are trying to set the counter's raw value, but the counter is read-only.-or- The instance is not correctly associated with a performance counter. -or-The property is set to when using global shared memory. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + + Gets or sets a value indicating whether this instance is in read-only mode. + true, if the instance is in read-only mode (even if the counter itself is a custom .NET Framework counter); false if it is in read/write mode. The default is the value set by the constructor. + 1 + + + Deletes the category instance specified by the object property. + This counter is read-only, so any instance that is associated with the category cannot be removed.-or- The instance is not correctly associated with a performance counter. -or-The property is set to when using global shared memory. + An error occurred when accessing a system API. + The platform is Windows 98 or Windows Millennium Edition (Me), which does not support performance counters. + 1 + + + + + + + + + Represents a performance object, which defines a category of performance counters. + 2 + + + Initializes a new instance of the class, leaves the property empty, and sets the property to the local computer. + + + Initializes a new instance of the class, sets the property to the specified value, and sets the property to the local computer. + The name of the performance counter category, or performance object, with which to associate this instance. + The is an empty string (""). + The is null. + + + Initializes a new instance of the class and sets the and properties to the specified values. + The name of the performance counter category, or performance object, with which to associate this instance. + The computer on which the performance counter category and its associated counters exist. + The is an empty string ("").-or- The syntax is invalid. + The is null. + + + Gets the category's help text. + A description of the performance object that this category measures. + The property is null. The category name must be set before getting the category help. + A call to an underlying system API failed. + 2 + + + + + + + Gets or sets the name of the performance object that defines this category. + The name of the performance counter category, or performance object, with which to associate this instance. + The is an empty string (""). + The is null. + 2 + + + + + + Gets the performance counter category type. + One of the values. + 1 + + + Determines whether the specified counter is registered to this category, which is indicated by the and properties. + true if the counter is registered to the category that is specified by the and properties; otherwise, false. + The name of the performance counter to look for. + The is null. + The property has not been set. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 2 + + + + + + + + Determines whether the specified counter is registered to the specified category on the local computer. + true, if the counter is registered to the specified category on the local computer; otherwise, false. + The name of the performance counter to look for. + The name of the performance counter category, or performance object, with which the specified performance counter is associated. + The is null.-or- The is null. + The is an empty string (""). + The category name does not exist. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + Determines whether the specified counter is registered to the specified category on a remote computer. + true, if the counter is registered to the specified category on the specified computer; otherwise, false. + The name of the performance counter to look for. + The name of the performance counter category, or performance object, with which the specified performance counter is associated. + The name of the computer on which the performance counter category and its associated counters exist. + The is null.-or- The is null. + The is an empty string ("").-or- The is invalid. + The category name does not exist. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + Registers the custom performance counter category containing the specified counters on the local computer. + A that is associated with the new custom category, or performance object. + The name of the custom performance counter category to create and register with the system. + A description of the custom category. + A that specifies the counters to create as part of the new category. + A counter name that is specified within the collection is null or an empty string ("").-or- A counter that is specified within the collection already exists.-or- The parameter has invalid syntax. It might contain backslash characters ("\") or have length greater than 80 characters. + The parameter is null. + The category already exists on the local computer.-or- The layout of the collection is incorrect for base counters. A counter of type AverageCount64, AverageTimer32, CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100Ns, CounterMultiTimer100NsInverse, RawFraction, SampleFraction or SampleCounter has to be immediately followed by one of the base counter types (AverageBase, MultiBase, RawBase, or SampleBase). + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + + Registers the custom performance counter category containing the specified counters on the local computer. + A that is associated with the new custom category, or performance object. + The name of the custom performance counter category to create and register with the system. + A description of the custom category. + One of the values. + A that specifies the counters to create as part of the new category. + A counter name that is specified within the collection is null or an empty string ("").-or- A counter that is specified within the collection already exists.-or- has invalid syntax. It might contain backslash characters ("\") or have length greater than 80 characters. + + is null. -or- is null. + + value is outside of the range of the following values: MultiInstance, SingleInstance, or Unknown. + The category already exists on the local computer.-or- The layout of the collection is incorrect for base counters. A counter of type AverageCount64, AverageTimer32, CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100Ns, CounterMultiTimer100NsInverse, RawFraction, SampleFraction, or SampleCounter must be immediately followed by one of the base counter types (AverageBase, MultiBase, RawBase, or SampleBase). + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + Registers the custom performance counter category containing a single counter of type on the local computer. + A that is associated with the new system category, or performance object. + The name of the custom performance counter category to create and register with the system. + A description of the custom category. + One of the values specifying whether the category is , , or . + The name of a new counter to create as part of the new category. + A description of the counter that is associated with the new custom category. + + is null or is an empty string ("").-or- The counter that is specified by already exists.-or- has invalid syntax. It might contain backslash characters ("\") or have length greater than 80 characters. + The category already exists on the local computer. + + is null. -or- is null. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + Registers a custom performance counter category containing a single counter of type NumberOfItems32 on the local computer. + A that is associated with the new system category, or performance object. + The name of the custom performance counter category to create and register with the system. + A description of the custom category. + The name of a new counter, of type NumberOfItems32, to create as part of the new category. + A description of the counter that is associated with the new custom category. + + is null or is an empty string ("").-or- The counter that is specified by already exists.-or- has invalid syntax. It might contain backslash characters ("\") or have length greater than 80 characters. + The category already exists on the local computer. + + is null. -or- is null. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + + Removes the category and its associated counters from the local computer. + The name of the custom performance counter category to delete. + The parameter is null. + The parameter has invalid syntax. It might contain backslash characters ("\") or have length greater than 80 characters. + A call to an underlying system API failed. + The category cannot be deleted because it is not a custom category. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + Determines whether the category is registered on the local computer. + true if the category is registered; otherwise, false. + The name of the performance counter category to look for. + The parameter is null. + The parameter is an empty string (""). + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + Determines whether the category is registered on the specified computer. + true if the category is registered; otherwise, false. + The name of the performance counter category to look for. + The name of the computer to examine for the category. + The parameter is null. + The parameter is an empty string ("").-or- The parameter is invalid. + A call to an underlying system API failed. + The network path cannot be found. + The caller does not have the required permission.-or-Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + Retrieves a list of the performance counter categories that are registered on the local computer. + An array of objects indicating the categories that are registered on the local computer. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + Retrieves a list of the performance counter categories that are registered on the specified computer. + An array of objects indicating the categories that are registered on the specified computer. + The computer to look on. + The parameter is invalid. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + Retrieves a list of the counters in a performance counter category that contains exactly one instance. + An array of objects indicating the counters that are associated with this single-instance performance counter category. + The category is not a single instance. + A call to an underlying system API failed. + The category does not have an associated instance. + Code that is executing without administrative privileges attempted to read a performance counter. + 2 + + + + + + + Retrieves a list of the counters in a performance counter category that contains one or more instances. + An array of objects indicating the counters that are associated with the specified object instance of this performance counter category. + The performance object instance for which to retrieve the list of associated counters. + The parameter is null. + The property for this instance has not been set.-or- The category does not contain the instance that is specified by the parameter. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 2 + + + + + + + Retrieves the list of performance object instances that are associated with this category. + An array of strings representing the performance object instance names that are associated with this category or, if the category contains only one performance object instance, a single-entry array that contains an empty string (""). + The property is null. The property might not have been set. -or-The category does not have an associated instance. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 2 + + + + + + + + Determines whether the specified performance object instance exists in the category that is identified by this object's property. + true if the category contains the specified performance object instance; otherwise, false. + The performance object instance in this performance counter category to search for. + The property is null. The property might not have been set. + The parameter is null. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 2 + + + + + + + + Determines whether a specified category on the local computer contains the specified performance object instance. + true if the category contains the specified performance object instance; otherwise, false. + The performance object instance to search for. + The performance counter category to search. + The parameter is null.-or- The parameter is null. + The parameter is an empty string (""). + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + Determines whether a specified category on a specified computer contains the specified performance object instance. + true if the category contains the specified performance object instance; otherwise, false. + The performance object instance to search for. + The performance counter category to search. + The name of the computer on which to look for the category instance pair. + The parameter is null.-or- The parameter is null. + The parameter is an empty string ("").-or- The parameter is invalid. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 1 + + + + + + + + Gets or sets the name of the computer on which this category exists. + The name of the computer on which the performance counter category and its associated counters exist. + The syntax is invalid. + 2 + + + + + + Reads all the counter and performance object instance data that is associated with this performance counter category. + An that contains the counter and performance object instance data for the category. + The property is null. The property might not have been set. + A call to an underlying system API failed. + Code that is executing without administrative privileges attempted to read a performance counter. + 2 + + + + + + + Indicates whether the performance counter category can have multiple instances. + 1 + + + The instance functionality for the performance counter category is unknown. + + + The performance counter category can have only a single instance. + + + The performance counter category can have multiple instances. + + + Specifies the lifetime of a performance counter instance. + + + Remove the performance counter instance when no counters are using the process category. + + + Remove the performance counter instance when the process is closed. + + + Prepares performance data for the performance.dll the system loads when working with performance counters. + 2 + + + Initializes a new instance of the class. + + + Called by the perf dll's close performance data + + + Performance data collection routine. Called by the PerfCount perf dll. + The call index. + A pointer to a Unicode string list with the requested Object identifiers. + A pointer to the data buffer. + A pointer to a number of bytes. + When this method returns, contains a with a value of -1. + + + Allows control of code access permissions for . + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified access levels, the name of the computer to use, and the category associated with the performance counter. + One of the values. + The server on which the performance counter and its associate category reside. + The name of the performance counter category (performance object) with which the performance counter is associated. + + + Initializes a new instance of the class with the specified permission access level entries. + An array of objects. The property is set to this value. + + is null. + + + Initializes a new instance of the class with the specified permission state. + One of the values. + The parameter is not a valid value of . + + + Gets the collection of permission entries for this permissions request. + A that contains the permission entries for this permissions request. + 2 + + + Defines access levels used by permission classes. + 2 + + + The can read categories. + + + The can read and write categories. + + + The has no permissions. + + + The can read categories. + + + The can write categories. + + + The can read, write, and create categories. + + + Allows declaritive performance counter permission checks. + 1 + + + Initializes a new instance of the class. + One of the values. + + + Gets or sets the name of the performance counter category. + The name of the performance counter category (performance object). + The value is null. + 2 + + + Creates the permission based on the requested access levels that are set through the property on the attribute. + An that represents the created permission. + 2 + + + + + + Gets or sets the computer name for the performance counter. + The server on which the category of the performance counter resides. + The format is invalid. + 2 + + + Gets or sets the access levels used in the permissions request. + A bitwise combination of the values. The default is . + 2 + + + Defines the smallest unit of a code access security permission that is set for a . + 2 + + + Initializes a new instance of the class. + A bitwise combination of the values. The property is set to this value. + The server on which the category of the performance counter resides. + The name of the performance counter category (performance object) with which this performance counter is associated. + + is null.-or- is null. + + is not a valid value.-or- is not a valid computer name. + + + Gets the name of the performance counter category (performance object). + The name of the performance counter category (performance object). + 2 + + + Gets the name of the server on which the category of the performance counter resides. + The name of the server on which the category resides. + 2 + + + Gets the permission access level of the entry. + A bitwise combination of the values. + 2 + + + Contains a strongly typed collection of objects. + 2 + + + Adds a specified to this collection. + The zero-based index of the added object. + The object to add. + 2 + + + Appends a set of specified permission entries to this collection. + An array of type objects that contains the permission entries to add. + + is null. + 2 + + + Appends a set of specified permission entries to this collection. + A that contains the permission entries to add. + + is null. + 2 + + + Determines whether this collection contains a specified object. + true if the specified object belongs to this collection; otherwise, false. + The object to find. + 2 + + + Copies the permission entries from this collection to an array, starting at a particular index of the array. + An array of type that receives this collection's permission entries. + The zero-based index at which to begin copying the permission entries. + 2 + + + Determines the index of a specified permission entry in this collection. + The zero-based index of the specified permission entry, or -1 if the permission entry was not found in the collection. + The permission entry for which to search. + 2 + + + Inserts a permission entry into this collection at a specified index. + The zero-based index of the collection at which to insert the permission entry. + The permission entry to insert into this collection. + 2 + + + Gets or sets the object at a specified index. + The object that exists at the specified index. + The zero-based index into the collection. + 2 + + + Performs additional custom processes after clearing the contents of the collection. + + + Performs additional custom processes before a new permission entry is inserted into the collection. + The zero-based index at which to insert . + The new value of the permission entry at . + + + Performs additional custom processes when removing a new permission entry from the collection. + The zero-based index at which can be found. + The permission entry to remove from . + + + Performs additional custom processes before setting a value in the collection. + The zero-based index at which can be found. + The value to replace with . + The new value of the permission entry at . + + + Removes a specified permission entry from this collection. + The permission entry to remove. + 2 + + + Specifies the formula used to calculate the method for a instance. + 2 + + + An instantaneous counter that shows the most recently observed value. Used, for example, to maintain a simple count of items or operations. + + + An instantaneous counter that shows the most recently observed value. Used, for example, to maintain a simple count of a very large number of items or operations. It is the same as NumberOfItems32 except that it uses larger fields to accommodate larger values. + + + An instantaneous counter that shows the most recently observed value in hexadecimal format. Used, for example, to maintain a simple count of items or operations. + + + An instantaneous counter that shows the most recently observed value. Used, for example, to maintain a simple count of a very large number of items or operations. It is the same as NumberOfItemsHEX32 except that it uses larger fields to accommodate larger values. + + + A difference counter that shows the average number of operations completed during each second of the sample interval. Counters of this type measure time in ticks of the system clock. + + + A difference counter that shows the average number of operations completed during each second of the sample interval. Counters of this type measure time in ticks of the system clock. This counter type is the same as the RateOfCountsPerSecond32 type, but it uses larger fields to accommodate larger values to track a high-volume number of items or operations per second, such as a byte-transmission rate. + + + An average counter designed to monitor the average length of a queue to a resource over time. It shows the difference between the queue lengths observed during the last two sample intervals divided by the duration of the interval. This type of counter is typically used to track the number of items that are queued or waiting. + + + An average counter that monitors the average length of a queue to a resource over time. Counters of this type display the difference between the queue lengths observed during the last two sample intervals, divided by the duration of the interval. This counter type is the same as CountPerTimeInterval32 except that it uses larger fields to accommodate larger values. This type of counter is typically used to track a high-volume or very large number of items that are queued or waiting. + + + An instantaneous percentage counter that shows the ratio of a subset to its set as a percentage. For example, it compares the number of bytes in use on a disk to the total number of bytes on the disk. Counters of this type display the current percentage only, not an average over time. + + + A base counter that stores the denominator of a counter that presents a general arithmetic fraction. Check that this value is greater than zero before using it as the denominator in a RawFraction value calculation. + + + An average counter that measures the time it takes, on average, to complete a process or operation. Counters of this type display a ratio of the total elapsed time of the sample interval to the number of processes or operations completed during that time. This counter type measures time in ticks of the system clock. + + + A base counter that is used in the calculation of time or count averages, such as AverageTimer32 and AverageCount64. Stores the denominator for calculating a counter to present "time per operation" or "count per operation". + + + An average counter that shows how many items are processed, on average, during an operation. Counters of this type display a ratio of the items processed to the number of operations completed. The ratio is calculated by comparing the number of items processed during the last interval to the number of operations completed during the last interval. + + + A percentage counter that shows the average ratio of hits to all operations during the last two sample intervals. + + + An average counter that shows the average number of operations completed in one second. When a counter of this type samples the data, each sampling interrupt returns one or zero. The counter data is the number of ones that were sampled. It measures time in units of ticks of the system performance timer. + + + A base counter that stores the number of sampling interrupts taken and is used as a denominator in the sampling fraction. The sampling fraction is the number of samples that were 1 (or true) for a sample interrupt. Check that this value is greater than zero before using it as the denominator in a calculation of SampleFraction. + + + A percentage counter that shows the average time that a component is active as a percentage of the total sample time. + + + A percentage counter that displays the average percentage of active time observed during sample interval. The value of these counters is calculated by monitoring the percentage of time that the service was inactive and then subtracting that value from 100 percent. + + + A percentage counter that shows the active time of a component as a percentage of the total elapsed time of the sample interval. It measures time in units of 100 nanoseconds (ns). Counters of this type are designed to measure the activity of one component at a time. + + + A percentage counter that shows the average percentage of active time observed during the sample interval. + + + A difference timer that shows the total time between when the component or process started and the time when this value is calculated. + + + A percentage counter that displays the active time of one or more components as a percentage of the total time of the sample interval. Because the numerator records the active time of components operating simultaneously, the resulting percentage can exceed 100 percent. + + + A percentage counter that shows the active time of one or more components as a percentage of the total time of the sample interval. It derives the active time by measuring the time that the components were not active and subtracting the result from 100 percent by the number of objects monitored. + + + A percentage counter that shows the active time of one or more components as a percentage of the total time of the sample interval. It measures time in 100 nanosecond (ns) units. + + + A percentage counter that shows the active time of one or more components as a percentage of the total time of the sample interval. Counters of this type measure time in 100 nanosecond (ns) units. They derive the active time by measuring the time that the components were not active and subtracting the result from multiplying 100 percent by the number of objects monitored. + + + A base counter that indicates the number of items sampled. It is used as the denominator in the calculations to get an average among the items sampled when taking timings of multiple, but similar items. Used with CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100Ns, and CounterMultiTimer100NsInverse. + + + A difference counter that shows the change in the measured attribute between the two most recent sample intervals. + + + A difference counter that shows the change in the measured attribute between the two most recent sample intervals. It is the same as the CounterDelta32 counter type except that is uses larger fields to accomodate larger values. + + + Provides access to local and remote processes and enables you to start and stop local system processes. + 1 + + + Initializes a new instance of the class. + + + Gets the base priority of the associated process. + The base priority, which is computed from the of the associated process. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set the property to false to access this property on Windows 98 and Windows Me. + The process has exited.-or- The process has not started, so there is no process ID. + 2 + + + Begins asynchronous read operations on the redirected stream of the application. + The property is false.- or - An asynchronous read operation is already in progress on the stream.- or - The stream has been used by a synchronous read operation. + 2 + + + Begins asynchronous read operations on the redirected stream of the application. + The property is false.- or - An asynchronous read operation is already in progress on the stream.- or - The stream has been used by a synchronous read operation. + 2 + + + Cancels the asynchronous read operation on the redirected stream of an application. + The stream is not enabled for asynchronous read operations. + 2 + + + Cancels the asynchronous read operation on the redirected stream of an application. + The stream is not enabled for asynchronous read operations. + 2 + + + Frees all the resources that are associated with this component. + 2 + + + Closes a process that has a user interface by sending a close message to its main window. + true if the close message was successfully sent; false if the associated process does not have a main window or if the main window is disabled (for example if a modal dialog is being shown). + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set the property to false to access this property on Windows 98 and Windows Me. + The process has already exited. -or-No process is associated with this object. + 1 + + + Release all resources used by this process. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets or sets whether the event should be raised when the process terminates. + true if the event should be raised when the associated process is terminated (through either an exit or a call to ); otherwise, false. The default is false. + 2 + + + Puts a component in state to interact with operating system processes that run in a special mode by enabling the native property SeDebugPrivilege on the current thread. + 2 + + + Occurs when an application writes to its redirected stream. + 2 + + + Gets the value that the associated process specified when it terminated. + The code that the associated process specified when it terminated. + The process has not exited.-or- The process is not valid. + You are trying to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + 1 + + + Occurs when a process exits. + 2 + + + Gets the time that the associated process exited. + A that indicates when the associated process was terminated. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + You are trying to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + 1 + + + Gets a new component and associates it with the currently active process. + A new component associated with the process resource that is running the calling application. + 1 + + + Returns a new component, given the identifier of a process on the local computer. + A component that is associated with the local process resource identified by the parameter. + The system-unique identifier of a process resource. + The process specified by the parameter is not running. The identifier might be expired. + The process was not started by this object. + 1 + + + Returns a new component, given a process identifier and the name of a computer on the network. + A component that is associated with a remote process resource identified by the parameter. + The system-unique identifier of a process resource. + The name of a computer on the network. + The process specified by the parameter is not running. The identifier might be expired.-or- The parameter syntax is invalid. The name might have length zero (0). + The parameter is null. + The process was not started by this object. + 1 + + + Creates a new component for each process resource on the local computer. + An array of type that represents all the process resources running on the local computer. + 1 + + + Creates a new component for each process resource on the specified computer. + An array of type that represents all the process resources running on the specified computer. + The computer from which to read the list of processes. + The parameter syntax is invalid. It might have length zero (0). + The parameter is null. + The operating system platform does not support this operation on remote computers. + There are problems accessing the performance counter API's used to get process information. This exception is specific to Windows NT, Windows 2000, and Windows XP. + A problem occurred accessing an underlying system API. + 1 + + + Creates an array of new components and associates them with all the process resources on the local computer that share the specified process name. + An array of type that represents the process resources running the specified application or file. + The friendly name of the process. + There are problems accessing the performance counter API's used to get process information. This exception is specific to Windows NT, Windows 2000, and Windows XP. + 1 + + + Creates an array of new components and associates them with all the process resources on a remote computer that share the specified process name. + An array of type that represents the process resources running the specified application or file. + The friendly name of the process. + The name of a computer on the network. + The parameter syntax is invalid. It might have length zero (0). + The parameter is null. + The operating system platform does not support this operation on remote computers. + There are problems accessing the performance counter API's used to get process information. This exception is specific to Windows NT, Windows 2000, and Windows XP. + A problem occurred accessing an underlying system API. + 1 + + + Gets the native handle of the associated process. + The handle that the operating system assigned to the associated process when the process was started. The system uses this handle to keep track of process attributes. + The process has not been started or has exited. The property cannot be read because there is no process associated with this instance.-or- The instance has been attached to a running process but you do not have the necessary permissions to get a handle with full access rights. + You are trying to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + 1 + + + Gets the number of handles opened by the process. + The number of operating system handles the process has opened. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set the property to false to access this property on Windows 98 and Windows Me. + 2 + + + Gets a value indicating whether the associated process has been terminated. + true if the operating system process referenced by the component has terminated; otherwise, false. + There is no process associated with the object. + The exit code for the process could not be retrieved. + You are trying to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + 1 + + + Gets the unique identifier for the associated process. + The system-generated unique identifier of the process that is referenced by this instance. + The process's property has not been set.-or- There is no process associated with this object. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set the property to false to access this property on Windows 98 and Windows Me. + 1 + + + Immediately stops the associated process. + The associated process could not be terminated. -or-The process is terminating.-or- The associated process is a Win16 executable. + You are attempting to call for a process that is running on a remote computer. The method is available only for processes running on the local computer. + The process has already exited. -or-There is no process associated with this object. + 1 + + + Takes a component out of the state that lets it interact with operating system processes that run in a special mode. + 2 + + + Gets the name of the computer the associated process is running on. + The name of the computer that the associated process is running on. + There is no process associated with this object. + 1 + + + Gets the main module for the associated process. + The that was used to start the process. + You are trying to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set to false to access this property on Windows 98 and Windows Me. + The process is not available.-or- The process has exited. + 1 + + + Gets the window handle of the main window of the associated process. + The system-generated window handle of the main window of the associated process. + The is not defined because the process has exited. + You are trying to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set to false to access this property on Windows 98 and Windows Me. + 2 + + + Gets the caption of the main window of the process. + The main window title of the process. + The property is not defined because the process has exited. + You are trying to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set to false to access this property on Windows 98 and Windows Me. + 1 + + + Gets or sets the maximum allowable working set size for the associated process. + The maximum working set size that is allowed in memory for the process, in bytes. + The maximum working set size is invalid. It must be greater than or equal to the minimum working set size. + Working set information cannot be retrieved from the associated process resource.-or- The process identifier or process handle is zero because the process has not been started. + You are trying to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The process is not available.-or- The process has exited. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets or sets the minimum allowable working set size for the associated process. + The minimum working set size that is required in memory for the process, in bytes. + The minimum working set size is invalid. It must be less than or equal to the maximum working set size. + Working set information cannot be retrieved from the associated process resource.-or- The process identifier or process handle is zero because the process has not been started. + You are trying to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The process is not available.-or- The process has exited. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the modules that have been loaded by the associated process. + An array of type that represents the modules that have been loaded by the associated process. + You are attempting to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The process is not available. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set to false to access this property on Windows 98 and Windows Me. + You are attempting to access the property for either the system process or the idle process. These processes do not have modules. + 2 + + + Gets the nonpaged system memory size allocated to this process. + The amount of memory, in bytes, the system has allocated for the associated process that cannot be written to the virtual memory paging file. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the amount of nonpaged system memory allocated for the associated process. + The amount of system memory, in bytes, allocated for the associated process that cannot be written to the virtual memory paging file. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Raises the event. + + + Occurs when an application writes to its redirected stream. + 2 + + + Gets the paged memory size. + The amount of memory, in bytes, allocated by the associated process that can be written to the virtual memory paging file. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the amount of paged memory allocated for the associated process. + The amount of memory, in bytes, allocated in the virtual memory paging file for the associated process. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the paged system memory size. + The amount of memory, in bytes, the system has allocated for the associated process that can be written to the virtual memory paging file. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the amount of pageable system memory allocated for the associated process. + The amount of system memory, in bytes, allocated for the associated process that can be written to the virtual memory paging file. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the peak paged memory size. + The maximum amount of memory, in bytes, allocated by the associated process that could be written to the virtual memory paging file. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the maximum amount of memory in the virtual memory paging file used by the associated process. + The maximum amount of memory, in bytes, allocated in the virtual memory paging file for the associated process since it was started. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the peak virtual memory size. + The maximum amount of virtual memory, in bytes, that the associated process has requested. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the maximum amount of virtual memory used by the associated process. + The maximum amount of virtual memory, in bytes, allocated for the associated process since it was started. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the peak working set size for the associated process. + The maximum amount of physical memory that the associated process has required all at once, in bytes. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the maximum amount of physical memory used by the associated process. + The maximum amount of physical memory, in bytes, allocated for the associated process since it was started. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets or sets a value indicating whether the associated process priority should temporarily be boosted by the operating system when the main window has the focus. + true if dynamic boosting of the process priority should take place for a process when it is taken out of the wait state; otherwise, false. The default is false. + Priority boost information could not be retrieved from the associated process resource. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property.-or- The process identifier or process handle is zero. (The process has not been started.) + You are attempting to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The process is not available. + 1 + + + Gets or sets the overall priority category for the associated process. + The priority category for the associated process, from which the of the process is calculated. + Process priority information could not be set or retrieved from the associated process resource.-or- The process identifier or process handle is zero. (The process has not been started.) + You are attempting to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The process is not available. + You have set the to AboveNormal or BelowNormal when using Windows 98 or Windows Millennium Edition (Windows Me). These platforms do not support those values for the priority class. + Priority class cannot be set because it does not use a valid value, as defined in the enumeration. + 1 + + + Gets the private memory size. + The number of bytes allocated by the associated process that cannot be shared with other processes. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the amount of private memory allocated for the associated process. + The amount of memory, in bytes, allocated for the associated process that cannot be shared with other processes. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the privileged processor time for this process. + A that indicates the amount of time that the process has spent running code inside the operating system core. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + You are attempting to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + 2 + + + Gets the name of the process. + The name that the system uses to identify the process to the user. + The process does not have an identifier, or no process is associated with the .-or- The associated process has exited. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set to false to access this property on Windows 98 and Windows Me. + The process is not on this computer. + 1 + + + Gets or sets the processors on which the threads in this process can be scheduled to run. + A bitmask representing the processors that the threads in the associated process can run on. The default depends on the number of processors on the computer. The default value is 2 n -1, where n is the number of processors. + + information could not be set or retrieved from the associated process resource.-or- The process identifier or process handle is zero. (The process has not been started.) + You are attempting to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The process was not available.-or- The process has exited. + 2 + + + Discards any information about the associated process that has been cached inside the process component. + 1 + + + Gets a value indicating whether the user interface of the process is responding. + true if the user interface of the associated process is responding to the system; otherwise, false. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set to false to access this property on Windows 98 and Windows Me. + There is no process associated with this object. + You are attempting to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + 1 + + + Gets the Terminal Services session identifier for the associated process. + The Terminal Services session identifier for the associated process. + There is no session associated with this process. + There is no process associated with this session identifier.-or-The associated process is not on this machine. + The property is not supported on Windows 98. + 1 + + + Gets a stream used to read the error output of the application. + A that can be used to read the standard error stream of the application. + The stream has not been defined for redirection; ensure is set to true and is set to false.- or - The stream has been opened for asynchronous read operations with . + 1 + + + Gets a stream used to write the input of the application. + A that can be used to write the standard input stream of the application. + The stream has not been defined because is set to false. + 1 + + + Gets a stream used to read the output of the application. + A that can be used to read the standard output stream of the application. + The stream has not been defined for redirection; ensure is set to true and is set to false.- or - The stream has been opened for asynchronous read operations with . + 1 + + + Starts (or reuses) the process resource that is specified by the property of this component and associates it with the component. + true if a process resource is started; false if no new process resource is started (for example, if an existing process is reused). + No file name was specified in the component's .-or- The member of the property is true while , , or is true. + There was an error in opening the associated file. + The process object has already been disposed. + 1 + + + Starts the process resource that is specified by the parameter containing process start information (for example, the file name of the process to start) and associates the resource with a new component. + A new component that is associated with the process resource, or null if no process resource is started (for example, if an existing process is reused). + The that contains the information that is used to start the process, including the file name and any command-line arguments. + No file name was specified in the parameter's property.-or- The property of the parameter is true and the , , or property is also true.-or-The property of the parameter is true and the property is not null or empty or the property is not null. + The parameter is null. + The process object has already been disposed. + The file specified in the parameter's property could not be found. + An error occurred when opening the associated file. -or-The sum of the length of the arguments and the length of the full path to the process exceeds 2080. The error message associated with this exception can be one of the following: "The data area passed to a system call is too small." or "Access is denied." + 1 + + + Starts a process resource by specifying the name of a document or application file and associates the resource with a new component. + A new component that is associated with the process resource, or null, if no process resource is started (for example, if an existing process is reused). + The name of a document or application file to run in the process. + An error occurred when opening the associated file. + The process object has already been disposed. + The PATH environment variable has a string containing quotes. + 1 + + + Starts a process resource by specifying the name of an application and a set of command-line arguments, and associates the resource with a new component. + A new component that is associated with the process, or null, if no process resource is started (for example, if an existing process is reused). + The name of an application file to run in the process. + Command-line arguments to pass when starting the process. + The or parameter is null. + An error occurred when opening the associated file. -or-The sum of the length of the arguments and the length of the full path to the process exceeds 2080. The error message associated with this exception can be one of the following: "The data area passed to a system call is too small." or "Access is denied." + The process object has already been disposed. + The PATH environment variable has a string containing quotes. + 1 + + + Starts a process resource by specifying the name of an application, a user name, a password, and a domain and associates the resource with a new component. + A new component that is associated with the process resource, or null if no process resource is started (for example, if an existing process is reused). + The name of an application file to run in the process. + The user name to use when starting the process. + A that contains the password to use when starting the process. + The domain to use when starting the process. + No file name was specified. + + is not an executable (.exe) file. + There was an error in opening the associated file. + The process object has already been disposed. + 1 + + + Starts a process resource by specifying the name of an application, a set of command-line arguments, a user name, a password, and a domain and associates the resource with a new component. + A new component that is associated with the process resource, or null if no process resource is started (for example, if an existing process is reused). + The name of an application file to run in the process. + Command-line arguments to pass when starting the process. + The user name to use when starting the process. + A that contains the password to use when starting the process. + The domain to use when starting the process. + No file name was specified. + + is not an executable (.exe) file. + An error occurred when opening the associated file. -or-The sum of the length of the arguments and the length of the full path to the associated file exceeds 2080. The error message associated with this exception can be one of the following: "The data area passed to a system call is too small." or "Access is denied." + The process object has already been disposed. + 1 + + + Gets or sets the properties to pass to the method of the . + The that represents the data with which to start the process. These arguments include the name of the executable file or document used to start the process. + The value that specifies the is null. + 1 + + + Gets the time that the associated process was started. + A that indicates when the process started. This only has meaning for started processes. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + You are attempting to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + The process has exited. + An error occurred in the call to the Windows function. + 1 + + + Gets or sets the object used to marshal the event handler calls that are issued as a result of a process exit event. + The used to marshal event handler calls that are issued as a result of an event on the process. + 2 + + + Gets the set of threads that are running in the associated process. + An array of type representing the operating system threads currently running in the associated process. + The process does not have an , or no process is associated with the instance.-or- The associated process has exited. + The platform is Windows 98 or Windows Millennium Edition (Windows Me); set to false to access this property on Windows 98 and Windows Me. + 1 + + + Formats the process's name as a string, combined with the parent component type, if applicable. + The , combined with the base component's return value. + + is not supported on Windows 98. + 2 + + + Gets the total processor time for this process. + A that indicates the amount of time that the associated process has spent utilizing the CPU. This value is the sum of the and the . + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + You are attempting to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + 2 + + + Gets the user processor time for this process. + A that indicates the amount of time that the associated process has spent running code inside the application portion of the process (not inside the operating system core). + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + You are attempting to access the property for a process that is running on a remote computer. This property is available only for processes that are running on the local computer. + 2 + + + Gets the size of the process's virtual memory. + The amount of virtual memory, in bytes, that the associated process has requested. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the amount of the virtual memory allocated for the associated process. + The amount of virtual memory, in bytes, allocated for the associated process. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Instructs the component to wait indefinitely for the associated process to exit. + The wait setting could not be accessed. + No process has been set, and a from which the property can be determined does not exist.-or- There is no process associated with this object.-or- You are attempting to call for a process that is running on a remote computer. This method is available only for processes that are running on the local computer. + 1 + + + Instructs the component to wait the specified number of milliseconds for the associated process to exit. + true if the associated process has exited; otherwise, false. + The amount of time, in milliseconds, to wait for the associated process to exit. The maximum is the largest possible value of a 32-bit integer, which represents infinity to the operating system. + The wait setting could not be accessed. + No process has been set, and a from which the property can be determined does not exist.-or- There is no process associated with this object.-or- You are attempting to call for a process that is running on a remote computer. This method is available only for processes that are running on the local computer. + 1 + + + Causes the component to wait indefinitely for the associated process to enter an idle state. This overload applies only to processes with a user interface and, therefore, a message loop. + true if the associated process has reached an idle state. + The process does not have a graphical interface.-or-An unknown error occurred. The process failed to enter an idle state.-or-The process has already exited. -or-No process is associated with this object. + 1 + + + Causes the component to wait the specified number of milliseconds for the associated process to enter an idle state. This overload applies only to processes with a user interface and, therefore, a message loop. + true if the associated process has reached an idle state; otherwise, false. + A value of 1 to that specifies the amount of time, in milliseconds, to wait for the associated process to become idle. A value of 0 specifies an immediate return, and a value of -1 specifies an infinite wait. + The process does not have a graphical interface.-or-An unknown error occurred. The process failed to enter an idle state.-or-The process has already exited. -or-No process is associated with this object. + 1 + + + Gets the associated process's physical memory usage. + The total amount of physical memory the associated process is using, in bytes. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Gets the amount of physical memory allocated for the associated process. + The amount of physical memory, in bytes, allocated for the associated process. + The platform is Windows 98 or Windows Millennium Edition (Windows Me), which does not support this property. + 2 + + + Represents a.dll or .exe file that is loaded into a particular process. + 2 + + + Gets the memory address where the module was loaded. + The load address of the module. + 2 + + + Gets the memory address for the function that runs when the system loads and runs the module. + The entry point of the module. + 2 + + + + + + Gets the full path to the module. + The fully qualified path that defines the location of the module. + 2 + + + Gets version information about the module. + A that contains the module's version information. + 2 + + + + + + Gets the amount of memory that is required to load the module. + The size, in bytes, of the memory that the module occupies. + 2 + + + Gets the name of the process module. + The name of the module. + 2 + + + Converts the name of the module to a string. + The value of the property. + 2 + + + Provides a strongly typed collection of objects. + 2 + + + Initializes a new instance of the class, with no associated instances. + + + Initializes a new instance of the class, using the specified array of instances. + An array of instances with which to initialize this instance. + + + Determines whether the specified process module exists in the collection. + true if the module exists in the collection; otherwise, false. + A instance that indicates the module to find in this collection. + 2 + + + Copies an array of instances to the collection, at the specified index. + An array of instances to add to the collection. + The location at which to add the new instances. + 2 + + + Provides the location of a specified module within the collection. + The zero-based index that defines the location of the module within the . + The whose index is retrieved. + 2 + + + Gets an index for iterating over the set of process modules. + A that indexes the modules in the collection + The zero-based index value of the module in the collection. + 2 + + + Indicates the priority that the system associates with a process. This value, together with the priority value of each thread of the process, determines each thread's base priority level. + 2 + + + Specifies that the process has no special scheduling needs. + + + Specifies that the threads of this process run only when the system is idle, such as a screen saver. The threads of the process are preempted by the threads of any process running in a higher priority class. + + + Specifies that the process performs time-critical tasks that must be executed immediately, such as the Task List dialog, which must respond quickly when called by the user, regardless of the load on the operating system. The threads of the process preempt the threads of normal or idle priority class processes. + + + Specifies that the process has the highest possible priority. + + + Specifies that the process has priority above but below . + + + Specifies that the process has priority above but below . + + + Specifies a set of values that are used when you start a process. + 2 + + + Initializes a new instance of the class without specifying a file name with which to start the process. + + + Initializes a new instance of the class and specifies a file name such as an application or document with which to start the process. + An application or document with which to start a process. + + + Initializes a new instance of the class, specifies an application file name with which to start the process, and specifies a set of command-line arguments to pass to the application. + An application with which to start a process. + Command-line arguments to pass to the application when the process starts. + + + Gets or sets the set of command-line arguments to use when starting the application. + File type–specific arguments that the system can associate with the application specified in the property. The default is an empty string (""). On Windows Vista and earlier versions of the Windows operating system, the length of the arguments added to the length of the full path to the process must be less than 2080. On Windows 7 and later versions, the length must be less than 32699. + 1 + + + Gets or sets a value indicating whether to start the process in a new window. + true if the process should be started without creating a new window to contain it; otherwise, false. The default is false. + 2 + + + Gets or sets a value that identifies the domain to use when starting the process. + The Active Directory domain to use when starting the process. The domain property is primarily of interest to users within enterprise environments that use Active Directory. + 1 + + + Gets search paths for files, directories for temporary files, application-specific options, and other similar information. + A string dictionary that provides environment variables that apply to this process and child processes. The default is null. + 1 + + + Gets or sets a value indicating whether an error dialog box is displayed to the user if the process cannot be started. + true if an error dialog box should be displayed on the screen if the process cannot be started; otherwise, false. The default is false. + 2 + + + Gets or sets the window handle to use when an error dialog box is shown for a process that cannot be started. + A pointer to the handle of the error dialog box that results from a process start failure. + 2 + + + Gets or sets the application or document to start. + The name of the application to start, or the name of a document of a file type that is associated with an application and that has a default open action available to it. The default is an empty string (""). + 1 + + + Gets or sets a value that indicates whether the Windows user profile is to be loaded from the registry. + true if the Windows user profile should be loaded; otherwise, false. The default is false. + 1 + + + Gets or sets a secure string that contains the user password to use when starting the process. + The user password to use when starting the process. + 1 + + + Gets or sets a value that indicates whether the error output of an application is written to the stream. + true if error output should be written to ; otherwise, false. The default is false. + 2 + + + Gets or sets a value indicating whether the input for an application is read from the stream. + true if input should be read from ; otherwise, false. The default is false. + 2 + + + Gets or sets a value that indicates whether the output of an application is written to the stream. + true if output should be written to ; otherwise, false. The default is false. + 2 + + + Gets or sets the preferred encoding for error output. + An object that represents the preferred encoding for error output. The default is null. + + + Gets or sets the preferred encoding for standard output. + An object that represents the preferred encoding for standard output. The default is null. + + + Gets or sets the user name to be used when starting the process. + The user name to use when starting the process. + 1 + + + Gets or sets a value indicating whether to use the operating system shell to start the process. + true if the shell should be used when starting the process; false if the process should be created directly from the executable file. The default is true. + 2 + + + Gets or sets the verb to use when opening the application or document specified by the property. + The action to take with the file that the process opens. The default is an empty string (""). + 2 + + + Gets the set of verbs associated with the type of file specified by the property. + The actions that the system can apply to the file indicated by the property. + 2 + + + Gets or sets the window state to use when the process is started. + One of the enumeration values that indicates whether the process is started in a window that is maximized, minimized, normal (neither maximized nor minimized), or not visible. The default is normal. + The window style is not one of the enumeration members. + 2 + + + Gets or sets the initial directory for the process to be started. + The fully qualified name of the directory that contains the process to be started. The default is an empty string (""). + 1 + + + Represents an operating system process thread. + 2 + + + Gets the base priority of the thread. + The base priority of the thread, which the operating system computes by combining the process priority class with the priority level of the associated thread. + 2 + + + Gets the current priority of the thread. + The current priority of the thread, which may deviate from the base priority based on how the operating system is scheduling the thread. The priority may be temporarily boosted for an active thread. + 2 + + + Gets the unique identifier of the thread. + The unique identifier associated with a specific thread. + 2 + + + + + + Sets the preferred processor for this thread to run on. + The preferred processor for the thread, used when the system schedules threads, to determine which processor to run the thread on. + The system could not set the thread to start on the specified processor. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Gets or sets a value indicating whether the operating system should temporarily boost the priority of the associated thread whenever the main window of the thread's process receives the focus. + true to boost the thread's priority when the user interacts with the process's interface; otherwise, false. The default is false. + The priority boost information could not be retrieved.-or-The priority boost information could not be set. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Gets or sets the priority level of the thread. + One of the values, specifying a range that bounds the thread's priority. + The thread priority level information could not be retrieved. -or-The thread priority level could not be set. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Gets the amount of time that the thread has spent running code inside the operating system core. + A indicating the amount of time that the thread has spent running code inside the operating system core. + The thread time could not be retrieved. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Sets the processors on which the associated thread can run. + An that points to a set of bits, each of which represents a processor that the thread can run on. + The processor affinity could not be set. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Resets the ideal processor for this thread to indicate that there is no single ideal processor. In other words, so that any processor is ideal. + The ideal processor could not be reset. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Gets the memory address of the function that the operating system called that started this thread. + The thread's starting address, which points to the application-defined function that the thread executes. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Gets the time that the operating system started the thread. + A representing the time that was on the system when the operating system started the thread. + The thread time could not be retrieved. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Gets the current state of this thread. + A that indicates the thread's execution, for example, running, waiting, or terminated. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Gets the total amount of time that this thread has spent using the processor. + A that indicates the amount of time that the thread has had control of the processor. + The thread time could not be retrieved. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Gets the amount of time that the associated thread has spent running code inside the application. + A indicating the amount of time that the thread has spent running code inside the application, as opposed to inside the operating system core. + The thread time could not be retrieved. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Gets the reason that the thread is waiting. + A representing the reason that the thread is in the wait state. + The thread is not in the wait state. + The platform is Windows 98 or Windows Millennium Edition. + The process is on a remote computer. + 2 + + + + + + Provides a strongly typed collection of objects. + 2 + + + Initializes a new instance of the class, with no associated instances. + + + Initializes a new instance of the class, using the specified array of instances. + An array of instances with which to initialize this instance. + + + Appends a process thread to the collection. + The zero-based index of the thread in the collection. + The thread to add to the collection. + 2 + + + Determines whether the specified process thread exists in the collection. + true if the thread exists in the collection; otherwise, false. + A instance that indicates the thread to find in this collection. + 2 + + + Copies an array of instances to the collection, at the specified index. + An array of instances to add to the collection. + The location at which to add the new instances. + 2 + + + Provides the location of a specified thread within the collection. + The zero-based index that defines the location of the thread within the . + The whose index is retrieved. + 2 + + + Inserts a process thread at the specified location in the collection. + The zero-based index indicating the location at which to insert the thread. + The thread to insert into the collection. + 2 + + + Gets an index for iterating over the set of process threads. + A that indexes the threads in the collection. + The zero-based index value of the thread in the collection. + 2 + + + Deletes a process thread from the collection. + The thread to remove from the collection. + 2 + + + Specified how a new window should appear when the system starts a process. + 2 + + + The normal, visible window style. The system displays a window with Normal style on the screen, in a default location. If a window is visible, the user can supply input to the window and view the window's output. Frequently, an application may initialize a new window to the Hidden style while it customizes the window's appearance, and then make the window style Normal. + + + The hidden window style. A window can be either visible or hidden. The system displays a hidden window by not drawing it. If a window is hidden, it is effectively disabled. A hidden window can process messages from the system or from other windows, but it cannot process input from the user or display output. Frequently, an application may keep a new window hidden while it customizes the window's appearance, and then make the window style Normal. To use , the property must be false. + + + The minimized window style. By default, the system reduces a minimized window to the size of its taskbar button and moves the minimized window to the taskbar. + + + The maximized window style. By default, the system enlarges a maximized window so that it fills the screen or, in the case of a child window, the parent window's client area. If the window has a title bar, the system automatically moves it to the top of the screen or to the top of the parent window's client area. Also, the system disables the window's sizing border and the window-positioning capability of the title bar so that the user cannot move the window by dragging the title bar. + + + Indicates whether a listener should trace a message based on the source of a trace. + 2 + + + Initializes a new instance of the class, specifying the name of the trace source. + The name of the trace source. + + + Determines whether the trace listener should trace the event. + true if the trace should be produced; otherwise, false. + An object that represents the information cache for the trace event. + The name of the source. + One of the enumeration values that identifies the event type. + A trace identifier number. + The format to use for writing an array of arguments or a message to write. + An array of argument objects. + A trace data object. + An array of trace data objects. + + is null. + 2 + + + Gets or sets the name of the trace source. + The name of the trace source. + The value is null. + 2 + + + Specifies the levels of trace messages filtered by the source switch and event type filter. + 2 + + + Does not allow any events through. + + + Allows only events through. + + + Allows and events through. + + + Allows , , and events through. + + + Allows , , , and events through. + + + Allows , , , , and events through. + + + Allows the , , , , and events through. + + + Allows all events through. + + + Provides a multilevel switch to control tracing and debug output without recompiling your code. + 2 + + + Initializes a new instance of the class, specifying the name of the source. + The name of the source. + + + Initializes a new instance of the class, specifying the display name and the default value for the source switch. + The name of the source switch. + The default value for the switch. + + + Gets or sets the level of the switch. + One of the values that represents the event level of the switch. + 2 + + + + + + + Invoked when the value of the property changes. + The new value of is not one of the values. + + + Determines if trace listeners should be called, based on the trace event type. + True if the trace listeners should be called; otherwise, false. + One of the values. + 2 + + + + + + + Provides a set of methods and properties that you can use to accurately measure elapsed time. + 1 + + + Initializes a new instance of the class. + + + Gets the total elapsed time measured by the current instance. + A read-only representing the total elapsed time measured by the current instance. + 1 + + + Gets the total elapsed time measured by the current instance, in milliseconds. + A read-only long integer representing the total number of milliseconds measured by the current instance. + 1 + + + Gets the total elapsed time measured by the current instance, in timer ticks. + A read-only long integer representing the total number of timer ticks measured by the current instance. + 1 + + + Gets the frequency of the timer as the number of ticks per second. This field is read-only. + 1 + + + Gets the current number of ticks in the timer mechanism. + A long integer representing the tick counter value of the underlying timer mechanism. + 1 + + + Indicates whether the timer is based on a high-resolution performance counter. This field is read-only. + 1 + + + Gets a value indicating whether the timer is running. + true if the instance is currently running and measuring elapsed time for an interval; otherwise, false. + 1 + + + Stops time interval measurement and resets the elapsed time to zero. + 1 + + + Stops time interval measurement, resets the elapsed time to zero, and starts measuring elapsed time. + + + Starts, or resumes, measuring elapsed time for an interval. + 1 + + + Initializes a new instance, sets the elapsed time property to zero, and starts measuring elapsed time. + A that has just begun measuring elapsed time. + 1 + + + Stops measuring elapsed time for an interval. + 1 + + + Provides an abstract base class to create new debugging and tracing switches. + 2 + + + Initializes a new instance of the class. + The name of the switch. + The description for the switch. + + + Initializes a new instance of the class, specifying the display name, description, and default value for the switch. + The name of the switch. + The description of the switch. + The default value for the switch. + + + Gets the custom switch attributes defined in the application configuration file. + A containing the case-insensitive custom attributes for the trace switch. + 1 + + + Gets a description of the switch. + The description of the switch. The default value is an empty string (""). + 2 + + + Gets a name used to identify the switch. + The name used to identify the switch. The default value is an empty string (""). + 2 + + + Gets the custom attributes supported by the switch. + A string array that contains the names of the custom attributes supported by the switch, or null if there no custom attributes are supported. + + + Invoked when the property is changed. + + + Invoked when the property is changed. + + + Gets or sets the current setting for this switch. + The current setting for this switch. The default is zero. + + + Gets or sets the value of the switch. + A string representing the value of the switch. + The value is null.-or-The value does not consist solely of an optional negative sign followed by a sequence of digits ranging from 0 to 9.-or-The value represents a number less than or greater than . + + + Identifies a switch used in an assembly, class, or member. + 1 + + + Initializes a new instance of the class, specifying the name and the type of the switch. + The display name of the switch. + The type of the switch. + + + Returns all switch attributes for the specified assembly. + An array that contains all the switch attributes for the assembly. + The assembly to check for switch attributes. + + is null. + 1 + + + Gets or sets the description of the switch. + The description of the switch. + 2 + + + Gets or sets the display name of the switch. + The display name of the switch. + + is set to null. + + is set to an empty string. + 2 + + + Gets or sets the type of the switch. + The type of the switch. + + is set to null. + 2 + + + Identifies the level type for a switch. + 1 + + + Initializes a new instance of the class, specifying the type that determines whether a trace should be written. + The that determines whether a trace should be written. + + + Gets or sets the type that determines whether a trace should be written. + The that determines whether a trace should be written. + The set operation failed because the value is null. + 2 + + + Directs tracing or debugging output to a or to a , such as . + 1 + + + Initializes a new instance of the class with as the output recipient. + + + Initializes a new instance of the class, using the stream as the recipient of the debugging and tracing output. + A that represents the stream the writes to. + The stream is null. + + + Initializes a new instance of the class with the specified name, using the stream as the recipient of the debugging and tracing output. + A that represents the stream the writes to. + The name of the new instance. + The stream is null. + + + Initializes a new instance of the class using the specified writer as recipient of the tracing or debugging output. + A that receives the output from the . + The writer is null. + + + Initializes a new instance of the class with the specified name, using the specified writer as recipient of the tracing or debugging output. + A that receives the output from the . + The name of the new instance. + The writer is null. + + + Initializes a new instance of the class, using the file as the recipient of the debugging and tracing output. + The name of the file the writes to. + The file is null. + + + Initializes a new instance of the class with the specified name, using the file as the recipient of the debugging and tracing output. + The name of the file the writes to. + The name of the new instance. + The stream is null. + + + Closes the so that it no longer receives tracing or debugging output. + 1 + + + Disposes this object. + true to release managed resources; if false, has no effect. + + + Flushes the output buffer for the . + 1 + + + + + + Writes a message to this instance's . + A message to write. + 1 + + + + + + Writes a message to this instance's followed by a line terminator. The default line terminator is a carriage return followed by a line feed (\r\n). + A message to write. + 1 + + + + + + Gets or sets the text writer that receives the tracing or debugging output. + A that represents the writer that receives the tracing or debugging output. + 2 + + + Specifies the priority level of a thread. + 2 + + + Specifies idle priority. This is the lowest possible priority value of all threads, independent of the value of the associated . + + + Specifies lowest priority. This is two steps below the normal priority for the associated . + + + Specifies one step below the normal priority for the associated . + + + Specifies normal priority for the associated . + + + Specifies one step above the normal priority for the associated . + + + Specifies highest priority. This is two steps above the normal priority for the associated . + + + Specifies time-critical priority. This is the highest priority of all threads, independent of the value of the associated . + + + Specifies the current execution state of the thread. + 1 + + + A state that indicates the thread has been initialized, but has not yet started. + + + A state that indicates the thread is waiting to use a processor because no processor is free. The thread is prepared to run on the next available processor. + + + A state that indicates the thread is currently using a processor. + + + A state that indicates the thread is about to use a processor. Only one thread can be in this state at a time. + + + A state that indicates the thread has finished executing and has exited. + + + A state that indicates the thread is not ready to use the processor because it is waiting for a peripheral operation to complete or a resource to become free. When the thread is ready, it will be rescheduled. + + + A state that indicates the thread is waiting for a resource, other than the processor, before it can execute. For example, it might be waiting for its execution stack to be paged in from disk. + + + The state of the thread is unknown. + + + Specifies the reason a thread is waiting. + 2 + + + The thread is waiting for the scheduler. + + + The thread is waiting for a free virtual memory page. + + + The thread is waiting for a virtual memory page to arrive in memory. + + + The thread is waiting for system allocation. + + + Thread execution is delayed. + + + Thread execution is suspended. + + + The thread is waiting for a user request. + + + The thread is waiting for event pair high. + + + The thread is waiting for event pair low. + + + The thread is waiting for a local procedure call to arrive. + + + The thread is waiting for reply to a local procedure call to arrive. + + + The thread is waiting for the system to allocate virtual memory. + + + The thread is waiting for a virtual memory page to be written to disk. + + + The thread is waiting for an unknown reason. + + + Provides a set of methods and properties that help you trace the execution of your code. This class cannot be inherited. + 1 + + + Checks for a condition; if the condition is false, displays a message box that shows the call stack. + The conditional expression to evaluate. If the condition is true, a failure message is not sent and the message box is not displayed. + 2 + + + + + + + Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack. + The conditional expression to evaluate. If the condition is true, the specified message is not sent and the message box is not displayed. + The message to send to the collection. + 2 + + + + + + + Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack. + The conditional expression to evaluate. If the condition is true, the specified messages are not sent and the message box is not displayed. + The message to send to the collection. + The detailed message to send to the collection. + 2 + + + + + + + Gets or sets whether should be called on the after every write. + true if is called on the after every write; otherwise, false. + 2 + + + + + + + Flushes the output buffer, and then closes the . + 1 + + + + + + + Gets the correlation manager for the thread for this trace. + The object associated with the thread for this trace. + 2 + + + + + + Emits the specified error message. + A message to emit. + 2 + + + + + + + Emits an error message, and a detailed error message. + A message to emit. + A detailed message to emit. + 2 + + + + + + + Flushes the output buffer, and causes buffered data to be written to the . + 1 + + + + + + + Increases the current by one. + 2 + + + + + + + Gets or sets the indent level. + The indent level. The default is zero. + 2 + + + + + + + Gets or sets the number of spaces in an indent. + The number of spaces in an indent. The default is four. + 2 + + + + + + + Gets the collection of listeners that is monitoring the trace output. + A that represents a collection of type monitoring the trace output. + 1 + + + + + + + Refreshes the trace configuration data. + 1 + + + Writes an error message to the trace listeners in the collection using the specified message. + The informative message to write. + 1 + + + + + + + + Writes an error message to the trace listeners in the collection using the specified array of objects and formatting information. + A format string that contains zero or more format items, which correspond to objects in the array. + An object array containing zero or more objects to format. + 1 + + + + + + + + Writes an informational message to the trace listeners in the collection using the specified message. + The informative message to write. + 1 + + + + + + + + Writes an informational message to the trace listeners in the collection using the specified array of objects and formatting information. + A format string that contains zero or more format items, which correspond to objects in the array. + An object array containing zero or more objects to format. + 1 + + + + + + + + Writes a warning message to the trace listeners in the collection using the specified message. + The informative message to write. + 1 + + + + + + + + Writes a warning message to the trace listeners in the collection using the specified array of objects and formatting information. + A format string that contains zero or more format items, which correspond to objects in the array. + An object array containing zero or more objects to format. + 1 + + + + + + + + Decreases the current by one. + 2 + + + + + + + Gets or sets a value indicating whether the global lock should be used. + true if the global lock is to be used; otherwise, false. The default is true. + + + Writes the value of the object's method to the trace listeners in the collection. + An whose name is sent to the . + 1 + + + + + + + Writes a category name and the value of the object's method to the trace listeners in the collection. + An name is sent to the . + A category name used to organize the output. + 1 + + + + + + + Writes a message to the trace listeners in the collection. + A message to write. + 1 + + + + + + + Writes a category name and a message to the trace listeners in the collection. + A message to write. + A category name used to organize the output. + 1 + + + + + + + Writes the value of the object's method to the trace listeners in the collection if a condition is true. + true to cause a message to be written; otherwise, false. + An whose name is sent to the . + 1 + + + + + + + Writes a category name and the value of the object's method to the trace listeners in the collection if a condition is true. + true to cause a message to be written; otherwise, false. + An whose name is sent to the . + A category name used to organize the output. + 1 + + + + + + + Writes a message to the trace listeners in the collection if a condition is true. + true to cause a message to be written; otherwise, false. + A message to write. + 1 + + + + + + + Writes a category name and message to the trace listeners in the collection if a condition is true. + true to cause a message to be written; otherwise, false. + A message to write. + A category name used to organize the output. + 1 + + + + + + + Writes the value of the object's method to the trace listeners in the collection. + An whose name is sent to the . + 1 + + + + + + + Writes a category name and the value of the object's method to the trace listeners in the collection. + An whose name is sent to the . + A category name used to organize the output. + 1 + + + + + + + Writes a message to the trace listeners in the collection. + A message to write. + 1 + + + + + + + Writes a category name and message to the trace listeners in the collection. + A message to write. + A category name used to organize the output. + 1 + + + + + + + Writes the value of the object's method to the trace listeners in the collection if a condition is true. + true to cause a message to be written; otherwise, false. + An whose name is sent to the . + 1 + + + + + + + Writes a category name and the value of the object's method to the trace listeners in the collection if a condition is true. + true to cause a message to be written; otherwise, false. + An whose name is sent to the . + A category name used to organize the output. + 1 + + + + + + + Writes a message to the trace listeners in the collection if a condition is true. + true to cause a message to be written; otherwise, false. + A message to write. + 1 + + + + + + + Writes a category name and message to the trace listeners in the collection if a condition is true. + true to cause a message to be written; otherwise, false. + A message to write. + A category name used to organize the output. + 1 + + + + + + + Provides trace event data specific to a thread and a process. + 2 + + + Initializes a new instance of the class. + + + Gets the call stack for the current thread. + A string containing stack trace information. This value can be an empty string (""). + 2 + + + + + + + Gets the date and time at which the event trace occurred. + A structure whose value is a date and time expressed in Coordinated Universal Time (UTC). + 2 + + + Gets the correlation data, contained in a stack. + A containing correlation data. + 1 + + + Gets the unique identifier of the current process. + The system-generated unique identifier of the current process. + 2 + + + + + + Gets a unique identifier for the current managed thread. + A string that represents a unique integer identifier for this managed thread. + 2 + + + Gets the current number of ticks in the timer mechanism. + The tick counter value of the underlying timer mechanism. + 2 + + + Identifies the type of event that has caused the trace. + 2 + + + Fatal error or application crash. + + + Recoverable error. + + + Noncritical problem. + + + Informational message. + + + Debugging trace. + + + Starting of a logical operation. + + + Stopping of a logical operation. + + + Suspension of a logical operation. + + + Resumption of a logical operation. + + + Changing of correlation identity. + + + Provides the base class for trace filter implementations. + 2 + + + Initializes a new instance of the class. + + + When overridden in a derived class, determines whether the trace listener should trace the event. + true to trace the specified event; otherwise, false. + The that contains information for the trace event. + The name of the source. + One of the values specifying the type of event that has caused the trace. + A trace identifier number. + Either the format to use for writing an array of arguments specified by the parameter, or a message to write. + An array of argument objects. + A trace data object. + An array of trace data objects. + 2 + + + Specifies what messages to output for the , and classes. + 2 + + + Output no tracing and debugging messages. + + + Output error-handling messages. + + + Output warnings and error-handling messages. + + + Output informational messages, warnings, and error-handling messages. + + + Output all debugging and tracing messages. + + + Provides the abstract base class for the listeners who monitor trace and debug output. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified name as the listener. + The name of the . + + + Gets the custom trace listener attributes defined in the application configuration file. + A containing the custom attributes for the trace listener. + 1 + + + When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output. + 2 + + + Releases all resources used by the . + 2 + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Emits an error message to the listener you create when you implement the class. + A message to emit. + 2 + + + Emits an error message and a detailed error message to the listener you create when you implement the class. + A message to emit. + A detailed message to emit. + 2 + + + Gets and sets the trace filter for the trace listener. + An object derived from the base class. + 2 + + + When overridden in a derived class, flushes the output buffer. + 2 + + + Gets the custom attributes supported by the trace listener. + A string array naming the custom attributes supported by the trace listener, or null if there are no custom attributes. + + + Gets or sets the indent level. + The indent level. The default is zero. + 2 + + + Gets or sets the number of spaces in an indent. + The number of spaces in an indent. The default is four spaces. + Set operation failed because the value is less than zero. + 2 + + + Gets a value indicating whether the trace listener is thread safe. + true if the trace listener is thread safe; otherwise, false. The default is false. + + + Gets or sets a name for this . + A name for this . The default is an empty string (""). + 2 + + + Gets or sets a value indicating whether to indent the output. + true if the output should be indented; otherwise, false. + + + Writes trace information, a data object and event information to the listener specific output. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + One of the values specifying the type of event that has caused the trace. + A numeric identifier for the event. + The trace data to emit. + 1 + + + + + + + Writes trace information, an array of data objects and event information to the listener specific output. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + One of the values specifying the type of event that has caused the trace. + A numeric identifier for the event. + An array of objects to emit as data. + 1 + + + + + + + Writes trace and event information to the listener specific output. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + One of the values specifying the type of event that has caused the trace. + A numeric identifier for the event. + 1 + + + + + + + Writes trace information, a message, and event information to the listener specific output. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + One of the values specifying the type of event that has caused the trace. + A numeric identifier for the event. + A message to write. + 1 + + + + + + + Writes trace information, a formatted array of objects and event information to the listener specific output. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + One of the values specifying the type of event that has caused the trace. + A numeric identifier for the event. + A format string that contains zero or more format items, which correspond to objects in the array. + An object array containing zero or more objects to format. + 1 + + + + + + + Gets or sets the trace output options. + A bitwise combination of the enumeration values. The default is . + Set operation failed because the value is invalid. + 2 + + + Writes trace information, a message, a related activity identity and event information to the listener specific output. + A object that contains the current process ID, thread ID, and stack trace information. + A name used to identify the output, typically the name of the application that generated the trace event. + A numeric identifier for the event. + A message to write. + A object identifying a related activity. + 1 + + + Writes the value of the object's method to the listener you create when you implement the class. + An whose fully qualified class name you want to write. + 2 + + + Writes a category name and the value of the object's method to the listener you create when you implement the class. + An whose fully qualified class name you want to write. + A category name used to organize the output. + 2 + + + When overridden in a derived class, writes the specified message to the listener you create in the derived class. + A message to write. + 2 + + + Writes a category name and a message to the listener you create when you implement the class. + A message to write. + A category name used to organize the output. + 2 + + + Writes the indent to the listener you create when you implement this class, and resets the property to false. + + + Writes the value of the object's method to the listener you create when you implement the class, followed by a line terminator. + An whose fully qualified class name you want to write. + 2 + + + Writes a category name and the value of the object's method to the listener you create when you implement the class, followed by a line terminator. + An whose fully qualified class name you want to write. + A category name used to organize the output. + 2 + + + When overridden in a derived class, writes a message to the listener you create in the derived class, followed by a line terminator. + A message to write. + 2 + + + Writes a category name and a message to the listener you create when you implement the class, followed by a line terminator. + A message to write. + A category name used to organize the output. + 2 + + + Provides a thread-safe list of objects. + 2 + + + Adds a to the list. + The position at which the new listener was inserted. + A to add to the list. + 2 + + + + + + + Adds an array of objects to the list. + An array of objects to add to the list. + + is null. + 2 + + + + + + + Adds the contents of another to the list. + Another whose contents are added to the list. + + is null. + 2 + + + + + + + Clears all the listeners from the list. + 2 + + + Checks whether the list contains the specified listener. + true if the listener is in the list; otherwise, false. + A to find in the list. + 2 + + + Copies a section of the current list to the specified array at the specified index. + An array of type to copy the elements into. + The starting index number in the current list to copy from. + 2 + + + Gets the number of listeners in the list. + The number of listeners in the list. + 2 + + + Gets an enumerator for this list. + An enumerator of type . + 2 + + + Gets the index of the specified listener. + The index of the listener, if it can be found in the list; otherwise, -1. + A to find in the list. + 2 + + + Inserts the listener at the specified index. + The position in the list to insert the new . + A to insert in the list. + The is not a valid index in the list. + + is null. + 2 + + + + + + + Gets or sets the at the specified index. + A with the specified index. + The zero-based index of the to get from the list. + The value is null. + 2 + + + Gets the first in the list with the specified name. + The first in the list with the given . This item returns null if no with the given name can be found. + The name of the to get from the list. + 2 + + + Removes from the collection the specified . + A to remove from the list. + 2 + + + Removes from the collection the first with the specified name. + The name of the to remove from the list. + 2 + + + Removes from the collection the at the specified index. + The zero-based index of the to remove from the list. + The is not a valid index in the list. + 2 + + + Copies a section of the current to the specified array of objects. + The one-dimensional array of objects that is the destination of the elements copied from the . The array must have zero-based indexing. + The zero-based index in at which copying begins. + + + Gets a value indicating whether access to the is synchronized (thread safe). + Always true. + + + Gets an object that can be used to synchronize access to the . + The current object. + + + Adds a trace listener to the . + The position into which the new trace listener was inserted. + The object to add to the . + + is null. -or- is not a . + + + Determines whether the contains a specific object. + true if the is found in the ; otherwise, false. + The object to locate in the . + + + Determines the index of a specific object in the . + The index of if found in the ; otherwise, -1. + The object to locate in the . + + + Inserts a object at the specified position in the . + The zero-based index at which should be inserted. + The object to insert into the . + + is not a object. + + + Gets a value indicating whether the has a fixed size. + Always false. + + + Gets a value indicating whether the is read-only + Always false. + + + Gets or sets the at the specified index in the . + The at the specified index. + The zero-based index of the to get. + + + Removes an object from the . + The object to remove from the . + + + Specifies trace data options to be written to the trace output. + 2 + + + Do not write any elements. + + + Write the logical operation stack, which is represented by the return value of the property. + + + Write the date and time. + + + Write the timestamp, which is represented by the return value of the method. + + + Write the process identity, which is represented by the return value of the property. + + + Write the thread identity, which is represented by the return value of the property for the current thread. + + + Write the call stack, which is represented by the return value of the property. + + + Provides a set of methods and properties that enable applications to trace the execution of code and associate trace messages with their source. + 1 + + + Initializes a new instance of the class, using the specified name for the source. + The name of the source (typically, the name of the application). + + is null. + + is an empty string (""). + + + Initializes a new instance of the class, using the specified name for the source and the default source level at which tracing is to occur. + The name of the source, typically the name of the application. + A bitwise combination of the enumeration values that specifies the default source level at which to trace. + + is null. + + is an empty string (""). + + + Gets the custom switch attributes defined in the application configuration file. + A containing the custom attributes for the trace switch. + 1 + + + Closes all the trace listeners in the trace listener collection. + 1 + + + + + + Flushes all the trace listeners in the trace listener collection. + An attempt was made to trace an event during finalization. + 1 + + + Gets the custom attributes supported by the trace source. + A string array naming the custom attributes supported by the trace source, or null if there are no custom attributes. + + + Gets the collection of trace listeners for the trace source. + A that contains the active trace listeners associated with the source. + 1 + + + + + + Gets the name of the trace source. + The name of the trace source. + 1 + + + Gets or sets the source switch value. + A object representing the source switch value. + + is set to null. + 1 + + + + + + Writes trace data to the trace listeners in the collection using the specified event type, event identifier, and trace data. + One of the enumeration values that specifies the event type of the trace data. + A numeric identifier for the event. + The trace data. + An attempt was made to trace an event during finalization. + 1 + + + + + + + + Writes trace data to the trace listeners in the collection using the specified event type, event identifier, and trace data array. + One of the enumeration values that specifies the event type of the trace data. + A numeric identifier for the event. + An object array containing the trace data. + An attempt was made to trace an event during finalization. + 1 + + + + + + + + Writes a trace event message to the trace listeners in the collection using the specified event type and event identifier. + One of the enumeration values that specifies the event type of the trace data. + A numeric identifier for the event. + An attempt was made to trace an event during finalization. + 1 + + + + + + + + Writes a trace event message to the trace listeners in the collection using the specified event type, event identifier, and message. + One of the enumeration values that specifies the event type of the trace data. + A numeric identifier for the event. + The trace message to write. + An attempt was made to trace an event during finalization. + 1 + + + + + + + + Writes a trace event to the trace listeners in the collection using the specified event type, event identifier, and argument array and format. + One of the enumeration values that specifies the event type of the trace data. + A numeric identifier for the event. + A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the array. + An object array containing zero or more objects to format. + + is null. + + is invalid.-or- The number that indicates an argument to format is less than zero, or greater than or equal to the number of specified objects to format. + An attempt was made to trace an event during finalization. + 1 + + + + + + + + Writes an informational message to the trace listeners in the collection using the specified message. + The informative message to write. + An attempt was made to trace an event during finalization. + 1 + + + + + + + + Writes an informational message to the trace listeners in the collection using the specified object array and formatting information. + A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the array. + An array containing zero or more objects to format. + + is null. + + is invalid.-or- The number that indicates an argument to format is less than zero, or greater than or equal to the number of specified objects to format. + An attempt was made to trace an event during finalization. + 1 + + + + + + + + Writes a trace transfer message to the trace listeners in the collection using the specified numeric identifier, message, and related activity identifier. + A numeric identifier for the event. + The trace message to write. + A structure that identifies the related activity. + 1 + + + Provides a multilevel switch to control tracing and debug output without recompiling your code. + 2 + + + Initializes a new instance of the class, using the specified display name and description. + The name to display on a user interface. + The description of the switch. + + + Initializes a new instance of the class, using the specified display name, description, and default value for the switch. + The name to display on a user interface. + The description of the switch. + The default value of the switch. + + + Gets or sets the trace level that determines the messages the switch allows. + One of the values that that specifies the level of messages that are allowed by the switch. + + is set to a value that is not one of the values. + 1 + + + + + + + Updates and corrects the level for this switch. + + + Sets the property to the integer equivalent of the property. + + + Gets a value indicating whether the switch allows error-handling messages. + true if the property is set to , , , or ; otherwise, false. + 1 + + + + + + + Gets a value indicating whether the switch allows informational messages. + true if the property is set to or ; otherwise, false. + 1 + + + + + + + Gets a value indicating whether the switch allows all messages. + true if the property is set to ; otherwise, false. + 1 + + + + + + + Gets a value indicating whether the switch allows warning messages. + true if the property is set to , , or ; otherwise, false. + 1 + + + + + + + Directs tracing or debugging output as XML-encoded data to a or to a , such as a . + 1 + + + Initializes a new instance of the class, using the specified stream as the recipient of the debugging and tracing output. + A that represents the stream the trace listener writes to. + + is null. + + + Initializes a new instance of the class with the specified name, using the specified stream as the recipient of the debugging and tracing output. + A that represents the stream the trace listener writes to. + The name of the new instance. + + is null. + + + Initializes a new instance of the class using the specified writer as the recipient of the debugging and tracing output. + A that receives the output from the trace listener. + + is null. + + + Initializes a new instance of the class with the specified name, using the specified writer as the recipient of the debugging and tracing output. + A that receives the output from the trace listener. + The name of the new instance. + + is null. + + + Initializes a new instance of the class, using the specified file as the recipient of the debugging and tracing output. + The name of the file to write to. + + is null. + + + Initializes a new instance of the class with the specified name, using the specified file as the recipient of the debugging and tracing output. + The name of the file to write to. + The name of the new instance. + + is null. + + + Closes the for this listener so that it no longer receives tracing or debugging output. + + + Writes trace information including an error message and a detailed error message to the file or stream. + The error message to write. + The detailed error message to append to the error message. + + + Writes trace information, a data object, and event information to the file or stream. + A that contains the current process ID, thread ID, and stack trace information. + The source name. + One of the values. + A numeric identifier for the event. + A data object to emit. + 1 + + + Writes trace information, data objects, and event information to the file or stream. + A that contains the current process ID, thread ID, and stack trace information. + The source name. + One of the values. + A numeric identifier for the event. + An array of data objects to emit. + 1 + + + Writes trace information, a message, and event information to the file or stream. + A that contains the current process ID, thread ID, and stack trace information. + The source name. + One of the values. + A numeric identifier for the event. + The message to write. + 1 + + + Writes trace information, a formatted message, and event information to the file or stream. + A that contains the current process ID, thread ID, and stack trace information. + The source name. + One of the values. + A numeric identifier for the event. + A format string that contains zero or more format items that correspond to objects in the array. + An object array containing zero or more objects to format. + 1 + + + Writes trace information including the identity of a related activity, a message, and event information to the file or stream. + A that contains the current process ID, thread ID, and stack trace information. + The source name. + A numeric identifier for the event. + A trace message to write. + A structure that identifies a related activity. + 1 + + + Writes a verbatim message without any additional context information to the file or stream. + The message to write. + + + Writes a verbatim message without any additional context information followed by the current line terminator to the file or stream. + The message to write. + + + Specifies that the attributed code should be excluded from code coverage information. + + + Initializes a new instance of the class. + + + Provides data for the event. + 2 + + + Initializes a new instance of the class. + An that represents the error that occurred. + + + Gets the that represents the error that occurred. + An that represents the error that occurred. + 2 + + + Represents the method that will handle the event of a object. + The source of the event. + An object that contains the event data. + 2 + + + Provides data for the directory events: , , . + 2 + + + Initializes a new instance of the class. + One of the values, which represents the kind of change detected in the file system. + The root directory of the affected file or directory. + The name of the affected file or directory. + + + Gets the type of directory event that occurred. + One of the values that represents the kind of change detected in the file system. + 2 + + + Gets the fully qualifed path of the affected file or directory. + The path of the affected file or directory. + 2 + + + Gets the name of the affected file or directory. + The name of the affected file or directory. + 2 + + + Represents the method that will handle the , , or event of a class. + The source of the event. + The that contains the event data. + 2 + + + Listens to the file system change notifications and raises events when a directory, or file in a directory, changes. + 2 + + + Initializes a new instance of the class. + + + Initializes a new instance of the class, given the specified directory to monitor. + The directory to monitor, in standard or Universal Naming Convention (UNC) notation. + The parameter is null. + The parameter is an empty string ("").-or- The path specified through the parameter does not exist. + + is too long. + + + Initializes a new instance of the class, given the specified directory and type of files to monitor. + The directory to monitor, in standard or Universal Naming Convention (UNC) notation. + The type of files to watch. For example, "*.txt" watches for changes to all text files. + The parameter is null.-or- The parameter is null. + The parameter is an empty string ("").-or- The path specified through the parameter does not exist. + + is too long. + + + Begins the initialization of a used on a form or used by another component. The initialization occurs at run time. + 2 + + + Occurs when a file or directory in the specified is changed. + 2 + + + Occurs when a file or directory in the specified is created. + 2 + + + Occurs when a file or directory in the specified is deleted. + 2 + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets or sets a value indicating whether the component is enabled. + true if the component is enabled; otherwise, false. The default is false. If you are using the component on a designer in Visual Studio 2005, the default is true. + The object has been disposed. + The current operating system is not Microsoft Windows NT or later. + The directory specified in could not be found. + + has not been set or is invalid. + 2 + + + Ends the initialization of a used on a form or used by another component. The initialization occurs at run time. + 2 + + + Occurs when the internal buffer overflows. + 2 + + + Gets or sets the filter string used to determine what files are monitored in a directory. + The filter string. The default is "*.*" (Watches all files.) + 2 + + + Gets or sets a value indicating whether subdirectories within the specified path should be monitored. + true if you want to monitor subdirectories; otherwise, false. The default is false. + 2 + + + Gets or sets the size (in bytes) of the internal buffer. + The internal buffer size in bytes. The default is 8192 (8 KB). + 2 + + + Gets or sets the type of changes to watch for. + One of the values. The default is the bitwise OR combination of LastWrite, FileName, and DirectoryName. + The value is not a valid bitwise OR combination of the values. + The value that is being set is not valid. + 2 + + + Raises the event. + A that contains the event data. + + + Raises the event. + A that contains the event data. + + + Raises the event. + A that contains the event data. + + + Raises the event. + An that contains the event data. + + + Raises the event. + A that contains the event data. + + + Gets or sets the path of the directory to watch. + The path to monitor. The default is an empty string (""). + The specified path does not exist or could not be found.-or- The specified path contains wildcard characters.-or- The specified path contains invalid path characters. + 2 + + + Occurs when a file or directory in the specified is renamed. + 2 + + + Gets or sets an for the . + An for the . + 2 + + + Gets or sets the object used to marshal the event handler calls issued as a result of a directory change. + The that represents the object used to marshal the event handler calls issued as a result of a directory change. The default is null. + 2 + + + A synchronous method that returns a structure that contains specific information on the change that occurred, given the type of change you want to monitor. + A that contains specific information on the change that occurred. + The to watch for. + 2 + + + A synchronous method that returns a structure that contains specific information on the change that occurred, given the type of change you want to monitor and the time (in milliseconds) to wait before timing out. + A that contains specific information on the change that occurred. + The to watch for. + The time (in milliseconds) to wait before timing out. + 2 + + + The exception thrown when the internal buffer overflows. + 2 + + + Initializes a new default instance of the class. + + + Initializes a new, empty instance of the class that is serializable using the specified and objects. + The information required to serialize the T:System.IO.InternalBufferOverflowException object. + The source and destination of the serialized stream associated with the T:System.IO.InternalBufferOverflowException object. + + + Initializes a new instance of the class with the error message to be displayed specified. + The message to be given for the exception. + + + Initializes a new instance of the class with the message to be displayed and the generated inner exception specified. + The message to be given for the exception. + The inner exception. + + + The exception that is thrown when a data stream is in an invalid format. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with a specified error message. + The error message that explains the reason for the exception. + + + Initializes a new instance of the class with a reference to the inner exception that is the cause of this exception. + The error message that explains the reason for the exception. + The exception that is the cause of the current exception. If the parameter is not null, the current exception is raised in a catch block that handles the inner exception. + + + Sets the description visual designers can display when referencing an event, extender, or property. + 1 + + + Initializes a new instance of the class. + The description to use. + + + Gets the description. + The description for the event, extender, or property. + 2 + + + Specifies changes to watch for in a file or folder. + 2 + + + The name of the file. + + + The name of the directory. + + + The attributes of the file or folder. + + + The size of the file or folder. + + + The date the file or folder last had anything written to it. + + + The date the file or folder was last opened. + + + The time the file or folder was created. + + + The security settings of the file or folder. + + + Provides data for the event. + 2 + + + Initializes a new instance of the class. + One of the values. + The name of the affected file or directory. + The name of the affected file or directory. + The old name of the affected file or directory. + + + Gets the previous fully qualified path of the affected file or directory. + The previous fully qualified path of the affected file or directory. + 2 + + + + + + Gets the old name of the affected file or directory. + The previous name of the affected file or directory. + 2 + + + Represents the method that will handle the event of a class. + The source of the event. + The that contains the event data. + 2 + + + Contains information on the change that occurred. + 2 + + + Gets or sets the type of change that occurred. + One of the values. + 2 + + + Gets or sets the name of the file or directory that changed. + The name of the file or directory that changed. + 2 + + + Gets or sets the original name of the file or directory that was renamed. + The original name of the file or directory that was renamed. + 2 + + + Gets or sets a value indicating whether the wait operation timed out. + true if the method timed out; otherwise, false. + 2 + + + Changes that might occur to a file or directory. + 2 + + + The creation of a file or folder. + + + The deletion of a file or folder. + + + The change of a file or folder. The types of changes include: changes to size, attributes, security settings, last write, and last access time. + + + The renaming of a file or folder. + + + The creation, deletion, change, or renaming of a file or folder. + + + Specifies whether to compress or decompress the underlying stream. + + + Decompresses the underlying stream. + + + Compresses the underlying stream. + + + Provides methods and properties for compressing and decompressing streams using the Deflate algorithm. + + + Initializes a new instance of the class using the specified stream and value. + The stream to compress or decompress. + One of the values that indicates the action to take. + + is null. + + is not a valid value.-or- is and is false.-or- is and is false. + + + Initializes a new instance of the class using the specified stream and value, and a value that specifies whether to leave the stream open. + The stream to compress or decompress. + One of the values that indicates the action to take. + true to leave the stream open; otherwise, false. + + is null. + + is not a valid value.-or- is and is false.-or- is and is false. + + + Gets a reference to the underlying stream. + A stream object that represents the underlying stream. + The underlying stream is closed. + + + Begins an asynchronous read operation. + An object that represents the asynchronous read, which could still be pending. + The byte array to read the data into. + The byte offset in at which to begin writing data read from the stream. + The maximum number of bytes to read. + An optional asynchronous callback, to be called when the read is complete. + A user-provided object that distinguishes this particular asynchronous read request from other requests. + An asynchronous read past the end of the stream was attempted, or a disk error occurred. + One or more of the arguments is invalid. + Methods were called after the stream was closed. + The current implementation does not support the read operation. + This call cannot be completed. + + + Begins an asynchronous write operation. + An object that represents the asynchronous write, which could still be pending. + The buffer to write data from. + The byte offset in to begin writing from. + The maximum number of bytes to write. + An optional asynchronous callback, to be called when the write is complete. + A user-provided object that distinguishes this particular asynchronous write request from other requests. + An asynchronous write past the end of the stream was attempted, or a disk error occurred. + One or more of the arguments is invalid. + Methods were called after the stream was closed. + The current implementation does not support the write operation. + The write operation cannot be performed because the stream is closed. + + + Gets a value indicating whether the stream supports reading while decompressing a file. + true if the value is Decompress, and the underlying stream is opened and supports reading; otherwise, false. + + + Gets a value indicating whether the stream supports seeking. + false in all cases. + + + Gets a value indicating whether the stream supports writing. + true if the value is Compress, and the underlying stream supports writing and is not closed; otherwise, false. + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Waits for the pending asynchronous read to complete. + The number of bytes read from the stream, between zero (0) and the number of bytes you requested. returns zero (0) only at the end of the stream; otherwise, it blocks until at least one byte is available. + The reference to the pending asynchronous request to finish. + + is null. + + did not originate from a method on the current stream. + An exception was thrown during a call to . + The end call is invalid because asynchronous read operations for this stream are not yet complete. + The stream is null. + + + Ends an asynchronous write operation. + A reference to the outstanding asynchronous I/O request. + + is null. + + did not originate from a method on the current stream. + An exception was thrown during a call to . + The stream is null. + The end write call is invalid. + + + Flushes the contents of the internal buffer of the current stream object to the underlying stream. + The stream is closed. + + + + + + This property is not supported and always throws a . + A long value. + This property is not supported on this stream. + + + + + + This property is not supported and always throws a . + A long value. + This property is not supported on this stream. + + + + + + Reads a number of decompressed bytes into the specified byte array. + The number of bytes that were read into the byte array. + The array to store decompressed bytes. + The byte offset in at which the read bytes will be placed. + The maximum number of decompressed bytes to read. + + is null. + The value was Compress when the object was created.- or - The underlying stream does not support reading. + + or is less than zero.-or- length minus the index starting point is less than . + The data is in an invalid format. + The stream is closed. + + + This operation is not supported and always throws a . + A long value. + The location in the stream. + One of the values. + This property is not supported on this stream. + + + This operation is not supported and always throws a . + The length of the stream. + This property is not supported on this stream. + + + Writes compressed bytes to the underlying stream from the specified byte array. + The buffer that contains the data to compress. + The byte offset in at which the compressed bytes will be placed. + The maximum number of compressed bytes to write. + + + Provides methods and properties used to compress and decompress streams. + + + Initializes a new instance of the class using the specified stream and value. + The stream to compress or decompress. + One of the values that indicates the action to take. + + is null. + + is not a valid enumeration value.-or- is and is false.-or- is and is false. + + + Initializes a new instance of the class using the specified stream and value, and a value that specifies whether to leave the stream open. + The stream to compress or decompress. + One of the values that indicates the action to take. + true to leave the stream open; otherwise, false. + + is null. + + is not a valid value.-or- is and is false.-or- is and is false. + + + Gets a reference to the underlying stream. + A stream object that represents the underlying stream. + The underlying stream is closed. + + + + + + Begins an asynchronous read operation. + An object that represents the asynchronous read, which could still be pending. + The byte array to read the data into. + The byte offset in at which to begin writing data read from the stream. + The maximum number of bytes to read. + An optional asynchronous callback, to be called when the read is complete. + A user-provided object that distinguishes this particular asynchronous read request from other requests. + An asynchronous read past the end of the stream was attempted, or a disk error occurred. + One or more of the arguments is invalid. + Methods were called after the stream was closed. + The current implementation does not support the read operation. + A read operation cannot be performed because the stream is closed. + + + Begins an asynchronous write operation. + An object that represents the asynchronous write, which could still be pending. + The buffer containing data to write to the current stream. + The byte offset in at which to begin writing. + The maximum number of bytes to write. + An optional asynchronous callback to be called when the write is complete. + A user-provided object that distinguishes this particular asynchronous write request from other requests. + The underlying stream is null. -or-The underlying stream is closed. + + + Gets a value indicating whether the stream supports reading while decompressing a file. + true if the value is Decompress, and the underlying stream supports reading and is not closed; otherwise, false. + + + + + + Gets a value indicating whether the stream supports seeking. + false in all cases. + + + Gets a value indicating whether the stream supports writing. + true if the value is Compress, and the underlying stream supports writing and is not closed; otherwise, false. + + + + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Waits for the pending asynchronous read to complete. + The number of bytes read from the stream, between zero (0) and the number of bytes you requested. returns zero (0) only at the end of the stream; otherwise, it blocks until at least one byte is available. + The reference to the pending asynchronous request to finish. + + is null. + + did not originate from a method on the current stream. + The end operation cannot be performed because the stream is closed. + + + Handles the end of an asynchronous write operation. + The object that represents the asynchronous call. + The underlying stream is null. -or-The underlying stream is closed. + + + Flushes the contents of the internal buffer of the current object to the underlying stream. + The stream is closed. + + + + + + This property is not supported and always throws a . + A long value. + This property is not supported on this stream. + + + + + + This property is not supported and always throws a . + A long value. + This property is not supported on this stream. + + + + + + Reads a number of decompressed bytes into the specified byte array. + The number of bytes that were decompressed into the byte array. If the end of the stream has been reached, zero or the number of bytes read is returned. + The array used to store decompressed bytes. + The byte offset in at which the read bytes will be placed. + The maximum number of decompressed bytes to read. + + is null. + The value was Compress when the object was created.- or -The underlying stream does not support reading. + + or is less than zero.-or- length minus the index starting point is less than . + The data is in an invalid format.-or-Decompression results in over 8 GB of data. + The stream is closed. + + + This property is not supported and always throws a . + A long value. + The location in the stream. + One of the values. + This property is not supported on this stream. + + + This property is not supported and always throws a . + The length of the stream. + This property is not supported on this stream. + + + Writes compressed bytes to the underlying stream from the specified byte array. + The buffer that contains the data to compress. + The byte offset in at which the compressed bytes will be placed. + The maximum number of compressed bytes to write. + The write operation cannot be performed because the stream is closed. + + + Specifies the control protocol used in establishing a serial port communication for a object. + + + No control is used for the handshake. + + + The XON/XOFF software control protocol is used. The XOFF control is sent to stop the transmission of data. The XON control is sent to resume the transmission. These software controls are used instead of Request to Send (RTS) and Clear to Send (CTS) hardware controls. + + + Request-to-Send (RTS) hardware flow control is used. RTS signals that data is available for transmission. If the input buffer becomes full, the RTS line will be set to false. The RTS line will be set to true when more room becomes available in the input buffer. + + + Both the Request-to-Send (RTS) hardware control and the XON/XOFF software controls are used. + + + Specifies the parity bit for a object. + + + No parity check occurs. + + + Sets the parity bit so that the count of bits set is an odd number. + + + Sets the parity bit so that the count of bits set is an even number. + + + Leaves the parity bit set to 1. + + + Leaves the parity bit set to 0. + + + Specifies the type of character that was received on the serial port of the object. + + + A character was received and placed in the input buffer. + + + The end of file character was received and placed in the input buffer. + + + Provides data for the event. + + + Gets or sets the event type. + One of the values. + + + Represents the method that will handle the event of a object. + The sender of the event, which is the object. + A object that contains the event data. + + + Specifies errors that occur on the object. + + + The application tried to transmit a character, but the output buffer was full. + + + An input buffer overflow has occurred. There is either no room in the input buffer, or a character was received after the end-of-file (EOF) character. + + + A character-buffer overrun has occurred. The next character is lost. + + + The hardware detected a parity error. + + + The hardware detected a framing error. + + + Prepares data for the event. + + + Gets or sets the event type. + One of the values. + + + Represents the method that will handle the event of a object. + The sender of the event, which is the object. + A object that contains the event data. + + + Specifies the type of change that occurred on the object. + + + The Clear to Send (CTS) signal changed state. This signal is used to indicate whether data can be sent over the serial port. + + + The Data Set Ready (DSR) signal changed state. This signal is used to indicate whether the device on the serial port is ready to operate. + + + The Carrier Detect (CD) signal changed state. This signal is used to indicate whether a modem is connected to a working phone line and a data carrier signal is detected. + + + A ring indicator was detected. + + + A break was detected on input. + + + Provides data for the event. + + + Gets or sets the event type. + One of the values. + + + Represents the method that will handle the event of a object. + The source of the event, which is the object. + A object that contains the event data. + + + Represents a serial port resource. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified object. + An interface to a container. + The specified port could not be found or opened. + + + Initializes a new instance of the class using the specified port name. + The port to use (for example, COM1). + The specified port could not be found or opened. + + + Initializes a new instance of the class using the specified port name and baud rate. + The port to use (for example, COM1). + The baud rate. + The specified port could not be found or opened. + + + Initializes a new instance of the class using the specified port name, baud rate, and parity bit. + The port to use (for example, COM1). + The baud rate. + One of the values. + The specified port could not be found or opened. + + + Initializes a new instance of the class using the specified port name, baud rate, parity bit, and data bits. + The port to use (for example, COM1). + The baud rate. + One of the values. + The data bits value. + The specified port could not be found or opened. + + + Initializes a new instance of the class using the specified port name, baud rate, parity bit, data bits, and stop bit. + The port to use (for example, COM1). + The baud rate. + One of the values. + The data bits value. + One of the values. + The specified port could not be found or opened. + + + Gets the underlying object for a object. + A object. + The stream is closed. This can occur because the method has not been called or the method has been called. + The stream is in a .NET Compact Framework application and one of the following methods was called:The .NET Compact Framework does not support the asynchronous model with base streams. + + + + + + Gets or sets the serial baud rate. + The baud rate. + The baud rate specified is less than or equal to zero, or is greater than the maximum allowable baud rate for the device. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + + + Gets or sets the break signal state. + true if the port is in a break state; otherwise, false. + The port is in an invalid state. - or -An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The stream is closed. This can occur because the method has not been called or the method has been called. + + + + + + Gets the number of bytes of data in the receive buffer. + The number of bytes of data in the receive buffer. + The port is in an invalid state. + The stream is closed. This can occur because the method has not been called or the method has been called. + + + + + + Gets the number of bytes of data in the send buffer. + The number of bytes of data in the send buffer. + The port is in an invalid state. + The stream is closed. This can occur because the method has not been called or the method has been called. + + + + + + Gets the state of the Carrier Detect line for the port. + true if the carrier is detected; otherwise, false. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The stream is closed. This can occur because the method has not been called or the method has been called. + + + + + + Closes the port connection, sets the property to false, and disposes of the internal object. + The port is in an invalid state.- or -An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + + + + + + Gets the state of the Clear-to-Send line. + true if the Clear-to-Send line is detected; otherwise, false. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The stream is closed. This can occur because the method has not been called or the method has been called. + + + + + + Gets or sets the standard length of data bits per byte. + The data bits length. + The port is in an invalid state. - or -An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The data bits value is less than 5 or more than 8. + + + Represents the method that will handle the data received event of a object. + + + Discards data from the serial driver's receive buffer. + The port is in an invalid state. - or -An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The stream is closed. This can occur because the method has not been called or the method has been called. + + + + + + Gets or sets a value indicating whether null bytes are ignored when transmitted between the port and the receive buffer. + true if null bytes are ignored; otherwise false. The default is false. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The stream is closed. This can occur because the method has not been called or the method has been called. + + + Discards data from the serial driver's transmit buffer. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The stream is closed. This can occur because the method has not been called or the method has been called. + + + + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + The port is in an invalid state. - or -An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + + + Gets the state of the Data Set Ready (DSR) signal. + true if a Data Set Ready signal has been sent to the port; otherwise, false. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The stream is closed. This can occur because the method has not been called or the method has been called. + + + + + + Gets or sets a value that enables the Data Terminal Ready (DTR) signal during serial communication. + true to enable Data Terminal Ready (DTR); otherwise, false. The default is false. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + + + Gets or sets the byte encoding for pre- and post-transmission conversion of text. + An object. The default is . + The property was set to null. + The property was set to an encoding that is not , , , , one of the Windows single byte encodings, or one of the Windows double byte encodings. + + + Represents the method that handles the error event of a object. + + + Gets an array of serial port names for the current computer. + An array of serial port names for the current computer. + The serial port names could not be queried. + + + Gets or sets the handshaking protocol for serial port transmission of data. + One of the values. The default is None. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The value passed is not a valid value in the enumeration. + + + + + + Indicates that no time-out should occur. + + + Gets a value indicating the open or closed status of the object. + true if the serial port is open; otherwise, false. The default is false. + + + Gets or sets the value used to interpret the end of a call to the and methods. + A value that represents the end of a line. The default is a line feed, (). + The property value is empty. + The property value is null. + + + Opens a new serial port connection. + Access is denied to the port.- or -The current process, or another process on the system, already has the specified COM port open either by a instance or in unmanaged code. + One or more of the properties for this instance are invalid. For example, the , , or properties are not valid values; the is less than or equal to zero; the or property is less than zero and is not . + The port name does not begin with "COM". - or -The file type of the port is not supported. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The specified port on the current instance of the is already open. + + + + + + Gets or sets the parity-checking protocol. + One of the enumeration values that represents the parity-checking protocol. The default is . + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The value passed is not a valid value in the enumeration. + + + + + + Gets or sets the byte that replaces invalid bytes in a data stream when a parity error occurs. + A byte that replaces invalid bytes. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + + + Represents the method that will handle the serial pin changed event of a object. + + + Gets or sets the port for communications, including but not limited to all available COM ports. + The communications port. The default is COM1. + The property was set to a value with a length of zero.-or-The property was set to a value that starts with "\\".-or-The port name was not valid. + The property was set to null. + The specified port is open. + + + Reads a number of bytes from the input buffer and writes those bytes into a byte array at the specified offset. + The number of bytes read. + The byte array to write the input to. + The offset in the buffer array to begin writing. + The number of bytes to read. + The buffer passed is null. + The specified port is not open. + The or parameters are outside a valid region of the being passed. Either or is less than zero. + + plus is greater than the length of the . + No bytes were available to read. + + + Reads a number of characters from the input buffer and writes them into an array of characters at a given offset. + The number of characters read. + The character array to write the input to. + The offset in the buffer array to begin writing. + The number of characters to read. + + plus is greater than the length of the buffer.- or - is 1 and there is a surrogate character in the buffer. + The passed is null. + The or parameters are outside a valid region of the being passed. Either or is less than zero. + The specified port is not open. + No characters were available to read. + + + Gets or sets the size of the input buffer. + The buffer size, in bytes. The default value is 4096. + The value set is less than or equal to zero. + The property was set while the stream was open. + The property was set to an odd integer value. + + + Synchronously reads one byte from the input buffer. + The byte, cast to an , or -1 if the end of the stream has been read. + The specified port is not open. + The operation did not complete before the time-out period ended.- or -No byte was read. + + + + + + Synchronously reads one character from the input buffer. + The character that was read. + The specified port is not open. + The operation did not complete before the time-out period ended.- or -No character was available in the allotted time-out period. + + + + + + Reads all immediately available bytes, based on the encoding, in both the stream and the input buffer of the object. + The contents of the stream and the input buffer of the object. + The specified port is not open. + + + + + + Reads up to the value in the input buffer. + The contents of the input buffer up to the first occurrence of a value. + The specified port is not open. + The operation did not complete before the time-out period ended.- or -No bytes were read. + + + + + + Gets or sets the number of milliseconds before a time-out occurs when a read operation does not finish. + The number of milliseconds before a time-out occurs when a read operation does not finish. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The read time-out value is less than zero and not equal to . + + + Reads a string up to the specified in the input buffer. + The contents of the input buffer up to the specified . + A value that indicates where the read operation stops. + The length of the parameter is 0. + The parameter is null. + The specified port is not open. + The operation did not complete before the time-out period ended. + + + Gets or sets the number of bytes in the internal input buffer before a event occurs. + The number of bytes in the internal input buffer before a event is fired. The default is 1. + The value is less than or equal to zero. + + + Gets or sets a value indicating whether the Request to Send (RTS) signal is enabled during serial communication. + true to enable Request to Transmit (RTS); otherwise, false. The default is false. + The value of the property was set or retrieved while the property is set to the value or the value. + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + + + Gets or sets the standard number of stopbits per byte. + One of the values. + The value is . + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + + + + + + Writes a specified number of bytes to the serial port using data from a buffer. + The byte array that contains the data to write to the port. + The zero-based byte offset in the parameter at which to begin copying bytes to the port. + The number of bytes to write. + The passed is null. + The specified port is not open. + The or parameters are outside a valid region of the being passed. Either or is less than zero. + + plus is greater than the length of the . + The operation did not complete before the time-out period ended. + + + Writes a specified number of characters to the serial port using data from a buffer. + The character array that contains the data to write to the port. + The zero-based byte offset in the parameter at which to begin copying bytes to the port. + The number of characters to write. + The passed is null. + The specified port is not open. + The or parameters are outside a valid region of the being passed. Either or is less than zero. + + plus is greater than the length of the . + The operation did not complete before the time-out period ended. + + + Writes the specified string to the serial port. + The string for output. + The specified port is not open. + + is null. + The operation did not complete before the time-out period ended. + + + Gets or sets the size of the serial port output buffer. + The size of the output buffer, in bytes. The default is 2048. + The value is less than or equal to zero. + The property was set while the stream was open. + The property was set to an odd integer value. + + + Writes the specified string and the value to the output buffer. + The string to write to the output buffer. + The parameter is null. + The specified port is not open. + The method could not write to the stream. + + + Gets or sets the number of milliseconds before a time-out occurs when a write operation does not finish. + The number of milliseconds before a time-out occurs. The default is . + The port is in an invalid state. - or - An attempt to set the state of the underlying port failed. For example, the parameters passed from this object were invalid. + The value is less than zero and not equal to . + + + Specifies the number of stop bits used on the object. + + + No stop bits are used. This value is not supported by the property. + + + One stop bit is used. + + + Two stop bits are used. + + + 1.5 stop bits are used. + + + Controls playback of a sound from a .wav file. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class, and attaches the .wav file within the specified . + A to a .wav file. + + + Initializes a new instance of the class. + The to be used for deserialization. + The destination to be used for deserialization. + The specified in cannot be resolved. + + + Initializes a new instance of the class, and attaches the specified .wav file. + The location of a .wav file to load. + The URL value specified by cannot be resolved. + + + Gets a value indicating whether loading of a .wav file has successfully completed. + true if a .wav file is loaded; false if a .wav file has not yet been loaded. + + + Loads a sound synchronously. + The elapsed time during loading exceeds the time, in milliseconds, specified by . + The file specified by cannot be found. + + + Loads a .wav file from a stream or a Web resource using a new thread. + The elapsed time during loading exceeds the time, in milliseconds, specified by . + The file specified by cannot be found. + + + Occurs when a .wav file has been successfully or unsuccessfully loaded. + + + Gets or sets the time, in milliseconds, in which the .wav file must load. + The number of milliseconds to wait. The default is 10000 (10 seconds). + + + Raises the event. + An that contains the event data. + + + Raises the event. + An that contains the event data. + + + Raises the event. + An that contains the event data. + + + Plays the .wav file using a new thread, and loads the .wav file first if it has not been loaded. + The elapsed time during loading exceeds the time, in milliseconds, specified by . + The file specified by cannot be found. + The .wav header is corrupted; the file specified by is not a PCM .wav file. + + + Plays and loops the .wav file using a new thread, and loads the .wav file first if it has not been loaded. + The elapsed time during loading exceeds the time, in milliseconds, specified by . + The file specified by cannot be found. + The .wav header is corrupted; the file specified by is not a PCM .wav file. + + + Plays the .wav file and loads the .wav file first if it has not been loaded. + The elapsed time during loading exceeds the time, in milliseconds, specified by . + The file specified by cannot be found. + The .wav header is corrupted; the file specified by is not a PCM .wav file. + + + Gets or sets the file path or URL of the .wav file to load. + The file path or URL from which to load a .wav file, or if no file path is present. The default is . + + + Occurs when a new audio source path for this has been set. + + + Stops playback of the sound if playback is occurring. + + + Gets or sets the from which to load the .wav file. + A from which to load the .wav file, or null if no stream is available. The default is null. + + + Occurs when a new audio source for this has been set. + + + For a description of this member, see the method. + The to populate with data. + The destination (see ) for this serialization. + + + Gets or sets the that contains data about the . + An that contains data about the . + + + Represents a system sound type. + 2 + + + + Plays the system sound type. + + + Retrieves sounds associated with a set of Windows operating system sound-event types. This class cannot be inherited. + 2 + + + Gets the sound associated with the Asterisk program event in the current Windows sound scheme. + A . + + + Gets the sound associated with the Beep program event in the current Windows sound scheme. + A . + + + Gets the sound associated with the Exclamation program event in the current Windows sound scheme. + A . + + + Gets the sound associated with the Hand program event in the current Windows sound scheme. + A . + + + Gets the sound associated with the Question program event in the current Windows sound scheme. + A . + + + Manages the authentication modules called during the client authentication process. + + + Calls each registered authentication module to find the first module that can respond to the authentication request. + An instance of the class containing the result of the authorization attempt. If there is no authentication module to respond to the challenge, this method returns null. + The challenge returned by the Internet resource. + The that initiated the authentication challenge. + The associated with this request. + + is null.-or- is null.-or- is null. + + + + + + + Gets or sets the credential policy to be used for resource requests made using the class. + An object that implements the interface that determines whether credentials are sent with requests. The default value is null. + + + Gets the dictionary that contains Service Principal Names (SPNs) that are used to identify hosts during Kerberos authentication for requests made using and its derived classes. + A writable that contains the SPN values for keys composed of host information. + + + Preauthenticates a request. + An instance of the class if the request can be preauthenticated; otherwise, null. If is null, this method returns null. + A to an Internet resource. + The associated with the request. + + is null. + + + + + + + Registers an authentication module with the authentication manager. + The to register with the authentication manager. + + is null. + + + + + + + Gets a list of authentication modules that are registered with the authentication manager. + An that enables the registered authentication modules to be read. + + + + + + + Removes the specified authentication module from the list of registered modules. + The to remove from the list of registered modules. + + is null. + The specified is not registered. + + + + + + + Removes authentication modules with the specified authentication scheme from the list of registered modules. + The authentication scheme of the module to remove. + + is null. + A module for this authentication scheme is not registered. + + + + + + + Specifies protocols for authentication. + + + No authentication is allowed. A client requesting an object with this flag set will always receive a 403 Forbidden status. Use this flag when a resource should never be served to a client. + + + Specifies digest authentication. + + + Negotiates with the client to determine the authentication scheme. If both client and server support Kerberos, it is used; otherwise, NTLM is used. + + + Specifies NTLM authentication. + + + Specifies basic authentication. + + + Specifies anonymous authentication. + + + Specifies Windows authentication. + + + Selects the authentication scheme for an instance. + One of the values that indicates the method of authentication to use for the specified client request. + The instance for which to select an authentication scheme. + + + Contains an authentication message for an Internet server. + + + Creates a new instance of the class with the specified authorization message. + The encrypted authorization message expected by the server. + + + Creates a new instance of the class with the specified authorization message and completion status. + The encrypted authorization message expected by the server. + The completion status of the authorization attempt. true if the authorization attempt is complete; otherwise, false. + + + Creates a new instance of the class with the specified authorization message, completion status, and connection group identifier. + The encrypted authorization message expected by the server. + The completion status of the authorization attempt. true if the authorization attempt is complete; otherwise, false. + A unique identifier that can be used to create private client-server connections that are bound only to this authentication scheme. + + + Gets the completion status of the authorization. + true if the authentication process is complete; otherwise, false. + + + Gets a unique identifier for user-specific connections. + A unique string that associates a connection with an authenticating entity. + + + Gets the message returned to the server in response to an authentication challenge. + The message that will be returned to the server in response to an authentication challenge. + + + Gets or sets a value that indicates whether mutual authentication occurred. + true if both client and server were authenticated; otherwise, false. + + + Gets or sets the prefix for Uniform Resource Identifiers (URIs) that can be authenticated with the property. + An array of strings that contains URI prefixes. + + + Represents the method that specifies a local Internet Protocol address and port number for a . + The local to which the is bound. + The associated with the connection to be created. + The remote that specifies the remote host. + The number of times this delegate was called for a specified connection. + + is equal to + + + Provides a set of properties and methods that are used to manage cookies. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with a specified and . + The name of a . The following characters must not be used inside : equal sign, semicolon, comma, newline (\n), return (\r), tab (\t), and space character. The dollar sign character ("$") cannot be the first character. + The value of a . The following characters must not be used inside : semicolon, comma. + The parameter is null. -or- The parameter is of zero length. -or- The parameter contains an invalid character.-or- The parameter is null .-or - The parameter contains a string not enclosed in quotes that contains an invalid character. + + + Initializes a new instance of the class with a specified , , and . + The name of a . The following characters must not be used inside : equal sign, semicolon, comma, newline (\n), return (\r), tab (\t), and space character. The dollar sign character ("$") cannot be the first character. + The value of a . The following characters must not be used inside : semicolon, comma. + The subset of URIs on the origin server to which this applies. The default value is "/". + The parameter is null. -or- The parameter is of zero length. -or- The parameter contains an invalid character.-or- The parameter is null .-or - The parameter contains a string not enclosed in quotes that contains an invalid character. + + + Initializes a new instance of the class with a specified , , , and . + The name of a . The following characters must not be used inside : equal sign, semicolon, comma, newline (\n), return (\r), tab (\t), and space character. The dollar sign character ("$") cannot be the first character. + The value of a object. The following characters must not be used inside : semicolon, comma. + The subset of URIs on the origin server to which this applies. The default value is "/". + The optional internet domain for which this is valid. The default value is the host this has been received from. + The parameter is null. -or- The parameter is of zero length. -or- The parameter contains an invalid character.-or- The parameter is null .-or - The parameter contains a string not enclosed in quotes that contains an invalid character. + + + Gets or sets a comment that the server can add to a . + An optional comment to document intended usage for this . + + + Gets or sets a URI comment that the server can provide with a . + An optional comment that represents the intended usage of the URI reference for this . The value must conform to URI format. + + + Gets or sets the discard flag set by the server. + true if the client is to discard the at the end of the current session; otherwise, false. The default is false. + + + Gets or sets the URI for which the is valid. + The URI for which the is valid. + + + Overrides the method. + Returns true if the is equal to . Two instances are equal if their , , , , and properties are equal. and string comparisons are case-insensitive. + A reference to a . + + + Gets or sets the current state of the . + true if the has expired; otherwise, false. The default is false. + + + Gets or sets the expiration date and time for the as a . + The expiration date and time for the as a instance. + + + Overrides the method. + The 32-bit signed integer hash code for this instance. + + + Determines whether a page script or other active content can access this cookie. + Boolean value that determines whether a page script or other active content can access this cookie. + + + Gets or sets the name for the . + The name for the . + The value specified for a set operation is null or the empty string- or -The value specified for a set operation contained an illegal character. The following characters must not be used inside the property: equal sign, semicolon, comma, newline (\n), return (\r), tab (\t), and space character. The dollar sign character ("$") cannot be the first character. + + + Gets or sets the URIs to which the applies. + The URIs to which the applies. + + + Gets or sets a list of TCP ports that the applies to. + The list of TCP ports that the applies to. + The value specified for a set operation could not be parsed or is not enclosed in double quotes. + + + Gets or sets the security level of a . + true if the client is only to return the cookie in subsequent requests if those requests use Secure Hypertext Transfer Protocol (HTTPS); otherwise, false. The default is false. + + + Gets the time when the cookie was issued as a . + The time when the cookie was issued as a . + + + Overrides the method. + Returns a string representation of this object that is suitable for including in a HTTP Cookie: request header. + + + + + + Gets or sets the for the . + The for the . + + + Gets or sets the version of HTTP state maintenance to which the cookie conforms. + The version of HTTP state maintenance to which the cookie conforms. + The value specified for a version is not allowed. + + + Provides a collection container for instances of the class. + + + Initializes a new instance of the class. + + + Adds a to a . + The to be added to a . + + is null. + + + Adds the contents of a to the current instance. + The to be added. + + is null. + + + Copies the elements of a to an instance of the class, starting at a particular index. + The target to which the will be copied. + The zero-based index in the target where copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in this is greater than the available space from to the end of the destination . + The elements in this cannot be cast automatically to the type of the destination . + + + Copies the elements of this to a array starting at the specified index of the target array. + The target array to which the will be copied. + The zero-based index in the target where copying begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in this is greater than the available space from to the end of the destination . + The elements in this cannot be cast automatically to the type of the destination . + + + Gets the number of cookies contained in a . + The number of cookies contained in a . + + + Gets an enumerator that can iterate through a . + An instance of an implementation of an interface that can iterate through a . + + + Gets a value that indicates whether a is read-only. + true if this is a read-only ; otherwise, false. The default is true. + + + Gets a value that indicates whether access to a is thread safe. + true if access to the is thread safe; otherwise, false. The default is false. + + + Gets the with a specific index from a . + A with a specific index from a . + The zero-based index of the to be found. + + is less than 0 or is greater than or equal to . + + + Gets the with a specific name from a . + The with a specific name from a . + The name of the to be found. + + is null. + + + Gets an object that you can use to synchronize access to the . + An object that you can use to synchronize access to the . + + + Provides a container for a collection of objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with a specified value for the number of instances that the container can hold. + The number of instances that the can hold. + + is less than or equal to zero. + + + Initializes a new instance of the class with specific properties. + The number of instances that the can hold. + The number of instances per domain. + The maximum size in bytes for any single in a . + + is not equal to . and is less than or equal to zero or is greater than . + + is less than or equal to zero. + + + Adds a to a . This method uses the domain from the to determine which domain collection to associate the with. + The to be added to the . + + is null. + The domain for is null or the empty string (""). + + is larger than . -or- the domain for is not a valid URI. + + + + + + Adds the contents of a to the . + The to be added to the . + + is null. + + + + + + Adds a to the for a particular URI. + The URI of the to be added to the . + The to be added to the . + + is null or is null. + + is larger than . -or- The domain for is not a valid URI. + + + + + + Adds the contents of a to the for a particular URI. + The URI of the to be added to the . + The to be added to the . + + is null. + The domain for one of the cookies in is null. + One of the cookies in contains an invalid domain. + + + + + + Gets and sets the number of instances that a can hold. + The number of instances that a can hold. This is a hard limit and cannot be exceeded by adding a . + + is less than or equal to zero or (value is less than and is not equal to ). + + + Gets the number of instances that a currently holds. + The number of instances that a currently holds. This is the total of instances in all domains. + + + Represents the default maximum size, in bytes, of the instances that the can hold. This field is constant. + + + Represents the default maximum number of instances that the can hold. This field is constant. + + + Represents the default maximum number of instances that the can reference per domain. This field is constant. + + + Gets the HTTP cookie header that contains the HTTP cookies that represent the instances that are associated with a specific URI. + An HTTP cookie header, with strings representing instances delimited by semicolons. + The URI of the instances desired. + + is null. + + + + + + Gets a that contains the instances that are associated with a specific URI. + A that contains the instances that are associated with a specific URI. + The URI of the instances desired. + + is null. + + + + + + Represents the maximum allowed length of a . + The maximum allowed length, in bytes, of a . + + is less than or equal to zero. + + + Gets and sets the number of instances that a can hold per domain. + The number of instances that are allowed per domain. + + is less than or equal to zero. -or- is greater than the maximum allowable number of cookies instances, 300, and is not equal to ). + + + Adds instances for one or more cookies from an HTTP cookie header to the for a specific URI. + The URI of the . + The contents of an HTTP set-cookie header as returned by a HTTP server, with instances delimited by commas. + + is null. + + is null. + One of the cookies is invalid. -or- An error occurred while adding one of the cookies to the container. + + + The exception that is thrown when an error is made adding a to a . + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with specific values of and . + The to be used. + The to be used. + + + Populates a instance with the data needed to serialize the . + The object that holds the serialized object data. The to populate with data. + The contextual information about the source or destination. A that specifies the destination for this serialization. + + + Populates a instance with the data needed to serialize the . + The to be used. + The to be used. + + + Provides storage for multiple credentials. + + + Creates a new instance of the class. + + + Adds a instance for use with SMTP to the credential cache and associates it with a host computer, port, and authentication protocol. Credentials added using this method are valid for SMTP only. This method does not work for HTTP or FTP requests. + A that identifies the host computer. + A that specifies the port to connect to on . + A that identifies the authentication scheme used when connecting to using . See Remarks. + The to add to the credential cache. + + is null. -or- is null. + + not an accepted value. See Remarks. + + is less than zero. + + + Adds a instance to the credential cache for use with protocols other than SMTP and associates it with a Uniform Resource Identifier (URI) prefix and authentication protocol. + A that specifies the URI prefix of the resources that the credential grants access to. + The authentication scheme used by the resource named in . + The to add to the credential cache. + + is null. -or- is null. + The same credentials are added more than once. + + + Gets the system credentials of the application. + An that represents the system credentials of the application. + + + + + + Gets the network credentials of the current security context. + An that represents the network credentials of the current user or application. + + + Returns the instance associated with the specified host, port, and authentication protocol. + A or, if there is no matching credential in the cache, null. + A that identifies the host computer. + A that specifies the port to connect to on . + A that identifies the authentication scheme used when connecting to . See Remarks. + + is null. -or- is null. + + not an accepted value. See Remarks. -or- is equal to the empty string (""). + + is less than zero. + + + Returns the instance associated with the specified Uniform Resource Identifier (URI) and authentication type. + A or, if there is no matching credential in the cache, null. + A that specifies the URI prefix of the resources that the credential grants access to. + The authentication scheme used by the resource named in . + + or is null. + + + Returns an enumerator that can iterate through the instance. + An for the . + + + Deletes a instance from the cache if it is associated with the specified host, port, and authentication protocol. + A that identifies the host computer. + A that specifies the port to connect to on . + A that identifies the authentication scheme used when connecting to . See Remarks. + + + Deletes a instance from the cache if it is associated with the specified Uniform Resource Identifier (URI) prefix and authentication protocol. + A that specifies the URI prefix of the resources that the credential is used for. + The authentication scheme used by the host named in . + + + Represents the file compression and decompression encoding format to be used to compress the data received in response to an . + + + Do not use compression. + + + Use the gZip compression-decompression algorithm. + + + Use the deflate compression-decompression algorithm. + + + Provides simple domain name resolution functionality. + + + Asynchronously returns the Internet Protocol (IP) addresses for the specified host. + An instance that references the asynchronous request. + The host name or IP address to resolve. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation is complete. + + is null. + The length of is greater than 255 characters. + An error is encountered when resolving . + + is an invalid IP address. + + + Begins an asynchronous request for information about the specified DNS host name. + An instance that references the asynchronous request. + The DNS name of the host. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation is complete. + + is null. + An error was encountered executing the DNS query. + + + + + + + + + Asynchronously resolves an IP address to an instance. + An instance that references the asynchronous request. + The IP address to resolve. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation is complete. + + is null. + An error is encountered when resolving . + + is an invalid IP address. + + + Asynchronously resolves a host name or IP address to an instance. + An instance that references the asynchronous request. + The host name or IP address to resolve. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation is complete. + + is null. + The length of is greater than 255 characters. + An error is encountered when resolving . + + is an invalid IP address. + + + Begins an asynchronous request to resolve a DNS host name or IP address to an instance. + An instance that references the asynchronous request. + The DNS name of the host. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation is complete. + + is null. + The caller does not have permission to access DNS information. + + + + + + + + + Ends an asynchronous request for DNS information. + An array of type that holds the IP addresses for the host specified by the parameter of . + An instance returned by a call to the method. + + + Ends an asynchronous request for DNS information. + An object that contains DNS information about a host. + An instance that is returned by a call to the method. + + is null. + + + + + + + + Ends an asynchronous request for DNS information. + An instance that contains address information about the host. + An instance returned by a call to an method. + + is null. + + + Ends an asynchronous request for DNS information. + An object that contains DNS information about a host. + An instance that is returned by a call to the method. + + is null. + + + + + + + + Returns the Internet Protocol (IP) addresses for the specified host. + An array of type that holds the IP addresses for the host that is specified by the parameter. + The host name or IP address to resolve. + + is null. + The length of is greater than 255 characters. + An error is encountered when resolving . + + is an invalid IP address. + + + Creates an instance from the specified . + An . + An . + + is null. + An error is encountered when resolving . + + + + + + + + + Creates an instance from an IP address. + An instance. + An IP address. + + is null. + An error is encountered when resolving . + + is not a valid IP address. + + + + + + + + + Gets the DNS information for the specified DNS host name. + An object that contains host information for the address specified in . + The DNS name of the host. + + is null. + The length of is greater than 255 characters. + An error is encountered when resolving . + + + + + + + + + Resolves an IP address to an instance. + An instance that contains address information about the host specified in . + An IP address. + + is null. + An error is encountered when resolving . + + is an invalid IP address. + + + Resolves a host name or IP address to an instance. + An instance that contains address information about the host specified in . + The host name or IP address to resolve. + The parameter is null. + The length of parameter is greater than 255 characters. + An error was encountered when resolving the parameter. + The parameter is an invalid IP address. + + + Gets the host name of the local computer. + A string that contains the DNS host name of the local computer. + An error is encountered when resolving the local host name. + + + + + + Resolves a DNS host name or IP address to an instance. + An instance that contains address information about the host specified in . + A DNS-style host name or IP address. + + is null. + The length of is greater than 255 characters. + An error is encountered when resolving . + + + + + + + + + Represents a network endpoint as a host name or a string representation of an IP address and a port number. + + + Initializes a new instance of the class with the host name or string representation of an IP address and a port number. + The host name or a string representation of the IP address. + The port number associated with the address, or 0 to specify any available port. is in host order. + The parameter contains an empty string. + The parameter is a null. + + is less than .-or- is greater than . + + + Initializes a new instance of the class with the host name or string representation of an IP address, a port number, and an address family. + The host name or a string representation of the IP address. + The port number associated with the address, or 0 to specify any available port. is in host order. + One of the values. + The parameter contains an empty string.-or- is . + The parameter is a null. + + is less than .-or- is greater than . + + + Gets the Internet Protocol (IP) address family. + One of the values. + + + Compares two objects. + true if the two instances are equal; otherwise, false. + A instance to compare to the current instance. + + + Returns a hash value for a . + An integer hash value for the . + + + Gets the host name or string representation of the Internet Protocol (IP) address of the host. + A host name or string representation of an IP address. + + + Gets the port number of the . + An integer value in the range 0 to 0xffff indicating the port number of the . + + + Returns the host name or string representation of the IP address and port number of the . + A string containing the address family, host name or IP address string, and the port number of the specified . + + + Controls rights to access Domain Name System (DNS) servers on the network. + + + Creates a new instance of the class that either allows unrestricted DNS access or disallows DNS access. + One of the values. + + is not a valid value. + + + Creates an identical copy of the current permission instance. + A new instance of the class that is an identical copy of the current instance. + + + Reconstructs a instance from an XML encoding. + The XML encoding to use to reconstruct the instance. + + is null. + + is not a element. + + + Creates a permission instance that is the intersection of the current permission instance and the specified permission instance. + A instance that represents the intersection of the current instance with the specified instance, or null if the intersection is empty. If both the current instance and are unrestricted, this method returns a new instance that is unrestricted; otherwise, it returns null. + The instance to intersect with the current instance. + + is neither a nor null. + + + Determines whether the current permission instance is a subset of the specified permission instance. + false if the current instance is unrestricted and is either null or unrestricted; otherwise, true. + The second instance to be tested for the subset relationship. + + is neither a nor null. + + + Checks the overall permission state of the object. + true if the instance was created with ; otherwise, false. + + + Creates an XML encoding of a instance and its current state. + A instance that contains an XML-encoded representation of the security object, including state information. + + + Creates a permission instance that is the union of the current permission instance and the specified permission instance. + A instance that represents the union of the current instance with the specified instance. If is null, this method returns a copy of the current instance. If the current instance or is unrestricted, this method returns a instance that is unrestricted; otherwise, it returns a instance that is restricted. + The instance to combine with the current instance. + + is neither a nor null. + + + Specifies permission to request information from Domain Name Servers. + + + Initializes a new instance of the class with the specified value. + One of the values. + The parameter is not a valid . + + + Creates and returns a new instance of the class. + A that corresponds to the security declaration. + + + Provides data for the event. + + + Gets the data that is downloaded by a method. + A array that contains the downloaded data. + + + + + + Represents the method that will handle the event of a . + The source of the event. + A containing event data. + + + Provides data for the event of a . + + + Gets the number of bytes received. + An value that indicates the number of bytes received. + + + Gets the total number of bytes in a data download operation. + An value that indicates the number of bytes that will be received. + + + Represents the method that will handle the event of a . + The source of the event. + A containing event data. + + + Provides data for the event. + + + Gets the data that is downloaded by a method. + A that contains the downloaded data. + + + + + + Represents the method that will handle the event of a . + The source of the event. + A that contains event data. + + + Identifies a network address. This is an abstract class. + + + Initializes a new instance of the class. + + + Gets the address family to which the endpoint belongs. + One of the values. + Any attempt is made to get or set the property when the property is not overridden in a descendant class. + + + + + + Creates an instance from a instance. + A new instance that is initialized from the specified instance. + The socket address that serves as the endpoint for a connection. + Any attempt is made to access the method when the method is not overridden in a descendant class. + + + + + + Serializes endpoint information into a instance. + A instance that contains the endpoint information. + Any attempt is made to access the method when the method is not overridden in a descendant class. + + + + + + Defines an endpoint that is authorized by a instance. + + + Determines whether the specified is equal to the current instance. + true if the specified is equal to the current ; otherwise, false. + The specified + + + Serves as a hash function for a particular instance. + A hash code for the current . + + + + + + Gets the DNS host name or IP address of the server that is associated with this endpoint. + A string that contains the DNS host name or IP address of the server. + + + Gets the network port number that is associated with this endpoint. + The network port number that is associated with this request, or . + + + Returns a string that represents the current instance. + A string that represents the current instance. + + + + + + Gets the transport type that is associated with this endpoint. + One of the values. + + + Provides a file system implementation of the class. + + + Initializes a new instance of the class from the specified instances of the and classes. + A object that contains the information that is required to serialize the new object. + A object that contains the source of the serialized stream that is associated with the new object. + + + Cancels a request to an Internet resource. + + + Begins an asynchronous request for a object to use to write data. + An that references the asynchronous request. + The delegate. + An object that contains state information for this request. + The property is GET and the application writes to the stream. + The stream is being used by a previous call to . + No write stream is available. + The was aborted. + + + + + + Begins an asynchronous request for a file system resource. + An that references the asynchronous request. + The delegate. + An object that contains state information for this request. + The stream is already in use by a previous call to . + The was aborted. + + + + + + Gets or sets the name of the connection group for the request. This property is reserved for future use. + The name of the connection group for the request. + + + Gets or sets the content length of the data being sent. + The number of bytes of request data being sent. + + is less than 0. + + + Gets or sets the content type of the data being sent. This property is reserved for future use. + The content type of the data being sent. + + + Gets or sets the credentials that are associated with this request. This property is reserved for future use. + An that contains the authentication credentials that are associated with this request. The default is null. + + + Ends an asynchronous request for a instance that the application uses to write data. + A object that the application uses to write data. + An that references the pending request for a stream. + + is null. + + + Ends an asynchronous request for a file system resource. + A that contains the response from the file system resource. + An that references the pending request for a response. + + is null. + + + Populates a with the data needed to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + Returns a object for writing data to the file system resource. + A for writing data to the file system resource. + The request times out. + + + + + + Returns a response to a file system request. + A that contains the response from the file system resource. + The request timed out. + + + + + + Gets a collection of the name/value pairs that are associated with the request. This property is reserved for future use. + A that contains header name/value pairs associated with this request. + + + Gets or sets the protocol method used for the request. This property is reserved for future use. + The protocol method to use in this request. + The method is invalid.- or -The method is not supported.- or -Multiple methods were specified. + + + Gets or sets a value that indicates whether to preauthenticate a request. This property is reserved for future use. + true to preauthenticate; otherwise, false. + + + Gets or sets the network proxy to use for this request. This property is reserved for future use. + An that indicates the network proxy to use for this request. + + + Gets the Uniform Resource Identifier (URI) of the request. + A that contains the URI of the request. + + + Populates a object with the required data to serialize the . + A that holds the serialized data for the . + A that contains the destination of the serialized stream that is associated with the new . + + + Gets or sets the length of time until the request times out. + The time, in milliseconds, until the request times out, or the value to indicate that the request does not time out. + The value specified is less than or equal to zero and is not . + + + Always throws a . + Always throws a . + Default credentials are not supported for file Uniform Resource Identifiers (URIs). + + + Provides a file system implementation of the class. + + + Initializes a new instance of the class from the specified instances of the and classes. + A instance that contains the information required to serialize the new instance. + An instance of the class that contains the source of the serialized stream associated with the new instance. + + + Closes the response stream. + + + Gets the length of the content in the file system resource. + The number of bytes returned from the file system resource. + + + Gets the content type of the file system resource. + The value "binary/octet-stream". + + + Populates a with the data needed to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + Returns the data stream from the file system resource. + A for reading data from the file system resource. + + + Gets a collection of header name/value pairs associated with the response. + A that contains the header name/value pairs associated with the response. + + + Gets the URI of the file system resource that provided the response. + A that contains the URI of the file system resource that provided the response. + + + Populates a instance with the data needed to serialize the . + A , which will hold the serialized data for the . + A containing the destination of the serialized stream associated with the new . + + + Specifies the status codes returned for a File Transfer Protocol (FTP) operation. + + + Included for completeness, this value is never returned by servers. + + + Specifies that the response contains a restart marker reply. The text of the description that accompanies this status contains the user data stream marker and the server marker. + + + Specifies that the service is not available now; try your request later. + + + Specifies that the data connection is already open and the requested transfer is starting. + + + Specifies that the server is opening the data connection. + + + Specifies that the command completed successfully. + + + Specifies that the command is not implemented by the server because it is not needed. + + + Specifies the status of a directory. + + + Specifies the status of a file. + + + Specifies the system type name using the system names published in the Assigned Numbers document published by the Internet Assigned Numbers Authority. + + + Specifies that the server is ready for a user login operation. + + + Specifies that the server is closing the control connection. + + + Specifies that the server is closing the data connection and that the requested file action was successful. + + + Specifies that the server is entering passive mode. + + + Specifies that the user is logged in and can send commands. + + + Specifies that the server accepts the authentication mechanism specified by the client, and the exchange of security data is complete. + + + Specifies that the requested file action completed successfully. + + + Specifies that the requested path name was created. + + + Specifies that the server expects a password to be supplied. + + + Specifies that the server requires a login account to be supplied. + + + Specifies that the requested file action requires additional information. + + + Specifies that the service is not available. + + + Specifies that the data connection cannot be opened. + + + Specifies that the connection has been closed. + + + Specifies that the requested action cannot be performed on the specified file because the file is not available or is being used. + + + Specifies that an error occurred that prevented the request action from completing. + + + Specifies that the requested action cannot be performed because there is not enough space on the server. + + + Specifies that the command has a syntax error or is not a command recognized by the server. + + + Specifies that one or more command arguments has a syntax error. + + + Specifies that the command is not implemented by the FTP server. + + + Specifies that the sequence of commands is not in the correct order. + + + Specifies that login information must be sent to the server. + + + Specifies that a user account on the server is required. + + + Specifies that the requested action cannot be performed on the specified file because the file is not available. + + + Specifies that the requested action cannot be taken because the specified page type is unknown. Page types are described in RFC 959 Section 3.1.2.3 + + + Specifies that the requested action cannot be performed. + + + Specifies that the requested action cannot be performed on the specified file. + + + Implements a File Transfer Protocol (FTP) client. + + + Terminates an asynchronous FTP operation. + + + + + + + + + Begins asynchronously opening a request's content stream for writing. + An instance that indicates the status of the operation. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation completes. + A previous call to this method or has not yet completed. + A connection to the FTP server could not be established. + The property is not set to . + + + + + + + + + + + Begins sending a request and receiving a response from an FTP server asynchronously. + An instance that indicates the status of the operation. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation completes. + + or has already been called for this instance. + + + + + + + + + + + Gets or sets the certificates used for establishing an encrypted connection to the FTP server. + An object that contains the client certificates. + The value specified for a set operation is null. + + + Gets or sets the name of the connection group that contains the service point used to send the current request. + A value that contains a connection group name. + A new value was specified for this property for a request that is already in progress. + + + Gets or sets a value that is ignored by the class. + An value that should be ignored. + + + Gets or sets a byte offset into the file being downloaded by this request. + An instance that specifies the file offset, in bytes. The default value is zero. + A new value was specified for this property for a request that is already in progress. + The value specified for this property is less than zero. + + + Always throws a . + Always throws a . + Content type information is not supported for FTP. + + + Gets or sets the credentials used to communicate with the FTP server. + An instance; otherwise, null if the property has not been set. + The value specified for a set operation is null. + An of a type other than was specified for a set operation. + A new value was specified for this property for a request that is already in progress. + + + + + + Defines the default cache policy for all FTP requests. + A that defines the cache policy for FTP requests. + The caller tried to set this property to null. + + + Gets or sets a that specifies that an SSL connection should be used. + true if control and data transmissions are encrypted; otherwise, false. The default value is false. + The connection to the FTP server has already been established. + + + Ends a pending asynchronous operation started with . + A writable instance associated with this instance. + The object that was returned when the operation started. + + is null. + + was not obtained by calling . + This method was already called for the operation identified by . + + + + + + + + + Ends a pending asynchronous operation started with . + A reference that contains an instance. This object contains the FTP server's response to the request. + The that was returned when the operation started. + + is null. + + was not obtained by calling . + This method was already called for the operation identified by . + An error occurred using an HTTP proxy. + + + + + + + + + Retrieves the stream used to upload data to an FTP server. + A writable instance used to store data to be sent to the server by the current request. + + has been called and has not completed. - or -An HTTP proxy is enabled, and you attempted to use an FTP command other than , , or . + A connection to the FTP server could not be established. + The property is not set to or . + + + + + + + + + + + Returns the FTP server response. + A reference that contains an instance. This object contains the FTP server's response to the request. + + or has already been called for this instance.- or -An HTTP proxy is enabled, and you attempted to use an FTP command other than , , or . + + is set to true, but the server does not support this feature.- or -A was specified and the timeout has expired. + + + + + + + + + + + Gets an empty object. + An empty object. + + + + + + + + + Gets or sets a value that specifies whether the control connection to the FTP server is closed after the request completes. + true if the connection to the server should not be destroyed; otherwise, false. The default value is true. + A new value was specified for this property for a request that is already in progress. + + + Gets or sets the command to send to the FTP server. + A value that contains the FTP command to send to the server. The default value is . + A new value was specified for this property for a request that is already in progress. + The method is invalid.- or -The method is not supported.- or -Multiple methods were specified. + + + Always throws a . + Always throws a . + Preauthentication is not supported for FTP. + + + Gets or sets the proxy used to communicate with the FTP server. + An instance responsible for communicating with the FTP server. + This property cannot be set to null. + A new value was specified for this property for a request that is already in progress. + + + + + + Gets or sets a time-out when reading from or writing to a stream. + The number of milliseconds before the reading or writing times out. The default value is 300,000 milliseconds (5 minutes). + The request has already been sent. + The value specified for a set operation is less than or equal to zero and is not equal to . + + + Gets or sets the new name of a file being renamed. + The new name of the file being renamed. + The value specified for a set operation is null or an empty string. + A new value was specified for this property for a request that is already in progress. + + + Gets the URI requested by this instance. + A instance that identifies a resource that is accessed using the File Transfer Protocol. + + + Gets the object used to connect to the FTP server. + A object that can be used to customize connection behavior. + + + + + + + Gets or sets the number of milliseconds to wait for a request. + An value that contains the number of milliseconds to wait before a request times out. The default value is . + The value specified is less than zero and is not . + A new value was specified for this property for a request that is already in progress. + + + Gets or sets a value that specifies the data type for file transfers. + true to indicate to the server that the data to be transferred is binary; false to indicate that the data is text. The default value is true. + A new value was specified for this property for a request that is already in progress. + + + Always throws a . + Always throws a . + Default credentials are not supported for FTP. + + + Gets or sets the behavior of a client application's data transfer process. + false if the client application's data transfer process listens for a connection on the data port; otherwise, true if the client should initiate a connection on the data port. The default value is true. + A new value was specified for this property for a request that is already in progress. + + + Encapsulates a File Transfer Protocol (FTP) server's response to a request. + + + Gets the message sent by the FTP server when a connection is established prior to logon. + A that contains the banner message sent by the server; otherwise, if no message is sent. + + + Frees the resources held by the response. + + + + + + + + Gets the length of the data received from the FTP server. + An value that contains the number of bytes of data received from the FTP server. + + + Gets the message sent by the server when the FTP session is ending. + A that contains the exit message sent by the server; otherwise, if no message is sent. + + + Retrieves the stream that contains response data sent from an FTP server. + A readable instance that contains data returned with the response; otherwise, if no response data was returned by the server. + The response did not return a data stream. + + + + + + + + Gets an empty object. + An empty object. + + + Gets the date and time that a file on an FTP server was last modified. + A that contains the last modified date and time for a file. + + + + + + Gets the URI that sent the response to the request. + A instance that identifies the resource associated with this response. + + + Gets the most recent status code sent from the FTP server. + An value that indicates the most recent status code returned with this response. + + + Gets text that describes a status code sent from the FTP server. + A instance that contains the status code and message returned with this response. + + + Gets the message sent by the FTP server when authentication is complete. + A that contains the welcome message sent by the server; otherwise, if no message is sent. + + + Contains a global default proxy instance for all HTTP requests. + + + Initializes a new instance of the class. + + + Returns an empty proxy instance. + An that contains no information. + + + Gets or sets the global HTTP proxy. + An that every call to uses. + The value specified for a set operation was null. + The caller does not have permission for the requested operation. + + + Represents the method that notifies callers when a continue response is received by the client. + The numeric value of the HTTP status from the server. + The headers returned with the 100-continue response from the server. + + + Provides a simple, programmatically controlled HTTP protocol listener. This class cannot be inherited. + + + Initializes a new instance of the class. + This class cannot be used on the current operating system. Windows Server 2003 or Windows XP SP2 is required to use instances of this class. + + + Shuts down the object immediately, discarding all currently queued requests. + + + + + + + + Gets or sets the scheme used to authenticate clients. + A bitwise combination of enumeration values that indicates how clients are to be authenticated. The default value is . + This object has been closed. + + + Gets or sets the delegate called to determine the protocol used to authenticate clients. + An delegate that invokes the method used to select an authentication protocol. The default value is null. + This object has been closed. + + + Begins asynchronously retrieving an incoming request. + An object that indicates the status of the asynchronous operation. + An delegate that references the method to invoke when a client request is available. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation completes. + A Win32 function call failed. Check the exception's property to determine the cause of the exception. + This object has not been started or is currently stopped. + This object is closed. + + + Shuts down the . + + + + + + + + Gets a default list of Service Provider Names (SPNs) as determined by registered prefixes. + A that contains a list of SPNs. + + + Completes an asynchronous operation to retrieve an incoming client request. + An object that represents the client request. + An object that was obtained when the asynchronous operation was started. + + was not obtained by calling the method. + + is null. + The method was already called for the specified object. + This object is closed. + + + Get or set the to use for extended protection for a session. + A that specifies the policy to use for extended protection. + An attempt was made to set the property, but the property was not null. + An attempt was made to set the property to null. + An attempt was made to set the property after the method was already called. + This object is closed. + The property was set to on a platform that does not support extended protection. + + + Get or set the delegate called to determine the to use for each request. + A that specifies the policy to use for extended protection. + An attempt was made to set the property, but the property must be null. + An attempt was made to set the property to null. + An attempt was made to set the property after the method was already called. + This object is closed. + An attempt was made to set the property on a platform that does not support extended protection. + + + Waits for an incoming request and returns when one is received. + An object that represents a client request. + A Win32 function call failed. Check the exception's property to determine the cause of the exception. + This object has not been started or is currently stopped.-or-The does not have any Uniform Resource Identifier (URI) prefixes to respond to. See Remarks. + This object is closed. + + + Gets or sets a value that specifies whether your application receives exceptions that occur when an sends the response to the client. + true if this should not return exceptions that occur when sending the response to the client; otherwise false. The default value is false. + This object has been closed. + + + Gets a value that indicates whether has been started. + true if the was started; otherwise, false. + + + Gets a value that indicates whether can be used with the current operating system. + true if is supported; otherwise, false. + + + Gets the Uniform Resource Identifier (URI) prefixes handled by this object. + An that contains the URI prefixes that this object is configured to handle. + This object has been closed. + + + + + + + + Gets or sets the realm, or resource partition, associated with this object. + A value that contains the name of the realm associated with the object. + This object has been closed. + + + Allows this instance to receive incoming requests. + A Win32 function call failed. Check the exception's property to determine the cause of the exception. + This object is closed. + + + + + + + + Causes this instance to stop receiving incoming requests. + This object has been closed. + + + + + + + + Releases the resources held by this object. + + + Gets or sets a value that controls whether, when NTLM is used, additional requests using the same Transmission Control Protocol (TCP) connection are required to authenticate. + true if the of the first request will be used for subsequent requests on the same connection; otherwise, false. The default value is false. + This object has been closed. + + + A delegate called to determine the to use for each request. + An object that specifies the extended protection policy to use for this request. + The to determine the extended protection policy that the instance will use to provide extended protection. + + + Holds the user name and password from a basic authentication request. + + + Initializes a new instance of the class using the specified user name and password. + The user name. + The password. + + + Indicates the password from a basic authentication attempt. + A that holds the password. + + + Provides access to the request and response objects used by the class. This class cannot be inherited. + + + Gets the that represents a client's request for a resource. + An object that represents the client request. + + + Gets the object that will be sent to the client in response to the client's request. + An object used to send a response back to the client. + + + Gets an object used to obtain identity, authentication information, and security roles for the client whose request is represented by this object. + An object that describes the client, or null if the that supplied this does not require authentication. + + + The exception that is thrown when an error occurs processing an HTTP request. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified error code. + A value that identifies the error that occurred. + + + Initializes a new instance of the class using the specified error code and message. + A value that identifies the error that occurred. + A that describes the error that occurred. + + + Initializes a new instance of the class from the specified instances of the and classes. + A object that contains the information required to deserialize the new object. + A object. + + + Gets a value that identifies the error that occurred. + A value. + + + Represents the collection used to store Uniform Resource Identifier (URI) prefixes for objects. + + + Adds a Uniform Resource Identifier (URI) prefix to the collection. + A that identifies the URI information that is compared in incoming requests. The prefix must be terminated with a forward slash ("/"). + + is null. + + does not use the http:// or https:// scheme. These are the only schemes supported for objects. -or- is not a correctly formatted URI prefix. Make sure the string is terminated with a "/". + The associated with this collection is closed. + A Windows function call failed. Check the exception's property to determine the cause of the exception. This exception is thrown if another has already added the prefix . + + + + + + + + + Removes all the Uniform Resource Identifier (URI) prefixes from the collection. + A Windows function call failed. Check the exception's property to determine the cause of the exception. + The associated with this collection is closed. + + + + + + + + Returns a value that indicates whether the specified prefix is contained in the collection. + true if this collection contains the prefix specified by ; otherwise, false. + A that contains the Uniform Resource Identifier (URI) prefix to test. + + is null. + + + Copies the contents of an to the specified array. + The one dimensional that receives the Uniform Resource Identifier (URI) prefix strings in this collection. + The zero-based index in at which copying begins. + + has more than one dimension. + This collection contains more elements than can be stored in starting at . + The associated with this collection is closed. + + cannot store string values. + + + Copies the contents of an to the specified string array. + The one dimensional string array that receives the Uniform Resource Identifier (URI) prefix strings in this collection. + The zero-based index in at which copying begins. + + has more than one dimension. + This collection contains more elements than can be stored in starting at . + The associated with this collection is closed. + + + Gets the number of prefixes contained in the collection. + An that contains the number of prefixes in this collection. + + + Returns an object that can be used to iterate through the collection. + An object that implements the interface and provides access to the strings in this collection. + + + Gets a value that indicates whether access to the collection is read-only. + Always returns false. + + + Gets a value that indicates whether access to the collection is synchronized (thread-safe). + This property always returns false. + + + Removes the specified Uniform Resource Identifier (URI) from the list of prefixes handled by the object. + true if the was found in the and removed; otherwise false. + A that contains the URI prefix to remove. + + is null. + A Windows function call failed. To determine the cause of the exception, check the exception's error code. + The associated with this collection is closed. + + + + + + + + Returns an object that can be used to iterate through the collection. + An object that implements the interface and provides access to the strings in this collection. + + + Describes an incoming HTTP request to an object. This class cannot be inherited. + + + Gets the MIME types accepted by the client. + A array that contains the type names specified in the request's Accept header or null if the client request did not include an Accept header. + + + Begins an asynchronous request for the client's X.509 v.3 certificate. + An that indicates the status of the operation. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the operation. This object is passed to the callback delegate when the operation completes. + + + Gets an error code that identifies a problem with the provided by the client. + An value that contains a Windows error code. + The client certificate has not been initialized yet by a call to the or methods-or - The operation is still in progress. + + + + + + Gets the content encoding that can be used with data sent with the request + An object suitable for use with the data in the property. + + + Gets the length of the body data included in the request. + The value from the request's Content-Length header. This value is -1 if the content length is not known. + + + Gets the MIME type of the body data included in the request. + A that contains the text of the request's Content-Type header. + + + Gets the cookies sent with the request. + A that contains cookies that accompany the request. This property returns an empty collection if the request does not contain cookies. + + + Ends an asynchronous request for the client's X.509 v.3 certificate. + The object that is returned when the operation started. + The pending request for the certificate. + + is null. + + was not obtained by calling + This method was already called for the operation identified by . + + + Retrieves the client's X.509 v.3 certificate. + A object that contains the client's X.509 v.3 certificate. + A call to this method to retrieve the client's X.509 v.3 certificate is in progress and therefore another call to this method cannot be made. + + + Gets a value that indicates whether the request has associated body data. + true if the request has associated body data; otherwise, false. + + + + + + Gets the collection of header name/value pairs sent in the request. + A that contains the HTTP headers included in the request. + + + + + + Gets the HTTP method specified by the client. + A that contains the method used in the request. + + + Gets a stream that contains the body data sent by the client. + A readable object that contains the bytes sent by the client in the body of the request. This property returns if no data is sent with the request. + + + Gets a value that indicates whether the client sending this request is authenticated. + true if the client was authenticated; otherwise, false. + + + Gets a value that indicates whether the request is sent from the local computer. + true if the request originated on the same computer as the object that provided the request; otherwise, false. + + + Gets a value that indicates whether the TCP connection used to send the request is using the Secure Sockets Layer (SSL) protocol. + true if the TCP connection is using SSL; otherwise, false. + + + Gets a value that indicates whether the client requests a persistent connection. + true if the connection should be kept open; otherwise, false. + + + + + + Get the server IP address and port number to which the request is directed. + An that represents the IP address that the request is sent to. + + + + + + Gets the HTTP version used by the requesting client. + A that identifies the client's version of HTTP. + + + Gets the query string included in the request. + A object that contains the query data included in the request . + + + Gets the URL information (without the host and port) requested by the client. + A that contains the raw URL for this request. + + + Gets the client IP address and port number from which the request originated. + An that represents the IP address and port number from which the request originated. + + + + + + Gets the request identifier of the incoming HTTP request. + A object that contains the identifier of the HTTP request. + + + Gets the Service Provider Name (SPN) that the client sent on the request. + A that contains the SPN the client sent on the request. + + + Gets the for the client request. + A object for the client request. + + + Gets the object requested by the client. + A object that identifies the resource requested by the client. + + + Gets the Uniform Resource Identifier (URI) of the resource that referred the client to the server. + A object that contains the text of the request's header, or null if the header was not included in the request. + + + Gets the user agent presented by the client. + A object that contains the text of the request's User-Agent header. + + + Gets the server IP address and port number to which the request is directed. + A that contains the host address information. + + + Gets the DNS name and, if provided, the port number specified by the client. + A value that contains the text of the request's Host header. + + + Gets the natural languages that are preferred for the response. + A array that contains the languages specified in the request's header or null if the client request did not include an header. + + + Represents a response to a request being handled by an object. + + + Closes the connection to the client without sending a response. + + + + + + + + Adds the specified header and value to the HTTP headers for this response. + The name of the HTTP header to set. + The value for the header. + + is null or an empty string (""). + You are not allowed to specify a value for the specified header.-or- or contains invalid characters. + The length of is greater than 65,535 characters. + + + Adds the specified to the collection of cookies for this response. + The to add to the collection to be sent with this response + + is null. + + + Appends a value to the specified HTTP header to be sent with this response. + The name of the HTTP header to append to. + The value to append to the header. + + is null or an empty string ("").-or-You are not allowed to specify a value for the specified header.-or- or contains invalid characters. + The length of is greater than 65,535 characters. + + + Sends the response to the client and releases the resources held by this instance. + + + + + + + + Returns the specified byte array to the client and releases the resources held by this instance. + A array that contains the response to send to the client. + true to block execution while flushing the stream to the client; otherwise, false. + + is null. + This object is closed. + + + + + + + + Gets or sets the for this response's . + An object suitable for use with the data in the property, or null if no encoding is specified. + + + Gets or sets the number of bytes in the body data included in the response. + The value of the response's Content-Length header. + The value specified for a set operation is less than zero. + The response is already being sent. + This object is closed. + + + Gets or sets the MIME type of the content returned. + A instance that contains the text of the response's Content-Type header. + The value specified for a set operation is null. + The value specified for a set operation is an empty string (""). + This object is closed. + + + + + + Gets or sets the collection of cookies returned with the response. + A that contains cookies to accompany the response. The collection is empty if no cookies have been added to the response. + + + Copies properties from the specified to this response. + The instance to copy. + + + Gets or sets the collection of header name/value pairs returned by the server. + A instance that contains all the explicitly set HTTP headers to be included in the response. + The instance specified for a set operation is not valid for a response. + + + + + + Gets or sets a value indicating whether the server requests a persistent connection. + true if the server requests a persistent connection; otherwise, false. The default is true. + This object is closed. + + + Gets a object to which a response can be written. + A object to which a response can be written. + This object is closed. + + + Gets or sets the HTTP version used for the response. + A object indicating the version of HTTP used when responding to the client. Note that this property is now obsolete. + The value specified for a set operation is null. + The value specified for a set operation does not have its property set to 1 or does not have its property set to either 0 or 1. + This object is closed. + + + Configures the response to redirect the client to the specified URL. + The URL that the client should use to locate the requested resource. + + + Gets or sets the value of the HTTP Location header in this response. + A that contains the absolute URL to be sent to the client in the Location header. + The value specified for a set operation is an empty string (""). + This object is closed. + + + Gets or sets whether the response uses chunked transfer encoding. + true if the response is set to use chunked transfer encoding; otherwise, false. The default is false. + + + Adds or updates a in the collection of cookies sent with this response. + A for this response. + + is null. + The cookie already exists in the collection and could not be replaced. + + + Gets or sets the HTTP status code to be returned to the client. + An value that specifies the HTTP status code for the requested resource. The default is , indicating that the server successfully processed the client's request and included the requested resource in the response body. + This object is closed. + The value specified for a set operation is not valid. Valid values are between 100 and 999 inclusive. + + + Gets or sets a text description of the HTTP status code returned to the client. + The text description of the HTTP status code returned to the client. The default is the RFC 2616 description for the property value, or an empty string ("") if an RFC 2616 description does not exist. + The value specified for a set operation is null. + The value specified for a set operation contains non-printable characters. + + + Releases all resources used by the . + + + The HTTP headers that may be specified in a client request. + + + The Cache-Control header, which specifies directives that must be obeyed by all cache control mechanisms along the request/response chain. + + + The Connection header, which specifies options that are desired for a particular connection. + + + The Date header, which specifies the date and time at which the request originated. + + + The Keep-Alive header, which specifies a parameter used into order to maintain a persistent connection. + + + The Pragma header, which specifies implementation-specific directives that might apply to any agent along the request/response chain. + + + The Trailer header, which specifies the header fields present in the trailer of a message encoded with chunked transfer-coding. + + + The Transfer-Encoding header, which specifies what (if any) type of transformation that has been applied to the message body. + + + The Upgrade header, which specifies additional communications protocols that the client supports. + + + The Via header, which specifies intermediate protocols to be used by gateway and proxy agents. + + + The Warning header, which specifies additional information about that status or transformation of a message that might not be reflected in the message. + + + The Allow header, which specifies the set of HTTP methods supported. + + + The Content-Length header, which specifies the length, in bytes, of the accompanying body data. + + + The Content-Type header, which specifies the MIME type of the accompanying body data. + + + The Content-Encoding header, which specifies the encodings that have been applied to the accompanying body data. + + + The Content-Langauge header, which specifies the natural language(s) of the accompanying body data. + + + The Content-Location header, which specifies a URI from which the accompanying body may be obtained. + + + The Content-MD5 header, which specifies the MD5 digest of the accompanying body data, for the purpose of providing an end-to-end message integrity check. + + + The Content-Range header, which specifies where in the full body the accompanying partial body data should be applied. + + + The Expires header, which specifies the date and time after which the accompanying body data should be considered stale. + + + The Last-Modified header, which specifies the date and time at which the accompanying body data was last modified. + + + The Accept header, which specifies the MIME types that are acceptable for the response. + + + The Accept-Charset header, which specifies the character sets that are acceptable for the response. + + + The Accept-Encoding header, which specifies the content encodings that are acceptable for the response. + + + The Accept-Langauge header, which specifies that natural languages that are preferred for the response. + + + The Authorization header, which specifies the credentials that the client presents in order to authenticate itself to the server. + + + The Cookie header, which specifies cookie data presented to the server. + + + The Expect header, which specifies particular server behaviors that are required by the client. + + + The From header, which specifies an Internet E-mail address for the human user who controls the requesting user agent. + + + The Host header, which specifies the host name and port number of the resource being requested. + + + The If-Match header, which specifies that the requested operation should be performed only if the client's cached copy of the indicated resource is current. + + + The If-Modified-Since header, which specifies that the requested operation should be performed only if the requested resource has been modified since the indicated data and time. + + + The If-None-Match header, which specifies that the requested operation should be performed only if none of client's cached copies of the indicated resources are current. + + + The If-Range header, which specifies that only the specified range of the requested resource should be sent, if the client's cached copy is current. + + + The If-Unmodified-Since header, which specifies that the requested operation should be performed only if the requested resource has not been modified since the indicated date and time. + + + The Max-Forwards header, which specifies an integer indicating the remaining number of times that this request may be forwarded. + + + The Proxy-Authorization header, which specifies the credentials that the client presents in order to authenticate itself to a proxy. + + + The Referer header, which specifies the URI of the resource from which the request URI was obtained. + + + The Range header, which specifies the the sub-range(s) of the response that the client requests be returned in lieu of the entire response. + + + The TE header, which specifies the transfer encodings that are acceptable for the response. + + + The Translate header, a Microsoft extension to the HTTP specification used in conjunction with WebDAV functionality. + + + The User-Agent header, which specifies information about the client agent. + + + The HTTP headers that can be specified in a server response. + + + The Cache-Control header, which specifies caching directives that must be obeyed by all caching mechanisms along the request/response chain. + + + The Connection header, which specifies options that are desired for a particular connection. + + + The Date header, which specifies the date and time at which the response originated. + + + The Keep-Alive header, which specifies a parameter to be used to maintain a persistent connection. + + + The Pragma header, which specifies implementation-specific directives that might apply to any agent along the request/response chain. + + + The Trailer header, which specifies that the indicated header fields are present in the trailer of a message that is encoded with chunked transfer-coding. + + + The Transfer-Encoding header, which specifies what (if any) type of transformation has been applied to the message body. + + + The Upgrade header, which specifies additional communications protocols that the client supports. + + + The Via header, which specifies intermediate protocols to be used by gateway and proxy agents. + + + The Warning header, which specifies additional information about that status or transformation of a message that might not be reflected in the message. + + + The Allow header, which specifies the set of HTTP methods that are supported. + + + The Content-Length header, which specifies the length, in bytes, of the accompanying body data. + + + The Content-Type header, which specifies the MIME type of the accompanying body data. + + + The Content-Encoding header, which specifies the encodings that have been applied to the accompanying body data. + + + The Content-Langauge header, which specifies the natural language or languages of the accompanying body data. + + + The Content-Location header, which specifies a URI from which the accompanying body can be obtained. + + + The Content-MD5 header, which specifies the MD5 digest of the accompanying body data, for the purpose of providing an end-to-end message integrity check. + + + The Range header, which specifies the subrange or subranges of the response that the client requests be returned in lieu of the entire response. + + + The Expires header, which specifies the date and time after which the accompanying body data should be considered stale. + + + The Last-Modified header, which specifies the date and time at which the accompanying body data was last modified. + + + The Accept-Ranges header, which specifies the range that is accepted by the server. + + + The Age header, which specifies the time, in seconds, since the response was generated by the originating server. + + + The Etag header, which specifies the current value for the requested variant. + + + The Location header, which specifies a URI to which the client is redirected to obtain the requested resource. + + + The Proxy-Authenticate header, which specifies that the client must authenticate itself to a proxy. + + + The Retry-After header, which specifies a time (in seconds), or a date and time, after which the client can retry its request. + + + The Server header, which specifies information about the originating server agent. + + + The Set-Cookie header, which specifies cookie data that is presented to the client. + + + The Vary header, which specifies the request headers that are used to determine whether a cached response is fresh. + + + The WWW-Authenticate header, which specifies that the client must authenticate itself to the server. + + + Contains the values of status codes defined for HTTP. + + + Equivalent to HTTP status 100. indicates that the client can continue with its request. + + + Equivalent to HTTP status 101. indicates that the protocol version or protocol is being changed. + + + Equivalent to HTTP status 200. indicates that the request succeeded and that the requested information is in the response. This is the most common status code to receive. + + + Equivalent to HTTP status 201. indicates that the request resulted in a new resource created before the response was sent. + + + Equivalent to HTTP status 202. indicates that the request has been accepted for further processing. + + + Equivalent to HTTP status 203. indicates that the returned metainformation is from a cached copy instead of the origin server and therefore may be incorrect. + + + Equivalent to HTTP status 204. indicates that the request has been successfully processed and that the response is intentionally blank. + + + Equivalent to HTTP status 205. indicates that the client should reset (not reload) the current resource. + + + Equivalent to HTTP status 206. indicates that the response is a partial response as requested by a GET request that includes a byte range. + + + Equivalent to HTTP status 300. indicates that the requested information has multiple representations. The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. + + + Equivalent to HTTP status 300. indicates that the requested information has multiple representations. The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. + + + Equivalent to HTTP status 301. indicates that the requested information has been moved to the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. + + + Equivalent to HTTP status 301. indicates that the requested information has been moved to the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will use the GET method. + + + Equivalent to HTTP status 302. indicates that the requested information is located at the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will use the GET method. + + + Equivalent to HTTP status 302. indicates that the requested information is located at the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will use the GET method. + + + Equivalent to HTTP status 303. automatically redirects the client to the URI specified in the Location header as the result of a POST. The request to the resource specified by the Location header will be made with a GET. + + + Equivalent to HTTP status 303. automatically redirects the client to the URI specified in the Location header as the result of a POST. The request to the resource specified by the Location header will be made with a GET. + + + Equivalent to HTTP status 304. indicates that the client's cached copy is up to date. The contents of the resource are not transferred. + + + Equivalent to HTTP status 305. indicates that the request should use the proxy server at the URI specified in the Location header. + + + Equivalent to HTTP status 306. is a proposed extension to the HTTP/1.1 specification that is not fully specified. + + + Equivalent to HTTP status 307. indicates that the request information is located at the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will also use the POST method. + + + Equivalent to HTTP status 307. indicates that the request information is located at the URI specified in the Location header. The default action when this status is received is to follow the Location header associated with the response. When the original request method was POST, the redirected request will also use the POST method. + + + Equivalent to HTTP status 400. indicates that the request could not be understood by the server. is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code. + + + Equivalent to HTTP status 401. indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication. + + + Equivalent to HTTP status 402. is reserved for future use. + + + Equivalent to HTTP status 403. indicates that the server refuses to fulfill the request. + + + Equivalent to HTTP status 404. indicates that the requested resource does not exist on the server. + + + Equivalent to HTTP status 405. indicates that the request method (POST or GET) is not allowed on the requested resource. + + + Equivalent to HTTP status 406. indicates that the client has indicated with Accept headers that it will not accept any of the available representations of the resource. + + + Equivalent to HTTP status 407. indicates that the requested proxy requires authentication. The Proxy-authenticate header contains the details of how to perform the authentication. + + + Equivalent to HTTP status 408. indicates that the client did not send a request within the time the server was expecting the request. + + + Equivalent to HTTP status 409. indicates that the request could not be carried out because of a conflict on the server. + + + Equivalent to HTTP status 410. indicates that the requested resource is no longer available. + + + Equivalent to HTTP status 411. indicates that the required Content-length header is missing. + + + Equivalent to HTTP status 412. indicates that a condition set for this request failed, and the request cannot be carried out. Conditions are set with conditional request headers like If-Match, If-None-Match, or If-Unmodified-Since. + + + Equivalent to HTTP status 413. indicates that the request is too large for the server to process. + + + Equivalent to HTTP status 414. indicates that the URI is too long. + + + Equivalent to HTTP status 415. indicates that the request is an unsupported type. + + + Equivalent to HTTP status 416. indicates that the range of data requested from the resource cannot be returned, either because the beginning of the range is before the beginning of the resource, or the end of the range is after the end of the resource. + + + Equivalent to HTTP status 417. indicates that an expectation given in an Expect header could not be met by the server. + + + Equivalent to HTTP status 500. indicates that a generic error has occurred on the server. + + + Equivalent to HTTP status 501. indicates that the server does not support the requested function. + + + Equivalent to HTTP status 502. indicates that an intermediate proxy server received a bad response from another proxy or the origin server. + + + Equivalent to HTTP status 503. indicates that the server is temporarily unavailable, usually due to high load or maintenance. + + + Equivalent to HTTP status 504. indicates that an intermediate proxy server timed out while waiting for a response from another proxy or the origin server. + + + Equivalent to HTTP status 505. indicates that the requested HTTP version is not supported by the server. + + + Defines the HTTP version numbers that are supported by the and classes. + + + Initializes a new instance of the class. + + + Defines a instance for HTTP 1.0. + + + Defines a instance for HTTP 1.1. + + + Provides an HTTP-specific implementation of the class. + + + Initializes a new instance of the class from the specified instances of the and classes. + A object that contains the information required to serialize the new object. + A object that contains the source and destination of the serialized stream associated with the new object. + + + Cancels a request to an Internet resource. + + + + + + + + Gets or sets the value of the Accept HTTP header. + The value of the Accept HTTP header. The default value is null. + + + Adds a byte range header to a request for a specific range from the beginning or end of the requested data. + The starting or ending point of the range. + + is invalid. + The range header could not be added. + + + Adds a byte range header to the request for a specified range. + The position at which to start sending data. + The position at which to stop sending data. + + is invalid. + + is greater than -or- or is less than 0. + The range header could not be added. + + + Adds a byte range header to a request for a specific range from the beginning or end of the requested data. + The starting or ending point of the range. + + is invalid. + The range header could not be added. + + + Adds a byte range header to the request for a specified range. + The position at which to start sending data. + The position at which to stop sending data. + + is invalid. + + is greater than -or- or is less than 0. + The range header could not be added. + + + Adds a Range header to a request for a specific range from the beginning or end of the requested data. + The description of the range. + The starting or ending point of the range. + + is null. + + is invalid. + The range header could not be added. + + + Adds a range header to a request for a specified range. + The description of the range. + The position at which to start sending data. + The position at which to stop sending data. + + is null. + + is greater than -or- or is less than 0. + + is invalid. + The range header could not be added. + + + Adds a Range header to a request for a specific range from the beginning or end of the requested data. + The description of the range. + The starting or ending point of the range. + + is null. + + is invalid. + The range header could not be added. + + + Adds a range header to a request for a specified range. + The description of the range. + The position at which to start sending data. + The position at which to stop sending data. + + is null. + + is greater than -or- or is less than 0. + + is invalid. + The range header could not be added. + + + Gets the Uniform Resource Identifier (URI) of the Internet resource that actually responds to the request. + A that identifies the Internet resource that actually responds to the request. The default is the URI used by the method to initialize the request. + + + Gets or sets a value that indicates whether the request should follow redirection responses. + true if the request should automatically follow redirection responses from the Internet resource; otherwise, false. The default value is true. + + + Gets or sets a value that indicates whether to buffer the data sent to the Internet resource. + true to enable buffering of the data sent to the Internet resource; false to disable buffering. The default is true. + + + Gets or sets the type of decompression that is used. + A T:System.Net.DecompressionMethods object that indicates the type of decompression that is used. + The object's current state does not allow this property to be set. + + + Begins an asynchronous request for a object to use to write data. + An that references the asynchronous request. + The delegate. + The state object for this request. + The property is GET or HEAD.-or- is true, is false, is -1, is false, and is POST or PUT. + The stream is being used by a previous call to -or- is set to a value and is false.-or- The thread pool is running out of threads. + The request cache validator indicated that the response for this request can be served from the cache; however, requests that write data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented. + + was previously called. + In a .NET Compact Framework application, a request stream with zero content length was not obtained and closed correctly. For more information about handling zero content length requests, see Network Programming in the .NET Compact Framework. + + + + + + + + + + + Begins an asynchronous request to an Internet resource. + An that references the asynchronous request for a response. + The delegate + The state object for this request. + The stream is already in use by a previous call to -or- is set to a value and is false.-or- The thread pool is running out of threads. + + is GET or HEAD, and either is greater than zero or is true.-or- is true, is false, and either is -1, is false and is POST or PUT.-or- The has an entity body but the method is called without calling the method. -or- The is greater than zero, but the application does not write all of the promised data. + + was previously called. + + + + + + + + + + + Gets or sets the collection of security certificates that are associated with this request. + The that contains the security certificates associated with this request. + The value specified for a set operation is null. + + + Gets or sets the value of the Connection HTTP header. + The value of the Connection HTTP header. The default value is null. + The value of is set to Keep-alive or Close. + + + Gets or sets the name of the connection group for the request. + The name of the connection group for this request. The default value is null. + + + Gets or sets the Content-length HTTP header. + The number of bytes of data to send to the Internet resource. The default is -1, which indicates the property has not been set and that there is no request data to send. + The request has been started by calling the , , , or method. + The new value is less than 0. + + + Gets or sets the value of the Content-type HTTP header. + The value of the Content-type HTTP header. The default value is null. + + + Gets or sets the delegate method called when an HTTP 100-continue response is received from the Internet resource. + A delegate that implements the callback method that executes when an HTTP Continue response is returned from the Internet resource. The default value is null. + + + Gets or sets the cookies associated with the request. + A that contains the cookies associated with this request. + + + Gets or sets authentication information for the request. + An that contains the authentication credentials associated with the request. The default is null. + + + + + + Get or set the Date HTTP header value to use in an HTTP request. + The Date header value in the HTTP request. + + + Gets or sets the default cache policy for this request. + A that specifies the cache policy in effect for this request when no other policy is applicable. + + + + + + + + Gets or sets the default maximum length of an HTTP error response. + An integer that represents the default maximum length of an HTTP error response. + The value is less than 0 and is not equal to -1. + + + Gets or sets the default for the property. + The length, in kilobytes (1024 bytes), of the default maximum for response headers received. The default configuration file sets this value to 64 kilobytes. + The value is not equal to -1 and is less than zero. + + + + + + Ends an asynchronous request for a object to use to write data. + A to use to write request data. + The pending request for a stream. + + is null. + The request did not complete, and no stream is available. + + was not returned by the current instance from a call to . + This method was called previously using . + + was previously called.-or- An error occurred while processing the request. + + + + + + + + Ends an asynchronous request for a object to use to write data and outputs the associated with the stream. + A to use to write request data. + The pending request for a stream. + The for the . + + was not returned by the current instance from a call to . + + is null. + This method was called previously using . + The request did not complete, and no stream is available. + + was previously called.-or- An error occurred while processing the request. + + + Ends an asynchronous request to an Internet resource. + A that contains the response from the Internet resource. + The pending request for a response. + + is null. + This method was called previously using -or- The property is greater than 0 but the data has not been written to the request stream. + + was previously called.-or- An error occurred while processing the request. + + was not returned by the current instance from a call to . + + + + + + + + Gets or sets the value of the Expect HTTP header. + The contents of the Expect HTTP header. The default value is null.NoteThe value for this property is stored in . If WebHeaderCollection is set, the property value is lost. + Expect is set to a string that contains "100-continue" as a substring. + + + Populates a with the data required to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + Gets a object to use to write request data. + A to use to write request data. + The property is GET or HEAD.-or- is true, is false, is -1, is false, and is POST or PUT. + The method is called more than once.-or- is set to a value and is false. + The request cache validator indicated that the response for this request can be served from the cache; however, requests that write data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented. + + was previously called.-or- The time-out period for the request expired.-or- An error occurred while processing the request. + In a .NET Compact Framework application, a request stream with zero content length was not obtained and closed correctly. For more information about handling zero content length requests, see Network Programming in the .NET Compact Framework. + + + + + + + + + + + Gets a object to use to write request data and outputs the associated with the stream. + A to use to write request data. + The for the . + The method was unable to obtain the . + The method is called more than once.-or- is set to a value and is false. + The request cache validator indicated that the response for this request can be served from the cache; however, requests that write data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented. + The property is GET or HEAD.-or- is true, is false, is -1, is false, and is POST or PUT. + + was previously called.-or- The time-out period for the request expired.-or- An error occurred while processing the request. + + + Returns a response from an Internet resource. + A that contains the response from the Internet resource. + The stream is already in use by a previous call to .-or- is set to a value and is false. + + is GET or HEAD, and either is greater or equal to zero or is true.-or- is true, is false, is -1, is false, and is POST or PUT. -or- The has an entity body but the method is called without calling the method. -or- The is greater than zero, but the application does not write all of the promised data. + The request cache validator indicated that the response for this request can be served from the cache; however, this request includes data to be sent to the server. Requests that send data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented. + + was previously called.-or- The time-out period for the request expired.-or- An error occurred while processing the request. + + + + + + + + + + + Gets a value that indicates whether a response has been received from an Internet resource. + true if a response has been received; otherwise, false. + + + Specifies a collection of the name/value pairs that make up the HTTP headers. + A that contains the name/value pairs that make up the headers for the HTTP request. + The request has been started by calling the , , , or method. + + + + + + Get or set the Host header value to use in an HTTP request independent from the request URI. + The Host header value in the HTTP request. + The Host header cannot be set to null. + The Host header cannot be set to an invalid value. + The Host header cannot be set after the has already started to be sent. + + + Gets or sets the value of the If-Modified-Since HTTP header. + A that contains the contents of the If-Modified-Since HTTP header. The default value is the current date and time. + + + + + + Gets or sets a value that indicates whether to make a persistent connection to the Internet resource. + true if the request to the Internet resource should contain a Connection HTTP header with the value Keep-alive; otherwise, false. The default is true. + + + Gets or sets the maximum number of redirects that the request follows. + The maximum number of redirection responses that the request follows. The default value is 50. + The value is set to 0 or less. + + + Gets or sets the maximum allowed length of the response headers. + The length, in kilobytes (1024 bytes), of the response headers. + The property is set after the request has already been submitted. + The value is less than 0 and is not equal to -1. + + + Gets or sets the media type of the request. + The media type of the request. The default value is null. + + + Gets or sets the method for the request. + The request method to use to contact the Internet resource. The default value is GET. + No method is supplied.-or- The method string contains invalid characters. + + + Gets or sets a value that indicates whether to pipeline the request to the Internet resource. + true if the request should be pipelined; otherwise, false. The default is true. + + + Gets or sets a value that indicates whether to send an Authorization header with the request. + true to send an HTTP Authorization header with requests after authentication has taken place; otherwise, false. The default is false. + + + Gets or sets the version of HTTP to use for the request. + The HTTP version to use for the request. The default is . + The HTTP version is set to a value other than 1.0 or 1.1. + + + Gets or sets proxy information for the request. + The object to use to proxy the request. The default value is set by calling the property. + + is set to null. + The request has been started by calling , , , or . + The caller does not have permission for the requested operation. + + + + + + + + + Gets or sets a time-out in milliseconds when writing to or reading from a stream. + The number of milliseconds before the writing or reading times out. The default value is 300,000 milliseconds (5 minutes). + The request has already been sent. + The value specified for a set operation is less than or equal to zero and is not equal to + + + Gets or sets the value of the Referer HTTP header. + The value of the Referer HTTP header. The default value is null. + + + Gets the original Uniform Resource Identifier (URI) of the request. + A that contains the URI of the Internet resource passed to the method. + + + Gets or sets a value that indicates whether to send data in segments to the Internet resource. + true to send data to the Internet resource in segments; otherwise, false. The default value is false. + The request has been started by calling the , , , or method. + + + Gets the service point to use for the request. + A that represents the network connection to the Internet resource. + + + + + + + + Populates a with the data needed to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + Gets or sets the time-out value in milliseconds for the and methods. + The number of milliseconds to wait before the request times out. The default value is 100,000 milliseconds (100 seconds). + The value specified is less than zero and is not . + + + Gets or sets the value of the Transfer-encoding HTTP header. + The value of the Transfer-encoding HTTP header. The default value is null. + + is set when is false. + + is set to the value "Chunked". + + + Gets or sets a value that indicates whether to allow high-speed NTLM-authenticated connection sharing. + true to keep the authenticated connection open; otherwise, false. + + + + + + Gets or sets a value that controls whether default credentials are sent with requests. + true if the default credentials are used; otherwise false. The default value is false. + You attempted to set this property after the request was sent. + + + + + + Gets or sets the value of the User-agent HTTP header. + The value of the User-agent HTTP header. The default value is null.NoteThe value for this property is stored in . If WebHeaderCollection is set, the property value is lost. + + + Provides an HTTP-specific implementation of the class. + + + Initializes a new instance of the class from the specified and instances. + A that contains the information required to serialize the new . + A that contains the source of the serialized stream that is associated with the new . + + + Gets the character set of the response. + A string that contains the character set of the response. + The current instance has been disposed. + + + + + + Closes the response stream. + + + + + + + + Gets the method that is used to encode the body of the response. + A string that describes the method that is used to encode the body of the response. + The current instance has been disposed. + + + Gets the length of the content returned by the request. + The number of bytes returned by the request. Content length does not include header information. + The current instance has been disposed. + + + Gets the content type of the response. + A string that contains the content type of the response. + The current instance has been disposed. + + + Gets or sets the cookies that are associated with this response. + A that contains the cookies that are associated with this response. + The current instance has been disposed. + + + Populates a with the data needed to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + Gets the contents of a header that was returned with the response. + The contents of the specified header. + The header value to return. + The current instance has been disposed. + + + Gets the stream that is used to read the body of the response from the server. + A containing the body of the response. + There is no response stream. + The current instance has been disposed. + + + + + + + + Gets the headers that are associated with this response from the server. + A that contains the header information returned with the response. + The current instance has been disposed. + + + Gets a value that indicates whether both client and server were authenticated. + true if mutual authentication occurred; otherwise, false. + + + Gets the last date and time that the contents of the response were modified. + A that contains the date and time that the contents of the response were modified. + The current instance has been disposed. + + + + + + Gets the method that is used to return the response. + A string that contains the HTTP method that is used to return the response. + The current instance has been disposed. + + + Gets the version of the HTTP protocol that is used in the response. + A that contains the HTTP protocol version of the response. + The current instance has been disposed. + + + Gets the URI of the Internet resource that responded to the request. + A that contains the URI of the Internet resource that responded to the request. + The current instance has been disposed. + + + Gets the name of the server that sent the response. + A string that contains the name of the server that sent the response. + The current instance has been disposed. + + + Gets the status of the response. + One of the values. + The current instance has been disposed. + + + Gets the status description returned with the response. + A string that describes the status of the response. + The current instance has been disposed. + + + Serializes this instance into the specified object. + The object into which this will be serialized. + The destination of the serialization. + + + Provides the base authentication interface for Web client authentication modules. + + + Returns an instance of the class in respose to an authentication challenge from a server. + An instance containing the authorization message for the request, or null if the challenge cannot be handled. + The authentication challenge sent by the server. + The instance associated with the challenge. + The credentials associated with the challenge. + + + Gets the authentication type provided by this authentication module. + A string indicating the authentication type provided by this authentication module. + + + Gets a value indicating whether the authentication module supports preauthentication. + true if the authorization module supports preauthentication; otherwise false. + + + Returns an instance of the class for an authentication request to a server. + An instance containing the authorization message for the request. + The instance associated with the authentication request. + The credentials associated with the authentication request. + + + Validates a server certificate. + + + Validates a server certificate. + true if the certificate should be honored; otherwise, false. + The that will use the certificate. + The certificate to validate. + The request that received the certificate. + The problem that was encountered when using the certificate. + + + Defines the credential policy to be used for resource requests that are made using and its derived classes. + + + Returns a that indicates whether the client's credentials are sent with a resource request made using an instance of the class. + true if the credentials are sent with the request; otherwise, false. + The that will receive the request. For more information, see the Remarks section. + The that represents the resource being requested. + The that will be sent with the request if this method returns true. + The that will conduct the authentication, if authentication is required. + + + Provides the base authentication interface for retrieving credentials for Web client authentication. + + + Returns a object that is associated with the specified URI, and authentication type. + The that is associated with the specified URI and authentication type, or, if no credentials are available, null. + The that the client is providing authentication for. + The type of authentication, as defined in the property. + + + Provides the interface for retrieving credentials for a host, port, and authentication type. + + + Returns the credential for the specified host, port, and authentication protocol. + A for the specified host, port, and authentication protocol, or null if there are no credentials available for the specified host, port, and authentication protocol. + The host computer that is authenticating the client. + The port on that the client will communicate with. + The authentication protocol. + + + Provides an Internet Protocol (IP) address. + + + Initializes a new instance of the class with the address specified as a array. + The byte array value of the IP address. + + is null. + + contains a bad IP address. + + + Initializes a new instance of the class with the address specified as a array and the specified scope identifier. + The byte array value of the IP address. + The long value of the scope identifier. + + is null. + + contains a bad IP address. + + < 0 or > 0x00000000FFFFFFFF + + + Initializes a new instance of the class with the address specified as an . + The long value of the IP address. For example, the value 0x2414188f in big-endian format would be the IP address "143.24.20.36". + + < 0 or > 0x00000000FFFFFFFF + + + An Internet Protocol (IP) address. + The long value of the IP address. + The address family is . + + + Gets the address family of the IP address. + Returns for IPv4 or for IPv6. + + + Provides an IP address that indicates that the server must listen for client activity on all network interfaces. This field is read-only. + + + Provides the IP broadcast address. This field is read-only. + + + Compares two IP addresses. + true if the two addresses are equal; otherwise, false. + An instance to compare to the current instance. + + + Provides a copy of the as an array of bytes. + A array. + + + Returns a hash value for an IP address. + An integer hash value. + + + + + + Converts a short value from host byte order to network byte order. + A short value, expressed in network byte order. + The number to convert, expressed in host byte order. + + + Converts an integer value from host byte order to network byte order. + An integer value, expressed in network byte order. + The number to convert, expressed in host byte order. + + + Converts a long value from host byte order to network byte order. + A long value, expressed in network byte order. + The number to convert, expressed in host byte order. + + + The method uses the field to indicate that a must listen for client activity on all network interfaces. + + + Provides the IP loopback address. This property is read-only. + + + Provides an IP address that indicates that no network interface should be used. This property is read-only. + + + Gets whether the address is an IPv6 link local address. + true if the IP address is an IPv6 link local address; otherwise, false. + + + Gets whether the address is an IPv6 multicast global address. + true if the IP address is an IPv6 multicast global address; otherwise, false. + + + Gets whether the address is an IPv6 site local address. + true if the IP address is an IPv6 site local address; otherwise, false. + + + Gets whether the address is an IPv6 Teredo address. + true if the IP address is an IPv6 Teredo address; otherwise, false. + + + Indicates whether the specified IP address is the loopback address. + true if is the loopback address; otherwise, false. + An IP address. + + + Provides the IP loopback address. This field is read-only. + + + Converts a short value from network byte order to host byte order. + A short value, expressed in host byte order. + The number to convert, expressed in network byte order. + + + Converts an integer value from network byte order to host byte order. + An integer value, expressed in host byte order. + The number to convert, expressed in network byte order. + + + Converts a long value from network byte order to host byte order. + A long value, expressed in host byte order. + The number to convert, expressed in network byte order. + + + Provides an IP address that indicates that no network interface should be used. This field is read-only. + + + Converts an IP address string to an instance. + An instance. + A string that contains an IP address in dotted-quad notation for IPv4 and in colon-hexadecimal notation for IPv6. + + can't contain Unicode characters. + + is null. + + is not a valid IP address. + + + Gets or sets the IPv6 address scope identifier. + A long integer that specifies the scope of the address. + AddressFamily = InterNetwork. + + < 0- or - > 0x00000000FFFFFFFF + + + Converts an Internet address to its standard notation. + A string that contains the IP address in either IPv4 dotted-quad or in IPv6 colon-hexadecimal notation. + The address family is and the address is bad. + + + + + + Determines whether a string is a valid IP address. + true if is a valid IP address; otherwise, false. + The string to validate. + The version of the string. + + can't contain Unicode characters. + + is null. + + + Represents a network endpoint as an IP address and a port number. + + + Initializes a new instance of the class with the specified address and port number. + The IP address of the Internet host. + The port number associated with the , or 0 to specify any available port. is in host order. + + is less than .-or- is greater than .-or- is less than 0 or greater than 0x00000000FFFFFFFF. + + + Initializes a new instance of the class with the specified address and port number. + An . + The port number associated with the , or 0 to specify any available port. is in host order. + + is null. + + is less than .-or- is greater than .-or- is less than 0 or greater than 0x00000000FFFFFFFF. + + + Gets or sets the IP address of the endpoint. + An instance containing the IP address of the endpoint. + + + Gets the Internet Protocol (IP) address family. + Returns . + + + Creates an endpoint from a socket address. + An instance using the specified socket address. + The to use for the endpoint. + The AddressFamily of is not equal to the AddressFamily of the current instance.-or- .Size < 8. + + + + + + Determines whether the specified is equal to the current instance. + true if the specified is equal to the current ; otherwise, false. + The specified to compare with the current instance. + + + Returns a hash value for a instance. + An integer hash value. + + + + + + Specifies the maximum value that can be assigned to the property. The MaxPort value is set to 0x0000FFFF. This field is read-only. + + + Specifies the minimum value that can be assigned to the property. This field is read-only. + + + Gets or sets the port number of the endpoint. + An integer value in the range to indicating the port number of the endpoint. + The value that was specified for a set operation is less than or greater than . + + + Serializes endpoint information into a instance. + A instance containing the socket address for the endpoint. + + + Returns the IP address and port number of the specified endpoint. + A string containing the IP address and the port number of the specified endpoint (for example, 192.168.1.2:80). + + + + + + Provides a container class for Internet host address information. + + + Initializes a new instance of the class. + + + Gets or sets a list of IP addresses that are associated with a host. + An array of type that contains IP addresses that resolve to the host names that are contained in the property. + + + Gets or sets a list of aliases that are associated with a host. + An array of strings that contain DNS names that resolve to the IP addresses in the property. + + + Gets or sets the DNS name of the host. + A string that contains the primary host name for the server. + + + Provides the base interface for implementation of proxy access for the class. + + + The credentials to submit to the proxy server for authentication. + An instance that contains the credentials that are needed to authenticate a request to the proxy server. + + + Returns the URI of a proxy. + A instance that contains the URI of the proxy used to contact . + A that specifies the requested Internet resource. + + + Indicates that the proxy should not be used for the specified host. + true if the proxy server should not be used for ; otherwise, false. + The of the host to check for proxy use. + + + Provides the base interface to load and execute scripts for automatic proxy detection. + + + Closes a script. + + + Loads a script. + A indicating whether the script was successfully loaded. + Internal only. + Internal only. + Internal only. + + + Runs a script. + A . + Internal only. + Internal only. + + + Provides the base interface for creating instances. + + + Creates a instance. + A instance. + The uniform resource identifier (URI) of the Web resource. + The request scheme specified in is not supported by this instance. + + is null. + The URI specified in is not a valid URI. + + + Specifies network access permissions. + + + Indicates that the application is allowed to accept connections from the Internet on a local resource. Notice that this is a protection for the local host that uses Accept to grant access to a local resource (address/port). At the time a socket tries to bind to this local resource a permission check is performed to see if an Accept exists on that resource. + + + Indicates that the application is allowed to connect to specific Internet resources. Notice that, in the case of remote host resource, no check is performed to see that Connect permissions exist. This is because the port of a connecting remote host is unknown and not suitable permissions can be built in advance. It is the application responsibility to check the permissions of the remote host trying to connect to a listening socket. + + + Provides credentials for password-based authentication schemes such as basic, digest, NTLM, and Kerberos authentication. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified user name and password. + The user name associated with the credentials. + The password for the user name associated with the credentials. + The class is not supported on this platform. + + + Initializes a new instance of the class with the specified user name, password, and domain. + The user name associated with the credentials. + The password for the user name associated with the credentials. + The domain associated with these credentials. + The class is not supported on this platform. + + + Initializes a new instance of the class with the specified user name and password. + The user name associated with the credentials. + The password for the user name associated with the credentials. + + + Initializes a new instance of the class with the specified user name, password, and domain. + The user name associated with the credentials. + The password for the user name associated with the credentials. + The domain associated with these credentials. + + + Gets or sets the domain or computer name that verifies the credentials. + The name of the domain associated with the credentials. + + + + + + Returns an instance of the class for the specified host, port, and authentication type. + A for the specified host, port, and authentication protocol, or null if there are no credentials available for the specified host, port, and authentication protocol. + The host computer that authenticates the client. + The port on the that the client communicates with. + The type of authentication requested, as defined in the property. + + + Returns an instance of the class for the specified Uniform Resource Identifier (URI) and authentication type. + A object. + The URI that the client provides authentication for. + The type of authentication requested, as defined in the property. + + + Gets or sets the password for the user name associated with the credentials. + The password associated with the credentials. If this instance was initialized with the parameter set to null, then the property will return an empty string. + + + + + + Gets or sets the password as a instance. + The password for the user name associated with the credentials. + The class is not supported on this platform. + + + Gets or sets the user name associated with the credentials. + The user name associated with the credentials. + + + + + + Provides data for the event. + + + Gets a readable stream that contains data downloaded by a method. + A that contains the downloaded data. + + + + + + Represents the method that will handle the event of a . + The source of the event. + A containing event data. + + + Provides data for the event. + + + Gets a writable stream that is used to send data to a server. + A where you can write data to be uploaded. + + + + + + Represents the method that will handle the event of a . + The source of the event. + A containing event data. + + + The exception that is thrown when an error is made while using a network protocol. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class from the specified and instances. + A that contains the information that is required to deserialize the . + A that contains the source of the serialized stream that is associated with the new . + + + Initializes a new instance of the class with the specified message. + The error message string. + + + Populates a with the data required to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + Serializes this instance into the specified object. + The object into which this will be serialized. + The destination of the serialization. + + + Specifies the security protocols that are supported by the Schannel security package. + + + Specifies the Secure Socket Layer (SSL) 3.0 security protocol. + + + Specifies the Transport Layer Security (TLS) 1.0 security protocol. + + + Provides connection management for HTTP connections. + + + Gets the Uniform Resource Identifier (URI) of the server that this object connects to. + An instance of the class that contains the URI of the Internet server that this object connects to. + The is in host mode. + + + Specifies the delegate to associate a local with a . + A delegate that forces a to use a particular local Internet Protocol (IP) address and port number. The default value is null. + + + Gets the certificate received for this object. + An instance of the class that contains the security certificate received for this object. + + + Gets the last client certificate sent to the server. + An object that contains the public values of the last client certificate sent to the server. + + + Removes the specified connection group from this object. + A value that indicates whether the connection group was closed. + The name of the connection group that contains the connections to close and remove from this service point. + + + Gets or sets the number of milliseconds after which an active connection is closed. + A that specifies the number of milliseconds that an active connection remains open. The default is -1, which allows an active connection to stay connected indefinitely. Set this property to 0 to force connections to close after servicing a request. + The value specified for a set operation is a negative number less than -1. + + + Gets or sets the maximum number of connections allowed on this object. + The maximum number of connections allowed on this object. + The connection limit is equal to or less than 0. + + + + + + + + + Gets the connection name. + A that represents the connection name. + + + Gets the number of open connections associated with this object. + The number of open connections associated with this object. + + + Gets or sets a value that determines whether 100-Continue behavior is used. + true to expect 100-Continue responses for POST requests; otherwise, false. The default value is true. + + + Gets the date and time that the object was last connected to a host. + A object that contains the date and time at which the object was last connected. + + + Gets or sets the amount of time a connection associated with the object can remain idle before the connection is closed. + The length of time, in milliseconds, that a connection associated with the object can remain idle before it is closed and reused for another connection. + + is set to less than or greater than . + + + Gets the version of the HTTP protocol that the object uses. + A object that contains the HTTP protocol version that the object uses. + + + Gets or sets the size of the receiving buffer for the socket used by this . + A that contains the size, in bytes, of the receive buffer. The default is 8192. + The value specified for a set operation is greater than . + + + Enables or disables the keep-alive option on a TCP connection. + If set to true, then the TCP keep-alive option on a TCP connection will be enabled using the specified and values. If set to false, then the TCP keep-alive option is disabled and the remaining parameters are ignored.The default value is false. + Specifies the timeout, in milliseconds, with no activity until the first keep-alive packet is sent. The value must be greater than 0. If a value of less than or equal to zero is passed an is thrown. + Specifies the interval, in milliseconds, between when successive keep-alive packets are sent if no acknowledgement is received.The value must be greater than 0. If a value of less than or equal to zero is passed an is thrown. + The value specified for or parameter is less than or equal to 0. + + + Indicates whether the object supports pipelined connections. + true if the object supports pipelined connections; otherwise, false. + + + Gets or sets a value that determines whether the Nagle algorithm is used on connections managed by this object. + true to use the Nagle algorithm; otherwise, false. The default value is true. + + + Manages the collection of objects. + + + Gets or sets policy for server certificates. + An object that implements the interface. + + + + + + Gets or sets a value that indicates whether the certificate is checked against the certificate authority revocation list. + true if the certificate revocation list is checked; otherwise, false. + + + + + + + Gets or sets the maximum number of concurrent connections allowed by a object. + The maximum number of concurrent connections allowed by a object. The default value is 2. + + is less than or equal to 0. + + + + + + + + The default number of non-persistent connections (4) allowed on a object connected to an HTTP/1.0 or later server. This field is constant but is no longer used in the .NET Framework 2.0. + + + The default number of persistent connections (2) allowed on a object connected to an HTTP/1.1 or later server. This field is constant and is used to initialize the property if the value of the property has not been set either directly or through configuration. + + + Gets or sets a value that indicates how long a Domain Name Service (DNS) resolution is considered valid. + The time-out value, in milliseconds. A value of -1 indicates an infinite time-out period. The default value is 120,000 milliseconds (two minutes). + + + Gets or sets a value that indicates whether a Domain Name Service (DNS) resolution rotates among the applicable Internet Protocol (IP) addresses. + false if a DNS resolution always returns the first IP address for a particular host; otherwise true. The default is false. + + + Gets the for this instance. + The encryption policy to use for this instance. + + + Gets or sets a value that determines whether 100-Continue behavior is used. + true to enable 100-Continue behavior. The default value is true. + + + + + + + Finds an existing object or creates a new object to manage communications with the specified Uniform Resource Identifier (URI). + The object that manages communications for the request. + The URI of the Internet resource to be contacted. + The proxy data for this request. + The URI specified in is invalid. + The maximum number of objects defined in has been reached. + + + + + + + Finds an existing object or creates a new object to manage communications with the specified object. + The object that manages communications for the request. + The object of the Internet resource to contact. + + is null. + The maximum number of objects defined in has been reached. + + + + + + + Finds an existing object or creates a new object to manage communications with the specified object. + The object that manages communications for the request. + A object that contains the address of the Internet resource to contact. + The proxy data for this request. + + is null. + The maximum number of objects defined in has been reached. + + + + + + + Gets or sets the maximum idle time of a object. + The maximum idle time, in milliseconds, of a object. The default value is 100,000 milliseconds (100 seconds). + + is less than or greater than . + + + + + + Gets or sets the maximum number of objects to maintain at any time. + The maximum number of objects to maintain. The default value is 0, which means there is no limit to the number of objects. + + is less than 0 or greater than . + + + + + + Gets or sets the security protocol used by the objects managed by the object. + One of the values defined in the enumeration. + The value specified to set the property is not a valid enumeration value. + + + Gets or sets the callback to validate a server certificate. + A . The default value is null. + + + Enables or disables the keep-alive option on a TCP connection. + If set to true, then the TCP keep-alive option on a TCP connection will be enabled using the specified and values. If set to false, then the TCP keep-alive option is disabled and the remaining parameters are ignored.The default value is false. + Specifies the timeout, in milliseconds, with no activity until the first keep-alive packet is sent.The value must be greater than 0. If a value of less than or equal to zero is passed an is thrown. + Specifies the interval, in milliseconds, between when successive keep-alive packets are sent if no acknowledgement is received.The value must be greater than 0. If a value of less than or equal to zero is passed an is thrown. + The value specified for or parameter is less than or equal to 0. + + + Determines whether the Nagle algorithm is used by the service points managed by this object. + true to use the Nagle algorithm; otherwise, false. The default value is true. + + + + + + + Stores serialized information from derived classes. + + + Creates a new instance of the class for the given address family. + An enumerated value. + + + Creates a new instance of the class using the specified address family and buffer size. + An enumerated value. + The number of bytes to allocate for the underlying buffer. + + is less than 2. These 2 bytes are needed to store . + + + Determines whether the specified is equal to the current instance. + true if the specified is equal to the current ; otherwise, false. + The specified to compare with the current instance. + + + Gets the enumerated value of the current . + One of the enumerated values. + + + Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. + A hash code for the current . + + + Gets or sets the specified index element in the underlying buffer. + The value of the specified index element in the underlying buffer. + The array index element of the desired information. + The specified index does not exist in the buffer. + + + Gets the underlying buffer size of the . + The underlying buffer size of the . + + + Returns information about the socket address. + A string that contains information about the . + + + + + + Controls rights to make or accept connections on a transport address. + + + Initializes a new instance of the class for the given transport address with the specified permission. + One of the values. + One of the values. + The host name for the transport address. + The port number for the transport address. + + is null. + + + Initializes a new instance of the class that allows unrestricted access to the or disallows access to the . + One of the values. + + + Gets a list of instances that identifies the endpoints that can be accepted under this permission instance. + An instance that implements the interface that contains instances. + + + Adds a permission to the set of permissions for a transport address. + One of the values. + One of the values. + The host name for the transport address. + The port number for the transport address. + + is null. + + + Defines a constant that represents all ports. + + + Gets a list of instances that identifies the endpoints that can be connected to under this permission instance. + An instance that implements the interface that contains instances. + + + Creates a copy of a instance. + A new instance of the class that is a copy of the current instance. + + + Reconstructs a instance for an XML encoding. + The XML encoding used to reconstruct the instance. + The is null. + The is not a permission element for this type. + + + Returns the logical intersection between two instances. + The instance that represents the intersection of two instances. If the intersection is empty, the method returns null. If the parameter is a null reference, the method returns null. + The instance to intersect with the current instance. + The parameter is not a . + + is not granted to the method caller. + + + + + + + + + Determines if the current permission is a subset of the specified permission. + If is null, this method returns true if the current instance defines no permissions; otherwise, false. If is not null, this method returns true if the current instance defines a subset of permissions; otherwise, false. + A that is to be tested for the subset relationship. + + is not a . + + is not granted to the method caller. + + + + + + + + + Checks the overall permission state of the object. + true if the instance is created with the Unrestricted value from ; otherwise, false. + + + Creates an XML encoding of a instance and its current state. + A instance that contains an XML-encoded representation of the instance, including state information. + + + + + + Returns the logical union between two instances. + The instance that represents the union of two instances. If parameter is null, it returns a copy of the current instance. + The instance to combine with the current instance. + + is not a . + + + Specifies security actions to control connections. This class cannot be inherited. + + + Initializes a new instance of the class with the specified value. + One of the values. + + is not a valid value. + + + Gets or sets the network access method that is allowed by this . + A string that contains the network access method that is allowed by this instance of . Valid values are "Accept" and "Connect." + The property is not null when you attempt to set the value. To specify more than one Access method, use an additional attribute declaration statement. + + + Creates and returns a new instance of the class. + An instance of the class that corresponds to the security declaration. + One or more of the current instance's , , , or properties is null. + + + + + + Gets or sets the DNS host name or IP address that is specified by this . + A string that contains the DNS host name or IP address that is associated with this instance of . + + is not null when you attempt to set the value. To specify more than one host, use an additional attribute declaration statement. + + + Gets or sets the port number that is associated with this . + A string that contains the port number that is associated with this instance of . + The property is null when you attempt to set the value. To specify more than one port, use an additional attribute declaration statement. + + + Gets or sets the that is specified by this . + A string that contains the that is associated with this . + + is not null when you attempt to set the value. To specify more than one transport type, use an additional attribute declaration statement. + + + The class provides additional context about the underlying transport layer. + + + Creates a new instance of the class + + + Retrieves the requested channel binding. + The requested , or null if the channel binding is not supported by the current transport or by the operating system. + The type of channel binding to retrieve. + + is must be for use with the retrieved from the property. + + + Defines transport types for the and classes. + + + UDP transport. + + + The transport type is connectionless, such as UDP. Specifying this value has the same effect as specifying . + + + TCP transport. + + + The transport is connection oriented, such as TCP. Specifying this value has the same effect as specifying . + + + All transport types. + + + Provides data for the event. + + + Gets the server reply to a data upload operation started by calling an method. + A array containing the server reply. + + + + + + Represents the method that will handle the event of a . + The source of the event. + A containing event data. + + + Provides data for the event. + + + Gets the server reply to a data upload operation that is started by calling an method. + A array that contains the server reply. + + + + + + Represents the method that will handle the event of a . + The source of the event. + A that contains event data. + + + Provides data for the event of a . + + + Gets the number of bytes received. + An value that indicates the number of bytes received. + + + Gets the number of bytes sent. + An value that indicates the number of bytes sent. + + + Gets the total number of bytes in a data upload operation. + An value that indicates the number of bytes that will be received. + + + Gets the total number of bytes to send. + An value that indicates the number of bytes that will be sent. + + + Represents the method that will handle the event of a . + The source of the event. + A containing event data. + + + Provides data for the event. + + + Gets the server reply to a string upload operation that is started by calling an method. + A array that contains the server reply. + + + + + + Represents the method that will handle the event of a . + The source of the event. + A containing event data. + + + Provides data for the event. + + + Gets the server reply to a data upload operation started by calling an method. + A array containing the server reply. + + + + + + Represents the method that will handle the event of a . + The source of the event. + A that contains event data. + + + Provides common methods for sending data to and receiving data from a resource identified by a URI. + + + Initializes a new instance of the class. + + + Gets or sets the base URI for requests made by a . + A containing the base URI for requests made by a or if no base address has been specified. + + is set to an invalid URI. The inner exception may contain information that will help you locate the error. + + + + + + Gets or sets the application's cache policy for any resources obtained by this WebClient instance using objects. + A object that represents the application's caching requirements. + + + Cancels a pending asynchronous operation. + + + + + + Gets or sets the network credentials that are sent to the host and used to authenticate the request. + An containing the authentication credentials for the request. The default is null. + + + + + + Downloads the resource with the specified URI as a array. + A array containing the downloaded resource. + The URI from which to download data. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while downloading data. + The method has been called simultaneously on multiple threads. + + + + + + + + Downloads the resource with the specified URI as a array. + A array containing the downloaded resource. + The URI represented by the object, from which to download data. + The parameter is null. + + + Downloads the specified resource as a array. This method does not block the calling thread. + A containing the URI to download. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while downloading the resource. + + + Downloads the specified resource as a array. This method does not block the calling thread. + A containing the URI to download. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while downloading the resource. + + + Occurs when an asynchronous data download operation completes. + + + Downloads the resource with the specified URI to a local file. + The URI from which to download data. + The name of the local file that is to receive the data. + The parameter is null. + The URI formed by combining and is invalid.-or- is null or .-or-The file does not exist.-or- An error occurred while downloading data. + The method has been called simultaneously on multiple threads. + + + + + + + + Downloads the resource with the specified URI to a local file. + The URI specified as a , from which to download data. + The name of the local file that is to receive the data. + The parameter is null. -or-The parameter is null. + The URI formed by combining and is invalid.-or- is null or .-or- The file does not exist. -or- An error occurred while downloading data. + The method has been called simultaneously on multiple threads. + + + Downloads, to a local file, the resource with the specified URI. This method does not block the calling thread. + The URI of the resource to download. + The name of the file to be placed on the local computer. + The parameter is null. -or-The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while downloading the resource. + The local file specified by is in use by another thread. + + + Downloads, to a local file, the resource with the specified URI. This method does not block the calling thread. + The URI of the resource to download. + The name of the file to be placed on the local computer. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + The parameter is null. -or-The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while downloading the resource. + The local file specified by is in use by another thread. + + + Occurs when an asynchronous file download operation completes. + + + Occurs when an asynchronous download operation successfully transfers some or all of the data. + + + Downloads the requested resource as a . The resource to download is specified as a containing the URI. + A containing the requested resource. + A containing the URI to download. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while downloading the resource. + The method has been called simultaneously on multiple threads. + + + + + + + + Downloads the requested resource as a . The resource to download is specified as a . + A containing the requested resource. + A object containing the URI to download. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while downloading the resource. + The method has been called simultaneously on multiple threads. + + + Downloads the resource specified as a . This method does not block the calling thread. + A containing the URI to download. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while downloading the resource. + + + Downloads the specified string to the specified resource. This method does not block the calling thread. + A containing the URI to download. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while downloading the resource. + + + Occurs when an asynchronous resource-download operation completes. + + + Gets and sets the used to upload and download strings. + A that is used to encode strings. The default value of this property is the encoding returned by . + + + Returns a object for the specified resource. + A new object for the specified resource. + A that identifies the resource to request. + + + Returns the for the specified . + A containing the response for the specified . + A that is used to obtain the response. + + + Returns the for the specified using the specified . + A containing the response for the specified . + A that is used to obtain the response. + An object obtained from a previous call to . + + + Gets or sets a collection of header name/value pairs associated with the request. + A containing header name/value pairs associated with this request. + + + Gets whether a Web request is in progress. + true if the Web request is still in progress; otherwise false. + + + Raises the event. + A object that contains event data. + + + Raises the event. + An object containing event data. + + + Raises the event. + A object containing event data. + + + Raises the event. + A object containing event data. + + + Raises the event. + A object containing event data. + + + Raises the event. + A object containing event data. + + + Raises the event. + A object containing event data. + + + Raises the event. + An object containing event data. + + + Raises the event. + An object containing event data. + + + Raises the event. + An object containing event data. + + + Raises the event. + A object containing event data. + + + Opens a readable stream for the data downloaded from a resource with the URI specified as a . + A used to read data from a resource. + The URI specified as a from which to download data. + The parameter is null. + The URI formed by combining , is invalid.-or- An error occurred while downloading data. + + + + + + + + Opens a readable stream for the data downloaded from a resource with the URI specified as a + A used to read data from a resource. + The URI specified as a from which to download data. + The parameter is null. + The URI formed by combining , is invalid.-or- An error occurred while downloading data. + + + Opens a readable stream containing the specified resource. This method does not block the calling thread. + The URI of the resource to retrieve. + The parameter is null. + The URI formed by combining and address is invalid.-or- An error occurred while downloading the resource. -or- An error occurred while opening the stream. + + + Opens a readable stream containing the specified resource. This method does not block the calling thread. + The URI of the resource to retrieve. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + The parameter is null. + The URI formed by combining and address is invalid.-or- An error occurred while downloading the resource. -or- An error occurred while opening the stream. + + + Occurs when an asynchronous operation to open a stream containing a resource completes. + + + Opens a stream for writing data to the specified resource. + A used to write data to the resource. + The URI of the resource to receive the data. + The parameter is null. + The URI formed by combining , and is invalid.-or- An error occurred while opening the stream. + + + + + + + + Opens a stream for writing data to the specified resource, using the specified method. + A used to write data to the resource. + The URI of the resource to receive the data. + The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. + The parameter is null. + The URI formed by combining , and is invalid.-or- An error occurred while opening the stream. + + + + + + + + Opens a stream for writing data to the specified resource. + A used to write data to the resource. + The URI of the resource to receive the data. + The parameter is null. + The URI formed by combining , and is invalid.-or- An error occurred while opening the stream. + + + Opens a stream for writing data to the specified resource, by using the specified method. + A used to write data to the resource. + The URI of the resource to receive the data. + The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. + The parameter is null. + The URI formed by combining , and is invalid.-or- An error occurred while opening the stream. + + + Opens a stream for writing data to the specified resource. This method does not block the calling thread. + The URI of the resource to receive the data. + The parameter is null. + + + Opens a stream for writing data to the specified resource. This method does not block the calling thread. + The URI of the resource to receive the data. + The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. + The parameter is null. + + + Opens a stream for writing data to the specified resource, using the specified method. This method does not block the calling thread. + The URI of the resource to receive the data. + The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. + A user-defined object that is passed to the method invoked when the asynchronous operation completes + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while opening the stream. + + + Occurs when an asynchronous operation to open a stream to write data to a resource completes. + + + Gets or sets the proxy used by this object. + An instance used to send requests. + + is set to null. + + + Gets or sets a collection of query name/value pairs associated with the request. + A that contains query name/value pairs associated with the request. If no pairs are associated with the request, the value is an empty . + + + + + + Gets a collection of header name/value pairs associated with the response. + A containing header name/value pairs associated with the response, or null if no response has been received. + + + + + + Uploads a data buffer to a resource identified by a URI. + A array containing the body of the response from the resource. + The URI of the resource to receive the data. + The data buffer to send to the resource. + The parameter is null. + The URI formed by combining , and is invalid.-or- is null. -or-An error occurred while sending the data.-or- There was no response from the server hosting the resource. + + + + + + + + Uploads a data buffer to the specified resource, using the specified method. + A array containing the body of the response from the resource. + The URI of the resource to receive the data. + The HTTP method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. + The data buffer to send to the resource. + The parameter is null. + The URI formed by combining , and is invalid.-or- is null.-or- An error occurred while uploading the data.-or- There was no response from the server hosting the resource. + + + + + + + + Uploads a data buffer to a resource identified by a URI. + A array containing the body of the response from the resource. + The URI of the resource to receive the data. + The data buffer to send to the resource. + The parameter is null. + The URI formed by combining , and is invalid.-or- is null. -or-An error occurred while sending the data.-or- There was no response from the server hosting the resource. + + + Uploads a data buffer to the specified resource, using the specified method. + A array containing the body of the response from the resource. + The URI of the resource to receive the data. + The HTTP method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. + The data buffer to send to the resource. + The parameter is null. + The URI formed by combining , and is invalid.-or- is null.-or- An error occurred while uploading the data.-or- There was no response from the server hosting the resource. + + + Uploads a data buffer to a resource identified by a URI, using the POST method. This method does not block the calling thread. + The URI of the resource to receive the data. + The data buffer to send to the resource. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while opening the stream.-or- There was no response from the server hosting the resource. + + + Uploads a data buffer to a resource identified by a URI, using the specified method. This method does not block the calling thread. + The URI of the resource to receive the data. + The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. + The data buffer to send to the resource. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while opening the stream.-or- There was no response from the server hosting the resource. + + + Uploads a data buffer to a resource identified by a URI, using the specified method and identifying token. + The URI of the resource to receive the data. + The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. + The data buffer to send to the resource. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + The parameter is null. + The URI formed by combining and is invalid.-or- An error occurred while opening the stream.-or- There was no response from the server hosting the resource. + + + Occurs when an asynchronous data-upload operation completes. + + + Uploads the specified local file to a resource with the specified URI. + A array containing the body of the response from the resource. + The URI of the resource to receive the file. For example, ftp://localhost/samplefile.txt. + The file to send to the resource. For example, "samplefile.txt". + The parameter is null. -or-The parameter is null. + The URI formed by combining , and is invalid.-or- is null, is , contains invalid characters, or does not exist.-or- An error occurred while uploading the file.-or- There was no response from the server hosting the resource.-or- The Content-type header begins with multipart. + + + + + + + + Uploads the specified local file to the specified resource, using the specified method. + A array containing the body of the response from the resource. + The URI of the resource to receive the file. + The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. + The file to send to the resource. + The parameter is null. -or-The parameter is null. + The URI formed by combining , and is invalid.-or- is null, is , contains invalid characters, or does not exist.-or- An error occurred while uploading the file.-or- There was no response from the server hosting the resource.-or- The Content-type header begins with multipart. + + + + + + + + Uploads the specified local file to a resource with the specified URI. + A array containing the body of the response from the resource. + The URI of the resource to receive the file. For example, ftp://localhost/samplefile.txt. + The file to send to the resource. For example, "samplefile.txt". + The parameter is null. -or-The parameter is null. + The URI formed by combining , and is invalid.-or- is null, is , contains invalid characters, or does not exist.-or- An error occurred while uploading the file.-or- There was no response from the server hosting the resource.-or- The Content-type header begins with multipart. + + + Uploads the specified local file to the specified resource, using the specified method. + A array containing the body of the response from the resource. + The URI of the resource to receive the file. + The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. + The file to send to the resource. + The parameter is null. -or-The parameter is null. + The URI formed by combining , and is invalid.-or- is null, is , contains invalid characters, or does not exist.-or- An error occurred while uploading the file.-or- There was no response from the server hosting the resource.-or- The Content-type header begins with multipart. + + + Uploads the specified local file to the specified resource, using the POST method. This method does not block the calling thread. + The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. + The file to send to the resource. + The parameter is null. -or-The parameter is null. + The URI formed by combining and is invalid.-or- is null, is , contains invalid character, or the specified path to the file does not exist.-or- An error occurred while opening the stream.-or- There was no response from the server hosting the resource.-or- The Content-type header begins with multipart. + + + Uploads the specified local file to the specified resource, using the POST method. This method does not block the calling thread. + The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. + The HTTP method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. + The file to send to the resource. + The parameter is null. -or-The parameter is null. + The URI formed by combining and is invalid.-or- is null, is , contains invalid character, or the specified path to the file does not exist.-or- An error occurred while opening the stream.-or- There was no response from the server hosting the resource.-or- The Content-type header begins with multipart. + + + Uploads the specified local file to the specified resource, using the POST method. This method does not block the calling thread. + The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. + The HTTP method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. + The file to send to the resource. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + The parameter is null. -or-The parameter is null. + The URI formed by combining and is invalid.-or- is null, is , contains invalid character, or the specified path to the file does not exist.-or- An error occurred while opening the stream.-or- There was no response from the server hosting the resource.-or- The Content-type header begins with multipart. + + + Occurs when an asynchronous file-upload operation completes. + + + Occurs when an asynchronous upload operation successfully transfers some or all of the data. + + + Uploads the specified string to the specified resource, using the POST method. + A containing the response sent by the server. + The URI of the resource to receive the string. For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. + The string to be uploaded. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource. + + + + + + + + Uploads the specified string to the specified resource, using the specified method. + A containing the response sent by the server. + The URI of the resource to receive the file. This URI must identify a resource that can accept a request sent with the method. + The HTTP method used to send the string to the resource. If null, the default is POST for http and STOR for ftp. + The string to be uploaded. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource.-or- cannot be used to send content. + + + + + + + + Uploads the specified string to the specified resource, using the POST method. + A containing the response sent by the server. + The URI of the resource to receive the string. For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. + The string to be uploaded. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource. + + + Uploads the specified string to the specified resource, using the specified method. + A containing the response sent by the server. + The URI of the resource to receive the file. This URI must identify a resource that can accept a request sent with the method. + The HTTP method used to send the string to the resource. If null, the default is POST for http and STOR for ftp. + The string to be uploaded. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource.-or- cannot be used to send content. + + + Uploads the specified string to the specified resource. This method does not block the calling thread. + The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. + The string to be uploaded. + + is null. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource. + + + Uploads the specified string to the specified resource. This method does not block the calling thread. + The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. + The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. + The string to be uploaded. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource. + + + Uploads the specified string to the specified resource. This method does not block the calling thread. + The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. + The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. + The string to be uploaded. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource. + + + Occurs when an asynchronous string-upload operation completes. + + + Uploads the specified name/value collection to the resource identified by the specified URI. + A array containing the body of the response from the resource. + The URI of the resource to receive the collection. + The to send to the resource. + The parameter is null.-or-The parameter is null. + The URI formed by combining , and is invalid.-or- is null.-or- There was no response from the server hosting the resource.-or- An error occurred while opening the stream.-or- The Content-type header is not null or "application/x-www-form-urlencoded". + + + + + + + + Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method. + A array containing the body of the response from the resource. + The URI of the resource to receive the collection. + The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. + The to send to the resource. + The parameter is null.-or-The parameter is null. + The URI formed by combining , and is invalid.-or- is null.-or- An error occurred while opening the stream.-or- There was no response from the server hosting the resource.-or- The Content-type header value is not null and is not application/x-www-form-urlencoded. + + + + + + + + Uploads the specified name/value collection to the resource identified by the specified URI. + A array containing the body of the response from the resource. + The URI of the resource to receive the collection. + The to send to the resource. + The parameter is null.-or-The parameter is null. + The URI formed by combining , and is invalid.-or- is null.-or- There was no response from the server hosting the resource.-or- An error occurred while opening the stream.-or- The Content-type header is not null or "application/x-www-form-urlencoded". + + + Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method. + A array containing the body of the response from the resource. + The URI of the resource to receive the collection. + The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. + The to send to the resource. + The parameter is null.-or-The parameter is null. + The URI formed by combining , and is invalid.-or- is null.-or- An error occurred while opening the stream.-or- There was no response from the server hosting the resource.-or- The Content-type header value is not null and is not application/x-www-form-urlencoded. + + + Uploads the data in the specified name/value collection to the resource identified by the specified URI. This method does not block the calling thread. + The URI of the resource to receive the collection. This URI must identify a resource that can accept a request sent with the default method. See remarks. + The to send to the resource. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource. + + + Uploads the data in the specified name/value collection to the resource identified by the specified URI, using the specified method. This method does not block the calling thread. + The URI of the resource to receive the collection. This URI must identify a resource that can accept a request sent with the method. + The method used to send the string to the resource. If null, the default is POST for http and STOR for ftp. + The to send to the resource. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource.-or- cannot be used to send content. + + + Uploads the data in the specified name/value collection to the resource identified by the specified URI, using the specified method. This method does not block the calling thread, and allows the caller to pass an object to the method that is invoked when the operation completes. + The URI of the resource to receive the collection. This URI must identify a resource that can accept a request sent with the method. + The HTTP method used to send the string to the resource. If null, the default is POST for http and STOR for ftp. + The to send to the resource. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + The parameter is null.-or-The parameter is null. + The URI formed by combining and is invalid.-or- There was no response from the server hosting the resource.-or- cannot be used to send content. + + + Occurs when an asynchronous upload of a name/value collection completes. + + + Gets or sets a value that controls whether the are sent with requests. + true if the default credentials are used; otherwise false. The default value is false. + + + + + + The exception that is thrown when an error occurs while accessing the network through a pluggable protocol. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class from the specified and instances. + A that contains the information required to serialize the new . + A that contains the source of the serialized stream that is associated with the new . + + + Initializes a new instance of the class with the specified error message. + The text of the error message. + + + Initializes a new instance of the class with the specified error message and nested exception. + The text of the error message. + A nested exception. + + + Initializes a new instance of the class with the specified error message, nested exception, status, and response. + The text of the error message. + A nested exception. + One of the values. + A instance that contains the response from the remote host. + + + Initializes a new instance of the class with the specified error message and status. + The text of the error message. + One of the values. + + + Populates a instance with the data needed to serialize the . + The to be used. + The to be used. + + + Gets the response that the remote host returned. + If a response is available from the Internet resource, a instance that contains the error response from an Internet resource; otherwise, null. + + + Gets the status of the response. + One of the values. + + + Serializes this instance into the specified object. + The object into which this will be serialized. + The destination of the serialization. + + + Defines status codes for the class. + + + No error was encountered. + + + The name resolver service could not resolve the host name. + + + The remote service point could not be contacted at the transport level. + + + A complete response was not received from the remote server. + + + A complete request could not be sent to the remote server. + + + The request was a piplined request and the connection was closed before the response was received. + + + The request was canceled, the method was called, or an unclassifiable error occurred. This is the default value for . + + + The response received from the server was complete but indicated a protocol-level error. For example, an HTTP protocol error such as 401 Access Denied would use this status. + + + The connection was prematurely closed. + + + A server certificate could not be validated. + + + An error occurred while establishing a connection using SSL. + + + The server response was not a valid HTTP response. + + + The connection for a request that specifies the Keep-alive header was closed unexpectedly. + + + An internal asynchronous request is pending. + + + No response was received during the time-out period for a request. + + + The name resolver service could not resolve the proxy host name. + + + An exception of unknown type has occurred. + + + A message was received that exceeded the specified limit when sending a request or receiving a response from the server. + + + The specified cache entry was not found. + + + The request was not permitted by the cache policy. In general, this occurs when a request is not cacheable and the effective policy prohibits sending the request to the server. You might receive this status if a request method implies the presence of a request body, a request method requires direct interaction with the server, or a request contains a conditional header. + + + This request was not permitted by the proxy. + + + Contains protocol headers associated with a request or response. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class from the specified instances of the and classes. + A containing the information required to serialize the . + A containing the source of the serialized stream associated with the new . + + contains invalid characters. + + is a null reference or . + + + Inserts the specified header with the specified value into the collection. + The header to add to the collection. + The content of the header. + The length of is greater than 65535. + This instance does not allow instances of . + + + Inserts the specified header with the specified value into the collection. + The header to add to the collection. + The content of the header. + The length of is greater than 65535. + This instance does not allow instances of . + + + Inserts the specified header into the collection. + The header to add, with the name and value separated by a colon. + + is null or . + + does not contain a colon (:) character.The length of is greater than 65535.-or- The name part of is or contains invalid characters.-or- is a restricted header that should be set with a property.-or- The value part of contains invalid characters. + The length the string after the colon (:) is greater than 65535. + + + Inserts a header with the specified name and value into the collection. + The header to add to the collection. + The content of the header. + + is null, , or contains invalid characters.-or- is a restricted header that must be set with a property setting.-or- contains invalid characters. + The length of is greater than 65535. + + + Inserts a header into the collection without checking whether the header is on the restricted header list. + The header to add to the collection. + The content of the header. + + is null, , or contains invalid characters.-or- contains invalid characters. + + is not null and the length of is too long (greater than 65,535 characters). + + + Gets all header names (keys) in the collection. + An array of type containing all header names in a Web request. + + + Removes all headers from the collection. + + + Gets the number of headers in the collection. + An indicating the number of headers in a request. + + + Get the value of a particular header in the collection, specified by an index into the collection. + A containing the value of the specified header. + The zero-based index of the key to get from the collection. + + is negative. -or- exceeds the size of the collection. + + + Get the value of a particular header in the collection, specified by the name of the header. + A holding the value of the specified header. + The name of the Web header. + + + Returns an enumerator that can iterate through the instance. + An for the . + + + Get the header name at the specified position in the collection. + A holding the header name. + The zero-based index of the key to get from the collection. + + is negative. -or- exceeds the size of the collection. + + + Populates a with the data needed to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + Gets an array of header values stored in the position of the header collection. + An array of header strings. + The header index to return. + + + Gets an array of header values stored in a header. + An array of header strings. + The header to return. + + + Tests whether the specified HTTP header can be set for the request. + true if the header is restricted; otherwise false. + The header to test. + + is null or . + + contains invalid characters. + + + Tests whether the specified HTTP header can be set for the request or the response. + true if the header is restricted; otherwise, false. + The header to test. + Does the Framework test the response or the request? + + is null or . + + contains invalid characters. + + + Gets or sets the specified request header. + A instance containing the specified header value. + The request header value. + This instance does not allow instances of . + + + + + + Gets or sets the specified response header. + A instance containing the specified header. + The response header value. + The length of is greater than 65535. + This instance does not allow instances of . + + + + + + Gets the collection of header names (keys) in the collection. + A containing all header names in a Web request. + + + Implements the interface and raises the deserialization event when the deserialization is complete. + The source of the deserialization event. + + + Removes the specified header from the collection. + The instance to remove from the collection. + This instance does not allow instances of . + + + + + + Removes the specified header from the collection. + The instance to remove from the collection. + This instance does not allow instances of . + + + + + + Removes the specified header from the collection. + The name of the header to remove from the collection. + + is null. + + is a restricted header.-or- contains invalid characters. + + + Sets the specified header to the specified value. + The value to set. + The content of the header to set. + The length of is greater than 65535. + This instance does not allow instances of . + + + Sets the specified header to the specified value. + The value to set. + The content of the header to set. + The length of is greater than 65535. + This instance does not allow instances of . + + + Sets the specified header to the specified value. + The header to set. + The content of the header to set. + + is null or . + The length of is greater than 65535. + + is a restricted header.-or- or contain invalid characters. + + + Serializes this instance into the specified object. + The object into which this will be serialized. + The destination of the serialization. + + + Converts the to a byte array.. + A array holding the header collection. + + + This method is obsolete. + The representation of the collection. + + + Controls rights to access HTTP Internet resources. + + + Creates a new instance of the class. + + + Initializes a new instance of the class with the specified access rights for the specified URI. + A NetworkAccess value that indicates what kind of access to grant to the specified URI. indicates that the application is allowed to accept connections from the Internet on a local resource. indicates that the application is allowed to connect to specific Internet resources. + A URI string to which access rights are granted. + + is null. + + + Initializes a new instance of the class with the specified access rights for the specified URI regular expression. + A value that indicates what kind of access to grant to the specified URI. indicates that the application is allowed to accept connections from the Internet on a local resource. indicates that the application is allowed to connect to specific Internet resources. + A regular expression that describes the URI to which access is to be granted. + + + Creates a new instance of the class that passes all demands or fails all demands. + A value. + + + This property returns an enumeration of a single accept permissions held by this . The possible objects types contained in the returned enumeration are and . + The interface that contains accept permissions. + + + Adds the specified URI string with the specified access rights to the current . + A that specifies the access rights that are granted to the URI. + A string that describes the URI to which access rights are granted. + + is null. + + + Adds the specified URI with the specified access rights to the current . + A NetworkAccess that specifies the access rights that are granted to the URI. + A regular expression that describes the set of URIs to which access rights are granted. + The parameter is null. + + + This property returns an enumeration of a single connect permissions held by this . The possible objects types contained in the returned enumeration are and . + The interface that contains connect permissions. + + + Creates a copy of a . + A new instance of the class that has the same values as the original. + + + Reconstructs a from an XML encoding. + The XML encoding from which to reconstruct the . + The parameter is null. + + is not a permission element for this type. + + + + + + + Returns the logical intersection of two instances. + A new that represents the intersection of the current instance and the parameter. If the intersection is empty, the method returns null. + The to compare with the current instance. + + is not null or of type + + + + + + + Determines whether the current is a subset of the specified object. + true if the current instance is a subset of the parameter; otherwise, false. If the target is null, the method returns true for an empty current permission that is not unrestricted and false otherwise. + The to compare to the current . + The target parameter is not an instance of . + The current instance contains a Regex-encoded right and there is not exactly the same right found in the target instance. + + + Checks the overall permission state of the . + true if the was created with the ; otherwise, false. + + + Creates an XML encoding of a and its current state. + A that contains an XML-encoded representation of the , including state information. + + + Returns the logical union between two instances of the class. + A that represents the union of the current instance and the parameter. If either WebPermission is , the method returns a that is . If the target is null, the method returns a copy of the current . + The to combine with the current . + target is not null or of type . + + + Specifies permission to access Internet resources. This class cannot be inherited. + + + Initializes a new instance of the class with a value that specifies the security actions that can be performed on this class. + One of the values. + + is not a valid value. + + + Gets or sets the URI string accepted by the current . + A string containing the URI accepted by the current . + + is not null when you attempt to set the value. If you wish to specify more than one Accept URI, use an additional attribute declaration statement. + + + Gets or sets a regular expression pattern that describes the URI accepted by the current . + A string containing a regular expression pattern that describes the URI accepted by the current . This string must be escaped according to the rules for encoding a constructor string. + + is not null when you attempt to set the value. If you wish to specify more than one Accept URI, use an additional attribute declaration statement. + + + + + + + Gets or sets the URI connection string controlled by the current . + A string containing the URI connection controlled by the current . + + is not null when you attempt to set the value. If you wish to specify more than one Connect URI, use an additional attribute declaration statement. + + + Gets or sets a regular expression pattern that describes the URI connection controlled by the current . + A string containing a regular expression pattern that describes the URI connection controlled by this . + + is not null when you attempt to set the value. If you wish to specify more than one connect URI, use an additional attribute declaration statement. + + + + + + + Creates and returns a new instance of the class. + A corresponding to the security declaration. + + + + + + Contains HTTP proxy settings for the class. + + + Initializes an empty instance of the class. + + + Initializes an instance of the class using previously serialized content. + The serialization data. + The context for the serialized data. + + + Initializes a new instance of the class with the specified URI. + The URI of the proxy server. + + is an invalid URI. + + + Initializes a new instance of the class with the specified URI and bypass setting. + The URI of the proxy server. + true to bypass the proxy for local addresses; otherwise, false. + + is an invalid URI. + + + Initializes a new instance of the class with the specified URI, bypass setting, and list of URIs to bypass. + The URI of the proxy server. + true to bypass the proxy for local addresses; otherwise, false. + An array of regular expression strings that contain the URIs of the servers to bypass. + + is an invalid URI. + + + Initializes a new instance of the class with the specified URI, bypass setting, list of URIs to bypass, and credentials. + The URI of the proxy server. + true to bypass the proxy for local addresses; otherwise, false. + An array of regular expression strings that contains the URIs of the servers to bypass. + An instance to submit to the proxy server for authentication. + + is an invalid URI. + + + Initializes a new instance of the class with the specified host and port number. + The name of the proxy host. + The port number on to use. + The URI formed by combining and is not a valid URI. + + + Initializes a new instance of the class from the specified instance. + A instance that contains the address of the proxy server. + + + Initializes a new instance of the class with the instance and bypass setting. + A instance that contains the address of the proxy server. + true to bypass the proxy for local addresses; otherwise, false. + + + Initializes a new instance of the class with the specified instance, bypass setting, and list of URIs to bypass. + A instance that contains the address of the proxy server. + true to bypass the proxy for local addresses; otherwise, false. + An array of regular expression strings that contains the URIs of the servers to bypass. + + + Initializes a new instance of the class with the specified instance, bypass setting, list of URIs to bypass, and credentials. + A instance that contains the address of the proxy server. + true to bypass the proxy for local addresses; otherwise, false. + An array of regular expression strings that contains the URIs of the servers to bypass. + An instance to submit to the proxy server for authentication. + + + Gets or sets the address of the proxy server. + A instance that contains the address of the proxy server. + + + Gets a list of addresses that do not use the proxy server. + An that contains a list of arrays that represents URIs that do not use the proxy server when accessed. + + + Gets or sets an array of addresses that do not use the proxy server. + An array that contains a list of regular expressions that describe URIs that do not use the proxy server when accessed. + + + Gets or sets a value that indicates whether to bypass the proxy server for local addresses. + true to bypass the proxy server for local addresses; otherwise, false. The default value is false. + + + Gets or sets the credentials to submit to the proxy server for authentication. + An instance that contains the credentials to submit to the proxy server for authentication. + You attempted to set this property when the property was set to true. + + + + + + Reads the Internet Explorer nondynamic proxy settings. + A instance that contains the nondynamic proxy settings from Internet Explorer 5.5 and later. + + + + + + + + + + Populates a with the data that is needed to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + Returns the proxied URI for a request. + The instance of the Internet resource, if the resource is on the bypass list; otherwise, the instance of the proxy. + The instance of the requested Internet resource. + The parameter is null. + + + Indicates whether to use the proxy server for the specified host. + true if the proxy server should not be used for ; otherwise, false. + The instance of the host to check for proxy use. + The parameter is null. + + + Creates the serialization data and context that are used by the system to serialize a object. + The object to populate with data. + A structure that indicates the destination for this serialization. + + + Gets or sets a value that controls whether the are sent with requests. + true if the default credentials are used; otherwise, false. The default value is false. + You attempted to set this property when the property contains credentials other than the default credentials. For more information, see the Remarks section. + + + + + + Makes a request to a Uniform Resource Identifier (URI). This is an abstract class. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class from the specified instances of the and classes. + A that contains the information required to serialize the new instance. + A that indicates the source of the serialized stream associated with the new instance. + Any attempt is made to access the constructor, when the constructor is not overridden in a descendant class. + + + Aborts the Request + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + + + + Gets or sets values indicating the level of authentication and impersonation used for this request. + A bitwise combination of the values. The default value is .In mutual authentication, both the client and server present credentials to establish their identity. The and values are relevant for Kerberos authentication. Kerberos authentication can be supported directly, or can be used if the Negotiate security protocol is used to select the actual security protocol. For more information about authentication protocols, see Internet Authentication.To determine whether mutual authentication occurred, check the property. If you specify the authentication flag value and mutual authentication does not occur, your application will receive an with a inner exception indicating that mutual authentication failed. + + + When overridden in a descendant class, provides an asynchronous version of the method. + An that references the asynchronous request. + The delegate. + An object containing state information for this asynchronous request. + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + When overridden in a descendant class, begins an asynchronous request for an Internet resource. + An that references the asynchronous request. + The delegate. + An object containing state information for this asynchronous request. + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + Gets or sets the cache policy for this request. + A object that defines a cache policy. + + + When overridden in a descendant class, gets or sets the name of the connection group for the request. + The name of the connection group for the request. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + When overridden in a descendant class, gets or sets the content length of the request data being sent. + The number of bytes of request data being sent. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + When overridden in a descendant class, gets or sets the content type of the request data being sent. + The content type of the request data. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + Initializes a new instance for the specified URI scheme. + A descendant for the specific URI scheme. + The URI that identifies the Internet resource. + The request scheme specified in has not been registered. + + is null. + The caller does not have permission to connect to the requested URI or a URI that the request is redirected to. + The URI specified in is not a valid URI. + + + + + + + + Initializes a new instance for the specified URI scheme. + A descendant for the specified URI scheme. + A containing the URI of the requested resource. + The request scheme specified in is not registered. + + is null. + The caller does not have permission to connect to the requested URI or a URI that the request is redirected to. + + + + + + + + Initializes a new instance for the specified URI scheme. + A descendant for the specified URI scheme. + A containing the URI of the requested resource. + The request scheme specified in is not registered. + + is null. + The caller does not have permission to connect to the requested URI or a URI that the request is redirected to. + + + + + + + + When overridden in a descendant class, gets or sets the network credentials used for authenticating the request with the Internet resource. + An containing the authentication credentials associated with the request. The default is null. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + Gets or sets the default cache policy for this request. + A that specifies the cache policy in effect for this request when no other policy is applicable. + + + Gets or sets the global HTTP proxy. + An used by every call to instances of . + + + When overridden in a descendant class, returns a for writing data to the Internet resource. + A to write data to. + An that references a pending request for a stream. + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + When overridden in a descendant class, returns a . + A that contains a response to the Internet request. + An that references a pending request for a response. + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + Populates a with the data needed to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + When overridden in a descendant class, returns a for writing data to the Internet resource. + A for writing data to the Internet resource. + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + + + + When overridden in a descendant class, returns a response to an Internet request. + A containing the response to the Internet request. + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + + + + Returns a proxy configured with the Internet Explorer settings of the currently impersonated user. + An used by every call to instances of . + + + When overridden in a descendant class, gets or sets the collection of header name/value pairs associated with the request. + A containing the header name/value pairs associated with this request. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + Gets or sets the impersonation level for the current request. + A value. + + + When overridden in a descendant class, gets or sets the protocol method to use in this request. + The protocol method to use in this request. + If the property is not overridden in a descendant class, any attempt is made to get or set the property. + + + + + + When overridden in a descendant class, indicates whether to pre-authenticate the request. + true to pre-authenticate; otherwise, false. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + When overridden in a descendant class, gets or sets the network proxy to use to access this Internet resource. + The to use to access the Internet resource. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + Registers a descendant for the specified URI. + true if registration is successful; otherwise, false. + The complete URI or URI prefix that the descendant services. + The create method that the calls to create the descendant. + + is null-or- is null. + + + + + + + + When overridden in a descendant class, gets the URI of the Internet resource associated with the request. + A representing the resource associated with the request + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + When overridden in a descendant class, populates a instance with the data needed to serialize the . + A , which holds the serialized data for the . + A that contains the destination of the serialized stream associated with the new . + An attempt is made to serialize the object, when the interface is not overridden in a descendant class. + + + Gets or sets the length of time, in milliseconds, before the request times out. + The length of time, in milliseconds, until the request times out, or the value to indicate that the request does not time out. The default value is defined by the descendant class. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + When overridden in a descendant class, gets or sets a value that controls whether are sent with requests. + true if the default credentials are used; otherwise false. The default value is false. + You attempted to set this property after the request was sent. + Any attempt is made to access the property, when the property is not overridden in a descendant class. + + + + + + Container class for , , and classes. This class cannot be inherited + + + Represents the types of file protocol methods that can be used with a FILE request. This class cannot be inherited. + + + Represents the FILE GET protocol method that is used to retrieve a file from a specified location. + + + Represents the FILE PUT protocol method that is used to copy a file to a specified location. + + + Represents the types of FTP protocol methods that can be used with an FTP request. This class cannot be inherited. + + + Represents the FTP APPE protocol method that is used to append a file to an existing file on an FTP server. + + + Represents the FTP DELE protocol method that is used to delete a file on an FTP server. + + + Represents the FTP RETR protocol method that is used to download a file from an FTP server. + + + Represents the FTP MDTM protocol method that is used to retrieve the date-time stamp from a file on an FTP server. + + + Represents the FTP SIZE protocol method that is used to retrieve the size of a file on an FTP server. + + + Represents the FTP NLIST protocol method that gets a short listing of the files on an FTP server. + + + Represents the FTP LIST protocol method that gets a detailed listing of the files on an FTP server. + + + Represents the FTP MKD protocol method creates a directory on an FTP server. + + + Represents the FTP PWD protocol method that prints the name of the current working directory. + + + Represents the FTP RMD protocol method that removes a directory. + + + Represents the FTP RENAME protocol method that renames a directory. + + + Represents the FTP STOR protocol method that uploads a file to an FTP server. + + + Represents the FTP STOU protocol that uploads a file with a unique name to an FTP server. + + + Represents the types of HTTP protocol methods that can be used with an HTTP request. + + + Represents the HTTP CONNECT protocol method that is used with a proxy that can dynamically switch to tunneling, as in the case of SSL tunneling. + + + Represents an HTTP GET protocol method. + + + Represents an HTTP HEAD protocol method. The HEAD method is identical to GET except that the server only returns message-headers in the response, without a message-body. + + + Represents an HTTP MKCOL request that creates a new collection (such as a collection of pages) at the location specified by the request-Uniform Resource Identifier (URI). + + + Represents an HTTP POST protocol method that is used to post a new entity as an addition to a URI. + + + Represents an HTTP PUT protocol method that is used to replace an entity identified by a URI. + + + Provides a response from a Uniform Resource Identifier (URI). This is an abstract class. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class from the specified instances of the and classes. + An instance of the class that contains the information required to serialize the new instance. + An instance of the class that indicates the source of the serialized stream that is associated with the new instance. + Any attempt is made to access the constructor, when the constructor is not overridden in a descendant class. + + + When overridden by a descendant class, closes the response stream. + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + + + + When overridden in a descendant class, gets or sets the content length of data being received. + The number of bytes returned from the Internet resource. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + When overridden in a derived class, gets or sets the content type of the data being received. + A string that contains the content type of the response. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + Populates a with the data that is needed to serialize the target object. + The to populate with data. + A that specifies the destination for this serialization. + + + When overridden in a descendant class, returns the data stream from the Internet resource. + An instance of the class for reading data from the Internet resource. + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + + + + When overridden in a derived class, gets a collection of header name-value pairs associated with this request. + An instance of the class that contains header values associated with this response. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + Gets a value that indicates whether this response was obtained from the cache. + true if the response was taken from the cache; otherwise, false. + + + Gets a value that indicates whether mutual authentication occurred. + true if both client and server were authenticated; otherwise, false. + + + When overridden in a derived class, gets the URI of the Internet resource that actually responded to the request. + An instance of the class that contains the URI of the Internet resource that actually responded to the request. + Any attempt is made to get or set the property, when the property is not overridden in a descendant class. + + + + + + When overridden in a derived class, releases all resources used by the . + Any attempt is made to access the method, when the method is not overridden in a descendant class. + + + Populates a instance with the data that is needed to serialize . + A that will hold the serialized data for the . + A that contains the destination of the serialized stream that is associated with the new . + + + Provides methods for encoding and decoding URLs when processing Web requests. + + + Converts a string that has been HTML-encoded for HTTP transmission into a decoded string. + A decoded string. + The string to decode. + + + Converts a string that has been HTML-encoded into a decoded string, and sends the decoded string to a output stream. + The string to decode. + A stream of output. + The parameter cannot be null if the parameter is not null. + + + Converts a string to an HTML-encoded string. + An encoded string. + The string to encode. + + + Converts a string into an HTML-encoded string, and returns the output as a stream of output. + The string to encode. + A output stream. + The parameter cannot be null if the parameter is not null. + + + Specifies the meaning of time values that control caching behavior for resources obtained using objects. + + + For internal use only. The Framework will throw an if you try to use this member. + + + Content can be taken from the cache if the time remaining before expiration is greater than or equal to the time specified with this value. + + + Content can be taken from the cache until it is older than the age specified with this value. + + + Content can be taken from the cache after it has expired, until the time specified with this value elapses. + + + + and . + + + + and . + + + Specifies caching behavior for resources obtained using the Hypertext Transfer protocol (HTTP). + + + Satisfies a request for a resource either by using the cached copy of the resource or by sending a request for the resource to the server. The action taken is determined by the current cache policy and the age of the content in the cache. This is the cache level that should be used by most applications. + + + Satisfies a request by using the server. No entries are taken from caches, added to caches, or removed from caches between the client and server. No entries are taken from caches, added to caches, or removed from caches between the client and server. This is the default cache behavior specified in the machine configuration file that ships with the .NET Framework. + + + Satisfies a request using the locally cached resource; does not send a request for an item that is not in the cache. When this cache policy level is specified, a exception is thrown if the item is not in the client cache. + + + Satisfies a request for a resource from the cache if the resource is available; otherwise, sends a request for a resource to the server. If the requested item is available in any cache between the client and the server, the request might be satisfied by the intermediate cache. + + + Compares the copy of the resource in the cache with the copy on the server. If the copy on the server is newer, it is used to satisfy the request and replaces the copy in the cache. If the copy in the cache is the same as the server copy, the cached copy is used. In the HTTP caching protocol, this is achieved using a conditional request. + + + Satisfies a request by using the server. The response might be saved in the cache. In the HTTP caching protocol, this is achieved using the no-cache cache control directive and the no-cache Pragma header. + + + Never satisfies a request by using resources from the cache and does not cache resources. If the resource is present in the local cache, it is removed. This policy level indicates to intermediate caches that they should remove the resource. In the HTTP caching protocol, this is achieved using the no-cache cache control directive. + + + Satisfies a request for a resource either from the local computer's cache or a remote cache on the local area network. If the request cannot be satisfied, a exception is thrown. In the HTTP caching protocol, this is achieved using the only-if-cached cache control directive. + + + Satisfies a request by using the server or a cache other than the local cache. Before the request can be satisfied by an intermediate cache, that cache must revalidate its cached entry with the server. In the HTTP caching protocol, this is achieved using the max-age = 0 cache control directive and the no-cache Pragma header. + + + Defines an application's caching requirements for resources obtained by using objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified cache synchronization date. + A object that specifies the time when resources stored in the cache must be revalidated. + + + Initializes a new instance of the class using the specified age control and time values. + One of the following enumeration values: , , or . + A value that specifies an amount of time. See the Remarks section for more information. + The value specified for the parameter cannot be used with this constructor. + + + Initializes a new instance of the class using the specified maximum age, age control value, and time value. + An value. + A value that specifies the maximum age for resources. + A value that specifies an amount of time. See the Remarks section for more information.   + The value specified for the parameter is not valid. + + + Initializes a new instance of the class using the specified maximum age, age control value, time value, and cache synchronization date. + An value. + A value that specifies the maximum age for resources. + A value that specifies an amount of time. See the Remarks section for more information.   + A object that specifies the time when resources stored in the cache must be revalidated. + + + Initializes a new instance of the class using the specified cache policy. + An value. + + + Gets the cache synchronization date for this instance. + A value set to the date specified when this instance was created. If no date was specified, this property's value is . + + + Gets the value that was specified when this instance was created. + A value that specifies the cache behavior for resources that were obtained using objects. + + + Gets the maximum age permitted for a resource returned from the cache. + A value that is set to the maximum age value specified when this instance was created. If no date was specified, this property's value is . + + + Gets the maximum staleness value that is permitted for a resource returned from the cache. + A value that is set to the maximum staleness value specified when this instance was created. If no date was specified, this property's value is . + + + Gets the minimum freshness that is permitted for a resource returned from the cache. + A value that specifies the minimum freshness specified when this instance was created. If no date was specified, this property's value is . + + + Returns a string representation of this instance. + A value that contains the property values for this instance. + + + Specifies caching behavior for resources obtained using and its derived classes. + + + Satisfies a request for a resource either by using the cached copy of the resource or by sending a request for the resource to the server. The action taken is determined by the current cache policy and the age of the content in the cache. This is the cache level that should be used by most applications. + + + Satisfies a request by using the server. No entries are taken from caches, added to caches, or removed from caches between the client and server. This is the default cache behavior specified in the machine configuration file that ships with the .NET Framework. + + + Satisfies a request using the locally cached resource; does not send a request for an item that is not in the cache. When this cache policy level is specified, a exception is thrown if the item is not in the client cache. + + + Satisfies a request for a resource from the cache, if the resource is available; otherwise, sends a request for a resource to the server. If the requested item is available in any cache between the client and the server, the request might be satisfied by the intermediate cache. + + + Satisfies a request by using the cached copy of the resource if the timestamp is the same as the timestamp of the resource on the server; otherwise, the resource is downloaded from the server, presented to the caller, and stored in the cache. + + + Satisfies a request by using the server. The response might be saved in the cache. In the HTTP caching protocol, this is achieved using the no-cache cache control directive and the no-cache Pragma header. + + + Never satisfies a request by using resources from the cache and does not cache resources. If the resource is present in the local cache, it is removed. This policy level indicates to intermediate caches that they should remove the resource. In the HTTP caching protocol, this is achieved using the no-cache cache control directive. + + + Defines an application's caching requirements for resources obtained by using objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. using the specified cache policy. + A that specifies the cache behavior for resources obtained using objects. + level is not a valid .value. + + + Gets the value specified when this instance was constructed. + A value that specifies the cache behavior for resources obtained using objects. + + + Returns a string representation of this instance. + A containing the for this instance. + + + Represents the type information for an authentication module. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified type information. + A string that identifies the type and the assembly that contains it. + + + Gets or sets the type and assembly information for the current instance. + A string that identifies a type that implements an authentication module or null if no value has been specified. + + + Represents a container for authentication module configuration elements. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Adds an element to the collection. + The to add to the collection. + + + Removes all elements from the collection. + + + Returns the index of the specified configuration element. + The zero-based index of . + A . + + + Gets or sets the element at the specified position in the collection. + The at the specified location. + The zero-based index of the element. + + + Gets or sets the element with the specified key. + The with the specified key or null if there is no element with the specified key. + The key for an element in the collection. + + + Removes the specified configuration element from the collection. + The to remove. + + + Removes the element with the specified key. + The key of the element to remove. + + + Removes the element at the specified index. + The zero-based index of the element to remove. + + + Represents the configuration section for authentication modules. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets the collection of authentication modules in the section. + A that contains the registered authentication modules. + + + Represents the address information for resources that are not retrieved using a proxy server. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified type information. + A string that identifies the address of a resource. + + + Gets or sets the addresses of resources that bypass the proxy server. + A string that identifies a resource. + + + Represents a container for the addresses of resources that bypass the proxy server. This class cannot be inherited. + + + Initializes an empty instance of the class. + + + Adds an element to the collection. + The to add to the collection. + + + Removes all elements from the collection. + + + Returns the index of the specified configuration element. + The zero-based index of . + A . + + + Gets or sets the element at the specified position in the collection. + The at the specified location. + The zero-based index of the element. + + + Gets or sets the element with the specified key. + The with the specified key, or null if there is no element with the specified key. + The key for an element in the collection. + + + Removes the specified configuration element from the collection. + The to remove. + + + Removes the element with the specified key. + The key of the element to remove. + + + Removes the element at the specified index. + The zero-based index of the element to remove. + + + Represents the maximum number of connections to a remote computer. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified address and connection limit information. + A string that identifies the address of a remote computer. + An integer that identifies the maximum number of connections allowed to from the local computer. + + + Gets or sets the address for remote computers. + A string that contains a regular expression describing an IP address or DNS name. + + + Gets or sets the maximum number of connections that can be made to a remote computer. + An integer that specifies the maximum number of connections. + + + Represents a container for connection management configuration elements. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Adds an element to the collection. + The to add to the collection. + + + Removes all elements from the collection. + + + Returns the index of the specified configuration element. + The zero-based index of . + A . + + + Gets or sets the element at the specified position in the collection. + The at the specified location. + The zero-based index of the element. + + + Gets or sets the element with the specified key. + The with the specified key or null if there is no element with the specified key. + The key for an element in the collection. + + + Removes the specified configuration element from the collection. + The to remove. + + + Removes the element with the specified key. + The key of the element to remove. + + + Removes the element at the specified index. + The zero-based index of the element to remove. + + + Represents the configuration section for connection management. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets the collection of connection management objects in the section. + A that contains the connection management information for the local computer. + + + Represents the configuration section for Web proxy server usage. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets the collection of resources that are not obtained using the Web proxy server. + A that contains the addresses of resources that bypass the Web proxy server. + + + Gets or sets whether a Web proxy is used. + true if a Web proxy will be used; otherwise, false. + + + Gets the type information for a custom Web proxy implementation. + A . + + + Gets the URI that identifies the Web proxy server to use. + A . + + + Gets or sets whether default credentials are to be used to access a Web proxy server. + true if default credentials are to be used; otherwise, false. + + + Represents the default FTP cache policy for network resources. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets or sets FTP caching behavior for the local machine. + A value that specifies the cache behavior. + + + Represents the default HTTP cache policy for network resources. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets or sets the maximum age permitted for a resource returned from the cache. + A value that specifies the maximum age for cached resources specified in the configuration file. + + + Gets or sets the maximum staleness value permitted for a resource returned from the cache. + A value that is set to the maximum staleness value specified in the configuration file. + + + Gets or sets the minimum freshness permitted for a resource returned from the cache. + A value that specifies the minimum freshness specified in the configuration file. + + + Gets or sets HTTP caching behavior for the local machine. + A value that specifies the cache behavior. + + + Represents the HttpListener element in the configuration file. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets a value that indicates if uses the raw unescaped URI instead of the converted URI. + A Boolean value that indicates if uses the raw unescaped URI, rather than the converted URI. + + + Represents the maximum length for response headers. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets or sets the maximum allowed length of an error response. + A 32-bit signed integer containing the maximum length in kilobytes (1024 bytes) of the error response. The default value is 64. + + + Gets or sets the maximum allowed length of the response headers. + A 32-bit signed integer containing the maximum length in kilobytes (1024 bytes) of the response headers. The default value is 64. + + + Gets or sets the maximum length of an upload in response to an unauthorized error code. + A 32-bit signed integer containing the maximum length (in multiple of 1,024 byte units) of an upload in response to an unauthorized error code. A value of -1 indicates that no size limit will be imposed on the upload. Setting the property to any other value will only send the request body if it is smaller than the number of bytes specified. So a value of 1 would indicate to only send the request body if it is smaller than 1,024 bytes. The default value for this property is -1. + + + Setting this property ignores validation errors that occur during HTTP parsing. + Boolean that indicates whether this property has been set. + + + Determines whether Internet Protocol version 6 is enabled on the local computer. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets or sets a Boolean value that indicates whether Internet Protocol version 6 is enabled on the local computer. + true if IPv6 is enabled; otherwise, false. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + + + Gets the SMTP settings for the local computer. + A object that contains configuration information for the local computer. + + + Represents the type information for a custom module. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets or sets the type and assembly information for the current instance. + A string that identifies a type that implements the interface or null if no value has been specified. + + + Gets the section group information for the networking namespaces. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets the configuration section containing the authentication modules registered for the local computer. + A object. + + + Gets the configuration section containing the connection management settings for the local computer. + A object. + + + Gets the configuration section containing the default Web proxy server settings for the local computer. + A object. + + + Gets the System.Net configuration section group from the specified configuration file. + A that represents the System.Net settings in . + A that represents a configuration file. + + + Gets the configuration section containing the SMTP client e-mail settings for the local computer. + A object. + + + Gets the configuration section containing the cache configuration settings for the local computer. + A object. + + + Gets the configuration section containing the network settings for the local computer. + A object. + + + Gets the configuration section containing the modules registered for use with the class. + A object. + + + Represents the performance counter element in the System.Net configuration file that determines whether networking performance counters are enabled. This class cannot be inherited. + + + Instantiates a object. + + + Gets or sets whether performance counters are enabled. + true if performance counters are enabled; otherwise, false. + + + Identifies the configuration settings for Web proxy server. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets and sets an value that controls whether the Web proxy is automatically detected. + + if the is automatically detected; if the is not automatically detected; or . + + + Gets and sets a value that indicates whether local resources are retrieved by using a Web proxy server. + A . + + + Gets and sets the URI that identifies the Web proxy server to use. + A containing a URI. + + + Gets and sets an value that specifies the location of the automatic proxy detection script. + A specifying the location of the automatic proxy detection script. + + + Gets and sets a value that controls whether the Internet Explorer Web proxy settings are used. + true if the Internet Explorer LAN settings are used to detect and configure the default used for requests; otherwise, false. + + + Specifies whether the proxy is automatically detected. + + + Unspecified. + + + The proxy is not automatically detected. + + + The proxy is automatically detected. + + + Specifies whether the proxy is bypassed for local resources. + + + Unspecified. + + + All requests for local resources should go through the proxy + + + Access local resources directly. + + + Specifies whether to use the local system proxy settings to determine whether the proxy is bypassed for local resources. + + + The system default proxy setting is unspecified. + + + Do not use system default proxy setting values + + + Use system default proxy setting values. + + + Represents the configuration section for cache behavior. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets the default FTP caching behavior for the local computer. + A that defines the default cache policy. + + + Gets the default caching behavior for the local computer. + A that defines the default cache policy. + + + Gets or sets the default cache policy level. + A enumeration value. + + + Gets or sets a Boolean value that enables caching on the local computer. + true if caching is disabled on the local computer; otherwise, false. + + + Gets or sets a Boolean value that indicates whether the local computer cache is private. + true if the cache provides user isolation; otherwise, false. + + + Gets or sets a value used as the maximum age for cached resources that do not have expiration information. + A that provides a default maximum age for cached resources. + + + Represents the default settings used to create connections to a remote computer. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets or sets a Boolean value that controls checking host name information in an X509 certificate. + true to specify host name checking; otherwise, false. + + + Gets or sets a Boolean value that indicates whether the certificate is checked against the certificate authority revocation list. + true if the certificate revocation list is checked; otherwise, false.The default value is false. + + + Gets or sets the amount of time after which address information is refreshed. + A that specifies when addresses are resolved using DNS. + + + Gets or sets a Boolean value that controls using different IP addresses on connections to the same server. + true to enable DNS round-robin behavior; otherwise, false. + + + Gets or sets the to use. + The encryption policy to use for a instance. + + + Gets or sets a Boolean value that determines whether 100-Continue behavior is used. + true to expect 100-Continue responses for POST requests; otherwise, false. The default value is true. + + + Gets or sets a Boolean value that determines whether the Nagle algorithm is used. + true to use the Nagle algorithm; otherwise, false. The default value is true. + + + Represents the configuration section for sockets, IPv6, response headers, and service points. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets the configuration element that controls the settings used by an object. + A object. + + + Gets the configuration element that controls the maximum response header length. + A object. + + + Gets the configuration element that enables Internet Protocol version 6 (IPv6). + A . + + + Gets the configuration element that controls whether performance counters are enabled. + A . + + + Gets the configuration element that controls settings for connections to remote host computers. + A object. + + + Gets the configuration element that controls settings for sockets. + A object. + + + Gets the configuration element that controls the execution timeout and download timeout of Web proxy scripts. + A object. + + + Represents the network element in the SMTP configuration file. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets or sets the client domain name used in the initial SMTP protocol request to connect to an SMTP mail server. + A string that represents the client domain name used in the initial SMTP protocol request to connect to an SMTP mail server. + + + Determines whether or not default user credentials are used to access an SMTP server. The default value is false. + true indicates that default user credentials will be used to access the SMTP server; otherwise, false. + + + Gets or sets whether SSL is used to access an SMTP mail server. The default value is false. + true indicates that SSL will be used to access the SMTP mail server; otherwise, false. + + + Gets or sets the name of the SMTP server. + A string that represents the name of the SMTP server to connect to. + + + Gets or sets the user password to use to connect to an SMTP mail server. + A string that represents the password to use to connect to an SMTP mail server. + + + Gets or sets the port that SMTP clients use to connect to an SMTP mail server. The default value is 25. + A string that represents the port to connect to an SMTP mail server. + + + Gets or sets the Service Provider Name (SPN) to use for authentication when using extended protection to connect to an SMTP mail server. + A string that represents the SPN to use for authentication when using extended protection to connect to an SMTP mail server. + + + Gets or sets the user name to connect to an SMTP mail server. + A string that represents the user name to connect to an SMTP mail server. + + + Represents the SMTP section in the System.Net configuration file. + + + Initializes a new instance of the class. + + + Gets or sets the SMTP delivery method. The default delivery method is . + A string that represents the SMTP delivery method. + + + Gets or sets the default value that indicates who the email message is from. + A string that represents the default value indicating who a mail message is from. + + + Gets a . + A object. + + + Gets the pickup directory that will be used by the SMPT client. + A object that specifies the pickup directory folder. + + + Represents an SMTP pickup directory configuration element. + + + Initializes a new instance of the class. + + + Gets or sets the folder where applications save mail messages to be processed by the SMTP server. + A string that specifies the pickup directory for e-mail messages. + + + Represents information used to configure objects. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets or sets a Boolean value that specifies whether completion ports are used when accepting connections. + true to use completion ports; otherwise, false. + + + Gets or sets a Boolean value that specifies whether completion ports are used when making connections. + true to use completion ports; otherwise, false. + + + Gets or sets a value that specifies the default to use for a socket. + The value of the for the current instance. + + + Represents information used to configure Web proxy scripts. This class cannot be inherited. + + + Initializes an instance of the class. + + + Gets or sets the Web proxy script download timeout using the format hours:minutes:seconds. + A object that contains the timeout value. The default download timeout is one minute. + + + Represents a URI prefix and the associated class that handles creating Web requests for the prefix. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified URI prefix and type information. + A string containing a URI prefix. + A string containing the type and assembly information for the class that handles creating requests for resources that use the URI prefix. For more information, see the Remarks section. + + + Initializes a new instance of the class using the specified URI prefix and type identifier. + A string containing a URI prefix. + A that identifies the class that handles creating requests for resources that use the URI prefix. + + + Gets or sets the URI prefix for the current Web request module. + A string that contains a URI prefix. + + + Gets or sets a class that creates Web requests. + A instance that identifies a Web request module. + + + Represents a container for Web request module configuration elements. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Adds an element to the collection. + The to add to the collection. + + + Removes all elements from the collection. + + + Returns the index of the specified configuration element. + The zero-based index of . + A . + + + Gets or sets the element at the specified position in the collection. + The at the specified location. + The zero-based index of the element. + + + Gets or sets the element with the specified key. + The with the specified key or null if there is no element with the specified key. + The key for an element in the collection. + + + Removes the specified configuration element from the collection. + The to remove. + + + Removes the element with the specified key. + The key of the element to remove. + + + Removes the element at the specified index. + The zero-based index of the element to remove. + + + Represents the configuration section for Web request modules. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets the collection of Web request modules in the section. + A containing the registered Web request modules. + + + Represents the format to view an email message. + + + Initializes a new instance of with the specified . + A stream that contains the content for this view. + + is null. + + + Initializes a new instance of with the specified and . + A stream that contains the content for this attachment. + The type of the content. + + is null. + + is not a valid value. + + + Initializes a new instance of with the specified and media type. + A stream that contains the content for this attachment. + The MIME media type of the content. + + is null. + + is not a valid value. + + + Initializes a new instance of with the specified file name. + The name of the file that contains the content for this alternate view. + + is null. + The caller does not have the required permission. + An I/O error occurred, such as a disk error. + The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access. + + + Initializes a new instance of with the specified file name and content type. + The name of the file that contains the content for this alternate view. + The type of the content. + + is null. + + is not a valid value. + The caller does not have the required permission. + An I/O error occurred, such as a disk error. + The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access. + + + Initializes a new instance of with the specified file name and media type. + The name of the file that contains the content for this alternate view. + The MIME media type of the content. + + is null. + + is not a valid value. + The caller does not have the required permission. + An I/O error occurred, such as a disk error. + The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access. + + + Gets or sets the Base URI to use for resolving relative URIs in the . + A . + + + Creates a of an email message using the content specified in a . + An object that represents an alternate view of an email message. + The that contains the content of the email message. + + is null. + + + Creates an of an email message using the content specified in a and the specified MIME media type of the content. + An object that represents an alternate view of an email message. + A that contains the content for this attachment. + A that describes the data in . + + is null. + + + Creates an of an email message using the content specified in a , the specified text encoding, and MIME media type of the content. + An object that represents an alternate view of an email message. + A that contains the content for this attachment. + An . This value can be null. + The MIME media type of the content. + + is null. + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets the set of embedded resources referred to by this attachment. + A object that stores the collection of linked resources to be sent as part of an e-mail message. + + + Represents a collection of objects. + + + Releases all resources used by the . + + + Represents an attachment to an e-mail. + + + Initializes a new instance of the class with the specified stream and content type. + A readable that contains the content for this attachment. + A that describes the data in . + + is null.-or- is null. + + + Initializes a new instance of the class with the specified stream and name. + A readable that contains the content for this attachment. + A that contains the value for the property of the associated with this attachment. This value can be null. + + is null. + + + Initializes a new instance of the class with the specified stream, name, and MIME type information. + A readable that contains the content for this attachment. + A that contains the value for the property of the associated with this attachment. This value can be null. + A that contains the MIME Content-Header information for this attachment. This value can be null. + + is null. + + is not in the correct format. + + + Initializes a new instance of the class with the specified content string. + A that contains a file path to use to create this attachment. + + is null. + + is empty. + + + Initializes a new instance of the class with the specified content string and . + A that contains a file path to use to create this attachment. + A that describes the data in . + + is null. + + is not in the correct format. + + + Initializes a new instance of the class with the specified content string and MIME type information. + A that contains the content for this attachment. + A that contains the MIME Content-Header information for this attachment. This value can be null. + + is null. + + is not in the correct format. + + + Gets the MIME content disposition for this attachment. + A that provides the presentation information for this attachment. + + + Creates a mail attachment using the content from the specified string, and the specified . + An object of type . + A that contains the content for this attachment. + A object that represents the Multipurpose Internet Mail Exchange (MIME) protocol Content-Type header to be used. + + + Creates a mail attachment using the content from the specified string, and the specified MIME content type name. + An object of type . + A that contains the content for this attachment. + The MIME content type name value in the content type associated with this attachment. + + + Creates a mail attachment using the content from the specified string, the specified MIME content type name, character encoding, and MIME header information for the attachment. + An object of type . + A that contains the content for this attachment. + The MIME content type name value in the content type associated with this attachment. + An . This value can be null. + A that contains the MIME Content-Header information for this attachment. This value can be null. + + + Gets or sets the MIME content type name value in the content type associated with this attachment. + A that contains the value for the content type represented by the property. + The value specified for a set operation is null. + The value specified for a set operation is (""). + + + Specifies the encoding for the . + An value that specifies the type of name encoding. The default value is determined from the name of the attachment. + + + Base class that represents an email attachment. Classes , , and derive from this class. + + + Instantiates an with the specified . + A stream containing the content for this attachment. + + is null. + + + Instantiates an with the specified and . + A stream containing the content for this attachment. + The type of the content. + + is null. + + is not a valid value. + + + Instantiates an with the specified and media type. + A stream containing the content for this attachment. + The MIME media type of the content. + + is null. + + is not a valid value. + + + Instantiates an with the specified file name. + The file name holding the content for this attachment. + + is null. + + + Instantiates an with the specified file name and content type. + The file name holding the content for this attachment. + The type of the content. + + is null. + + is not a valid value. + + + Instantiates an with the specified file name and media type. + The file name holding the content for this attachment. + The MIME media type of the content. + + is null. + + is not a valid value. + + + Gets or sets the MIME content ID for this attachment. + A holding the content ID. + Attempted to set to null. + + + Gets the content stream of this attachment. + A . + + + Gets the content type of this attachment. + A . + + + Releases the resources used by the . + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets or sets the encoding of this attachment. + A . + + + Stores attachments to be sent as part of an e-mail message. + + + Releases all resources used by the . + + + Describes the delivery notification options for e-mail. + + + No notification information will be sent. The mail server will utilize its configured behavior to determine whether it should generate a delivery notification. + + + Notify if the delivery is successful. + + + Notify if the delivery is unsuccessful. + + + Notify if the delivery is delayed. + + + A notification should not be generated under any circumstances. + + + Represents an embedded external resource in an email attachment, such as an image in an HTML attachment. + + + Initializes a new instance of using the supplied . + A stream that contains the content for this embedded resource. + + is null. + + + Initializes a new instance of with the values supplied by and . + A stream that contains the content for this embedded resource. + The type of the content. + + is null. + + is not a valid value. + + + Initializes a new instance of with the specified and media type. + A stream that contains the content for this embedded resource. + The MIME media type of the content. + + is null. + + is not a valid value. + + + Initializes a new instance of using the specified file name. + The file name holding the content for this embedded resource. + + is null. + + + Initializes a new instance of with the specified file name and content type. + The file name that holds the content for this embedded resource. + The type of the content. + + is null. + + is not a valid value. + + + Initializes a new instance of with the specified file name and media type. + The file name that holds the content for this embedded resource. + The MIME media type of the content. + + is null. + + is not a valid value. + + + Gets or sets a URI that the resource must match. + If is a relative URI, the recipient of the message must resolve it. + + + Creates a object from a string to be included in an email attachment as an embedded resource. The default media type is plain text, and the default content type is ASCII. + A object that contains the embedded resource to be included in the email attachment. + A string that contains the embedded resource to be included in the email attachment. + The specified content string is null. + + + Creates a object from a string to be included in an email attachment as an embedded resource, with the specified content type, and media type as plain text. + A object that contains the embedded resource to be included in the email attachment. + A string that contains the embedded resource to be included in the email attachment. + The type of the content. + The specified content string is null. + + + Creates a object from a string to be included in an email attachment as an embedded resource, with the specified content type, and media type. + A object that contains the embedded resource to be included in the email attachment. + A string that contains the embedded resource to be included in the email attachment. + The type of the content. + The MIME media type of the content. + The specified content string is null. + + + Stores linked resources to be sent as part of an e-mail message. + + + Releases all resources used by the . + + + Represents the address of an electronic mail sender or recipient. + + + Initializes a new instance of the class using the specified address. + A that contains an e-mail address. + + is null. + + is (""). + + is not in a recognized format. + + + Initializes a new instance of the class using the specified address and display name. + A that contains an e-mail address. + A that contains the display name associated with . This parameter can be null. + + is null. + + is (""). + + is not in a recognized format.-or- contains non-ASCII characters. + + + Initializes a new instance of the class using the specified address, display name, and encoding. + A that contains an e-mail address. + A that contains the display name associated with . + The that defines the character set used for . + + is null.-or- is null. + + is ("").-or- is (""). + + is not in a recognized format.-or- contains non-ASCII characters. + + + Gets the e-mail address specified when this instance was created. + A that contains the e-mail address. + + + Gets the display name composed from the display name and address information specified when this instance was created. + A that contains the display name; otherwise, ("") if no display name information was specified when this instance was created. + + + Compares two mail addresses. + true if the two mail addresses are equal; otherwise, false. + A instance to compare to the current instance. + + + Returns a hash value for a mail address. + An integer hash value. + + + Gets the host portion of the address specified when this instance was created. + A that contains the name of the host computer that accepts e-mail for the property. + + + Returns a string representation of this instance. + A that contains the contents of this . + + + Gets the user information from the address specified when this instance was created. + A that contains the user name portion of the . + + + Store e-mail addresses that are associated with an e-mail message. + + + Initializes an empty instance of the class. + + + Add a list of e-mail addresses to the collection. + The e-mail addresses to add to the . Multiple e-mail addresses must be separated with a comma character (","). + The parameter is null. + The parameter is an empty string. + The parameter contains an e-mail address that is invalid or not supported. + + + Inserts an e-mail address into the , at the specified location. + The location at which to insert the e-mail address that is specified by . + The e-mail address to be inserted into the collection. + The parameter is null. + + + Replaces the element at the specified index. + The index of the e-mail address element to be replaced. + An e-mail address that will replace the element in the collection. + The parameter is null. + + + Returns a string representation of the e-mail addresses in this object. + A containing the e-mail addresses in this collection. + + + Represents an e-mail message that can be sent using the class. + + + Initializes an empty instance of the class. + + + Initializes a new instance of the class by using the specified class objects. + A that contains the address of the sender of the e-mail message. + A that contains the address of the recipient of the e-mail message. + + is null.-or- is null. + + or is malformed. + + + Initializes a new instance of the class by using the specified class objects. + A that contains the address of the sender of the e-mail message. + A that contains the addresses of the recipients of the e-mail message. + + is null.-or- is null. + + is ("").-or- is (""). + + or is malformed. + + + Initializes a new instance of the class. + A that contains the address of the sender of the e-mail message. + A that contains the address of the recipient of the e-mail message. + A that contains the subject text. + A that contains the message body. + + is null.-or- is null. + + is ("").-or- is (""). + + or is malformed. + + + Gets the attachment collection used to store alternate forms of the message body. + A writable . + + + Gets the attachment collection used to store data attached to this e-mail message. + A writable . + + + Gets the address collection that contains the blind carbon copy (BCC) recipients for this e-mail message. + A writable object. + + + Gets or sets the message body. + A value that contains the body text. + + + Gets or sets the encoding used to encode the message body. + An applied to the contents of the . + + + Gets the address collection that contains the carbon copy (CC) recipients for this e-mail message. + A writable object. + + + Gets or sets the delivery notifications for this e-mail message. + A value that contains the delivery notifications for this message. + + + Releases all resources used by the . + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets or sets the from address for this e-mail message. + A that contains the from address information. + + + Gets the e-mail headers that are transmitted with this e-mail message. + A that contains the e-mail headers. + + + Gets or sets the encoding used for the user-defined custom headers for this e-mail message. + The encoding used for user-defined custom headers for this e-mail message. + + + Gets or sets a value indicating whether the mail message body is in Html. + true if the message body is in Html; else false. The default is false. + + + Gets or sets the priority of this e-mail message. + A that contains the priority of this message. + + + Gets or sets the ReplyTo address for the mail message. + A MailAddress that indicates the value of the field. + + + Gets or sets the list of addresses to reply to for the mail message. + The list of the addresses to reply to for the mail message. + + + Gets or sets the sender's address for this e-mail message. + A that contains the sender's address information. + + + Gets or sets the subject line for this e-mail message. + A that contains the subject content. + + + Gets or sets the encoding used for the subject content for this e-mail message. + An that was used to encode the property. + + + Gets the address collection that contains the recipients of this e-mail message. + A writable object. + + + Specifies the priority of a . + + + The email has normal priority. + + + The email has low priority. + + + The email has high priority. + + + Represents the method that will handle the event. + The source of the event. + An containing event data. + + + Specifies the level of access allowed to a Simple Mail Transport Protocol (SMTP) server. + + + No access to an SMTP host. + + + Connection to an SMTP host on the default port (port 25). + + + Connection to an SMTP host on any port. + + + Allows applications to send e-mail by using the Simple Mail Transfer Protocol (SMTP). + + + Initializes a new instance of the class by using configuration file settings. + + + Initializes a new instance of the class that sends e-mail by using the specified SMTP server. + A that contains the name or IP address of the host computer used for SMTP transactions. + + + Initializes a new instance of the class that sends e-mail by using the specified SMTP server and port. + A that contains the name or IP address of the host used for SMTP transactions. + An greater than zero that contains the port to be used on . + + cannot be less than zero. + + + Specify which certificates should be used to establish the Secure Sockets Layer (SSL) connection. + An , holding one or more client certificates. The default value is derived from the mail configuration attributes in a configuration file. + + + Gets or sets the credentials used to authenticate the sender. + An that represents the credentials to use for authentication; or null if no credentials have been specified. + You cannot change the value of this property when an email is being sent. + + + Specifies how outgoing email messages will be handled. + An that indicates how email messages are delivered. + + + Sends a QUIT message to the SMTP server, gracefully ends the TCP connection, and releases all resources used by the current instance of the class. + + + Sends a QUIT message to the SMTP server, gracefully ends the TCP connection, releases all resources used by the current instance of the class, and optionally disposes of the managed resources. + true to release both managed and unmanaged resources; false to releases only unmanaged resources. + + + Specify whether the uses Secure Sockets Layer (SSL) to encrypt the connection. + true if the uses SSL; otherwise, false. The default is false. + + + Gets or sets the name or IP address of the host used for SMTP transactions. + A that contains the name or IP address of the computer to use for SMTP transactions. + The value specified for a set operation is null. + The value specified for a set operation is equal to (""). + You cannot change the value of this property when an email is being sent. + + + Raises the event. + An that contains event data. + + + Gets or sets the folder where applications save mail messages to be processed by the local SMTP server. + A that specifies the pickup directory for mail messages. + + + Gets or sets the port used for SMTP transactions. + An that contains the port number on the SMTP host. The default value is 25. + The value specified for a set operation is less than or equal to zero. + You cannot change the value of this property when an email is being sent. + + + Sends the specified message to an SMTP server for delivery. + A that contains the message to send. + + is null. + This has a call in progress.-or- is null.-or- There are no recipients specified in , , and properties.-or- property is set to and is null.-or- property is set to and is equal to the empty string ("").-or- property is set to and is zero, a negative number, or greater than 65,535. + This object has been disposed. + The connection to the SMTP server failed.-or-Authentication failed.-or-The operation timed out.-or- is set to true but the property is set to or .-or- is set to true, but the SMTP mail server did not advertise STARTTLS in the response to the EHLO command. + The could not be delivered to one or more of the recipients in , , or . + + + Sends the specified e-mail message to an SMTP server for delivery. The message sender, recipients, subject, and message body are specified using objects. + A that contains the address information of the message sender. + A that contains the addresses that the message is sent to. + A that contains the subject line for the message. + A that contains the message body. + + is null.-or- is null. + + is .-or- is . + This has a call in progress.-or- property is set to and is null.-or- property is set to and is equal to the empty string ("").-or- property is set to and is zero, a negative number, or greater than 65,535. + This object has been disposed. + The connection to the SMTP server failed.-or-Authentication failed.-or-The operation timed out.-or- is set to true but the property is set to or .-or- is set to true, but the SMTP mail server did not advertise STARTTLS in the response to the EHLO command. + The message could not be delivered to one or more of the recipients in . + + + Sends the specified e-mail message to an SMTP server for delivery. This method does not block the calling thread and allows the caller to pass an object to the method that is invoked when the operation completes. + A that contains the message to send. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + + is null.-or- is null. + This has a call in progress.-or- There are no recipients specified in , , and properties.-or- property is set to and is null.-or- property is set to and is equal to the empty string ("").-or- property is set to and is zero, a negative number, or greater than 65,535. + This object has been disposed. + The connection to the SMTP server failed.-or-Authentication failed.-or-The operation timed out.-or- is set to true but the property is set to or .-or- is set to true, but the SMTP mail server did not advertise STARTTLS in the response to the EHLO command.-or-The could not be delivered to one or more of the recipients in , , or . + + + Sends an e-mail message to an SMTP server for delivery. The message sender, recipients, subject, and message body are specified using objects. This method does not block the calling thread and allows the caller to pass an object to the method that is invoked when the operation completes. + A that contains the address information of the message sender. + A that contains the address that the message is sent to. + A that contains the subject line for the message. + A that contains the message body. + A user-defined object that is passed to the method invoked when the asynchronous operation completes. + + is null.-or- is null. + + is .-or- is . + This has a call in progress.-or- property is set to and is null.-or- property is set to and is equal to the empty string ("").-or- property is set to and is zero, a negative number, or greater than 65,535. + This object has been disposed. + The connection to the SMTP server failed.-or-Authentication failed.-or-The operation timed out.-or- is set to true but the property is set to or .-or- is set to true, but the SMTP mail server did not advertise STARTTLS in the response to the EHLO command.-or-The message could not be delivered to one or more of the recipients in . + + + Cancels an asynchronous operation to send an e-mail message. + This object has been disposed. + + + Occurs when an asynchronous e-mail send operation completes. + + + Gets the network connection used to transmit the e-mail message. + A that connects to the property used for SMTP. + + is null or the empty string ("").-or- is zero. + + + Gets or sets the Service Provider Name (SPN) to use for authentication when using extended protection. + A that specifies the SPN to use for extended protection. The default value for this SPN is of the form "SMTPSVC/<host>" where <host> is the hostname of the SMTP mail server. + + + Gets or sets a value that specifies the amount of time after which a synchronous call times out. + An that specifies the time-out value in milliseconds. The default value is 100,000 (100 seconds). + The value specified for a set operation was less than zero. + You cannot change the value of this property when an email is being sent. + + + Gets or sets a value that controls whether the are sent with requests. + true if the default credentials are used; otherwise false. The default value is false. + You cannot change the value of this property when an e-mail is being sent. + + + Specifies how email messages are delivered. + + + Email is sent through the network to an SMTP server. + + + Email is copied to the directory specified by the property for delivery by an external application. + + + Email is copied to the pickup directory used by a local Internet Information Services (IIS) for delivery. + + + Represents the exception that is thrown when the is not able to complete a or operation. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified status code. + An value. + + + Initializes a new instance of the class with the specified status code and error message. + An value. + A that describes the error that occurred. + + + Initializes a new instance of the class from the specified instances of the and classes. + A that contains the information required to serialize the new . + A that contains the source and destination of the serialized stream associated with the new instance. + + + Initializes a new instance of the class with the specified error message. + A that describes the error that occurred. + + + Initializes a new instance of the class with the specified error message and inner exception. + A that describes the error that occurred. + The exception that is the cause of the current exception. + + + Populates a instance with the data needed to serialize the . + The to populate with data. + A that specifies the destination for this serialization. + + + Gets the status code returned by an SMTP server when an e-mail message is transmitted. + An value that indicates the error that occurred. + + + Populates a instance with the data needed to serialize the . + A , which holds the serialized data for the . + A that contains the destination of the serialized stream associated with the new . + + + Represents the exception that is thrown when the is not able to complete a or operation to a particular recipient. + + + Initializes an empty instance of the class. + + + Initializes a new instance of the class with the specified status code and e-mail address. + An value. + A that contains the e-mail address. + + + Initializes a new instance of the class with the specified status code, e-mail address, and server response. + An value. + A that contains the e-mail address. + A that contains the server response. + + + Initializes a new instance of the class from the specified instances of the and classes. + A that contains the information required to serialize the new . + A that contains the source and destination of the serialized stream that is associated with the new instance. + + + Initializes a new instance of the class with the specified error message. + A that contains the error message. + + + Initializes a new instance of the class with the specified error message and inner exception. + A that describes the error that occurred. + The exception that is the cause of the current exception. + + + Initializes a new instance of the class with the specified error message, e-mail address, and inner exception. + A that describes the error that occurred. + A that contains the e-mail address. + The exception that is the cause of the current exception. + + + Indicates the e-mail address with delivery difficulties. + A that contains the e-mail address. + + + Populates a instance with the data that is needed to serialize the . + The to populate with data. + A that specifies the destination for this serialization. + + + Populates a instance with the data that is needed to serialize the . + A instance, which holds the serialized data for the . + A instance that contains the destination of the serialized stream that is associated with the new . + + + The exception that is thrown when e-mail is sent using an and cannot be delivered to all recipients. + + + Initializes an empty instance of the class. + + + Initializes a new instance of the class from the specified instances of the and classes. + A instance that contains the information required to serialize the new instance. + A that contains the source of the serialized stream that is associated with the new instance. + + + Initializes a new instance of the class with the specified . + The exception message. + + + Initializes a new instance of the class with the specified and inner . + The exception message. + The inner exception. + + + Initializes a new instance of the class with the specified and array of type . + The exception message. + The array of recipients with delivery errors. + + + Populates a instance with the data that is needed to serialize the . + The to be used. + The to be used. + + + Gets one or more s that indicate the e-mail recipients with SMTP delivery errors. + An array of type that lists the recipients with delivery errors. + + + Initializes a new instance of the class from the specified and instances. + A that contains the information required to serialize the new . + A that contains the source of the serialized stream that is associated with the new . + + + Controls access to Simple Mail Transport Protocol (SMTP) servers. + + + Initializes a new instance of the class with the specified state. + true if the new permission is unrestricted; otherwise, false. + + + Initializes a new instance of the class using the specified access level. + One of the values. + + + Initializes a new instance of the class using the specified permission state value. + One of the values. + + + Gets the level of access to SMTP servers controlled by the permission. + One of the values. + + + Adds the specified access level value to the permission. + One of the values. + + + Creates and returns an identical copy of the current permission. + An that is identical to the current permission. + + + Sets the state of the permission using the specified XML encoding. + The XML encoding to use to set the state of the current permission. + + does not describe an object.-or- does not contain the required state information to reconstruct the permission. + + is null. + + + Creates and returns a permission that is the intersection of the current permission and the specified permission. + An that represents the intersection of the current permission and the specified permission. Returns null if the intersection is empty or is null. + An to intersect with the current permission. It must be of the same type as the current permission. + + is not an . + + + Returns a value indicating whether the current permission is a subset of the specified permission. + true if the current permission is a subset of the specified permission; otherwise, false. + An that is to be tested for the subset relationship. This permission must be of the same type as the current permission. + + is not an . + + + Returns a value indicating whether the current permission is unrestricted. + true if the current permission is unrestricted; otherwise, false. + + + Creates an XML encoding of the state of the permission. + A that contains an XML encoding of the current permission. + + + Creates a permission that is the union of the current permission and the specified permission. + A new permission that represents the union of the current permission and the specified permission. + An to combine with the current permission. + + is not an . + + + Controls access to Simple Mail Transport Protocol (SMTP) servers. + + + Initializes a new instance of the class. + One of the values that specifies the permission behavior. + + is not a valid . + + + Gets or sets the level of access to SMTP servers controlled by the attribute. + A value. Valid values are "Connect" and "None". + + + Creates a permission object that can be stored with the in an assembly's metadata. + An instance. + + + Specifies the outcome of sending e-mail by using the class. + + + A system status or system Help reply. + + + A Help message was returned by the service. + + + The SMTP service is ready. + + + The SMTP service is closing the transmission channel. + + + The email was successfully sent to the SMTP service. + + + The user mailbox is not located on the receiving server; the server forwards the e-mail. + + + The specified user is not local, but the receiving SMTP service accepted the message and attempted to deliver it. This status code is defined in RFC 1123, which is available at http://www.ietf.org. + + + The SMTP service is ready to receive the e-mail content. + + + The SMTP service is not available; the server is closing the transmission channel. + + + The destination mailbox is in use. + + + The SMTP service cannot complete the request. This error can occur if the client's IP address cannot be resolved (that is, a reverse lookup failed). You can also receive this error if the client domain has been identified as an open relay or source for unsolicited e-mail (spam). For details, see RFC 2505, which is available at http://www.ietf.org. + + + The SMTP service does not have sufficient storage to complete the request. + + + The client was not authenticated or is not allowed to send mail using the specified SMTP host. + + + The SMTP service does not recognize the specified command. + + + The syntax used to specify a command or parameter is incorrect. + + + The SMTP service does not implement the specified command. + + + The commands were sent in the incorrect sequence. + + + The SMTP server is configured to accept only TLS connections, and the SMTP client is attempting to connect by using a non-TLS connection. The solution is for the user to set EnableSsl=true on the SMTP Client. + + + The SMTP service does not implement the specified command parameter. + + + The destination mailbox was not found or could not be accessed. + + + The user mailbox is not located on the receiving server. You should resend using the supplied address information. + + + The message is too large to be stored in the destination mailbox. + + + The syntax used to specify the destination mailbox is incorrect. + + + The transaction failed. + + + The transaction could not occur. You receive this error when the specified SMTP host cannot be found. + + + Represents a MIME protocol Content-Disposition header. + + + Initializes a new instance of the class with a of . + + + Initializes a new instance of the class with the specified disposition information. + A value that contains the disposition. + + is null or equal to (""). + + + Gets or sets the creation date for a file attachment. + A value that indicates the file creation date; otherwise, if no date was specified. + + + Gets or sets the disposition type for an e-mail attachment. + A that contains the disposition type. The value is not restricted but is typically one of the values. + The value specified for a set operation is null. + The value specified for a set operation is equal to (""). + + + Determines whether the content-disposition header of the specified object is equal to the content-disposition header of this object. + true if the content-disposition headers are the same; otherwise false. + The object to compare with this object. + + + Gets or sets the suggested file name for an e-mail attachment. + A that contains the file name. + + + Determines the hash code of the specified object + An integer hash value. + + + Gets or sets a value that determines the disposition type (Inline or Attachment) for an e-mail attachment. + true if content in the attachment is presented inline as part of the e-mail body; otherwise, false. + + + Gets or sets the modification date for a file attachment. + A value that indicates the file modification date; otherwise, if no date was specified. + + + Gets the parameters included in the Content-Disposition header represented by this instance. + A writable that contains parameter name/value pairs. + + + Gets or sets the read date for a file attachment. + A value that indicates the file read date; otherwise, if no date was specified. + + + Gets or sets the size of a file attachment. + A that specifies the number of bytes in the file attachment. The default value is -1, which indicates that the file size is unknown. + + + Returns a representation of this instance. + A that contains the property values for this instance. + + + Represents a MIME protocol Content-Type header. + + + Initializes a new default instance of the class. + + + Initializes a new instance of the class using the specified string. + A , for example, "text/plain; charset=us-ascii", that contains the MIME media type, subtype, and optional parameters. + + is null. + + is (""). + + is in a form that cannot be parsed. + + + Gets or sets the value of the boundary parameter included in the Content-Type header represented by this instance. + A that contains the value associated with the boundary parameter. + + + Gets or sets the value of the charset parameter included in the Content-Type header represented by this instance. + A that contains the value associated with the charset parameter. + + + Determines whether the content-type header of the specified object is equal to the content-type header of this object. + true if the content-type headers are the same; otherwise false. + The object to compare with this object. + + + Determines the hash code of the specified object + An integer hash value. + + + Gets or sets the media type value included in the Content-Type header represented by this instance. + A that contains the media type and subtype value. This value does not include the semicolon (;) separator that follows the subtype. + The value specified for a set operation is null. + The value specified for a set operation is (""). + The value specified for a set operation is in a form that cannot be parsed. + + + Gets or sets the value of the name parameter included in the Content-Type header represented by this instance. + A that contains the value associated with the name parameter. + + + Gets the dictionary that contains the parameters included in the Content-Type header represented by this instance. + A writable that contains name and value pairs. + + + Returns a string representation of this object. + A that contains the current settings for this . + + + Supplies the strings used to specify the disposition type for an e-mail attachment. + + + Specifies that the attachment is to be displayed as a file attached to the e-mail message. + + + Specifies that the attachment is to be displayed as part of the e-mail message body. + + + Specifies the media type information for an e-mail message attachment. + + + Specifies the kind of application data in an e-mail message attachment. + + + Specifies that the data is not interpreted. + + + Specifies that the data is in Portable Document Format (PDF). + + + Specifies that the data is in Rich Text Format (RTF). + + + Specifies that the data is a SOAP document. + + + Specifies that the data is compressed. + + + Specifies the type of image data in an e-mail message attachment. + + + Specifies that the data is in Graphics Interchange Format (GIF). + + + Specifies that the data is in Joint Photographic Experts Group (JPEG) format. + + + Specifies that the data is in Tagged Image File Format (TIFF). + + + Specifies the type of text data in an e-mail message attachment. + + + Specifies that the data is in HTML format. + + + Specifies that the data is in plain text format. + + + Specifies that the data is in Rich Text Format (RTF). + + + Specifies that the data is in XML format. + + + Specifies the Content-Transfer-Encoding header information for an e-mail message attachment. + + + Encodes data that consists of printable characters in the US-ASCII character set. See RFC 2406 Section 6.7. + + + Encodes stream-based data. See RFC 2406 Section 6.8. + + + Used for data that is not encoded. The data is in 7-bit US-ASCII characters with a total line length of no longer than 1000 characters. See RFC2406 Section 2.7. + + + Indicates that the transfer encoding is unknown. + + + Specifies the current state of an IP address. + + + The address is not valid. A nonvalid address is expired and no longer assigned to an interface; applications should not send data packets to it. + + + The duplicate address detection procedure's evaluation of the address has not completed successfully. Applications should not use the address because it is not yet valid and packets sent to it are discarded. + + + The address is not unique. This address should not be assigned to the network interface. + + + The address is valid, but it is nearing its lease lifetime and should not be used by applications. + + + The address is valid and its use is unrestricted. + + + Represents the IP address of the network gateway. This class cannot be instantiated. + + + Initializes the members of this class. + + + Get the IP address of the gateway. + An object that contains the IP address of the gateway. + + + Stores a set of types. + + + Initializes a new instance of the class. + + + Throws a because this operation is not supported for this collection. + The object to be added to the collection. + + + Throws a because this operation is not supported for this collection. + + + Checks whether the collection contains the specified object. + true if the object exists in the collection; otherwise false. + The object to be searched in the collection. + + + Copies the elements in this collection to a one-dimensional array of type . + A one-dimensional array that receives a copy of the collection. + The zero-based index in at which the copy begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in this is greater than the available space from to the end of the destination . + The elements in this cannot be cast automatically to the type of the destination . + + + Gets the number of types in this collection. + An value that contains the number of types in this collection. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Gets a value that indicates whether access to this collection is read-only. + true in all cases. + + + Gets the at the specific index of the collection. + The at the specific index in the collection. + The index of interest. + + + Throws a because this operation is not supported for this collection. + Always throws a . + The object to be removed. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Provides Internet Control Message Protocol for IPv4 (ICMPv4) statistical data for the local computer. + + + Initializes a new instance of the class. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Address Mask Reply messages that were received. + An value that specifies the total number of Address Mask Reply messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Address Mask Reply messages that were sent. + An value that specifies the total number of Address Mask Reply messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Address Mask Request messages that were received. + An value that specifies the total number of Address Mask Request messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Address Mask Request messages that were sent. + An value that specifies the total number of Address Mask Request messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) messages that were received because of a packet having an unreachable address in its destination. + An value that specifies the total number of Destination Unreachable messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) messages that were sent because of a packet having an unreachable address in its destination. + An value that specifies the total number of Destination Unreachable messages sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Echo Reply messages that were received. + An value that specifies the total number of number of ICMP Echo Reply messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Echo Reply messages that were sent. + An value that specifies the total number of number of ICMP Echo Reply messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Echo Request messages that were received. + An value that specifies the total number of number of ICMP Echo Request messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Echo Request messages that were sent. + An value that specifies the total number of number of ICMP Echo Request messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) error messages that were received. + An value that specifies the total number of ICMP error messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) error messages that were sent. + An value that specifies the total number of number of ICMP error messages that were sent. + + + Gets the number of Internet Control Message Protocol messages that were received. + An value that specifies the total number of ICMPv4 messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) messages that were sent. + An value that specifies the total number of ICMPv4 messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Parameter Problem messages that were received. + An value that specifies the total number of ICMP Parameter Problem messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Parameter Problem messages that were sent. + An value that specifies the total number of ICMP Parameter Problem messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Redirect messages that were received. + An value that specifies the total number of ICMP Redirect messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Redirect messages that were sent. + An value that specifies the total number of ICMP Redirect messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Source Quench messages that were received. + An value that specifies the total number of Source Quench messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Source Quench messages that were sent. + An value that specifies the total number of Source Quench messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Time Exceeded messages that were received. + An value that specifies the total number of ICMP Time Exceeded messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Time Exceeded messages that were sent. + An value that specifies the total number of ICMP Time Exceeded messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Timestamp Reply messages that were received. + An value that specifies the total number of Timestamp Reply messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Timestamp Reply messages that were sent. + An value that specifies the total number of Timestamp Reply messages that were sent. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Timestamp Request messages that were received. + An value that specifies the total number of Timestamp Request messages that were received. + + + Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Timestamp Request messages that were sent. + An value that specifies the total number of Timestamp Request messages that were sent. + + + Provides Internet Control Message Protocol for Internet Protocol version 6 (ICMPv6) statistical data for the local computer. + + + Initializes a new instance of the class. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) messages received because of a packet having an unreachable address in its destination. + An value that specifies the total number of Destination Unreachable messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) messages sent because of a packet having an unreachable address in its destination. + An value that specifies the total number of Destination Unreachable messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Echo Reply messages received. + An value that specifies the total number of number of ICMP Echo Reply messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Echo Reply messages sent. + An value that specifies the total number of number of ICMP Echo Reply messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Echo Request messages received. + An value that specifies the total number of number of ICMP Echo Request messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Echo Request messages sent. + An value that specifies the total number of number of ICMP Echo Request messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) error messages received. + An value that specifies the total number of ICMP error messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) error messages sent. + An value that specifies the total number of ICMP error messages sent. + + + Gets the number of Internet Group management Protocol (IGMP) Group Membership Query messages received. + An value that specifies the total number of Group Membership Query messages received. + + + Gets the number of Internet Group management Protocol (IGMP) Group Membership Query messages sent. + An value that specifies the total number of Group Membership Query messages sent. + + + Gets the number of Internet Group Management Protocol (IGMP) Group Membership Reduction messages received. + An value that specifies the total number of Group Membership Reduction messages received. + + + Gets the number of Internet Group Management Protocol (IGMP) Group Membership Reduction messages sent. + An value that specifies the total number of Group Membership Reduction messages sent. + + + Gets the number of Internet Group Management Protocol (IGMP) Group Membership Report messages received. + An value that specifies the total number of Group Membership Report messages received. + + + Gets the number of Internet Group Management Protocol (IGMP) Group Membership Report messages sent. + An value that specifies the total number of Group Membership Report messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) messages received. + An value that specifies the total number of ICMPv6 messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) messages sent. + An value that specifies the total number of ICMPv6 messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Neighbor Advertisement messages received. + An value that specifies the total number of ICMP Neighbor Advertisement messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Neighbor Advertisement messages sent. + An value that specifies the total number of Neighbor Advertisement messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Neighbor Solicitation messages received. + An value that specifies the total number of Neighbor Solicitation messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Neighbor Solicitation messages sent. + An value that specifies the total number of Neighbor Solicitation messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Packet Too Big messages received. + An value that specifies the total number of ICMP Packet Too Big messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Packet Too Big messages sent. + An value that specifies the total number of ICMP Packet Too Big messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Parameter Problem messages received. + An value that specifies the total number of ICMP Parameter Problem messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Parameter Problem messages sent. + An value that specifies the total number of ICMP Parameter Problem messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Redirect messages received. + An value that specifies the total number of ICMP Redirect messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Redirect messages sent. + An value that specifies the total number of ICMP Redirect messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Router Advertisement messages received. + An value that specifies the total number of Router Advertisement messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Router Advertisement messages sent. + An value that specifies the total number of Router Advertisement messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Router Solicitation messages received. + An value that specifies the total number of Router Solicitation messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Router Solicitation messages sent. + An value that specifies the total number of Router Solicitation messages sent. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Time Exceeded messages received. + An value that specifies the total number of ICMP Time Exceeded messages received. + + + Gets the number of Internet Control Message Protocol version 6 (ICMPv6) Time Exceeded messages sent. + An value that specifies the total number of ICMP Time Exceeded messages sent. + + + Stores a set of types. + + + Initializes a new instance of the class. + + + Throws a because this operation is not supported for this collection. + The object to be added to the collection. + + + Throws a because this operation is not supported for this collection. + + + Checks whether the collection contains the specified object. + true if the object exists in the collection; otherwise, false. + The object to be searched in the collection. + + + Copies the elements in this collection to a one-dimensional array of type . + A one-dimensional array that receives a copy of the collection. + The zero-based index in at which the copy begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in this is greater than the available space from to the end of the destination . + The elements in this cannot be cast automatically to the type of the destination . + + + Gets the number of types in this collection. + An value that contains the number of types in this collection. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Gets a value that indicates whether access to this collection is read-only. + true in all cases. + + + Gets the at the specific index of the collection. + The at the specific index in the collection. + The index of interest. + + + Throws a because this operation is not supported for this collection. + Always throws a . + The object to be removed. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Provides information about a network interface address. + + + Initializes a new instance of the class. + + + Gets the Internet Protocol (IP) address. + An instance that contains the IP address of an interface. + + + Gets a value that indicates whether the Internet Protocol (IP) address is valid to appear in a Domain Name System (DNS) server database. + true if the address can appear in a DNS database; otherwise, false. + + + Gets a value that indicates whether the Internet Protocol (IP) address is transient (a cluster address). + true if the address is transient; otherwise, false. + + + Stores a set of types. + + + Throws a because this operation is not supported for this collection. + The object to be added to the collection. + + + Throws a because this operation is not supported for this collection. + + + Checks whether the collection contains the specified object. + true if the object exists in the collection; otherwise. false. + The object to be searched in the collection. + + + Copies the collection to the specified array. + A one-dimensional array that receives a copy of the collection. + The zero-based index in at which the copy begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in this is greater than the available space from to the end of the destination . + The elements in this cannot be cast automatically to the type of the destination . + + + Gets the number of types in this collection. + An value that contains the number of types in this collection. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Gets a value that indicates whether access to this collection is read-only. + true in all cases. + + + Gets the at the specified index in the collection. + The at the specified location. + The zero-based index of the element. + + + Throws a because this operation is not supported for this collection. + Always throws a . + The object to be removed. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Provides information about the network connectivity of the local computer. + + + Initializes a new instance of the class. + + + Begins an asynchronous request to retrieve the stable unicast IP address table on the local computer. + An that references the asynchronous request. + The delegate. + An object that contains state information for this request. + This method is not implemented on the platform. This method uses the native NotifyStableUnicastIpAddressTable function that is supported on Windows Vista and later. + The call to the native NotifyStableUnicastIpAddressTable function failed. + + + Gets the Dynamic Host Configuration Protocol (DHCP) scope name. + A instance that contains the computer's DHCP scope name. + A Win32 function call failed. + + + Gets the domain in which the local computer is registered. + A instance that contains the computer's domain name. If the computer does not belong to a domain, returns . + A Win32 function call failed. + + + Ends a pending asynchronous request to retrieve the stable unicast IP address table on the local computer. + An that stores state information and any user defined data for this asynchronous operation. + An that references the asynchronous request. + The call to the native GetAdaptersAddresses function failed. + This method is not implemented on the platform. This method uses the native NotifyStableUnicastIpAddressTable function that is supported on Windows Vista and later. + The caller does not have necessary permission. + + + Returns information about the Internet Protocol version 4 (IPv4) and IPv6 Transmission Control Protocol (TCP) connections on the local computer. + A array that contains objects that describe the active TCP connections, or an empty array if no active TCP connections are detected. + The Win32 function GetTcpTable failed. + + + Returns endpoint information about the Internet Protocol version 4 (IPv4) and IPv6 Transmission Control Protocol (TCP) listeners on the local computer. + A array that contains objects that describe the active TCP listeners, or an empty array, if no active TCP listeners are detected. + The Win32 function GetTcpTable failed. + + + Returns information about the Internet Protocol version 4 (IPv4) and IPv6 User Datagram Protocol (UDP) listeners on the local computer. + An array that contains objects that describe the UDP listeners, or an empty array if no UDP listeners are detected. + The call to the Win32 function GetUdpTable failed. + + + Provides Internet Control Message Protocol (ICMP) version 4 statistical data for the local computer. + An object that provides ICMP version 4 traffic statistics for the local computer. + The Win32 function GetIcmpStatistics failed. + + + Provides Internet Control Message Protocol (ICMP) version 6 statistical data for the local computer. + An object that provides ICMP version 6 traffic statistics for the local computer. + The Win32 function GetIcmpStatisticsEx failed. + The local computer's operating system is not Windows XP or later. + + + Gets an object that provides information about the local computer's network connectivity and traffic statistics. + A object that contains information about the local computer. + + + + + + Provides Internet Protocol version 4 (IPv4) statistical data for the local computer. + An object that provides IPv4 traffic statistics for the local computer. + The call to the Win32 function GetIpStatistics failed. + + + Provides Internet Protocol version 6 (IPv6) statistical data for the local computer. + An object that provides IPv6 traffic statistics for the local computer. + The call to the Win32 function GetIpStatistics failed. + The local computer is not running an operating system that supports IPv6. + + + Provides Transmission Control Protocol/Internet Protocol version 4 (TCP/IPv4) statistical data for the local computer. + A object that provides TCP/IPv4 traffic statistics for the local computer. + The call to the Win32 function GetTcpStatistics failed. + + + Provides Transmission Control Protocol/Internet Protocol version 6 (TCP/IPv6) statistical data for the local computer. + A object that provides TCP/IPv6 traffic statistics for the local computer. + The call to the Win32 function GetTcpStatistics failed. + The local computer is not running an operating system that supports IPv6. + + + Provides User Datagram Protocol/Internet Protocol version 4 (UDP/IPv4) statistical data for the local computer. + A object that provides UDP/IPv4 traffic statistics for the local computer. + The call to the Win32 function GetUdpStatistics failed. + + + Provides User Datagram Protocol/Internet Protocol version 6 (UDP/IPv6) statistical data for the local computer. + A object that provides UDP/IPv6 traffic statistics for the local computer. + The call to the Win32 function GetUdpStatistics failed. + The local computer is not running an operating system that supports IPv6. + + + Retrieves the stable unicast IP address table on the local computer. + A that contains a list of stable unicast IP addresses on the local computer. + The call to the native GetAdaptersAddresses function failed. + This method is not implemented on the platform. This method uses the native NotifyStableUnicastIpAddressTable function that is supported on Windows Vista and later. + The caller does not have necessary permission. + The call to the native NotifyStableUnicastIpAddressTable function failed. + + + Gets the host name for the local computer. + A instance that contains the computer's NetBIOS name. + A Win32 function call failed. + + + Gets a value that specifies whether the local computer is acting as a Windows Internet Name Service (WINS) proxy. + true if the local computer is a WINS proxy; otherwise, false. + A Win32 function call failed. + + + Gets the Network Basic Input/Output System (NetBIOS) node type of the local computer. + A value. + A Win32 function call failed. + + + Provides Internet Protocol (IP) statistical data. + + + Initializes a new instance of the class. + + + Gets the default time-to-live (TTL) value for Internet Protocol (IP) packets. + An value that specifies the TTL. + + + Gets a value that specifies whether Internet Protocol (IP) packet forwarding is enabled. + A value that specifies whether packet forwarding is enabled. + + + Gets the number of network interfaces. + An value containing the number of network interfaces for the address family used to obtain this instance. + + + Gets the number of Internet Protocol (IP) addresses assigned to the local computer. + An value that indicates the number of IP addresses assigned to the address family (Internet Protocol version 4 or Internet Protocol version 6) described by this object. + + + Gets the number of routes in the Internet Protocol (IP) routing table. + An value that specifies the total number of routes in the routing table. + + + Gets the number of outbound Internet Protocol (IP) packets. + An value that specifies the total number of outgoing packets. + + + Gets the number of routes that have been discarded from the routing table. + An value that specifies the total number of valid routes that have been discarded. + + + Gets the number of transmitted Internet Protocol (IP) packets that have been discarded. + An value that specifies the total number of outgoing packets that have been discarded. + + + Gets the number of Internet Protocol (IP) packets for which the local computer could not determine a route to the destination address. + An value that specifies the number of packets that could not be sent because a route could not be found. + + + Gets the number of Internet Protocol (IP) packets that could not be fragmented. + An value that specifies the total number of packets that required fragmentation but had the "Don't Fragment" bit set. + + + Gets the number of Internet Protocol (IP) packets that required reassembly. + An value that specifies the total number of packet reassemblies required. + + + Gets the number of Internet Protocol (IP) packets that were not successfully reassembled. + An value that specifies the total number of packets that could not be reassembled. + + + Gets the maximum amount of time within which all fragments of an Internet Protocol (IP) packet must arrive. + An value that specifies the maximum number of milliseconds within which all fragments of a packet must arrive to avoid being discarded. + + + Gets the number of Internet Protocol (IP) packets fragmented. + An value that specifies the total number of fragmented packets. + + + Gets the number of Internet Protocol (IP) packets reassembled. + An value that specifies the total number of fragmented packets that have been successfully reassembled. + + + Gets the number of Internet Protocol (IP) packets received. + An value that specifies the total number of IP packets received. + + + Gets the number of Internet Protocol (IP) packets delivered. + An value that specifies the total number of IP packets delivered. + + + Gets the number of Internet Protocol (IP) packets that have been received and discarded. + An value that specifies the total number of incoming packets that have been discarded. + + + Gets the number of Internet Protocol (IP) packets forwarded. + An value that specifies the total number of forwarded packets. + + + Gets the number of Internet Protocol (IP) packets with address errors that were received. + An value that specifies the total number of IP packets received with errors in the address portion of the header. + + + Gets the number of Internet Protocol (IP) packets with header errors that were received. + An value that specifies the total number of IP packets received and discarded due to errors in the header. + + + Gets the number of Internet Protocol (IP) packets received on the local machine with an unknown protocol in the header. + An value that indicates the total number of IP packets received with an unknown protocol. + + + Provides information about network interfaces that support Internet Protocol version 4 (IPv4) or Internet Protocol version 6 (IPv6). + + + Initializes a new instance of the class. + + + Gets the anycast IP addresses assigned to this interface. + An that contains the anycast addresses for this interface. + + + Gets the addresses of Dynamic Host Configuration Protocol (DHCP) servers for this interface. + An that contains the address information for DHCP servers, or an empty array if no servers are found. + + + Gets the addresses of Domain Name System (DNS) servers for this interface. + A that contains the DNS server addresses. + + + Gets the Domain Name System (DNS) suffix associated with this interface. + A that contains the DNS suffix for this interface, or if there is no DNS suffix for the interface. + This property is not valid on computers running operating systems earlier than Windows 2000. + + + Gets the IPv4 network gateway addresses for this interface. + An that contains the address information for network gateways, or an empty array if no gateways are found. + + + Provides Internet Protocol version 4 (IPv4) configuration data for this network interface. + An object that contains IPv4 configuration data, or null if no data is available for the interface. + The interface does not support the IPv4 protocol. + + + Provides Internet Protocol version 6 (IPv6) configuration data for this network interface. + An object that contains IPv6 configuration data. + The interface does not support the IPv6 protocol. + + + Gets a value that indicates whether NetBt is configured to use DNS name resolution on this interface. + true if NetBt is configured to use DNS name resolution on this interface; otherwise, false. + + + Gets a value that indicates whether this interface is configured to automatically register its IP address information with the Domain Name System (DNS). + true if this interface is configured to automatically register a mapping between its dynamic IP address and static domain names; otherwise, false. + + + Gets the multicast addresses assigned to this interface. + An that contains the multicast addresses for this interface. + + + Gets the unicast addresses assigned to this interface. + An that contains the unicast addresses for this interface. + + + Gets the addresses of Windows Internet Name Service (WINS) servers. + An that contains the address information for WINS servers, or an empty array if no servers are found. + + + Reports the status of sending an Internet Control Message Protocol (ICMP) echo message to a computer. + + + The ICMP echo request succeeded; an ICMP echo reply was received. When you get this status code, the other properties contain valid data. + + + The ICMP echo request failed because the network that contains the destination computer is not reachable. + + + The ICMP echo request failed because the destination computer is not reachable. + + + The ICMP echo request failed because the destination computer that is specified in an ICMP echo message is not reachable, because it does not support the packet's protocol. + + + The ICMP echo request failed because the port on the destination computer is not available. + + + The ICMP echo request failed because contact with the destination computer is administratively prohibited. + + + The ICMP echo request failed because of insufficient network resources. + + + The ICMP echo request failed because it contains an invalid option. + + + The ICMP echo request failed because of a hardware error. + + + The ICMP echo request failed because the packet containing the request is larger than the maximum transmission unit (MTU) of a node (router or gateway) located between the source and destination. The MTU defines the maximum size of a transmittable packet. + + + The ICMP echo Reply was not received within the allotted time. The default time allowed for replies is 5 seconds. You can change this value using the or methods that take a parameter. + + + The ICMP echo request failed because there is no valid route between the source and destination computers. + + + The ICMP echo request failed because its Time to Live (TTL) value reached zero, causing the forwarding node (router or gateway) to discard the packet. + + + The ICMP echo request failed because the packet was divided into fragments for transmission and all of the fragments were not received within the time allotted for reassembly. RFC 2460 (available at www.ietf.org) specifies 60 seconds as the time limit within which all packet fragments must be received. + + + The ICMP echo request failed because a node (router or gateway) encountered problems while processing the packet header. This is the status if, for example, the header contains invalid field data or an unrecognized option. + + + The ICMP echo request failed because the packet was discarded. This occurs when the source computer's output queue has insufficient storage space, or when packets arrive at the destination too quickly to be processed. + + + The ICMP echo request failed because the destination IP address cannot receive ICMP echo requests or should never appear in the destination address field of any IP datagram. For example, calling and specifying IP address "000.0.0.0" returns this status. + + + The ICMP echo request failed because the destination computer that is specified in an ICMP echo message is not reachable; the exact cause of problem is unknown. + + + The ICMP echo request failed because its Time to Live (TTL) value reached zero, causing the forwarding node (router or gateway) to discard the packet. + + + The ICMP echo request failed because the header is invalid. + + + The ICMP echo request failed because the Next Header field does not contain a recognized value. The Next Header field indicates the extension header type (if present) or the protocol above the IP layer, for example, TCP or UDP. + + + The ICMP echo request failed because of an ICMP protocol error. + + + The ICMP echo request failed because the source address and destination address that are specified in an ICMP echo message are not in the same scope. This is typically caused by a router forwarding a packet using an interface that is outside the scope of the source address. Address scopes (link-local, site-local, and global scope) determine where on the network an address is valid. + + + The ICMP echo request failed for an unknown reason. + + + Provides information about network interfaces that support Internet Protocol version 4 (IPv4). + + + Initializes a new instance of the class. + + + Gets the index of the network interface associated with the Internet Protocol version 4 (IPv4) address. + An that contains the index of the IPv4 interface. + + + Gets a value that indicates whether this interface has an automatic private IP addressing (APIPA) address. + true if the interface uses an APIPA address; otherwise, false. + + + Gets a value that indicates whether this interface has automatic private IP addressing (APIPA) enabled. + true if the interface uses APIPA; otherwise, false. + + + Gets a value that indicates whether the interface is configured to use a Dynamic Host Configuration Protocol (DHCP) server to obtain an IP address. + true if the interface is configured to obtain an IP address from a DHCP server; otherwise, false. + + + Gets a value that indicates whether this interface can forward (route) packets. + true if this interface routes packets; otherwise false. + + + Gets the maximum transmission unit (MTU) for this network interface. + An value that specifies the MTU. + + + Gets a value that indicates whether an interface uses Windows Internet Name Service (WINS). + true if the interface uses WINS; otherwise, false. + + + Provides statistical data for a network interface on the local computer. + + + Initializes a new instance of the class. + + + Gets the number of bytes that were received on the interface. + An value that specifies the total number of bytes that were received on the interface. + + + Gets the number of bytes that were sent on the interface. + An value that specifies the total number of bytes that were transmitted on the interface. + + + Gets the number of incoming packets that were discarded. + An value that specifies the total number of discarded incoming packets. + + + Gets the number of incoming packets with errors. + An value that specifies the total number of incoming packets with errors. + + + Gets the number of incoming packets with an unknown protocol. + An value that specifies the total number of incoming packets with an unknown protocol. + + + Gets the number of non-unicast packets that were received on the interface. + An value that specifies the total number of non-unicast packets that were received on the interface. + + + Gets the number of non-unicast packets that were sent on the interface. + An value that specifies the total number of non-unicast packets that were sent on the interface. + + + Gets the number of outgoing packets that were discarded. + An value that specifies the total number of discarded outgoing packets. + + + Gets the number of outgoing packets with errors. + An value that specifies the total number of outgoing packets with errors. + + + Gets the length of the output queue. + An value that specifies the total number of packets in the output queue. + + + Gets the number of unicast packets that were received on the interface. + An value that specifies the total number of unicast packets that were received on the interface. + + + Gets the number of unicast packets that were sent on the interface. + An value that specifies the total number of unicast packets that were sent on the interface. + + + Provides information about network interfaces that support Internet Protocol version 6 (IPv6). + + + Initializes a new instance of the class. + + + Gets the index of the network interface associated with an Internet Protocol version 6 (IPv6) address. + An value that contains the index of the network interface for IPv6 address. + + + Gets the maximum transmission unit (MTU) for this network interface. + An value that specifies the MTU. + + + Provides information about a network interface's multicast address. + + + Initializes a new instance of the class. + + + Gets the number of seconds remaining during which this address is the preferred address. + An value that specifies the number of seconds left for this address to remain preferred. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Gets the number of seconds remaining during which this address is valid. + An value that specifies the number of seconds left for this address to remain assigned. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Specifies the amount of time remaining on the Dynamic Host Configuration Protocol (DHCP) lease for this IP address. + An value that contains the number of seconds remaining before the computer must release the instance. + + + Gets a value that indicates the state of the duplicate address detection algorithm. + One of the values that indicates the progress of the algorithm in determining the uniqueness of this IP address. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Gets a value that identifies the source of a Multicast Internet Protocol (IP) address prefix. + One of the values that identifies how the prefix information was obtained. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Gets a value that identifies the source of a Multicast Internet Protocol (IP) address suffix. + One of the values that identifies how the suffix information was obtained. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Stores a set of types. + + + Initializes a new instance of the class. + + + Throws a because the collection is read-only and elements cannot be added to the collection. + The object to be added to the collection. + + + Throws a because the collection is read-only and elements cannot be removed. + + + Checks whether the collection contains the specified object. + true if the object exists in the collection; otherwise, false. + The object to be searched in the collection. + + + Copies the elements in this collection to a one-dimensional array of type . + A one-dimensional array that receives a copy of the collection. + The zero-based index in at which the copy begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in this is greater than the available space from to the end of the destination . + The elements in this cannot be cast automatically to the type of the destination . + + + Gets the number of types in this collection. + An value that contains the number of types in this collection. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Gets a value that indicates whether access to this collection is read-only. + true in all cases. + + + Gets the at the specific index of the collection. + The at the specific index in the collection. + The index of interest. + + + Throws a because the collection is read-only and elements cannot be removed. + Always throws a . + The object to be removed. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Specifies the Network Basic Input/Output System (NetBIOS) node type. + + + An unknown node type. + + + A broadcast node. + + + A peer-to-peer node. + + + A mixed node. + + + A hybrid node. + + + References one or more methods to be called when the address of a network interface changes. + The source of the event. + An object that contains data about the event. + + + References one or more methods to be called when the availability of the network changes. + The source of the event. + An object that contains data about the event. + + + Provides data for the event. + + + Gets the current status of the network connection. + true if the network is available; otherwise, false. + + + Allows applications to receive notification when the Internet Protocol (IP) address of a network interface, also called a network card or adapter, changes. + + + Occurs when the IP address of a network interface changes. + + + Occurs when the availability of the network changes. + + + Specifies permission to access information about network interfaces and traffic statistics. + + + No access to network information. + + + Read access to network information. + + + Ping access to network information. + + + The exception that is thrown when an error occurs while retrieving network information. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified error code. + A Win32 error code. + + + Initializes a new instance of the class with serialized data. + A SerializationInfo object that contains the serialized exception data. + A StreamingContext that contains contextual information about the serialized exception. + + + Gets the Win32 error code for this exception. + An value that contains the Win32 error code. + + + Controls access to network information and traffic statistics for the local computer. This class cannot be inherited. + + + Initializes a new instance of the class using the specified value. + One of the values. + + + Initializes a new instance of the class with the specified . + One of the values. + + + Gets the level of access to network information controlled by this permission. + One of the values. + + + Adds the specified value to this permission. + One of the values. + + + Creates and returns an identical copy of this permission. + A that is identical to the current permission + + + Sets the state of this permission using the specified XML encoding. + A that contains the XML encoding to use to set the state of the current permission + + is null. + + is not a permission encoding.-or- is not an encoding of a . -or- has invalid values. + + + Creates and returns a permission that is the intersection of the current permission and the specified permission. + A that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty or is null. + An to intersect with the current permission. It must be of the same type as the current permission. + + is not a . + + + Determines whether the current permission is a subset of the specified permission. + true if the current permission is a subset of the specified permission; otherwise, false. + An that is to be tested for the subset relationship. This permission must be of the same type as the current permission + + + Returns a value indicating whether the current permission is unrestricted. + true if the current permission is unrestricted; otherwise, false. + + + Creates an XML encoding of the state of this permission. + A that contains the XML encoding of the current permission. + + + Creates a permission that is the union of this permission and the specified permission. + A new permission that represents the union of the current permission and the specified permission. + A permission to combine with the current permission. + + + Allows security actions for to be applied to code using declarative security. + + + Initializes a new instance of the class. + A value that specifies the permission behavior. + + + Gets or sets the network information access level. + A string that specifies the access level. + + + Creates and returns a new object. + A that corresponds to this attribute. + + + + + + Provides configuration and statistical information for a network interface. + + + Initializes a new instance of the class. + + + Gets the description of the interface. + A that describes this interface. + + + Returns objects that describe the network interfaces on the local computer. + A array that contains objects that describe the available network interfaces, or an empty array if no interfaces are detected. + A Windows system function call failed. + + + + + + + + + Returns an object that describes the configuration of this network interface. + An object that describes this network interface. + + + Gets the IPv4 statistics. + An object. + + + Indicates whether any network connection is available. + true if a network connection is available; otherwise, false. + + + Returns the Media Access Control (MAC) or physical address for this adapter. + A object that contains the physical address. + + + Gets the identifier of the network adapter. + A that contains the identifier. + + + Gets a value that indicates whether the network interface is set to only receive data packets. + true if the interface only receives network traffic; otherwise, false. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Gets the index of the IPv4 loopback interface. + A that contains the index for the IPv4 loopback interface. + This property is not valid on computers running only Ipv6. + + + Gets the name of the network adapter. + A that contains the adapter name. + + + Gets the interface type. + An value that specifies the network interface type. + + + Gets the current operational state of the network connection. + One of the values. + + + Gets the speed of the network interface. + A value that specifies the speed in bits per second. + + + Gets a value that indicates whether the interface supports the specified protocol. + true if the specified protocol is supported; otherwise, false. + A value. + + + Gets a value that indicates whether the network interface is enabled to receive multicast packets. + true if the interface receives multicast packets; otherwise, false. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Specifies the Internet Protocol versions that are supported by a network interface. + + + Internet Protocol version 4. + + + Internet Protocol version 6. + + + Specifies types of network interfaces. + + + The interface type is not known. + + + The network interface uses an Ethernet connection. Ethernet is defined in IEEE standard 802.3. + + + The network interface uses a Token-Ring connection. Token-Ring is defined in IEEE standard 802.5. + + + The network interface uses a Fiber Distributed Data Interface (FDDI) connection. FDDI is a set of standards for data transmission on fiber optic lines in a local area network. + + + The network interface uses a basic rate interface Integrated Services Digital Network (ISDN) connection. ISDN is a set of standards for data transmission over telephone lines. + + + The network interface uses a primary rate interface Integrated Services Digital Network (ISDN) connection. ISDN is a set of standards for data transmission over telephone lines. + + + The network interface uses a Point-To-Point protocol (PPP) connection. PPP is a protocol for data transmission using a serial device. + + + The network interface is a loopback adapter. Such interfaces are often used for testing; no traffic is sent over the wire. + + + The network interface uses an Ethernet 3 megabit/second connection. This version of Ethernet is defined in IETF RFC 895. + + + The network interface uses a Serial Line Internet Protocol (SLIP) connection. SLIP is defined in IETF RFC 1055. + + + The network interface uses asynchronous transfer mode (ATM) for data transmission. + + + The network interface uses a modem. + + + The network interface uses a Fast Ethernet connection over twisted pair and provides a data rate of 100 megabits per second. This type of connection is also known as 100Base-T. + + + The network interface uses a connection configured for ISDN and the X.25 protocol. X.25 allows computers on public networks to communicate using an intermediary computer. + + + The network interface uses a Fast Ethernet connection over optical fiber and provides a data rate of 100 megabits per second. This type of connection is also known as 100Base-FX. + + + The network interface uses a wireless LAN connection (IEEE 802.11 standard). + + + The network interface uses an Asymmetric Digital Subscriber Line (ADSL). + + + The network interface uses a Rate Adaptive Digital Subscriber Line (RADSL). + + + The network interface uses a Symmetric Digital Subscriber Line (SDSL). + + + The network interface uses a Very High Data Rate Digital Subscriber Line (VDSL). + + + The network interface uses the Internet Protocol (IP) in combination with asynchronous transfer mode (ATM) for data transmission. + + + The network interface uses a gigabit Ethernet connection and provides a data rate of 1,000 megabits per second (1 gigabit per second). + + + The network interface uses a tunnel connection. + + + The network interface uses a Multirate Digital Subscriber Line. + + + The network interface uses a High Performance Serial Bus. + + + Specifies the operational state of a network interface. + + + The network interface is up; it can transmit data packets. + + + The network interface is unable to transmit data packets. + + + The network interface is running tests. + + + The network interface status is not known. + + + The network interface is not in a condition to transmit data packets; it is waiting for an external event. + + + The network interface is unable to transmit data packets because of a missing component, typically a hardware component. + + + The network interface is unable to transmit data packets because it runs on top of one or more other interfaces, and at least one of these "lower layer" interfaces is down. + + + Provides the Media Access Control (MAC) address for a network interface (adapter). + + + Initializes a new instance of the class. + A array containing the address. + + + Compares two instances. + true if this instance and the specified instance contain the same address; otherwise false. + The to compare to the current instance. + + + Returns the address of the current instance. + A array containing the address. + + + Returns the hash value of a physical address. + An integer hash value. + + + Returns a new instance with a zero length address. This field is read-only. + + + Parses the specified and stores its contents as the address bytes of the returned by this method. + A instance with the specified address. + A containing the address that will be used to initialize the instance returned by this method. + The parameter contains an illegal hardware address. This exception also occurs if the parameter contains a string in the incorrect format. + + + Returns the representation of the address of this instance. + A containing the address contained in this instance. + + + Allows an application to determine whether a remote computer is accessible over the network. + + + Initializes a new instance of the class. + + + Releases the unmanaged resources used by the object, and optionally disposes of the managed resources. + true to release both managed and unmanaged resources; false to releases only unmanaged resources. + + + Raises the event. + A object that contains event data. + + + Occurs when an asynchronous operation to send an Internet Control Message Protocol (ICMP) echo message and receive the corresponding ICMP echo reply message completes or is canceled. + + + Attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. + A object that provides information about the ICMP echo reply message, if one was received, or describes the reason for the failure if no message was received. + An that identifies the computer that is the destination for the ICMP echo message. + + is null. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + This object has been disposed. + + + + + + + + + + Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. This method allows you to specify a time-out value for the operation. + A object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received. + An that identifies the computer that is the destination for the ICMP echo message. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + + is null. + + is less than zero. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + This object has been disposed. + + + Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation. + A object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. The method will return if the packet exceeds the Maximum Transmission Unit (MTU). + An that identifies the computer that is the destination for the ICMP echo message. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + A array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes. + The size of exceeds 65500 bytes. + + is null.-or- is null, or the size is greater than 65500 bytes. + + is less than zero. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + This object has been disposed. + + + Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP echo message packet. + A object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. The method will return if the packet exceeds the Maximum Transmission Unit (MTU). + An that identifies the computer that is the destination for the ICMP echo message. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + A array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes. + A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet. + The size of exceeds 65500 bytes. + + is null.-or- is null, or the size is greater than 65500 bytes. + + is less than zero. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + This object has been disposed. + + + Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. + A object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. + A that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address. + + is null or is an empty string (""). + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + This object has been disposed. + + + + + + + + + + Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This method allows you to specify a time-out value for the operation. + A object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received. + A that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + + is null or is an empty string (""). + + is less than zero. + A call to is in progress. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + This object has been disposed. + + + Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation. + A object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received. + A that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + A array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes. + The size of exceeds 65500 bytes. + + is null or is an empty string ("").-or- is null, or the size is greater than 65500 bytes. + + is less than zero. + A call to is in progress. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + This object has been disposed. + + + Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP packet. + A object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received. + A that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + A array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes. + A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet. + The size of exceeds 65500 bytes. + + is null or is a zero length string.-or- is null, or the size is greater than 65500 bytes. + + is less than zero. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + This object has been disposed. + + + Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP echo message packet. + An that identifies the computer that is the destination for the ICMP echo message. + A array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet. + An object that is passed to the method invoked when the asynchronous operation completes. + + is null.-or- is null. + + is less than zero. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + + is not a valid IP address. + This object has been disposed. + The size of exceeds 65500 bytes. + + + Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation. + An that identifies the computer that is the destination for the ICMP echo message. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + A array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes. + An object that is passed to the method invoked when the asynchronous operation completes. + + is null.-or- is null. + + is less than zero. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + + is not a valid IP address. + This object has been disposed. + The size of exceeds 65500 bytes. + + + Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation. + An that identifies the computer that is the destination for the ICMP echo message. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + An object that is passed to the method invoked when the asynchronous operation completes. + + is null. + + is less than zero. + A call to method is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + + is not a valid IP address. + This object has been disposed. + + + Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified , and receive a corresponding ICMP echo reply message from that computer. + An that identifies the computer that is the destination for the ICMP echo message. + An object that is passed to the method invoked when the asynchronous operation completes. + + is null. + A call to the method is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + + is not a valid IP address. + This object has been disposed. + + + + + + + + + + Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP packet. + A that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address. + A array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + A object used to control fragmentation and Time-to-Live values for the ICMP echo message packet. + An object that is passed to the method invoked when the asynchronous operation completes. + + is null or is an empty string ("").-or- is null. + + is less than zero. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + + could not be resolved to a valid IP address. + This object has been disposed. + The size of exceeds 65500 bytes. + + + Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation. + A that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + A array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes. + An object that is passed to the method invoked when the asynchronous operation completes. + + is null or is an empty string ("").-or- is null. + + is less than zero. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + + could not be resolved to a valid IP address. + This object has been disposed. + The size of exceeds 65500 bytes. + + + Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation. + A that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address. + An value that specifies the maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message. + An object that is passed to the method invoked when the asynchronous operation completes. + + is null or is an empty string (""). + + is less than zero. + A call to is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + + could not be resolved to a valid IP address. + This object has been disposed. + + + Asynchronously attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. + A that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address. + An object that is passed to the method invoked when the asynchronous operation completes. + + is null or is an empty string (""). + A call to method is in progress. + + is an IPv6 address and the local computer is running an operating system earlier than Windows 2000. + An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. + + could not be resolved to a valid IP address. + This object has been disposed. + + + + + + + + + + Cancels all pending asynchronous requests to send an Internet Control Message Protocol (ICMP) echo message and receives a corresponding ICMP echo reply message. + + + + + + + + Provides data for the event. + + + Gets an object that contains data that describes an attempt to send an Internet Control Message Protocol (ICMP) echo request message and receive a corresponding ICMP echo reply message. + A object that describes the results of the ICMP echo request. + + + Represents the method that will handle the event of a object. + The source of the event. + A object that contains the event data. + + + The exception that is thrown when a or method calls a method that throws an exception. + + + Initializes a new instance of the class with serialized data. + The object that holds the serialized object data. + A that specifies the contextual information about the source or destination for this serialization. + + + Initializes a new instance of the class using the specified message. + A that describes the error. + + + Initializes a new instance of the class using the specified message and inner exception. + A that describes the error. + The exception that causes the current exception. + + + Used to control how data packets are transmitted. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class and sets the Time to Live and fragmentation values. + An value greater than zero that specifies the number of times that the data packets can be forwarded. + true to prevent data sent to the remote host from being fragmented; otherwise, false. + + is less than or equal to zero. + + + Gets or sets a value that controls fragmentation of the data sent to the remote host. + true if the data cannot be sent in multiple packets; otherwise false. The default is false. + + + Gets or sets the number of routing nodes that can forward the data before it is discarded. + An value that specifies the number of times the data packets can be forwarded. The default is 128. + The value specified for a set operation is less than or equal to zero. + + + Provides information about the status and data resulting from a or operation. + + + Gets the address of the host that sends the Internet Control Message Protocol (ICMP) echo reply. + An containing the destination for the ICMP echo message. + + + Gets the buffer of data received in an Internet Control Message Protocol (ICMP) echo reply message. + A array containing the data received in an ICMP echo reply message, or an empty array, if no reply was received. + + + Gets the options used to transmit the reply to an Internet Control Message Protocol (ICMP) echo request. + A object that contains the Time to Live (TTL) and the fragmentation directive used for transmitting the reply if is ; otherwise, null. + + + Gets the number of milliseconds taken to send an Internet Control Message Protocol (ICMP) echo request and receive the corresponding ICMP echo reply message. + An that specifies the round trip time, in milliseconds. + + + Gets the status of an attempt to send an Internet Control Message Protocol (ICMP) echo request and receive the corresponding ICMP echo reply message. + An value indicating the result of the request. + + + Specifies how an IP address network prefix was located. + + + The prefix was located using an unspecified source. + + + The prefix was manually configured. + + + The prefix is a well-known prefix. Well-known prefixes are specified in standard-track Request for Comments (RFC) documents and assigned by the Internet Assigned Numbers Authority (Iana) or an address registry. Such prefixes are reserved for special purposes. + + + The prefix was supplied by a Dynamic Host Configuration Protocol (DHCP) server. + + + The prefix was supplied by a router advertisement. + + + Specifies how an IP address host suffix was located. + + + The suffix was located using an unspecified source. + + + The suffix was manually configured. + + + The suffix is a well-known suffix. Well-known suffixes are specified in standard-track Request for Comments (RFC) documents and assigned by the Internet Assigned Numbers Authority (Iana) or an address registry. Such suffixes are reserved for special purposes. + + + The suffix was supplied by a Dynamic Host Configuration Protocol (DHCP) server. + + + The suffix is a link-local suffix. + + + The suffix was randomly assigned. + + + Provides information about the Transmission Control Protocol (TCP) connections on the local computer. + + + Initializes a new instance of the class. + + + Gets the local endpoint of a Transmission Control Protocol (TCP) connection. + An instance that contains the IP address and port on the local computer. + + + Gets the remote endpoint of a Transmission Control Protocol (TCP) connection. + An instance that contains the IP address and port on the remote computer. + + + Gets the state of this Transmission Control Protocol (TCP) connection. + One of the enumeration values. + + + Specifies the states of a Transmission Control Protocol (TCP) connection. + + + The TCP connection state is unknown. + + + The TCP connection is closed. + + + The local endpoint of the TCP connection is listening for a connection request from any remote endpoint. + + + The local endpoint of the TCP connection has sent the remote endpoint a segment header with the synchronize (SYN) control bit set and is waiting for a matching connection request. + + + The local endpoint of the TCP connection has sent and received a connection request and is waiting for an acknowledgment. + + + The TCP handshake is complete. The connection has been established and data can be sent. + + + The local endpoint of the TCP connection is waiting for a connection termination request from the remote endpoint or for an acknowledgement of the connection termination request sent previously. + + + The local endpoint of the TCP connection is waiting for a connection termination request from the remote endpoint. + + + The local endpoint of the TCP connection is waiting for a connection termination request from the local user. + + + The local endpoint of the TCP connection is waiting for an acknowledgement of the connection termination request sent previously. + + + The local endpoint of the TCP connection is waiting for the final acknowledgement of the connection termination request sent previously. + + + The local endpoint of the TCP connection is waiting for enough time to pass to ensure that the remote endpoint received the acknowledgement of its connection termination request. + + + The transmission control buffer (TCB) for the TCP connection is being deleted. + + + Provides Transmission Control Protocol (TCP) statistical data. + + + Initializes a new instance of the class. + + + Gets the number of accepted Transmission Control Protocol (TCP) connection requests. + An value that specifies the total number of TCP connection requests accepted. + + + Gets the number of Transmission Control Protocol (TCP) connection requests made by clients. + An value that specifies the total number of TCP connections initiated by clients. + + + Specifies the total number of Transmission Control Protocol (TCP) connections established. + An value that specifies the total number of connections established. + + + Gets the number of current Transmission Control Protocol (TCP) connections. + An value that specifies the total number of current TCP connections. + + + Gets the number of Transmission Control Protocol (TCP) errors received. + An value that specifies the total number of TCP errors received. + + + Gets the number of failed Transmission Control Protocol (TCP) connection attempts. + An value that specifies the total number of failed TCP connection attempts. + + + Gets the maximum number of supported Transmission Control Protocol (TCP) connections. + An value that specifies the total number of TCP connections that can be supported. + + + Gets the maximum retransmission time-out value for Transmission Control Protocol (TCP) segments. + An value that specifies the maximum number of milliseconds permitted by a TCP implementation for the retransmission time-out value. + + + Gets the minimum retransmission time-out value for Transmission Control Protocol (TCP) segments. + An value that specifies the minimum number of milliseconds permitted by a TCP implementation for the retransmission time-out value. + + + Gets the number of RST packets received by Transmission Control Protocol (TCP) connections. + An value that specifies the total number of reset TCP connections. + + + Gets the number of Transmission Control Protocol (TCP) segments sent with the reset flag set. + An value that specifies the total number of TCP segments sent with the reset flag set. + + + Gets the number of Transmission Control Protocol (TCP) segments received. + An value that specifies the total number of TCP segments received. + + + Gets the number of Transmission Control Protocol (TCP) segments re-sent. + An value that specifies the total number of TCP segments retransmitted. + + + Gets the number of Transmission Control Protocol (TCP) segments sent. + An value that specifies the total number of TCP segments sent. + + + Provides User Datagram Protocol (UDP) statistical data. + + + Initializes a new instance of the class. + + + Gets the number of User Datagram Protocol (UDP) datagrams that were received. + An value that specifies the total number of datagrams that were delivered to UDP users. + + + Gets the number of User Datagram Protocol (UDP) datagrams that were sent. + An value that specifies the total number of datagrams that were sent. + + + Gets the number of User Datagram Protocol (UDP) datagrams that were received and discarded because of port errors. + An value that specifies the total number of received UDP datagrams that were discarded because there was no listening application at the destination port. + + + Gets the number of User Datagram Protocol (UDP) datagrams that were received and discarded because of errors other than bad port information. + An value that specifies the total number of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port. + + + Gets the number of local endpoints that are listening for User Datagram Protocol (UDP) datagrams. + An value that specifies the total number of sockets that are listening for UDP datagrams. + + + Provides information about a network interface's unicast address. + + + Initializes a new instance of the class. + + + Gets the number of seconds remaining during which this address is the preferred address. + An value that specifies the number of seconds left for this address to remain preferred. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Gets the number of seconds remaining during which this address is valid. + An value that specifies the number of seconds left for this address to remain assigned. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Specifies the amount of time remaining on the Dynamic Host Configuration Protocol (DHCP) lease for this IP address. + An value that contains the number of seconds remaining before the computer must release the instance. + + + Gets a value that indicates the state of the duplicate address detection algorithm. + One of the values that indicates the progress of the algorithm in determining the uniqueness of this IP address. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Gets the IPv4 mask. + An object that contains the IPv4 mask. + + + Gets a value that identifies the source of a unicast Internet Protocol (IP) address prefix. + One of the values that identifies how the prefix information was obtained. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Gets a value that identifies the source of a unicast Internet Protocol (IP) address suffix. + One of the values that identifies how the suffix information was obtained. + This property is not valid on computers running operating systems earlier than Windows XP. + + + Stores a set of types. + + + Initializes a new instance of the class. + + + Throws a because this operation is not supported for this collection. + The object to be added to the collection. + + + Throws a because this operation is not supported for this collection. + + + Checks whether the collection contains the specified object. + true if the object exists in the collection; otherwise, false. + The object to be searched in the collection. + + + Copies the elements in this collection to a one-dimensional array of type . + A one-dimensional array that receives a copy of the collection. + The zero-based index in at which the copy begins. + + is null. + + is less than zero. + + is multidimensional.-or- The number of elements in this is greater than the available space from to the end of the destination . + The elements in this cannot be cast automatically to the type of the destination . + + + Gets the number of types in this collection. + An value that contains the number of types in this collection. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Gets a value that indicates whether access to this collection is read-only. + true in all cases. + + + Gets the instance at the specified index in the collection. + The at the specified location. + The zero-based index of the element. + + + Throws a because the collection is read-only and elements cannot be removed. + Always throws a . + The object to be removed. + + + Returns an object that can be used to iterate through this collection. + An object that implements the interface and provides access to the types in this collection. + + + Provides methods for passing credentials across a stream and requesting or performing authentication for client-server applications. + + + Initializes a new instance of the class. + A object used by the for sending and receiving data. + A that indicates whether closing this object also closes . + + is null.-or- is equal to . + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets the stream used by this for sending and receiving data. + A object. + + + Gets a value that indicates whether authentication was successful. + true if successful authentication occurred; otherwise, false. + + + Gets a value that indicates whether data sent using this is encrypted. + true if data is encrypted before being transmitted over the network and decrypted when it reaches the remote endpoint; otherwise, false. + + + Gets a value that indicates whether both server and client have been authenticated. + true if the client and server have been authenticated; otherwise, false. + + + Gets a value that indicates whether the local side of the connection was authenticated as the server. + true if the local endpoint was authenticated as the server side of a client-server authenticated connection; false if the local endpoint was authenticated as the client. + + + Gets a value that indicates whether the data sent using this stream is signed. + true if the data is signed before being transmitted; otherwise, false. + + + Gets whether the stream used by this for sending and receiving data has been left open. + true if the inner stream has been left open; otherwise, false. + + + Specifies client requirements for authentication and impersonation when using the class and derived classes to request a resource. + + + No authentication is required for the client and server. + + + The client and server should be authenticated. The request does not fail if the server is not authenticated. To determine whether mutual authentication occurred, check the value of the property. + + + The client and server should be authenticated. If the server is not authenticated, your application will receive an with a inner exception that indicates that mutual authentication failed + + + The EncryptionPolicy to use. + + + Require encryption and never allow a NULL cipher. + + + Prefer that full encryption be used, but allow a NULL cipher (no encryption) if the server agrees. + + + Allow no encryption and request that a NULL cipher be used if the other endpoint can handle a NULL cipher. + + + Selects the local Secure Sockets Layer (SSL) certificate used for authentication. + An used for establishing an SSL connection. + An object that contains state information for this validation. + The host server specified by the client. + An containing local certificates. + The certificate used to authenticate the remote party. + A array of certificate issuers acceptable to the remote party. + + + Provides a stream that uses the Negotiate security protocol to authenticate the client, and optionally the server, in client-server communication. + + + Initializes a new instance of the class using the specified . + A object used by the for sending and receiving data. + + + Initializes a new instance of the class using the specified and stream closure behavior. + A object used by the for sending and receiving data. + true to indicate that closing this has no effect on ; false to indicate that closing this also closes . See the Remarks section for more information. + + is null.- or - is equal to . + + + Called by clients to authenticate the client, and optionally the server, in a client-server connection. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + + + Called by clients to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified client credential and the channel binding. + The that is used to establish the identity of the client. + The that is used for extended protection. + The Service Principal Name (SPN) that uniquely identifies the server to authenticate. + + is null.- or - is null. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + This object has been closed. + + + Called by clients to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credential, authentication options, and channel binding. + The that is used to establish the identity of the client. + The that is used for extended protection. + The Service Principal Name (SPN) that uniquely identifies the server to authenticate. + One of the values, indicating the security services for the stream. + One of the values, indicating how the server can use the client's credentials to access resources. + + is null.- or - is null. + + is not a valid value. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + This object has been closed. + + + Called by clients to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified client credential. + The that is used to establish the identity of the client. + The Service Principal Name (SPN) that uniquely identifies the server to authenticate. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + + is null. + + + Called by clients to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials and authentication options. + The that is used to establish the identity of the client. + The Service Principal Name (SPN) that uniquely identifies the server to authenticate. + One of the values, indicating the security services for the stream. + One of the values, indicating how the server can use the client's credentials to access resources. + + is not a valid value. + + is null. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + + + Called by servers to authenticate the client, and optionally the server, in a client-server connection. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Windows 95 and Windows 98 are not supported. + + + Called by servers to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified server credentials and authentication options. + The that is used to establish the identity of the server. + One of the values, indicating the security services for the stream. + One of the values, indicating how the server can use the client's credentials to access resources. + + is null. + + must be , , or , + The authentication failed. You can use this object to try to r-authenticate. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server. + Windows 95 and Windows 98 are not supported. + + + Called by servers to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified server credentials, authentication options, and extended protection policy. + The that is used to establish the identity of the client. + The that is used for extended protection. + One of the values, indicating the security services for the stream. + One of the values, indicating how the server can use the client's credentials to access resources. + The and on the extended protection policy passed in the parameter are both null. + + is null. + + must be , , or , + The authentication failed. You can use this object to try to r-authenticate. + The authentication failed. You can use this object to retry the authentication. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server. + Windows 95 and Windows 98 are not supported. + This object has been closed. + The parameter was set to on a platform that does not support extended protection. + + + Called by servers to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified extended protection policy. + The that is used for extended protection. + The and on the extended protection policy passed in the parameter are both null. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + Windows 95 and Windows 98 are not supported. + This object has been closed. + The parameter was set to on a platform that does not support extended protection. + + + Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. This method does not block. + An object indicating the status of the asynchronous operation. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object containing information about the operation. This object is passed to the delegate when the operation completes. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + + + Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials and channel binding. This method does not block. + An object indicating the status of the asynchronous operation. + The that is used to establish the identity of the client. + The that is used for extended protection. + The Service Principal Name (SPN) that uniquely identifies the server to authenticate. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object containing information about the write operation. This object is passed to the delegate when the operation completes. + + is null.- or - is null. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + This object has been closed. + + + Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials, authentication options, and channel binding. This method does not block. + An object indicating the status of the asynchronous operation. + The that is used to establish the identity of the client. + The that is used for extended protection. + The Service Principal Name (SPN) that uniquely identifies the server to authenticate. + One of the values, indicating the security services for the stream. + One of the values, indicating how the server can use the client's credentials to access resources. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object containing information about the write operation. This object is passed to the delegate when the operation completes. + + is null.- or - is null. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + This object has been closed. + + + Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials. This method does not block. + An object indicating the status of the asynchronous operation. + The that is used to establish the identity of the client. + The Service Principal Name (SPN) that uniquely identifies the server to authenticate. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object containing information about the write operation. This object is passed to the delegate when the operation completes. + + is null.- or - is null. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + + + Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials and authentication options. This method does not block. + An object indicating the status of the asynchronous operation. + The that is used to establish the identity of the client. + The Service Principal Name (SPN) that uniquely identifies the server to authenticate. + One of the values, indicating the security services for the stream. + One of the values, indicating how the server can use the client's credentials to access resources. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object containing information about the write operation. This object is passed to the delegate when the operation completes. + + is null.- or - is null. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client. + + + Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. This method does not block. + An object indicating the status of the asynchronous operation. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object containing information about the operation. This object is passed to the delegate when the operation completes. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Windows 95 and Windows 98 are not supported. + + + Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified server credentials and authentication options. This method does not block. + An object indicating the status of the asynchronous operation. + The that is used to establish the identity of the client. + One of the values, indicating the security services for the stream. + One of the values, indicating how the server can use the client's credentials to access resources. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object containing information about the operation. This object is passed to the delegate when the operation completes. + + is null. + + must be , , or , + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + This object has been closed. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server. + Windows 95 and Windows 98 are not supported. + + + Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified server credentials, authentication options, and extended protection policy. This method does not block. + An object indicating the status of the asynchronous operation. + The that is used to establish the identity of the client. + The that is used for extended protection. + One of the values, indicating the security services for the stream. + One of the values, indicating how the server can use the client's credentials to access resources. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object containing information about the write operation. This object is passed to the delegate when the operation completes. + The and on the extended protection policy passed in the parameter are both null. + + is null. + + must be , , or , + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + Authentication has already occurred.- or -This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server. + Windows 95 and Windows 98 are not supported. + This object has been closed. + The parameter was set to on a platform that does not support extended protection. + + + Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified extended protection policy. This method does not block. + An object indicating the status of the asynchronous operation. + The that is used for extended protection. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object containing information about the write operation. This object is passed to the delegate when the operation completes. + The and on the extended protection policy passed in the parameter are both null. + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + Windows 95 and Windows 98 are not supported. + This object has been closed. + The parameter was set to on a platform that does not support extended protection. + + + Begins an asynchronous read operation that reads data from the stream and stores it in the specified array. + An object indicating the status of the asynchronous operation. + A array that receives the bytes read from the stream. + The zero-based location in at which to begin storing the data read from this stream. + The maximum number of bytes to read from the stream. + An delegate that references the method to invoke when the read operation is complete. + A user-defined object containing information about the read operation. This object is passed to the delegate when the operation completes. + + is null. + + is less than 0.- or - is greater than the length of .- or - plus is greater than the length of . + The read operation failed.- or -Encryption is in use, but the data could not be decrypted. + There is already a read operation in progress. + This object has been closed. + Authentication has not occurred. + + + Begins an asynchronous write operation that writes s from the specified buffer to the stream. + An object indicating the status of the asynchronous operation. + A array that supplies the bytes to be written to the stream. + The zero-based location in at which to begin reading bytes to be written to the stream. + An value that specifies the number of bytes to read from . + An delegate that references the method to invoke when the write operation is complete. + A user-defined object containing information about the write operation. This object is passed to the delegate when the operation completes. + + is null. + + .- or - is greater than the length of .- or - plus count is greater than the length of . + The write operation failed.- or -Encryption is in use, but the data could not be encrypted. + There is already a write operation in progress. + This object has been closed. + Authentication has not occurred. + + + Gets a value that indicates whether the underlying stream is readable. + true if authentication has occurred and the underlying stream is readable; otherwise, false. + + + Gets a value that indicates whether the underlying stream is seekable. + This property always returns false. + + + Gets a value that indicates whether the underlying stream supports time-outs. + true if the underlying stream supports time-outs; otherwise, false. + + + Gets a value that indicates whether the underlying stream is writable. + true if authentication has occurred and the underlying stream is writable; otherwise, false. + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Ends a pending asynchronous client authentication operation that was started with a call to . + An instance returned by a call to . + + is null. + + was not created by a call to . + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + There is no pending client authentication to complete. + + + Ends a pending asynchronous client authentication operation that was started with a call to . + An instance returned by a call to . + + is null. + + was not created by a call to . + The authentication failed. You can use this object to retry the authentication. + The authentication failed. You can use this object to retry the authentication. + There is no pending authentication to complete. + + + Ends an asynchronous read operation that was started with a call to . + A value that specifies the number of bytes read from the underlying stream. + An instance returned by a call to + + is null. + The asyncResult was not created by a call to . + There is no pending read operation to complete. + The read operation failed. + Authentication has not occurred. + + + Ends an asynchronous write operation that was started with a call to . + An instance returned by a call to + + is null. + The asyncResult was not created by a call to . + There is no pending write operation to complete. + The write operation failed. + Authentication has not occurred. + + + Causes any buffered data to be written to the underlying device. + + + Gets a value that indicates how the server can use the client's credentials. + One of the values. + Authentication failed or has not occurred. + + + Gets a value that indicates whether authentication was successful. + true if successful authentication occurred; otherwise, false. + + + Gets a value that indicates whether this uses data encryption. + true if data is encrypted before being transmitted over the network and decrypted when it reaches the remote endpoint; otherwise, false. + + + Gets a value that indicates whether both the server and the client have been authenticated. + true if the server has been authenticated; otherwise, false. + + + Gets a value that indicates whether the local side of the connection used by this was authenticated as the server. + true if the local endpoint was successfully authenticated as the server side of the authenticated connection; otherwise, false. + + + Gets a value that indicates whether the data sent using this stream is signed. + true if the data is signed before being transmitted; otherwise, false. + + + Gets the length of the underlying stream. + A that specifies the length of the underlying stream. + Getting the value of this property is not supported when the underlying stream is a . + + + Gets or sets the current position in the underlying stream. + A that specifies the current position in the underlying stream. + Setting this property is not supported.- or -Getting the value of this property is not supported when the underlying stream is a . + + + Reads data from this stream and stores it in the specified array. + A value that specifies the number of bytes read from the underlying stream. When there is no more data to be read, returns 0. + A array that receives the bytes read from the stream. + A containing the zero-based location in at which to begin storing the data read from this stream. + A containing the maximum number of bytes to read from the stream. + The read operation failed. + Authentication has not occurred. + A operation is already in progress. + + + Gets or sets the amount of time a read operation blocks waiting for data. + A that specifies the amount of time that will elapse before a read operation fails. + + + Gets information about the identity of the remote party sharing this authenticated stream. + An object that describes the identity of the remote endpoint. + Authentication failed or has not occurred. + + + Throws . + Always throws a . + This value is ignored. + This value is ignored. + Seeking is not supported on . + + + Sets the length of the underlying stream. + An value that specifies the length of the stream. + + + Write the specified number of s to the underlying stream using the specified buffer and offset. + A array that supplies the bytes written to the stream. + An containing the zero-based location in at which to begin reading bytes to be written to the stream. + A containing the number of bytes to read from . + + is null. + + .- or - is greater than the length of .- or - plus count is greater than the length of . + The write operation failed.- or -Encryption is in use, but the data could not be encrypted. + There is already a write operation in progress. + This object has been closed. + Authentication has not occurred. + + + Gets or sets the amount of time a write operation blocks waiting for data. + A that specifies the amount of time that will elapse before a write operation fails. + + + Indicates the security services requested for an authenticated stream. + + + Authentication only. + + + Sign data to help ensure the integrity of transmitted data. + + + Encrypt and sign data to help ensure the confidentiality and integrity of transmitted data. + + + Verifies the remote Secure Sockets Layer (SSL) certificate used for authentication. + A value that determines whether the specified certificate is accepted for authentication. + An object that contains state information for this validation. + The certificate used to authenticate the remote party. + The chain of certificate authorities associated with the remote certificate. + One or more errors associated with the remote certificate. + + + Enumerates Secure Socket Layer (SSL) policy errors. + + + No SSL policy errors. + + + Certificate not available. + + + Certificate name mismatch. + + + + has returned a non empty array. + + + Provides a stream used for client-server communication that uses the Secure Socket Layer (SSL) security protocol to authenticate the server and optionally the client. + + + Initializes a new instance of the class using the specified . + A object used by the for sending and receiving data. + + is not readable.-or- is not writable. + + is null.-or- is equal to . + + + Initializes a new instance of the class using the specified and stream closure behavior. + A object used by the for sending and receiving data. + A Boolean value that indicates the closure behavior of the object used by the for sending and receiving data. This parameter indicates if the inner stream is left open. + + is not readable.-or- is not writable. + + is null.-or- is equal to . + + + Initializes a new instance of the class using the specified , stream closure behavior and certificate validation delegate. + A object used by the for sending and receiving data. + A Boolean value that indicates the closure behavior of the object used by the for sending and receiving data. This parameter indicates if the inner stream is left open. + A delegate responsible for validating the certificate supplied by the remote party. + + is not readable.-or- is not writable. + + is null.-or- is equal to . + + + Initializes a new instance of the class using the specified , stream closure behavior, certificate validation delegate and certificate selection delegate. + A object used by the for sending and receiving data. + A Boolean value that indicates the closure behavior of the object used by the for sending and receiving data. This parameter indicates if the inner stream is left open. + A delegate responsible for validating the certificate supplied by the remote party. + A delegate responsible for selecting the certificate used for authentication. + + is not readable.-or- is not writable. + + is null.-or- is equal to . + + + Initializes a new instance of the class using the specified + A object used by the for sending and receiving data. + A Boolean value that indicates the closure behavior of the object used by the for sending and receiving data. This parameter indicates if the inner stream is left open. + A delegate responsible for validating the certificate supplied by the remote party. + A delegate responsible for selecting the certificate used for authentication. + The to use. + + is not readable.-or- is not writable.-or- is not valid. + + is null.-or- is equal to . + + + Called by clients to authenticate the server and optionally the client in a client-server connection. + The name of the server that shares this . + + is null. + The authentication failed and left this object in an unusable state. + Authentication has already occurred.-or-Server authentication using this was tried previously.-or- Authentication is already in progress. + This object has been closed. + + + Called by clients to authenticate the server and optionally the client in a client-server connection. The authentication process uses the specified certificate collection and SSL protocol. + The name of the server that will share this . + The that contains client certificates. + The value that represents the protocol used for authentication. + A value that specifies whether the certificate revocation list is checked during authentication. + + + Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificate. + The certificate used to authenticate the server. + + is null. + The authentication failed and left this object in an unusable state. + Authentication has already occurred.-or-Client authentication using this was tried previously.-or- Authentication is already in progress. + This object has been closed. + The method is not supported on Windows 95, Windows 98, or Windows Millennium. + + + Called by servers to begin an asynchronous operation to authenticate the server and optionally the client using the specified certificates, requirements and security protocol. + The X509Certificate used to authenticate the server. + A value that specifies whether the client must supply a certificate for authentication. + The value that represents the protocol used for authentication. + A value that specifies whether the certificate revocation list is checked during authentication. + + is null. + + is not a valid value. + The authentication failed and left this object in an unusable state. + Authentication has already occurred.-or-Client authentication using this was tried previously.-or- Authentication is already in progress. + This object has been closed. + The method is not supported on Windows 95, Windows 98, or Windows Millennium. + + + Called by clients to begin an asynchronous operation to authenticate the server and optionally the client. + An object that indicates the status of the asynchronous operation. + The name of the server that shares this . + An delegate that references the method to invoke when the authentication is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation completes. + + is null. + The authentication failed and left this object in an unusable state. + Authentication has already occurred.-or-Server authentication using this was tried previously.-or- Authentication is already in progress. + This object has been closed. + + + Called by clients to begin an asynchronous operation to authenticate the server and optionally the client using the specified certificates and security protocol. + An object that indicates the status of the asynchronous operation. + The name of the server that shares this . + The containing client certificates. + The value that represents the protocol used for authentication. + A value that specifies whether the certificate revocation list is checked during authentication. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation completes. + + is null. + + is not a valid value. + The authentication failed and left this object in an unusable state. + Authentication has already occurred.-or-Server authentication using this was tried previously.-or- Authentication is already in progress. + This object has been closed. + + + Called by servers to begin an asynchronous operation to authenticate the client and optionally the server in a client-server connection. + An object indicating the status of the asynchronous operation. + The X509Certificate used to authenticate the server. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation completes. + + is null. + The authentication failed and left this object in an unusable state. + Authentication has already occurred.-or-Client authentication using this was tried previously.-or- Authentication is already in progress. + This object has been closed. + The method is not supported on Windows 95, Windows 98, or Windows Millennium. + + + Called by servers to begin an asynchronous operation to authenticate the server and optionally the client using the specified certificates, requirements and security protocol. + An object that indicates the status of the asynchronous operation. + The X509Certificate used to authenticate the server. + A value that specifies whether the client must supply a certificate for authentication. + The value that represents the protocol used for authentication. + A value that specifies whether the certificate revocation list is checked during authentication. + An delegate that references the method to invoke when the authentication is complete. + A user-defined object that contains information about the operation. This object is passed to the delegate when the operation completes. + + is null. + + is not a valid value. + The authentication failed and left this object in an unusable state. + Authentication has already occurred.-or-Server authentication using this was tried previously.-or- Authentication is already in progress. + This object has been closed. + The method is not supported on Windows 95, Windows 98, or Windows Millennium. + + + Begins an asynchronous read operation that reads data from the stream and stores it in the specified array. + An object that indicates the status of the asynchronous operation. + A array that receives the bytes read from the stream. + The zero-based location in at which to begin storing the data read from this stream. + The maximum number of bytes to read from the stream. + An delegate that references the method to invoke when the read operation is complete. + A user-defined object that contains information about the read operation. This object is passed to the delegate when the operation completes. + + is null. + + + + . > the length of .-or- + count > the length of . + The read operation failed.-or-Encryption is in use, but the data could not be decrypted. + There is already a read operation in progress. + This object has been closed. + Authentication has not occurred. + + + Begins an asynchronous write operation that writes s from the specified buffer to the stream. + An object indicating the status of the asynchronous operation. + A array that supplies the bytes to be written to the stream. + The zero-based location in at which to begin reading bytes to be written to the stream. + An value that specifies the number of bytes to read from . + An delegate that references the method to invoke when the write operation is complete. + A user-defined object that contains information about the write operation. This object is passed to the delegate when the operation completes. + + is null. + + + + . > the length of .-or- + count > the length of . + The write operation failed. + There is already a write operation in progress. + This object has been closed. + Authentication has not occurred. + + + Gets a value that indicates whether the underlying stream is readable. + true if authentication has occurred and the underlying stream is readable; otherwise false. + + + Gets a value that indicates whether the underlying stream is seekable. + This property always returns false. + + + Gets a value that indicates whether the underlying stream supports time-outs. + true if the underlying stream supports time-outs; otherwise, false. + + + Gets a value that indicates whether the underlying stream is writable. + true if authentication has occurred and the underlying stream is writable; otherwise false. + + + Gets a value that indicates whether the certificate revocation list is checked during the certificate validation process. + true if the certificate revocation list is checked; otherwise, false. + + + Gets a value that identifies the bulk encryption algorithm used by this . + A value. + The property was accessed before the completion of the authentication process or the authentication process failed. + + + Gets a value that identifies the strength of the cipher algorithm used by this . + An value that specifies the strength of the algorithm, in bits. + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Ends a pending asynchronous server authentication operation started with a previous call to . + An instance returned by a call to . + + is null. + + was not created by a call to . + The authentication failed and left this object in an unusable state. + There is no pending server authentication to complete. + + + Ends a pending asynchronous client authentication operation started with a previous call to . + An instance returned by a call to . + + is null. + + was not created by a call to . + The authentication failed and left this object in an unusable state. + There is no pending client authentication to complete. + + + Ends an asynchronous read operation started with a previous call to . + A value that specifies the number of bytes read from the underlying stream. + An instance returned by a call to + + is null. + + was not created by a call to . + There is no pending read operation to complete. + The read operation failed. + Authentication has not occurred. + + + Ends an asynchronous write operation started with a previous call to . + An instance returned by a call to + + is null. + + was not created by a call to . + There is no pending write operation to complete. + The write operation failed. + Authentication has not occurred. + + + Causes any buffered data to be written to the underlying device. + + + Gets the algorithm used for generating message authentication codes (MACs). + A value. + The property was accessed before the completion of the authentication process or the authentication process failed. + + + Gets a value that identifies the strength of the hash algorithm used by this instance. + An value that specifies the strength of the algorithm, in bits. Valid values are 128 or 160. + + + Gets a value that indicates whether authentication was successful. + true if successful authentication occurred; otherwise, false. + + + Gets a value that indicates whether this uses data encryption. + true if data is encrypted before being transmitted over the network and decrypted when it reaches the remote endpoint; otherwise false. + + + Gets a value that indicates whether both server and client have been authenticated. + true if the server has been authenticated; otherwise false. + + + Gets a value that indicates whether the local side of the connection used by this was authenticated as the server. + true if the local endpoint was successfully authenticated as the server side of the authenticated connection; otherwise false. + + + Gets a value that indicates whether the data sent using this stream is signed. + true if the data is signed before being transmitted; otherwise false. + + + Gets the key exchange algorithm used by this . + An value. + + + Gets a value that identifies the strength of the key exchange algorithm used by this instance. + An value that specifies the strength of the algorithm, in bits. + + + Gets the length of the underlying stream. + A . + Getting the value of this property is not supported when the underlying stream is a . + + + Gets the certificate used to authenticate the local endpoint. + An X509Certificate object that represents the certificate supplied for authentication or null if no certificate was supplied. + Authentication failed or has not occurred. + + + Gets or sets the current position in the underlying stream. + A . + Setting this property is not supported.-or-Getting the value of this property is not supported when the underlying stream is a . + + + Reads data from this stream and stores it in the specified array. + A value that specifies the number of bytes read. When there is no more data to be read, returns 0. + A array that receives the bytes read from this stream. + A that contains the zero-based location in at which to begin storing the data read from this stream. + A that contains the maximum number of bytes to read from this stream. + + is null. + + + + . > the length of .-or- + count > the length of . + The read operation failed. Check the inner exception, if present to determine the cause of the failure. + There is already a read operation in progress. + This object has been closed. + Authentication has not occurred. + + + Gets or sets the amount of time a read operation blocks waiting for data. + A that specifies the amount of time that elapses before a synchronous read operation fails. + + + Gets the certificate used to authenticate the remote endpoint. + An X509Certificate object that represents the certificate supplied for authentication or null if no certificate was supplied. + Authentication failed or has not occurred. + + + Throws a . + Always throws a . + This value is ignored. + This value is ignored. + Seeking is not supported by objects. + + + Sets the length of the underlying stream. + An value that specifies the length of the stream. + + + Gets a value that indicates the security protocol used to authenticate this connection. + The value that represents the protocol used for authentication. + + + Gets the used for authentication using extended protection. + The object that contains the channel binding token (CBT) used for extended protection. + + + Writes the specified data to this stream. + A array that supplies the bytes written to the stream. + + is null. + The write operation failed. + There is already a write operation in progress. + This object has been closed. + Authentication has not occurred. + + + Write the specified number of s to the underlying stream using the specified buffer and offset. + A array that supplies the bytes written to the stream. + A that contains the zero-based location in at which to begin reading bytes to be written to the stream. + A that contains the number of bytes to read from . + + is null. + + + + . > the length of .-or- + count > the length of . + The write operation failed. + There is already a write operation in progress. + This object has been closed. + Authentication has not occurred. + + + Gets or sets the amount of time a write operation blocks waiting for data. + A that specifies the amount of time that elapses before a synchronous write operation fails. + + + Specifies the addressing scheme that an instance of the class can use. + + + Unknown address family. + + + Unspecified address family. + + + Unix local to host address. + + + Address for IP version 4. + + + ARPANET IMP address. + + + Address for PUP protocols. + + + Address for MIT CHAOS protocols. + + + Address for Xerox NS protocols. + + + IPX or SPX address. + + + Address for ISO protocols. + + + Address for OSI protocols. + + + European Computer Manufacturers Association (ECMA) address. + + + Address for Datakit protocols. + + + Addresses for CCITT protocols, such as X.25. + + + IBM SNA address. + + + DECnet address. + + + Direct data-link interface address. + + + LAT address. + + + NSC Hyperchannel address. + + + AppleTalk address. + + + NetBios address. + + + VoiceView address. + + + FireFox address. + + + Banyan address. + + + Native ATM services address. + + + Address for IP version 6. + + + Address for Microsoft cluster products. + + + IEEE 1284.4 workgroup address. + + + IrDA address. + + + Address for Network Designers OSI gateway-enabled protocols. + + + MAX address. + + + Specifies the IO control codes supported by the method. + + + Enable notification for when data is waiting to be received. This value is equal to the Winsock 2 FIOASYNC constant. + + + Control the blocking behavior of the socket. If the argument specified with this control code is zero, the socket is placed in blocking mode. If the argument is nonzero, the socket is placed in nonblocking mode. This value is equal to the Winsock 2 FIONBIO constant. + + + Return the number of bytes available for reading. This value is equal to the Winsock 2 FIONREAD constant. + + + Return information about out-of-band data waiting to be received. When using this control code on stream sockets, the return value indicates the number of bytes available. + + + Associate this socket with the specified handle of a companion interface. Refer to the appropriate protocol-specific annex in the Winsock 2 reference or documentation for the particular companion interface for additional details. It is recommended that the Component Object Model (COM) be used instead of this IOCTL to discover and track other interfaces that might be supported by a socket. This control code is present for backward compatibility with systems where COM is not available or cannot be used for some other reason. This value is equal to the Winsock 2 SIO_ASSOCIATE_HANDLE constant. + + + Replace the oldest queued datagram with an incoming datagram when the incoming message queues are full. This value is equal to the Winsock 2 SIO_ENABLE_CIRCULAR_QUEUEING constant. + + + Discard the contents of the sending queue. This value is equal to the Winsock 2 SIO_FLUSH constant. + + + Return a SOCKADDR structure that contains the broadcast address for the address family of the current socket. The returned address can be used with the method. This value is equal to the Winsock 2 SIO_GET_BROADCAST_ADDRESS constant. This value can be used on User Datagram Protocol (UDP) sockets only. + + + Obtain provider-specific functions that are not part of the Winsock specification. Functions are specified using their provider-assigned GUID. This value is equal to the Winsock 2 SIO_GET_EXTENSION_FUNCTION_POINTER constant. + + + Retrieve the QOS structure associated with the socket. This control is only supported on platforms that provide a QOS capable transport (Windows Me, Windows 2000, and later.) This value is equal to the Winsock 2 SIO_GET_QOS constant. + + + Return the Quality of Service (QOS) attributes for the socket group. This value is reserved for future use, and is equal to the Winsock 2 SIO_GET_GROUP_QOS constant. + + + Control whether multicast data sent by the socket appears as incoming data in the sockets receive queue. This value is equal to the Winsock 2 SIO_MULTIPOINT_LOOPBACK constant. + + + Control the number of times a multicast packet can be forwarded by a router, also known as the Time to Live (TTL), or hop count. This value is equal to the Winsock 2 SIO_MULTICAST_SCOPE constant. + + + Set the Quality of Service (QOS) attributes for the socket. QOS defines the bandwidth requirements for the socket. This control code is supported on Windows Me, Windows 2000, and later operating systems. This value is equal to the Winsock 2 SIO_SET_QOS constant. + + + Set the Quality of Service (QOS) attributes for the socket group. This value is reserved for future use and is equal to the Winsock 2 SIO_SET_GROUP_QOS constant. + + + Return a handle for the socket that is valid in the context of a companion interface. This value is equal to the Winsock 2 SIO_TRANSLATE_HANDLE constant. + + + Return the interface addresses that can be used to connect to the specified remote address. This value is equal to the Winsock 2 SIO_ROUTING_INTERFACE_QUERY constant. + + + Enable receiving notification when the local interface used to access a remote endpoint changes. This value is equal to the Winsock 2 SIO_ROUTING_INTERFACE_CHANGE constant. + + + Return the list of local interfaces that the socket can bind to. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_ADDRESS_LIST_QUERY constant. + + + Enable receiving notification when the list of local interfaces for the socket's protocol family changes. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_ADDRESS_LIST_CHANGE constant. + + + Retrieve the underlying provider's SOCKET handle. This handle can be used to receive plug-and-play event notification. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_QUERY_TARGET_PNP_HANDLE constant. + + + Control whether the socket receives notification when a namespace query becomes invalid. This control code is supported on Windows XP and later operating systems. This value is equal to the Winsock 2 SIO_NSP_NOTIFY_CHANGE constant. + + + Sort the structure returned by the field and add scope ID information for IPv6 addresses. This control code is supported on Windows XP and later operating systems. This value is equal to the Winsock 2 SIO_ADDRESS_LIST_SORT constant. + + + Enable receiving all IPv4 packets on the network. The socket must have address family , the socket type must be , and the protocol type must be . The current user must belong to the Administrators group on the local computer, and the socket must be bound to a specific port. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_RCVALL constant. + + + Enable receiving all multicast IPv4 packets on the network. These are packets with destination addresses in the range 224.0.0.0 through 239.255.255.255. The socket must have address family , the socket type must be , and the protocol type must be . The current user must belong to the Administrators group on the local computer, and the socket must be bound to a specific port. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_RCVALL_MCAST constant. + + + Enable receiving all Internet Group Management Protocol (IGMP) packets on the network. The socket must have address family , the socket type must be , and the protocol type must be . The current user must belong to the Administrators group on the local computer, and the socket must be bound to a specific port. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_RCVALL_IGMPMCAST constant. + + + Control sending TCP keep-alive packets and the interval at which they are sent. This control code is supported on Windows 2000 and later operating systems. For additional information, see RFC 1122 section 4.2.3.6. This value is equal to the Winsock 2 SIO_KEEPALIVE_VALS constant. + + + This value is equal to the Winsock 2 SIO_ABSORB_RTRALERT constant. + + + Set the interface used for outgoing unicast packets. This value is equal to the Winsock 2 SIO_UCAST_IF constant. + + + This value is equal to the Winsock 2 SIO_LIMIT_BROADCASTS constant. + + + Bind the socket to a specified interface index. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_INDEX_BIND constant. + + + Set the interface used for outgoing multicast packets. The interface is identified by its index. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_INDEX_MCASTIF constant. + + + Join a multicast group using an interface identified by its index. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_INDEX_ADD_MCAST constant. + + + Remove the socket from a multicast group. This control code is supported on Windows 2000 and later operating systems. This value is equal to the Winsock 2 SIO_INDEX_ADD_MCAST constant. + + + Presents the packet information from a call to or . + + + Gets the origin information of the packet that was received as a result of calling the method or method. + An that indicates the origin information of the packet that was received as a result of calling the method or method. For packets that were sent from a unicast address, the property will return the of the sender; for multicast or broadcast packets, the property will return the multicast or broadcast . + + + Returns a value that indicates whether this instance is equal to a specified object. + true if is an instance of and equals the value of the instance; otherwise, false. + The object to compare with this instance. + + + Returns the hash code for this instance. + An Int32 hash code. + + + Gets the network interface information that is associated with a call to or . + An value, which represents the index of the network interface. You can use this index with to get more information about the relevant interface. + + + Tests whether two specified instances are equivalent. + true if and are equal; otherwise, false. + The instance that is to the left of the equality operator. + The instance that is to the right of the equality operator. + + + Tests whether two specified instances are not equal. + true if and are unequal; otherwise, false. + The instance that is to the left of the inequality operator. + The instance that is to the right of the inequality operator. + + + A value that enables restriction of an IPv6 socket to a specified scope, such as addresses with the same link local or site local prefix. + + + The IP protection level is unspecified. On Windows 7 and Windows Server 2008 R2, the default value for the IP Protection level on a socket is unspecified. + + + The IP protection level is unrestricted. This value would be used by applications designed to operate across the Internet, including applications taking advantage of IPv6 NAT traversal capabilities built into Windows (Teredo, for example). These applications may bypass IPv4 firewalls, so applications must be hardened against Internet attacks directed at the opened port. On Windows Server 2008 R2 and Windows Vista, the default value for the IP Protection level on a socket is unrestricted. + + + The IP protection level is edge restricted. This value would be used by applications designed to operate across the Internet. This setting does not allow Network Address Translation (NAT) traversal using the Windows Teredo implementation. These applications may bypass IPv4 firewalls, so applications must be hardened against Internet attacks directed at the opened port. On Windows Server 2003 and Windows XP, the default value for the IP Protection level on a socket is edge restricted. + + + The IP protection level is restricted. This value would be used by intranet applications that do not implement Internet scenarios. These applications are generally not tested or hardened against Internet-style attacks. This setting will limit the received traffic to link-local only. + + + Contains option values for joining an IPv6 multicast group. + + + Initializes a new version of the class for the specified IP multicast group. + The of the multicast group. + + is null. + + + Initializes a new instance of the class with the specified IP multicast group and the local interface address. + The group . + The local interface address. + + is less than 0.-or- is greater than 0x00000000FFFFFFFF. + + is null. + + + Gets or sets the IP address of a multicast group. + An that contains the Internet address of a multicast group. + + is null. + + + Gets or sets the interface index that is associated with a multicast group. + A value that specifies the address of the interface. + The value that is specified for a set operation is less than 0 or greater than 0x00000000FFFFFFFF. + + + Specifies whether a will remain connected after a call to the or methods and the length of time it will remain connected, if data remains to be sent. + + + Initializes a new instance of the class. + true to remain connected after the method is called; otherwise, false. + The number of seconds to remain connected after the method is called. + + + Gets or sets a value that indicates whether to linger after the is closed. + true if the should linger after is called; otherwise, false. + + + Gets or sets the amount of time to remain connected after calling the method if data remains to be sent. + The amount of time, in seconds, to remain connected after calling . + + + Contains values used to join and drop multicast groups. + + + Initializes a new version of the class for the specified IP multicast group. + The of the multicast group. + + is null. + + + Initializes a new instance of the class with the specified IP multicast group address and interface index. + The of the multicast group. + The index of the interface that is used to send and receive multicast packets. + + + Initializes a new instance of the class with the specified IP multicast group address and local IP address associated with a network interface. + The group . + The local . + + is null.-or- is null. + + + Gets or sets the IP address of a multicast group. + An that contains the Internet address of a multicast group. + + + Gets or sets the index of the interface that is used to send and receive multicast packets. + An integer that represents the index of a array element. + + + Gets or sets the local address associated with a multicast group. + An that contains the local address associated with a multicast group. + + + Provides the underlying stream of data for network access. + + + Creates a new instance of the class for the specified . + The that the will use to send and receive data. + The parameter is null. + The parameter is not connected.-or- The property of the parameter is not .-or- The parameter is in a nonblocking state. + + + Initializes a new instance of the class for the specified with the specified ownership. + The that the will use to send and receive data. + Set to true to indicate that the will take ownership of the ; otherwise, false. + The parameter is null. + The parameter is not connected.-or- the value of the property of the parameter is not .-or- the parameter is in a nonblocking state. + + + Creates a new instance of the class for the specified with the specified access rights. + The that the will use to send and receive data. + A bitwise combination of the values that specify the type of access given to the over the provided . + The parameter is null. + The parameter is not connected.-or- the property of the parameter is not .-or- the parameter is in a nonblocking state. + + + Creates a new instance of the class for the specified with the specified access rights and the specified ownership. + The that the will use to send and receive data. + A bitwise combination of the values that specifies the type of access given to the over the provided . + Set to true to indicate that the will take ownership of the ; otherwise, false. + The parameter is null. + The parameter is not connected.-or- The property of the parameter is not .-or- The parameter is in a nonblocking state. + + + Begins an asynchronous read from the . + An that represents the asynchronous call. + An array of type that is the location in memory to store data read from the . + The location in to begin storing the data. + The number of bytes to read from the . + The delegate that is executed when completes. + An object that contains any additional user-defined data. + The parameter is null. + The parameter is less than 0.-or- The parameter is greater than the length of the paramater.-or- The is less than 0.-or- The is greater than the length of minus the value of the parameter. + The underlying is closed.-or- There was a failure while reading from the network. -or-An error occurred when accessing the socket. See the Remarks section for more information. + The is closed. + + + + + + + + Begins an asynchronous write to a stream. + An that represents the asynchronous call. + An array of type that contains the data to write to the . + The location in to begin sending the data. + The number of bytes to write to the . + The delegate that is executed when completes. + An object that contains any additional user-defined data. + The parameter is null. + The parameter is less than 0.-or- The parameter is greater than the length of .-or- The parameter is less than 0.-or- The parameter is greater than the length of minus the value of the parameter. + The underlying is closed.-or- There was a failure while writing to the network. -or-An error occurred when accessing the socket. See the Remarks section for more information. + The is closed. + + + + + + + + Gets a value that indicates whether the supports reading. + true if data can be read from the stream; otherwise, false. The default value is true. + + + Gets a value that indicates whether the stream supports seeking. This property is not currently supported.This property always returns false. + false in all cases to indicate that cannot seek a specific location in the stream. + + + Indicates whether timeout properties are usable for . + true in all cases. + + + Gets a value that indicates whether the supports writing. + true if data can be written to the ; otherwise, false. The default value is true. + + + Closes the after waiting the specified time to allow data to be sent. + A 32-bit signed integer that specifies the number of milliseconds to wait to send any remaining data before closing. + The parameter is less than -1. + + + Gets a value that indicates whether data is available on the to be read. + true if data is available on the stream to be read; otherwise, false. + The is closed. + The underlying is closed. + Use the property to obtain the specific error code, and refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error. + + + + + + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Handles the end of an asynchronous read. + The number of bytes read from the . + An that represents an asynchronous call. + The parameter is null. + The underlying is closed.-or- An error occurred when accessing the socket. See the Remarks section for more information. + The is closed. + + + + + + + + + Handles the end of an asynchronous write. + The that represents the asynchronous call. + The parameter is null. + The underlying is closed.-or- An error occurred while writing to the network. -or-An error occurred when accessing the socket. See the Remarks section for more information. + The is closed. + + + + + + + + + Releases all resources used by the . + + + Flushes data from the stream. This method is reserved for future use. + + + Gets the length of the data available on the stream. This property is not currently supported and always throws a . + The length of the data available on the stream. + Any use of this property. + + + + + + Gets or sets the current position in the stream. This property is not currently supported and always throws a . + The current position in the stream. + Any use of this property. + + + + + + Reads data from the . + The number of bytes read from the . + An array of type that is the location in memory to store data read from the . + The location in to begin storing the data to. + The number of bytes to read from the . + The parameter is null. + The parameter is less than 0.-or- The parameter is greater than the length of .-or- The parameter is less than 0.-or- The parameter is greater than the length of minus the value of the parameter. -or-An error occurred when accessing the socket. See the Remarks section for more information. + The underlying is closed. + The is closed.-or- There is a failure reading from the network. + + + + + + + + + Gets or sets a value that indicates whether the can be read. + true to indicate that the can be read; otherwise, false. The default value is true. + + + Gets or sets the amount of time that a read operation blocks waiting for data. + A that specifies the amount of time, in milliseconds, that will elapse before a read operation fails. The default value, , specifies that the read operation does not time out. + The value specified is less than or equal to zero and is not . + + + + + + + + Sets the current position of the stream to the given value. This method is not currently supported and always throws a . + The position in the stream. + This parameter is not used. + This parameter is not used. + Any use of this property. + + + Sets the length of the stream. This method always throws a . + This parameter is not used. + Any use of this property. + + + Gets the underlying . + A that represents the underlying network connection. + + + Writes data to the . + An array of type that contains the data to write to the . + The location in from which to start writing data. + The number of bytes to write to the . + The parameter is null. + The parameter is less than 0.-or- The parameter is greater than the length of .-or- The parameter is less than 0.-or- The parameter is greater than the length of minus the value of the parameter. + There was a failure while writing to the network. -or-An error occurred when accessing the socket. See the Remarks section for more information. + The is closed.-or- There was a failure reading from the network. + + + + + + + + + Gets a value that indicates whether the is writable. + true if data can be written to the stream; otherwise, false. The default value is true. + + + Gets or sets the amount of time that a write operation blocks waiting for data. + A that specifies the amount of time, in milliseconds, that will elapse before a write operation fails. The default value, , specifies that the write operation does not time out. + The value specified is less than or equal to zero and is not . + + + + + + + + Specifies the type of protocol that an instance of the class can use. + + + Unknown protocol. + + + Unspecified protocol. + + + Unix local to host protocol. + + + IP version 4 protocol. + + + ARPANET IMP protocol. + + + PUP protocol. + + + MIT CHAOS protocol. + + + Xerox NS protocol. + + + IPX or SPX protocol. + + + ISO protocol. + + + OSI protocol. + + + European Computer Manufacturers Association (ECMA) protocol. + + + DataKit protocol. + + + CCITT protocol, such as X.25. + + + IBM SNA protocol. + + + DECNet protocol. + + + Direct data link protocol. + + + LAT protocol. + + + NSC HyperChannel protocol. + + + AppleTalk protocol. + + + NetBIOS protocol. + + + VoiceView protocol. + + + FireFox protocol. + + + Banyan protocol. + + + Native ATM services protocol. + + + IP version 6 protocol. + + + Microsoft Cluster products protocol. + + + IEEE 1284.4 workgroup protocol. + + + IrDA protocol. + + + Network Designers OSI gateway enabled protocol. + + + MAX protocol. + + + Specifies the protocols that the class supports. + + + Internet Protocol. + + + IPv6 Hop by Hop Options header. + + + Internet Control Message Protocol. + + + Internet Group Management Protocol. + + + Gateway To Gateway Protocol. + + + Internet Protocol version 4. + + + Transmission Control Protocol. + + + PARC Universal Packet Protocol. + + + User Datagram Protocol. + + + Internet Datagram Protocol. + + + Internet Protocol version 6 (IPv6). + + + IPv6 Routing header. + + + IPv6 Fragment header. + + + IPv6 Encapsulating Security Payload header. + + + IPv6 Authentication header. For details, see RFC 2292 section 2.2.1, available at http://www.ietf.org. + + + Internet Control Message Protocol for IPv6. + + + IPv6 No next header. + + + IPv6 Destination Options header. + + + Net Disk Protocol (unofficial). + + + Raw IP packet protocol. + + + Unspecified protocol. + + + Internet Packet Exchange Protocol. + + + Sequenced Packet Exchange protocol. + + + Sequenced Packet Exchange version 2 protocol. + + + Unknown protocol. + + + Defines the polling modes for the method. + + + Read status mode. + + + Write status mode. + + + Error status mode. + + + Represents an element in a array. + + + Initializes a new instance of the class using the specified buffer. + A byte array of data to send using the method. + The parameter cannot be null + + + Initializes a new instance of the class using the specified buffer, buffer offset, and count. + A byte array of data to send using the method. + The offset, in bytes, from the beginning of the to the location in the to start sending the data specified in the parameter. + The number of bytes to send starting from the parameter. If is zero, no bytes are sent. + The parameter cannot be null + The and parameters must be greater than or equal to zero. The and must be less than the size of the buffer + + + Initializes a new instance of the class using the specified buffer, buffer offset, and count with an option to combine this element with the next element in a single send request from the sockets layer to the transport. + A byte array of data to send using the method. + The offset, in bytes, from the beginning of the to the location in the to start sending the data specified in the parameter. + The number bytes to send starting from the parameter. If is zero, no bytes are sent. + A Boolean value that specifies that this element should not be combined with the next element in a single send request from the sockets layer to the transport. This flag is used for granular control of the content of each message on a datagram or message-oriented socket. + The parameter cannot be null + The and parameters must be greater than or equal to zero. The and must be less than the size of the buffer + + + Initializes a new instance of the class using the specified file. + The filename of the file to be transmitted using the method. + The parameter cannot be null + + + Initializes a new instance of the class using the specified filename path, offset, and count. + The filename of the file to be transmitted using the method. + The offset, in bytes, from the beginning of the file to the location in the file to start sending the file specified in the parameter. + The number of bytes to send starting from the parameter. If is zero, the entire file is sent. + The parameter cannot be null + The and parameters must be greater than or equal to zero. The and must be less than the size of the file indicated by the parameter. + + + Initializes a new instance of the class using the specified filename path, buffer offset, and count with an option to combine this element with the next element in a single send request from the sockets layer to the transport. + The filename of the file to be transmitted using the method. + The offset, in bytes, from the beginning of the file to the location in the file to start sending the file specified in the parameter. + The number of bytes to send starting from the parameter. If is zero, the entire file is sent. + A Boolean value that specifies that this element should not be combined with the next element in a single send request from the sockets layer to the transport. This flag is used for granular control of the content of each message on a datagram or message-oriented socket. + The parameter cannot be null + The and parameters must be greater than or equal to zero. The and must be less than the size of the file indicated by the parameter. + + + Gets the buffer to be sent if the class was initialized with a parameter. + The byte buffer to send if the class was initialized with a parameter. + + + Gets the count of bytes to be sent. + The count of bytes to send if the class was initialized with a parameter. + + + Gets a Boolean value that indicates if this element should not be combined with the next element in a single send request from the sockets layer to the transport. + A Boolean value that indicates if this element should not be combined with the next element in a single send request. + + + Gets the filename of the file to send if the class was initialized with a parameter. + The filename of the file to send if the class was initialized with a parameter. + + + Gets the offset, in bytes, from the beginning of the data buffer or file to the location in the buffer or file to start sending the data. + The offset, in bytes, from the beginning of the data buffer or file to the location in the buffer or file to start sending the data. + + + Implements the Berkeley sockets interface. + + + Initializes a new instance of the class using the specified address family, socket type and protocol. + One of the values. + One of the values. + One of the values. + The combination of , , and results in an invalid socket. + + + Initializes a new instance of the class using the specified value returned from . + The socket information returned by . + + + Creates a new for a newly created connection. + A for a newly created connection. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + The accepting socket is not listening for connections. You must call and before calling . + + + + + + + + + Begins an asynchronous operation to accept an incoming connection attempt. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation.Returns false if the I/O operation completed synchronously. The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + The object to use for this asynchronous socket operation. + An argument is not valid. This exception occurs if the buffer provided is not large enough. The buffer must be at least 2 * (sizeof(SOCKADDR_STORAGE + 16) bytes. This exception also occurs if multiple buffers are specified, the property is not null. + An argument is out of range. The exception occurs if the is less than 0. + An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. You must call the and method before calling the method.This exception also occurs if the socket is already connected or a socket operation was already in progress using the specified parameter. + An error occurred when attempting to access the socket. See the Remarks section for more information. + Windows XP or later is required for this method. + The has been closed. + + + Gets the address family of the . + One of the values. + + + Gets the amount of data that has been received from the network and is available to be read. + The number of bytes of data received from the network and available to be read. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Begins an asynchronous operation to accept an incoming connection attempt. + An that references the asynchronous creation. + The delegate. + An object that contains state information for this request. + The object has been closed. + Windows NT is required for this method. + The accepting socket is not listening for connections. You must call and before calling .-or- The accepted socket is bound. + + is less than 0. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + + + + + + Begins an asynchronous operation to accept an incoming connection attempt and receives the first block of data sent by the client application. + An that references the asynchronous creation. + The number of bytes to accept from the sender. + The delegate. + An object that contains state information for this request. + The object has been closed. + Windows NT is required for this method. + The accepting socket is not listening for connections. You must call and before calling .-or- The accepted socket is bound. + + is less than 0. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + + + + + + Begins an asynchronous operation to accept an incoming connection attempt from a specified socket and receives the first block of data sent by the client application. + An object that references the asynchronous object creation. + The accepted object. This value may be null. + The maximum number of bytes to receive. + The delegate. + An object that contains state information for this request. + The object has been closed. + Windows NT is required for this method. + The accepting socket is not listening for connections. You must call and before calling .-or- The accepted socket is bound. + + is less than 0. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + + + + + + Begins an asynchronous request for a remote host connection. + An that references the asynchronous connection. + An that represents the remote host. + The delegate. + An object that contains state information for this request. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + The is ing. + + + + + + + + + + Begins an asynchronous request for a remote host connection. The host is specified by an and a port number. + An that references the asynchronous connection. + The of the remote host. + The port number of the remote host. + An delegate that references the method to invoke when the connect operation is complete. + A user-defined object that contains information about the connect operation. This object is passed to the delegate when the operation is complete. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + The is not in the socket family. + The port number is not valid. + The length of is zero. + The is ing. + + + + + + + + + + Begins an asynchronous request for a remote host connection. The host is specified by an array and a port number. + An that references the asynchronous connections. + At least one , designating the remote host. + The port number of the remote host. + An delegate that references the method to invoke when the connect operation is complete. + A user-defined object that contains information about the connect operation. This object is passed to the delegate when the operation is complete. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + This method is valid for sockets that use or . + The port number is not valid. + The length of is zero. + The is ing. + + + + + + + + + + Begins an asynchronous request for a remote host connection. The host is specified by a host name and a port number. + An that references the asynchronous connection. + The name of the remote host. + The port number of the remote host. + An delegate that references the method to invoke when the connect operation is complete. + A user-defined object that contains information about the connect operation. This object is passed to the delegate when the operation is complete. + + is null. + The has been closed. + This method is valid for sockets in the or families. + The port number is not valid. + The is ing. + + + + + + + + + + Begins an asynchronous request to disconnect from a remote endpoint. + An object that references the asynchronous operation. + true if this socket can be reused after the connection is closed; otherwise, false. + The delegate. + An object that contains state information for this request. + The operating system is Windows 2000 or earlier, and this method requires Windows XP. + The object has been closed. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + + + + + Begins to asynchronously receive data from a connected . + An that references the asynchronous read. + An array of type that is the storage location for the received data. + The zero-based position in the parameter at which to store the received data. + The number of bytes to receive. + A bitwise combination of the values. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the receive operation. This object is passed to the delegate when the operation is complete. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + has been closed. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + + + + + + + + Begins to asynchronously receive data from a connected . + An that references the asynchronous read. + An array of type that is the storage location for the received data. + The location in to store the received data. + The number of bytes to receive. + A bitwise combination of the values. + A object that stores the socket error. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the receive operation. This object is passed to the delegate when the operation is complete. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + has been closed. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + + + Begins to asynchronously receive data from a connected . + An that references the asynchronous read. + An array of type that is the storage location for the received data. + A bitwise combination of the values. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the receive operation. This object is passed to the delegate when the operation is complete. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + has been closed. + + + Begins to asynchronously receive data from a connected . + An that references the asynchronous read. + An array of type that is the storage location for the received data. + A bitwise combination of the values. + A object that stores the socket error. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the receive operation. This object is passed to the delegate when the operation is complete. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + has been closed. + + + Begins to asynchronously receive data from a specified network device. + An that references the asynchronous read. + An array of type that is the storage location for the received data. + The zero-based position in the parameter at which to store the data. + The number of bytes to receive. + A bitwise combination of the values. + An that represents the source of the data. + The delegate. + An object that contains state information for this request. + + is null.-or- is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + + + + + + + + + Begins to asynchronously receive the specified number of bytes of data into the specified location of the data buffer, using the specified , and stores the endpoint and packet information.. + An that references the asynchronous read. + An array of type that is the storage location for the received data. + The zero-based position in the parameter at which to store the data. + The number of bytes to receive. + A bitwise combination of the values. + An that represents the source of the data. + The delegate. + An object that contains state information for this request. + + is null.-or- is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + The has been closed. + The operating system is Windows 2000 or earlier, and this method requires Windows XP. + + + Sends data asynchronously to a connected . + An that references the asynchronous send. + An array of type that contains the data to send. + The zero-based position in the parameter at which to begin sending data. + The number of bytes to send. + A bitwise combination of the values. + The delegate. + An object that contains state information for this request. + + is null. + An error occurred when attempting to access the socket. See remarks section below. + + is less than 0.-or- is less than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + The has been closed. + + + + + + + + Sends data asynchronously to a connected . + An that references the asynchronous send. + An array of type that contains the data to send. + The zero-based position in the parameter at which to begin sending data. + The number of bytes to send. + A bitwise combination of the values. + A object that stores the socket error. + The delegate. + An object that contains state information for this request. + + is null. + An error occurred when attempting to access the socket. See remarks section below. + + is less than 0.-or- is less than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + The has been closed. + + + Sends data asynchronously to a connected . + An that references the asynchronous send. + An array of type that contains the data to send. + A bitwise combination of the values. + The delegate. + An object that contains state information for this request. + + is null. + + is empty. + An error occurred when attempting to access the socket. See remarks section below. + The has been closed. + + + Sends data asynchronously to a connected . + An that references the asynchronous send. + An array of type that contains the data to send. + A bitwise combination of the values. + A object that stores the socket error. + The delegate. + An object that contains state information for this request. + + is null. + + is empty. + An error occurred when attempting to access the socket. See remarks section below. + The has been closed. + + + Sends the file to a connected object using the flag. + An object that represents the asynchronous send. + A string that contains the path and name of the file to send. This parameter can be null. + The delegate. + An object that contains state information for this request. + The object has been closed. + The socket is not connected to a remote host. + The file was not found. + An error occurred when attempting to access the socket. See remarks section below. + + + + + + + Sends a file and buffers of data asynchronously to a connected object. + An object that represents the asynchronous operation. + A string that contains the path and name of the file to be sent. This parameter can be null. + A array that contains data to be sent before the file is sent. This parameter can be null. + A array that contains data to be sent after the file is sent. This parameter can be null. + A bitwise combination of values. + An delegate to be invoked when this operation completes. This parameter can be null. + A user-defined object that contains state information for this request. This parameter can be null. + The object has been closed. + An error occurred when attempting to access the socket. See remarks section below. + The operating system is not Windows NT or later.- or - The socket is not connected to a remote host. + The file was not found. + + + Sends data asynchronously to a specific remote host. + An that references the asynchronous send. + An array of type that contains the data to send. + The zero-based position in at which to begin sending data. + The number of bytes to send. + A bitwise combination of the values. + An that represents the remote device. + The delegate. + An object that contains state information for this request. + + is null.-or- is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + + + + + + + + + Associates a with a local endpoint. + The local to associate with the . + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + + + + + + + + + Gets or sets a value that indicates whether the is in blocking mode. + true if the will block; otherwise, false. The default is true. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Cancels an asynchronous request for a remote host connection. + The object used to request the connection to the remote host by calling one of the methods. + The parameter cannot be null and the cannot be null. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + + + Closes the connection and releases all associated resources. + + + + + + + + Closes the connection and releases all associated resources with a specified timeout to allow queued data to be sent. + Wait up to seconds to send any remaining data, then close the socket. + + + + + + + + Establishes a connection to a remote host. + An that represents the remote device. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + The is ing. + + + + + + + + + + Establishes a connection to a remote host. The host is specified by an IP address and a port number. + The IP address of the remote host. + The port number of the remote host. + + is null. + The port number is not valid. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + This method is valid for sockets in the or families. + The length of is zero. + The is ing. + + + + + + + + + + Establishes a connection to a remote host. The host is specified by an array of IP addresses and a port number. + The IP addresses of the remote host. + The port number of the remote host. + + is null. + The port number is not valid. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + This method is valid for sockets in the or families. + The length of is zero. + The is ing. + + + + + + + + + + Establishes a connection to a remote host. The host is specified by a host name and a port number. + The name of the remote host. + The port number of the remote host. + + is null. + The port number is not valid. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + This method is valid for sockets in the or families. + The is ing. + + + + + + + + + + Begins an asynchronous request for a remote host connection. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation. Returns false if the I/O operation completed synchronously. In this case, The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + The object to use for this asynchronous socket operation. + An argument is not valid. This exception occurs if multiple buffers are specified, the property is not null. + The parameter cannot be null and the cannot be null. + The is listening or a socket operation was already in progress using the object specified in the parameter. + An error occurred when attempting to access the socket. See the Remarks section for more information. + Windows XP or later is required for this method. This exception also occurs if the local endpoint and the are not the same address family. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + + + Begins an asynchronous request for a remote host connection. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation. Returns false if the I/O operation completed synchronously. In this case, The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + One of the values. + One of the values. + The object to use for this asynchronous socket operation. + An argument is not valid. This exception occurs if multiple buffers are specified, the property is not null. + The parameter cannot be null and the cannot be null. + The is listening or a socket operation was already in progress using the object specified in the parameter. + An error occurred when attempting to access the socket. See the Remarks section for more information. + Windows XP or later is required for this method. This exception also occurs if the local endpoint and the are not the same address family. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + + + Gets a value that indicates whether a is connected to a remote host as of the last or operation. + true if the was connected to a remote resource as of the most recent operation; otherwise, false. + + + Closes the socket connection and allows reuse of the socket. + true if this socket can be reused after the current connection is closed; otherwise, false. + This method requires Windows 2000 or earlier, or the exception will be thrown. + The object has been closed. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + + + + + Begins an asynchronous request to disconnect from a remote endpoint. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation. Returns false if the I/O operation completed synchronously. In this case, The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + The object to use for this asynchronous socket operation. + The parameter cannot be null. + A socket operation was already in progress using the object specified in the parameter. + Windows XP or later is required for this method. + The has been closed. + An error occurred when attempting to access the socket. + + + Releases all resources used by the current instance of the class. + + + Releases the unmanaged resources used by the , and optionally disposes of the managed resources. + true to release both managed and unmanaged resources; false to releases only unmanaged resources. + + + Gets or sets a value that specifies whether the allows Internet Protocol (IP) datagrams to be fragmented. + true if the allows datagram fragmentation; otherwise, false. The default is true. + This property can be set only for sockets in the or families. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Duplicates the socket reference for the target process, and closes the socket for this process. + The socket reference to be passed to the target process. + The ID of the target process where a duplicate of the socket reference is created. + + is not a valid process id.-or- Duplication of the socket reference failed. + + + Gets or sets a value that specifies whether the can send or receive broadcast packets. + true if the allows broadcast packets; otherwise, false. The default is false. + This option is valid for a datagram socket only. + The has been closed. + + + + + + + + Asynchronously accepts an incoming connection attempt and creates a new object to handle remote host communication. This method returns a buffer that contains the initial data transferred. + A object to handle communication with the remote host. + An array of type that contains the bytes transferred. + An object that stores state information for this asynchronous operation as well as any user defined data. + Windows NT is required for this method. + The object has been closed. + + is empty. + + was not created by a call to . + + method was previously called. + An error occurred when attempting to access the See the Remarks section for more information. + + + + + + + + + Asynchronously accepts an incoming connection attempt and creates a new object to handle remote host communication. This method returns a buffer that contains the initial data and the number of bytes transferred. + A object to handle communication with the remote host. + An array of type that contains the bytes transferred. + The number of bytes transferred. + An object that stores state information for this asynchronous operation as well as any user defined data. + Windows NT is required for this method. + The object has been closed. + + is empty. + + was not created by a call to . + + method was previously called. + An error occurred when attempting to access the . See the Remarks section for more information. + + + + + + + + + Asynchronously accepts an incoming connection attempt and creates a new to handle remote host communication. + A to handle communication with the remote host. + An that stores state information for this asynchronous operation as well as any user defined data. + + is null. + + was not created by a call to . + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + method was previously called. + Windows NT is required for this method. + + + + + + + + + Ends a pending asynchronous connection request. + An that stores state information and any user defined data for this asynchronous operation. + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous connection. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Ends a pending asynchronous disconnect request. + An object that stores state information and any user-defined data for this asynchronous operation. + The operating system is Windows 2000 or earlier, and this method requires Windows XP. + The object has been closed. + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous connection. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The disconnect request has timed out. + + + + + + + + Ends a pending asynchronous read. + The number of bytes received. + An that stores state information and any user defined data for this asynchronous operation. + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous read. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + Ends a pending asynchronous read. + The number of bytes received. + An that stores state information and any user defined data for this asynchronous operation. + A object that stores the socket error. + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous read. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + Ends a pending asynchronous read from a specific endpoint. + If successful, the number of bytes received. If unsuccessful, returns 0. + An that stores state information and any user defined data for this asynchronous operation. + The source . + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous read. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + Ends a pending asynchronous read from a specific endpoint. This method also reveals more information about the packet than . + If successful, the number of bytes received. If unsuccessful, returns 0. + An that stores state information and any user defined data for this asynchronous operation. + A bitwise combination of the values for the received packet. + The source . + The and interface of the received packet. + + is null-or- is null. + + was not returned by a call to the method. + + was previously called for the asynchronous read. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + Ends a pending asynchronous send. + If successful, the number of bytes sent to the ; otherwise, an invalid error. + An that stores state information for this asynchronous operation. + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous send. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + Ends a pending asynchronous send. + If successful, the number of bytes sent to the ; otherwise, an invalid error. + An that stores state information for this asynchronous operation. + A object that stores the socket error. + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous send. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + Ends a pending asynchronous send of a file. + An object that stores state information for this asynchronous operation. + Windows NT is required for this method. + The object has been closed. + + is empty. + + was not returned by a call to the method. + + was previously called for the asynchronous . + An error occurred when attempting to access the socket. See remarks section below. + + + + + + + + Ends a pending asynchronous send to a specific location. + If successful, the number of bytes sent; otherwise, an invalid error. + An that stores state information and any user defined data for this asynchronous operation. + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous send. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + Gets or sets a value that specifies whether the allows only one process to bind to a port. + true if the allows only one socket to bind to a specific port; otherwise, false. The default is true for Windows Server 2003 and Windows XP Service Pack 2, and false for all other versions. + An error occurred when attempting to access the socket. + The has been closed. + + has been called for this . + + + + + + + + Frees resources used by the class. + + + Returns the value of a specified option, represented as an object. + An object that represents the value of the option. When the parameter is set to the return value is an instance of the class. When is set to or , the return value is an instance of the class. When is any other value, the return value is an integer. + One of the values. + One of the values. + An error occurred when attempting to access the socket. See the Remarks section for more information.-or- was set to the unsupported value . + The has been closed. + + + + + + + + Returns the specified option setting, represented as a byte array. + One of the values. + One of the values. + An array of type that is to receive the option setting. + An error occurred when attempting to access the socket. See the Remarks section for more information. - or -In .NET Compact Framework applications, the Windows CE default buffer space is set to 32768 bytes. You can change the per socket buffer space by calling . + The has been closed. + + + + + + + + Returns the value of the specified option in an array. + An array of type that contains the value of the socket option. + One of the values. + One of the values. + The length, in bytes, of the expected return value. + An error occurred when attempting to access the socket. See the Remarks section for more information. - or -In .NET Compact Framework applications, the Windows CE default buffer space is set to 32768 bytes. You can change the per socket buffer space by calling . + The has been closed. + + + + + + + + Gets the operating system handle for the . + An that represents the operating system handle for the . + + + + + + Sets low-level operating modes for the using numerical control codes. + The number of bytes in the parameter. + An value that specifies the control code of the operation to perform. + A array that contains the input data required by the operation. + A array that contains the output data returned by the operation. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + An attempt was made to change the blocking mode without using the property. + A caller in the call stack does not have the required permissions. + + + + + + + + Sets low-level operating modes for the using the enumeration to specify control codes. + The number of bytes in the parameter. + A value that specifies the control code of the operation to perform. + An array of type that contains the input data required by the operation. + An array of type that contains the output data returned by the operation. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + An attempt was made to change the blocking mode without using the property. + + + + + + + + Gets a value that indicates whether the is bound to a specific local port. + true if the is bound to a local port; otherwise, false. + + + Gets or sets a value that specifies whether the will delay closing a socket in an attempt to send all pending data. + A that specifies how to linger while closing a socket. + An error occurred when attempting to access the socket. + The has been closed. + + + + + + + + Places a in a listening state. + The maximum length of the pending connections queue. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Gets the local endpoint. + The that the is using for communications. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Gets or sets a value that specifies whether outgoing multicast packets are delivered to the sending application. + true if the receives outgoing multicast packets; otherwise, false. + An error occurred when attempting to access the socket. + The has been closed. + + + + + + + + Gets or sets a value that specifies whether the stream is using the Nagle algorithm. + false if the uses the Nagle algorithm; otherwise, true. The default is false. + An error occurred when attempting to access the . See the Remarks section for more information. + The has been closed. + + + + + + + + Indicates whether the underlying operating system and network adaptors support Internet Protocol version 4 (IPv4). + true if the operating system and network adaptors support the IPv4 protocol; otherwise, false. + + + Indicates whether the underlying operating system and network adaptors support Internet Protocol version 6 (IPv6). + true if the operating system and network adaptors support the IPv6 protocol; otherwise, false. + + + Determines the status of the . + The status of the based on the polling mode value passed in the parameter.Mode Return Value true if has been called and a connection is pending; -or- true if data is available for reading; -or- true if the connection has been closed, reset, or terminated; otherwise, returns false. true, if processing a , and the connection has succeeded; -or- true if data can be sent; otherwise, returns false. true if processing a that does not block, and the connection has failed; -or- true if is not set and out-of-band data is available; otherwise, returns false. + The time to wait for a response, in microseconds. + One of the values. + The parameter is not one of the values. + An error occurred when attempting to access the socket. See remarks below. + The has been closed. + + + + + + + + Gets the protocol type of the . + One of the values. + + + Receives data from a bound into a receive buffer. + The number of bytes received. + An array of type that is the storage location for the received data. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller in the call stack does not have the required permissions. + + + + + + + + + Receives the specified number of bytes from a bound into the specified offset position of the receive buffer, using the specified . + The number of bytes received. + An array of type that is the storage location for received data. + The location in to store the received data. + The number of bytes to receive. + A bitwise combination of the values. + + is null. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + + is not a valid combination of values.-or- The property was not set.-or- An operating system error occurs while accessing the . + The has been closed. + A caller in the call stack does not have the required permissions. + + + + + + + + + Receives data from a bound into a receive buffer, using the specified . + The number of bytes received. + An array of type that is the storage location for the received data. + The position in the parameter to store the received data. + The number of bytes to receive. + A bitwise combination of the values. + A object that stores the socket error. + + is null. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + + is not a valid combination of values.-or- The property is not set.-or- An operating system error occurs while accessing the . + The has been closed. + A caller in the call stack does not have the required permissions. + + + Receives the specified number of bytes of data from a bound into a receive buffer, using the specified . + The number of bytes received. + An array of type that is the storage location for the received data. + The number of bytes to receive. + A bitwise combination of the values. + + is null. + + exceeds the size of . + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller in the call stack does not have the required permissions. + + + + + + + + + Receives data from a bound into a receive buffer, using the specified . + The number of bytes received. + An array of type that is the storage location for the received data. + A bitwise combination of the values. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller in the call stack does not have the required permissions. + + + + + + + + + Receives data from a bound into the list of receive buffers. + The number of bytes received. + A list of s of type that contains the received data. + The parameter is null. + An error occurred while attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + Receives data from a bound into the list of receive buffers, using the specified . + The number of bytes received. + A list of s of type that contains the received data. + A bitwise combination of the values. + + is null.-or-.Count is zero. + An error occurred while attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + Receives data from a bound into the list of receive buffers, using the specified . + The number of bytes received. + A list of s of type that contains the received data. + A bitwise combination of the values. + A object that stores the socket error. + + is null.-or-.Count is zero. + An error occurred while attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + Begins an asynchronous request to receive data from a connected object. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation. Returns false if the I/O operation completed synchronously. In this case, The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + The object to use for this asynchronous socket operation. + An argument was invalid. The or properties on the parameter must reference valid buffers. One or the other of these properties may be set, but not both at the same time. + A socket operation was already in progress using the object specified in the parameter. + Windows XP or later is required for this method. + The has been closed. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + Gets or sets a value that specifies the size of the receive buffer of the . + An that contains the size, in bytes, of the receive buffer. The default is 8192. + An error occurred when attempting to access the socket. + The has been closed. + The value specified for a set operation is less than 0. + + + + + + + + Receives the specified number of bytes of data into the specified location of the data buffer, using the specified , and stores the endpoint. + The number of bytes received. + An array of type that is the storage location for received data. + The position in the parameter to store the received data. + The number of bytes to receive. + A bitwise combination of the values. + An , passed by reference, that represents the remote server. + + is null.-or- is null. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of the minus the value of the offset parameter. + + is not a valid combination of values.-or- The property was not set.-or- An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + + Receives the specified number of bytes into the data buffer, using the specified , and stores the endpoint. + The number of bytes received. + An array of type that is the storage location for received data. + The number of bytes to receive. + A bitwise combination of the values. + An , passed by reference, that represents the remote server. + + is null.-or- is null. + + is less than 0.-or- is greater than the length of . + + is not a valid combination of values.-or- The property was not set.-or- An operating system error occurs while accessing the . + The has been closed. + A caller in the call stack does not have the required permissions. + + + + + + + + + + Receives a datagram into the data buffer and stores the endpoint. + The number of bytes received. + An array of type that is the storage location for received data. + An , passed by reference, that represents the remote server. + + is null.-or- is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller in the call stack does not have the required permissions. + + + + + + + + + + Receives a datagram into the data buffer, using the specified , and stores the endpoint. + The number of bytes received. + An array of type that is the storage location for the received data. + A bitwise combination of the values. + An , passed by reference, that represents the remote server. + + is null.-or- is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller in the call stack does not have the required permissions. + + + + + + + + + + Begins to asynchronously receive data from a specified network device. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation. Returns false if the I/O operation completed synchronously. In this case, The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + The object to use for this asynchronous socket operation. + The cannot be null. + A socket operation was already in progress using the object specified in the parameter. + Windows XP or later is required for this method. + The has been closed. + An error occurred when attempting to access the socket. + + + Receives the specified number of bytes of data into the specified location of the data buffer, using the specified , and stores the endpoint and packet information. + The number of bytes received. + An array of type that is the storage location for received data. + The position in the parameter to store the received data. + The number of bytes to receive. + A bitwise combination of the values. + An , passed by reference, that represents the remote server. + An holding address and interface information. + + is null.- or- is null. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of the minus the value of the offset parameter. + + is not a valid combination of values.-or- The property was not set.-or- The .NET Framework is running on an AMD 64-bit processor.-or- An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + The operating system is Windows 2000 or earlier, and this method requires Windows XP. + + + Begins to asynchronously receive the specified number of bytes of data into the specified location in the data buffer, using the specified , and stores the endpoint and packet information. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation. Returns false if the I/O operation completed synchronously. In this case, The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + The object to use for this asynchronous socket operation. + The cannot be null. + Windows XP or later is required for this method. + The has been closed. + An error occurred when attempting to access the socket. + + + Gets or sets a value that specifies the amount of time after which a synchronous call will time out. + The time-out value, in milliseconds. The default value is 0, which indicates an infinite time-out period. Specifying -1 also indicates an infinite time-out period. + An error occurred when attempting to access the socket. + The has been closed. + The value specified for a set operation is less than -1. + + + + + + + + Gets the remote endpoint. + The with which the is communicating. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Determines the status of one or more sockets. + An of instances to check for readability. + An of instances to check for writability. + An of instances to check for errors. + The time-out value, in microseconds. A -1 value indicates an infinite time-out. + The parameter is null or empty.-and- The parameter is null or empty -and- The parameter is null or empty. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + Sends data to a connected . + The number of bytes sent to the . + An array of type that contains the data to be sent. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + Sends the specified number of bytes of data to a connected , starting at the specified offset, and using the specified . + The number of bytes sent to the . + An array of type that contains the data to be sent. + The position in the data buffer at which to begin sending data. + The number of bytes to send. + A bitwise combination of the values. + + is null. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + + is not a valid combination of values.-or- An operating system error occurs while accessing the . See the Remarks section for more information. + The has been closed. + + + + + + + + + Sends the specified number of bytes of data to a connected , starting at the specified offset, and using the specified + The number of bytes sent to the . + An array of type that contains the data to be sent. + The position in the data buffer at which to begin sending data. + The number of bytes to send. + A bitwise combination of the values. + A object that stores the socket error. + + is null. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + + is not a valid combination of values.-or- An operating system error occurs while accessing the . See the Remarks section for more information. + The has been closed. + + + Sends the specified number of bytes of data to a connected , using the specified . + The number of bytes sent to the . + An array of type that contains the data to be sent. + The number of bytes to send. + A bitwise combination of the values. + + is null. + + is less than 0 or exceeds the size of the buffer. + + is not a valid combination of values.-or- An operating system error occurs while accessing the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + Sends data to a connected using the specified . + The number of bytes sent to the . + An array of type that contains the data to be sent. + A bitwise combination of the values. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + Sends the set of buffers in the list to a connected . + The number of bytes sent to the . + A list of s of type that contains the data to be sent. + + is null. + + is empty. + An error occurred when attempting to access the socket. See remarks section below. + The has been closed. + + + Sends the set of buffers in the list to a connected , using the specified . + The number of bytes sent to the . + A list of s of type that contains the data to be sent. + A bitwise combination of the values. + + is null. + + is empty. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + Sends the set of buffers in the list to a connected , using the specified . + The number of bytes sent to the . + A list of s of type that contains the data to be sent. + A bitwise combination of the values. + A object that stores the socket error. + + is null. + + is empty. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + Sends data asynchronously to a connected object. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation. Returns false if the I/O operation completed synchronously. In this case, The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + The object to use for this asynchronous socket operation. + The or properties on the parameter must reference valid buffers. One or the other of these properties may be set, but not both at the same time. + A socket operation was already in progress using the object specified in the parameter. + Windows XP or later is required for this method. + The has been closed. + The is not yet connected or was not obtained via an , ,or , method. + + + Gets or sets a value that specifies the size of the send buffer of the . + An that contains the size, in bytes, of the send buffer. The default is 8192. + An error occurred when attempting to access the socket. + The has been closed. + The value specified for a set operation is less than 0. + + + + + + + + Sends the file to a connected object with the transmit flag. + A that contains the path and name of the file to be sent. This parameter can be null. + The socket is not connected to a remote host. + The object has been closed. + The object is not in blocking mode and cannot accept this synchronous call. + The file was not found. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + + + + + Sends the file and buffers of data to a connected object using the specified value. + A that contains the path and name of the file to be sent. This parameter can be null. + A array that contains data to be sent before the file is sent. This parameter can be null. + A array that contains data to be sent after the file is sent. This parameter can be null. + One or more of values. + The operating system is not Windows NT or later.- or - The socket is not connected to a remote host. + The object has been closed. + The object is not in blocking mode and cannot accept this synchronous call. + The file was not found. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + Sends a collection of files or in memory data buffers asynchronously to a connected object. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation. Returns false if the I/O operation completed synchronously. In this case, The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + The object to use for this asynchronous socket operation. + The file specified in the property was not found. + A socket operation was already in progress using the object specified in the parameter. + Windows XP or later is required for this method. This exception also occurs if the is not connected to a remote host. + The has been closed. + A connectionless is being used and the file being sent exceeds the maximum packet size of the underlying transport. + + + Gets or sets a value that specifies the amount of time after which a synchronous call will time out. + The time-out value, in milliseconds. If you set the property with a value between 1 and 499, the value will be changed to 500. The default value is 0, which indicates an infinite time-out period. Specifying -1 also indicates an infinite time-out period. + An error occurred when attempting to access the socket. + The has been closed. + The value specified for a set operation is less than -1. + + + + + + + + Sends the specified number of bytes of data to the specified endpoint, starting at the specified location in the buffer, and using the specified . + The number of bytes sent. + An array of type that contains the data to be sent. + The position in the data buffer at which to begin sending data. + The number of bytes to send. + A bitwise combination of the values. + The that represents the destination location for the data. + + is null.-or- is null. + + is less than 0.-or- is greater than the length of .-or- is less than 0.-or- is greater than the length of minus the value of the parameter. + + is not a valid combination of values.-or- An operating system error occurs while accessing the . See the Remarks section for more information. + The has been closed. + A caller in the call stack does not have the required permissions. + + + + + + + + + + Sends the specified number of bytes of data to the specified endpoint using the specified . + The number of bytes sent. + An array of type that contains the data to be sent. + The number of bytes to send. + A bitwise combination of the values. + The that represents the destination location for the data. + + is null.-or- is null. + The specified exceeds the size of . + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + + Sends data to the specified endpoint. + The number of bytes sent. + An array of type that contains the data to be sent. + The that represents the destination for the data. + + is null.-or- is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + + Sends data to a specific endpoint using the specified . + The number of bytes sent. + An array of type that contains the data to be sent. + A bitwise combination of the values. + The that represents the destination location for the data. + + is null.-or- is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + + Sends data asynchronously to a specific remote host. + Returns true if the I/O operation is pending. The event on the parameter will be raised upon completion of the operation. Returns false if the I/O operation completed synchronously. In this case, The event on the parameter will not be raised and the object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. + The object to use for this asynchronous socket operation. + The cannot be null. + A socket operation was already in progress using the object specified in the parameter. + Windows XP or later is required for this method. + The has been closed. + The protocol specified is connection-oriented, but the is not yet connected. + + + Set the IP protection level on a socket. + The IP protection level to set on this socket. + The parameter cannot be . The IP protection level cannot be set to unspecified. + The of the socket must be either or . + + + Sets the specified option to the specified value. + One of the values. + One of the values. + The value of the option, represented as a . + The object has been closed. + An error occurred when attempting to access the socket. See the Remarks section for more information. + + + + + + + + Sets the specified option to the specified value, represented as a byte array. + One of the values. + One of the values. + An array of type that represents the value of the option. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Sets the specified option to the specified integer value. + One of the values. + One of the values. + A value of the option. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Sets the specified option to the specified value, represented as an object. + One of the values. + One of the values. + A or that contains the value of the option. + + is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Disables sends and receives on a . + One of the values that specifies the operation that will no longer be allowed. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Gets the type of the . + One of the values. + + + Gets a value indicating whether IPv4 support is available and enabled on the current host. + true if the current host supports the IPv4 protocol; otherwise, false. + + + Gets a value that indicates whether the Framework supports IPv6 for certain obsolete members. + true if the Framework supports IPv6 for certain obsolete methods; otherwise, false. + + + Gets or sets a value that specifies the Time To Live (TTL) value of Internet Protocol (IP) packets sent by the . + The TTL value. + The TTL value can't be set to a negative number. + This property can be set only for sockets in the or families. + An error occurred when attempting to access the socket. This error is also returned when an attempt was made to set TTL to a value higher than 255. + The has been closed. + + + + + + + + Specifies whether the socket should only use Overlapped I/O mode. + true if the uses only overlapped I/O; otherwise, false. The default is false. + The socket has been bound to a completion port. + + + Represents an asynchronous socket operation. + + + Creates an empty instance. + The platform is not supported. + + + Gets or sets the socket to use or the socket created for accepting a connection with an asynchronous socket method. + The to use or the socket created for accepting a connection with an asynchronous socket method. + + + Gets the data buffer to use with an asynchronous socket method. + A array that represents the data buffer to use with an asynchronous socket method. + + + Gets or sets an array of data buffers to use with an asynchronous socket method. + An that represents an array of data buffers to use with an asynchronous socket method. + There are ambiguous buffers specified on a set operation. This exception occurs if the property has been set to a non-null value and an attempt was made to set the property to a non-null value. + + + Gets the number of bytes transferred in the socket operation. + An that contains the number of bytes transferred in the socket operation. + + + The event used to complete an asynchronous operation. + + + Gets the exception in the case of a connection failure when a was used. + An that indicates the cause of the connection error when a was specified for the property. + + + The created and connected object after successful completion of the method. + The connected object. + + + Gets the maximum amount of data, in bytes, to send or receive in an asynchronous operation. + An that contains the maximum amount of data, in bytes, to send or receive. + + + Gets or sets a value that specifies if socket can be reused after a disconnect operation. + A that specifies if socket can be reused after a disconnect operation. + + + Releases the unmanaged resources used by the instance and optionally disposes of the managed resources. + + + Frees resources used by the class. + + + Gets the type of socket operation most recently performed with this context object. + A instance that indicates the type of socket operation most recently performed with this context object. + + + Gets the offset, in bytes, into the data buffer referenced by the property. + An that contains the offset, in bytes, into the data buffer referenced by the property. + + + Represents a method that is called when an asynchronous operation completes. + The event that is signaled. + + + Gets the IP address and interface of a received packet. + An instance that contains the destination IP address and interface of a received packet. + + + Gets or sets the remote IP endpoint for an asynchronous operation. + An that represents the remote IP endpoint for an asynchronous operation. + + + Gets or sets an array of buffers to be sent for an asynchronous operation used by the method. + An array of objects that represent an array of buffers to be sent. + + + Gets or sets a bitwise combination of values for an asynchronous operation used by the method. + A that contains a bitwise combination of values that are used with an asynchronous operation. + + + Gets or sets the size, in bytes, of the data block used in the send operation. + An that contains the size, in bytes, of the data block used in the send operation. + + + Sets the data buffer to use with an asynchronous socket method. + The data buffer to use with an asynchronous socket method. + The offset, in bytes, in the data buffer where the operation starts. + The maximum amount of data, in bytes, to send or receive in the buffer. + There are ambiguous buffers specified. This exception occurs if the property is also not null and the property is also not null. + An argument was out of range. This exception occurs if the parameter is less than zero or greater than the length of the array in the property. This exception also occurs if the parameter is less than zero or greater than the length of the array in the property minus the parameter. + + + Sets the data buffer to use with an asynchronous socket method. + The offset, in bytes, in the data buffer where the operation starts. + The maximum amount of data, in bytes, to send or receive in the buffer. + An argument was out of range. This exception occurs if the parameter is less than zero or greater than the length of the array in the property. This exception also occurs if the parameter is less than zero or greater than the length of the array in the property minus the parameter. + + + Gets or sets the result of the asynchronous socket operation. + A that represents the result of the asynchronous socket operation. + + + Gets the results of an asynchronous socket operation or sets the behavior of an asynchronous operation. + A that represents the results of an asynchronous socket operation. + + + Gets or sets a user or application object associated with this asynchronous socket operation. + An object that represents the user or application object associated with this asynchronous socket operation. + + + The type of asynchronous socket operation most recently performed with this context object. + + + None of the socket operations. + + + A socket Accept operation. + + + A socket Connect operation. + + + A socket Disconnect operation. + + + A socket Receive operation. + + + A socket ReceiveFrom operation. + + + A socket ReceiveMessageFrom operation. + + + A socket Send operation. + + + A socket SendPackets operation. + + + A socket SendTo operation. + + + Defines error codes for the class. + + + The operation succeeded. + + + An unspecified error has occurred. + + + A blocking call was canceled. + + + An attempt was made to access a in a way that is forbidden by its access permissions. + + + An invalid pointer address was detected by the underlying socket provider. + + + An invalid argument was supplied to a member. + + + There are too many open sockets in the underlying socket provider. + + + An operation on a nonblocking socket cannot be completed immediately. + + + A blocking operation is in progress. + + + The nonblocking already has an operation in progress. + + + A operation was attempted on a non-socket. + + + A required address was omitted from an operation on a . + + + The datagram is too long. + + + The protocol type is incorrect for this . + + + An unknown, invalid, or unsupported option or level was used with a . + + + The protocol is not implemented or has not been configured. + + + The support for the specified socket type does not exist in this address family. + + + The address family is not supported by the protocol family. + + + The protocol family is not implemented or has not been configured. + + + The address family specified is not supported. This error is returned if the IPv6 address family was specified and the IPv6 stack is not installed on the local machine. This error is returned if the IPv4 address family was specified and the IPv4 stack is not installed on the local machine. + + + Only one use of an address is normally permitted. + + + The selected IP address is not valid in this context. + + + The network is not available. + + + No route to the remote host exists. + + + The application tried to set on a connection that has already timed out. + + + The connection was aborted by the .NET Framework or the underlying socket provider. + + + The connection was reset by the remote peer. + + + No free buffer space is available for a operation. + + + The is already connected. + + + The application tried to send or receive data, and the is not connected. + + + A request to send or receive data was disallowed because the has already been closed. + + + The connection attempt timed out, or the connected host has failed to respond. + + + The remote host is actively refusing a connection. + + + The operation failed because the remote host is down. + + + There is no network route to the specified host. + + + Too many processes are using the underlying socket provider. + + + The network subsystem is unavailable. + + + The version of the underlying socket provider is out of range. + + + The underlying socket provider has not been initialized. + + + A graceful shutdown is in progress. + + + The specified class was not found. + + + No such host is known. The name is not an official host name or alias. + + + The name of the host could not be resolved. Try again later. + + + The error is unrecoverable or the requested database cannot be located. + + + The requested name or IP address was not found on the name server. + + + The application has initiated an overlapped operation that cannot be completed immediately. + + + The overlapped operation was aborted due to the closure of the . + + + The exception that is thrown when a socket error occurs. + + + Initializes a new instance of the class with the last operating system error code. + + + Initializes a new instance of the class with the specified error code. + The error code that indicates the error that occurred. + + + Initializes a new instance of the class from the specified instances of the and classes. + A instance that contains the information that is required to serialize the new instance. + A that contains the source of the serialized stream that is associated with the new instance. + + + Gets the error code that is associated with this exception. + An integer error code that is associated with this exception. + + + Gets the error message that is associated with this exception. + A string that contains the error message. + + + Gets the error code that is associated with this exception. + An integer error code that is associated with this exception. + + + Specifies socket send and receive behaviors. + + + Use no flags for this call. + + + Process out-of-band data. + + + Peek at the incoming message. + + + Send without using routing tables. + + + Provides a standard value for the number of WSABUF structures that are used to send and receive data. + + + The message was too large to fit into the specified buffer and was truncated. + + + Indicates that the control data did not fit into an internal 64-KB buffer and was truncated. + + + Indicates a broadcast packet. + + + Indicates a multicast packet. + + + Partial send or receive for message. + + + Encapsulates the information that is necessary to duplicate a . + + + Gets or sets the options for a . + A instance. + + + Gets or sets the protocol information for a . + An array of type . + + + Describes states for a . + + + The is nonblocking. + + + The is connected. + + + The is listening for new connections. + + + The uses overlapped I/O. + + + Defines socket option levels for the and methods. + + + + options apply to all sockets. + + + + options apply only to IP sockets. + + + + options apply only to IPv6 sockets. + + + + options apply only to TCP sockets. + + + + options apply only to UDP sockets. + + + Defines configuration option names. + + + Record debugging information. + + + The socket is listening. + + + Allows the socket to be bound to an address that is already in use. + + + Use keep-alives. + + + Do not route; send the packet directly to the interface addresses. + + + Permit sending broadcast messages on the socket. + + + Bypass hardware when possible. + + + Linger on close if unsent data is present. + + + Receives out-of-band data in the normal data stream. + + + Close the socket gracefully without lingering. + + + Enables a socket to be bound for exclusive access. + + + Specifies the total per-socket buffer space reserved for sends. This is unrelated to the maximum message size or the size of a TCP window. + + + Specifies the total per-socket buffer space reserved for receives. This is unrelated to the maximum message size or the size of a TCP window. + + + Specifies the low water mark for operations. + + + Specifies the low water mark for operations. + + + Send a time-out. This option applies only to synchronous methods; it has no effect on asynchronous methods such as the method. + + + Receive a time-out. This option applies only to synchronous methods; it has no effect on asynchronous methods such as the method. + + + Get the error status and clear. + + + Get the socket type. + + + Not supported; will throw a if used. + + + Specifies the IP options to be inserted into outgoing datagrams. + + + Indicates that the application provides the IP header for outgoing datagrams. + + + Change the IP header type of the service field. + + + Set the IP header Time-to-Live field. + + + Set the interface for outgoing multicast packets. + + + An IP multicast Time to Live. + + + An IP multicast loopback. + + + Add an IP group membership. + + + Drop an IP group membership. + + + Do not fragment IP datagrams. + + + Join a source group. + + + Drop a source group. + + + Block data from a source. + + + Unblock a previously blocked source. + + + Return information about received packets. + + + Specifies the maximum number of router hops for an Internet Protocol version 6 (IPv6) packet. This is similar to Time to Live (TTL) for Internet Protocol version 4. + + + Enables restriction of a IPv6 socket to a specified scope, such as addresses with the same link local or site local prefix.This socket option enables applications to place access restrictions on IPv6 sockets. Such restrictions enable an application running on a private LAN to simply and robustly harden itself against external attacks. This socket option widens or narrows the scope of a listening socket, enabling unrestricted access from public and private users when appropriate, or restricting access only to the same site, as required. This socket option has defined protection levels specified in the enumeration. + + + Indicates if a socket created for the AF_INET6 address family is restricted to IPv6 communications only. Sockets created for the AF_INET6 address family may be used for both IPv6 and IPv4 communications. Some applications may want to restrict their use of a socket created for the AF_INET6 address family to IPv6 communications only. When this value is non-zero (the default on Windows), a socket created for the AF_INET6 address family can be used to send and receive IPv6 packets only. When this value is zero, a socket created for the AF_INET6 address family can be used to send and receive packets to and from an IPv6 address or an IPv4 address. Note that the ability to interact with an IPv4 address requires the use of IPv4 mapped addresses. This socket option is supported on Windows Vista or later. + + + Disables the Nagle algorithm for send coalescing. + + + Use urgent data as defined in RFC-1222. This option can be set only once; after it is set, it cannot be turned off. + + + Use expedited data as defined in RFC-1222. This option can be set only once; after it is set, it cannot be turned off. + + + Send UDP datagrams with checksum set to zero. + + + Set or get the UDP checksum coverage. + + + Updates an accepted socket's properties by using those of an existing socket. This is equivalent to using the Winsock2 SO_UPDATE_ACCEPT_CONTEXT socket option and is supported only on connection-oriented sockets. + + + Updates a connected socket's properties by using those of an existing socket. This is equivalent to using the Winsock2 SO_UPDATE_CONNECT_CONTEXT socket option and is supported only on connection-oriented sockets. + + + Defines constants that are used by the method. + + + Disables a for receiving. This field is constant. + + + Disables a for sending. This field is constant. + + + Disables a for both sending and receiving. This field is constant. + + + Specifies the type of socket that an instance of the class represents. + + + Supports reliable, two-way, connection-based byte streams without the duplication of data and without preservation of boundaries. A Socket of this type communicates with a single peer and requires a remote host connection before communication can begin. uses the Transmission Control Protocol () and the InterNetwork. + + + Supports datagrams, which are connectionless, unreliable messages of a fixed (typically small) maximum length. Messages might be lost or duplicated and might arrive out of order. A of type requires no connection prior to sending and receiving data, and can communicate with multiple peers. uses the Datagram Protocol () and the . + + + Supports access to the underlying transport protocol. Using the , you can communicate using protocols like Internet Control Message Protocol () and Internet Group Management Protocol (). Your application must provide a complete IP header when sending. Received datagrams return with the IP header and options intact. + + + Supports connectionless, message-oriented, reliably delivered messages, and preserves message boundaries in data. Rdm (Reliably Delivered Messages) messages arrive unduplicated and in order. Furthermore, the sender is notified if messages are lost. If you initialize a Socket using , you do not require a remote host connection before sending and receiving data. With , you can communicate with multiple peers. + + + Provides connection-oriented and reliable two-way transfer of ordered byte streams across a network. does not duplicate data, and it preserves boundaries within the data stream. A Socket of type communicates with a single peer and requires a remote host connection before communication can begin. + + + Specifies an unknown Socket type. + + + Provides client connections for TCP network services. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class and binds it to the specified local endpoint. + The to which you bind the TCP . + The parameter is null. + + + Initializes a new instance of the class with the specified family. + The of the IP protocol. + The parameter is not equal to AddressFamily.InterNetwork -or- The parameter is not equal to AddressFamily.InterNetworkV6 + + + Initializes a new instance of the class and connects to the specified port on the specified host. + The DNS name of the remote host to which you intend to connect. + The port number of the remote host to which you intend to connect. + The parameter is null. + The parameter is not between and . + An error occurred when accessing the socket. See the Remarks section for more information. + + + Gets or set a value that indicates whether a connection has been made. + true if the connection has been made; otherwise, false. + + + Gets the amount of data that has been received from the network and is available to be read. + The number of bytes of data received from the network and available to be read. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Begins an asynchronous request for a remote host connection. The remote host is specified by an and a port number (). + An object that references the asynchronous connection. + The of the remote host. + The port number of the remote host. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the connect operation. This object is passed to the delegate when the operation is complete. + The parameter is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + The port number is not valid. + + + + + + + + + + Begins an asynchronous request for a remote host connection. The remote host is specified by an array and a port number (). + An object that references the asynchronous connection. + At least one that designates the remote hosts. + The port number of the remote hosts. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the connect operation. This object is passed to the delegate when the operation is complete. + The parameter is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + The port number is not valid. + + + + + + + + + + Begins an asynchronous request for a remote host connection. The remote host is specified by a host name () and a port number (). + An object that references the asynchronous connection. + The name of the remote host. + The port number of the remote host. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the connect operation. This object is passed to the delegate when the operation is complete. + The parameter is null. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + The port number is not valid. + + + + + + + + + + Gets or sets the underlying . + The underlying network . + + + Disposes this instance and requests that the underlying TCP connection be closed. + + + + + + + + Connects the client to a remote TCP host using the specified IP address and port number. + The of the host to which you intend to connect. + The port number to which you intend to connect. + The parameter is null. + The is not between and . + An error occurred when accessing the socket. See the Remarks section for more information. + + is closed. + + + + + + + + + + Connects the client to a remote TCP host using the specified IP addresses and port number. + The array of the host to which you intend to connect. + The port number to which you intend to connect. + The parameter is null. + The port number is not valid. + An error occurred when attempting to access the socket. See the Remarks section for more information. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. + This method is valid for sockets that use the flag or the flag. + + + + + + + + + + Connects the client to a remote TCP host using the specified remote network endpoint. + The to which you intend to connect. + The parameter is null. + An error occurred when accessing the socket. See the Remarks section for more information. + The is closed. + + + + + + + + + + Connects the client to the specified port on the specified host. + The DNS name of the remote host to which you intend to connect. + The port number of the remote host to which you intend to connect. + The parameter is null. + The parameter is not between and . + An error occurred when accessing the socket. See the Remarks section for more information. + + is closed. + + + + + + + + + + Gets a value indicating whether the underlying for a is connected to a remote host. + true if the socket was connected to a remote resource as of the most recent operation; otherwise, false. + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + Set to true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Asynchronously accepts an incoming connection attempt. + An object returned by a call to . + The parameter is null. + The parameter was not returned by a call to a method. + The method was previously called for the asynchronous connection. + An error occurred when attempting to access the . See the Remarks section for more information. + The underlying has been closed. + + + + + + + + Gets or sets a value that specifies whether the allows only one client to use a port. + true if the allows only one client to use a specific port; otherwise, false. The default is true for Windows Server 2003 and Windows XP Service Pack 2 and later, and false for all other versions. + An error occurred when attempting to access the underlying socket. + The underlying has been closed. + + + + + + + + Frees resources used by the class. + + + Returns the used to send and receive data. + The underlying . + The is not connected to a remote host. + The has been closed. + + + + + + + + Gets or sets information about the linger state of the associated socket. + A . By default, lingering is disabled. + + + + + + + + Gets or sets a value that disables a delay when send or receive buffers are not full. + true if the delay is disabled, otherwise false. The default value is false. + + + + + + + + Gets or sets the size of the receive buffer. + The size of the receive buffer, in bytes. The default value is 8192 bytes. + An error occurred when setting the buffer size.-or-In .NET Compact Framework applications, you cannot set this property. For a workaround, see the Platform Note in Remarks. + + + + + + + + Gets or sets the amount of time a will wait to receive data once a read operation is initiated. + The time-out value of the connection in milliseconds. The default value is 0. + + + + + + + + Gets or sets the size of the send buffer. + The size of the send buffer, in bytes. The default value is 8192 bytes. + + + + + + + + Gets or sets the amount of time a will wait for a send operation to complete successfully. + The send time-out value, in milliseconds. The default is 0. + + + + + + + + Releases all resources used by the . + + + Listens for connections from TCP network clients. + + + Initializes a new instance of the class that listens on the specified port. + The port on which to listen for incoming connection attempts. + + is not between and . + + + Initializes a new instance of the class that listens for incoming connection attempts on the specified local IP address and port number. + An that represents the local IP address. + The port on which to listen for incoming connection attempts. + + is null. + + is not between and . + + + Initializes a new instance of the class with the specified local endpoint. + An that represents the local endpoint to which to bind the listener . + + is null. + + + Accepts a pending connection request. + A used to send and receive data. + The listener has not been started with a call to . + + + + + + + + + Accepts a pending connection request + A used to send and receive data. + The listener has not been started with a call to . + Use the property to obtain the specific error code. When you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error. + + + + + + + + + Gets a value that indicates whether is actively listening for client connections. + true if is actively listening; otherwise, false. + + + Enables or disables Network Address Translation (NAT) traversal on a instance. + A Boolean value that specifies whether to enable or disable NAT traversal. + The method was called after calling the method + + + Begins an asynchronous operation to accept an incoming connection attempt. + An that references the asynchronous creation of the . + An delegate that references the method to invoke when the operation is complete. + A user-defined object containing information about the accept operation. This object is passed to the delegate when the operation is complete. + An error occurred while attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + Begins an asynchronous operation to accept an incoming connection attempt. + An that references the asynchronous creation of the . + An delegate that references the method to invoke when the operation is complete. + A user-defined object containing information about the accept operation. This object is passed to the delegate when the operation is complete. + An error occurred while attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + + Asynchronously accepts an incoming connection attempt and creates a new to handle remote host communication. + A . + An returned by a call to the method. + The underlying has been closed. + The parameter is null. + The parameter was not created by a call to the method. + The method was previously called. + An error occurred while attempting to access the . See the Remarks section for more information. + + + + + + + + + Asynchronously accepts an incoming connection attempt and creates a new to handle remote host communication. + A . + An returned by a call to the method. + + + + + + + + + Gets or sets a value that specifies whether the allows only one underlying socket to listen to a specific port. + true if the allows only one to listen to a specific port; otherwise, false. . The default is true for Windows Server 2003 and Windows XP Service Pack 2 and later, and false for all other versions. + The has been started. Call the method and then set the property. + An error occurred when attempting to access the underlying socket. + The underlying has been closed. + + + + + + + + Gets the underlying of the current . + The to which the is bound. + + + + + + + + Determines if there are pending connection requests. + true if connections are pending; otherwise, false. + The listener has not been started with a call to . + + + + + + + + Gets the underlying network . + The underlying . + + + Starts listening for incoming connection requests. + Use the property to obtain the specific error code. When you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error. + + + + + + + + + Starts listening for incoming connection requests with a maximum number of pending connection. + The maximum length of the pending connections queue. + An error occurred while accessing the socket. See the Remarks section for more information. + The parameter is less than zero or exceeds the maximum number of permitted connections. + The underlying is null. + + + + + + + + + Closes the listener. + Use the property to obtain the specific error code. When you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error. + + + + + + + + The enumeration defines values used in file transfer requests. + + + Use the default thread to process long file transfer requests. + + + Start a transport-level disconnect after all the file data has been queued for transmission. When used with , these flags return the socket to a disconnected, reusable state after the file has been transmitted. + + + The socket handle may be reused when the request completes. This flag is valid only if is also specified. When used with , these flags return the socket to a disconnected, reusable state after the file has been transmitted. + + + Complete the file transfer request immediately, without pending. If this flag is specified and the file transfer succeeds, the data has been accepted by the system but not necessarily acknowledged by the remote end. Do not use this flag with the and flags. + + + Use system threads to process long file transfer requests. + + + Use kernel asynchronous procedure calls (APCs) instead of worker threads to process long file transfer requests. Long requests are defined as requests that require more than a single read from the file or a cache; the request therefore depends on the size of the file and the specified length of the send packet. + + + Provides User Datagram Protocol (UDP) network services. + + + Initializes a new instance of the class. + An error occurred when accessing the socket. See the Remarks section for more information. + + + Initializes a new instance of the class and binds it to the local port number provided. + The local port number from which you intend to communicate. + The parameter is greater than or less than . + An error occurred when accessing the socket. See the Remarks section for more information. + + + Initializes a new instance of the class and binds it to the local port number provided. + The port on which to listen for incoming connection attempts. + One of the values that specifies the addressing scheme of the socket. + + is not or . + + is greater than or less than . + An error occurred when accessing the socket. See the Remarks section for more information. + + + Initializes a new instance of the class and binds it to the specified local endpoint. + An that respresents the local endpoint to which you bind the UDP connection. + + is null. + An error occurred when accessing the socket. See the Remarks section for more information. + + + Initializes a new instance of the class. + One of the values that specifies the addressing scheme of the socket. + + is not or . + An error occurred when accessing the socket. See the Remarks section for more information. + + + Initializes a new instance of the class and establishes a default remote host. + The name of the remote DNS host to which you intend to connect. + The remote port number to which you intend to connect. + + is null. + + is not between and . + An error occurred when accessing the socket. See the Remarks section for more information. + + + Gets or sets a value indicating whether a default remote host has been established. + true if a connection is active; otherwise, false. + + + Enables or disables Network Address Translation (NAT) traversal on a instance. + A Boolean value that specifies whether to enable or disable NAT traversal. + + + Gets the amount of data received from the network that is available to read. + The number of bytes of data received from the network. + An error occurred while attempting to access the socket. See the Remarks section for more information. + The has been closed. + + + + + + + + Receives a datagram from a remote host asynchronously. + An object that references the asynchronous receive. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the receive operation. This object is passed to the delegate when the operation is complete. + + + Sends a datagram to a remote host asynchronously. The destination was specified previously by a call to . + An object that references the asynchronous send. + A array that contains the data to be sent. + The number of bytes to send. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the send operation. This object is passed to the delegate when the operation is complete. + + + Sends a datagram to a destination asynchronously. The destination is specified by a . + An object that references the asynchronous send. + A array that contains the data to be sent. + The number of bytes to send. + The that represents the destination for the data. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the send operation. This object is passed to the delegate when the operation is complete. + + + Sends a datagram to a destination asynchronously. The destination is specified by the host name and port number. + An object that references the asynchronous send. + A array that contains the data to be sent. + The number of bytes to send. + The destination host. + The destination port number. + An delegate that references the method to invoke when the operation is complete. + A user-defined object that contains information about the send operation. This object is passed to the delegate when the operation is complete. + + + Gets or sets the underlying network . + The underlying Network . + + + Closes the UDP connection. + An error occurred when accessing the socket. See the Remarks section for more information. + + + + + + + + Establishes a default remote host using the specified IP address and port number. + The of the remote host to which you intend to send data. + The port number to which you intend send data. + + is closed. + + is null. + + is not between and . + An error occurred when accessing the socket. See the Remarks section for more information. + + + + + + + + + + Establishes a default remote host using the specified network endpoint. + An that specifies the network endpoint to which you intend to send data. + An error occurred when accessing the socket. See the Remarks section for more information. + + is null. + The is closed. + + + + + + + + + + Establishes a default remote host using the specified host name and port number. + The DNS name of the remote host to which you intend send data. + The port number on the remote host to which you intend to send data. + The is closed. + + is not between and . + An error occurred when accessing the socket. See the Remarks section for more information. + + + + + + + + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets or sets a value that specifies whether the allows Internet Protocol (IP) datagrams to be fragmented. + true if the allows datagram fragmentation; otherwise, false. The default is true. + This property can be set only for sockets that use the flag or the flag. + + + + + + + + Leaves a multicast group. + The of the multicast group to leave. + The underlying has been closed. + An error occurred when accessing the socket. See the Remarks section for more information. + The IP address is not compatible with the value that defines the addressing scheme of the socket. + + is null. + + + + + + + + Leaves a multicast group. + The of the multicast group to leave. + The interface index associated with the local IP address joined to the multicast group. + The underlying has been closed. + An error occurred when accessing the socket. See the Remarks section for more information. + The IP address is not compatible with the value that defines the addressing scheme of the socket. + + is null. + + + + + + + + Gets or sets a value that specifies whether the may send or receive broadcast packets. + true if the allows broadcast packets; otherwise, false. The default is false. + + + + + + + + Ends a pending asynchronous receive. + If successful, the number of bytes received. If unsuccessful, this method returns 0. + An object returned by a call to . + The specified remote endpoint. + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous read. + An error occurred when attempting to access the underlying . See the Remarks section for more information. + The underlying has been closed. + + + Ends a pending asynchronous send. + If successful, the number of bytes sent to the . + An object returned by a call to . + + is null. + + was not returned by a call to the method. + + was previously called for the asynchronous read. + An error occurred when attempting to access the underlying socket. See the Remarks section for more information. + The underlying has been closed. + + + Gets or sets a value that specifies whether the allows only one client to use a port. + true if the allows only one client to use a specific port; otherwise, false. The default is true for Windows Server 2003 and Windows XP Service Pack 2 and later, and false for all other versions. + An error occurred when attempting to access the underlying socket. + The underlying has been closed. + + + + + + + + Adds a to a multicast group. + The interface index associated with the local IP address on which to join the multicast group. + The multicast of the group you want to join. + The underlying has been closed. + An error occurred when accessing the socket. See the Remarks section for more information. + + + + + + + + Adds a to a multicast group. + The multicast of the group you want to join. + The underlying has been closed. + An error occurred when accessing the socket. See the Remarks section for more information. + The IP address is not compatible with the value that defines the addressing scheme of the socket. + + + + + + + + Adds a to a multicast group with the specified Time to Live (TTL). + The of the multicast group to join. + The Time to Live (TTL), measured in router hops. + The TTL provided is not between 0 and 255 + The underlying has been closed. + An error occurred when accessing the socket. See the Remarks section for more information. + + is null. + The IP address is not compatible with the value that defines the addressing scheme of the socket. + + + + + + + + Adds a to a multicast group. + The multicast of the group you want to join. + The local . + The underlying has been closed. + An error occurred when accessing the socket. See the Remarks section for more information. + + + + + + + + Gets or sets a value that specifies whether outgoing multicast packets are delivered to the sending application. + true if the receives outgoing multicast packets; otherwise, false. + + + + + + + + Returns a UDP datagram that was sent by a remote host. + An array of type that contains datagram data. + An that represents the remote host from which the data was sent. + The underlying has been closed. + An error occurred when accessing the socket. See the Remarks section for more information. + + + + + + + + + + Sends a UDP datagram to a remote host. + The number of bytes sent. + An array of type that specifies the UDP datagram that you intend to send represented as an array of bytes. + The number of bytes in the datagram. + + is null. + The has already established a default remote host. + The is closed. + An error occurred when accessing the socket. See the Remarks section for more information. + + + + + + + + + Sends a UDP datagram to the host at the specified remote endpoint. + The number of bytes sent. + An array of type that specifies the UDP datagram that you intend to send, represented as an array of bytes. + The number of bytes in the datagram. + An that represents the host and port to which to send the datagram. + + is null. + + has already established a default remote host. + + is closed. + An error occurred when accessing the socket. See the Remarks section for more information. + + + + + + + + + Sends a UDP datagram to a specified port on a specified remote host. + The number of bytes sent. + An array of type that specifies the UDP datagram that you intend to send represented as an array of bytes. + The number of bytes in the datagram. + The name of the remote host to which you intend to send the datagram. + The remote port number with which you intend to communicate. + + is null. + The has already established a default remote host. + The is closed. + An error occurred when accessing the socket. See the Remarks section for more information. + + + + + + + + + Releases all resources used by the . + + + Gets or sets a value that specifies the Time to Live (TTL) value of Internet Protocol (IP) packets sent by the . + The TTL value. + + + + + + + + Sets the default value of a parameter when called from a language that supports default parameters. This class cannot be inherited. + + + Initializes a new instance of the class with the default value of a parameter. + An object that represents the default value of a parameter. + + + Gets the default value of a parameter. + An object that represents the default value of a parameter. + + + Tracks outstanding handles and forces a garbage collection when the specified threshold is reached. + + + Initializes a new instance of the class using a name and a threshold at which to begin handle collection. + A name for the collector. This parameter allows you to name collectors that track handle types separately. + A value that specifies the point at which collections should begin. + The parameter is less than 0. + + + Initializes a new instance of the class using a name, a threshold at which to begin handle collection, and a threshold at which handle collection must occur. + A name for the collector. This parameter allows you to name collectors that track handle types separately. + A value that specifies the point at which collections should begin. + A value that specifies the point at which collections must occur. This should be set to the maximum number of available handles. + The parameter is less than 0.-or-The parameter is less than 0. + The parameter is less than the parameter. + + + Increments the current handle count. + The property is less than 0. + + + Gets the number of handles collected. + The number of handles collected. + + + Gets a value that specifies the point at which collections should begin. + A value that specifies the point at which collections should begin. + + + Gets a value that specifies the point at which collections must occur. + A value that specifies the point at which collections must occur. + + + Gets the name of a object. + This property allows you to name collectors that track handle types separately. + + + Decrements the current handle count. + The property is less than 0. + + + Replaces the standard common language runtime (CLR) free-threaded marshaler with the standard OLE STA marshaler. + + + Initializes a new instance of the class. + + + Specifies the requested behavior when setting up an advise sink or a caching connection with an object. + + + For data advisory connections ( or ), this flag requests the data object not to send data when it calls . + + + Requests that the object not wait for the data or view to change before making an initial call to (for data or view advisory connections) or updating the cache (for cache connections). + + + Requests that the object make only one change notification or cache update before deleting the connection. + + + For data advisory connections, assures accessibility to data. + + + Synonym for , which is used more often. + + + This value is used by DLL object applications and object handlers that perform the drawing of their objects. + + + For cache connections, this flag updates the cached representation only when the object containing the cache is saved. + + + Specifies the direction of the data flow in the parameter of the method. This determines the formats that the resulting enumerator can enumerate. + + + Requests that supply an enumerator for the formats that can be specified in . + + + Requests that supply an enumerator for the formats that can be specified in . + + + Specifies the desired data or view aspect of the object when drawing or getting data. + + + A representation of an object that lets that object be displayed as an embedded object inside a container. This value is typically specified for compound document objects. The presentation can be provided for the screen or printer. + + + A thumbnail representation of an object that lets that object be displayed in a browsing tool. The thumbnail is approximately a 120 by 120 pixel, 16-color (recommended), device-independent bitmap potentially wrapped in a metafile. + + + An iconic representation of an object. + + + A representation of an object on the screen as though it were printed to a printer using the Print command from the File menu. The described data may represent a sequence of pages. + + + Represents a generalized Clipboard format. + + + Specifies the particular clipboard format of interest. + + + Specifies one of the enumeration constants that indicates how much detail should be contained in the rendering. + + + Specifies part of the aspect when the data must be split across page boundaries. + + + Specifies a pointer to a DVTARGETDEVICE structure containing information about the target device that the data is being composed for. + + + Specifies one of the enumeration constants, which indicates the type of storage medium used to transfer the object's data. + + + Provides a managed definition of the IAdviseSink interface. + + + Notifies all registered advisory sinks that the object has changed from the running state to the loaded state. This method is called by a server. + + + Notifies all data objects currently registered advisory sinks that data in the object has changed. + A , passed by reference, which describes the format, target device, rendering, and storage information of the calling data object. + A , passed by reference, which defines the storage medium (global memory, disk file, storage object, stream object, Graphics Device Interface (GDI) object, or undefined) and ownership of that medium for the calling data object. + + + Notifies all registered advisory sinks that the object has been renamed. This method is called by a server. + A pointer to the IMoniker interface on the new full moniker of the object. + + + Notifies all registered advisory sinks that the object has been saved. This method is called by a server. + + + Notifies an object's registered advisory sinks that its view has changed. This method is called by a server. + The aspect, or view, of the object. Contains a value taken from the enumeration. + The portion of the view that has changed. Currently, only -1 is valid. + + + Provides the managed definition of the IDataObject interface. + + + Creates a connection between a data object and an advisory sink. This method is called by an object that supports an advisory sink and enables the advisory sink to be notified of changes in the object's data. + This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following: ValueDescriptionS_OKThe advisory connection was created.E_NOTIMPLThis method is not implemented on the data object.DV_E_LINDEXThere is an invalid value for ; currently, only -1 is supported.DV_E_FORMATETCThere is an invalid value for the parameter.OLE_E_ADVISENOTSUPPORTEDThe data object does not support change notification. + A structure, passed by reference, that defines the format, target device, aspect, and medium that will be used for future notifications. + One of the values that specifies a group of flags for controlling the advisory connection. + A pointer to the interface on the advisory sink that will receive the change notification. + When this method returns, contains a pointer to a DWORD token that identifies this connection. You can use this token later to delete the advisory connection by passing it to . If this value is zero, the connection was not established. This parameter is passed uninitialized. + + + Destroys a notification connection that had been previously established. + A DWORD token that specifies the connection to remove. Use the value returned by when the connection was originally established. + + + Creates an object that can be used to enumerate the current advisory connections. + This method supports the standard return value E_OUTOFMEMORY, as well as the following:ValueDescriptionS_OKThe enumerator object is successfully instantiated or there are no connections.OLE_E_ADVISENOTSUPPORTEDThis object does not support advisory notifications. + When this method returns, contains an that receives the interface pointer to the new enumerator object. If the implementation sets to null, there are no connections to advisory sinks at this time. This parameter is passed uninitialized. + + + Creates an object for enumerating the structures for a data object. These structures are used in calls to or . + This method supports the standard return values E_INVALIDARG and E_OUTOFMEMORY, as well as the following:ValueDescriptionS_OKThe enumerator object was successfully created.E_NOTIMPLThe direction specified by the parameter is not supported.OLE_S_USEREGRequests that OLE enumerate the formats from the registry. + One of the values that specifies the direction of the data. + + + Provides a standard structure that is logically equivalent to a more complex structure. Use this method to determine whether two different structures would return the same data, removing the need for duplicate rendering. + This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following: ValueDescriptionS_OKThe returned structure is different from the one that was passed.DATA_S_SAMEFORMATETCThe structures are the same and null is returned in the parameter.DV_E_LINDEXThere is an invalid value for ; currently, only -1 is supported.DV_E_FORMATETCThere is an invalid value for the parameter.OLE_E_NOTRUNNINGThe application is not running. + A pointer to a structure, passed by reference, that defines the format, medium, and target device that the caller would like to use to retrieve data in a subsequent call such as . The member is not significant in this case and should be ignored. + When this method returns, contains a pointer to a structure that contains the most general information possible for a specific rendering, making it canonically equivalent to . The caller must allocate this structure and the method must fill in the data. To retrieve data in a subsequent call such as , the caller uses the supplied value of , unless the value supplied is null. This value is null if the method returns DATA_S_SAMEFORMATETC. The member is not significant in this case and should be ignored. This parameter is passed uninitialized. + + + Obtains data from a source data object. The method, which is called by a data consumer, renders the data described in the specified structure and transfers it through the specified structure. The caller then assumes responsibility for releasing the structure. + A pointer to a structure, passed by reference, that defines the format, medium, and target device to use when passing the data. It is possible to specify more than one medium by using the Boolean OR operator, allowing the method to choose the best medium among those specified. + When this method returns, contains a pointer to the structure that indicates the storage medium containing the returned data through its member, and the responsibility for releasing the medium through the value of its member. If is null, the receiver of the medium is responsible for releasing it; otherwise, points to the IUnknown interface on the appropriate object so its Release method can be called. The medium must be allocated and filled in by . This parameter is passed uninitialized. + + + Obtains data from a source data object. This method, which is called by a data consumer, differs from the method in that the caller must allocate and free the specified storage medium. + A pointer to a structure, passed by reference, that defines the format, medium, and target device to use when passing the data. Only one medium can be specified in , and only the following values are valid: , , , or . + A , passed by reference, that defines the storage medium containing the data being transferred. The medium must be allocated by the caller and filled in by . The caller must also free the medium. The implementation of this method must always supply a value of null for the member of the structure that this parameter points to. + + + Determines whether the data object is capable of rendering the data described in the structure. Objects attempting a paste or drop operation can call this method before calling to get an indication of whether the operation may be successful. + This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following: ValueDescriptionS_OKA subsequent call to would probably be successful.DV_E_LINDEXAn invalid value for ; currently, only -1 is supported.DV_E_FORMATETCAn invalid value for the parameter.DV_E_TYMEDAn invalid value.DV_E_DVASPECTAn invalid value.OLE_E_NOTRUNNINGThe application is not running. + A pointer to a structure, passed by reference, that defines the format, medium, and target device to use for the query. + + + Transfers data to the object that implements this method. This method is called by an object that contains a data source. + A structure, passed by reference, that defines the format used by the data object when interpreting the data contained in the storage medium. + A structure, passed by reference, that defines the storage medium in which the data is being passed. + true to specify that the data object called, which implements , owns the storage medium after the call returns. This means that the data object must free the medium after it has been used by calling the ReleaseStgMedium function. false to specify that the caller retains ownership of the storage medium, and the data object called uses the storage medium for the duration of the call only. + + + Provides the managed definition of the IEnumFORMATETC interface. + + + Creates a new enumerator that contains the same enumeration state as the current enumerator. + When this method returns, contains a reference to the newly created enumerator. This parameter is passed uninitialized. + + + Retrieves a specified number of items in the enumeration sequence. + S_OK if the parameter equals the parameter; otherwise, S_FALSE. + The number of references to return in . + When this method returns, contains a reference to the enumerated references. This parameter is passed uninitialized. + When this method returns, contains a reference to the actual number of references enumerated in . This parameter is passed uninitialized. + + + Resets the enumeration sequence to the beginning. + An HRESULT with the value S_OK. + + + Skips a specified number of items in the enumeration sequence. + S_OK if the number of elements skipped equals the parameter; otherwise, S_FALSE. + The number of elements to skip in the enumeration. + + + Provides the managed definition of the IEnumSTATDATA interface. + + + Creates a new enumerator that contains the same enumeration state as the current enumerator. + When this method returns, contains a reference to the newly created enumerator. This parameter is passed uninitialized. + + + Retrieves a specified number of items in the enumeration sequence. + S_OK if the parameter equals the parameter; otherwise, S_FALSE. + The number of references to return in . + When this method returns, contains a reference to the enumerated references. This parameter is passed uninitialized. + When this parameter returns, contains a reference to the actual number of references enumerated in . This parameter is passed uninitialized. + + + Resets the enumeration sequence to the beginning. + An HRESULT with the value S_OK. + + + Skips a specified number of items in the enumeration sequence. + S_OK if the number of elements skipped equals the parameter; otherwise, S_FALSE. + The number of elements to skip in the enumeration. + + + Provides the managed definition of the STATDATA structure. + + + Represents the enumeration value that determines when the advisory sink is notified of changes in the data. + + + Represents the interface that will receive change notifications. + + + Represents the token that uniquely identifies the advisory connection. This token is returned by the method that sets up the advisory connection. + + + Represents the structure for the data of interest to the advise sink. The advise sink receives notification of changes to the data specified by this structure. + + + Provides the managed definition of the STGMEDIUM structure. + + + Represents a pointer to an interface instance that allows the sending process to control the way the storage is released when the receiving process calls the ReleaseStgMedium function. If is null, ReleaseStgMedium uses default procedures to release the storage; otherwise, ReleaseStgMedium uses the specified IUnknown interface. + + + Specifies the type of storage medium. The marshaling and unmarshaling routines use this value to determine which union member was used. This value must be one of the elements of the enumeration. + + + Represents a handle, string, or interface pointer that the receiving process can use to access the data being transferred. + + + Provides the managed definition of the TYMED structure. + + + The storage medium is a global memory handle (HGLOBAL). Allocate the global handle with the GMEM_SHARE flag. If the member is null, the destination process should use GlobalFree to release the memory. + + + The storage medium is a disk file identified by a path. If the STGMEDIUM member is null, the destination process should use OpenFile to delete the file. + + + The storage medium is a stream object identified by an IStream pointer. Use ISequentialStream::Read to read the data. If the member is not null, the destination process should use IStream::Release to release the stream component. + + + The storage medium is a storage component identified by an IStorage pointer. The data is in the streams and storages contained by this IStorage instance. If the member is not null, the destination process should use IStorage::Release to release the storage component. + + + The storage medium is a Graphics Device Interface (GDI) component (HBITMAP). If the member is null, the destination process should use DeleteObject to delete the bitmap. + + + The storage medium is a metafile (HMETAFILE). Use the Windows or WIN32 functions to access the metafile's data. If the member is null, the destination process should use DeleteMetaFile to delete the bitmap. + + + The storage medium is an enhanced metafile. If the member is null, the destination process should use DeleteEnhMetaFile to delete the bitmap. + + + No data is being passed. + + + Represents the name of a version of the .NET Framework. + + + Initializes a new instance of the class from a string that contains information about a version of the .NET Framework. + A string that contains .NET Framework version information. + + is .-or- has fewer than two components or more than three components.-or- does not include a major and minor version number.-or-does not include a valid version number. + + is null. + + + Initializes a new instance of the class from a string and a object that identify a .NET Framework version. + A string that identifies a .NET Framework version. + An object that contains .NET Framework version information. + + is . + + is null.-or- is null. + + + Initializes a new instance of the class from a string, a object that identifies a .NET Framework version, and a profile name. + A string that identifies a .NET Framework version. + An object that contains .NET Framework version information. + A profile name. + + is . + + is null.-or- is null. + + + Returns a value that indicates whether this instance represents the same .NET Framework version as a specified object. + true if every component of the current object matches the corresponding component of ; otherwise, false. + The object to compare to the current instance. + + + Returns a value that indicates whether this instance represents the same .NET Framework version as a specified instance. + true if every component of the current object matches the corresponding component of ; otherwise, false. + The object to compare to the current instance. + + + Gets the full name of this object. + The full name of this object. + + + Returns the hash code for the object. + A 32-bit signed integer that represents the hash code of this instance. + + + Gets the identifier of this object. + The identifier of this object. + + + Returns a value that indicates whether two objects represent the same .NET Framework version. + true if the and parameters represent the same .NET Framework version; otherwise, false. + The first object to compare. + The second object to compare. + + + Returns a value that indicates whether two objects represent different .NET Framework versions. + true if the and parameters represent different .NET Framework versions; otherwise, false. + The first object to compare. + The second object to compare. + + + Gets the profile name of this object. + The profile name of this object. + + + Returns the string representation of this object. + A string that represents this object. + + + Gets the version of this object. + An object that contains version information about this object. + + + Represents a set of access rights allowed or denied for a user or group. This class cannot be inherited. + + + Initializes a new instance of the class, specifying the user or group the rule applies to, the access rights, and whether the specified access rights are allowed or denied. + The user or group the rule applies to. Must be of type or a type such as that can be converted to type . + A bitwise combination of values specifying the rights allowed or denied. + One of the values specifying whether the rights are allowed or denied. + + specifies an invalid value.-or- specifies an invalid value. + + is null. -or- is zero. + + is neither of type nor of a type such as that can be converted to type . + + + Initializes a new instance of the class, specifying the name of the user or group the rule applies to, the access rights, and whether the specified access rights are allowed or denied. + The name of the user or group the rule applies to. + A bitwise combination of values specifying the rights allowed or denied. + One of the values specifying whether the rights are allowed or denied. + + specifies an invalid value.-or- specifies an invalid value. + + is zero. + + is null.-or- is a zero-length string.-or- is longer than 512 characters. + + + Gets the rights allowed or denied by the access rule. + A bitwise combination of values indicating the rights allowed or denied by the access rule. + + + Represents a set of access rights to be audited for a user or group. This class cannot be inherited. + + + Initializes a new instance of the class, specifying the user or group to audit, the rights to audit, and whether to audit success, failure, or both. + The user or group the rule applies to. Must be of type or a type such as that can be converted to type . + A bitwise combination of values specifying the kinds of access to audit. + A bitwise combination of values specifying whether to audit success, failure, or both. + + specifies an invalid value.-or- specifies an invalid value. + + is null. -or- is zero. + + is neither of type nor of a type such as that can be converted to type . + + + Gets the access rights affected by the audit rule. + A bitwise combination of values that indicates the rights affected by the audit rule. + + + Specifies the access control rights that can be applied to named system semaphore objects. + + + The right to release a named semaphore. + + + The right to delete a named semaphore. + + + The right to open and copy the access rules and audit rules for a named semaphore. + + + The right to change the security and audit rules associated with a named semaphore. + + + The right to change the owner of a named semaphore. + + + The right to wait on a named semaphore. + + + The right to exert full control over a named semaphore, and to modify its access rules and audit rules. + + + Represents the Windows access control security for a named semaphore. This class cannot be inherited. + + + Initializes a new instance of the class with default values. + This class is not supported on Windows 98 or Windows Millennium Edition. + + + Initializes a new instance of the class with the specified sections of the access control security rules from the system semaphore with the specified name. + The name of the system semaphore whose access control security rules are to be retrieved. + A combination of flags specifying the sections to retrieve. + This class is not supported on Windows 98 or Windows Millennium Edition. + + + Gets the enumeration that the class uses to represent access rights. + A object representing the enumeration. + + + Creates a new access control rule for the specified user, with the specified access rights, access control, and flags. + A object representing the specified rights for the specified user. + An that identifies the user or group the rule applies to. + A bitwise combination of values specifying the access rights to allow or deny, cast to an integer. + Meaningless for named semaphores, because they have no hierarchy. + Meaningless for named semaphores, because they have no hierarchy. + Meaningless for named semaphores, because they have no hierarchy. + One of the values specifying whether the rights are allowed or denied. + + , , , or specifies an invalid value. + + is null. -or- is zero. + + is neither of type , nor of a type such as that can be converted to type . + + + Gets the type that the class uses to represent access rules. + A object representing the class. + + + Searches for a matching rule with which the new rule can be merged. If none are found, adds the new rule. + The access control rule to add. + + is null. + + + Searches for an audit rule with which the new rule can be merged. If none are found, adds the new rule. + The audit rule to add. The user specified by this rule determines the search. + + + Creates a new audit rule, specifying the user the rule applies to, the access rights to audit, and the outcome that triggers the audit rule. + A object representing the specified audit rule for the specified user. The return type of the method is the base class, , but the return value can be cast safely to the derived class. + An that identifies the user or group the rule applies to. + A bitwise combination of values specifying the access rights to audit, cast to an integer. + Meaningless for named wait handles, because they have no hierarchy. + Meaningless for named wait handles, because they have no hierarchy. + Meaningless for named wait handles, because they have no hierarchy. + A bitwise combination of values that specify whether to audit successful access, failed access, or both. + + , , , or specifies an invalid value. + + is null. -or- is zero. + + is neither of type , nor of a type such as that can be converted to type . + + + Gets the type that the class uses to represent audit rules. + A object representing the class. + + + Searches for an access control rule with the same user and (allow or deny) as the specified rule, and with compatible inheritance and propagation flags; if such a rule is found, the rights contained in the specified access rule are removed from it. + true if a compatible rule is found; otherwise false. + A that specifies the user and to search for, and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found. + + is null. + + + Searches for all access control rules with the same user and (allow or deny) as the specified rule and, if found, removes them. + A that specifies the user and to search for. Any rights specified by this rule are ignored. + + is null. + + + Searches for an access control rule that exactly matches the specified rule and, if found, removes it. + The to remove. + + is null. + + + Searches for an audit control rule with the same user as the specified rule, and with compatible inheritance and propagation flags; if a compatible rule is found, the rights contained in the specified rule are removed from it. + true if a compatible rule is found; otherwise, false. + A that specifies the user to search for, and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found. + + is null. + + + Searches for all audit rules with the same user as the specified rule and, if found, removes them. + A that specifies the user to search for. Any rights specified by this rule are ignored. + + is null. + + + Searches for an audit rule that exactly matches the specified rule and, if found, removes it. + The to remove. + + is null. + + + Removes all access control rules with the same user as the specified rule, regardless of , and then adds the specified rule. + The to add. The user specified by this rule determines the rules to remove before this rule is added. + + is null. + + + Removes all access control rules with the same user and (allow or deny) as the specified rule, and then adds the specified rule. + The to add. The user and of this rule determine the rules to remove before this rule is added. + + is null. + + + Removes all audit rules with the same user as the specified rule, regardless of the value, and then adds the specified rule. + The to add. The user specified by this rule determines the rules to remove before this rule is added. + + is null. + + + The exception that is thrown when authentication fails for an authentication stream. + + + Initializes a new instance of the class with no message. + + + Initializes a new instance of the class from the specified instances of the and classes. + A instance that contains the information required to deserialize the new instance. + A instance. + + + Initializes a new instance of the class with the specified message. + A that describes the authentication failure. + + + Initializes a new instance of the class with the specified message and inner exception. + A that describes the authentication failure. + The that is the cause of the current exception. + + + Defines the possible cipher algorithms for the class. + + + No encryption algorithm is used. + + + Rivest's Code 2 (RC2) algorithm. + + + Rivest's Code 4 (RC4) algorithm. + + + The Data Encryption Standard (DES) algorithm. + + + The Triple Data Encryption Standard (3DES) algorithm. + + + The Advanced Encryption Standard (AES) algorithm. + + + The Advanced Encryption Standard (AES) algorithm with a 128 bit key. + + + The Advanced Encryption Standard (AES) algorithm with a 192 bit key. + + + The Advanced Encryption Standard (AES) algorithm with a 256 bit key. + + + No encryption is used with a Null cipher algorithm. + + + Specifies the algorithm used to create keys shared by the client and server. + + + No key exchange algorithm is used. + + + The RSA public-key signature algorithm. + + + The RSA public-key exchange algorithm. + + + The Diffie Hellman ephemeral key exchange algorithm. + + + Specifies the algorithm used for generating message authentication codes (MACs). + + + No hashing algorithm is used. + + + The Message Digest 5 (MD5) hashing algorithm. + + + The Secure Hashing Algorithm (SHA1). + + + The exception that is thrown when authentication fails for an authentication stream and cannot be retried. + + + Initializes a new instance of the class with no message. + + + Initializes a new instance of the class from the specified instances of the and classes. + A instance that contains the information required to deserialize the new instance. + A instance. + + + Initializes a new instance of the class with the specified message. + A that describes the authentication failure. + + + Initializes a new instance of the class with the specified message and inner exception. + A that describes the authentication failure. + The that is the cause of the current exception. + + + Defines the possible versions of . + + + No SSL protocol is specified. + + + Specifies the SSL 2.0 protocol. SSL 2.0 has been superseded by the TLS protocol and is provided for backward compatibility only. + + + Specifies the SSL 3.0 protocol. SSL 3.0 has been superseded by the TLS protocol and is provided for backward compatibility only. + + + Specifies the TLS 1.0 security protocol. The TLS protocol is defined in IETF RFC 2246. + + + Specifies that either Secure Sockets Layer (SSL) 3.0 or Transport Layer Security (TLS) 1.0 are acceptable for secure communications + + + The class encapsulates a pointer to the opaque data used to bind an authenticated transaction to a secure channel. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + A Boolean value that indicates if the application owns the safe handle to a native memory region containing the byte data that would be passed to native calls that provide extended protection for integrated windows authentication. + + + The property gets the size, in bytes, of the channel binding token associated with the instance. + The size, in bytes, of the channel binding token in the instance. + + + The enumeration represents the kinds of channel bindings that can be queried from secure channels. + + + An unknown channel binding type. + + + A channel binding completely unique to a given channel (a TLS session key, for example). + + + A channel binding unique to a given endpoint (a TLS server certificate, for example). + + + The class represents the extended protection policy used by the server to validate incoming client connections. + + + Initializes a new instance of the class from a object that contains the required data to populate the . + A instance that contains the information that is required to serialize the new instance. + A that contains the source of the serialized stream that is associated with the new instance. + + + Initializes a new instance of the class that specifies when the extended protection policy should be enforced. + A value that indicates when the extended protection policy should be enforced. + + + Initializes a new instance of the class that specifies when the extended protection policy should be enforced and the channel binding token (CBT) to be used. + A value that indicates when the extended protection policy should be enforced. + A that contains a custom channel binding to use for validation. + + is specified as . + + is null. + + + Initializes a new instance of the class that specifies when the extended protection policy should be enforced, the kind of protection enforced by the policy, and a custom Service Provider Name (SPN) list that is used to match against a client's SPN. + A value that indicates when the extended protection policy should be enforced. + A value that indicates the kind of protection enforced by the policy. + A that contains the custom SPN list that is used to match against a client's SPN. + + is specified as . + + is nullor an empty list. + + + Initializes a new instance of the class that specifies when the extended protection policy should be enforced, the kind of protection enforced by the policy, and a custom Service Provider Name (SPN) list that is used to match against a client's SPN. + A value that indicates when the extended protection policy should be enforced. + A value that indicates the kind of protection enforced by the policy. + A that contains the custom SPN list that is used to match against a client's SPN. + + is specified as . + + is nullor an empty list. + + + Gets a custom channel binding token (CBT) to use for validation. + A that contains a custom channel binding to use for validation. + + + Gets the custom Service Provider Name (SPN) list used to match against a client's SPN. + A that contains the custom SPN list that is used to match against a client's SPN. + + + Indicates whether the operating system supports integrated windows authentication with extended protection. + true if the operating system supports integrated windows authentication with extended protection, otherwise false. + + + Gets when the extended protection policy should be enforced. + A value that indicates when the extended protection policy should be enforced. + + + Gets the kind of protection enforced by the extended protection policy. + A value that indicates the kind of protection enforced by the policy. + + + Populates a object with the required data to serialize an object. + A object that holds the serialized data for an object. + A that contains the destination of the serialized stream that is associated with the new . + + + Gets a string representation for the extended protection policy instance. + A instance that contains the representation of the instance. + + + The class represents the type converter for extended protection policy used by the server to validate incoming client connections. + + + Initializes a new instance of the class. + + + Returns whether this converter can convert the object to the specified type. + true if this converter can perform the conversion; otherwise false. + The object to convert. + A that represents the type you want to convert to. + + + Convert the object to the specified type + An that represents the converted parameter. + An that provides a format context. + A object. If null is passed, the current culture is assumed. + The to convert. This should be a object. + The to convert the value parameter to. + The parameter is null. + The conversion could not be performed. + + + The enumeration specifies when the should be enforced. + + + The is never enforced and extended protection is disabled. + + + The is enforced only if the client and server supports extended protection. + + + The is always enforced. Clients that don’t support extended protection will fail to authenticate. + + + The enumeration specifies the protection scenario enforced by the policy. + + + The transport will select between a secure and standard protection scenario depending on the type of channel used. For secure protection, integrated Windows authentication is wrapped in a secure channel and has an exactly matching channel binding token with no Service Provider Name (SPN) validation. For standard protection, integrated Windows authentication is optionally wrapped in a secure channel with an optional channel binding token and SPN validation is required. So if the request comes through a secure channel, the channel binding token (CBT) is checked, otherwise the SPN is checked. + + + Integrated Windows authentication is wrapped in a secure channel terminated by a trusted proxy and has a channel binding token with SPN validation required. This requires the presence of a CBT, but the CBT is not checked while the SPN is checked. + + + The class is a read-only collection of service principal names. + + + Initializes a new read-only instance of the class based on an existing . + An instance of the class that contains the specified values of service names to be used to initialize the class. + + is null. + + is empty. + + + Merges the current with the specified values to create a new containing the union. + A new instance that contains the union of the existing instance merged with the specified values. + An instance of the class that contains the specified values of service names to be merged. + + is null. + + is empty. + + + Merges the current with the specified values to create a new containing the union. + A new instance that contains the union of the existing instance merged with the specified values. + A string that contains the specified values of service names to be used to initialize the class. + + is null. + + is empty. + + + The class represents a configuration element for an . + + + Initializes a new instance of the class. + + + The method builds a new instance based on the properties set on the class. + A new instance that represents the extended protection policy created. + + + Gets or sets the custom Service Provider Name (SPN) list used to match against a client's SPN for this configuration policy element. + Returns a that includes the custom SPN list used to match against a client's SPN. + + + Gets or sets the policy enforcement value for this configuration policy element. + Returns a value that indicates when the extended protection policy should be enforced. + + + Gets or sets the kind of protection enforced by the extended protection policy for this configuration policy element. + A value that indicates the kind of protection enforced by the policy. + + + The class represents a configuration element for a service name used in a . + + + Initializes a new instance of the class. + + + Gets or sets the Service Provider Name (SPN) for this instance. + A that contains the representation of SPN for this instance. + + + The class is a collection of service principal names that represent a configuration element for an . + + + Initializes a new instance of the class. + + + The method adds a instance to this . + The instance to add to this . + + + The method removes all configuration element objects from this . + + + The method retrieves the index of the specified configuration element in this . + The index of the specified in this . + The instance to retrieve the index of in this . + + + The property gets or sets the instance at the specified index location. + The instance requested. If the requested instance is not found, then null is returned. + The index of the instance in this . + + + The property gets or sets the instance based on a string that represents the instance. + The instance requested. If the requested instance is not found, then null is returned. + A that represents the instance in this . + + + The method removes a instance from this . + The instance to remove from this . + + is null. + + + The method removes a instance from this based on the specified. + A that represents the instance to remove from this + + + The method removes a instance from this based on the index specified. + The index of the instance to remove from this . + + + Represents Abstract Syntax Notation One (ASN.1)-encoded data. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using a byte array. + A byte array that contains Abstract Syntax Notation One (ASN.1)-encoded data. + + + Initializes a new instance of the class using an instance of the class. + An instance of the class. + + is null. + + + Initializes a new instance of the class using an object and a byte array. + An object. + A byte array that contains Abstract Syntax Notation One (ASN.1)-encoded data. + + + Initializes a new instance of the class using a byte array. + A string that represents information. + A byte array that contains Abstract Syntax Notation One (ASN.1)-encoded data. + + + Copies information from an object. + The object to base the new object on. + + is null. + + + Returns a formatted version of the Abstract Syntax Notation One (ASN.1)-encoded data as a string. + A formatted string that represents the Abstract Syntax Notation One (ASN.1)-encoded data. + true if the return string should contain carriage returns; otherwise, false. + + + Gets or sets the value for an object. + An object. + + + Gets or sets the Abstract Syntax Notation One (ASN.1)-encoded data represented in a byte array. + A byte array that represents the Abstract Syntax Notation One (ASN.1)-encoded data. + The value is null. + + + Represents a collection of objects. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class and adds an object to the collection. + The object to add to the collection. + + + Adds an object to the object. + The index of the added object. + The object to add to the collection. + + is null. + Neither of the OIDs are null and the OIDs do not match. + One of the OIDs is null and the OIDs do not match. + + + Copies the object into an array. + The array that the object is to be copied into. + The location where the copy operation starts. + + + Gets the number of objects in a collection. + The number of objects. + + + Returns an object that can be used to navigate the object. + An object. + + + Gets a value that indicates whether access to the object is thread safe. + false in all cases. + + + Gets an object from the object. + An object. + The location in the collection. + + + Removes an object from the object. + The object to remove. + + is null. + + + Gets an object that can be used to synchronize access to the object. + An object used to synchronize access to the object. + + + Copies the object into an array. + The array that the object is to be copied into. + The location where the copy operation starts. + + is a multidimensional array, which is not supported by this method. + The length for is invalid. + + is null. + The length for is out of range. + + + Returns an object that can be used to navigate the object. + An object that can be used to navigate the collection. + + + Provides the ability to navigate through an object. This class cannot be inherited. + + + Gets the current object in an object. + The current object in the collection. + + + Advances to the next object in an object. + true, if the enumerator was successfully advanced to the next element; false, if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Sets an enumerator to its initial position. + The collection was modified after the enumerator was created. + + + Gets the current object in an object. + The current object. + + + Represents a cryptographic object identifier. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using the specified object. + The object identifier information to use to create the new object identifier. + + is null. + + + Initializes a new instance of the class using a string value of an object. + An object identifier. + + + Initializes a new instance of the class using the specified value and friendly name. + The dotted number of the identifier. + The friendly name of the identifier. + + + Gets or sets the friendly name of the identifier. + The friendly name of the identifier. + + + Gets or sets the dotted number of the identifier. + The dotted number of the identifier. + + + Represents a collection of objects. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Adds an object to the object. + The index of the added object. + The object to add to the collection. + + + Copies the object into an array. + The array to copy the object into. + The location where the copy operation starts. + + + Gets the number of objects in a collection. + The number of objects in a collection. + + + Returns an object that can be used to navigate the object. + An object. + + + Gets a value that indicates whether access to the object is thread safe. + false in all cases. + + + Gets an object from the object. + An object. + The location of the object in the collection. + + + Gets the first object that contains a value of the property or a value of the property that matches the specified string value from the object. + An object. + A string that represents a property or a property. + + + Gets an object that can be used to synchronize access to the object. + An object that can be used to synchronize access to the object. + + + Copies the object into an array. + The array to copy the object to. + The location where the copy operation starts. + + cannot be a multidimensional array.-or-The length of is an invalid offset length. + + is null. + The value of is out range. + + + Returns an object that can be used to navigate the object. + An object that can be used to navigate the collection. + + + Provides the ability to navigate through an object. This class cannot be inherited. + + + Gets the current object in an object. + The current object in the collection. + + + Advances to the next object in an object. + true, if the enumerator was successfully advanced to the next element; false, if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Sets an enumerator to its initial position. + The collection was modified after the enumerator was created. + + + Gets the current object in an object. + The current object. + + + Specifies the way to open the X.509 certificate store. + + + Open the X.509 certificate store for reading only. + + + Open the X.509 certificate store for both reading and writing. + + + Open the X.509 certificate store for the highest access allowed. + + + Opens only existing stores; if no store exists, the method will not create a new store. + + + Open the X.509 certificate store and include archived certificates. + + + Represents a certificate's public key information. This class cannot be inherited. + + + Initializes a new instance of the class using an object identifier (OID) object of the public key, an ASN.1-encoded representation of the public key parameters, and an ASN.1-encoded representation of the public key value. + An object identifier (OID) object that represents the public key. + An ASN.1-encoded representation of the public key parameters. + An ASN.1-encoded representation of the public key value. + + + Gets the ASN.1-encoded representation of the public key value. + The ASN.1-encoded representation of the public key value. + + + Gets the ASN.1-encoded representation of the public key parameters. + The ASN.1-encoded representation of the public key parameters. + + + Gets an or object representing the public key. + An object representing the public key. + The key algorithm is not supported. + + + Gets an object identifier (OID) object of the public key. + An object identifier (OID) object of the public key. + + + Specifies the location of the X.509 certificate store. + + + The X.509 certificate store used by the current user. + + + The X.509 certificate store assigned to the local machine. + + + Specifies the name of the X.509 certificate store to open. + + + The X.509 certificate store for other users. + + + The X.509 certificate store for third-party certificate authorities (CAs). + + + The X.509 certificate store for intermediate certificate authorities (CAs). + + + The X.509 certificate store for revoked certificates. + + + The X.509 certificate store for personal certificates. + + + The X.509 certificate store for trusted root certificate authorities (CAs). + + + The X.509 certificate store for directly trusted people and resources. + + + The X.509 certificate store for directly trusted publishers. + + + Represents the distinguished name of an X509 certificate. This class cannot be inherited. + + + Initializes a new instance of the class using information from the specified byte array. + A byte array that contains distinguished name information. + + + Initializes a new instance of the class using the specified object. + An object that represents the distinguished name. + + + Initializes a new instance of the class using the specified object. + An object. + + + Initializes a new instance of the class using information from the specified string. + A string that represents the distinguished name. + + + Initializes a new instance of the class using the specified string and flag. + A string that represents the distinguished name. + A bitwise combination of the enumeration values that specify the characteristics of the distinguished name. + + + Decodes a distinguished name using the characteristics specified by the parameter. + The decoded distinguished name. + A flag that specifies the characteristics of the object. + The certificate has an invalid name. + + + Returns a formatted version of an X500 distinguished name for printing or for output to a text window or to a console. + A formatted string that represents the X500 distinguished name. + true if the return string should contain carriage returns; otherwise, false. + + + Gets the comma-delimited distinguished name from an X500 certificate. + The comma-delimited distinguished name of the X509 certificate. + + + Specifies characteristics of the X.500 distinguished name. + + + The distinguished name has no special characteristics. + + + The distinguished name is reversed. + + + The distinguished name uses semicolons. + + + The distinguished name does not use the plus sign. + + + The distinguished name does not use quotation marks. + + + The distinguished name uses commas. + + + The distinguished name uses the new line character. + + + The distinguished name uses UTF8 encoding. + + + The distinguished name uses T61 encoding. + + + The distinguished name uses UTF8 encoding. + + + Defines the constraints set on a certificate. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. Parameters specify a value that indicates whether a certificate is a certificate authority (CA) certificate, a value that indicates whether the certificate has a restriction on the number of path levels it allows, the number of levels allowed in a certificate's path, and a value that indicates whether the extension is critical. + true if the certificate is a certificate authority (CA) certificate; otherwise, false. + true if the certificate has a restriction on the number of path levels it allows; otherwise, false. + The number of levels allowed in a certificate's path. + true if the extension is critical; otherwise, false. + + + Initializes a new instance of the class using an object and a value that identifies whether the extension is critical. + The encoded data to use to create the extension. + true if the extension is critical; otherwise, false. + + + Gets a value indicating whether a certificate is a certificate authority (CA) certificate. + true if the certificate is a certificate authority (CA) certificate, otherwise, false. + + + Initializes a new instance of the class using an object. + The encoded data to use to create the extension. + + + Gets a value indicating whether a certificate has a restriction on the number of path levels it allows. + true if the certificate has a restriction on the number of path levels it allows, otherwise, false. + The extension cannot be decoded. + + + Gets the number of levels allowed in a certificate's path. + An integer indicating the number of levels allowed in a certificate's path. + The extension cannot be decoded. + + + Represents an X.509 certificate. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using information from a byte array. + A byte array containing data from an X.509 certificate. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using a byte array and a password. + A byte array that contains data from an X.509 certificate. + The password required to access the X.509 certificate data. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using a byte array, a password, and a key storage flag. + A byte array that contains data from an X.509 certificate. + The password required to access the X.509 certificate data. + A bitwise combination of the enumeration values that control where and how to import the private key of the certificate. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using a byte array and a password. + A byte array containing data from an X.509 certificate. + The password required to access the X.509 certificate data. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using a byte array, a password, and a key storage flag. + A byte array containing data from an X.509 certificate. + The password required to access the X.509 certificate data. + A bitwise combination of the enumeration values that control where and how to import the private key of the certificate. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using an unmanaged handle. + A pointer to a certificate context in unmanaged code. The C structure is called PCCERT_CONTEXT. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using the specified serialization and stream context information. + The serialization information required to deserialize the new . + Contextual information about the source of the stream to be deserialized. + + + Initializes a new instance of the class using an object. + An object. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using a certificate file name. + The name of a certificate file. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using a certificate file name and a password. + The name of a certificate file. + The password required to access the X.509 certificate data. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using a certificate file name, a password, and a key storage flag. + The name of a certificate file. + The password required to access the X.509 certificate data. + A bitwise combination of the enumeration values that control where and how to import the private key of the certificate. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using a certificate file name and a password used to access the certificate. + The name of a certificate file. + The password required to access the X.509 certificate data. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Initializes a new instance of the class using a certificate file name, a password used to access the certificate, and a key storage flag. + The name of a certificate file. + The password required to access the X.509 certificate data. + A bitwise combination of the enumeration values that control where and how to import the private key of the certificate. + An error with the certificate occurs. For example:The certificate file does not exist.The certificate is invalid.The certificate's password is incorrect. + + + Gets or sets a value indicating that an X.509 certificate is archived. + true if the certificate is archived, false if the certificate is not archived. + The certificate is unreadable. + + + Gets a collection of objects. + An object. + The certificate is unreadable. + + + Gets or sets the associated alias for a certificate. + The certificate's friendly name. + The certificate is unreadable. + + + Indicates the type of certificate contained in a byte array. + An object. + A byte array containing data from an X.509 certificate. + + has a zero length or is null. + + + Indicates the type of certificate contained in a file. + An object. + The name of a certificate file. + + is null. + + + Gets the subject and issuer names from a certificate. + The name of the certificate. + The value for the subject. + true to include the issuer name; otherwise, false. + + + Gets a value that indicates whether an object contains a private key. + true if the object contains a private key; otherwise, false. + The certificate context is invalid. + + + Populates an object with data from a byte array. + A byte array containing data from an X.509 certificate. + + + Populates an object using data from a byte array, a password, and a key storage flag. + A byte array that contains data from an X.509 certificate. + The password required to access the X.509 certificate data. + A bitwise combination of the enumeration values that control where and how to import the private key of the certificate. + + + Populates an object using data from a byte array, a password, and flags for determining how to import the private key. + A byte array containing data from an X.509 certificate. + The password required to access the X.509 certificate data. + A bitwise combination of the enumeration values that control where and how to import the private key of the certificate. + + + Populates an object with information from a certificate file. + The name of a certificate. + + + Populates an object with information from a certificate file, a password, and a key storage flag. + The name of a certificate file. + The password required to access the X.509 certificate data. + A bitwise combination of the enumeration values that control where and how to import the private key of the certificate. + + + Populates an object with information from a certificate file, a password, and a value. + The name of a certificate file. + The password required to access the X.509 certificate data. + A bitwise combination of the enumeration values that control where and how to import the private key of the certificate. + + + Gets the distinguished name of the certificate issuer. + An object that contains the name of the certificate issuer. + The certificate context is invalid. + + + Gets the date in local time after which a certificate is no longer valid. + A object that represents the expiration date for the certificate . + The certificate is unreadable. + + + Gets the date in local time on which a certificate becomes valid. + A object that represents the effective date of the certificate. + The certificate is unreadable. + + + Gets or sets the object that represents the private key associated with a certificate. + An object, which is either an RSA or DSA cryptographic service provider. + The key value is not an RSA or DSA key, or the key is unreadable. + The value being set for this property is null. + The key algorithm for this private key is not supported. + The X.509 keys do not match. + The cryptographic service provider key is null. + + + Gets a object associated with a certificate. + A object. + The key value is not an RSA or DSA key, or the key is unreadable. + + + Gets the raw data of a certificate. + The raw data of the certificate as a byte array. + + + Resets the state of an object. + + + Gets the serial number of a certificate. + The serial number of the certificate. + + + Gets the algorithm used to create the signature of a certificate. + Returns the object identifier () of the signature algorithm. + The certificate is unreadable. + + + Gets the subject distinguished name from a certificate. + An object that represents the name of the certificate subject. + The certificate context is invalid. + + + Gets the thumbprint of a certificate. + The thumbprint of the certificate. + + + Displays an X.509 certificate in text format. + The certificate information. + + + Displays an X.509 certificate in text format. + The certificate information. + true to display the public key, private key, extensions, and so forth; false to display information that is similar to the class, including thumbprint, serial number, subject and issuer names, and so on. + + + Performs a X.509 chain validation using basic validation policy. + true if the validation succeeds; false if the validation fails. + The certificate is unreadable. + + + Gets the X.509 format version of a certificate. + The certificate format. + The certificate is unreadable. + + + Represents a collection of objects. This class cannot be inherited. + + + Initializes a new instance of the class without any information. + + + Initializes a new instance of the class using an object. + An object to start the collection from. + + + Initializes a new instance of the class using an array of objects. + An array of objects. + + + Initializes a new instance of the class using the specified certificate collection. + An object. + + + Adds an object to the end of the . + The index at which the has been added. + An X.509 certificate represented as an object. + + is null. + + + Adds multiple objects in an array to the object. + An array of objects. + + is null. + + + Adds multiple objects in an object to another object. + An object. + + is null. + + + Determines whether the object contains a specific certificate. + true if the contains the specified ; otherwise, false. + The object to locate in the collection. + + is null. + + + Exports X.509 certificate information into a byte array. + X.509 certificate information in a byte array. + A supported object. + + + Exports X.509 certificate information into a byte array using a password. + X.509 certificate information in a byte array. + A supported object. + A string used to protect the byte array. + The certificate is unreadable, the content is invalid or, in the case of a certificate requiring a password, the private key could not be exported because the password provided was incorrect. + + + Searches an object using the search criteria specified by the enumeration and the object. + An object. + One of the values. + The search criteria as an object. + true to allow only valid certificates to be returned from the search; otherwise, false. + + is invalid. + + + Returns an enumerator that can iterate through a object. + An object that can iterate through the object. + + + Imports a certificate in the form of a byte array into a object. + A byte array containing data from an X.509 certificate. + + + Imports a certificate, in the form of a byte array that requires a password to access the certificate, into a object. + A byte array containing data from an object. + The password required to access the certificate information. + A bitwise combination of the enumeration values that control how and where the private key is imported. + + + Imports a certificate file into a object. + The name of the file containing the certificate information. + + + Imports a certificate file that requires a password into a object. + The name of the file containing the certificate information. + The password required to access the certificate information. + A bitwise combination of the enumeration values that control how and where the private key is imported. + + + Inserts an object into the object at the specified index. + The zero-based index at which to insert . + The object to insert. + + is less than zero.-or- is greater than the property. + The collection is read-only.-or- The collection has a fixed size. + + is null. + + + Gets or sets the element at the specified index. + The element at the specified index. + The zero-based index of the element to get or set. + + is less than zero.-or- is equal to or greater than the property. + + is null. + + + Removes the first occurrence of a certificate from the object. + The object to be removed from the object. + + is null. + + + Removes multiple objects in an array from an object. + An array of objects. + + is null. + + + Removes multiple objects in an object from another object. + An object. + + is null. + + + Supports a simple iteration over a object. This class cannot be inherited. + + + Gets the current element in the object. + The current element in the object. + The enumerator is positioned before the first element of the collection or after the last element. + + + Advances the enumerator to the next element in the object. + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Sets the enumerator to its initial position, which is before the first element in the object. + The collection was modified after the enumerator was created. + + + For a description of this member, see . + The current element in the object. + The enumerator is positioned before the first element of the collection or after the last element. + + + For a description of this member, see . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + For a description of this member, see . + The collection was modified after the enumerator was created. + + + Defines a collection that stores objects. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class from an array of objects. + The array of objects with which to initialize the new object. + + + Initializes a new instance of the class from another . + The with which to initialize the new object. + + + Adds an with the specified value to the current . + The index into the current at which the new was inserted. + The to add to the current . + + + Copies the elements of an array of type to the end of the current . + The array of type containing the objects to add to the current . + The parameter is null. + + + Copies the elements of the specified to the end of the current . + The containing the objects to add to the collection. + The parameter is null. + + + Gets a value indicating whether the current contains the specified . + true if the is contained in this collection; otherwise, false. + The to locate. + + + Copies the values in the current to a one-dimensional instance at the specified index. + The one-dimensional that is the destination of the values copied from . + The index into to begin copying. + The parameter is multidimensional.-or- The number of elements in the is greater than the available space between and the end of . + The parameter is null. + The parameter is less than the parameter's lower bound. + + + Returns an enumerator that can iterate through the . + An enumerator of the subelements of you can use to iterate through the collection. + + + Builds a hash value based on all values contained in the current . + A hash value based on all values contained in the current . + + + Returns the index of the specified in the current . + The index of the specified by the parameter in the , if found; otherwise, -1. + The to locate. + + + Inserts a into the current at the specified index. + The zero-based index where should be inserted. + The to insert. + + + Gets or sets the entry at the specified index of the current . + The at the specified index of the current . + The zero-based index of the entry to locate in the current . + The parameter is outside the valid range of indexes for the collection. + + + Removes a specific from the current . + The to remove from the current . + The specified by the parameter is not found in the current . + + + Enumerates the objects in an . + + + Initializes a new instance of the class for the specified . + The to enumerate. + + + Gets the current in the . + The current in the . + The enumerator is positioned before the first element of the collection or after the last element. + + + Advances the enumerator to the next element of the collection. + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was instantiated. + + + Sets the enumerator to its initial position, which is before the first element in the collection. + The collection is modified after the enumerator is instantiated. + + + For a description of this member, see . + The current X.509 certificate object in the object. + The enumerator is positioned before the first element of the collection or after the last element. + + + For a description of this member, see . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was instantiated. + + + For a description of this member, see . + The collection was modified after the enumerator was instantiated. + + + Represents a chain-building engine for certificates. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class specifying a value that indicates whether the machine context should be used. + true to use the machine context; false to use the current user context. + + + Initializes a new instance of the class using an handle to an X.509 chain. + An handle to an X.509 chain. + The parameter is null. + The parameter points to an invalid context. + + + Builds an X.509 chain using the policy specified in . + true if the X.509 certificate is valid; otherwise, false. + An object. + The is not a valid certificate or is null. + The is unreadable. + + + Gets a handle to an X.509 chain. + An handle to an X.509 chain. + + + Gets a collection of objects. + An object. + + + Gets or sets the to use when building an X.509 certificate chain. + The object associated with this X.509 chain. + The value being set for this property is null. + + + Gets the status of each element in an object. + An array of objects. + + + + + + Creates an object after querying for the mapping defined in the CryptoConfig file, and maps the chain to that mapping. + An object. + + + + + + Clears the current object. + + + Represents an element of an X.509 chain. + + + Gets the X.509 certificate at a particular chain element. + An object. + + + Gets the error status of the current X.509 certificate in a chain. + An array of objects. + + + + + + Gets additional error information from an unmanaged certificate chain structure. + A string representing the pwszExtendedErrorInfo member of the unmanaged CERT_CHAIN_ELEMENT structure in the Crypto API. + + + Represents a collection of objects. This class cannot be inherited. + + + Copies an object into an array, starting at the specified index. + An array of objects. + An integer representing the index value. + The specified is less than zero, or greater than or equal to the length of the array. + + is null. + + plus the current count is greater than the length of the array. + + + Gets the number of elements in the collection. + An integer representing the number of elements in the collection. + + + Gets an object that can be used to navigate through a collection of chain elements. + An object. + + + Gets a value indicating whether the collection of chain elements is synchronized. + Always returns false. + + + Gets the object at the specified index. + An object. + An integer value. + + is less than zero. + + is greater than or equal to the length of the collection. + + + Gets an object that can be used to synchronize access to an object. + A pointer reference to the current object. + + + Copies an object into an array, starting at the specified index. + An array to copy the object to. + The index of at which to start copying. + The specified is less than zero, or greater than or equal to the length of the array. + + is null. + + plus the current count is greater than the length of the array. + + + Gets an object that can be used to navigate a collection of chain elements. + An object. + + + Supports a simple iteration over an . This class cannot be inherited. + + + Gets the current element in the . + The current element in the . + The enumerator is positioned before the first element of the collection or after the last element. + + + + + + Advances the enumerator to the next element in the . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Sets the enumerator to its initial position, which is before the first element in the . + The collection was modified after the enumerator was created. + + + Gets the current element in the . + The current element in the . + The enumerator is positioned before the first element of the collection or after the last element. + + + Represents the chain policy to be applied when building an X509 certificate chain. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Gets a collection of object identifiers (OIDs) specifying which application policies or enhanced key usages (EKUs) the certificate supports. + An object. + + + Gets a collection of object identifiers (OIDs) specifying which certificate policies the certificate supports. + An object. + + + Represents an additional collection of certificates that can be searched by the chaining engine when validating a certificate chain. + An object. + + + Resets the members to their default values. + + + Gets or sets values for X509 revocation flags. + An object. + The value supplied is not a valid flag. + + + Gets or sets values for X509 certificate revocation mode. + An object. + The value supplied is not a valid flag. + + + Gets the time span that elapsed during online revocation verification or downloading the certificate revocation list (CRL). + A object. + + + Gets verification flags for the certificate. + A value from the enumeration. + The value supplied is not a valid flag. is the default value. + + + The time that the certificate was verified expressed in local time. + A object. + + + Provides a simple structure for storing X509 chain status and error information. + + + Specifies the status of the X509 chain. + An value. + + + Specifies a description of the value. + A localizable string. + + + Defines the status of an X509 chain. + + + Specifies that the X509 chain has no errors. + + + Specifies that the X509 chain is not valid due to an invalid time value, such as a value that indicates an expired certificate. + + + Deprecated, this flag has no effect. + + + Specifies that the X509 chain is invalid due to a revoked certificate. + + + Specifies that the X509 chain is invalid due to an invalid certificate signature. + + + Specifies that the key usage is not valid. + + + Specifies that the X509 chain is invalid due to an untrusted root certificate. + + + Specifies that it is not possible to determine whether the certificate has been revoked. This can be due to the certificate revocation list (CRL) being offline or unavailable. + + + Specifies that the X509 chain could not be built. + + + Specifies that the X509 chain is invalid due to an invalid extension. + + + Specifies that the X509 chain is invalid due to invalid policy constraints. + + + Specifies that the X509 chain is invalid due to invalid basic constraints. + + + Specifies that the X509 chain is invalid due to invalid name constraints. + + + Specifies that the certificate does not have a supported name constant or has a name constant that is unsupported. + + + Specifies that the certificate has an undefined name constant. + + + Specifies that the certificate has an impermissible name constraint. + + + Specifies that the X509 chain is invalid because a certificate has excluded a name constraint. + + + Specifies that the X509 chain could not be built up to the root certificate. + + + Specifies that the certificate trust list (CTL) is not valid because of an invalid time value, such as one that indicates that the CTL has expired. + + + Specifies that the certificate trust list (CTL) contains an invalid signature. + + + Specifies that the certificate trust list (CTL) is not valid for this use. + + + Specifies that the online certificate revocation list (CRL) the X509 chain relies on is currently offline. + + + Specifies that there is no certificate policy extension in the certificate. This error would occur if a group policy has specified that all certificates must have a certificate policy. + + + Defines the collection of object identifiers (OIDs) that indicates the applications that use the key. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using an object and a value that identifies whether the extension is critical. + The encoded data to use to create the extension. + true if the extension is critical; otherwise, false. + + + Initializes a new instance of the class using an and a value that identifies whether the extension is critical. + An collection. + true if the extension is critical; otherwise, false. + The specified contains one or more corrupt values. + + + Initializes a new instance of the class using an object. + The encoded data to use to create the extension. + + + Gets the collection of object identifiers (OIDs) that indicate the applications that use the key. + An object indicating the applications that use the key. + + + + + + Represents an X509 extension. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class. + The encoded data to be used to create the extension. + true if the extension is critical; otherwise false. + + + Initializes a new instance of the class. + The object identifier used to identify the extension. + The encoded data used to create the extension. + true if the extension is critical; otherwise false. + + is null. + + is an empty string (""). + + + Initializes a new instance of the class. + A string representing the object identifier. + The encoded data used to create the extension. + true if the extension is critical; otherwise false. + + + Copies the extension properties of the specified object. + The to be copied. + + is null. + + does not have a valid X.509 extension. + + + Gets a Boolean value indicating whether the extension is critical. + true if the extension is critical; otherwise, false. + + + Represents a collection of objects. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Adds an object to an object. + The index at which the parameter was added. + An object to add to the object. + The value of the parameter is null. + + + Copies a collection into an array starting at the specified index. + An array of objects. + The location in the array at which copying starts. + + is a zero-length string or contains an invalid value. + + is null. + + specifies a value that is not in the range of the array. + + + Gets the number of objects in a object. + An integer representing the number of objects in the object. + + + Returns an enumerator that can iterate through an object. + An object to use to iterate through the object. + + + Gets a value indicating whether the collection is guaranteed to be thread safe. + true if the collection is thread safe; otherwise, false. + + + Gets the object at the specified index. + An object. + The location of the object to retrieve. + + is less than zero. + + is equal to or greater than the length of the array. + + + Gets the first object whose value or friendly name is specified by an object identifier (OID). + An object. + The object identifier (OID) of the extension to retrieve. + + + Gets an object that you can use to synchronize access to the object. + An object that you can use to synchronize access to the object. + + + Copies the collection into an array starting at the specified index. + An array of objects. + The location in the array at which copying starts. + + is a zero-length string or contains an invalid value. + + is null. + + specifies a value that is not in the range of the array. + + + Returns an enumerator that can iterate through an object. + An object to use to iterate through the object. + + + Supports a simple iteration over a . This class cannot be inherited. + + + Gets the current element in the . + The current element in the . + The enumerator is positioned before the first element of the collection or after the last element. + + + + + + Advances the enumerator to the next element in the . + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + The collection was modified after the enumerator was created. + + + Sets the enumerator to its initial position, which is before the first element in the . + The collection was modified after the enumerator was created. + + + Gets an object from a collection. + The current element in the . + The enumerator is positioned before the first element of the collection or after the last element. + + + Specifies the type of value the method searches for. + + + The parameter for the method must be a string representing the thumbprint of the certificate. + + + The parameter for the method must be a string representing the subject name of the certificate. This is a less specific search than that provided by the enumeration value. Using the value, the method performs a case-insensitive string comparison using the supplied value. For example, if you pass "MyCert" to the method, it will find all certificates with the subject name containing that string, regardless of other subject values. Searching by distinguished name is a more precise search. + + + The parameter for the method must be a string representing the subject distinguished name of the certificate. This is a more specific search than that provided by the enumeration value. Using the value, the method performs a case-insensitive string comparison for the entire distinguished name. Searching by subject name is a less precise search. + + + The parameter for the method must be a string representing the issuer name of the certificate. This is a less specific search than that provided by the enumeration value. Using the value, the method performs a case-insensitive string comparison using the supplied value. For example, if you pass "MyCA" to the method, it will find all certificates with the issuer name containing that string, regardless of other issuer values. + + + The parameter for the method must be a string representing the issuer distinguished name of the certificate. This is a more specific search than that provided by the enumeration value. Using the value, the method performs a case-insensitive string comparison for the entire distinguished name. Searching by issuer name is a less precise search. + + + The parameter for the method must be a string representing the serial number of the certificate as it is displayed by the UI. The serial number must be in reverse order because it is an integer. + + + The parameter for the method must be a value in local time. You can use to find all the currently valid certificates. + + + The parameter for the method must be a value in local time. The value does not have to be in the future. For example, you can use to find certificates that became valid in the current year by taking the intersection of the results of a operation for for the last day of last year with the results of a operation for of . + + + The parameter for the method must be a value in local time. For example, you can find all the certificates that will be valid until the end of the year by eliminating the results of a operation for of the last day of the year from the results of a operation for . + + + The parameter for the method must be a string representing the template name of the certificate, such as "ClientAuth". A template name is an X509 version 3 extension that specifies the uses of the certificate. + + + The parameter for the method must be a string representing either the application policy friendly name or the object identifier (OID, or ) of the certificate. For example, "Encrypting File System" or "1.3.6.1.4.1.311.10.3.4" can be used. For an application that will be localized, the OID value must be used, because the friendly name is localized. + + + The parameter for the method must be a string representing either the friendly name or the object identifier (OID, or ) of the certificate policy. The best practice is to use the OID, such as "1.3.6.1.4.1.311.10.3.4". For an application that will be localized, the OID must be used, because the friendly name is localized. + + + The parameter for the method must be a string describing the extension to find. The object identifier (OID) is most commonly used to direct the method to search for all certificates that have an extension matching that OID value. + + + The parameter for the method must be either a string representing the key usage or an integer representing a bit mask containing all the requested key usages. For the string value, only one key usage at a time can be specified, but the method can be used in a cascading sequence to get the intersection of the requested usages. For example, the parameter can be set to "KeyEncipherment" or an integer (0x30 indicates "KeyEncipherment" and "DataEncipherment"). Values of the enumeration can also be used. + + + The parameter for the method must be a string representing the subject key identifier in hexadecimal, such as "F3E815D45E83B8477B9284113C64EF208E897112", as displayed in the UI. + + + Specifies how much of the X.509 certificate chain should be included in the X.509 data. + + + No X.509 chain information is included. + + + The entire X.509 chain is included except for the root certificate. + + + Only the end certificate is included in the X.509 chain information. + + + The entire X.509 chain is included. + + + Defines the usage of a key contained within an X.509 certificate. This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using an object and a value that identifies whether the extension is critical. + The encoded data to use to create the extension. + true if the extension is critical; otherwise, false. + + + Initializes a new instance of the class using the specified value and a value that identifies whether the extension is critical. + One of the values that describes how to use the key. + true if the extension is critical; otherwise, false. + + + Initializes a new instance of the class using an object. + The encoded data to use to create the extension. + + + Gets the key usage flag associated with the certificate. + One of the values. + The extension cannot be decoded. + + + Defines how the certificate key can be used. If this value is not defined, the key can be used for any purpose. + + + No key usage parameters. + + + The key can be used for encryption only. + + + The key can be used to sign a certificate revocation list (CRL). + + + The key can be used to sign certificates. + + + The key can be used to determine key agreement, such as a key created using the Diffie-Hellman key agreement algorithm. + + + The key can be used for data encryption. + + + The key can be used for key encryption. + + + The key can be used for authentication. + + + The key can be used as a digital signature. + + + The key can be used for decryption only. + + + Specifies the type of name the X509 certificate contains. + + + The simple name of a subject or issuer of an X509 certificate. + + + The email address of the subject or issuer associated of an X509 certificate. + + + The UPN name of the subject or issuer of an X509 certificate. + + + The DNS name associated with the alternative name of either the subject or issuer of an X509 certificate. + + + The DNS name associated with the alternative name of either the subject or the issuer of an X.509 certificate. This value is equivalent to the value. + + + The URL address associated with the alternative name of either the subject or issuer of an X509 certificate. + + + Specifies which X509 certificates in the chain should be checked for revocation. + + + Only the end certificate is checked for revocation. + + + The entire chain of certificates is checked for revocation. + + + The entire chain, except the root certificate, is checked for revocation. + + + Specifies the mode used to check for X509 certificate revocation. + + + No revocation check is performed on the certificate. + + + A revocation check is made using an online certificate revocation list (CRL). + + + A revocation check is made using a cached certificate revocation list (CRL). + + + Represents an X.509 store, which is a physical store where certificates are persisted and managed. This class cannot be inherited. + + + Initializes a new instance of the class using the personal certificates of the current user store. + + + Initializes a new instance of the class using an Intptr handle to an HCERTSTORE store. + A handle to an HCERTSTORE store. + The parameter is null. + The parameter points to an invalid context. + + + Initializes a new instance of the class using the specified value. + One of the enumeration values that specifies the location of the X.509 certificate store. + + + Initializes a new instance of the class using the specified value. + One of the enumeration values that specifies the name of the X.509 certificate store. + + + Initializes a new instance of the class using the specified and values. + One of the enumeration values that specifies the name of the X.509 certificate store. + One of the enumeration values that specifies the location of the X.509 certificate store. + + is not a valid location or is not a valid name. + + + Initializes a new instance of the class using the specified store name. + A string value that represents the store name. See for more information. + + + Initializes a new instance of the class using a string that represents a value from the enumeration and a value from the enumeration. + A string that represents a value from the enumeration. + One of the enumeration values that specifies the location of the X.509 certificate store. + + contains invalid values. + + + Adds a certificate to an X.509 certificate store. + The certificate to add. + + is null. + The certificate could not be added to the store. + + + Adds a collection of certificates to an X.509 certificate store. + The collection of certificates to add. + + is null. + The caller does not have the required permission. + + + Returns a collection of certificates located in an X.509 certificate store. + A collection of certificates. + + + Closes an X.509 certificate store. + + + Gets the location of the X.509 certificate store. + The location of the certificate store. + + + Gets the name of the X.509 certificate store. + The name of the certificate store. + + + Opens an X.509 certificate store or creates a new store, depending on flag settings. + A bitwise combination of enumeration values that specifies the way to open the X.509 certificate store. + The store is unreadable. + The caller does not have the required permission. + The store contains invalid values. + + + Removes a certificate from an X.509 certificate store. + The certificate to remove. + + is null. + The caller does not have the required permission. + + + Removes a range of certificates from an X.509 certificate store. + A range of certificates to remove. + + is null. + The caller does not have the required permission. + + + Gets an handle to an HCERTSTORE store. + A handle to an HCERTSTORE store. + The store is not open. + + + Defines a string that identifies a certificate's subject key identifier (SKI). This class cannot be inherited. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class using a byte array and a value that identifies whether the extension is critical. + A byte array that represents data to use to create the extension. + true if the extension is critical; otherwise, false. + + + Initializes a new instance of the class using encoded data and a value that identifies whether the extension is critical. + The object to use to create the extension. + true if the extension is critical; otherwise, false. + + + Initializes a new instance of the class using a public key and a value indicating whether the extension is critical. + A object to create a subject key identifier (SKI) from. + true if the extension is critical; otherwise, false. + + + Initializes a new instance of the class using a public key, a hash algorithm identifier, and a value indicating whether the extension is critical. + A object to create a subject key identifier (SKI) from. + One of the values that identifies which hash algorithm to use. + true if the extension is critical; otherwise, false. + + + Initializes a new instance of the class using a string and a value that identifies whether the extension is critical. + A string, encoded in hexadecimal format, that represents the subject key identifier (SKI) for a certificate. + true if the extension is critical; otherwise, false. + + + Creates a new instance of the class by copying information from encoded data. + The object to use to create the extension. + + + Gets a string that represents the subject key identifier (SKI) for a certificate. + A string, encoded in hexadecimal format, that represents the subject key identifier (SKI). + The extension cannot be decoded. + + + Defines the type of hash algorithm to use with the class. + + + The SKI is composed of the 160-bit SHA-1 hash of the value of the public key (excluding the tag, length, and number of unused bits). + + + The SKI is composed of a four-bit type field with the value 0100, followed by the least significant 60 bits of the SHA-1 hash of the value of the public key (excluding the tag, length, and number of unused bit string bits) + + + The subject key identifier (SKI) is composed of a 160-bit SHA-1 hash of the encoded public key (including the tag, length, and number of unused bits). + + + Specifies conditions under which verification of certificates in the X509 chain should be conducted. + + + No flags pertaining to verification are included. + + + Ignore certificates in the chain that are not valid either because they have expired or they are not yet in effect when determining certificate validity. + + + Ignore that the certificate trust list (CTL) is not valid, for reasons such as the CTL has expired, when determining certificate verification. + + + Ignore that the CA (certificate authority) certificate and the issued certificate have validity periods that are not nested when verifying the certificate. For example, the CA cert can be valid from January 1 to December 1 and the issued certificate from January 2 to December 2, which would mean the validity periods are not nested. + + + Ignore that the basic constraints are not valid when determining certificate verification. + + + Ignore that the chain cannot be verified due to an unknown certificate authority (CA). + + + Ignore that the certificate was not issued for the current use when determining certificate verification. + + + Ignore that the certificate has an invalid name when determining certificate verification. + + + Ignore that the certificate has invalid policy when determining certificate verification. + + + Ignore that the end certificate (the user certificate) revocation is unknown when determining certificate verification. + + + Ignore that the certificate trust list (CTL) signer revocation is unknown when determining certificate verification. + + + Ignore that the certificate authority revocation is unknown when determining certificate verification. + + + Ignore that the root revocation is unknown when determining certificate verification. + + + All flags pertaining to verification are included. + + + Allows control of code access security permissions. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified level of access to resources at creation. + One of the values. + The parameter is not a valid value of . + + + Adds a permission entry to the permission. + The to add. + The specified is null. + The number of elements in the property is not equal to the number of elements in the property.-or- The is already included in the permission. + + + Specifies the character to be used to represent the any wildcard character. + + + Clears the permission of the added permission entries. + + + Creates and returns an identical copy of the current permission object. + A copy of the current permission object. + + + + + + Reconstructs a security object with a specified state from an XML encoding. + The XML encoding to use to reconstruct the security object. + The parameter is not a valid permission element.-or- The version number of the parameter is not supported. + The parameter is null. + + + Returns an array of the objects added to this permission. + An array of objects that were added to this permission. + + + Creates and returns a permission object that is the intersection of the current permission object and a target permission object. + A new permission object that represents the intersection of the current object and the specified target. This object is null if the intersection is empty. + A permission object of the same type as the current permission object. + The target permission object is not of the same type as the current permission object. + + + Determines whether the current permission object is a subset of the specified permission. + true if the current permission object is a subset of the specified permission object; otherwise, false. + A permission object that is to be tested for the subset relationship. + + + Gets a value indicating whether the permission is unrestricted. + true if permission is unrestricted; otherwise, false. + + + Specifies the character to be used to represent a local reference. + + + Gets or sets an enumeration value that describes the types of access that you are giving the resource. + An enumeration value that is derived from and describes the types of access that you are giving the resource. + The property value is null. + The property value is not an enumeration value. + + + Removes a permission entry from the permission. + The to remove. + The specified is null. + The number of elements in the property is not equal to the number of elements in the property.-or- The is not in the permission. + + + Gets or sets an array of strings that identify the resource you are protecting. + An array of strings that identify the resource you are trying to protect. + The property value is null. + The length of the array is 0. + + + Creates and returns an XML encoding of the security object and its current state. + An XML encoding of the security object, including any state information. + + + Creates a permission object that combines the current permission object and the target permission object. + A new permission object that represents the union of the current permission object and the specified permission object. + A permission object to combine with the current permission object. It must be of the same type as the current permission object. + The permission object is not of the same type as the current permission object. + + + Defines the smallest unit of a code access security permission set. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class with the specified permission access and permission access path. + The integer representation of the permission access level enumeration value. The property is set to this value. + The array of strings that identify the resource you are protecting. The property is set to this value. + The specified is null. + + + Gets an integer representation of the access level enumeration value. + The access level enumeration value. + + + Gets an array of strings that identify the resource you are protecting. + An array of strings that identify the resource you are protecting. + + + Controls access to stores containing X.509 certificates. This class cannot be inherited. + + + Initializes a new instance of the class with either fully restricted or unrestricted permission state. + One of the values. + + is not a valid value. + + + Initializes a new instance of the class with the specified access. + A bitwise combination of the values. + + is not a valid combination of values. + + + Creates and returns an identical copy of the current permission. + A copy of the current permission. + + + + + + Gets or sets the type of access allowed by the current permission. + A bitwise combination of the values. + An attempt is made to set this property to an invalid value. See for the valid values. + + + Reconstructs a permission with a specified state from an XML encoding. + A that contains the XML encoding to use to reconstruct the permission. + + is null. + + is not a valid permission element.-or- The version number in is not valid. + + + Creates and returns a permission that is the intersection of the current permission and the specified permission. + A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty. + A permission to intersect with the current permission. It must be of the same type as the current permission. + + s not null and is not of the same type as the current permission. + + + Determines whether the current permission is a subset of the specified permission. + true if the current permission is a subset of the specified permission; otherwise, false. + A permission to test for the subset relationship. This permission must be of the same type as the current permission. + + is not null and is not of the same type as the current permission. + + + Returns a value indicating whether the current permission is unrestricted. + true if the current permission is unrestricted; otherwise, false. + + + Creates an XML encoding of the permission and its current state. + A that contains an XML encoding of the permission, including any state information. + + + + + + Creates a permission that is the union of the current permission and the specified permission. + A new permission that represents the union of the current permission and the specified permission. + A permission to combine with the current permission. It must be of the same type as the current permission. + + is not null and is not of the same type as the current permission. + + + Allows security actions for to be applied to code using declarative security. This class cannot be inherited. + + + Initializes a new instance of the class with the specified security action. + One of the values. + + + Gets or sets a value indicating whether the code is permitted to add to a store. + true if the ability to add to a store is allowed; otherwise, false. + + + Creates and returns a new . + A that corresponds to the attribute. + + + + + + Gets or sets a value indicating whether the code is permitted to create a store. + true if the ability to create a store is allowed; otherwise, false. + + + Gets or sets a value indicating whether the code is permitted to delete a store. + true if the ability to delete a store is allowed; otherwise, false. + + + Gets or sets a value indicating whether the code is permitted to enumerate the certificates in a store. + true if the ability to enumerate certificates is allowed; otherwise, false. + + + Gets or sets a value indicating whether the code is permitted to enumerate stores. + true if the ability to enumerate stores is allowed; otherwise, false. + + + Gets or sets the store permissions. + A bitwise combination of the values. The default is . + + + Gets or sets a value indicating whether the code is permitted to open a store. + true if the ability to open a store is allowed; otherwise, false. + + + Gets or sets a value indicating whether the code is permitted to remove a certificate from a store. + true if the ability to remove a certificate from a store is allowed; otherwise, false. + + + Specifies the permitted access to X.509 certificate stores. + + + Permission is not given to perform any certificate or store operations. + + + The ability to create a new store. + + + The ability to delete a store. + + + The ability to enumerate the stores on a computer. + + + The ability to open a store. + + + The ability to add a certificate to a store. + + + The ability to remove a certificate from a store. + + + The ability to enumerate the certificates in a store. + + + The ability to perform all certificate and store operations. + + + Defines partial-trust access to the class. + + + Initializes a new instance of the class. + The to request. Only and are valid. + + is not a valid permission state. Only and are valid. + + + Initializes a new instance of the class with the specified permission flags. + The permission flags to request. + + + A copy of the current permission object. + + + Gets or sets the for the type descriptor. + The for the type descriptor. + + + The XML encoding to use to reconstruct the security object. + + + A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty. + A permission to intersect with the current permission. It must be of the same type as the current permission. + + + true if the current permission is a subset of the specified permission; otherwise, false. + A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. + + + Gets a value that indicates whether the type descriptor may be called from partially trusted code. + true if the property is set to ; otherwise, false. + + + An XML encoding of the security object, including any state information. + + + A new permission that represents the union of the current permission and the specified permission. + A permission to combine with the current permission. It must be of the same type as the current permission. + + + Determines the permission flags that apply to a . + + + Initializes a new instance of the class with the specified . + One of the values. + + + A serializable permission object. + + + Gets or sets the for the . + The for the . + + + Gets or sets a value that indicates whether the type descriptor can be accessed from partial trust. + true if the type descriptor can be accessed from partial trust; otherwise, false. + + + Defines permission settings for type descriptors. + + + No permission flags are set on the type descriptor. + + + The type descriptor may be called from partially trusted code. + + + Represents the results from a single successful subexpression capture. + + + The position in the original string where the first character of the captured substring was found. + The zero-based starting position in the original string where the captured substring was found. + + + The length of the captured substring. + The length of the captured substring. + + + Gets the captured substring from the input string. + The actual substring that was captured by the match. + + + Gets the captured substring from the input string. + The actual substring that was captured by the match. + + + Represents the set of captures made by a single capturing group. + + + Copies all the elements of the collection to the given array beginning at the given index. + The array the collection is to be copied into. + The position in the destination array where copying is to begin. + + is null. + + is outside the bounds of . -or- plus is outside the bounds of . + + + Gets the number of substrings captured by the group. + The number of items in the . + + + Provides an enumerator that iterates through the collection. + An object that contains all objects within the . + + + Gets a value that indicates whether the collection is read only. + true in all cases. + + + Gets a value that indicates whether access to the collection is synchronized (thread-safe). + false in all cases. + + + Gets an individual member of the collection. + The captured substring at position in the collection. + Index into the capture collection. + + is less than 0 or greater than . + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the collection. + + + Represents the results from a single capturing group. + + + Gets a collection of all the captures matched by the capturing group, in innermost-leftmost-first order (or innermost-rightmost-first order if the regular expression is modified with the option). The collection may have zero or more items. + The collection of substrings matched by the group. + + + Gets a value indicating whether the match is successful. + true if the match is successful; otherwise, false. + + + Returns a Group object equivalent to the one supplied that is safe to share between multiple threads. + A regular expression Group object. + The input object. + + is null. + + + Returns the set of captured groups in a single match. + + + Copies all the elements of the collection to the given array beginning at the given index. + The array the collection is to be copied into. + The position in the destination array where the copying is to begin. + + is null. + + is outside the bounds of .-or- plus is outside the bounds of . + + + Returns the number of groups in the collection. + The number of groups in the collection. + + + Provides an enumerator that iterates through the collection. + An enumerator that contains all objects in the . + + + Gets a value that indicates whether the collection is read-only. + true in all cases. + + + Gets a value that indicates whether access to the is synchronized (thread-safe). + false in all cases. + + + Enables access to a member of the collection by integer index. + The member of the collection specified by . + The zero-based index of the collection member to be retrieved. + + + Enables access to a member of the collection by string index. + The member of the collection specified by . + The name of a capturing group. + + + Gets an object that can be used to synchronize access to the . + A copy of the object to synchronize. + + + Represents the results from a single regular expression match. + + + Gets the empty group. All failed matches return this empty match. + An empty match. + + + Gets a collection of groups matched by the regular expression. + The character groups matched by the pattern. + + + Returns a new object with the results for the next match, starting at the position at which the last match ended (at the character after the last matched character). + The next regular expression match. + + + + + + Returns the expansion of the specified replacement pattern. + The expanded version of the parameter. + The replacement pattern to use. + + is null. + Expansion is not allowed for this pattern. + + + Returns a instance equivalent to the one supplied that is suitable to share between multiple threads. + A regular expression match that is suitable to share between multiple threads. + A regular expression match equivalent to the one expected. + + is null. + + + Represents the set of successful matches found by iteratively applying a regular expression pattern to the input string. + + + Copies all the elements of the collection to the given array starting at the given index. + The array the collection is to be copied into. + The position in the array where copying is to begin. + + is a multi-dimensional array. + + is outside the bounds of .-or- plus is outside the bounds of . + + + Gets the number of matches. + The number of matches. + + + + + + Provides an enumerator that iterates through the collection. + An object that contains all objects within the . + + + Gets a value that indicates whether the collection is read only. + true in all cases. + + + Gets a value indicating whether access to the collection is synchronized (thread-safe). + false in all cases. + + + Gets an individual member of the collection. + The captured substring at position in the collection. + Index into the collection. + + is less than 0 or greater than or equal to . + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the collection. This property always returns the object itself. + + + Represents the method that is called each time a regular expression match is found during a method operation. + A string returned by the method that is represented by the delegate. + The object that represents a single regular expression match during a method operation. + + + Represents an immutable regular expression. + + + Initializes a new instance of the class. + + + Initializes a new instance of the class by using serialized data. + The object that contains a serialized pattern and information. + The destination for this serialization. (This parameter is not used; specify null.) + A regular expression parsing error occurred. + The pattern that contains is null. + + contains an invalid flag. + + + Initializes and compiles a new instance of the class for the specified regular expression. + The regular expression pattern to match. + A regular expression parsing error occurred. + + is null. + + + Initializes and compiles a new instance of the class for the specified regular expression, with options that modify the pattern. + The regular expression pattern to match. + A bitwise combination of the enumeration values that modify the regular expression. + A regular expression parsing error occurred. + + is null. + + contains an invalid flag. + + + Gets or sets the maximum number of entries in the current static cache of compiled regular expressions. + The maximum number of entries in the static cache. + The value in a set operation is less than zero. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Compiles one or more specified objects to a named assembly. + An array that describes the regular expressions to compile. + The file name of the assembly. + The value of the parameter's property is an empty or null string.-or-The regular expression pattern of one or more objects in contains invalid syntax. + + or is null. + + + + + + + Compiles one or more specified objects to a named assembly with the specified attributes. + An array that describes the regular expressions to compile. + The file name of the assembly. + An array that defines the attributes to apply to the assembly. + The value of the parameter's property is an empty or null string.-or-The regular expression pattern of one or more objects in contains invalid syntax. + + or is null. + + + + + + + Compiles one or more specified objects and a specified resource file to a named assembly with the specified attributes. + An array that describes the regular expressions to compile. + The file name of the assembly. + An array that defines the attributes to apply to the assembly. + The name of the Win32 resource file to include in the assembly. + The value of the parameter's property is an empty or null string.-or-The regular expression pattern of one or more objects in contains invalid syntax. + + or is null. + The parameter designates an invalid Win32 resource file. + The file designated by the parameter cannot be found. + + + + + + + Escapes a minimal set of characters (\, *, +, ?, |, {, [, (,), ^, $,., #, and white space) by replacing them with their escape codes. This instructs the regular expression engine to interpret these characters literally rather than as metacharacters. + A string of characters with metacharacters converted to their escaped form. + The input string that contains the text to convert. + + is null. + + + Used by a object generated by the method. + + + Returns an array of capturing group names for the regular expression. + A string array of group names. + + + + + + Returns an array of capturing group numbers that correspond to group names in an array. + An integer array of group numbers. + + + Gets the group name that corresponds to the specified group number. + A string that contains the group name associated with the specified group number. If there is no group name that corresponds to , the method returns . + The group number to convert to the corresponding group name. + + + Returns the group number that corresponds to the specified group name. + The group number that corresponds to the specified group name, or -1 if is not a valid group name. + The group name to convert to the corresponding group number. + + is null. + + + Used by a object generated by the method. + References have already been initialized. + + + Indicates whether the regular expression specified in the constructor finds a match in a specified input string. + true if the regular expression finds a match; otherwise, false. + The string to search for a match. + + is null. + + + + + + + Indicates whether the regular expression specified in the constructor finds a match in the specified input string, beginning at the specified starting position in the string. + true if the regular expression finds a match; otherwise, false. + The string to search for a match. + The character position at which to start the search. + + is null. + + is less than zero or greater than the length of . + + + + + + + Indicates whether the specified regular expression finds a match in the specified input string. + true if the regular expression finds a match; otherwise, false. + The string to search for a match. + The regular expression pattern to match. + A regular expression parsing error occurred. + + or is null. + + + + + + + Indicates whether the specified regular expression finds a match in the specified input string, using the specified matching options. + true if the regular expression finds a match; otherwise, false. + The string to search for a match. + The regular expression pattern to match. + A bitwise combination of the enumeration values that provide options for matching. + A regular expression parsing error occurred. + + or is null. + + is not a valid value. + + + + + + + Searches the specified input string for the first occurrence of the regular expression specified in the constructor. + An object that contains information about the match. + The string to search for a match. + + is null. + + + + + + + Searches the input string for the first occurrence of a regular expression, beginning at the specified starting position in the string. + An object that contains information about the match. + The string to search for a match. + The zero-based character position at which to start the search. + + is null. + + is less than zero or greater than the length of . + + + + + + + Searches the input string for the first occurrence of a regular expression, beginning at the specified starting position and searching only the specified number of characters. + An object that contains information about the match. + The string to search for a match. + The zero-based character position in the input string that defines the leftmost position to be searched. + The number of characters in the substring to include in the search. + + is null. + + is less than zero or greater than the length of .-or- is less than zero or greater than the length of .-or-+– 1 identifies a position that is outside the range of . + + + + + + + Searches the specified input string for the first occurrence of the specified regular expression. + An object that contains information about the match. + The string to search for a match. + The regular expression pattern to match. + A regular expression parsing error occurred. + + or is null. + + + + + + + Searches the input string for the first occurrence of the specified regular expression, using the specified matching options. + An object that contains information about the match. + The string to search for a match. + The regular expression pattern to match. + A bitwise combination of the enumeration values that provide options for matching. + A regular expression parsing error occurred. + + or is null. + + is not a valid bitwise combination of values. + + + + + + + Searches the specified input string for all occurrences of a regular expression. + A collection of the objects found by the search. If no matches are found, the method returns an empty collection object. + The string to search for a match. + + is null. + + + + + + + Searches the specified input string for all occurrences of a regular expression, beginning at the specified starting position in the string. + A collection of the objects found by the search. If no matches are found, the method returns an empty collection object. + The string to search for a match. + The character position in the input string at which to start the search. + + is null. + + is less than zero or greater than the length of . + + + + + + + Searches the specified input string for all occurrences of a specified regular expression. + A collection of the objects found by the search. If no matches are found, the method returns an empty collection object. + The string to search for a match. + The regular expression pattern to match. + A regular expression parsing error occurred. + + or is null. + + + + + + + Searches the specified input string for all occurrences of a specified regular expression, using the specified matching options. + A collection of the objects found by the search. If no matches are found, the method returns an empty collection object. + The string to search for a match. + The regular expression pattern to match. + A bitwise combination of the enumeration values that specify options for matching. + A regular expression parsing error occurred. + + or is null. + + is not a valid bitwise combination of values. + + + + + + + Returns the options passed into the constructor. + The parameter that was passed into the constructor. + + + Used by a object generated by the method. + + + Within a specified input string, replaces all strings that match a regular expression pattern with a specified replacement string. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + The replacement string. + + or is null. + + + + + + + Within a specified input string, replaces a specified maximum number of strings that match a regular expression pattern with a specified replacement string. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + The replacement string. + The maximum number of times the replacement can occur. + + or is null. + + + + + + + Within a specified input substring, replaces a specified maximum number of strings that match a regular expression pattern with a specified replacement string. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + The replacement string. + Maximum number of times the replacement can occur. + The character position in the input string where the search begins. + + or is null. + + is less than zero or greater than the length of . + + + + + + + Within a specified input string, replaces all strings that match a specified regular expression with a specified replacement string. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + The regular expression pattern to match. + The replacement string. + A regular expression parsing error occurred. + + , , or is null. + + + + + + + Within a specified input string, replaces all strings that match a specified regular expression with a specified replacement string. Specified options modify the matching operation. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + The regular expression pattern to match. + The replacement string. + A bitwise combination of the enumeration values that provide options for matching. + A regular expression parsing error occurred. + + , , or is null. + + is not a valid bitwise combination of values. + + + + + + + Within a specified input string, replaces all strings that match a specified regular expression with a string returned by a delegate. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + The regular expression pattern to match. + A custom method that examines each match and returns either the original matched string or a replacement string. + A regular expression parsing error occurred. + + , , or is null. + + + + + + + Within a specified input string, replaces all strings that match a specified regular expression with a string returned by a delegate. Specified options modify the matching operation. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + The regular expression pattern to match. + A custom method that examines each match and returns either the original matched string or a replacement string. + A bitwise combination of the enumeration values that provide options for matching. + A regular expression parsing error occurred. + + , , or is null. + + is not a valid bitwise combination of values. + + + + + + + Within a specified input string, replaces all strings that match a specified regular expression with a string returned by a delegate. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + A custom method that examines each match and returns either the original matched string or a replacement string. + + or is null. + + + + + + + Within a specified input string, replaces a specified maximum number of strings that match a regular expression pattern with a string returned by a delegate. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + A custom method that examines each match and returns either the original matched string or a replacement string. + The maximum number of times the replacement will occur. + + or is null. + + + + + + + Within a specified input substring, replaces a specified maximum number of strings that match a regular expression pattern with a string returned by a delegate. + A new string that is identical to the input string, except that a replacement string takes the place of each matched string. + The string to search for a match. + A custom method that examines each match and returns either the original matched string or a replacement string. + The maximum number of times the replacement will occur. + The character position in the input string where the search begins. + + or is null. + + is less than zero or greater than the length of . + + + + + + + Gets a value indicating whether the regular expression searches from right to left. + true if the regular expression searches from right to left; otherwise false. + + + Used by a object generated by the method. + + + Splits the specified input string at the positions defined by a regular expression pattern specified in the constructor. + An array of strings. + The string to split. + + is null. + + + + + + + Splits the specified input string a specified maximum number of times at the positions defined by a regular expression specified in the constructor. + An array of strings. + The string to be split. + The maximum number of times the split can occur. + + is null. + + + + + + + Splits the specified input string a specified maximum number of times at the positions defined by a regular expression specified in the constructor. The search for the regular expression pattern starts at a specified character position in the input string. + An array of strings. + The string to be split. + The maximum number of times the split can occur. + The character position in the input string where the search will begin. + + is null. + + is less than zero or greater than the length of . + + + + + + + Splits the input string at the positions defined by a regular expression pattern. + An array of strings. + The string to split. + The regular expression pattern to match. + A regular expression parsing error occurred. + + or is null. + + + + + + + Splits the input string at the positions defined by a specified regular expression pattern. Specified options modify the matching operation. + An array of strings. + The string to split. + The regular expression pattern to match. + A bitwise combination of the enumeration values that provide options for matching. + A regular expression parsing error occurred. + + or is null. + + is not a valid bitwise combination of values. + + + + + + + Populates a object with the data necessary to deserialize the current object. + The object to populate with serialization information. + The place to store and retrieve serialized data. Reserved for future use. + + + Returns the regular expression pattern that was passed into the Regex constructor. + The parameter that was passed into the Regex constructor. + + + Converts any escaped characters in the input string. + A string of characters with any escaped characters converted to their unescaped form. + The input string containing the text to convert. + + includes an unrecognized escape sequence. + + is null. + + + Used by a object generated by the method. + true if the property contains the option; otherwise, false. + + + Used by a object generated by the method. + true if the property contains the option; otherwise, false. + + + Provides information about a regular expression that is used to compile a regular expression to a stand-alone assembly. + + + Initializes a new instance of the class that contains information about a regular expression to be included in an assembly. + The regular expression to compile. + The regular expression options to use when compiling the regular expression. + The name of the type that represents the compiled regular expression. + The namespace to which the new type belongs. + true to make the compiled regular expression publicly visible; otherwise, false. + + + Gets or sets a value that indicates whether the compiled regular expression has public visibility. + true if the regular expression has public visibility; otherwise, false. + + + Gets or sets the name of the type that represents the compiled regular expression. + The name of the new type. + The value for this property is null. + The value for this property is an empty string. + + + Gets or sets the namespace to which the new type belongs. + The namespace of the new type. + The value for this property is null. + + + Gets or sets the options to use when compiling the regular expression. + A bitwise combination of the enumeration values. + + + Gets or sets the regular expression to compile. + The regular expression to compile. + The value for this property is null. + + + Provides enumerated values to use to set regular expression options. + + + Specifies that no options are set. + + + Specifies case-insensitive matching. + + + Multiline mode. Changes the meaning of ^ and $ so they match at the beginning and end, respectively, of any line, and not just the beginning and end of the entire string. + + + Specifies that the only valid captures are explicitly named or numbered groups of the form (?<name>…). This allows unnamed parentheses to act as noncapturing groups without the syntactic clumsiness of the expression (?:…). + + + Specifies that the regular expression is compiled to an assembly. This yields faster execution but increases startup time. This value should not be assigned to the property when calling the method. + + + Specifies single-line mode. Changes the meaning of the dot (.) so it matches every character (instead of every character except \n). + + + Eliminates unescaped white space from the pattern and enables comments marked with #. However, the value does not affect or eliminate white space in character classes. + + + Specifies that the search will be from right to left instead of from left to right. + + + Enables ECMAScript-compliant behavior for the expression. This value can be used only in conjunction with the , , and values. The use of this value with any other values results in an exception. + + + Specifies that cultural differences in language is ignored. See Performing Culture-Insensitive Operations in the RegularExpressions Namespace for more information. + + + The class is the base class for compiled regular expressions. + + + Initializes a new instance of the class. + + + Used by a object generated by the method. + + + Used by a object generated by the method. Determines whether a character is in a character class. + true if the parameter is in the character class specified by the parameter. + A character to test. + The internal name of a character class. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Used by a object generated by the method. + + + Creates a class for a compiled regular expression. + + + Initializes a new instance of the class. + + + When overridden in a derived class, creates a object for a specific compiled regular expression. + A object designed to execute a specific compiled regular expression. + + + Copies all the elements of the collection to the given array beginning at the given index. + The one-dimensional array the collection is to be copied into. + The zero-based index in the destination array where copying is to begin. + + is null. + + is outside the bounds of .-or- plus is outside the bounds of . + + + Gets a value that indicates whether access to the collection is synchronized (thread-safe). + false in all cases. + + + Gets an object that can be used to synchronize access to the collection. + A object that can be used to synchronize access to the collection. + + + Copies all the elements of the collection to the specified array beginning at the specified index. + The one-dimensional array the collection is to be copied into. + The zero-based index in the destination array where copying is to begin. + + is null. + + is outside the bounds of .-or- plus is outside the bounds of . + + + Gets a value that indicates whether access to the collection is synchronized (thread-safe). + false in all cases. + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the collection. + + + Copies all the elements of the collection to the specified array starting at the specified index. + The one-dimensional array the collection is to be copied into. + The zero-based index in the array where copying is to begin. + + is a multi-dimensional array. + + is outside the bounds of array.-or- plus is outside the bounds of . + + + Gets a value that indicates whether access to the collection is synchronized (thread-safe). + false in all cases. + + + Gets an object that can be used to synchronize access to the collection. + An object that can be used to synchronize access to the collection. This property always returns the object itself. + + + Enables multiple tasks to cooperatively work on an algorithm in parallel through multiple phases. + + + Initializes a new instance of the class. + The number of participating threads. + + is less than 0 or greater than 32,767. + + + Initializes a new instance of the class. + The number of participating threads. + The to be executed after each phase. null (Nothing in Visual Basic) may be passed to indicate no action is taken. + + is less than 0 or greater than 32,767. + + + Notifies the that there will be an additional participant. + The phase number of the barrier in which the new participants will first participate. + The current instance has already been disposed. + Adding a participant would cause the barrier's participant count to exceed 32,767.-or-The method was invoked from within a post-phase action. + + + Notifies the that there will be additional participants. + The phase number of the barrier in which the new participants will first participate. + The number of additional participants to add to the barrier. + The current instance has already been disposed. + + is less than 0.-or-Adding participants would cause the barrier's participant count to exceed 32,767. + The method was invoked from within a post-phase action. + + + Gets the number of the barrier's current phase. + Returns the number of the barrier's current phase. + + + Releases all resources used by the current instance of the class. + The method was invoked from within a post-phase action. + + + When overridden in a derived class, releases the unmanaged resources used by the , and optionally releases the managed resources. + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Gets the total number of participants in the barrier. + Returns the total number of participants in the barrier. + + + Gets the number of participants in the barrier that haven’t yet signaled in the current phase. + Returns the number of participants in the barrier that haven’t yet signaled in the current phase. + + + Notifies the that there will be one less participant. + The current instance has already been disposed. + The barrier already has 0 participants.-or-The method was invoked from within a post-phase action. + + + Notifies the that there will be fewer participants. + The number of additional participants to remove from the barrier. + The current instance has already been disposed. + + is less than 0. + The barrier already has 0 participants.-or-The method was invoked from within a post-phase action. -or-current participant count is less than the specified participantCount + The total participant count is less than the specified + + + Signals that a participant has reached the and waits for all other participants to reach the barrier as well. + The current instance has already been disposed. + The method was invoked from within a post-phase action, the barrier currently has 0 participants, or the barrier is signaled by more threads than are registered as participants. + If an exception is thrown from the post phase action of a Barrier after all participating threads have called SignalAndWait, the exception will be wrapped in a BarrierPostPhaseException and be thrown on all participating threads. + + + Signals that a participant has reached the and waits for all other participants to reach the barrier as well, using a 32-bit signed integer to measure the timeout. + if all participants reached the barrier within the specified time; otherwise false. + The number of milliseconds to wait, or (-1) to wait indefinitely. + The current instance has already been disposed. + + is a negative number other than -1, which represents an infinite time-out. + The method was invoked from within a post-phase action, the barrier currently has 0 participants, or the barrier is signaled by more threads than are registered as participants. + If an exception is thrown from the post phase action of a Barrier after all participating threads have called SignalAndWait, the exception will be wrapped in a BarrierPostPhaseException and be thrown on all participating threads. + + + Signals that a participant has reached the barrier and waits for all other participants to reach the barrier as well, using a 32-bit signed integer to measure the timeout, while observing a . + if all participants reached the barrier within the specified time; otherwise false + The number of milliseconds to wait, or (-1) to wait indefinitely. + The to observe. + + has been canceled. + The current instance has already been disposed. + + is a negative number other than -1, which represents an infinite time-out. + The method was invoked from within a post-phase action, the barrier currently has 0 participants, or the barrier is signaled by more threads than are registered as participants. + + + Signals that a participant has reached the and waits for all other participants to reach the barrier, while observing a . + The to observe. + + has been canceled. + The current instance has already been disposed. + The method was invoked from within a post-phase action, the barrier currently has 0 participants, or the barrier is signaled by more threads than are registered as participants. + + + Signals that a participant has reached the and waits for all other participants to reach the barrier as well, using a to measure the time interval. + true if all other participants reached the barrier; otherwise, false. + A that represents the number of milliseconds to wait, or a that represents -1 milliseconds to wait indefinitely. + The current instance has already been disposed. + + is a negative number other than -1 milliseconds, which represents an infinite time-out, or it is greater than 32,767. + The method was invoked from within a post-phase action, the barrier currently has 0 participants, or the barrier is signaled by more threads than are registered as participants. + + + Signals that a participant has reached the and waits for all other participants to reach the barrier as well, using a to measure the time interval, while observing a . + true if all other participants reached the barrier; otherwise, false. + A that represents the number of milliseconds to wait, or a that represents -1 milliseconds to wait indefinitely. + The to observe. + + has been canceled. + The current instance has already been disposed. + + is a negative number other than -1 milliseconds, which represents an infinite time-out. + The method was invoked from within a post-phase action, the barrier currently has 0 participants, or the barrier is signaled by more threads than are registered as participants. + + + The exception that is thrown when the post-phase action of a fails + + + Initializes a new instance of the class with a system-supplied message that describes the error. + + + Initializes a new instance of the class with the specified inner exception. + The exception that is the cause of the current exception. + + + Initializes a new instance of the class with serialized data. + The object that holds the serialized object data. + The contextual information about the source or destination. + + + Initializes a new instance of the class with a specified message that describes the error. + The message that describes the exception. The caller of this constructor is required to ensure that this string has been localized for the current system culture. + + + Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception. + The message that describes the exception. The caller of this constructor is required to ensure that this string has been localized for the current system culture. + The exception that is the cause of the current exception. If the parameter is not null, the current exception is raised in a catch block that handles the inner exception. + + + Limits the number of threads that can access a resource or pool of resources concurrently. + 1 + + + Initializes a new instance of the class, specifying the maximum number of concurrent entries and optionally reserving some entries. + The initial number of requests for the semaphore that can be granted concurrently. + The maximum number of requests for the semaphore that can be granted concurrently. + + is greater than . + + is less than 1.-or- is less than 0. + + + Initializes a new instance of the class, specifying the maximum number of concurrent entries, optionally reserving some entries for the calling thread, and optionally specifying the name of a system semaphore object. + The initial number of requests for the semaphore that can be granted concurrently. + The maximum number of requests for the semaphore that can be granted concurrently. + The name of a named system semaphore object. + + is greater than .-or- is longer than 260 characters. + + is less than 1.-or- is less than 0. + A Win32 error occurred. + The named semaphore exists and has access control security, and the user does not have . + The named semaphore cannot be created, perhaps because a wait handle of a different type has the same name. + + + Initializes a new instance of the class, specifying the maximum number of concurrent entries, optionally reserving some entries for the calling thread, optionally specifying the name of a system semaphore object, and specifying a variable that receives a value indicating whether a new system semaphore was created. + The initial number of requests for the semaphore that can be satisfied concurrently. + The maximum number of requests for the semaphore that can be satisfied concurrently. + The name of a named system semaphore object. + When this method returns, contains true if a local semaphore was created (that is, if is null or an empty string) or if the specified named system semaphore was created; false if the specified named system semaphore already existed. This parameter is passed uninitialized. + + is greater than . -or- is longer than 260 characters. + + is less than 1.-or- is less than 0. + A Win32 error occurred. + The named semaphore exists and has access control security, and the user does not have . + The named semaphore cannot be created, perhaps because a wait handle of a different type has the same name. + + + Initializes a new instance of the class, specifying the maximum number of concurrent entries, optionally reserving some entries for the calling thread, optionally specifying the name of a system semaphore object, specifying a variable that receives a value indicating whether a new system semaphore was created, and specifying security access control for the system semaphore. + The initial number of requests for the semaphore that can be satisfied concurrently. + The maximum number of requests for the semaphore that can be satisfied concurrently. + The name of a named system semaphore object. + When this method returns, contains true if a local semaphore was created (that is, if is null or an empty string) or if the specified named system semaphore was created; false if the specified named system semaphore already existed. This parameter is passed uninitialized. + A object that represents the access control security to be applied to the named system semaphore. + + is greater than .-or- is longer than 260 characters. + + is less than 1.-or- is less than 0. + The named semaphore exists and has access control security, and the user does not have . + A Win32 error occurred. + The named semaphore cannot be created, perhaps because a wait handle of a different type has the same name. + + + Gets the access control security for a named system semaphore. + A object that represents the access control security for the named system semaphore. + The current object represents a named system semaphore, and the user does not have rights.-or-The current object represents a named system semaphore and was not opened with rights. + Not supported for Windows 98 or Windows Millennium Edition. + 1 + + + Opens an existing named semaphore. + A object that represents a named system semaphore. + The name of a named system semaphore. + + is an empty string.-or- is longer than 260 characters. + + is null. + The named semaphore does not exist. + A Win32 error occurred. + The named semaphore exists, but the user does not have the security access required to use it. + 1 + + + + + + Opens an existing named semaphore, specifying the desired security access rights. + A object that represents the named system semaphore. + The name of a system semaphore. + A bitwise combination of the values that represent the desired security access rights. + + is an empty string.-or- is longer than 260 characters. + + is null. + The named semaphore does not exist. + A Win32 error occurred. + The named semaphore exists, but the user does not have the desired security access rights. + 1 + + + Exits the semaphore and returns the previous count. + The count on the semaphore before the method was called. + The semaphore count is already at the maximum value. + A Win32 error occurred with a named semaphore. + The current semaphore represents a named system semaphore, but the user does not have .-or-The current semaphore represents a named system semaphore, but it was not opened with . + 1 + + + Exits the semaphore a specified number of times and returns the previous count. + The count on the semaphore before the method was called. + The number of times to exit the semaphore. + + is less than 1. + The semaphore count is already at the maximum value. + A Win32 error occurred with a named semaphore. + The current semaphore represents a named system semaphore, but the user does not have rights.-or-The current semaphore represents a named system semaphore, but it was not opened with rights. + 1 + + + Sets the access control security for a named system semaphore. + A object that represents the access control security to be applied to the named system semaphore. + + is null. + The user does not have rights.-or-The semaphore was not opened with rights. + The current object does not represent a named system semaphore. + 1 + + + Provides data for the event. + 2 + + + Initializes a new instance of the class. + The that occurred. + + + Gets the that occurred. + The that occurred. + 1 + + + Represents the method that will handle the event of an . + The source of the event. + A that contains the event data. + 2 + + + Provides data for the event. + + + Gets the time the event was raised. + The time the event was raised. + + + Represents the method that will handle the event of a . + The source of the event. + An object that contains the event data. + + + Generates recurring events in an application. + + + Initializes a new instance of the class, and sets all the properties to their initial values. + + + Initializes a new instance of the class, and sets the property to the specified number of milliseconds. + The time, in milliseconds, between events. The value must be greater than zero and less than or equal to . + The value of the parameter is less than or equal to zero, or greater than . + + + Gets or sets a value indicating whether the should raise the event each time the specified interval elapses or only after the first time it elapses. + true if the should raise the event each time the interval elapses; false if it should raise the event only once, after the first time the interval elapses. The default is true. + + + Begins the run-time initialization of a that is used on a form or by another component. + + + Releases the resources used by the . + + + Releases all resources used by the current . + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + Occurs when the interval elapses. + + + Gets or sets a value indicating whether the should raise the event. + true if the should raise the event; otherwise, false. The default is false. + This property cannot be set because the timer has been disposed. + The property was set to a value greater than before the timer was enabled. + + + Ends the run-time initialization of a that is used on a form or by another component. + + + + + + Gets or sets the interval at which to raise the event. + The time, in milliseconds, between events. The value must be greater than zero, and less than or equal to . The default is 100 milliseconds. + The interval is less than or equal to zero.-or-The interval is greater than , and the timer is currently enabled. (If the timer is not currently enabled, no exception is thrown until it becomes enabled.) + + + Gets or sets the site that binds the to its container in design mode. + An interface representing the site that binds the object to its container. + + + Starts raising the event by setting to true. + The is created with an interval equal to or greater than + 1, or set to an interval less than zero. + + + + + + Stops raising the event by setting to false. + + + + + + Gets or sets the object used to marshal event-handler calls that are issued when an interval has elapsed. + The representing the object used to marshal the event-handler calls that are issued when an interval has elapsed. The default is null. + + + Sets the description that visual designers can display when referencing an event, extender, or property. + + + Initializes a new instance of the class. + The description to use. + + + Gets the description that visual designers can display when referencing an event, extender, or property. + The description for the event, extender, or property. + + + Controls access permissions in ASP.NET hosted environments. This class cannot be inherited. + + + Initializes a new instance of the class with the specified enumeration value. + A enumeration value. + + is not set to one of the enumeration values. + + + Initializes a new instance of the class with the specified permission level. + An enumeration value. + + + When implemented by a derived class, creates and returns an identical copy of the current permission object. + A copy of the current permission object. + + + Reconstructs a permission object with a specified state from an XML encoding. + The containing the XML encoding to use to reconstruct the permission object. + + is null. + The property of is not equal to "IPermission". - or- The class of is null or an empty string (""). + + + When implemented by a derived class, creates and returns a permission that is the intersection of the current permission and the specified permission. + An that represents the intersection of the current permission and the specified permission; otherwise, null if the intersection is empty. + A permission to combine with the current permission. It must be of the same type as the current permission. + + is not an . + + + Returns a value indicating whether the current permission is a subset of the specified permission. + true if the current is a subset of the specified ; otherwise, false. + The to combine with the current permission. It must be of the same type as the current . + + is not an . + + + Returns a value indicating whether unrestricted access to the resource that is protected by the current permission is allowed. + true if unrestricted use of the resource protected by the permission is allowed; otherwise, false. + + + Gets or sets the current hosting permission level for an ASP.NET application. + One of the enumeration values. + + + Creates an XML encoding of the permission object and its current state. + A containing the XML encoding of the permission object, including any state information. + + + Creates a permission that is the union of the current permission and the specified permission. + An that represents the union of the current permission and the specified permission. + A permission to combine with the current permission. It must be of the same type as the current permission. + + is not an . + + + Allows security actions for to be applied to code using declarative security. This class cannot be inherited. + + + Initializes a new instance of the class. + One of the enumeration values. + + + Creates a new with the permission level previously set by the property. + An that is the new . + + + + + + Gets or sets the current hosting permission level. + One of the enumeration values. + + + Specifies the trust level that is granted to an ASP.NET Web application. + + + Indicates that no permission is granted. All demands for will fail. + + + Indicates that features protected with a demand for the level will succeed. This level allows code to execute but not to interact with resources present on the system. This level is granted by configuring at least the trust level using the trust section in a configuration file. + + + Indicates that features protected with a demand for any level less than or equal to the level will succeed. This level is intended to allow read-only access to limited resources in a constrained environment. This level is granted by specifying the trust level in the trust section in a configuration file. + + + Indicates that features protected with a demand for any level less than or equal to the level will succeed. This level is granted by configuring at least the trust level in the trust section in a configuration file. + + + Indicates that features protected with a demand for any level less than or equal to the High trust level will succeed. This level is intended for highly trusted managed-code applications that need to use most of the managed permissions that support semi-trusted access. It does not grant some of the highest permissions (for example, the ability to call into native code), but it does provide a way to run trusted applications with least privilege or to provide some level of constraints for highly trusted applications. This level is granted by configuring at least the trust level in the trust section in a configuration file. + + + Indicates that all demands for permission to use all features of an application will be granted. This is equivalent to granting Full trust level in the trust section in a configuration file. + + + \ No newline at end of file diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/Win.dat b/Bin/Debug/CommonControls/.NET4 示例/UserDb/Win.dat index ad88b6e..12a781d 100644 --- a/Bin/Debug/CommonControls/.NET4 示例/UserDb/Win.dat +++ b/Bin/Debug/CommonControls/.NET4 示例/UserDb/Win.dat @@ -1,2 +1,2 @@ [Money_Op] -hwnd=4207474 +hwnd=212388 diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apk_icon.png b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apk_icon.png new file mode 100644 index 0000000..b56be60 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apk_icon.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678054.png b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678054.png new file mode 100644 index 0000000..b56be60 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678054.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678095.png b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678095.png new file mode 100644 index 0000000..b56be60 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678095.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678220.png b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678220.png new file mode 100644 index 0000000..b56be60 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678220.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678268.png b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678268.png new file mode 100644 index 0000000..b56be60 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678268.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678340.png b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678340.png new file mode 100644 index 0000000..b56be60 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678340.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678369.png b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678369.png new file mode 100644 index 0000000..b56be60 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/apkicon_1697678369.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/icon.png b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/icon.png new file mode 100644 index 0000000..b56be60 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/icon.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/icon_1696644265.png b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/icon_1696644265.png new file mode 100644 index 0000000..b56be60 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/UserDb/tmp/icon_1696644265.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/cUpdate.dat b/Bin/Debug/CommonControls/.NET4 示例/cUpdate.dat index 9db8656..d87fa3c 100644 --- a/Bin/Debug/CommonControls/.NET4 示例/cUpdate.dat +++ b/Bin/Debug/CommonControls/.NET4 示例/cUpdate.dat @@ -1,4 +1,4 @@ - + \ No newline at end of file diff --git a/Bin/Debug/CommonControls/.NET4 示例/ryControls.dll b/Bin/Debug/CommonControls/.NET4 示例/ryControls.dll index 893428e..06067d5 100644 Binary files a/Bin/Debug/CommonControls/.NET4 示例/ryControls.dll and b/Bin/Debug/CommonControls/.NET4 示例/ryControls.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/ryControls.xml b/Bin/Debug/CommonControls/.NET4 示例/ryControls.xml index b1b565f..61b6e79 100644 --- a/Bin/Debug/CommonControls/.NET4 示例/ryControls.xml +++ b/Bin/Debug/CommonControls/.NET4 示例/ryControls.xml @@ -5182,6 +5182,9 @@ 超级颜色选择控件 + + 分页控件 + @@ -7028,6 +7031,193 @@ the contents of this method with the code editor. + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + Looks up a localized resource of type System.Byte[]. + + 颜色标签 @@ -8625,6 +8815,16 @@ 标签创建时事件 + + + 标签激活前事件 + + + + + 标签激活后事件 + + 在标签栏创建时激发 @@ -8777,6 +8977,18 @@ MGdUI皮肤 + + + + + + + + + + + + 获取子窗体 @@ -8824,6 +9036,11 @@ to make the client area to have 3D view + + + 双击事件 + + 消息 @@ -9951,6 +10168,9851 @@ + + + Adapter for WinForms brushes objects for core. + + + + + The actual WinForms brush instance. + + + + + If to dispose the brush when is called.
+ Ignore dispose for cached brushes. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms context menu for core. + + + + + the underline win forms context menu + + + + + Init. + + + + + Adapter for WinForms Control for core. + + + + + the underline win forms control. + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Get the underline win forms control + + + + + Adapter for WinForms Font object for core. + + + + + the underline win-forms font. + + + + + a handle to this Font. + + + + + the vertical offset of the font underline location from the top of the font. + + + + + Cached font height. + + + + + Cached font whitespace width. + + + + + Init. + + + + + the underline win-forms font. + + + + + Get the handle to this Font. + + + + + Set font metrics to be cached for the font for future use. + + the full height of the font + the vertical offset of the font underline location from the top of the font. + + + + Adapter for WinForms Font family object for core. + + + + + the underline win-forms font. + + + + + Init. + + + + + the underline win-forms font family. + + + + + Adapter for WinForms Graphics for core. + + + + + used for calculation. + + + + + used for calculation. + + + + + Used for GDI+ measure string. + + + + + The string format to use for measuring strings for GDI+ text rendering + + + + + The string format to use for rendering strings for GDI+ text rendering + + + + + The wrapped WinForms graphics object + + + + + Use GDI+ text rendering to measure/draw text. + + + + + the initialized HDC used + + + + + if to release the graphics object on dispose + + + + + If text alignment was set to RTL + + + + + Init static resources. + + + + + Init. + + the win forms graphics object to use + Use GDI+ text rendering to measure/draw text + optional: if to release the graphics object on dispose (default - false) + + + + Release current HDC to be able to use methods. + + + + + Init HDC for the current graphics object to be used to call GDI directly. + + + + + Set a resource (e.g. a font) for the specified device context. + WARNING: Calling Font.ToHfont() many times without releasing the font handle crashes the app. + + + + + Set the text color of the device context. + + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Special draw logic to draw transparent text using GDI.
+ 1. Create in-memory DC
+ 2. Copy background to in-memory DC
+ 3. Draw the text to in-memory DC
+ 4. Copy the in-memory DC to the proper location with alpha blend
+ + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Adapter for WinForms graphics path object for core. + + + + + The actual WinForms graphics path instance. + + + + + the last point added to the path to begin next segment from + + + + + The actual WinForms graphics path instance. + + + + + Get arc start angle for the given corner. + + + + + Adapter for WinForms Image object for core. + + + + + the underline win-forms image. + + + + + Initializes a new instance of the class. + + + + + the underline win-forms image. + + + + + Adapter for WinForms pens objects for core. + + + + + The actual WinForms brush instance. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms platforms. + + + + + Singleton instance of global adapter. + + + + + Init installed font families and set default font families mapping. + + + + + Singleton instance of global adapter. + + + + + Low level handling of Html Renderer logic, this class is used by , + , and .
+ + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + returns page list + + + + + returns page list count + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrappable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given printer device. + + the printer device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + mouse event args + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the mouse event args + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + + + + + + Create HtmlRenderer mouse event from win forms mouse event. + + + + + Create HtmlRenderer key event from win forms key event. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ Using and client can control how the html content effects the + size of the label. Either case scrollbars are never shown and html content outside of client bounds will be clipped. + and with AutoSize can limit the max/min size of the control
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoSize:

+ AutoSize = AutoSizeHeightOnly = false
+ The label size will not change by the html content. MaximumSize and MinimumSize are ignored.
+
+ AutoSize = true
+ The width and height is adjustable by the html content, the width will be longest line in the html, MaximumSize.Width will restrict it but it can be lower than that.
+
+ AutoSizeHeightOnly = true
+ The width of the label is set and will not change by the content, the height is adjustable by the html content with restrictions to the MaximumSize.Height and MinimumSize.Height values.
+ + +

LinkClicked event

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + the current html text set in the control + + + + + is to handle auto size of the control height only + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + Creates a new HTML Label + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Automatically sets the size of the label by content size + + + + + Automatically sets the height of the label by content height (width is not effected). + + + + + Gets or sets the max size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the min size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the html of this control. + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform paint of the html in the control. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ If is true and the layout of the html resulted in its content beyond the client bounds + of the panel it will show scrollbars (horizontal/vertical) allowing to scroll the content.
+ If is false html content outside the client bounds will be clipped.
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoScroll:

+ Allows showing scrollbars if html content is placed outside the visible boundaries of the panel. + + +

LinkClicked event:

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the control + + + + + the current html text set in the control + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + The last position of the scrollbars to know if it has changed to update mouse + + + + + Creates a new HtmlPanel and sets a basic css for it's styling. + + + + + + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. + + + + + Gets or sets the text of this panel + + + + + + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Adjust the scrollbar of the panel on html element by the given id.
+ The top of the html element rectangle will be at the top of the panel, if there + is not enough height to scroll to the top the scroll will be at maximum.
+ + the id of the element to scroll to + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform html container layout by the current panel client size. + + + + + Perform paint of the html in the control. + + + + + Set focus on the control for keyboard scrollbars handling. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Handle key down event for selection, copy and scrollbars handling. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + On html renderer scroll request adjust the scrolling of the panel to the requested location. + + + + + Adjust the scrolling of the panel to the requested location. + + the location to adjust the scroll to + + + + call mouse move to handle paint after scroll or html change affecting mouse cursor. + + + + + Used to add arrow keys to the handled keys in . + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Standalone static class for simple and direct HTML rendering.
+ For WinForms UI prefer using HTML controls: or .
+ For low-level control and performance consider using .
+ + + + GDI vs. GDI+ text rendering
+ Windows supports two text rendering technologies: GDI and GDI+.
+ GDI is older, has better performance and looks better on standard monitors but doesn't support alpha channel for transparency.
+ GDI+ is newer, device independent so work better for printers but is slower and looks worse on monitors.
+ HtmlRender supports both GDI and GDI+ text rendering to accommodate different needs, GDI+ text rendering methods have "GdiPlus" suffix + in their name where GDI do not.
+ + + Rendering to image
+ See https://htmlrenderer.codeplex.com/wikipage?title=Image%20generation
+ Because of GDI text rendering issue with alpha channel clear type text rendering rendering to image requires special handling.
+ Solid color background - generate an image where the background is filled with solid color and all the html is rendered on top + of the background color, GDI text rendering will be used. (RenderToImage method where the first argument is html string)
+ Image background - render html on top of existing image with whatever currently exist but it cannot have transparent pixels, + GDI text rendering will be used. (RenderToImage method where the first argument is Image object)
+ Transparent background - render html to empty image using GDI+ text rendering, the generated image can be transparent. + Text rendering can be controlled using , note that + doesn't render well on transparent background. (RenderToImageGdiPlus method)
+ + + Overwrite stylesheet resolution
+ Exposed by optional "stylesheetLoad" delegate argument.
+ Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + Overwrite image resolution
+ Exposed by optional "imageLoad" delegate argument.
+ Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ Note: Cannot use asynchronous scheme overwrite scheme.
+ + + + + Simple rendering
+ HtmlRender.Render(g, "Hello World]]>");
+ HtmlRender.Render(g, "Hello World]]>", 10, 10, 500, CssData.Parse("body {font-size: 20px}")");
+ + + Image rendering
+ HtmlRender.RenderToImage("Hello World]]>", new Size(600,400));
+ HtmlRender.RenderToImage("Hello World]]>", 600);
+ HtmlRender.RenderToImage(existingImage, "Hello World]]>");
+ + + + + + Adds a font family to be used in html rendering.
+ The added font will be used by all rendering function including and all WinForms controls. + + + The given font family instance must be remain alive while the renderer is in use.
+ If loaded to then the collection must be alive.
+ If loaded from file then the file must not be deleted. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + + This fonts mapping can be used as a fallback in case the requested font is not installed in the client system. + + the font family to replace + the font family to replace with + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI text rendering, note has no effect. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI+ text rending, use to control text rendering. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Renders the specified HTML source on the specified location and max width restriction.
+ Use GDI text rendering, note has no effect.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI text rendering, note has no effect.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ The HTML will be layout by the given image size but may be clipped if cannot fit.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + optional: the top-left most location to start render the html at (default - 0,0) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Measure the size (width and height) required to draw the given html under given width and height restrictions.
+ + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size of the html by performing layout under the given restrictions. + + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Clip the graphics so the html will not be rendered outside the max height bound given.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Copy all the bitmap bits from memory bitmap buffer to the given image. + + the source memory bitmap buffer to copy from + the destination bitmap image to copy to + + + + Provides HTML rendering on the tooltips. + + + + + the container to render and handle the html shown in the tooltip + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + The text rendering hint to be used for text rendering. + + + + + The CSS class used for tooltip html root div + + + + + the control that the tooltip is currently showing on.
+ Used for link handling. + + + + + timer used to handle mouse move events when mouse is over the tooltip.
+ Used for link handling. + + + + + the handle of the actual tooltip window used to know when the tooltip is hidden
+ Used for link handling. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + The CSS class used for tooltip html root div (default: htmltooltip)
+ Setting to 'null' clear base style on the tooltip.
+ Set custom class found in to change the base style of the tooltip. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Gets or sets the max size the tooltip. + + An ordered pair of type representing the width and height of a rectangle. + + + + On tooltip appear set the html by the associated control, layout and set the tooltip size by the html size. + + + + + Draw the html using the tooltip graphics. + + + + + Adjust the location of the tooltip window to the location of the mouse and handle + if the tooltip window will try to appear outside the boundaries of the control. + + the control the tooltip is appearing on + the size of the tooltip window + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Raised on link handling timer tick, used for: + 1. Know when the tooltip is hidden by checking the visibility of the tooltip window. + 2. Call HandleMouseMove so the mouse cursor will react if over a link element. + 3. Call HandleMouseDown and HandleMouseUp to simulate click on a link if one was clicked. + + + + + Unsubscribe from events and dispose of . + + + + + Helper to encode and set HTML fragment to clipboard.
+ See http://theartofdev.wordpress.com/2012/11/11/setting-html-and-plain-text-formatting-to-clipboard/.
+ . + + + The MIT License (MIT) Copyright (c) 2014 Arthur Teplitzki. + + + + + The string contains index references to other spots in the string, so we need placeholders so we can compute the offsets.
+ The _ strings are just placeholders. We'll back-patch them actual values afterwards.
+ The string layout () also ensures that it can't appear in the body of the html because the
+ character must be escaped.
+ + + + + html comment to point the beginning of html fragment + + + + + html comment to point the end of html fragment + + + + + Used to calculate characters byte count in UTF-8 + + + + + Create with given html and plain-text ready to be used for clipboard or drag and drop.
+ Handle missing ]]> tags, specified start\end segments and Unicode characters. + + + + Windows Clipboard works with UTF-8 Unicode encoding while .NET strings use with UTF-16 so for clipboard to correctly + decode Unicode string added to it from .NET we needs to be re-encoded it using UTF-8 encoding. + + + Builds the CF_HTML header correctly for all possible HTMLs
+ If given html contains start/end fragments then it will use them in the header: + hello world]]> + If given html contains html/body tags then it will inject start/end fragments to exclude html/body tags: + hello world]]> + If given html doesn't contain html/body tags then it will inject the tags and start/end fragments properly: + world]]> + In all cases creating a proper CF_HTML header:
+ + + hello world + ]]> + + See format specification here: http://msdn.microsoft.com/library/default.asp?url=/workshop/networking/clipboard/htmlclipboard.asp + + + a html fragment + the plain text + + + + Clears clipboard and sets the given HTML and plain text fragment to the clipboard, providing additional meta-information for HTML.
+ See for HTML fragment details.
+ + + ClipboardHelper.CopyToClipboard("Hello World", "Hello World"); + + a html fragment + the plain text + + + + Clears clipboard and sets the given plain text fragment to the clipboard.
+ + the plain text + + + + Generate HTML fragment data string with header that is required for the clipboard. + + the html to generate for + the resulted string + + + + Calculates the number of bytes produced by encoding the string in the string builder in UTF-8 and not .NET default string encoding. + + the string builder to count its string + optional: the start index to calculate from (default - start of string) + optional: the end index to calculate to (default - end of string) + the number of bytes required to encode the string in UTF-8 + + + + Utilities for converting WinForms entities to HtmlRenderer core entities. + + + + + Convert from WinForms point to core point. + + + + + Convert from WinForms point to core point. + + + + + Convert from core point to WinForms point. + + + + + Convert from core point to WinForms point. + + + + + Convert from WinForms size to core size. + + + + + Convert from core size to WinForms size. + + + + + Convert from core size to WinForms size. + + + + + Convert from WinForms rectangle to core rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from WinForms color to core color. + + + + + Convert from core color to WinForms color. + + + + + Utility for Win32 API. + + + + + Const for BitBlt copy raster-operation code. + + + + + Const for BitBlt paint raster-operation code. + + + + + Create a compatible memory HDC from the given HDC.
+ The memory HDC can be rendered into without effecting the original HDC.
+ The returned memory HDC and must be released using . + + the HDC to create memory HDC from + the width of the memory HDC to create + the height of the memory HDC to create + returns used bitmap memory section that must be released when done with memory HDC + memory HDC + + + + Release the given memory HDC and dib section created from . + + Memory HDC to release + bitmap section to release + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + A pointer to a RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + If the function succeeds, the return value is nonzero. + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ARGB (alpha, red, green, blue) color. + + + + + Represents a color that is null. + + 1 + + + + Gets a system-defined color. + + + + + Gets a system-defined color that has an ARGB value of #FF000000. + + + + + Gets a system-defined color that has an ARGB value of #FFFFFFFF. + + + + + Gets a system-defined color that has an ARGB value of #FFF5F5F5. + + + + + Gets a system-defined color that has an ARGB value of #FFD3D3D3. + + + + + Gets the red component value of this structure. + + + + + Gets the green component value of this structure. + + + + + Gets the blue component value of this structure. + + + + + Gets the alpha component value of this structure. + + + + + Specifies whether this structure is uninitialized. + + + This property returns true if this color is uninitialized; otherwise, false. + + 1 + + + + Tests whether two specified structures are equivalent. + + + true if the two structures are equal; otherwise, false. + + + The that is to the left of the equality operator. + + + The that is to the right of the equality operator. + + 3 + + + + Tests whether two specified structures are different. + + + true if the two structures are different; otherwise, false. + + + The that is to the left of the inequality operator. + + + The that is to the right of the inequality operator. + + 3 + + + + Creates a structure from the four ARGB component (alpha, red, green, and blue) values. Although this method allows a 32-bit value to be passed for each component, the value of each component is limited to 8 bits. + + + The that this method creates. + + The alpha component. Valid values are 0 through 255. + The red component. Valid values are 0 through 255. + The green component. Valid values are 0 through 255. + The blue component. Valid values are 0 through 255. + + , , , or is less than 0 or greater than 255. + + 1 + + + + Creates a structure from the specified 8-bit color values (red, green, and blue). The alpha value is implicitly 255 (fully opaque). Although this method allows a 32-bit value to be passed for each color component, the value of each component is limited to 8 bits. + + + The that this method creates. + + + The red component value for the new . Valid values are 0 through 255. + + + The green component value for the new . Valid values are 0 through 255. + + + The blue component value for the new . Valid values are 0 through 255. + + + , , or is less than 0 or greater than 255. + + 1 + + + + Tests whether the specified object is a structure and is equivalent to this + + structure. + + + true if is a structure equivalent to this + + structure; otherwise, false. + + The object to test. + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies the hash code for this . + + 1 + + + + Converts this structure to a human-readable string. + + + + + Specifies the style of dashed lines drawn with a object. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 自定义 + + + + + Specifies style information applied to text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + Init. + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + Is the left mouse button participated in the event + + + + + Init. + + + + + Is the left mouse button participated in the event + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ordered pair of floating-point x- and y-coordinates that defines a point in a two-dimensional plane. + + + + + Represents a new instance of the class with member data left uninitialized. + + 1 + + + + Initializes a new instance of the class with the specified coordinates. + + The horizontal position of the point. + The vertical position of the point. + + + + + + Gets a value indicating whether this is empty. + + + true if both and + + are 0; otherwise, false. + + 1 + + + + Gets or sets the x-coordinate of this . + + + The x-coordinate of this . + + 1 + + + + Gets or sets the y-coordinate of this . + + + The y-coordinate of this . + + 1 + + + + Translates the by the specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the x- and y-coordinates of the + + . + + + + + Translates a by the negative of a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Compares two structures. The result specifies whether the values of the + + and properties of the two + + structures are equal. + + + true if the and + + values of the left and right + + structures are equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Determines whether the coordinates of the specified points are not equal. + + + true to indicate the and + + values of and + + are not equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Translates a given by a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the coordinates of + + . + + + + + Translates a by the negative of a specified size. + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Specifies whether this contains the same coordinates as the specified + + . + + + This method returns true if is a and has the same coordinates as this + + . + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts this to a human readable string. + + + A string that represents this . + + 1 + + + + Stores a set of four floating-point numbers that represent the location and size of a rectangle. + + + + + Represents an instance of the class with its members uninitialized. + + + + + Initializes a new instance of the class with the specified location and size. + + The x-coordinate of the upper-left corner of the rectangle. + The y-coordinate of the upper-left corner of the rectangle. + The width of the rectangle. + The height of the rectangle. + + + + Initializes a new instance of the class with the specified location and size. + + A that represents the upper-left corner of the rectangular region. + A that represents the width and height of the rectangular region. + + + + Gets or sets the coordinates of the upper-left corner of this structure. + + A that represents the upper-left corner of this structure. + + + + Gets or sets the size of this . + + A that represents the width and height of this structure. + + + + Gets or sets the x-coordinate of the upper-left corner of this structure. + + + The x-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the y-coordinate of the upper-left corner of this structure. + + + The y-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the width of this structure. + + + The width of this structure. + + + + + Gets or sets the height of this structure. + + + The height of this structure. + + + + + Gets the x-coordinate of the left edge of this structure. + + + The x-coordinate of the left edge of this structure. + + + + + Gets the y-coordinate of the top edge of this structure. + + + The y-coordinate of the top edge of this structure. + + + + + Gets the x-coordinate that is the sum of and + + of this structure. + + + The x-coordinate that is the sum of and + + of this structure. + + + + + Gets the y-coordinate that is the sum of and + + of this structure. + + + The y-coordinate that is the sum of and + + of this structure. + + + + + Tests whether the or + + property of this has a value of zero. + + + This property returns true if the or + + property of this has a value of zero; otherwise, false. + + + + + Tests whether two structures have equal location and size. + + + This operator returns true if the two specified structures have equal + , , , and properties. + + + The structure that is to the left of the equality operator. + + + The structure that is to the right of the equality operator. + + + + + Tests whether two structures differ in location or size. + + + This operator returns true if any of the , + , , or + properties of the two structures are unequal; otherwise false. + + + The structure that is to the left of the inequality operator. + + + The structure that is to the right of the inequality operator. + + + + + Creates a structure with upper-left corner and lower-right corner at the specified locations. + + + The new that this method creates. + + The x-coordinate of the upper-left corner of the rectangular region. + The y-coordinate of the upper-left corner of the rectangular region. + The x-coordinate of the lower-right corner of the rectangular region. + The y-coordinate of the lower-right corner of the rectangular region. + + + + Tests whether is a with the same location and size of this + . + + + This method returns true if is a and its X, Y, Width, and Height properties are equal to the corresponding properties of this + ; otherwise, false. + + + The to test. + + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point defined by and is contained within this + + structure; otherwise false. + + The x-coordinate of the point to test. + The y-coordinate of the point to test. + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point represented by the parameter is contained within this + + structure; otherwise false. + + The to test. + + + + Determines if the rectangular region represented by is entirely contained within this + + structure. + + + This method returns true if the rectangular region represented by is entirely contained within the rectangular region represented by this + + ; otherwise false. + + + The to test. + + + + + Inflates this structure by the specified amount. + + + The amount to inflate this structure horizontally. + + + The amount to inflate this structure vertically. + + + + + Inflates this by the specified amount. + + The amount to inflate this rectangle. + + + + Creates and returns an inflated copy of the specified structure. The copy is inflated by the specified amount. The original rectangle remains unmodified. + + + The inflated . + + + The to be copied. This rectangle is not modified. + + The amount to inflate the copy of the rectangle horizontally. + The amount to inflate the copy of the rectangle vertically. + + + + Replaces this structure with the intersection of itself and the specified + + structure. + + The rectangle to intersect. + + + + Returns a structure that represents the intersection of two rectangles. If there is no intersection, and empty + + is returned. + + + A third structure the size of which represents the overlapped area of the two specified rectangles. + + A rectangle to intersect. + A rectangle to intersect. + + + + Determines if this rectangle intersects with . + + + This method returns true if there is any intersection. + + The rectangle to test. + + + + Creates the smallest possible third rectangle that can contain both of two rectangles that form a union. + + + A third structure that contains both of the two rectangles that form the union. + + A rectangle to union. + A rectangle to union. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location horizontally. + The amount to offset the location vertically. + + + + Gets the hash code for this structure. For information about the use of hash codes, see Object.GetHashCode. + + The hash code for this + + + + Converts the Location and Size of this to a human-readable string. + + + A string that contains the position, width, and height of this structure for example, "{X=20, Y=20, Width=100, Height=50}". + + + + + Stores an ordered pair of floating-point numbers, typically the width and height of a rectangle. + + + + + Gets a structure that has a + + and + + value of 0. + + + A structure that has a + + and + + value of 0. + + 1 + + + + Initializes a new instance of the structure from the specified existing + + structure. + + + The structure from which to create the new + + structure. + + + + + Initializes a new instance of the structure from the specified structure. + + The structure from which to initialize this structure. + + + + Initializes a new instance of the structure from the specified dimensions. + + + The width component of the new structure. + + + The height component of the new structure. + + + + + Gets a value that indicates whether this structure has zero width and height. + + + This property returns true when this structure has both a width and height of zero; otherwise, false. + + 1 + + + + Gets or sets the horizontal component of this structure. + + + The horizontal component of this structure, typically measured in pixels. + + 1 + + + + Gets or sets the vertical component of this structure. + + + The vertical component of this structure, typically measured in pixels. + + 1 + + + + Converts the specified structure to a + structure. + + The structure to which this operator converts. + The structure to be converted + + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + 3 + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A that is the result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + 3 + + + + Tests whether two structures are equal. + + + This operator returns true if and have equal width and height; otherwise, false. + + + The structure on the left side of the equality operator. + + + The structure on the right of the equality operator. + + 3 + + + + Tests whether two structures are different. + + + This operator returns true if and differ either in width or height; false if + + and are equal. + + + The structure on the left of the inequality operator. + + + The structure on the right of the inequality operator. + + 3 + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A structure that is a result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + + + + Tests to see whether the specified object is a structure with the same dimensions as this + + structure. + + + This method returns true if is a and has the same width and height as this + + ; otherwise, false. + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts a structure to a structure. + + + Returns a structure. + + + + + Creates a human-readable string that represents this structure. + + + A string that represents this structure. + + 1 + + + + + + + Platform adapter to bridge platform specific objects to HTML Renderer core library.
+ Core uses abstract renderer objects (RAdapter/RControl/REtc...) to access platform specific functionality, the concrete platforms + implements those objects to provide concrete platform implementation. Those allowing the core library to be platform agnostic. + + Platforms: WinForms, WPF, Metro, PDF renders, etc.
+ Objects: UI elements(Controls), Graphics(Render context), Colors, Brushes, Pens, Fonts, Images, Clipboard, etc.
+ + + + It is best to have a singleton instance of this class for concrete implementation!
+ This is because it holds caches of default CssData, Images, Fonts and Brushes. + + + + + cache of brush color to brush instance + + + + + cache of pen color to pen instance + + + + + cache of all the font used not to create same font again and again + + + + + default CSS parsed data singleton + + + + + image used to draw loading image icon + + + + + image used to draw error image icon + + + + + Init. + + + + + Get the default CSS stylesheet data. + + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Check if the given font exists in the system by font family name. + + the font name to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get image to be used while HTML image is loading. + + + + + Get image to be used if HTML image load failed. + + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard
+ Not relevant for platforms that don't render HTML on UI element. + + the text to set + + + + Set the given html and plain text data to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + + + + Set the given image to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the image object to set to clipboard + + + + Create a context menu that can be used on the control
+ Not relevant for platforms that don't render HTML on UI element. + + new context menu + + + + Save the given image to file by showing save dialog to the client.
+ Not relevant for platforms that don't render HTML on UI element. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard + + the text to set + + + + Set the given html and plain text data to clipboard. + + the html data + the plain text data + + + + Set the given image to clipboard. + + + + + + Create a context menu that can be used on the control + + new context menu + + + + Save the given image to file by showing save dialog to the client. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Adapter for platform specific brush objects - used to fill graphics (rectangles, polygons and paths).
+ The brush can be solid color, gradient or image. + + + + + + + + + + Adapter for platform specific context menu - used to create and show context menu at specific location.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The total number of items in the context menu + + + + + Add divider item to the context menu.
+ The divider is a non clickable place holder used to separate items. + + + + + Add item to the context menu with the given text that will raise the given event when clicked. + the text to set on the new context menu itemif to set the item as enabled or disabledthe event to raise when the item is clicked + + + + Remove the last item from the context menu iff it is a divider + + + + + Show the context menu in the given parent control at the given location. + the parent control to show inthe location to show at relative to the parent control + + + + + + + + + Adapter for platform specific control object - used to handle updating the control that the html is rendered on.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The platform adapter. + + + + + Init control with platform adapter. + + + + + The platform adapter. + + + + + Is the left mouse button is currently in pressed state + + + + + Is the right mouse button is currently in pressed state + + + + + Get the current location of the mouse relative to the control + + + + + Set the cursor over the control to default cursor + + + + + Set the cursor over the control to hand cursor + + + + + Set the cursor over the control to I beam cursor + + + + + Do drag-drop copy operation for the given data object. + + the drag-drop data object + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Invalidates the entire surface of the control and causes the control to be redrawn. + + + + + Adapter for platform specific font object - used to render text using specific font. + + + + + Gets the em-size of this Font measured in the units specified by the Unit property. + + + + + The line spacing, in pixels, of this font. + + + + + Get the vertical offset of the font underline location from the top of the font. + + + + + Get the left padding, in pixels, of the font. + + + + + + + + + + + + Adapter for platform specific font family object - define the available font families to use.
+ Required for custom fonts handling: fonts that are not installed on the system. + + + + + Gets the name of this Font Family. + + + + + Adapter for platform specific graphics rendering object - used to render graphics and text in platform specific context.
+ The core HTML Renderer components use this class for rendering logic, extending this + class in different platform: WinForms, WPF, Metro, PDF, etc. + + + + + the global adapter + + + + + Te clipping bound stack as clips are pushed/poped to/from the graphics + + + + + Init. + + + + + Get color pen. + + the color to get the pen for + pen instance + + + + Get solid color brush. + + the color to get the brush for + solid color brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Gets a Rectangle structure that bounds the clipping region of this Graphics. + + A rectangle structure that represents a bounding rectangle for the clipping region of this Graphics. + + + + Pop the latest clip push. + + + + + Push the clipping region of this Graphics to interception of current clipping rectangle and the given rectangle. + + Rectangle to clip to. + + + + Push the clipping region of this Graphics to exclude the given rectangle from the current clipping rectangle. + + Rectangle to exclude clipping in. + + + + Set the graphics smooth mode to use anti-alias.
+ Use to return back the mode used. + + the previous smooth mode before the change + + + + Return to previous smooth mode before anti-alias was set as returned from . + + the previous mode to set + + + + Get TextureBrush object that uses the specified image and bounding rectangle. + + The Image object with which this TextureBrush object fills interiors. + A Rectangle structure that represents the bounding rectangle for this TextureBrush object. + The dimension by which to translate the transformation + + + + Get GraphicsPath object. + + graphics path instance + + + + Measure the width and height of string when drawn on device context HDC + using the given font . + + the string to measure + the font to measure string with + the size of the string + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ Not relevant for platforms that don't render HTML on UI element. + + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Draw the given string using the given font and foreground color at given location. + + the string to draw + the font to use to draw the string + the text color to set + the location to start string draw (top-left) + used to know the size of the rendered text for transparent text support + is to render the string right-to-left (true - RTL, false - LTR) + + + + Draws a line connecting the two points specified by the coordinate pairs. + + Pen that determines the color, width, and style of the line. + The x-coordinate of the first point. + The y-coordinate of the first point. + The x-coordinate of the second point. + The y-coordinate of the second point. + + + + Draws a rectangle specified by a coordinate pair, a width, and a height. + + A Pen that determines the color, width, and style of the rectangle. + The x-coordinate of the upper-left corner of the rectangle to draw. + The y-coordinate of the upper-left corner of the rectangle to draw. + The width of the rectangle to draw. + The height of the rectangle to draw. + + + + Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height. + + Brush that determines the characteristics of the fill. + The x-coordinate of the upper-left corner of the rectangle to fill. + The y-coordinate of the upper-left corner of the rectangle to fill. + Width of the rectangle to fill. + Height of the rectangle to fill. + + + + Draws the specified portion of the specified at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. The image is scaled to fit the rectangle. + Rectangle structure that specifies the portion of the object to draw. + + + + Draws the specified Image at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. + + + + Draws a GraphicsPath. + + Pen that determines the color, width, and style of the path. + GraphicsPath to draw. + + + + Fills the interior of a GraphicsPath. + + Brush that determines the characteristics of the fill. + GraphicsPath that represents the path to fill. + + + + Fills the interior of a polygon defined by an array of points specified by Point structures. + + Brush that determines the characteristics of the fill. + Array of Point structures that represent the vertices of the polygon to fill. + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Adapter for platform specific graphics path object - used to render (draw/fill) path shape. + + + + + Start path at the given point. + + + + + Add stright line to the given point from te last point. + + + + + Add circular arc of the given size to the given point from the last point. + + + + + Release path resources. + + + + + The 4 corners that are handled in arc rendering. + + + + + + + + + + + + + + + + + + + + + + + + + Adapter for platform specific image object - used to render images. + + + + + Get the width, in pixels, of the image. + + + + + Get the height, in pixels, of the image. + + + + + + + + + + Adapter for platform specific pen objects - used to draw graphics (lines, rectangles and paths) + + + + + Gets or sets the width of this Pen, in units of the Graphics object used for drawing. + + + + + Gets or sets the style used for dashed lines drawn with this Pen. + + + + + Holds parsed stylesheet css blocks arranged by media and classes.
+ + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + used to return empty array + + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data. + + + + + Init. + + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + Platform adapter + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data + + + + + Check if there are css blocks for the given class selector. + + the class selector to check for css blocks by + optional: the css media type (default - all) + true - has css blocks for the class, false - otherwise + + + + Get collection of css blocks for the requested class selector.
+ the can be: class name, html element name, html element and + class name (elm.class), hash tag with element id (#id).
+ returned all the blocks that word on the requested class selector, it can contain simple + selector or hierarchy selector. + + the class selector to get css blocks by + optional: the css media type (default - all) + collection of css blocks, empty collection if no blocks exists (never null) + + + + Add the given css block to the css data, merging to existing block if required. + + + If there is no css blocks for the same class it will be added to data collection.
+ If there is already css blocks for the same class it will check for each existing block + if the hierarchical selectors match (or not exists). if do the two css blocks will be merged into + one where the new block properties overwrite existing if needed. if the new block doesn't mach any + existing it will be added either to the beginning of the list if it has no hierarchical selectors or at the end.
+ Css block without hierarchical selectors must be added to the beginning of the list so more specific block + can overwrite it when the style is applied. + + the media type to add the CSS to + the css block to add + + + + Combine this CSS data blocks with CSS blocks for each media.
+ Merge blocks if exists in both. + + the CSS data to combine with + + + + Create deep copy of the css data with cloned css blocks. + + cloned object + + + + CSS Specification's Default Style Sheet for HTML 4 + + + http://www.w3.org/TR/CSS21/sample.html + + + + + Border types + + + + + Represents a CSS Box of text or replaced elements. + + + The Box can contains other boxes, that's the way that the CSS Tree + is composed. + + To know more about boxes visit CSS spec: + http://www.w3.org/TR/CSS21/box.html + + + + + the parent css box of this css box in the hierarchy + + + + + the root container for the hierarchy + + + + + the html tag that is associated with this css box, null if anonymous box + + + + + the inner text of the box + + + + + Do not use or alter this flag + + + Flag that indicates that CssTable algorithm already made fixes on it. + + + + + handler for loading background image + + + + + Init. + + optional: the parent of this css box in html + optional: the html tag associated with this css box + + + + Gets the HtmlContainer of the Box. + WARNING: May be null. + + + + + Gets or sets the parent box of this box + + + + + Gets the children boxes of this box + + + + + Is the box is of "br" element. + + + + + is the box "Display" is "Inline", is this is an inline box and not block. + + + + + is the box "Display" is "Block", is this is an block box and not inline. + + + + + Is the css box clickable (by default only "a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + Gets the containing block-box of this box. (The nearest parent box with display=block) + + + + + Gets the HTMLTag that hosts this box + + + + + Gets if this box represents an image + + + + + Tells if the box is empty or contains just blank spaces + + + + + Gets or sets the inner text of the box + + + + + Gets the line-boxes of this box (if block box) + + + + + Gets the linebox(es) that contains words of this box (if inline) + + + + + Gets the rectangles where this box should be painted + + + + + Gets the BoxWords of text in the box + + + + + Gets the first word of the box + + + + + Gets or sets the first linebox where content of this box appear + + + + + Gets or sets the last linebox where content of this box appear + + + + + Create new css box for the given parent with the given html tag.
+ + the html tag to define the box + the box to add the new box to it as child + the new box + + + + Create new css box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous inline boxes visit: http://www.w3.org/TR/CSS21/visuren.html#anonymous + + the box to add the new box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new box + + + + Create new css block box. + + the new block box + + + + Create new css block box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous block boxes visit CSS spec: + http://www.w3.org/TR/CSS21/visuren.html#anonymous-block-level + + the box to add the new block box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new block box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + Device context to use + + + + Prints the fragment + + Device context to use + + + + + + Set this box in + + + + + + Move all child boxes from to this box. + + the box to move all its child boxes from + + + + Splits the text into words and saves the result + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions.
+ + Device context to use + + + + Assigns words its width and height + + + + + + Get the parent of this css properties instance. + + + + + + Gets the index of the box to be used on a (ordered) list + + + + + + Creates the + + + + + + Searches for the first word occurrence inside the box, on the specified linebox + + + + + + + + Gets the specified Attribute, returns string.Empty if no attribute specified + + Attribute to retrieve + Attribute value or string.Empty if no attribute specified + + + + Gets the value of the specified attribute of the source HTML tag. + + Attribute to retrieve + Value to return if attribute is not specified + Attribute value or defaultValue if no attribute specified + + + + Gets the minimum width that the box can be.
+ The box can be as thin as the longest word plus padding.
+ The check is deep thru box tree.
+ + the min width of the box + + + + Gets the longest word (in width) inside the box, deeply. + + + + + + + + + Get the total margin value (left and right) from the given box to the given end box.
+ + the box to start calculation from. + the total margin + + + + Gets the maximum bottom of the boxes inside the startBox + + + + + + + + Get the and width of the box content.
+ + The minimum width the content must be so it won't overflow (largest word + padding). + The total width the content can take without line wrapping (with padding). + + + + Get the and of the box words content and .
+ + the box to calculate for + the width that allows for each word to fit (width of the longest word) + the max width a single line of words can take without wrapping + the total amount of padding the content has + + + + + + Gets if this box has only inline siblings (including itself) + + + + + + Gets the rectangles where inline box will be drawn. See Remarks for more info. + + Rectangles where content should be placed + + Inline boxes can be split across different LineBoxes, that's why this method + Delivers a rectangle for each LineBox related to this box, if inline. + + + Inherits inheritable values from parent. + + + + + Gets the result of collapsing the vertical margins of the two boxes + + the previous box under the same parent + Resulting top margin + + + + Calculate the actual right of the box by the actual right of the child boxes if this box actual right is not set. + + the calculated actual right value + + + + Gets the result of collapsing the vertical margins of the two boxes + + Resulting bottom margin + + + + Deeply offsets the top of the box and its contents + + + + + + Paints the fragment + + the device to draw to + + + + Prints the fragment + + the device to draw to + + + + + + Paints the background of the box + + the device to draw into + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Paint all the words in the box. + + the device to draw into + the current scroll offset to offset the words + + + + Paints the text decoration (underline/strike-through/over-line) + + the device to draw into + + + + + + + Offsets the rectangle of the specified linebox by the specified gap, + and goes deep for rectangles of children in that linebox. + + + + + + + Resets the array + + + + + On image load process complete with image request refresh for it to be painted. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Get brush for the text depending if there is selected text color set. + + + + + Get brush for selection background depending if it has external and if alpha is required for images. + + + used for images so they will have alpha effect + + + + ToString override. + + + + + + CSS box for iframe element.
+ If the iframe is of embedded YouTube or Vimeo video it will show image with play. + + + + + the image word of this image box + + + + + is the iframe is of embeded video + + + + + the title of the video + + + + + the url of the video thumbnail image + + + + + link to the video on the site + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Is the css box clickable ("a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + is the iframe is of embeded video + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Load YouTube video data (title, image, link) by calling YouTube API. + + + + + Parse YouTube API response to get video data (title, image, link). + + + + + Load Vimeo video data (title, image, link) by calling Vimeo API. + + + + + Parse Vimeo API response to get video data (title, image, link). + + + + + Handle error occurred during video data load to handle if the video was not found. + + the exception that occurred during data load web request + the name of the video source (YouTube/Vimeo/Etc.) + + + + Create image handler for downloading video image if found and release the WebClient instance used for API call. + + + + + Paints the fragment + + the device to draw to + + + + Draw video image over the iframe if found. + + + + + Draw video title on top of the iframe if found. + + + + + Draw play over the iframe if we found link url. + + + + + Assigns words its width and height + + the device to use + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + CSS box for hr element. + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + the device to draw to + + + + CSS box for image element. + + + + + the image word of this image box + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Get the image of this image box. + + + + + Paints the fragment + + the device to draw to + + + + Assigns words its width and height + + the device to use + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Base class for css box to handle the css properties.
+ Has field and property for every css property that can be set, the properties add additional parsing like + setting the correct border depending what border value was set (single, two , all four).
+ Has additional fields to control the location and size of the box and 'actual' css values for some properties + that require additional calculations and parsing.
+ + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + the width of whitespace between words + + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + Gets the bounds of the box + + + + + Gets the width available on the box, counting padding and margin. + + + + + Gets the right of the box. When setting, it will affect only the width of the box. + + + + + Gets or sets the bottom of the box. + (When setting, alters only the Size.Height of the box) + + + + + Gets the left of the client rectangle (Where content starts rendering) + + + + + Gets the top of the client rectangle (Where content starts rendering) + + + + + Gets the right of the client rectangle + + + + + Gets the bottom of the client rectangle + + + + + Gets the client rectangle + + + + + Gets the actual height + + + + + Gets the actual height + + + + + Gets the actual top's padding + + + + + Gets the actual padding on the left + + + + + Gets the actual Padding of the bottom + + + + + Gets the actual padding on the right + + + + + Gets the actual top's Margin + + + + + The margin top value if was effected by margin collapse. + + + + + Gets the actual Margin on the left + + + + + Gets the actual Margin of the bottom + + + + + Gets the actual Margin on the right + + + + + Gets the actual top border width + + + + + Gets the actual Left border width + + + + + Gets the actual Bottom border width + + + + + Gets the actual Right border width + + + + + Gets the actual top border Color + + + + + Gets the actual Left border Color + + + + + Gets the actual Bottom border Color + + + + + Gets the actual Right border Color + + + + + Gets the actual length of the north west corner + + + + + Gets the actual length of the north east corner + + + + + Gets the actual length of the south east corner + + + + + Gets the actual length of the south west corner + + + + + Gets a value indicating if at least one of the corners of the box is rounded + + + + + Gets the actual width of whitespace between words. + + + + + + Gets the actual color for the text. + + + + + Gets the actual background color of the box + + + + + Gets the second color that creates a gradient for the background + + + + + Gets the actual angle specified for the background gradient + + + + + Gets the actual font of the parent + + + + + Gets the font that should be actually used to paint the text of the box + + + + + Gets the line height + + + + + Gets the text indentation (on first line only) + + + + + Gets the actual horizontal border spacing for tables + + + + + Gets the actual vertical border spacing for tables + + + + + Get the parent of this css properties instance. + + + + + + Gets the height of the font in the specified units + + + + + + Ensures that the specified length is converted to pixels if necessary + + + + + + Set the style/width/color for all 4 borders on the box.
+ if null is given for a value it will not be set. + + optional: the style to set + optional: the width to set + optional: the color to set + + + + Measures the width of whitespace between words (set ). + + + + + Inherits inheritable values from specified box. + + Set to true to inherit all CSS properties instead of only the ineritables + Box to inherit the properties + + + + Helps on CSS Layout. + + + + + Measure image box size by the width\height set on the box and the actual rendered image size.
+ If no image exists for the box error icon will be set. + + the image word to measure + + + + Creates line boxes for the specified blockbox + + + + + + + Applies special vertical alignment for table-cells + + + + + + + Recursively flows the content of the box using the inline model + + Device Info + Blockbox that contains the text flow + Current box to flow its content + Maximum reached right + Space to use between rows of text + x starting coordinate for when breaking lines of text + Current linebox being used + Current x coordinate that will be the left of the next word + Current y coordinate that will be the top of the next word + Maximum right reached so far + Maximum bottom reached so far + + + + Adjust the position of absolute elements by letf and top margins. + + + + + Recursively creates the rectangles of the blockBox, by bubbling from deep to outside of the boxes + in the rectangle structure + + + + + Applies vertical and horizontal alignment to words in lineboxes + + + + + + + Applies right to left direction to words + + + + + + + Applies RTL direction to all the words on the line. + + the line to apply RTL to + + + + Applies RTL direction to specific box words on the line. + + + + + + + Applies vertical alignment to the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies right alignment to the text on the linebox + + + + + + + Simplest alignment, just arrange words. + + + + + + + Layout engine for tables executing the complex layout of tables with rows/columns/headers/etc. + + + + + the main box of the table + + + + + + + + + + collection of all rows boxes + + + + + collection of all columns boxes + + + + + + + + + + Init. + + + + + + Get the table cells spacing for all the cells in the table.
+ Used to calculate the spacing the table has in addition to regular padding and borders. + + the table box to calculate the spacing for + the calculated spacing + + + + + + + + + + + Analyzes the Table and assigns values to this CssTable object. + To be called from the constructor + + + + + Get the table boxes into the proper fields. + + + + + Insert EmptyBoxes for vertical cell spanning. + + + + + Determine Row and Column Count, and ColumnWidths + + + + + + + + + + + + While table width is larger than it should, and width is reductable.
+ If table max width is limited by we need to lower the columns width even if it will result in clipping
+ + + + + Check for minimum sizes (increment widths if necessary) + + + + + Layout the cells by the calculated table layout + + + + + + Gets the spanned width of a cell (With of all columns it spans minus one). + + + + + Gets the cell column index checking its position and other cells colspans + + + + + + + + Gets the cells width, taking colspan and being in the specified column + + + + + + + + Gets the colspan of the specified box + + + + + + Gets the rowspan of the specified box + + + + + + Recursively measures words inside the box + + the box to measure + Device to use + + + + Tells if the columns widths can be reduced, + by checking the minimum widths of all cells + + + + + + Tells if the specified column can be reduced, + by checking its minimum width + + + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Calculate the min and max width for each column of the table by the content in all rows.
+ the min width possible without clipping content
+ the max width the cell content can take without wrapping
+ + if to measure only columns that have no calculated width + return the min width for each column - the min width possible without clipping content + return the max width for each column - the max width the cell content can take without wrapping + + + + Gets the width available for cells + + + + It takes away the cell-spacing from + + + + + Gets the current sum of column widths + + + + + + Gets the span attribute of the tag of the specified box + + + + + + Gets the minimum width of each column + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual vertical spacing of the table + + + + + Represents and gets info about a CSS Length + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + Creates a new CssLength from a length specified on a CSS style sheet or fragment + + Length as specified in the Style Sheet or style fragment + + + + Gets the number in the length + + + + + Gets if the length has some parsing error + + + + + Gets if the length represents a precentage (not actually a length) + + + + + Gets if the length is specified in relative units + + + + + Gets the unit of the length + + + + + Gets the length as specified in the string + + + + + If length is in Ems, returns its value in points + + Em size factor to multiply + Points size of this em + If length has an error or isn't in ems + + + + If length is in Ems, returns its value in pixels + + Pixel size factor to multiply + Pixels size of this em + If length has an error or isn't in ems + + + + Returns the length formatted ready for CSS interpreting. + + + + + + Represents a line of text. + + + To learn more about line-boxes see CSS spec: + http://www.w3.org/TR/CSS21/visuren.html + + + + + Creates a new LineBox + + + + + Gets a list of boxes related with the linebox. + To know the words of the box inside this linebox, use the method. + + + + + Gets the words inside the linebox + + + + + Gets the owner box + + + + + Gets a List of rectangles that are to be painted on this linebox + + + + + Get the height of this box line (the max height of all the words) + + + + + Get the bottom of this box line (the max bottom of all the words) + + + + + Lets the linebox add the word an its box to their lists if necessary. + + + + + + Return the words of the specified box that live in this linebox + + + + + + + Updates the specified rectangle of the specified box. + + + + + + + + + + Copies the rectangles to their specified box + + + + + Sets the baseline of the words of the specified box to certain height + + Device info + box to check words + baseline + + + + Check if the given word is the last selected word in the line.
+ It can either be the last word in the line or the next word has no selection. + + the word to check + + + + + Returns the words of the linebox + + + + + + Represents a word inside an inline box + + + Because of performance, words of text are the most atomic + element in the project. It should be characters, but come on, + imagine the performance when drawing char by char on the device.
+ It may change for future versions of the library. + + + + + the CSS box owner of the word + + + + + Rectangle + + + + + If the word is selected this points to the selection handler for more data + + + + + Init. + + the CSS box owner of the word + + + + Gets the Box where this word belongs. + + + + + Gets or sets the bounds of the rectangle + + + + + Left of the rectangle + + + + + Top of the rectangle + + + + + Width of the rectangle + + + + + Get the full width of the word including the spacing. + + + + + Gets the actual width of whitespace between words. + + + + + Height of the rectangle + + + + + Gets or sets the right of the rectangle. When setting, it only affects the Width of the rectangle. + + + + + Gets or sets the bottom of the rectangle. When setting, it only affects the Height of the rectangle. + + + + + If the word is selected this points to the selection handler for more data + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + is the word is currently selected + + + + + the selection start index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the word is partially selected (-1 if not selected or fully selected) + + + + + Gets or sets an offset to be considered in measurements + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + the image object if it is image word (can be null if not loaded) + + + + + the image rectangle restriction as returned from image load event + + + + + Creates a new BoxWord which represents an image + + the CSS box owner of the word + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + the image rectange restriction as returned from image load event + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + The word text + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Init. + + the CSS box owner of the word + the word chars + was there a whitespace before the word chars (before trim) + was there a whitespace after the word chars (before trim) + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + Represents this word for debugging purposes + + + + + + Used to make space on vertical cell combination + + + + + the index of the row where box starts + + + + + the index of the row where box ends + + + + + Gets the index of the row where box starts + + + + + Gets the index of the row where box ends + + + + + Represents the possible units of the CSS lengths + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + CSS boxes that have ":hover" selector on them. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + Init. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + the name of the html tag + + + + + if the tag is single placed; in other words it doesn't have a separate closing tag; + + + + + collection of attributes and their value the html tag has + + + + + Init. + + the name of the html tag + if the tag is single placed; in other words it doesn't have a separate closing tag; + collection of attributes and their value the html tag has + + + + Gets the name of this tag + + + + + Gets collection of attributes and their value the html tag has + + + + + Gets if the tag is single placed; in other words it doesn't have a separate closing tag;
+ e.g. <br> + + + + + is the html tag has attributes. + + true - has attributes, false - otherwise + + + + Gets a boolean indicating if the attribute list has the specified attribute + + attribute name to check if exists + true - attribute exists, false - otherwise + + + + Get attribute value for given attribute name or null if not exists. + + attribute name to get by + optional: value to return if attribute is not specified + attribute value or null if not found + + + + Represents a block of CSS property values.
+ Contains collection of key-value pairs that are CSS properties for specific css class.
+ Css class can be either custom or html tag name. + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + the name of the css class of the block + + + + + the CSS block properties and values + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + is the css block has :hover pseudo-class + + + + + Creates a new block from the block's source + + the name of the css class of the block + the CSS block properties and values + optional: additional selectors to used in hierarchy + optional: is the css block has :hover pseudo-class + + + + the name of the css class of the block + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + Gets the CSS block properties and its values + + + + + is the css block has :hover pseudo-class + + + + + Merge the other block properties into this css block.
+ Other block properties can overwrite this block properties. + + the css block to merge with + + + + Create deep copy of the CssBlock. + + new CssBlock with same data + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Check if the selectors of the css blocks is the same. + + the other block to compare to + true - the selectors on blocks are the same, false - otherwise + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Serves as a hash function for a particular type. + + A hash code for the current . + + + + Returns a that represents the current . + + + + + Holds single class selector in css block hierarchical selection (p class1 > div.class2) + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Creates a new block from the block's source + + the name of the css class of the block + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Returns a that represents the current . + + + + + Controls the way styles are generated when html is generated. + + + + + styles are not generated at all + + + + + style are inserted in style attribute for each html tag + + + + + style section is generated in the head of the html + + + + + Callback used in to allow setting image externally and async.
+ The callback can provide path to image file path, URL or the actual image to use.
+ If is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + the image to use + optional: limit to specific rectangle in the loaded image + + + + Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and + provide file path to load the image from. Can also use the asynchronous image overwrite not to block HTML rendering is applicable.
+ If no alternative data is provided the original source will be used.
+ + + + + use to cancel the image loading by html renderer, the provided image will be used. + + + + + the source of the image (file path or uri) + + + + + collection of all the attributes that are defined on the image element + + + + + Callback used to allow setting image externally and async. + + + + + Init. + + the source of the image (file path or Uri) + collection of all the attributes that are defined on the image element + Callback used to allow setting image externally and async. + + + + the source of the image (file path, URL or inline data) + + + + + collection of all the attributes that are defined on the image element or CSS style + + + + + Indicate the image load is handled asynchronously. + Cancel this image loading and overwrite the image asynchronously using callback method.
+ + + + + Callback to overwrite the loaded image with error image.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + the path to the image to load (file path or URL) + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + + + + + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ If imageRectangle is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + + + + + Raised when the user clicks on a link in the html. + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + Init. + + the link href that was clicked + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + + + + + + + Exception thrown when client code subscribed to LinkClicked event thrown exception. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a specified error message. + + The message that describes the error. + + + + Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ It can happen if some async event has occurred that requires re-paint and re-layout of the html.
+ Example: async download of image is complete. + + + + + is re-layout is required for the refresh + + + + + Init. + + is re-layout is required for the refresh + + + + is re-layout is required for the refresh + + + + + + + + + + + Raised when an error occurred during html rendering. + + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + Init. + + the type of error to report + the error message + optional: the exception that occurred + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + + + + + + + Enum of possible error types that can be reported. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + the location to scroll to + + + + + Init. + + the location to scroll to + + + + the x location to scroll to + + + + + the x location to scroll to + + + + + + + + + + + Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Init. + + the source of the image (file path or URL) + collection of all the attributes that are defined on the image element + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Holds data on link element in HTML.
+ Used to expose data outside of HTML Renderer internal structure. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Init. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Is the link is directed to another element in the html + + + + + Return the id of the element this anchor link is referencing. + + + + + + + + + + + Contains all the paint code to paint different background images. + + + + + Draw the background image of the given box in the given rectangle.
+ Handle background-repeat and background-position values. + + the device to draw into + the box to draw its background image + the handler that loads image to draw + the rectangle to draw image in + + + + Get top-left location to start drawing the image at depending on background-position value. + + the background-position value + the rectangle to position image in + the size of the image + the top-left location + + + + Draw the background image at the required location repeating it over the X axis.
+ Adjust location to left if starting location doesn't include all the range (adjusted to center or right). + + + + + Draw the background image at the required location repeating it over the Y axis.
+ Adjust location to top if starting location doesn't include all the range (adjusted to center or bottom). + + + + + Draw the background image at the required location repeating it over the X and Y axis.
+ Adjust location to left-top if starting location doesn't include all the range (adjusted to center or bottom/right). + + + + + Contains all the complex paint code to paint different style borders. + + + + + used for all border paint to use the same points and not create new array each time. + + + + + Draws all the border of the box with respect to style, width, etc. + + the device to draw into + the box to draw borders for + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Draw simple border. + + Desired border + the device to draw to + Box which the border corresponds + the brush to use + the bounding rectangle to draw in + Beveled border path, null if there is no rounded corners + + + + Draw specific border (top/bottom/left/right) with the box data (style/width/rounded).
+ + desired border to draw + the box to draw its borders, contain the borders data + the device to draw into + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + + + + Set rectangle for inset/outset border as it need diagonal connection to other borders. + + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + Beveled border path, null if there is no rounded corners + + + + Makes a border path for rounded borders.
+ To support rounded dotted/dashed borders we need to use arc in the border path.
+ Return null if the border is not rounded.
+ + the device to draw into + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Beveled border path, null if there is no rounded corners + + + + Get pen to be used for border draw respecting its style. + + + + + Get the border color for the given box border. + + + + + Get the border width for the given box border. + + + + + Get the border style for the given box border. + + + + + Makes the specified color darker for inset/outset borders. + + + + + Handle context menu. + + + + + select all text + + + + + copy selected text + + + + + copy the link source + + + + + open link (as left mouse click) + + + + + copy the source of the image + + + + + copy image to clipboard + + + + + save image to disk + + + + + open video in browser + + + + + copy video url to browser + + + + + the selection handler linked to the context menu handler + + + + + the html container the handler is on + + + + + the last context menu shown + + + + + the control that the context menu was shown on + + + + + the css rectangle that context menu shown on + + + + + the css link box that context menu shown on + + + + + Init context menu items strings. + + + + + Init. + + the selection handler linked to the context menu handler + the html container the handler is on + + + + Show context menu clicked on given rectangle. + + the parent control to show the context menu on + the rectangle that was clicked to show context menu + the link that was clicked to show context menu on + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Dispose of the last used context menu. + + + + + Handle link click. + + + + + Copy the href of a link to clipboard. + + + + + Open save as dialog to save the image + + + + + Copy the image source to clipboard. + + + + + Copy image object to clipboard. + + + + + Copy selected text. + + + + + Select all text. + + + + + Utilities for fonts and fonts families handling. + + + + + + + + + + Allow to map not installed fonts to different + + + + + collection of all installed and added font families to check if font exists + + + + + cache of all the font used not to create same font again and again + + + + + Init. + + + + + Check if the given font family exists by name + + the font to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get cached font instance for the given font properties.
+ Improve performance not to create same font multiple times. + + cached font instance + + + + Get cached font if it exists in cache or null if it is not. + + + + + create font (try using existing font family to support custom fonts) + + + + + Handler for all loading image logic.
+

+ Loading by .
+ Loading by file path.
+ Loading by URI.
+

+ + + + Supports sync and async image loading. + + + If the image object is created by the handler on calling dispose of the handler the image will be released, this + makes release of unused images faster as they can be large.
+ Disposing image load handler will also cancel download of image from the web. + + + + + + the container of the html to handle load image for + + + + + callback raised when image load process is complete with image or without + + + + + the web client used to download image from URL (to cancel on dispose) + + + + + Must be open as long as the image is in use + + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + to know if image load event callback was sync or async raised + + + + + flag to indicate if to release the image object on box dispose (only if image was loaded by the box) + + + + + is the handler has been disposed + + + + + Init. + + the container of the html to handle load image for + callback raised when image load process is complete with image or without + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + Set image of this image box by analyzing the src attribute.
+ Load the image from inline base64 encoded string.
+ Or from calling property/method on the bridge object that returns image or URL to image.
+ Or from file path
+ Or from URI. + + + File path and URI image loading is executed async and after finishing calling + on the main thread and not thread-pool. + + the source of the image to load + the collection of attributes on the element to use in event + the image object (null if failed) + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set the image using callback from load image event, use the given data. + + the path to the image to load (file path or uri) + the image to load + optional: limit to specific rectangle of the image and not all of it + + + + Load the image from inline base64 encoded string data. + + the source that has the base64 encoded image + + + + Extract image object from inline base64 encoded data in the src of the html img element. + + the source that has the base64 encoded image + image from base64 data string or null if failed + + + + Load image from path of image file or URL. + + the file path or uri to load image from + + + + Load the image file on thread-pool thread and calling after. + + the file path to get the image from + + + + Load the image file on thread-pool thread and calling after.
+ Calling on the main thread and not thread-pool. + + the file path to get the image from + + + + Load image from the given URI by downloading it.
+ Create local file name in temp folder from the URI, if the file already exists use it as it has already been downloaded. + If not download the file using . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + key value pair of URL and file info to download the file to + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + Flag image load complete and request refresh for re-layout and invalidate. + + + + + Release the image and client objects. + + + + + Handler for text selection in the html. + + + + + the root of the handled html tree + + + + + handler for showing context menu on right click + + + + + the mouse location when selection started used to ignore small selections + + + + + the starting word of html selection
+ where the user started the selection, if the selection is backwards then it will be the last selected word. + + + + + the ending word of html selection
+ where the user ended the selection, if the selection is backwards then it will be the first selected word. + + + + + the selection start index if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + is the selection goes backward in the html, the starting word comes after the ending word in DFS traversing.
+ + + + + used to ignore mouse up after selection + + + + + current selection process is after double click (full word selection) + + + + + used to know if selection is in the control or started outside so it needs to be ignored + + + + + used to handle drag and drop + + + + + is the cursor on the control has been changed by the selection handler + + + + + used to know if double click selection is requested + + + + + used to know if drag and drop was already started not to execute the same operation over + + + + + Init. + + the root of the handled html tree + + + + Select all the words in the html. + + the control hosting the html to invalidate + + + + Select the word at the given location if found. + + the control hosting the html to invalidate + the location to select word at + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse on the html + + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + is the left mouse button has been released + is the mouse up should be ignored + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse on the html + + + + On mouse leave change the cursor back to default. + + the control hosting the html to set cursor and invalidate + + + + Copy the currently selected html segment to clipboard.
+ Copy rich html text and plain text. + + + + + Get the currently selected text segment in the html.
+ + + + + Copy the currently selected html segment with style.
+ + + + + The selection start index if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start index for + data value or -1 if not applicable + + + + The selection end index if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end index for + + + + The selection start offset if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start offset for + + + + The selection end offset if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end offset for + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Handle html text selection by mouse move over the html with left mouse button pressed.
+ Calculate the words in the selected range and set their selected property. + + the control hosting the html to invalidate + the mouse location + true - partial word selection allowed, false - only full words selection + + + + Clear the current selection. + + + + + Clear the selection from all the words in the css box recursively. + + the css box to selectionStart clear at + + + + Start drag and drop operation on the currently selected html segment. + + the control to start the drag and drop on + + + + Select all the words that are under DOM hierarchy.
+ + the box to start select all at + + + + Check if the current selection is non empty, has some selection data. + + + true - partial word selection allowed, false - only full words selection + true - is non empty selection, false - empty selection + + + + Select all the words that are between word and word in the DOM hierarchy.
+ + the root of the DOM sub-tree the selection is in + selection start word limit + selection end word limit + + + + Select all the words that are between word and word in the DOM hierarchy. + + the current traversal node + selection start word limit + selection end word limit + used to know the traversal is currently in selected range + + + + + Calculate the character index and offset by characters for the given word and given offset.
+ . + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + to set the starting or ending char and offset data + + + + Calculate the character index and offset by characters for the given word and given offset.
+ If the location is below the word line then set the selection to the end.
+ If the location is to the right of the word then set the selection to the end.
+ If the offset is to the left of the word set the selection to the beginning.
+ Otherwise calculate the width of each substring to find the char the location is on. + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + is to include the first character in the calculation + return the index of the char under the location + return the offset of the char under the location + + + + Check if the selection direction is forward or backward.
+ Is the selection start word is before the selection end word in DFS traversal. + + + + + Handler for loading a stylesheet data. + + + + + Load stylesheet data from the given source.
+ The source can be local file or web URI.
+ First raise event to allow the client to overwrite the stylesheet loading.
+ If the stylesheet is downloaded from URI we will try to correct local URIs to absolute.
+ + the container of the html to handle load stylesheet for + the source of the element to load the stylesheet by + the attributes of the link element + return the stylesheet string that has been loaded (null if failed or is given) + return stylesheet data object that was provided by overwrite (null if failed or is given) + + + + Load stylesheet string from given source (file path or uri). + + the container of the html to handle load stylesheet for + the file path or uri to load the stylesheet from + the stylesheet string + + + + Load the stylesheet from local file by given path. + + the container of the html to handle load stylesheet for + the stylesheet file to load + the loaded stylesheet string + + + + Load the stylesheet from uri by downloading the string. + + the container of the html to handle load stylesheet for + the uri to download from + the loaded stylesheet string + + + + Make relative URLs absolute in the stylesheet using the URI of the stylesheet. + + the stylesheet to correct + the stylesheet uri to use to create absolute URLs + Corrected stylesheet + + + + Low level handling of Html Renderer logic.
+ Allows html layout and rendering without association to actual control, those allowing to handle html rendering on any graphics object.
+ Using this class will require the client to handle all propagation's of mouse/keyboard events, layout/paint calls, scrolling offset, + location/size/rectangle handling and UI refresh requests.
+ + + + MaxSize and ActualSize:
+ The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can exceed the max size by layout restrictions (unwrap-able line, set image size, etc.).
+ Set zero for unlimited (width/height separately).
+ + + ScrollOffset:
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ Element that is rendered at location (50,100) with offset of (0,200) will not be rendered + at -100, therefore outside the client rectangle. + + + LinkClicked event
+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link to overwrite by custom logic.
+ If error occurred in event handler it will propagate up the stack. + + + StylesheetLoad event:
+ Raised when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + ImageLoad event:
+ Raised when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ + + Refresh event:
+ Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + RenderError event:
+ Raised when an error occurred during html rendering.
+ + + + + + + + + + + + + + + + parser for CSS data + + + + + the root css box of the parsed html + + + + + list of all css boxes that have ":hover" selector on them + + + + + Handler for text selection in the html. + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + the parsed stylesheet data used for handling the html + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled (default - true) + + + + + Gets or sets a value indicating if anti-aliasing should be avoided + for geometry like backgrounds and borders + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ + + + + the top-left most location of the rendered html + + + + + the max width and height of the rendered html, effects layout, actual size cannot exceed this values.
+ Set zero for unlimited.
+ + + + + Gets or sets the scroll offset of the document for scroll controls + + + + + The actual size of the rendered html (after layout) + + + + + Init. + + + + + + + + + + parser for CSS data + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrapable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + the root css box of the parsed html + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + + + + + + + Clear the content of the HTML container releasing any resources used to render previously existing content. + + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given device. + + the device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the location of the mouse + the mouse event data + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + Raise the stylesheet load event with the given event args. + + the event args + + + + Raise the image load event with the given event args. + + the event args + + + + Request invalidation and re-layout of the control hosting the renderer. + + is re-layout is required for the refresh + + + + Report error in html render process. + + the type of error to report + the error message + optional: the exception that occured + + + + Handle link clicked going over event and using if not canceled. + + the control hosting the html to invalidate + the location of the mouse + the link that was clicked + + + + Add css box that has ":hover" selector to be handled on mouse hover. + + the box that has the hover selector + the css block with the css data with the selector + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Adjust the offset of the given location by the current scroll offset. + + the location to adjust + the adjusted location + + + + Check if the mouse is currently on the html container.
+ Relevant if the html container is not filled in the hosted control (location is not zero and the size is not the full size of the control). + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + General utilities. + + + + + Measure the size of the html by performing layout under the given restrictions. + + the graphics to use + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Perform the layout of the html container by given size restrictions returning the final size.
+ The layout can be effected by the HTML content in the if or + is set to true.
+ Handle minimum and maximum size restrictions.
+ Handle auto size and auto size for height only. if is true + is ignored.
+ + the graphics used for layout + the html container to layout + the current size + the min size restriction - can be empty for no restriction + the max size restriction - can be empty for no restriction + if to modify the size (width and height) by html content layout + if to modify the height by html content layout + + + + Parser to parse CSS stylesheet source string into CSS objects. + + + + + split CSS rule + + + + + + + + + + Utility for value parsing. + + + + + The chars to trim the css class name by + + + + + Init. + + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + raw css stylesheet to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the CSS data with parsed CSS objects (never null) + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ The parsed css blocks are added to the given css data, merged if class name already exists. + + the CSS data to fill with parsed CSS objects + raw css stylesheet to parse + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the font-family value to parse + parsed font-family value + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + color value + + + + Remove comments from the given stylesheet. + + the stylesheet to remove comments from + stylesheet without comments + + + + Parse given stylesheet for CSS blocks
+ This blocks are added under the "all" keyword. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Parse given stylesheet for media CSS blocks
+ This blocks are added under the specific media block they are found. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Feeds the style with a block about the specific media.
+ When no media is specified, "all" will be used. + + + the CSS block to handle + optional: the media (default - all) + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse css block selector to support hierarchical selector (p class1 > class2). + + the class selector to parse + return the main class the css block is on + returns the hierarchy of classes or null if single class selector + + + + Parse the properties of the given css block into a key-value dictionary. + + the raw css block to parse + dictionary with parsed css block properties + + + + Add the given property to the given properties collection, if the property is complex containing + multiple css properties then parse them and add the inner properties. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse length property to add only valid lengths. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse color property to add only valid color. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse a complex font property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + + + the value of the property to parse + parsed value + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the value of the property to parse + parsed font-family value + + + + Parse a complex border property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the left, top, right or bottom direction of the border to parse + the properties collection to add the specific properties to + + + + Parse a complex margin property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border style property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border width property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border color property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex padding property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Split multi direction value into the proper direction values (left, top, right, bottom). + + + + + Split the value by the specified separator; e.g. Useful in values like 'padding:5 4 3 inherit' + + Value to be splitted + + Splitted and trimmed values + + + + + + + + + + + + + Parse the given substring to extract border width substring. + Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse CSS properties values like numbers, Urls, etc. + + + + + + + + + + Init. + + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid double number, false - otherwise + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid int number, false - otherwise + + + + Check if the given string is a valid length value. + + the string value to check + true - valid, false - invalid + + + + Evals a number and returns it. If number is a percentage, it will be multiplied by hundredPercent + + Number to be parsed + Number that represents the 100% if parsed number is a percentage + Parsed number. Zero if error while parsing. + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + if the length is in pixels and the length is font related it needs to use 72/96 factor + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + if the length is in pixels and the length is font related it needs to use 72/96 factor + Allows the return double to be in points. If false, result will be pixels + the parsed length value with adjustments + + + + Get the unit to use for the length, use default if no unit found in length string. + + + + + Check if the given color string value is valid. + + color string value to parse + true - valid, false - invalid + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + Color value + + + + Parses a color value in CSS style; e.g. #ff0000, RED, RGB(255,0,0), RGB(100%, 0, 0) + + color substring value to parse + substring start idx + substring length + return the parsed color + true - valid color, false - otherwise + + + + Parses a border value in CSS style; e.g. 1px, 1, thin, thick, medium + + + + + + + + Get color by parsing given hex value color string (#A28B34). + + true - valid color, false - otherwise + + + + Get color by parsing given RGB value color string (RGB(255,180,90)) + + true - valid color, false - otherwise + + + + Get color by parsing given RGBA value color string (RGBA(255,180,90,180)) + + true - valid color, false - otherwise + + + + Get color by given name, including .NET name. + + true - valid color, false - otherwise + + + + Parse the given decimal number string to positive int value.
+ Start at given , ignore whitespaces and take + as many digits as possible to parse to int. + + the string to parse + the index to start parsing at + parsed int or 0 + + + + Parse the given decimal number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Parse the given hex number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Handle css DOM tree generation from raw html and stylesheet. + + + + + Parser for CSS + + + + + Init. + + + + + Generate css tree by parsing the given html and applying the given css style data on it. + + the html to parse + the html container to use for reference resolve + the css data to use + the root of the generated tree + + + + Read styles defined inside the dom structure in links and style elements.
+ If the html tag is "style" tag parse it content and add to the css data for all future tags parsing.
+ If the html tag is "link" that point to style data parse it content and add to the css data for all future tags parsing.
+ + the box to parse style data in + the html container to use for reference resolve + the style data to fill with found styles + check if the css data has been modified by the handled html not to change the base css data + + + + Applies style to all boxes in the tree.
+ If the html tag has style defined for each apply that style to the css box of the tag.
+ If the html tag has "class" attribute and the class name has style defined apply that style on the tag css box.
+ If the html tag has "style" attribute parse it and apply the parsed style on the tag css box.
+ + the box to apply the style to + the style data for the html + + + + Set the selected text style (selection text color and background color). + + + the style data + + + + Assigns the given css classes to the given css box checking if matching.
+ Support multiple classes in single attribute separated by whitespace. + + the css box to assign css to + the css data to use to get the matching css blocks + + + + Assigns the given css style blocks to the given css box checking if matching. + + the css box to assign css to + the css data to use to get the matching css blocks + the class selector to search for css blocks + + + + Check if the given css block is assignable to the given css box.
+ the block is assignable if it has no hierarchical selectors or if the hierarchy matches.
+ Special handling for ":hover" pseudo-class.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Check if the given css block is assignable to the given css box by validating the selector.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Assigns the given css style block properties to the given css box. + + the css box to assign css to + the css block to assign + + + + Check if the given style is allowed to be set on the given css box.
+ Used to prevent invalid CssBoxes creation like table with inline display style. + + the css box to assign css to + the style key to cehck + the style value to check + true - style allowed, false - not allowed + + + + Clone css data if it has not already been cloned.
+ Used to preserve the base css data used when changed by style inside html. + + + + + + + + + + + + Converts an HTML length into a Css length + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Execute action on all the "td" cells of the table.
+ Handle if there is "theader" or "tbody" exists. + + the table element + the action to execute + + + + Go over all the text boxes (boxes that have some text that will be rendered) and + remove all boxes that have only white-spaces but are not 'preformatted' so they do not effect + the rendered html. + + the current box to correct its sub-tree + + + + Go over all image boxes and if its display style is set to block, put it inside another block but set the image to inline. + + the current box to correct its sub-tree + + + + Correct the DOM tree recursively by replacing "br" html boxes with anonymous blocks that respect br spec.
+ If the "br" tag is after inline box then the anon block will have zero height only acting as newline, + but if it is after block box then it will have min-height of the font size so it will create empty line. + + the current box to correct its sub-tree + used to know if the br is following a box so it should create an empty line or not so it only + move to a new line + + + + Correct DOM tree if there is block boxes that are inside inline blocks.
+ Need to rearrange the tree so block box will be only the child of other block box. + + the current box to correct its sub-tree + + + + Rearrange the DOM of the box to have block box with boxes before the inner block box and after. + + the box that has the problem + + + + Split bad box that has inline and block boxes into two parts, the left - before the block box + and right - after the block box. + + the parent box that has the problem + the box to split into different boxes + the left block box that is created for the split + + + + Makes block boxes be among only block boxes and all inline boxes have block parent box.
+ Inline boxes should live in a pool of Inline boxes only so they will define a single block.
+ At the end of this process a block box will have only block siblings and inline box will have + only inline siblings. + + the current box to correct its sub-tree + + + + Check if the given box contains only inline child boxes in all subtree. + + the box to check + true - only inline child boxes, false - otherwise + + + + Check if the given box contains inline and block child boxes. + + the box to check + true - has variant child boxes, false - otherwise + + + + + + + + + Parses the source html to css boxes tree structure. + + the html source to parse + + + + Add html text anon box to the current box, this box will have the rendered text
+ Adding box also for text that contains only whitespaces because we don't know yet if + the box is preformatted. At later stage they will be removed if not relevant. + + the html source to parse + the start of the html part + the index of the next html tag + the current box in html tree parsing + + + + Parse the html part, the part from prev parsing index to the beginning of the next html tag.
+ + the html source to parse + the index of the next html tag + the current box in html tree parsing + the end of the parsed part, the new start index + + + + Parse raw html tag source to object.
+ Extract attributes found on the tag. + + the html source to parse + the start index of the tag in the source + the length of the tag from the start index in the source + return the name of the html tag + return the dictionary of tag attributes + true - the tag is closing tag, false - otherwise + + + + Extract html tag attributes from the given sub-string. + + the html source to parse + the start index of the tag attributes in the source + the length of the tag attributes from the start index in the source + return the dictionary of tag attributes + + + + Collection of regular expressions used when parsing + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + Static class that contains argument-checking methods + + + + + Validate given condition is true, otherwise throw exception. + + Exception type to throw. + Condition to assert. + Exception message in-case of assert failure. + + + + Validate given argument isn't Null. + + argument to validate + Name of the argument checked + if is Null + + + + Validate given argument isn't . + + argument to validate + Name of the argument checked + if is + + + + Validate given argument isn't Null or empty. + + argument to validate + Name of the argument checked + if is Null or empty + + + + Validate given argument isn't Null. + + Type expected of arg + argument to validate + Name of the argument checked + if is Null + arg cast as T + + + + Validate given argument isn't Null or empty AND argument value is the path of existing file. + + argument to validate + Name of the argument checked + if is Null or empty + if arg file-path not exist + + + + Utility methods for general stuff. + + + + + Table to convert numbers into roman digits + + + + + Check if the given char is of Asian range. + + the character to check + true - Asian char, false - otherwise + + + + Check if the given char is a digit character (0-9) and (0-9, a-f for HEX) + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Convert the given char to digit. + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Get size that is max of and for width and height separately. + + + + + Get Uri object for the given path if it is valid uri path. + + the path to get uri for + uri or null if not valid + + + + Get the first value in the given dictionary. + + the type of dictionary key + the type of dictionary value + the dictionary + optional: the default value to return of no elements found in dictionary + first element or default value + + + + Get file info object for the given path if it is valid file path. + + the path to get file info for + file info or null if not valid + + + + Get web client response content type. + + the web client to get the response content type from + response content type or null + + + + Gets the representation of the online uri on the local disk. + + The online image uri. + The path of the file on the disk. + + + + Get substring seperated by whitespace starting from the given idex. + + the string to get substring in + the index to start substring search from + return the length of the found string + the index of the substring, -1 if no valid sub-string found + + + + Compare that the substring of is equal to + Assume given substring is not empty and all indexes are valid!
+ + true - equals, false - not equals + + + + Replaces invalid filename chars to '_' + + The possibly-not-valid filename + A valid filename. + + + + Convert number to alpha numeric system by the requested style (UpperAlpha, LowerRoman, Hebrew, etc.). + + the number to convert + the css style to convert by + converted string + + + + Convert the given integer into alphabetic numeric format (D, AU, etc.) + + the number to convert + is to use lowercase + the roman number string + + + + Convert the given integer into alphabetic numeric format (alpha, AU, etc.) + + the number to convert + the roman number string + + + + Convert the given integer into roman numeric format (II, VI, IX, etc.) + + the number to convert + if to use lowercase letters for roman digits + the roman number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + String constants to avoid typing errors. + + + + + Centimeters + + + + + Millimeters + + + + + Pixels + + + + + Inches + + + + + Em - The font size of the relevant font + + + + + The 'x-height' of the relevan font + + + + + Points + + + + + Picas + + + + + Default font size in points. Change this value to modify the default font size. + + + + + Default font used for the generic 'serif' family + + + + + Utility method for handling CSS stuff. + + + + + Brush for selection background + + + + + Brush for selection background + + + + + Gets the white space width of the specified box + + + + + + + + Get CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to get it's property value + the name of the CSS property + the value of the property, null if no such property exists + + + + Set CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to set it's property value + the name of the CSS property + the value to set + + + + Utility class for traversing DOM structure and execution stuff on it. + + + + + Check if the given location is inside the given box deep.
+ Check inner boxes and all lines that the given box spans to. + + the box to check + the location to check + true - location inside the box, false - otherwise + + + + Check if the given box contains only inline child boxes. + + the box to check + true - only inline child boxes, false - otherwise + + + + Recursively searches for the parent with the specified HTML Tag name + + + + + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + fix word space for first word in inline tag. + + the box to check + + + + Gets the next sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Get attribute value by given key starting search from given box, search up the tree until + attribute found or root. + + the box to start lookup at + the attribute to get + the value of the attribute or null if not found + + + + Get css box under the given sub-tree at the given x,y location, get the inner most.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + Optional: if to get only visible boxes (default - true) + css link box if exists or null + + + + Collect all link boxes found in the HTML tree. + + the box to start search from + collection to add all link boxes to + + + + Get css link box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + css link box if exists or null + + + + Get css box under the given sub-tree with the given id.
+ + the box to start search from + the id to find the box by + css box if exists or null + + + + Get css line box under the given sub-tree at the given y location or the nearest line from the top.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the line box to search in + the location to find the box at + css word box if exists or null + + + + Find the css line box that the given word is in. + + the word to search for it's line box + line box that the word is in + + + + Get selected plain text of the given html sub-tree. + + the DOM box to get selected text from its sub-tree + the selected plain text string + + + + Generate html from the given DOM tree.
+ Generate all the style inside the html, in header or for every tag depending on value. + + the box of the html generate html from + Optional: controls the way styles are generated when html is generated + Optional: true - generate only selected html subset, false - generate all (default - false) + generated html + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the root to generate tree from + generated tree + + + + Get selected plain text of the given html sub-tree.
+ Append all the selected words. + + the builder to append the selected text to + the DOM box to get selected text from its sub-tree + the index of the last word appended + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ + the box to check its sub-tree + the collection to add the selected tags to + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ Use to handle boxes that are between selected words but don't have selected word inside.
+ + the box to check its sub-tree + the hash to add the selected boxes to + used to handle boxes that are between selected words but don't have selected word inside + is the current box is in selected sub-tree + + + + find the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + the root of the boxes tree + the selected boxes to find selection root in + the box that is the root of selected boxes + + + + Check if the given box has a names child box (has html tag) recursively. + + the box to check + true - in sub-tree there is a named box, false - otherwise + + + + Write the given html DOM sub-tree into the given string builder.
+ If are given write html only from those tags. + + used to parse CSS data + the string builder to write html into + the html sub-tree to write + Controls the way styles are generated when html is generated + Control if to generate only selected boxes, if given only boxes found in hash will be generated + the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + + + Write the given html tag with all its attributes and styles. + + used to parse CSS data + the string builder to write html into + the css box with the html tag to write + Controls the way styles are generated when html is generated + + + + Clean the given style collection by removing default styles so only custom styles remain.
+ Return new collection where the old remains unchanged. + + the box the styles apply to, used to know the default style + the collection of styles to clean + new cleaned styles collection + + + + Write stylesheet data inline into the html. + + the string builder to write stylesheet into + the css data to write to the head + + + + Get the selected word with respect to partial selected words. + + the word to append + is to get selected text or all the text in the word + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the box to generate for + the string builder to generate to + the current indent level to set indent of generated text + + + + Defines HTML strings + + + + + List of html tags that don't have content + + + + + the html encode\decode pairs + + + + + the html decode only pairs + + + + + Init. + + + + + Is the given html tag is single tag or can have content. + + the tag to check (must be lower case) + true - is single tag, false - otherwise + + + + Decode html encoded string to regular string.
+ Handles <, >, "&. + + the string to decode + decoded string + + + + Encode regular string into html encoded string.
+ Handles <, >, "&. + + the string to encode + encoded string + + + + Decode html special charecters encoded using char entity code (€) + + the string to decode + decoded string + + + + Decode html special charecters encoded using char entity name + + the string to decode + decoded string + + + + Provides some drawing functionality + + + + + Check if the given color is visible if painted (has alpha and color values) + + the color to check + true - visible, false - not visible + + + + Clip the region the graphics will draw on by the overflow style of the containing block.
+ Recursively travel up the tree to find containing block that has overflow style set to hidden. if not + block found there will be no clipping and null will be returned. + + the graphics to clip + the box that is rendered to get containing blocks + true - was clipped, false - not clipped + + + + Draw image loading icon. + + the device to draw into + + the rectangle to draw icon in + + + + Draw image failed to load icon. + + the device to draw into + + the rectangle to draw icon in + + + + Creates a rounded rectangle using the specified corner radius
+ NW-----NE + | | + | | + SW-----SE + + the device to draw into + Rectangle to round + Radius of the north east corner + Radius of the north west corner + Radius of the south east corner + Radius of the south west corner + GraphicsPath with the lines of the rounded rectangle ready to be painted + + + + Represents sub-string of a full string starting at specific location with a specific length. + + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Init sub-string that is the full string. + + the full string that this sub-string is part of + + + + Init. + + the full string that this sub-string is part of + the start index of the sub-string + the length of the sub-string starting at + is null + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Get string char at specific index. + + the idx to get the char at + char at index + + + + Is the sub-string is empty string. + + true - empty string, false - otherwise + + + + Is the sub-string is empty string or contains only whitespaces. + + true - empty or whitespace string, false - otherwise + + + + Is the sub-string contains only whitespaces (at least one). + + true - empty or whitespace string, false - otherwise + + + + Get a string of the sub-string.
+ This will create a new string object! + + new string that is the sub-string represented by this instance + + + + Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length. + + The zero-based starting character position of a substring in this instance. + The number of characters in the substring. + A String equivalent to the substring of length length that begins at startIndex in this instance, or + Empty if startIndex is equal to the length of this instance and length is zero. + + + + Collection of regular expressions used when parsing + + + + + Extracts CSS style comments; e.g. /* comment */ + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts CSS colors; e.g. black white #fff #fe98cd rgb(5,5,5) rgb(45%, 0, 0) + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts CSS border styles; e.g. solid none dotted + + + + + Extracts CSS border widthe; e.g. 1px thin 3em + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + Extracts HTML tags + + + + + Extracts attributes from a HTML tag; e.g. att=value, att="value" + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + 线条图 @@ -32826,5 +42888,2509 @@ the contents of this method with the code editor. + + + The top left rectangle in auto hide strip area. + + + + + The top right rectangle in auto hide strip area. + + + + + The bottom left rectangle in auto hide strip area. + + + + + The bottom right rectangle in auto hide strip area. + + + + + Gets one of the four auto hide strip rectangles. + + Dock state. + The desired rectangle. + + As the corners are represented by , , , and , + the four strips can be easily calculated out as the borders. + + + + + Context menu. + + + This property should be obsolete as it does not support theming. Please use instead. + + + + + Context menu strip. + + + + + Overridden to avoid resize issues with nested controls + + + http://blogs.msdn.com/b/alejacma/archive/2008/11/20/controls-won-t-get-resized-once-the-nesting-hierarchy-of-windows-exceeds-a-certain-depth-x64.aspx + http://support.microsoft.com/kb/953934 + + + + + Determines whether the close button is visible on the content + + + + + There's a bug in the WinForms layout engine + that can result in a deferred layout to not + properly clear out the cached layout args after + the layout operation is performed. + Specifically, this bug is hit when the bounds of + the Pane change, initiating a layout on the parent + (DockWindow) which is where the bug hits. + To work around it, when a pane loses the DockWindow + as its parent, that parent DockWindow needs to + perform a layout to flush the cached args, if they exist. + + + + + Gets a value indicating whether dock panel can be dragged when in auto hide mode. + Default is false. + + + + + Determines the color with which the client rectangle will be drawn. + If this property is used instead of the BackColor it will not have any influence on the borders to the surrounding controls (DockPane). + The BackColor property changes the borders of surrounding controls (DockPane). + Alternatively both properties may be used (BackColor to draw and define the color of the borders and DockBackColor to define the color of the client rectangle). + For Backgroundimages: Set your prefered Image, then set the DockBackColor and the BackColor to the same Color (Control) + + + + + Dock area. + + + This is the center rectangle of control. + + Excluded spaces are for the following visual elements, + * Auto hide strips on four sides. + * Necessary paddings defined in themes. + + Therefore, all dock contents mainly fall into this area (except auto hide window, which might slightly move beyond this area). + + + + + Flag to show autohide content on mouse hover. Default value is true. + + + This flag is ignored in VS2012/2013 themes. Such themes assume it is always false. + + + + + DragHandlerBase is the base class for drag handlers. The derived class should: + 1. Define its public method BeginDrag. From within this public BeginDrag method, + DragHandlerBase.BeginDrag should be called to initialize the mouse capture + and message filtering. + 2. Override the OnDragging and OnEndDrag methods. + + + + + Loads layout from XML file. + + The file name. + Deserialization handler. + Deserialization might throw exceptions. + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + Deserialization might throw exceptions. + + The stream is closed after deserialization. + + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + The flag to close the stream after deserialization. + Deserialization might throw exceptions. + + + + Deserialization handler of layout file/stream. + + Strings stored in layout file/stream. + Dock content deserialized from layout/stream. + + The deserialization handler method should handle all possible exceptions. + + If any exception happens during deserialization and is not handled, the program might crash or experience other issues. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The skin to use when displaying the DockPanel. + The skin allows custom gradient color schemes to be used when drawing the + DockStrips and Tabs. + + + + + The skin used to display the auto hide strips and tabs. + + + + + The skin used to display the Document and ToolWindow style DockStrips and Tabs. + + + + + The skin used to display the auto hide strip and tabs. + + + + + The gradient color skin for the DockStrips. + + + + + The gradient color skin for the Tabs. + + + + + The gradient color skin for the Tabs. + + + + + Font used in AutoHideStrip elements. + + + + + The skin used to display the document and tool strips and tabs. + + + + + The skin used to display the Document style DockPane strip and tab. + + + + + The skin used to display the ToolWindow style DockPane strip and tab. + + + + + Font used in DockPaneStrip elements. + + + + + The skin used to display the DockPane ToolWindow strip and tab. + + + + + The skin used to display the active ToolWindow caption. + + + + + The skin used to display the inactive ToolWindow caption. + + + + + The skin used to display the DockPane strip and tab. + + + + + The gradient color skin for the DockStrip. + + + + + The skin used to display the active DockPane tabs. + + + + + The skin used to display the inactive DockPane tabs. + + + + + The skin used to display the dock pane tab + + + + + The text color. + + + + + The skin used to display the dock pane tab + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient color skin. + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient mode to display the colors. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Dock window base class. + + + + + Dock window of Visual Studio 2003/2005 theme. + + + + + The location to draw the DockPaneStrip for Document style windows. + + + + + + + + + + + + + + + Gets images for tabs and captions. + + + + + + + + + + Gets images for docking indicators. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Switches a pane with its first child in the pane hierarchy. (The actual hiding happens elsewhere.) + + Pane to switch + + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized string similar to Docking. + + + + + Looks up a localized string similar to Docking Notification. + + + + + Looks up a localized string similar to Performance. + + + + + Looks up a localized string similar to Property Changed. + + + + + Looks up a localized string similar to (Float). + + + + + Looks up a localized string similar to Determines if end user drag and drop docking is allowed.. + + + + + Looks up a localized string similar to The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel.. + + + + + Looks up a localized string similar to Enable/Disable the close button of the content.. + + + + + Looks up a localized string similar to Shows or hides the close button of the content. This property does not function with System MDI Document Style.. + + + + + Looks up a localized string similar to The form must be of type IDockContent.. + + + + + Looks up a localized string similar to Gets or sets a value indicating in which area of the DockPanel the content allowed to show.. + + + + + Looks up a localized string similar to Occurs when the value of DockState property changed.. + + + + + Looks up a localized string similar to Indicates the content will be hidden instead of being closed.. + + + + + Looks up a localized string similar to The desired docking state when first showing.. + + + + + Looks up a localized string similar to Context menu displayed for the dock pane tab strip.. + + + + + Looks up a localized string similar to The tab text displayed in the dock pane. If not set, the Text property will be used.. + + + + + Looks up a localized string similar to The text displayed when mouse hovers over the tab.. + + + + + Looks up a localized string similar to The provided value is out of range.. + + + + + Looks up a localized string similar to Invalid Value: The value of DockAreas conflicts with current DockState.. + + + + + Looks up a localized string similar to The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane.. + + + + + Looks up a localized string similar to The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane.. + + + + + Looks up a localized string similar to Invalid value, conflicts with DockableAreas property.. + + + + + Looks up a localized string similar to The dock state is invalid.. + + + + + Looks up a localized string similar to The dock panel is null.. + + + + + Looks up a localized string similar to Invalid beforeContent, it must be contained by the pane.. + + + + + Looks up a localized string similar to Invalid DockState: Content can not be showed as "Unknown" or "Hidden".. + + + + + Looks up a localized string similar to The previous pane is invalid. It can not be null, and its docking state must not be auto-hide.. + + + + + Looks up a localized string similar to DockPanel can not be null.. + + + + + Looks up a localized string similar to The Pane can not be null.. + + + + + Looks up a localized string similar to Invalid value, check DockableAreas property.. + + + + + Looks up a localized string similar to Context menu displayed for the dock pane tab strip.. + + + + + Looks up a localized string similar to Press SHIFT for docking to full side.. + + + + + Looks up a localized string similar to Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content.. + + + + + Looks up a localized string similar to Invalid argument: Content can not be "null".. + + + + + Looks up a localized string similar to Invalid argument: The content's DockPanel can not be "null".. + + + + + Looks up a localized string similar to The specified container conflicts with the IsFloat property.. + + + + + Looks up a localized string similar to The previous pane does not exist in the nested docking pane collection.. + + + + + Looks up a localized string similar to The container can not be null.. + + + + + Looks up a localized string similar to The previous pane can not be null when the nested docking pane collection is not empty.. + + + + + Looks up a localized string similar to The previous pane can not be itself.. + + + + + Looks up a localized string similar to FloatWindow property can not be set to "null" when DockState is DockState.Float.. + + + + + Looks up a localized string similar to Invalid Content: Content not within the collection.. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to The state for the dock pane is invalid.. + + + + + Looks up a localized string similar to Auto Hide. + + + + + Looks up a localized string similar to Close. + + + + + Looks up a localized string similar to Options. + + + + + Looks up a localized string similar to Invalid Content: The content must be auto-hide state and associates with this DockPanel.. + + + + + Looks up a localized string similar to Occurs when the value of the AutoHideWindow's ActiveContent changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActiveContentProperty changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActiveDocument property changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActivePane property changed.. + + + + + Looks up a localized string similar to Determines if the drag and drop docking is allowed.. + + + + + Looks up a localized string similar to Determines if the drag and drop nested docking is allowed.. + + + + + Looks up a localized string similar to Occurs when a content added to the DockPanel.. + + + + + Looks up a localized string similar to Occurs when a content removed from the DockPanel.. + + + + + Looks up a localized string similar to The default size of float window.. + + + + + Looks up a localized string similar to Provides Visual Studio .Net style docking.. + + + + + Looks up a localized string similar to Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to The visual skin to use when displaying the docked windows.. + + + + + Looks up a localized string similar to Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Occurs when a document or pane is dragged within the dock panel.. + + + + + Looks up a localized string similar to The style of the document window.. + + + + + Looks up a localized string similar to Determines where the tab strip for Document style content is drawn.. + + + + + Looks up a localized string similar to The DockPanel has already been initialized.. + + + + + Looks up a localized string similar to The configuration file's version is invalid.. + + + + + Looks up a localized string similar to The XML file format is invalid.. + + + + + Looks up a localized string similar to Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form.. + + + + + Looks up a localized string similar to DockPanel configuration file. Author: Weifen Luo, all rights reserved.. + + + + + Looks up a localized string similar to !!! AUTOMATICALLY GENERATED FILE. DO NOT MODIFY !!!. + + + + + Looks up a localized string similar to Indicates whether the control layout is right-to-left when the RightToLeft property is set to Yes.. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to Invalid Pane: DockPane not within the collection.. + + + + + Looks up a localized string similar to Shows the hidden autohide content when hovering over the tab. When disabled, the tab must be clicked to show the content.. + + + + + Looks up a localized string similar to Show close button on each tab. + + + + + Looks up a localized string similar to Determines if the document icon will be displayed in the tab strip.. + + + + + Looks up a localized string similar to Support deeply nested controls. Disabling this setting may improve resize performance but may cause heavily nested content not to resize.. + + + + + Looks up a localized string similar to Close. + + + + + Looks up a localized string similar to Window List. + + + + + Looks up a localized string similar to Invalid argument: DockPanel can not be "null".. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to Invalid Pane: DockPane not within the collection.. + + + + + Looks up a localized string similar to Invalid DockPanel.. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Determines whether the close button is visible on the content + + + + + Calculate which tabs are displayed and in what order. + + + + + Visual Studio 2005 theme (default theme). + + + + + + + + + + X for this inside the logical strip rectangle. + + + + + Width of this . + + + + + Dock window of Visual Studio 2012 Light theme. + + + + + Initializes a new instance of the class. + + The dock panel. + State of the dock. + + + + Determines whether the close button is visible on the content + + + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized string similar to Docking. + + + + + Looks up a localized string similar to Docking Notification. + + + + + Looks up a localized string similar to Performance. + + + + + Looks up a localized string similar to Property Changed. + + + + + Looks up a localized string similar to (Float). + + + + + Looks up a localized string similar to Determines if end user drag and drop docking is allowed.. + + + + + Looks up a localized string similar to The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel.. + + + + + Looks up a localized string similar to Enable/Disable the close button of the content.. + + + + + Looks up a localized string similar to Shows or hides the close button of the content. This property does not function with System MDI Document Style.. + + + + + Looks up a localized string similar to The form must be of type IDockContent.. + + + + + Looks up a localized string similar to Gets or sets a value indicating in which area of the DockPanel the content allowed to show.. + + + + + Looks up a localized string similar to Occurs when the value of DockState property changed.. + + + + + Looks up a localized string similar to Indicates the content will be hidden instead of being closed.. + + + + + Looks up a localized string similar to The desired docking state when first showing.. + + + + + Looks up a localized string similar to Context menu displayed for the dock pane tab strip.. + + + + + Looks up a localized string similar to The tab text displayed in the dock pane. If not set, the Text property will be used.. + + + + + Looks up a localized string similar to The text displayed when mouse hovers over the tab.. + + + + + Looks up a localized string similar to The provided value is out of range.. + + + + + Looks up a localized string similar to Invalid Value: The value of DockAreas conflicts with current DockState.. + + + + + Looks up a localized string similar to The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane.. + + + + + Looks up a localized string similar to The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane.. + + + + + Looks up a localized string similar to Invalid value, conflicts with DockableAreas property.. + + + + + Looks up a localized string similar to The dock state is invalid.. + + + + + Looks up a localized string similar to The dock panel is null.. + + + + + Looks up a localized string similar to Invalid beforeContent, it must be contained by the pane.. + + + + + Looks up a localized string similar to Invalid DockState: Content can not be showed as "Unknown" or "Hidden".. + + + + + Looks up a localized string similar to The previous pane is invalid. It can not be null, and its docking state must not be auto-hide.. + + + + + Looks up a localized string similar to DockPanel can not be null.. + + + + + Looks up a localized string similar to The Pane can not be null.. + + + + + Looks up a localized string similar to Invalid value, check DockableAreas property.. + + + + + Looks up a localized string similar to Context menu displayed for the dock pane tab strip.. + + + + + Looks up a localized string similar to Press SHIFT for docking to full side.. + + + + + Looks up a localized string similar to Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content.. + + + + + Looks up a localized string similar to Invalid argument: Content can not be "null".. + + + + + Looks up a localized string similar to Invalid argument: The content's DockPanel can not be "null".. + + + + + Looks up a localized string similar to The specified container conflicts with the IsFloat property.. + + + + + Looks up a localized string similar to The previous pane does not exist in the nested docking pane collection.. + + + + + Looks up a localized string similar to The container can not be null.. + + + + + Looks up a localized string similar to The previous pane can not be null when the nested docking pane collection is not empty.. + + + + + Looks up a localized string similar to The previous pane can not be itself.. + + + + + Looks up a localized string similar to FloatWindow property can not be set to "null" when DockState is DockState.Float.. + + + + + Looks up a localized string similar to Invalid Content: Content not within the collection.. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to The state for the dock pane is invalid.. + + + + + Looks up a localized string similar to Auto Hide. + + + + + Looks up a localized string similar to Close. + + + + + Looks up a localized string similar to Window Position. + + + + + Looks up a localized string similar to Invalid Content: The content must be auto-hide state and associates with this DockPanel.. + + + + + Looks up a localized string similar to Occurs when the value of the AutoHideWindow's ActiveContent changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActiveContentProperty changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActiveDocument property changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActivePane property changed.. + + + + + Looks up a localized string similar to Determines if the drag and drop docking is allowed.. + + + + + Looks up a localized string similar to Determines if the drag and drop nested docking is allowed.. + + + + + Looks up a localized string similar to Occurs when a content added to the DockPanel.. + + + + + Looks up a localized string similar to Occurs when a content removed from the DockPanel.. + + + + + Looks up a localized string similar to The default size of float window.. + + + + + Looks up a localized string similar to Provides Visual Studio .Net style docking.. + + + + + Looks up a localized string similar to Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to The visual skin to use when displaying the docked windows.. + + + + + Looks up a localized string similar to Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to The style of the document window.. + + + + + Looks up a localized string similar to Determines where the tab strip for Document style content is drawn.. + + + + + Looks up a localized string similar to The DockPanel has already been initialized.. + + + + + Looks up a localized string similar to The configuration file's version is invalid.. + + + + + Looks up a localized string similar to The XML file format is invalid.. + + + + + Looks up a localized string similar to Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form.. + + + + + Looks up a localized string similar to DockPanel configuration file. Author: Weifen Luo, all rights reserved.. + + + + + Looks up a localized string similar to !!! AUTOMATICALLY GENERATED FILE. DO NOT MODIFY !!!. + + + + + Looks up a localized string similar to Indicates whether the control layout is right-to-left when the RightToLeft property is set to Yes.. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to Invalid Pane: DockPane not within the collection.. + + + + + Looks up a localized string similar to Shows the hidden autohide content when hovering over the tab. When disabled, the tab must be clicked to show the content.. + + + + + Looks up a localized string similar to Show close button on each tab. + + + + + Looks up a localized string similar to Determines if the document icon will be displayed in the tab strip.. + + + + + Looks up a localized string similar to Support deeply nested controls. Disabling this setting may improve resize performance but may cause heavily nested content not to resize.. + + + + + Looks up a localized string similar to Close. + + + + + Looks up a localized string similar to Window List. + + + + + Looks up a localized string similar to Invalid argument: DockPanel can not be "null".. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to Invalid Pane: DockPane not within the collection.. + + + + + Looks up a localized string similar to Invalid DockPanel.. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculate which tabs are displayed and in what order. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 theme base. + + + + + + + + + + + + + + diff --git a/Bin/Debug/CommonControls/.NET4 示例/ryUpdate.dll b/Bin/Debug/CommonControls/.NET4 示例/ryUpdate.dll index 1567cfd..f113970 100644 Binary files a/Bin/Debug/CommonControls/.NET4 示例/ryUpdate.dll and b/Bin/Debug/CommonControls/.NET4 示例/ryUpdate.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/skin.json b/Bin/Debug/CommonControls/.NET4 示例/skin.json new file mode 100644 index 0000000..a412e36 --- /dev/null +++ b/Bin/Debug/CommonControls/.NET4 示例/skin.json @@ -0,0 +1,39 @@ +{ + "name": "", + "date": 1671247019, + "ver": "", + "author": "", + "skin": { + "CaptionBackColorTop": "#E8E8E8", + "CaptionBackColorBottom": "#F8F8F8", + "CaptionTextColor": "#808080", + "IconLeftMargin": 2, + "IconSize": 22, + "CaptionHeight": 26, + "BorderWidth": 1, + "minForeColor": "#808080", + "minBackColorHover": "#438BDD", + "minBackColorPressed": "#327DD2", + "maxForeColor": "#808080", + "maxBackColorHover": "#438BDD", + "maxBackColorPressed": "#327DD2", + "closeForeColor": "#808080", + "closeBackColorHover": "#D94747", + "closeBackColorPressed": "#BC3434", + "FormBackColor": "#F2F2F2", + "FormBorderOutterColor": "#808080", + "FormBorderInnerColor": "#FFFFFF", + "FormBorderInmostColor": "#F8F8F8", + "ShowShadow": false, + "ShadowWidth": 1, + "ShadowColor": "#000000", + "ShadowAValueDark": 80, + "ShadowAValueLight": 0, + "TabActiveBackColorTop": "#FFFFFF", + "TabActiveBackColorBottom": "#F8F8F8", + "TabDeactiveBackColorTop": "#E6E6E6", + "TabDeactiveBackColorBottom": "#E6E6E6", + "TabMoveColorStart": "#F0F0F0", + "TabMoveColorEnd": "#F0F0F0" + } +} \ No newline at end of file diff --git a/Bin/Debug/CommonControls/.NET4 示例/testUI.dll b/Bin/Debug/CommonControls/.NET4 示例/testUI.dll new file mode 100644 index 0000000..9627158 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/testUI.dll differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/watermark.png b/Bin/Debug/CommonControls/.NET4 示例/watermark.png new file mode 100644 index 0000000..8a9db4b Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4 示例/watermark.png differ diff --git a/Bin/Debug/CommonControls/.NET4 示例/线程错误.txt b/Bin/Debug/CommonControls/.NET4 示例/线程错误.txt index e942b5b..1d4d9e1 100644 --- a/Bin/Debug/CommonControls/.NET4 示例/线程错误.txt +++ b/Bin/Debug/CommonControls/.NET4 示例/线程错误.txt @@ -1,22 +1,21 @@ -2021/2/10 22:56:28 +2023/10/19 10:22:37 -错误描述:所请求的剪贴板操作失败。 +错误描述:Value was either too large or too small for a character. -异常堆栈： 在 System.Windows.Forms.Clipboard.ThrowIfFailed(Int32 hr) - 在 System.Windows.Forms.Clipboard.SetDataObject(Object data, Boolean copy, Int32 retryTimes, Int32 retryDelay) - 在 System.Windows.Forms.Clipboard.SetText(String text, TextDataFormat format) - 在 System.Windows.Forms.Clipboard.SetText(String text) - 在 ryCommon.Auto.PasteText(String text) 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\MyDb\SysFuns\Auto.cs:行号 185 - 在 Itrycn_Project2.FrmStart.button2_Click(Object sender, EventArgs e) 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\Itrycn_Project2\FrmStart.cs:行号 157 - 在 System.Windows.Forms.Control.OnClick(EventArgs e) - 在 System.Windows.Forms.Button.OnClick(EventArgs e) - 在 System.Windows.Forms.Button.OnMouseUp(MouseEventArgs mevent) - 在 System.Windows.Forms.Control.WmMouseUp(Message& m, MouseButtons button, Int32 clicks) - 在 System.Windows.Forms.Control.WndProc(Message& m) - 在 System.Windows.Forms.ButtonBase.WndProc(Message& m) - 在 System.Windows.Forms.Button.WndProc(Message& m) - 在 System.Windows.Forms.Control.ControlNativeWindow.OnMessage(Message& m) - 在 System.Windows.Forms.Control.ControlNativeWindow.WndProc(Message& m) - 在 System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam) +异常堆栈： at System.Convert.ToChar(Int64 value) + at TheArtOfDev.HtmlRenderer.Core.Utils.HtmlUtils.DecodeHtmlCharByCode(String str) in E:\My Datas\毕方项目\C#\睿元公用控件组\Source\RaUI\UI\HtmlRenderer\Core\Utils\HtmlUtils.cs:line 375 + at TheArtOfDev.HtmlRenderer.Core.Utils.HtmlUtils.DecodeHtml(String str) in E:\My Datas\毕方项目\C#\睿元公用控件组\Source\RaUI\UI\HtmlRenderer\Core\Utils\HtmlUtils.cs:line 323 + at TheArtOfDev.HtmlRenderer.Core.Dom.CssBox.ParseToWords() in E:\My Datas\毕方项目\C#\睿元公用控件组\Source\RaUI\UI\HtmlRenderer\Core\Dom\CssBox.cs:line 659 + at TheArtOfDev.HtmlRenderer.Core.Parse.DomParser.CorrectTextBoxes(CssBox box) in E:\My Datas\毕方项目\C#\睿元公用控件组\Source\RaUI\UI\HtmlRenderer\Core\Parse\DomParser.cs:line 596 + at TheArtOfDev.HtmlRenderer.Core.Parse.DomParser.GenerateCssTree(String html, HtmlContainerInt htmlContainer, CssData& cssData) in E:\My Datas\毕方项目\C#\睿元公用控件组\Source\RaUI\UI\HtmlRenderer\Core\Parse\DomParser.cs:line 69 + at TheArtOfDev.HtmlRenderer.Core.HtmlContainerInt.SetHtml(String htmlSource, CssData baseCssData) in E:\My Datas\毕方项目\C#\睿元公用控件组\Source\RaUI\UI\HtmlRenderer\Core\HtmlContainerInt.cs:line 421 + at TheArtOfDev.HtmlRenderer.WinForms.HtmlContainer.SetHtml(String htmlSource, CssData baseCssData) in E:\My Datas\毕方项目\C#\睿元公用控件组\Source\RaUI\UI\HtmlRenderer\HtmlContainer.cs:line 316 + at TheArtOfDev.HtmlRenderer.WinForms.HtmlPanel.set_Text(String value) in E:\My Datas\毕方项目\C#\睿元公用控件组\Source\RaUI\UI\HtmlRenderer\HtmlPanel.cs:line 345 + at Itrycn_Project2.FrmStart.textBox1_TextChanged(Object sender, EventArgs e) in E:\My Datas\毕方项目\C#\睿元公用控件组\Source\Itrycn_Project2\FrmStart.cs:line 305 + at System.Windows.Forms.Control.OnTextChanged(EventArgs e) + at System.Windows.Forms.TextBoxBase.OnTextChanged(EventArgs e) + at System.Windows.Forms.TextBoxBase.WmReflectCommand(Message& m) + at System.Windows.Forms.TextBox.WndProc(Message& m) + at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam) -异常方法：Void ThrowIfFailed(Int32) \ No newline at end of file +异常方法：Char ToChar(Int64) \ No newline at end of file diff --git a/Bin/Debug/CommonControls/.NET4 示例/错误.txt b/Bin/Debug/CommonControls/.NET4 示例/错误.txt index 1fb2b86..ea20f7c 100644 --- a/Bin/Debug/CommonControls/.NET4 示例/错误.txt +++ b/Bin/Debug/CommonControls/.NET4 示例/错误.txt @@ -1,10 +1,13 @@ -2021/9/2 17:28:18 +2023/1/11 8:44:19 -错误描述:未将对象引用设置到对象的实例。 +错误描述:参数“picture”必须是可用作 Icon 的图片。 -异常堆栈： 在 ryControls.Controls.RichTextBox2..ctor() 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\ryControls\Controls\RichTextBox2.cs:行号 45 - 在 Itrycn_Project2.FrmStart.InitializeComponent() 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\Itrycn_Project2\FrmStart.Designer.cs:行号 46 - 在 Itrycn_Project2.FrmStart..ctor(String[] args) 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\Itrycn_Project2\FrmStart.cs:行号 20 - 在 Itrycn_Project2.Program.Main(String[] args) 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\Itrycn_Project2\Program.cs:行号 36 +异常堆栈： 在 System.Drawing.Icon.Initialize(Int32 width, Int32 height) + 在 ryCommon.RyImage.ConvertPNGToIcon(Bitmap input, Icon& icon, Int32 size, Boolean preserveAspectRatio) 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\MyDb\FileFuns\RyImage.cs:行号 1042 + 在 MGdu.WinFormUI.GMForm.set_GMFormIcon(Image value) 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\ryControls\Gdu.WinFormUI\Forms\GMForm.cs:行号 378 + 在 Itrycn_Project2.FrmStart.InitializeComponent() 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\Itrycn_Project2\FrmStart.Designer.cs:行号 243 + 在 Itrycn_Project2.FrmStart..ctor(String[] args) 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\Itrycn_Project2\FrmStart.cs:行号 25 + 在 Itrycn_Project2.Config.Init.Show(String[] args) 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\Itrycn_Project2\Config\Init.cs:行号 24 + 在 Itrycn_Project2.Program.Main(String[] args) 位置 E:\My Datas\毕方项目\C#\睿元公用控件组\Source\Itrycn_Project2\Program.cs:行号 30 -异常方法：Void .ctor() \ No newline at end of file +异常方法：Void Initialize(Int32, Int32) \ No newline at end of file diff --git a/Bin/Debug/CommonControls/.NET4/MyDb.dll b/Bin/Debug/CommonControls/.NET4/MyDb.dll deleted file mode 100644 index 45845a5..0000000 Binary files a/Bin/Debug/CommonControls/.NET4/MyDb.dll and /dev/null differ diff --git a/Bin/Debug/CommonControls/.NET4/MyDb.xml b/Bin/Debug/CommonControls/.NET4/MyDb.xml deleted file mode 100644 index c3d0f9c..0000000 --- a/Bin/Debug/CommonControls/.NET4/MyDb.xml +++ /dev/null @@ -1,11616 +0,0 @@ - - - - MyDb - - - - - 基于XML实现的权限类 - - - - - 用户名 - - - - - 用户id - - - - - 密码 - - - - - 权限控制Id - - - - - 用户备注 - - - - - 是否是管理员权限 - - - - - 是否是超级管理员权限 - - - - - 设置权限 - - 权限名称 - 权限值 - 返回是否设置成功 - - - - 获取权限 - - 权限名称 - 默认权限值 - 返回权限值 - - - - 获取权限 - - 权限名称 - 返回权限值 - - - - 批量导入权限 - - 权限相关的内容 - 返回是否执行成功 - - - - 导出权限 - - 返回导出文本 - - - - 清除所有权限 - - 返回是否执行成功 - - - - 汉字转拼音静态类,包括功能全拼和缩写，方法全部是静态的 - - - - - 汉字的机内码数组 - - - - - 机内码对应的拼音数组 - - - - - 把汉字转换成拼音(全拼) - - 汉字字符串 - 转换后的拼音(全拼)字符串 - - - - 把汉字转换成拼音(全拼) - - 汉字字符串 - 转换后的拼音(全拼)字符串 - - - - 把汉字转换成拼音(首拼) - - 汉字字符串 - 转换后的拼音(首拼)字符串 - - - - 把汉字转换成拼音(全拼) - - 汉字字符串 - 用指定字符分隔 - 转换后的拼音(全拼)字符串 - - - - 汉字转拼音缩写 - - 要转换的汉字字符串 - 拼音缩写 - - - - 汉字转拼音缩写 (字符串) (小写) (空格间隔) - - 要转换的汉字字符串 - 拼音缩写 - - - - 汉字转拼音缩写 (大写) - - 要转换的汉字字符串 - 拼音缩写 - - - - 汉字转拼音缩写 (字符串)(大写)(空格间隔) - - 要转换的汉字字符串 - 拼音缩写 - - - - 取单个字符的拼音声母 - - 要转换的单个汉字 - 拼音声母 - - - - 取单个字符的拼音声母 - - 要转换的单个汉字 - 拼音声母 - - - - Ini操作类 - - - - - 写入Ini - - - - - - - - - - 获取Ini - - - - - - - - - - - - 声明INI文件的读操作函数 GetPrivateProfileString() - - - - - - - - - - - - 声明INI文件的读操作函数 GetPrivateProfileString() - - - - - - - - - - 声明INI文件的读操作函数 GetPrivateProfileString() - - - - - - - - - - - - 获取所有节点名称(Section) - - 存放节点名称的内存地址,每个节点之间用\0分隔 - 内存大小(characters) - Ini文件 - 内容的实际长度,为0表示没有内容,为nSize-2表示内存大小不够 - - - - 编码 - - - - - Ini操作类 - - - - - - 根据section取所有key和值 - - - - - - - 读取INI文件中指定INI文件中的所有节点名称(Section) - - 所有节点,没有内容返回string[0] - - - - 读取INI文件 - - 段，格式[] - 键 - 返回byte类型的section组或键值组 - - - - 根据section取所有key - - - - - - - 写入ini - - - - - - - - 写入ini - - - - - - - - 写入ini - - - - - - - - 写入ini - - - - - - - - 写入ini - - - - - - - - 写入Ini - - - - - - - - 读取Ini - - - - - - - - 读取Ini - - - - - - - - - 读取Ini - - - - - - - - - 读取Ini - - - - - - - - - - - 写入ini - - - - - - - - - 删除Ini的Key - - - - - - - 删除Ini节点 - - - - - - 控件信息 - - - - - id - - - - - 控件对象 - - - - - 控件值类型 - - - - - 默认值 - - - - - 值类型 - - - - - 默认 - - - - - 取列表顺序值 - - - - - 取当前选择的列表值 - - - - - 取对象值 - - - - - 保存的设置类型 - - - - - Ini - - - - - XML - - - - - 对象值 - - - - - 显示的文本 - - - - - 图片序号 - - - - - id - - - - - Tag值 - - - - - 显示文本值 - - - - - - 星期数据 - - - - - 一周的开始时间 - - - - - 一周的结束时间 - - - - - XML操作类 - - - - - XML操作类 - - - - - 从XML文本中加载数据 - - - - - - 从指定的XML文本中加载 - - XML文本 - 如为1，表示加载成功，为0为失败 - - - - 载入空的XML文档 - - 如为1，表示加载成功，为0为失败 - - - - 从指定的文件中加载 - - XML文件路径 - 如为1，表示加载成功，为0为失败 - - - - 保存到指定文件中 - - 文件路径 - 如为1，表示保存成功，为0为失败 - - - - 判断节点是否存在 - - 属性名 - 属性值 - 返回1，表示存在，其它表示不存在 - - - - 定位节点 - - 属性名 - 属性值 - 返回第一个符合要求的结果 - - - - 定位节点,如果找不到节点，就新建一个节点 - - 属性名 - 属性值 - 返回第一个符合要求的结果 - - - - 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 - - 返回第一个符合要求的结果 - - - - 定位设置节点 - - 返回第一个符合要求的结果 - - - - 在节点后插入数据 - - - - - - - 在节点前插入数据 - - - - - - - 获取节点数量 - - 属性名 - 属性值 - 返回符合要求的结果数量 - - - - 获取节点数量 - - 返回符合要求的结果数量 - - - - 获取节点数量 - - 属性名 - 属性值 - - - - 返回符合要求的结果数量 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 读取指定节点的值(string) - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 获取属性值 - - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 读取所有的节点名称 - - - - - - 读取指定节点的值(string) - - - - - - - - 读取指定节点的值(int) - - - - - - - - 读取指定节点的值(decimal) - - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 获取XML文件的根元素 - - - - - 获取所有列表 - - 如为1，表示获取成功，为0为失败 - - - - 获取所有列表 - - 如为1，表示获取成功，为0为失败 - - - - 新增节点 - - - - - - - - 新增节点并定位到新节点 - - - - - - - - 新增设置节点并定位 - - - - - - 在指定节点前新增节点并定位到新节点 - - - - - - - - - 获取当前节点 - - - - - - 删除节点 - - - - - - 获取XML文本 - - - - - - 获取XML文本 - - - - - - 获取文本 - - - - - - 获取文本 - - - - - - 字符串操作类 - - - - - 字符串转Base64 - - - - - - - Base64转字符串 - - - - - - - 转换指定字符串为布尔类型 - - - - - 转换指定字符串为Double类型 - - - - - 已重载.计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. - - 第一个日期和时间 - 第二个日期和时间 - - - - - 已重载.计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. - - 一个日期和时间 - - - - - 转换指定字符串为Int类型 - - - - - 转换指定字符串为Int类型 - - - - - 转换指定布尔类型为Int类型,true为1，false为0 - - - - - 判断指定字符串是否是布尔类型 - - - - - 判断指定字符串是否是Double类型 - - - - - 判断指定字符串是否是Int类型 - - - - - 根据年月日转换成日期 - - - - - - - - - 追加字符 - - - - - 获取2个字符串中间的内容,point1为空表示从首位开始算，point2为空表示算到结尾。 - - - - - 判断字符串是否只包含数字或英文 - - - - - - - 判断字符串是否只包含英文 - - - - - - - 判断字符串是否只包含数字 - - - - - - - 判断字符串是否匹配,支持?*通配符 - - 待匹配的字符串 - 匹配的通配符 - - - - - 通配符替换 - - - - - - - - - 支持忽略大小写的替换功能 - - - - - 是否忽略大小写 - - - - - 获取匹配的内容 - - - - - - - - - 文件时间 - - - - - 创建时间 - - - - - 最后修改时间 - - - - - 访问时间 - - - - - 图片类型 - - - - - Bmp图片 - - - - - Jpeg图片 - - - - - Png图片 - - - - - Gif动态图片 - - - - - Tiff图片 - - - - - 对变量的拓展 - - - - - 替换文本(忽略大小写) - - - 需要替换的内容 - 替换后的内容 - - - - - 替换文本(忽略大小写),可支持通配符 - - - - - 是否是通配符表达式,不是，则普通替换，忽略大小写，是，则启用通配符替换 - - - - - 支持忽略大小写的替换文本功能 - - - - - 是否忽略大小写 - - - - - 获取符合要求的第一个结果 - - - - 是否是正则 - - - - - 查找字符串,忽略大小写 - - - - - - - - - 查找字符串,忽略大小写 - - - - - - - - 判断字符串是否是数字或英文 - - - - - - - 判断字符串是否是英文 - - - - - - - 判断字符串是否是数字(不同于IsInt,本函数是判断字符串是否只含有数字,对字符串长度没有限制) - - - - - - - 是否在指定范围内 - - - - - - - - - 是否在指定范围内 - - - - - - - - - 转换指定字符串为Int类型 - - - 最小值 - 最大值 - 如果字符串不在范围内，则使用本默认值 - - - - - 转换指定布尔类型到Int类型,true为1，false为0 - - - - - - - 将指定类型转换成整型 - - - - - - - - 将数字转换成字符串,小数点末尾后面不包含0 - - - - - - - 将数字转换成字符串,小数点末尾后面不包含0 - - - - - - - - 将数字转换成字符串,小数点末尾后面不包含0 - - - - - - - 将数字转换成字符串,小数点末尾后面不包含0 - - - - - - - - 将指定类型转换成整型 - - - - - - - 将指定类型转换成长整型,如果时间时间类型,则转换为Unix时间戳 - - - - - - - - 转换为Unix时间戳 - - - - - - - 转换为Js时间戳 - - - - - - - 转换为Unix时间戳 - - - - - - - 将指定类型转换成长整型 - - - - - - - 转换指定类型为Double类型 - - - - - - - - 转换指定类型为Double类型 - - - - - - - 判断时间是否在指定时间上 - - - - - - - - - 判断时间是否在指定时间上 - - - - - - - - - - 判断时间是否在指定日期 - - - - - - - - - 判断时间是否在指定日期 - - - - - - - - - - 转换DateTime类型到日期时间字符串(例如 2000-01-01 08:08:08) - - - - - - - 转换DateTime类型到日期字符串(例如 2000-01-01) - - - - - - - 转换DateTime类型到日期星期字符串(例如 2000-01-01 星期六) - - - - - - - 转换DateTime类型到Unix时间戳 - - - - - - - 转换Unix时间戳到DateTime类型 - - - - - - - 判断字符串是否与内容匹配 - - - - - - - - 将变量值转换成Double类型,如果不在指定区域范围内，则使用默认值 - - - - - - - - - - 转换到文件大小字符串 - - - - - - - 转换到文件大小字符串 - - - - - - - 转换指定类型为Decimal类型 - - - - - - - - 将变量值转换成Decimal类型 - - - - - - - 将变量值转换成Decimal类型,如果不在指定区域范围内，则使用默认值 - - - - - - - - - - 转换指定类型为DateTime类型 - - - - - - - - 将变量值转换成DateTime类型 - - - - - - - 转换指定类型为布尔类型 - - - - - - - 追加字符 - - - - - - - - 获取指定字符串之间的内容 - - - - - - - - - 获取指定字符串之间的内容 - - - - - - - - - - - - 判断指定字符串是否是Int类型 - - - - - - - 判断指定字符串是否是Double类型 - - - - - - - 判断是否是布尔类型 - - - - - - - 将字符串转换为Base64类型 - - - - - - - 判断字符串是否在指定长度 - - - - - - - - - 判断能否转换成日期格式 - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 文件信息 - - - - - 获取版本号 - - - - - 获取版本号 - - - - - - - 根据版本字符串输出double类型的版本号 - - - - - - - - 比较两个版本号大小 - - - - oldVer小于newVer,返回1,大于则返回-1,相等返回0 - - - - 比较版本号 - - - - - - old小于new,返回1,大于则返回-1,相等返回0 - - - - 判断是否是管理员方式运行 - - - - - - 大文件与批量文件操作类,支持中途取消操作,本类需要实例化操作 - - - - - 传输进度 - - 当前传输完成的值 - 全部值,为-1表示无法获取 - 当前传输的百分比,为-1表示无法获取 - - - - 传输进度 - - - - - 取消事件 - - - - - 大文件按流复制文件,支持自动创建目标文件夹。 true：复制成功 false：复制失败 - - 原始文件路径 - 复制目标文件路径 - - - - - 复制文件夹到目标文件夹,不支持进度事件,支持中途取消 - - 源文件夹 - 目标文件夹 - 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 - - - - 复制文件夹到目标文件夹,支持进度事件,支持中途取消 - - 源文件夹 - 目标文件夹 - 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 - - - - 复制文件夹到目标文件夹,支持中途取消 - - 源文件夹 - 目标文件夹 - 初始的文件数量 - 总数量,如果不计算,则使用-1 - 操作的数量,包含成功的和失败的 - 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 - - - - 获取文件夹中的文件数量 - - 文件夹路径 - 返回文件数量,中途取消则返回-1 - - - - 获取文件夹的大小 - - 文件夹路径 - 返回文件数量,中途取消则返回-1 - - - - 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) - - 要添加的文件路径 - 要添加到的文件夹 - 是否根据时间进行重命名 - 返回是否成功执行 - 成功执行则返回路径，否则返回空 - - - - Hosts操作类 - - - - - 获取并转换hosts内容 - - hosts内容 - - - - - 获取hosts并转换hosts内容 - - - - - - 追加内容到hosts里 - - 要追加的内容列表，每一行为ip 域名的格式 - 0表示无需新增,-1表示添加失败,1表示追加成功 - - - - write为true,追加内容到hosts里;为false,判断是否需要追加 - - 要追加的内容列表，每一行为ip 域名的格式 - 是否要写入,如果为false,则只判断是否需要追加,而不写入Hosts文件 - 0表示无需新增,-1表示添加失败,1表示追加成功 - - - - 追加内容到hosts里 - - 要追加的内容 - 0表示无需新增,-1表示添加失败,1表示追加成功 - - - - 追加内容到hosts里 - - ip地址 - 域名 - 0表示无需新增,-1表示添加失败,1表示追加成功 - - - - 从hosts文件里删除内容 - - 要删除的内容 - 0表示无需删除,-1表示添加失败,1表示删除成功 - - - - 从hosts文件里删除内容 - - ip地址 - 域名 - 0表示无需删除,-1表示添加失败,1表示删除成功 - - - - Host信息 - - - - - IP - - - - - 域名 - - - - - 注释 - - - - - 是否要删除 - - - - - 音频播放类 - - - - - 临时音频文件 - - - - - 父窗口句柄 - - - - - 声音标签 - - - - play synchronously (default) - - - play asynchronously - - - silence (!default) if sound not found - - - pszSound points to a memory file - - - loop the sound until next sndPlaySound - - - don’t stop any currently playing sound - - - Stop Playing Wave - - - don’t wait if the driver is busy - - - name is a registry alias - - - alias is a predefined id - - - name is file name - - - name is resource name or atom - - - - 音频播放类 - - embedded music file - 临时保存的文件位置 - 父窗口句柄 - - - - 音频播放类 - - 要播放的音频位置 - 父窗口句柄 - - - - 音频播放类 - - - 父窗口句柄 - - - - 播放音频 - - - - - - 播放音频 - - - - - 关闭音频 - - - - - 文件操作类 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 删除单个文件。 - - 删除的文件名 - 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 - 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 - 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 - 反馈错误消息的字符串 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 删除单个文件。 - - 删除的文件名 - 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 永久删除单个文件。 - - 永久删除的文件名 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 删除一组文件。 - - 字符串数组，表示一组文件名 - 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 - 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 - 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 - 反馈错误消息的字符串 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 移动文件到指定路径下 - - 要移动的文件名 - 移动到的目的路径 - - - - - 移动一个文件到指定路径下 - - 要移动的文件名 - 移动到的目的路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 反馈错误消息的字符串 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 - - - - 移动一组文件到指定的路径下 - - 要移动的文件名数组 - 移动到的目的路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 反馈错误消息的字符串 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 - - - - 复制文件到指定的文件名或路径 - - 要复制的文件名 - 复制到的目的文件名或路径 - - - - - 复制文件到指定的文件名或路径 - - 要复制的文件名 - 复制到的目的文件名或路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 返回错误信息 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 - - - - 复制一组文件到指定的路径 - - 要复制的文件名数组 - 复制到的目的路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 返回错误信息 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 - - - - 大文件多次复制文件 true：复制成功 false：复制失败 - - 原始文件路径 - 复制目标文件路径 - - - - - 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) - - 源文件夹 - 目标文件夹 - 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 - - - - 重命名一个文件为新名称，建议您使用更方便的Microsoft.VisualBasic.FileSystem.ReName();替换该方法 - - 要复制的文件名 - 复制到的目的文件名或路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 返回错误信息 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 - - - - 删除单个或多个文件 - - 删除的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 - 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 - 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 - 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 - 反馈错误消息的字符串 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 移动或复制一个或多个文件到指定路径下 - - 操作类型，是移动操作还是复制操作 - 要移动或复制的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 - 移动到的目的位置 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 反馈错误消息的字符串 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 - - - - 如果指定文件夹不存在，则创建文件夹 - - - - - - 获取一个文件的全名 - - 文件名 - 返回生成文件的完整路径名 - - - - 获取一个文件的全名 - - 文件名 - 返回生成文件的完整路径名 - - - - 解释错误代码 - - 代码号 - 返回关于错误代码的文字描述 - - - - 运行文件 - - - - - - - - /运行文件 - - - - - - - - - 运行程序 - - - - - - - 打开文件 - - - - - - - 打开文件夹并定位文件 - - - - - - - 打开网址 - - - - - - - 判断文件名是否有效 - - - - - - - 转换到有效文件名 - - - - - - - 追加日志 - - - - - - - 追加文件 - - - - - - - 读取文件内容,可以自动识别文件编码 - - - - - - - 读取文件内容,可以自动识别文件编码 - - - - - - - - 读取文件所有行,可以自动识别文件编码 - - - - - - - 读取文件所有行,可以自动识别文件编码 - - - - - - - - 写入所有文本行到文件,如果文件夹不存在，会自动创建 - - - - - - - - 写入所有文本到文件,如果文件夹不存在，会自动创建 - - - - - - - - 从文件中加载图片,使用本方法，不会导致图片文件被占用。 - - - - - - 获取文件大小 - - - - - - - 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) - - 要添加的文件路径 - 要添加到的文件夹 - 是否根据时间进行重命名 - 返回是否成功执行 - 成功执行则返回路径，否则返回空 - - - - 获取文件大小字符串 - - - - - - - 获取文件大小字符串 - - - - - - - 复制内容到剪切板 - - - - - - 添加某个控件为支持拖放属性 - - - - - - - 使管理员方式运行时支持拖放 - - - - - - - 保存高质量不失真照片 - - - - - - - - 保存高质量不失真照片 - - - - - - - - 保存高质量不失真照片 - - - - - - - - 保存高质量不失真照片 - - - - - - - 保存高质量不失真照片 - - - - - - - 获取绝对路径 - - - - - - - 获取相对路径 - - - - - - - 获取图标 - - - - - - - - - - - - - - 销毁图标 - - - - - - - 获取文件图标 - - - - - - - - - - 用于取得一个文本文件的编码方式(Encoding)。 - - - - - 用于取得一个文本文件的编码方式(Encoding)。 - - - - - 取得一个文本文件的编码方式。如果无法在文件头部找到有效的前导符，Encoding.Default将被返回。 - - 文件名。 - - - - - 取得一个文本文件流的编码方式。 - - 文本文件流。 - - - - - 取得一个文本文件的编码方式。 - - 文件名。 - 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 - - - - - 取得一个文本文件流的编码方式。 - - 文本文件流。 - 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 - - - - - 通过给定的文件流，判断文件的编码类型 - - 文件流 - 文件的编码类型 - - - - 判断是否是不带 BOM 的 UTF8 格式 - - - - - - - 数据库操作扩展 - - - - - 判断DataSet是否包含数据 - - - - - - - 获取首行数据,如果没有数据,则返回null - - - - - - - 获取第一行第一列的值 - - - - - - - 获取第一张表的指定行数据 - - - 指定第几行 - - - - - 对鼠标或键盘的自动化操作 - - - - - 鼠标左键 - - - - - 鼠标中键 - - - - - 鼠标右键 - - - - - 模拟键盘按键 - - - - 按下还是抬起 - - - - 鼠标滚轮 - - - - - - - - 鼠标移动 - - - - - - - - 自定义鼠标按下或抬起 - - - - - - - - - 左键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标x(句柄内的坐标,非屏幕坐标) - 坐标y(句柄内的坐标,非屏幕坐标) - - - - 左键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标(句柄内的坐标,非屏幕坐标) - - - - 右键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标x(句柄内的坐标,非屏幕坐标) - 坐标y(句柄内的坐标,非屏幕坐标) - - - - 右键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标(句柄内的坐标,非屏幕坐标) - - - - 中键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标x(句柄内的坐标,非屏幕坐标) - 坐标y(句柄内的坐标,非屏幕坐标) - - - - 中键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标(句柄内的坐标,非屏幕坐标) - - - - 左键单击鼠标(不支持后台单击) - - 坐标x(屏幕坐标) - 坐标y(屏幕坐标) - - - - 左键单击鼠标(不支持后台单击) - - 坐标(屏幕坐标) - - - - 右键单击鼠标(不支持后台单击) - - 坐标x(屏幕坐标) - 坐标y(屏幕坐标) - - - - 右键单击鼠标(不支持后台单击) - - 坐标(屏幕坐标) - - - - 中键单击鼠标(不支持后台单击) - - 坐标x(屏幕坐标) - 坐标y(屏幕坐标) - - - - 中键单击鼠标(不支持后台单击) - - 坐标(屏幕坐标) - - - - 粘贴文本 - - - - - - 获取指定句柄的大小及位置 - - - - - - - - 设置指定句柄的大小 - - - - - - - 判断鼠标位置是不是在指定的矩形中 - - - - - - - - 判断2张图是否相似度超90 - - - - - - - - /获取2种颜色的相似度,范围为0~100 - - - - - - - - 新模态窗体 - - - - - 设置窗体返回的结果值，并关闭窗体。 - - 当前窗体 - 模态变量 - 防止 - - - - 窗体返回的结果事件 - - - - - - - 当打开的窗体返回结果时激发 - - - - - 窗体返回的状态 - - - - - 实例化类 - - 父窗体,如果为null,则取桌面为父窗体 - - - - - 获取最顶级的父窗口 - - - - - - 显示新模态窗体,会暂时禁用父窗体,关闭当前窗体后,父窗体会恢复。 - - - - - 只运行一个实例,打开后,所有窗体都依然有效。 - - - - - - 显示窗体 - - 显示的位置 - - - - 显示在父窗体中间 - - - - - 窗体显示位置 - - - - - 右上角 - - - - - 顶部中间 - - - - - 顶部右边 - - - - - 中间 - - - - - 左下角 - - - - - 底部中间 - - - - - 右下角 - - - - - 父窗体居中 - - - - - 运行库检测类 - - - - - 获取产品状态 - - - - - - - 判断是否已安装VC运行库 - - - - - - 判断是否已安装VC运行库 - - - - - - 安装状态 - - - - - 组件禁用 - - - - - 配置数据已损坏 - - - - - 安装已暂停或正在进行 - - - - - 从源运行，源不可用 - - - - - 返回缓冲区溢出 - - - - - 无效的参数传递给该函数。 - - - - - 不公布或者未安装该产品。 - - - - - 损坏 - - - - - 该产品已公布但尚未安装。 - - - - - 正在移除的组件（操作状态，不可设置） - - - - - 不同的用户安装该产品。 - - - - - 安装在本地驱动器上 - - - - - 从源代码、CD或网络运行 - - - - - 为当前用户安装该产品。 - - - - - 安装的版本,是x86还是x64，还是全部安装了 - - - - - 判断32位和64位运行库是否已安装 - - - - - 判断32位运行库是否已安装 - - - - - 判断64位运行库是否已安装 - - - - - 判断是否已安装VC2005运行库 - - - - - - 判断是否已安装VC2005SP1运行库 - - - - - - 判断是否已安装VC2008运行库 - - - - - - 判断是否已安装VC2008SP1运行库 - - - - - - 判断是否已安装VC2010运行库 - - - - - - 判断是否已安装VC2010SP1运行库 - - - - - - 判断是否已安装VC2012运行库 - - - - - - 判断是否已安装VC2013运行库 - - - - - - 判断是否已安装VC2015或以上运行库 - - - - - - 判断是否已安装VC2017运行库或以上运行库 - - - - - - 判断是否已安装VC2019运行库或以上运行库 - - - - - - 判断是否已安装VC2022运行库或以上运行库 - - - - - - 判断当前系统是否安装了WebView2组件 - - - - - - 判断当前系统是否安装了.NET 4.8 - - - - - - 日期时间的操作类 - - - - - 获取当前是周几,周一到周日，分别是1-7. - - - - - - - 获取当前是周几,1-7，分别是返回一到日. - - - - - - - 获取当前是周几,输入日期，根据周几，分别是返回一到日. - - - - - - - 获取一周的开始和结束,开始时间为第一天的0点，结束时间以最后一天的0点为结束时间 - - - - - - - 获取2个日期相差几周 - - - - - - - - 获取2个日期相差几个月 - - - - - - - - 获取一个月的开始 - - - - - - - 判断是否在同一个星期。 - - - - - - - - 判断是否在同一个月。 - - - - - - - - 判断是否在同一天 - - - - - - - - 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. - - 第一个日期和时间 - 第二个日期和时间 - - - - - 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. - - 第一个日期和时间 - 第二个日期和时间 - 是否显示秒 - - - - - 将秒数显示成中文表达式 - - - - - - - 计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. - - 一个日期和时间 - - - - - 将c# DateTime时间格式转换为Unix时间戳格式 - - 时间 - long - - - - 时间戳转为C#格式时间 - - - - - - - 时间戳转为C#格式时间 - - - - - - - 将c# DateTime时间格式转换为js时间戳格式 - - 时间 - long - - - - JS时间戳转为C#格式时间 - - - - - - - JS时间戳转为C#格式时间 - - - - - - - 根据年月日转换成日期 - - - - - - - - - 根据日期和时间转换成日期时间 - - - - - - - - 将时间转换成当前分钟开始的时间 - - - - - - - 将时间转换成当前秒钟开始的时间 - - - - - - - 当前时间在这一天里的秒数 - - - - - - - 窗体操作类 - - - - - 设置Comobox的行间距 - - - - - - - 移除关闭按钮。返回值，非零表示成功，零表示失败。 - - 窗口的句柄 - 是否成功 - - - - 把窗体放到最前 - - - - - - 显示窗体 - - - - - - - - 设置窗体是否置顶 - - - - - - - 显示没有焦点的窗口 - - - - - - 根据句柄获取窗口文本 - - - - - - - 根据句柄获取窗口类 - - - - - - - 获取当前活动的窗口句柄 - - - - - - 获取当前前台的窗口句柄 - - - - - - 设置为当前活动窗口 - - - - - - - 根据窗口句柄来获得进程id - - - - - - - 显示窗体 - - - - - - 设置窗体父窗体为桌面,不会随着显示桌面而最小化,但无法设置窗体透明度 - - - - - - 结束进程 - - - - - - - 打开窗体,只打开一个实例(非模态) - - - - - - - 将窗体植入到容器控件中 - - - 作为窗体容器的控件 - - - - - 重新调整窗体大小以适配容器大小 - - - 作为窗体容器的控件 - - - - - 设置注册表操作,部分功能需要管理员权限 - - - - - 访问的注册表位置(64位还是32位) - - - - - 访问的注册表节点 - - - - - 判断注册表项是否存在 - - - - - - - - - 删除注册表键(如果存在子键,子键将一并被删除) - - - - - - - - - - 删除注册表键值 - - - - - - - - - - 获取注册表键值 - - - - - - - - - - - 设置注册表键值 - - - - - - - - - - - 设置注册表键值 - - - - - - - - - - - 设置是否开机启动 - - 是否开机启动 - 开机启动名称 - 启动命令 - - - - - 设置是否开机启动 - - 是否开机启动 - 开机启动名称 - - - - - 把指定文件设置为开机启动或取消开机启动 - - 是否开机启动 - 开机启动名称 - 要开机启动的文件路径 - - - - - 检查是否开机启动 - - 开机启动名称 - 开机启动命令 - - - - - 检查是否开机启动 - - 开机启动名称 - - - - - 判断指定文件是否是开机启动 - - 开机启动名称 - 文件路径 - - - - - 判断当前程序是否是开机启动 - - 开机启动名称 - - - - - 判断当前程序是否是开机启动 - - 开机启动名称 - 启动命令行 - - - - - 设置指定文件的浏览器控件内核版本 - - 文件名，要求不带路径 - 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - 设置文件关联 - - 扩展名(如.apk) - 映射的扩展名(如apkfile) - app名称(建议用英文数字) - 文件关联描述 - 文件路径 - - - - 设置文件关联 - - 映射的扩展名(如apkfile) - app名称(建议用英文数字) - 文件关联描述 - 文件路径 - - - - 在指定文件格式右键菜单中增加菜单 - - 扩展名(如.apk) - app名称(建议用英文数字) - 文件关联描述 - 文件路径 - - - - 删除文件关联 - - 映射的扩展名(如apkfile) - app名称(建议用英文数字) - - - - 获取文件关联是否存在 - - 映射的扩展名(如apkfile) - app名称(建议用英文数字) - - - - 采用的IE模式 - - - - - IE7兼容视图 - - - - - IE8 标准模式 - - - - - IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - IE9 标准模式 - - - - - IE9 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - IE10 标准模式 - - - - - IE10 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - 设置当前软件的浏览器控件内核版本 - - 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - 设置指定文件的浏览器控件内核版本 - - 文件名，要求不带路径 - IE内核版本 - - - - - 设置当前软件的浏览器控件内核版本 - - IE内核版本 - - - - - 系统函数 - - - - - - - - - - 红 - - - - - 绿 - - - - - 蓝 - - - - - 获取屏幕伽马值 - - - - - - - - 设置屏幕伽马值 - - - - - - - - 获取键盘和鼠标没有操作的时间 - - - - - - 设置屏幕 Gamma值 - - - - - - - - - 设置屏幕亮度 - - - - - - - 获取系统名称,注意需要在app.manifest文件中设置兼容win10 - - - - - - 窗体操作类 - - - - - 构造函数 - - - - - - 析构 - - - - - 设置让窗体支持移动 - - - - - 是否允许可调节大小 - - - - - 可调节窗体大小的宽度 - - - - - - - - - - - - - - - - - - - - - - - 开始截图 - - 是否截取鼠标指针 - - - - - - - - - - 根据XPath来获取属性值 - - - - 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml - - - - - - 根据当前节点生成HtmlDocument - - - - - - - 根据XPath来获取属性值 - - - - 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml - - - - - - 根据XPath来查找节点 - - - - - - - - 在当前节点下根据xpath来查找符合的第一个节点 - - - - - - - - 在当前节点下根据xpath来查找所有符合的节点 - - - - - - - - A utility class to compute CRC32. - - - - - Compute a checksum for a given array of bytes. - - The array of bytes to compute the checksum for. - The computed checksum. - - - - Compute a checksum for a given string. - - The string to compute the checksum for. - The computed checksum. - - - - Represents an HTML attribute. - - - - - Gets the line number of this attribute in the document. - - - - - Gets the column number of this attribute in the document. - - - - - Gets the stream position of the value of this attribute in the document, relative to the start of the document. - - - - - Gets the length of the value. - - - - - - - - - - Gets the qualified name of the attribute. - - - - - Name of attribute with original case - - - - - Gets the HTML document to which this attribute belongs. - - - - - Gets the HTML node to which this attribute belongs. - - - - - Specifies what type of quote the data should be wrapped in - - - - - Specifies what type of quote the data should be wrapped in (internal to keep backward compatibility) - - - - - Gets the stream position of this attribute in the document, relative to the start of the document. - - - - - Gets or sets the value of the attribute. - - - - - Gets the DeEntitized value of the attribute. - - - - - Gets a valid XPath string that points to this Attribute - - - - - Compares the current instance with another attribute. Comparison is based on attributes' name. - - An attribute to compare with this instance. - A 32-bit signed integer that indicates the relative order of the names comparison. - - - - Creates a duplicate of this attribute. - - The cloned attribute. - - - - Removes this attribute from it's parents collection - - - - - An Enum representing different types of Quotes used for surrounding attribute values - - - - - A single quote mark ' - - - - - A double quote mark " - - - - - No quote mark - - - - - The initial value (current value) - - - - - Represents a combined list and collection of HTML nodes. - - - - - Gets the number of elements actually contained in the list. - - - - - Gets readonly status of colelction - - - - - Gets the attribute at the specified index. - - - - - Gets a given attribute from the list using its name. - - - - - Adds a new attribute to the collection with the given values - - - - - - - Adds supplied item to collection - - - - - Adds a range supplied items to collection. - An IEnumerable<HtmlAttribute> of items to append to this. - - - Adds a range supplied items to collection using a dictionary. - A Dictionary<string,string> of items to append to this. - - - - Explicit clear - - - - - Retreives existence of supplied item - - - - - - - Copies collection to array - - - - - - - Get Explicit enumerator - - - - - - Explicit non-generic enumerator - - - - - - Retrieves the index for the supplied item, -1 if not found - - - - - - - Inserts given item into collection at supplied index - - - - - - - Explicit collection remove - - - - - - - Removes the attribute at the specified index. - - The index of the attribute to remove. - - - - Inserts the specified attribute as the last attribute in the collection. - - The attribute to insert. May not be null. - The appended attribute. - - - - Creates and inserts a new attribute as the last attribute in the collection. - - The name of the attribute to insert. - The appended attribute. - - - - Creates and inserts a new attribute as the last attribute in the collection. - - The name of the attribute to insert. - The value of the attribute to insert. - The appended attribute. - - - - Checks for existance of attribute with given name - - - - - - - Inserts the specified attribute as the first node in the collection. - - The attribute to insert. May not be null. - The prepended attribute. - - - - Removes a given attribute from the list. - - The attribute to remove. May not be null. - - - - Removes an attribute from the list, using its name. If there are more than one attributes with this name, they will all be removed. - - The attribute's name. May not be null. - - - - Remove all attributes in the list. - - - - - Returns all attributes with specified name. Handles case insentivity - - Name of the attribute - - - - - Removes all attributes from the collection - - - - - Clears the attribute collection - - - - - Represents an HTML comment. - - - - - Gets or Sets the comment text of the node. - - - - - Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. - - - - - Gets or Sets the object and its content in HTML. - - - - - Represents a complete HTML document. - - - - True to disable, false to enable the behavior tag p. - - - Default builder to use in the HtmlDocument constructor - - - Action to execute before the Parse is executed - - - - Defines the max level we would go deep into the html document - - - - The HtmlDocument Text. Careful if you modify it. - - - True to stay backward compatible with previous version of HAP. This option does not guarantee 100% compatibility. - - - - Adds Debugging attributes to node. Default is false. - - - - - Defines if closing for non closed nodes must be done at the end or directly in the document. - Setting this to true can actually change how browsers render the page. Default is false. - - - - - Defines if non closed nodes will be checked at the end of parsing. Default is true. - - - - - Defines if a checksum must be computed for the document while parsing. Default is false. - - - - - Defines if SelectNodes method will return null or empty collection when no node matched the XPath expression. - Setting this to true will return empty collection and false will return null. Default is false. - - - - True to disable, false to enable the server side code. - - - - Defines the default stream encoding to use. Default is System.Text.Encoding.Default. - - - - - Force to take the original comment instead of creating it - - - - - Defines if source text must be extracted while parsing errors. - If the document has a lot of errors, or cascading errors, parsing performance can be dramatically affected if set to true. - Default is false. - - - - - Defines the maximum length of source text or parse errors. Default is 100. - - - - - Defines if LI, TR, TH, TD tags must be partially fixed when nesting errors are detected. Default is false. - - - - - Defines if output must conform to XML, instead of HTML. Default is false. - - - - - If used together with and enabled, Xml namespaces in element names are preserved. Default is false. - - - - - Defines if attribute value output must be optimized (not bound with double quotes if it is possible). Default is false. - - - - Defines the global attribute value quote. When specified, it will always win. - - - - Defines if name must be output with it's original case. Useful for asp.net tags and attributes. Default is false. - - - - - Defines if name must be output in uppercase. Default is false. - - - - - Defines if declared encoding must be read from the document. - Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node. - Default is true. - - - - - Defines the name of a node that will throw the StopperNodeException when found as an end node. Default is null. - - - - - Defines if the 'id' attribute must be specifically used. Default is true. - - - - - Defines if empty nodes must be written as closed during output. Default is false. - - - - - The max number of nested child nodes. - Added to prevent stackoverflow problem when a page has tens of thousands of opening html tags with no closing tags - - - - - Creates an instance of an HTML document. - - - - Gets the parsed text. - The parsed text. - - - - Defines the max level we would go deep into the html document. If this depth level is exceeded, and exception is - thrown. - - - - - Gets the document CRC32 checksum if OptionComputeChecksum was set to true before parsing, 0 otherwise. - - - - - Gets the document's declared encoding. - Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node (pre-HTML5) or the meta charset="XXXXX" html node (HTML5). - - - - - Gets the root node of the document. - - - - - Gets the document's output encoding. - - - - - Gets a list of parse errors found in the document. - - - - - Gets the remaining text. - Will always be null if OptionStopperNodeName is null. - - - - - Gets the offset of Remainder in the original Html text. - If OptionStopperNodeName is null, this will return the length of the original Html text. - - - - - Gets the document's stream encoding. - - - - - Gets a valid XML name. - - Any text. - A string that is a valid XML name. - - - - - - - - - - - - - - - - - - - Applies HTML encoding to a specified string. - - The input string to encode. May not be null. - The encoded string. - - - - Determines if the specified character is considered as a whitespace character. - - The character to check. - true if if the specified character is considered as a whitespace character. - - - - Creates an HTML attribute with the specified name. - - The name of the attribute. May not be null. - The new HTML attribute. - - - - Creates an HTML attribute with the specified name. - - The name of the attribute. May not be null. - The value of the attribute. - The new HTML attribute. - - - - Creates an HTML comment node. - - The new HTML comment node. - - - - Creates an HTML comment node with the specified comment text. - - The comment text. May not be null. - The new HTML comment node. - - - - Creates an HTML element node with the specified name. - - The qualified name of the element. May not be null. - The new HTML node. - - - - Creates an HTML text node. - - The new HTML text node. - - - - Creates an HTML text node with the specified text. - - The text of the node. May not be null. - The new HTML text node. - - - - Detects the encoding of an HTML stream. - - The input stream. May not be null. - The detected encoding. - - - - Detects the encoding of an HTML stream. - - The input stream. May not be null. - The html is checked. - The detected encoding. - - - - Detects the encoding of an HTML text provided on a TextReader. - - The TextReader used to feed the HTML. May not be null. - The detected encoding. - - - - Detects the encoding of an HTML text. - - The input html text. May not be null. - The detected encoding. - - - - Gets the HTML node with the specified 'id' attribute value. - - The attribute id to match. May not be null. - The HTML node with the matching id or null if not found. - - - - Loads an HTML document from a stream. - - The input stream. - - - - Loads an HTML document from a stream. - - The input stream. - Indicates whether to look for byte order marks at the beginning of the stream. - - - - Loads an HTML document from a stream. - - The input stream. - The character encoding to use. - - - - Loads an HTML document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the stream. - - - - Loads an HTML document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the stream. - The minimum buffer size. - - - - Loads the HTML document from the specified TextReader. - - The TextReader used to feed the HTML data into the document. May not be null. - - - - Loads the HTML document from the specified string. - - String containing the HTML document to load. May not be null. - - - - Saves the HTML document to the specified stream. - - The stream to which you want to save. - - - - Saves the HTML document to the specified stream. - - The stream to which you want to save. May not be null. - The character encoding to use. May not be null. - - - - Saves the HTML document to the specified StreamWriter. - - The StreamWriter to which you want to save. - - - - Saves the HTML document to the specified TextWriter. - - The TextWriter to which you want to save. May not be null. - - - - Saves the HTML document to the specified XmlWriter. - - The XmlWriter to which you want to save. - - - - Detects the encoding of an HTML document from a file first, and then loads the file. - - The complete file path to be read. - - - - Detects the encoding of an HTML document from a file first, and then loads the file. - - The complete file path to be read. May not be null. - true to detect encoding, false otherwise. - - - - Detects the encoding of an HTML file. - - Path for the file containing the HTML document to detect. May not be null. - The detected encoding. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - The character encoding to use. May not be null. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - The character encoding to use. May not be null. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - The character encoding to use. May not be null. - Indicates whether to look for byte order marks at the beginning of the file. - The minimum buffer size. - - - - Saves the mixed document to the specified file. - - The location of the file where you want to save the document. - - - - Saves the mixed document to the specified file. - - The location of the file where you want to save the document. May not be null. - The character encoding to use. May not be null. - - - - Creates a new XPathNavigator object for navigating this HTML document. - - An XPathNavigator object. The XPathNavigator is positioned on the root of the document. - - - - Flags that describe the behavior of an Element node. - - - - - The node is a CDATA node. - - - - - The node is empty. META or IMG are example of such nodes. - - - - - The node will automatically be closed during parsing. - - - - - The node can overlap. - - - - - A utility class to replace special characters by entities and vice-versa. - Follows HTML 4.0 specification found at http://www.w3.org/TR/html4/sgml/entities.html - Follows Additional specification found at https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references - See also: https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references - - - - - - - - - - A collection of entities indexed by name. - - - - - A collection of entities indexed by value. - - - - - Replace known entities by characters. - - The source text. - The result text. - - - - Clone and entitize an HtmlNode. This will affect attribute values and nodes' text. It will also entitize all child nodes. - - The node to entitize. - An entitized cloned node. - - - - Replace characters above 127 by entities. - - The source text. - The result text. - - - - Replace characters above 127 by entities. - - The source text. - If set to false, the function will not use known entities name. Default is true. - The result text. - - - - Replace characters above 127 by entities. - - The source text. - If set to false, the function will not use known entities name. Default is true. - If set to true, the [quote], [ampersand], [lower than] and [greather than] characters will be entitized. - The result text - - - - Represents an HTML node. - - - - - Gets the name of a comment node. It is actually defined as '#comment'. - - - - - Gets the name of the document node. It is actually defined as '#document'. - - - - - Gets the name of a text node. It is actually defined as '#text'. - - - - - Gets a collection of flags that define specific behaviors for specific element nodes. - The table contains a DictionaryEntry list with the lowercase tag name as the Key, and a combination of HtmlElementFlags as the Value. - - - - - Initialize HtmlNode. Builds a list of all tags that have special allowances - - - - - Initializes HtmlNode, providing type, owner and where it exists in a collection - - - - - - - - Gets the collection of HTML attributes for this node. May not be null. - - - - - Gets all the children of the node. - - - - - Gets a value indicating if this node has been closed or not. - - - - - Gets the collection of HTML attributes for the closing tag. May not be null. - - - - - Gets the closing tag of the node, null if the node is self-closing. - - - - - Gets the first child of the node. - - - - - Gets a value indicating whether the current node has any attributes. - - - - - Gets a value indicating whether this node has any child nodes. - - - - - Gets a value indicating whether the current node has any attributes on the closing tag. - - - - - Gets or sets the value of the 'id' HTML attribute. The document must have been parsed using the OptionUseIdAttribute set to true. - - - - - Gets or Sets the HTML between the start and end tags of the object. - - - - - Gets the text between the start and end tags of the object. - - - - Gets direct inner text. - The direct inner text. - - - - Gets the last child of the node. - - - - - Gets the line number of this node in the document. - - - - - Gets the column number of this node in the document. - - - - - Gets the stream position of the area between the opening and closing tag of the node, relative to the start of the document. - - - - - Gets the stream position of the area of the beginning of the tag, relative to the start of the document. - - - - - Gets the length of the area between the opening and closing tag of the node. - - - - - Gets the length of the entire node, opening and closing tag included. - - - - - Gets or sets this node's name. - - - - - Gets the HTML node immediately following this element. - - - - - Gets the type of this node. - - - - - The original unaltered name of the tag - - - - - Gets or Sets the object and its content in HTML. - - - - - Gets the to which this node belongs. - - - - - Gets the parent of this node (for nodes that can have parents). - - - - - Gets the node immediately preceding this node. - - - - - Gets the stream position of this node in the document, relative to the start of the document. - - - - - Gets a valid XPath string that points to this node - - - - - The depth of the node relative to the opening root html element. This value is used to determine if a document has to many nested html nodes which can cause stack overflows - - - - - Determines if an element node can be kept overlapped. - - The name of the element node to check. May not be null. - true if the name is the name of an element node that can be kept overlapped, false otherwise. - - - - Creates an HTML node from a string representing literal HTML. - - The HTML text. - The newly created node instance. - - - - Creates an HTML node from a string representing literal HTML. - - The HTML text. - The HTML Document builder. - The newly created node instance. - - - - Determines if an element node is a CDATA element node. - - The name of the element node to check. May not be null. - true if the name is the name of a CDATA element node, false otherwise. - - - - Determines if an element node is closed. - - The name of the element node to check. May not be null. - true if the name is the name of a closed element node, false otherwise. - - - - Determines if an element node is defined as empty. - - The name of the element node to check. May not be null. - true if the name is the name of an empty element node, false otherwise. - - - - Determines if a text corresponds to the closing tag of an node that can be kept overlapped. - - The text to check. May not be null. - true or false. - - - - Returns a collection of all ancestor nodes of this element. - - - - - - Get Ancestors with matching name - - - - - - - Returns a collection of all ancestor nodes of this element. - - - - - - Gets all anscestor nodes and the current node - - - - - - - Adds the specified node to the end of the list of children of this node. - - The node to add. May not be null. - The node added. - - - Sets child nodes identifier. - The chil node. - - - - Adds the specified node to the end of the list of children of this node. - - The node list to add. May not be null. - - - - Gets all Attributes with name - - - - - - - Creates a duplicate of the node - - - - - - Creates a duplicate of the node and changes its name at the same time. - - The new name of the cloned node. May not be null. - The cloned node. - - - - Creates a duplicate of the node and changes its name at the same time. - - The new name of the cloned node. May not be null. - true to recursively clone the subtree under the specified node; false to clone only the node itself. - The cloned node. - - - - Creates a duplicate of the node. - - true to recursively clone the subtree under the specified node; false to clone only the node itself. - The cloned node. - - - - Creates a duplicate of the node and the subtree under it. - - The node to duplicate. May not be null. - - - - Creates a duplicate of the node. - - The node to duplicate. May not be null. - true to recursively clone the subtree under the specified node, false to clone only the node itself. - - - - Gets all Descendant nodes for this node and each of child nodes - - The depth level of the node to parse in the html tree - the current element as an HtmlNode - - - - Returns a collection of all descendant nodes of this element, in document order - - - - - - Gets all Descendant nodes in enumerated list - - - - - - Gets all Descendant nodes in enumerated list - - - - - - Get all descendant nodes with matching name - - - - - - - Returns a collection of all descendant nodes of this element, in document order - - - - - - Gets all descendant nodes including this node - - - - - - - Gets first generation child node matching name - - - - - - - Gets matching first generation child nodes matching name - - - - - - Gets data attribute. - The key. - The data attribute. - - - Gets the data attributes in this collection. - - An enumerator that allows foreach to be used to process the data attributes in this - collection. - - - - Gets the attributes in this collection. - - An enumerator that allows foreach to be used to process the attributes in this collection. - - - - Gets the attributes in this collection. - A variable-length parameters list containing attribute names. - - An enumerator that allows foreach to be used to process the attributes in this collection. - - - - - Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. - - The name of the attribute to get. May not be null. - The default value to return if not found. - The value of the attribute if found, the default value if not found. - - - - Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. - - The name of the attribute to get. May not be null. - The default value to return if not found. - The value of the attribute if found, the default value if not found. - - - - Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. - - The name of the attribute to get. May not be null. - The default value to return if not found. - The value of the attribute if found, the default value if not found. - - - - Helper method to get the value of an attribute of this node. If the attribute is not found, - the default value will be returned. - - The name of the attribute to get. May not be null. - The default value to return if not found. - The value of the attribute if found, the default value if not found. - - - - Inserts the specified node immediately after the specified reference node. - - The node to insert. May not be null. - The node that is the reference node. The newNode is placed after the refNode. - The node being inserted. - - - - Inserts the specified node immediately before the specified reference node. - - The node to insert. May not be null. - The node that is the reference node. The newChild is placed before this node. - The node being inserted. - - - - Adds the specified node to the beginning of the list of children of this node. - - The node to add. May not be null. - The node added. - - - - Adds the specified node list to the beginning of the list of children of this node. - - The node list to add. May not be null. - - - - Removes node from parent collection - - - - - Removes all the children and/or attributes of the current node. - - - - - Removes all the children of the current node. - - - - Removes all id for node described by node. - The node. - - - Move a node already associated and append it to this node instead. - The child node to move. - - - Move a children collection already associated and append it to this node instead. - The children collection already associated to move to another node. - - - Removes the children collection for this node. - The old children collection to remove. - - - - Removes the specified child node. - - The node being removed. May not be null. - The node removed. - - - - Removes the specified child node. - - The node being removed. May not be null. - true to keep grand children of the node, false otherwise. - The node removed. - - - - Replaces the child node oldChild with newChild node. - - The new node to put in the child list. - The node being replaced in the list. - The node replaced. - - - - Helper method to set the value of an attribute of this node. If the attribute is not found, it will be created automatically. - - The name of the attribute to set. May not be null. - The value for the attribute. - The corresponding attribute instance. - - - - Saves all the children of the node to the specified TextWriter. - - The TextWriter to which you want to save. - Identifies the level we are in starting at root with 0 - - - - Saves all the children of the node to a string. - - The saved string. - - - - Saves the current node to the specified TextWriter. - - The TextWriter to which you want to save. - identifies the level we are in starting at root with 0 - - - - Saves the current node to the specified XmlWriter. - - The XmlWriter to which you want to save. - - - - Saves the current node to a string. - - The saved string. - - - - Sets the parent Html node and properly determines the current node's depth using the parent node's depth. - - - - - Adds one or more classes to this node. - - The node list to add. May not be null. - - - - Adds one or more classes to this node. - - The node list to add. May not be null. - true to throw Error if class name exists, false otherwise. - - - - Removes the class attribute from the node. - - - - - Removes the class attribute from the node. - - true to throw Error if class name doesn't exist, false otherwise. - - - - Removes the specified class from the node. - - The class being removed. May not be null. - - - - Removes the specified class from the node. - - The class being removed. May not be null. - true to throw Error if class name doesn't exist, false otherwise. - - - - Replaces the class name oldClass with newClass name. - - The new class name. - The class being replaced. - - - - Replaces the class name oldClass with newClass name. - - The new class name. - The class being replaced. - true to throw Error if class name doesn't exist, false otherwise. - - - Gets the CSS Class from the node. - - The CSS Class from the node - - - - Check if the node class has the parameter class. - The class. - True if node class has the parameter class, false if not. - - - - Fill an object and go through it's properties and fill them too. - - Type of object to want to fill. It should have atleast one property that defined XPath. - Returns an object of type T including Encapsulated data. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - - - - Fill an object and go through it's properties and fill them too. - - Type of object to want to fill. It should have atleast one property that defined XPath. - If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. - Returns an object of type T including Encapsulated data. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - - - - Fill an object and go through it's properties and fill them too. - - Type of object to want to fill. It should have atleast one property that defined XPath. - If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. - Returns an object of type targetType including Encapsulated data. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - - - - Creates a new XPathNavigator object for navigating this HTML node. - - An XPathNavigator object. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document. - - - - Creates an XPathNavigator using the root of this document. - - - - - - Selects a list of nodes matching the expression. - - The XPath expression. - An containing a collection of nodes matching the query, or null if no node matched the XPath expression. - - - - Selects a list of nodes matching the expression. - - The XPath expression. - An containing a collection of nodes matching the query, or null if no node matched the XPath expression. - - - - Selects the first XmlNode that matches the XPath expression. - - The XPath expression. May not be null. - The first that matches the XPath query or a null reference if no matching node was found. - - - - Selects a list of nodes matching the expression. - - The XPath expression. - An containing a collection of nodes matching the query, or null if no node matched the XPath expression. - - - - Includes tools that GetEncapsulatedData method uses them. - - - - - Determine if a type define an attribute or not , supporting both .NetStandard and .NetFramework2.0 - - Type you want to test it. - Attribute that type must have or not. - If true , The type parameter define attributeType parameter. - - - - Retrive properties of type that defined . - - Type that you want to find it's XPath-Defined properties. - IEnumerable of property infos of a type , that defined specific attribute. - - - - Determine if a has implemented BUT is considered as NONE-IEnumerable ! - - The property info you want to test. - True if property info is IEnumerable. - - - - Returns T type(first generic type) of or . - - IEnumerable-Implemented property - List of generic types. - - - - Find and Return a mehtod that defined in a class by it's name. - - Type of class include requested method. - Name of requested method as string. - Method info of requested method. - - - - Create of given type. - - Type that you want to make a List of it. - Returns IList of given type. - - - - Returns the part of value of you want as . - - A htmlNode instance. - Attribute that includes ReturnType - String that choosen from HtmlNode as result. - - - - Returns parts of values of you want as . - - that you want to retrive each value. - A instnce incules . - Type of IList generic you want. - - - - - Simulate Func method to use in Lambada Expression. - - - - - - - - - This method works like Where method in LINQ. - - - - - - - - - Check if the type can instantiated. - - - - - - - Returns count of elements stored in IEnumerable of T - - - - - - - - Specify which part of is requested. - - - - - The text between the start and end tags of the object. - - - - - The HTML between the start and end tags of the object - - - - - The object and its content in HTML - - - - - Just mark and flag classes to show they have properties that defined . - - - - - Includes XPath and . XPath for finding html tags and for specify which part of you want to return. - - - - - XPath Expression that is used to find related html node. - - - - - Html Attribute name - - - - - The methode of output - - - - - Specify Xpath to find related Html Node. - - - - - - Specify Xpath to find related Html Node. - - - Specify you want the output include html text too. - - - - Specify Xpath and Attribute to find related Html Node and its attribute value. - - - - - - - Tagging a property with this Attribute make Encapsulator to ignore that property if it causes an error. - - - - - Exception that often occures when there is no way to bind a XPath to a Html Tag. - - - - - - - - - - - - - - - - - - - - - - - Exception that often occures when there is no way to bind a XPath to a HtmlTag Attribute. - - - - - - - - - - - - - - - - - - - - - - - Exception that often occures when there is no property that assigned with XPath Property in Class. - - - - - - - - - - - - - - - - - - - - - - - Represents a combined list and collection of HTML nodes. - - - - - Initialize the HtmlNodeCollection with the base parent node - - The base node of the collection - - - Gets the parent node associated to the collection. - - - - Gets a given node from the list. - - - - - Get node with tag name - - - - - - - Gets the number of elements actually contained in the list. - - - - - Is collection read only - - - - - Gets the node at the specified index. - - - - - Add node to the collection - - - - - - Add node to the collection - - - - - - - Clears out the collection of HtmlNodes. Removes each nodes reference to parentnode, nextnode and prevnode - - - - - Gets existence of node in collection - - - - - - - Copy collection to array - - - - - - - Get Enumerator - - - - - - Get Explicit Enumerator - - - - - - Get index of node - - - - - - - Insert node at index - - - - - - - Remove node - - - - - - - Remove at index - - - - - - Get first instance of node in supplied collection - - - - - - - - Add node to the end of the collection - - - - - - Get first instance of node with name - - - - - - - Get index of node - - - - - - - Add node to the beginning of the collection - - - - - - Remove node at index - - - - - - - Replace node at index - - - - - - - Get all node descended from this collection - - - - - - Get all node descended from this collection with matching name - - - - - - Gets all first generation elements in collection - - - - - - Gets all first generation elements matching name - - - - - - - All first generation nodes in collection - - - - - - Represents an HTML navigator on an HTML document seen as a data store. - - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - Indicates whether to look for byte order marks at the beginning of the stream. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - The character encoding to use. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the stream. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the stream. - The minimum buffer size. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a TextReader. - - The TextReader used to feed the HTML data into the document. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - The character encoding to use. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - The minimum buffer size. - - - - Gets the base URI for the current node. - Always returns string.Empty in the case of HtmlNavigator implementation. - - - - - Gets the current HTML document. - - - - - Gets the current HTML node. - - - - - Gets a value indicating whether the current node has child nodes. - - - - - Gets a value indicating whether the current node has child nodes. - - - - - Gets a value indicating whether the current node is an empty element. - - - - - Gets the name of the current HTML node without the namespace prefix. - - - - - Gets the qualified name of the current node. - - - - - Gets the namespace URI (as defined in the W3C Namespace Specification) of the current node. - Always returns string.Empty in the case of HtmlNavigator implementation. - - - - - Gets the associated with this implementation. - - - - - Gets the type of the current node. - - - - - Gets the prefix associated with the current node. - Always returns string.Empty in the case of HtmlNavigator implementation. - - - - - Gets the text value of the current node. - - - - - Gets the xml:lang scope for the current node. - Always returns string.Empty in the case of HtmlNavigator implementation. - - - - - Creates a new HtmlNavigator positioned at the same node as this HtmlNavigator. - - A new HtmlNavigator object positioned at the same node as the original HtmlNavigator. - - - - Gets the value of the HTML attribute with the specified LocalName and NamespaceURI. - - The local name of the HTML attribute. - The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. - The value of the specified HTML attribute. String.Empty or null if a matching attribute is not found or if the navigator is not positioned on an element node. - - - - Returns the value of the namespace node corresponding to the specified local name. - Always returns string.Empty for the HtmlNavigator implementation. - - The local name of the namespace node. - Always returns string.Empty for the HtmlNavigator implementation. - - - - Determines whether the current HtmlNavigator is at the same position as the specified HtmlNavigator. - - The HtmlNavigator that you want to compare against. - true if the two navigators have the same position, otherwise, false. - - - - Moves to the same position as the specified HtmlNavigator. - - The HtmlNavigator positioned on the node that you want to move to. - true if successful, otherwise false. If false, the position of the navigator is unchanged. - - - - Moves to the HTML attribute with matching LocalName and NamespaceURI. - - The local name of the HTML attribute. - The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. - true if the HTML attribute is found, otherwise, false. If false, the position of the navigator does not change. - - - - Moves to the first sibling of the current node. - - true if the navigator is successful moving to the first sibling node, false if there is no first sibling or if the navigator is currently positioned on an attribute node. - - - - Moves to the first HTML attribute. - - true if the navigator is successful moving to the first HTML attribute, otherwise, false. - - - - Moves to the first child of the current node. - - true if there is a first child node, otherwise false. - - - - Moves the XPathNavigator to the first namespace node of the current element. - Always returns false for the HtmlNavigator implementation. - - An XPathNamespaceScope value describing the namespace scope. - Always returns false for the HtmlNavigator implementation. - - - - Moves to the node that has an attribute of type ID whose value matches the specified string. - - A string representing the ID value of the node to which you want to move. This argument does not need to be atomized. - true if the move was successful, otherwise false. If false, the position of the navigator is unchanged. - - - - Moves the XPathNavigator to the namespace node with the specified local name. - Always returns false for the HtmlNavigator implementation. - - The local name of the namespace node. - Always returns false for the HtmlNavigator implementation. - - - - Moves to the next sibling of the current node. - - true if the navigator is successful moving to the next sibling node, false if there are no more siblings or if the navigator is currently positioned on an attribute node. If false, the position of the navigator is unchanged. - - - - Moves to the next HTML attribute. - - - - - - Moves the XPathNavigator to the next namespace node. - Always returns falsefor the HtmlNavigator implementation. - - An XPathNamespaceScope value describing the namespace scope. - Always returns false for the HtmlNavigator implementation. - - - - Moves to the parent of the current node. - - true if there is a parent node, otherwise false. - - - - Moves to the previous sibling of the current node. - - true if the navigator is successful moving to the previous sibling node, false if there is no previous sibling or if the navigator is currently positioned on an attribute node. - - - - Moves to the root node to which the current node belongs. - - - - - Represents the type of a node. - - - - - The root of a document. - - - - - An HTML element. - - - - - An HTML comment. - - - - - A text node is always the child of an element or a document node. - - - - - Represents a parsing error found during document parsing. - - - - - Gets the type of error. - - - - - Gets the line number of this error in the document. - - - - - Gets the column number of this error in the document. - - - - - Gets a description for the error. - - - - - Gets the the full text of the line containing the error. - - - - - Gets the absolute stream position of this error in the document, relative to the start of the document. - - - - - Represents the type of parsing error. - - - - - A tag was not closed. - - - - - A tag was not opened. - - - - - There is a charset mismatch between stream and declared (META) encoding. - - - - - An end tag was not required. - - - - - An end tag is invalid at this position. - - - - - Represents an HTML text node. - - - - - Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. - - - - - Gets or Sets the object and its content in HTML. - - - - - Gets or Sets the text of the node. - - - - - A utility class to get HTML document from HTTP. - - - - - Represents the method that will handle the PostResponse event. - - - - - Represents the method that will handle the PreHandleDocument event. - - - - - Represents the method that will handle the PreRequest event. - - - - - Occurs after an HTTP request has been executed. - - - - - Occurs before an HTML document is handled. - - - - - Occurs before an HTTP request is executed. - - - - - Gets or Sets a value indicating if document encoding must be automatically detected. - - - - - Gets or sets the Encoding used to override the response stream from any web request - - - - - Gets or Sets a value indicating whether to get document only from the cache. - If this is set to true and document is not found in the cache, nothing will be loaded. - - - - - Gets or Sets a value indicating whether to get document from the cache if exists, otherwise from the web - A value indicating whether to get document from the cache if exists, otherwise from the web - - - - - Gets or Sets the cache path. If null, no caching mechanism will be used. - - - - - Gets a value indicating if the last document was retrieved from the cache. - - - - - Gets the last request duration in milliseconds. - - - - - Gets the URI of the Internet resource that actually responded to the request. - - - - - Gets the last request status. - - - - - Gets or Sets the size of the buffer used for memory operations. - - - - - Gets or Sets a value indicating if cookies will be stored. - - - - Gets or sets a value indicating whether redirect should be captured instead of the current location. - True if capture redirect, false if not. - - - - Gets or Sets the User Agent HTTP 1.1 header sent on any webrequest - - - - - Gets or Sets a value indicating whether the caching mechanisms should be used or not. - - - - - Gets the MIME content type for a given path extension. - - The input path extension. - The default content type to return if any error occurs. - The path extension's MIME content type. - - - - Gets the path extension for a given MIME content type. - - The input MIME content type. - The default path extension to return if any error occurs. - The MIME content type's path extension. - - - - Creates an instance of the given type from the specified Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The requested type. - An newly created instance. - - - - Gets an HTML document from an Internet resource and saves it to the specified file. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The location of the file where you want to save the document. - - - - Gets an HTML document from an Internet resource and saves it to the specified file. - Proxy aware - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The location of the file where you want to save the document. - - - - - - Gets an HTML document from an Internet resource and saves it to the specified file. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The location of the file where you want to save the document. - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - - - - Gets an HTML document from an Internet resource and saves it to the specified file. Understands Proxies - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The location of the file where you want to save the document. - - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - - - - - Gets the cache file path for a specified url. - - The url fo which to retrieve the cache path. May not be null. - The cache file path. - - - - Gets an HTML document from an Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - A new HTML document. - - - - Gets an HTML document from an Internet resource. - - The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). - A new HTML document. - - - - Gets an HTML document from an Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - Host to use for Proxy - Port the Proxy is on - User Id for Authentication - Password for Authentication - A new HTML document. - - - - Gets an HTML document from an Internet resource. - - The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). - Host to use for Proxy - Port the Proxy is on - User Id for Authentication - Password for Authentication - A new HTML document. - - - - Loads an HTML document from an Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - A new HTML document. - - - - Loads an HTML document from an Internet resource. - - The requested URL, such as new Uri("http://Myserver/Mypath/Myfile.asp"). - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - A new HTML document. - - - - Loads an HTML document from an Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - Proxy to use with this request - Credentials to use when authenticating - A new HTML document. - - - - Loads an HTML document from an Internet resource. - - The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - Proxy to use with this request - Credentials to use when authenticating - A new HTML document. - - - - Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The XmlTextWriter to which you want to save to. - - - Gets or sets the web browser timeout. - - - - Gets or sets the web browser delay. - - - Loads HTML using a WebBrowser and Application.DoEvents. - Thrown when an exception error condition occurs. - The requested URL, such as "http://html-agility-pack.net/". - A new HTML document. - - - Loads HTML using a WebBrowser and Application.DoEvents. - Thrown when an exception error condition occurs. - The requested URL, such as "http://html-agility-pack.net/". - (Optional) Check if the browser script has all been run and completed. - A new HTML document. - - - Loads HTML using a WebBrowser and Application.DoEvents. - Thrown when an exception error condition occurs. - The requested URL, such as "http://html-agility-pack.net/". - (Optional) Check if the browser script has all been run and completed. - A new HTML document. - - - - Creates an instance of the given type from the specified Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The URL that specifies the XSLT stylesheet to load. - An containing the namespace-qualified arguments used as input to the transform. - The requested type. - An newly created instance. - - - - Creates an instance of the given type from the specified Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The URL that specifies the XSLT stylesheet to load. - An containing the namespace-qualified arguments used as input to the transform. - The requested type. - A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. - An newly created instance. - - - - Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The URL that specifies the XSLT stylesheet to load. - An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. - The XmlTextWriter to which you want to save. - - - - Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". May not be null. - The URL that specifies the XSLT stylesheet to load. - An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. - The XmlTextWriter to which you want to save. - A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. - - - - Represents an exception thrown by the HtmlWeb utility class. - - - - - Creates an instance of the HtmlWebException. - - The exception's message. - - - - Represents a document with mixed code and text. ASP, ASPX, JSP, are good example of such documents. - - - - - Gets or sets the token representing code end. - - - - - Gets or sets the token representing code start. - - - - - Gets or sets the token representing code directive. - - - - - Gets or sets the token representing response write directive. - - - - - Creates a mixed code document instance. - - - - - Gets the code represented by the mixed code document seen as a template. - - - - - Gets the list of code fragments in the document. - - - - - Gets the list of all fragments in the document. - - - - - Gets the encoding of the stream used to read the document. - - - - - Gets the list of text fragments in the document. - - - - - Create a code fragment instances. - - The newly created code fragment instance. - - - - Create a text fragment instances. - - The newly created text fragment instance. - - - - Loads a mixed code document from a stream. - - The input stream. - - - - Loads a mixed code document from a stream. - - The input stream. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads a mixed code document from a stream. - - The input stream. - The character encoding to use. - - - - Loads a mixed code document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads a mixed code document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - The minimum buffer size. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - The character encoding to use. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - The minimum buffer size. - - - - Loads the mixed code document from the specified TextReader. - - The TextReader used to feed the HTML data into the document. - - - - Loads a mixed document from a text - - The text to load. - - - - Saves the mixed document to the specified stream. - - The stream to which you want to save. - - - - Saves the mixed document to the specified stream. - - The stream to which you want to save. - The character encoding to use. - - - - Saves the mixed document to the specified file. - - The location of the file where you want to save the document. - - - - Saves the mixed document to the specified file. - - The location of the file where you want to save the document. - The character encoding to use. - - - - Saves the mixed document to the specified StreamWriter. - - The StreamWriter to which you want to save. - - - - Saves the mixed document to the specified TextWriter. - - The TextWriter to which you want to save. - - - - Represents a fragment of code in a mixed code document. - - - - - Gets the fragment code text. - - - - - Represents a base class for fragments in a mixed code document. - - - - - Gets the fragement text. - - - - - Gets the type of fragment. - - - - - Gets the line number of the fragment. - - - - - Gets the line position (column) of the fragment. - - - - - Gets the fragment position in the document's stream. - - - - - Represents a list of mixed code fragments. - - - - - Gets the Document - - - - - Gets the number of fragments contained in the list. - - - - - Gets a fragment from the list using its index. - - - - - Gets an enumerator that can iterate through the fragment list. - - - - - Appends a fragment to the list of fragments. - - The fragment to append. May not be null. - - - - Gets an enumerator that can iterate through the fragment list. - - - - - Prepends a fragment to the list of fragments. - - The fragment to append. May not be null. - - - - Remove a fragment from the list of fragments. If this fragment was not in the list, an exception will be raised. - - The fragment to remove. May not be null. - - - - Remove all fragments from the list. - - - - - Remove a fragment from the list of fragments, using its index in the list. - - The index of the fragment to remove. - - - - Represents a fragment enumerator. - - - - - Gets the current element in the collection. - - - - - Gets the current element in the collection. - - - - - Advances the enumerator to the next element of the collection. - - true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. - - - - Sets the enumerator to its initial position, which is before the first element in the collection. - - - - - Represents the type of fragment in a mixed code document. - - - - - The fragment contains code. - - - - - The fragment contains text. - - - - - Represents a fragment of text in a mixed code document. - - - - - Gets the fragment text. - - - - - 给控件增加拖放功能的类 - - - - - 拖放实例 - - - - - 高级拖放事件 - - - - - - - - - - - - - - - - - - - - 使管理员方式运行时支持拖放 - - - - - - 使支持拖放属性 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 网络操作类 - - - - - 通过NetworkInterface读取网卡Mac - - - - - - 通过NetworkInterface读取网卡Mac - - - - - - 根据mac字符串来获取最终的mac地址,可以是各种MAC地址格式,非法的内容将返回null - - - - - - - 远程唤醒 - - - - - - - - 远程唤醒 - - - - - - - - - 消息客户端类 - - - - - 判断当前消息主服务器是否创建成功 - - - - - 最后一次接收消息的时间,可用来判断服务端是否有响应 - - - - - 主句柄 - - - - - 当收到消息时激发 - - - - - 连接上主服务器时触发 - - - - - 收到服务端关闭通知 - - - - - 收到服务端关闭通知，即将关闭 - - - - - 服务端大小改变时激发 - - - - - 实例化客户端 - - 服务端ID - 当前客户端ID,会向服务器报告当前ID - 客户端 - - - - - - - - - 断开服务端连接 - - - - - 发送消息,采用多线程发送 - - - - - - - 向服务端发送心跳包 - - - - - 判断服务端句柄是否存在。 - - - - - - 共享内存 - - - - - 写共享内存 - - 需要映射的文件的字节数量 - 映射对象（简单类型、结构体等） - 文件映射对象的名称 - - - - - 写共享内存 - - 需要映射的文件的字节数量 - 映射对象（简单类型、结构体等） - 文件映射对象的名称 - 发送消息的窗口句柄 - 发送消息 - - - - - 读共享内存 - - - - - - - - 读共享内存 - - - - - - - - 读共享内存 - - - - - - - - - 读共享内存 - - 需要映射的文件的字节数量 - 类型 - 文件映射对象的名称 - 返回读到的映射对象 - - - - 读共享内存 - - 需要映射的文件的字节数量 - 类型 - 文件映射对象的名称 - 返回读到的映射字节数据 - - - - 消息服务器 - - - - - 消息事件 - - - - - - - 大小改变事件 - - - - - - - - 即将关闭事件 - - - - - - - 当收到消息时激发 - - - - - 消息处理类 - - - - - - - - - - - - - - - - - - - - - - - 发送消息,采用单线程发送 - - 要发送到的句柄 - 编号 - 消息内容 - - - - 发送消息，采用多线程发送 - - 要发送到的句柄 - 编号 - 消息内容 - - - - 消息类 - - - - - 是否取消 - - - - - 来源句柄 - - - - - - - - - - 消息文本 - - - - - 需要回复的内容 - - - - - 消息服务端类 - - - - - 判断当前消息主服务器是否创建成功 - - - - - 当收到消息时激发 - - - - - 当收到自定义消息时(非系统消息)激发 - - - - - 有消息客户端发起连接请求时激发 - - - - - 有消息客户端连接成功时激发 - - - - - 有消息客户端断开连接时激发 - - - - - - - 服务端ID,需要唯一性,共客户端识别 - 服务端 - - - - 释放资源 - - - - - 判断是否包含指定客户端 - - - - - - - - - - - - 设置客户端大小 - - - - - 根据客户端ID,获取客户端对象 - - - - - - - 根据客户端句柄,获取客户端对象 - - - - - - - 关闭所有客户端 - - - - - 关闭指定客户端 - - - - - - 关闭指定客户端 - - - - - - 向所有客户端发送消息，单线程 - - - - - - - 向指定客户端发送消息 - - - - - - - - 关闭在指定时间前失去响应的子客户端 - - - - - - 客户端信息 - - - - - 客户端句柄 - - - - - 客户端ID - - - - - 客户端连接时间 - - - - - 心跳时间 - - - - - 数据库引擎 - - - - - 数据库枚举类型 - - - - - Odbc引擎 - - - - - OleDb引擎 - - - - - Oracle引擎 - - - - - MSSQL引擎 - - - - - SQLite引擎 - - - - - MySql引擎 - - - - - 判断DataSet是否包含数据 - - - - - - - 获取首行数据 - - - - - - - 获取第一行第一列的值 - - - - - - - 将DataSet类型转换为RyQuickSQL列表类型 - - - - - - - 将DataSet类型转换为RyQuickSQL列表类型 - - - - - - - - 数据库操作接口 - - - - - 连接数据库 - - - - - - 断开数据库 - - - - - - 获取数量 - - - - - - - - 获取分页语句 - - - - - - - - - 获取分页语句 - - - - - - - - - 获取分页语句 - - - - - - - - - - 获取分页语句 - - - - - - - - - - 添加Parameter参数 - - - - - - - 清空Parameter参数 - - - - - - - 获取Parameter值 - - - - - - 根据RyQuickSQL类来获取Parameter值 - - - - - - - 开始执行事务 - - - - - 提交事务 - - - - - 判断是否包含数据 - - - - - - - - 返回-1000表示该数据库不支持本接口 - - - - - - - 读取数据 - - - - - - - 读取数据 - - - - - - - - 读取数据 - - - - - - - - 根据id号获取数据 - - - - - - - - 执行SQL语句 - - - - - - - - 执行SQL语句 - - - - - - - - 执行SQL语句 - - - 只针对IsAdd为false才生效，where 以后的sql语句 - 是新增还是更新 - - - - - 插入数据库 - - - - - - - 更新数据库 - - - where 以后的sql语句 - - - - - 执行SQL语句 - - - - - - - 根据id号删除数据 - - - - - - - - 创建数据库 - - - - - - - 释放资源 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 连接数据库 - - 数据库连接字符串 - - - - - 连接数据库 - - 数据源 - 数据库名称 - 用户id - 用户密码 - - - - - - - - - 连接数据库 - - - - - - 关闭数据库 - - - - - - 运行SQL命令 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令 - - SQL语句 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 数组第一个默认的值 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 数组第一个默认的值 - 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 判断指定值是否存在 - - 表名 - 指定值所属字段 - 指定值 - 当前id，如果是新增记录，请填写-1 - - - - - 判断SQL语句是否有结果返回 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 判断SQL语句是否有结果返回 - - SQL语句 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 执行SQL语句 - - - 只针对IsAdd为false才生效，where 以后的sql语句 - 是新增还是更新 - - - - - 插入数据库 - - - - - - - 更新数据库 - - - where 以后的sql语句 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SQL字段类型 - - - - - SQL字段类型 - - - - - - - SQL字段类型 - - - - - - - - SQL字段名 - - - - - SQL字段值 - - - - - SQL字段长度 - - - - - 不是真的值，而是用于计算的值 - - - - - SQL快速操作类 - - - - - SQL快速操作类 - - - - - - 表名 - - - - - 操作字段列表 - - - - - 清理使用资源 - - - - - 清理使用资源 - - - - - 清理使用资源 - - - - - 操作参数列表 - - - - - 操作参数列表 - - - - - 添加字符串字段 - - - - - - - 添加null值字段 - - - - - - 添加日期字段 - - - - - - - 添加int字段 - - - - - - - 添加double字段 - - - - - - - 添加decimal字段 - - - - - - - 添加byte[]字段 - - - - - - - 添加bool字段 - - - - - - - 添加用于计算的值 - - - - - - - 添加Int64字段 - - - - - - - 清空内容 - - - - - 数量 - - - - - - - - - - 输出多条件搜索。 - - 字段名,多个字段请用逗号分隔。 - 多个条件之间请用空格隔开 - - - - - 获取插入SQL语句 - - - - - - 获取更新SQL语句 - - - - - - 添加参数 - - - - - - - 获取Ole参数 - - - - - - 获取SQL参数 - - - - - - 一个强类型的资源类，用于查找本地化的字符串等。 - - - - - 返回此类使用的缓存的 ResourceManager 实例。 - - - - - 重写当前线程的 CurrentUICulture 属性，对 - 使用此强类型资源类的所有资源查找执行重写。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - Win32 API - - - - - - - - - - WM_COPYDATA消息的主要目的是允许在进程间传递只读数据。 - - - - - 系统通道ID - - - - - 用户通道ID - - - - - 获取消息 - - - - - - - - 发送消息 - - - - - - - - - - 设置父窗口 - - - - - - - - - Http连接操作帮助类 - - - - - - - - - - - - 根据相传入的数据，得到相应页面数据 - - 参数类对象 - 返回HttpResult类型 - - - - 获取数据的并解析的方法 - - - - - - - 设置编码 - - HttpItem - HttpResult - byte[] - - - - 提取网页Byte - - - - - - 为请求准备参数 - - 参数列表 - - - - 设置证书 - - - - - - 设置多个证书 - - - - - - 设置Cookie - - Http参数 - - - - 设置Post数据 - - Http参数 - - - - 设置代理 - - 参数对象 - - - - 回调验证证书问题 - - 流对象 - 证书 - X509Chain - SslPolicyErrors - bool - - - - 通过设置这个属性，可以在发出连接的时候绑定客户端发出连接所使用的IP地址。 - - - - - - - - - Http请求参考类 - - - - - 请求URL必须填写 - - - - - 请求方式默认为GET方式,当为POST方式时必须设置Postdata的值 - - - - - 默认请求超时时间 - - - - - 默认写入Post数据超时间 - - - - - 设置Host的标头信息 - - - - - 获取或设置一个值，该值指示是否与 Internet 资源建立持久性连接默认为true。 - - - - - 请求标头值 默认为text/html, application/xhtml+xml, */* - - - - - 请求返回类型默认 text/html - - - - - 客户端访问信息默认Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0) - - - - - 返回数据编码默认为NUll,可以自动识别,一般为utf-8,gbk,gb2312 - - - - - Post的数据类型 - - - - - Post请求时要发送的字符串Post数据 - - - - - Post请求时要发送的Byte类型的Post数据 - - - - - Cookie对象集合 - - - - - 请求时的Cookie - - - - - 来源地址，上次访问地址 - - - - - 证书绝对路径 - - - - - 设置代理对象，不想使用IE默认配置就设置为Null，而且不要设置ProxyIp - - - - - 是否设置为全文小写，默认为不转化 - - - - - 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 - - - - - 最大连接数 - - - - - 代理Proxy 服务器用户名 - - - - - 代理 服务器密码 - - - - - 代理 服务IP,如果要使用IE代理就设置为ieproxy - - - - - 设置返回类型String和Byte - - - - - header对象 - - - - - 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 - - - - - 获取或设置一个 System.Boolean 值，该值确定是否使用 100-Continue 行为。如果 POST 请求需要 100-Continue 响应，则为 true；否则为 false。默认值为 true。 - - - - - 设置509证书集合 - - - - - 设置或获取Post参数编码,默认的为Default编码 - - - - - Cookie返回类型,默认的是只返回字符串类型 - - - - - 获取或设置请求的身份验证信息。 - - - - - 设置请求将跟随的重定向的最大数目 - - - - - 获取和设置IfModifiedSince，默认为当前日期和时间 - - - - - 设置本地的出口ip和端口 - ] - - item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); - - - - - Http返回参数类 - - - - - Http请求返回的Cookie - - - - - Cookie对象集合 - - - - - 返回的String类型数据 只有ResultType.String时才返回数据，其它情况为空 - - - - - 返回的Byte数组 只有ResultType.Byte时才返回数据，其它情况为空 - - - - - header对象 - - - - - 返回状态说明 - - - - - 返回状态码,默认为OK - - - - - 最后访问的URl - - - - - 获取重定向的URl - - - - - 返回类型 - - - - - 表示只返回字符串 只有Html有数据 - - - - - 表示返回字符串和字节流 ResultByte和Html都有数据返回 - - - - - Post的数据格式默认为string - - - - - 字符串类型，这时编码Encoding可不设置 - - - - - Byte类型，需要设置PostdataByte参数的值编码Encoding可设置为空 - - - - - 传文件，Postdata必须设置为文件的绝对路径，必须设置Encoding的值 - - - - - Cookie返回类型 - - - - - 只返回字符串类型的Cookie - - - - - CookieCollection格式的Cookie集合同时也返回String类型的cookie - - - - - Http服务器类 - - - - - - - - - - - - 当收到Get事件时激发 - - - - - 当收到Post事件时激发 - - - - - 监听的主机,默认是localhost - - - - - 最后一次错误信息 - - - - - 在此端口建立Http服务类 - - 端口号 - - - - - - - - - - 开始服务 - - - - - 退出服务 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 超时时间 - - - - 以post方式获取网页源码 - - - - - - - - - 以post方式提交json内容 - - - - - - - - - 以post方式提交json内容 - - - - - - - - 以post方式获取网页源码 - - - - - - - - - - 以post方式获取网页源码 - - - - - - - - 获取网址对应的文件大小 - - - - - - - 获取网址对应的文件大小 - - - - - - - - 代理 - - - - - - - - - - 获取网页源码 - - - - - - - - 获取网页源码 - - - - - - - - - 获取网页源码 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 将相对网址转换成绝对网址 - - 相对网址 - 当前页面地址 - 转换后的绝对网址 - - - - - - - - - - - - - - url解密 - - - - - - - - url解密,按UTF8方式解密 - - - - - - - Url加密 - - - - - - - - Url加密,按UTF8方式加密 - - - - - - - 解密 - - - - - - - 加密 - - - - - - - - - - - - - - - - - - - - - - - - - url加密,Unicode - - - - - - - - - - - - - - - - - - - - - - Html解码,将html里未转义成功的重新转义。 - - - - - - - 将url里的字段分解成表单字典 - - - - - - - - - 根据表单字段名获取值 - - - - - - - - - AES加密解密类 - - - - - AES加密算法 - - 明文字符串 - 密钥 - 返回加密后的密文字节数组 - - - - AES解密 - - 密文字节数组 - 密钥 - 返回解密后的字符串 - - - - 加密 - - - - - - - - 解码 - - - - - - - - 转换密钥到合法密钥 - - - - - - - Base64编码类 - - - - - 编码 - - - - - - - 把字符串编码成Base64字符串 - - - - - - - - 解码 - - - - - - - MD5和SHA1操作类 - - - - - 计算文件MD5。 - 通过MD5CryptoServiceProvider类中的ComputeHash方法直接传入一个FileStream类实现计算MD5 - 操作简单，代码少，调用即可 - - 文件地址 - MD5Hash - - - - 计算文件MD5。 - 通过HashAlgorithm的TransformBlock方法对流进行叠加运算获得MD5 - 实现稍微复杂，但可使用与传输文件或接收文件时同步计算MD5值 - 可自定义缓冲区大小，计算速度较快 - - 文件地址 - MD5Hash - - - - 获取MD5 - - - - - - - 获取MD5 - - - - - - - 获取SHA1 - - - - - - - 获取SHA1 - - - - - - - 获取HmacSHA1 - - - - - - - - 获取SHA256 - - - - - - - 获取HmacSHA256 - - - - - - - - 获取SHA224 - - - - - - - 获取SHA512 - - - - - - - 获取HmacSHA512 - - - - - - - 使用using代替lock操作的对象,可指定写入和读取锁定模式 - - - - 利用IDisposable的using语法糖方便的释放锁定操作 - 内部类 - - - - 读写锁对象 - - - - 是否为写入模式 - - - - 利用IDisposable的using语法糖方便的释放锁定操作 - 构造函数 - - 读写锁 - 写入模式为true,读取模式为false - - - 释放对象时退出指定锁定模式 - - - - 空的可释放对象,免去了调用时需要判断是否为null的问题 - 内部类 - - - - 空的可释放对象 - - - - 空的释放方法 - - - - 读写锁 - - - - 保存数据 - - - - 使用using代替lock操作的对象,可指定写入和读取锁定模式 - 构造函数 - - - - 使用using代替lock操作的对象,可指定写入和读取锁定模式 - 构造函数 - 为Data属性设置初始值 - - - - 获取或设置当前对象中保存数据的值 - - 获取数据时未进入读取或写入锁定模式 - 设置数据时未进入写入锁定模式 - - - 是否启用,当该值为false时,Read()和Write()方法将返回 Disposable.Empty - - - - 进入读取锁定模式,该模式下允许多个读操作同时进行 - 退出读锁请将返回对象释放,建议使用using语块 - Enabled为false时,返回Disposable.Empty; - 在读取或写入锁定模式下重复执行,返回Disposable.Empty; - - - - 进入写入锁定模式,该模式下只允许同时执行一个读操作 - 退出读锁请将返回对象释放,建议使用using语块 - Enabled为false时,返回Disposable.Empty; - 在写入锁定模式下重复执行,返回Disposable.Empty; - - 读取模式下不能进入写入锁定状态 - - - - 中国农历类,最大支持公元0-9999年 - - 日期：2019-02-09 - 作者：http://www.cnblogs.com/zjfree/ - - - - 日历类型 - - - - - 无效 - - - - - Julian 日历 - - - - - Gregorian 日历 - - - - - 有效 - - - - - 公历节日 - - - - - 农历节日 - - - - - 某个月第n个星期几 - - - - - 获取农历 - - - - - - - 获取农历 - - - - - - - - - 获得某农历年的闰月，返回 1~12 对应一月到十二月，返回 0 表示无闰月 - - - - - - - 农历搜索方向 - - - - - 无效 - - - - - 向上 - - - - - 向下 - - - - - {* 日月食类型， 无， 日食， 月全食， 月偏食 } - - - - - 无 - - - - - 日食 - - - - - 月全食 - - - - - 月偏食 - - - - - {* 月相， 无， 朔， 望} - - - - - 无 - - - - - 朔 - - - - - 望 - - - - - 获得某公历年月日的农历日数和该日月相以及日月食类型和时刻 - - - - - - - - - - - - 获得某公历年月日的农历月数 - - - - - - - - - 获取阳历日期对应的农历日期 - - - - - - - - - - - - - 获得某公历年月日的农历月日和是否闰月的信息 - - - - - - - - - - - - 获得等效标准日数对应的某公历日，倒推而来 - - - - - - - - - - 比较两个农历日期（包括闰月信息），1 大于2返回1、1等于2返回0、1小于2返回-1 - - - - - - - - - - - - - - 获得某农历年月日（加是否闰月）的公历年月日 - 该函数采用反向二分法查找 - - - - - - - - - - - - - 获取农历某一个月的总天数 - - - - - - - - - 获取农历年份，范围约1901-2101年 - - - - - - - 获取农历年份，范围约0-9999年 - - - - - - - - - 获取农历月份，范围约1901-2101年 - - - - - - - 获取农历月份，范围约0-9999年 - - - - - - - - - 获取中文表示的农历月份 - - - - - - - 获取农历日，范围约1901-2101年 - - - - - - - 获取农历日，范围约0-9999年 - - - - - - - - - 获取农历日，范围约0-9999年 - - - - - - - 获取节气，范围约1901-2101年 - - - - - - - 获取节气，范围约0-9999年 - - - - - - - - - 返回y年第n个节气（如小寒为1）的日差天数值（pd取值真假，分别表示平气和定气） - - - - pd取值真假，分别表示平气和定气 - - - - - 获取等效标准日数 - - - - - - - - - 取本月天数，不考虑 1582 年 10 月的特殊情况 - - - - - - - - 获取节气，范围约1901-2101年 - - - - - - - 获取节气，范围约0-9999年 - - - - - - - - - 获取节气 - - - - - - - - - - - - 获取公历节日 - - - - - - - 获取公历节日 - - - - - - - - - 获取指定月份的第n个星期几的节日 - - - - - - - 返回星座，范围约1901-2101年 - - - - - 返回星座，范围约0-9999年 - - - - - 获取农历节日 - - - - - - - - - 获取农历节日 - - - - - - - 判断y年m月(1,2,..,12,下同)d日是Gregorian历还是Julian历（opt=1,2,3分别表示标准日历,Gregorge历和Julian历）,是则返回1，是Julian历则返回0，若是Gregorge历所删去的那10天则返回-1 - - - - - 返回阳历y年m月d日的日差天数（在y年年内所走过的天数，如2000年3月1日为61） - - - - - 返回阳历y年日差天数为x时所对应的月日数（如y=2000，x=274时，返回1001(表示10月1日，即返回100*m+d)） - - - - - 获取指定日期的节气。 - - 要获取的年 - 要获取的月 - - - 立春：立是开始的意思，春是蠢动，表示万物开始有生气，这一天春天开始。 - 雨水：降雨开始，雨水将多。 - 惊蛰：春雷响动，惊动蛰伏地下冬眠的生物，它们将开始出土活动。 - 春分：这是春季九十天的中分点，这一天昼夜相等，所以古代曾称春分秋分为昼夜分。 - 清明：明洁晴朗，气候温暖，草木开始萌发繁茂。 - 谷雨：雨生百谷的意思。雨水增多，适时的降雨对谷物生长很为有利。 - 立夏：夏天开始，万物渐将随温暖的气候而生长。 - 小满：满指籽粒饱满，麦类等夏热作物这时开始结籽灌浆，即将饱满。 - 芒种：有芒作物开始成熟，此时也是秋季作物播种的最繁忙时节。 - 夏至：白天最长，黑夜最短，这一天中午太阳位置最高，日影短至终极，古代又称这一天为日北至或长日至。 - 小暑：暑是炎热，此时还未到达最热。 - 大暑：炎热的程度到达高峰。 - 立秋：秋天开始，植物快成熟了。 - 处暑：处是住的意思，表示暑气到此为止。 - 白露：地面水气凝结为露，色白，是天气开始转凉了。 - 秋分：秋季九十天的中间，这一天昼夜相等，同春分一样，太阳从正东升起正西落下。 - 寒露：水露先白而后寒，是气候将逐渐转冷的意思。 - 霜降：水气开始凝结成霜。 - 立冬：冬是终了，作物收割后要收藏起来的意思，这一天起冬天开始。 - 小雪：开始降雪，但还不多。 - 大雪：雪量由小增大。 - 冬至：这一天中午太阳在天空中位置最低，日影最长，白天最短， 黑夜最长，古代又称短日至或日南至。 - 小寒：冷气积久而为寒，此时尚未冷到顶点。 - 大寒：天候达到最寒冷的程度 - - - - - 获取年柱。 - - - - - 获得月柱 - - - - - - - 获取日柱。 - - - - - 返回甲子数x对应的天干数（如33为3） - - - - - 返回甲子数x对应的地支数（如33为9） - - - - - 获取日的天干地支 - - - - - - - 返回甲子数x对应的天干字符串 - - - - - 返回甲子数x对应的地支字符串 - - - - - 返回甲子数x对应的干支字符串 - - - - - - - 获取三伏开始时间 - - - 0表示1伏，1表示2伏，2表示3伏 - - - - - 节气 - - - - - 节气的时间。 - - - - - 节气名。 - - - - - 热键转换类 - - - - - 功能键。 - - - - - 修改键。 - - - - - 转换功能键到谷歌浏览器专用 - - - - - 将chrome功能键转换为普通功能键 - - - - - - - 按键值。 - - - - - 初始化类 的新实例。 - - The modifiers. - The key code. - - - - - - - - - - - - - - - - - 初始化类 的新实例。 - - - - - 加载热键 - - - - - - - 加载热键 - - - - - - 加载热键 - - - - - - 判断是否是热键 - - - - - 获取当前热键 - - - - - 已重载，返回“Ctrl+Alt+A”格式的字符串。 - - 类似“Ctrl+Alt+A”格式的字符串 - - - - 返回“Ctrl+Alt+A”格式的字符串。 - - 类似“Ctrl+Alt+A”格式的字符串 - - - - 功能键 - - - - - 无 - - - - - Alt键 - - - - - Ctrl键 - - - - - Alt+Ctrl键 - - - - - Shift键 - - - - - Shift+Alt键 - - - - - Shift+Ctrl键 - - - - - Alt+Shift+Ctrl键 - - - - - Win键 - - - - - 热键类 - - - - - 热键类 - - - - - - 热键注销 - - - - - 热键是否有效 - - - - - 释放热键 - - - - - 获取热键Tag - - - - - - - 获取热键id - - - - - - - 获取热键id - - - - - - - - 判断热键id是否存在 - - - - - - - 判断热键Tag是否存在 - - - - - - - 判断热键是否存在 - - - - - - - - 注册热键 - - - - - - - - - 注册热键 - - - - - - - - - 注册热键 - - - - - - - - - - 获取热键数量 - - - - - 删除热键 - - - - - - - 删除所有热键 - - - - - 删除所有热键 - - - - - 热键事件 - - - - - - 当使用热键时发生的事件 - - - - - 热键消息过滤 - - - - - - - 热键类型 - - - - - 热键id - - - - - 热键Tag - - - - - 功能键 - - - - - 普通键 - - - - - 热键类型 - - - - - - - - 热键类型 - - - - - - - - - 热键类型 - - - - - - - - - - 结束进程 - - - - - - - - - - - - - - - - - - - - - - - / - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - / - - - - - / - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 删除一个逻辑笔、画笔、字体、位图、区域或者调色板，释放所有与该对象有关的系统资源，在对象被删除之后，指定的句柄也就失效了。 - - - - - - - 选择一对象到指定的设备上下文环境中，该新对象替换先前的相同类型的对象。 - - - - - - - - 创建一个与指定设备兼容的内存设备上下文环境（DC）。 - - - - - - - 为一个设备创建设备上下文环境。 - - - - - - - - - - 删除指定的设备上下文环境（Dc）。 - - - - - - - - - - - - 模拟鼠标点击 - - - - - - - - - - - 模拟按键 - - - - - - - - - 返回hWnd参数所指定的窗口的设备环境。 - - - - - - - 移动窗口 - - - - - - - - - - - - 将消息信息传送给指定的窗口过程的函数。使用函数CallWindowsProc可进行窗口子分类。 - 通常来说，同一类的所有窗口共享一个窗口过程。子类是一个窗口或者相同类的一套窗口， - 在其消息被传送到该类的窗口过程之前，这些消息是由另一个窗口过程进行解释和处理的。 - - - - - - - - - - - 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 - - - - - - - - - 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 - - - - - - - - - 设置弹出式窗口，层叠窗口或子窗口的父窗口 - - - - - - - - 获得一个指定子窗口的父窗口句柄 - - Handle to the window whose parent window handle is to be retrieved. - If the window is a child window, the return value is a handle to the parent window. If the window is a top-level window, the return value is a handle to the owner window. If the window is a top-level unowned window or if the function fails, the return value is NULL. - - - - 获取系统菜单的句柄 - - 拥有窗口菜单拷贝的窗口的句柄 - 标志位，指定将执行的操作 - - - - - 获取系统菜单的句柄 - - 拥有窗口菜单拷贝的窗口的句柄 - 标志位，指定将执行的操作。 - 如果此参数为FALSE，GetSystemMenu返回当前使用窗口菜单的拷贝的句柄。该拷贝初始时与窗口菜单相同，但可以被修改。 - 如果此参数为TRUE，GetSystemMenu重置窗口菜单到缺省状态。如果存在先前的窗口菜单，将被销毁。 - - 如果参数bRevert为FALSE，返回值是窗口菜单的拷贝的句柄：如果参数bRevert为TRUE，返回值是NULL。 - - - - 从指定菜单删除一个菜单项或分离一个子菜单。 - 备注：只要一个菜单被修改，无论它是否在显示窗口里，应用程序都必须调用函数DrawMenuBar。 - - 将被修改的菜单的句柄。 - 指定将被删除的菜单项，其含义由参数wFlags决定。 - - 如果函数调用成功，返回非零值；如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。 - - - - 设置前台窗口 - - - - - - - 获取当前前台窗口句柄 - - - - - - 获得当前活动窗体 - - 活动窗口的句柄。如没有窗口处于活动状态或处于活动状态的窗口非当前线程创建，则返回零。 - - - - 设置活动窗体 - - - - - - - 获取类名 - - - - - - - - - 获取当前线程对应的进程ID - - - - - - - - 判断指定句柄是否是一个窗口 - - - - - - - 获取窗口标题 - - - - - - - - - 发送消息 - - - - - - - - - - 发送消息 - - - - - - - - - - 发送消息 - - - - - - - - - - 发送消息 - - - - - - - - - - 发送消息 - - - - - - - - - 从文件中载入指针 - - - - - - - 判断窗口是否可见 - - - - - - - 查找窗口 - - - - - - - - The FindWindowEx function retrieves a handle to a window whose class name and window name match the specified strings. The function searches child windows, beginning with the one following the specified child window. - - Handle to the parent window whose child windows are to be searched. - Handle to a child window. - Specifies class name. - Pointer to a null-terminated string that specifies the window name (the window's title). - If the function succeeds, the return value is a handle to the window that has the specified class and window names.If the function fails, the return value is NULL. - - - - The InvalidateRect function adds a rectangle to the specified window's update region. - - Handle to window. - Rectangle coordinates. - Erase state. - If the function succeeds, the return value is true.If the function fails, the return value is false. - - - - The ValidateRect function validates the client area within a rectangle by removing the rectangle from the update region of the specified window. - - Handle to window. - Validation rectangle coordinates. - If the function succeeds, the return value is true.If the function fails, the return value is false. - - - - 获取指定窗口的有关信息，也可用于获取窗口内存中指定偏移的32位度整型值。 - - - - - - - - 检索一指定窗口的客户区域或整个屏幕的显示设备上下文环境的句柄，以后可以在GDI函数中使用该句柄来在设备上下文环境中绘图。 - - - - - - - 释放设备上下文环境（DC）供其他应用程序使用。函数的效果与设备上下文环境类型有关。它只释放公用的和设备上下文环境，对于类或私有的则无效。 - - - - - - - - 获取桌面句柄 - - - - - - 获取窗口客户区的大小。注意一下：窗口的客户区为窗口中除标题栏、菜单栏之外的地方。 - - - - - - - - 返回指定窗口的边框矩形的尺寸。该尺寸以相对于屏幕坐标左上角的屏幕坐标给出。 - - - - - - - - 更新一个分层窗口的位置，大小，形状，内容和半透明度 - - - - - - - - - - - - - - - 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 - 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 - - A handle to the window. - A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. - Specifies the new position of the left side of the window, in client coordinates. - Specifies the new position of the top of the window, in client coordinates. - Specifies the new width of the window, in pixels. - Specifies the new height of the window, in pixels. - Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. - If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. - - - - 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 - 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 - - - - - - - - - - - - - 设置指针位置 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 获取或设置是否捕获鼠标 - - - - - 获取或设置是否显示图像信息 - - - - - 获取或设置操作框点的颜色 - - - - - 获取或设置操作框边框颜色 - - - - - 获取或设置放大图形的原始尺寸 - - - - - 获取或设置放大图像的倍数 - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - 获取或设置用于被操作的图像 - - - - - 获取或设置操作框点的颜色 - - - - - 获取或设置操作框线条的颜色 - - - - - 获取当前选中的区域 - - - - - 获取或设置放大图像的原图大小尺寸 - - - - - 获取或设置图像放大的倍数 - - - - - 获取或设置是否绘制操作框点 - - - - - 获取或设置是否限制鼠标操作区域 - - - - - 获取或设置是否绘制信息展示 - - - - - 获取或设置是否根据图像大小自动调整控件尺寸 - - - - - 获取当前是否绘制的有区域 - - - - - 获取当前是否开始绘制 - - - - - 获取当前操作框是否正在移动 - - - - - 获取或设置操作框是否锁定 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 响应四个按键实现精确移动 - - - - - - - - - - - - 绘制操作框 - - - - - - 绘制图像放大信息 - - - - - - 清空所有操作 - - - - - 手动设置一个块选中区域 - - 要选中区域 - - - - 手动设置一个块选中区域 - - 要选中区域的坐标 - 要选中区域的大小 - - - - 手动设置一个块选中区域 - - 要选中区域的x坐标 - 要选中区域的y坐标 - 要选中区域的宽度 - 要选中区域的高度 - - - - 手动设置信息显示的位置 - - 要显示的位置 - - - - 手动设置信息显示的位置 - - 要显示位置的x坐标 - 要显示位置的y坐标 - - - - 获取操作框内的图像 - - 结果图像 - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 鼠标结构信息 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 设置Hook - - - - - - 卸载Hook - - - - - - 鼠标状态枚举值 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 事件参数 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Bin/Debug/CommonControls/.NET4/MyDb_MSSQL.dll b/Bin/Debug/CommonControls/.NET4/MyDb_MSSQL.dll deleted file mode 100644 index 802a582..0000000 Binary files a/Bin/Debug/CommonControls/.NET4/MyDb_MSSQL.dll and /dev/null differ diff --git a/Bin/Debug/CommonControls/.NET4/MyDb_MSSQL.xml b/Bin/Debug/CommonControls/.NET4/MyDb_MSSQL.xml deleted file mode 100644 index 2602e60..0000000 --- a/Bin/Debug/CommonControls/.NET4/MyDb_MSSQL.xml +++ /dev/null @@ -1,348 +0,0 @@ - - - - MyDb_MSSQL - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 连接数据库 - - 数据库连接字符串 - - - - - 连接数据库 - - 数据源 - 数据库名称 - 用户id - 用户密码 - - - - - - - - - 连接数据库 - - - - - - 关闭数据库 - - - - - - 运行SQL命令 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令 - - SQL语句 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 数组第一个默认的值 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 数组第一个默认的值 - 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 判断指定值是否存在 - - 表名 - 指定值所属字段 - 指定值 - 当前id，如果是新增记录，请填写-1 - - - - - 判断SQL语句是否有结果返回 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 判断SQL语句是否有结果返回 - - SQL语句 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Bin/Debug/CommonControls/.NET4/MyDb_MySQL.dll b/Bin/Debug/CommonControls/.NET4/MyDb_MySQL.dll deleted file mode 100644 index cacda7a..0000000 Binary files a/Bin/Debug/CommonControls/.NET4/MyDb_MySQL.dll and /dev/null differ diff --git a/Bin/Debug/CommonControls/.NET4/MyDb_MySQL.xml b/Bin/Debug/CommonControls/.NET4/MyDb_MySQL.xml deleted file mode 100644 index 03e8fc1..0000000 --- a/Bin/Debug/CommonControls/.NET4/MyDb_MySQL.xml +++ /dev/null @@ -1,372 +0,0 @@ - - - - MyDb_MySQL - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 连接数据库 - - 数据库连接字符串 - - - - - 连接数据库 - - 数据源 - 数据库名称 - 用户id - 用户密码 - - - - - - - - - 连接数据库 - - - - - - 关闭数据库 - - - - - - 运行SQL命令 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令 - - SQL语句 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 数组第一个默认的值 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 数组第一个默认的值 - 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 判断指定值是否存在 - - 表名 - 指定值所属字段 - 指定值 - 当前id，如果是新增记录，请填写-1 - - - - - 判断SQL语句是否有结果返回 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 判断SQL语句是否有结果返回 - - SQL语句 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 执行SQL语句 - - - 只针对IsAdd为false才生效，where 以后的sql语句 - 是新增还是更新 - - - - - 插入数据库 - - - - - - - 更新数据库 - - - where 以后的sql语句 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Bin/Debug/CommonControls/.NET4/MyDb_SQLite.dll b/Bin/Debug/CommonControls/.NET4/MyDb_SQLite.dll deleted file mode 100644 index 61db6a7..0000000 Binary files a/Bin/Debug/CommonControls/.NET4/MyDb_SQLite.dll and /dev/null differ diff --git a/Bin/Debug/CommonControls/.NET4/MyDb_SQLite.xml b/Bin/Debug/CommonControls/.NET4/MyDb_SQLite.xml deleted file mode 100644 index 2fe5ccb..0000000 --- a/Bin/Debug/CommonControls/.NET4/MyDb_SQLite.xml +++ /dev/null @@ -1,431 +0,0 @@ - - - - MyDb_SQLite - - - - - - - - - - - - - - - - - - - - - - 数据库路径 - 数据库密码 - - - - - - - 数据库路径 - - - - - - - - - - - - - - - - - - - - 连接数据库 - - - - - - 设置路径和密码 - - - - - - 连接数据库 - - - - - - - - - - - - 连接或创建数据库，如果数据库不存在，就创建，否则连接 - - - - - - 连接或创建数据库，如果数据库不存在，就创建，否则连接 - - - - - - 关闭数据库 - - - - - - 运行SQL命令 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令 - - SQL语句 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 数组第一个默认的值 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 数组第一个默认的值 - 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 判断指定值是否存在 - - 表名 - 指定值所属字段 - 指定值 - 当前id，如果是新增记录，请填写-1 - - - - - 判断SQL语句是否有结果返回 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 判断SQL语句是否有结果返回 - - SQL语句 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 创建数据库 - - SQL语句 - - - - - 根据内置例子创建数据库 - - - - - - 保存信息，如果Name不存在，系统会自动创建 - - 返回1，表示成功，0表示失败 - - - - 获取信息 - - - - - - 获取信息 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 执行SQL语句 - - - 只针对IsAdd为false才生效，where 以后的sql语句 - 是新增还是更新 - - - - - 插入数据库 - - - - - - - 更新数据库 - - - where 以后的sql语句 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Bin/Debug/CommonControls/.NET4/Newtonsoft.Json.dll b/Bin/Debug/CommonControls/.NET4/Newtonsoft.Json.dll new file mode 100644 index 0000000..7af125a Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4/Newtonsoft.Json.dll differ diff --git a/Bin/Debug/CommonControls/.NET4/Newtonsoft.Json.xml b/Bin/Debug/CommonControls/.NET4/Newtonsoft.Json.xml new file mode 100644 index 0000000..0cbf62c --- /dev/null +++ b/Bin/Debug/CommonControls/.NET4/Newtonsoft.Json.xml @@ -0,0 +1,9646 @@ + + + + Newtonsoft.Json + + + + + Represents a BSON Oid (object id). + + + + + Gets or sets the value of the Oid. + + The value of the Oid. + + + + Initializes a new instance of the class. + + The Oid value. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. + + + + + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. + + + true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. + + + + + Gets or sets a value indicating whether the root object will be read as a JSON array. + + + true if the root object will be read as a JSON array; otherwise, false. + + + + + Gets or sets the used when reading values from BSON. + + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. + + + + + Gets or sets the used when writing values to BSON. + When set to no conversion will occur. + + The used when writing values to BSON. + + + + Initializes a new instance of the class. + + The to write to. + + + + Initializes a new instance of the class. + + The to write to. + + + + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. + + + + + Writes the end. + + The token. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + + + + Writes the beginning of a JSON array. + + + + + Writes the beginning of a JSON object. + + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value that represents a BSON object id. + + The Object ID value to write. + + + + Writes a BSON regex. + + The regex pattern. + The regex options. + + + + Specifies how constructors are used when initializing objects during deserialization by the . + + + + + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. + + + + + Json.NET will use a non-public default constructor before falling back to a parameterized constructor. + + + + + Converts a binary value to and from a base 64 string value. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Creates a custom object. + + The object type to convert. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Creates an object which will then be populated by the serializer. + + Type of the object. + The created object. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + + + + Provides a base class for converting a to and from JSON. + + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a F# discriminated union type to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an Entity Framework to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). + + + + + Gets or sets the date time styles used when converting a date to and from JSON. + + The date time styles used when converting a date to and from JSON. + + + + Gets or sets the date time format used when converting a date to and from JSON. + + The date time format used when converting a date to and from JSON. + + + + Gets or sets the culture used when converting a date to and from JSON. + + The culture used when converting a date to and from JSON. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from its name string value. + + + + + Gets or sets a value indicating whether the written enum text should be camel case. + The default value is false. + + true if the written enum text will be camel case; otherwise, false. + + + + Gets or sets the naming strategy used to resolve how enum text is written. + + The naming strategy used to resolve how enum text is written. + + + + Gets or sets a value indicating whether integer values are allowed when serializing and deserializing. + The default value is true. + + true if integers are allowed when serializing and deserializing; otherwise, false. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class. + + true if the written enum text will be camel case; otherwise, false. + + + + Initializes a new instance of the class. + + The naming strategy used to resolve how enum text is written. + true if integers are allowed when serializing and deserializing; otherwise, false. + + + + Initializes a new instance of the class. + + The of the used to write enum text. + + + + Initializes a new instance of the class. + + The of the used to write enum text. + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + + Initializes a new instance of the class. + + The of the used to write enum text. + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + true if integers are allowed when serializing and deserializing; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from Unix epoch time + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Converts a to and from a string (e.g. "1.2.3.4"). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts XML to and from JSON. + + + + + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. + + The name of the deserialized root element. + + + + Gets or sets a value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + true if the array attribute is written to the XML; otherwise, false. + + + + Gets or sets a value indicating whether to write the root JSON object. + + true if the JSON root object is omitted; otherwise, false. + + + + Gets or sets a value indicating whether to encode special characters when converting JSON to XML. + If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify + XML namespaces, attributes or processing directives. Instead special characters are encoded and written + as part of the XML element name. + + true if special characters are encoded; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The calling serializer. + The value. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Checks if the is a namespace attribute. + + Attribute name to test. + The attribute name prefix if it has one, otherwise an empty string. + true if attribute name is for a namespace attribute, otherwise false. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + + + + Specifies how dates are formatted when writing JSON text. + + + + + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + + + + + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + + + + + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + + + + + Date formatted strings are not parsed to a date type and are read as strings. + + + + + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + + + + + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + + + + + Specifies how to treat the time value when converting between string and . + + + + + Treat as local time. If the object represents a Coordinated Universal Time (UTC), it is converted to the local time. + + + + + Treat as a UTC. If the object represents a local time, it is converted to a UTC. + + + + + Treat as a local time if a is being converted to a string. + If a string is being converted to , convert to a local time if a time zone is specified. + + + + + Time zone information should be preserved when converting. + + + + + The default JSON name table implementation. + + + + + Initializes a new instance of the class. + + + + + Gets a string containing the same characters as the specified range of characters in the given array. + + The character array containing the name to find. + The zero-based index into the array specifying the first character of the name. + The number of characters in the name. + A string containing the same characters as the specified range of characters in the given array. + + + + Adds the specified string into name table. + + The string to add. + This method is not thread-safe. + The resolved string. + + + + Specifies default value handling options for the . + + + + + + + + + Include members where the member value is the same as the member's default value when serializing objects. + Included members are written to JSON. Has no effect when deserializing. + + + + + Ignore members where the member value is the same as the member's default value when serializing objects + so that it is not written to JSON. + This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, + decimals and floating point numbers; and false for booleans). The default value ignored can be changed by + placing the on the property. + + + + + Members with a default value but no JSON will be set to their default value when deserializing. + + + + + Ignore members where the member value is the same as the member's default value when serializing objects + and set members to their default value when deserializing. + + + + + Specifies float format handling options when writing special floating point numbers, e.g. , + and with . + + + + + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + + + + + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Note that this will produce non-valid JSON. + + + + + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. + + + + + Specifies how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + + + + + Floating point numbers are parsed to . + + + + + Floating point numbers are parsed to . + + + + + Specifies formatting options for the . + + + + + No special formatting is applied. This is the default. + + + + + Causes child objects to be indented according to the and settings. + + + + + Provides an interface for using pooled arrays. + + The array type content. + + + + Rent an array from the pool. This array must be returned when it is no longer needed. + + The minimum required length of the array. The returned array may be longer. + The rented array from the pool. This array must be returned when it is no longer needed. + + + + Return an array to the pool. + + The array that is being returned. + + + + Provides an interface to enable a class to return line and position information. + + + + + Gets a value indicating whether the class can return line information. + + + true if and can be provided; otherwise, false. + + + + + Gets the current line number. + + The current line number or 0 if no line information is available (for example, when returns false). + + + + Gets the current line position. + + The current line position or 0 if no line information is available (for example, when returns false). + + + + Instructs the how to serialize the collection. + + + + + Gets or sets a value indicating whether null items are allowed in the collection. + + true if null items are allowed in the collection; otherwise, false. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a flag indicating whether the array can contain null items. + + A flag indicating whether the array can contain null items. + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Instructs the to use the specified constructor when deserializing that object. + + + + + Instructs the how to serialize the object. + + + + + Gets or sets the id. + + The id. + + + + Gets or sets the title. + + The title. + + + + Gets or sets the description. + + The description. + + + + Gets or sets the collection's items converter. + + The collection's items converter. + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets the of the . + + The of the . + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets a value that indicates whether to preserve object references. + + + true to keep object reference; otherwise, false. The default is false. + + + + + Gets or sets a value that indicates whether to preserve collection's items references. + + + true to keep collection's items object references; otherwise, false. The default is false. + + + + + Gets or sets the reference loop handling used when serializing the collection's items. + + The reference loop handling. + + + + Gets or sets the type name handling used when serializing the collection's items. + + The type name handling. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Provides methods for converting between .NET types and JSON types. + + + + + + + + Gets or sets a function that creates default . + Default settings are automatically used by serialization methods on , + and and on . + To serialize without using any default settings create a with + . + + + + + Represents JavaScript's boolean value true as a string. This field is read-only. + + + + + Represents JavaScript's boolean value false as a string. This field is read-only. + + + + + Represents JavaScript's null as a string. This field is read-only. + + + + + Represents JavaScript's undefined as a string. This field is read-only. + + + + + Represents JavaScript's positive infinity as a string. This field is read-only. + + + + + Represents JavaScript's negative infinity as a string. This field is read-only. + + + + + Represents JavaScript's NaN as a string. This field is read-only. + + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation using the specified. + + The value to convert. + The format the date will be converted to. + The time zone handling when the date is converted to a string. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation using the specified. + + The value to convert. + The format the date will be converted to. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + The string delimiter character. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + The string delimiter character. + The string escape handling. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Serializes the specified object to a JSON string. + + The object to serialize. + A JSON string representation of the object. + + + + Serializes the specified object to a JSON string using formatting. + + The object to serialize. + Indicates how the output should be formatted. + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using a collection of . + + The object to serialize. + A collection of converters used while serializing. + A JSON string representation of the object. + + + + Serializes the specified object to a JSON string using formatting and a collection of . + + The object to serialize. + Indicates how the output should be formatted. + A collection of converters used while serializing. + A JSON string representation of the object. + + + + Serializes the specified object to a JSON string using . + + The object to serialize. + The used to serialize the object. + If this is null, default serialization settings will be used. + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using a type, formatting and . + + The object to serialize. + The used to serialize the object. + If this is null, default serialization settings will be used. + + The type of the value being serialized. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using formatting and . + + The object to serialize. + Indicates how the output should be formatted. + The used to serialize the object. + If this is null, default serialization settings will be used. + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using a type, formatting and . + + The object to serialize. + Indicates how the output should be formatted. + The used to serialize the object. + If this is null, default serialization settings will be used. + + The type of the value being serialized. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + A JSON string representation of the object. + + + + + Deserializes the JSON to a .NET object. + + The JSON to deserialize. + The deserialized object from the JSON string. + + + + Deserializes the JSON to a .NET object using . + + The JSON to deserialize. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type. + + The JSON to deserialize. + The of object being deserialized. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type. + + The type of the object to deserialize to. + The JSON to deserialize. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the given anonymous type. + + + The anonymous type to deserialize to. This can't be specified + traditionally and must be inferred from the anonymous type passed + as a parameter. + + The JSON to deserialize. + The anonymous type object. + The deserialized anonymous type from the JSON string. + + + + Deserializes the JSON to the given anonymous type using . + + + The anonymous type to deserialize to. This can't be specified + traditionally and must be inferred from the anonymous type passed + as a parameter. + + The JSON to deserialize. + The anonymous type object. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized anonymous type from the JSON string. + + + + Deserializes the JSON to the specified .NET type using a collection of . + + The type of the object to deserialize to. + The JSON to deserialize. + Converters to use while deserializing. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type using . + + The type of the object to deserialize to. + The object to deserialize. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type using a collection of . + + The JSON to deserialize. + The type of the object to deserialize. + Converters to use while deserializing. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type using . + + The JSON to deserialize. + The type of the object to deserialize to. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized object from the JSON string. + + + + Populates the object with values from the JSON string. + + The JSON to populate values from. + The target object to populate values onto. + + + + Populates the object with values from the JSON string using . + + The JSON to populate values from. + The target object to populate values onto. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + + + + Serializes the to a JSON string. + + The node to serialize. + A JSON string of the . + + + + Serializes the to a JSON string using formatting. + + The node to serialize. + Indicates how the output should be formatted. + A JSON string of the . + + + + Serializes the to a JSON string using formatting and omits the root object if is true. + + The node to serialize. + Indicates how the output should be formatted. + Omits writing the root object. + A JSON string of the . + + + + Deserializes the from a JSON string. + + The JSON string. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by . + + The JSON string. + The name of the root element to append when deserializing. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by , + writes a Json.NET array attribute for collections, and encodes special characters. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + + A value to indicate whether to encode special characters when converting JSON to XML. + If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify + XML namespaces, attributes or processing directives. Instead special characters are encoded and written + as part of the XML element name. + + The deserialized . + + + + Serializes the to a JSON string. + + The node to convert to JSON. + A JSON string of the . + + + + Serializes the to a JSON string using formatting. + + The node to convert to JSON. + Indicates how the output should be formatted. + A JSON string of the . + + + + Serializes the to a JSON string using formatting and omits the root object if is true. + + The node to serialize. + Indicates how the output should be formatted. + Omits writing the root object. + A JSON string of the . + + + + Deserializes the from a JSON string. + + The JSON string. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by . + + The JSON string. + The name of the root element to append when deserializing. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by , + writes a Json.NET array attribute for collections, and encodes special characters. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + + A value to indicate whether to encode special characters when converting JSON to XML. + If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify + XML namespaces, attributes or processing directives. Instead special characters are encoded and written + as part of the XML element name. + + The deserialized . + + + + Converts an object to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can read JSON. + + true if this can read JSON; otherwise, false. + + + + Gets a value indicating whether this can write JSON. + + true if this can write JSON; otherwise, false. + + + + Converts an object to and from JSON. + + The object type to convert. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. If there is no existing value then null will be used. + The existing value has a value. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Instructs the to use the specified when serializing the member or class. + + + + + Gets the of the . + + The of the . + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + + + + + Initializes a new instance of the class. + + Type of the . + + + + Initializes a new instance of the class. + + Type of the . + Parameter list to use when constructing the . Can be null. + + + + Represents a collection of . + + + + + Instructs the how to serialize the collection. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + The exception thrown when an error occurs during JSON serialization or deserialization. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Instructs the to deserialize properties with no matching class member into the specified collection + and write values during serialization. + + + + + Gets or sets a value that indicates whether to write extension data when serializing the object. + + + true to write extension data when serializing the object; otherwise, false. The default is true. + + + + + Gets or sets a value that indicates whether to read extension data when deserializing the object. + + + true to read extension data when deserializing the object; otherwise, false. The default is true. + + + + + Initializes a new instance of the class. + + + + + Instructs the not to serialize the public field or public read/write property value. + + + + + Base class for a table of atomized string objects. + + + + + Gets a string containing the same characters as the specified range of characters in the given array. + + The character array containing the name to find. + The zero-based index into the array specifying the first character of the name. + The number of characters in the name. + A string containing the same characters as the specified range of characters in the given array. + + + + Instructs the how to serialize the object. + + + + + Gets or sets the member serialization. + + The member serialization. + + + + Gets or sets the missing member handling used when deserializing this object. + + The missing member handling. + + + + Gets or sets how the object's properties with null values are handled during serialization and deserialization. + + How the object's properties with null values are handled during serialization and deserialization. + + + + Gets or sets a value that indicates whether the object's properties are required. + + + A value indicating whether the object's properties are required. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified member serialization. + + The member serialization. + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Instructs the to always serialize the member with the specified name. + + + + + Gets or sets the type used when serializing the property's collection items. + + The collection's items type. + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets the of the . + + The of the . + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets the null value handling used when serializing this property. + + The null value handling. + + + + Gets or sets the default value handling used when serializing this property. + + The default value handling. + + + + Gets or sets the reference loop handling used when serializing this property. + + The reference loop handling. + + + + Gets or sets the object creation handling used when deserializing this property. + + The object creation handling. + + + + Gets or sets the type name handling used when serializing this property. + + The type name handling. + + + + Gets or sets whether this property's value is serialized as a reference. + + Whether this property's value is serialized as a reference. + + + + Gets or sets the order of serialization of a member. + + The numeric order of serialization. + + + + Gets or sets a value indicating whether this property is required. + + + A value indicating whether this property is required. + + + + + Gets or sets the name of the property. + + The name of the property. + + + + Gets or sets the reference loop handling used when serializing the property's collection items. + + The collection's items reference loop handling. + + + + Gets or sets the type name handling used when serializing the property's collection items. + + The collection's items type name handling. + + + + Gets or sets whether this property's collection items are serialized as a reference. + + Whether this property's collection items are serialized as a reference. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified name. + + Name of the property. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + + + Specifies the state of the reader. + + + + + A read method has not been called. + + + + + The end of the file has been reached successfully. + + + + + Reader is at a property. + + + + + Reader is at the start of an object. + + + + + Reader is in an object. + + + + + Reader is at the start of an array. + + + + + Reader is in an array. + + + + + The method has been called. + + + + + Reader has just read a value. + + + + + Reader is at the start of a constructor. + + + + + Reader is in a constructor. + + + + + An error occurred that prevents the read operation from continuing. + + + + + The end of the file has been reached successfully. + + + + + Gets the current reader state. + + The current reader state. + + + + Gets or sets a value indicating whether the source should be closed when this reader is closed. + + + true to close the source when this reader is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether multiple pieces of JSON content can + be read from a continuous stream without erroring. + + + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. + + + + + Gets the quotation mark character used to enclose the value of a string. + + + + + Gets or sets how time zones are handled when reading JSON. + + + + + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + + + + + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + + + + + Gets or sets how custom date formatted strings are parsed when reading JSON. + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + + + + + Gets the type of the current JSON token. + + + + + Gets the text value of the current JSON token. + + + + + Gets the .NET type for the current JSON token. + + + + + Gets the depth of the current token in the JSON document. + + The depth of the current token in the JSON document. + + + + Gets the path of the current JSON token. + + + + + Gets or sets the culture used when reading JSON. Defaults to . + + + + + Initializes a new instance of the class. + + + + + Reads the next JSON token from the source. + + true if the next token was read successfully; false if there are no more tokens to read. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a []. + + A [] or null if the next JSON token is null. This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Skips the children of the current token. + + + + + Sets the current token. + + The new token. + + + + Sets the current token and value. + + The new token. + The value. + + + + Sets the current token and value. + + The new token. + The value. + A flag indicating whether the position index inside an array should be updated. + + + + Sets the state based on current token type. + + + + + Releases unmanaged and - optionally - managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Changes the reader's state to . + If is set to true, the source is also closed. + + + + + The exception thrown when an error occurs while reading JSON text. + + + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Initializes a new instance of the class + with a specified error message, JSON path, line number, line position, and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The path to the JSON where the error occurred. + The line number indicating where the error occurred. + The line position indicating where the error occurred. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Instructs the to always serialize the member, and to require that the member has a value. + + + + + The exception thrown when an error occurs during JSON serialization or deserialization. + + + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Initializes a new instance of the class + with a specified error message, JSON path, line number, line position, and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The path to the JSON where the error occurred. + The line number indicating where the error occurred. + The line position indicating where the error occurred. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Serializes and deserializes objects into and from the JSON format. + The enables you to control how objects are encoded into JSON. + + + + + Occurs when the errors during serialization and deserialization. + + + + + Gets or sets the used by the serializer when resolving references. + + + + + Gets or sets the used by the serializer when resolving type names. + + + + + Gets or sets the used by the serializer when resolving type names. + + + + + Gets or sets the used by the serializer when writing trace messages. + + The trace writer. + + + + Gets or sets the equality comparer used by the serializer when comparing references. + + The equality comparer. + + + + Gets or sets how type name writing and reading is handled by the serializer. + The default value is . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how object references are preserved by the serializer. + The default value is . + + + + + Gets or sets how reference loops (e.g. a class referencing itself) is handled. + The default value is . + + + + + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + The default value is . + + + + + Gets or sets how null values are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how default values are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how objects are created during deserialization. + The default value is . + + The object creation handling. + + + + Gets or sets how constructors are used during deserialization. + The default value is . + + The constructor handling. + + + + Gets or sets how metadata properties are used during deserialization. + The default value is . + + The metadata properties handling. + + + + Gets a collection that will be used during serialization. + + Collection that will be used during serialization. + + + + Gets or sets the contract resolver used by the serializer when + serializing .NET objects to JSON and vice versa. + + + + + Gets or sets the used by the serializer when invoking serialization callback methods. + + The context. + + + + Indicates how JSON text output is formatted. + The default value is . + + + + + Gets or sets how dates are written to JSON text. + The default value is . + + + + + Gets or sets how time zones are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + The default value is . + + + + + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + The default value is . + + + + + Gets or sets how special floating point numbers, e.g. , + and , + are written as JSON text. + The default value is . + + + + + Gets or sets how strings are escaped when writing JSON text. + The default value is . + + + + + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. + The default value is "yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK". + + + + + Gets or sets the culture used when reading JSON. + The default value is . + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + A null value means there is no maximum. + The default value is null. + + + + + Gets a value indicating whether there will be a check for additional JSON content after deserializing an object. + The default value is false. + + + true if there will be a check for additional JSON content after deserializing an object; otherwise, false. + + + + + Initializes a new instance of the class. + + + + + Creates a new instance. + The will not use default settings + from . + + + A new instance. + The will not use default settings + from . + + + + + Creates a new instance using the specified . + The will not use default settings + from . + + The settings to be applied to the . + + A new instance using the specified . + The will not use default settings + from . + + + + + Creates a new instance. + The will use default settings + from . + + + A new instance. + The will use default settings + from . + + + + + Creates a new instance using the specified . + The will use default settings + from as well as the specified . + + The settings to be applied to the . + + A new instance using the specified . + The will use default settings + from as well as the specified . + + + + + Populates the JSON values onto the target object. + + The that contains the JSON structure to read values from. + The target object to populate values onto. + + + + Populates the JSON values onto the target object. + + The that contains the JSON structure to read values from. + The target object to populate values onto. + + + + Deserializes the JSON structure contained by the specified . + + The that contains the JSON structure to deserialize. + The being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The of object being deserialized. + The instance of being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The type of the object to deserialize. + The instance of being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The of object being deserialized. + The instance of being deserialized. + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + The type of the value being serialized. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + The type of the value being serialized. + This parameter is used when is Auto to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + + + Specifies the settings on a object. + + + + + Gets or sets how reference loops (e.g. a class referencing itself) are handled. + The default value is . + + Reference loop handling. + + + + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + The default value is . + + Missing member handling. + + + + Gets or sets how objects are created during deserialization. + The default value is . + + The object creation handling. + + + + Gets or sets how null values are handled during serialization and deserialization. + The default value is . + + Null value handling. + + + + Gets or sets how default values are handled during serialization and deserialization. + The default value is . + + The default value handling. + + + + Gets or sets a collection that will be used during serialization. + + The converters. + + + + Gets or sets how object references are preserved by the serializer. + The default value is . + + The preserve references handling. + + + + Gets or sets how type name writing and reading is handled by the serializer. + The default value is . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + The type name handling. + + + + Gets or sets how metadata properties are used during deserialization. + The default value is . + + The metadata properties handling. + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how constructors are used during deserialization. + The default value is . + + The constructor handling. + + + + Gets or sets the contract resolver used by the serializer when + serializing .NET objects to JSON and vice versa. + + The contract resolver. + + + + Gets or sets the equality comparer used by the serializer when comparing references. + + The equality comparer. + + + + Gets or sets the used by the serializer when resolving references. + + The reference resolver. + + + + Gets or sets a function that creates the used by the serializer when resolving references. + + A function that creates the used by the serializer when resolving references. + + + + Gets or sets the used by the serializer when writing trace messages. + + The trace writer. + + + + Gets or sets the used by the serializer when resolving type names. + + The binder. + + + + Gets or sets the used by the serializer when resolving type names. + + The binder. + + + + Gets or sets the error handler called during serialization and deserialization. + + The error handler called during serialization and deserialization. + + + + Gets or sets the used by the serializer when invoking serialization callback methods. + + The context. + + + + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. + The default value is "yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK". + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + A null value means there is no maximum. + The default value is null. + + + + + Indicates how JSON text output is formatted. + The default value is . + + + + + Gets or sets how dates are written to JSON text. + The default value is . + + + + + Gets or sets how time zones are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + The default value is . + + + + + Gets or sets how special floating point numbers, e.g. , + and , + are written as JSON. + The default value is . + + + + + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + The default value is . + + + + + Gets or sets how strings are escaped when writing JSON text. + The default value is . + + + + + Gets or sets the culture used when reading JSON. + The default value is . + + + + + Gets a value indicating whether there will be a check for additional content after deserializing an object. + The default value is false. + + + true if there will be a check for additional content after deserializing an object; otherwise, false. + + + + + Initializes a new instance of the class. + + + + + Represents a reader that provides fast, non-cached, forward-only access to JSON text data. + + + + + Initializes a new instance of the class with the specified . + + The containing the JSON data to read. + + + + Gets or sets the reader's property name table. + + + + + Gets or sets the reader's character buffer pool. + + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a []. + + A [] or null if the next JSON token is null. This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Gets a value indicating whether the class can return line information. + + + true if and can be provided; otherwise, false. + + + + + Gets the current line number. + + + The current line number or 0 if no line information is available (for example, returns false). + + + + + Gets the current line position. + + + The current line position or 0 if no line information is available (for example, returns false). + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets or sets the writer's character array pool. + + + + + Gets or sets how many s to write for each level in the hierarchy when is set to . + + + + + Gets or sets which character to use to quote attribute values. + + + + + Gets or sets which character to use for indenting when is set to . + + + + + Gets or sets a value indicating whether object names will be surrounded with quotes. + + + + + Initializes a new instance of the class using the specified . + + The to write to. + + + + Flushes whatever is in the buffer to the underlying and also flushes the underlying . + + + + + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes the beginning of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the specified end token. + + The end token to write. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + + + + Writes indent characters. + + + + + Writes the JSON value delimiter. + + + + + Writes an indent space. + + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a value. + + The value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the given white space. + + The string of white space characters. + + + + Specifies the type of JSON token. + + + + + This is returned by the if a read method has not been called. + + + + + An object start token. + + + + + An array start token. + + + + + A constructor start token. + + + + + An object property name. + + + + + A comment. + + + + + Raw JSON. + + + + + An integer. + + + + + A float. + + + + + A string. + + + + + A boolean. + + + + + A null token. + + + + + An undefined token. + + + + + An object end token. + + + + + An array end token. + + + + + A constructor end token. + + + + + A Date. + + + + + Byte data. + + + + + + Represents a reader that provides validation. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Sets an event handler for receiving schema validation errors. + + + + + Gets the text value of the current JSON token. + + + + + + Gets the depth of the current token in the JSON document. + + The depth of the current token in the JSON document. + + + + Gets the path of the current JSON token. + + + + + Gets the quotation mark character used to enclose the value of a string. + + + + + + Gets the type of the current JSON token. + + + + + + Gets the .NET type for the current JSON token. + + + + + + Initializes a new instance of the class that + validates the content returned from the given . + + The to read from while validating. + + + + Gets or sets the schema. + + The schema. + + + + Gets the used to construct this . + + The specified in the constructor. + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a []. + + + A [] or null if the next JSON token is null. + + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets or sets a value indicating whether the destination should be closed when this writer is closed. + + + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. + + + + + Gets the top. + + The top. + + + + Gets the state of the writer. + + + + + Gets the path of the writer. + + + + + Gets or sets a value indicating how JSON text output should be formatted. + + + + + Gets or sets how dates are written to JSON text. + + + + + Gets or sets how time zones are handled when writing JSON text. + + + + + Gets or sets how strings are escaped when writing JSON text. + + + + + Gets or sets how special floating point numbers, e.g. , + and , + are written to JSON text. + + + + + Gets or sets how and values are formatted when writing JSON text. + + + + + Gets or sets the culture used when writing JSON. Defaults to . + + + + + Initializes a new instance of the class. + + + + + Flushes whatever is in the buffer to the destination and also flushes the destination. + + + + + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes the beginning of a JSON object. + + + + + Writes the end of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the end of an array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the end constructor. + + + + + Writes the property name of a name/value pair of a JSON object. + + The name of the property. + + + + Writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + + + + Writes the end of the current JSON object or array. + + + + + Writes the current token and its children. + + The to read the token from. + + + + Writes the current token. + + The to read the token from. + A flag indicating whether the current token's children should be written. + + + + Writes the token and its value. + + The to write. + + The value to write. + A value is only required for tokens that have an associated value, e.g. the property name for . + null can be passed to the method for tokens that don't have a value, e.g. . + + + + + Writes the token. + + The to write. + + + + Writes the specified end token. + + The end token to write. + + + + Writes indent characters. + + + + + Writes the JSON value delimiter. + + + + + Writes an indent space. + + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON without changing the writer's state. + + The raw JSON to write. + + + + Writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the given white space. + + The string of white space characters. + + + + Releases unmanaged and - optionally - managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Sets the state of the . + + The being written. + The value being written. + + + + The exception thrown when an error occurs while writing JSON text. + + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Initializes a new instance of the class + with a specified error message, JSON path and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The path to the JSON where the error occurred. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Specifies how JSON comments are handled when loading JSON. + + + + + Ignore comments. + + + + + Load comments as a with type . + + + + + Specifies how duplicate property names are handled when loading JSON. + + + + + Replace the existing value when there is a duplicate property. The value of the last property in the JSON object will be used. + + + + + Ignore the new value when there is a duplicate property. The value of the first property in the JSON object will be used. + + + + + Throw a when a duplicate property is encountered. + + + + + Contains the LINQ to JSON extension methods. + + + + + Returns a collection of tokens that contains the ancestors of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains the ancestors of every token in the source collection. + + + + Returns a collection of tokens that contains every token in the source collection, and the ancestors of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains every token in the source collection, the ancestors of every token in the source collection. + + + + Returns a collection of tokens that contains the descendants of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains the descendants of every token in the source collection. + + + + Returns a collection of tokens that contains every token in the source collection, and the descendants of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains every token in the source collection, and the descendants of every token in the source collection. + + + + Returns a collection of child properties of every object in the source collection. + + An of that contains the source collection. + An of that contains the properties of every object in the source collection. + + + + Returns a collection of child values of every object in the source collection with the given key. + + An of that contains the source collection. + The token key. + An of that contains the values of every token in the source collection with the given key. + + + + Returns a collection of child values of every object in the source collection. + + An of that contains the source collection. + An of that contains the values of every token in the source collection. + + + + Returns a collection of converted child values of every object in the source collection with the given key. + + The type to convert the values to. + An of that contains the source collection. + The token key. + An that contains the converted values of every token in the source collection with the given key. + + + + Returns a collection of converted child values of every object in the source collection. + + The type to convert the values to. + An of that contains the source collection. + An that contains the converted values of every token in the source collection. + + + + Converts the value. + + The type to convert the value to. + A cast as a of . + A converted value. + + + + Converts the value. + + The source collection type. + The type to convert the value to. + A cast as a of . + A converted value. + + + + Returns a collection of child tokens of every array in the source collection. + + The source collection type. + An of that contains the source collection. + An of that contains the values of every token in the source collection. + + + + Returns a collection of converted child tokens of every array in the source collection. + + An of that contains the source collection. + The type to convert the values to. + The source collection type. + An that contains the converted values of every token in the source collection. + + + + Returns the input typed as . + + An of that contains the source collection. + The input typed as . + + + + Returns the input typed as . + + The source collection type. + An of that contains the source collection. + The input typed as . + + + + Represents a collection of objects. + + The type of token. + + + + Gets the of with the specified key. + + + + + + Represents a JSON array. + + + + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified content. + + The contents of the array. + + + + Initializes a new instance of the class with the specified content. + + The contents of the array. + + + + Loads an from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads an from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + + + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + + + + + + Creates a from an object. + + The object that will be used to create . + A with the values of the specified object. + + + + Creates a from an object. + + The object that will be used to create . + The that will be used to read the object. + A with the values of the specified object. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets or sets the at the specified index. + + + + + + Determines the index of a specific item in the . + + The object to locate in the . + + The index of if found in the list; otherwise, -1. + + + + + Inserts an item to the at the specified index. + + The zero-based index at which should be inserted. + The object to insert into the . + + is not a valid index in the . + + + + + Removes the item at the specified index. + + The zero-based index of the item to remove. + + is not a valid index in the . + + + + + Returns an enumerator that iterates through the collection. + + + A of that can be used to iterate through the collection. + + + + + Adds an item to the . + + The object to add to the . + + + + Removes all items from the . + + + + + Determines whether the contains a specific value. + + The object to locate in the . + + true if is found in the ; otherwise, false. + + + + + Copies the elements of the to an array, starting at a particular array index. + + The array. + Index of the array. + + + + Gets a value indicating whether the is read-only. + + true if the is read-only; otherwise, false. + + + + Removes the first occurrence of a specific object from the . + + The object to remove from the . + + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + + + + + Represents a JSON constructor. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets or sets the name of this constructor. + + The constructor name. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified name and content. + + The constructor name. + The contents of the constructor. + + + + Initializes a new instance of the class with the specified name and content. + + The constructor name. + The contents of the constructor. + + + + Initializes a new instance of the class with the specified name. + + The constructor name. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified key. + + The with the specified key. + + + + Loads a from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Represents a token that can contain other tokens. + + + + + Occurs when the list changes or an item in the list changes. + + + + + Occurs before an item is added to the collection. + + + + + Occurs when the items list of the collection has changed, or the collection is reset. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Raises the event. + + The instance containing the event data. + + + + Raises the event. + + The instance containing the event data. + + + + Raises the event. + + The instance containing the event data. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Get the first child token of this token. + + + A containing the first child token of the . + + + + + Get the last child token of this token. + + + A containing the last child token of the . + + + + + Returns a collection of the child tokens of this token, in document order. + + + An of containing the child tokens of this , in document order. + + + + + Returns a collection of the child values of this token, in document order. + + The type to convert the values to. + + A containing the child values of this , in document order. + + + + + Returns a collection of the descendant tokens for this token in document order. + + An of containing the descendant tokens of the . + + + + Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. + + An of containing this token, and all the descendant tokens of the . + + + + Adds the specified content as children of this . + + The content to be added. + + + + Adds the specified content as the first children of this . + + The content to be added. + + + + Creates a that can be used to add tokens to the . + + A that is ready to have content written to it. + + + + Replaces the child nodes of this token with the specified content. + + The content. + + + + Removes the child nodes from this token. + + + + + Merge the specified content into this . + + The content to be merged. + + + + Merge the specified content into this using . + + The content to be merged. + The used to merge the content. + + + + Gets the count of child JSON tokens. + + The count of child JSON tokens. + + + + Represents a collection of objects. + + The type of token. + + + + An empty collection of objects. + + + + + Initializes a new instance of the struct. + + The enumerable. + + + + Returns an enumerator that can be used to iterate through the collection. + + + A that can be used to iterate through the collection. + + + + + Gets the of with the specified key. + + + + + + Determines whether the specified is equal to this instance. + + The to compare with this instance. + + true if the specified is equal to this instance; otherwise, false. + + + + + Determines whether the specified is equal to this instance. + + The to compare with this instance. + + true if the specified is equal to this instance; otherwise, false. + + + + + Returns a hash code for this instance. + + + A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table. + + + + + Represents a JSON object. + + + + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Occurs when a property value changes. + + + + + Occurs when a property value is changing. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified content. + + The contents of the object. + + + + Initializes a new instance of the class with the specified content. + + The contents of the object. + + + + Gets the node type for this . + + The type. + + + + Gets an of of this object's properties. + + An of of this object's properties. + + + + Gets a with the specified name. + + The property name. + A with the specified name or null. + + + + Gets the with the specified name. + The exact name will be searched for first and if no matching property is found then + the will be used to match a property. + + The property name. + One of the enumeration values that specifies how the strings will be compared. + A matched with the specified name or null. + + + + Gets a of of this object's property values. + + A of of this object's property values. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets or sets the with the specified property name. + + + + + + Loads a from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + is not valid JSON. + + + + + Loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + is not valid JSON. + + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + is not valid JSON. + + + + + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + is not valid JSON. + + + + + + + + Creates a from an object. + + The object that will be used to create . + A with the values of the specified object. + + + + Creates a from an object. + + The object that will be used to create . + The that will be used to read the object. + A with the values of the specified object. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified property name. + + Name of the property. + The with the specified property name. + + + + Gets the with the specified property name. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + Name of the property. + One of the enumeration values that specifies how the strings will be compared. + The with the specified property name. + + + + Tries to get the with the specified property name. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + Name of the property. + The value. + One of the enumeration values that specifies how the strings will be compared. + true if a value was successfully retrieved; otherwise, false. + + + + Adds the specified property name. + + Name of the property. + The value. + + + + Determines whether the JSON object has the specified property name. + + Name of the property. + true if the JSON object has the specified property name; otherwise, false. + + + + Removes the property with the specified name. + + Name of the property. + true if item was successfully removed; otherwise, false. + + + + Tries to get the with the specified property name. + + Name of the property. + The value. + true if a value was successfully retrieved; otherwise, false. + + + + Returns an enumerator that can be used to iterate through the collection. + + + A that can be used to iterate through the collection. + + + + + Raises the event with the provided arguments. + + Name of the property. + + + + Raises the event with the provided arguments. + + Name of the property. + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Represents a JSON property. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets the property name. + + The property name. + + + + Gets or sets the property value. + + The property value. + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + The property name. + The property content. + + + + Initializes a new instance of the class. + + The property name. + The property content. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Loads a from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Represents a view of a . + + + + + Initializes a new instance of the class. + + The name. + + + + When overridden in a derived class, returns whether resetting an object changes its value. + + + true if resetting the component changes its value; otherwise, false. + + The component to test for reset capability. + + + + When overridden in a derived class, gets the current value of the property on a component. + + + The value of a property for a given component. + + The component with the property for which to retrieve the value. + + + + When overridden in a derived class, resets the value for this property of the component to the default value. + + The component with the property value that is to be reset to the default value. + + + + When overridden in a derived class, sets the value of the component to a different value. + + The component with the property value that is to be set. + The new value. + + + + When overridden in a derived class, determines a value indicating whether the value of this property needs to be persisted. + + + true if the property should be persisted; otherwise, false. + + The component with the property to be examined for persistence. + + + + When overridden in a derived class, gets the type of the component this property is bound to. + + + A that represents the type of component this property is bound to. + When the or + + methods are invoked, the object specified might be an instance of this type. + + + + + When overridden in a derived class, gets a value indicating whether this property is read-only. + + + true if the property is read-only; otherwise, false. + + + + + When overridden in a derived class, gets the type of the property. + + + A that represents the type of the property. + + + + + Gets the hash code for the name of the member. + + + + The hash code for the name of the member. + + + + + Represents a raw JSON string. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class. + + The raw json. + + + + Creates an instance of with the content of the reader's current token. + + The reader. + An instance of with the content of the reader's current token. + + + + Specifies the settings used when loading JSON. + + + + + Initializes a new instance of the class. + + + + + Gets or sets how JSON comments are handled when loading JSON. + The default value is . + + The JSON comment handling. + + + + Gets or sets how JSON line info is handled when loading JSON. + The default value is . + + The JSON line info handling. + + + + Gets or sets how duplicate property names in JSON objects are handled when loading JSON. + The default value is . + + The JSON duplicate property name handling. + + + + Specifies the settings used when merging JSON. + + + + + Initializes a new instance of the class. + + + + + Gets or sets the method used when merging JSON arrays. + + The method used when merging JSON arrays. + + + + Gets or sets how null value properties are merged. + + How null value properties are merged. + + + + Gets or sets the comparison used to match property names while merging. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + The comparison used to match property names while merging. + + + + Represents an abstract JSON token. + + + + + Gets a comparer that can compare two tokens for value equality. + + A that can compare two nodes for value equality. + + + + Gets or sets the parent. + + The parent. + + + + Gets the root of this . + + The root of this . + + + + Gets the node type for this . + + The type. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Compares the values of two tokens, including the values of all descendant tokens. + + The first to compare. + The second to compare. + true if the tokens are equal; otherwise false. + + + + Gets the next sibling token of this node. + + The that contains the next sibling token. + + + + Gets the previous sibling token of this node. + + The that contains the previous sibling token. + + + + Gets the path of the JSON token. + + + + + Adds the specified content immediately after this token. + + A content object that contains simple content or a collection of content objects to be added after this token. + + + + Adds the specified content immediately before this token. + + A content object that contains simple content or a collection of content objects to be added before this token. + + + + Returns a collection of the ancestor tokens of this token. + + A collection of the ancestor tokens of this token. + + + + Returns a collection of tokens that contain this token, and the ancestors of this token. + + A collection of tokens that contain this token, and the ancestors of this token. + + + + Returns a collection of the sibling tokens after this token, in document order. + + A collection of the sibling tokens after this tokens, in document order. + + + + Returns a collection of the sibling tokens before this token, in document order. + + A collection of the sibling tokens before this token, in document order. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets the with the specified key converted to the specified type. + + The type to convert the token to. + The token key. + The converted token value. + + + + Get the first child token of this token. + + A containing the first child token of the . + + + + Get the last child token of this token. + + A containing the last child token of the . + + + + Returns a collection of the child tokens of this token, in document order. + + An of containing the child tokens of this , in document order. + + + + Returns a collection of the child tokens of this token, in document order, filtered by the specified type. + + The type to filter the child tokens on. + A containing the child tokens of this , in document order. + + + + Returns a collection of the child values of this token, in document order. + + The type to convert the values to. + A containing the child values of this , in document order. + + + + Removes this token from its parent. + + + + + Replaces this token with the specified token. + + The value. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Returns the indented JSON for this token. + + + ToString() returns a non-JSON string value for tokens with a type of . + If you want the JSON for all token types then you should use . + + + The indented JSON for this token. + + + + + Returns the JSON for this token using the given formatting and converters. + + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. + The JSON for this token using the given formatting and converters. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to []. + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from [] to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Creates a for this token. + + A that can be used to read this token and its descendants. + + + + Creates a from an object. + + The object that will be used to create . + A with the value of the specified object. + + + + Creates a from an object using the specified . + + The object that will be used to create . + The that will be used when reading the object. + A with the value of the specified object. + + + + Creates an instance of the specified .NET type from the . + + The object type that the token will be deserialized to. + The new object created from the JSON value. + + + + Creates an instance of the specified .NET type from the . + + The object type that the token will be deserialized to. + The new object created from the JSON value. + + + + Creates an instance of the specified .NET type from the using the specified . + + The object type that the token will be deserialized to. + The that will be used when creating the object. + The new object created from the JSON value. + + + + Creates an instance of the specified .NET type from the using the specified . + + The object type that the token will be deserialized to. + The that will be used when creating the object. + The new object created from the JSON value. + + + + Creates a from a . + + A positioned at the token to read into this . + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Creates a from a . + + An positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + + + Creates a from a . + + A positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Creates a from a . + + A positioned at the token to read into this . + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Selects a using a JSONPath expression. Selects the token that matches the object path. + + + A that contains a JSONPath expression. + + A , or null. + + + + Selects a using a JSONPath expression. Selects the token that matches the object path. + + + A that contains a JSONPath expression. + + A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. + A . + + + + Selects a collection of elements using a JSONPath expression. + + + A that contains a JSONPath expression. + + An of that contains the selected elements. + + + + Selects a collection of elements using a JSONPath expression. + + + A that contains a JSONPath expression. + + A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. + An of that contains the selected elements. + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Creates a new instance of the . All child tokens are recursively cloned. + + A new instance of the . + + + + Adds an object to the annotation list of this . + + The annotation to add. + + + + Get the first annotation object of the specified type from this . + + The type of the annotation to retrieve. + The first annotation object that matches the specified type, or null if no annotation is of the specified type. + + + + Gets the first annotation object of the specified type from this . + + The of the annotation to retrieve. + The first annotation object that matches the specified type, or null if no annotation is of the specified type. + + + + Gets a collection of annotations of the specified type for this . + + The type of the annotations to retrieve. + An that contains the annotations for this . + + + + Gets a collection of annotations of the specified type for this . + + The of the annotations to retrieve. + An of that contains the annotations that match the specified type for this . + + + + Removes the annotations of the specified type from this . + + The type of annotations to remove. + + + + Removes the annotations of the specified type from this . + + The of annotations to remove. + + + + Compares tokens to determine whether they are equal. + + + + + Determines whether the specified objects are equal. + + The first object of type to compare. + The second object of type to compare. + + true if the specified objects are equal; otherwise, false. + + + + + Returns a hash code for the specified object. + + The for which a hash code is to be returned. + A hash code for the specified object. + The type of is a reference type and is null. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + + + Gets the at the reader's current position. + + + + + Initializes a new instance of the class. + + The token to read from. + + + + Initializes a new instance of the class. + + The token to read from. + The initial path of the token. It is prepended to the returned . + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Gets the path of the current JSON token. + + + + + Specifies the type of token. + + + + + No token type has been set. + + + + + A JSON object. + + + + + A JSON array. + + + + + A JSON constructor. + + + + + A JSON object property. + + + + + A comment. + + + + + An integer value. + + + + + A float value. + + + + + A string value. + + + + + A boolean value. + + + + + A null value. + + + + + An undefined value. + + + + + A date value. + + + + + A raw JSON value. + + + + + A collection of bytes value. + + + + + A Guid value. + + + + + A Uri value. + + + + + A TimeSpan value. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets the at the writer's current position. + + + + + Gets the token being written. + + The token being written. + + + + Initializes a new instance of the class writing to the given . + + The container being written to. + + + + Initializes a new instance of the class. + + + + + Flushes whatever is in the buffer to the underlying . + + + + + Closes this writer. + If is set to true, the JSON is auto-completed. + + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + + + + + Writes the beginning of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the end. + + The token. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Writes a value. + An error will be raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Represents a value in JSON (string, integer, date, etc). + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Creates a comment with the given value. + + The value. + A comment with the given value. + + + + Creates a string with the given value. + + The value. + A string with the given value. + + + + Creates a null value. + + A null value. + + + + Creates a undefined value. + + A undefined value. + + + + Gets the node type for this . + + The type. + + + + Gets or sets the underlying token value. + + The underlying token value. + + + + Writes this token to a . + + A into which this method will write. + A collection of s which will be used when writing the token. + + + + Indicates whether the current object is equal to another object of the same type. + + + true if the current object is equal to the parameter; otherwise, false. + + An object to compare with this object. + + + + Determines whether the specified is equal to the current . + + The to compare with the current . + + true if the specified is equal to the current ; otherwise, false. + + + + + Serves as a hash function for a particular type. + + + A hash code for the current . + + + + + Returns a that represents this instance. + + + ToString() returns a non-JSON string value for tokens with a type of . + If you want the JSON for all token types then you should use . + + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format. + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format provider. + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format. + The format provider. + + A that represents this instance. + + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object. + + An object to compare with this instance. + + A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has these meanings: + Value + Meaning + Less than zero + This instance is less than . + Zero + This instance is equal to . + Greater than zero + This instance is greater than . + + + is not of the same type as this instance. + + + + + Specifies how line information is handled when loading JSON. + + + + + Ignore line information. + + + + + Load line information. + + + + + Specifies how JSON arrays are merged together. + + + + Concatenate arrays. + + + Union arrays, skipping items that already exist. + + + Replace all array items. + + + Merge array items together, matched by index. + + + + Specifies how null value properties are merged. + + + + + The content's null value properties will be ignored during merging. + + + + + The content's null value properties will be merged. + + + + + Specifies the member serialization options for the . + + + + + All public members are serialized by default. Members can be excluded using or . + This is the default member serialization mode. + + + + + Only members marked with or are serialized. + This member serialization mode can also be set by marking the class with . + + + + + All public and private fields are serialized. Members can be excluded using or . + This member serialization mode can also be set by marking the class with + and setting IgnoreSerializableAttribute on to false. + + + + + Specifies metadata property handling options for the . + + + + + Read metadata properties located at the start of a JSON object. + + + + + Read metadata properties located anywhere in a JSON object. Note that this setting will impact performance. + + + + + Do not try to read metadata properties. + + + + + Specifies missing member handling options for the . + + + + + Ignore a missing member and do not attempt to deserialize it. + + + + + Throw a when a missing member is encountered during deserialization. + + + + + Specifies null value handling options for the . + + + + + + + + + Include null values when serializing and deserializing objects. + + + + + Ignore null values when serializing and deserializing objects. + + + + + Specifies how object creation is handled by the . + + + + + Reuse existing objects, create new objects when needed. + + + + + Only reuse existing objects. + + + + + Always create new objects. + + + + + Specifies reference handling options for the . + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . + + + + + + + + Do not preserve references when serializing types. + + + + + Preserve references when serializing into a JSON object structure. + + + + + Preserve references when serializing into a JSON array structure. + + + + + Preserve references when serializing. + + + + + Specifies reference loop handling options for the . + + + + + Throw a when a loop is encountered. + + + + + Ignore loop references and do not serialize. + + + + + Serialize loop references. + + + + + Indicating whether a property is required. + + + + + The property is not required. The default state. + + + + + The property must be defined in JSON but can be a null value. + + + + + The property must be defined in JSON and cannot be a null value. + + + + + The property is not required but it cannot be a null value. + + + + + + Contains the JSON schema extension methods. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + + Determines whether the is valid. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + + true if the specified is valid; otherwise, false. + + + + + + Determines whether the is valid. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + When this method returns, contains any error messages generated while validating. + + true if the specified is valid; otherwise, false. + + + + + + Validates the specified . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + + + + + Validates the specified . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + The validation event handler. + + + + + An in-memory representation of a JSON Schema. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets or sets the id. + + + + + Gets or sets the title. + + + + + Gets or sets whether the object is required. + + + + + Gets or sets whether the object is read-only. + + + + + Gets or sets whether the object is visible to users. + + + + + Gets or sets whether the object is transient. + + + + + Gets or sets the description of the object. + + + + + Gets or sets the types of values allowed by the object. + + The type. + + + + Gets or sets the pattern. + + The pattern. + + + + Gets or sets the minimum length. + + The minimum length. + + + + Gets or sets the maximum length. + + The maximum length. + + + + Gets or sets a number that the value should be divisible by. + + A number that the value should be divisible by. + + + + Gets or sets the minimum. + + The minimum. + + + + Gets or sets the maximum. + + The maximum. + + + + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). + + A flag indicating whether the value can not equal the number defined by the minimum attribute (). + + + + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). + + A flag indicating whether the value can not equal the number defined by the maximum attribute (). + + + + Gets or sets the minimum number of items. + + The minimum number of items. + + + + Gets or sets the maximum number of items. + + The maximum number of items. + + + + Gets or sets the of items. + + The of items. + + + + Gets or sets a value indicating whether items in an array are validated using the instance at their array position from . + + + true if items are validated using their array position; otherwise, false. + + + + + Gets or sets the of additional items. + + The of additional items. + + + + Gets or sets a value indicating whether additional items are allowed. + + + true if additional items are allowed; otherwise, false. + + + + + Gets or sets whether the array items must be unique. + + + + + Gets or sets the of properties. + + The of properties. + + + + Gets or sets the of additional properties. + + The of additional properties. + + + + Gets or sets the pattern properties. + + The pattern properties. + + + + Gets or sets a value indicating whether additional properties are allowed. + + + true if additional properties are allowed; otherwise, false. + + + + + Gets or sets the required property if this property is present. + + The required property if this property is present. + + + + Gets or sets the a collection of valid enum values allowed. + + A collection of valid enum values allowed. + + + + Gets or sets disallowed types. + + The disallowed types. + + + + Gets or sets the default value. + + The default value. + + + + Gets or sets the collection of that this schema extends. + + The collection of that this schema extends. + + + + Gets or sets the format. + + The format. + + + + Initializes a new instance of the class. + + + + + Reads a from the specified . + + The containing the JSON Schema to read. + The object representing the JSON Schema. + + + + Reads a from the specified . + + The containing the JSON Schema to read. + The to use when resolving schema references. + The object representing the JSON Schema. + + + + Load a from a string that contains JSON Schema. + + A that contains JSON Schema. + A populated from the string that contains JSON Schema. + + + + Load a from a string that contains JSON Schema using the specified . + + A that contains JSON Schema. + The resolver. + A populated from the string that contains JSON Schema. + + + + Writes this schema to a . + + A into which this method will write. + + + + Writes this schema to a using the specified . + + A into which this method will write. + The resolver used. + + + + Returns a that represents the current . + + + A that represents the current . + + + + + + Returns detailed information about the schema exception. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + + Generates a from a specified . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets or sets how undefined schemas are handled by the serializer. + + + + + Gets or sets the contract resolver. + + The contract resolver. + + + + Generate a from the specified type. + + The type to generate a from. + A generated from the specified type. + + + + Generate a from the specified type. + + The type to generate a from. + The used to resolve schema references. + A generated from the specified type. + + + + Generate a from the specified type. + + The type to generate a from. + Specify whether the generated root will be nullable. + A generated from the specified type. + + + + Generate a from the specified type. + + The type to generate a from. + The used to resolve schema references. + Specify whether the generated root will be nullable. + A generated from the specified type. + + + + + Resolves from an id. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets or sets the loaded schemas. + + The loaded schemas. + + + + Initializes a new instance of the class. + + + + + Gets a for the specified reference. + + The id. + A for the specified reference. + + + + + The value types allowed by the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + No type specified. + + + + + String type. + + + + + Float type. + + + + + Integer type. + + + + + Boolean type. + + + + + Object type. + + + + + Array type. + + + + + Null type. + + + + + Any type. + + + + + + Specifies undefined schema Id handling options for the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Do not infer a schema Id. + + + + + Use the .NET type name as the schema Id. + + + + + Use the assembly qualified .NET type name as the schema Id. + + + + + + Returns detailed information related to the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets the associated with the validation error. + + The JsonSchemaException associated with the validation error. + + + + Gets the path of the JSON location where the validation error occurred. + + The path of the JSON location where the validation error occurred. + + + + Gets the text description corresponding to the validation error. + + The text description. + + + + + Represents the callback method that will handle JSON schema validation events and the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + A camel case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Resolves member mappings for a type, camel casing property names. + + + + + Initializes a new instance of the class. + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + Used by to resolve a for a given . + + + + + Gets a value indicating whether members are being get and set using dynamic code generation. + This value is determined by the runtime permissions available. + + + true if using dynamic code generation; otherwise, false. + + + + + Gets or sets the default members search flags. + + The default members search flags. + + + + Gets or sets a value indicating whether compiler generated members should be serialized. + + + true if serialized compiler generated members; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore the interface when serializing and deserializing types. + + + true if the interface will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore the attribute when serializing and deserializing types. + + + true if the attribute will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore IsSpecified members when serializing and deserializing types. + + + true if the IsSpecified members will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore ShouldSerialize members when serializing and deserializing types. + + + true if the ShouldSerialize members will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets the naming strategy used to resolve how property names and dictionary keys are serialized. + + The naming strategy used to resolve how property names and dictionary keys are serialized. + + + + Initializes a new instance of the class. + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + Gets the serializable members for the type. + + The type to get serializable members for. + The serializable members for the type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates the constructor parameters. + + The constructor to create properties for. + The type's member properties. + Properties for the given . + + + + Creates a for the given . + + The matching member property. + The constructor parameter. + A created for the given . + + + + Resolves the default for the contract. + + Type of the object. + The contract's default . + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Determines which contract type is created for the given type. + + Type of the object. + A for the given type. + + + + Creates properties for the given . + + The type to create properties for. + /// The member serialization mode for the type. + Properties for the given . + + + + Creates the used by the serializer to get and set values from a member. + + The member. + The used by the serializer to get and set values from a member. + + + + Creates a for the given . + + The member's parent . + The member to create a for. + A created for the given . + + + + Resolves the name of the property. + + Name of the property. + Resolved name of the property. + + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + + + + Resolves the key of the dictionary. By default is used to resolve dictionary keys. + + Key of the dictionary. + Resolved key of the dictionary. + + + + Gets the resolved name of the property. + + Name of the property. + Name of the property. + + + + The default naming strategy. Property names and dictionary keys are unchanged. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + The default serialization binder used when resolving and loading classes from type names. + + + + + Initializes a new instance of the class. + + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + The type of the object the formatter creates a new instance of. + + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + The type of the object the formatter creates a new instance of. + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + + + Represents a trace writer that writes to the application's instances. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of will exclude messages and include , + and messages. + + + The that will be used to filter the trace messages passed to the writer. + + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Get and set values for a using dynamic methods. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + Provides information surrounding an error. + + + + + Gets the error. + + The error. + + + + Gets the original object that caused the error. + + The original object that caused the error. + + + + Gets the member that caused the error. + + The member that caused the error. + + + + Gets the path of the JSON location where the error occurred. + + The path of the JSON location where the error occurred. + + + + Gets or sets a value indicating whether this is handled. + + true if handled; otherwise, false. + + + + Provides data for the Error event. + + + + + Gets the current object the error event is being raised against. + + The current object the error event is being raised against. + + + + Gets the error context. + + The error context. + + + + Initializes a new instance of the class. + + The current object. + The error context. + + + + Get and set values for a using dynamic methods. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + Provides methods to get attributes. + + + + + Returns a collection of all of the attributes, or an empty collection if there are no attributes. + + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. + + The type of the attributes. + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Used by to resolve a for a given . + + + + + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + Used to resolve references when serializing and deserializing JSON by the . + + + + + Resolves a reference to its object. + + The serialization context. + The reference to resolve. + The object that was resolved from the reference. + + + + Gets the reference for the specified object. + + The serialization context. + The object to get a reference for. + The reference to the object. + + + + Determines whether the specified object is referenced. + + The serialization context. + The object to test for a reference. + + true if the specified object is referenced; otherwise, false. + + + + + Adds a reference to the specified object. + + The serialization context. + The reference. + The object to reference. + + + + Allows users to control class loading and mandate what class to load. + + + + + When implemented, controls the binding of a serialized object to a type. + + Specifies the name of the serialized object. + Specifies the name of the serialized object + The type of the object the formatter creates a new instance of. + + + + When implemented, controls the binding of a serialized object to a type. + + The type of the object the formatter creates a new instance of. + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + + + Represents a trace writer. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of will exclude messages and include , + and messages. + + The that will be used to filter the trace messages passed to the writer. + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Provides methods to get and set values. + + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + Contract details for a used by the . + + + + + Gets the of the collection items. + + The of the collection items. + + + + Gets a value indicating whether the collection type is a multidimensional array. + + true if the collection type is a multidimensional array; otherwise, false. + + + + Gets or sets the function used to create the object. When set this function will override . + + The function used to create the object. + + + + Gets a value indicating whether the creator has a parameter with the collection values. + + true if the creator has a parameter with the collection values; otherwise, false. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets or sets the default collection items . + + The converter. + + + + Gets or sets a value indicating whether the collection items preserve object references. + + true if collection items preserve object references; otherwise, false. + + + + Gets or sets the collection item reference loop handling. + + The reference loop handling. + + + + Gets or sets the collection item type name handling. + + The type name handling. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Handles serialization callback events. + + The object that raised the callback event. + The streaming context. + + + + Handles serialization error callback events. + + The object that raised the callback event. + The streaming context. + The error context. + + + + Sets extension data for an object during deserialization. + + The object to set extension data on. + The extension data key. + The extension data value. + + + + Gets extension data for an object during serialization. + + The object to set extension data on. + + + + Contract details for a used by the . + + + + + Gets the underlying type for the contract. + + The underlying type for the contract. + + + + Gets or sets the type created during deserialization. + + The type created during deserialization. + + + + Gets or sets whether this type contract is serialized as a reference. + + Whether this type contract is serialized as a reference. + + + + Gets or sets the default for this contract. + + The converter. + + + + Gets the internally resolved for the contract's type. + This converter is used as a fallback converter when no other converter is resolved. + Setting will always override this converter. + + + + + Gets or sets all methods called immediately after deserialization of the object. + + The methods called immediately after deserialization of the object. + + + + Gets or sets all methods called during deserialization of the object. + + The methods called during deserialization of the object. + + + + Gets or sets all methods called after serialization of the object graph. + + The methods called after serialization of the object graph. + + + + Gets or sets all methods called before serialization of the object. + + The methods called before serialization of the object. + + + + Gets or sets all method called when an error is thrown during the serialization of the object. + + The methods called when an error is thrown during the serialization of the object. + + + + Gets or sets the default creator method used to create the object. + + The default creator method used to create the object. + + + + Gets or sets a value indicating whether the default creator is non-public. + + true if the default object creator is non-public; otherwise, false. + + + + Contract details for a used by the . + + + + + Gets or sets the dictionary key resolver. + + The dictionary key resolver. + + + + Gets the of the dictionary keys. + + The of the dictionary keys. + + + + Gets the of the dictionary values. + + The of the dictionary values. + + + + Gets or sets the function used to create the object. When set this function will override . + + The function used to create the object. + + + + Gets a value indicating whether the creator has a parameter with the dictionary values. + + true if the creator has a parameter with the dictionary values; otherwise, false. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets the object's properties. + + The object's properties. + + + + Gets or sets the property name resolver. + + The property name resolver. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets or sets the object constructor. + + The object constructor. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets or sets the object member serialization. + + The member object serialization. + + + + Gets or sets the missing member handling used when deserializing this object. + + The missing member handling. + + + + Gets or sets a value that indicates whether the object's properties are required. + + + A value indicating whether the object's properties are required. + + + + + Gets or sets how the object's properties with null values are handled during serialization and deserialization. + + How the object's properties with null values are handled during serialization and deserialization. + + + + Gets the object's properties. + + The object's properties. + + + + Gets a collection of instances that define the parameters used with . + + + + + Gets or sets the function used to create the object. When set this function will override . + This function is called with a collection of arguments which are defined by the collection. + + The function used to create the object. + + + + Gets or sets the extension data setter. + + + + + Gets or sets the extension data getter. + + + + + Gets or sets the extension data value type. + + + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Maps a JSON property to a .NET member or constructor parameter. + + + + + Gets or sets the name of the property. + + The name of the property. + + + + Gets or sets the type that declared this property. + + The type that declared this property. + + + + Gets or sets the order of serialization of a member. + + The numeric order of serialization. + + + + Gets or sets the name of the underlying member or parameter. + + The name of the underlying member or parameter. + + + + Gets the that will get and set the during serialization. + + The that will get and set the during serialization. + + + + Gets or sets the for this property. + + The for this property. + + + + Gets or sets the type of the property. + + The type of the property. + + + + Gets or sets the for the property. + If set this converter takes precedence over the contract converter for the property type. + + The converter. + + + + Gets or sets the member converter. + + The member converter. + + + + Gets or sets a value indicating whether this is ignored. + + true if ignored; otherwise, false. + + + + Gets or sets a value indicating whether this is readable. + + true if readable; otherwise, false. + + + + Gets or sets a value indicating whether this is writable. + + true if writable; otherwise, false. + + + + Gets or sets a value indicating whether this has a member attribute. + + true if has a member attribute; otherwise, false. + + + + Gets the default value. + + The default value. + + + + Gets or sets a value indicating whether this is required. + + A value indicating whether this is required. + + + + Gets a value indicating whether has a value specified. + + + + + Gets or sets a value indicating whether this property preserves object references. + + + true if this instance is reference; otherwise, false. + + + + + Gets or sets the property null value handling. + + The null value handling. + + + + Gets or sets the property default value handling. + + The default value handling. + + + + Gets or sets the property reference loop handling. + + The reference loop handling. + + + + Gets or sets the property object creation handling. + + The object creation handling. + + + + Gets or sets or sets the type name handling. + + The type name handling. + + + + Gets or sets a predicate used to determine whether the property should be serialized. + + A predicate used to determine whether the property should be serialized. + + + + Gets or sets a predicate used to determine whether the property should be deserialized. + + A predicate used to determine whether the property should be deserialized. + + + + Gets or sets a predicate used to determine whether the property should be serialized. + + A predicate used to determine whether the property should be serialized. + + + + Gets or sets an action used to set whether the property has been deserialized. + + An action used to set whether the property has been deserialized. + + + + Returns a that represents this instance. + + + A that represents this instance. + + + + + Gets or sets the converter used when serializing the property's collection items. + + The collection's items converter. + + + + Gets or sets whether this property's collection items are serialized as a reference. + + Whether this property's collection items are serialized as a reference. + + + + Gets or sets the type name handling used when serializing the property's collection items. + + The collection's items type name handling. + + + + Gets or sets the reference loop handling used when serializing the property's collection items. + + The collection's items reference loop handling. + + + + A collection of objects. + + + + + Initializes a new instance of the class. + + The type. + + + + When implemented in a derived class, extracts the key from the specified element. + + The element from which to extract the key. + The key for the specified element. + + + + Adds a object. + + The property to add to the collection. + + + + Gets the closest matching object. + First attempts to get an exact case match of and then + a case insensitive match. + + Name of the property. + A matching property if found. + + + + Gets a property by property name. + + The name of the property to get. + Type property name string comparison. + A matching property if found. + + + + Contract details for a used by the . + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Lookup and create an instance of the type described by the argument. + + The type to create. + Optional arguments to pass to an initializing constructor of the JsonConverter. + If null, the default constructor is used. + + + + A kebab case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Represents a trace writer that writes to memory. When the trace message limit is + reached then old trace messages will be removed as new messages are added. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of will exclude messages and include , + and messages. + + + The that will be used to filter the trace messages passed to the writer. + + + + + Initializes a new instance of the class. + + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Returns an enumeration of the most recent trace messages. + + An enumeration of the most recent trace messages. + + + + Returns a of the most recent trace messages. + + + A of the most recent trace messages. + + + + + A base class for resolving how property names and dictionary keys are serialized. + + + + + A flag indicating whether dictionary keys should be processed. + Defaults to false. + + + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + + + + A flag indicating whether explicitly specified property names, + e.g. a property name customized with a , should be processed. + Defaults to false. + + + + + Gets the serialized name for a given property name. + + The initial property name. + A flag indicating whether the property has had a name explicitly specified. + The serialized property name. + + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + + + + Gets the serialized key for a given dictionary key. + + The initial dictionary key. + The serialized dictionary key. + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Hash code calculation + + + + + + Object equality implementation + + + + + + + Compare to another NamingStrategy + + + + + + + Represents a method that constructs an object. + + The object type to create. + + + + When applied to a method, specifies that the method is called when an error occurs serializing an object. + + + + + Provides methods to get attributes from a , , or . + + + + + Initializes a new instance of the class. + + The instance to get attributes for. This parameter should be a , , or . + + + + Returns a collection of all of the attributes, or an empty collection if there are no attributes. + + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. + + The type of the attributes. + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Get and set values for a using reflection. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + A snake case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Specifies how strings are escaped when writing JSON text. + + + + + Only control characters (e.g. newline) are escaped. + + + + + All non-ASCII and control characters (e.g. newline) are escaped. + + + + + HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped. + + + + + Indicates the method that will be used during deserialization for locating and loading assemblies. + + + + + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. + + + + + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. + + + + + Specifies type name handling options for the . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + + + + Do not include the .NET type name when serializing types. + + + + + Include the .NET type name when serializing into a JSON object structure. + + + + + Include the .NET type name when serializing into a JSON array structure. + + + + + Always include the .NET type name when serializing. + + + + + Include the .NET type name when the type of the object being serialized is not the same as its declared type. + Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON + you must specify a root type object with + or . + + + + + Determines whether the collection is null or empty. + + The collection. + + true if the collection is null or empty; otherwise, false. + + + + + Adds the elements of the specified collection to the specified generic . + + The list to add to. + The collection of elements to add. + + + + Converts the value to the specified type. If the value is unable to be converted, the + value is checked whether it assignable to the specified type. + + The value to convert. + The culture to use when converting. + The type to convert or cast the value to. + + The converted type. If conversion was unsuccessful, the initial value + is returned if assignable to the target type. + + + + + Helper method for generating a MetaObject which calls a + specific method on Dynamic that returns a result + + + + + Helper method for generating a MetaObject which calls a + specific method on Dynamic, but uses one of the arguments for + the result. + + + + + Helper method for generating a MetaObject which calls a + specific method on Dynamic, but uses one of the arguments for + the result. + + + + + Returns a Restrictions object which includes our current restrictions merged + with a restriction limiting our type + + + + + Helper class for serializing immutable collections. + Note that this is used by all builds, even those that don't support immutable collections, in case the DLL is GACed + https://github.com/JamesNK/Newtonsoft.Json/issues/652 + + + + + Gets the type of the typed collection's items. + + The type. + The type of the typed collection's items. + + + + Gets the member's underlying type. + + The member. + The underlying type of the member. + + + + Determines whether the property is an indexed property. + + The property. + + true if the property is an indexed property; otherwise, false. + + + + + Gets the member's value on the object. + + The member. + The target object. + The member's value on the object. + + + + Sets the member's value on the target object. + + The member. + The target. + The value. + + + + Determines whether the specified MemberInfo can be read. + + The MemberInfo to determine whether can be read. + /// if set to true then allow the member to be gotten non-publicly. + + true if the specified MemberInfo can be read; otherwise, false. + + + + + Determines whether the specified MemberInfo can be set. + + The MemberInfo to determine whether can be set. + if set to true then allow the member to be set non-publicly. + if set to true then allow the member to be set if read-only. + + true if the specified MemberInfo can be set; otherwise, false. + + + + + Builds a string. Unlike this class lets you reuse its internal buffer. + + + + + Determines whether the string is all white space. Empty string will return false. + + The string to test whether it is all white space. + + true if the string is all white space; otherwise, false. + + + + + Specifies the state of the . + + + + + An exception has been thrown, which has left the in an invalid state. + You may call the method to put the in the Closed state. + Any other method calls result in an being thrown. + + + + + The method has been called. + + + + + An object is being written. + + + + + An array is being written. + + + + + A constructor is being written. + + + + + A property is being written. + + + + + A write method has not been called. + + + + Specifies that an output will not be null even if the corresponding type allows it. + + + Specifies that when a method returns , the parameter will not be null even if the corresponding type allows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + + Gets the return value condition. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + + + Initializes a new instance of the class. + + + The condition parameter value. Code after the method will be considered unreachable by diagnostics if the argument to + the associated parameter matches this value. + + + + Gets the condition parameter value. + + + diff --git a/Bin/Debug/CommonControls/.NET4/OpenXmlPowerTools.dll b/Bin/Debug/CommonControls/.NET4/OpenXmlPowerTools.dll new file mode 100644 index 0000000..c225873 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4/OpenXmlPowerTools.dll differ diff --git a/Bin/Debug/CommonControls/.NET4/RaUI.dll b/Bin/Debug/CommonControls/.NET4/RaUI.dll new file mode 100644 index 0000000..6b051c3 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4/RaUI.dll differ diff --git a/Bin/Debug/CommonControls/.NET4/RaUI.xml b/Bin/Debug/CommonControls/.NET4/RaUI.xml new file mode 100644 index 0000000..3d8c4b0 --- /dev/null +++ b/Bin/Debug/CommonControls/.NET4/RaUI.xml @@ -0,0 +1,61435 @@ + + + + RaUI + + + + + 基于XML实现的权限类 + + + + + 用户名 + + + + + 用户id + + + + + 密码 + + + + + 权限控制Id + + + + + 用户备注 + + + + + 是否是管理员权限 + + + + + 是否是超级管理员权限 + + + + + 设置权限 + + 权限名称 + 权限值 + 返回是否设置成功 + + + + 获取权限 + + 权限名称 + 默认权限值 + 返回权限值 + + + + 获取权限 + + 权限名称 + 返回权限值 + + + + 批量导入权限 + + 权限相关的内容 + 返回是否执行成功 + + + + 导出权限 + + 返回导出文本 + + + + 清除所有权限 + + 返回是否执行成功 + + + + 字符串字数统计 + + + + + 返回字数统计信息 + + + + + + + 字符串统计信息 + + + + + 汉字数量 + + + + + 英文字母数量 + + + + + 英文单词数量 + + + + + 数字数量(一个数字字符算一个数) + + + + + 数字数量(一串数字算一个数) + + + + + 字节总数(汉字算2个字节) + + + + + 总数(英文单词算一个数，一串数字算一个数) + + + + + 可见字符总数(一个字母算一个数,一个数字算一个数) + + + + + 汉字转拼音静态类,包括功能全拼和缩写，方法全部是静态的 + + + + + 汉字的机内码数组 + + + + + 机内码对应的拼音数组 + + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(首拼) + + 汉字字符串 + 转换后的拼音(首拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 用指定字符分隔 + 转换后的拼音(全拼)字符串 + + + + 汉字转拼音缩写 + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串) (小写) (空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (大写) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串)(大写)(空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 字符串操作类 + + + + + 字符串转Base64 + + + + + + + Base64转字符串 + + + + + + + 判断是否包含日文平假和片假 + + + + + + + 转换指定字符串为布尔类型 + + + + + 转换指定字符串为Double类型 + + + + + 已重载.计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 已重载.计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定布尔类型为Int类型,true为1，false为0 + + + + + 判断指定字符串是否是布尔类型 + + + + + 判断指定字符串是否是Double类型 + + + + + 判断指定字符串是否是Int类型 + + + + + 根据年月日转换成日期 + + + + + + + + + 追加字符 + + + + + 获取2个字符串中间的内容,point1为空表示从首位开始算，point2为空表示算到结尾。 + + + + + 判断字符串是否只包含数字或英文 + + + + + + + 判断字符串是否只包含英文 + + + + + + + 判断字符串是否只包含数字 + + + + + + + 判断字符串是否匹配,支持?*通配符 + + 待匹配的字符串 + 匹配的通配符 + + + + + 通配符替换 + + + + + + + + + 支持忽略大小写的替换功能 + + + + + 是否忽略大小写 + + + + + 获取匹配的内容 + + + + + + + + + Json扩展 + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 对变量的拓展 + + + + + 替换文本(忽略大小写) + + + 需要替换的内容 + 替换后的内容 + + + + + 替换文本(忽略大小写),可支持通配符 + + + + + 是否是通配符表达式,不是，则普通替换，忽略大小写，是，则启用通配符替换 + + + + + 将颜色转换为Html颜色格式 + + + + + + + 支持忽略大小写的替换文本功能 + + + + + 是否忽略大小写 + + + + + 获取字数信息 + + + + + + + 获取符合要求的第一个结果 + + + + 是否是正则 + + + + + 查找字符串,忽略大小写 + + + + + + + + + 查找字符串,忽略大小写 + + + + + + + + 判断字符串是否是数字或英文 + + + + + + + 判断字符串是否含有日文 + + + + + + + 判断字符串是否是英文 + + + + + + + 判断字符串是否是数字(不同于IsInt,本函数是判断字符串是否只含有数字,对字符串长度没有限制) + + + + + + + 是否在指定范围内 + + + + + + + + + 是否在指定范围内 + + + + + + + + + 转换指定字符串为Int类型 + + + 最小值 + 最大值 + 如果字符串不在范围内，则使用本默认值 + + + + + 转换指定布尔类型到Int类型,true为1，false为0 + + + + + + + 将指定类型转换成整型 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将指定类型转换成整型 + + + + + + + 将指定类型转换成长整型,如果时间时间类型,则转换为Unix时间戳 + + + + + + + + 转换为Unix时间戳 + + + + + + + 转换为Js时间戳 + + + + + + + 转换为Unix时间戳 + + + + + + + 将指定类型转换成长整型 + + + + + + + 转换指定类型为Double类型 + + + + + + + + 转换指定类型为Double类型 + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + + 转换DateTime类型到日期时间字符串(例如 2000-01-01 08:08:08) + + + + + + + 转换DateTime类型到日期字符串(例如 2000-01-01) + + + + + + + 转换DateTime类型到日期星期字符串(例如 2000-01-01 星期六) + + + + + + + 转换DateTime类型到Unix时间戳 + + + + + + + 转换Unix时间戳到DateTime类型 + + + + + + + 判断字符串是否与内容匹配 + + + + + + + + 将变量值转换成Double类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换到文件大小字符串 + + + + + + + 转换到文件大小字符串 + + + + + + + 转换指定类型为Decimal类型 + + + + + + + + 将变量值转换成Decimal类型 + + + + + + + 将变量值转换成Decimal类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换指定类型为DateTime类型 + + + + + + + + 将变量值转换成DateTime类型 + + + + + + + 转换指定类型为布尔类型 + + + + + + + 追加字符 + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + + + + 判断指定字符串是否是Int类型 + + + + + + + 判断指定字符串是否是Double类型 + + + + + + + 判断是否是布尔类型 + + + + + + + 将字符串转换为Base64类型 + + + + + + + 判断字符串是否在指定长度 + + + + + + + + + 判断能否转换成日期格式 + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 大文件与批量文件操作类,支持中途取消操作,本类需要实例化操作 + + + + + 传输进度 + + 当前传输完成的值 + 全部值,为-1表示无法获取 + 当前传输的百分比,为-1表示无法获取 + 当前下载速度(值为每秒下载的字节数),为-1表示无法获取 + 携带的参数(可选) + + + + 传输失败的事件 + + 错误描述 + 携带的参数(可选) + + + + 文件传输出错 + + + + + 文件传输进度 + + + + + 文件夹传输进度 + + + + + 取消事件 + + + + + 大文件按流复制文件,支持自动创建目标文件夹。 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + 携带的参数(可选) + + + + + 复制文件夹到目标文件夹,不支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持中途取消 + + 源文件夹 + 目标文件夹 + 初始的文件数量 + 总数量,如果不计算,则使用-1 + 操作的数量,包含成功的和失败的 + 携带的参数(可选) + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 获取文件夹中的文件数量 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 获取文件夹的大小 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 文件信息 + + + + + 获取版本号 + + + + + 获取版本号 + + + + + + + 根据版本字符串输出double类型的版本号 + + + + + + + + 比较两个版本号大小 + + + + oldVer小于newVer,返回1,大于则返回-1,相等返回0,不支持则返回-1000 + + + + 从字符串中提取版本号 + + + + + + + 比较版本号 + + + + + + old小于new,返回1,大于则返回-1,相等返回0 + + + + 判断是否是管理员方式运行 + + + + + + Hosts操作类 + + + + + 获取并转换hosts内容 + + hosts内容 + + + + + 获取hosts并转换hosts内容 + + + + + + 追加内容到hosts里 + + 要追加的内容列表，每一行为ip 域名的格式 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + write为true,追加内容到hosts里;为false,判断是否需要追加 + + 要追加的内容列表，每一行为ip 域名的格式 + 是否要写入,如果为false,则只判断是否需要追加,而不写入Hosts文件 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + 要追加的内容 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + ip地址 + 域名 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 从hosts文件里删除内容 + + 要删除的内容 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + 从hosts文件里删除内容 + + ip地址 + 域名 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + Host信息 + + + + + IP + + + + + 域名 + + + + + 注释 + + + + + 是否要删除 + + + + + Ini操作类 + + + + + 写入Ini + + + + + + + + + + 获取Ini + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 获取所有节点名称(Section) + + 存放节点名称的内存地址,每个节点之间用\0分隔 + 内存大小(characters) + Ini文件 + 内容的实际长度,为0表示没有内容,为nSize-2表示内存大小不够 + + + + 编码 + + + + + Ini操作类 + + + + + + 根据section取所有key和值 + + + + + + + 读取INI文件中指定INI文件中的所有节点名称(Section) + + 所有节点,没有内容返回string[0] + + + + 读取INI文件 + + 段，格式[] + 键 + 返回byte类型的section组或键值组 + + + + 根据section取所有key + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入Ini + + + + + + + + 读取Ini + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + + + 写入ini + + + + + + + + + 删除Ini的Key + + + + + + + 删除Ini节点 + + + + + + 控件信息 + + + + + id + + + + + 控件对象 + + + + + 控件值类型 + + + + + 默认值 + + + + + 值类型 + + + + + 默认 + + + + + 取列表顺序值 + + + + + 取当前选择的列表值 + + + + + 取对象值 + + + + + 保存的设置类型 + + + + + Ini + + + + + XML + + + + + 对象值 + + + + + 显示的文本 + + + + + 图片序号 + + + + + id + + + + + Tag值 + + + + + 显示文本值 + + + + + + 星期数据 + + + + + 一周的开始时间 + + + + + 一周的结束时间 + + + + + 图片类型 + + + + + Bmp图片 + + + + + Jpeg图片 + + + + + Png图片 + + + + + Gif动态图片 + + + + + Tiff图片 + + + + + 文件操作类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 永久删除单个文件。 + + 永久删除的文件名 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除一组文件。 + + 字符串数组，表示一组文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + + + + + 移动一个文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 移动一组文件到指定的路径下 + + 要移动的文件名数组 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制一组文件到指定的路径 + + 要复制的文件名数组 + 复制到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 大文件多次复制文件 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 重命名一个文件为新名称，建议您使用更方便的Microsoft.VisualBasic.FileSystem.ReName();替换该方法 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 删除单个或多个文件 + + 删除的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动或复制一个或多个文件到指定路径下 + + 操作类型，是移动操作还是复制操作 + 要移动或复制的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 移动到的目的位置 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 如果指定文件夹不存在，则创建文件夹 + + + + + + 根据指定文件夹路径,生成一个随机不存在的文件名 + + + 扩展名,比如.jpg + 前缀 + + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 解释错误代码 + + 代码号 + 返回关于错误代码的文字描述 + + + + 运行文件 + + + + + + + + /运行文件 + + + + + + + + + 运行程序 + + + + + + + 打开文件 + + + + + + + 打开文件夹并定位文件 + + + + + + + 打开网址 + + + + + + + 判断是否为空的文件夹 + + + + + + + 文件或文件夹是否存在 + + + + + + + 判断文件名是否有效 + + + + + + + 转换到有效文件名 + + + + + + + 追加日志 + + + + + + + 追加文件 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + + 写入所有文本行到文件,如果文件夹不存在，会自动创建 + + + + + + + + 写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + + 以UTF-8格式写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + 从文件中加载图片,使用本方法，不会导致图片文件被占用。 + + + + + + 获取文件大小 + + + + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 获取文件大小字符串 + + + + + + + 根据文件大小字符串获取长整型表示的文件大小 + + + + + + + 获取文件大小字符串 + + + + + + + 复制内容到剪切板 + + + + + + 添加某个控件为支持拖放属性 + + + + + + + 使管理员方式运行时支持拖放 + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 获取绝对路径 + + + + + + + 获取相对路径 + + + + + + + 获取图标 + + + + + + + + + + + + + + 销毁图标 + + + + + + + 获取文件图标 + + + + + + + + 获取文件图标 + + + + + + + + + + 图片相关API + + + + + 检测文件真实扩展名 + + + + + + + 检测文件真实扩展名 + + + + + + + 从文件或Url中加载图片,使用本方法，不会导致图片文件被占用。(如果是webp格式,需要引入OpenXmlPowerTools) + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + 图片质量,0~100 + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + 图片质量,0~100 + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + 图片质量,0~100 + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 以逆时针为方向对图像进行旋转 + + 位图流 + 旋转角度[0,360](前台给的) + + + + + 是否包括透明像素 + + + + 操作失败 + + + + 矩形边界 + + + + + + + + 计算水印位置 + + + + + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 计算最大字体大小 + + + + + + + + + + + 计算旋转矩形大小 + + + + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + + + + + 缩放 + + + 宽 + 高 + 插值算法 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 缩放 + + + 宽 + 高 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 根据原边长和新边长计算绘制的起始点坐标 + + + + + + + + 获取缩放模式 + + + + + + 是否裁剪图片 + + + + + 裁剪或填充 + + + + + 背景色 + 插值算法 + + Image 不能为 null + 操作失败 + + + + 裁剪 + + + 宽度 + 高度 + + 返回裁剪后的图片 + Image 不能为 null + 新的图片尺寸的宽度和高度必须大于零 + 操作失败 + + + + 调整宽度 + + + + + + + + 根据最大宽度调整图片尺寸 + + + 最大宽度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最大高度调整图片尺寸 + + + 最大高度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最长边调整图片尺寸 + + + 设置最长边允许的值,当最长边大于这个值时,自动缩放 + 返回调整后的图片 + Image 不能为 null + 最大值必须大于零 + 操作失败 + + + + 调整高度 + + + + + + + + 调整图片大小 + + + + + + + + + + 调整图片大小 + + + + + + + + + + + 调整图片大小 + + + + + + + + + + + + + 转换Image为Icon + + 要转换为图标的Image对象 + 当image为null时是否返回null。false则抛空引用异常 + + + + + 缩放模式 + + + + + 宽度优先(不裁剪宽) + + + + + 高度优先(不裁剪高) + + + + + 水印位置 + + + + + 左上角 + + + + + 中上 + + + + + 右上角 + + + + + 左中 + + + + + 居中 + + + + + 右中 + + + + + 左下角 + + + + + 中下 + + + + + 右下角 + + + + + 全屏平铺 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + 音频播放类 + + + + + 临时音频文件 + + + + + 父窗口句柄 + + + + + 声音标签 + + + + play synchronously (default) + + + play asynchronously + + + silence (!default) if sound not found + + + pszSound points to a memory file + + + loop the sound until next sndPlaySound + + + don’t stop any currently playing sound + + + Stop Playing Wave + + + don’t wait if the driver is busy + + + name is a registry alias + + + alias is a predefined id + + + name is file name + + + name is resource name or atom + + + + 音频播放类 + + embedded music file + 临时保存的文件位置 + 父窗口句柄 + + + + 音频播放类 + + 要播放的音频位置 + 父窗口句柄 + + + + 音频播放类 + + + 父窗口句柄 + + + + 播放音频 + + + + + + 播放音频 + + + + + 关闭音频 + + + + + XML操作类 + + + + + XML操作类 + + + + + 从XML文本中加载数据 + + + + + + 从指定的XML文本中加载 + + XML文本 + 如为1，表示加载成功，为0为失败 + + + + 载入空的XML文档 + + 如为1，表示加载成功，为0为失败 + + + + 从指定的文件中加载 + + XML文件路径 + 如为1，表示加载成功，为0为失败 + + + + 保存到指定文件中 + + 文件路径 + 如为1，表示保存成功，为0为失败 + + + + 判断节点是否存在 + + 属性名 + 属性值 + 返回1，表示存在，其它表示不存在 + + + + 定位节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 定位节点,如果找不到节点，就新建一个节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 + + 返回第一个符合要求的结果 + + + + 定位设置节点 + + 返回第一个符合要求的结果 + + + + 在节点后插入数据 + + + + + + + 在节点前插入数据 + + + + + + + 获取节点数量 + + 属性名 + 属性值 + 返回符合要求的结果数量 + + + + 获取节点数量 + + 返回符合要求的结果数量 + + + + 获取节点数量 + + 属性名 + 属性值 + + + + 返回符合要求的结果数量 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 读取指定节点的值(string) + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + + + 获取属性值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取所有的节点名称 + + + + + + 读取指定节点的值(string) + + + + + + + + 读取指定节点的值(int) + + + + + + + + 读取指定节点的值(decimal) + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 获取XML文件的根元素 + + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 新增节点 + + + + + + + + 新增节点并定位到新节点 + + + + + + + + 新增设置节点并定位 + + + + + + 在指定节点前新增节点并定位到新节点 + + + + + + + + + 获取当前节点 + + + + + + 删除节点 + + + + + + 获取XML文本 + + + + + + 获取XML文本 + + + + + + 获取文本 + + + + + + 获取文本 + + + + + + 文件时间 + + + + + 创建时间 + + + + + 最后修改时间 + + + + + 访问时间 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 取得一个文本文件的编码方式。如果无法在文件头部找到有效的前导符，Encoding.Default将被返回。 + + 文件名。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + + + + + 取得一个文本文件的编码方式。 + + 文件名。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 通过给定的文件流，判断文件的编码类型 + + 文件流 + 文件的编码类型 + + + + 判断是否是不带 BOM 的 UTF8 格式 + + + + + + + + + + + Read a WebP file + WebP file to load + Bitmap with the WebP image + + + Decode a WebP image + The data to uncompress + Bitmap with the WebP image + + + Decode a WebP image + the data to uncompress + Options for advanced decode + Bitmap with the WebP image + + + Get Thumbnail from webP in mode faster/low quality + The data to uncompress + Wanted width of thumbnail + Wanted height of thumbnail + Bitmap with the WebP thumbnail in 24bpp + + + Thumbnail from webP in mode slow/high quality + The data to uncompress + Wanted width of thumbnail + Wanted height of thumbnail + Bitmap with the WebP thumbnail + + + Save bitmap to file in WebP format + Bitmap with the WebP image + The file to write + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + + + Lossy encoding bitmap to WebP (Simple encoding API) + Bitmap with the image + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + Compressed data + + + Lossy encoding bitmap to WebP (Advanced encoding API) + Bitmap with the image + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + Between 0 (fastest, lowest compression) and 9 (slower, best compression) + + Compressed data + + + Lossless encoding bitmap to WebP (Simple encoding API) + Bitmap with the image + Compressed data + + + Lossless encoding image in bitmap (Advanced encoding API) + Bitmap with the image + Between 0 (fastest, lowest compression) and 9 (slower, best compression) + Compressed data + + + Near lossless encoding image in bitmap + Bitmap with the image + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + Between 0 (fastest, lowest compression) and 9 (slower, best compression) + Compress data + + + Get the libwebp version + Version of library + + + Get info of WEBP data + The data of WebP + width of image + height of image + Image has alpha channel + Image is a animation + Format of image: 0 = undefined (/mixed), 1 = lossy, 2 = lossless + + + Compute PSNR, SSIM or LSIM distortion metric between two pictures. Warning: this function is rather CPU-intensive. + Picture to measure + Reference picture + 0 = PSNR, 1 = SSIM, 2 = LSIM + dB in the Y/U/V/Alpha/All order + + + Encoding image using Advanced encoding API + Bitmap with the image + Config for encode + True if need encode info. + Compressed data + + + Free memory + + + This function will initialize the configuration according to a predefined set of parameters (referred to by 'preset') and a given quality factor. + The WebPConfig struct + Type of image + Quality of compresion + 0 if error + + + Get info of WepP image + Bytes[] of webp image + Size of rawWebP + Features of WebP image + VP8StatusCode + + + Activate the lossless compression mode with the desired efficiency. + The WebPConfig struct + between 0 (fastest, lowest compression) and 9 (slower, best compression) + 0 in case of parameter errorr + + + Check that 'config' is non-NULL and all configuration parameters are within their valid ranges. + The WebPConfig struct + 1 if config are OK + + + Init the struct WebPPicture ckecking the dll version + The WebPPicture struct + 1 if not error + + + Colorspace conversion function to import RGB samples. + The WebPPicture struct + Point to BGR data + stride of BGR data + Returns 0 in case of memory error. + + + Colorspace conversion function to import RGB samples. + The WebPPicture struct + Point to BGRA data + stride of BGRA data + Returns 0 in case of memory error. + + + Colorspace conversion function to import RGB samples. + The WebPPicture struct + Point to BGR data + stride of BGR data + Returns 0 in case of memory error. + + + The writer type for output compress data + Data returned + Size of data returned + Picture struct + + + + Compress to webp format + The config struct for compresion parameters + 'picture' hold the source samples in both YUV(A) or ARGB input + Returns 0 in case of error, 1 otherwise. In case of error, picture->error_code is updated accordingly. + + + Release the memory allocated by WebPPictureAlloc() or WebPPictureImport*() + Note that this function does _not_ free the memory used by the 'picture' object itself. + Besides memory (which is reclaimed) all other fields of 'picture' are preserved. + Picture struct + + + Validate the WebP image header and retrieve the image height and width. Pointers *width and *height can be passed NULL if deemed irrelevant + Pointer to WebP image data + This is the size of the memory block pointed to by data containing the image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + 1 if success, otherwise error code returned in the case of (a) formatting error(s). + + + Decode WEBP image pointed to by *data and returns BGR samples into a pre-allocated buffer + Pointer to WebP image data + This is the size of the memory block pointed to by data containing the image data + Pointer to decoded WebP image + Size of allocated buffer + Specifies the distance between scanlines + output_buffer if function succeeds; NULL otherwise + + + Decode WEBP image pointed to by *data and returns BGR samples into a pre-allocated buffer + Pointer to WebP image data + This is the size of the memory block pointed to by data containing the image data + Pointer to decoded WebP image + Size of allocated buffer + Specifies the distance between scanlines + output_buffer if function succeeds; NULL otherwise + + + Initialize the configuration as empty. This function must always be called first, unless WebPGetFeatures() is to be called. + Configuration struct + False in case of mismatched version. + + + Decodes the full data at once, taking 'config' into account. + WebP raw data to decode + Size of WebP data + Configuration struct + VP8_STATUS_OK if the decoding was successful + + + Free any memory associated with the buffer. Must always be called last. Doesn't free the 'buffer' structure itself. + WebPDecBuffer + + + Lossy encoding images + Pointer to BGR image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + Ranges from 0 (lower quality) to 100 (highest quality). Controls the loss and quality during compression + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Lossy encoding images + Pointer to BGRA image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + Ranges from 0 (lower quality) to 100 (highest quality). Controls the loss and quality during compression + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Lossless encoding images pointed to by *data in WebP format + Pointer to BGR image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Lossless encoding images pointed to by *data in WebP format + Pointer to BGR image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Releases memory returned by the WebPEncode + Pointer to memory + + + Get the webp version library + 8bits for each of major/minor/revision packet in integer. E.g: v2.5.7 is 0x020507 + + + Compute PSNR, SSIM or LSIM distortion metric between two pictures. + Picture to measure + Reference picture + 0 = PSNR, 1 = SSIM, 2 = LSIM + dB in the Y/U/V/Alpha/All order + False in case of error (src and ref don't have same dimension, ...) + + + Enumerate some predefined settings for WebPConfig, depending on the type of source picture. These presets are used when calling WebPConfigPreset(). + + + Default preset. + + + Digital picture, like portrait, inner shot. + + + Outdoor photograph, with natural lighting. + + + Hand or line drawing, with high-contrast details. + + + Small-sized colorful images. + + + Text-like. + + + Encoding error conditions. + + + No error. + + + Memory error allocating objects. + + + Memory error while flushing bits. + + + A pointer parameter is NULL. + + + Configuration is invalid. + + + Picture has invalid width/height. + + + Partition is bigger than 512k. + + + Partition is bigger than 16M. + + + Error while flushing bytes. + + + File is bigger than 4G. + + + Abort request by user. + + + List terminator. always last. + + + Enumeration of the status codes. + + + No error. + + + Memory error allocating objects. + + + Configuration is invalid. + + + + + + + + Configuration is invalid. + + + + + + + + Abort request by user. + + + + + + + + Image characteristics hint for the underlying encoder. + + + Default preset. + + + Digital picture, like portrait, inner shot + + + Outdoor photograph, with natural lighting + + + Discrete tone image (graph, map-tile etc). + + + list terminator. always last. + + + Describes the byte-ordering of packed samples in memory. + + + Byte-order: R,G,B,R,G,B,... + + + Byte-order: R,G,B,A,R,G,B,A,... + + + Byte-order: B,G,R,B,G,R,... + + + Byte-order: B,G,R,A,B,G,R,A,... + + + Byte-order: A,R,G,B,A,R,G,B,... + + + Byte-order: RGB-565: [a4 a3 a2 a1 a0 r5 r4 r3], [r2 r1 r0 g4 g3 g2 g1 g0], ... + WEBP_SWAP_16BITS_CSP is defined, + Byte-order: RGB-565: [a4 a3 a2 a1 a0 b5 b4 b3], [b2 b1 b0 g4 g3 g2 g1 g0], ... + + + Byte-order: RGB-565: [r4 r3 r2 r1 r0 g5 g4 g3], [g2 g1 g0 b4 b3 b2 b1 b0], ... + WEBP_SWAP_16BITS_CSP is defined, + Byte-order: [b3 b2 b1 b0 a3 a2 a1 a0], [r3 r2 r1 r0 g3 g2 g1 g0], ... + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + yuv 4:2:0 + + + yuv 4:2:0 + + + MODE_LAST -> 13 + + + + Decoding states. State normally flows as: + WEBP_HEADER->VP8_HEADER->VP8_PARTS0->VP8_DATA->DONE for a lossy image, and + WEBP_HEADER->VP8L_HEADER->VP8L_DATA->DONE for a lossless image. + If there is any error the decoder goes into state ERROR. + + + + Features gathered from the bitstream + + + Width in pixels, as read from the bitstream. + + + Height in pixels, as read from the bitstream. + + + True if the bitstream contains an alpha channel. + + + True if the bitstream is an animation. + + + 0 = undefined (/mixed), 1 = lossy, 2 = lossless + + + Padding for later use. + + + Compression parameters. + + + Lossless encoding (0=lossy(default), 1=lossless). + + + Between 0 (smallest file) and 100 (biggest) + + + Quality/speed trade-off (0=fast, 6=slower-better) + + + Hint for image type (lossless only for now). + + + If non-zero, set the desired target size in bytes. Takes precedence over the 'compression' parameter. + + + If non-zero, specifies the minimal distortion to try to achieve. Takes precedence over target_size. + + + Maximum number of segments to use, in [1..4] + + + Spatial Noise Shaping. 0=off, 100=maximum. + + + Range: [0 = off .. 100 = strongest] + + + Range: [0 = off .. 7 = least sharp] + + + Filtering type: 0 = simple, 1 = strong (only used if filter_strength > 0 or autofilter > 0) + + + Auto adjust filter's strength [0 = off, 1 = on] + + + Algorithm for encoding the alpha plane (0 = none, 1 = compressed with WebP lossless). Default is 1. + + + Predictive filtering method for alpha plane. 0: none, 1: fast, 2: best. Default if 1. + + + Between 0 (smallest size) and 100 (lossless). Default is 100. + + + Number of entropy-analysis passes (in [1..10]). + + + If true, export the compressed picture back. In-loop filtering is not applied. + + + Preprocessing filter (0=none, 1=segment-smooth, 2=pseudo-random dithering) + + + Log2(number of token partitions) in [0..3] Default is set to 0 for easier progressive decoding. + + + Quality degradation allowed to fit the 512k limit on prediction modes coding (0: no degradation, 100: maximum possible degradation). + + + If true, compression parameters will be remapped to better match the expected output size from JPEG compression. Generally, the output size will be similar but the degradation will be lower. + + + If non-zero, try and use multi-threaded encoding. + + + If set, reduce memory usage (but increase CPU use). + + + Near lossless encoding [0 = max loss .. 100 = off (default)]. + + + If non-zero, preserve the exact RGB values under transparent area. Otherwise, discard this invisible RGB information for better compression. The default value is 0. + + + Reserved for future lossless feature + + + if needed, use sharp (and slow) RGB->YUV conversion + + + Padding for later use. + + + Main exchange structure (input samples, output bytes, statistics) + + + Main flag for encoder selecting between ARGB or YUV input. Recommended to use ARGB input (*argb, argb_stride) for lossless, and YUV input (*y, *u, *v, etc.) for lossy + + + colorspace: should be YUV420 for now (=Y'CbCr). Value = 0 + + + Width of picture (less or equal to WEBP_MAX_DIMENSION) + + + Height of picture (less or equal to WEBP_MAX_DIMENSION) + + + Pointer to luma plane. + + + Pointer to chroma U plane. + + + Pointer to chroma V plane. + + + Luma stride. + + + Chroma stride. + + + Pointer to the alpha plane + + + stride of the alpha plane + + + Padding for later use. + + + Pointer to argb (32 bit) plane. + + + This is stride in pixels units, not bytes. + + + Padding for later use. + + + Byte-emission hook, to store compressed bytes as they are ready. + + + Can be used by the writer. + + + 1: intra type, 2: segment, 3: quant, 4: intra-16 prediction mode, 5: chroma prediction mode, 6: bit cost, 7: distortion + + + if not NULL, points to an array of size ((width + 15) / 16) * ((height + 15) / 16) that will be filled with a macroblock map, depending on extra_info_type. + + + Pointer to side statistics (updated only if not NULL) + + + Error code for the latest error encountered during encoding + + + If not NULL, report progress during encoding. + + + this field is free to be set to any value and used during callbacks (like progress-report e.g.). + + + Padding for later use. + + + Row chunk of memory for yuva planes + + + row chunk of memory for argb planes + + + Padding for later use. + + + + + + + + + Structure for storing auxiliary statistics (mostly for lossy encoding). + + + Final size + + + Peak-signal-to-noise ratio for Y + + + Peak-signal-to-noise ratio for U + + + Peak-signal-to-noise ratio for V + + + Peak-signal-to-noise ratio for All + + + Peak-signal-to-noise ratio for Alpha + + + Number of intra4 + + + Number of intra16 + + + Number of skipped macroblocks + + + Approximate number of bytes spent for header + + + Approximate number of bytes spent for mode-partition #0 + + + Approximate number of bytes spent for DC coefficients for segment 0. + + + Approximate number of bytes spent for AC coefficients for segment 0. + + + Approximate number of bytes spent for uv coefficients for segment 0. + + + Approximate number of bytes spent for DC coefficients for segment 1. + + + Approximate number of bytes spent for AC coefficients for segment 1. + + + Approximate number of bytes spent for uv coefficients for segment 1. + + + Approximate number of bytes spent for DC coefficients for segment 2. + + + Approximate number of bytes spent for AC coefficients for segment 2. + + + Approximate number of bytes spent for uv coefficients for segment 2. + + + Approximate number of bytes spent for DC coefficients for segment 3. + + + Approximate number of bytes spent for AC coefficients for segment 3. + + + Approximate number of bytes spent for uv coefficients for segment 3. + + + Number of macroblocks in segments 0 + + + Number of macroblocks in segments 1 + + + Number of macroblocks in segments 2 + + + Number of macroblocks in segments 3 + + + Quantizer values for segment 0 + + + Quantizer values for segment 1 + + + Quantizer values for segment 2 + + + Quantizer values for segment 3 + + + Filtering strength for segment 0 [0..63] + + + Filtering strength for segment 1 [0..63] + + + Filtering strength for segment 2 [0..63] + + + Filtering strength for segment 3 [0..63] + + + Size of the transparency data + + + Size of the enhancement layer data + + + bit0:predictor bit1:cross-color transform bit2:subtract-green bit3:color indexing + + + Number of precision bits of histogram + + + Precision bits for transform + + + Number of bits for color cache lookup + + + Number of color in palette, if used + + + Final lossless size + + + Lossless header (transform, huffman etc) size + + + Lossless image data size + + + Padding for later use. + + + + + + + + Immutable bitstream features (optional) + + + Output buffer (can point to external mem) + + + Decoding options + + + Output buffer + + + Colorspace. + + + Width of image. + + + Height of image. + + + If non-zero, 'internal_memory' pointer is not used. If value is '2' or more, the external memory is considered 'slow' and multiple read/write will be avoided. + + + Output buffer parameters. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + Internally allocated memory (only when is_external_memory is 0). Should not be used externally, but accessed via WebPRGBABuffer. + + + Union of buffer parameters + + + + + + + + + + + + + + + + + + Pointer to luma samples + + + Pointer to chroma U samples + + + Pointer to chroma V samples + + + Pointer to alpha samples + + + luma stride + + + chroma U stride + + + chroma V stride + + + alpha stride + + + luma plane size + + + chroma plane U size + + + chroma plane V size + + + alpha plane size + + + Generic structure for describing the output sample buffer. + + + pointer to RGBA samples. + + + stride in bytes from one scanline to the next. + + + total size of the rgba buffer. + + + Decoding options + + + if true, skip the in-loop filtering. + + + if true, use faster pointwise upsampler. + + + if true, cropping is applied _first_ + + + left position for cropping. Will be snapped to even values. + + + top position for cropping. Will be snapped to even values. + + + width of the cropping area + + + height of the cropping area + + + if true, scaling is applied _afterward_ + + + final width + + + final height + + + if true, use multi-threaded decoding + + + dithering strength (0=Off, 100=full) + + + flip output vertically + + + alpha dithering strength in [0..100] + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + + 数据库操作扩展 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据,如果没有数据,则返回null + + + + + + + 获取第一行第一列的值 + + + + + + + 获取第一张表的指定行数据 + + + 指定第几行 + + + + + 获取第一张表的行数 + + + + + + + + + + + + 获取和设置aapt.exe的完整路径 + + + + + 获取和设置缓存文件夹 + + + + + 是否开启深度分析,深度分析需要解压apk进行分析，会更耗时。 + + + + + 读取adb内容 + + + + + + + + + + + + app名称 + + + + + 包名 + + + + + 版本号 + + + + + 版本字符串 + + + + + 权限 + + + + + 最小SDK + + + + + 应用图标,需开启DeepAnaly_On开关，否则无法获取 + + + + + 文件名 + + + + + 文件路径 + + + + + 文件创建时间 + + + + + 文件修改时间 + + + + + 错误信息 + + + + + 对鼠标或键盘的自动化操作 + + + + + 鼠标左键 + + + + + 鼠标中键 + + + + + 鼠标右键 + + + + + 模拟键盘按键 + + + + 按下还是抬起 + + + + 鼠标滚轮 + + + + + + + + 鼠标移动 + + + + + + + + 自定义鼠标按下或抬起 + + + + + + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 粘贴文本 + + + + + + 获取指定句柄的大小及位置 + + + + + + + + 设置指定句柄的大小 + + + + + + + 判断鼠标位置是不是在指定的矩形中 + + + + + + + + 判断2张图是否相似度超90 + + + + + + + + /获取2种颜色的相似度,范围为0~100 + + + + + + + + 新模态窗体 + + + + + 设置窗体返回的结果值，并关闭窗体。 + + 当前窗体 + 模态变量 + 防止 + + + + 窗体返回的结果事件 + + + + + + + 当打开的窗体返回结果时激发 + + + + + 窗体返回的状态 + + + + + 实例化类 + + 父窗体,如果为null,则取桌面为父窗体 + + + + + 获取最顶级的父窗口 + + + + + + 显示新模态窗体,会暂时禁用父窗体,关闭当前窗体后,父窗体会恢复。 + + + + + 只运行一个实例,打开后,所有窗体都依然有效。 + + + + + + 显示窗体 + + 显示的位置 + + + + 显示在父窗体中间 + + + + + 窗体显示位置 + + + + + 右上角 + + + + + 顶部中间 + + + + + 顶部右边 + + + + + 中间 + + + + + 左下角 + + + + + 底部中间 + + + + + 右下角 + + + + + 父窗体居中 + + + + + + + + + + + + + + + + + + + + + + + + + 设置线程数量 + + + + + 要计算的总数量 + + + + + 每个线程要计算的数量 + + + + + + + + + + 当前已使用的时间 + + + + + + + 线程数量 + 要计算的事务数量 + + + + + + + + + + + + + + + + + + + + + + + 多线程计算时激发 + + + + + 在所有线程执行完毕后发生 + + + + + 在线程执行完毕后发生,最后一个执行完毕的线程将不收到本事件通知 + + + + + 进程相关接口 + + + + + 获取进程路径 + + + + + + + 获取进程路径 + + + + + + + 获取命令行 + + + + + + + 获取命令行 + + + + + + + 运行库检测类 + + + + + 获取产品状态 + + + + + + + 判断是否已安装VC运行库 + + + + + + 判断是否已安装VC运行库 + + + + + + 安装状态 + + + + + 组件禁用 + + + + + 配置数据已损坏 + + + + + 安装已暂停或正在进行 + + + + + 从源运行，源不可用 + + + + + 返回缓冲区溢出 + + + + + 无效的参数传递给该函数。 + + + + + 不公布或者未安装该产品。 + + + + + 损坏 + + + + + 该产品已公布但尚未安装。 + + + + + 正在移除的组件（操作状态，不可设置） + + + + + 不同的用户安装该产品。 + + + + + 安装在本地驱动器上 + + + + + 从源代码、CD或网络运行 + + + + + 为当前用户安装该产品。 + + + + + 安装的版本,是x86还是x64，还是全部安装了 + + + + + 判断32位和64位运行库是否已安装 + + + + + 判断32位运行库是否已安装 + + + + + 判断64位运行库是否已安装 + + + + + 判断是否已安装VC2005运行库 + + + + + + 判断是否已安装VC2005SP1运行库 + + + + + + 判断是否已安装VC2008运行库 + + + + + + 判断是否已安装VC2008SP1运行库 + + + + + + 判断是否已安装VC2010运行库 + + + + + + 判断是否已安装VC2010SP1运行库 + + + + + + 判断是否已安装VC2012运行库 + + + + + + 判断是否已安装VC2013运行库 + + + + + + 判断是否已安装VC2015或以上运行库 + + + + + + 判断是否已安装VC2017运行库或以上运行库 + + + + + + 判断是否已安装VC2019运行库或以上运行库 + + + + + + 判断是否已安装VC2022运行库或以上运行库 + + + + + + 判断当前系统是否安装了WebView2组件 + + + + + + 判断当前系统是否安装了.NET 4.8 + + + + + + 日期时间的操作类 + + + + + 获取当前是周几,周一到周日，分别是1-7. + + + + + + + 获取当前是周几,1-7，分别是返回一到日. + + + + + + + 获取当前是周几,输入日期，根据周几，分别是返回一到日. + + + + + + + 获取一周的开始和结束,开始时间为第一天的0点，结束时间以最后一天的0点为结束时间 + + + + + + + 获取2个日期相差几周 + + + + + + + + 获取2个日期相差几个月 + + + + + + + + 获取一个月的开始 + + + + + + + 判断是否在同一个星期。 + + + + + + + + 判断是否在同一个月。 + + + + + + + + 判断是否在同一天 + + + + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + 是否显示秒 + + + + + 将秒数显示成中文表达式 + + + + + + + 计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 将c# DateTime时间格式转换为Unix时间戳格式 + + 时间 + long + + + + 时间戳转为C#格式时间 + + + + + + + 时间戳转为C#格式时间 + + + + + + + 将c# DateTime时间格式转换为js时间戳格式 + + 时间 + long + + + + JS时间戳转为C#格式时间 + + + + + + + JS时间戳转为C#格式时间 + + + + + + + 根据年月日转换成日期 + + + + + + + + + 根据日期和时间转换成日期时间 + + + + + + + + 将时间转换成当前分钟开始的时间 + + + + + + + 将时间转换成当前秒钟开始的时间 + + + + + + + 当前时间在这一天里的秒数 + + + + + + + 窗体操作类 + + + + + 设置Comobox的行间距 + + + + + + + 移除关闭按钮。返回值，非零表示成功，零表示失败。 + + 窗口的句柄 + 是否成功 + + + + 把窗体放到最前 + + + + + + 显示窗体 + + + + + + + + 设置窗体是否置顶 + + + + + + + 显示没有焦点的窗口 + + + + + + 根据句柄获取窗口文本 + + + + + + + 根据句柄获取窗口类 + + + + + + + 获取当前活动的窗口句柄 + + + + + + 获取当前前台的窗口句柄 + + + + + + 设置为当前活动窗口 + + + + + + + 根据窗口句柄来获得进程id + + + + + + + 显示窗体 + + + + + + 设置窗体父窗体为桌面,不会随着显示桌面而最小化,但无法设置窗体透明度 + + + + + + 结束进程 + + + + + + + 打开窗体,只打开一个实例(非模态) + + + + + + + 将窗体植入到容器控件中 + + + 作为窗体容器的控件 + + + + + 重新调整窗体大小以适配容器大小 + + + 作为窗体容器的控件 + + + + + 设置注册表操作,部分功能需要管理员权限 + + + + + 访问的注册表位置(64位还是32位) + + + + + 访问的注册表节点 + + + + + 判断注册表项是否存在 + + + + + + + + + 删除注册表键(如果存在子键,子键将一并被删除) + + + + + + + + + + 删除注册表键值 + + + + + + + + + + 获取注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + 启动命令 + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + + + + + 把指定文件设置为开机启动或取消开机启动 + + 是否开机启动 + 开机启动名称 + 要开机启动的文件路径 + + + + + 检查是否开机启动 + + 开机启动名称 + 开机启动命令 + + + + + 检查是否开机启动 + + 开机启动名称 + + + + + 判断指定文件是否是开机启动 + + 开机启动名称 + 文件路径 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + 启动命令行 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置文件关联 + + 扩展名(如.apk) + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 设置文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 在指定文件格式右键菜单中增加菜单 + + 扩展名(如.apk) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 删除文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 获取文件关联是否存在 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 采用的IE模式 + + + + + IE7兼容视图 + + + + + IE8 标准模式 + + + + + IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE9 标准模式 + + + + + IE9 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE10 标准模式 + + + + + IE10 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置当前软件的浏览器控件内核版本 + + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + IE内核版本 + + + + + 设置当前软件的浏览器控件内核版本 + + IE内核版本 + + + + + 系统音量操作类 + + + + + 判断系统是否正处于静音(暂不支持XP或以下系统) + + + + + + 系统函数 + + + + + + + + + + 红 + + + + + 绿 + + + + + 蓝 + + + + + 获取屏幕伽马值 + + + + + + + + 设置屏幕伽马值 + + + + + + + + 获取键盘和鼠标没有操作的时间 + + + + + + 设置屏幕 Gamma值 + + + + + + + + + 设置屏幕亮度 + + + + + + + 获取系统名称,注意需要在app.manifest文件中设置兼容win10 + + + + + + SOURCE CODE FROM THE WEBSITE. + LAST UPDATE:WWW.VJSDN.COM易学论坛,2009/08/03 by Jonny Sun + + + + + Mutes the left hand channel and transfers audio fully to the right + + + + + Mutes the right hand channel and transfers audio fully to the left + + + + + 窗体操作类 + + + + + 构造函数 + + + + + + 析构 + + + + + 设置让窗体支持移动 + + + + + 是否允许可调节大小 + + + + + 可调节窗体大小的宽度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 提供一个任务调度程序，确保在ThreadPool之上运行时具有最大并发级别。 + + + + Whether the current thread is processing work items. + + + The list of tasks to be executed. + + + The maximum concurrency level allowed by this scheduler. + + + Whether the scheduler is currently processing work items. + + + + Initializes an instance of the LimitedConcurrencyLevelTaskScheduler class with the + specified degree of parallelism. + + The maximum degree of parallelism provided by this scheduler. + + + Queues a task to the scheduler. + The task to be queued. + + + + Informs the ThreadPool that there's work to be executed for this scheduler. + + + + Attempts to execute the specified task on the current thread. + The task to be executed. + + Whether the task could be executed on the current thread. + + + Attempts to remove a previously scheduled task from the scheduler. + The task to be removed. + Whether the task could be found and removed. + + + Gets the maximum concurrency level supported by this scheduler. + + + Gets an enumerable of the tasks currently scheduled on this scheduler. + An enumerable of the tasks currently scheduled. + + + + + + + + + + + + + + + + 开始截图 + + 是否截取鼠标指针 + + + + + 自动排列控件 + + + + + 最大列数 + + + + + 开始排列的坐标 + + + + + 下一项的位置 + + + + + 下一项的右下角坐标 + + + + + 竖向间隔像素 + + + + + 横向间隔像素 + + + + + 最小保留右边距,只对ReDraw2有效 + + + + + 自动排列控件构造函数 + + + + + + 自动排列控件构造函数 + + + + + + + + 开始排列控件 + + + + + 开始排列控件,当列数超过显示空间时，自动换行 + + + + + 加入的控件列表 + + + + + 初始化添加,自动将容器设置为滚动条自动显示 + + + + + + 添加控件 + + + + + + + 删除控件 + + + + + + 删除控件 + + + + + + 清空所有控件 + + + + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据当前节点生成HtmlDocument + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据XPath来查找节点 + + + + + + + + 在当前节点下根据xpath来查找符合的第一个节点 + + + + + + + + 在当前节点下根据xpath来查找所有符合的节点 + + + + + + + + A utility class to compute CRC32. + + + + + Compute a checksum for a given array of bytes. + + The array of bytes to compute the checksum for. + The computed checksum. + + + + Compute a checksum for a given string. + + The string to compute the checksum for. + The computed checksum. + + + + Represents an HTML attribute. + + + + + Gets the line number of this attribute in the document. + + + + + Gets the column number of this attribute in the document. + + + + + Gets the stream position of the value of this attribute in the document, relative to the start of the document. + + + + + Gets the length of the value. + + + + + + + + + + Gets the qualified name of the attribute. + + + + + Name of attribute with original case + + + + + Gets the HTML document to which this attribute belongs. + + + + + Gets the HTML node to which this attribute belongs. + + + + + Specifies what type of quote the data should be wrapped in + + + + + Specifies what type of quote the data should be wrapped in (internal to keep backward compatibility) + + + + + Gets the stream position of this attribute in the document, relative to the start of the document. + + + + + Gets or sets the value of the attribute. + + + + + Gets the DeEntitized value of the attribute. + + + + + Gets a valid XPath string that points to this Attribute + + + + + Compares the current instance with another attribute. Comparison is based on attributes' name. + + An attribute to compare with this instance. + A 32-bit signed integer that indicates the relative order of the names comparison. + + + + Creates a duplicate of this attribute. + + The cloned attribute. + + + + Removes this attribute from it's parents collection + + + + + An Enum representing different types of Quotes used for surrounding attribute values + + + + + A single quote mark ' + + + + + A double quote mark " + + + + + No quote mark + + + + + The initial value (current value) + + + + + Represents a combined list and collection of HTML nodes. + + + + + Gets the number of elements actually contained in the list. + + + + + Gets readonly status of colelction + + + + + Gets the attribute at the specified index. + + + + + Gets a given attribute from the list using its name. + + + + + Adds a new attribute to the collection with the given values + + + + + + + Adds supplied item to collection + + + + + Adds a range supplied items to collection. + An IEnumerable<HtmlAttribute> of items to append to this. + + + Adds a range supplied items to collection using a dictionary. + A Dictionary<string,string> of items to append to this. + + + + Explicit clear + + + + + Retreives existence of supplied item + + + + + + + Copies collection to array + + + + + + + Get Explicit enumerator + + + + + + Explicit non-generic enumerator + + + + + + Retrieves the index for the supplied item, -1 if not found + + + + + + + Inserts given item into collection at supplied index + + + + + + + Explicit collection remove + + + + + + + Removes the attribute at the specified index. + + The index of the attribute to remove. + + + + Inserts the specified attribute as the last attribute in the collection. + + The attribute to insert. May not be null. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The value of the attribute to insert. + The appended attribute. + + + + Checks for existance of attribute with given name + + + + + + + Inserts the specified attribute as the first node in the collection. + + The attribute to insert. May not be null. + The prepended attribute. + + + + Removes a given attribute from the list. + + The attribute to remove. May not be null. + + + + Removes an attribute from the list, using its name. If there are more than one attributes with this name, they will all be removed. + + The attribute's name. May not be null. + + + + Remove all attributes in the list. + + + + + Returns all attributes with specified name. Handles case insentivity + + Name of the attribute + + + + + Removes all attributes from the collection + + + + + Clears the attribute collection + + + + + Represents an HTML comment. + + + + + Gets or Sets the comment text of the node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Represents a complete HTML document. + + + + True to disable, false to enable the behavior tag p. + + + Default builder to use in the HtmlDocument constructor + + + Action to execute before the Parse is executed + + + + Defines the max level we would go deep into the html document + + + + The HtmlDocument Text. Careful if you modify it. + + + True to stay backward compatible with previous version of HAP. This option does not guarantee 100% compatibility. + + + + Adds Debugging attributes to node. Default is false. + + + + + Defines if closing for non closed nodes must be done at the end or directly in the document. + Setting this to true can actually change how browsers render the page. Default is false. + + + + + Defines if non closed nodes will be checked at the end of parsing. Default is true. + + + + + Defines if a checksum must be computed for the document while parsing. Default is false. + + + + + Defines if SelectNodes method will return null or empty collection when no node matched the XPath expression. + Setting this to true will return empty collection and false will return null. Default is false. + + + + True to disable, false to enable the server side code. + + + + Defines the default stream encoding to use. Default is System.Text.Encoding.Default. + + + + + Force to take the original comment instead of creating it + + + + + Defines if source text must be extracted while parsing errors. + If the document has a lot of errors, or cascading errors, parsing performance can be dramatically affected if set to true. + Default is false. + + + + + Defines the maximum length of source text or parse errors. Default is 100. + + + + + Defines if LI, TR, TH, TD tags must be partially fixed when nesting errors are detected. Default is false. + + + + + Defines if output must conform to XML, instead of HTML. Default is false. + + + + + If used together with and enabled, Xml namespaces in element names are preserved. Default is false. + + + + + Defines if attribute value output must be optimized (not bound with double quotes if it is possible). Default is false. + + + + Defines the global attribute value quote. When specified, it will always win. + + + + Defines if name must be output with it's original case. Useful for asp.net tags and attributes. Default is false. + + + + + Defines if name must be output in uppercase. Default is false. + + + + + Defines if declared encoding must be read from the document. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node. + Default is true. + + + + + Defines the name of a node that will throw the StopperNodeException when found as an end node. Default is null. + + + + + Defines if the 'id' attribute must be specifically used. Default is true. + + + + + Defines if empty nodes must be written as closed during output. Default is false. + + + + + The max number of nested child nodes. + Added to prevent stackoverflow problem when a page has tens of thousands of opening html tags with no closing tags + + + + + Creates an instance of an HTML document. + + + + Gets the parsed text. + The parsed text. + + + + Defines the max level we would go deep into the html document. If this depth level is exceeded, and exception is + thrown. + + + + + Gets the document CRC32 checksum if OptionComputeChecksum was set to true before parsing, 0 otherwise. + + + + + Gets the document's declared encoding. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node (pre-HTML5) or the meta charset="XXXXX" html node (HTML5). + + + + + Gets the root node of the document. + + + + + Gets the document's output encoding. + + + + + Gets a list of parse errors found in the document. + + + + + Gets the remaining text. + Will always be null if OptionStopperNodeName is null. + + + + + Gets the offset of Remainder in the original Html text. + If OptionStopperNodeName is null, this will return the length of the original Html text. + + + + + Gets the document's stream encoding. + + + + + Gets a valid XML name. + + Any text. + A string that is a valid XML name. + + + + + + + + + + + + + + + + + + + Applies HTML encoding to a specified string. + + The input string to encode. May not be null. + The encoded string. + + + + Determines if the specified character is considered as a whitespace character. + + The character to check. + true if if the specified character is considered as a whitespace character. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The new HTML attribute. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The value of the attribute. + The new HTML attribute. + + + + Creates an HTML comment node. + + The new HTML comment node. + + + + Creates an HTML comment node with the specified comment text. + + The comment text. May not be null. + The new HTML comment node. + + + + Creates an HTML element node with the specified name. + + The qualified name of the element. May not be null. + The new HTML node. + + + + Creates an HTML text node. + + The new HTML text node. + + + + Creates an HTML text node with the specified text. + + The text of the node. May not be null. + The new HTML text node. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The html is checked. + The detected encoding. + + + + Detects the encoding of an HTML text provided on a TextReader. + + The TextReader used to feed the HTML. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML text. + + The input html text. May not be null. + The detected encoding. + + + + Gets the HTML node with the specified 'id' attribute value. + + The attribute id to match. May not be null. + The HTML node with the matching id or null if not found. + + + + Loads an HTML document from a stream. + + The input stream. + + + + Loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Loads the HTML document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. May not be null. + + + + Loads the HTML document from the specified string. + + String containing the HTML document to load. May not be null. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. May not be null. + The character encoding to use. May not be null. + + + + Saves the HTML document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the HTML document to the specified TextWriter. + + The TextWriter to which you want to save. May not be null. + + + + Saves the HTML document to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. May not be null. + true to detect encoding, false otherwise. + + + + Detects the encoding of an HTML file. + + Path for the file containing the HTML document to detect. May not be null. + The detected encoding. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. May not be null. + The character encoding to use. May not be null. + + + + Creates a new XPathNavigator object for navigating this HTML document. + + An XPathNavigator object. The XPathNavigator is positioned on the root of the document. + + + + Flags that describe the behavior of an Element node. + + + + + The node is a CDATA node. + + + + + The node is empty. META or IMG are example of such nodes. + + + + + The node will automatically be closed during parsing. + + + + + The node can overlap. + + + + + A utility class to replace special characters by entities and vice-versa. + Follows HTML 4.0 specification found at http://www.w3.org/TR/html4/sgml/entities.html + Follows Additional specification found at https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references + See also: https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references + + + + + + + + + + A collection of entities indexed by name. + + + + + A collection of entities indexed by value. + + + + + Replace known entities by characters. + + The source text. + The result text. + + + + Clone and entitize an HtmlNode. This will affect attribute values and nodes' text. It will also entitize all child nodes. + + The node to entitize. + An entitized cloned node. + + + + Replace characters above 127 by entities. + + The source text. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + If set to true, the [quote], [ampersand], [lower than] and [greather than] characters will be entitized. + The result text + + + + Represents an HTML node. + + + + + Gets the name of a comment node. It is actually defined as '#comment'. + + + + + Gets the name of the document node. It is actually defined as '#document'. + + + + + Gets the name of a text node. It is actually defined as '#text'. + + + + + Gets a collection of flags that define specific behaviors for specific element nodes. + The table contains a DictionaryEntry list with the lowercase tag name as the Key, and a combination of HtmlElementFlags as the Value. + + + + + Initialize HtmlNode. Builds a list of all tags that have special allowances + + + + + Initializes HtmlNode, providing type, owner and where it exists in a collection + + + + + + + + Gets the collection of HTML attributes for this node. May not be null. + + + + + Gets all the children of the node. + + + + + Gets a value indicating if this node has been closed or not. + + + + + Gets the collection of HTML attributes for the closing tag. May not be null. + + + + + Gets the closing tag of the node, null if the node is self-closing. + + + + + Gets the first child of the node. + + + + + Gets a value indicating whether the current node has any attributes. + + + + + Gets a value indicating whether this node has any child nodes. + + + + + Gets a value indicating whether the current node has any attributes on the closing tag. + + + + + Gets or sets the value of the 'id' HTML attribute. The document must have been parsed using the OptionUseIdAttribute set to true. + + + + + Gets or Sets the HTML between the start and end tags of the object. + + + + + Gets the text between the start and end tags of the object. + + + + Gets direct inner text. + The direct inner text. + + + + Gets the last child of the node. + + + + + Gets the line number of this node in the document. + + + + + Gets the column number of this node in the document. + + + + + Gets the stream position of the area between the opening and closing tag of the node, relative to the start of the document. + + + + + Gets the stream position of the area of the beginning of the tag, relative to the start of the document. + + + + + Gets the length of the area between the opening and closing tag of the node. + + + + + Gets the length of the entire node, opening and closing tag included. + + + + + Gets or sets this node's name. + + + + + Gets the HTML node immediately following this element. + + + + + Gets the type of this node. + + + + + The original unaltered name of the tag + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets the to which this node belongs. + + + + + Gets the parent of this node (for nodes that can have parents). + + + + + Gets the node immediately preceding this node. + + + + + Gets the stream position of this node in the document, relative to the start of the document. + + + + + Gets a valid XPath string that points to this node + + + + + The depth of the node relative to the opening root html element. This value is used to determine if a document has to many nested html nodes which can cause stack overflows + + + + + Determines if an element node can be kept overlapped. + + The name of the element node to check. May not be null. + true if the name is the name of an element node that can be kept overlapped, false otherwise. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The newly created node instance. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The HTML Document builder. + The newly created node instance. + + + + Determines if an element node is a CDATA element node. + + The name of the element node to check. May not be null. + true if the name is the name of a CDATA element node, false otherwise. + + + + Determines if an element node is closed. + + The name of the element node to check. May not be null. + true if the name is the name of a closed element node, false otherwise. + + + + Determines if an element node is defined as empty. + + The name of the element node to check. May not be null. + true if the name is the name of an empty element node, false otherwise. + + + + Determines if a text corresponds to the closing tag of an node that can be kept overlapped. + + The text to check. May not be null. + true or false. + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Get Ancestors with matching name + + + + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Gets all anscestor nodes and the current node + + + + + + + Adds the specified node to the end of the list of children of this node. + + The node to add. May not be null. + The node added. + + + Sets child nodes identifier. + The chil node. + + + + Adds the specified node to the end of the list of children of this node. + + The node list to add. May not be null. + + + + Gets all Attributes with name + + + + + + + Creates a duplicate of the node + + + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + The cloned node. + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node. + + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node and the subtree under it. + + The node to duplicate. May not be null. + + + + Creates a duplicate of the node. + + The node to duplicate. May not be null. + true to recursively clone the subtree under the specified node, false to clone only the node itself. + + + + Gets all Descendant nodes for this node and each of child nodes + + The depth level of the node to parse in the html tree + the current element as an HtmlNode + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Get all descendant nodes with matching name + + + + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all descendant nodes including this node + + + + + + + Gets first generation child node matching name + + + + + + + Gets matching first generation child nodes matching name + + + + + + Gets data attribute. + The key. + The data attribute. + + + Gets the data attributes in this collection. + + An enumerator that allows foreach to be used to process the data attributes in this + collection. + + + + Gets the attributes in this collection. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + Gets the attributes in this collection. + A variable-length parameters list containing attribute names. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, + the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Inserts the specified node immediately after the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newNode is placed after the refNode. + The node being inserted. + + + + Inserts the specified node immediately before the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newChild is placed before this node. + The node being inserted. + + + + Adds the specified node to the beginning of the list of children of this node. + + The node to add. May not be null. + The node added. + + + + Adds the specified node list to the beginning of the list of children of this node. + + The node list to add. May not be null. + + + + Removes node from parent collection + + + + + Removes all the children and/or attributes of the current node. + + + + + Removes all the children of the current node. + + + + Removes all id for node described by node. + The node. + + + Move a node already associated and append it to this node instead. + The child node to move. + + + Move a children collection already associated and append it to this node instead. + The children collection already associated to move to another node. + + + Removes the children collection for this node. + The old children collection to remove. + + + + Removes the specified child node. + + The node being removed. May not be null. + The node removed. + + + + Removes the specified child node. + + The node being removed. May not be null. + true to keep grand children of the node, false otherwise. + The node removed. + + + + Replaces the child node oldChild with newChild node. + + The new node to put in the child list. + The node being replaced in the list. + The node replaced. + + + + Helper method to set the value of an attribute of this node. If the attribute is not found, it will be created automatically. + + The name of the attribute to set. May not be null. + The value for the attribute. + The corresponding attribute instance. + + + + Saves all the children of the node to the specified TextWriter. + + The TextWriter to which you want to save. + Identifies the level we are in starting at root with 0 + + + + Saves all the children of the node to a string. + + The saved string. + + + + Saves the current node to the specified TextWriter. + + The TextWriter to which you want to save. + identifies the level we are in starting at root with 0 + + + + Saves the current node to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Saves the current node to a string. + + The saved string. + + + + Sets the parent Html node and properly determines the current node's depth using the parent node's depth. + + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + true to throw Error if class name exists, false otherwise. + + + + Removes the class attribute from the node. + + + + + Removes the class attribute from the node. + + true to throw Error if class name doesn't exist, false otherwise. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + true to throw Error if class name doesn't exist, false otherwise. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + true to throw Error if class name doesn't exist, false otherwise. + + + Gets the CSS Class from the node. + + The CSS Class from the node + + + + Check if the node class has the parameter class. + The class. + True if node class has the parameter class, false if not. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type targetType including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Creates a new XPathNavigator object for navigating this HTML node. + + An XPathNavigator object. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document. + + + + Creates an XPathNavigator using the root of this document. + + + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects the first XmlNode that matches the XPath expression. + + The XPath expression. May not be null. + The first that matches the XPath query or a null reference if no matching node was found. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Includes tools that GetEncapsulatedData method uses them. + + + + + Determine if a type define an attribute or not , supporting both .NetStandard and .NetFramework2.0 + + Type you want to test it. + Attribute that type must have or not. + If true , The type parameter define attributeType parameter. + + + + Retrive properties of type that defined . + + Type that you want to find it's XPath-Defined properties. + IEnumerable of property infos of a type , that defined specific attribute. + + + + Determine if a has implemented BUT is considered as NONE-IEnumerable ! + + The property info you want to test. + True if property info is IEnumerable. + + + + Returns T type(first generic type) of or . + + IEnumerable-Implemented property + List of generic types. + + + + Find and Return a mehtod that defined in a class by it's name. + + Type of class include requested method. + Name of requested method as string. + Method info of requested method. + + + + Create of given type. + + Type that you want to make a List of it. + Returns IList of given type. + + + + Returns the part of value of you want as . + + A htmlNode instance. + Attribute that includes ReturnType + String that choosen from HtmlNode as result. + + + + Returns parts of values of you want as . + + that you want to retrive each value. + A instnce incules . + Type of IList generic you want. + + + + + Simulate Func method to use in Lambada Expression. + + + + + + + + + This method works like Where method in LINQ. + + + + + + + + + Check if the type can instantiated. + + + + + + + Returns count of elements stored in IEnumerable of T + + + + + + + + Specify which part of is requested. + + + + + The text between the start and end tags of the object. + + + + + The HTML between the start and end tags of the object + + + + + The object and its content in HTML + + + + + Just mark and flag classes to show they have properties that defined . + + + + + Includes XPath and . XPath for finding html tags and for specify which part of you want to return. + + + + + XPath Expression that is used to find related html node. + + + + + Html Attribute name + + + + + The methode of output + + + + + Specify Xpath to find related Html Node. + + + + + + Specify Xpath to find related Html Node. + + + Specify you want the output include html text too. + + + + Specify Xpath and Attribute to find related Html Node and its attribute value. + + + + + + + Tagging a property with this Attribute make Encapsulator to ignore that property if it causes an error. + + + + + Exception that often occures when there is no way to bind a XPath to a Html Tag. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no way to bind a XPath to a HtmlTag Attribute. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no property that assigned with XPath Property in Class. + + + + + + + + + + + + + + + + + + + + + + + Represents a combined list and collection of HTML nodes. + + + + + Initialize the HtmlNodeCollection with the base parent node + + The base node of the collection + + + Gets the parent node associated to the collection. + + + + Gets a given node from the list. + + + + + Get node with tag name + + + + + + + Gets the number of elements actually contained in the list. + + + + + Is collection read only + + + + + Gets the node at the specified index. + + + + + Add node to the collection + + + + + + Add node to the collection + + + + + + + Clears out the collection of HtmlNodes. Removes each nodes reference to parentnode, nextnode and prevnode + + + + + Gets existence of node in collection + + + + + + + Copy collection to array + + + + + + + Get Enumerator + + + + + + Get Explicit Enumerator + + + + + + Get index of node + + + + + + + Insert node at index + + + + + + + Remove node + + + + + + + Remove at index + + + + + + Get first instance of node in supplied collection + + + + + + + + Add node to the end of the collection + + + + + + Get first instance of node with name + + + + + + + Get index of node + + + + + + + Add node to the beginning of the collection + + + + + + Remove node at index + + + + + + + Replace node at index + + + + + + + Get all node descended from this collection + + + + + + Get all node descended from this collection with matching name + + + + + + Gets all first generation elements in collection + + + + + + Gets all first generation elements matching name + + + + + + + All first generation nodes in collection + + + + + + Represents an HTML navigator on an HTML document seen as a data store. + + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Gets the base URI for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the current HTML document. + + + + + Gets the current HTML node. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node is an empty element. + + + + + Gets the name of the current HTML node without the namespace prefix. + + + + + Gets the qualified name of the current node. + + + + + Gets the namespace URI (as defined in the W3C Namespace Specification) of the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the associated with this implementation. + + + + + Gets the type of the current node. + + + + + Gets the prefix associated with the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the text value of the current node. + + + + + Gets the xml:lang scope for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Creates a new HtmlNavigator positioned at the same node as this HtmlNavigator. + + A new HtmlNavigator object positioned at the same node as the original HtmlNavigator. + + + + Gets the value of the HTML attribute with the specified LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + The value of the specified HTML attribute. String.Empty or null if a matching attribute is not found or if the navigator is not positioned on an element node. + + + + Returns the value of the namespace node corresponding to the specified local name. + Always returns string.Empty for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns string.Empty for the HtmlNavigator implementation. + + + + Determines whether the current HtmlNavigator is at the same position as the specified HtmlNavigator. + + The HtmlNavigator that you want to compare against. + true if the two navigators have the same position, otherwise, false. + + + + Moves to the same position as the specified HtmlNavigator. + + The HtmlNavigator positioned on the node that you want to move to. + true if successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves to the HTML attribute with matching LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + true if the HTML attribute is found, otherwise, false. If false, the position of the navigator does not change. + + + + Moves to the first sibling of the current node. + + true if the navigator is successful moving to the first sibling node, false if there is no first sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the first HTML attribute. + + true if the navigator is successful moving to the first HTML attribute, otherwise, false. + + + + Moves to the first child of the current node. + + true if there is a first child node, otherwise false. + + + + Moves the XPathNavigator to the first namespace node of the current element. + Always returns false for the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the node that has an attribute of type ID whose value matches the specified string. + + A string representing the ID value of the node to which you want to move. This argument does not need to be atomized. + true if the move was successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves the XPathNavigator to the namespace node with the specified local name. + Always returns false for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the next sibling of the current node. + + true if the navigator is successful moving to the next sibling node, false if there are no more siblings or if the navigator is currently positioned on an attribute node. If false, the position of the navigator is unchanged. + + + + Moves to the next HTML attribute. + + + + + + Moves the XPathNavigator to the next namespace node. + Always returns falsefor the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the parent of the current node. + + true if there is a parent node, otherwise false. + + + + Moves to the previous sibling of the current node. + + true if the navigator is successful moving to the previous sibling node, false if there is no previous sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the root node to which the current node belongs. + + + + + Represents the type of a node. + + + + + The root of a document. + + + + + An HTML element. + + + + + An HTML comment. + + + + + A text node is always the child of an element or a document node. + + + + + Represents a parsing error found during document parsing. + + + + + Gets the type of error. + + + + + Gets the line number of this error in the document. + + + + + Gets the column number of this error in the document. + + + + + Gets a description for the error. + + + + + Gets the the full text of the line containing the error. + + + + + Gets the absolute stream position of this error in the document, relative to the start of the document. + + + + + Represents the type of parsing error. + + + + + A tag was not closed. + + + + + A tag was not opened. + + + + + There is a charset mismatch between stream and declared (META) encoding. + + + + + An end tag was not required. + + + + + An end tag is invalid at this position. + + + + + Represents an HTML text node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets or Sets the text of the node. + + + + + A utility class to get HTML document from HTTP. + + + + + Represents the method that will handle the PostResponse event. + + + + + Represents the method that will handle the PreHandleDocument event. + + + + + Represents the method that will handle the PreRequest event. + + + + + Occurs after an HTTP request has been executed. + + + + + Occurs before an HTML document is handled. + + + + + Occurs before an HTTP request is executed. + + + + + Gets or Sets a value indicating if document encoding must be automatically detected. + + + + + Gets or sets the Encoding used to override the response stream from any web request + + + + + Gets or Sets a value indicating whether to get document only from the cache. + If this is set to true and document is not found in the cache, nothing will be loaded. + + + + + Gets or Sets a value indicating whether to get document from the cache if exists, otherwise from the web + A value indicating whether to get document from the cache if exists, otherwise from the web + + + + + Gets or Sets the cache path. If null, no caching mechanism will be used. + + + + + Gets a value indicating if the last document was retrieved from the cache. + + + + + Gets the last request duration in milliseconds. + + + + + Gets the URI of the Internet resource that actually responded to the request. + + + + + Gets the last request status. + + + + + Gets or Sets the size of the buffer used for memory operations. + + + + + Gets or Sets a value indicating if cookies will be stored. + + + + Gets or sets a value indicating whether redirect should be captured instead of the current location. + True if capture redirect, false if not. + + + + Gets or Sets the User Agent HTTP 1.1 header sent on any webrequest + + + + + Gets or Sets a value indicating whether the caching mechanisms should be used or not. + + + + + Gets the MIME content type for a given path extension. + + The input path extension. + The default content type to return if any error occurs. + The path extension's MIME content type. + + + + Gets the path extension for a given MIME content type. + + The input MIME content type. + The default path extension to return if any error occurs. + The MIME content type's path extension. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The requested type. + An newly created instance. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. - Proxy aware + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. Understands Proxies + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + + Gets the cache file path for a specified url. + + The url fo which to retrieve the cache path. May not be null. + The cache file path. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The XmlTextWriter to which you want to save to. + + + Gets or sets the web browser timeout. + + + + Gets or sets the web browser delay. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + An newly created instance. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + An newly created instance. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". May not be null. + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + + + + Represents an exception thrown by the HtmlWeb utility class. + + + + + Creates an instance of the HtmlWebException. + + The exception's message. + + + + Represents a document with mixed code and text. ASP, ASPX, JSP, are good example of such documents. + + + + + Gets or sets the token representing code end. + + + + + Gets or sets the token representing code start. + + + + + Gets or sets the token representing code directive. + + + + + Gets or sets the token representing response write directive. + + + + + Creates a mixed code document instance. + + + + + Gets the code represented by the mixed code document seen as a template. + + + + + Gets the list of code fragments in the document. + + + + + Gets the list of all fragments in the document. + + + + + Gets the encoding of the stream used to read the document. + + + + + Gets the list of text fragments in the document. + + + + + Create a code fragment instances. + + The newly created code fragment instance. + + + + Create a text fragment instances. + + The newly created text fragment instance. + + + + Loads a mixed code document from a stream. + + The input stream. + + + + Loads a mixed code document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads the mixed code document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Loads a mixed document from a text + + The text to load. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + The character encoding to use. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + The character encoding to use. + + + + Saves the mixed document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the mixed document to the specified TextWriter. + + The TextWriter to which you want to save. + + + + Represents a fragment of code in a mixed code document. + + + + + Gets the fragment code text. + + + + + Represents a base class for fragments in a mixed code document. + + + + + Gets the fragement text. + + + + + Gets the type of fragment. + + + + + Gets the line number of the fragment. + + + + + Gets the line position (column) of the fragment. + + + + + Gets the fragment position in the document's stream. + + + + + Represents a list of mixed code fragments. + + + + + Gets the Document + + + + + Gets the number of fragments contained in the list. + + + + + Gets a fragment from the list using its index. + + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Appends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Prepends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Remove a fragment from the list of fragments. If this fragment was not in the list, an exception will be raised. + + The fragment to remove. May not be null. + + + + Remove all fragments from the list. + + + + + Remove a fragment from the list of fragments, using its index in the list. + + The index of the fragment to remove. + + + + Represents a fragment enumerator. + + + + + Gets the current element in the collection. + + + + + Gets the current element in the collection. + + + + + Advances the enumerator to the next element of the collection. + + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + + + + Sets the enumerator to its initial position, which is before the first element in the collection. + + + + + Represents the type of fragment in a mixed code document. + + + + + The fragment contains code. + + + + + The fragment contains text. + + + + + Represents a fragment of text in a mixed code document. + + + + + Gets the fragment text. + + + + + 给控件增加拖放功能的类 + + + + + 拖放实例 + + + + + 高级拖放事件 + + + + + + + + + + + + + + + + + + + + + + + + + 使管理员方式运行时支持拖放 + + + + + + 使支持拖放属性 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取WMI内容 + + + + + + + 获取WMI内容 + + + + + + + 获取内存信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取硬盘信息 + + + + + + 获取主板信息 + + + + + + 获取处理器信息 + + + + + + 获取主要硬件信息 + + + + + + 获取主要硬件信息 + + 是否获取XML格式 + + + + + 网络操作类 + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 根据mac字符串来获取最终的mac地址,可以是各种MAC地址格式,非法的内容将返回null + + + + + + + 远程唤醒 + + + + + + + + 远程唤醒 + + + + + + + + + 消息服务器 + + + + + 消息事件 + + + + + + + 大小改变事件 + + + + + + + + 即将关闭事件 + + + + + + + 当收到消息时激发 + + + + + 消息处理类 + + + + + + + + + + + + + + + + + + + + + + + 发送消息,采用单线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 发送消息，采用多线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 消息类 + + + + + 是否取消 + + + + + 来源句柄 + + + + + + + + + + 消息文本 + + + + + 需要回复的内容 + + + + + 消息客户端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 最后一次接收消息的时间,可用来判断服务端是否有响应 + + + + + 主句柄 + + + + + 当收到消息时激发 + + + + + 连接上主服务器时触发 + + + + + 收到服务端关闭通知 + + + + + 收到服务端关闭通知，即将关闭 + + + + + 服务端大小改变时激发 + + + + + 实例化客户端 + + 服务端ID + 当前客户端ID,会向服务器报告当前ID + 客户端 + + + + + + + + + 断开服务端连接 + + + + + 发送消息,采用多线程发送 + + + + + + + 向服务端发送心跳包 + + + + + 判断服务端句柄是否存在。 + + + + + + 消息服务端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 当收到消息时激发 + + + + + 当收到自定义消息时(非系统消息)激发 + + + + + 有消息客户端发起连接请求时激发 + + + + + 有消息客户端连接成功时激发 + + + + + 有消息客户端断开连接时激发 + + + + + + + 服务端ID,需要唯一性,共客户端识别 + 服务端 + + + + 释放资源 + + + + + 判断是否包含指定客户端 + + + + + + + + + + + + 设置客户端大小 + + + + + 根据客户端ID,获取客户端对象 + + + + + + + 根据客户端句柄,获取客户端对象 + + + + + + + 关闭所有客户端 + + + + + 关闭指定客户端 + + + + + + 关闭指定客户端 + + + + + + 向所有客户端发送消息，单线程 + + + + + + + 向指定客户端发送消息 + + + + + + + + 关闭在指定时间前失去响应的子客户端 + + + + + + 客户端信息 + + + + + 客户端句柄 + + + + + 客户端ID + + + + + 客户端连接时间 + + + + + 心跳时间 + + + + + 共享内存 + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 删除内存映射 + + + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + 发送消息的窗口句柄 + 发送消息 + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射对象 + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射字节数据 + + + + 数据库引擎 + + + + + 数据库枚举类型 + + + + + Odbc引擎 + + + + + OleDb引擎 + + + + + Oracle引擎 + + + + + MSSQL引擎 + + + + + SQLite引擎 + + + + + MySql引擎 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据 + + + + + + + 获取第一行第一列的值 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + + 建立访问数据库的实例 + + 数据库枚举类型 + + + + + 数据库操作接口 + + + + + 连接数据库 + + + + + + 数据库是否已连接 + + + + + 断开数据库 + + + + + + 获取数量 + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + + 获取分页语句 + + + + + + + + + + 添加Parameter参数 + + + + + + + 清空Parameter参数 + + + + + + + 获取Parameter值 + + + + + + 根据RyQuickSQL类来获取Parameter值 + + + + + + + 开始执行事务 + + + + + 提交事务 + + + + + 判断是否包含数据 + + + + + + + + 返回-1000表示该数据库不支持本接口 + + + + + + + 读取数据 + + + + + + + 读取数据 + + + + + + + + 读取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + 执行SQL语句 + + + + + + + 根据id号删除数据 + + + + + + + + 根据id号删除数据 + + + + + + + + 创建数据库 + + + + + + + 释放资源 + + + + + 最后一个错误信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + SQL字段类型 + + + + + SQL字段类型 + + + + + + + SQL字段类型 + + + + + + + + SQL字段名 + + + + + SQL字段值 + + + + + SQL字段长度 + + + + + 不是真的值，而是用于计算的值 + + + + + SQL快速操作类 + + + + + SQL快速操作类 + + + + + + 表名 + + + + + 操作字段列表 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + + + + + + + + 操作参数列表 + + + + + 操作参数列表 + + + + + 添加字符串字段 + + + + + + + 添加null值字段 + + + + + + 添加日期字段 + + + + + + + 添加int字段 + + + + + + + 添加double字段 + + + + + + + 添加decimal字段 + + + + + + + 添加byte[]字段 + + + + + + + 添加bool字段 + + + + + + + 添加用于计算的值 + + + + + + + 添加Int64字段 + + + + + + + 清空内容 + + + + + 数量 + + + + + + + + + + 输出多条件搜索。 + + 字段名,多个字段请用逗号分隔。 + 多个条件之间请用空格隔开 + + + + + 获取插入SQL语句 + + + + + + 获取更新SQL语句 + + + + + + 添加参数 + + + + + + + 获取Ole参数 + + + + + + 获取SQL参数 + + + + + + + + + + + + + + + + + + + + + + + 数据库路径 + 数据库密码 + + + + + + + 数据库路径 + + + + + + + + + + + + + + + + + + + + 连接数据库 + + + + + + 设置路径和密码 + + + + + + 连接数据库 + + + + + + + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 创建数据库 + + SQL语句 + + + + + 根据内置例子创建数据库 + + + + + + 保存信息，如果Name不存在，系统会自动创建 + + 返回1，表示成功，0表示失败 + + + + 获取信息 + + + + + + 获取信息 + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Http连接操作帮助类 + + + + + + + + + + + + 根据相传入的数据，得到相应页面数据 + + 参数类对象 + 返回HttpResult类型 + + + + 获取数据的并解析的方法 + + + + + + + 设置编码 + + HttpItem + HttpResult + byte[] + + + + 提取网页Byte + + + + + + 为请求准备参数 + + 参数列表 + + + + 设置证书 + + + + + + 设置多个证书 + + + + + + 设置Cookie + + Http参数 + + + + 设置Post数据 + + Http参数 + + + + 设置代理 + + 参数对象 + + + + 回调验证证书问题 + + 流对象 + 证书 + X509Chain + SslPolicyErrors + bool + + + + 通过设置这个属性，可以在发出连接的时候绑定客户端发出连接所使用的IP地址。 + + + + + + + + + Http请求参考类 + + + + + 请求URL必须填写 + + + + + 请求方式默认为GET方式,当为POST方式时必须设置Postdata的值 + + + + + 默认请求超时时间 + + + + + 默认写入Post数据超时间 + + + + + 设置Host的标头信息 + + + + + 获取或设置一个值，该值指示是否与 Internet 资源建立持久性连接默认为true。 + + + + + 请求标头值 默认为text/html, application/xhtml+xml, */* + + + + + 请求返回类型默认 text/html + + + + + 客户端访问信息默认Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0) + + + + + 返回数据编码默认为NUll,可以自动识别,一般为utf-8,gbk,gb2312 + + + + + Post的数据类型 + + + + + Post请求时要发送的字符串Post数据 + + + + + Post请求时要发送的Byte类型的Post数据 + + + + + Cookie对象集合 + + + + + 请求时的Cookie + + + + + 来源地址，上次访问地址 + + + + + 证书绝对路径 + + + + + 设置代理对象，不想使用IE默认配置就设置为Null，而且不要设置ProxyIp + + + + + 是否设置为全文小写，默认为不转化 + + + + + 获取或设置要在 HTTP 请求中使用的 Date HTTP 标头值。默认不填写 + + + + + 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 + + + + + 最大连接数 + + + + + 代理Proxy 服务器用户名 + + + + + 代理 服务器密码 + + + + + 代理 服务IP,如果要使用IE代理就设置为ieproxy + + + + + 设置返回类型String和Byte + + + + + header对象 + + + + + 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 + + + + + 获取或设置一个 System.Boolean 值，该值确定是否使用 100-Continue 行为。如果 POST 请求需要 100-Continue 响应，则为 true；否则为 false。默认值为 true。 + + + + + 设置509证书集合 + + + + + 设置或获取Post参数编码,默认的为Default编码 + + + + + Cookie返回类型,默认的是只返回字符串类型 + + + + + 获取或设置请求的身份验证信息。 + + + + + 设置请求将跟随的重定向的最大数目 + + + + + 获取和设置IfModifiedSince，默认为当前日期和时间 + + + + + 设置本地的出口ip和端口 + ] + + item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); + + + + + 是否重置request,response的值，默认不重置，当设置为True时request,response将被设置为Null + + + + + Http返回参数类 + + + + + Http请求返回的Cookie + + + + + Cookie对象集合 + + + + + 返回的String类型数据 只有ResultType.String时才返回数据，其它情况为空 + + + + + 返回的Byte数组 只有ResultType.Byte时才返回数据，其它情况为空 + + + + + header对象 + + + + + 返回状态说明 + + + + + 返回状态码,默认为OK + + + + + 最后访问的URl + + + + + 获取重定向的URl + + + + + 返回类型 + + + + + 表示只返回字符串 只有Html有数据 + + + + + 表示返回字符串和字节流 ResultByte和Html都有数据返回 + + + + + Post的数据格式默认为string + + + + + 字符串类型，这时编码Encoding可不设置 + + + + + Byte类型，需要设置PostdataByte参数的值编码Encoding可设置为空 + + + + + 传文件，Postdata必须设置为文件的绝对路径，必须设置Encoding的值 + + + + + Cookie返回类型 + + + + + 只返回字符串类型的Cookie + + + + + CookieCollection格式的Cookie集合同时也返回String类型的cookie + + + + + Http服务器类 + + + + + + + + + + + + 当收到Get事件时激发 + + + + + 当收到Post事件时激发 + + + + + 监听的主机,默认是localhost + + + + + 最后一次错误信息 + + + + + 在此端口建立Http服务类 + + 端口号 + + + + + + + + + + 开始服务 + + + + + 退出服务 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超时时间 + + + + 以post方式获取网页源码 + + + + + + + + + 以post方式提交json内容 + + + + + + + + + 以post方式提交json内容 + + + + + + + + 头信息 + + + + + 以post方式获取网页源码 + + + + + + + + + + 以post方式获取网页源码 + + + + + + + + 获取网址对应的文件大小 + + + + + + + 获取网址对应的文件大小 + + + + + + + + 获取网址对应的文件大小 + + + + + + + + + 代理 + + + + + 代理用户名 + + + + + 代理密码 + + + + + + + + + + 是否自动跳转 + + + + + 获取网页源码 + + + + + + + + + + 获取网页源码 + + + + + + + + 获取网页源码 + + + + + + + + 获取网页源码 + + + + + + + + + 获取网页源码 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将相对网址转换成绝对网址 + + 相对网址 + 当前页面地址 + 转换后的绝对网址 + + + + WebDav接口 + + + + + WebDav初始化 + + + + + + + + 删除文件 + + 相对路径,不包括域名 + + + + + 下载文件 + + + + + + + + 下载文件 + + + + + + + + + 上传文件 + + + + + + + + 上传文件 + + + + + + + + + 新建文件夹 + + + + + + + 新建文件夹 + + 文件夹路径 + + + + + + 新建文件夹 + + + + + + + + 将文件或目录列出来 + + + + + + + + 定义每个文件或目录的属性 + + + + + 文件名 + + + + + 是否是文件夹 + + + + + 网址 + + + + + 最后修改时间 + + + + + + + + + + + + + + + url解密 + + + + + + + + url解密,按UTF8方式解密 + + + + + + + Url加密 + + + + + + + + Url加密,按UTF8方式加密 + + + + + + + 解密 + + + + + + + 加密 + + + + + + + + + + + + + + + + + + + + + + + + + url加密,Unicode + + + + + + + + + + + + + + + + + + + + + + Html解码,将html里未转义成功的重新转义。 + + + + + + + 将url里的字段分解成表单字典 + + + + + + + + + 根据表单字段名获取值 + + + + + + + + + AES加密解密类 + + + + + AES加密算法 + + 明文字符串 + 密钥 + 返回加密后的密文字节数组 + + + + AES解密 + + 密文字节数组 + 密钥 + 返回解密后的字符串 + + + + 加密 + + + + + + + + 解码 + + + + + + + + 转换密钥到合法密钥 + + + + + + + Base64编码类 + + + + + 编码 + + + + + + + 把字符串编码成Base64字符串 + + + + + + + + 解码 + + + + + + + MD5和SHA1操作类 + + + + + 计算文件MD5。 + 通过MD5CryptoServiceProvider类中的ComputeHash方法直接传入一个FileStream类实现计算MD5 + 操作简单，代码少，调用即可 + + 文件地址 + MD5Hash + + + + 计算文件MD5。 + 通过HashAlgorithm的TransformBlock方法对流进行叠加运算获得MD5 + 实现稍微复杂，但可使用与传输文件或接收文件时同步计算MD5值 + 可自定义缓冲区大小，计算速度较快 + + 文件地址 + MD5Hash + + + + 获取MD5 + + + + + + + 获取MD5 + + + + + + + 获取SHA1 + + + + + + + 获取SHA1 + + + + + + + 获取HmacSHA1 + + + + + + + + 获取SHA256 + + + + + + + 获取HmacSHA256 + + + + + + + + 获取SHA224 + + + + + + + 获取SHA512 + + + + + + + 获取HmacSHA512 + + + + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 内部类 + + + + 读写锁对象 + + + + 是否为写入模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 构造函数 + + 读写锁 + 写入模式为true,读取模式为false + + + 释放对象时退出指定锁定模式 + + + + 空的可释放对象,免去了调用时需要判断是否为null的问题 + 内部类 + + + + 空的可释放对象 + + + + 空的释放方法 + + + + 读写锁 + + + + 保存数据 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + 为Data属性设置初始值 + + + + 获取或设置当前对象中保存数据的值 + + 获取数据时未进入读取或写入锁定模式 + 设置数据时未进入写入锁定模式 + + + 是否启用,当该值为false时,Read()和Write()方法将返回 Disposable.Empty + + + + 进入读取锁定模式,该模式下允许多个读操作同时进行 + 退出读锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在读取或写入锁定模式下重复执行,返回Disposable.Empty; + + + + 进入写入锁定模式,该模式下只允许同时执行一个写操作 + 退出写锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在写入锁定模式下重复执行,返回Disposable.Empty; + + 读取模式下不能进入写入锁定状态 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Shell + + + + + 根据路径获取 IShellFolder 和 PIDL + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 弹出系统右键菜单 + + + + + + + + 中国农历类,最大支持公元0-9999年 + + 日期：2019-02-09 + 作者：http://www.cnblogs.com/zjfree/ + + + + 日历类型 + + + + + 无效 + + + + + Julian 日历 + + + + + Gregorian 日历 + + + + + 有效 + + + + + 公历节日 + + + + + 农历节日 + + + + + 某个月第n个星期几 + + + + + 获取农历 + + + + + + + 获取农历 + + + + + + + + + 获得某农历年的闰月，返回 1~12 对应一月到十二月，返回 0 表示无闰月 + + + + + + + 农历搜索方向 + + + + + 无效 + + + + + 向上 + + + + + 向下 + + + + + {* 日月食类型， 无， 日食， 月全食， 月偏食 } + + + + + 无 + + + + + 日食 + + + + + 月全食 + + + + + 月偏食 + + + + + {* 月相， 无， 朔， 望} + + + + + 无 + + + + + 朔 + + + + + 望 + + + + + 获得某公历年月日的农历日数和该日月相以及日月食类型和时刻 + + + + + + + + + + + + 获得某公历年月日的农历月数 + + + + + + + + + 获取阳历日期对应的农历日期 + + + + + + + + + + + + + 获得某公历年月日的农历月日和是否闰月的信息 + + + + + + + + + + + + 获得等效标准日数对应的某公历日，倒推而来 + + + + + + + + + + 比较两个农历日期（包括闰月信息），1 大于2返回1、1等于2返回0、1小于2返回-1 + + + + + + + + + + + + + + 获得某农历年月日（加是否闰月）的公历年月日 + 该函数采用反向二分法查找 + + + + + + + + + + + + + 获取农历某一个月的总天数 + + + + + + + + + 获取农历年份，范围约1901-2101年 + + + + + + + 获取农历年份，范围约0-9999年 + + + + + + + + + 获取农历月份，范围约1901-2101年 + + + + + + + 获取农历月份，范围约0-9999年 + + + + + + + + + 获取中文表示的农历月份 + + + + + + + 获取农历日，范围约1901-2101年 + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 返回y年第n个节气（如小寒为1）的日差天数值（pd取值真假，分别表示平气和定气） + + + + pd取值真假，分别表示平气和定气 + + + + + 获取等效标准日数 + + + + + + + + + 取本月天数，不考虑 1582 年 10 月的特殊情况 + + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 获取节气 + + + + + + + + + + + + 获取公历节日 + + + + + + + 获取公历节日 + + + + + + + + + 获取指定月份的第n个星期几的节日 + + + + + + + 返回星座，范围约1901-2101年 + + + + + 返回星座，范围约0-9999年 + + + + + 获取农历节日 + + + + + + + + + 获取农历节日 + + + + + + + 判断y年m月(1,2,..,12,下同)d日是Gregorian历还是Julian历（opt=1,2,3分别表示标准日历,Gregorge历和Julian历）,是则返回1，是Julian历则返回0，若是Gregorge历所删去的那10天则返回-1 + + + + + 返回阳历y年m月d日的日差天数（在y年年内所走过的天数，如2000年3月1日为61） + + + + + 返回阳历y年日差天数为x时所对应的月日数（如y=2000，x=274时，返回1001(表示10月1日，即返回100*m+d)） + + + + + 获取指定日期的节气。 + + 要获取的年 + 要获取的月 + + + 立春：立是开始的意思，春是蠢动，表示万物开始有生气，这一天春天开始。 + 雨水：降雨开始，雨水将多。 + 惊蛰：春雷响动，惊动蛰伏地下冬眠的生物，它们将开始出土活动。 + 春分：这是春季九十天的中分点，这一天昼夜相等，所以古代曾称春分秋分为昼夜分。 + 清明：明洁晴朗，气候温暖，草木开始萌发繁茂。 + 谷雨：雨生百谷的意思。雨水增多，适时的降雨对谷物生长很为有利。 + 立夏：夏天开始，万物渐将随温暖的气候而生长。 + 小满：满指籽粒饱满，麦类等夏热作物这时开始结籽灌浆，即将饱满。 + 芒种：有芒作物开始成熟，此时也是秋季作物播种的最繁忙时节。 + 夏至：白天最长，黑夜最短，这一天中午太阳位置最高，日影短至终极，古代又称这一天为日北至或长日至。 + 小暑：暑是炎热，此时还未到达最热。 + 大暑：炎热的程度到达高峰。 + 立秋：秋天开始，植物快成熟了。 + 处暑：处是住的意思，表示暑气到此为止。 + 白露：地面水气凝结为露，色白，是天气开始转凉了。 + 秋分：秋季九十天的中间，这一天昼夜相等，同春分一样，太阳从正东升起正西落下。 + 寒露：水露先白而后寒，是气候将逐渐转冷的意思。 + 霜降：水气开始凝结成霜。 + 立冬：冬是终了，作物收割后要收藏起来的意思，这一天起冬天开始。 + 小雪：开始降雪，但还不多。 + 大雪：雪量由小增大。 + 冬至：这一天中午太阳在天空中位置最低，日影最长，白天最短， 黑夜最长，古代又称短日至或日南至。 + 小寒：冷气积久而为寒，此时尚未冷到顶点。 + 大寒：天候达到最寒冷的程度 + + + + + 获取年柱。 + + + + + 获得月柱 + + + + + + + 获取日柱。 + + + + + 返回甲子数x对应的天干数（如33为3） + + + + + 返回甲子数x对应的地支数（如33为9） + + + + + 获取日的天干地支 + + + + + + + 返回甲子数x对应的天干字符串 + + + + + 返回甲子数x对应的地支字符串 + + + + + 返回甲子数x对应的干支字符串 + + + + + + + 获取三伏开始时间 + + + 0表示1伏，1表示2伏，2表示3伏 + + + + + 节气 + + + + + 节气的时间。 + + + + + 节气名。 + + + + + 热键转换类 + + + + + 功能键。 + + + + + 修改键。 + + + + + 转换功能键到谷歌浏览器专用 + + + + + 将chrome功能键转换为普通功能键 + + + + + + + 按键值。 + + + + + 初始化类 的新实例。 + + The modifiers. + The key code. + + + + + + + + + + + + + + + + + 初始化类 的新实例。 + + + + + 加载热键 + + + + + + + 加载热键 + + + + + + 加载热键 + + + + + + 判断是否是热键 + + + + + 获取当前热键 + + + + + 已重载，返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 功能键 + + + + + 无 + + + + + Alt键 + + + + + Ctrl键 + + + + + Alt+Ctrl键 + + + + + Shift键 + + + + + Shift+Alt键 + + + + + Shift+Ctrl键 + + + + + Alt+Shift+Ctrl键 + + + + + Win键 + + + + + 热键类 + + + + + 热键类 + + + + + + 热键注销 + + + + + 热键是否有效 + + + + + 释放热键 + + + + + 获取热键Tag + + + + + + + 获取热键id + + + + + + + 获取热键id + + + + + + + + 判断热键id是否存在 + + + + + + + 判断热键Tag是否存在 + + + + + + + 判断热键是否存在 + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + + 获取热键数量 + + + + + 删除热键 + + + + + + + 删除所有热键 + + + + + 删除所有热键 + + + + + 热键事件 + + + + + + 当使用热键时发生的事件 + + + + + 热键消息过滤 + + + + + + + 热键类型 + + + + + 热键id + + + + + 热键Tag + + + + + 功能键 + + + + + 普通键 + + + + + 热键类型 + + + + + + + + 热键类型 + + + + + + + + + 热键类型 + + + + + Win32 API + + + + + + + + + + WM_COPYDATA消息的主要目的是允许在进程间传递只读数据。 + + + + + 系统通道ID + + + + + 用户通道ID + + + + + 获取消息 + + + + + + + + 发送消息 + + + + + + + + + + 设置父窗口 + + + + + + + + + + + + + + 删除一个逻辑笔、画笔、字体、位图、区域或者调色板，释放所有与该对象有关的系统资源，在对象被删除之后，指定的句柄也就失效了。 + + + + + + + 选择一对象到指定的设备上下文环境中，该新对象替换先前的相同类型的对象。 + + + + + + + + 创建一个与指定设备兼容的内存设备上下文环境（DC）。 + + + + + + + 为一个设备创建设备上下文环境。 + + + + + + + + + + 删除指定的设备上下文环境（Dc）。 + + + + + + + + + + + + 结束进程 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 模拟鼠标点击 + + + + + + + + + + + 模拟按键 + + + + + + + + + 返回hWnd参数所指定的窗口的设备环境。 + + + + + + + 移动窗口 + + + + + + + + + + + + 将消息信息传送给指定的窗口过程的函数。使用函数CallWindowsProc可进行窗口子分类。 + 通常来说，同一类的所有窗口共享一个窗口过程。子类是一个窗口或者相同类的一套窗口， + 在其消息被传送到该类的窗口过程之前，这些消息是由另一个窗口过程进行解释和处理的。 + + + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 设置弹出式窗口，层叠窗口或子窗口的父窗口 + + + + + + + + 获得一个指定子窗口的父窗口句柄 + + Handle to the window whose parent window handle is to be retrieved. + If the window is a child window, the return value is a handle to the parent window. If the window is a top-level window, the return value is a handle to the owner window. If the window is a top-level unowned window or if the function fails, the return value is NULL. + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作 + + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作。 + 如果此参数为FALSE，GetSystemMenu返回当前使用窗口菜单的拷贝的句柄。该拷贝初始时与窗口菜单相同，但可以被修改。 + 如果此参数为TRUE，GetSystemMenu重置窗口菜单到缺省状态。如果存在先前的窗口菜单，将被销毁。 + + 如果参数bRevert为FALSE，返回值是窗口菜单的拷贝的句柄：如果参数bRevert为TRUE，返回值是NULL。 + + + + 从指定菜单删除一个菜单项或分离一个子菜单。 + 备注：只要一个菜单被修改，无论它是否在显示窗口里，应用程序都必须调用函数DrawMenuBar。 + + 将被修改的菜单的句柄。 + 指定将被删除的菜单项，其含义由参数wFlags决定。 + + 如果函数调用成功，返回非零值；如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。 + + + + 设置前台窗口 + + + + + + + 获取当前前台窗口句柄 + + + + + + 获得当前活动窗体 + + 活动窗口的句柄。如没有窗口处于活动状态或处于活动状态的窗口非当前线程创建，则返回零。 + + + + 设置活动窗体 + + + + + + + 获取类名 + + + + + + + + + 获取当前线程对应的进程ID + + + + + + + + 判断指定句柄是否是一个窗口 + + + + + + + 获取窗口标题 + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + 从文件中载入指针 + + + + + + + 判断窗口是否可见 + + + + + + + 查找窗口 + + + + + + + + The FindWindowEx function retrieves a handle to a window whose class name and window name match the specified strings. The function searches child windows, beginning with the one following the specified child window. + + Handle to the parent window whose child windows are to be searched. + Handle to a child window. + Specifies class name. + Pointer to a null-terminated string that specifies the window name (the window's title). + If the function succeeds, the return value is a handle to the window that has the specified class and window names.If the function fails, the return value is NULL. + + + + The InvalidateRect function adds a rectangle to the specified window's update region. + + Handle to window. + Rectangle coordinates. + Erase state. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + The ValidateRect function validates the client area within a rectangle by removing the rectangle from the update region of the specified window. + + Handle to window. + Validation rectangle coordinates. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + 获取指定窗口的有关信息，也可用于获取窗口内存中指定偏移的32位度整型值。 + + + + + + + + 检索一指定窗口的客户区域或整个屏幕的显示设备上下文环境的句柄，以后可以在GDI函数中使用该句柄来在设备上下文环境中绘图。 + + + + + + + 释放设备上下文环境（DC）供其他应用程序使用。函数的效果与设备上下文环境类型有关。它只释放公用的和设备上下文环境，对于类或私有的则无效。 + + + + + + + + 获取桌面句柄 + + + + + + 获取窗口客户区的大小。注意一下：窗口的客户区为窗口中除标题栏、菜单栏之外的地方。 + + + + + + + + 返回指定窗口的边框矩形的尺寸。该尺寸以相对于屏幕坐标左上角的屏幕坐标给出。 + + + + + + + + 更新一个分层窗口的位置，大小，形状，内容和半透明度 + + + + + + + + + + + + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + + + + + + + + + + + + 设置指针位置 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使用的数据库接口 + + + + + 使用的数据库连接字符串 + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 使用的数据库接口 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + FTP数据管理类(不含上传下载功能) + + + + + + + + + + + + 获取指定id的FTP信息 + + + + + + + 获取指定name的FTP信息 + + + + + + + 打开FTP管理界面 + + + + + 创建SQLite数据库表 + + + + + FTP信息 + + + + + id + + + + + 名称 + + + + + IP + + + + + 端口 + + + + + 用户名 + + + + + 密码 + + + + + 远程目录 + + + + + 加密方式 + + + + + 添加时间 + + + + + + + + + + 备注 + + + + + 添加时间字符串 + + + + + 设置 + + + + + 部门列表 + + + + + + + + + + 远程文件信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 升级地址 + + + + + + + + + + 隔多久后再次检查更新 + + + + + 本地保存的配置信息 + + + + + 当前安装的软件版本 + + + + + 当前安装的软件修正版本 + + + + + 当前安装的数据库版本 + + + + + + + + + + + + + + + + + + + + 获取当前更新的类型 + + + + + 每隔n小时检测一次更新 + + + + + 读取版本信息完成后激发 + + + + + 没有版本更新时激发 + + + + + 发现新版本时激发 + + + + + 发生错误后激发 + + + + + 更新进度变化后激发 + + + + + 开始检测新版本 + + + + + + + + + + 初始化升级函数 + + 为null,则表示事件运行在多线程模式下，否则,事件是在窗体所在线程下 + + + + + + + + + + + + + + 获取版本信息 + + + + + 开始下载 + + + + + 开始下载 + + + + + 下载,不使用多线程 + + + + + 结束下载 + + + + + + + + + + + + + + + 设置升级 + + + + + 是否是在线更新 + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + 提示文本 + + + + + 更新日期 + + + + + 更新版本 + + + + + 更新描述 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新类型,soft或者data + + + + + 更新描述Url + + + + + 更新描述 + + + + + 版本 + + + + + 更新日期 + + + + + 更新地址 + + + + + 在下载升级包前首先要下载的内容 + + + + + 升级程序要使用的设置xml + + + + + + + + + + 错误字符串 + + + + + 错误id + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前登陆用户 + + + + + + + + + + 没有版本更新时激发 + + + + + + + + + + + 取消更新。 + + + + + + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 Docking 的本地化字符串。 + + + + + 查找类似 Docking Notification 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 Property Changed 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 Determines if end user drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 Enable/Disable the close button of the content. 的本地化字符串。 + + + + + 查找类似 Shows or hides the close button of the content. This property does not function with System MDI Document Style. 的本地化字符串。 + + + + + 查找类似 The form must be of type IDockContent. 的本地化字符串。 + + + + + 查找类似 Gets or sets a value indicating in which area of the DockPanel the content allowed to show. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of DockState property changed. 的本地化字符串。 + + + + + 查找类似 Indicates the content will be hidden instead of being closed. 的本地化字符串。 + + + + + 查找类似 The desired docking state when first showing. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找类似 The tab text displayed in the dock pane. If not set, the Text property will be used. 的本地化字符串。 + + + + + 查找类似 The text displayed when mouse hovers over the tab. 的本地化字符串。 + + + + + 查找类似 The provided value is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Value: The value of DockAreas conflicts with current DockState. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 Invalid value, conflicts with DockableAreas property. 的本地化字符串。 + + + + + 查找类似 The dock state is invalid. 的本地化字符串。 + + + + + 查找类似 The dock panel is null. 的本地化字符串。 + + + + + 查找类似 Invalid beforeContent, it must be contained by the pane. 的本地化字符串。 + + + + + 查找类似 Invalid DockState: Content can not be showed as "Unknown" or "Hidden". 的本地化字符串。 + + + + + 查找类似 The previous pane is invalid. It can not be null, and its docking state must not be auto-hide. 的本地化字符串。 + + + + + 查找类似 DockPanel can not be null. 的本地化字符串。 + + + + + 查找类似 The Pane can not be null. 的本地化字符串。 + + + + + 查找类似 Invalid value, check DockableAreas property. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Press SHIFT for docking to full side. 的本地化字符串。 + + + + + 查找类似 Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid argument: Content can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid argument: The content's DockPanel can not be "null". 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 The specified container conflicts with the IsFloat property. 的本地化字符串。 + + + + + 查找类似 The previous pane does not exist in the nested docking pane collection. 的本地化字符串。 + + + + + 查找类似 The container can not be null. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be null when the nested docking pane collection is not empty. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be itself. 的本地化字符串。 + + + + + 查找类似 FloatWindow property can not be set to "null" when DockState is DockState.Float. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid Content: Content not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 The state for the dock pane is invalid. 的本地化字符串。 + + + + + 查找类似 Auto Hide 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window Position 的本地化字符串。 + + + + + 查找类似 Invalid Content: The content must be auto-hide state and associates with this DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of the AutoHideWindow's ActiveContent changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveContentProperty changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveDocument property changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActivePane property changed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop nested docking is allowed. 的本地化字符串。 + + + + + 查找类似 Occurs when a content added to the DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when a content removed from the DockPanel. 的本地化字符串。 + + + + + 查找类似 The default size of float window. 的本地化字符串。 + + + + + 查找类似 Provides Visual Studio .Net style docking. 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The visual skin to use when displaying the docked windows. 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The style of the document window. 的本地化字符串。 + + + + + 查找类似 Determines where the tab strip for Document style content is drawn. 的本地化字符串。 + + + + + 查找类似 The DockPanel has already been initialized. 的本地化字符串。 + + + + + 查找类似 The configuration file's version is invalid. 的本地化字符串。 + + + + + 查找类似 The XML file format is invalid. 的本地化字符串。 + + + + + 查找类似 Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form. 的本地化字符串。 + + + + + 查找类似 DockPanel configuration file. Author: Weifen Luo, all rights reserved. 的本地化字符串。 + + + + + 查找类似 !!! AUTOMATICALLY GENERATED FILE. DO NOT MODIFY !!! 的本地化字符串。 + + + + + 查找类似 Indicates whether the control layout is right-to-left when the RightToLeft property is set to Yes. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Shows the hidden autohide content when hovering over the tab. When disabled, the tab must be clicked to show the content. 的本地化字符串。 + + + + + 查找类似 Show close button on each tab 的本地化字符串。 + + + + + 查找类似 Determines if the document icon will be displayed in the tab strip. 的本地化字符串。 + + + + + 查找类似 Support deeply nested controls. Disabling this setting may improve resize performance but may cause heavily nested content not to resize. 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window List 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid argument: DockPanel can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid DockPanel. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 停靠 的本地化字符串。 + + + + + 查找类似 停靠通知 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 属性已更改 的本地化字符串。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 确定是否允许最终用户拖放停靠 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 启用/禁用DockContent的关闭按钮。 的本地化字符串。 + + + + + 查找类似 显示或隐藏DockContent的关闭按钮。此属性不适用于系统MDI文档样式。 的本地化字符串。 + + + + + 查找类似 窗体的类型必须为IDockContent。 的本地化字符串。 + + + + + 查找类似 获取或设置一个值，该值指示允许在DockPanel的哪个区域显示内容。 的本地化字符串。 + + + + + 查找类似 当DockState属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 指示DockContent将隐藏而不是关闭。 的本地化字符串。 + + + + + 查找类似 首次显示时所需的停靠状态。 的本地化字符串。 + + + + + 查找类似 显示停靠窗格选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 停靠窗格中显示的选项卡文本。如果未设置，将使用Text属性。 的本地化字符串。 + + + + + 查找类似 鼠标悬停在选项卡上时显示的文本。 的本地化字符串。 + + + + + 查找类似 提供的值超出范围。 的本地化字符串。 + + + + + 查找类似 无效值：DockAreas的值与当前DockState冲突。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 无效值，与DockableAreas属性冲突。 的本地化字符串。 + + + + + 查找类似 停靠状态无效。 的本地化字符串。 + + + + + 查找类似 DockPanel 为 null 的本地化字符串。 + + + + + 查找类似 beforeContent无效，它必须包含在pane中。 的本地化字符串。 + + + + + 查找类似 DockState无效：DockContent不能显示为“未知”或“隐藏”。 的本地化字符串。 + + + + + 查找类似 上一个Pane无效。它不能为null，其停靠状态不能自动隐藏。 的本地化字符串。 + + + + + 查找类似 DockPanel不能为null。 的本地化字符串。 + + + + + 查找类似 Pane不能为null。 的本地化字符串。 + + + + + 查找类似 无效值，请检查DockableAreas属性。 的本地化字符串。 + + + + + 查找类似 显示DockPanel选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 按SHIFT键以停靠到完全侧。 的本地化字符串。 + + + + + 查找类似 无效内容：ActiveContent必须是可见内容之一，如果没有可见内容，则为null。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent的DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 指定的容器与IsFloat属性冲突。 的本地化字符串。 + + + + + 查找类似 嵌套DockPanel集合中不存在上一个Pane。 的本地化字符串。 + + + + + 查找类似 容器不能为空。 的本地化字符串。 + + + + + 查找类似 当嵌套DockPanel集合不为空时，上一个Pane不能为空。 的本地化字符串。 + + + + + 查找类似 上一个Pane不能是其本身。 的本地化字符串。 + + + + + 查找类似 当DockState为DockState.Float时，FloatWindow属性不能设置为“null”。 的本地化字符串。 + + + + + 查找类似 无效内容：内容不在集合中。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 DockPanel的状态无效。 的本地化字符串。 + + + + + 查找类似 自动隐藏 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 属性 的本地化字符串。 + + + + + 查找类似 无效DockContent：DockContent必须为自动隐藏状态并与此DockPanel关联。 的本地化字符串。 + + + + + 查找类似 当AutoHideWindow的ActiveContent值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveContentProperty值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveDocument属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActivePane属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放停靠。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放嵌套停靠。 的本地化字符串。 + + + + + 查找类似 当DockContent添加到DockPanel时发生。 的本地化字符串。 + + + + + 查找类似 从DockPanel中删除DockContent时发生。 的本地化字符串。 + + + + + 查找类似 浮动窗口的默认大小。 的本地化字符串。 + + + + + 查找类似 提供Visual Studio.Net样式的停靠。 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 显示停靠窗口时要使用的视觉外观。 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 在停靠面板中拖动文档或Pane时发生。 的本地化字符串。 + + + + + 查找类似 文档窗口的样式。 的本地化字符串。 + + + + + 查找类似 确定绘制文档样式内容的选项卡栏的位置。 的本地化字符串。 + + + + + 查找类似 DockPanel已初始化。 的本地化字符串。 + + + + + 查找类似 配置文件的版本无效。 的本地化字符串。 + + + + + 查找类似 XML文件格式无效。 的本地化字符串。 + + + + + 查找类似 父窗体无效。使用DockingMdi或SystemMdi文档样式时，DockPanel控件必须是主MDI容器窗体的子控件。 的本地化字符串。 + + + + + 查找类似 DockPanel配置文件。作者：罗伟芬，版权所有。 的本地化字符串。 + + + + + 查找类似 !!! 自动生成的文件。不要修改！！！ 的本地化字符串。 + + + + + 查找类似 指示当RightToLeft属性设置为“是”时，控件布局是否从右向左。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 悬停在选项卡上时显示隐藏的自动隐藏内容。禁用时，必须单击选项卡才能显示内容。 的本地化字符串。 + + + + + 查找类似 在每个选项卡上显示关闭按钮 的本地化字符串。 + + + + + 查找类似 确定是否在选项卡栏中显示文档图标。 的本地化字符串。 + + + + + 查找类似 支持深度嵌套控件。禁用此设置可能会提高调整大小的性能，但可能会导致嵌套严重的内容无法调整大小。 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 窗口列表 的本地化字符串。 + + + + + 查找类似 无效参数：DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 无效DockPanel. 的本地化字符串。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置是否捕获鼠标 + + + + + 获取或设置是否显示图像信息 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框边框颜色 + + + + + 获取或设置放大图形的原始尺寸 + + + + + 获取或设置放大图像的倍数 + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置用于被操作的图像 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框线条的颜色 + + + + + 获取当前选中的区域 + + + + + 获取或设置放大图像的原图大小尺寸 + + + + + 获取或设置图像放大的倍数 + + + + + 获取或设置是否绘制操作框点 + + + + + 获取或设置是否限制鼠标操作区域 + + + + + 获取或设置是否绘制信息展示 + + + + + 获取或设置是否根据图像大小自动调整控件尺寸 + + + + + 获取当前是否绘制的有区域 + + + + + 获取当前是否开始绘制 + + + + + 获取当前操作框是否正在移动 + + + + + 获取或设置操作框是否锁定 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 响应四个按键实现精确移动 + + + + + + + + + + + + 绘制操作框 + + + + + + 绘制图像放大信息 + + + + + + 清空所有操作 + + + + + 手动设置一个块选中区域 + + 要选中区域 + + + + 手动设置一个块选中区域 + + 要选中区域的坐标 + 要选中区域的大小 + + + + 手动设置一个块选中区域 + + 要选中区域的x坐标 + 要选中区域的y坐标 + 要选中区域的宽度 + 要选中区域的高度 + + + + 手动设置信息显示的位置 + + 要显示的位置 + + + + 手动设置信息显示的位置 + + 要显示位置的x坐标 + 要显示位置的y坐标 + + + + 获取操作框内的图像 + + 结果图像 + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标结构信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置Hook + + + + + + 卸载Hook + + + + + + 鼠标状态枚举值 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Martin Lottering : 2007-10-27 + -------------------------------- + This is a usefull control in Filters. Allows you to save space and can replace a Grouped Box of CheckBoxes. + Currently used on the TasksFilter for TaskStatusses, which means the user can select which Statusses to include + in the "Search". + This control does not implement a CheckBoxListBox, instead it adds a wrapper for the normal ComboBox and Items. + See the CheckBoxItems property. + ---------------- + ALSO IMPORTANT: In Data Binding when setting the DataSource. The ValueMember must be a bool type property, because it will + be binded to the Checked property of the displayed CheckBox. Also see the DisplayMemberSingleItem for more information. + ---------------- + Extends the CodeProject PopupComboBox "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp" + by Lukasz Swiatkowski. + + + + + + + + + + The checkbox list control. The public CheckBoxItems property provides a direct reference to its Items. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation and its formatting however is controlled + by the Binded object, since it owns that property. + + + + + Builds a CSV string of the items selected. + + + + + A direct reference to the Items of CheckBoxComboBoxListControl. + You can use it to Get or Set the Checked status of items manually if you want. + But do not manipulate the List itself directly, e.g. Adding and Removing, + since the list is synchronised when shown with the ComboBox.Items. So for changing + the list contents, use Items instead. + + + + + The DataSource of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + The ValueMember of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation however is controlled by the Binded + object, since it owns that property. + + + + + Made this property Browsable again, since the Base Popup hides it. This class uses it again. + Gets an object representing the collection of the items contained in this + System.Windows.Forms.ComboBox. + + A System.Windows.Forms.ComboBox.ObjectCollection representing the items in + the System.Windows.Forms.ComboBox. + + + + + + + + + + + + + + + + + Will add an invisible item when the style is DropDownList, + to help maintain the correct text in main TextBox. + + + + + + + + + + + + A function to clear/reset the list. + (Ubiklou : http://www.codeproject.com/KB/combobox/extending_combobox.aspx?msg=2526813#xx2526813xx) + + + + + Uncheck all items. + + + + + The properties that will be assigned to the checkboxes as default values. + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + A container control for the ListControl to ensure the ScrollBar on the ListControl does not + Paint over the Size grip. Setting the Padding or Margin on the Popup or host control does + not work as I expected. + + + + + + + + + + Prescribed by the Popup class to ensure Resize operations work correctly. + + + + + + This ListControl that pops up to the User. It contains the CheckBoxComboBoxItems. + The items are docked DockStyle.Top in this control. + + + + + + + + + + + Simply a reference to the CheckBoxComboBox. + + + + + A Typed list of ComboBoxCheckBoxItems. + + + + + + + + + + Prescribed by the Popup control to enable Resize operations. + + + + + + + + + + + + Maintains the controls displayed in the list by keeping them in sync with the actual + items in the combobox. (e.g. removing and adding as well as ordering) + + + + + The CheckBox items displayed in the Popup of the ComboBox. + + + + + + + A reference to the CheckBoxComboBox. + A reference to the item in the ComboBox.Items that this object is extending. + + + + A reference to the CheckBoxComboBox. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + When using Data Binding operations via the DataSource property of the ComboBox. This + adds the required Bindings for the CheckBoxes. + + + + + + + + + + + Added this handler because the control doesn't seem + to initialize correctly until shown for the first + time, which also means the summary text value + of the combo is out of sync initially. + + + + + A Typed List of the CheckBox items. + Simply a wrapper for the CheckBoxComboBox.Items. A list of CheckBoxComboBoxItem objects. + This List is automatically synchronised with the Items of the ComboBox and extended to + handle the additional boolean value. That said, do not Add or Remove using this List, + it will be lost or regenerated from the ComboBox.Items. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Returns the item with the specified displayName or Text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Called when any property changes. + + + + + + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com Simple pop-up control http://www.codeproject.com/cs/miscctrl/simplepopup.asp. + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Gets a value indicating whether the PopupControl.Popup uses the fade effect. + + true if pop-up uses the fade effect; otherwise, false. + To use the fade effect, the FocusOnOpen property also has to be set to true. + + + + Gets or sets a value indicating whether to focus the content after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether this PopupControl.Popup is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets the size that is the lower limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the size that is the upper limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the PopupControl.Popup class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows pop-up window below the specified area of specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Adjusts the size of the owner to accommodate the if the owner is currently displayed, or clears and resets active child controls of the if the is not currently displayed. + + true if the owner is currently displayed; otherwise, false. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + + + + + + + + + + + + + + + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the size grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the PopupControl.PopupComboBox class. + + + + + The pop-up wrapper for the dropDownControl. + Made PROTECTED instead of PRIVATE so descendent classes can set its Resizable property. + Note however the pop-up properties must be set after the dropDownControl is assigned, since this + popup wrapper is recreated when the dropDownControl is assigned. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Shows the drop down. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Maintains an additional "Selected" and "Count" value for each item in a List. + Useful in the CheckBoxComboBox. It holds a reference to the List[Index] Item and + whether it is selected or not. + It also caters for a Count, if needed. + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. And no Counts will be displayed + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + Is a Count indicator used. + + + + + The original List of values wrapped. A "Selected" and possibly "Count" functionality is added. + + + + + Used to indicate NOT to use ToString(), but read this property instead as a display value. + + + + + When specified, indicates that ToString() should not be performed on the items. + This property will be read instead. + This is specifically useful on DataTable implementations, where PropertyDescriptors are used to read the values. + + + + + Builds a concatenation list of selected items in the list. + + + + + Indicates whether the Item display value (Name) should include a count. + + + + + Reset all counts to zero. + + + + + Creates a ObjectSelectionWrapper item. + Note that the constructor signature of sub classes classes are important. + + + + + + + + + + + + + + Used together with the ListSelectionWrapper in order to wrap data sources for a CheckBoxComboBox. + It helps to ensure you don't add an extra "Selected" property to a class that don't really need or want that information. + + + + + + + + + + + + Used as a count indicator for the item. Not necessarily displayed. + + + + + Is this item selected. + + + + + A reference to the wrapped item. + + + + + The containing list for these selections. + + + + + An indicator of how many items with the specified status is available for the current filter level. + Thaught this would make the app a bit more user-friendly and help not to miss items in Statusses + that are not often used. + + + + + A reference to the item wrapped. + + + + + The item display value. If ShowCount is true, it displays the "Name [Count]". + + + + + The textbox display value. The names concatenated. + + + + + Indicates whether the item is selected. + + + + + + + + + + + + + + + + 控件的状态。 + + + + + 正常 + + + + + 鼠标经过 + + + + + 鼠标按下 + + + + + 鼠标的当前位置 + + + + + + + + + + + + + + + + + + + + 美化按钮 + + + + + 普通按钮矩形位置 + + + + + 美化按钮 + + + + + 分割按钮的宽度 + + + + + 是否启用分割按钮 + + + + + 优先使用默认皮肤 + + + + + 按钮基础背景色 + + + + + 按钮字体颜色 + + + + + 图片宽度,默认值为18px，最小12px + + + + + 圆角的位置,默认全部都是圆角 + + + + + 设置圆角半径 + + + + + 背景色是否渐变 + + + + + 图片高度 + + + + + 图片与文字之间的间距 + + + + + 当鼠标按下时图片和文字是否产生偏移 + + + + + 鼠标进入时 + + + + + + 鼠标离开 + + + + + + 鼠标按下 + + + + + + 鼠标弹起 + + + + + + 鼠标当前所在位置 + + + + + 获取图像以及文字的位置 + + + + + + + + + + + + + + + + + + + + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强版Label(禁用了双击Label会自动复制文本到剪切板的功能) + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强富文本控件 + + + + + 开始更新 + + + + + 结束更新 + + + + + RichTextBox + + + + + + + + + + + + + + + + + + + + + + + 在自带菜单弹出前激发 + + + + + 根据标签获得菜单项 + + + + + + + 只允许输入文本(只对设置之后的人工输入有效) + + + + + 按下按键 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标按下 + + + + + + + + + + + + + + + + + + 当文本框为空时,显示的内容。 + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 消息列表控件 + + + + + 最大高度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 增强时间控件 + + + + + 增强时间控件 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 选择文本框 + + + + + 选择文本框 + + + + + 按钮基础背景色 + + + + + 优先使用默认皮肤 + + + + + 选择的id + + + + + 选择的名称 + + + + + 选择的名称 + + + + + 字体 + + + + + 重新设置大小 + + + + + 在选择时激发 + + + + + 点击选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 建立圆角路径的样式。 + + + + + 四个角都不是圆角。 + + + + + 四个角都为圆角。 + + + + + 左边两个角为圆角。 + + + + + 右边两个角为圆角。 + + + + + 上边两个角为圆角。 + + + + + 下边两个角为圆角。 + + + + + 左下角为圆角。 + + + + + 右下角为圆角。 + + + + + 画图相关API + + + + + 建立带有圆角样式的路径。 + + 用来建立路径的矩形。 + 圆角的大小。 + 圆角的样式。 + 是否把矩形长宽减 1,以便画出边框。 + 建立的路径。 + + + + 窗体皮肤 + + + + + 窗体皮肤 + + + + + 标题属性 + + + + + 是否使用父窗口的图标 + + + + + 点击最小化按钮是最小化还是隐藏 + + + + + 最大化按钮 + + + + + 最小化按钮 + + + + + 标题栏关闭按钮是否显示 + + + + + 当窗口位于后台时，是否标注显示。 + + + + + + + + + + 标题栏字体颜色 + + + + + 标题栏不处于活动状态时的字体颜色 + + + + + 标题栏背景颜色 + + + + + 标题栏不处于活动状态时的背景颜色 + + + + + 是否允许拖拉窗体边缘来改变窗体大小 + + + + + + + + + + + 画边框 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 热键文本框 + + + + + 热键文本框 + + + + + + + + + + + + + + + + + 在控件大小变化时发生 + + + + + + 此属性无效 + + + + + 载入热键配置 + + + + + + 保存热键 + + + + + + 是否含义热键 + + + + + 读取或设置热键 + + + + + 功能键 + + + + + 热键按键 + + + + + KeyDown事件 + + + + + + KeyDown事件 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 可以改变文本行距（行间距）的Label + + + + + 行间距 + + + + + 可以改变文本行距（行间距）的Label + + + + + + + + + + 字体高度 + + + + + + + + + + 文本 + + + + + + + + + + + + + + + + + + + 图标列表控件 + + + + + + + + + + + + 图标列表控件 + + + + + 图标大小 + + + + + 文本显示高度(从底部算起) + + + + + 默认图标 + + + + + 是否显示图标 + + + + + 是否显示网格线 + + + + + 角标图标合集 + + + + + 画项 + + + + + + 选择项的背景开始颜色 + + + + + 选择项的背景结束颜色 + + + + + 选择项的边框颜色 + + + + + 选择项的字体颜色 + + + + + 重绘选中时背景 + + + + + 重绘图标 + + + 区域大小 + + + + + + + + 重绘文本 + + + + + 获取文本对齐 + + + + + 水平滚动条滚动事件 + + + + + 垂直滚动条滚动事件 + + + + + + + + + + + 列表项 + + + + + 图标 + + + + + 角标图片序号,为-1表示无角标 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + 内容 + + + + + 网址 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 计算两个日期的时间间隔,返回的是日期值+ + + 时间值,将显示在返回的值里 + 参照时间 + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 控件边框颜色 + + + + + 控件背景颜色 + + + + + 圆角弧度大小 + + + + + 圆角风格 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 图标 + + + + + 标题 + + + + + 悬浮提示 + + + + + 标题颜色 + + + + + 设置按钮 + + + + + + + 判断和设置是否选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 绘制边框 + + 消息 + + + + 类说明：CContextMenuStrip控件的实现用来代替系统的ContextMenuStrip控件 + + + + + + + + + + + + + + + + 重写OnCreateControl + + + + + 重写OnPaint事件 + + + + + + CreateRoundedRectanglePath + + Rectangle + + + + + + 系统热键数据类。 + + + + + 系统热键数据类 + + + + + 使多行属性失效掉 + + + + + 使只读属性失效掉 + + + + + 获取热键文本 + + + + + 功能键 + + + + + 热键按键 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 在搜索时激发 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + + + + + + 文本为空时的显示效果 + + + + + 文本不选中 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + 字体 + + + + + 优先使用默认皮肤 + + + + + 背景色是否渐变 + + + + + 按钮基础背景色 + + + + + 按钮圆角部分背景颜色 + + + + + + + + + + 重新设置大小 + + + + + 点击搜索按钮 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 使用公共皮肤 + + + + + 按钮颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 皮肤公共类 + + + + + 是否使用默认皮肤 + + + + + 按钮皮肤 + + + + + 按钮皮肤类 + + + + + 背景颜色 + + + + + 字体颜色 + + + + + 是否颜色渐变 + + + + + 类说明：帮助类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 修改控件或窗体的边框，例如Textbox或是Form窗体 + + 消息 + 控件对象 + 边框像素 + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 图片所在上级域名 + + + + + 图片资源所在上级文件夹 + + + + + 根据不同前缀，加载不同格式图片。i:表示工程内置图片;s:表示T_ImageDomain域名下的图片,u:表示指定url的图片;f:表示本地图片 + + + + + + 加载本地图片,加载完毕不会占用本地图片 + + + + + + 加载指定url图片 + + url位置 + 是否异步 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 选项发生变化时激发 + + + + + 标签选择的序号 + + + + + + + + + + 选择的颜色 + + + + + 多标签控件颜色 + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 获取对应的标签 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获得当前进程，以便重绘控件 + + + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点边框颜色 + + + + + 是否鼠标MouseOver状态 + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点时边框颜色 + + + + + + + + + + 鼠标移动到该控件上时 + + + + + + 当鼠标从该控件移开时 + + + + + + 当该控件获得焦点时 + + + + + + 当该控件失去焦点时 + + + + + + 获得操作系统消息 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 美化文本框控件 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + 是否只能输入数字 + + + + + 是否多行 + + + + + 是否在显示不下时换行 + + + + + 最大长度 + + + + + + + + + + 背景颜色 + + + + + 右键菜单 + + + + + 字体颜色 + + + + + 选择的开始位置 + + + + + 选择的长度 + + + + + 选择的文本 + + + + + 提示文本 + + + + + 选择全部 + + + + + 密码 + + + + + 是否只读 + + + + + + + + + + + 文本为空时的显示效果 + + + + + 字体 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + + + + + + 选择文本框中的文本范围 + + 文本框中当前选定文本的第一个字符的位置。 + 要选择的字符数 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Define some Windows message constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This class adds to the functionality provided in System.Windows.Forms.MenuStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + This class adds to the functionality provided in System.Windows.Forms.ToolStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 透明图片控件 + + + + + 是否使用透明,默认为True + + + + + 设置透明度 + + + + + 要绑定的控件 + + + + + 透明图片控件 + + + + + 图片 + + + + + 初始化加载控件 + + 透明度 + 是否显示加载图片 + 图片 + + + + + + + + + + + + + + + 显示加载 + + + + + 隐藏加载 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日历控件 + + + + + 单击事件 + + + + + + + 单击某个日期事件 + + + + + 日历控件 + + + + + 设置日期 + + + + + 放假数据表 + + + + + 是否处于设计模式 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日控件 + + + + + 日控件 + + + + + 当前日期 + + + + + 在发生页码变化前激发 + + + + + 设置休息状态,1为休息,-1为上班，其它为不显示 + + + + + + 日期 + + + + + 农历 + + + + + 阳历日期字体颜色 + + + + + 阳历日期字体 + + + + + 农历日期字体 + + + + + 农历部分字体颜色 + + + + + 是否选中 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + 类 名:ColorHSL + 功 能:H 色相 \ S 饱和度(纯度) \ L 亮度 颜色模型 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + HSL颜色 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 饱和度 + + + + + 类 名:ColorHSV + 功 能:H 色相 \ S 饱和度(纯度) \ V 明度 颜色模型 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 明度 + + + + + 类 名:ColorRGB + 功 能:R 红色 \ G 绿色 \ B 蓝色 颜色模型 + 所有颜色模型的基类,RGB是用于输出到屏幕的颜色模式,所以所有模型都将转换成RGB输出 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + + + + + + + 红色 + + + + + 绿色 + + + + + 蓝色 + + + + + 获取实际颜色 + + + + + + 类 名:ColorHelper + 功 能:提供从RGB到HSV/HSL色彩空间的相互转换 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + RGB转换HSV + + + + + + + HSV转换RGB + + + + + + + RGB转换HSL + + + + + + + HSL转换RGB + + H, S and L input range = 0 -1.0 + + + + + RGB转CMYK + + + + + + + + + + RGB转CMYK + + + + + + + + + + + + CMYK转RGB + + + + + + + + + + Standard-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Standard-RGB,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Adobe-RGB,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Adobe-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Yxy转RGB + + + + + + + + + RGB转Yxy + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 超级颜色选择控件 + + + 分页控件 + + + + + + + + + + + + + + + + + + + + + + + + + + 获取网页颜色 + + + + + 超级颜色选择控件 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Chrome风格的多标签控件 + + + + + 设置选项卡处于选中状态时第一背景色. + + + + + 设置选项卡处于选中状态时第二背景色. + + + + + 设置选项卡处于非选中状态时第一背景色. + + + + + 设置选项卡处于非选中状态时第二背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第一背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第二背景色. + + + + + 设置选项卡工作区背景色. + + + + + 设置选项卡工作区背景图. + + + + + 是否显示关闭按钮 + + + + + 是否显示新增按钮 + + + + + 是否允许拖拽标签 + + + + + 标签最大宽度 + + + + + 标签右键菜单 + + + + + 鼠标按下标签时激发 + + + + + 鼠标放开标签时激发 + + + + + Chrome风格的多标签控件 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置圆角半径 + + + + + Tab文字左边距离 + + + + + + + + + + + + + + 画标签文字 + + + + + + + + + 画标签图标 + + + + + + + 画关闭按钮 + + + + + + + + 获取所有选项卡合起来的宽度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 添加新标签 + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + The position is not over a tab. + + + + + The position is over a tab's icon. + + + + + The position is over a tab's text. + + + + + The position is over a tab but not over its icon or its text. For owner-drawn tab controls, this value is specified if the position is anywhere over a tab. + TCHT_ONITEM is a bitwise-OR operation on TCHT_ONITEMICON and TCHT_ONITEMLABEL. + + + + + Specifies values from SetWindowPosZ enumeration. + + + + + Specified HWND_TOP enumeration value. + + + + + Specified HWND_BOTTOM enumeration value. + + + + + Specified HWND_TOPMOST enumeration value. + + + + + Specified HWND_NOTOPMOST enumeration value. + + + + + Invalidates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_INVALIDATE invalidates the entire window. + + + + Causes the OS to post a WM_PAINT message to the window regardless of whether a portion of the window is invalid. + + + + Causes the window to receive a WM_ERASEBKGND message when the window is repainted. + Specify this value in combination with the RDW_INVALIDATE value; otherwise, RDW_ERASE has no effect. + + + + + Validates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_VALIDATE validates the entire window. + This value does not affect internal WM_PAINT messages. + + + + Suppresses any pending WM_ERASEBKGND messages. + + + Excludes child windows, if any, from the repainting operation. + + + Includes child windows, if any, in the repainting operation. + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND and WM_PAINT messages before the RedrawWindow returns, if necessary. + + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND messages before RedrawWindow returns, if necessary. + The affected windows receive WM_PAINT messages at the ordinary time. + + + + + Specifies values from Msgs enumeration. + + + + + Specified WM_NULL enumeration value. + + + + + Specified WM_CREATE enumeration value. + + + + + Specified WM_DESTROY enumeration value. + + + + + Specified WM_MOVE enumeration value. + + + + + Specified WM_SIZE enumeration value. + + + + + Specified WM_ACTIVATE enumeration value. + + + + + Specified WM_SETFOCUS enumeration value. + + + + + Specified WM_KILLFOCUS enumeration value. + + + + + Specified WM_ENABLE enumeration value. + + + + + Specified WM_SETREDRAW enumeration value. + + + + + Specified WM_SETTEXT enumeration value. + + + + + Specified WM_GETTEXT enumeration value. + + + + + Specified WM_GETTEXTLENGTH enumeration value. + + + + + Specified WM_PAINT enumeration value. + + + + + Specified WM_CLOSE enumeration value. + + + + + Specified WM_QUERYENDSESSION enumeration value. + + + + + Specified WM_QUIT enumeration value. + + + + + Specified WM_QUERYOPEN enumeration value. + + + + + Specified WM_ERASEBKGND enumeration value. + + + + + Specified WM_SYSCOLORCHANGE enumeration value. + + + + + Specified WM_ENDSESSION enumeration value. + + + + + Specified WM_SHOWWINDOW enumeration value. + + + + + Specified WM_WININICHANGE enumeration value. + + + + + Specified WM_SETTINGCHANGE enumeration value. + + + + + Specified WM_DEVMODECHANGE enumeration value. + + + + + Specified WM_ACTIVATEAPP enumeration value. + + + + + Specified WM_FONTCHANGE enumeration value. + + + + + Specified WM_TIMECHANGE enumeration value. + + + + + Specified WM_CANCELMODE enumeration value. + + + + + Specified WM_SETCURSOR enumeration value. + + + + + Specified WM_MOUSEACTIVATE enumeration value. + + + + + Specified WM_CHILDACTIVATE enumeration value. + + + + + Specified WM_QUEUESYNC enumeration value. + + + + + Specified WM_GETMINMAXINFO enumeration value. + + + + + Specified WM_PAINTICON enumeration value. + + + + + Specified WM_ICONERASEBKGND enumeration value. + + + + + Specified WM_NEXTDLGCTL enumeration value. + + + + + Specified WM_SPOOLERSTATUS enumeration value. + + + + + Specified WM_DRAWITEM enumeration value. + + + + + Specified WM_MEASUREITEM enumeration value. + + + + + Specified WM_DELETEITEM enumeration value. + + + + + Specified WM_VKEYTOITEM enumeration value. + + + + + Specified WM_CHARTOITEM enumeration value. + + + + + Specified WM_SETFONT enumeration value. + + + + + Specified WM_GETFONT enumeration value. + + + + + Specified WM_SETHOTKEY enumeration value. + + + + + Specified WM_GETHOTKEY enumeration value. + + + + + Specified WM_QUERYDRAGICON enumeration value. + + + + + Specified WM_COMPAREITEM enumeration value. + + + + + Specified WM_GETOBJECT enumeration value. + + + + + Specified WM_COMPACTING enumeration value. + + + + + Specified WM_COMMNOTIFY enumeration value. + + + + + Specified WM_WINDOWPOSCHANGING enumeration value. + + + + + Specified WM_WINDOWPOSCHANGED enumeration value. + + + + + Specified WM_POWER enumeration value. + + + + + Specified WM_COPYDATA enumeration value. + + + + + Specified WM_CANCELJOURNAL enumeration value. + + + + + Specified WM_NOTIFY enumeration value. + + + + + Specified WM_INPUTLANGCHANGEREQUEST enumeration value. + + + + + Specified WM_INPUTLANGCHANGE enumeration value. + + + + + Specified WM_TCARD enumeration value. + + + + + Specified WM_HELP enumeration value. + + + + + Specified WM_USERCHANGED enumeration value. + + + + + Specified WM_NOTIFYFORMAT enumeration value. + + + + + Specified WM_CONTEXTMENU enumeration value. + + + + + Specified WM_STYLECHANGING enumeration value. + + + + + Specified WM_STYLECHANGED enumeration value. + + + + + Specified WM_DISPLAYCHANGE enumeration value. + + + + + Specified WM_GETICON enumeration value. + + + + + Specified WM_SETICON enumeration value. + + + + + Specified WM_NCCREATE enumeration value. + + + + + Specified VK_RMENU enumeration value. + + + + + Specified WM_NCCALCSIZE enumeration value. + + + + + Specified WM_NCHITTEST enumeration value. + + + + + Specified WM_NCPAINT enumeration value. + + + + + Specified WM_NCACTIVATE enumeration value. + + + + + Specified WM_GETDLGCODE enumeration value. + + + + + Specified WM_SYNCPAINT enumeration value. + + + + + Specified WM_NCMOUSEMOVE enumeration value. + + + + + Specified WM_NCLBUTTONDOWN enumeration value. + + + + + Specified WM_NCLBUTTONUP enumeration value. + + + + + Specified WM_NCLBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCRBUTTONDOWN enumeration value. + + + + + Specified WM_NCRBUTTONUP enumeration value. + + + + + Specified WM_NCRBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCMBUTTONDOWN enumeration value. + + + + + Specified WM_NCMBUTTONUP enumeration value. + + + + + Specified WM_NCMBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCXBUTTONDOWN enumeration value. + + + + + Specified WM_NCXBUTTONUP enumeration value. + + + + + Specified WM_KEYDOWN enumeration value. + + + + + Specified WM_KEYUP enumeration value. + + + + + Specified WM_CHAR enumeration value. + + + + + Specified WM_DEADCHAR enumeration value. + + + + + Specified WM_SYSKEYDOWN enumeration value. + + + + + Specified WM_SYSKEYUP enumeration value. + + + + + Specified WM_SYSCHAR enumeration value. + + + + + Specified WM_SYSDEADCHAR enumeration value. + + + + + Specified WM_KEYLAST enumeration value. + + + + + Specified WM_IME_STARTCOMPOSITION enumeration value. + + + + + Specified WM_IME_ENDCOMPOSITION enumeration value. + + + + + Specified WM_IME_COMPOSITION enumeration value. + + + + + Specified WM_IME_KEYLAST enumeration value. + + + + + Specified WM_INITDIALOG enumeration value. + + + + + Specified WM_COMMAND enumeration value. + + + + + Specified WM_SYSCOMMAND enumeration value. + + + + + Specified WM_TIMER enumeration value. + + + + + Specified WM_HSCROLL enumeration value. + + + + + Specified WM_VSCROLL enumeration value. + + + + + Specified WM_INITMENU enumeration value. + + + + + Specified WM_INITMENUPOPUP enumeration value. + + + + + Specified WM_MENUSELECT enumeration value. + + + + + Specified WM_MENUCHAR enumeration value. + + + + + Specified WM_ENTERIDLE enumeration value. + + + + + Specified WM_MENURBUTTONUP enumeration value. + + + + + Specified WM_MENUDRAG enumeration value. + + + + + Specified WM_MENUGETOBJECT enumeration value. + + + + + Specified WM_UNINITMENUPOPUP enumeration value. + + + + + Specified WM_MENUCOMMAND enumeration value. + + + + + Specified WM_CTLCOLORMSGBOX enumeration value. + + + + + Specified WM_CTLCOLOREDIT enumeration value. + + + + + Specified WM_CTLCOLORLISTBOX enumeration value. + + + + + Specified WM_CTLCOLORBTN enumeration value. + + + + + Specified WM_CTLCOLORDLG enumeration value. + + + + + Specified WM_CTLCOLORSCROLLBAR enumeration value. + + + + + Specified WM_CTLCOLORSTATIC enumeration value. + + + + + Specified WM_MOUSEMOVE enumeration value. + + + + + Specified WM_LBUTTONDOWN enumeration value. + + + + + Specified WM_LBUTTONUP enumeration value. + + + + + Specified WM_LBUTTONDBLCLK enumeration value. + + + + + Specified WM_RBUTTONDOWN enumeration value. + + + + + Specified WM_RBUTTONUP enumeration value. + + + + + Specified WM_RBUTTONDBLCLK enumeration value. + + + + + Specified WM_MBUTTONDOWN enumeration value. + + + + + Specified WM_MBUTTONUP enumeration value. + + + + + Specified WM_MBUTTONDBLCLK enumeration value. + + + + + Specified WM_MOUSEWHEEL enumeration value. + + + + + Specified WM_XBUTTONDOWN enumeration value. + + + + + Specified WM_XBUTTONUP enumeration value. + + + + + Specified WM_XBUTTONDBLCLK enumeration value. + + + + + Specified WM_PARENTNOTIFY enumeration value. + + + + + Specified WM_ENTERMENULOOP enumeration value. + + + + + Specified WM_EXITMENULOOP enumeration value. + + + + + Specified WM_NEXTMENU enumeration value. + + + + + Specified WM_SIZING enumeration value. + + + + + Specified WM_CAPTURECHANGED enumeration value. + + + + + Specified WM_MOVING enumeration value. + + + + + Specified WM_DEVICECHANGE enumeration value. + + + + + Specified WM_MDICREATE enumeration value. + + + + + Specified WM_MDIDESTROY enumeration value. + + + + + Specified WM_MDIACTIVATE enumeration value. + + + + + Specified WM_MDIRESTORE enumeration value. + + + + + Specified WM_MDINEXT enumeration value. + + + + + Specified WM_MDIMAXIMIZE enumeration value. + + + + + Specified WM_MDITILE enumeration value. + + + + + Specified WM_MDICASCADE enumeration value. + + + + + Specified WM_MDIICONARRANGE enumeration value. + + + + + Specified WM_MDIGETACTIVE enumeration value. + + + + + Specified WM_MDISETMENU enumeration value. + + + + + Specified WM_ENTERSIZEMOVE enumeration value. + + + + + Specified WM_EXITSIZEMOVE enumeration value. + + + + + Specified WM_DROPFILES enumeration value. + + + + + Specified WM_MDIREFRESHMENU enumeration value. + + + + + Specified WM_IME_SETCONTEXT enumeration value. + + + + + Specified WM_IME_NOTIFY enumeration value. + + + + + Specified WM_IME_CONTROL enumeration value. + + + + + Specified WM_IME_COMPOSITIONFULL enumeration value. + + + + + Specified WM_IME_SELECT enumeration value. + + + + + Specified WM_IME_CHAR enumeration value. + + + + + Specified WM_IME_REQUEST enumeration value. + + + + + Specified WM_IME_KEYDOWN enumeration value. + + + + + Specified WM_IME_KEYUP enumeration value. + + + + + Specified WM_MOUSEHOVER enumeration value. + + + + + Specified WM_UNDO enumeration value. + + + + + Specified WM_RENDERFORMAT enumeration value. + + + + + Specified WM_RENDERALLFORMATS enumeration value. + + + + + Specified WM_DESTROYCLIPBOARD enumeration value. + + + + + Specified WM_DRAWCLIPBOARD enumeration value. + + + + + Specified WM_PAINTCLIPBOARD enumeration value. + + + + + Specified WM_VSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_SIZECLIPBOARD enumeration value. + + + + + Specified WM_ASKCBFORMATNAME enumeration value. + + + + + Specified WM_CHANGECBCHAIN enumeration value. + + + + + Specified WM_HSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_QUERYNEWPALETTE enumeration value. + + + + + Specified WM_PALETTEISCHANGING enumeration value. + + + + + Specified WM_PALETTECHANGED enumeration value. + + + + + Specified WM_HOTKEY enumeration value. + + + + + Specified WM_PRINT enumeration value. + + + + + Specified WM_PRINTCLIENT enumeration value. + + + + + Specified WM_HANDHELDFIRST enumeration value. + + + + + Specified WM_HANDHELDLAST enumeration value. + + + + + Specified WM_AFXFIRST enumeration value. + + + + + Specified WM_AFXLAST enumeration value. + + + + + Specified WM_PENWINFIRST enumeration value. + + + + + Specified WM_PENWINLAST enumeration value. + + + + + Specified WM_APP enumeration value. + + + + + Specified WM_USER enumeration value. + + + + + Specified WM_REFLECT enumeration value. + + + + + Specified WM_THEMECHANGED enumeration value. + + + + + + + + + + 关键词 + + + + + 密码 + + + + + 权限用户id + + + + + + + + + + + + + 返回关键词 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 树形控件，用于分类用 + + + + + 显示在第一位的名称 + + + + + 是否显示菜单 + + + + + 树形控件 + + + + + 判断指定节点是否是目标节点的子节点 + + + + + + + + + 判断当前节点，当前用户是否有权限访问 + + + + + + + + + 权限事件 + + + + + + + + 选择权限用户时发生 + + + + + 数据变化时发生 + + + + + 数据变化前发生 + + + + + 操作事件 + + + + + + + 在添加分组前发生 + + + + + 在修改分组前发生 + + + + + 在删除分组前发生 + + + + + 在设置密码前发生 + + + + + 在设置权限前发生 + + + + + 获取新的关键词分类 + + + + + + 根据id获取节点 + + + + + + + 根据节点获取节点信息 + + + + + + + 设置节点信息 + + + + + + + 设置节点关键词和密码 + + + + + + + + 设置节点密码 + + + + + + + 设置节点关键词 + + + + + + + 设置节点用户 + + + + + + + RecursionTreeControl:表示将XML文件的内容显示在TreeView控件中 + + 将要加载的XML文件中的节点元素 + 将要加载的XML文件中的节点集合 + + + + 把XML文本载入到列表中 + + + + + + 把XML文件载入到列表中 + + + + + + 将列表保存为xml文本 + + + + + + 改变所有子节点的状态 + + + + + + + 反选子节点 + + + + + + 根据关键词来选中列表 + + + + + + 根据关键词来选中列表 + + + + + + 格式化关键字(会去除重复项)，以便存入数据库 + + + + + + + 去除掉重复项 + + + + + + + 获取当前选中项以及所有父项的关键词组合 + + + + + + 获取选中的 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 是否为添加 + + + + + 选择的文本 + + + + + 选择的Tag + + + + + 选择的图片序号 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + 旧密码 + + + + + 新密码 + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 控件状态 + + + + + 无 + + + + + 获得焦点 + + + + + 失去焦点 + + + + + 鼠标指针进入控件 + + + + + Toolbar控件 + + + + + + + + + + + + + + + 获取或设置控件显示的图片 + + + + + 重写控件焦点属性 + + + + + 自定义绘制 + + + + + + 焦点进入 + + + + + + 失去焦点 + + + + + + 禁止调整大小 + + + + + + + + + + + + + + + + + + 只响应单击鼠标左键事件 + + + + + + 按比例缩放图片 + + + + + + + 图片缩放 + + 源图片 + 缩放图片的宽度 + 缩放图片的高度 + 缩放的图片 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 绘图对像 + + 绘图对像 + 图片 + 绘置的图片大小、坐标 + 绘置的图片边界 + 当前状态 + 状态总数 + + + + 绘图对像 + + 绘图对像 + 图片对像 + 绘置的图片大小、坐标 + 当前状态 + 状态总数 + + + + + + + + + 得到要绘置的图片对像 + + 图像在程序集中的地址 + + + + + 得到要绘置的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 获取资源图标 + + + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的地址 + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 颜色标签 + + + + + 行间距 + + + + + 颜色标签 + + + + + 更新 + + + + + 字体高度 + + + + + 控件高 + + + + + 控件文本 + + + + + 获取过滤掉颜色的字 + + + + + + + 改变字体 + + + + + + + + + + + + + + 分页控件 + + + + + 首页文本 + + + + + 上一页文本 + + + + + 下一页文本 + + + + + 末页文本 + + + + + 跳页文本 + + + + + 页面信息文本 + + + + + 存储SQL参数 + + + + + 最后一页的页码 + + + + + 在发生页码变化时激发 + + + + + 在发生页码变化前激发 + + + + + 设置/返回每页显示的量大小 + + + + + 设置/返回记录总数 + + + + + 设置/返回分页SQL语句,{pagecount}表示页数,{recordcount}表示记录总数,{pagesize}表示页面大小, + {pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 设置/返回当{recordnum}小于等于0时的分页SQL语句(比如第一页),如果为空，则默认使用SQLText值。{pagecount}表示页数, + {recordcount}表示记录总数,{pagesize}表示页面大小,{pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 获取当前页码 + + + + + + 设置分页语句 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取数据库指定条件的记录总数 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MySQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MySQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MSSQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MSSQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 获取SQLite数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 返回分页SQL语句 + + + + + 分页控件 + + + + + 设置当前页为指定页 + + + + + + 下一页 + + + + + 上一页 + + + + + 末页 + + + + + 首页 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 密码控件 + + + + + + + + + + 密码 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + This enum represents the possible browser commands + + + + + Used when no commans are available + + + + + Used in the new navigation events + + + + + The URL to navigate to + + + + + The name of the frame to navigate to + + + + + The flags when opening a new window + + + + + The pointer to ppDisp + + + + + Creates a new instance of WebBrowserExtendedNavigatingEventArgs + + Pointer to the automation object of the browser + The URL to go to + The name of the frame + The new window flags + + + + + + + + + Used in the new navigation events + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 查看源码 + + + + + 复制当前选中区 + + + + + 粘贴当前选中区 + + + + + 剪切当前选中区 + + + + + 全选 + + + + + 清除当前选中区的选中状态。 + + + + + 从当前选中区中删除全部超级链接。 + + + + + 从当前选中区中删除全部书签。 + + + + + 删除当前选中区 + + + + + 重做 + + + + + 撤销 + + + + + 从当前选中区中删除格式化标签。 + + + + + 点击节点 + + + + + + + + 点击节点 + + + + + + + + + 点击元素 + + 节点名 + 属性 + 属性值 + 等待毫秒数 + 第几个符合的元素,从1开始 + + + + 等待多时毫秒 + + + + + + Represents event information for the main form, when the command state of the active browser changes + + + + + Creates a new instance of the class + + A list of commands that are available + + + + Gets a list of commands that are available + + + + + An extended version of the control. + + + + + + + + + + + + 在页面弹出消息对话框时激发 + + + + + + + + + + + + + + + + + + + + + + 打开页面并等待页面加载完毕 + + 要打开的页面地址 + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待页面加载完毕 + + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待指定毫秒 + + 等待指定毫秒 + + + + 获取网页源代码,可以自动去除乱码 + + + + + + 加载html文本到浏览器中 + + + + + + + 加载html文本到浏览器中 + + + + + + 强制用本窗体打开新链接 + + + + + + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is created. + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is discarded. + + + + + Returns the automation object for the web browser + + + + + This method will be called to give you a chance to create your own event sink + + + + + Detaches the event sink + + + + + 在文档下载开始时激发 + + + + + Raises the event + + Empty + + You could start an animation or a notification that downloading is starting + + + + + 下载完成后触发 + + + Here you could start monitoring for script errors. + + + + + Raises the event + + Empty + + + + 在开始浏览新网页时激发. + + + + + 在打开新的网页窗口时激发 + + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 新窗口事件,只限Window XP SP2或以上系统支持 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Overridden + + The send to this procedure + + + + A list of all the available window messages + + + + + Raises the event + + + + + 在网页窗口关闭时激发 + + + Do not confuse this with DWebBrowserEvents2.Quit... That's something else. + + + + + Flags used by INewWindowManager::EvaluateNewWindow. + These values are taken into account in the decision of whether to display a pop-up window. + + + + + No information Present + + + + + The page is unloading. This flag is set in response to the onbeforeunload and onunload events. + Some pages load pop-up windows when you leave them rather than when you enter. This flag is used to identify those situations. + + + + + The call to INewWindowManager::EvaluateNewWindow is the result of a user-initiated action + (a mouse click or key press). Use this flag in conjunction with the NWMF_FIRST_USERINITED flag + to determine whether the call is a direct or indirect result of the user-initiated action. + + + + + When NWMF_USERINITED is present, this flag indicates that the call to + INewWindowManager::EvaluateNewWindow is the first query that results from this user-initiated action. + Always use this flag in conjunction with NWMF_USERINITED. + + + + + The override key (ALT) was pressed. The override key is used to bypass the pop-up manager梐llowing + all pop-up windows to display梐nd must be held down at the time that INewWindowManager::EvaluateNewWindow is called. + + + + + The new window attempting to load is the result of a call to the showHelp method. Help is sometimes displayed in a separate window, + and this flag is valuable in those cases. + + + + + The new window is a dialog box that displays HTML content. + + + + + Indicates that the EvaluateNewWindow method is being called through a marshalled Component Object Model (COM) proxy + from another thread. In this situation, the method should make a decision and return immediately without performing + blocking operations such as showing modal user interface (UI). Lengthy operations will cause the calling thread to + appear unresponsive. + + + + + HRESULT constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + a form that supports custom theme + + + + + 标签新建按钮事件 + + + + + 标签关闭按钮事件 + + + + + 标签创建时事件 + + + + + 标签激活前事件 + + + + + 标签激活后事件 + + + + + 在标签栏创建时激发 + + + + + + + 内边距 + + + + + 默认内边距 + + + + + 标题 + + + + + 皮肤/主题 + + + + + 是否可拖动改变窗体大小 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 标题栏高度 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 控制按钮相对于右上角的偏移量 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 标题栏图标尺寸 + + + + + 窗体图标,如果设置本项,将不使用Icon属性 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题距离左边的距离 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 是否显示阴影 + + + + + 窗体阴影宽度 + + + + + 使用阴影来缩放 + + + + + 窗体阴影颜色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区区域，坐标相对于窗体左上角 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区大小 + + + + + 表示MDI标签栏的区域，包括bottom-region + + + + + MGdUI皮肤 + + + + + + + + + + + + + + + + + 获取子窗体 + + + + + + 通过sendmessage方式激活子窗体以避免闪烁 + + + + + + 当子窗体关闭时激发 + + + + + + + 子窗体可视化变化 + + + + + + + 获取当前的子窗体列表 + + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最小化 + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最大化 + + + + + to make the client area to have 3D view + + + + + 双击事件 + + + + + 消息 + + + + + + 画UI + + + + + + 在画背景时激发 + + + + + + 重写该方法解决在VS设计器中，每次保存一个新的尺寸，再打开尺寸会变大的问题 + + + + + 创建控件时激发 + + + + + 窗体可见变化时激发 + + + + + + 大小改变时激发 + + + + + + 在位置变化时激发 + + + + + + 窗体激活 + + + + + + 窗体关闭后激发 + + + + + + 加载时 + + + + + + 在子窗体激活时激发 + + + + + + 标签菜单 + + + + + 窗体上移动鼠标时激发 + + + + + + 获取当前点击的标签项 + + + + + 在窗体上按下鼠标时激发 + + + + + + 在窗体上放开鼠标时激发 + + + + + + 在鼠标离开窗体时激发 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 该类处理mdi-bar的绘制及鼠标事件管理 + + + + + use left,top,right to location the bar in owner form, + the margin is from Form.ClientRectangle + + + + + 整个标签栏高度,包含标签栏底部区域、标签、标签顶部空隙 + + + + + 标签栏底部区域的高度 + + + + + 是否显示标签栏边框 + + + + + 是否显示标签栏背景 + + + + + 标签栏左内边距 + + + + + 标签栏右内边距 + + + + + 标签高度 + + + + + 激活的标签高度 + + + + + tab顶部与bar顶部的空间,这个值用来计算 BarHeight + + + + + 每个标签的左右边界可以不是垂直的，而是都有一个斜度 + + + + + tab与tab之间的距离，用负值可以使tab有重叠的效果 + + + + + 标签是否显示图标 + + + + + 是否显示标签关闭按钮 + + + + + 标签图标大小 + + + + + 标签图标距离左边的距离 + + + + + 标签文字距离左边的距离 + + + + + 标签关闭按钮的大小 + + + + + 标签关闭按钮距离右边的距离 + + + + + 是否显示新建标签按钮 + + + + + 新建标签按钮的大小 + + + + + 新建标签距离左边的距离 + + + + + 按钮与Bar底部的距离 + + + + + 一个tab允许的最小宽度 + + + + + 一个tab允许的最大显示宽度 + + + + + 标签正常宽度 + + + + + 同步_listTabItems与mdi主窗体实际存在的子form + + + + + 为每个tab分配空间，如果tab数目太多，则有些会被隐藏 + + + + + 重绘整个标签栏 + + + + + + 处理鼠标事件。该方法会触发一些click事件，重刷一些按钮等 + + + + + + + 该类表示一个单独的标签项 + + + + + 该标签所对应的窗体 + + + + + 最终分配到的整个tab的宽度 + + + + + 表示所对应的form是否仍未被关闭 + + + + + 是否因空间不足而被隐藏 + + + + + 返回全部显示该标签文本所需的长度 + + + + + + 返回显示全部文本时该tab所需的宽度,该宽度不超过bar-container + 规定的tabmaxwidth + + + + + + 居左 + + + + + 显示在最后一个标签后面 + + + + + 该类封装设置一个主题所需的信息，可以继承该类实现不同的主题 + + + + + 主题名称，用于标识主题，对主题进行简单描述 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 窗体标题栏高度 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题栏图标尺寸 + + + + + 标题栏文本左边距 + + + + + 控制按钮（关闭按钮）相对于窗体右上角的偏移量 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 是否使用默认的圆角样式，该样式为左上角和右上角圆角， + 最好在窗体边框较粗时才使用该样式 + + + + + 是否在标题栏上绘制图标 + + + + + 是否在标题栏上绘制文本 + + + + + 是否显示窗体阴影 + + + + + 窗体阴影大小 + + + + + 拖动窗体阴影是否可以改变窗体大小 + + + + + 阴影的颜色，可以设置成其他颜色而不一定是黑色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 是否在客户区边界画线使其看起来有立体感 + + + + + 窗体标题栏文字是否居中显示 + + + + + 窗体边框最外一像素的颜色 + + + + + 窗体边框第二最外像素的颜色 + + + + + 窗体边框其他部分颜色，如果窗体边框大小大于2，则其他像素将用此颜色画出 + + + + + 标题栏颜色是从上到下渐变的，这个值设置上边的颜色值 + + + + + 标题栏颜色是从上到下渐变的，这个值设置下边的颜色值 + + + + + 标题栏文字颜色 + + + + + 窗体背景颜色，该值将覆盖窗体自带的BackColor属性值 + + + + + 窗体关闭按钮的颜色集合 + + + + + 窗体最大化/还原按钮的颜色集合 + + + + + 窗体最小化按钮的颜色集合 + + + + + 默认状态下关闭按钮背景图片 + + + + + 鼠标移过去时关闭按钮背景图片 + + + + + 鼠标按下时关闭按钮背景图片 + + + + + 默认状态下最大化按钮背景图片 + + + + + 鼠标移过去时最大化按钮背景图片 + + + + + 鼠标按下时最大化按钮背景图片 + + + + + 默认状态下恢复按钮背景图片 + + + + + 鼠标移过去时恢复按钮背景图片 + + + + + 鼠标按下时恢复按钮背景图片 + + + + + 默认状态下最小化按钮背景图片 + + + + + 鼠标移过去时最小化按钮背景图片 + + + + + 鼠标按下时最小化按钮背景图片 + + + + + 是否用SendMessage的方式切换子窗体，以避免子窗体切换时产生的闪烁 + + + + + Mdi-Bar与窗体左、上、右边界的距离，只用到这三个值，Bottom值没用到。 + 用这三个值来确定Mdi-Bar的宽度及其在窗体中的位置 + + + + + 内部左边空白，第一个标签将从这个空白距离之后开始 + + + + + 标签栏内部右边空白 + + + + + 标签栏背景颜色 + + + + + 标签栏边框颜色 + + + + + 标签栏背景图片 + + + + + 是否显示标签栏边框 + + + + + 标签栏下边区域的背景颜色 + + + + + 标签栏下边区域的高度 + + + + + 标签高度 + + + + + 被选中的标签高度，可以设置成与TabHeight不一样的值，以突出显示被选中状态 + + + + + 标签之间的距离，设成负值可以使标签有重叠的效果 + + + + + 标签的最大宽度，任何情况下标签都不能超过这个宽度 + + + + + 标签正常宽度，如果标签需要很短的宽度（比如20像素）就可以显示完上面的文字， + 但是Mdi-Bar上有足够的空间时，标签会以正常宽度（比如100像素）显示 + + + + + 标签最小宽度，当标签小于这个宽度时将被隐藏 + + + + + 标签梯度大小，标签可以不以矩形方式显示，而是有一个梯度/斜度。 + + + + + 标签顶部空白，这个值用于参与计算Mdi-Bar高度，计算方式为： + Mdi-Bar Height = BottomRegionHeight + TabHeight + TabTopSpace + + + + + 标签上是否显示子窗体图标 + + + + + 标签上是否显示子窗体关闭图标 + + + + + 选中状态的标签的上部背景色，与下部背景色不同时，标签背景色就有渐变效果 + + + + + 选中状态的标签的下部背景色，与上部背景色不同时，标签背景色就有渐变效果 + + + + + 标签激活时字体颜色 + + + + + 非选中状态的标签的字体颜色 + + + + + 非选中状态的标签的上部背景色 + + + + + 非选中状态的标签的下部背景色 + + + + + 标签外边框颜色 + + + + + 标签内边框颜色，这个颜色一般具有一定的透明度 + + + + + 是否显示标签边框 + + + + + 是否显示默认的新建标签按钮(NewTabBtn) + + + + + NewTabBtn与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 新建标签按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 新建标签按钮大小 + + + + + 按钮颜色集合 + + + + + 是否一直显示ListAllBtn，即使在没有标签被隐藏的情况下 + + + + + 《显示全部标签》按钮的位置 + + + + + 《显示全部标签》按钮与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 《显示全部标签》按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 《显示全部标签》按钮的颜色 + + + + + 《显示全部标签》按钮的大小 + + + + + 皮肤主题 + + + + + 设置百分比 + + + + + + + + + 引发 ValueChanged 事件 + + + + + + 引发 ThemeChanged 事件 + + + + + + 指示鼠标位于哪个区域 + + + + + 控件Value值发生变化后引发 + + + + + 控件绘制MainLine前引发, 可以设置Cancel参数来取消默认的绘制 + + + + + 控件绘制Button前引发 + + + + + 引发 ValueChanged 事件 + + + + + 引发 BeforePaintMainLine 事件 + + + + + 引发 BeforePaintButton 事件 + + + + + 将Value值加一个LargeChange量 + + + + + 将Value值减一个LargeChange量 + + + + + 将Value值加一个SmallChange量 + + + + + 将Value值减一个SmallChange量 + + + + + 提供产生各种路径的静态方法，比如圆角路径、关闭按钮上的x路径、+号路径 + + + + + 圆角样式 + + + + + 无 + + + + + 所有 + + + + + 上 + + + + + 下 + + + + + 左 + + + + + 右 + + + + + SimpleObject指的是只有一种状态（不像普通按钮一样有三种状态），并且其上的元素 + 布局比较简单的Object + + + + + + + + + + + + + + + + + + + + DevExpress风格皮肤 + + + + + DevExpress风格皮肤 + + + + + 新风格皮肤 + + + + + 新风格皮肤 + + + + + 基础皮肤 + + + + + VS2013风格皮肤 + + + + + this theme is just for chrome one quarter style + + + + + for diamond ring style only + + + + + Location of cursor hot spot returnet in WM_NCHITTEST. + + + + + On the screen background or on a dividing line between windows + (same as HTNOWHERE, except that the DefWindowProc function produces a system beep to indicate an error). + + + + + In a window currently covered by another window in the same thread + (the message will be sent to underlying windows in the same thread until one of them returns a code that is not HTTRANSPARENT). + + + + + On the screen background or on a dividing line between windows. + + + + In a client area. + + + In a title bar. + + + In a window menu or in a Close button in a child window. + + + In a size box (same as HTSIZE). + + + In a menu. + + + In a horizontal scroll bar. + + + In the vertical scroll bar. + + + In a Minimize button. + + + In a Maximize button. + + + In the left border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the right border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the upper-horizontal border of a window. + + + In the upper-left corner of a window border. + + + In the upper-right corner of a window border. + + + In the lower-horizontal border of a resizable window + (the user can click the mouse to resize the window vertically). + + + In the lower-left corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the lower-right corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the border of a window that does not have a sizing border. + + + In a Close button. + + + In a Help button. + + + + Contains the new coordinates of a window that has been moved or resized, that is, it is the proposed new window coordinates. + + + + + Contains the coordinates of the window before it was moved or resized. + + + + + Contains the coordinates of the window's client area before the window was moved or resized. + + + + + Pointer to a WINDOWPOS structure that contains the size and position values specified in the operation that moved or resized the window. + + + + + + + + + + 是否在这个按钮上按下了鼠标未释放 + + + + + 是否可见 + + + + + + + + + + 画两次可以加深颜色 + + + + + 用于在click事件中传回数据 + + + + + 获取或设置是否将绘制完全限制在指定的区域内 + + + + + + + + + + + + + + + + + Adapter for WinForms brushes objects for core. + + + + + The actual WinForms brush instance. + + + + + If to dispose the brush when is called.
+ Ignore dispose for cached brushes. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms context menu for core. + + + + + the underline win forms context menu + + + + + Init. + + + + + Adapter for WinForms Control for core. + + + + + the underline win forms control. + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Get the underline win forms control + + + + + Adapter for WinForms Font object for core. + + + + + the underline win-forms font. + + + + + a handle to this Font. + + + + + the vertical offset of the font underline location from the top of the font. + + + + + Cached font height. + + + + + Cached font whitespace width. + + + + + Init. + + + + + the underline win-forms font. + + + + + Get the handle to this Font. + + + + + Set font metrics to be cached for the font for future use. + + the full height of the font + the vertical offset of the font underline location from the top of the font. + + + + Adapter for WinForms Font family object for core. + + + + + the underline win-forms font. + + + + + Init. + + + + + the underline win-forms font family. + + + + + Adapter for WinForms Graphics for core. + + + + + used for calculation. + + + + + used for calculation. + + + + + Used for GDI+ measure string. + + + + + The string format to use for measuring strings for GDI+ text rendering + + + + + The string format to use for rendering strings for GDI+ text rendering + + + + + The wrapped WinForms graphics object + + + + + Use GDI+ text rendering to measure/draw text. + + + + + the initialized HDC used + + + + + if to release the graphics object on dispose + + + + + If text alignment was set to RTL + + + + + Init static resources. + + + + + Init. + + the win forms graphics object to use + Use GDI+ text rendering to measure/draw text + optional: if to release the graphics object on dispose (default - false) + + + + Release current HDC to be able to use methods. + + + + + Init HDC for the current graphics object to be used to call GDI directly. + + + + + Set a resource (e.g. a font) for the specified device context. + WARNING: Calling Font.ToHfont() many times without releasing the font handle crashes the app. + + + + + Set the text color of the device context. + + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Special draw logic to draw transparent text using GDI.
+ 1. Create in-memory DC
+ 2. Copy background to in-memory DC
+ 3. Draw the text to in-memory DC
+ 4. Copy the in-memory DC to the proper location with alpha blend
+ + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Adapter for WinForms graphics path object for core. + + + + + The actual WinForms graphics path instance. + + + + + the last point added to the path to begin next segment from + + + + + The actual WinForms graphics path instance. + + + + + Get arc start angle for the given corner. + + + + + Adapter for WinForms Image object for core. + + + + + the underline win-forms image. + + + + + Initializes a new instance of the class. + + + + + the underline win-forms image. + + + + + Adapter for WinForms pens objects for core. + + + + + The actual WinForms brush instance. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms platforms. + + + + + Singleton instance of global adapter. + + + + + Init installed font families and set default font families mapping. + + + + + Singleton instance of global adapter. + + + + + Low level handling of Html Renderer logic, this class is used by , + , and .
+ + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + returns page list + + + + + returns page list count + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrappable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given printer device. + + the printer device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + mouse event args + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the mouse event args + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + + + + + + Create HtmlRenderer mouse event from win forms mouse event. + + + + + Create HtmlRenderer key event from win forms key event. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ Using and client can control how the html content effects the + size of the label. Either case scrollbars are never shown and html content outside of client bounds will be clipped. + and with AutoSize can limit the max/min size of the control
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoSize:

+ AutoSize = AutoSizeHeightOnly = false
+ The label size will not change by the html content. MaximumSize and MinimumSize are ignored.
+
+ AutoSize = true
+ The width and height is adjustable by the html content, the width will be longest line in the html, MaximumSize.Width will restrict it but it can be lower than that.
+
+ AutoSizeHeightOnly = true
+ The width of the label is set and will not change by the content, the height is adjustable by the html content with restrictions to the MaximumSize.Height and MinimumSize.Height values.
+ + +

LinkClicked event

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + the current html text set in the control + + + + + is to handle auto size of the control height only + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + Creates a new HTML Label + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Automatically sets the size of the label by content size + + + + + Automatically sets the height of the label by content height (width is not effected). + + + + + Gets or sets the max size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the min size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the html of this control. + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform paint of the html in the control. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ If is true and the layout of the html resulted in its content beyond the client bounds + of the panel it will show scrollbars (horizontal/vertical) allowing to scroll the content.
+ If is false html content outside the client bounds will be clipped.
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoScroll:

+ Allows showing scrollbars if html content is placed outside the visible boundaries of the panel. + + +

LinkClicked event:

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the control + + + + + the current html text set in the control + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + The last position of the scrollbars to know if it has changed to update mouse + + + + + Creates a new HtmlPanel and sets a basic css for it's styling. + + + + + + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. + + + + + Gets or sets the text of this panel + + + + + + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Adjust the scrollbar of the panel on html element by the given id.
+ The top of the html element rectangle will be at the top of the panel, if there + is not enough height to scroll to the top the scroll will be at maximum.
+ + the id of the element to scroll to + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform html container layout by the current panel client size. + + + + + Perform paint of the html in the control. + + + + + Set focus on the control for keyboard scrollbars handling. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Handle key down event for selection, copy and scrollbars handling. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + On html renderer scroll request adjust the scrolling of the panel to the requested location. + + + + + Adjust the scrolling of the panel to the requested location. + + the location to adjust the scroll to + + + + call mouse move to handle paint after scroll or html change affecting mouse cursor. + + + + + Used to add arrow keys to the handled keys in . + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Standalone static class for simple and direct HTML rendering.
+ For WinForms UI prefer using HTML controls: or .
+ For low-level control and performance consider using .
+ + + + GDI vs. GDI+ text rendering
+ Windows supports two text rendering technologies: GDI and GDI+.
+ GDI is older, has better performance and looks better on standard monitors but doesn't support alpha channel for transparency.
+ GDI+ is newer, device independent so work better for printers but is slower and looks worse on monitors.
+ HtmlRender supports both GDI and GDI+ text rendering to accommodate different needs, GDI+ text rendering methods have "GdiPlus" suffix + in their name where GDI do not.
+ + + Rendering to image
+ See https://htmlrenderer.codeplex.com/wikipage?title=Image%20generation
+ Because of GDI text rendering issue with alpha channel clear type text rendering rendering to image requires special handling.
+ Solid color background - generate an image where the background is filled with solid color and all the html is rendered on top + of the background color, GDI text rendering will be used. (RenderToImage method where the first argument is html string)
+ Image background - render html on top of existing image with whatever currently exist but it cannot have transparent pixels, + GDI text rendering will be used. (RenderToImage method where the first argument is Image object)
+ Transparent background - render html to empty image using GDI+ text rendering, the generated image can be transparent. + Text rendering can be controlled using , note that + doesn't render well on transparent background. (RenderToImageGdiPlus method)
+ + + Overwrite stylesheet resolution
+ Exposed by optional "stylesheetLoad" delegate argument.
+ Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + Overwrite image resolution
+ Exposed by optional "imageLoad" delegate argument.
+ Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ Note: Cannot use asynchronous scheme overwrite scheme.
+ + + + + Simple rendering
+ HtmlRender.Render(g, "Hello World]]>");
+ HtmlRender.Render(g, "Hello World]]>", 10, 10, 500, CssData.Parse("body {font-size: 20px}")");
+ + + Image rendering
+ HtmlRender.RenderToImage("Hello World]]>", new Size(600,400));
+ HtmlRender.RenderToImage("Hello World]]>", 600);
+ HtmlRender.RenderToImage(existingImage, "Hello World]]>");
+ + + + + + Adds a font family to be used in html rendering.
+ The added font will be used by all rendering function including and all WinForms controls. + + + The given font family instance must be remain alive while the renderer is in use.
+ If loaded to then the collection must be alive.
+ If loaded from file then the file must not be deleted. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + + This fonts mapping can be used as a fallback in case the requested font is not installed in the client system. + + the font family to replace + the font family to replace with + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI text rendering, note has no effect. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI+ text rending, use to control text rendering. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Renders the specified HTML source on the specified location and max width restriction.
+ Use GDI text rendering, note has no effect.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI text rendering, note has no effect.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ The HTML will be layout by the given image size but may be clipped if cannot fit.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + optional: the top-left most location to start render the html at (default - 0,0) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Measure the size (width and height) required to draw the given html under given width and height restrictions.
+ + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size of the html by performing layout under the given restrictions. + + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Clip the graphics so the html will not be rendered outside the max height bound given.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Copy all the bitmap bits from memory bitmap buffer to the given image. + + the source memory bitmap buffer to copy from + the destination bitmap image to copy to + + + + Provides HTML rendering on the tooltips. + + + + + the container to render and handle the html shown in the tooltip + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + The text rendering hint to be used for text rendering. + + + + + The CSS class used for tooltip html root div + + + + + the control that the tooltip is currently showing on.
+ Used for link handling. + + + + + timer used to handle mouse move events when mouse is over the tooltip.
+ Used for link handling. + + + + + the handle of the actual tooltip window used to know when the tooltip is hidden
+ Used for link handling. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + The CSS class used for tooltip html root div (default: htmltooltip)
+ Setting to 'null' clear base style on the tooltip.
+ Set custom class found in to change the base style of the tooltip. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Gets or sets the max size the tooltip. + + An ordered pair of type representing the width and height of a rectangle. + + + + On tooltip appear set the html by the associated control, layout and set the tooltip size by the html size. + + + + + Draw the html using the tooltip graphics. + + + + + Adjust the location of the tooltip window to the location of the mouse and handle + if the tooltip window will try to appear outside the boundaries of the control. + + the control the tooltip is appearing on + the size of the tooltip window + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Raised on link handling timer tick, used for: + 1. Know when the tooltip is hidden by checking the visibility of the tooltip window. + 2. Call HandleMouseMove so the mouse cursor will react if over a link element. + 3. Call HandleMouseDown and HandleMouseUp to simulate click on a link if one was clicked. + + + + + Unsubscribe from events and dispose of . + + + + + Helper to encode and set HTML fragment to clipboard.
+ See http://theartofdev.wordpress.com/2012/11/11/setting-html-and-plain-text-formatting-to-clipboard/.
+ . + + + The MIT License (MIT) Copyright (c) 2014 Arthur Teplitzki. + + + + + The string contains index references to other spots in the string, so we need placeholders so we can compute the offsets.
+ The _ strings are just placeholders. We'll back-patch them actual values afterwards.
+ The string layout () also ensures that it can't appear in the body of the html because the
+ character must be escaped.
+ + + + + html comment to point the beginning of html fragment + + + + + html comment to point the end of html fragment + + + + + Used to calculate characters byte count in UTF-8 + + + + + Create with given html and plain-text ready to be used for clipboard or drag and drop.
+ Handle missing ]]> tags, specified start\end segments and Unicode characters. + + + + Windows Clipboard works with UTF-8 Unicode encoding while .NET strings use with UTF-16 so for clipboard to correctly + decode Unicode string added to it from .NET we needs to be re-encoded it using UTF-8 encoding. + + + Builds the CF_HTML header correctly for all possible HTMLs
+ If given html contains start/end fragments then it will use them in the header: + hello world]]> + If given html contains html/body tags then it will inject start/end fragments to exclude html/body tags: + hello world]]> + If given html doesn't contain html/body tags then it will inject the tags and start/end fragments properly: + world]]> + In all cases creating a proper CF_HTML header:
+ + + hello world + ]]> + + See format specification here: http://msdn.microsoft.com/library/default.asp?url=/workshop/networking/clipboard/htmlclipboard.asp + + + a html fragment + the plain text + + + + Clears clipboard and sets the given HTML and plain text fragment to the clipboard, providing additional meta-information for HTML.
+ See for HTML fragment details.
+ + + ClipboardHelper.CopyToClipboard("Hello World", "Hello World"); + + a html fragment + the plain text + + + + Clears clipboard and sets the given plain text fragment to the clipboard.
+ + the plain text + + + + Generate HTML fragment data string with header that is required for the clipboard. + + the html to generate for + the resulted string + + + + Calculates the number of bytes produced by encoding the string in the string builder in UTF-8 and not .NET default string encoding. + + the string builder to count its string + optional: the start index to calculate from (default - start of string) + optional: the end index to calculate to (default - end of string) + the number of bytes required to encode the string in UTF-8 + + + + Utilities for converting WinForms entities to HtmlRenderer core entities. + + + + + Convert from WinForms point to core point. + + + + + Convert from WinForms point to core point. + + + + + Convert from core point to WinForms point. + + + + + Convert from core point to WinForms point. + + + + + Convert from WinForms size to core size. + + + + + Convert from core size to WinForms size. + + + + + Convert from core size to WinForms size. + + + + + Convert from WinForms rectangle to core rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from WinForms color to core color. + + + + + Convert from core color to WinForms color. + + + + + Utility for Win32 API. + + + + + Const for BitBlt copy raster-operation code. + + + + + Const for BitBlt paint raster-operation code. + + + + + Create a compatible memory HDC from the given HDC.
+ The memory HDC can be rendered into without effecting the original HDC.
+ The returned memory HDC and must be released using . + + the HDC to create memory HDC from + the width of the memory HDC to create + the height of the memory HDC to create + returns used bitmap memory section that must be released when done with memory HDC + memory HDC + + + + Release the given memory HDC and dib section created from . + + Memory HDC to release + bitmap section to release + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + A pointer to a RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + If the function succeeds, the return value is nonzero. + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ARGB (alpha, red, green, blue) color. + + + + + Represents a color that is null. + + 1 + + + + Gets a system-defined color. + + + + + Gets a system-defined color that has an ARGB value of #FF000000. + + + + + Gets a system-defined color that has an ARGB value of #FFFFFFFF. + + + + + Gets a system-defined color that has an ARGB value of #FFF5F5F5. + + + + + Gets a system-defined color that has an ARGB value of #FFD3D3D3. + + + + + Gets the red component value of this structure. + + + + + Gets the green component value of this structure. + + + + + Gets the blue component value of this structure. + + + + + Gets the alpha component value of this structure. + + + + + Specifies whether this structure is uninitialized. + + + This property returns true if this color is uninitialized; otherwise, false. + + 1 + + + + Tests whether two specified structures are equivalent. + + + true if the two structures are equal; otherwise, false. + + + The that is to the left of the equality operator. + + + The that is to the right of the equality operator. + + 3 + + + + Tests whether two specified structures are different. + + + true if the two structures are different; otherwise, false. + + + The that is to the left of the inequality operator. + + + The that is to the right of the inequality operator. + + 3 + + + + Creates a structure from the four ARGB component (alpha, red, green, and blue) values. Although this method allows a 32-bit value to be passed for each component, the value of each component is limited to 8 bits. + + + The that this method creates. + + The alpha component. Valid values are 0 through 255. + The red component. Valid values are 0 through 255. + The green component. Valid values are 0 through 255. + The blue component. Valid values are 0 through 255. + + , , , or is less than 0 or greater than 255. + + 1 + + + + Creates a structure from the specified 8-bit color values (red, green, and blue). The alpha value is implicitly 255 (fully opaque). Although this method allows a 32-bit value to be passed for each color component, the value of each component is limited to 8 bits. + + + The that this method creates. + + + The red component value for the new . Valid values are 0 through 255. + + + The green component value for the new . Valid values are 0 through 255. + + + The blue component value for the new . Valid values are 0 through 255. + + + , , or is less than 0 or greater than 255. + + 1 + + + + Tests whether the specified object is a structure and is equivalent to this + + structure. + + + true if is a structure equivalent to this + + structure; otherwise, false. + + The object to test. + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies the hash code for this . + + 1 + + + + Converts this structure to a human-readable string. + + + + + Specifies the style of dashed lines drawn with a object. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 自定义 + + + + + Specifies style information applied to text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + Init. + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + Is the left mouse button participated in the event + + + + + Init. + + + + + Is the left mouse button participated in the event + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ordered pair of floating-point x- and y-coordinates that defines a point in a two-dimensional plane. + + + + + Represents a new instance of the class with member data left uninitialized. + + 1 + + + + Initializes a new instance of the class with the specified coordinates. + + The horizontal position of the point. + The vertical position of the point. + + + + + + Gets a value indicating whether this is empty. + + + true if both and + + are 0; otherwise, false. + + 1 + + + + Gets or sets the x-coordinate of this . + + + The x-coordinate of this . + + 1 + + + + Gets or sets the y-coordinate of this . + + + The y-coordinate of this . + + 1 + + + + Translates the by the specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the x- and y-coordinates of the + + . + + + + + Translates a by the negative of a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Compares two structures. The result specifies whether the values of the + + and properties of the two + + structures are equal. + + + true if the and + + values of the left and right + + structures are equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Determines whether the coordinates of the specified points are not equal. + + + true to indicate the and + + values of and + + are not equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Translates a given by a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the coordinates of + + . + + + + + Translates a by the negative of a specified size. + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Specifies whether this contains the same coordinates as the specified + + . + + + This method returns true if is a and has the same coordinates as this + + . + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts this to a human readable string. + + + A string that represents this . + + 1 + + + + Stores a set of four floating-point numbers that represent the location and size of a rectangle. + + + + + Represents an instance of the class with its members uninitialized. + + + + + Initializes a new instance of the class with the specified location and size. + + The x-coordinate of the upper-left corner of the rectangle. + The y-coordinate of the upper-left corner of the rectangle. + The width of the rectangle. + The height of the rectangle. + + + + Initializes a new instance of the class with the specified location and size. + + A that represents the upper-left corner of the rectangular region. + A that represents the width and height of the rectangular region. + + + + Gets or sets the coordinates of the upper-left corner of this structure. + + A that represents the upper-left corner of this structure. + + + + Gets or sets the size of this . + + A that represents the width and height of this structure. + + + + Gets or sets the x-coordinate of the upper-left corner of this structure. + + + The x-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the y-coordinate of the upper-left corner of this structure. + + + The y-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the width of this structure. + + + The width of this structure. + + + + + Gets or sets the height of this structure. + + + The height of this structure. + + + + + Gets the x-coordinate of the left edge of this structure. + + + The x-coordinate of the left edge of this structure. + + + + + Gets the y-coordinate of the top edge of this structure. + + + The y-coordinate of the top edge of this structure. + + + + + Gets the x-coordinate that is the sum of and + + of this structure. + + + The x-coordinate that is the sum of and + + of this structure. + + + + + Gets the y-coordinate that is the sum of and + + of this structure. + + + The y-coordinate that is the sum of and + + of this structure. + + + + + Tests whether the or + + property of this has a value of zero. + + + This property returns true if the or + + property of this has a value of zero; otherwise, false. + + + + + Tests whether two structures have equal location and size. + + + This operator returns true if the two specified structures have equal + , , , and properties. + + + The structure that is to the left of the equality operator. + + + The structure that is to the right of the equality operator. + + + + + Tests whether two structures differ in location or size. + + + This operator returns true if any of the , + , , or + properties of the two structures are unequal; otherwise false. + + + The structure that is to the left of the inequality operator. + + + The structure that is to the right of the inequality operator. + + + + + Creates a structure with upper-left corner and lower-right corner at the specified locations. + + + The new that this method creates. + + The x-coordinate of the upper-left corner of the rectangular region. + The y-coordinate of the upper-left corner of the rectangular region. + The x-coordinate of the lower-right corner of the rectangular region. + The y-coordinate of the lower-right corner of the rectangular region. + + + + Tests whether is a with the same location and size of this + . + + + This method returns true if is a and its X, Y, Width, and Height properties are equal to the corresponding properties of this + ; otherwise, false. + + + The to test. + + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point defined by and is contained within this + + structure; otherwise false. + + The x-coordinate of the point to test. + The y-coordinate of the point to test. + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point represented by the parameter is contained within this + + structure; otherwise false. + + The to test. + + + + Determines if the rectangular region represented by is entirely contained within this + + structure. + + + This method returns true if the rectangular region represented by is entirely contained within the rectangular region represented by this + + ; otherwise false. + + + The to test. + + + + + Inflates this structure by the specified amount. + + + The amount to inflate this structure horizontally. + + + The amount to inflate this structure vertically. + + + + + Inflates this by the specified amount. + + The amount to inflate this rectangle. + + + + Creates and returns an inflated copy of the specified structure. The copy is inflated by the specified amount. The original rectangle remains unmodified. + + + The inflated . + + + The to be copied. This rectangle is not modified. + + The amount to inflate the copy of the rectangle horizontally. + The amount to inflate the copy of the rectangle vertically. + + + + Replaces this structure with the intersection of itself and the specified + + structure. + + The rectangle to intersect. + + + + Returns a structure that represents the intersection of two rectangles. If there is no intersection, and empty + + is returned. + + + A third structure the size of which represents the overlapped area of the two specified rectangles. + + A rectangle to intersect. + A rectangle to intersect. + + + + Determines if this rectangle intersects with . + + + This method returns true if there is any intersection. + + The rectangle to test. + + + + Creates the smallest possible third rectangle that can contain both of two rectangles that form a union. + + + A third structure that contains both of the two rectangles that form the union. + + A rectangle to union. + A rectangle to union. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location horizontally. + The amount to offset the location vertically. + + + + Gets the hash code for this structure. For information about the use of hash codes, see Object.GetHashCode. + + The hash code for this + + + + Converts the Location and Size of this to a human-readable string. + + + A string that contains the position, width, and height of this structure for example, "{X=20, Y=20, Width=100, Height=50}". + + + + + Stores an ordered pair of floating-point numbers, typically the width and height of a rectangle. + + + + + Gets a structure that has a + + and + + value of 0. + + + A structure that has a + + and + + value of 0. + + 1 + + + + Initializes a new instance of the structure from the specified existing + + structure. + + + The structure from which to create the new + + structure. + + + + + Initializes a new instance of the structure from the specified structure. + + The structure from which to initialize this structure. + + + + Initializes a new instance of the structure from the specified dimensions. + + + The width component of the new structure. + + + The height component of the new structure. + + + + + Gets a value that indicates whether this structure has zero width and height. + + + This property returns true when this structure has both a width and height of zero; otherwise, false. + + 1 + + + + Gets or sets the horizontal component of this structure. + + + The horizontal component of this structure, typically measured in pixels. + + 1 + + + + Gets or sets the vertical component of this structure. + + + The vertical component of this structure, typically measured in pixels. + + 1 + + + + Converts the specified structure to a + structure. + + The structure to which this operator converts. + The structure to be converted + + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + 3 + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A that is the result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + 3 + + + + Tests whether two structures are equal. + + + This operator returns true if and have equal width and height; otherwise, false. + + + The structure on the left side of the equality operator. + + + The structure on the right of the equality operator. + + 3 + + + + Tests whether two structures are different. + + + This operator returns true if and differ either in width or height; false if + + and are equal. + + + The structure on the left of the inequality operator. + + + The structure on the right of the inequality operator. + + 3 + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A structure that is a result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + + + + Tests to see whether the specified object is a structure with the same dimensions as this + + structure. + + + This method returns true if is a and has the same width and height as this + + ; otherwise, false. + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts a structure to a structure. + + + Returns a structure. + + + + + Creates a human-readable string that represents this structure. + + + A string that represents this structure. + + 1 + + + + + + + Platform adapter to bridge platform specific objects to HTML Renderer core library.
+ Core uses abstract renderer objects (RAdapter/RControl/REtc...) to access platform specific functionality, the concrete platforms + implements those objects to provide concrete platform implementation. Those allowing the core library to be platform agnostic. + + Platforms: WinForms, WPF, Metro, PDF renders, etc.
+ Objects: UI elements(Controls), Graphics(Render context), Colors, Brushes, Pens, Fonts, Images, Clipboard, etc.
+ + + + It is best to have a singleton instance of this class for concrete implementation!
+ This is because it holds caches of default CssData, Images, Fonts and Brushes. + + + + + cache of brush color to brush instance + + + + + cache of pen color to pen instance + + + + + cache of all the font used not to create same font again and again + + + + + default CSS parsed data singleton + + + + + image used to draw loading image icon + + + + + image used to draw error image icon + + + + + Init. + + + + + Get the default CSS stylesheet data. + + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Check if the given font exists in the system by font family name. + + the font name to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get image to be used while HTML image is loading. + + + + + Get image to be used if HTML image load failed. + + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard
+ Not relevant for platforms that don't render HTML on UI element. + + the text to set + + + + Set the given html and plain text data to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + + + + Set the given image to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the image object to set to clipboard + + + + Create a context menu that can be used on the control
+ Not relevant for platforms that don't render HTML on UI element. + + new context menu + + + + Save the given image to file by showing save dialog to the client.
+ Not relevant for platforms that don't render HTML on UI element. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard + + the text to set + + + + Set the given html and plain text data to clipboard. + + the html data + the plain text data + + + + Set the given image to clipboard. + + + + + + Create a context menu that can be used on the control + + new context menu + + + + Save the given image to file by showing save dialog to the client. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Adapter for platform specific brush objects - used to fill graphics (rectangles, polygons and paths).
+ The brush can be solid color, gradient or image. + + + + + + + + + + Adapter for platform specific context menu - used to create and show context menu at specific location.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The total number of items in the context menu + + + + + Add divider item to the context menu.
+ The divider is a non clickable place holder used to separate items. + + + + + Add item to the context menu with the given text that will raise the given event when clicked. + the text to set on the new context menu itemif to set the item as enabled or disabledthe event to raise when the item is clicked + + + + Remove the last item from the context menu iff it is a divider + + + + + Show the context menu in the given parent control at the given location. + the parent control to show inthe location to show at relative to the parent control + + + + + + + + + Adapter for platform specific control object - used to handle updating the control that the html is rendered on.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The platform adapter. + + + + + Init control with platform adapter. + + + + + The platform adapter. + + + + + Is the left mouse button is currently in pressed state + + + + + Is the right mouse button is currently in pressed state + + + + + Get the current location of the mouse relative to the control + + + + + Set the cursor over the control to default cursor + + + + + Set the cursor over the control to hand cursor + + + + + Set the cursor over the control to I beam cursor + + + + + Do drag-drop copy operation for the given data object. + + the drag-drop data object + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Invalidates the entire surface of the control and causes the control to be redrawn. + + + + + Adapter for platform specific font object - used to render text using specific font. + + + + + Gets the em-size of this Font measured in the units specified by the Unit property. + + + + + The line spacing, in pixels, of this font. + + + + + Get the vertical offset of the font underline location from the top of the font. + + + + + Get the left padding, in pixels, of the font. + + + + + + + + + + + + Adapter for platform specific font family object - define the available font families to use.
+ Required for custom fonts handling: fonts that are not installed on the system. + + + + + Gets the name of this Font Family. + + + + + Adapter for platform specific graphics rendering object - used to render graphics and text in platform specific context.
+ The core HTML Renderer components use this class for rendering logic, extending this + class in different platform: WinForms, WPF, Metro, PDF, etc. + + + + + the global adapter + + + + + Te clipping bound stack as clips are pushed/poped to/from the graphics + + + + + Init. + + + + + Get color pen. + + the color to get the pen for + pen instance + + + + Get solid color brush. + + the color to get the brush for + solid color brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Gets a Rectangle structure that bounds the clipping region of this Graphics. + + A rectangle structure that represents a bounding rectangle for the clipping region of this Graphics. + + + + Pop the latest clip push. + + + + + Push the clipping region of this Graphics to interception of current clipping rectangle and the given rectangle. + + Rectangle to clip to. + + + + Push the clipping region of this Graphics to exclude the given rectangle from the current clipping rectangle. + + Rectangle to exclude clipping in. + + + + Set the graphics smooth mode to use anti-alias.
+ Use to return back the mode used. + + the previous smooth mode before the change + + + + Return to previous smooth mode before anti-alias was set as returned from . + + the previous mode to set + + + + Get TextureBrush object that uses the specified image and bounding rectangle. + + The Image object with which this TextureBrush object fills interiors. + A Rectangle structure that represents the bounding rectangle for this TextureBrush object. + The dimension by which to translate the transformation + + + + Get GraphicsPath object. + + graphics path instance + + + + Measure the width and height of string when drawn on device context HDC + using the given font . + + the string to measure + the font to measure string with + the size of the string + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ Not relevant for platforms that don't render HTML on UI element. + + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Draw the given string using the given font and foreground color at given location. + + the string to draw + the font to use to draw the string + the text color to set + the location to start string draw (top-left) + used to know the size of the rendered text for transparent text support + is to render the string right-to-left (true - RTL, false - LTR) + + + + Draws a line connecting the two points specified by the coordinate pairs. + + Pen that determines the color, width, and style of the line. + The x-coordinate of the first point. + The y-coordinate of the first point. + The x-coordinate of the second point. + The y-coordinate of the second point. + + + + Draws a rectangle specified by a coordinate pair, a width, and a height. + + A Pen that determines the color, width, and style of the rectangle. + The x-coordinate of the upper-left corner of the rectangle to draw. + The y-coordinate of the upper-left corner of the rectangle to draw. + The width of the rectangle to draw. + The height of the rectangle to draw. + + + + Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height. + + Brush that determines the characteristics of the fill. + The x-coordinate of the upper-left corner of the rectangle to fill. + The y-coordinate of the upper-left corner of the rectangle to fill. + Width of the rectangle to fill. + Height of the rectangle to fill. + + + + Draws the specified portion of the specified at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. The image is scaled to fit the rectangle. + Rectangle structure that specifies the portion of the object to draw. + + + + Draws the specified Image at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. + + + + Draws a GraphicsPath. + + Pen that determines the color, width, and style of the path. + GraphicsPath to draw. + + + + Fills the interior of a GraphicsPath. + + Brush that determines the characteristics of the fill. + GraphicsPath that represents the path to fill. + + + + Fills the interior of a polygon defined by an array of points specified by Point structures. + + Brush that determines the characteristics of the fill. + Array of Point structures that represent the vertices of the polygon to fill. + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Adapter for platform specific graphics path object - used to render (draw/fill) path shape. + + + + + Start path at the given point. + + + + + Add stright line to the given point from te last point. + + + + + Add circular arc of the given size to the given point from the last point. + + + + + Release path resources. + + + + + The 4 corners that are handled in arc rendering. + + + + + + + + + + + + + + + + + + + + + + + + + Adapter for platform specific image object - used to render images. + + + + + Get the width, in pixels, of the image. + + + + + Get the height, in pixels, of the image. + + + + + + + + + + Adapter for platform specific pen objects - used to draw graphics (lines, rectangles and paths) + + + + + Gets or sets the width of this Pen, in units of the Graphics object used for drawing. + + + + + Gets or sets the style used for dashed lines drawn with this Pen. + + + + + Holds parsed stylesheet css blocks arranged by media and classes.
+ + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + used to return empty array + + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data. + + + + + Init. + + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + Platform adapter + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data + + + + + Check if there are css blocks for the given class selector. + + the class selector to check for css blocks by + optional: the css media type (default - all) + true - has css blocks for the class, false - otherwise + + + + Get collection of css blocks for the requested class selector.
+ the can be: class name, html element name, html element and + class name (elm.class), hash tag with element id (#id).
+ returned all the blocks that word on the requested class selector, it can contain simple + selector or hierarchy selector. + + the class selector to get css blocks by + optional: the css media type (default - all) + collection of css blocks, empty collection if no blocks exists (never null) + + + + Add the given css block to the css data, merging to existing block if required. + + + If there is no css blocks for the same class it will be added to data collection.
+ If there is already css blocks for the same class it will check for each existing block + if the hierarchical selectors match (or not exists). if do the two css blocks will be merged into + one where the new block properties overwrite existing if needed. if the new block doesn't mach any + existing it will be added either to the beginning of the list if it has no hierarchical selectors or at the end.
+ Css block without hierarchical selectors must be added to the beginning of the list so more specific block + can overwrite it when the style is applied. + + the media type to add the CSS to + the css block to add + + + + Combine this CSS data blocks with CSS blocks for each media.
+ Merge blocks if exists in both. + + the CSS data to combine with + + + + Create deep copy of the css data with cloned css blocks. + + cloned object + + + + CSS Specification's Default Style Sheet for HTML 4 + + + http://www.w3.org/TR/CSS21/sample.html + + + + + Border types + + + + + Represents a CSS Box of text or replaced elements. + + + The Box can contains other boxes, that's the way that the CSS Tree + is composed. + + To know more about boxes visit CSS spec: + http://www.w3.org/TR/CSS21/box.html + + + + + the parent css box of this css box in the hierarchy + + + + + the root container for the hierarchy + + + + + the html tag that is associated with this css box, null if anonymous box + + + + + the inner text of the box + + + + + Do not use or alter this flag + + + Flag that indicates that CssTable algorithm already made fixes on it. + + + + + handler for loading background image + + + + + Init. + + optional: the parent of this css box in html + optional: the html tag associated with this css box + + + + Gets the HtmlContainer of the Box. + WARNING: May be null. + + + + + Gets or sets the parent box of this box + + + + + Gets the children boxes of this box + + + + + Is the box is of "br" element. + + + + + is the box "Display" is "Inline", is this is an inline box and not block. + + + + + is the box "Display" is "Block", is this is an block box and not inline. + + + + + Is the css box clickable (by default only "a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + Gets the containing block-box of this box. (The nearest parent box with display=block) + + + + + Gets the HTMLTag that hosts this box + + + + + Gets if this box represents an image + + + + + Tells if the box is empty or contains just blank spaces + + + + + Gets or sets the inner text of the box + + + + + Gets the line-boxes of this box (if block box) + + + + + Gets the linebox(es) that contains words of this box (if inline) + + + + + Gets the rectangles where this box should be painted + + + + + Gets the BoxWords of text in the box + + + + + Gets the first word of the box + + + + + Gets or sets the first linebox where content of this box appear + + + + + Gets or sets the last linebox where content of this box appear + + + + + Create new css box for the given parent with the given html tag.
+ + the html tag to define the box + the box to add the new box to it as child + the new box + + + + Create new css box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous inline boxes visit: http://www.w3.org/TR/CSS21/visuren.html#anonymous + + the box to add the new box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new box + + + + Create new css block box. + + the new block box + + + + Create new css block box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous block boxes visit CSS spec: + http://www.w3.org/TR/CSS21/visuren.html#anonymous-block-level + + the box to add the new block box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new block box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + Device context to use + + + + Prints the fragment + + Device context to use + + + + + + Set this box in + + + + + + Move all child boxes from to this box. + + the box to move all its child boxes from + + + + Splits the text into words and saves the result + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions.
+ + Device context to use + + + + Assigns words its width and height + + + + + + Get the parent of this css properties instance. + + + + + + Gets the index of the box to be used on a (ordered) list + + + + + + Creates the + + + + + + Searches for the first word occurrence inside the box, on the specified linebox + + + + + + + + Gets the specified Attribute, returns string.Empty if no attribute specified + + Attribute to retrieve + Attribute value or string.Empty if no attribute specified + + + + Gets the value of the specified attribute of the source HTML tag. + + Attribute to retrieve + Value to return if attribute is not specified + Attribute value or defaultValue if no attribute specified + + + + Gets the minimum width that the box can be.
+ The box can be as thin as the longest word plus padding.
+ The check is deep thru box tree.
+ + the min width of the box + + + + Gets the longest word (in width) inside the box, deeply. + + + + + + + + + Get the total margin value (left and right) from the given box to the given end box.
+ + the box to start calculation from. + the total margin + + + + Gets the maximum bottom of the boxes inside the startBox + + + + + + + + Get the and width of the box content.
+ + The minimum width the content must be so it won't overflow (largest word + padding). + The total width the content can take without line wrapping (with padding). + + + + Get the and of the box words content and .
+ + the box to calculate for + the width that allows for each word to fit (width of the longest word) + the max width a single line of words can take without wrapping + the total amount of padding the content has + + + + + + Gets if this box has only inline siblings (including itself) + + + + + + Gets the rectangles where inline box will be drawn. See Remarks for more info. + + Rectangles where content should be placed + + Inline boxes can be split across different LineBoxes, that's why this method + Delivers a rectangle for each LineBox related to this box, if inline. + + + Inherits inheritable values from parent. + + + + + Gets the result of collapsing the vertical margins of the two boxes + + the previous box under the same parent + Resulting top margin + + + + Calculate the actual right of the box by the actual right of the child boxes if this box actual right is not set. + + the calculated actual right value + + + + Gets the result of collapsing the vertical margins of the two boxes + + Resulting bottom margin + + + + Deeply offsets the top of the box and its contents + + + + + + Paints the fragment + + the device to draw to + + + + Prints the fragment + + the device to draw to + + + + + + Paints the background of the box + + the device to draw into + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Paint all the words in the box. + + the device to draw into + the current scroll offset to offset the words + + + + Paints the text decoration (underline/strike-through/over-line) + + the device to draw into + + + + + + + Offsets the rectangle of the specified linebox by the specified gap, + and goes deep for rectangles of children in that linebox. + + + + + + + Resets the array + + + + + On image load process complete with image request refresh for it to be painted. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Get brush for the text depending if there is selected text color set. + + + + + Get brush for selection background depending if it has external and if alpha is required for images. + + + used for images so they will have alpha effect + + + + ToString override. + + + + + + CSS box for iframe element.
+ If the iframe is of embedded YouTube or Vimeo video it will show image with play. + + + + + the image word of this image box + + + + + is the iframe is of embeded video + + + + + the title of the video + + + + + the url of the video thumbnail image + + + + + link to the video on the site + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Is the css box clickable ("a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + is the iframe is of embeded video + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Load YouTube video data (title, image, link) by calling YouTube API. + + + + + Parse YouTube API response to get video data (title, image, link). + + + + + Load Vimeo video data (title, image, link) by calling Vimeo API. + + + + + Parse Vimeo API response to get video data (title, image, link). + + + + + Handle error occurred during video data load to handle if the video was not found. + + the exception that occurred during data load web request + the name of the video source (YouTube/Vimeo/Etc.) + + + + Create image handler for downloading video image if found and release the WebClient instance used for API call. + + + + + Paints the fragment + + the device to draw to + + + + Draw video image over the iframe if found. + + + + + Draw video title on top of the iframe if found. + + + + + Draw play over the iframe if we found link url. + + + + + Assigns words its width and height + + the device to use + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + CSS box for hr element. + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + the device to draw to + + + + CSS box for image element. + + + + + the image word of this image box + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Get the image of this image box. + + + + + Paints the fragment + + the device to draw to + + + + Assigns words its width and height + + the device to use + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Base class for css box to handle the css properties.
+ Has field and property for every css property that can be set, the properties add additional parsing like + setting the correct border depending what border value was set (single, two , all four).
+ Has additional fields to control the location and size of the box and 'actual' css values for some properties + that require additional calculations and parsing.
+ + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + the width of whitespace between words + + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + Gets the bounds of the box + + + + + Gets the width available on the box, counting padding and margin. + + + + + Gets the right of the box. When setting, it will affect only the width of the box. + + + + + Gets or sets the bottom of the box. + (When setting, alters only the Size.Height of the box) + + + + + Gets the left of the client rectangle (Where content starts rendering) + + + + + Gets the top of the client rectangle (Where content starts rendering) + + + + + Gets the right of the client rectangle + + + + + Gets the bottom of the client rectangle + + + + + Gets the client rectangle + + + + + Gets the actual height + + + + + Gets the actual height + + + + + Gets the actual top's padding + + + + + Gets the actual padding on the left + + + + + Gets the actual Padding of the bottom + + + + + Gets the actual padding on the right + + + + + Gets the actual top's Margin + + + + + The margin top value if was effected by margin collapse. + + + + + Gets the actual Margin on the left + + + + + Gets the actual Margin of the bottom + + + + + Gets the actual Margin on the right + + + + + Gets the actual top border width + + + + + Gets the actual Left border width + + + + + Gets the actual Bottom border width + + + + + Gets the actual Right border width + + + + + Gets the actual top border Color + + + + + Gets the actual Left border Color + + + + + Gets the actual Bottom border Color + + + + + Gets the actual Right border Color + + + + + Gets the actual length of the north west corner + + + + + Gets the actual length of the north east corner + + + + + Gets the actual length of the south east corner + + + + + Gets the actual length of the south west corner + + + + + Gets a value indicating if at least one of the corners of the box is rounded + + + + + Gets the actual width of whitespace between words. + + + + + + Gets the actual color for the text. + + + + + Gets the actual background color of the box + + + + + Gets the second color that creates a gradient for the background + + + + + Gets the actual angle specified for the background gradient + + + + + Gets the actual font of the parent + + + + + Gets the font that should be actually used to paint the text of the box + + + + + Gets the line height + + + + + Gets the text indentation (on first line only) + + + + + Gets the actual horizontal border spacing for tables + + + + + Gets the actual vertical border spacing for tables + + + + + Get the parent of this css properties instance. + + + + + + Gets the height of the font in the specified units + + + + + + Ensures that the specified length is converted to pixels if necessary + + + + + + Set the style/width/color for all 4 borders on the box.
+ if null is given for a value it will not be set. + + optional: the style to set + optional: the width to set + optional: the color to set + + + + Measures the width of whitespace between words (set ). + + + + + Inherits inheritable values from specified box. + + Set to true to inherit all CSS properties instead of only the ineritables + Box to inherit the properties + + + + Helps on CSS Layout. + + + + + Measure image box size by the width\height set on the box and the actual rendered image size.
+ If no image exists for the box error icon will be set. + + the image word to measure + + + + Creates line boxes for the specified blockbox + + + + + + + Applies special vertical alignment for table-cells + + + + + + + Recursively flows the content of the box using the inline model + + Device Info + Blockbox that contains the text flow + Current box to flow its content + Maximum reached right + Space to use between rows of text + x starting coordinate for when breaking lines of text + Current linebox being used + Current x coordinate that will be the left of the next word + Current y coordinate that will be the top of the next word + Maximum right reached so far + Maximum bottom reached so far + + + + Adjust the position of absolute elements by letf and top margins. + + + + + Recursively creates the rectangles of the blockBox, by bubbling from deep to outside of the boxes + in the rectangle structure + + + + + Applies vertical and horizontal alignment to words in lineboxes + + + + + + + Applies right to left direction to words + + + + + + + Applies RTL direction to all the words on the line. + + the line to apply RTL to + + + + Applies RTL direction to specific box words on the line. + + + + + + + Applies vertical alignment to the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies right alignment to the text on the linebox + + + + + + + Simplest alignment, just arrange words. + + + + + + + Layout engine for tables executing the complex layout of tables with rows/columns/headers/etc. + + + + + the main box of the table + + + + + + + + + + collection of all rows boxes + + + + + collection of all columns boxes + + + + + + + + + + Init. + + + + + + Get the table cells spacing for all the cells in the table.
+ Used to calculate the spacing the table has in addition to regular padding and borders. + + the table box to calculate the spacing for + the calculated spacing + + + + + + + + + + + Analyzes the Table and assigns values to this CssTable object. + To be called from the constructor + + + + + Get the table boxes into the proper fields. + + + + + Insert EmptyBoxes for vertical cell spanning. + + + + + Determine Row and Column Count, and ColumnWidths + + + + + + + + + + + + While table width is larger than it should, and width is reductable.
+ If table max width is limited by we need to lower the columns width even if it will result in clipping
+ + + + + Check for minimum sizes (increment widths if necessary) + + + + + Layout the cells by the calculated table layout + + + + + + Gets the spanned width of a cell (With of all columns it spans minus one). + + + + + Gets the cell column index checking its position and other cells colspans + + + + + + + + Gets the cells width, taking colspan and being in the specified column + + + + + + + + Gets the colspan of the specified box + + + + + + Gets the rowspan of the specified box + + + + + + Recursively measures words inside the box + + the box to measure + Device to use + + + + Tells if the columns widths can be reduced, + by checking the minimum widths of all cells + + + + + + Tells if the specified column can be reduced, + by checking its minimum width + + + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Calculate the min and max width for each column of the table by the content in all rows.
+ the min width possible without clipping content
+ the max width the cell content can take without wrapping
+ + if to measure only columns that have no calculated width + return the min width for each column - the min width possible without clipping content + return the max width for each column - the max width the cell content can take without wrapping + + + + Gets the width available for cells + + + + It takes away the cell-spacing from + + + + + Gets the current sum of column widths + + + + + + Gets the span attribute of the tag of the specified box + + + + + + Gets the minimum width of each column + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual vertical spacing of the table + + + + + Represents and gets info about a CSS Length + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + Creates a new CssLength from a length specified on a CSS style sheet or fragment + + Length as specified in the Style Sheet or style fragment + + + + Gets the number in the length + + + + + Gets if the length has some parsing error + + + + + Gets if the length represents a precentage (not actually a length) + + + + + Gets if the length is specified in relative units + + + + + Gets the unit of the length + + + + + Gets the length as specified in the string + + + + + If length is in Ems, returns its value in points + + Em size factor to multiply + Points size of this em + If length has an error or isn't in ems + + + + If length is in Ems, returns its value in pixels + + Pixel size factor to multiply + Pixels size of this em + If length has an error or isn't in ems + + + + Returns the length formatted ready for CSS interpreting. + + + + + + Represents a line of text. + + + To learn more about line-boxes see CSS spec: + http://www.w3.org/TR/CSS21/visuren.html + + + + + Creates a new LineBox + + + + + Gets a list of boxes related with the linebox. + To know the words of the box inside this linebox, use the method. + + + + + Gets the words inside the linebox + + + + + Gets the owner box + + + + + Gets a List of rectangles that are to be painted on this linebox + + + + + Get the height of this box line (the max height of all the words) + + + + + Get the bottom of this box line (the max bottom of all the words) + + + + + Lets the linebox add the word an its box to their lists if necessary. + + + + + + Return the words of the specified box that live in this linebox + + + + + + + Updates the specified rectangle of the specified box. + + + + + + + + + + Copies the rectangles to their specified box + + + + + Sets the baseline of the words of the specified box to certain height + + Device info + box to check words + baseline + + + + Check if the given word is the last selected word in the line.
+ It can either be the last word in the line or the next word has no selection. + + the word to check + + + + + Returns the words of the linebox + + + + + + Represents a word inside an inline box + + + Because of performance, words of text are the most atomic + element in the project. It should be characters, but come on, + imagine the performance when drawing char by char on the device.
+ It may change for future versions of the library. + + + + + the CSS box owner of the word + + + + + Rectangle + + + + + If the word is selected this points to the selection handler for more data + + + + + Init. + + the CSS box owner of the word + + + + Gets the Box where this word belongs. + + + + + Gets or sets the bounds of the rectangle + + + + + Left of the rectangle + + + + + Top of the rectangle + + + + + Width of the rectangle + + + + + Get the full width of the word including the spacing. + + + + + Gets the actual width of whitespace between words. + + + + + Height of the rectangle + + + + + Gets or sets the right of the rectangle. When setting, it only affects the Width of the rectangle. + + + + + Gets or sets the bottom of the rectangle. When setting, it only affects the Height of the rectangle. + + + + + If the word is selected this points to the selection handler for more data + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + is the word is currently selected + + + + + the selection start index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the word is partially selected (-1 if not selected or fully selected) + + + + + Gets or sets an offset to be considered in measurements + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + the image object if it is image word (can be null if not loaded) + + + + + the image rectangle restriction as returned from image load event + + + + + Creates a new BoxWord which represents an image + + the CSS box owner of the word + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + the image rectange restriction as returned from image load event + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + The word text + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Init. + + the CSS box owner of the word + the word chars + was there a whitespace before the word chars (before trim) + was there a whitespace after the word chars (before trim) + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + Represents this word for debugging purposes + + + + + + Used to make space on vertical cell combination + + + + + the index of the row where box starts + + + + + the index of the row where box ends + + + + + Gets the index of the row where box starts + + + + + Gets the index of the row where box ends + + + + + Represents the possible units of the CSS lengths + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + CSS boxes that have ":hover" selector on them. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + Init. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + the name of the html tag + + + + + if the tag is single placed; in other words it doesn't have a separate closing tag; + + + + + collection of attributes and their value the html tag has + + + + + Init. + + the name of the html tag + if the tag is single placed; in other words it doesn't have a separate closing tag; + collection of attributes and their value the html tag has + + + + Gets the name of this tag + + + + + Gets collection of attributes and their value the html tag has + + + + + Gets if the tag is single placed; in other words it doesn't have a separate closing tag;
+ e.g. <br> + + + + + is the html tag has attributes. + + true - has attributes, false - otherwise + + + + Gets a boolean indicating if the attribute list has the specified attribute + + attribute name to check if exists + true - attribute exists, false - otherwise + + + + Get attribute value for given attribute name or null if not exists. + + attribute name to get by + optional: value to return if attribute is not specified + attribute value or null if not found + + + + Represents a block of CSS property values.
+ Contains collection of key-value pairs that are CSS properties for specific css class.
+ Css class can be either custom or html tag name. + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + the name of the css class of the block + + + + + the CSS block properties and values + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + is the css block has :hover pseudo-class + + + + + Creates a new block from the block's source + + the name of the css class of the block + the CSS block properties and values + optional: additional selectors to used in hierarchy + optional: is the css block has :hover pseudo-class + + + + the name of the css class of the block + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + Gets the CSS block properties and its values + + + + + is the css block has :hover pseudo-class + + + + + Merge the other block properties into this css block.
+ Other block properties can overwrite this block properties. + + the css block to merge with + + + + Create deep copy of the CssBlock. + + new CssBlock with same data + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Check if the selectors of the css blocks is the same. + + the other block to compare to + true - the selectors on blocks are the same, false - otherwise + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Serves as a hash function for a particular type. + + A hash code for the current . + + + + Returns a that represents the current . + + + + + Holds single class selector in css block hierarchical selection (p class1 > div.class2) + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Creates a new block from the block's source + + the name of the css class of the block + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Returns a that represents the current . + + + + + Controls the way styles are generated when html is generated. + + + + + styles are not generated at all + + + + + style are inserted in style attribute for each html tag + + + + + style section is generated in the head of the html + + + + + Callback used in to allow setting image externally and async.
+ The callback can provide path to image file path, URL or the actual image to use.
+ If is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + the image to use + optional: limit to specific rectangle in the loaded image + + + + Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and + provide file path to load the image from. Can also use the asynchronous image overwrite not to block HTML rendering is applicable.
+ If no alternative data is provided the original source will be used.
+ + + + + use to cancel the image loading by html renderer, the provided image will be used. + + + + + the source of the image (file path or uri) + + + + + collection of all the attributes that are defined on the image element + + + + + Callback used to allow setting image externally and async. + + + + + Init. + + the source of the image (file path or Uri) + collection of all the attributes that are defined on the image element + Callback used to allow setting image externally and async. + + + + the source of the image (file path, URL or inline data) + + + + + collection of all the attributes that are defined on the image element or CSS style + + + + + Indicate the image load is handled asynchronously. + Cancel this image loading and overwrite the image asynchronously using callback method.
+ + + + + Callback to overwrite the loaded image with error image.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + the path to the image to load (file path or URL) + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + + + + + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ If imageRectangle is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + + + + + Raised when the user clicks on a link in the html. + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + Init. + + the link href that was clicked + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + + + + + + + Exception thrown when client code subscribed to LinkClicked event thrown exception. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a specified error message. + + The message that describes the error. + + + + Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ It can happen if some async event has occurred that requires re-paint and re-layout of the html.
+ Example: async download of image is complete. + + + + + is re-layout is required for the refresh + + + + + Init. + + is re-layout is required for the refresh + + + + is re-layout is required for the refresh + + + + + + + + + + + Raised when an error occurred during html rendering. + + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + Init. + + the type of error to report + the error message + optional: the exception that occurred + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + + + + + + + Enum of possible error types that can be reported. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + the location to scroll to + + + + + Init. + + the location to scroll to + + + + the x location to scroll to + + + + + the x location to scroll to + + + + + + + + + + + Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Init. + + the source of the image (file path or URL) + collection of all the attributes that are defined on the image element + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Holds data on link element in HTML.
+ Used to expose data outside of HTML Renderer internal structure. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Init. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Is the link is directed to another element in the html + + + + + Return the id of the element this anchor link is referencing. + + + + + + + + + + + Contains all the paint code to paint different background images. + + + + + Draw the background image of the given box in the given rectangle.
+ Handle background-repeat and background-position values. + + the device to draw into + the box to draw its background image + the handler that loads image to draw + the rectangle to draw image in + + + + Get top-left location to start drawing the image at depending on background-position value. + + the background-position value + the rectangle to position image in + the size of the image + the top-left location + + + + Draw the background image at the required location repeating it over the X axis.
+ Adjust location to left if starting location doesn't include all the range (adjusted to center or right). + + + + + Draw the background image at the required location repeating it over the Y axis.
+ Adjust location to top if starting location doesn't include all the range (adjusted to center or bottom). + + + + + Draw the background image at the required location repeating it over the X and Y axis.
+ Adjust location to left-top if starting location doesn't include all the range (adjusted to center or bottom/right). + + + + + Contains all the complex paint code to paint different style borders. + + + + + used for all border paint to use the same points and not create new array each time. + + + + + Draws all the border of the box with respect to style, width, etc. + + the device to draw into + the box to draw borders for + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Draw simple border. + + Desired border + the device to draw to + Box which the border corresponds + the brush to use + the bounding rectangle to draw in + Beveled border path, null if there is no rounded corners + + + + Draw specific border (top/bottom/left/right) with the box data (style/width/rounded).
+ + desired border to draw + the box to draw its borders, contain the borders data + the device to draw into + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + + + + Set rectangle for inset/outset border as it need diagonal connection to other borders. + + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + Beveled border path, null if there is no rounded corners + + + + Makes a border path for rounded borders.
+ To support rounded dotted/dashed borders we need to use arc in the border path.
+ Return null if the border is not rounded.
+ + the device to draw into + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Beveled border path, null if there is no rounded corners + + + + Get pen to be used for border draw respecting its style. + + + + + Get the border color for the given box border. + + + + + Get the border width for the given box border. + + + + + Get the border style for the given box border. + + + + + Makes the specified color darker for inset/outset borders. + + + + + Handle context menu. + + + + + select all text + + + + + copy selected text + + + + + copy the link source + + + + + open link (as left mouse click) + + + + + copy the source of the image + + + + + copy image to clipboard + + + + + save image to disk + + + + + open video in browser + + + + + copy video url to browser + + + + + the selection handler linked to the context menu handler + + + + + the html container the handler is on + + + + + the last context menu shown + + + + + the control that the context menu was shown on + + + + + the css rectangle that context menu shown on + + + + + the css link box that context menu shown on + + + + + Init context menu items strings. + + + + + Init. + + the selection handler linked to the context menu handler + the html container the handler is on + + + + Show context menu clicked on given rectangle. + + the parent control to show the context menu on + the rectangle that was clicked to show context menu + the link that was clicked to show context menu on + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Dispose of the last used context menu. + + + + + Handle link click. + + + + + Copy the href of a link to clipboard. + + + + + Open save as dialog to save the image + + + + + Copy the image source to clipboard. + + + + + Copy image object to clipboard. + + + + + Copy selected text. + + + + + Select all text. + + + + + Utilities for fonts and fonts families handling. + + + + + + + + + + Allow to map not installed fonts to different + + + + + collection of all installed and added font families to check if font exists + + + + + cache of all the font used not to create same font again and again + + + + + Init. + + + + + Check if the given font family exists by name + + the font to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get cached font instance for the given font properties.
+ Improve performance not to create same font multiple times. + + cached font instance + + + + Get cached font if it exists in cache or null if it is not. + + + + + create font (try using existing font family to support custom fonts) + + + + + Handler for all loading image logic.
+

+ Loading by .
+ Loading by file path.
+ Loading by URI.
+

+ + + + Supports sync and async image loading. + + + If the image object is created by the handler on calling dispose of the handler the image will be released, this + makes release of unused images faster as they can be large.
+ Disposing image load handler will also cancel download of image from the web. + + + + + + the container of the html to handle load image for + + + + + callback raised when image load process is complete with image or without + + + + + the web client used to download image from URL (to cancel on dispose) + + + + + Must be open as long as the image is in use + + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + to know if image load event callback was sync or async raised + + + + + flag to indicate if to release the image object on box dispose (only if image was loaded by the box) + + + + + is the handler has been disposed + + + + + Init. + + the container of the html to handle load image for + callback raised when image load process is complete with image or without + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + Set image of this image box by analyzing the src attribute.
+ Load the image from inline base64 encoded string.
+ Or from calling property/method on the bridge object that returns image or URL to image.
+ Or from file path
+ Or from URI. + + + File path and URI image loading is executed async and after finishing calling + on the main thread and not thread-pool. + + the source of the image to load + the collection of attributes on the element to use in event + the image object (null if failed) + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set the image using callback from load image event, use the given data. + + the path to the image to load (file path or uri) + the image to load + optional: limit to specific rectangle of the image and not all of it + + + + Load the image from inline base64 encoded string data. + + the source that has the base64 encoded image + + + + Extract image object from inline base64 encoded data in the src of the html img element. + + the source that has the base64 encoded image + image from base64 data string or null if failed + + + + Load image from path of image file or URL. + + the file path or uri to load image from + + + + Load the image file on thread-pool thread and calling after. + + the file path to get the image from + + + + Load the image file on thread-pool thread and calling after.
+ Calling on the main thread and not thread-pool. + + the file path to get the image from + + + + Load image from the given URI by downloading it.
+ Create local file name in temp folder from the URI, if the file already exists use it as it has already been downloaded. + If not download the file using . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + key value pair of URL and file info to download the file to + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + Flag image load complete and request refresh for re-layout and invalidate. + + + + + Release the image and client objects. + + + + + Handler for text selection in the html. + + + + + the root of the handled html tree + + + + + handler for showing context menu on right click + + + + + the mouse location when selection started used to ignore small selections + + + + + the starting word of html selection
+ where the user started the selection, if the selection is backwards then it will be the last selected word. + + + + + the ending word of html selection
+ where the user ended the selection, if the selection is backwards then it will be the first selected word. + + + + + the selection start index if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + is the selection goes backward in the html, the starting word comes after the ending word in DFS traversing.
+ + + + + used to ignore mouse up after selection + + + + + current selection process is after double click (full word selection) + + + + + used to know if selection is in the control or started outside so it needs to be ignored + + + + + used to handle drag and drop + + + + + is the cursor on the control has been changed by the selection handler + + + + + used to know if double click selection is requested + + + + + used to know if drag and drop was already started not to execute the same operation over + + + + + Init. + + the root of the handled html tree + + + + Select all the words in the html. + + the control hosting the html to invalidate + + + + Select the word at the given location if found. + + the control hosting the html to invalidate + the location to select word at + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse on the html + + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + is the left mouse button has been released + is the mouse up should be ignored + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse on the html + + + + On mouse leave change the cursor back to default. + + the control hosting the html to set cursor and invalidate + + + + Copy the currently selected html segment to clipboard.
+ Copy rich html text and plain text. + + + + + Get the currently selected text segment in the html.
+ + + + + Copy the currently selected html segment with style.
+ + + + + The selection start index if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start index for + data value or -1 if not applicable + + + + The selection end index if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end index for + + + + The selection start offset if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start offset for + + + + The selection end offset if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end offset for + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Handle html text selection by mouse move over the html with left mouse button pressed.
+ Calculate the words in the selected range and set their selected property. + + the control hosting the html to invalidate + the mouse location + true - partial word selection allowed, false - only full words selection + + + + Clear the current selection. + + + + + Clear the selection from all the words in the css box recursively. + + the css box to selectionStart clear at + + + + Start drag and drop operation on the currently selected html segment. + + the control to start the drag and drop on + + + + Select all the words that are under DOM hierarchy.
+ + the box to start select all at + + + + Check if the current selection is non empty, has some selection data. + + + true - partial word selection allowed, false - only full words selection + true - is non empty selection, false - empty selection + + + + Select all the words that are between word and word in the DOM hierarchy.
+ + the root of the DOM sub-tree the selection is in + selection start word limit + selection end word limit + + + + Select all the words that are between word and word in the DOM hierarchy. + + the current traversal node + selection start word limit + selection end word limit + used to know the traversal is currently in selected range + + + + + Calculate the character index and offset by characters for the given word and given offset.
+ . + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + to set the starting or ending char and offset data + + + + Calculate the character index and offset by characters for the given word and given offset.
+ If the location is below the word line then set the selection to the end.
+ If the location is to the right of the word then set the selection to the end.
+ If the offset is to the left of the word set the selection to the beginning.
+ Otherwise calculate the width of each substring to find the char the location is on. + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + is to include the first character in the calculation + return the index of the char under the location + return the offset of the char under the location + + + + Check if the selection direction is forward or backward.
+ Is the selection start word is before the selection end word in DFS traversal. + + + + + Handler for loading a stylesheet data. + + + + + Load stylesheet data from the given source.
+ The source can be local file or web URI.
+ First raise event to allow the client to overwrite the stylesheet loading.
+ If the stylesheet is downloaded from URI we will try to correct local URIs to absolute.
+ + the container of the html to handle load stylesheet for + the source of the element to load the stylesheet by + the attributes of the link element + return the stylesheet string that has been loaded (null if failed or is given) + return stylesheet data object that was provided by overwrite (null if failed or is given) + + + + Load stylesheet string from given source (file path or uri). + + the container of the html to handle load stylesheet for + the file path or uri to load the stylesheet from + the stylesheet string + + + + Load the stylesheet from local file by given path. + + the container of the html to handle load stylesheet for + the stylesheet file to load + the loaded stylesheet string + + + + Load the stylesheet from uri by downloading the string. + + the container of the html to handle load stylesheet for + the uri to download from + the loaded stylesheet string + + + + Make relative URLs absolute in the stylesheet using the URI of the stylesheet. + + the stylesheet to correct + the stylesheet uri to use to create absolute URLs + Corrected stylesheet + + + + Low level handling of Html Renderer logic.
+ Allows html layout and rendering without association to actual control, those allowing to handle html rendering on any graphics object.
+ Using this class will require the client to handle all propagation's of mouse/keyboard events, layout/paint calls, scrolling offset, + location/size/rectangle handling and UI refresh requests.
+ + + + MaxSize and ActualSize:
+ The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can exceed the max size by layout restrictions (unwrap-able line, set image size, etc.).
+ Set zero for unlimited (width/height separately).
+ + + ScrollOffset:
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ Element that is rendered at location (50,100) with offset of (0,200) will not be rendered + at -100, therefore outside the client rectangle. + + + LinkClicked event
+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link to overwrite by custom logic.
+ If error occurred in event handler it will propagate up the stack. + + + StylesheetLoad event:
+ Raised when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + ImageLoad event:
+ Raised when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ + + Refresh event:
+ Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + RenderError event:
+ Raised when an error occurred during html rendering.
+ + + + + + + + + + + + + + + + parser for CSS data + + + + + the root css box of the parsed html + + + + + list of all css boxes that have ":hover" selector on them + + + + + Handler for text selection in the html. + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + the parsed stylesheet data used for handling the html + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled (default - true) + + + + + Gets or sets a value indicating if anti-aliasing should be avoided + for geometry like backgrounds and borders + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ + + + + the top-left most location of the rendered html + + + + + the max width and height of the rendered html, effects layout, actual size cannot exceed this values.
+ Set zero for unlimited.
+ + + + + Gets or sets the scroll offset of the document for scroll controls + + + + + The actual size of the rendered html (after layout) + + + + + Init. + + + + + + + + + + parser for CSS data + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrapable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + the root css box of the parsed html + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + + + + + + + Clear the content of the HTML container releasing any resources used to render previously existing content. + + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given device. + + the device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the location of the mouse + the mouse event data + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + Raise the stylesheet load event with the given event args. + + the event args + + + + Raise the image load event with the given event args. + + the event args + + + + Request invalidation and re-layout of the control hosting the renderer. + + is re-layout is required for the refresh + + + + Report error in html render process. + + the type of error to report + the error message + optional: the exception that occured + + + + Handle link clicked going over event and using if not canceled. + + the control hosting the html to invalidate + the location of the mouse + the link that was clicked + + + + Add css box that has ":hover" selector to be handled on mouse hover. + + the box that has the hover selector + the css block with the css data with the selector + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Adjust the offset of the given location by the current scroll offset. + + the location to adjust + the adjusted location + + + + Check if the mouse is currently on the html container.
+ Relevant if the html container is not filled in the hosted control (location is not zero and the size is not the full size of the control). + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + General utilities. + + + + + Measure the size of the html by performing layout under the given restrictions. + + the graphics to use + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Perform the layout of the html container by given size restrictions returning the final size.
+ The layout can be effected by the HTML content in the if or + is set to true.
+ Handle minimum and maximum size restrictions.
+ Handle auto size and auto size for height only. if is true + is ignored.
+ + the graphics used for layout + the html container to layout + the current size + the min size restriction - can be empty for no restriction + the max size restriction - can be empty for no restriction + if to modify the size (width and height) by html content layout + if to modify the height by html content layout + + + + Parser to parse CSS stylesheet source string into CSS objects. + + + + + split CSS rule + + + + + + + + + + Utility for value parsing. + + + + + The chars to trim the css class name by + + + + + Init. + + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + raw css stylesheet to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the CSS data with parsed CSS objects (never null) + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ The parsed css blocks are added to the given css data, merged if class name already exists. + + the CSS data to fill with parsed CSS objects + raw css stylesheet to parse + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the font-family value to parse + parsed font-family value + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + color value + + + + Remove comments from the given stylesheet. + + the stylesheet to remove comments from + stylesheet without comments + + + + Parse given stylesheet for CSS blocks
+ This blocks are added under the "all" keyword. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Parse given stylesheet for media CSS blocks
+ This blocks are added under the specific media block they are found. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Feeds the style with a block about the specific media.
+ When no media is specified, "all" will be used. + + + the CSS block to handle + optional: the media (default - all) + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse css block selector to support hierarchical selector (p class1 > class2). + + the class selector to parse + return the main class the css block is on + returns the hierarchy of classes or null if single class selector + + + + Parse the properties of the given css block into a key-value dictionary. + + the raw css block to parse + dictionary with parsed css block properties + + + + Add the given property to the given properties collection, if the property is complex containing + multiple css properties then parse them and add the inner properties. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse length property to add only valid lengths. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse color property to add only valid color. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse a complex font property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + + + the value of the property to parse + parsed value + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the value of the property to parse + parsed font-family value + + + + Parse a complex border property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the left, top, right or bottom direction of the border to parse + the properties collection to add the specific properties to + + + + Parse a complex margin property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border style property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border width property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border color property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex padding property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Split multi direction value into the proper direction values (left, top, right, bottom). + + + + + Split the value by the specified separator; e.g. Useful in values like 'padding:5 4 3 inherit' + + Value to be splitted + + Splitted and trimmed values + + + + + + + + + + + + + Parse the given substring to extract border width substring. + Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse CSS properties values like numbers, Urls, etc. + + + + + + + + + + Init. + + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid double number, false - otherwise + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid int number, false - otherwise + + + + Check if the given string is a valid length value. + + the string value to check + true - valid, false - invalid + + + + Evals a number and returns it. If number is a percentage, it will be multiplied by hundredPercent + + Number to be parsed + Number that represents the 100% if parsed number is a percentage + Parsed number. Zero if error while parsing. + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + if the length is in pixels and the length is font related it needs to use 72/96 factor + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + if the length is in pixels and the length is font related it needs to use 72/96 factor + Allows the return double to be in points. If false, result will be pixels + the parsed length value with adjustments + + + + Get the unit to use for the length, use default if no unit found in length string. + + + + + Check if the given color string value is valid. + + color string value to parse + true - valid, false - invalid + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + Color value + + + + Parses a color value in CSS style; e.g. #ff0000, RED, RGB(255,0,0), RGB(100%, 0, 0) + + color substring value to parse + substring start idx + substring length + return the parsed color + true - valid color, false - otherwise + + + + Parses a border value in CSS style; e.g. 1px, 1, thin, thick, medium + + + + + + + + Get color by parsing given hex value color string (#A28B34). + + true - valid color, false - otherwise + + + + Get color by parsing given RGB value color string (RGB(255,180,90)) + + true - valid color, false - otherwise + + + + Get color by parsing given RGBA value color string (RGBA(255,180,90,180)) + + true - valid color, false - otherwise + + + + Get color by given name, including .NET name. + + true - valid color, false - otherwise + + + + Parse the given decimal number string to positive int value.
+ Start at given , ignore whitespaces and take + as many digits as possible to parse to int. + + the string to parse + the index to start parsing at + parsed int or 0 + + + + Parse the given decimal number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Parse the given hex number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Handle css DOM tree generation from raw html and stylesheet. + + + + + Parser for CSS + + + + + Init. + + + + + Generate css tree by parsing the given html and applying the given css style data on it. + + the html to parse + the html container to use for reference resolve + the css data to use + the root of the generated tree + + + + Read styles defined inside the dom structure in links and style elements.
+ If the html tag is "style" tag parse it content and add to the css data for all future tags parsing.
+ If the html tag is "link" that point to style data parse it content and add to the css data for all future tags parsing.
+ + the box to parse style data in + the html container to use for reference resolve + the style data to fill with found styles + check if the css data has been modified by the handled html not to change the base css data + + + + Applies style to all boxes in the tree.
+ If the html tag has style defined for each apply that style to the css box of the tag.
+ If the html tag has "class" attribute and the class name has style defined apply that style on the tag css box.
+ If the html tag has "style" attribute parse it and apply the parsed style on the tag css box.
+ + the box to apply the style to + the style data for the html + + + + Set the selected text style (selection text color and background color). + + + the style data + + + + Assigns the given css classes to the given css box checking if matching.
+ Support multiple classes in single attribute separated by whitespace. + + the css box to assign css to + the css data to use to get the matching css blocks + + + + Assigns the given css style blocks to the given css box checking if matching. + + the css box to assign css to + the css data to use to get the matching css blocks + the class selector to search for css blocks + + + + Check if the given css block is assignable to the given css box.
+ the block is assignable if it has no hierarchical selectors or if the hierarchy matches.
+ Special handling for ":hover" pseudo-class.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Check if the given css block is assignable to the given css box by validating the selector.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Assigns the given css style block properties to the given css box. + + the css box to assign css to + the css block to assign + + + + Check if the given style is allowed to be set on the given css box.
+ Used to prevent invalid CssBoxes creation like table with inline display style. + + the css box to assign css to + the style key to cehck + the style value to check + true - style allowed, false - not allowed + + + + Clone css data if it has not already been cloned.
+ Used to preserve the base css data used when changed by style inside html. + + + + + + + + + + + + Converts an HTML length into a Css length + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Execute action on all the "td" cells of the table.
+ Handle if there is "theader" or "tbody" exists. + + the table element + the action to execute + + + + Go over all the text boxes (boxes that have some text that will be rendered) and + remove all boxes that have only white-spaces but are not 'preformatted' so they do not effect + the rendered html. + + the current box to correct its sub-tree + + + + Go over all image boxes and if its display style is set to block, put it inside another block but set the image to inline. + + the current box to correct its sub-tree + + + + Correct the DOM tree recursively by replacing "br" html boxes with anonymous blocks that respect br spec.
+ If the "br" tag is after inline box then the anon block will have zero height only acting as newline, + but if it is after block box then it will have min-height of the font size so it will create empty line. + + the current box to correct its sub-tree + used to know if the br is following a box so it should create an empty line or not so it only + move to a new line + + + + Correct DOM tree if there is block boxes that are inside inline blocks.
+ Need to rearrange the tree so block box will be only the child of other block box. + + the current box to correct its sub-tree + + + + Rearrange the DOM of the box to have block box with boxes before the inner block box and after. + + the box that has the problem + + + + Split bad box that has inline and block boxes into two parts, the left - before the block box + and right - after the block box. + + the parent box that has the problem + the box to split into different boxes + the left block box that is created for the split + + + + Makes block boxes be among only block boxes and all inline boxes have block parent box.
+ Inline boxes should live in a pool of Inline boxes only so they will define a single block.
+ At the end of this process a block box will have only block siblings and inline box will have + only inline siblings. + + the current box to correct its sub-tree + + + + Check if the given box contains only inline child boxes in all subtree. + + the box to check + true - only inline child boxes, false - otherwise + + + + Check if the given box contains inline and block child boxes. + + the box to check + true - has variant child boxes, false - otherwise + + + + + + + + + Parses the source html to css boxes tree structure. + + the html source to parse + + + + Add html text anon box to the current box, this box will have the rendered text
+ Adding box also for text that contains only whitespaces because we don't know yet if + the box is preformatted. At later stage they will be removed if not relevant. + + the html source to parse + the start of the html part + the index of the next html tag + the current box in html tree parsing + + + + Parse the html part, the part from prev parsing index to the beginning of the next html tag.
+ + the html source to parse + the index of the next html tag + the current box in html tree parsing + the end of the parsed part, the new start index + + + + Parse raw html tag source to object.
+ Extract attributes found on the tag. + + the html source to parse + the start index of the tag in the source + the length of the tag from the start index in the source + return the name of the html tag + return the dictionary of tag attributes + true - the tag is closing tag, false - otherwise + + + + Extract html tag attributes from the given sub-string. + + the html source to parse + the start index of the tag attributes in the source + the length of the tag attributes from the start index in the source + return the dictionary of tag attributes + + + + Collection of regular expressions used when parsing + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + Static class that contains argument-checking methods + + + + + Validate given condition is true, otherwise throw exception. + + Exception type to throw. + Condition to assert. + Exception message in-case of assert failure. + + + + Validate given argument isn't Null. + + argument to validate + Name of the argument checked + if is Null + + + + Validate given argument isn't . + + argument to validate + Name of the argument checked + if is + + + + Validate given argument isn't Null or empty. + + argument to validate + Name of the argument checked + if is Null or empty + + + + Validate given argument isn't Null. + + Type expected of arg + argument to validate + Name of the argument checked + if is Null + arg cast as T + + + + Validate given argument isn't Null or empty AND argument value is the path of existing file. + + argument to validate + Name of the argument checked + if is Null or empty + if arg file-path not exist + + + + Utility methods for general stuff. + + + + + Table to convert numbers into roman digits + + + + + Check if the given char is of Asian range. + + the character to check + true - Asian char, false - otherwise + + + + Check if the given char is a digit character (0-9) and (0-9, a-f for HEX) + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Convert the given char to digit. + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Get size that is max of and for width and height separately. + + + + + Get Uri object for the given path if it is valid uri path. + + the path to get uri for + uri or null if not valid + + + + Get the first value in the given dictionary. + + the type of dictionary key + the type of dictionary value + the dictionary + optional: the default value to return of no elements found in dictionary + first element or default value + + + + Get file info object for the given path if it is valid file path. + + the path to get file info for + file info or null if not valid + + + + Get web client response content type. + + the web client to get the response content type from + response content type or null + + + + Gets the representation of the online uri on the local disk. + + The online image uri. + The path of the file on the disk. + + + + Get substring seperated by whitespace starting from the given idex. + + the string to get substring in + the index to start substring search from + return the length of the found string + the index of the substring, -1 if no valid sub-string found + + + + Compare that the substring of is equal to + Assume given substring is not empty and all indexes are valid!
+ + true - equals, false - not equals + + + + Replaces invalid filename chars to '_' + + The possibly-not-valid filename + A valid filename. + + + + Convert number to alpha numeric system by the requested style (UpperAlpha, LowerRoman, Hebrew, etc.). + + the number to convert + the css style to convert by + converted string + + + + Convert the given integer into alphabetic numeric format (D, AU, etc.) + + the number to convert + is to use lowercase + the roman number string + + + + Convert the given integer into alphabetic numeric format (alpha, AU, etc.) + + the number to convert + the roman number string + + + + Convert the given integer into roman numeric format (II, VI, IX, etc.) + + the number to convert + if to use lowercase letters for roman digits + the roman number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + String constants to avoid typing errors. + + + + + Centimeters + + + + + Millimeters + + + + + Pixels + + + + + Inches + + + + + Em - The font size of the relevant font + + + + + The 'x-height' of the relevan font + + + + + Points + + + + + Picas + + + + + Default font size in points. Change this value to modify the default font size. + + + + + Default font used for the generic 'serif' family + + + + + Utility method for handling CSS stuff. + + + + + Brush for selection background + + + + + Brush for selection background + + + + + Gets the white space width of the specified box + + + + + + + + Get CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to get it's property value + the name of the CSS property + the value of the property, null if no such property exists + + + + Set CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to set it's property value + the name of the CSS property + the value to set + + + + Utility class for traversing DOM structure and execution stuff on it. + + + + + Check if the given location is inside the given box deep.
+ Check inner boxes and all lines that the given box spans to. + + the box to check + the location to check + true - location inside the box, false - otherwise + + + + Check if the given box contains only inline child boxes. + + the box to check + true - only inline child boxes, false - otherwise + + + + Recursively searches for the parent with the specified HTML Tag name + + + + + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + fix word space for first word in inline tag. + + the box to check + + + + Gets the next sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Get attribute value by given key starting search from given box, search up the tree until + attribute found or root. + + the box to start lookup at + the attribute to get + the value of the attribute or null if not found + + + + Get css box under the given sub-tree at the given x,y location, get the inner most.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + Optional: if to get only visible boxes (default - true) + css link box if exists or null + + + + Collect all link boxes found in the HTML tree. + + the box to start search from + collection to add all link boxes to + + + + Get css link box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + css link box if exists or null + + + + Get css box under the given sub-tree with the given id.
+ + the box to start search from + the id to find the box by + css box if exists or null + + + + Get css line box under the given sub-tree at the given y location or the nearest line from the top.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the line box to search in + the location to find the box at + css word box if exists or null + + + + Find the css line box that the given word is in. + + the word to search for it's line box + line box that the word is in + + + + Get selected plain text of the given html sub-tree. + + the DOM box to get selected text from its sub-tree + the selected plain text string + + + + Generate html from the given DOM tree.
+ Generate all the style inside the html, in header or for every tag depending on value. + + the box of the html generate html from + Optional: controls the way styles are generated when html is generated + Optional: true - generate only selected html subset, false - generate all (default - false) + generated html + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the root to generate tree from + generated tree + + + + Get selected plain text of the given html sub-tree.
+ Append all the selected words. + + the builder to append the selected text to + the DOM box to get selected text from its sub-tree + the index of the last word appended + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ + the box to check its sub-tree + the collection to add the selected tags to + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ Use to handle boxes that are between selected words but don't have selected word inside.
+ + the box to check its sub-tree + the hash to add the selected boxes to + used to handle boxes that are between selected words but don't have selected word inside + is the current box is in selected sub-tree + + + + find the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + the root of the boxes tree + the selected boxes to find selection root in + the box that is the root of selected boxes + + + + Check if the given box has a names child box (has html tag) recursively. + + the box to check + true - in sub-tree there is a named box, false - otherwise + + + + Write the given html DOM sub-tree into the given string builder.
+ If are given write html only from those tags. + + used to parse CSS data + the string builder to write html into + the html sub-tree to write + Controls the way styles are generated when html is generated + Control if to generate only selected boxes, if given only boxes found in hash will be generated + the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + + + Write the given html tag with all its attributes and styles. + + used to parse CSS data + the string builder to write html into + the css box with the html tag to write + Controls the way styles are generated when html is generated + + + + Clean the given style collection by removing default styles so only custom styles remain.
+ Return new collection where the old remains unchanged. + + the box the styles apply to, used to know the default style + the collection of styles to clean + new cleaned styles collection + + + + Write stylesheet data inline into the html. + + the string builder to write stylesheet into + the css data to write to the head + + + + Get the selected word with respect to partial selected words. + + the word to append + is to get selected text or all the text in the word + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the box to generate for + the string builder to generate to + the current indent level to set indent of generated text + + + + Defines HTML strings + + + + + List of html tags that don't have content + + + + + the html encode\decode pairs + + + + + the html decode only pairs + + + + + Init. + + + + + Is the given html tag is single tag or can have content. + + the tag to check (must be lower case) + true - is single tag, false - otherwise + + + + Decode html encoded string to regular string.
+ Handles <, >, "&. + + the string to decode + decoded string + + + + Encode regular string into html encoded string.
+ Handles <, >, "&. + + the string to encode + encoded string + + + + Decode html special charecters encoded using char entity code (€) + + the string to decode + decoded string + + + + Decode html special charecters encoded using char entity name + + the string to decode + decoded string + + + + Provides some drawing functionality + + + + + Check if the given color is visible if painted (has alpha and color values) + + the color to check + true - visible, false - not visible + + + + Clip the region the graphics will draw on by the overflow style of the containing block.
+ Recursively travel up the tree to find containing block that has overflow style set to hidden. if not + block found there will be no clipping and null will be returned. + + the graphics to clip + the box that is rendered to get containing blocks + true - was clipped, false - not clipped + + + + Draw image loading icon. + + the device to draw into + + the rectangle to draw icon in + + + + Draw image failed to load icon. + + the device to draw into + + the rectangle to draw icon in + + + + Creates a rounded rectangle using the specified corner radius
+ NW-----NE + | | + | | + SW-----SE + + the device to draw into + Rectangle to round + Radius of the north east corner + Radius of the north west corner + Radius of the south east corner + Radius of the south west corner + GraphicsPath with the lines of the rounded rectangle ready to be painted + + + + Represents sub-string of a full string starting at specific location with a specific length. + + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Init sub-string that is the full string. + + the full string that this sub-string is part of + + + + Init. + + the full string that this sub-string is part of + the start index of the sub-string + the length of the sub-string starting at + is null + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Get string char at specific index. + + the idx to get the char at + char at index + + + + Is the sub-string is empty string. + + true - empty string, false - otherwise + + + + Is the sub-string is empty string or contains only whitespaces. + + true - empty or whitespace string, false - otherwise + + + + Is the sub-string contains only whitespaces (at least one). + + true - empty or whitespace string, false - otherwise + + + + Get a string of the sub-string.
+ This will create a new string object! + + new string that is the sub-string represented by this instance + + + + Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length. + + The zero-based starting character position of a substring in this instance. + The number of characters in the substring. + A String equivalent to the substring of length length that begins at startIndex in this instance, or + Empty if startIndex is equal to the length of this instance and length is zero. + + + + Collection of regular expressions used when parsing + + + + + Extracts CSS style comments; e.g. /* comment */ + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts CSS colors; e.g. black white #fff #fe98cd rgb(5,5,5) rgb(45%, 0, 0) + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts CSS border styles; e.g. solid none dotted + + + + + Extracts CSS border widthe; e.g. 1px thin 3em + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + Extracts HTML tags + + + + + Extracts attributes from a HTML tag; e.g. att=value, att="value" + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + 线条图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + 初始化参数 + + + + + 返回或设置X轴间隔 + + + + + 标题 + + + + + 返回图片的宽度 + + + + + 返回或设置图片的高度 + + + + + X轴的间距 + + + + + Y轴的间距 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 背景颜色 + + + + + X轴的颜色 + + + + + Y轴的颜色 + + + + + 返回X轴数据的最大值(供给Painter调用) + + + + + 返回图片数据 + + + + + 画布 + + + + + 作图器 + + + + + 释放内容资源 + + + + + 获取X轴中的最大值 + + + + + + + 获取所有X轴列中的最大值 + + + + + + + 初始化图片 + + X轴的数据 + + + + + 画一条走势图 + + + + + + 画多条走势图 + + + + + + 作图器的基础类 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 返回此作图器的相关链走势图 + + + + + 获取某值在Y轴上的位置 + + 当前点的值 + 点坐标 + + + + 画XY轴线 + + 画布 + X轴的数据 + + + + 画标题 + + + + + + 画走势线 + + 画布 + X轴数据 + + + + 方块图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图的X轴数据 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + + + 标题 + + + + + 值 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 值的颜色 + + + + + 值的字体 + + + + + 绘制颜色 + + + + + 值是否可见 + + + + + 克隆自身 + + + + + + 定义X轴的数据集合 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + 添加一批数据 + + 轴的标题 + + + + 添加一批数据 + + 轴的标题 + 轴的值 + + + + 重置轴的值 + + 轴的值 + + + + 克隆数据 + + + + + + Indicates the behavior of a key when a cell "on the edge" is being edited. + and the normal behavior of that key would exceed the edge. For example, + for a key that normally moves one column to the left, the "edge" would be + the left most column, since the normal action of the key cannot be taken + (since there are no more columns to the left). + + + + + 按键将被忽略 + + + + + 按键将导致单元格编辑环绕到相对边缘的单元格。 + + + + + 按键将Wrap，但该列将更改为相应的相邻列。这只对正常操作为ChangeRow的键有意义。 + + + + + 按键将Wrap，但该行将更改为相应的相邻行。这只对正常操作为ChangeColumn的键有意义. + + + + + 该键将导致当前编辑操作结束。 + + + + + Indicates the normal behaviour of a key when used during a cell edit + operation. + + + + + The key press will be ignored + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the left. + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the right. + + + + + The key press will end the current edit and begin an edit + operation on the row above. + + + + + The key press will end the current edit and begin an edit + operation on the row below + + + + + The key press will cancel the current edit + + + + + The key press will finish the current edit operation + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Instances of this class handle key presses during a cell edit operation. + + + + + 设置给定键的行为 + + + + + + + + 处理按键操作 + + + + True if the key was completely handled. + + + + Gets or sets the ObjectListView on which the current key is being handled. + This cannot be null. + + + + + Gets the row of the cell that is currently being edited + + + + + Gets the index of the column of the cell that is being edited + + + + + Gets or sets the map that remembers the normal behaviour of keys + + + + + Gets or sets the map that remembers the desired behaviour of keys + on edge cases. + + + + + Setup the default key mapping + + + + + Handle the end edit command + + + + + Handle the cancel edit command + + + + + Placeholder that subclasses can override to handle any custom verbs + + + + + + + + Handle a change row command + + + + + + + Handle a change column command + + + + + + + Start editing the indicated cell if that cell is not already being edited + + The row to edit + The cell within that row to edit + + + + Gets the adjacent item to the given item in the given direction. + If that item is disabled, continue in that direction until an enabled item is found. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more enabled items in that direction. + + + + Gets the adjacent item to the given item in the given direction, wrapping if needed. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more items in that direction. + + + + Gets a collection of columns that are editable in the order they are shown to the user + + + + + These items allow combo boxes to remember a value and its description. + + + + + + + + + + + + + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + This editor shows and auto completes values from the given listview column. + + + + + Create an AutoCompleteCellEditor + + + + + + + This combo box is specialised to allow editing of an enum. + + + + + + + + + + + This editor simply shows and edits integer values. + + + + + + + + + + Gets or sets the value shown by this editor + + + + + This editor simply shows and edits unsigned integer values. + + This class can't be made public because unsigned int is not a + CLS-compliant type. If you want to use, just copy the code to this class + into your project and use it from there. + + + + This editor simply shows and edits boolean values. + + + + + + + + + + This editor simply shows and edits boolean values using a checkbox + + + + + Gets or sets the value shown by this editor + + + + + Gets or sets how the checkbox will be aligned + + + + + This editor simply shows and edits floating point values. + + You can intercept the CellEditStarting event if you want + to change the characteristics of the editor. For example, by increasing + the number of decimal places. + + + + + + + + + Gets or sets the value shown by this editor + + + + + A delegate that creates an editor for the given value + + The model from which that value came + The column for which the editor is being created + A representative value of the type to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A control which can edit the given value + + + + An editor registry gives a way to decide what cell editor should be used to edit + the value of a cell. Programmers can register non-standard types and the control that + should be used to edit instances of that type. + + + All ObjectListViews share the same editor registry. + + + + + Create an EditorRegistry + + + + + Register that values of 'type' should be edited by instances of 'controlType'. + + The type of value to be edited + The type of the Control that will edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), typeof(MySpecialColorEditor)); + + + + + Register the given delegate so that it is called to create editors + for values of the given type + + The type of value to be edited + The delegate that will create a control that can edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), CreateColorEditor); + ... + public Control CreateColorEditor(Object model, OLVColumn column, Object value) + { + return new MySpecialColorEditor(); + } + + + + + Register a delegate that will be called to create an editor for values + that have not been handled. + + The delegate that will create a editor for all other types + + + + Register a delegate that will be given a chance to create a control + before any other option is considered. + + The delegate that will create a control + + + + Remove the registered handler for the given type + + Does nothing if the given type doesn't exist + The type whose registration is to be removed + + + + Create and return an editor that is appropriate for the given value. + Return null if no appropriate editor can be found. + + The model involved + The column to be edited + The value to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A Control that can edit the given type of values + + + + Create and return an editor that will edit values of the given type + + A enum type + + + + A DataListView is a ListView that can be bound to a datasource (which would normally be a DataTable or DataView). + + + This listview keeps itself in sync with its source datatable by listening for change events. + The DataListView will automatically create columns to show all of the data source's columns/properties, if there is not already + a column showing that property. This allows you to define one or two columns in the designer and then have the others generated automatically. + If you don't want any column to be auto generated, set to false. + These generated columns will be only the simplest view of the world, and would look more interesting with a few delegates installed. + This listview will also automatically generate missing aspect getters to fetch the values from the data view. + Changing data sources is possible, but error prone. Before changing data sources, the programmer is responsible for modifying/resetting + the column collection to be valid for the new data source. + Internally, a CurrencyManager controls keeping the data source in-sync with other users of the data source (as per normal .NET + behavior). This means that the model objects in the DataListView are DataRowView objects. If you write your own AspectGetters/Setters, + they will be given DataRowView objects. + + + + + Make a DataListView + + + + + + + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + When a DataSource is set, the control will create OLVColumns to show any + data source columns that are not already shown. + If the DataSource is changed, you will have to remove any previously + created columns, since they will be configured for the previous DataSource. + . + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + Adaptors cannot be shared between controls. Each DataListView needs its own adapter. + + + + + Add the given collection of model objects to this control. + + A collection of model objects + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Insert the given collection of objects before the given position + + Where to insert the objects + The objects to be inserted + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Remove the given collection of model objects from this control. + + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Change the Unfreeze behaviour + + + + + Handles parent binding context changes + + Unused EventArgs. + + + + A DataTreeListView is a TreeListView that calculates its hierarchy based on + information in the data source. + + + Like a , a DataTreeListView sources all its information + from a combination of and . + can be a DataTable, DataSet, + or anything that implements . + + + To function properly, the DataTreeListView requires: + + the table to have a column which holds a unique for the row. The name of this column must be set in . + the table to have a column which holds id of the hierarchical parent of the row. The name of this column must be set in . + a value which identifies which rows are the roots of the tree (). + + The hierarchy structure is determined finding all the rows where the parent key is equal to . These rows + become the root objects of the hierarchy. + + Like a TreeListView, the hierarchy must not contain cycles. Bad things will happen if the data is cyclic. + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. Actually, it can be any value that can + be compared for equality against a basic type. + If this is set to the wrong value (i.e. to a value that no row + has in the parent id column), the list will be empty. + + + + + Gets or sets the value that identifies a row as a root object. + . The RootKeyValue can be of any type, + but the IDE cannot sensibly represent a value of any type, + so this is a typed wrapper around that property. + + + If you want the root value to be something other than a string, + you will have set it yourself. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + An IDragSource controls how drag out from the ObjectListView will behave + + + + + A drag operation is beginning. Return the data object that will be used + for data transfer. Return null to prevent the drag from starting. The data + object will normally include all the selected objects. + + + The returned object is later passed to the GetAllowedEffect() and EndDrag() + methods. + + What ObjectListView is being dragged from. + Which mouse button is down? + What item was directly dragged by the user? There may be more than just this + item selected. + The data object that will be used for data transfer. This will often be a subclass + of DataObject, but does not need to be. + + + + What operations are possible for this drag? This controls the icon shown during the drag + + The data object returned by StartDrag() + A combination of DragDropEffects flags + + + + The drag operation is complete. Do whatever is necessary to complete the action. + + The data object returned by StartDrag() + The value returned from GetAllowedEffects() + + + + A do-nothing implementation of IDragSource that can be safely subclassed. + + + + + See IDragSource documentation + + + + + + + + + See IDragSource documentation + + + + + + + See IDragSource documentation + + + + + + + A reasonable implementation of IDragSource that provides normal + drag source functionality. It creates a data object that supports + inter-application dragging of text and HTML representation of + the dragged rows. It can optionally force a refresh of all dragged + rows when the drag is complete. + + Subclasses can override GetDataObject() to add new + data formats to the data transfer object. + + + + Construct a SimpleDragSource + + + + + Construct a SimpleDragSource that refreshes the dragged rows when + the drag is complete + + + + + + Gets or sets whether the dragged rows should be refreshed when the + drag operation is complete. + + + + + Create a DataObject when the user does a left mouse drag operation. + See IDragSource for further information. + + + + + + + + + Which operations are allowed in the operation? By default, all operations are supported. + + + All opertions are supported + + + + The drag operation is finished. Refreshe the dragged rows if so configured. + + + + + + + Create a data object that will be used to as the data object + for the drag operation. + + + Subclasses can override this method add new formats to the data object. + + The ObjectListView that is the source of the drag + A data object for the drag + + + + Objects that implement this interface can acts as the receiver for drop + operation for an ObjectListView. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Should the drag be allowed to continue? + + + + + + This is a do-nothing implementation of IDropSink that is a useful + base class for more sophisticated implementations. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Change the cursor to reflect the current drag operation. + + You only need to override this if you want non-standard cursors. + The standard cursors are supplied automatically. + + + + + Should the drag be allowed to continue? + + + You only need to override this if you want the user to be able + to end the drop in some non-standard way, e.g. dragging to a + certain point even without releasing the mouse, or going outside + the bounds of the application. + + + + + + This is called when the mouse leaves the drop region and after the + drop has completed. + + + + + The enum indicates which target has been found for a drop operation + + + + + No applicable target has been found + + + + + The list itself is the target of the drop + + + + + An item is the target + + + + + Between two items (or above the top item or below the bottom item) + can be the target. This is not actually ever a target, only a value indicate + that it is valid to drop between items + + + + + Above an item is the target + + + + + Below an item is the target + + + + + A subitem is the target of the drop + + + + + On the right of an item is the target (not currently used) + + + + + On the left of an item is the target (not currently used) + + + + + This class represents a simple implementation of a drop sink. + + + Actually, it should be called CleverDropSink -- it's far from simple and can do quite a lot in its own right. + + + + + Make a new drop sink + + + + + Get or set the locations where a drop is allowed to occur (OR-ed together) + + + + + Gets or sets whether this sink allows model objects to be dragged from other lists. Defaults to true. + + + + + Gets or sets whether the ObjectListView should scroll when the user drags + something near to the top or bottom rows. Defaults to true. + + AutoScroll does not scroll horizontally. + + + + Gets the billboard overlay that will be used to display feedback + messages during a drag operation. + + Set this to null to stop the feedback. + + + + Get or set whether a drop can occur between items of the list + + + + + Get or set whether a drop can occur on the listview itself + + + + + Get or set whether a drop can occur on items in the list + + + + + Get or set whether a drop can occur on a subitem in the list + + + + + Gets or sets whether the drop sink should draw feedback onto the given list + during the drag operation. Defaults to true. + + If this is false, you will have to give the user feedback in some + other fashion, like cursor changes + + + + Get or set the index of the item that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get or set the color that will be used to provide drop feedback + + + + + Get whether the alt key was down during this drop event + + + + + Get whether any modifier key was down during this drop event + + + + + Get whether the control key was down during this drop event + + + + + Get whether the left mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the shift key was down during this drop event + + + + + Get or set the state of the keys during this drop event + + + + + Gets or sets whether the drop sink will automatically use cursors + based on the drop effect. By default, this is true. If this is + set to false, you must set the Cursor yourself. + + + + + Triggered when the sink needs to know if a drop can occur. + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + + + + + Triggered when the sink needs to know if a drop can occur + AND the source is an ObjectListView + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + AND the source is an ObjectListView + + + + + Cleanup the drop sink when the mouse has left the control or + the drag has finished. + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag is moving over this control. + + + + + + Trigger the Dropped events + + + + + + Trigger CanDrop + + + + + + Trigger Dropped + + + + + + Trigger ModelCanDrop + + + + + + Trigger ModelDropped + + + + + + Handle the timer tick event, which is sent when the listview should + scroll + + + + + When the mouse is at the given point, what should the target of the drop be? + + This method should update the DropTarget* members of the given arg block + + The mouse point, in client co-ordinates + + + + What sort of action is possible when the mouse is at the given point? + + + + + + + + + + Based solely on the state of the modifier keys, what drop operation should + be used? + + The drop operation that matches the state of the keys + + + + Should the listview be made to scroll when the mouse is at the given point? + + + + + + Update the state of our sink to reflect the information that + may have been written into the drop event args. + + + + + + Draw the feedback that shows that the background is the target + + + + + + + Draw the feedback that shows that an item (or a subitem) is the target + + + + + DropTargetItem and DropTargetSubItemIndex tells what is the target + + + + + Draw the feedback that shows the drop will occur before target + + + + + + + Draw the feedback that shows the drop will occur after target + + + + + + + Return a GraphicPath that is round corner rectangle. + + + + + + + + Calculate the target rectangle when the given item (and possible subitem) + is the target of the drop. + + + + + + + + Draw a "between items" line at the given co-ordinates + + + + + + + + + + This drop sink allows items within the same list to be rearranged, + as well as allowing items to be dropped from other lists. + + + + This class can only be used on plain ObjectListViews and FastObjectListViews. + The other flavours have no way to implement the insert operation that is required. + + + This class does not work with grouping. + + + This class works when the OLV is sorted, but it is up to the programmer + to decide what rearranging such lists "means". Example: if the control is sorting + students by academic grade, and the user drags a "Fail" grade student up amonst the "A+" + students, it is the responsibility of the programmer to makes the appropriate changes + to the model and redraw/rebuild the control so that the users action makes sense. + + + Users of this class should listen for the CanDrop event to decide + if models from another OLV can be moved to OLV under this sink. + + + + + + Create a RearrangingDropSink + + + + + Create a RearrangingDropSink + + + + + + Trigger OnModelCanDrop + + + + + + Trigger OnModelDropped + + + + + + Do the work of processing the dropped items + + + + + + When a drop sink needs to know if something can be dropped, or + to notify that a drop has occured, it uses an instance of this class. + + + + + Create a OlvDropEventArgs + + + + + Get the original drag-drop event args + + + + + Get the data object that is being dragged + + + + + Get the drop sink that originated this event + + + + + Get or set the index of the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the drag effect that should be used for this operation + + + + + Get or set if this event was handled. No further processing will be done for a handled event. + + + + + Get or set the feedback message for this operation + + + If this is not null, it will be displayed as a feedback message + during the drag. + + + + + Get the ObjectListView that is being dropped on + + + + + Get the location of the mouse (in target ListView co-ords) + + + + + Get the drop action indicated solely by the state of the modifier keys + + + + + These events are triggered when the drag source is an ObjectListView. + + + + + Create a ModelDropEventArgs + + + + + Gets the model objects that are being dragged. + + + + + Gets the ObjectListView that is the source of the dragged objects. + + + + + Get the model object that is being dropped upon. + + This is only value for TargetLocation == Item + + + + Refresh all the objects involved in the operation + + + + + A data transfer object that knows how to transform a list of model + objects into a text and HTML representation. + + + + + Create a data object from the selected objects in the given ObjectListView + + The source of the data object + + + + Create a data object which operates on the given model objects + in the given ObjectListView + + The source of the data object + The model objects to be put into the data object + + + + Gets or sets whether hidden columns will also be included in the text + and HTML representation. If this is false, only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. + + + + + Gets the ObjectListView that is being used as the source of the data + + + + + Gets the model objects that are to be placed in the data object + + + + + Put a text and HTML representation of our model objects + into the data object. + + + + + Create an exporter for the data contained in this object + + + + + + Make a HTML representation of our model objects + + + + + Convert the fragment of HTML into the Clipboards HTML format. + + The HTML format is found here http://msdn2.microsoft.com/en-us/library/aa767917.aspx + + The HTML to put onto the clipboard. It must be valid HTML! + A string that can be put onto the clipboard and will be recognized as HTML + + + + A FastDataListView virtualizes the display of data from a DataSource. It operates on + DataSets and DataTables in the same way as a DataListView, but does so much more efficiently. + + + + A FastDataListView still has to load all its data from the DataSource. If you have SQL statement + that returns 1 million rows, all 1 million rows will still need to read from the database. + However, once the rows are loaded, the FastDataListView will only build rows as they are displayed. + + + + + + + + + + + + 获取或设置在设置DataSource时是否自动生成列以显示列。 + + 必须在设置DataSource之前设置此设置。之后就没有效果了。 + + + + 获取或设置将在此列表视图中显示的VirtualListDataSource。 + + VirtualListDataSource应实现 , , + 或 . 以下是一些常见的对象类型 + + + + + + + + 绑定到列表容器时 (即，实现 接口, 比如 ) + 您还必须实现 属性，以便标识要显示的特定列表。您也可以设置 属性， + 即使当VirtualListDataSource引用列表时也是如此, 因为 还可以用于导航列表之间的关系. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + Create the DataSourceAdapter that this control will use. + + A DataSourceAdapter configured for this list + Subclasses should override this to create their + own specialized adapters + + + + Change the Unfreeze behaviour + + + + + A FastObjectListView trades function for speed. + + + On my mid-range laptop, this view builds a list of 10,000 objects in 0.1 seconds, + as opposed to a normal ObjectListView which takes 10-15 seconds. Lists of up to 50,000 items should be + able to be handled with sub-second response times even on low end machines. + + A FastObjectListView is implemented as a virtual list with many of the virtual modes limits (e.g. no sorting) + fixed through coding. There are some functions that simply cannot be provided. Specifically, a FastObjectListView cannot: + + use Tile view + show groups on XP + + + + + + + Make a FastObjectListView + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + This method preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code and performance is O(n) where n is the number of selected rows. + This method is not thread safe. + + + + + Move the given collection of objects to the given index. + + This operation only makes sense on non-grouped ObjectListViews. + + + + + + 删除任何排序并恢复到模型对象的给定顺序 + + To be really honest, Unsort() doesn't work on FastObjectListViews since + the original ordering of model objects is lost when Sort() is called. So this method + effectively just turns off sorting. + + + + 为FastObjectListView提供数据源 + + + This class isn't intended to be used directly, but it is left as a public + class just in case someone wants to subclass it. + + + + + Create a FastObjectListDataSource + + + + + + Get n'th object + + + + + + + How many items are in the data source + + + + + + Get the index of the given model + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Remove the given collection of models from this source. + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + Apply the given filters to this data source. One or both may be null. + + + + + + + Gets the full list of objects being used for this fast list. + This list is unfiltered. + + + + + Gets the list of objects from ObjectList which survive any installed filters. + + + + + Rebuild the map that remembers which model object is displayed at which line + + + + + Build our filtered list from our full list. + + + + + Concrete implementation of the ICluster interface. + + + + + Create a cluster + + The key for the cluster + + + + Return a string representation of this cluster + + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Return an indication of the ordering between this object and the given one + + + + + + + This class provides a useful base implemention of a clustering + strategy where the clusters are grouped around the value of a given column. + + + + + This field is the text that will be shown to the user when a cluster + key is null. It is exposed so it can be localized. + + + + + This field is the text that will be shown to the user when a cluster + key is empty (i.e. a string of zero length). It is exposed so it can be localized. + + + + + Gets or sets the format that will be used by default for clusters that only + contain 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + + + + Gets or sets the format that will be used by default for clusters that + contain 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + + + + Create a clustering strategy + + + + + Gets or sets the column upon which this strategy is operating + + + + + Gets or sets the format that will be used when the cluster + contains only 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatSingular will be used + + + + Gets or sets the format that will be used when the cluster + contains 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatPlural will be used + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Create a label that combines the string representation of the cluster + key with a format string that holds an "X [N items in cluster]" type layout. + + + + + + + + This class calculates clusters from the groups that the column uses. + + + + This is the default strategy for all non-date, filterable columns. + + + This class does not strictly mimic the groups created by the given column. + In particular, if the programmer changes the default grouping technique + by listening for grouping events, this class will not mimic that behaviour. + + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + This enum is used to indicate various portions of a datetime + + + + + Year + + + + + Month + + + + + Day of the month + + + + + Hour + + + + + Minute + + + + + Second + + + + + This class implements a strategy where the model objects are clustered + according to some portion of the datetime value in the configured column. + + To create a strategy that grouped people who were born in + the same month, you would create a strategy that extracted just + the month, and formatted it to show just the month's name. Like this: + + + someColumn.ClusteringStrategy = new DateTimeClusteringStrategy(DateTimePortion.Month, "MMMM"); + + + + + Create a strategy that clusters by month/year + + + + + Create a strategy that clusters around the given parts + + + + + + + Gets or sets the format string will will be used to create a user-presentable + version of the cluster key. + + The format should use the date/time format strings, as documented + in the Windows SDK. Both standard formats and custom format will work. + "D" - long date pattern + "MMMM, yyyy" - "January, 1999" + + + + Gets or sets the parts of the DateTime that will be extracted when + determining the clustering key for an object. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Convert the given date into a user presentable string + + + + + + + Instances of this class know how to build a Filter menu. + It is responsible for clustering the values in the target column, + build a menu that shows those clusters, and then constructing + a filter that will enact the users choices. + + + Almost all of the methods in this class are declared as "virtual protected" + so that subclasses can provide alternative behaviours. + + + + + Gets or sets the string that labels the Apply button. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Clear All menu item. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Filtering menu as a whole.. + Exposed so it can be localized. + + + + + Gets or sets the string that represents Select All values. + If this is set to null or empty, no Select All option will be included. + Exposed so it can be localized. + + + + + Gets or sets the image that will be placed next to the Clear Filtering menu item + + + + + Gets or sets the image that will be placed next to all "Apply" menu items on the filtering menu + + + + + Gets or sets whether null should be considered as a valid data value. + If this is true (the default), then a cluster will null as a key will be allow. + If this is false, object that return a cluster key of null will ignored. + + + + + Gets or sets the maximum number of objects that the clustering strategy + will consider. This should be large enough to collect all unique clusters, + but small enough to finish in a reasonable time. + + The default value is 10,000. This should be perfectly + acceptable for almost all lists. + + + + Create a Filter menu on the given tool tip for the given column in the given ObjectListView. + + This is the main entry point into this class. + + + + The strip that should be shown to the user + + + + Create a collection of clusters that should be presented to the user + + + + + + + + + Order the given list of clusters in the manner in which they should be presented to the user. + + + + + + + Do the work of making a menu that shows the clusters to the users + + + + + + + + Wrap a protected section around the real HandleItemChecked method, so that if + that method tries to change a "checkedness" of an item, we don't get a recursive + stack error. Effectively, this ensure that HandleItemChecked is only called + in response to a user action. + + + + + + + Handle a user-generated ItemCheck event + + + + + + + Handle any checking/unchecking of the Select All option, and keep + its checkedness in sync with everything else that is checked. + + + + + + + + Clear all the filters that are applied to the given column + + The column from which filters are to be removed + + + + Apply the selected values from the given list as a filter on the given column + + A list in which the checked items should be used as filters + The column for which a filter should be generated + + + + Interface for model-by-model filtering + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + Interface for whole list filtering + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Base class for model-by-model filters + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + This filter calls a given Predicate to decide if a model object should be included + + + + + Create a filter based on the given predicate + + The function that will filter objects + + + + Gets or sets the predicate used to filter model objects + + + + + Should the given model object be included? + + + + + + + A CompositeFilter joins several other filters together. + If there are no filters, all model objects are included + + + + + Create an empty filter + + + + + Create a composite filter from the given list of filters + + A list of filters + + + + Gets or sets the filters used by this composite + + + + + Get the sub filters that are text match filters + + + + + Decide whether or not the given model should be included by the filter + + + True if the object is included by the filter + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must satisfy all filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must only satisfy one of the filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter from the given filters + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + Instances of this class extract a value from the model object + and compare that value to a list of fixed values. The model + object is included if the extracted value is in the list + + If there is no delegate installed or there are + no values to match, no model objects will be matched + + + + Create a filter that will use the given delegate to extract values + + + + + + Create a filter that will extract values using the given delegate + and compare them to the values in the given list. + + + + + + + Gets or sets the delegate that will be used to extract values + from model objects + + + + + Gets or sets the list of values that the value extracted from + the model object must match in order to be included. + + + + + Should the given model object be included? + + + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Instances of this class match a property of a model objects against + a list of bit flags. The property should be an xor-ed collection + of bits flags. + + Both the property compared and the list of possible values + must be convertible to ulongs. + + + + Create an instance + + + + + + + Gets or sets the collection of values that will be matched. + These must be ulongs (or convertible to ulongs). + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Base class for whole list filters + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Instance of this class implement delegate based whole list filtering + + + + + A delegate that filters on a whole list + + + + + + + Create a ListFilter + + + + + + Gets or sets the delegate that will filter the list + + + + + Do the actual work of filtering + + + + + + + Filter the list so only the last N entries are displayed + + + + + Create a no-op tail filter + + + + + Create a filter that includes on the last N model objects + + + + + + Gets or sets the number of model objects that will be + returned from the tail of the list + + + + + Return the last N subset of the model objects + + + + + + + Instances of this class cluster model objects on the basis of a + property that holds an xor-ed collection of bit flags. + + + + + Create a clustering strategy that operates on the flags of the given enum + + + + + + Create a clustering strategy around the given collections of flags and their display labels. + There must be the same number of elements in both collections. + + The list of flags. + + + + + Gets the value that will be xor-ed to test for the presence of a particular value. + + + + + Gets the labels that will be used when the corresponding Value is XOR present in the data. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + A cluster is a like collection of objects that can be usefully filtered + as whole using the filtering UI provided by the ObjectListView. + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Implementation of this interface control the selecting of cluster keys + and how those clusters will be presented to the user + + + + + Gets or sets the column upon which this strategy will operate + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + If the returned value is an IEnumerable, the given model is considered + to belong to multiple clusters + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Instances of this class include only those rows of the listview + that match one or more given strings. + + This class can match strings by prefix, regex, or simple containment. + There are factory methods for each of these matching strategies. + + + + Create a text filter that will include rows where any cell matches + any of the given regex expressions. + + + + + Any string that is not a valid regex expression will be ignored. + + + + Create a text filter that includes rows where any cell begins with one of the given strings + + + + + + + + Create a text filter that includes rows where any cell contains any of the given strings. + + + + + + + + Create a TextFilter + + + + + + Create a TextFilter that finds the given string + + + + + + + Create a TextFilter that finds the given string using the given comparison + + + + + + + + Gets or sets which columns will be used for the comparisons? If this is null, all columns will be used + + + + + Gets or sets additional columns which will be used in the comparison. These will be used + in addition to either the Columns property or to all columns taken from the control. + + + + + Gets or sets the collection of strings that will be used for + contains matching. Setting this replaces all previous texts + of any kind. + + + + + Gets whether or not this filter has any search criteria + + + + + Gets or set the ObjectListView upon which this filter will work + + + You cannot really rebase a filter after it is created, so do not change this value. + It is included so that it can be set in an object initializer. + + + + + Gets or sets the collection of strings that will be used for + prefix matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + This is only used when doing Regex matching (obviously). + If this is not set specifically, the appropriate options are chosen to match the + StringComparison setting (culture invariant, case sensitive). + + + + + Gets or sets the collection of strings that will be used for + regex pattern matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets how the filter will match text + + + + + Loop over the columns that are being considering by the filter + + + + + + Do the actual work of filtering + + + + + + + Find all the ways in which this filter matches the given string. + + This is used by the renderer to decide which bits of + the string should be highlighted + + A list of character ranges indicating the matched substrings + + + + Is the given column one of the columns being used by this filter? + + + + + + + Base class for the various types of string matching that TextMatchFilter provides + + + + + Gets how the filter will match text + + + + + Gets the text filter to which this component belongs + + + + + Gets or sets the text that will be matched + + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + This component provides text contains matching strategy. + + + + + Create a text contains strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides text begins with matching strategy. + + + + + Create a text begins strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides regex matching strategy. + + + + + Creates a regex strategy + + + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + + + Gets or sets a compilex regular expression, based on our current Text and RegexOptions. + + + If Text fails to compile as a regular expression, this will return a Regex object + that will match all strings. + + + + + Gets whether or not our current regular expression is a valid regex + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This attribute is used to mark a property of a model + class that should be noticed by Generator class. + + + All the attributes of this class match their equivilent properties on OLVColumn. + + + + + Create a new OLVColumnAttribute + + + + + Create a new OLVColumnAttribute with the given title + + The title of the column + + + + + + + + + + + + + + + + + + + + + + + + + + + + + An array of IComparables that mark the cutoff points for values when + grouping on this column. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Properties marked with [OLVChildren] will be used as the children source in a TreeListView. + + + + + Properties marked with [OLVIgnore] will not have columns generated for them. + + + + + ColumnComparer is the workhorse for all comparison between two values of a particular column. + If the column has a specific comparer, use that to compare the values. Otherwise, do + a case insensitive string compare of the string representations of the values. + + This class inherits from both IComparer and its generic counterpart + so that it can be used on untyped and typed collections. + This is used by normal (non-virtual) ObjectListViews. Virtual lists use + ModelObjectComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column + + The column whose values will be compared + The ordering for column values + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column, and by a secondary column if the primary + column is equal. + + The column whose values will be compared + The ordering for column values + The column whose values will be compared for secondary sorting + The ordering for secondary column values + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare the actual values to be used for sorting + + The aspect extracted from the first row + The aspect extracted from the second row + An ordering indication: -1, 0, 1 + + + + This comparer sort list view groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + + + + Create a group comparer + + The ordering for column values + + + + Compare the two groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + group1 + group2 + An ordering indication: -1, 0, 1 + + + + This comparer can be used to sort a collection of model objects by a given column + + + This is used by virtual ObjectListViews. Non-virtual lists use + ColumnComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a model object comparer + + + + + + + Create a model object comparer with a secondary sorting column + + + + + + + + + Compare the two model objects + + + + + + + + Compare the actual values + + + + + + + + A helper class that translates DataSource events for an ObjectListView + + + + + Make a DataSourceAdapter + + + + + Finalize this object + + + + + Release all the resources used by this instance + + + + + Release all the resources used by this instance + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets the ObjectListView upon which this adaptor will operate + + + + + Gets or sets the currency manager which is handling our binding context + + + + + + + + + + + + + + + + + + + + + + + + + + + Our data source has changed. Figure out how to handle the new source + + + + + Our data source has changed. Figure out how to handle the new source + + + + + The data source for this control has changed. Reconfigure the control for the new source + + + + + Take the contents of the currently bound list and put them into the control + + + + + Create columns for the listview based on what properties are available in the data source + + + This method will create columns if there is not already a column displaying that property. + + + + + Decide if a new column should be added to the control to display + the given property + + + + + + + Configure the given column to show the given property. + The title and aspect name of the column are already filled in. + + + + + + + Generate aspect getters and putters for any columns that are missing them (and for which we have + enough information to actually generate a getter) + + + + + CurrencyManager ListChanged event handler. + Deals with fine-grained changes to list items. + + + It's actually difficult to deal with these changes in a fine-grained manner. + If our listview is grouped, then any change may make a new group appear or + an old group disappear. It is rarely enough to simply update the affected row. + + + + + + + Handle PropertyDescriptor* events + + + + + + Handle ItemMoved event + + + + + + Handle the ItemDeleted event + + + + + + Handle an ItemAdded event. + + + + + + Handle the Reset event + + + + + + Handle ItemChanged event. This is triggered when a single item + has changed, so just refresh that one item. + + + Even in this simple case, we should probably rebuild the list. + For example, the change could put the item into its own new group. + + + + The CurrencyManager calls this if the data source looks + different. We just reload everything. + + + + + CHECK: Do we need this if we are handle ListChanged metadata events? + + + + + Called by the CurrencyManager when the currently selected item + changes. We update the ListView selection so that we stay in sync + with any other controls bound to the same source. + + + + + + + Change the control's position (which is it's currently selected row) + to the nth row in the dataset + + The index of the row to be selected + + + + Handle the selection changing in our ListView. + We need to tell our currency manager about the new position. + + + + + + + Handle the frozenness of our ListView changing. + + + + + + + Handle a change to the BindingContext of our ListView. + + + + + + + These delegates are used to extract an aspect from a row object + + + + + These delegates are used to put a changed value back into a model object + + + + + These delegates can be used to convert an aspect value to a display string, + instead of using the default ToString() + + + + + These delegates are used to get the tooltip for a cell + + + + + These delegates are used to the state of the checkbox for a row object. + + + For reasons known only to someone in Microsoft, we can only set + a boolean on the ListViewItem to indicate it's "checked-ness", but when + we receive update events, we have to use a tristate CheckState. So we can + be told about an indeterminate state, but we can't set it ourselves. + + As of version 2.0, we can now return indeterminate state. + + + + + These delegates are used to get the state of the checkbox for a row object. + + + + + + + These delegates are used to put a changed check state back into a model object + + + + + These delegates are used to put a changed check state back into a model object + + + + + + + + These delegates are used to get the renderer for a particular cell + + + + + The callbacks for RightColumnClick events + + + + + This delegate will be used to own draw header column. + + + + + This delegate is called when a group has been created but not yet made + into a real ListViewGroup. The user can take this opportunity to fill + in lots of other details about the group. + + + + + These delegates are used to retrieve the object that is the key of the group to which the given row belongs. + + + + + These delegates are used to convert a group key into a title for the group + + + + + These delegates are used to get the tooltip for a column header + + + + + These delegates are used to fetch the image selector that should be used + to choose an image for this column. + + + + + These delegates are used to draw a cell + + + + + These delegates are used to fetch a row object for virtual lists + + + + + These delegates are used to format a listviewitem before it is added to the control. + + + + + These delegates can be used to return the array of texts that should be searched for text filtering + + + + + These delegates are used to sort the listview in some custom fashion + + + + + These delegates are used to order two strings. + x cannot be null. y can be null. + + + + + An ObjectListView is a much easier to use, and much more powerful, version of the ListView. + + + + An ObjectListView automatically populates a ListView control with information taken + from a given collection of objects. It can do this because each column is configured + to know which bit of the model object (the "aspect") it should be displaying. Columns similarly + understand how to sort the list based on their aspect, and how to construct groups + using their aspect. + + + Aspects are extracted by giving the name of a method to be called or a + property to be fetched. These names can be simple names or they can be dotted + to chain property access e.g. "Owner.Address.Postcode". + Aspects can also be extracted by installing a delegate. + + + An ObjectListView can show a "this list is empty" message when there is nothing to show in the list, + so that the user knows the control is supposed to be empty. + + + Right clicking on a column header should present a menu which can contain: + commands (sort, group, ungroup); filtering; and column selection. Whether these + parts of the menu appear is controlled by ShowCommandMenuOnRightClick, + ShowFilterMenuOnRightClick and SelectColumnsOnRightClick respectively. + + + The groups created by an ObjectListView can be configured to include other formatting + information, including a group icon, subtitle and task button. Using some undocumented + interfaces, these groups can even on virtual lists. + + + ObjectListView supports dragging rows to other places, including other application. + Special support is provide for drops from other ObjectListViews in the same application. + In many cases, an ObjectListView becomes a full drag source by setting to + true. Similarly, to accept drops, it is usually enough to set to true, + and then handle the and events (or the and + events, if you only want to handle drops from other ObjectListViews in your application). + + + For these classes to build correctly, the project must have references to these assemblies: + + + System + System.Data + System.Design + System.Drawing + System.Windows.Forms (obviously) + + + + + + How does a user indicate that they want to edit cells? + + + + + 列表将不支持编辑(同时F2按键无效) + + + + + 单击 单元格 将编辑值. + 选择该行，就像正常选择行一样。用户必须按F2键才能编辑主列。 + + + + + 双击子项或主列将编辑该单元格。 + F2键将编辑主列。 + + + + + 按F2键是编辑单元格的唯一方法。一旦主列被编辑， + 行中的其他单元格可以通过按Tab键进行编辑。 + + + + + 只需单击任意单元格即可编辑值，即使是主列也是如此。 + + + + + 这些值指定向用户显示列选择的方式 + + + + + 不会显示任何列选择 + + + + + 这些列将显示在主菜单中 + + + + + 这些列将显示在子菜单中 + + + + + 将显示一个模式对话框，允许用户选择列 + + + + + Triggered after a ObjectListView has been searched by the user typing into the list + + + + + Triggered after a ObjectListView has been sorted + + + + + Triggered before a ObjectListView is searched by the user typing into the list + + + Set Cancelled to true to prevent the searching from taking place. + Changing StringToFind or StartSearchFrom will change the subsequent search. + + + + + Triggered before a ObjectListView is sorted + + + Set Cancelled to true to prevent the sort from taking place. + Changing ColumnToSort or SortOrder will change the subsequent sort. + + + + + Triggered after a ObjectListView has created groups + + + + + Triggered before a ObjectListView begins to create groups + + + Set Groups to prevent the default group creation process + + + + + Triggered just before a ObjectListView creates groups + + + You can make changes to the groups, which have been created, before those + groups are created within the listview. + + + + + Triggered when a button in a cell is left clicked. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when a cell has finished being edited. + + + + + Triggered when a cell is about to finish being edited. + + If Cancel is already true, the user is cancelling the edit operation. + Set Cancel to true to prevent the value from the cell being written into the model. + You cannot prevent the editing from finishing within this event -- you need + the CellEditValidating event for that. + + + + Triggered when a cell is about to be edited. + + Set Cancel to true to prevent the cell being edited. + You can change the the Control to be something completely different. + + + + Triggered when a cell editor needs to be validated + + + If this event is cancelled, focus will remain on the cell editor. + + + + + Triggered when a cell is left clicked. + + + + + Triggered when the mouse is above a cell. + + + + + Triggered when a cell is right clicked. + + + + + This event is triggered when a cell needs a tool tip. + + + + + This event is triggered when a checkbox is checked/unchecked on a subitem + + + + + Triggered when a column header is right clicked. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + + + This event is triggered when the control needs to filter its collection of objects. + + + + + This event is triggered when a cell needs to be formatted. + + + + + This event is triggered when the frozeness of the control changes. + + + + + This event is triggered when a row needs to be formatted. + + + + + This event is triggered when a group is about to collapse or expand. + This can be cancelled to prevent the expansion. + + + + + This event is triggered when a group changes state. + + + + + This event is triggered when a header checkbox is changing value + + + + + This event is triggered when a header needs a tool tip. + + + + + Triggered when the "hot" item changes + + + + + Triggered when a hyperlink cell is clicked. + + + + + Triggered when the task text of a group is clicked. + + + + + Is the value in the given cell a hyperlink. + + + + + Some new objects are about to be added to an ObjectListView. + + + + + The contents of the ObjectListView has changed. + + + + + The contents of the ObjectListView is about to change via a SetObjects call + + + Set Cancelled to true to prevent the contents of the list changing. This does not work with virtual lists. + + + + + Some objects are about to be removed from an ObjectListView. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler, and when the source control + for the drag was an ObjectListView. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler and when the source control + for the drag was an ObjectListView. + + + + + This event is triggered once per user action that changes the selection state + of one or more rows. + + + + + This event is triggered when the contents of the ObjectListView has scrolled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Tell the world when a cell is about to be edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell has finished being edited. + + + + + 创建一个 ObjectListView + + + + + Dispose of any resources this instance has been using + + + + + + 获取鼠标左键是否在此时按下。 + + + + + 获取该程序是否在Vista或更高版本上运行 + + + + + 获取该程序是否在Win7或更高版本上运行 + + + + + Gets or sets how what smoothing mode will be applied to graphic operations. + + + + + Gets or sets how should text be renderered. + + + + + 获取或设置当组Key为Null时将用于标题组的字符串。将其公开以使其可以本地化。 + + + + + Convert the given enumerable into an ArrayList as efficiently as possible + + The source collection + If true, this method will always create a new + collection. + An ArrayList with the same contents as the given collection. + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Return the count of items in the given enumerable + + + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + Return whether or not the given enumerable is empty. A string is regarded as + an empty collection. + + + True if the given collection is null or empty + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Gets or sets whether all ObjectListViews will silently ignore missing aspect errors. + + + + By default, if an ObjectListView is asked to display an aspect + (i.e. a field/property/method) + that does not exist from a model, it displays an error message in that cell, since that + condition is normally a programming error. There are some use cases where + this is not an error -- in those cases, set this to true and ObjectListView will + simply display an empty cell. + + Be warned: if you set this to true, it can be very difficult to track down + typing mistakes or name changes in AspectNames. + + + + + Gets or sets whether the control will draw a rectangle in each cell showing the cell padding. + + + + This can help with debugging display problems from cell padding. + + As with all cell padding, this setting only takes effect when the control is owner drawn. + + + + + Gets the style that will be used by default to format disabled rows + + + + + Gets the style that will be used by default to format hot rows + + + + + Gets or sets an model filter that is combined with any column filtering that the end-user specifies. + + This is different from the ModelFilter property, since setting that will replace + any column filtering, whereas setting this will combine this filter with the column filtering + + + + Get or set all the columns that this control knows about. + Only those columns where IsVisible is true will be seen by the user. + + + + If you want to add new columns programmatically, add them to + AllColumns and then call RebuildColumns(). Normally, you do not have to + deal with this property directly. Just use the IDE. + + If you do add or remove columns from the AllColumns collection, + you have to call RebuildColumns() to make those changes take effect. + + + + + 获取或设置每隔一行的背景色 + + + + + 获取已设置的交替行背景色或默认颜色 + + + + + 此属性强制ObjectListView始终按给定列对项进行分组。 + + + + + 如果AlwaysGroupByColumn不为空，则此属性将用于确定如何对这些组进行排序。 + 如果此属性的值为SortOrder.None，则排序顺序将根据用户上次单击的标题切换。 + + + + + Give access to the image list that is actually being used by the control + + + Normally, it is preferable to use SmallImageList. Only use this property + if you know exactly what you are doing. + + + + + 获取或设置编辑单元格的方式 + + Columns can also be marked as editable. + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + 默认值为 true. + + + This is always treated as true when the control is NOT owner drawn. + + When this is false and the control is owner drawn, + ObjectListView will try to calculate the width of the cell's + actual contents, and then size the editing control to be just the right width. If this is true, + the whole width of the cell will be used, regardless of the cell's contents. + + Each column can have a different value for property. This value from the control is only + used when a column is not specified one way or another. + Regardless of this setting, developers can specify the exact size of the editing control + by listening for the CellEditStarting event. + + + + + Gets or sets the engine that will handle key presses during a cell edit operation. + Settings this to null will reset it to default value. + + + + + 获取当前用于编辑单元格的控件。 + + This will obviously be null if no cell is being edited. + + + + 获取或设置编辑控件左边缘或右边缘的单元格时Tab键的行为。 + 如果为False(默认值)，则按Tab键将换行到同一行的另一侧。 + 如果为True，编辑最右边的单元格时按Tab键将前进到下一行， + 编辑最左边的单元格时按Shift-Tab组合键将更改为上一行。 + + + + + 获取或设置编辑单元格时Enter键的行为。 + 如果为False(默认值)，则按Enter键将简单地完成编辑操作。 + 如果为True，则Enter将完成编辑操作，并在当前单元格下方的单元格上启动新的编辑操作，在位于底部单元格时换行到下一行的顶部。 + + + + + 获取显示单元格提示的工具提示控件 + + + + + 获取或设置该项的每个单元格周围将留空的像素数。单元格内容在考虑填充后对齐。 + + + Each value of the given rectangle will be treated as an inset from + the corresponding side. The width of the rectangle is the padding for the + right cell edge. The height of the rectangle is the padding for the bottom + cell edge. + + + So, this.olv1.CellPadding = new Rectangle(1, 2, 3, 4); will leave one pixel + of space to the left of the cell, 2 pixels at the top, 3 pixels of space + on the right edge, and 4 pixels of space at the bottom of each cell. + + + This setting only takes effect when the control is owner drawn. + + This setting only affects the contents of the cell. The background is + not affected. + If you set this to a foolish value, your control will appear to be empty. + + + + + 获取或设置默认情况下单元格垂直对齐的方式。 + + This setting only takes effect when the control is owner drawn. It will only be noticable + when RowHeight has been set such that there is some vertical space in each row. + + + + Should this list show checkboxes? + + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + .NET's CheckedItems property is not helpful. It is just a short-hand for + iterating through the list looking for items that are checked. + + + The performance of the get method is O(n), where n is the number of items + in the control. The performance of the set method is + O(n + m) where m is the number of objects being checked. Be careful on long lists. + + + + + + 获取或设置可枚举对象中的选中对象。 + + + Useful for checking all objects in the list. + + + this.olv1.CheckedObjectsEnumerable = this.olv1.Objects; + + + + + Gets Columns for this list. We hide the original so we can associate + a specialised editor with it. + + + + + 获取/设置当列表切换到TileView(平铺视图)时应使用的列的列表。 + + + + + 按向用户显示的顺序返回可见列 + + + + + 获取显示列表的控件区域，减去任何标题控件 + + + + + 获取或设置当用户按Ctrl+C组合键时是否应将选定行复制到剪贴板 + + + + + 获取或设置按Ctrl+C键复制到剪贴板功能是否应使用安装的DragSource创建放置到剪贴板上的数据对象。 + + This is normally what is desired, unless a custom DragSource is installed + that does some very specialized drag-drop behaviour. + + + + Gets the list of decorations that will be drawn the ListView + + + + Do not modify the contents of this list directly. Use the AddDecoration() and RemoveDecoration() methods. + + + A decoration scrolls with the list contents. An overlay is fixed in place. + + + + + + 所有者绘制时，此渲染器将绘制未指定特定渲染器的列 + + 如果尝试将其设置为NULL，则它将恢复为HighlightTextRenende + + + + 获取用于绘制给定单元格的渲染器。 + + The row model for the row + The column to be drawn + The renderer used for drawing a cell. Must not return null. + + + + 获取或设置将应用于禁用项的样式。 + + If this is not set explicitly, will be used. + + + + 获取或设置已禁用的模型对象的列表。无法选择或激活已禁用的对象。 + + + + + 判断此给定模型对象是否已禁用 + + + + + + + 禁用给定的模型对象。禁用的对象无法选择或激活。 + + Must not be null + + + + 禁用所有给定的模型对象 + + + + + + 启用给定的模型对象，以便可以再次选择并激活它。 + + Must not be null + + + + 启用所有给定的模型对象 + + + + + + 忽略所有禁用的对象。这不会触发重绘或重建 + + + + + Gets or sets the object that controls how drags start from this control + + + + + Gets or sets the object that controls how drops are accepted and processed + by this ListView. + + + + If the given sink is an instance of SimpleDropSink, then events from the drop sink + will be automatically forwarded to the ObjectListView (which means that handlers + for those event can be configured within the IDE). + + If this is set to null, the control will not accept drops. + + + + + This registry decides what control should be used to edit what cells, based + on the type of the value in the cell. + + + All instances of ObjectListView share the same editor registry. + + + + 获取或设置在此列表视图中没有项时应显示的文本。 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 获取或设置绘制列表空消息时应使用的字体 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 返回“列表为空”消息的字体或合理的默认值 + + + + + Gets or sets the overlay responsible for drawing the List Empty msg. + + + + + 获取在筛选中幸存下来的对象的集合。 + + + + This collection is the result of filtering the current list of objects. + It is not a snapshot of the filtered list that was last used to build the control. + + + Normal warnings apply when using this with virtual lists. It will work, but it + may take a while. + + + + + + 获取或设置将用于生成筛选器菜单的策略对象 + + 如果为NULL，则不会生成筛选器菜单。 + + + + 获取或设置具有键盘焦点的行 + + + + Setting an object to be focused does *not* select it. If you want to select and focus a row, + use . + + + This property is not generally used and is only useful in specialized situations. + + + + + + 隐藏Groups集合，使其在“属性”网格中不可见。 + + + + + 获取或设置分组使用的ImageList + + 如果未设置此选项，则分组标题将不会显示任何图像。 + + + + 获取在组为空或包含多个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 + + + "[{0} [{1} 项]" + + + + 返回this.GroupWithItemCountFormat或合理的默认值 + + + + + 获取在组仅包含单个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 (总是1) + + + "[{0} [{1} 项]" + + + + 获取GroupWithItemCountSingularFormat或合理的默认值 + + + + + 获取或设置此ObjectListView中的组是否应可折叠。 + + + 此特性只支持Vista或之后的系统. + + + + + 获取当前列表是否存在当列表为空时显示的文本 + + + + + 获取是否有要绘制的叠加层 + + + + + 获取ListView的列头控件 + + + + + 获取或设置列标题文本的绘制字体 + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + 获取或设置将用于绘制列表视图的列标题的样式 + + + + 仅当HeaderUsesThemes为false时才使用此选项。 + + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + + + 获取或设置标题的最大高度。-1表示没有最大值。 + + + + + 获取或设置标题的最小高度。-1表示没有最小值。 + + + + + 获取或设置是否严格按照操作系统的主题绘制标题。 + + + + 如果设置为true，则列头将完全由系统呈现，不需要ObjectListViews的任何特殊处理。 + 页眉中将没有图像、没有过滤器指示符、没有文字换行、没有页眉样式、没有复选框。 + + 如果将其设置为False，ObjectListView将以其认为最好的方式呈现标题。 + 如果不需要特殊功能，则ObjectListView会将渲染委托给操作系统。 + 否则，ObjectListView将根据配置设置绘制标题。 + + + 没有主题的效果会因操作系统不同而不同。至少，分类指示器不会是标准的。 + + + + + + 获取或设置列头标题中的文本是否自动换行。 + + + 将在单词之间应用换行符。过长的单词仍将被省略。 + + 与所有使列头看起来不同的设置一样，HeaderUsesThemes必须设置为false，否则操作系统将负责绘制列头，并且不允许自动换行文本。 + + + + + + 获取显示列标题提示的工具提示 + + + + + 获取鼠标当前所在行的索引。 + + + + + 获取鼠标当前所在列的索引 + + + + + 获取鼠标当前所在的项/子项的一部分 + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + 获取鼠标所在的组。 + + + + + 处于“热”状态的项的索引，即在光标下方。-1表示没有项目。 + + + + + 获取和设置对游标下的行应用哪种格式 + + + + 这仅在UseHotItem为true时生效。 + + 如果样式具有叠加层，则必须对其进行设置。*之前* 将其分配给此属性。之后添加它将被忽略。 + + + + + 获取已安装的热点项样式或合理的默认值。 + + + + + 获取和设置应将哪种格式应用于超链接 + + + + + 获取和设置所选行的背景应该使用什么颜色 + + + + + 返回应用于选定行的背景颜色或合理的默认值 + + + + + 获取和设置所选行的字体应该使用什么颜色 + + + + + 返回应用于选定行的字体颜色或合理的默认值 + + + + + 使用 SelectedBackColor 代替 + + + + + 使用 SelectedBackColorOrDefault 代替 + + + + + 使用 SelectedForeColor 代替 + + + + + 使用 SelectedForeColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedBackColor 代替 + + + + + 使用 UnfocusedSelectedBackColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedForeColor 代替 + + + + + 使用 UnfocusedSelectedForeColorOrDefault 代替 + + + + + 获取或设置是否应将隐藏列包括在复制或拖动到其他应用程序的行的文本表示形式中。 + 如果为False(默认值)，则仅包括可见列。 + + + + + 获取或设置复制行时，列标题是否在文本中。 + 如果为False(默认值)，在文本中将不会显示列标题。 + + + + + 如果当前正在进行单元格编辑操作，则返回TRUE + + + + + 如果在开发环境中使用ObjectListView，则返回true。 + + + + + 获取当前列表是否正在筛选其内容 + + + + + 当用户在列表中键入内容时，是否应该搜索当前排序列中的值以查找匹配项？ + 如果为False，则无论排序列是什么，都将始终使用主列。 + + When this is true, the behavior is like that of ITunes. + + + + 获取或设置此控件是否将使用SimpleDropSink接收拖动 + + + + 此设置将替换任何以前的DropSink。 + + + 将其设置为true后，SimpleDropSink仍需要配置为说明它何时可以接受拖动， + 以及在拖动某些内容时应该执行什么操作。需要执行这些操作使此属性几乎毫无用处 :( + + + + + + 获取或设置此控件是否将使用SimpleDragSource来启动拖动 + + 此设置将替换之前的任何DragSource + + + + 隐藏Items集合，使其在“属性”网格中不可见。 + + + + + 当列表中的项目处于非详细视图中时，此渲染器会绘制项目。在详细信息视图中，负责个体列的呈现器。 + + + + + 获取或设置最后一次排序的列 + + 这是PrimarySortColumn的别名 + + + + 获取或设置最后一次排序的方向 + + 这是 PrimarySortOrder的别名 + + + + 获取或设置应用于整个对象列表的筛选器。 + + + 列表将立即更新以反映此筛选器。 + + + + + 获取或设置应用于列表中每个模型对象的筛选器 + + + 您可能需要考虑使用 而不是此属性， + 因为AdditionalFilter在运行时与列筛选相结合。 + 设置此属性只是替换用户可能已给出的任何列筛选器。 + + The list is updated immediately to reflect this filter. + + + + + + Gets the hit test info last time the mouse was moved. + + Useful for hot item processing. + + + + 获取或设置列表显示的组列表。 + + + 此属性与.NET Groups属性的工作方式不同，应将其视为只读属性。 + 对列表所做的更改不会反映在ListView本身中。 + 在此列表中添加或删除组是没有意义的，这样的修改不会起到任何作用。 + 要执行此类操作，必须侦听BeforeCreatingGroups或AboutToCreateGroups事件， + 并更改这些事件中的组列表。 + + + + + 获取或设置折叠的OLVGroups的集合。 + + + + + Gets or sets whether the user wants to owner draw the header control + themselves. If this is false (the default), ObjectListView will use + custom drawing to render the header, if needed. + + + If you listen for the DrawColumnHeader event, you need to set this to true, + otherwise your event handler will not be called. + + + + + 获取/设置此列表将显示的对象集合 + + + + 设置此属性后，控件的内容将立即更新。 + + 如果可能，此方法将保留所选内容。使用 if + 如果您不想保留所选内容，请执行以下操作。 + 保留选择是该代码中最慢的部分，性能为O(N)，其中n是选定的行数。 + 此方法不是线程安全的。 + 该属性确实适用于虚拟列表：设置是没有问题的，但如果您尝试获取它， + 并且列表有1000万个对象，则可能需要一些时间才能返回。 + 此集合未经过筛选。使用 只访问那些在任何已安装的筛选器中幸存下来的对象。 + + + + + 获取当前控件所有对象组成的列表 + + + + + 获取创建群集时将考虑的对象集合。 + (用于生成类似Excel的列筛选器) + + + + + 获取或设置将在ListView顶部绘制的图像 + + + + + 获取或设置将在ListView顶部绘制的文本 + + + + + 获取或设置所有覆盖图的透明度。0表示完全透明，255表示完全不透明。 + + + 这已经过时了，请在每个覆盖上使用Transparency。 + + + + + 获取将在ListView顶部绘制的覆盖列表 + + + You can add new overlays and remove overlays that you have added, but + don't mess with the overlays that you didn't create. + + + + + Gets or sets whether the ObjectListView will be owner drawn. Defaults to true. + + + + When this is true, all of ObjectListView's neat features are available. + + We have to reimplement this property, even though we just call the base + property, in order to change the [DefaultValue] to true. + + + + + + 获取或设置主复选框是否在列表重新生成和筛选操作中保持其值。 + + + + 此属性仅在未显式设置CheckStateGetter/Putter时才有用。 + 如果您使用CheckStateGetter/Putter，那么这些方法已经持久化了行的检查性。 + + 此默认值为true。如果为False，则在重新生成或筛选列表时，复选框将丢失其值。 + 如果在虚拟列表中将其设置为false，则必须安装CheckStateGetter/Putters。 + + + + + 获取或设置记住模型对象的复选框状态的字典 + + 当PersistentCheckBoxs值为TRUE时，此选项用于虚拟列表. + + + + 获取或设置最后一次排序的列 + + + + + 获取或设置最后一次排序的方向 + + + + + 获取或设置不可编辑复选框是否绘制为禁用。默认是false。 + + + 这仅在所有者描述模式(owner drawn mode)下有效。 + + + + + 以像素为单位指定控件中每行的高度。 + + 列表视图中的行高通常由字体大小和小图像列表大小决定。 + 此设置允许覆盖该计算(原因是：您仍然不能将行高设置为小于控件中使用的字体的行高)。 + 将其设置为-1表示使用正常计算方法。 + 此功能是体验功能！如果您使用此功能，您的程序可能会发生意想不到的事情。 + + + + + 获取每行有多少像素高 + + + + + 获取此控件的每页上显示多少行 + + + + + 获取/设置将用于解析排序时相等的比较的列(第二排序列)。 + + 此设置没有用户界面。它必须以编程方式设置。 + + + + 获取或设置当使用Second darySortColumn时，它将以什么顺序比较结果 + + + + + 获取或设置当用户按Ctrl+A组合键时是否应选择所有行 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许用户选择视图中将显示哪些列 + + 这只是SelectColumnsOnRightClickBehaviour的兼容性包装属性. + + + + 获取或设置当右键单击标题时用户如何能够选择列 + + + + + 当列选择菜单打开时，是否应在选择项目后保持打开状态？保持打开状态允许用户一次打开或关闭多个列。 + + SelectColumnsOnRightClickBehaviour设置为InlineMenu时才有效。当行为设置为SubMenu菜单时，该选项不起作用。 + + + + 获取或设置选定列 + + + + 如果TintSortColumn为true，则排序列将自动成为选定列。 + + + 色调的颜色由SelectedColumnTint控制。 + + + + + + Gets or sets the decoration that will be drawn on all selected rows + + + + + 获取或设置应该使用什么颜色来给选定的列着色 + + + 色调颜色必须是Alpha可混合的，因此如果给定的颜色是纯色(即Alpha=255)，则会将其更改为具有合理的Alpha值。 + + + + + 获取或设置当前选定行的索引。 + 获取索引时，如果没有选择任何行，或者选择了多个行，则返回-1。 + + + + + 获取或设置当前选定的ListViewItem。如果未选择任何行，或者选择了多个行，则返回NULL。 + + + + + 如果只选择了一行，则从当前选定的行获取模型对象。 + 如果未选择任何行，或选择了多个行，则返回NULL。 + 设置时，这将选择显示给定模型对象的行，并将焦点放在该行上，取消选择所有其他行。 + + + + + 从当前选定的行中获取模型对象。 + 如果未选中任何行，则返回的列表为空。 + 设置此值时，请选择显示给定模型对象的行，取消选择所有其他行。 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许他们选择要在列表视图上执行的常见任务 + + + + + 获取或设置当右键单击标题控件时，此ObjectListView是否像筛选菜单一样显示表格 + + + + + 获取或设置是否应按组显示其项目 + + + + + 列表视图是否应该在列标题中显示位图以显示排序方向 + + + The only reason for not wanting to have sort indicators is that, on pre-XP versions of + Windows, having sort indicators required the ListView to have a small image list, and + as soon as you give a ListView a SmallImageList, the text of column 0 is bumped 16 + pixels to the right, even if you never used an image. + + + + + 列表视图是否应该显示子项上的图像 + + + 虚拟列表必须是所有者绘制的，才能在子项上显示图像 + + + + + 此属性控制分组标签是否显示该分组项目数量 + + + 后缀的格式由GroupWithItemCountFormat/GroupWithItemCountSingularFormat属性控制 + + + + + 获取或设置控件是在所有视图中显示列标题(True)，还是仅在详细信息视图中显示列标题(False) + + + + 此属性工作不正常。JPP 2010/04/06。 + 如果它是在创建控件之前设置的，则可以正常工作。 + 但是，如果在创建控件后将其关闭，则控件将丢失其复选框(奇怪！) + + + 要在创建控件后更改此设置，事情会很复杂。 + 如果它是关闭的，而我们想要打开它，我们必须更改视图，标题就会出现。 + 如果它当前处于打开状态，而我们想要将其关闭，则必须更改视图并重新创建控制柄。 + 重新创建句柄是一个问题，因为它会使我们的复选框样式消失。 + + + 该属性不能工作在 Win XP 系统. + + + + + 重写SmallImageList属性，以便我们可以正确地隐藏其操作。 + + 如果使用RowHeight属性指定行高，则必须在设置/更改RowHeight之前完全初始化SmallImageList。 + 如果在设置行高之后将新图像添加到图像列表，则必须再次将图像列表分配给控件。像这样简单的事情会奏效的： + listView1.SmallImageList = listView1.SmallImageList; + + + + + 返回小图像列表中图像的大小或合理的默认值 + + + + + 当列表视图分组时，项是否应该按主列排序？如果为False，则项目将按分组时的同一列进行排序。 + + + + + 当列表视图分组时，一个组的末尾和下一个组的开头之间应该有多少像素 + + + + + 排序列是否应该显示轻微的色调？ + + + + + 获取或设置是否使用三态复选框？ + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + 否则，用户在选中和取消选中之间交替单击。 + 当此设置为False时，CheckStateGetter仍可以返回不确定。 + + + + + 获取或设置列表顶部项目的索引 + + + + 此属性仅在列表视图处于详细信息视图中且不显示组时才起作用。 + + + 显示组时不起作用的原因是，当启用组时，无论滚动位置如何， + Windows msg LVM_GETTOPINDEX总是返回0。 + + + + + + 获取或设置将鼠标移到标题上是否会触发CellOver事件。 + 默认为true。 + + + 将鼠标移动到标题上之前不会触发CellOver事件，因为Header被视为单独的控件。 + 如果此行为更改导致您的应用程序出现问题，请将其设置为False。 + 如果您想知道鼠标何时在标题上移动，请将此属性设置为true(默认值)。 + + + + + 通过拖动分隔线调整列的大小时，是否应在每次鼠标移动时调整填充空格的列的大小？ + 如果为False，则释放鼠标时将更新填充栏。 + + + + 如果空间填充列位于正在调整大小的列的左侧，这看起来会很奇怪：该列的右边缘将被拖动，但由于空间填充列正在收缩，其左边缘将会移动。 + + 这是合乎逻辑的行为--只是看起来不对。 + + + 考虑到上述行为，如果空间填充列不是最右边的列，最好关闭该属性。 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的背景 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的背景的颜色 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的字体颜色。 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的字体颜色 + + + + + 获取或设置列表是否每隔一行提供不同的背景色？默认值为false。 + + 交替行的颜色由AlternateRowBackColor提供。 + 在.NET中，列表视图在非整行选择模式下有一个“功能”，在这种模式下，所选行不会使用正确的背景色绘制。 + + + + 是否应该为控件中的每个单元格调用FormatCell事件？ + + + 在许多情况下，不执行单元格级格式设置。 + 如果除非需要，ObjectListView不会为每个单元格触发Format Cell事件，则它的运行速度会稍快一些。 + 因此，默认情况下，它不会为每个单元格引发事件。 + + ObjectListView*确实*在每次重新生成行时引发FormatRow事件。各行可以决定是否对行中的每个单元格引发FormatCell事件。 + + + 无论此设置如何，只有当ObjectListView处于详细视图中时才会引发FormatCell事件。 + + + + + 所选行是否应使用非标准前景色和背景色绘制？ + + V2.9不再需要此属性 + + + + 获取或设置此ObjectListView是否将使用与Vista资源管理器相同的热项和选择机制。 + + + + 此属性有许多缺陷： + + 这仅适用于Vista及更高版本 + 它不能很好地与AlternateRowBackColors配合使用。 + 它不能很好地与HotItemStyles配合使用。 + 如果FullRowSelect为false，这看起来有点傻。 + 当列表是所有者绘制的时，它根本不起作用(因为所有的绘制都是由渲染器完成的)。 + 因此，它不能与TreeListView一起工作，因为它们“必须”是所有者绘制的。你仍然可以设置它，但它不会生效。 + + 但如果你一定要看起来像Vista/Win7，这是你的权限。如果这项设置搞砸了其他事情，请不要抱怨。 + + + 当此属性设置为True时，ObjectListView将不是所有者描述的。 + 这将禁用ObjectListView的许多漂亮的基于绘图的功能。 + + + + + + 获取或设置列表是否应启用筛选 + + + + + 获取或设置列表是否应将指示符放入列的标题中，以表明它正在筛选该列 + + 如果将其设置为true，HeaderUsesThemes将自动设置为false，因为我们只能在不使用主题标题时绘制筛选器指示器。 + + + + 鼠标下方的控件(复选框或按钮)是否应该被绘制为“Hot” + + + 如果为False，则当鼠标悬停在控件上时，控件的绘制方式不会有所不同。 + + 如果为False，且UseHotItem和UseHyperLinks为False，则ObjectListView可以跳过鼠标移动的某些处理。这使得鼠标移动处理几乎不使用CPU。 + + + + + + 光标下的项是否应以特殊方式设置格式？ + + + + + 获取或设置此列表视图是否应在单元格中显示超链接。 + + + + + 此控件是否应显示覆盖(Overlays) + + 覆盖(Overlays)在默认情况下是启用的，只有在它们在您的开发环境中造成问题时才需要禁用。 + + + + 是否应将此控件配置为在子项上显示复选框？ + + 如果将其设置为True，则将为该控件提供一个SmallImageList(如果它还没有一个SmallImageList)。 + 此外，如果它是一个虚拟列表，它将被设置为所有者描述的，因为虚拟列表不能在没有所有者描述的情况下绘制复选框。 + + + + 获取或设置ObjectListView是否将使用类似Vista的半透明选择机制。 + + + + 与UseExplorerTheme不同的是，这个类似Vista的方案可以在XP上运行，并且既适用于所有者描述的列表，也适用于非所有者描述的列表。 + + + 这将替换任何已安装的SelectedRowDecory。 + + + 如果您不喜欢用于选择的颜色，请忽略此属性， + 只需创建您自己的RowBorderDecory并将其分配给SelectedRowDecory， + 就像此属性设置器所做的那样。 + + + + + + 获取或设置ObjectListView是否将使用类似于Vista的半透明热行突出显示机制。 + + + + 设置此项将替换任何已安装的HotItemStyle。 + + + 如果您不喜欢热项目使用的颜色，请忽略此属性， + 只需创建您自己的HotItemStyle，填充所需的值， + 并将其分配给HotItemStyle属性，就像此属性设置器所做的那样。 + + + + + + 获取/设置此列表视图正在使用的视图样式 + + 切换到平铺(Tile)或详细信息(Details)视图会安装适合该视图的列。令人困惑的是，在平铺视图中，每列都显示为一行信息。 + + + + 此委托仅将对象的检查性作为布尔值获取。 + + 如果您永远不想担心不确定状态(这是相当常见的)，请使用此选项。 + + 这是CheckStateGetter属性的便捷包装。 + + + + + + This delegate sets the checkedness of an object as a boolean only. It must return + true or false indicating if the object was checked or not. + + Use this if you never want to worry about the + Indeterminate state (which is fairly common). + + This is a convenience wrapper around the CheckStatePutter property. + + + + + + 获取此列表视图是否能够显示组 + + + + + 获取或设置ObjectListView是否可以依赖正在引发的Application.Idle事件。 + + 在某些主机环境中(例如，在VisualStudio和Office中作为扩展运行时)，从不引发Application.Idle事件。 + 如果不会引发Idle事件，则将其设置为False，ObjectListView将自行引发这些事件。 + + + + + This delegate fetches the renderer for a particular cell. + + + + If this returns null (or is not installed), the renderer for the column will be used. + If the column renderer is null, then will be used. + + + This is called every time any cell is drawn. It must be efficient! + + + + + + This delegate is called when the list wants to show a tooltip for a particular cell. + The delegate should return the text to display, or null to use the default behavior + (which is to show the full text of truncated cell values). + + + Displaying the full text of truncated cell values only work for FullRowSelect listviews. + This is MS's behavior, not mine. Don't complain to me :) + + + + + 保存是否选中模型的属性(或字段)的名称。 + + + 该属性是可修改的。它必须具有bool(或bool？)返回类型。如果TriStateCheckBooks为真)。 + 设置此属性将替换任何已安装的CheckStateGetter或CheckStatePutter。 + 相反，稍后设置CheckStateGetter或CheckStatePutter属性将优先于此属性的行为。 + + + + + 只要ObjectListView需要知道与给定模型对象关联的行的检查状态，就会调用此委托。 + + + .NET has no support for indeterminate values, but as of v2.0, this class allows + indeterminate values. + + + + + This delegate will be called whenever the user tries to change the check state of a row. + The delegate should return the state that was actually set, which may be different + to the state given. + + + + + 此委托可用于以自定义方式对表进行排序。 + + + + 委托必须在ObjectListView上安装ListViewItemSorter。 + 安装ItemSorter会执行对ListViewItems进行排序的实际工作。 + 有关ItemSorter必须执行的操作的示例，请参见代码中的ColumnCompeller。 + + + 请勿在VirtualObjectListView上安装CustomSorter。改为重写IVirtualListDataSource的SortObjects()方法。 + + + + + + This delegate is called when the list wants to show a tooltip for a particular header. + The delegate should return the text to display, or null to use the default behavior + (which is to not show any tooltip). + + + Installing a HeaderToolTipGetter takes precedence over any text in OLVColumn.ToolTipText. + + + + + This delegate can be used to format a OLVListItem before it is added to the control. + + + The model object for the row can be found through the RowObject property of the OLVListItem object. + All subitems normally have the same style as list item, so setting the forecolor on one + subitem changes the forecolor of all subitems. + To allow subitems to have different attributes, do this: + myListViewItem.UseItemStyleForSubItems = false;. + + If UseAlternatingBackColors is true, the backcolor of the listitem will be calculated + by the control and cannot be controlled by the RowFormatter delegate. + In general, trying to use a RowFormatter + when UseAlternatingBackColors is true does not work well. + As it says in the summary, this is called before the item is added to the control. + Many properties of the OLVListItem itself are not available at that point, including: + Index, Selected, Focused, Bounds, Checked, DisplayIndex. + + + + + 将给定的模型对象添加到此控件。 + + 要显示的模型对象 + See AddObjects() for more details + + + + 将给定的模型对象集合添加到此控件。 + + 要显示的模型对象集合 + + 如果排序处于活动状态(即，如果PrimarySortColumn不为空)，则添加的对象将出现在其正确的排序位置。否则，它们将出现在列表的末尾。 + 不执行任何检查以查看是否有任何对象已在ListView中。 + 空对象将被静默忽略。 + + + + + 将列的大小调整到页眉宽度和数据的最大值。 + + + + + 设置任何自动初始化的列宽(宽度为0或-1的列将分别调整为其内容或标题的宽度)。 + + + 显然，这只会起作用一次。一旦运行，列宽将更改为其他值(不是0或-1)，因此第二次运行时不会执行任何操作。 + 若要强制所有列更改其大小，请使用 。 + + + + + 根据最后一个排序列或第一列(如果没有最后一个排序列)将视图项组织到组中 + + + + + 根据给定列将视图项组织成组 + + + + 如果AlwaysGroupByColumn属性不为Null，则列表视图项将按该列组织，并且将忽略‘Column’参数。 + + 此方法触发排序事件：BeforeSorting和AfterSorting。 + + 其值应用于排序的列。 + + + + + 根据给定列将视图项组织成组 + + 将使用哪一列进行分组 + 组将使用什么顺序 + 其值应用于排序的列。不能为空 + 列中值的排序顺序 + 当‘column’中的值相等时，请使用此列提供的值 + 次级值将如何排序 + 此方法不会触发排序事件。使用BuildGroups()执行此操作 + + + + 收集并返回影响组创建的所有变量 + + + + + + Make a list of groups that should be shown according to the given parameters + + + The list of groups to be created + This should not change the state of the control. It is possible that the + groups created will not be used. They may simply be discarded. + + + + 生成/重新生成列表中的所有列表视图项，尽可能多地保留状态 + + + + + 生成/重新生成列表中的所有列表视图项 + + If this is true, the control will try to preserve the selection, + focused item, and the scroll position (see Remarks) + + + + Use this method in situations were the contents of the list is basically the same + as previously. + + + + + + 清除此列表可能一直在使用的所有缓存信息 + + + + + Apply all required extended styles to our control. + + + + Whenever .NET code sets an extended style, it erases all other extended styles + that it doesn't use. So, we have to explicit reapply the styles that we have + added. + + + Normally, we would override CreateParms property and update + the ExStyle member, but ListView seems to ignore all ExStyles that + it doesn't already know about. Worse, when we set the LVS_EX_HEADERINALLVIEWS + value, bad things happen (the control crashes!). + + + + + + Give the listview a reasonable size of its tiles, based on the number of lines of + information that each tile is going to display. + + + + + Rebuild this list for the given view + + + + + + 移除所有对象(线程安全) + + This method can safely be called from background threads. + + + + 重置已访问其URL的内存 + + + + + 将选定行的文本和HTML表示复制到剪贴板上。 + + Be careful when using this with virtual lists. If the user has selected + 10,000,000 rows, this method will faithfully try to copy all of them to the clipboard. + From the user's point of view, your program will appear to have hung. + + + + 将给定对象的文本和HTML表示复制到剪贴板上。 + + + + + 将所有对象的文本和HTML表示复制到剪贴板上。 + + + + + 返回给定对象的html表示形式 + + + + + 取消选择列表视图中的所有行 + + + + + 返回紧跟在给定项后面的ListViewItem。 + 如果给定项为空，则返回列表中的第一个项。 + 如果给定项是最后一项，则返回NULL。 + + The item that is before the item that is returned, or null + A ListViewItem + + + + 按向用户显示的顺序返回最后一项。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + 按向用户显示的顺序返回第n项(从0开始)。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回给定listviewitem索引的显示索引。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回紧接在给定项之前出现的ListViewItem。 + 如果给定项为空，则返回列表中的最后一项。 + 如果给定项是第一项，则返回NULL。 + + The item that is before the item that is returned + A ListViewItem + + + + 在给定位置之前插入给定的对象集合 + + Where to insert the objects + The objects to be inserted + + + This operation only makes sense of non-sorted, non-grouped + lists, since any subsequent sort/group operation will rearrange + the list. + + This method only works on ObjectListViews and FastObjectListViews. + + + + + 如果选择了表示给定模型的行，则返回TRUE + + The model object to look for + Is the row selected + + + + 给定的URL是否已被访问 + + The string to be consider + Has it been visited + + + + 按给定的值增量滚动ListView。 + + Horizontal delta + Vertical delta + + + + Return a point that represents the current horizontal and vertical scroll positions + + + + + 记住给定的URL已被访问 + + The url to be remembered + This does not cause the control be redrawn + + + + 将给定的对象集合移动到给定的索引。 + + 此操作仅对未分组的ObjectListViews有意义。 + + + + + + 计算在给定点下的项目是什么？ + + + + + + + + 使用Windows控件的SUBITEMHITTEST消息执行点击测试。 + 这提供了标准ListView.HitTest()不提供的有关组点击的信息。 + + + + + + + + What is under the given point? This takes the various parts of a cell into accout, including + any custom parts that a custom renderer might use + + + + An information block about what is under the point + + + + Perform a hit test when the control is not owner drawn + + + + + + + + Perform a hit test when the control is owner drawn. This hands off responsibility + to the renderer. + + + + + + + + Pause (or unpause) all animations in the list + + true to pause, false to unpause + + + + Rebuild the columns based upon its current view and column visibility settings + + + + + 从ListView中删除给定的模型对象 + + The model to be removed + See RemoveObjects() for more details + This method is thread-safe. + + + + + 从控件中移除所有给定对象。 + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + This method is thread-safe. + + + + + 选择列表视图中的所有行 + + + + + 在列表视图的右下角设置要固定的给定图像。 + 当列表视图滚动时，此图像不会滚动。 + + + + 此方法使用ListView的原生功能显示背景图像。 + 它有几个限制： + + + 它在owner drawn模式下不能很好地工作。在owner drawn绘制模式下， + 每个单元格都会绘制自身，包括覆盖背景图像的背景。 + 启用网格线时看起来不是很好，因为网格线是在图像上绘制的。 + 它在XP上完全不起作用。 + 显然，当启用交替行背景色时，效果不佳。 + + + 如果你能忍受这些限制，原生水印就相当不错了。 + 它们是真实的背景，而不是像OverlayImage使用的半透明覆盖。 + 与覆盖相比，它们也有明显的优势，因为即使在MDI应用程序中，它们也可以正常工作。 + + 设置此选项将清除所有背景图像。 + + The image to be drawn. If null, any existing image will be removed. + + + + 将给定的图像设置为ListView的背景，以便它在列表中以给定的百分比偏移量显示。 + + + 这具有与 中所述的相同限制. + 在使用该方法之前，请确保了解这些限制。 + 这非常类似于 属性， + 但标准Backround Image不能正确处理具有透明区域的图像--它将透明区域呈现为黑色。这种方法没有这个问题。 + 设置此选项将清除所有背景水印。 + + The image to be drawn. If null, any existing image will be removed. + The horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + The vertical percentage where the image will be placed. + + + + 将给定图像设置为ListView的平铺背景。 + + + 这具有与 和 相同的限制. + 在使用该方法之前，请确保了解这些限制。 + + 要绘制的图像。如果为null，则将删除所有现有图像。 + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法。 + 该列表将立即更新 + The objects to be displayed + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法. + 该列表将立即更新 + The objects to be displayed + 是否应尽可能保留列表的状态。 + + + + 将给定的模型对象更新到ListView中。 + 如果该模型尚不存在，则会添加该模型。 + + The model to be updated + + + See for more details + + 此方法是线程安全的。 + 此方法将导致重新排序列表。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更新与给定对象相等的预先存在的模型。 + 如果控件中不存在任何模型，则会添加它们。 + + Collection of objects to be updated/added + + 此方法将导致重新排序列表。 + null值将被静默忽略。 + 此方法是线程安全的。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更改当前模型对象上对INotifyPropertyChanged事件的任何订阅， + 以便我们不再侦听旧模型上的事件，而侦听给定集合上的事件。 + + This does nothing if UseNotifyPropertyChanged is false. + + + + + 获取或设置ObjectListView是否应订阅它给定的模型对象上的INotifyPropertyChanged事件。 + + + + 这应该在调用SetObjects()之前设置。如果将其设置为False，ObjectListView将取消订阅所有当前模型对象。 + + 如果在虚拟列表上将其设置为true，ObjectListView将遍历列表中尝试订阅更改通知的所有对象。 + 如果您的虚拟列表中有10,000,000个项目，这可能需要一些时间。 + + + + + Subscribe to INotifyPropertyChanges on the given collection of objects. + + + + + + Unsubscribe from INotifyPropertyChanges on the given collection of objects. + If the given collection is null, unsubscribe from all current subscriptions + + + + + + Return a byte array that represents the current state of the ObjectListView, such + that the state can be restored by RestoreState() + + + The state of an ObjectListView includes the attributes that the user can modify: + + current view (i.e. Details, Tile, Large Icon...) + sort column and direction + column order + column widths + column visibility + + + + It does not include selection or the scroll position. + + + A byte array representing the state of the ObjectListView + + + + Restore the state of the control from the given string, which must have been + produced by SaveState() + + A byte array returned from SaveState() + Returns true if the state was restored + + + + Instances of this class are used to store the state of an ObjectListView. + + + + + The application is idle. Trigger a SelectionChanged event. + + + + + + + The application is idle. Handle the column resizing event. + + + + + + + Handle the BeginScroll listview notification + + + True if the event was completely handled + + + + Handle the EndScroll listview notification + + + True if the event was completely handled + + + + Handle the LinkClick listview notification + + + True if the event was completely handled + + + + The cell tooltip control wants information about the tool tip that it should show. + + + + + + + Allow the HeaderControl to call back into HandleHeaderToolTipShowing without making that method public + + + + + + + The header tooltip control wants information about the tool tip that it should show. + + + + + + + Event handler for the column click event + + + + + Override the basic message pump for this control + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user wants to see the context menu. + + The windows m + A bool indicating if this m has been handled + + We want to ignore context menu requests that are triggered by right clicks on the header + + + + + Handle the Custom draw series of notifications + + The message + True if the message has been handled + + + + Handle the underlying control being destroyed + + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + Find the first row after the given start in which the text value in the + comparison column begins with the given text. The comparison column is column 0, + unless IsSearchOnSortColumn is true, in which case the current sort column is used. + + The text to be prefix matched + The index of the first row to consider + Which direction should be searched? + The index of the first row that matched, or -1 + The text comparison is a case-insensitive, prefix match. The search will + search the every row until a match is found, wrapping at the end if needed. + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + 是否只匹配开头 + The index of the matched row, or -1 + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + Handle the Group Info series of notifications + + The message + True if the message has been handled + + + + Handle a key down message + + + True if the msg has been handled + + + + Toggle the checkedness of the selected rows + + + + Actually, this doesn't actually toggle all rows. It toggles the first row, and + all other rows get the check state of that first row. This is actually a much + more useful behaviour. + + + If no rows are selected, this method does nothing. + + + + + + Catch the Left Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button up event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Trigger a GroupExpandCollapse event and return true if the action was cancelled + + + + + + + Catch the Right Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the right Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a right mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the MouseMove event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle notifications that have been reflected back from the parent window + + The m to be processed + bool to indicate if the msg has been handled + + + + In the notification messages, we handle attempts to change the width of our columns + + The m to be processed + bool to indicate if the msg has been handled + + + + Create a ToolTipControl to manage the tooltip control used by the listview control + + + + + Update the handle used by our cell tooltip to be the tooltip used by + the underlying Windows listview control. + + + + + Handle the WM_PAINT event + + + Return true if the msg has been handled and nothing further should be done + + + + Perform any steps needed before painting the control + + + + + Perform any steps needed after painting the control + + + + + Handle the window position changing. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a menu that is appropriate when the given column header is clicked. + + The index of the header that was clicked. This + can be -1, indicating that the header was clicked outside of a column + Where should the menu be shown + True if a menu was displayed + + + + Create the menu that should be displayed when the user right clicks + on the given column header. + + Index of the column that was right clicked. + This can be negative, which indicates a click outside of any header. + The toolstrip that should be displayed + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + Where should the menu be placed + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + + Where should the menu be placed + + + + 获取或设置要用于升序排序命令的文本 + + + + + 获取或设置要用于降序排序命令的文本 + + + + + 获取或设置要用于分组命令的文本 + + + + + 获取或设置要用于锁定分组命令的文本 + + + + + 获取或设置要用于不锁定分组命令的文本 + + + + + 获取或设置要用于关闭分组命令的文本 + + + + + 获取或设置要用于不排序命令的文本 + + + + + 获取或设置要用于列描述的文本 + + + + + 获取或设置要用于选择列描述的文本 + + + + + Gets or sets the image that will be place next to the Sort Ascending command + + + + + Gets or sets the image that will be placed next to the Sort Descending command + + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + + Return the menu to which the items were added + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + Return the menu to which the items were added + + + + Create the menu items that will allow columns to be choosen and add them to the + given collection + + + + + + Create a Filtering menu + + + + + + + + Override the OnColumnReordered method to do what we want + + + + + + When the column widths are changing, resize the space filling columns + + + + + + + When the column widths change, resize the space filling columns + + + + + + + When the size of the control changes, we have to resize our space filling columns. + + + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Check all rows + + + + + Check the checkbox in the given column header + + If the given columns header check box is linked to the cell check boxes, + then checkboxes in all cells will also be checked. + + + + + Mark the checkbox in the given column header as having an indeterminate value + + + + + + Mark the given object as indeterminate check state + + The model object to be marked indeterminate + + + + Mark the given object as checked in the list + + The model object to be checked + + + + Mark the given objects as checked in the list + + The model object to be checked + + + + Put a check into the check box at the given cell + + + + + + + Put an indeterminate check into the check box at the given cell + + + + + + + Return true of the given object is checked + + The model object whose checkedness is returned + Is the given object checked? + If the given object is not in the list, this method returns false. + + + + Return true of the given object is indeterminately checked + + The model object whose checkedness is returned + Is the given object indeterminately checked? + If the given object is not in the list, this method returns false. + + + + Is there a check at the check box at the given cell + + + + + + + Get the checkedness of an object from the model. Returning null means the + model does not know and the value from the control will be used. + + + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the checkedness of the given object. A checked object becomes + unchecked; an unchecked or indeterminate object becomes checked. + If the list has tristate checkboxes, the order is: + unchecked -> checked -> indeterminate -> unchecked ... + + The model object to be checked + + + + Toggle the checkbox in the header of the given column + + Obviously, this is only useful if the column actually has a header checkbox. + + + + + Toggle the check at the check box of the given cell + + + + + + + Uncheck all rows + + + + + Mark the given object as unchecked in the list + + The model object to be unchecked + + + + Mark the given objects as unchecked in the list + + The model object to be checked + + + + Uncheck the checkbox in the given column header + + + + + + Uncheck the check at the given cell + + + + + + + 返回给定索引处的列 + + Index of the column to be returned + An OLVColumn + + + + 返回给定标题处的列,如果有多个符合要求的标题,则默认只返回第一个 + + 要返回的列的名称 + An OLVColumn + + + + 返回给定视图可见的列的集合。只有Tile和Details有列；所有其他视图都有0列。 + + 正在为哪个视图计算列？ + A list of columns + + + + 返回列表中的项目数 + + 列表中的项目数 + 如果安装了筛选器，这将返回与筛选器匹配的项目数。 + + + + 返回给定索引处的项 + + Index of the item to be returned + An OLVListItem + + + + 返回给定索引处的模型对象 + + Index of the model object to be returned + A model object + + + + 找出在给定的坐标下的行和列 + X 坐标 + Y 坐标 + 给定点下的列项 + 在给定坐标点下的行项。可以为null。 + + + + 返回给定索引/列的子项 + + Index of the item to be returned + Index of the subitem to be returned + An OLVListSubItem + + + + 滚动列表视图，使给定组位于顶部。 + + The group to be revealed + + 如果该组可见，如果可能，列表仍将滚动以将该组移至顶部。 + + 这只在列表显示分组时才有效(显然)。 + 这在虚拟列表上不起作用，因为虚拟列表不使用ListViewGroups进行分组。使用 代替. + + + + + 使给定的模型对象可见 + + The model object to be revealed + + + + 返回选定行的模型对象，如果没有选择或有多个选择，则返回null + + Model object or null + + + + 返回选定行的模型对象，如果没有选择，则返回空集合 + + ArrayList + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + Model object or null + 使用 CheckedObject 属性代替本方法 + + + + 获取选中的模型对象的集合。 + + 使用 CheckedObjects 属性代替本方法 + + + + 在列表视图中查找给定的模型对象并返回其索引 + + The model object to be found + The index of the object. -1 means the object was not present + + + + Rebuild the given ListViewItem with the data from its associated model. + + This method does not resort or regroup the view. It simply updates + the displayed data of the given item + + + + Rebuild the data on the row that is showing the given object. + + + + This method does not resort or regroup the view. + + + The given object is *not* used as the source of data for the rebuild. + It is only used to locate the matching model in the collection, + then that matching model is used as the data source. This distinction is + only important in model classes that have overridden the Equals() method. + + + If you want the given model object to replace the pre-existing model, + use . + + + + + + Update the rows that are showing the given objects + + + This method does not resort or regroup the view. + This method can safely be called from background threads. + + + + + 更新选定的行 + + This method does not resort or regroup the view. + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + Use the property to deselect all other rows + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + 对象是否也应该被聚焦 + Use the property to deselect all other rows + + + + 选择显示任意给定模型对象的行。取消选择所有其他行。 + + A collection of model objects + + + + 获取或设置是否冻结列表视图。当列表视图被冻结时，它不会自我更新。 + + Frozen属性与Freeze()/UnFreeze()方法类似， + 不同之处在于将Frozen属性设置为False会立即解冻控件， + 而不管有多少未完成的Freeze()调用。 + objectListView1.Frozen = false; // unfreeze the control now! + + + + + 冻结列表视图，使其不再自我更新。 + + Freeze()/Unfreeze() calls nest correctly + + + + 解冻列表视图。如果此调用是最外层的unFreeze()，则将重新构建listview的内容。 + + Freeze()/Unfreeze() calls nest correctly + + + + 在冻结列表视图时执行所需的实际工作 + + + + + 解冻列表视图时执行所需的实际工作 + + + + + 如果选择事件当前挂起，则返回TRUE。在挂起选择事件时，不会引发SelectedIndexChanged或SelectionChanged事件。 + + + + + Suspend selection events until a matching ResumeSelectionEvents() + is called. + + Calls to this method nest correctly. Every call to SuspendSelectionEvents() + must have a matching ResumeSelectionEvents(). + + + + Resume raising selection events. + + + + + Returns a disposable that will disable selection events + during a using() block. + + + + + + Implementation only class that suspends and resumes selection + events on instance creation and disposal. + + + + + 按最后一个排序列和顺序对项目进行排序 + + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的名称 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的索引 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + The column whose values will be used for the sorting. + If null, the first column will be used. + The ordering to be used for sorting. If this is None, + this.Sorting and then SortOrder.Ascending will be used + If ShowGroups is true, the rows will be grouped by the given column. + If AlwaysGroupsByColumn is not null, the rows will be grouped by that column, + and the rows within each group will be sorted by the given column. + + + + Put a sort indicator next to the text of the sort column + + + + + Put a sort indicator next to the text of the given given column + + The column to be marked + The sort order in effect on that column + + + + The name of the image used when a column is sorted ascending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + The name of the image used when a column is sorted descending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + If the sort indicator images don't already exist, this method will make and install them + + + + + Remove any sorting and revert to the given order of the model objects + + + + + Do the actual work of creating the given list of groups + + + + + + For some reason, UseItemStyleForSubItems doesn't work for the colors + when owner drawing the list, so we have to specifically give each subitem + the desired colors + + The item whose subitems are to be corrected + Cells drawn via BaseRenderer don't need this, but it is needed + when an owner drawn cell uses DrawDefault=true + + + + Fill in the given OLVListItem with values of the given row + + the OLVListItem that is to be stuff with values + the model object from which values will be taken + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + + + + Convert the given image selector to an index into our image list. + Return -1 if that's not possible + + + Index of the image in the imageList, or -1 + + + + Return the tooltip that should be shown when the mouse is hovered over the given column + + The column index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回当鼠标悬停在给定单元格上时应显示的工具提示 + + The column index whose tool tip is to be fetched + The row index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回显示给定模型对象的OLVListItem + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Do the work required after the items in a listview have been created + + + + + Do the work required after one item in a listview have been created + + + + + 准备列表视图以显示交替的行背景色 + + We cannot rely on lvi.Index in this method. + In a straight list, lvi.Index is the display index, and can be used to determine + whether the row should be colored. But when organised by groups, lvi.Index is not + useable because it still refers to the position in the overall list, not the display order. + + + + + Setup all subitem images on all rows + + + + + 告诉基础列表控件针对子项显示哪些图像 + + the index at which the item occurs + the item whose subitems are to be set + + + + Tell the underlying list control which images to show against the subitems + + the index at which the item occurs + the item whose subitems are to be set + will existing images be cleared if no new image is provided? + + + + Set the subitem image natively + + + + + + + + + Take ownership of the 'objects' collection. This separats our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + This method has the intentional side-effect of converting our list of objects to an ArrayList. + + + + + + 触发给定项目的FormatRow和可能的FormatCell事件 + + + + + + + + 触发给定项目的FormatCell事件 + + + + + + + + Make the list forget everything -- all rows and all columns + + Use if you want to remove just the rows. + + + + Update our externally visible image list so it holds the same images as our shadow list, but sized correctly + + + + + Return a copy of the given source image list, where each image has been resized to be height x height in size. + If source is null, an empty image list of the given size is returned + + Height and width of the new images + Height and width of the new images + Source of the images (can be null) + A new image list + + + + Return a bitmap of the given height x height, which shows the given image, centred. + + Height and width of new bitmap + Height and width of new bitmap + Image to be centred + The background color + A new bitmap + + + + Initialize the state image list with the required checkbox images + + + + + The name of the image used when a check box is checked + + + + + The name of the image used when a check box is unchecked + + + + + The name of the image used when a check box is Indeterminate + + + + + Setup this control so it can display check boxes on subitems + (or primary checkboxes in virtual mode) + + This gives the ListView a small image list, if it doesn't already have one. + + + + Make sure the small image list for this control has checkbox images + (used for sub-item checkboxes). + + + + This gives the ListView a small image list, if it doesn't already have one. + + + ObjectListView has to manage checkboxes on subitems separate from the checkboxes on each row. + The underlying ListView knows about the per-row checkboxes, and to make them work, OLV has to + correctly configure the StateImageList. However, the ListView cannot do checkboxes in subitems, + so ObjectListView has to handle them in a differnt fashion. So, per-row checkboxes are controlled + by images in the StateImageList, but per-cell checkboxes are handled by images in the SmallImageList. + + + + + + Owner draw the column header + + + + + + Owner draw the item + + + + + + Owner draw a single subitem + + + + + + We need the click count in the mouse up event, but that is always 1. + So we have to remember the click count from the preceding mouse down event. + + + + + + When the mouse leaves the control, remove any hot item highlighting + + + + + + When the mouse moves, we might need to change the hot item. + + + + + + Check to see if we need to start editing a cell + + + + + + Tell the world that a hyperlink was clicked and if the event isn't handled, + do the default processing. + + + + + + Do the default processing for a hyperlink clicked event, which + is to try and open the url. + + + + + + The user right clicked on the control + + + + + + This method is called every time a row is selected or deselected. This can be + a pain if the user shift-clicks 100 rows. We override this method so we can + trigger one event for any number of select/deselects that come from one user action + + + + + + Called when the handle of the underlying control is created + + + + + + This method is called after the control has been fully created. + + + + + Should we start editing the cell in response to the given mouse button event? + + + + + + + Handle a key press on this control. We specifically look for F2 which edits the primary column, + or a Tab character during an edit operation, which tries to start editing on the next (or previous) cell. + + + + + + + Start an editing operation on the first editable column of the given model. + + + + + If the model doesn't exist, or there are no editable columns, this method + will do nothing. + + This will start an edit operation regardless of CellActivationMode. + + + + + + Begin an edit operation on the given cell. + + This performs various sanity checks and passes off the real work to StartCellEdit(). + The row to be edited + The index of the cell to be edited + + + + Really start an edit operation on a given cell. The parameters are assumed to be sane. + + The row to be edited + The index of the cell to be edited + + + + Calculate the bounds of the edit control for the given item/column + + + + + + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is not being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Try to give the given value to the provided control. Fall back to assigning a string + if the value assignment fails. + + A control + The value to be given to the control + The string to be given if the value doesn't work + + + + Setup the given control to be a cell editor + + + + + Return the value that the given control is showing + + + + + + + Called when the cell editor could be about to lose focus. Time to commit the change + + + + + + + Return the bounds of the given cell + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Return the bounds of the given cell only until the edge of the current text + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Calculate the visible bounds of the given column. The column's bottom edge is + either the bottom of the last row or the bottom of the control. + + The bounds of the control itself + The column + A Rectangle + This returns an empty rectnage if the control isn't in Details mode, + OR has doesn't have any rows, OR if the given column is hidden. + + + + Return a control that can be used to edit the value of the given cell. + + The row to be edited + The index of the cell to be edited + A Control to edit the given cell + + + + Get the first non-null value of the given column. + At most 1000 rows will be considered. + + + The first non-null value, or null if no non-null values were found + + + + Return a TextBox that can be used as a default cell editor. + + What column does the cell belong to? + + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + Consider only this many rows + + + + Stop editing a cell and throw away any changes. + + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Remove all trace of any existing cell edit operation + + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + True if the cell editor should be disposed + + + + Force the hot item to be recalculated + + + + + Force the hot item to be recalculated + + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + Where is the mouse? + This is the main entry point for hot item handling + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + + This is the main entry point for hot item handling + + + + Update the given row using the current hot item information + + + + + + Update the given row using the given hot item information + + + + + + + + + Apply a style to the given row + + + + + + + Apply a style to a cell + + + + + + + + Remove hot item styling from the given row + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Add the given decoration to those on this list and make it appear + + The decoration + + A decoration scrolls with the listview. An overlay stays fixed in place. + + + + + Add the given overlay to those on this list and make it appear + + The overlay + + + + Draw all the decorations + + A Graphics + The items that were redrawn and whose decorations should also be redrawn + + + + Is the given decoration shown on this list + + The overlay + + + + Is the given overlay shown on this list? + + The overlay + + + + Hide any overlays. + + + This is only a temporary hiding -- the overlays will be shown + the next time the ObjectListView redraws. + + + + + Create and configure the empty list msg overlay + + + + + Initialize the standard image and text overlays + + + + + Make sure that any overlays are visible. + + + + + Refresh the display of the overlays + + + + + Refresh the display of just one overlays + + + + + Remove the given decoration from this list + + The decoration to remove + + + + Remove the given overlay to those on this list + + The overlay + + + + 创建一个筛选器，该筛选器将执行当前安装在可见列上的所有筛选。 + + + + + Do the actual work of filtering + + + + + + + + + 删除所有列筛选。 + + + + + 根据每列中定义的值筛选更新此ObjectListView的筛选 + + + + + When some setting related to filtering changes, this method is called. + + + + + 使用当前安装的模型过滤器更新所有渲染器 + + + + + 获取给定模型的复选框状态。 + + The model + 模型的复选框状态。默认为未选中。 + + + + 设置给定模型对象的复选框状态 + + The model to be remembered + The model's checkedness + The state given to the method + + + + 忽略任何持久复选框状态 + + + + + The callbacks for CellEditing events + + this + We could replace this with EventHandler<CellEditEventArgs> but that would break all + cell editing event code from v1.x. + + + + + A TreeListView combines an expandable tree structure with list view columns. + + + To support tree operations, two delegates must be provided: + + + + CanExpandGetter + + + This delegate must accept a model object and return a boolean indicating + if that model should be expandable. + + + + + ChildrenGetter + + + This delegate must accept a model object and return an IEnumerable of model + objects that will be displayed as children of the parent model. This delegate will only be called + for a model object if the CanExpandGetter has already returned true for that model. + + + + + ParentGetter + + + This delegate must accept a model object and return the parent model. + This delegate will only be called when HierarchicalCheckboxes is true OR when Reveal() is called. + + + + + The top level branches of the tree are set via the Roots property. SetObjects(), AddObjects() + and RemoveObjects() are interpreted as operations on this collection of roots. + + + To add new children to an existing branch, make changes to your model objects and then + call RefreshObject() on the parent. + + The tree must be a directed acyclic graph -- no cycles are allowed. Put more mundanely, + each model object must appear only once in the tree. If the same model object appears in two + places in the tree, the control will become confused. + + + + + This event is triggered when user input requests the expansion of a list item. + + + + + This event is triggered when user input requests the collapse of a list item. + + + + + This event is triggered after the expansion of a list item due to user input. + + + + + This event is triggered after the collapse of a list item due to user input. + + + + + Trigger the expanding event + + + + + + Trigger the collapsing event + + + + + + Trigger the expanded event + + + + + + Trigger the collapsed event + + + + + + This class handles drawing the tree structure of the primary column. + + + + + Create a TreeRenderer + + + + + Should the renderer draw glyphs at the expansion points? + + The expansion points will still function to expand/collapse even if this is false. + + + + Should the renderer draw lines connecting siblings? + + + + + Return the pen that will be used to draw the lines between branches + + + + + Should the renderer draw triangles as the expansion glyphs? + + + This looks best with ShowLines = false + + + + + Return the branch that the renderer is currently drawing. + + + + + Return the TreeListView for which the renderer is being used. + + + + + How many pixels will be reserved for each level of indentation? + + + + + The real work of drawing the tree is done in this method + + + + + + + Draw the expansion indicator + + + + + + + + Gets whether or not we should render using styles + + + + + Draw the expansion indicator using styles + + + + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the expansion indicator without using styles + + + + + + + + Draw the lines of the tree + + + + + + + + + + Do the hit test + + + + + + + + + Calculate the edit rect + + + + + + + + + + + Make a default TreeListView + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + This is called *often* -- on every mouse move when required. It must be fast. + Don't do database lookups, linear searches, or pi calculations. Just return the + value of a property. + + + When this delegate is called, the TreeListView is not in a stable state. Don't make + calls back into the control. + + + + + + Gets whether or not this listview is capable of showing groups + + + + + This is the delegate that will be used to fetch the children of a model object + + + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + When this delegate is called, the TreeListView is not in a stable state. Don't do anything + that will result in calls being made back into the control. + + + + + + This is the delegate that will be used to fetch the parent of a model object + + The parent of the given model, or null if the model doesn't exist or + if the model is a root + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivalent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + + + + Gets or sets the model objects that are expanded. + + + This can be used to expand model objects before they are seen. + + Setting this does *not* force the control to rebuild + its display. You need to call RebuildAll(true). + + + + + + Gets or sets the filter that is applied to our whole list of objects. + TreeListViews do not currently support whole list filters. + + + + + Gets or sets whether this tree list view will display hierarchical checkboxes. + Hierarchical checkboxes is when a parent's "checkedness" is calculated from + the "checkedness" of its children. If all children are checked, the parent + will be checked. If all children are unchecked, the parent will also be unchecked. + If some children are checked and others are not, the parent will be indeterminate. + + + Hierarchical checkboxes don't work with either CheckStateGetters or CheckedAspectName + (which is basically the same thing). This is because it is too expensive to build the + initial state of the control if these are installed, since the control would have to walk + *every* branch recursively since a single bottom level leaf could change the checkedness + of the top root. + + + + + Gets or sets the collection of root objects of the tree + + + + + Gets the collection of objects that will be considered when creating clusters + (which are used to generate Excel-like column filters) + + + + + After expanding a branch, should the TreeListView attempts to show as much of the + revealed descendents as possible. + + + + + The model objects that form the top level branches of the tree. + + Setting this does NOT reset the state of the control. + In particular, it does not collapse branches. + + + + Make sure that at least one column is displaying a tree. + If no columns is showing the tree, make column 0 do it. + + + + + Gets or sets the renderer that will be used to draw the tree structure. + Setting this to null resets the renderer to default. + + If a column is currently rendering the tree, the renderer + for that column will be replaced. If no column is rendering the tree, + column 0 will be given this renderer. + + + + This is the delegate that will be used to create the underlying Tree structure + that the TreeListView uses to manage the information about the tree. + + + The factory must not return null. + + Most users of TreeListView will never have to use this delegate. + + + + + + Should a wait cursor be shown when a branch is being expanded? + + When this is true, the wait cursor will be shown whilst the children of the + branch are being fetched. If the children of the branch have already been cached, + the cursor will not change. + + + + Gets the model that is used to manage the tree structure + + + Don't mess with this property unless you really know what you are doing. + If you don't already know what it's for, you don't need it. + + + + Return true if the branch at the given model is expanded + + + + + + + Collapse the subtree underneath the given model + + + + + + Collapse all subtrees within this control + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Collapse all roots and forget everything we know about all models + + + + + Expand the subtree underneath the given model object + + + + + + Expand all the branches within this tree recursively. + + Be careful: this method could take a long time for large trees. + + + + Completely rebuild the tree structure + + If true, the control will try to preserve selection and expansion + + + + Completely rebuild the tree structure + + If not null, this list of objects will be selected after the tree is rebuilt + If not null, this collection of objects will be expanded after the tree is rebuilt + If not null, this collection of objects will be checked after the tree is rebuilt + + + + Unroll all the ancestors of the given model and make sure it is then visible. + + This works best when a ParentGetter is installed. + The object to be revealed + If true, the model will be selected and focused after being revealed + True if the object was found and revealed. False if it was not found. + + + + Update the rows that are showing the given objects + + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the expanded state of the branch at the given model object + + + + + + Return whether or not the given model can expand. + + + The given model must have already been seen in the tree + + + + Return the model object that is the parent of the given model object. + + + + The given model must have already been seen in the tree. + + + + Return the collection of model objects that are the children of the + given model as they exist in the tree at the moment. + + + + + This method returns the collection of children as the tree knows them. If the given + model has never been presented to the user (e.g. it belongs to a parent that has + never been expanded), then this method will return an empty collection. + + Because of this, if you want to traverse the whole tree, this is not the method to use. + It's better to traverse the your data model directly. + + + If the given model has not already been seen in the tree or + if it is not expandable, an empty collection will be returned. + + + + + + Delegates of this type are use to decide if the given model object can be expanded + + The model under consideration + Can the given model be expanded? + + + + Delegates of this type are used to fetch the children of the given model object + + The parent whose children should be fetched + An enumerable over the children + + + + Delegates of this type are used to fetch the parent of the given model object. + + The child whose parent should be fetched + The parent of the child or null if the child is a root + + + + Delegates of this type are used to create a new underlying Tree structure. + + The view for which the Tree is being created + A subclass of Tree + + + + Handle a left button down event + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + This differs from the base method by also setting up the IndentCount property. + + + + Reinitialize the Tree structure + + + + + Recalculate the state of the checkboxes of all the items in the given list + and their ancestors. + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Recalculate the hierarchy state of the given item and its ancestors + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Yield the unique ancestors of the given collection of objects. + The order of the ancestors is guaranteed to be deeper objects first. + Roots will always be last. + + + Unique ancestors of the given objects + + + + Return all the ancestors of the given model + + + + This uses ParentGetter if possible. + + If the given model is a root OR if the model doesn't exist, the collection will be empty + + The model whose ancestors should be calculated + Return a collection of ancestors of the given model. + + + + The application is idle and a SelectionChanged event has been scheduled + + + + + + + Decide if the given key event should be handled as a normal key input to the control? + + + + + + + Handle focus being lost, including making sure that the whole control is redrawn. + + + + + + Handle the keyboard input to mimic a TreeView. + + + Was the key press handled? + + + + A Tree object represents a tree structure data model that supports both + tree and flat list operations as well as fast access to branches. + + If you create a subclass of Tree, you must install it in the TreeListView + via the TreeFactory delegate. + + + + Create a Tree + + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + + This is the delegate that will be used to fetch the children of a model object + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + + Get or return the top level model objects in the tree + + + + + What tree view is this Tree the model for? + + + + + Collapse the subtree underneath the given model + + The model to be collapsed. If the model isn't in the tree, + or if it is already collapsed, the command does nothing. + The index of the model in flat list version of the tree + + + + Collapse all branches in this tree + + Nothing useful + + + + Expand the subtree underneath the given model object + + The model to be expanded. + The index of the model in flat list version of the tree + + If the model isn't in the tree, + if it cannot be expanded or if it is already expanded, the command does nothing. + + + + + Expand all branches in this tree + + Return the index of the first branch that was expanded + + + + Return the Branch object that represents the given model in the tree + + The model whose branches is to be returned + The branch that represents the given model, or null if the model + isn't in the tree. + + + + Return the number of visible descendents that are below the given model. + + The model whose descendent count is to be returned + The number of visible descendents. 0 if the model doesn't exist or is collapsed + + + + Rebuild the children of the given model, refreshing any cached information held about the given object + + + The index of the model in flat list version of the tree + + + + Is the given model expanded? + + + + + + + Remember whether or not the given model was expanded + + + + + + + Insert the children of the given branch into the given position + + The branch whose children should be inserted + The index where the children should be inserted + + + + Rebuild our flat internal list of objects. + + + + + Rebuild our reverse index that maps an object to its location + in the filteredObjectList array. + + + + + + Create a new branch within this tree + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Sort the tree on the given column and in the given order + + + + + + + + + + + + + Add the given collection of objects to the roots of this tree + + + + + + + + + + + + + Remove all of the given objects from the roots of the tree. + Any objects that is not already in the roots collection is ignored. + + + + + + Set the roots of this tree to be the given collection + + + + + + Update/replace the nth object with the given object + + + + + + + + + + + + + + Is this list currently being filtered? + + + + + Should the given model be included in this control? + + The model to consider + True if it will be included + + + + + + + + + + + + + + A Branch represents a sub-tree within a tree + + + + + Indicators for branches + + + + + FirstBranch of tree + + + + + LastChild of parent + + + + + OnlyBranch of tree + + + + + Create a Branch + + + + + + + + Get the ancestor branches of this branch, with the 'oldest' ancestor first. + + + + + Can this branch be expanded? + + + + + Gets or sets our children + + + + + Get/set the model objects that are beneath this branch + + + + + Gets a list of all the branches that survive filtering + + + + + Gets or set whether this branch is expanded + + + + + Return true if this branch is the first branch of the entire tree + + + + + Return true if this branch is the last child of its parent + + + + + Return true if this branch is the only top level branch + + + + + Gets the depth level of this branch + + + + + Gets or sets which model is represented by this branch + + + + + Return the number of descendents of this branch that are currently visible + + + + + + Gets or sets our parent branch + + + + + Gets or sets our overall tree + + + + + Is this branch currently visible? A branch is visible + if it has no parent (i.e. it's a root), or its parent + is visible and expanded. + + + + + Clear any cached information that this branch is holding + + + + + Collapse this branch + + + + + Expand this branch + + + + + Expand this branch recursively + + + + + Collapse all branches in this tree + + Nothing useful + + + + Fetch the children of this branch. + + This should only be called when CanExpand is true. + + + + Collapse the visible descendents of this branch into list of model objects + + + + + + Flatten this branch's visible descendents onto the given list. + + + The branch itself is not included in the list. + + + + Force a refresh of all children recursively + + + + + Sort the sub-branches and their descendents so they are ordered according + to the given comparer. + + The comparer that orders the branches + + + + This class sorts branches according to how their respective model objects are sorted + + + + + Create a BranchComparer + + + + + + Order the two branches + + + + + + + + Let the world know that a cell edit operation is beginning or ending + + + + + Create an event args + + + + + + + + + + Change this to true to cancel the cell editing operation. + + + During the CellEditStarting event, setting this to true will prevent the cell from being edited. + During the CellEditFinishing event, if this value is already true, this indicates that the user has + cancelled the edit operation and that the handler should perform cleanup only. Setting this to true, + will prevent the ObjectListView from trying to write the new value into the model object. + + + + + During the CellEditStarting event, this can be modified to be the control that you want + to edit the value. You must fully configure the control before returning from the event, + including its bounds and the value it is showing. + During the CellEditFinishing event, you can use this to get the value that the user + entered and commit that value to the model. Changing the control during the finishing + event has no effect. + + + + + The column of the cell that is going to be or has been edited. + + + + + The model object of the row of the cell that is going to be or has been edited. + + + + + The listview item of the cell that is going to be or has been edited. + + + + + The data value of the cell as it stands in the control. + + Only validate during Validating and Finishing events. + + + + The index of the cell that is going to be or has been edited. + + + + + The data value of the cell before the edit operation began. + + + + + The bounds of the cell that is going to be or has been edited. + + + + + Gets or sets whether the control used for editing should be auto matically disposed + when the cell edit operation finishes. Defaults to true + + If the control is expensive to create, you might want to cache it and reuse for + for various cells. If so, you don't want ObjectListView to dispose of the control automatically + + + + Event blocks for events that can be cancelled + + + + + Has this event been cancelled by the event handler? + + + + + BeforeSorting + + + + + Create BeforeSortingEventArgs + + + + + + + + + Create BeforeSortingEventArgs + + + + + + + + + + + Did the event handler already do the sorting for us? + + + + + What column will be used for grouping + + + + + How will groups be ordered + + + + + What column will be used for sorting + + + + + What order will be used for sorting. None means no sorting. + + + + + What column will be used for secondary sorting? + + + + + What order will be used for secondary sorting? + + + + + Sorting has just occurred. + + + + + Create a AfterSortingEventArgs + + + + + + + + + + + Create a AfterSortingEventArgs + + + + + + What column was used for grouping? + + + + + What ordering was used for grouping? + + + + + What column was used for sorting? + + + + + What ordering was used for sorting? + + + + + What column was used for secondary sorting? + + + + + What order was used for secondary sorting? + + + + + This event is triggered when the contents of a list have changed + and we want the world to have a chance to filter the list. + + + + + Create a FilterEventArgs + + + + + + Gets or sets what objects are being filtered + + + + + Gets or sets what objects survived the filtering + + + + + This event is triggered after the items in the list have been changed, + either through SetObjects, AddObjects or RemoveObjects. + + + + + Create a ItemsChangedEventArgs + + + + + Constructor for this event when used by a virtual list + + + + + + + Gets how many items were in the list before it changed + + + + + Gets how many objects are in the list after the change. + + + + + This event is triggered by AddObjects before any change has been made to the list. + + + + + Create an ItemsAddingEventArgs + + + + + + Create an ItemsAddingEventArgs + + + + + + + Gets or sets where the collection is going to be inserted. + + + + + Gets or sets the objects to be added to the list + + + + + This event is triggered by SetObjects before any change has been made to the list. + + + When used with a virtual list, OldObjects will always be null. + + + + + Create ItemsChangingEventArgs + + + + + + + Gets the objects that were in the list before it change. + For virtual lists, this will always be null. + + + + + Gets or sets the objects that will be in the list after it changes. + + + + + This event is triggered by RemoveObjects before any change has been made to the list. + + + + + Create an ItemsRemovingEventArgs + + + + + + Gets or sets the objects that will be removed + + + + + Triggered after the user types into a list + + + + + Create an AfterSearchingEventArgs + + + + + + + Gets the string that was actually searched for + + + + + Gets or sets whether an the event handler already handled this event + + + + + Gets the index of the row that was selected by the search. + -1 means that no row was matched + + + + + Triggered when the user types into a list + + + + + Create BeforeSearchingEventArgs + + + + + + + Gets or sets the string that will be found by the search routine + + Modifying this value does not modify the memory of what the user has typed. + When the user next presses a character, the search string will revert to what + the user has actually typed. + + + + Gets or sets the index of the first row that will be considered to matching. + + + + + The parameter block when telling the world about a cell based event + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + This is null for events triggered by the header. + + + + Gets the row index of the cell + + This is -1 for events triggered by the header. + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the location of the mouse at the time of the event + + + + + Gets the state of the modifier keys at the time of the event + + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view and + for event triggered by the header + + + + Gets the HitTest object that determined which cell was hit + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Tells the world that a cell was clicked + + + + + Gets or sets the number of clicks associated with this event + + + + + Tells the world that a cell was right clicked + + + + + Gets or sets the menu that should be displayed as a result of this event. + + The menu will be positioned at Location, so changing that property changes + where the menu will be displayed. + + + + Tell the world that the mouse is over a given cell + + + + + Tells the world that the frozen-ness of the ObjectListView has changed. + + + + + Make a FreezeEventArgs + + + + + + How frozen is the control? 0 means that the control is unfrozen, + more than 0 indicates froze. + + + + + The parameter block when telling the world that a tool tip is about to be shown. + + + + + Gets the tooltip control that is triggering the tooltip event + + + + + Gets or sets the text should be shown on the tooltip for this event + + Setting this to empty or null prevents any tooltip from showing + + + + In what direction should the text for this tooltip be drawn? + + + + + Should the tooltip for this event been shown in bubble style? + + This doesn't work reliable under Vista + + + + What color should be used for the background of the tooltip + + Setting this does nothing under Vista + + + + What color should be used for the foreground of the tooltip + + Setting this does nothing under Vista + + + + What string should be used as the title for the tooltip for this event? + + + + + Which standard icon should be used for the tooltip for this event + + + + + How many milliseconds should the tooltip remain before it automatically + disappears. + + + + + What font should be used to draw the text of the tooltip? + + + + + Common information to all hyperlink events + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the ObjectListView that is the source of the event + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the text of the cell + + + + + Gets or sets whether or not this cell is a hyperlink. + Defaults to true for enabled rows and false for disabled rows. + + + + + Gets or sets the url that should be invoked when this cell is clicked. + + Setting this to None or String.Empty means that this cell is not a hyperlink + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the item of the cell + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the display index of the row + + + + + Should events be triggered for each cell in this row? + + + + + Parameter block for FormatCellEvent + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the model value that is being displayed by the cell. + + This is null when the view is not in details view + + + + The event args when a hyperlink is clicked + + + + + Gets the url that was associated with this cell. + + + + + The event args when the check box in a column header is changing + + + + + Get the column whose checkbox is changing + + + + + Get or set the new state that should be used by the column + + + + + The event args when the hot item changed + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Gets the part of the cell that the mouse is over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + Gets the index of the column that the mouse is over + + In non-details view, this will always be 0. + + + + Gets the index of the row that the mouse is over + + + + + Gets the group that the mouse is over + + + + + Gets the part of the cell that the mouse used to be over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse used to be over + + + + + Gets the index of the column that the mouse used to be over + + + + + Gets the index of the row that the mouse used to be over + + + + + Gets the group that the mouse used to be over + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + Let the world know that a checkbox on a subitem is changing + + + + + Create a new event block + + + + + + + + + + The column of the cell that is having its checkbox changed. + + + + + The model object of the row of the cell that is having its checkbox changed. + + + + + The listview item of the cell that is having its checkbox changed. + + + + + The current check state of the cell. + + + + + The proposed new check state of the cell. + + + + + The index of the cell that is going to be or has been edited. + + + + + This event argument block is used when groups are created for a list. + + + + + Create a CreateGroupsEventArgs + + + + + + Gets the settings that control the creation of groups + + + + + Gets or sets the groups that should be used + + + + + Has this event been cancelled by the event handler? + + + + + This event argument block is used when the text of a group task is clicked + + + + + Create a GroupTaskClickedEventArgs + + + + + + Gets which group was clicked + + + + + This event argument block is used when a group is about to expand or collapse + + + + + Create a GroupExpandingCollapsingEventArgs + + + + + + Gets which group is expanding/collapsing + + + + + Gets whether this event is going to expand the group. + If this is false, the group must be collapsing. + + + + + This event argument block is used when the state of group has changed (collapsed, selected) + + + + + Create a GroupStateChangedEventArgs + + + + + + + + Gets whether the group was collapsed by this event + + + + + Gets whether the group was focused by this event + + + + + Gets whether the group was selected by this event + + + + + Gets whether the group was uncollapsed by this event + + + + + Gets whether the group was unfocused by this event + + + + + Gets whether the group was unselected by this event + + + + + Gets which group had its state changed + + + + + Gets the previous state of the group + + + + + Gets the new state of the group + + + + + This event argument block is used when a branch of a tree is about to be expanded + + + + + Create a new event args + + + + + + + Gets the model that is about to expand. If null, all branches are going to be expanded. + + + + + Gets the OLVListItem that is about to be expanded + + + + + This event argument block is used when a branch of a tree has just been expanded + + + + + Create a new event args + + + + + + + Gets the model that is was expanded. If null, all branches were expanded. + + + + + Gets the OLVListItem that was expanded + + + + + This event argument block is used when a branch of a tree is about to be collapsed + + + + + Create a new event args + + + + + + + Gets the model that is about to collapse. If this is null, all models are going to collapse. + + + + + Gets the OLVListItem that is about to be collapsed. Can be null + + + + + This event argument block is used when a branch of a tree has just been collapsed + + + + + Create a new event args + + + + + + + Gets the model that is was collapsed. If null, all branches were collapsed + + + + + Gets the OLVListItem that was collapsed + + + + + This class contains all the settings used when groups are created + + + + + Create a GroupingParameters + + + + + + + + + + + + + + + Gets or sets the ObjectListView being grouped + + + + + Gets or sets the column used to create groups + + + + + In what order will the groups themselves be sorted? + + + + + If this is set, this comparer will be used to order the groups + + + + + If this is set, this comparer will be used to order items within each group + + + + + Gets or sets the column that will be the primary sort + + + + + Gets or sets the ordering for the primary sort + + + + + Gets or sets the column used for secondary sorting + + + + + Gets or sets the ordering for the secondary sort + + + + + Gets or sets the title format used for groups with zero or more than one element + + + + + Gets or sets the title format used for groups with only one element + + + + + Gets or sets whether the items should be sorted by the primary column + + + + + These values indicate what is the state of the group. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + Normal + + + + + Collapsed + + + + + Hidden + + + + + NoHeader + + + + + Can be collapsed + + + + + Has focus + + + + + Is Selected + + + + + Is subsetted + + + + + Subset link has focus + + + + + All styles + + + + + This mask indicates which members of a LVGROUP have valid data. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + No mask + + + + + Group has header + + + + + Group has footer + + + + + Group has state + + + + + + + + + + + + + + + pszSubtitle is valid + + + + + pszTask is valid + + + + + pszDescriptionTop is valid + + + + + pszDescriptionBottom is valid + + + + + iTitleImage is valid + + + + + iExtendedImage is valid + + + + + iFirstItem and cItems are valid + + + + + pszSubsetTitle is valid + + + + + readonly, cItems holds count of items in visible subset, iFirstItem is valid + + + + + This mask indicates which members of a GROUPMETRICS structure are valid + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class enhance the capabilities of a normal ListViewGroup, + enabling the functionality that was released in v6 of the common controls. + + + + In this implementation (2009-09), these objects are essentially passive. + Setting properties does not automatically change the associated group in + the listview. Collapsed and Collapsible are two exceptions to this and + give immediate results. + + + This really should be a subclass of ListViewGroup, but that class is + sealed (why is that?). So this class provides the same interface as a + ListViewGroup, plus many other new properties. + + + + + + Create an OLVGroup + + + + + 按指定标题创建分组 + + 分组标题 + + + + Gets or sets the bottom description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets whether or not this group is collapsed + + + + + Gets or sets whether or not this group can be collapsed + + + + + Gets or sets some representation of the contents of this group + + This is user defined (like Tag) + + + + Gets whether this group has been created. + + + + + Gets or sets the int or string that will select the extended image to be shown against the title + + + + + Gets or sets the footer of the group + + + + + Gets the internal id of our associated ListViewGroup. + + + + + Gets or sets the header of the group + + + + + Gets or sets the horizontal alignment of the group header + + + + + Gets or sets the internally created id of the group + + + + + Gets or sets ListViewItems that are members of this group + + Listener of the BeforeCreatingGroups event can populate this collection. + It is only used on non-virtual lists. + + + + Gets or sets the key that was used to partition objects into this group + + This is user defined (like Tag) + + + + Gets the ObjectListView that this group belongs to + + If this is null, the group has not yet been created. + + + + Gets or sets the name of the group + + As of 2009-09-01, this property is not used. + + + + Gets or sets whether this group is focused + + + + + Gets or sets whether this group is selected + + + + + Gets or sets the text that will show that this group is subsetted + + + As of WinSDK v7.0, subsetting of group is officially unimplemented. + We can get around this using undocumented interfaces and may do so. + + + + + Gets or set the subtitleof the task + + + + + Gets or sets the value by which this group will be sorted. + + + + + Gets or sets the state of the group + + + + + Gets or sets which bits of State are valid + + + + + Gets or sets whether this group is showing only a subset of its elements + + + As of WinSDK v7.0, this property officially does nothing. + + + + + Gets or sets the user-defined data attached to this group + + + + + Gets or sets the task of this group + + This task is the clickable text that appears on the right margin + of the group header. + + + + Gets or sets the int or string that will select the image to be shown against the title + + + + + Gets or sets the top description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets the number of items that are within this group. + + This should only be used for virtual groups. + + + + Gets or sets the ListViewGroup that is shadowed by this group. + + For virtual groups, this will always be null. + + + + Calculate the index into the group image list of the given image selector + + + + + + + Convert this object to a string representation + + + + + + Insert a native group into the underlying Windows control, + *without* using a ListViewGroup + + + This is used when creating virtual groups + + + + Insert a native group into the underlying control via a ListViewGroup + + + + + + Change the members of the group to match the current contents of Items, + using a ListViewGroup + + + + + Create a native LVGROUP structure that matches this group + + + + + Get the current state of this group from the underlying control + + + + + Get the current state of this group from the underlying control + + + + + An instance of Munger gets a value from or puts a value into a target object. The property + to be peeked (or poked) is determined from a string. The peeking or poking is done using reflection. + + + Name of the aspect to be peeked can be a field, property or parameterless method. The name of an + aspect to poke can be a field, writable property or single parameter method. + + Aspect names can be dotted to chain a series of references. + + Order.Customer.HomeAddress.State + + + + + Create a do nothing Munger + + + + + Create a Munger that works on the given aspect name + + The name of the + + + + A helper method to put the given value into the given aspect of the given object. + + This method catches and silently ignores any errors that occur + while modifying the target object + The object to be modified + The name of the property/field to be modified + The value to be assigned + Did the modification work? + + + + Gets or sets whether Mungers will silently ignore missing aspect errors. + + + + By default, if a Munger is asked to fetch a field/property/method + that does not exist from a model, it returns an error message, since that + condition is normally a programming error. There are some use cases where + this is not an error, and the munger should simply keep quiet. + + By default this is true during release builds. + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or parameter-less method. + + + The name can be dotted, which chains references. If any link in the chain returns + null, the entire chain is considered to return null. + + + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + Extract the value indicated by our AspectName from the given target. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Extract the value indicated by our AspectName from the given target, raising exceptions + if the munger fails. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Poke the given value into the given target indicated by our AspectName. + + + + If the AspectName is a dotted path, all the selectors bar the last + are used to find the object that should be updated, and the last + selector is used as the property to update on that object. + + + So, if 'target' is a Person and the AspectName is "HomeAddress.Postcode", + this method will first fetch "HomeAddress" property, and then try to set the + "Postcode" property on the home address object. + + + The object that will be poked + The value that will be poked into the target + bool indicating whether the put worked + + + + Gets the list of SimpleMungers that match our AspectName + + + + + Convert a possibly dotted AspectName into a list of SimpleMungers + + + + + + + Evaluate the given chain of SimpleMungers against an initial target. + + + + + + + + A SimpleMunger deals with a single property/field/method on its target. + + + Munger uses a chain of these resolve a dotted aspect name. + + + + + Create a SimpleMunger + + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or method. + When using a method to get a value, the method must be parameter-less. + When using a method to set a value, the method must accept 1 parameter. + + + It cannot be a dotted name. + + + + + + Get a value from the given target + + + + + + + Poke the given value into the given target indicated by our AspectName. + + The object that will be poked + The value that will be poked into the target + bool indicating if the put worked + + + + These exceptions are raised when a munger finds something it cannot process + + + + + Create a MungerException + + + + + + + + Get the munger that raised the exception + + + + + Gets the target that threw the exception + + + + + Wrapper for all native method calls on ListView controls + + + + + Put an image under the ListView. + + + + The ListView must have its handle created before calling this. + + + This doesn't work very well. Specifically, it doesn't play well with owner drawn, + and grid lines are drawn over it. + + + + The image to be used as the background. If this is null, any existing background image will be cleared. + If this is true, the image is pinned to the bottom right and does not scroll. The other parameters are ignored + If this is true, the image will be tiled to fill the whole control background. The offset parameters will be ignored. + If both watermark and tiled are false, this indicates the horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + If both watermark and tiled are false, this indicates the vertical percentage where the image will be placed. + + + + + Flags controlling how the Image List item is + drawn + + + + + Draw item normally. + + + + + Draw item transparently. + + + + + Draw item blended with 25% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw item blended with 50% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw the icon's mask + + + + + Draw the icon image without using the mask + + + + + Draw the icon using the ROP specified. + + + + + Preserves the alpha channel in dest. XP only. + + + + + Scale the image to cx, cy instead of clipping it. XP only. + + + + + Scale the image to the current DPI of the display. XP only. + + + + + Enumeration containing XP ImageList Draw State options + + + + + The image state is not modified. + + + + + Adds a glow effect to the icon, which causes the icon to appear to glow + with a given color around the edges. (Note: does not appear to be implemented) + + + + + Adds a drop shadow effect to the icon. (Note: does not appear to be implemented) + + + + + Saturates the icon by increasing each color component + of the RGB triplet for each pixel in the icon. (Note: only ever appears to result in a completely unsaturated icon) + + + + + Alpha blends the icon. Alpha blending controls the transparency + level of an icon, according to the value of its alpha channel. + (Note: does not appear to be implemented). + + + + + Draws an image using the specified flags and state on XP systems. + + The image list from which an item will be drawn + Device context to draw to + Index of image to draw + X Position to draw at + Y Position to draw at + Drawing flags + Width to draw + Height to draw + State flags + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + Change the virtual list size of the given ListView (which must be in virtual mode) + + This will not change the scroll position + The listview to send a message to + How many rows should the list have? + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + + + Calculates the number of items that can fit vertically in the visible area of a list-view (which + must be in details or list view. + + The listView + Number of visible items per page + + + + For the given item and subitem, make it display the given image + + The listview to send a m to + row number (0 based) + subitem (0 is the item itself) + index into the image list + + + + Setup the given column of the listview to show the given image to the right of the text. + If the image index is -1, any previous image is cleared + + The listview to send a m to + Index of the column to modifiy + + Index into the small image list + + + + Does this version of the operating system have builtin sort indicators? + + Are there builtin sort indicators + XP and later have these + + + + Return the bounds of the update region on the given control. + + The BeginPaint() system call validates the update region, effectively wiping out this information. + So this call has to be made before the BeginPaint() call. + The control whose update region is be calculated + A rectangle + + + + Validate an area of the given control. A validated area will not be repainted at the next redraw. + + The control to be validated + The area of the control to be validated + + + + Select all rows on the given listview + + The listview whose items are to be selected + + + + Deselect all rows on the given listview + + The listview whose items are to be deselected + + + + Deselect a single row + + + + + + + Set the item state on the given item + + The listview whose item's state is to be changed + The index of the item to be changed + Which bits of the value are to be set? + The value to be set + + + + Scroll the given listview by the given deltas + + + + + true if the scroll succeeded + + + + Return the handle to the header control on the given list + + The listview whose header control is to be returned + The handle to the header control + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the index of the column of the header that is under the given point. + Return -1 if no column is under the pt + + The list we are interested in + The client co-ords + The index of the column under the point, or -1 if no column header is under that point + + + + Return the index of the divider under the given point. Return -1 if no divider is under the pt + + The list we are interested in + The client co-ords + The index of the divider under the point, or -1 if no divider is under that point + + + + Get the scroll position of the given scroll bar + + + + + + + + Change the z-order to the window 'toBeMoved' so it appear directly on top of 'reference' + + + + + + + + Make the given control/window a topmost window + + + + + + + Change the size of the window without affecting any other attributes + + + + + + + + + Show the given window without activating it + + The window to show + + + + Mark the given column as being selected. + + + The OLVColumn or null to clear + + This method works, but it prevents subitems in the given column from having + back colors. + + + + + A simple-minded implementation of a Dictionary that can handle null as a key. + + The type of the dictionary key + The type of the values to be stored + This is not a full implementation and is only meant to handle + collecting groups by their keys, since groups can have null as a key value. + + + + OLVListItems are specialized ListViewItems that know which row object they came from, + and the row index at which they are displayed, even when in group view mode. They + also know the image they should draw against themselves + + + + + Create a OLVListItem for the given row object + + + + + Create a OLVListItem for the given row object, represented by the given string and image + + + + + Gets the bounding rectangle of the item, including all subitems + + + + + Gets or sets how many pixels will be left blank around each cell of this item + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how the cells of this item will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the checkedness of this item. + + + Virtual lists don't handle checkboxes well, so we have to intercept attempts to change them + through the items, and change them into something that will work. + Unfortunately, this won't work if this property is set through the base class, since + the property is not declared as virtual. + + + + + Enable tri-state checkbox. + + .NET's Checked property was not built to handle tri-state checkboxes, + and will return True for both Checked and Indeterminate states. + + + + Gets if this item has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Gets whether or not this row can be selected and activated + + + + + Gets whether any cell on this item is showing a hyperlink + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the the model object that is source of the data for this list item. + + + + + Gets or sets the color that will be used for this row's background when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection BackColor will be used. + + + + + + Gets or sets the color that will be used for this row's foreground when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection ForeColor will be used. + + + + + + Return the sub item at the given index + + Index of the subitem to be returned + An OLVListSubItem + + + + Return bounds of the given subitem + + This correctly calculates the bounds even for column 0. + + + + A ListViewSubItem that knows which image should be drawn against it. + + + + + Create a OLVListSubItem + + + + + Create a OLVListSubItem that shows the given string and image + + + + + Gets or sets how many pixels will be left blank around this cell + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how this cell will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the model value is being displayed by this subitem. + + + + + Gets if this subitem has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the url that should be invoked when this subitem is clicked + + + + + Gets or sets whether this cell is selected + + + + + Return the state of the animatation of the image on this subitem. + Null means there is either no image, or it is not an animation + + + + + An indication of where a hit was within ObjectListView cell + + + + + Nowhere + + + + + On the text + + + + + On the image + + + + + On the checkbox + + + + + On the expand button (TreeListView) + + + + + in a button (cell must have ButtonRenderer) + + + + + in the cell but not in any more specific location + + + + + UserDefined location1 (used for custom renderers) + + + + + On the expand/collapse widget of the group + + + + + Somewhere on a group + + + + + Somewhere in a column header + + + + + Somewhere in a column header checkbox + + + + + Somewhere in a header divider + + + + + A collection of ListViewHitTest constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class encapsulate the information gathered during a OlvHitTest() + operation. + + Custom renderers can use HitTestLocation.UserDefined and the UserData + object to store more specific locations for use during event handlers. + + + + Create a OlvListViewHitTestInfo + + + + + Create a OlvListViewHitTestInfo when the header was hit + + + + + Where is the hit location? + + + + + Where is the hit location? + + + + + Which group was hit? + + + + + Custom renderers can use this information to supply more details about the hit location + + + + + Gets the item that was hit + + + + + Gets the subitem that was hit + + + + + Gets the part of the subitem that was hit + + + + + Gets the ObjectListView that was tested + + + + + Gets the model object that was hit + + + + + Gets the index of the row under the hit point or -1 + + + + + Gets the index of the column under the hit point + + + + + Gets the index of the header divider + + + + + Gets the column that was hit + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + A TreeDataSourceAdapter knows how to build a tree structure from a binding list. + + To build a tree + + + + Create a data source adaptor that knows how to build a tree structure + + + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets the DataTreeListView that is being managed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A IVirtualGroups is the interface that a virtual list must implement to support virtual groups + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + This is a safe, do nothing implementation of a grouping strategy + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + Provides grouping functionality to a FastObjectListView + + + + + Create groups for FastListView + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This is the COM interface that a ListView must be given in order for groups in virtual lists to work. + + + This interface is NOT documented by MS. It was found on Greg Chapell's site. This means that there is + no guarantee that it will work on future versions of Windows, nor continue to work on current ones. + + + + + Not sure what this does + + + + + + + Not sure what this does + + + + + + + Get the index of the item that occurs at the n'th position of the indicated group. + + Index of the group + Index within the group + Index of the item within the whole list + + + + Get the index of the group to which the given item belongs + + Index of the item within the whole list + Which occurences of the item is wanted + Index of the group + + + + Get the number of groups that contain the given item + + Index of the item within the whole list + How many groups does it occur within + + + + A hint to prepare any cache for the given range of requests + + + + + + + A default implementation of the IOwnerDataCallback interface + + + + + A VirtualListDataSource is a complete manner to provide functionality to a virtual list. + An object that implements this interface provides a VirtualObjectListView with all the + information it needs to be fully functional. + + Implementors must provide functioning implementations of at least GetObjectCount() + and GetNthObject(), otherwise nothing will appear in the list. + + + + Return the object that should be displayed at the n'th row. + + The index of the row whose object is to be returned. + The model object at the n'th row, or null if the fetching was unsuccessful. + + + + Return the number of rows that should be visible in the virtual list + + The number of rows the list view should have. + + + + Get the index of the row that is showing the given model object + + The model object sought + The index of the row showing the model, or -1 if the object could not be found. + + + + The ListView is about to request the given range of items. Do + whatever caching seems appropriate. + + + + + + + Find the first row that "matches" the given text in the given range. + + The text typed by the user + Start searching from this index. This may be greater than the 'to' parameter, + in which case the search should descend + Do not search beyond this index. This may be less than the 'from' parameter. + The column that should be considered when looking for a match. + Return the index of row that was matched, or -1 if no match was found + + + + Sort the model objects in the data source. + + + + + + + Add the given collection of model objects to this control. + + A collection of model objects + + + + Insert the given collection of model objects to this control at the position + + Index where the collection will be added + A collection of model objects + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + + + Set the collection of objects that this control will show. + + + + + + Update/replace the nth object with the given object + + + + + + + This extension allow virtual lists to filter their contents + + + + + All subsequent retrievals on this data source should be filtered + through the given filters. null means no filtering of that kind. + + + + + + + A do-nothing implementation of the VirtualListDataSource interface. + + + + + Creates an AbstractVirtualListDataSource + + + + + + The list view that this data source is giving information to. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + This is a useful default implementation of SearchText method, intended to be called + by implementors of IVirtualListDataSource. + + + + + + + + + + + + + + + + + + This class mimics the behavior of VirtualObjectListView v1.x. + + + + + Creates a VirtualListVersion1DataSource + + + + + + How will the n'th object of the data source be fetched? + + + + + + + + + + + + + + + + + + + + + + Designer for and its subclasses. + + + + This designer removes properties and events that are available on ListView but that are not + useful on ObjectListView. + + + We can't inherit from System.Windows.Forms.Design.ListViewDesigner, since it is marked internal. + So, this class uses reflection to create a ListViewDesigner and then forwards messages to that designer. + + + + + + Initializes the designer with the specified component. + + The to associate the designer with. This component must always be an instance of, or derive from, . + + + + Initializes a newly created component. + + A name/value dictionary of default values to apply to properties. May be null if no default values are specified. + + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Removes the duplicate DockingActionList added by this designer to the . + + + adds an internal DockingActionList : 'Dock/Undock in Parent Container'. + But the default designer has already added that action list. So we need to remove one. + + + + + Adjusts the set of properties the component exposes through a . + + An containing the properties for the class of the component. + + + + Allows a designer to add to the set of events that it exposes through a . + + The events for the class of the component. + + + + Allows a designer to change or remove items from the set of attributes that it exposes through a . + + The attributes for the class of the component. + + + + Allows a designer to change or remove items from the set of events that it exposes through a . + + The events for the class of the component. + + + + Gets the design-time action lists supported by the component associated with the designer. + + + The design-time action lists supported by the component associated with the designer. + + + + + Gets the collection of components associated with the component managed by the designer. + + + The components that are associated with the component managed by the designer. + + + + + Indicates whether a mouse click at the specified point should be handled by the control. + + + true if a click at the specified point is to be handled by the control; otherwise, false. + + A indicating the position at which the mouse was clicked, in screen coordinates. + + + + Processes Windows messages and optionally routes them to the control. + + The to process. + + + + This class modifies a ListViewActionList, by removing the "Edit Items" and "Edit Groups" actions. + + + + That class is internal, so we cannot simply subclass it, which would be simplier. + + + Action lists use reflection to determine if that action can be executed, so we not + only have to modify the returned collection of actions, but we have to implement + the properties and commands that the returned actions use. + + + + + This class works in conjunction with the OLVColumns property to allow OLVColumns + to be added to the ObjectListView. + + + + + Create a OLVColumnCollectionEditor + + + + + + What type of object does this editor create? + + + + + + Edit a given value + + + + + + + + + What text should be shown in the list for the given object? + + + + + + + Control how the overlay is presented in the IDE + + + + + An OLVColumn knows which aspect of an object it should present. + + + The column knows how to: + + extract its aspect from the row object + convert an aspect to a string + calculate the image for the row object + extract a group "key" from the row object + convert a group "key" into a title for the group + + For sorting to work correctly, aspects from the same column + must be of the same type, that is, the same aspect cannot sometimes + return strings and other times integers. + + + + + How should the button be sized? + + + + + 每个单元格都将具有相同大小的按钮，如ButtonSize属性所示 + + + + + 每个单元格都将绘制一个填充单元格的按钮，该按钮由ButtonPadding插入 + + + + + 将调整每个按钮的大小以包含文本内容 + + + + + Create an OLVColumn + + + + + Initialize a column to have the given title, and show the given aspect + + The title of the column + The aspect to be shown in the column + + + + 此委托将用于提取要在此列中显示的值。 + + + 如果设置, AspectName属性将被忽略. + + + + + 请记住，如果当前列的AspectGetter是内部生成的，依旧可以随意重新生成 + + + + + 应调用以获取要在此列中显示的值的属性或方法的名称。 + 仅当未指定ValueGetterDelegate时才使用此选项。 + + 此名称可以用来表示对属性或无参数方法的链引用。 + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + 此委托将用于将编辑后的值放回模型对象中。 + + + 如果IsEdable==false，则不执行任何操作。 + + + + + 用于将要在此列中显示的Aspect转换为字符串的委托。 + + 如果设置了此值，AspectToStringFormat将被忽略。 + + + + 将Aspect转换成字符串的格式文本 + + + 此字符串作为第一个参数传递给String.Format()方法。 + 仅当尚未设置AspectToStringConverter时才使用此选项。 + "{0:C}" 表示转换数字到货币 + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取用户操作是否可以隐藏此列 + + 这会同时考虑Hideable属性以及此列是否为列表视图的主列(列0)。 + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + + + 如果控件不是所有者绘制(owner drawn)的，则始终将其视为true。 + + 如果该值为False(默认值)并且控件是所有者绘制(owner drawn)的， + ObjectListView将尝试计算单元格实际内容的宽度，然后将编辑控件的大小调整为恰到好处的宽度。 + 如果为真，则无论单元格的内容如何，都将使用单元格的整个宽度。 + + 如果未在列上设置此属性，则将使用控件中的值 + + 仅当控件处于详细信息视图中时才使用此值。 + 无论此设置如何，开发人员都可以通过侦听CellEditStarting事件来指定编辑控件的确切大小。 + + + + + 获取编辑此列中的单元格时是否应使用整个单元格 + + 这将计算当前有效值，该值可能与CellEditUseWholeCell不同 + + + + 获取或设置此列中此单元格周围将留空的像素数 + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + + 获取或设置此列中的单元格垂直对齐的方式。 + + + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + 如果未设置，将使用控件本身的值。 + + + + + + 获取或设置此列是否显示复选框。 + + + 在第0列上设置此选项不起作用。列0复选框由ObjectListView本身的CheckBox属性控制。 + + + + + Gets or sets the clustering strategy used for this column. + + + + The clustering strategy is used to build a Filtering menu for this item. + If this is null, a useful default will be chosen. + + + To disable filtering on this colummn, set UseFiltering to false. + + + Cluster strategies belong to a particular column. The same instance + cannot be shared between multiple columns. + + + + + + 获取或设置是否启用此列中的按钮(如果此列是按钮)，即使该行本身被禁用 + + + + + 此列是否应该调整大小以填充列表视图中的空闲空间？ + + + + 如果希望两列(或更多列)平均共享可用空间，请将此属性设置为True。 + 如果希望此列具有更大或更小的可用空间份额，则必须显式设置FreeSpaceProportion属性。 + + + 空间填充列仍然由MinimumWidth和MaximumWidth属性控制。 + + /// + + + + 控件中未占用的水平空间应分配给此列的比例是多少？ + + + + 在某些情况下，如果列(通常是最右边的列)可以随着列表视图的扩展而扩展， + 这样就可以在不必水平滚动的情况下尽可能多地看到列(您永远不应该让用户必须水平滚动任何内容！)。 + + + 调整空间填充列的大小以占据列表视图的未占用宽度的一部分(未占用宽度是一旦所有非填充列都被赋予其空间后剩余的宽度)。 + 此属性指示将分配给此列的未占用空间的相对比例。此属性的实际值并不重要，重要的是它的值相对于其他列中的值。 + 例子: + + + 如果只有一个空间填充列，则无论FreeSpaceProportion中的值如何，都将为其提供所有可用空间。 + + + 如果有两个或多个空间填充列，并且它们的FreeSpaceProportion值都相同，则它们将平等地共享空闲空间。 + + + 如果FreeSpaceProportion有三个值为3、2和1的空间填充列，则第一列将占用一半的空闲空间，第二列将占用三分之一的空闲空间，第三列将占用六分之一的空闲空间。 + + + + + + + + 获取或设置在单击此列的标题时是否对此列值重新生成组。 + + + 此设置仅在ShowGroups为true时使用。 + + 如果为False，则单击标题不会重建组。 + + 如果为false，则仍会激发BeforeCreatingGroups事件，这些事件可用于根据具体情况进行分组或提供反馈。 + + + + + 当组已创建但尚未成为真正的ListViewGroup时，将调用此委托。用户可以利用此机会填写有关该组的许多其他详细信息。 + + + + + 调用此委托以获取对象，该对象是给定行所属的组的键。 + + + + + 调用此委托将组键转换为该组的标题。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，应如何设置标签的格式 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 + + + "{0} [{1} items]" + + + + 获取this.GroupWithItemCountFormat或默认值 + + + 如果未设置GroupWithItemCountFormat，则如果可能，将从ObjectListView中获取其值。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，如果组中只有一个项目，标签应该如何格式化 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 (始终为1) + + + "{0} [{1} item]" + + + + 获取this.GroupWithItemCountSingularFormat或默认值 + + + 如果未设置此值，将使用列表视图中的值 + + + + + 获取是否应在列标题中使用筛选器指示符绘制此列。 + + + + + 获取或设置将用于所有者绘制标题列的委托。 + + + + + 获取或设置将用于绘制此列标题的样式 + + 仅当拥有的ObjectListView将HeaderUsesThemes设置为False时才使用此选项。 + + + + 获取或设置绘制此列的标题时使用的字体 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置绘制此列标题文本的颜色 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置将在列标题中显示的图像键 + + 这仅在HeaderUsesThemes为false时使用 + + + + 获取或设置Header文本的对齐方式 + + + + + 返回Header的文本对齐方式。这将是显式设置的，或者将遵循列中文本的对齐方式 + + + + + 获取转换为StringAlignment的Header对齐方式 + + + + + 获取此列的标题中是否有图像 + + + + + 获取或设置此Header是否在Header中放置复选框 + + + + + 获取或设置此Header是否在Header中放置三态复选框 + + + + + 获取或设置此列Header中复选框的选中状态 + + + + + 获取或设置选中/取消选中标题复选框的值是否会导致将此列中所有单元格的复选框设置为相同的选中/取消选中。 + 默认值为true. + + + + 当单元格的复选框状态改变时，该函数不会与自动更新标题的功能相反。 + + + 此属性在TreeListView上的行为最好描述为未定义，应该避免。 + + + 此操作(检查/取消检查所有行)的性能为O(n)，其中n是行数。它将在大型虚拟列表上工作，但可能需要一些时间。 + + + + + + 获取或设置是否禁用标题中的复选框 + + + 单击禁用的复选框不会更改其值，但会引发HeaderCheckBoxChanging事件，使程序员有机会执行适当的操作。 + + + + 获取或设置用户是否可以隐藏此列。 + + + 无论此设置如何，列0永远不能隐藏。 + + + + + 获取或设置此列中的文本值是否类似于超链接 + + + + + 这是属性的名称，将调用该属性来获取应该在此列中显示的图像的图像选择器。 + 它可以返回int、String、Image或NULL。 + + + 如果ImageGetter不为空，则忽略此项。 + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 调用此委托以获取应该在此列中显示的图像的图像选择器。它可以返回int、String、Image或NULL。 + + + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 获取或设置此列是否在其单元格中绘制按钮 + + + + 如果将其设置为true，则列的呈现器将成为ColumnButtonRenender(如果尚未成为ColumnButtonRenender)。如果设置为False，则将丢弃以前的任何按钮渲染器 + + 如果单元格的Aspect为Null或空，则不会在单元格中绘制任何内容。 + + + + Create a ColumnButtonRenderer to draw buttons in this column + + + + + + Fill in details to our ColumnButtonRenderer based on the properties set on the column + + + + + 获取或设置按钮可以占用的最大宽度。 + -1 表示不限制最大宽度 + + 仅当SizingMode为TextBound时才生效 + + + + 获取或设置当SizingMode为TextBound时单元格周围的额外空间 + + + + + 获取或设置SizingMode为FixedBound时按钮的大小 + + 如果未设置，将使用单元格的边界 + + + + 获取或设置此列显示按钮时如何调整每个按钮的大小 + + + + + 此列中显示的值是否可以编辑 + + 此默认值为false，因为控制列表视图的可编辑性的主要方法是列表视图本身。 + 列表视图可编辑后，所有列也可编辑，除非程序员显式将它们标记为不可编辑 + + + + 是否是固定宽度 + + + + + 获取/设置当视图切换到平铺视图(TileView)时是否使用此列。 + + 无论此设置如何，第0列始终包含在平铺视图中。平铺视图不能很好地处理许多“列”信息。两三个最好。 + + + + 获取或设置Header的文本是否应垂直呈现。 + + + 如果为True，最好将ToolTipText设置为列的名称，以便于阅读。 + 垂直Header仅为文本。他们不会画出图像。 + + + + + 该列是否可见 + + 更改此值后，必须调用RebuildColumns()才能使更改生效。 + + + + 此列最后一次定位在详细信息视图列中的位置是什么 + + DisplayIndex是易失性的。一旦从控件中移除列，就无法发现它在显示顺序中的位置。 + 即使列不在列表视图的活动列中，此属性也会保护该信息。 + + + + 列最大宽度 + + -1表示不限制. 将该值指定为与MinimumWidth相同的值，以生成固定宽度的列。 + + + + 列最小宽度 + + -1表示不限制. 将该值指定为与MaximumWidth相同的值，以生成固定宽度的列。 + + + + Get/set the renderer that will be invoked when a cell needs to be redrawn + + + + + This delegate is called when a cell needs to be drawn in OwnerDrawn mode. + + This method is kept primarily for backwards compatibility. + New code should implement an IRenderer, though this property will be maintained. + + + + 获取或设置执行文本搜索时是否使用此列的单元格中的文本。 + + + + 如果为False，则文本筛选器在查找匹配项时不会尝试搜索此列单元格。 + + + + + + 获取或设置一个委托，该委托将返回在使用基于文本的筛选器时应考虑进行文本匹配的文本值数组。 + + + + + 获取或设置此列的标题是否将包括该列的文本。 + + + + 如果为false，则列标题中呈现的唯一内容将是来自 . + + 只有在以下情况下才会考虑此设置: ObjectListView中的 为false . + + + + + 获取或设置当用户单击此列的标题时是否重新排序列表内容。 + + + + 如果为False，则单击标题将不会对列表进行排序，但也不会提供有关列表未排序原因的任何反馈。提供适当的反馈是程序员的责任。 + + 如果为false，则仍会触发BeforeSorting事件，该事件可用于根据具体情况进行排序或提供反馈。 + + + + + 获取或设置列内容的水平对齐方式。 + + NET将不允许列0具有除左对齐以外的任何对齐方式。我们不能更改列表视图的基本行为，但当所有者绘制时，列0现在可以有其他对齐方式。 + + + + 获取列文本对齐的StringAlignment等效项 + + + + + 当鼠标悬停在该列的标题上时，应该显示什么字符串？ + + 如果拥有的ObjectListView上安装了HeaderToolTipGetter，则将忽略此值。 + + + + 此列是否应该有一个三态复选框 + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + + + + + 按列纵横比的首字母对对象进行分组 + + + 一种常见的模式是按该组的值的首字母对列进行分组。aspect必须是字符串(显然)。 + + + + + 获取或设置此列是否应为用户可筛选的列 + + + + + Gets or sets a filter that will only include models where the model's value + for this column is one of the values in ValuesChosenForFiltering + + + + + Gets or sets the values that will be used to generate a filter for this + column. For a model to be included by the generated filter, its value for this column + must be in this list. If the list is null or empty, this column will + not be used for filtering. + + + + + 列宽 + + + + + 获取或设置此列单元格的内容是否应自动换行 + + 如果此列使用自定义IRenender(即，不是从BaseRenender派生的)，则该呈现器负责实现自动换行。 + + + + For a given group value, return the string that should be used as the groups title. + + The group key that is being converted to a title + string + + + + Get the checkedness of the given object for this column + + The row object that is being displayed + The checkedness of the object + + + + Put the checkedness of the given object for this column + + The row object that is being displayed + + The checkedness of the object + + + + For a given row object, extract the value indicated by the AspectName property of this column. + + The row object that is being displayed + An object, which is the aspect named by AspectName + + + + For a given row object, return the object that is the key of the group that this row belongs to. + + The row object that is being displayed + Group key object + + + + For a given row object, return the image selector of the image that should displayed in this column. + + The row object that is being displayed + int or string or Image. int or string will be used as index into image list. null or -1 means no image + + + + Return the image that represents the check box for the given model + + + + + + + For a given row object, return the strings that will be searched when trying to filter by string. + + + This will normally be the simple GetStringValue result, but if this column is non-textual (e.g. image) + you might want to install a SearchValueGetter delegate which can return something that could be used + for text filtering. + + + The array of texts to be searched. If this returns null, search will not match that object. + + + + For a given row object, return the string representation of the value shown in this column. + + + For aspects that are string (e.g. aPerson.Name), the aspect and its string representation are the same. + For non-strings (e.g. aPerson.DateOfBirth), the string representation is very different. + + + + + + + For a given row object, return the object that is to be displayed in this column. + + The row object that is being displayed + An object, which is the aspect to be displayed + + + + Update the given model object with the given value using the column's + AspectName. + + The model object to be updated + The value to be put into the model + + + + Update the given model object with the given value + + The model object to be updated + The value to be put into the model + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Decide the clustering strategy that will be used for this column + + + + + + Gets or sets the type of data shown in this column. + + If this is not set, it will try to get the type + by looking through the rows of the listview. + + + + This event is triggered when the visibility of this column changes. + + + + + Tell the world when visibility of a column changes. + + + + + Create groupies + This is an untyped version to help with Generator and OLVColumn attributes + + + + + + + Create groupies + + + + + + + + Create groupies + + + + + + + + + Create groupies + + + + + + + + + + Create groupies. + Install delegates that will group the columns aspects into progressive partitions. + If an aspect is less than value[n], it will be grouped with description[n]. + If an aspect has a value greater than the last element in "values", it will be grouped + with the last element in "descriptions". + + Array of values. Values must be able to be + compared to the aspect (using IComparable) + The description for the matching value. The last element is the default description. + If there are n values, there must be n+1 descriptions. + + this.salaryColumn.MakeGroupies( + new UInt32[] { 20000, 100000 }, + new string[] { "Lowly worker", "Middle management", "Rarified elevation"}); + + + + + + + + + Create groupies based on exact value matches. + + + Install delegates that will group rows into partitions based on equality of this columns aspects. + If an aspect is equal to value[n], it will be grouped with description[n]. + If an aspect is not equal to any value, it will be grouped with "[other]". + + Array of values. Values must be able to be + equated to the aspect + The description for the matching value. + + this.marriedColumn.MakeEqualGroupies( + new MaritalStatus[] { MaritalStatus.Single, MaritalStatus.Married, MaritalStatus.Divorced, MaritalStatus.Partnered }, + new string[] { "Looking", "Content", "Looking again", "Mostly content" }); + + + + + + + + + An adorment is the common base for overlays and decorations. + + + + + Gets or sets the corner of the adornment that will be positioned at the reference corner + + + + + Gets or sets location within the reference rectange where the adornment will be drawn + + This is a simplied interface to ReferenceCorner and AdornmentCorner + + + + Gets or sets the offset by which the position of the adornment will be adjusted + + + + + Gets or sets the point of the reference rectangle to which the adornment will be aligned. + + + + + Gets or sets the degree of rotation by which the adornment will be transformed. + The centre of rotation will be the center point of the adornment. + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + Calculate the location of rectangle of the given size, + so that it's indicated corner would be at the given point. + + The point + + Which corner will be positioned at the reference point + + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.TopLeft) -> Point(50, 100) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.MiddleCenter) -> Point(45, 90) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.BottomRight) -> Point(40, 80) + + + + Calculate a rectangle that has the given size which is positioned so that + its alignment point is at the reference location of the given rect. + + + + + + + + Create a rectangle of the given size which is positioned so that + its indicated corner is at the indicated corner of the reference rect. + + + + + + + + + Creates a rectangle so that its bottom left is at the centre of the reference: + corner=BottomLeft, referenceCorner=MiddleCenter + This is a powerful concept that takes some getting used to, but is + very neat once you understand it. + + + + + Return the point at the indicated corner of the given rectangle (it doesn't + have to be a corner, but a named location) + + The reference rectangle + Which point of the rectangle should be returned? + A point + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.TopLeft) -> Point(0, 0) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.MiddleCenter) -> Point(25, 50) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.BottomRight) -> Point(50, 100) + + + + Given the item and the subitem, calculate its bounds. + + + + + + + + Apply any specified rotation to the Graphic content. + + The Graphics to be transformed + The rotation will be around the centre of this rect + + + + Reverse the rotation created by ApplyRotation() + + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Gets or sets the image that will be drawn + + + + + Gets or sets if the image will be shrunk to fit with its horizontal bounds + + + + + Draw the image in its specified location + + The Graphics used for drawing + The bounds of the rendering + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How big should the image be? + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location, scaled so that it is not wider + than the given rectangle. Height is scaled proportional to the width. + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Utility to draw a bitmap transparenly. + + + + + + + + + An adornment that will draw text + + + + + Gets or sets the background color of the text + Set this to Color.Empty to not draw a background + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the border around the billboard. + Set this to Color.Empty to remove the border + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the width of the border around the text + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the font that will be used to draw the text + + + + + Gets the font that will be used to draw the text or a reasonable default + + + + + Does this text have a background? + + + + + Does this overlay have a border? + + + + + Gets or sets the maximum width of the text. Text longer than this will wrap. + 0 means no maximum. + + + + + Gets or sets the formatting that should be used on the text + + + + + Gets or sets the text that will be drawn + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the text + + + + + Gets or sets whether the text will wrap when it exceeds its bounds + + + + + Draw our text with our stored configuration in relation to the given + reference rectangle + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + + + + Draw the given text with our stored configuration + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + The text to draw + How opaque should be text be + + + + Draw the text with a border + + The Graphics used for drawing + The bounds within which the text should be drawn + The text to draw + How opaque should be text be + + + + Return the rectangle that will be the precise bounds of the displayed text + + + + + The bounds of the text + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectagle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + A decoration is an overlay that draws itself in relation to a given row or cell. + Decorations scroll when the listview scrolls. + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + An AbstractDecoration is a safe do-nothing implementation of the IDecoration interface + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + Gets the bounds of the decorations row + + + + + Get the bounds of the decorations cell + + + + + Draw the decoration + + + + + + + + This decoration draws a slight tint over a column of the + owning listview. If no column is explicitly set, the selected + column in the listview will be used. + The selected column is normally the sort column, but does not have to be. + + + + + Create a TintedColumnDecoration + + + + + Create a TintedColumnDecoration + + + + + + Gets or sets the column that will be tinted + + + + + Gets or sets the color that will be 'tinted' over the selected column + + + + + Draw a slight colouring over our tinted column + + + This overlay only works when: + - the list is in Details view + - there is at least one row + - there is a selected column (or a specified tint column) + + + + + + + + This decoration draws an optionally filled border around a rectangle. + Subclasses must override CalculateBounds(). + + + + + Create a BorderDecoration + + + + + Create a BorderDecoration + + The pen used to draw the border + + + + Create a BorderDecoration + + The pen used to draw the border + The brush used to fill the rectangle + + + + Gets or sets the pen that will be used to draw the border + + + + + Gets or sets the padding that will be added to the bounds of the item + before drawing the border and fill. + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the brush that will be used to fill the border + + This value is ignored when using gradient brush + + + + Gets or sets the color that will be used as the start of a gradient fill. + + This and FillGradientTo must be given value to show a gradient + + + + Gets or sets the color that will be used as the end of a gradient fill. + + This and FillGradientFrom must be given value to show a gradient + + + + Gets or sets the fill mode that will be used for the gradient. + + + + + Draw a filled border + + + + + + + + Subclasses should override this to say where the border should be drawn + + + + + + Do the actual work of drawing the filled border + + + + + + + Create a GraphicsPath that represents a round cornered rectangle. + + + If this is 0 or less, the rectangle will not be rounded. + + + + + Instances of this class draw a border around the decorated row + + + + + Gets or sets the index of the left most column to be used for the border + + + + + Gets or sets the index of the right most column to be used for the border + + + + + Calculate the boundaries of the border + + + + + + Instances of this class draw a border around the decorated subitem. + + + + + Calculate the boundaries of the border + + + + + + This decoration puts a border around the cell being edited and + optionally "lightboxes" the cell (makes the rest of the control dark). + + + + + Create a EditingCellBorderDecoration + + + + + Create a EditingCellBorderDecoration + + Should the decoration use a lighbox display style? + + + + Gets or set whether the decoration should make the rest of + the control dark when a cell is being edited + + If this is true, FillBrush is used to overpaint + the control. + + + + Draw the decoration + + + + + + + + This decoration causes everything *except* the row under the mouse to be overpainted + with a tint, making the row under the mouse stand out in comparison. + The darker and more opaque the fill color, the more obvious the + decorated row becomes. + + + + + Create a LightBoxDecoration + + + + + Draw a tint over everything in the ObjectListView except the + row under the mouse. + + + + + + + + Instances of this class put an Image over the row/cell that it is decorating + + + + + Create an image decoration + + + + + Create an image decoration + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Instances of this class draw some text over the row/cell that they are decorating + + + + + Create a TextDecoration + + + + + Create a TextDecoration + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + The interface for an object which can draw itself over the top of + an ObjectListView. + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + An interface for an overlay that supports variable levels of transparency + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + A null implementation of the IOverlay interface + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + How transparent should this overlay be? + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Create an ImageOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + An overlay that will draw text over the top of the ObjectListView + + + + + Create a TextOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Gets or sets whether the border will be drawn with rounded corners + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + A Billboard overlay is a TextOverlay positioned at an absolute point + + + + + Create a BillboardOverlay + + + + + Gets or sets where should the top left of the billboard be placed + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Renderers are the mechanism used for owner drawing cells. As such, they can also handle + hit detection and positioning of cell editing rectangles. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + Renderers that implement this interface will have the filter property updated, + each time the filter on the ObjectListView is updated. + + + + + + + + + + An AbstractRenderer is a do-nothing implementation of the IRenderer interface. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + This class provides compatibility for v1 RendererDelegates + + + + + The renderer delegate that this renderer wraps + + + + + A BaseRenderer provides useful base level functionality for any custom renderer. + + + Subclasses will normally override the Render or OptionalRender method, and use the other + methods as helper functions. + + + + + Can the renderer wrap lines that do not fit completely within the cell? + + Wrapping text doesn't work with the GDI renderer. + + + + Gets or sets how many pixels will be left blank around this cell + + + + This setting only takes effect when the control is owner drawn. + + for more details. + + + + + Gets the horiztonal alignment of the column + + + + + Gets or sets how cells drawn by this renderer will be vertically aligned. + + + + If this is not set, the value from the column or control itself will be used. + + + + + + Gets the optional padding that this renderer should apply before drawing. + This property considers all possible sources of padding + + + + + Gets the vertical cell alignment that should govern the rendering. + This property considers all possible sources. + + + + + Gets or sets the image list from which keyed images will be fetched + + + + + When rendering multiple images, how many pixels should be between each image? + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Get or set the aspect of the model object that this renderer should draw + + + + + What are the bounds of the cell that is being drawn? + + + + + Get or set the OLVColumn that this renderer will draw + + + + + Get/set the event that caused this renderer to be called + + + + + Get/set the event that caused this renderer to be called + + + + + Gets or sets the font to be used for text in this cell + + + + + Gets the image list from which keyed images will be fetched + + + + + Should this renderer fill in the background before drawing? + + + + + Cache whether or not our item is selected + + + + + Is this renderer being used on a printer context? + + + + + Get or set the listitem that this renderer will be drawing + + + + + Get/set the listview for which the drawing is to be done + + + + + Get the specialized OLVSubItem that this renderer is drawing + + This returns null for column 0. + + + + Get or set the model object that this renderer should draw + + + + + Get or set the list subitem that this renderer will be drawing + + + + + The brush that will be used to paint the text + + + + + Will this renderer use the custom images from the parent ObjectListView + to draw the checkbox images. + + + + If this is true, the renderer will use the images from the + StateImageList to represent checkboxes. 0 - unchecked, 1 - checked, 2 - indeterminate. + + If this is false (the default), then the renderer will use .NET's standard + CheckBoxRenderer. + + + + + Align the second rectangle with the first rectangle, + according to the alignment of the column + + The cell's bounds + The rectangle to be aligned within the bounds + An aligned rectangle + + + + Calculate the left edge of the rectangle that aligns the outer rectangle with the inner one + according to this renderer's horizontal alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with the inner rectangle + according to this renders vertical alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with a rectangle of the given height + according to this renderer's vertical alignment + + + + + + + + Calculate the space that our rendering will occupy and then align that space + with the given rectangle, according to the Column alignment + + + Pre-padded bounds of the cell + + + + + Calculate the size of the content of this cell. + + + Pre-padded bounds of the cell + The width and height of the content + + + + Calculate the bounds of a checkbox given the (pre-padded) cell bounds + + + Pre-padded cell bounds + + + + + How much space will the check box for this cell occupy? + + Only column 0 can have check boxes. Sub item checkboxes are + treated as images + + + + + + How much space will the check box for this row occupy? + If the list doesn't have checkboxes, or this isn't the primary column, + this returns an empty size. + + + + + + + How much horizontal space will the image of this cell occupy? + + + + + + + + How much vertical space will the image of this cell occupy? + + + + + + + + How much space will the image of this cell occupy? + + + + + + + + How much horizontal space will the text of this cell occupy? + + + + + + + + + How much space will the text of this cell occupy? + + + + + + + + + Return the Color that is the background color for this item's cell + + The background color of the subitem + + + + Return the color of the background color when the item is selected + + The background color of the subitem + + + + Return the color to be used for text in this cell + + The text color of the subitem + + + + Return the color of the foreground color when the item is selected + + The foreground color of the subitem + + + + Return the image that should be drawn against this subitem + + An Image or null if no image should be drawn. + + + + Return the actual image that should be drawn when keyed by the given image selector. + An image selector can be: + an int, giving the index into the image list + a string, giving the image key into the image list + an Image, being the image itself + + + The value that indicates the image to be used + An Image or null + + + + + + + + Return the string that should be drawn within this + + + + + + Return the Color that is the background color for this item's text + + The background color of the subitem's text + + + + Render the whole item in a non-details view. + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Render one cell + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Calculate which part of this cell was hit + + + + + + + + Calculate the edit rectangle + + + + + + + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method. + The graphics context that should be used for drawing + The bounds of the subitem cell + Returns whether the rendering has already taken place. + If this returns false, the default processing will take over. + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method if they never want + to fall back on the default processing + The graphics context that should be used for drawing + The bounds of the subitem cell + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw the standard "[checkbox] [image] [text]" cell after the state properties have been initialized. + + + + + + + Change the bounds of the given rectangle to take any cell padding into account + + + + + + + Perform normal hit testing relative to the given aligned content bounds + + + + + + + + + + This method calculates the bounds of the text within a standard layout + (i.e. optional checkbox, optional image, text) + + This method only works correctly if the state of the renderer + has been fully initialized (see BaseRenderer.GetEditRectangle) + + + + + + + + Apply any padding to the given bounds, and then align a rectangle of the given + size within that padded area. + + + + + + + + + Draw the given image aligned horizontally within the column. + + + Over tall images are scaled to fit. Over-wide images are + truncated. This is by design! + + Graphics context to use for drawing + Bounds of the cell + The image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Pre-padded bounds of the cell + + + + Fill in the background of this cell + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the primary check box of this row (checkboxes in other sub items use a different method) + + Graphics context to use for drawing + The pre-aligned and padded target rectangle + + + + Calculate the CheckBoxState we need to correctly draw the given state + + + + + + + Should this checkbox be drawn as disabled? + + + + + Is the current item hot (i.e. under the mouse)? + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The optional image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the given collection of image selectors + + + + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The string to be drawn + + + + Print the given text in the given rectangle using only GDI routines + + + + + + The native list control uses GDI routines to do its drawing, so using them + here makes the owner drawn mode looks more natural. + This method doesn't honour the CanWrap setting on the renderer. All + text is single line + + + + + Gets the cell's vertical alignment as a TextFormatFlag + + + + + + Gets the StringFormat needed when drawing text using GDI+ + + + + + Print the given text in the given rectangle using normal GDI+ .NET methods + + Printing to a printer dc has to be done using this method. + + + + This renderer highlights substrings that match a given text filter. + + + + + Create a HighlightTextRenderer + + + + + Create a HighlightTextRenderer + + + + + + Create a HighlightTextRenderer + + + + + + Gets or set how rounded will be the corners of the text match frame + + + + + Gets or set the brush will be used to paint behind the matched substrings. + Set this to null to not fill the frame. + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Gets or set the pen will be used to frame the matched substrings. + Set this to null to not draw a frame. + + + + + Gets or sets whether the frame around a text match will have rounded corners + + + + + Gets or set the text that will be highlighted + + + + + Gets or sets the manner in which substring will be compared. + + + Use this to control if substring matches are case sensitive or insensitive. + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw text using GDI + + + + + + + + Draw the highlighted text using GDI + + + + + + + + Draw an indication around the given frame that shows a text match + + + + + + + + + + Draw the text using GDI+ + + + + + + + + Draw the highlighted text using GDI+ + + + + + + + + Gets whether the renderer should actually draw highlighting + + + + + Return a GraphicPath that is a round cornered rectangle + + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + + + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + This class maps a data value to an image that should be drawn for that value. + + It is useful for drawing data that is represented as an enum or boolean. + + + + Return a renderer that draw boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + A Renderer + + + + Return a renderer that draw tristate boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + Draw this when our data value is null + A Renderer + + + + Make a new empty renderer + + + + + Make a new renderer that will show the given image when the given key is the aspect value + + The data value to be matched + The image to be shown when the key is matched + + + + Make a new renderer that will show the given images when it receives the given keys + + + + + + + + + Build a renderer from the given array of keys and their matching images + + An array of key/image pairs + + + + Register the image that should be drawn when our Aspect has the data value. + + Value that the Aspect must match + An ImageSelector -- an int, string or image + + + + Render our value + + + + + + + Draw a collection of images + + + + + + + + Draw one image + + + + + + + + This renderer draws just a checkbox to match the check state of our model object. + + + + + Draw our cell + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + Handle the HitTest request + + + + + + + + + Render an image that comes from our data source. + + The image can be sourced from: + + a byte-array (normally when the image to be shown is + stored as a value in a database) + an int, which is treated as an index into the image list + a string, which is treated first as a file name, and failing that as an index into the image list + an ICollection of ints or strings, which will be drawn as consecutive images + + If an image is an animated GIF, it's state is stored in the SubItem object. + By default, the image renderer does not render animations (it begins life with animations paused). + To enable animations, you must call Unpause(). + In the current implementation (2009-09), each column showing animated gifs must have a + different instance of ImageRenderer assigned to it. You cannot share the same instance of + an image renderer between two animated gif columns. If you do, only the last column will be + animated. + + + + + Make an empty image renderer + + + + + Make an empty image renderer that begins life ready for animations + + + + + Finalizer + + + + + Should the animations in this renderer be paused? + + + + + Gets a timer that can be used to trigger redraws on animations + + + + + Pause any animations + + + + + Unpause any animations + + + + + Draw our image + + + + + + + Translate our Aspect into an image. + + The strategy is: + If its a byte array, we treat it as an in-memory image + If it's an int, we use that as an index into our image list + If it's a string, we try to load a file by that name. If we can't, + we use the string as an index into our image list. + + An image + + + + This is the method that is invoked by the timer. It basically switches control to the listview thread. + + not used + + + + This is the OnTimer callback, but invoked in the same thread as the creator of the ListView. + This method can use all of ListViews methods without creating a CrossThread exception. + + + + + Instances of this class kept track of the animation state of a single image. + + + + + Is the given image an animation + + The image to be tested + Is the image an animation? + + + + Create an AnimationState in a quiet state + + + + + Create an animation state for the given image, which may or may not + be an animation + + The image to be rendered + + + + Does this state represent a valid animation + + + + + Advance our images current frame and calculate when it will expire + + + + + Render our Aspect as a progress bar + + + + + Make a BarRenderer + + + + + Make a BarRenderer for the given range of data values + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + 此栏是否应以系统样式绘制？ + + + + + 将从我们的单元格边框开始绘制多少像素的条形图 + + + + + 在绘制进度条之前，将使用什么颜色填充控件内部？ + + + + + 进度条边框颜色 + + + + + 进度条的边框像素宽 + + + + + 进度条的“填充”部分应该是什么颜色？ + + 仅当GradientStartColor为Color.Empty时才使用此选项 + + + + 进度条中是否显示文本百分比进度显示 + + + + + + 使用渐变以此颜色开始填充进度条 + + + + + 使用渐变填充以此颜色结尾的进度条 + + + + + 使用渐变以此颜色开始填充渐满进度条 + + + + + 使用渐变填充以此颜色结尾的渐满进度条 + + + + + 无论列变得多宽，进度条都不会比这个宽。 + + + + + 无论单元格有多高，进度条都不会比这个高 + + + + + 预期的最小数据值。小于此值的值将显示一个空条。 + + + + + 接近满时的值,高于该值时，显示不同颜色，小于等于MinimumValue或大于MaximumValue值，则表示未设置该值 + + + + + 范围的最大值。大于此值的值将给出一个完整的条形。 + + + + + The Pen that will draw the frame surrounding this bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the background of the bar + + + + + Draw this progress bar using a gradient + + + + + + + Draw our aspect + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + An ImagesRenderer draws zero or more images depending on the data returned by its Aspect. + + This renderer's Aspect must return a ICollection of ints, strings or Images, + each of which will be drawn horizontally one after the other. + As of v2.1, this functionality has been absorbed into ImageRenderer and this is now an + empty shell, solely for backwards compatibility. + + + + + A MultiImageRenderer draws the same image a number of times based on our data value + + The stars in the Rating column of iTunes is a good example of this type of renderer. + + + + Make a quiet renderer + + + + + Make an image renderer that will draw the indicated image, at most maxImages times. + + + + + + + + + The index of the image that should be drawn + + + + + The name of the image that should be drawn + + + + + The image selector that will give the image to be drawn + + Like all image selectors, this can be an int, string or Image + + + + What is the maximum number of images that this renderer should draw? + + + + + Values less than or equal to this will have 0 images drawn + + + + + Values greater than or equal to this will have MaxNumberImages images drawn + + + + + Draw our data value + + + + + + + A class to render a value that contains a bitwise-OR'ed collection of values. + + + + + Register the given image to the given value + + When this flag is present... + ...draw this image + + + + Draw the flags + + + + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + This renderer draws an image, a single line title, and then multi-line description + under the title. + + + This class works best with FullRowSelect = true. + It's not designed to work with cell editing -- it will work but will look odd. + + It's not RightToLeft friendly. + + + + + + Create a DescribedTaskRenderer + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Gets or set the font that will be used to draw the title of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the title of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the title of the task or a reasonable default + + + + + Gets or set the font that will be used to draw the description of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the description of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the description of the task or a reasonable default + + + + + Gets or sets the number of pixels that will be left between the image and the text + + + + + 顶部留白像素 + + + + + Gets or sets the number of pixels that will be left between the title and the description + + + + + Gets or sets the name of the aspect of the model object that contains the task description + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Fetch the description from the model class + + + + + + + + + + + + + + + Draw our item + + + + + + + Draw the task + + + + + + + + + + Handle the HitTest request + + + + + + + + + This renderer draws a functioning button in its cell + + + + + Gets or sets how each button will be sized + + + + + 获取或设置SizingMode为FixedBounds时按钮的大小 + + If this is not set, the bounds of the cell will be used + + + + 获取或设置SizingMode为TextBounds时单元格周围的额外空间 + + + + + Gets or sets the maximum width that a button can occupy. + -1 means there is no maximum width. + + This is only considered when the SizingMode is TextBounds + + + + Gets or sets the minimum width that a button can occupy. + -1 means there is no minimum width. + + This is only considered when the SizingMode is TextBounds + + + + 获取或设置此列按钮的字体颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的背景颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的内边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮是否画边框(如果有按钮的话) + + + + + Calculate the size of the contents + + + + + + + + Draw the button + + + + + + + What part of the control is under the given point? + + + + + + + + + + What is the state of the button? + + + + + + Is the mouse over the button? + + + + + The common interface supported by all style objects + + + + + Gets or set the font that will be used by this style + + + + + Gets or set the font style + + + + + Gets or sets the ForeColor + + + + + Gets or sets the BackColor + + + + + Basic implementation of IItemStyle + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class specify how should "hot items" (non-selected + rows under the cursor) be renderered. + + + + + Gets or sets the overlay that should be drawn as part of the hot item + + + + + Gets or sets the decoration that should be drawn as part of the hot item + + A decoration is different from an overlay in that an decoration + scrolls with the listview contents, whilst an overlay does not. + + + + This class defines how a cell should be formatted + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class describe how hyperlinks will appear + + + + + Create a HyperlinkStyle + + + + + What sort of formatting should be applied to hyperlinks in their normal state? + + + + + What sort of formatting should be applied to hyperlinks when the mouse is over them? + + + + + What sort of formatting should be applied to hyperlinks after they have been clicked? + + + + + Gets or sets the cursor that should be shown when the mouse is over a hyperlink. + + + + + Instances of this class control one the styling of one particular state + (normal, hot, pressed) of a header control + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Gets or sets the color in which a frame will be drawn around the header for this column + + + + + Gets or sets the width of the frame that will be drawn around the header for this column + + + + + This class defines how a header should be formatted in its various states. + + + + + Create a new HeaderFormatStyle + + + + + What sort of formatting should be applied to a column header when the mouse is over it? + + + + + What sort of formatting should be applied to a column header in its normal state? + + + + + What sort of formatting should be applied to a column header when pressed? + + + + + Set the font for all three states + + + + + + Set the fore color for all three states + + + + + + Set the back color for all three states + + + + + + 正常为选中按钮 + + + + + 获得焦点的按钮 + + + + + 鼠标经过样式 + + + + + 获得焦点并鼠标经过 + + + + + 自定义GDI工具，绘制按钮 + + + + + 绘制圆形按钮（用法同矩形按钮） + + + + + + + + + + 绘制圆角按钮 + + 要绘制的文字 + Graphics 对象 + 要填充的矩形 + + + + + 根据普通矩形得到圆角矩形的路径 + + 原始矩形 + 半径 + 图形路径 + + + + A GlassPanelForm sits transparently over an ObjectListView to show overlays. + + + + + Get the low-level windows flag that will be given to CreateWindow. + + + + + Attach this form to the given ObjectListView + + + + + Made the overlay panel invisible + + + + + Show the overlay panel in its correctly location + + + If the panel is always shown, this method does nothing. + If the panel is being resized, this method also does nothing. + + + + + Detach this glass panel from its previous ObjectListView + + + You should unbind the overlay panel before making any changes to the + widget hierarchy. + + + + + Handle when the form that owns the ObjectListView begins to be resized + + + + + + + Handle when the form that owns the ObjectListView finished to be resized + + + + + + + The owning form has moved. Move the overlay panel too. + + + + + + + The owning form is resizing. Hide our overlay panel until the resizing stops + + + + + + + Handle when the bound OLV changes its location. The overlay panel must + be moved too, IFF it is currently visible. + + + + + + + Handle when the bound OLV changes size. The overlay panel must + resize too, IFF it is currently visible. + + + + + + + Handle when the bound OLV is part of a TabControl and that + TabControl changes tabs. The overlay panel is hidden. The + first time the bound OLV is redrawn, the overlay panel will + be shown again. + + + + + + + Somewhere the parent of the bound OLV has changed. Update + our events. + + + + + + + Handle when the bound OLV changes its visibility. + The overlay panel should match the OLV's visibility. + + + + + + + Class used to capture window messages for the header of the list view + control. + + + + + Create a header control for the given ObjectListView. + + + + + + Return the index of the column under the current cursor position, + or -1 if the cursor is not over a column + + Index of the column under the cursor, or -1 + + + + 返回此控件的Windows句柄 + + + 当ObjectListView被初始化为UserControl的一部分时，GetHeaderControl()方法返回0，直到UserControl完全初始化。 + 因此，构造函数中的AssignHandle()调用不起作用。因此，我们覆盖了Handle属性，以便值始终为当前值。 + + + + + Gets or sets a style that should be applied to the font of the + column's header text when the mouse is over that column + + THIS IS EXPERIMENTAL. USE AT OWN RISK. August 2009 + + + + 如果光标位于其复选框上，则获取光标下列的索引 + + + + + Gets the client rectangle for the header + + + + + 如果给定坐标点在给定列的复选框上方，则返回TRUE。 + + + + + + + + 获取光标是否位于“锁定”的分隔线上，即用户无法拖动的分隔线。 + + + + + 获取或设置此标头所属的列表视图 + + + + + 获取标题的最大高度。-1表示没有最大值。 + + + + + 获取标题的最小高度。-1表示没有最低要求。 + + + + + Get or set the ToolTip that shows tips for the header + + + + + 获取或设置当列标题中的文本太长而无法放入列中时，是否应对其进行自动换行 + + + + + Calculate how height the header needs to be + + Height in pixels + + + + Get the bounds of the checkbox against the given column + + + + + + + Should the given column be drawn with a checkbox against it? + + + + + + + Should the given column show a sort indicator? + + + + + + + Should the given column be drawn with a filter indicator against it? + + + + + + + Should the given column show a non-themed sort indicator? + + + + + + + Return the bounds of the item with the given index + + + + + + + Return the bounds within which the given column will be drawn + + + + + + + Force the header to redraw by invalidating it + + + + + Force the header to redraw a single column by invalidating it + + + + + Create a native tool tip control for this listview + + + + + Override the basic message pump + + + + + + Handle the LButtonDown windows message + + + + + + + Handle the LButtonUp windows message + + + + + + + Handle the SetCursor windows message + + + + + + + Handle the MouseMove windows message + + + + + + + Handle the MouseLeave windows message + + + + + + + Handle the Notify windows message + + + + + + + Handle the CustomDraw windows message + + + + + + + The message divides a ListView's space between the header and the rows of the listview. + The WINDOWPOS structure controls the headers bounds, the RECT controls the listview bounds. + + + + + + + Handle when the underlying header control is destroyed + + + + + + + Does this header need to be custom drawn? + + Word wrapping and colored text require custom drawning. Funnily enough, we + can change the font natively. + + + + Draw one cell of the header + + + + + + + + Draw a background for the header, without using Themes. + + + + + + + + + + + Draw a more-or-less pure themed header background. + + + + + + + + + + Draw a sort indicator using themes + + + + + + + Draw a sort indicator without using themes + + + + + + + + Draw an indication that this column has a filter applied to it + + + + + + + + Draw the header's image and text + + + + + + + + + Return the header format that should be used for the given column + + + + + + + What style should be applied to the header? + + + + + + + + + What font should be used to draw the header text? + + + + + + + + + What flags will be used when drawing text + + + + + Perform a HitTest for the header control + + + + Null if the given point isn't over the header + + + + Instances of this class put a CheckedListBox into a tool strip menu item. + + + + + Create a ToolStripCheckedListBox + + + + + Gets the control embedded in the menu + + + + + Gets the items shown in the checkedlistbox + + + + + Gets or sets whether an item should be checked when it is clicked + + + + + Gets a collection of the checked items + + + + + Add a possibly checked item to the control + + + + + + + Add an item with the given state to the control + + + + + + + Gets the checkedness of the i'th item + + + + + + + Set the checkedness of the i'th item + + + + + + + Check all the items in the control + + + + + Unchecked all the items in the control + + + + + Listen for events on the underlying control + + + + + + Stop listening for events on the underlying control + + + + + + Tell the world that an item was checked + + + + + Trigger the ItemCheck event + + + + + + + A limited wrapper around a Windows tooltip window. + + + + + These are the standard icons that a tooltip can display. + + + + + No icon + + + + + Info + + + + + Warning + + + + + Error + + + + + Large info (Vista and later only) + + + + + Large warning (Vista and later only) + + + + + Large error (Vista and later only) + + + + + + + + + + + + + + + + + + + + + + + + + Get or set if the style of the tooltip control + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set the background color of the tooltip + + + + + Get or set the color of the text and border on the tooltip. + + + + + Get or set the title that will be shown on the tooltip. + + + + + Get or set the icon that will be shown on the tooltip. + + + + + Gets or sets the font that will be used to draw this control. + is still. + + Setting this to null reverts to the default font. + + + + Gets or sets how many milliseconds the tooltip will remain visible while the mouse + is still. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown again. + + + + + Create the underlying control. + + The parent of the tooltip + This does nothing if the control has already been created + + + + Take a copy of the current settings and restore them when the + tooltip is poppped. + + + This call cannot be nested. Subsequent calls to this method will be ignored + until PopSettings() is called. + + + + + Restore the settings of the tooltip as they were when PushSettings() + was last called. + + + + + Add the given window to those for whom this tooltip will show tips + + The window + + + + Hide any currently visible tooltip + + + + + + Remove the given window from those managed by this tooltip + + + + + + Set the maximum width of a tooltip string. + + + + + Set the maximum width of a tooltip string. + + Setting this ensures that line breaks in the tooltip are honoured. + + + + Make a TOOLINFO structure for the given window + + + A filled in TOOLINFO + + + + Handle a WmNotify message + + The msg + True if the message has been handled + + + + Handle a get display info message + + The msg + True if the message has been handled + + + + Handle a TTN_LINKCLICK message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_POP message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_SHOW message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a reflected notify message + + The msg + True if the message has been handled + + + + Mess with the basic message pump of the tooltip + + + + + + Tell the world that a tooltip is about to show + + + + + Tell the world that a tooltip is about to disappear + + + + + + + + + + + + + + + + + This form is an example of how an application could allows the user to select which columns + an ObjectListView will display, as well as select which order the columns are displayed in. + + + In Tile view, ColumnHeader.DisplayIndex does nothing. To reorder the columns you have + to change the order of objects in the Columns property. + Remember that the first column is special! + It has to remain the first column. + + + + + Make a new ColumnSelectionForm + + + + + Open this form so it will edit the columns that are available in the listview's current view + + The ObjectListView whose columns are to be altered + + + + Open this form so it will edit the columns that are available in the given listview + when the listview is showing the given type of view. + + The ObjectListView whose columns are to be altered + The view that is to be altered. Must be View.Details or View.Tile + + + + Initialize the form to show the columns of the given view + + + + + + + The user has pressed OK. Do what's requied. + + + + + + + Enable the controls on the dialog to match the current state + + + + + A Comparer that will sort a list of columns so that visible ones come before hidden ones, + and that are ordered by their display order. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + An object that implements the IGenerator interface provides the ability + to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + The Generator class provides methods to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + For a given type, a Generator can create columns to match the public properties + of that type. The generator can consider all public properties or only those public properties marked with + [OLVColumn] attribute. + + + + + Gets or sets the actual generator used by the static convinence methods. + + If you subclass the standard generator or implement IGenerator yourself, + you should install an instance of your subclass/implementation here. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the public properties of the given type + that have a OLVColumn attribute. + + + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Replace all the columns in the given listview with the given list of columns. + + + + + + + Post process columns after creating them and adding them to the AllColumns collection. + + + + + + Create a column from the given PropertyInfo and OLVColumn attribute + + + + + + + + Make a column from the given PropertyInfo + + + + + + + Make a column from the given PropertyDescriptor + + + + + + + Create a column with all the given information + + + + + + + + + + + Create a column. + + + + + + + + + Convert a property name to a displayable title. + + + + + + + Configure the given column to show a checkbox if appropriate + + + + + + + If this given type has an property marked with [OLVChildren], make delegates that will + traverse that property as the children of an instance of the model + + + + + + + Generate CanExpand and ChildrenGetter delegates from the given property. + + + + + + + An OLVExporter converts a collection of rows from an ObjectListView + into a variety of textual formats. + + + + + What format will be used for exporting + + + + + Tab separated values, according to http://www.iana.org/assignments/media-types/text/tab-separated-values + + + + + Alias for TabSeparated + + + + + Comma separated values, according to http://www.ietf.org/rfc/rfc4180.txt + + + + + HTML table, according to me + + + + + Create an empty exporter + + + + + Create an exporter that will export all the rows of the given ObjectListView + + + + + + Create an exporter that will export all the given rows from the given ObjectListView + + + + + + + Gets or sets whether hidden columns will also be included in the textual + representation. If this is false (the default), only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. Default is true. + + + + + Gets the ObjectListView that is being used as the source of the data + to be exported + + + + + Gets the model objects that are to be placed in the data object + + + + + Export the nominated rows from the nominated ObjectListView. + Returns the result in the expected format. + + + + This will perform only one conversion, even if called multiple times with different formats. + + + + Convert + + + + + Encode a string such that it can be used as a value in a CSV file. + This basically means replacing any quote mark with two quote marks, + and enclosing the whole string in quotes. + + + + + + + HTML-encodes a string and returns the encoded string. + + The text string to encode. + The HTML-encoded text. + Taken from http://www.west-wind.com/weblog/posts/2009/Feb/05/Html-and-Uri-String-Encoding-without-SystemWeb + + + + A TypedObjectListView is a type-safe wrapper around an ObjectListView. + + + VCS does not support generics on controls. It can be faked to some degree, but it + cannot be completely overcome. In our case in particular, there is no way to create + the custom OLVColumn's that we need to truly be generic. So this wrapper is an + experiment in providing some type-safe access in a way that is useful and available today. + A TypedObjectListView is not more efficient than a normal ObjectListView. + Underneath, the same name of casts are performed. But it is easier to use since you + do not have to write the casts yourself. + + + The class of model object that the list will manage + + To use a TypedObjectListView, you write code like this: + + TypedObjectListView<Person> tlist = new TypedObjectListView<Person>(this.listView1); + tlist.CheckStateGetter = delegate(Person x) { return x.IsActive; }; + tlist.GetColumn(0).AspectGetter = delegate(Person x) { return x.Name; }; + ... + + To iterate over the selected objects, you can write something elegant like this: + + foreach (Person x in tlist.SelectedObjects) { + x.GrantSalaryIncrease(); + } + + + + + + Create a typed wrapper around the given list. + + The listview to be wrapped + + + + Return the model object that is checked, if only one row is checked. + If zero rows are checked, or more than one row, null is returned. + + + + + Return the list of all the checked model objects + + + + + The ObjectListView that is being wrapped + + + + + Get or set the list of all model objects + + + + + Return the model object that is selected, if only one row is selected. + If zero rows are selected, or more than one row, null is returned. + + + + + The list of model objects that are selected. + + + + + Return a typed wrapper around the column at the given index + + The index of the column + A typed column or null + + + + Return a typed wrapper around the column with the given name + + The name of the column + A typed column or null + + + + Return the model object at the given index + + The index of the model object + The model object or null + + + + CheckStateGetter + + + + + + + Gets or sets the check state getter + + + + + BooleanCheckStateGetter + + + + + + + Gets or sets the boolean check state getter + + + + + CheckStatePutter + + + + + + + + Gets or sets the check state putter delegate + + + + + BooleanCheckStatePutter + + + + + + + + Gets or sets the boolean check state putter + + + + + ToolTipGetter + + + + + + + + Gets or sets the cell tooltip getter + + + + + Gets or sets the header tool tip getter + + + + + This method will generate AspectGetters for any column that has an AspectName. + + + + + A type-safe wrapper around an OLVColumn + + + + + + Creates a TypedColumn + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Generate an aspect getter that does the same thing as the AspectName, + except without using reflection. + + + + If you have an AspectName of "Owner.Address.Postcode", this will generate + the equivilent of: this.AspectGetter = delegate (object x) { + return x.Owner.Address.Postcode; + } + + + + If AspectName is empty, this method will do nothing, otherwise + this will replace any existing AspectGetter. + + + + + + Generates an aspect getter method dynamically. The method will execute + the given dotted chain of selectors against a model object given at runtime. + + The type of model object to be passed to the generated method + A dotted chain of selectors. Each selector can be the name of a + field, property or parameter-less method. + A typed delegate + + + + This method generates the actual IL for the method. + + + + + + + + A virtual object list view operates in virtual mode, that is, it only gets model objects for + a row when it is needed. This gives it the ability to handle very large numbers of rows with + minimal resources. + + A listview is not a great user interface for a large number of items. But if you've + ever wanted to have a list with 10 million items, go ahead, knock yourself out. + Virtual lists can never iterate their contents. That would defeat the whole purpose. + Animated GIFs should not be used in virtual lists. Animated GIFs require some state + information to be stored for each animation, but virtual lists specifically do not keep any state information. + In any case, you really do not want to keep state information for 10 million animations! + + Although it isn't documented, .NET virtual lists cannot have checkboxes. This class codes around this limitation, + but you must use the functions provided by ObjectListView: CheckedObjects, CheckObject(), UncheckObject() and their friends. + If you use the normal check box properties (CheckedItems or CheckedIndicies), they will throw an exception, since the + list is in virtual mode, and .NET "knows" it can't handle checkboxes in virtual mode. + + Due to the limits of the underlying Windows control, virtual lists do not trigger ItemCheck/ItemChecked events. + Use a CheckStatePutter instead. + To enable grouping, you must provide an implmentation of IVirtualGroups interface, via the GroupingStrategy property. + Similarly, to enable filtering on the list, your VirtualListDataSource must also implement the IFilterableDataSource interface. + + + + + Create a VirtualObjectListView + + + + + Gets whether or not this listview is capabale of showing groups + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + This class optimizes the management of CheckStates so that it will work efficiently even on + large lists of item. However, those optimizations are impossible if you install a CheckStateGetter. + With a CheckStateGetter installed, the performance of this method is O(n) where n is the size + of the list. This could be painfully slow. + + + + + Gets or sets whether or not an object will be included in the CheckedObjects + collection, even if it is not present in the control at the moment + + + This property is an implementation detail and should not be altered. + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Gets or sets the strategy that will be used to create groups + + + This must be provided for a virtual list to show groups. + + + + + Gets whether or not the current list is filtering its contents + + + This is only possible if our underlying data source supports filtering. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + Setting this property preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code -- performance is O(n) where n is the number of selected rows. + This method is not thread safe. + The property DOES work on virtual lists, but if you try to iterate through a list + of 10 million objects, it may take some time :) + + + + + This delegate is used to fetch a rowObject, given it's index within the list + + Only use this property if you are not using a VirtualListDataSource. + + + + Should this list show its items in groups? + + + + + Get/set the data source that is behind this virtual list + + Setting this will cause the list to redraw. + + + + Gets or sets the number of rows in this virtual list. + + + There is an annoying feature/bug in the .NET ListView class. + When you change the VirtualListSize property, it always scrolls so + that the focused item is the top item. This is annoying since it makes + the virtual list seem to flicker as the control scrolls to show the focused + item and then scrolls back to where ObjectListView wants it to be. + + + + + Return the number of items in the list + + the number of items in the list + + + + Return the model object at the given index + + Index of the model object to be returned + A model object + + + + Find the given model object within the listview and return its index + + The model object to be found + The index of the object. -1 means the object was not present + + + + Return the OLVListItem that displays the given model object + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Add the given collection of model objects to this control. + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the end of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Scroll the listview so that the given group is at the top. + + The index of the group to be revealed + + If the group is already visible, the list will still be scrolled to move + the group to the top, if that is possible. + + This only works when the list is showing groups (obviously). + + + + + Inserts the given collection of model objects to this control at hte given location + + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the given position of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Update the rows that are showing the given objects + + This method does not resort the items. + + + + Update the rows that are selected + + This method does not resort or regroup the view. + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + Due to problems in the underlying ListView, if you remove all the objects from + the control using this method and the list scroll vertically when you do so, + then when you subsequenially add more objects to the control, + the vertical scroll bar will become confused and the control will draw one or more + blank lines at the top of the list. + + + + + Select the row that is displaying the given model object. All other rows are deselected. + + Model object to select + Should the object be focused as well? + + + + Select the rows that is displaying any of the given model object. All other rows are deselected. + + A collection of model objects + This method has O(n) performance where n is the number of model objects passed. + Do not use this to select all the rows in the list -- use SelectAll() for that. + + + + Set the collection of objects that this control will show. + + + Should the state of the list be preserved as far as is possible. + + + + Get the checkedness of an object from the model. Returning null means the + model does know and the value from the control will be used. + + + + + + + Rebuild the list with its current contents. + + + Invalidate any cached information when we rebuild the list. + + + + + Clear any cached info this list may have been using + + + + + Do the work of creating groups for this control + + + + + + Do the plumbing to disable groups on a virtual list + + + + + Do the plumbing to enable groups on a virtual list + + + + + Return the position of the given itemIndex in the list as it currently shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the last item in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + Return the n'th item (0-based) in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the ListViewItem that appears immediately after the given item. + If the given item is null, the first item in the list will be returned. + Return null if the given item is the last item. + + The item that is before the item that is returned, or null + A OLVListItem + + + + Return the ListViewItem that appears immediately before the given item. + If the given item is null, the last item in the list will be returned. + Return null if the given item is the first item. + + The item that is before the item that is returned + A ListViewItem + + + + Make a list of groups that should be shown according to the given parameters + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + + + + On virtual lists, this cannot work. + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Refresh the given item in the list + + The item to refresh + + + + Change the size of the list + + + + + + Take ownership of the 'objects' collection. This separates our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + VirtualObjectListViews always own their collections, so this is a no-op. + + + + + + Change the state of the control to reflect changes in filtering + + + + + Change the size of the virtual list so that it matches its data source + + + + + Handle the CacheVirtualItems event + + + + + + + Handle a RetrieveVirtualItem + + + + + + + Handle the SearchForVirtualList event, which is called when the user types into a virtual list + + + + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 初始化的时候给个alpha值,这样在灰图片的时候可以半透明 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使图片单色化 + + + + + + + + + + + + 自定义 + + + + + 预置 + + + + + 系统 + + + + + 颜色表示法 + + + + + 根据颜色表示字符串获取对应的颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 从文件中获取Image对象 + 这个函数的主要功能是处理一些ico文件 + 一些ico文件的格式可能比较新，直接Image.FormFile，会报内存不足的异常 + + + 是否将文件读入内存操作，如果为false,将直接返回Image.FromFile，在此情况下， + 必须手动释放Image对象，否则文件将一直处于占用状态，如果为true,则在内存中拷贝副本 + + + + + + 将图像转为Icon对象,使用png格式 + + + + + + + 将图像转为Icon对象 + + + + + + + + 返回适应指定容器大小的图像 + 如果图像的尺寸(长或宽)超出了容器范围,将按比例获取图像的缩略图返回,否则直接返回图像 + 此方法最终调用 Image.GetThumbnailImage + 但是注意,在指定的容器尺寸过小时,返回的Image尺寸不可知,是在为了显示16x16的小缩略图是发现了此问题 + 使用 GetScaleImage + + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + + The source image. + The rectangle to fit in to. + Horizontal image aligment in percent. + Vertical image aligment in percent. + New image size. + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + The image will be centered in the fit box. + + The source image. + The rectangle to fit in to. + New image size. + + + + Gets the scaled size of an image required to fit + in to the given size keeping the image aspect ratio. + + The source image. + The size to fit in to. + New image size. + + + + 获取一个圆角矩形 + + + + 角度 + + + + + 获取一个圆角矩形 + + + 角度 + + + + + + + + + + + + + + + + + + + + + + 返回一个表示箭头的Path + 如果开始坐标和结束坐标之间的距离大于箭头的大小，箭头向结束坐标对齐，顶着结束坐标 + + 开始坐标 + 结束坐标（顶点，方向） + 箭头的长短，大小 + 箭头的粗细 + + + + + 在指定的Image上绘制特定标记 + + + + + 文件不存在 + + + + + + 文件不存在 + + + + + + 无法读取文件 + + + + + + + + + + + + + + + + + + + + + 验证失败中显示错误信息时用的标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + 验证控件的输入 + + + + + + + 自定义验证方法 + 在基础验证都通过后，才会调用自定义验证方法（如果有） + + + + + + + + + + 是否支持 Windows Vista 以上的玻璃效果 + + + + + 是否打开了玻璃效果 + + + + + 获取应用程序主窗体 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 这个缓存是全局的 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 所对应的绑定数据类型 + + + + + 是否对 DataBoundType 的子类型有效 + 默认无效 + 如果设置为 true，又同时添加了基类与子类的 codon，则运行时会取到哪个codon不确定 + 通常取先添加的那个 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取授予该组件的许可证密钥 + + + + + 0:未验证 + 1:验证失败 + 2:验证通过 + + + + + 获取组件的实例或类型的许可证（如果已给定上下文并确定拒绝许可证是否引发异常）。 + + + + + + + + + + 强类型资源类，用于查找本地化字符串等。 + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + Returns a System.String that represents the current System.Object. + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + + + + + + Call GetLanguages() to retrieve a list of possible languages that can be used to set this property. + The default value is the default language. + + + + + Gets a list of available languages defined in this assembly. + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Determines which animation to use while showing the pop-up window. + + + + + Determines which animation to use while hiding the pop-up window. + + + + + Determines the duration of the animation. + + + + + Gets or sets a value indicating whether the content should receive the focus after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether the is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets a minimum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets a maximum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows the pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows the pop-up window below the specified area of the specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the sizing grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Types of animation of the pop-up window. + + + + + Uses no animation. + + + + + Animates the window from left to right. This flag can be used with roll or slide animation. + + + + + Animates the window from right to left. This flag can be used with roll or slide animation. + + + + + Animates the window from top to bottom. This flag can be used with roll or slide animation. + + + + + Animates the window from bottom to top. This flag can be used with roll or slide animation. + + + + + Makes the window appear to collapse inward if it is hiding or expand outward if the window is showing. + + + + + Uses a slide animation. + + + + + Uses a fade effect. + + + + + Uses a roll animation. + + + + + Uses a default animation. + + + + + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the class. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Gets or sets a value indicating whether the combo box is displaying its drop-down portion. + + + true if the drop-down portion is displayed; otherwise, false. The default is false. + + + + + Occurs when the drop-down portion of a is shown. + + + + + Shows the drop down. + + + + + Occurs when the drop-down portion of the is no longer visible. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Represents a Windows combo box control which can be used in a popup's content control. + + + + + Initializes a new instance of the PopupControl.ComboBox class. + + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 白色到灰色的垂直渐变 + + + + + + + + + + This method handles the RenderToolStripBorder event. + + + + + + + + + + + + A ToolstripManager rendering class with advanced control features + + + + + Creates a new EasyRender class for modifications + + + + + + + + + + + + + + + + + + + + Gets the manager to edit and change the appearance of the Toolstrip + + + + + Gets the manager to edit and change the appearance of Toolstrip buttons + + + + + Gets the manager to edit and change the appearance of other Toolstrip controls + + + + + Gets the manager to edit and change the appearance of the Panels + + + + + Gets the manager to edit and change the appearance of the Toolstrip split buttons + + + + + Gets the manager to edit and change the appearance of the Status-bar + + + + + Gets or sets whether to smooth the font text on all controls + + + + + Gets or sets the color of the text if the AlterColor is set to true + + + + + Gets or sets whether to override the font-color on all controls + + + + + Creates a GraphicsPath that appreciates an area where things can be drawn + + The rectangular area which will serve as the base + The curve amount of the corners + + + + + Creates a triangle based on the size and bounds sectors + + The area which the triangle is confined to + The size of the triangle + The direction which the triangle is pointing + + + + + Gets a color array based on the state of a normal button + + The button to check the state of + + + + + + Gets a color array based on the state of a split-button + + The button to check the state of + + + + + + Gets a color array based on the state of a menu-item + + The button to check the state of + + + + + + Gets a color array based on the state of a drop-down button + + The button to check the state of + + + + + + Gets a blending property for a specified type of Toolstrip item + + The Toolstrip item + The type of item this is + + + + + Fills a specified boundary with color + + The Graphics object to draw onto + The boundaries to draw the color + The brush to fill the color + + + + Fills a specified boundary with a gradient with specified colors + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + + + + Fills a specified boundary with a gradient with specified colors at a given angle + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Fills a specified boundary with a gradient with specified colors at a given angle and with blending properties + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a set path with a defined brush + + The Graphics object to draw onto + The path to draw along + The brush to fill the color + + + + Draws a set path with specified colors + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + + + + Draws a set path with specified colors at a given angle + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Draws a set path with specified colors at a given angle with blending properties + + The Graphics object to draw onto + The path to draw along + + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Toolstrip background + + The Toolstrip being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Toolstrip split-button + + The Toolstrip split-button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Statusbar background + + The Statusbar being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Menustrip item + + The Menustrip item + The Graphics object to handle + The parent Toolstrip + + + + Covers the button background rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Applies any and all changes made to the Renderer + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Toolstrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IToolstrip class for customization + + The IToolstrip to import the settings from + + + + Disposes of the IToolstrip class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip background gradient from the top + + + + + Gets or sets the color of the Toolstrip background gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip background + If set to null, the Toolstrip will simply draw the gradient + + + + + Gets or sets the angle which the Toolstrip background will be drawn + + + + + Gets or sets the color of the Toolstrip border gradient from the top + + + + + Gets or sets the color of the Toolstrip border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip border + If set to null, the Toolstrip will simply draw the border + + + + + Gets or sets the angle which the Toolstrip border will be drawn + + + + + Gets or sets the curve of the border of the Toolstrip + + + + + Imports the settings from a previous or pre-defined IToolstrip and applies it to the current + + The IToolstrip to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IToolstripControls class for customization + + + + + Disposes of the IToolstripControls class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip seperator on the dark side + + + + + Gets or sets the color of the Toolstrip seperator on the light side + + + + + Gets or sets the height of the Toolstrip seperator control + + + + + Gets or sets the color of the grip dots/line at the top + + + + + Gets or sets the color of the grip shadow + + + + + Gets or sets in what mode the grip will be drawn + + + + + Gets or sets the distance, in pixels, between each grip dot + + + + + Gets or sets the size of the dots or lines for the grip + + + + + Imports the settings from a previous or pre-defined IToolstripControls and applies it to the current + + The IToolstripControls to import the settings from + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IButton and applies it to the current + + The IButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" and "Click" do not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IDropDownButton and applies it to the current + + The IDropDownButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new ISplitButton class for customization + + + + + Disposes of the ISplitButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Gets or sets when to display the drop-down arrow + + + + + Gets or sets the color of the drop-down arrow + + + + + Imports the settings from a previous or pre-defined ISplitButton and applies it to the current + + The ISplitButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IPanel class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient at the top of the content panel + + + + + Gets or sets the color of the gradient at the bottom of the content panel + + + + + Gets or sets whether each panel inherits the shading from the content panel + + + + + Gets or sets the angle which the background gradient is drawn + + + + + Gets or sets the blend of the background + + + + + Gets or sets a mode to render the background in + + + + + + + + + + Creates a new IStatusBar class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient of the background at the top + + + + + Gets or sets the color of the gradient of the background at the bottom + + + + + Gets or sets the blending that will apply to the background + + + + + Gets or sets the angle which the background gradient will be drawn + + + + + Gets or sets the color of the dark border + + + + + Gets or sets the color of the light border + + + + + Gets or sets the color of the grip at the top-most + + + + + Gets or sets the color of the grip at the bottom-most + + + + + Gets or sets the spacing of the grip blocks + + + + + Imports the settings from a previous or pre-defined IStatusBar and applies it to the current + + The IStatusBar to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Menustrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IMenustrip class for customization + + The IMenustrip to import the settings from + + + + Disposes of the IMenustrip class and clears all resources related to it + + + + + Gets or sets the color of the menu-strip border (dark) + + + + + Gets or sets the color of the menu-strip border (light) + + + + + Gets or sets how the background of the menu-strip is inherited + + + + + If inheritence is set to none, the color of the background gradient at the top + + + + + If inheritence is set to none, the color of the background gradient at the bottom + + + + + If inheritence is set to none, the blending option for the background + + + + + Gets or sets the color of the margin gradient at the left + + + + + Gets or sets the color of the margin gradient at the right + + + + + Gets or sets the color of the margin border (displayed to the right) + + + + + Gets or sets the color of the root menu-strip button background when it is selected + + + + + Gets or sets the color of the root menu-strip button border when it is selected + + + + + Gets or sets the color of the seperator dark color + + + + + Gets or sets the color of the seperator light color + + + + + Gets or sets the inset position of the seperator from the left + + + + + Gets the class that handles the look and feel of the menu-strip items + + + + + Imports the settings from a previous or pre-defined IMenustrip and applies it to the current + + The IMenustrip to import the settings from + + + + Sets the blending for the background to it's default + + + + + Defines when to show an arrow + + + + + + + + + + + + + + + + + + + + Defines when to use a blend property + + + + + Use the blend when the object is drawn + + + + + Use the blend when the object is hovered over + + + + + Use the blend when the object is clicked + + + + + Use the blend when the object is checked + + + + + Always use the blend regardless of the state of the object + + + + + Defines a method of drawing a grip on a control + + + + + Draws the grip as a set of dots + + + + + Draws the grip as two lines + + + + + Does not draw the grip at all, but the object remains moveable + + + + + Defines a specific type of button to search by + + + + + + + + + + + + + + + + + + + + + + + + + Defines a method for background or object inheritence + + + + + + + + + + + + + + + Defines a method of rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 主菜单 + + + + + 背景透明的工具条 + + + + + 银白色至白色渐变 + + + + + 白色至银白色渐变 + + + + + + + + + + + + + + + 当前工作区窗体所关联并激活的工具栏 + + + + + 模拟运行时的外观 + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 鼠标滑过 + + + + + 控件的高度根据内容自动调整，忽略外部设置 + + + + + 边框宽度 + + + + + 文本和description文本之间的间距 + + + + + 最大显示的项数 + + + + + + + + + + 是否显示说明字段，此属性不影响弹出面板是否显示 + 弹出面板是否显示由DescriptionMember是否设置决定 + + + + + + + + + + + + + + + 下拉列表的布局模式 + + + + + + + + + + 是否允许空 + + + + + + + + + + 测量当前控件应该的高度 + + + + + + 整个可用的绘图表面 + + + + + 右边按钮的绘图表面 + + + + + 绘制边框 + + + + + + 绘制背景 + + + + + + 绘制文本 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前热点项生改变 + + + + + + + + + + + + + + + + + + + + + 通过外能事件获取用于绘制项的文本 + + + + + + + + + + + + + + + + + + + + + + + + + + 标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + + + + + + + + + + + + + + + + + + 排序箭头开始颜色 + + + + + 排序箭头开始颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 控件的背景画布颜色 + 因为控件的边框和过度色都有依靠改变透明度实现渐变，所以一个白色的底版就非常重要 + 使过度色不受控件本身背景色的影响，光不绘制背景不行，要刷上白色背景 + + + + + 控件背景色 + + + + + + + + + + + + + + + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 该项具有输入焦点 + + + + + 鼠标滑过 + + + + + + + + + + The item is not visible. + + + + + The item is partially visible. + + + + + The item is fully visible. + + + + + 布局方式 + + + + + 标准布局 + + + + + 使项带有描述的布局 + + + + + 双击项事件参数 + + + + + + + + + + + + + + + + 项被删除事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 为项绘制带有描述信息的渲染器 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + 默认布局引擎，以类似微软ListView的方式按行排列项 + + + + + 框选的最短开始长度 + + + + + 框选时滚动条的自动滚动速度 + + + + + 用于鼠标框选时，框出了控件中项的显示范围时，自动滚动滚动条 + + + + + 自动滚动时，滚动值 + + + + + 是否处于框选状态中 + + + + + 内框offset，内框offset是绝对相对于滚动条的 + + + + + 整个可显示项的边界的offset，包括上下padding部分 + + + + + 鼠标按下时项区域边界的offset，即 _itemsAreaOffset + 用于框选时，跨越可视部队画框 + + + + + 当前所能显示的最大行数 + + + + + + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + + + + + + + + + + + + + + + + + + + + + 没有任何项 + + + + + 没有任何项处于可显示状态 + + + + + 整个控件区域 + + + + + 整个可用于绘制项的可视区域 + 去除左右Padding部分，去除滚动条 + + + + + 用于绘制项的区域 + 考虑边距间隔大小和滚动条区域 + + + + + 项的尺寸 + 不放在ListView本身中定义而是放在LayoutManager中定义，是因为不同的布局方式 + 可能会是带长宽的Size做为itemSize，比如平铺的方式 + + + + + 项周围的边距 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新整个布局引擎的状态 + + + + + 判断指定的项是否处于可见状态 + + + + + + + 获取项的呈现区域 + + + + + + + + + + + + + + + + + + + + 获取当前所有可见项 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculates the maximum number of rows and columns + that can be fully displayed. + + + + + 计算当前可见项的index范围 + + + + + 更新滚动条状态 + + + + + 创建框选框 + + + + + + 根据矩形区域选择项 + + + + + + 应用导航键，如上下左右，返回应用导航键之后的项的坐标 + + + + + 使指定下标的项处于可见状态 + + + + + + 默认渲染器，不绘制项的实际内容，但是绘制DEBUG信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 用于子类重写时删除相应的缓存 + + + + + + 绘制项的背景 + + The System.Drawing.Graphics to draw on. + The client coordinates of the item area. + + + + 绘制最终的前景 + + + + + + 绘制选择边框 + + The System.Drawing.Graphics to draw on. + The client coordinates of the selection rectangle. + + + + 绘制项的边框 + + + + + + + + 绘制项 + + + + + + + 绘制项的背景 + + + + + + + 绘制项的内容 + + + + + + + + 绘制背景 + + + + + + 绘制当前所有可见项 + + + + + + Renders the selection rectangle. + + The graphics to draw on. + + + + 默认渲染器，以类似微软ListView的方式按行绘制项，只绘制简单的文本 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + + + + + + + + + + + + + + + 项的背景色 + + + + + 控件背景色 + + + + + 项的边框色 + + + + + 选择框颜色 + + + + + 选择框的边框色 + + + + + 当控件具有焦点时选定项的背景色 + + + + + + + + + + 控件失去焦点时选定项的背景色 + + + + + + + + + + 热点项的背景色 + + + + + + + + + + 图像内边框颜色 + + + + + 图像外边框颜色 + + + + + + + + + + Creates a control with a border. + + + + + Specifies that the control has a border with a sunken edge. + + + + + + + + + + 是否需要在调用 ResumeLayout 时重绘 + + + + + 为项扩展的用于呈现的属性 + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + 鼠标左键是否处于按下状态 + + + + + 鼠标右键是否处于按下状态 + + + + + 鼠标最后点击的位置 + + + + + 当前鼠标经过的项 + + + + + + + + + + + + + + + 配色方案 + + + + + 当前布局中项的高度 + + + + + + + + + + 是否没有任何项 + + + + + + + + + + 获取当前具有输入焦点的项 + + + + + 默认的用于呈现为项中文本的Property + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + + 请求在下次调用 ResumeLayout 时重绘 + + + + + 获取当前选中的所有项 + + + + + + + + + + + + 设置扩展属性供特定LayoutEngine使用 + 如果指定的 ExtendMember 已存在，覆盖之 + 用String.Empty 或 null 做为 propertyName传入，表示删除指定的 member + + + + + + + + + + + + + + + + + + + + + 恢复正常的布局逻辑。 + + + + + + + + + + + 临时挂起控件的布局逻辑。 + + + + + + + + + + 获取当前选中项所绑定的对象 + 如果没有选中项，返回null，如果选中多项，返回选中项集合中的第一个 + + + + + + 根据指定的绑定项对象 + 设置当前列表中选定的项 + + + + + + 获取当前选中的所有项的绑定对象集合 + 如果当前没有选中任何项，返回空集合 + + + + + + 取消所有项的选择 + + + + + + + + + + + + + + + + 获取创建控件句柄时所需要的创建参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + 项被删除 + + + + + 通过外能事件获取用于绘制项的文本 + + + + + Represents the color palette of the image list view. + + + + + Gets or sets the background color of the ImageListView control. + + + + + Gets or sets the background color of the ImageListViewItem. + + + + + Gets or sets the background color of alternating cells in Details View. + + + + + Gets or sets the border color of the ImageListViewItem. + + + + + Gets or sets the foreground color of the ImageListViewItem. + + + + + Gets or sets the background gradient color1 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color2 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the border color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the fore color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is hovered. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is hovered. + + + + + Gets or sets the border color of the ImageListViewItem if the item is hovered. + + + + + Gets or sets the color of the insertion caret. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is selected. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is selected. + + + + + Gets or sets the border color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the fore color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the background gradient color1 of the column header. + + + + + Gets or sets the background gradient color2 of the column header. + + + + + Gets or sets the background hover gradient color1 of the column header. + + + + + Gets or sets the background hover gradient color2 of the column header. + + + + + Gets or sets the cells foreground color of the column header text. + + + + + Gets or sets the cells background color if column is selected in Details View. + + + + + Gets or sets the color of the separator in Details View. + + + + + Gets or sets the foreground color of the cell text in Details View. + + + + + Gets or sets the foreground color of alternating cells text in Details View. + + + + + Gets or sets the background color of the image pane. + + + + + Gets or sets the separator line color between image pane and thumbnail view. + + + + + Gets or sets the color of labels in pane view. + + + + + Gets or sets the image inner border color for thumbnails and pane. + + + + + Gets or sets the image outer border color for thumbnails and pane. + + + + + Gets or sets the background color1 of the selection rectangle. + + + + + Gets or sets the background color2 of the selection rectangle. + + + + + Gets or sets the color of the selection rectangle border. + + + + + Initializes a new instance of the ImageListViewColor class. + + + + + Initializes a new instance of the ImageListViewColor class + from its string representation. + + String representation of the object. + + + + Copies color values from the given object. + + The source object. + + + + Represents the default color theme. + + + + + Represents the noir color theme. + + + + + Represents the mandarin color theme. + + + + + Sets the color palette to default colors. + + + + + Sets the color palette to mandarin colors. + + + + + Sets the color palette to noir colors. + + + + + Determines whether all color values of the specified + ImageListViewColor are equal to this instance. + + The object to compare with this instance. + true if the two instances have the same color values; + otherwise false. + + + + Returns a hash code for this instance. + + + A hash code for this instance, suitable for use in + hashing algorithms and data structures like a hash table. + + + + + Returns a string that represents this instance. + + + A string that represents this instance. + + + + + 测试坐标 + + + + + 项的坐标 + + + + + 是否点击了项 + + + + + + + + + + + + + + + + + + + + + + 该项当前的选中状态 + + + + + + + + + + + + + + + + + + + + 所绑定的对象 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将指定的事件移动到(紧邻)另一个事件之前 + + + + + + + 将指定的事件移动到(紧邻)另一个事件之后 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Modify a WinForms TreeView control to use the new Explorer style theme + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + WM_COPYDATA消息所要求的数据结构 + + + + + + + + + + + + + + + + + + + + + + + + + 通过窗口的标题来查找窗口的句柄 + + + + + + + + 发送 Windows 消息 + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 发送消息，只能传递一个自定义的消息ID和消息字符串，想传一个结构，但没成功 + + 目标进程名称，如果有多个，则给每个都发送 + 自定义数据，可以通过这个来决定如何解析下面的strMsg + 传递的消息，是一个字符串 + + + + 接收消息，得到消息字符串 + + System.Windows.Forms.Message m + 接收到的消息字符串 + + + + + + + + + 最大圆角半径 + + + + + 最小矩形边长，用于自动处理圆角大小 + + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + 填充区域针对矩形的缩进距离 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + + + + 使图片单色化 + + + + + + + 获取颜色 + + + + + + + + + + + + + 颜色变化时激发 + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + The top left rectangle in auto hide strip area. + + + + + The top right rectangle in auto hide strip area. + + + + + The bottom left rectangle in auto hide strip area. + + + + + The bottom right rectangle in auto hide strip area. + + + + + Gets one of the four auto hide strip rectangles. + + Dock state. + The desired rectangle. + + As the corners are represented by , , , and , + the four strips can be easily calculated out as the borders. + + + + + Context menu. + + + This property should be obsolete as it does not support theming. Please use instead. + + + + + Context menu strip. + + + + + Overridden to avoid resize issues with nested controls + + + http://blogs.msdn.com/b/alejacma/archive/2008/11/20/controls-won-t-get-resized-once-the-nesting-hierarchy-of-windows-exceeds-a-certain-depth-x64.aspx + http://support.microsoft.com/kb/953934 + + + + + Determines whether the close button is visible on the content + + + + + There's a bug in the WinForms layout engine + that can result in a deferred layout to not + properly clear out the cached layout args after + the layout operation is performed. + Specifically, this bug is hit when the bounds of + the Pane change, initiating a layout on the parent + (DockWindow) which is where the bug hits. + To work around it, when a pane loses the DockWindow + as its parent, that parent DockWindow needs to + perform a layout to flush the cached args, if they exist. + + + + + Gets a value indicating whether dock panel can be dragged when in auto hide mode. + Default is false. + + + + + Determines the color with which the client rectangle will be drawn. + If this property is used instead of the BackColor it will not have any influence on the borders to the surrounding controls (DockPane). + The BackColor property changes the borders of surrounding controls (DockPane). + Alternatively both properties may be used (BackColor to draw and define the color of the borders and DockBackColor to define the color of the client rectangle). + For Backgroundimages: Set your prefered Image, then set the DockBackColor and the BackColor to the same Color (Control) + + + + + Dock area. + + + This is the center rectangle of control. + + Excluded spaces are for the following visual elements, + * Auto hide strips on four sides. + * Necessary paddings defined in themes. + + Therefore, all dock contents mainly fall into this area (except auto hide window, which might slightly move beyond this area). + + + + + Flag to show autohide content on mouse hover. Default value is true. + + + This flag is ignored in VS2012/2013 themes. Such themes assume it is always false. + + + + + DragHandlerBase is the base class for drag handlers. The derived class should: + 1. Define its public method BeginDrag. From within this public BeginDrag method, + DragHandlerBase.BeginDrag should be called to initialize the mouse capture + and message filtering. + 2. Override the OnDragging and OnEndDrag methods. + + + + + Loads layout from XML file. + + The file name. + Deserialization handler. + Deserialization might throw exceptions. + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + Deserialization might throw exceptions. + + The stream is closed after deserialization. + + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + The flag to close the stream after deserialization. + Deserialization might throw exceptions. + + + + Deserialization handler of layout file/stream. + + Strings stored in layout file/stream. + Dock content deserialized from layout/stream. + + The deserialization handler method should handle all possible exceptions. + + If any exception happens during deserialization and is not handled, the program might crash or experience other issues. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The skin to use when displaying the DockPanel. + The skin allows custom gradient color schemes to be used when drawing the + DockStrips and Tabs. + + + + + The skin used to display the auto hide strips and tabs. + + + + + The skin used to display the Document and ToolWindow style DockStrips and Tabs. + + + + + The skin used to display the auto hide strip and tabs. + + + + + The gradient color skin for the DockStrips. + + + + + The gradient color skin for the Tabs. + + + + + The gradient color skin for the Tabs. + + + + + Font used in AutoHideStrip elements. + + + + + The skin used to display the document and tool strips and tabs. + + + + + The skin used to display the Document style DockPane strip and tab. + + + + + The skin used to display the ToolWindow style DockPane strip and tab. + + + + + Font used in DockPaneStrip elements. + + + + + The skin used to display the DockPane ToolWindow strip and tab. + + + + + The skin used to display the active ToolWindow caption. + + + + + The skin used to display the inactive ToolWindow caption. + + + + + The skin used to display the DockPane strip and tab. + + + + + The gradient color skin for the DockStrip. + + + + + The skin used to display the active DockPane tabs. + + + + + The skin used to display the inactive DockPane tabs. + + + + + The skin used to display the dock pane tab + + + + + The text color. + + + + + The skin used to display the dock pane tab + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient color skin. + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient mode to display the colors. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Dock window base class. + + + + + Dock window of Visual Studio 2003/2005 theme. + + + + + The location to draw the DockPaneStrip for Document style windows. + + + + + + + + + + + + + + + Gets images for tabs and captions. + + + + + + + + + + Gets images for docking indicators. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Switches a pane with its first child in the pane hierarchy. (The actual hiding happens elsewhere.) + + Pane to switch + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Determines whether the close button is visible on the content + + + + + Calculate which tabs are displayed and in what order. + + + + + Visual Studio 2005 theme (default theme). + + + + + + + + + + X for this inside the logical strip rectangle. + + + + + Width of this . + + + + + Dock window of Visual Studio 2012 Light theme. + + + + + Initializes a new instance of the class. + + The dock panel. + State of the dock. + + + + Determines whether the close button is visible on the content + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculate which tabs are displayed and in what order. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 theme base. + + + + + + + + + + + + + + + + diff --git a/Bin/Debug/CommonControls/.NET4/RaUIV3.dll b/Bin/Debug/CommonControls/.NET4/RaUIV3.dll new file mode 100644 index 0000000..e32d4e6 Binary files /dev/null and b/Bin/Debug/CommonControls/.NET4/RaUIV3.dll differ diff --git a/Bin/Debug/CommonControls/.NET4/ryControls.xml b/Bin/Debug/CommonControls/.NET4/RaUIV3.xml similarity index 53% rename from Bin/Debug/CommonControls/.NET4/ryControls.xml rename to Bin/Debug/CommonControls/.NET4/RaUIV3.xml index b1b565f..45c0bce 100644 --- a/Bin/Debug/CommonControls/.NET4/ryControls.xml +++ b/Bin/Debug/CommonControls/.NET4/RaUIV3.xml @@ -1,32830 +1,59963 @@ - - - - ryControls - - - - - Martin Lottering : 2007-10-27 - -------------------------------- - This is a usefull control in Filters. Allows you to save space and can replace a Grouped Box of CheckBoxes. - Currently used on the TasksFilter for TaskStatusses, which means the user can select which Statusses to include - in the "Search". - This control does not implement a CheckBoxListBox, instead it adds a wrapper for the normal ComboBox and Items. - See the CheckBoxItems property. - ---------------- - ALSO IMPORTANT: In Data Binding when setting the DataSource. The ValueMember must be a bool type property, because it will - be binded to the Checked property of the displayed CheckBox. Also see the DisplayMemberSingleItem for more information. - ---------------- - Extends the CodeProject PopupComboBox "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp" - by Lukasz Swiatkowski. - - - - - - - - - - The checkbox list control. The public CheckBoxItems property provides a direct reference to its Items. - - - - - In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. - The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display - a concatenated Text of the items selected. This concatenation and its formatting however is controlled - by the Binded object, since it owns that property. - - - - - Builds a CSV string of the items selected. - - - - - A direct reference to the Items of CheckBoxComboBoxListControl. - You can use it to Get or Set the Checked status of items manually if you want. - But do not manipulate the List itself directly, e.g. Adding and Removing, - since the list is synchronised when shown with the ComboBox.Items. So for changing - the list contents, use Items instead. - - - - - The DataSource of the combobox. Refreshes the CheckBox wrappers when this is set. - - - - - The ValueMember of the combobox. Refreshes the CheckBox wrappers when this is set. - - - - - In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. - The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display - a concatenated Text of the items selected. This concatenation however is controlled by the Binded - object, since it owns that property. - - - - - Made this property Browsable again, since the Base Popup hides it. This class uses it again. - Gets an object representing the collection of the items contained in this - System.Windows.Forms.ComboBox. - - A System.Windows.Forms.ComboBox.ObjectCollection representing the items in - the System.Windows.Forms.ComboBox. - - - - - - - - - - - - - - - - - Will add an invisible item when the style is DropDownList, - to help maintain the correct text in main TextBox. - - - - - - - - - - - - A function to clear/reset the list. - (Ubiklou : http://www.codeproject.com/KB/combobox/extending_combobox.aspx?msg=2526813#xx2526813xx) - - - - - Uncheck all items. - - - - - The properties that will be assigned to the checkboxes as default values. - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - A container control for the ListControl to ensure the ScrollBar on the ListControl does not - Paint over the Size grip. Setting the Padding or Margin on the Popup or host control does - not work as I expected. - - - - - - - - - - Prescribed by the Popup class to ensure Resize operations work correctly. - - - - - - This ListControl that pops up to the User. It contains the CheckBoxComboBoxItems. - The items are docked DockStyle.Top in this control. - - - - - - - - - - - Simply a reference to the CheckBoxComboBox. - - - - - A Typed list of ComboBoxCheckBoxItems. - - - - - - - - - - Prescribed by the Popup control to enable Resize operations. - - - - - - - - - - - - Maintains the controls displayed in the list by keeping them in sync with the actual - items in the combobox. (e.g. removing and adding as well as ordering) - - - - - The CheckBox items displayed in the Popup of the ComboBox. - - - - - - - A reference to the CheckBoxComboBox. - A reference to the item in the ComboBox.Items that this object is extending. - - - - A reference to the CheckBoxComboBox. - - - - - A reference to the Item in ComboBox.Items that this object is extending. - - - - - A reference to the Item in ComboBox.Items that this object is extending. - - - - - When using Data Binding operations via the DataSource property of the ComboBox. This - adds the required Bindings for the CheckBoxes. - - - - - - - - - - - Added this handler because the control doesn't seem - to initialize correctly until shown for the first - time, which also means the summary text value - of the combo is out of sync initially. - - - - - A Typed List of the CheckBox items. - Simply a wrapper for the CheckBoxComboBox.Items. A list of CheckBoxComboBoxItem objects. - This List is automatically synchronised with the Items of the ComboBox and extended to - handle the additional boolean value. That said, do not Add or Remove using this List, - it will be lost or regenerated from the ComboBox.Items. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Returns the item with the specified displayName or Text. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Called when any property changes. - - - - - - - - - - CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". - - - - - CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". - - - - - CodeProject.com Simple pop-up control http://www.codeproject.com/cs/miscctrl/simplepopup.asp. - Represents a pop-up window. - - - - - Gets the content of the pop-up. - - - - - Gets a value indicating whether the PopupControl.Popup uses the fade effect. - - true if pop-up uses the fade effect; otherwise, false. - To use the fade effect, the FocusOnOpen property also has to be set to true. - - - - Gets or sets a value indicating whether to focus the content after the pop-up has been opened. - - true if the content should be focused after the pop-up has been opened; otherwise, false. - If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. - - - - Gets or sets a value indicating whether presing the alt key should close the pop-up. - - true if presing the alt key does not close the pop-up; otherwise, false. - - - - Gets or sets a value indicating whether this PopupControl.Popup is resizable. - - true if resizable; otherwise, false. - - - - Gets or sets the size that is the lower limit that can specify. - - An ordered pair of type representing the width and height of a rectangle. - - - - Gets or sets the size that is the upper limit that can specify. - - An ordered pair of type representing the width and height of a rectangle. - - - - Gets parameters of a new window. - - An object of type used when creating a new window. - - - - Initializes a new instance of the PopupControl.Popup class. - - The content of the pop-up. - - Pop-up will be disposed immediately after disposion of the content control. - - is null. - - - - Processes a dialog box key. - - One of the values that represents the key to process. - - true if the key was processed by the control; otherwise, false. - - - - - Updates the pop-up region. - - - - - Shows pop-up window below the specified control. - - The control below which the pop-up will be shown. - - When there is no space below the specified control, the pop-up control is shown above it. - - is null. - - - - Shows pop-up window below the specified area of specified control. - - The control used to compute screen location of specified area. - The area of control below which the pop-up will be shown. - - When there is no space below specified area, the pop-up control is shown above it. - - is null. - - - - Adjusts the size of the owner to accommodate the if the owner is currently displayed, or clears and resets active child controls of the if the is not currently displayed. - - true if the owner is currently displayed; otherwise, false. - - - - Raises the event. - - An that contains the event data. - - - - Raises the event. - - A that contains the event data. - - - - Raises the event. - - An that contains the event data. - - - - - - - - - - - - - - - - - - - - - Processes Windows messages. - - The Windows to process. - - - - Processes the resizing messages. - - The message. - true, if the WndProc method from the base class shouldn't be invoked. - - - - Paints the size grip. - - The instance containing the event data. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". - Represents a Windows combo box control with a custom popup control attached. - - - - - Initializes a new instance of the PopupControl.PopupComboBox class. - - - - - The pop-up wrapper for the dropDownControl. - Made PROTECTED instead of PRIVATE so descendent classes can set its Resizable property. - Note however the pop-up properties must be set after the dropDownControl is assigned, since this - popup wrapper is recreated when the dropDownControl is assigned. - - - - - Gets or sets the drop down control. - - The drop down control. - - - - Shows the drop down. - - - - - Hides the drop down. - - - - - Processes Windows messages. - - The Windows to process. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - Maintains an additional "Selected" and "Count" value for each item in a List. - Useful in the CheckBoxComboBox. It holds a reference to the List[Index] Item and - whether it is selected or not. - It also caters for a Count, if needed. - - - - - No property on the object is specified for display purposes, so simple ToString() operation - will be performed. And no Counts will be displayed - - - - - No property on the object is specified for display purposes, so simple ToString() operation - will be performed. - - - - - A Display "Name" property is specified. ToString() will not be performed on items. - This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. - If a PropertyDescriptor is not found, a Property will be used. - - - - - A Display "Name" property is specified. ToString() will not be performed on items. - This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. - If a PropertyDescriptor is not found, a Property will be used. - - - - - Is a Count indicator used. - - - - - The original List of values wrapped. A "Selected" and possibly "Count" functionality is added. - - - - - Used to indicate NOT to use ToString(), but read this property instead as a display value. - - - - - When specified, indicates that ToString() should not be performed on the items. - This property will be read instead. - This is specifically useful on DataTable implementations, where PropertyDescriptors are used to read the values. - - - - - Builds a concatenation list of selected items in the list. - - - - - Indicates whether the Item display value (Name) should include a count. - - - - - Reset all counts to zero. - - - - - Creates a ObjectSelectionWrapper item. - Note that the constructor signature of sub classes classes are important. - - - - - - - - - - - - - - Used together with the ListSelectionWrapper in order to wrap data sources for a CheckBoxComboBox. - It helps to ensure you don't add an extra "Selected" property to a class that don't really need or want that information. - - - - - - - - - - - - Used as a count indicator for the item. Not necessarily displayed. - - - - - Is this item selected. - - - - - A reference to the wrapped item. - - - - - The containing list for these selections. - - - - - An indicator of how many items with the specified status is available for the current filter level. - Thaught this would make the app a bit more user-friendly and help not to miss items in Statusses - that are not often used. - - - - - A reference to the item wrapped. - - - - - The item display value. If ShowCount is true, it displays the "Name [Count]". - - - - - The textbox display value. The names concatenated. - - - - - Indicates whether the item is selected. - - - - - - - - - - - - - - - - 控件状态 - - - - - 无 - - - - - 获得焦点 - - - - - 失去焦点 - - - - - 鼠标指针进入控件 - - - - - Toolbar控件 - - - - - - - - - - - - - - - 获取或设置控件显示的图片 - - - - - 重写控件焦点属性 - - - - - 自定义绘制 - - - - - - 焦点进入 - - - - - - 失去焦点 - - - - - - 禁止调整大小 - - - - - - - - - - - - - - - - - - 只响应单击鼠标左键事件 - - - - - - 按比例缩放图片 - - - - - - - 图片缩放 - - 源图片 - 缩放图片的宽度 - 缩放图片的高度 - 缩放的图片 - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 绘图对像 - - 绘图对像 - 图片 - 绘置的图片大小、坐标 - 绘置的图片边界 - 当前状态 - 状态总数 - - - - 绘图对像 - - 绘图对像 - 图片对像 - 绘置的图片大小、坐标 - 当前状态 - 状态总数 - - - - - - - - - 得到要绘置的图片对像 - - 图像在程序集中的地址 - - - - - 得到要绘置的图片对像 - - 图像在程序集中的路径 - 图像在程序集中的地址 - - - - - 获取资源图标 - - - - - - - 得到图程序集中的图片对像 - - 图像在程序集中的地址 - - - - - 得到图程序集中的图片对像 - - 图像在程序集中的路径 - 图像在程序集中的地址 - - - - - 控件的状态。 - - - - - 正常 - - - - - 鼠标经过 - - - - - 鼠标按下 - - - - - 鼠标的当前位置 - - - - - - - - - - - - - - - - - - - - 美化按钮 - - - - - 普通按钮矩形位置 - - - - - 美化按钮 - - - - - 分割按钮的宽度 - - - - - 是否启用分割按钮 - - - - - 优先使用默认皮肤 - - - - - 按钮基础背景色 - - - - - 按钮字体颜色 - - - - - 图片宽度,默认值为18px，最小12px - - - - - 圆角的位置,默认全部都是圆角 - - - - - 设置圆角半径 - - - - - 背景色是否渐变 - - - - - 图片高度 - - - - - 图片与文字之间的间距 - - - - - 当鼠标按下时图片和文字是否产生偏移 - - - - - 鼠标进入时 - - - - - - 鼠标离开 - - - - - - 鼠标按下 - - - - - - 鼠标弹起 - - - - - - 鼠标当前所在位置 - - - - - 获取图像以及文字的位置 - - - - - - - - - - - - - - - - - - - - - - - - 添加菜单分隔线 - - - - - - 添加菜单 - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 增强版Label(禁用了双击Label会自动复制文本到剪切板的功能) - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 增强富文本控件 - - - - - 开始更新 - - - - - 结束更新 - - - - - RichTextBox - - - - - - - - - - - - - - - - - - - - - - - 在自带菜单弹出前激发 - - - - - 根据标签获得菜单项 - - - - - - - 只允许输入文本(只对设置之后的人工输入有效) - - - - - 按下按键 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 鼠标按下 - - - - - - - - - - - - - - - - - - 当文本框为空时,显示的内容。 - - - - - 添加菜单分隔线 - - - - - - 添加菜单 - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - 消息列表控件 - - - - - 最大高度 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 建立圆角路径的样式。 - - - - - 四个角都不是圆角。 - - - - - 四个角都为圆角。 - - - - - 左边两个角为圆角。 - - - - - 右边两个角为圆角。 - - - - - 上边两个角为圆角。 - - - - - 下边两个角为圆角。 - - - - - 左下角为圆角。 - - - - - 右下角为圆角。 - - - - - 画图相关API - - - - - 建立带有圆角样式的路径。 - - 用来建立路径的矩形。 - 圆角的大小。 - 圆角的样式。 - 是否把矩形长宽减 1,以便画出边框。 - 建立的路径。 - - - - 窗体皮肤 - - - - - 窗体皮肤 - - - - - 标题属性 - - - - - 是否使用父窗口的图标 - - - - - 点击最小化按钮是最小化还是隐藏 - - - - - 最大化按钮 - - - - - 最小化按钮 - - - - - 标题栏关闭按钮是否显示 - - - - - 当窗口位于后台时，是否标注显示。 - - - - - - - - - - 标题栏字体颜色 - - - - - 标题栏不处于活动状态时的字体颜色 - - - - - 标题栏背景颜色 - - - - - 标题栏不处于活动状态时的背景颜色 - - - - - 是否允许拖拉窗体边缘来改变窗体大小 - - - - - - - - - - - 画边框 - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - 热键文本框 - - - - - 热键文本框 - - - - - - - - - - - - - - - - - 在控件大小变化时发生 - - - - - - 此属性无效 - - - - - 载入热键配置 - - - - - - 保存热键 - - - - - - 是否含义热键 - - - - - 读取或设置热键 - - - - - 功能键 - - - - - 热键按键 - - - - - KeyDown事件 - - - - - - KeyDown事件 - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 图标列表控件 - - - - - 图标列表控件 - - - - - 图标大小 - - - - - 文本显示高度(从底部算起) - - - - - 默认图标 - - - - - 是否显示图标 - - - - - 是否显示网格线 - - - - - 角标图标合集 - - - - - 画项 - - - - - - 选择项的背景开始颜色 - - - - - 选择项的背景结束颜色 - - - - - 选择项的边框颜色 - - - - - 选择项的字体颜色 - - - - - 重绘选中时背景 - - - - - 重绘图标 - - - 区域大小 - - - - - - - - 重绘文本 - - - - - 获取文本对齐 - - - - - 水平滚动条滚动事件 - - - - - 垂直滚动条滚动事件 - - - - - - - - - - - 列表项 - - - - - 图标 - - - - - 角标图片序号,为-1表示无角标 - - - - - - - - - - - - - - - 最大高度 - - - - - 标题 - - - - - 是否显示时间 - - - - - 添加时间 - - - - - - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 最大高度 - - - - - 标题 - - - - - 是否显示时间 - - - - - 添加时间 - - - - - 内容 - - - - - 网址 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 图标 - - - - - 标题 - - - - - 悬浮提示 - - - - - 标题颜色 - - - - - 设置按钮 - - - - - - - 判断和设置是否选择 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 绘制边框 - - 消息 - - - - 类说明：CContextMenuStrip控件的实现用来代替系统的ContextMenuStrip控件 - - - - - - - - - - - - - - - - 重写OnCreateControl - - - - - 重写OnPaint事件 - - - - - - CreateRoundedRectanglePath - - Rectangle - - - - - - 系统热键数据类。 - - - - - 系统热键数据类 - - - - - 使多行属性失效掉 - - - - - 使只读属性失效掉 - - - - - 获取热键文本 - - - - - 功能键 - - - - - 热键按键 - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 增强时间控件 - - - - - 增强时间控件 - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 选择文本框 - - - - - 选择文本框 - - - - - 按钮基础背景色 - - - - - 优先使用默认皮肤 - - - - - 选择的id - - - - - 选择的名称 - - - - - 选择的名称 - - - - - 字体 - - - - - 重新设置大小 - - - - - 在选择时激发 - - - - - 点击选择 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 可以改变文本行距（行间距）的Label - - - - - 行间距 - - - - - 可以改变文本行距（行间距）的Label - - - - - - - - - - 字体高度 - - - - - - - - - - 文本 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 计算两个日期的时间间隔,返回的是日期值+ - - 时间值,将显示在返回的值里 - 参照时间 - - - - - - - - - - - - - - - 控件边框颜色 - - - - - 控件背景颜色 - - - - - 圆角弧度大小 - - - - - 圆角风格 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - 在搜索时激发 - - - - - 文本变化时激发 - - - - - 文本变化时激发 - - - - - 双击时激发 - - - - - - - - - - - - - - - 文本为空时的显示效果 - - - - - 文本不选中 - - - - - 有内容时的显示效果 - - - - - 当文本框为空时,显示的内容。 - - - - - 字体 - - - - - 优先使用默认皮肤 - - - - - 背景色是否渐变 - - - - - 按钮基础背景色 - - - - - 按钮圆角部分背景颜色 - - - - - - - - - - 重新设置大小 - - - - - 点击搜索按钮 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - - - - - - 使用公共皮肤 - - - - - 按钮颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - 皮肤公共类 - - - - - 是否使用默认皮肤 - - - - - 按钮皮肤 - - - - - 按钮皮肤类 - - - - - 背景颜色 - - - - - 字体颜色 - - - - - 是否颜色渐变 - - - - - 类说明：帮助类 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 修改控件或窗体的边框，例如Textbox或是Form窗体 - - 消息 - 控件对象 - 边框像素 - 边框颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 超级图片控件,支持加载工程内部图片、异步加载网络图片 - - - - - 超级图片控件,支持加载工程内部图片、异步加载网络图片 - - - - - 图片所在上级域名 - - - - - 图片资源所在上级文件夹 - - - - - 根据不同前缀，加载不同格式图片。i:表示工程内置图片;s:表示T_ImageDomain域名下的图片,u:表示指定url的图片;f:表示本地图片 - - - - - - 加载本地图片,加载完毕不会占用本地图片 - - - - - - 加载指定url图片 - - url位置 - 是否异步 - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 多标签控件 - - - - - - - - - - 选项发生变化时激发 - - - - - 标签选择的序号 - - - - - - - - - - 选择的颜色 - - - - - 多标签控件颜色 - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 多标签控件 - - - - - - - - - - 获取对应的标签 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 美化文本框控件 - - - - - 文本变化时激发 - - - - - 文本变化时激发 - - - - - 双击时激发 - - - - - - - - - - 是否只能输入数字 - - - - - 是否多行 - - - - - 是否在显示不下时换行 - - - - - 最大长度 - - - - - - - - - - 背景颜色 - - - - - 右键菜单 - - - - - 字体颜色 - - - - - 选择的开始位置 - - - - - 选择的长度 - - - - - 选择的文本 - - - - - 提示文本 - - - - - 选择全部 - - - - - 密码 - - - - - 是否只读 - - - - - - - - - - - 文本为空时的显示效果 - - - - - 字体 - - - - - 有内容时的显示效果 - - - - - 当文本框为空时,显示的内容。 - - - - - - - - - - 选择文本框中的文本范围 - - 文本框中当前选定文本的第一个字符的位置。 - 要选择的字符数 - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - Define some Windows message constants - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This class adds to the functionality provided in System.Windows.Forms.MenuStrip. - - It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to - bring the form into focus and once more to take the desired action - - It also implements a SuppressHighlighting property to turn off the highlighting - that occures on mouseover when the form is not active - - - - - Gets or sets whether the control honors item clicks when its containing form does - not have input focus. - - - Default value is false, which is the same behavior provided by the base ToolStrip class. - - - - - Gets or sets whether the control shows highlighting on mouseover - - - Default value is true, which is the same behavior provided by the base MenuStrip class. - - - - - This method overrides the procedure that responds to Windows messages. - - It intercepts the WM_MOUSEMOVE message - and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. - Otherwise, it calls the base class procedure to handle the message. - - It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with - an "Activate" result if ClickThrough is enabled. - - - - - - This class adds to the functionality provided in System.Windows.Forms.ToolStrip. - - It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to - bring the form into focus and once more to take the desired action - - It also implements a SuppressHighlighting property to turn off the highlighting - that occures on mouseover when the form is not active - - - - - Gets or sets whether the control honors item clicks when its containing form does - not have input focus. - - - Default value is false, which is the same behavior provided by the base ToolStrip class. - - - - - Gets or sets whether the control shows highlighting on mouseover - - - Default value is true, which is the same behavior provided by the base MenuStrip class. - - - - - This method overrides the procedure that responds to Windows messages. - - It intercepts the WM_MOUSEMOVE message - and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. - Otherwise, it calls the base class procedure to handle the message. - - It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with - an "Activate" result if ClickThrough is enabled. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 还原 - - - - - 移动 - - - - - 大小 - - - - - 最小化 - - - - - 最大化 - - - - - 关闭 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 透明图片控件 - - - - - 是否使用透明,默认为True - - - - - 设置透明度 - - - - - 要绑定的控件 - - - - - 透明图片控件 - - - - - 图片 - - - - - 初始化加载控件 - - 透明度 - 是否显示加载图片 - 图片 - - - - - - - - - - - - - - - 显示加载 - - - - - 隐藏加载 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - 获得当前进程，以便重绘控件 - - - - - - - 是否启用热点效果 - - - - - 边框颜色 - - - - - 热点边框颜色 - - - - - 是否鼠标MouseOver状态 - - - - - 是否启用热点效果 - - - - - 边框颜色 - - - - - 热点时边框颜色 - - - - - - - - - - 鼠标移动到该控件上时 - - - - - - 当鼠标从该控件移开时 - - - - - - 当该控件获得焦点时 - - - - - - 当该控件失去焦点时 - - - - - - 获得操作系统消息 - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 一个强类型的资源类，用于查找本地化的字符串等。 - - - - - 返回此类使用的缓存的 ResourceManager 实例。 - - - - - 重写当前线程的 CurrentUICulture 属性，对 - 使用此强类型资源类的所有资源查找执行重写。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 日控件 - - - - - 日控件 - - - - - 当前日期 - - - - - 在发生页码变化前激发 - - - - - 设置休息状态,1为休息,-1为上班，其它为不显示 - - - - - - 日期 - - - - - 农历 - - - - - 阳历日期字体颜色 - - - - - 阳历日期字体 - - - - - 农历日期字体 - - - - - 农历部分字体颜色 - - - - - 是否选中 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 日历控件 - - - - - 单击事件 - - - - - - - 单击某个日期事件 - - - - - 日历控件 - - - - - 设置日期 - - - - - 放假数据表 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - 设置管理类,快速添加设置。 - - - - - 设置管理类,快速添加设置。 - - - - - 设置管理类,快速添加设置。 - - - - - - 存储类型 - - - - - 配置存储路径 - - - - - 设置XML内容 - - - - - 添加控件 - - - - - - - - 设置值 - - - - - - - - 添加控件 - - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 添加控件 - - - - - - - - - 读取配置 - - - - - 保存配置 - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - 类 名:ColorHSL - 功 能:H 色相 \ S 饱和度(纯度) \ L 亮度 颜色模型 - 日 期:2015-02-08 - 修 改:2015-03-20 - 作 者:ls9512 - - - - - HSL颜色 - - - - - - - - 色相 - - - - - 饱和度(纯度) - - - - - 饱和度 - - - - - 类 名:ColorHSV - 功 能:H 色相 \ S 饱和度(纯度) \ V 明度 颜色模型 - 日 期:2015-01-22 - 修 改:2015-03-20 - 作 者:ls9512 - - - - - 构造方法 - - - - - - - - 色相 - - - - - 饱和度(纯度) - - - - - 明度 - - - - - 类 名:ColorRGB - 功 能:R 红色 \ G 绿色 \ B 蓝色 颜色模型 - 所有颜色模型的基类,RGB是用于输出到屏幕的颜色模式,所以所有模型都将转换成RGB输出 - 日 期:2015-01-22 - 修 改:2015-03-20 - 作 者:ls9512 - - - - - 构造方法 - - - - - - - - - - - - - - 红色 - - - - - 绿色 - - - - - 蓝色 - - - - - 获取实际颜色 - - - - - - 类 名:ColorHelper - 功 能:提供从RGB到HSV/HSL色彩空间的相互转换 - 日 期:2015-02-08 - 修 改:2015-03-20 - 作 者:ls9512 - - - - - RGB转换HSV - - - - - - - HSV转换RGB - - - - - - - RGB转换HSL - - - - - - - HSL转换RGB - - H, S and L input range = 0 -1.0 - - - - - RGB转CMYK - - - - - - - - - - RGB转CMYK - - - - - - - - - - - - CMYK转RGB - - - - - - - - - - Standard-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源. - - - - - - - - - XYZ → Standard-RGB,X、Y、Z 使用 D65/2°标准光源. - - - - - - - - - XYZ → Adobe-RGB,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 - - - - - - - - - Adobe-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 - - - - - - - - - Yxy转RGB - - - - - - - - - RGB转Yxy - - - - - - - - - 超级颜色选择控件 - - - - - - - - - - - - - - - - - - - - - - - - - - 获取网页颜色 - - - - - 超级颜色选择控件 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要修改 - 使用代码编辑器修改此方法的内容。 - - - - - Chrome风格的多标签控件 - - - - - 设置选项卡处于选中状态时第一背景色. - - - - - 设置选项卡处于选中状态时第二背景色. - - - - - 设置选项卡处于非选中状态时第一背景色. - - - - - 设置选项卡处于非选中状态时第二背景色. - - - - - 设置鼠标移动到非选中状态选项卡时第一背景色. - - - - - 设置鼠标移动到非选中状态选项卡时第二背景色. - - - - - 设置选项卡工作区背景色. - - - - - 设置选项卡工作区背景图. - - - - - 是否显示关闭按钮 - - - - - 是否显示新增按钮 - - - - - 是否允许拖拽标签 - - - - - 标签最大宽度 - - - - - 标签右键菜单 - - - - - 鼠标按下标签时激发 - - - - - 鼠标放开标签时激发 - - - - - Chrome风格的多标签控件 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 设置圆角半径 - - - - - Tab文字左边距离 - - - - - - - - - - - - - - 画标签文字 - - - - - - - - - 画标签图标 - - - - - - - 画关闭按钮 - - - - - - - - 获取所有选项卡合起来的宽度 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 添加新标签 - - - - - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - The position is not over a tab. - - - - - The position is over a tab's icon. - - - - - The position is over a tab's text. - - - - - The position is over a tab but not over its icon or its text. For owner-drawn tab controls, this value is specified if the position is anywhere over a tab. - TCHT_ONITEM is a bitwise-OR operation on TCHT_ONITEMICON and TCHT_ONITEMLABEL. - - - - - Specifies values from SetWindowPosZ enumeration. - - - - - Specified HWND_TOP enumeration value. - - - - - Specified HWND_BOTTOM enumeration value. - - - - - Specified HWND_TOPMOST enumeration value. - - - - - Specified HWND_NOTOPMOST enumeration value. - - - - - Invalidates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. - You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_INVALIDATE invalidates the entire window. - - - - Causes the OS to post a WM_PAINT message to the window regardless of whether a portion of the window is invalid. - - - - Causes the window to receive a WM_ERASEBKGND message when the window is repainted. - Specify this value in combination with the RDW_INVALIDATE value; otherwise, RDW_ERASE has no effect. - - - - - Validates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. - You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_VALIDATE validates the entire window. - This value does not affect internal WM_PAINT messages. - - - - Suppresses any pending WM_ERASEBKGND messages. - - - Excludes child windows, if any, from the repainting operation. - - - Includes child windows, if any, in the repainting operation. - - - Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND and WM_PAINT messages before the RedrawWindow returns, if necessary. - - - - Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND messages before RedrawWindow returns, if necessary. - The affected windows receive WM_PAINT messages at the ordinary time. - - - - - Specifies values from Msgs enumeration. - - - - - Specified WM_NULL enumeration value. - - - - - Specified WM_CREATE enumeration value. - - - - - Specified WM_DESTROY enumeration value. - - - - - Specified WM_MOVE enumeration value. - - - - - Specified WM_SIZE enumeration value. - - - - - Specified WM_ACTIVATE enumeration value. - - - - - Specified WM_SETFOCUS enumeration value. - - - - - Specified WM_KILLFOCUS enumeration value. - - - - - Specified WM_ENABLE enumeration value. - - - - - Specified WM_SETREDRAW enumeration value. - - - - - Specified WM_SETTEXT enumeration value. - - - - - Specified WM_GETTEXT enumeration value. - - - - - Specified WM_GETTEXTLENGTH enumeration value. - - - - - Specified WM_PAINT enumeration value. - - - - - Specified WM_CLOSE enumeration value. - - - - - Specified WM_QUERYENDSESSION enumeration value. - - - - - Specified WM_QUIT enumeration value. - - - - - Specified WM_QUERYOPEN enumeration value. - - - - - Specified WM_ERASEBKGND enumeration value. - - - - - Specified WM_SYSCOLORCHANGE enumeration value. - - - - - Specified WM_ENDSESSION enumeration value. - - - - - Specified WM_SHOWWINDOW enumeration value. - - - - - Specified WM_WININICHANGE enumeration value. - - - - - Specified WM_SETTINGCHANGE enumeration value. - - - - - Specified WM_DEVMODECHANGE enumeration value. - - - - - Specified WM_ACTIVATEAPP enumeration value. - - - - - Specified WM_FONTCHANGE enumeration value. - - - - - Specified WM_TIMECHANGE enumeration value. - - - - - Specified WM_CANCELMODE enumeration value. - - - - - Specified WM_SETCURSOR enumeration value. - - - - - Specified WM_MOUSEACTIVATE enumeration value. - - - - - Specified WM_CHILDACTIVATE enumeration value. - - - - - Specified WM_QUEUESYNC enumeration value. - - - - - Specified WM_GETMINMAXINFO enumeration value. - - - - - Specified WM_PAINTICON enumeration value. - - - - - Specified WM_ICONERASEBKGND enumeration value. - - - - - Specified WM_NEXTDLGCTL enumeration value. - - - - - Specified WM_SPOOLERSTATUS enumeration value. - - - - - Specified WM_DRAWITEM enumeration value. - - - - - Specified WM_MEASUREITEM enumeration value. - - - - - Specified WM_DELETEITEM enumeration value. - - - - - Specified WM_VKEYTOITEM enumeration value. - - - - - Specified WM_CHARTOITEM enumeration value. - - - - - Specified WM_SETFONT enumeration value. - - - - - Specified WM_GETFONT enumeration value. - - - - - Specified WM_SETHOTKEY enumeration value. - - - - - Specified WM_GETHOTKEY enumeration value. - - - - - Specified WM_QUERYDRAGICON enumeration value. - - - - - Specified WM_COMPAREITEM enumeration value. - - - - - Specified WM_GETOBJECT enumeration value. - - - - - Specified WM_COMPACTING enumeration value. - - - - - Specified WM_COMMNOTIFY enumeration value. - - - - - Specified WM_WINDOWPOSCHANGING enumeration value. - - - - - Specified WM_WINDOWPOSCHANGED enumeration value. - - - - - Specified WM_POWER enumeration value. - - - - - Specified WM_COPYDATA enumeration value. - - - - - Specified WM_CANCELJOURNAL enumeration value. - - - - - Specified WM_NOTIFY enumeration value. - - - - - Specified WM_INPUTLANGCHANGEREQUEST enumeration value. - - - - - Specified WM_INPUTLANGCHANGE enumeration value. - - - - - Specified WM_TCARD enumeration value. - - - - - Specified WM_HELP enumeration value. - - - - - Specified WM_USERCHANGED enumeration value. - - - - - Specified WM_NOTIFYFORMAT enumeration value. - - - - - Specified WM_CONTEXTMENU enumeration value. - - - - - Specified WM_STYLECHANGING enumeration value. - - - - - Specified WM_STYLECHANGED enumeration value. - - - - - Specified WM_DISPLAYCHANGE enumeration value. - - - - - Specified WM_GETICON enumeration value. - - - - - Specified WM_SETICON enumeration value. - - - - - Specified WM_NCCREATE enumeration value. - - - - - Specified VK_RMENU enumeration value. - - - - - Specified WM_NCCALCSIZE enumeration value. - - - - - Specified WM_NCHITTEST enumeration value. - - - - - Specified WM_NCPAINT enumeration value. - - - - - Specified WM_NCACTIVATE enumeration value. - - - - - Specified WM_GETDLGCODE enumeration value. - - - - - Specified WM_SYNCPAINT enumeration value. - - - - - Specified WM_NCMOUSEMOVE enumeration value. - - - - - Specified WM_NCLBUTTONDOWN enumeration value. - - - - - Specified WM_NCLBUTTONUP enumeration value. - - - - - Specified WM_NCLBUTTONDBLCLK enumeration value. - - - - - Specified WM_NCRBUTTONDOWN enumeration value. - - - - - Specified WM_NCRBUTTONUP enumeration value. - - - - - Specified WM_NCRBUTTONDBLCLK enumeration value. - - - - - Specified WM_NCMBUTTONDOWN enumeration value. - - - - - Specified WM_NCMBUTTONUP enumeration value. - - - - - Specified WM_NCMBUTTONDBLCLK enumeration value. - - - - - Specified WM_NCXBUTTONDOWN enumeration value. - - - - - Specified WM_NCXBUTTONUP enumeration value. - - - - - Specified WM_KEYDOWN enumeration value. - - - - - Specified WM_KEYUP enumeration value. - - - - - Specified WM_CHAR enumeration value. - - - - - Specified WM_DEADCHAR enumeration value. - - - - - Specified WM_SYSKEYDOWN enumeration value. - - - - - Specified WM_SYSKEYUP enumeration value. - - - - - Specified WM_SYSCHAR enumeration value. - - - - - Specified WM_SYSDEADCHAR enumeration value. - - - - - Specified WM_KEYLAST enumeration value. - - - - - Specified WM_IME_STARTCOMPOSITION enumeration value. - - - - - Specified WM_IME_ENDCOMPOSITION enumeration value. - - - - - Specified WM_IME_COMPOSITION enumeration value. - - - - - Specified WM_IME_KEYLAST enumeration value. - - - - - Specified WM_INITDIALOG enumeration value. - - - - - Specified WM_COMMAND enumeration value. - - - - - Specified WM_SYSCOMMAND enumeration value. - - - - - Specified WM_TIMER enumeration value. - - - - - Specified WM_HSCROLL enumeration value. - - - - - Specified WM_VSCROLL enumeration value. - - - - - Specified WM_INITMENU enumeration value. - - - - - Specified WM_INITMENUPOPUP enumeration value. - - - - - Specified WM_MENUSELECT enumeration value. - - - - - Specified WM_MENUCHAR enumeration value. - - - - - Specified WM_ENTERIDLE enumeration value. - - - - - Specified WM_MENURBUTTONUP enumeration value. - - - - - Specified WM_MENUDRAG enumeration value. - - - - - Specified WM_MENUGETOBJECT enumeration value. - - - - - Specified WM_UNINITMENUPOPUP enumeration value. - - - - - Specified WM_MENUCOMMAND enumeration value. - - - - - Specified WM_CTLCOLORMSGBOX enumeration value. - - - - - Specified WM_CTLCOLOREDIT enumeration value. - - - - - Specified WM_CTLCOLORLISTBOX enumeration value. - - - - - Specified WM_CTLCOLORBTN enumeration value. - - - - - Specified WM_CTLCOLORDLG enumeration value. - - - - - Specified WM_CTLCOLORSCROLLBAR enumeration value. - - - - - Specified WM_CTLCOLORSTATIC enumeration value. - - - - - Specified WM_MOUSEMOVE enumeration value. - - - - - Specified WM_LBUTTONDOWN enumeration value. - - - - - Specified WM_LBUTTONUP enumeration value. - - - - - Specified WM_LBUTTONDBLCLK enumeration value. - - - - - Specified WM_RBUTTONDOWN enumeration value. - - - - - Specified WM_RBUTTONUP enumeration value. - - - - - Specified WM_RBUTTONDBLCLK enumeration value. - - - - - Specified WM_MBUTTONDOWN enumeration value. - - - - - Specified WM_MBUTTONUP enumeration value. - - - - - Specified WM_MBUTTONDBLCLK enumeration value. - - - - - Specified WM_MOUSEWHEEL enumeration value. - - - - - Specified WM_XBUTTONDOWN enumeration value. - - - - - Specified WM_XBUTTONUP enumeration value. - - - - - Specified WM_XBUTTONDBLCLK enumeration value. - - - - - Specified WM_PARENTNOTIFY enumeration value. - - - - - Specified WM_ENTERMENULOOP enumeration value. - - - - - Specified WM_EXITMENULOOP enumeration value. - - - - - Specified WM_NEXTMENU enumeration value. - - - - - Specified WM_SIZING enumeration value. - - - - - Specified WM_CAPTURECHANGED enumeration value. - - - - - Specified WM_MOVING enumeration value. - - - - - Specified WM_DEVICECHANGE enumeration value. - - - - - Specified WM_MDICREATE enumeration value. - - - - - Specified WM_MDIDESTROY enumeration value. - - - - - Specified WM_MDIACTIVATE enumeration value. - - - - - Specified WM_MDIRESTORE enumeration value. - - - - - Specified WM_MDINEXT enumeration value. - - - - - Specified WM_MDIMAXIMIZE enumeration value. - - - - - Specified WM_MDITILE enumeration value. - - - - - Specified WM_MDICASCADE enumeration value. - - - - - Specified WM_MDIICONARRANGE enumeration value. - - - - - Specified WM_MDIGETACTIVE enumeration value. - - - - - Specified WM_MDISETMENU enumeration value. - - - - - Specified WM_ENTERSIZEMOVE enumeration value. - - - - - Specified WM_EXITSIZEMOVE enumeration value. - - - - - Specified WM_DROPFILES enumeration value. - - - - - Specified WM_MDIREFRESHMENU enumeration value. - - - - - Specified WM_IME_SETCONTEXT enumeration value. - - - - - Specified WM_IME_NOTIFY enumeration value. - - - - - Specified WM_IME_CONTROL enumeration value. - - - - - Specified WM_IME_COMPOSITIONFULL enumeration value. - - - - - Specified WM_IME_SELECT enumeration value. - - - - - Specified WM_IME_CHAR enumeration value. - - - - - Specified WM_IME_REQUEST enumeration value. - - - - - Specified WM_IME_KEYDOWN enumeration value. - - - - - Specified WM_IME_KEYUP enumeration value. - - - - - Specified WM_MOUSEHOVER enumeration value. - - - - - Specified WM_UNDO enumeration value. - - - - - Specified WM_RENDERFORMAT enumeration value. - - - - - Specified WM_RENDERALLFORMATS enumeration value. - - - - - Specified WM_DESTROYCLIPBOARD enumeration value. - - - - - Specified WM_DRAWCLIPBOARD enumeration value. - - - - - Specified WM_PAINTCLIPBOARD enumeration value. - - - - - Specified WM_VSCROLLCLIPBOARD enumeration value. - - - - - Specified WM_SIZECLIPBOARD enumeration value. - - - - - Specified WM_ASKCBFORMATNAME enumeration value. - - - - - Specified WM_CHANGECBCHAIN enumeration value. - - - - - Specified WM_HSCROLLCLIPBOARD enumeration value. - - - - - Specified WM_QUERYNEWPALETTE enumeration value. - - - - - Specified WM_PALETTEISCHANGING enumeration value. - - - - - Specified WM_PALETTECHANGED enumeration value. - - - - - Specified WM_HOTKEY enumeration value. - - - - - Specified WM_PRINT enumeration value. - - - - - Specified WM_PRINTCLIENT enumeration value. - - - - - Specified WM_HANDHELDFIRST enumeration value. - - - - - Specified WM_HANDHELDLAST enumeration value. - - - - - Specified WM_AFXFIRST enumeration value. - - - - - Specified WM_AFXLAST enumeration value. - - - - - Specified WM_PENWINFIRST enumeration value. - - - - - Specified WM_PENWINLAST enumeration value. - - - - - Specified WM_APP enumeration value. - - - - - Specified WM_USER enumeration value. - - - - - Specified WM_REFLECT enumeration value. - - - - - Specified WM_THEMECHANGED enumeration value. - - - - - - - - - - 关键词 - - - - - 密码 - - - - - 权限用户id - - - - - - - - - - - - - 返回关键词 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 树形控件，用于分类用 - - - - - 显示在第一位的名称 - - - - - 是否显示菜单 - - - - - 树形控件 - - - - - 判断指定节点是否是目标节点的子节点 - - - - - - - - - 判断当前节点，当前用户是否有权限访问 - - - - - - - - - 权限事件 - - - - - - - - 选择权限用户时发生 - - - - - 数据变化时发生 - - - - - 数据变化前发生 - - - - - 操作事件 - - - - - - - 在添加分组前发生 - - - - - 在修改分组前发生 - - - - - 在删除分组前发生 - - - - - 在设置密码前发生 - - - - - 在设置权限前发生 - - - - - 获取新的关键词分类 - - - - - - 根据id获取节点 - - - - - - - 根据节点获取节点信息 - - - - - - - 设置节点信息 - - - - - - - 设置节点关键词和密码 - - - - - - - - 设置节点密码 - - - - - - - 设置节点关键词 - - - - - - - 设置节点用户 - - - - - - - RecursionTreeControl:表示将XML文件的内容显示在TreeView控件中 - - 将要加载的XML文件中的节点元素 - 将要加载的XML文件中的节点集合 - - - - 把XML文本载入到列表中 - - - - - - 把XML文件载入到列表中 - - - - - - 将列表保存为xml文本 - - - - - - 改变所有子节点的状态 - - - - - - - 反选子节点 - - - - - - 根据关键词来选中列表 - - - - - - 根据关键词来选中列表 - - - - - - 格式化关键字(会去除重复项)，以便存入数据库 - - - - - - - 去除掉重复项 - - - - - - - 获取当前选中项以及所有父项的关键词组合 - - - - - - 获取选中的 - - - - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - - - - - - 是否为添加 - - - - - 选择的文本 - - - - - 选择的Tag - - - - - 选择的图片序号 - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - 旧密码 - - - - - 新密码 - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - 颜色标签 - - - - - 行间距 - - - - - 颜色标签 - - - - - 更新 - - - - - 字体高度 - - - - - 控件高 - - - - - 控件文本 - - - - - 获取过滤掉颜色的字 - - - - - - - 改变字体 - - - - - - - - - - - - - - 密码控件 - - - - - - - - - - 密码 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 分页控件 - - - - - 首页文本 - - - - - 上一页文本 - - - - - 下一页文本 - - - - - 末页文本 - - - - - 跳页文本 - - - - - 页面信息文本 - - - - - 存储SQL参数 - - - - - 最后一页的页码 - - - - - 在发生页码变化时激发 - - - - - 在发生页码变化前激发 - - - - - 设置/返回每页显示的量大小 - - - - - 设置/返回记录总数 - - - - - 设置/返回分页SQL语句,{pagecount}表示页数,{recordcount}表示记录总数,{pagesize}表示页面大小, - {pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 - - - - - 设置/返回当{recordnum}小于等于0时的分页SQL语句(比如第一页),如果为空，则默认使用SQLText值。{pagecount}表示页数, - {recordcount}表示记录总数,{pagesize}表示页面大小,{pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 - - - - - 获取当前页码 - - - - - - 设置分页语句 - - 数据库类型 - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 获取数据库指定条件的记录总数 - - 数据库类型 - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - - - - - 设置分页语句为MySQL分页语句 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 获取MySQL数据库指定条件的记录总数 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - - - - - 设置分页语句为MSSQL分页语句 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 获取MSSQL数据库指定条件的记录总数 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 设置分页语句为SQLite分页语句 - - 表名 - 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 - 排序语句，必须包含Order By;,如果不存在排序语句，请为空 - - - - - 设置分页语句为SQLite分页语句 - - 表名 - 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 - - - - - 获取SQLite数据库指定条件的记录总数 - - 表名 - 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 - - - - - 返回分页SQL语句 - - - - - 分页控件 - - - - - 设置当前页为指定页 - - - - - - 下一页 - - - - - 上一页 - - - - - 末页 - - - - - 首页 - - - - - 必需的设计器变量。 - - - - - 清理所有正在使用的资源。 - - 如果应释放托管资源，为 true；否则为 false。 - - - - 设计器支持所需的方法 - 不要 - 使用代码编辑器修改此方法的内容。 - - - - - 自动排列控件 - - - - - 最大列数 - - - - - 开始排列的坐标 - - - - - 下一项的位置 - - - - - 下一项的右下角坐标 - - - - - 竖向间隔像素 - - - - - 横向间隔像素 - - - - - 最小保留右边距,只对ReDraw2有效 - - - - - 自动排列控件构造函数 - - - - - - 自动排列控件构造函数 - - - - - - - - 开始排列控件 - - - - - 开始排列控件,当列数超过显示空间时，自动换行 - - - - - 加入的控件列表 - - - - - 初始化添加,自动将容器设置为滚动条自动显示 - - - - - - 添加控件 - - - - - - - 删除控件 - - - - - - 删除控件 - - - - - - 清空所有控件 - - - - - This enum represents the possible browser commands - - - - - Used when no commans are available - - - - - Used in the new navigation events - - - - - The URL to navigate to - - - - - The name of the frame to navigate to - - - - - The flags when opening a new window - - - - - The pointer to ppDisp - - - - - Creates a new instance of WebBrowserExtendedNavigatingEventArgs - - Pointer to the automation object of the browser - The URL to go to - The name of the frame - The new window flags - - - - - - - - - Used in the new navigation events - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 查看源码 - - - - - 复制当前选中区 - - - - - 粘贴当前选中区 - - - - - 剪切当前选中区 - - - - - 全选 - - - - - 清除当前选中区的选中状态。 - - - - - 从当前选中区中删除全部超级链接。 - - - - - 从当前选中区中删除全部书签。 - - - - - 删除当前选中区 - - - - - 重做 - - - - - 撤销 - - - - - 从当前选中区中删除格式化标签。 - - - - - 点击节点 - - - - - - - - 点击节点 - - - - - - - - - 点击元素 - - 节点名 - 属性 - 属性值 - 等待毫秒数 - 第几个符合的元素,从1开始 - - - - 等待多时毫秒 - - - - - - Represents event information for the main form, when the command state of the active browser changes - - - - - Creates a new instance of the class - - A list of commands that are available - - - - Gets a list of commands that are available - - - - - An extended version of the control. - - - - - - - - - - - - 在页面弹出消息对话框时激发 - - - - - - - - - - - - - - - - - - - - - - 打开页面并等待页面加载完毕 - - 要打开的页面地址 - 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 - - - - 等待页面加载完毕 - - 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 - - - - 等待指定毫秒 - - 等待指定毫秒 - - - - 获取网页源代码,可以自动去除乱码 - - - - - - 加载html文本到浏览器中 - - - - - - - 加载html文本到浏览器中 - - - - - - 强制用本窗体打开新链接 - - - - - - - - - - - This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. - Called by the control when the underlying ActiveX control is created. - - - - - - This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. - Called by the control when the underlying ActiveX control is discarded. - - - - - Returns the automation object for the web browser - - - - - This method will be called to give you a chance to create your own event sink - - - - - Detaches the event sink - - - - - 在文档下载开始时激发 - - - - - Raises the event - - Empty - - You could start an animation or a notification that downloading is starting - - - - - 下载完成后触发 - - - Here you could start monitoring for script errors. - - - - - Raises the event - - Empty - - - - 在开始浏览新网页时激发. - - - - - 在打开新的网页窗口时激发 - - - - - Raises the event - - Thrown when BrowserExtendedNavigatingEventArgs is null - - - - Raises the event - - Thrown when BrowserExtendedNavigatingEventArgs is null - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 新窗口事件,只限Window XP SP2或以上系统支持 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - / - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Overridden - - The send to this procedure - - - - A list of all the available window messages - - - - - Raises the event - - - - - 在网页窗口关闭时激发 - - - Do not confuse this with DWebBrowserEvents2.Quit... That's something else. - - - - - Flags used by INewWindowManager::EvaluateNewWindow. - These values are taken into account in the decision of whether to display a pop-up window. - - - - - No information Present - - - - - The page is unloading. This flag is set in response to the onbeforeunload and onunload events. - Some pages load pop-up windows when you leave them rather than when you enter. This flag is used to identify those situations. - - - - - The call to INewWindowManager::EvaluateNewWindow is the result of a user-initiated action - (a mouse click or key press). Use this flag in conjunction with the NWMF_FIRST_USERINITED flag - to determine whether the call is a direct or indirect result of the user-initiated action. - - - - - When NWMF_USERINITED is present, this flag indicates that the call to - INewWindowManager::EvaluateNewWindow is the first query that results from this user-initiated action. - Always use this flag in conjunction with NWMF_USERINITED. - - - - - The override key (ALT) was pressed. The override key is used to bypass the pop-up manager梐llowing - all pop-up windows to display梐nd must be held down at the time that INewWindowManager::EvaluateNewWindow is called. - - - - - The new window attempting to load is the result of a call to the showHelp method. Help is sometimes displayed in a separate window, - and this flag is valuable in those cases. - - - - - The new window is a dialog box that displays HTML content. - - - - - Indicates that the EvaluateNewWindow method is being called through a marshalled Component Object Model (COM) proxy - from another thread. In this situation, the method should make a decision and return immediately without performing - blocking operations such as showing modal user interface (UI). Lengthy operations will cause the calling thread to - appear unresponsive. - - - - - HRESULT constants - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - a form that supports custom theme - - - - - 标签新建按钮事件 - - - - - 标签关闭按钮事件 - - - - - 标签创建时事件 - - - - - 在标签栏创建时激发 - - - - - - - 内边距 - - - - - 默认内边距 - - - - - 标题 - - - - - 皮肤/主题 - - - - - 是否可拖动改变窗体大小 - - - - - 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 - - - - - 窗体边框大小 - - - - - 标题栏高度 - - - - - 窗体圆角程度 - - - - - 窗体圆角样式 - - - - - 控制按钮相对于右上角的偏移量 - - - - - 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 - - - - - 标题栏图标尺寸 - - - - - 窗体图标,如果设置本项,将不使用Icon属性 - - - - - 标题栏图标与窗体左边框的距离 - - - - - 标题距离左边的距离 - - - - - 窗体关闭按钮的尺寸 - - - - - 窗体最大化/还原按钮的大小 - - - - - 窗体最小化按钮的大小 - - - - - 是否显示阴影 - - - - - 窗体阴影宽度 - - - - - 使用阴影来缩放 - - - - - 窗体阴影颜色 - - - - - 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 - - - - - 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 - - - - - 表示去掉自画的边框及标题栏后，剩下的可用的客户区区域，坐标相对于窗体左上角 - - - - - 表示去掉自画的边框及标题栏后，剩下的可用的客户区大小 - - - - - 表示MDI标签栏的区域，包括bottom-region - - - - - MGdUI皮肤 - - - - - 获取子窗体 - - - - - - 通过sendmessage方式激活子窗体以避免闪烁 - - - - - - 当子窗体关闭时激发 - - - - - - - 子窗体可视化变化 - - - - - - - 获取当前的子窗体列表 - - - - - - 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最小化 - - - - - 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最大化 - - - - - to make the client area to have 3D view - - - - - 消息 - - - - - - 画UI - - - - - - 在画背景时激发 - - - - - - 重写该方法解决在VS设计器中，每次保存一个新的尺寸，再打开尺寸会变大的问题 - - - - - 创建控件时激发 - - - - - 窗体可见变化时激发 - - - - - - 大小改变时激发 - - - - - - 在位置变化时激发 - - - - - - 窗体激活 - - - - - - 窗体关闭后激发 - - - - - - 加载时 - - - - - - 在子窗体激活时激发 - - - - - - 标签菜单 - - - - - 窗体上移动鼠标时激发 - - - - - - 获取当前点击的标签项 - - - - - 在窗体上按下鼠标时激发 - - - - - - 在窗体上放开鼠标时激发 - - - - - - 在鼠标离开窗体时激发 - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - 该类处理mdi-bar的绘制及鼠标事件管理 - - - - - use left,top,right to location the bar in owner form, - the margin is from Form.ClientRectangle - - - - - 整个标签栏高度,包含标签栏底部区域、标签、标签顶部空隙 - - - - - 标签栏底部区域的高度 - - - - - 是否显示标签栏边框 - - - - - 是否显示标签栏背景 - - - - - 标签栏左内边距 - - - - - 标签栏右内边距 - - - - - 标签高度 - - - - - 激活的标签高度 - - - - - tab顶部与bar顶部的空间,这个值用来计算 BarHeight - - - - - 每个标签的左右边界可以不是垂直的，而是都有一个斜度 - - - - - tab与tab之间的距离，用负值可以使tab有重叠的效果 - - - - - 标签是否显示图标 - - - - - 是否显示标签关闭按钮 - - - - - 标签图标大小 - - - - - 标签图标距离左边的距离 - - - - - 标签文字距离左边的距离 - - - - - 标签关闭按钮的大小 - - - - - 标签关闭按钮距离右边的距离 - - - - - 是否显示新建标签按钮 - - - - - 新建标签按钮的大小 - - - - - 新建标签距离左边的距离 - - - - - 按钮与Bar底部的距离 - - - - - 一个tab允许的最小宽度 - - - - - 一个tab允许的最大显示宽度 - - - - - 标签正常宽度 - - - - - 同步_listTabItems与mdi主窗体实际存在的子form - - - - - 为每个tab分配空间，如果tab数目太多，则有些会被隐藏 - - - - - 重绘整个标签栏 - - - - - - 处理鼠标事件。该方法会触发一些click事件，重刷一些按钮等 - - - - - - - 该类表示一个单独的标签项 - - - - - 该标签所对应的窗体 - - - - - 最终分配到的整个tab的宽度 - - - - - 表示所对应的form是否仍未被关闭 - - - - - 是否因空间不足而被隐藏 - - - - - 返回全部显示该标签文本所需的长度 - - - - - - 返回显示全部文本时该tab所需的宽度,该宽度不超过bar-container - 规定的tabmaxwidth - - - - - - 居左 - - - - - 显示在最后一个标签后面 - - - - - 该类封装设置一个主题所需的信息，可以继承该类实现不同的主题 - - - - - 主题名称，用于标识主题，对主题进行简单描述 - - - - - 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 - - - - - 窗体边框大小 - - - - - 窗体标题栏高度 - - - - - 标题栏图标与窗体左边框的距离 - - - - - 标题栏图标尺寸 - - - - - 标题栏文本左边距 - - - - - 控制按钮（关闭按钮）相对于窗体右上角的偏移量 - - - - - 窗体关闭按钮的尺寸 - - - - - 窗体最大化/还原按钮的大小 - - - - - 窗体最小化按钮的大小 - - - - - 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 - - - - - 窗体圆角程度 - - - - - 窗体圆角样式 - - - - - 是否使用默认的圆角样式，该样式为左上角和右上角圆角， - 最好在窗体边框较粗时才使用该样式 - - - - - 是否在标题栏上绘制图标 - - - - - 是否在标题栏上绘制文本 - - - - - 是否显示窗体阴影 - - - - - 窗体阴影大小 - - - - - 拖动窗体阴影是否可以改变窗体大小 - - - - - 阴影的颜色，可以设置成其他颜色而不一定是黑色 - - - - - 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 - - - - - 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 - - - - - 是否在客户区边界画线使其看起来有立体感 - - - - - 窗体标题栏文字是否居中显示 - - - - - 窗体边框最外一像素的颜色 - - - - - 窗体边框第二最外像素的颜色 - - - - - 窗体边框其他部分颜色，如果窗体边框大小大于2，则其他像素将用此颜色画出 - - - - - 标题栏颜色是从上到下渐变的，这个值设置上边的颜色值 - - - - - 标题栏颜色是从上到下渐变的，这个值设置下边的颜色值 - - - - - 标题栏文字颜色 - - - - - 窗体背景颜色，该值将覆盖窗体自带的BackColor属性值 - - - - - 窗体关闭按钮的颜色集合 - - - - - 窗体最大化/还原按钮的颜色集合 - - - - - 窗体最小化按钮的颜色集合 - - - - - 默认状态下关闭按钮背景图片 - - - - - 鼠标移过去时关闭按钮背景图片 - - - - - 鼠标按下时关闭按钮背景图片 - - - - - 默认状态下最大化按钮背景图片 - - - - - 鼠标移过去时最大化按钮背景图片 - - - - - 鼠标按下时最大化按钮背景图片 - - - - - 默认状态下恢复按钮背景图片 - - - - - 鼠标移过去时恢复按钮背景图片 - - - - - 鼠标按下时恢复按钮背景图片 - - - - - 默认状态下最小化按钮背景图片 - - - - - 鼠标移过去时最小化按钮背景图片 - - - - - 鼠标按下时最小化按钮背景图片 - - - - - 是否用SendMessage的方式切换子窗体，以避免子窗体切换时产生的闪烁 - - - - - Mdi-Bar与窗体左、上、右边界的距离，只用到这三个值，Bottom值没用到。 - 用这三个值来确定Mdi-Bar的宽度及其在窗体中的位置 - - - - - 内部左边空白，第一个标签将从这个空白距离之后开始 - - - - - 标签栏内部右边空白 - - - - - 标签栏背景颜色 - - - - - 标签栏边框颜色 - - - - - 标签栏背景图片 - - - - - 是否显示标签栏边框 - - - - - 标签栏下边区域的背景颜色 - - - - - 标签栏下边区域的高度 - - - - - 标签高度 - - - - - 被选中的标签高度，可以设置成与TabHeight不一样的值，以突出显示被选中状态 - - - - - 标签之间的距离，设成负值可以使标签有重叠的效果 - - - - - 标签的最大宽度，任何情况下标签都不能超过这个宽度 - - - - - 标签正常宽度，如果标签需要很短的宽度（比如20像素）就可以显示完上面的文字， - 但是Mdi-Bar上有足够的空间时，标签会以正常宽度（比如100像素）显示 - - - - - 标签最小宽度，当标签小于这个宽度时将被隐藏 - - - - - 标签梯度大小，标签可以不以矩形方式显示，而是有一个梯度/斜度。 - - - - - 标签顶部空白，这个值用于参与计算Mdi-Bar高度，计算方式为： - Mdi-Bar Height = BottomRegionHeight + TabHeight + TabTopSpace - - - - - 标签上是否显示子窗体图标 - - - - - 标签上是否显示子窗体关闭图标 - - - - - 选中状态的标签的上部背景色，与下部背景色不同时，标签背景色就有渐变效果 - - - - - 选中状态的标签的下部背景色，与上部背景色不同时，标签背景色就有渐变效果 - - - - - 标签激活时字体颜色 - - - - - 非选中状态的标签的字体颜色 - - - - - 非选中状态的标签的上部背景色 - - - - - 非选中状态的标签的下部背景色 - - - - - 标签外边框颜色 - - - - - 标签内边框颜色，这个颜色一般具有一定的透明度 - - - - - 是否显示标签边框 - - - - - 是否显示默认的新建标签按钮(NewTabBtn) - - - - - NewTabBtn与下边框的距离，这个值用来定位按钮的Y坐标 - - - - - 新建标签按钮与左边框的距离，这个值用来定位按钮的X坐标 - - - - - 新建标签按钮大小 - - - - - 按钮颜色集合 - - - - - 是否一直显示ListAllBtn，即使在没有标签被隐藏的情况下 - - - - - 《显示全部标签》按钮的位置 - - - - - 《显示全部标签》按钮与下边框的距离，这个值用来定位按钮的Y坐标 - - - - - 《显示全部标签》按钮与左边框的距离，这个值用来定位按钮的X坐标 - - - - - 《显示全部标签》按钮的颜色 - - - - - 《显示全部标签》按钮的大小 - - - - - 皮肤主题 - - - - - 设置百分比 - - - - - - - - - 引发 ValueChanged 事件 - - - - - - 引发 ThemeChanged 事件 - - - - - - 指示鼠标位于哪个区域 - - - - - 控件Value值发生变化后引发 - - - - - 控件绘制MainLine前引发, 可以设置Cancel参数来取消默认的绘制 - - - - - 控件绘制Button前引发 - - - - - 引发 ValueChanged 事件 - - - - - 引发 BeforePaintMainLine 事件 - - - - - 引发 BeforePaintButton 事件 - - - - - 将Value值加一个LargeChange量 - - - - - 将Value值减一个LargeChange量 - - - - - 将Value值加一个SmallChange量 - - - - - 将Value值减一个SmallChange量 - - - - - 提供产生各种路径的静态方法，比如圆角路径、关闭按钮上的x路径、+号路径 - - - - - 圆角样式 - - - - - 无 - - - - - 所有 - - - - - 上 - - - - - 下 - - - - - 左 - - - - - 右 - - - - - SimpleObject指的是只有一种状态（不像普通按钮一样有三种状态），并且其上的元素 - 布局比较简单的Object - - - - - - - - - - - - - - - - - - - - DevExpress风格皮肤 - - - - - DevExpress风格皮肤 - - - - - 新风格皮肤 - - - - - 新风格皮肤 - - - - - 基础皮肤 - - - - - VS2013风格皮肤 - - - - - this theme is just for chrome one quarter style - - - - - for diamond ring style only - - - - - Location of cursor hot spot returnet in WM_NCHITTEST. - - - - - On the screen background or on a dividing line between windows - (same as HTNOWHERE, except that the DefWindowProc function produces a system beep to indicate an error). - - - - - In a window currently covered by another window in the same thread - (the message will be sent to underlying windows in the same thread until one of them returns a code that is not HTTRANSPARENT). - - - - - On the screen background or on a dividing line between windows. - - - - In a client area. - - - In a title bar. - - - In a window menu or in a Close button in a child window. - - - In a size box (same as HTSIZE). - - - In a menu. - - - In a horizontal scroll bar. - - - In the vertical scroll bar. - - - In a Minimize button. - - - In a Maximize button. - - - In the left border of a resizable window - (the user can click the mouse to resize the window horizontally). - - - - In the right border of a resizable window - (the user can click the mouse to resize the window horizontally). - - - - In the upper-horizontal border of a window. - - - In the upper-left corner of a window border. - - - In the upper-right corner of a window border. - - - In the lower-horizontal border of a resizable window - (the user can click the mouse to resize the window vertically). - - - In the lower-left corner of a border of a resizable window - (the user can click the mouse to resize the window diagonally). - - - In the lower-right corner of a border of a resizable window - (the user can click the mouse to resize the window diagonally). - - - In the border of a window that does not have a sizing border. - - - In a Close button. - - - In a Help button. - - - - Contains the new coordinates of a window that has been moved or resized, that is, it is the proposed new window coordinates. - - - - - Contains the coordinates of the window before it was moved or resized. - - - - - Contains the coordinates of the window's client area before the window was moved or resized. - - - - - Pointer to a WINDOWPOS structure that contains the size and position values specified in the operation that moved or resized the window. - - - - - - - - - - 是否在这个按钮上按下了鼠标未释放 - - - - - 是否可见 - - - - - - - - - - 画两次可以加深颜色 - - - - - 用于在click事件中传回数据 - - - - - 获取或设置是否将绘制完全限制在指定的区域内 - - - - - - - - - - - - - - - - - 线条图 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - 画值 - - 画布 - X轴数据 - - - - 走势图 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - 初始化参数 - - - - - 返回或设置X轴间隔 - - - - - 标题 - - - - - 返回图片的宽度 - - - - - 返回或设置图片的高度 - - - - - X轴的间距 - - - - - Y轴的间距 - - - - - 标题的颜色 - - - - - 标题的字体 - - - - - 背景颜色 - - - - - X轴的颜色 - - - - - Y轴的颜色 - - - - - 返回X轴数据的最大值(供给Painter调用) - - - - - 返回图片数据 - - - - - 画布 - - - - - 作图器 - - - - - 释放内容资源 - - - - - 获取X轴中的最大值 - - - - - - - 获取所有X轴列中的最大值 - - - - - - - 初始化图片 - - X轴的数据 - - - - - 画一条走势图 - - - - - - 画多条走势图 - - - - - - 作图器的基础类 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - 返回此作图器的相关链走势图 - - - - - 获取某值在Y轴上的位置 - - 当前点的值 - 点坐标 - - - - 画XY轴线 - - 画布 - X轴的数据 - - - - 画标题 - - - - - - 画走势线 - - 画布 - X轴数据 - - - - 方块图 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - 画值 - - 画布 - X轴数据 - - - - 走势图的X轴数据 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - - - - - - - - 标题 - - - - - 值 - - - - - 标题的颜色 - - - - - 标题的字体 - - - - - 值的颜色 - - - - - 值的字体 - - - - - 绘制颜色 - - - - - 值是否可见 - - - - - 克隆自身 - - - - - - 定义X轴的数据集合 - - - 作者: Kingthy - 日期: 2007-09-11 - MSN: Kingthy@gmail.com - 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 - - - - - - - - - - - - - - - - 添加一批数据 - - 轴的标题 - - - - 添加一批数据 - - 轴的标题 - 轴的值 - - - - 重置轴的值 - - 轴的值 - - - - 克隆数据 - - - - - - Indicates the behavior of a key when a cell "on the edge" is being edited. - and the normal behavior of that key would exceed the edge. For example, - for a key that normally moves one column to the left, the "edge" would be - the left most column, since the normal action of the key cannot be taken - (since there are no more columns to the left). - - - - - 按键将被忽略 - - - - - 按键将导致单元格编辑环绕到相对边缘的单元格。 - - - - - 按键将Wrap，但该列将更改为相应的相邻列。这只对正常操作为ChangeRow的键有意义。 - - - - - 按键将Wrap，但该行将更改为相应的相邻行。这只对正常操作为ChangeColumn的键有意义. - - - - - 该键将导致当前编辑操作结束。 - - - - - Indicates the normal behaviour of a key when used during a cell edit - operation. - - - - - The key press will be ignored - - - - - The key press will end the current edit and begin an edit - operation on the next editable cell to the left. - - - - - The key press will end the current edit and begin an edit - operation on the next editable cell to the right. - - - - - The key press will end the current edit and begin an edit - operation on the row above. - - - - - The key press will end the current edit and begin an edit - operation on the row below - - - - - The key press will cancel the current edit - - - - - The key press will finish the current edit operation - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Custom verb that can be used for specialized actions. - - - - - Instances of this class handle key presses during a cell edit operation. - - - - - 设置给定键的行为 - - - - - - - - 处理按键操作 - - - - True if the key was completely handled. - - - - Gets or sets the ObjectListView on which the current key is being handled. - This cannot be null. - - - - - Gets the row of the cell that is currently being edited - - - - - Gets the index of the column of the cell that is being edited - - - - - Gets or sets the map that remembers the normal behaviour of keys - - - - - Gets or sets the map that remembers the desired behaviour of keys - on edge cases. - - - - - Setup the default key mapping - - - - - Handle the end edit command - - - - - Handle the cancel edit command - - - - - Placeholder that subclasses can override to handle any custom verbs - - - - - - - - Handle a change row command - - - - - - - Handle a change column command - - - - - - - Start editing the indicated cell if that cell is not already being edited - - The row to edit - The cell within that row to edit - - - - Gets the adjacent item to the given item in the given direction. - If that item is disabled, continue in that direction until an enabled item is found. - - The row whose neighbour is sought - The direction of the adjacentness - An OLVListView adjacent to the given item, or null if there are no more enabled items in that direction. - - - - Gets the adjacent item to the given item in the given direction, wrapping if needed. - - The row whose neighbour is sought - The direction of the adjacentness - An OLVListView adjacent to the given item, or null if there are no more items in that direction. - - - - Gets a collection of columns that are editable in the order they are shown to the user - - - - - These items allow combo boxes to remember a value and its description. - - - - - - - - - - - - - - - - - Returns a string that represents the current object. - - - A string that represents the current object. - - 2 - - - - This editor shows and auto completes values from the given listview column. - - - - - Create an AutoCompleteCellEditor - - - - - - - This combo box is specialised to allow editing of an enum. - - - - - - - - - - - This editor simply shows and edits integer values. - - - - - - - - - - Gets or sets the value shown by this editor - - - - - This editor simply shows and edits unsigned integer values. - - This class can't be made public because unsigned int is not a - CLS-compliant type. If you want to use, just copy the code to this class - into your project and use it from there. - - - - This editor simply shows and edits boolean values. - - - - - - - - - - This editor simply shows and edits boolean values using a checkbox - - - - - Gets or sets the value shown by this editor - - - - - Gets or sets how the checkbox will be aligned - - - - - This editor simply shows and edits floating point values. - - You can intercept the CellEditStarting event if you want - to change the characteristics of the editor. For example, by increasing - the number of decimal places. - - - - - - - - - Gets or sets the value shown by this editor - - - - - A delegate that creates an editor for the given value - - The model from which that value came - The column for which the editor is being created - A representative value of the type to be edited. This value may not be the exact - value for the column/model combination. It could be simply representative of - the appropriate type of value. - A control which can edit the given value - - - - An editor registry gives a way to decide what cell editor should be used to edit - the value of a cell. Programmers can register non-standard types and the control that - should be used to edit instances of that type. - - - All ObjectListViews share the same editor registry. - - - - - Create an EditorRegistry - - - - - Register that values of 'type' should be edited by instances of 'controlType'. - - The type of value to be edited - The type of the Control that will edit values of 'type' - - ObjectListView.EditorRegistry.Register(typeof(Color), typeof(MySpecialColorEditor)); - - - - - Register the given delegate so that it is called to create editors - for values of the given type - - The type of value to be edited - The delegate that will create a control that can edit values of 'type' - - ObjectListView.EditorRegistry.Register(typeof(Color), CreateColorEditor); - ... - public Control CreateColorEditor(Object model, OLVColumn column, Object value) - { - return new MySpecialColorEditor(); - } - - - - - Register a delegate that will be called to create an editor for values - that have not been handled. - - The delegate that will create a editor for all other types - - - - Register a delegate that will be given a chance to create a control - before any other option is considered. - - The delegate that will create a control - - - - Remove the registered handler for the given type - - Does nothing if the given type doesn't exist - The type whose registration is to be removed - - - - Create and return an editor that is appropriate for the given value. - Return null if no appropriate editor can be found. - - The model involved - The column to be edited - The value to be edited. This value may not be the exact - value for the column/model combination. It could be simply representative of - the appropriate type of value. - A Control that can edit the given type of values - - - - Create and return an editor that will edit values of the given type - - A enum type - - - - A DataListView is a ListView that can be bound to a datasource (which would normally be a DataTable or DataView). - - - This listview keeps itself in sync with its source datatable by listening for change events. - The DataListView will automatically create columns to show all of the data source's columns/properties, if there is not already - a column showing that property. This allows you to define one or two columns in the designer and then have the others generated automatically. - If you don't want any column to be auto generated, set to false. - These generated columns will be only the simplest view of the world, and would look more interesting with a few delegates installed. - This listview will also automatically generate missing aspect getters to fetch the values from the data view. - Changing data sources is possible, but error prone. Before changing data sources, the programmer is responsible for modifying/resetting - the column collection to be valid for the new data source. - Internally, a CurrencyManager controls keeping the data source in-sync with other users of the data source (as per normal .NET - behavior). This means that the model objects in the DataListView are DataRowView objects. If you write your own AspectGetters/Setters, - they will be given DataRowView objects. - - - - - Make a DataListView - - - - - - - - - - - Gets or sets whether or not columns will be automatically generated to show the - columns when the DataSource is set. - - This must be set before the DataSource is set. It has no effect afterwards. - - - - Get or set the DataSource that will be displayed in this list view. - - The DataSource should implement either , , - or . Some common examples are the following types of objects: - - - - - - - - When binding to a list container (i.e. one that implements the - interface, such as ) - you must also set the property in order - to identify which particular list you would like to display. You - may also set the property even when - DataSource refers to a list, since can - also be used to navigate relations between lists. - When a DataSource is set, the control will create OLVColumns to show any - data source columns that are not already shown. - If the DataSource is changed, you will have to remove any previously - created columns, since they will be configured for the previous DataSource. - . - - - - - Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. - - If the data source is not a DataSet or DataViewManager, this property has no effect - - - - Gets or sets the DataSourceAdaptor that does the bulk of the work needed - for data binding. - - - Adaptors cannot be shared between controls. Each DataListView needs its own adapter. - - - - - Add the given collection of model objects to this control. - - A collection of model objects - This is a no-op for data lists, since the data - is controlled by the DataSource. Manipulate the data source - rather than this view of the data source. - - - - Insert the given collection of objects before the given position - - Where to insert the objects - The objects to be inserted - This is a no-op for data lists, since the data - is controlled by the DataSource. Manipulate the data source - rather than this view of the data source. - - - - Remove the given collection of model objects from this control. - - This is a no-op for data lists, since the data - is controlled by the DataSource. Manipulate the data source - rather than this view of the data source. - - - - Change the Unfreeze behaviour - - - - - Handles parent binding context changes - - Unused EventArgs. - - - - A DataTreeListView is a TreeListView that calculates its hierarchy based on - information in the data source. - - - Like a , a DataTreeListView sources all its information - from a combination of and . - can be a DataTable, DataSet, - or anything that implements . - - - To function properly, the DataTreeListView requires: - - the table to have a column which holds a unique for the row. The name of this column must be set in . - the table to have a column which holds id of the hierarchical parent of the row. The name of this column must be set in . - a value which identifies which rows are the roots of the tree (). - - The hierarchy structure is determined finding all the rows where the parent key is equal to . These rows - become the root objects of the hierarchy. - - Like a TreeListView, the hierarchy must not contain cycles. Bad things will happen if the data is cyclic. - - - - - Gets or sets whether or not columns will be automatically generated to show the - columns when the DataSource is set. - - This must be set before the DataSource is set. It has no effect afterwards. - - - - Get or set the DataSource that will be displayed in this list view. - - The DataSource should implement either , , - or . Some common examples are the following types of objects: - - - - - - - - When binding to a list container (i.e. one that implements the - interface, such as ) - you must also set the property in order - to identify which particular list you would like to display. You - may also set the property even when - DataSource refers to a list, since can - also be used to navigate relations between lists. - - - - - Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. - - If the data source is not a DataSet or DataViewManager, this property has no effect - - - - Gets or sets the name of the property/column that uniquely identifies each row. - - - - The value contained by this column must be unique across all rows - in the data source. Odd and unpredictable things will happen if two - rows have the same id. - - Null cannot be a valid key value. - - - - - Gets or sets the name of the property/column that contains the key of - the parent of a row. - - - - The test condition for deciding if one row is the parent of another is functionally - equivilent to this: - - Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) - - - Unlike key value, parent keys can be null but a null parent key can only be used - to identify root objects. - - - - - Gets or sets the value that identifies a row as a root object. - When the ParentKey of a row equals the RootKeyValue, that row will - be treated as root of the TreeListView. - - - - The test condition for deciding a root object is functionally - equivilent to this: - - Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) - - - The RootKeyValue can be null. Actually, it can be any value that can - be compared for equality against a basic type. - If this is set to the wrong value (i.e. to a value that no row - has in the parent id column), the list will be empty. - - - - - Gets or sets the value that identifies a row as a root object. - . The RootKeyValue can be of any type, - but the IDE cannot sensibly represent a value of any type, - so this is a typed wrapper around that property. - - - If you want the root value to be something other than a string, - you will have set it yourself. - - - - - Gets or sets whether or not the key columns (id and parent id) should - be shown to the user. - - This must be set before the DataSource is set. It has no effect - afterwards. - - - - Gets or sets the DataSourceAdaptor that does the bulk of the work needed - for data binding. - - - - - An IDragSource controls how drag out from the ObjectListView will behave - - - - - A drag operation is beginning. Return the data object that will be used - for data transfer. Return null to prevent the drag from starting. The data - object will normally include all the selected objects. - - - The returned object is later passed to the GetAllowedEffect() and EndDrag() - methods. - - What ObjectListView is being dragged from. - Which mouse button is down? - What item was directly dragged by the user? There may be more than just this - item selected. - The data object that will be used for data transfer. This will often be a subclass - of DataObject, but does not need to be. - - - - What operations are possible for this drag? This controls the icon shown during the drag - - The data object returned by StartDrag() - A combination of DragDropEffects flags - - - - The drag operation is complete. Do whatever is necessary to complete the action. - - The data object returned by StartDrag() - The value returned from GetAllowedEffects() - - - - A do-nothing implementation of IDragSource that can be safely subclassed. - - - - - See IDragSource documentation - - - - - - - - - See IDragSource documentation - - - - - - - See IDragSource documentation - - - - - - - A reasonable implementation of IDragSource that provides normal - drag source functionality. It creates a data object that supports - inter-application dragging of text and HTML representation of - the dragged rows. It can optionally force a refresh of all dragged - rows when the drag is complete. - - Subclasses can override GetDataObject() to add new - data formats to the data transfer object. - - - - Construct a SimpleDragSource - - - - - Construct a SimpleDragSource that refreshes the dragged rows when - the drag is complete - - - - - - Gets or sets whether the dragged rows should be refreshed when the - drag operation is complete. - - - - - Create a DataObject when the user does a left mouse drag operation. - See IDragSource for further information. - - - - - - - - - Which operations are allowed in the operation? By default, all operations are supported. - - - All opertions are supported - - - - The drag operation is finished. Refreshe the dragged rows if so configured. - - - - - - - Create a data object that will be used to as the data object - for the drag operation. - - - Subclasses can override this method add new formats to the data object. - - The ObjectListView that is the source of the drag - A data object for the drag - - - - Objects that implement this interface can acts as the receiver for drop - operation for an ObjectListView. - - - - - Gets or sets the ObjectListView that is the drop sink - - - - - Draw any feedback that is appropriate to the current drop state. - - - Any drawing is done over the top of the ListView. This operation should disturb - the Graphic as little as possible. Specifically, do not erase the area into which - you draw. - - A Graphic for drawing - The contents bounds of the ListView (not including any header) - - - - The user has released the drop over this control - - - Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned - to the originator of the drag. - - - - - - A drag has entered this control. - - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - Change the cursor to reflect the current drag operation. - - - - - - The drag has left the bounds of this control - - - - - The drag is moving over this control. - - This is where any drop target should be calculated. - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - - Should the drag be allowed to continue? - - - - - - This is a do-nothing implementation of IDropSink that is a useful - base class for more sophisticated implementations. - - - - - Gets or sets the ObjectListView that is the drop sink - - - - - Draw any feedback that is appropriate to the current drop state. - - - Any drawing is done over the top of the ListView. This operation should disturb - the Graphic as little as possible. Specifically, do not erase the area into which - you draw. - - A Graphic for drawing - The contents bounds of the ListView (not including any header) - - - - The user has released the drop over this control - - - Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned - to the originator of the drag. - - - - - - A drag has entered this control. - - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - The drag has left the bounds of this control - - - - - The drag is moving over this control. - - This is where any drop target should be calculated. - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - - Change the cursor to reflect the current drag operation. - - You only need to override this if you want non-standard cursors. - The standard cursors are supplied automatically. - - - - - Should the drag be allowed to continue? - - - You only need to override this if you want the user to be able - to end the drop in some non-standard way, e.g. dragging to a - certain point even without releasing the mouse, or going outside - the bounds of the application. - - - - - - This is called when the mouse leaves the drop region and after the - drop has completed. - - - - - The enum indicates which target has been found for a drop operation - - - - - No applicable target has been found - - - - - The list itself is the target of the drop - - - - - An item is the target - - - - - Between two items (or above the top item or below the bottom item) - can be the target. This is not actually ever a target, only a value indicate - that it is valid to drop between items - - - - - Above an item is the target - - - - - Below an item is the target - - - - - A subitem is the target of the drop - - - - - On the right of an item is the target (not currently used) - - - - - On the left of an item is the target (not currently used) - - - - - This class represents a simple implementation of a drop sink. - - - Actually, it should be called CleverDropSink -- it's far from simple and can do quite a lot in its own right. - - - - - Make a new drop sink - - - - - Get or set the locations where a drop is allowed to occur (OR-ed together) - - - - - Gets or sets whether this sink allows model objects to be dragged from other lists. Defaults to true. - - - - - Gets or sets whether the ObjectListView should scroll when the user drags - something near to the top or bottom rows. Defaults to true. - - AutoScroll does not scroll horizontally. - - - - Gets the billboard overlay that will be used to display feedback - messages during a drag operation. - - Set this to null to stop the feedback. - - - - Get or set whether a drop can occur between items of the list - - - - - Get or set whether a drop can occur on the listview itself - - - - - Get or set whether a drop can occur on items in the list - - - - - Get or set whether a drop can occur on a subitem in the list - - - - - Gets or sets whether the drop sink should draw feedback onto the given list - during the drag operation. Defaults to true. - - If this is false, you will have to give the user feedback in some - other fashion, like cursor changes - - - - Get or set the index of the item that is the target of the drop - - - - - Get the item that is the target of the drop - - - - - Get or set the location of the target of the drop - - - - - Get or set the index of the subitem that is the target of the drop - - - - - Get or set the color that will be used to provide drop feedback - - - - - Get whether the alt key was down during this drop event - - - - - Get whether any modifier key was down during this drop event - - - - - Get whether the control key was down during this drop event - - - - - Get whether the left mouse button was down during this drop event - - - - - Get whether the right mouse button was down during this drop event - - - - - Get whether the right mouse button was down during this drop event - - - - - Get whether the shift key was down during this drop event - - - - - Get or set the state of the keys during this drop event - - - - - Gets or sets whether the drop sink will automatically use cursors - based on the drop effect. By default, this is true. If this is - set to false, you must set the Cursor yourself. - - - - - Triggered when the sink needs to know if a drop can occur. - - - Handlers should set Effect to indicate what is possible. - Handlers can change any of the DropTarget* setttings to change - the target of the drop. - - - - - Triggered when the drop is made. - - - - - Triggered when the sink needs to know if a drop can occur - AND the source is an ObjectListView - - - Handlers should set Effect to indicate what is possible. - Handlers can change any of the DropTarget* setttings to change - the target of the drop. - - - - - Triggered when the drop is made. - AND the source is an ObjectListView - - - - - Cleanup the drop sink when the mouse has left the control or - the drag has finished. - - - - - Draw any feedback that is appropriate to the current drop state. - - - Any drawing is done over the top of the ListView. This operation should disturb - the Graphic as little as possible. Specifically, do not erase the area into which - you draw. - - A Graphic for drawing - The contents bounds of the ListView (not including any header) - - - - The user has released the drop over this control - - - - - - A drag has entered this control. - - Implementators should set args.Effect to the appropriate DragDropEffects. - - - - - Change the cursor to reflect the current drag operation. - - - - - - The drag is moving over this control. - - - - - - Trigger the Dropped events - - - - - - Trigger CanDrop - - - - - - Trigger Dropped - - - - - - Trigger ModelCanDrop - - - - - - Trigger ModelDropped - - - - - - Handle the timer tick event, which is sent when the listview should - scroll - - - - - When the mouse is at the given point, what should the target of the drop be? - - This method should update the DropTarget* members of the given arg block - - The mouse point, in client co-ordinates - - - - What sort of action is possible when the mouse is at the given point? - - - - - - - - - - Based solely on the state of the modifier keys, what drop operation should - be used? - - The drop operation that matches the state of the keys - - - - Should the listview be made to scroll when the mouse is at the given point? - - - - - - Update the state of our sink to reflect the information that - may have been written into the drop event args. - - - - - - Draw the feedback that shows that the background is the target - - - - - - - Draw the feedback that shows that an item (or a subitem) is the target - - - - - DropTargetItem and DropTargetSubItemIndex tells what is the target - - - - - Draw the feedback that shows the drop will occur before target - - - - - - - Draw the feedback that shows the drop will occur after target - - - - - - - Return a GraphicPath that is round corner rectangle. - - - - - - - - Calculate the target rectangle when the given item (and possible subitem) - is the target of the drop. - - - - - - - - Draw a "between items" line at the given co-ordinates - - - - - - - - - - This drop sink allows items within the same list to be rearranged, - as well as allowing items to be dropped from other lists. - - - - This class can only be used on plain ObjectListViews and FastObjectListViews. - The other flavours have no way to implement the insert operation that is required. - - - This class does not work with grouping. - - - This class works when the OLV is sorted, but it is up to the programmer - to decide what rearranging such lists "means". Example: if the control is sorting - students by academic grade, and the user drags a "Fail" grade student up amonst the "A+" - students, it is the responsibility of the programmer to makes the appropriate changes - to the model and redraw/rebuild the control so that the users action makes sense. - - - Users of this class should listen for the CanDrop event to decide - if models from another OLV can be moved to OLV under this sink. - - - - - - Create a RearrangingDropSink - - - - - Create a RearrangingDropSink - - - - - - Trigger OnModelCanDrop - - - - - - Trigger OnModelDropped - - - - - - Do the work of processing the dropped items - - - - - - When a drop sink needs to know if something can be dropped, or - to notify that a drop has occured, it uses an instance of this class. - - - - - Create a OlvDropEventArgs - - - - - Get the original drag-drop event args - - - - - Get the data object that is being dragged - - - - - Get the drop sink that originated this event - - - - - Get or set the index of the item that is the target of the drop - - - - - Get or set the location of the target of the drop - - - - - Get or set the index of the subitem that is the target of the drop - - - - - Get the item that is the target of the drop - - - - - Get or set the drag effect that should be used for this operation - - - - - Get or set if this event was handled. No further processing will be done for a handled event. - - - - - Get or set the feedback message for this operation - - - If this is not null, it will be displayed as a feedback message - during the drag. - - - - - Get the ObjectListView that is being dropped on - - - - - Get the location of the mouse (in target ListView co-ords) - - - - - Get the drop action indicated solely by the state of the modifier keys - - - - - These events are triggered when the drag source is an ObjectListView. - - - - - Create a ModelDropEventArgs - - - - - Gets the model objects that are being dragged. - - - - - Gets the ObjectListView that is the source of the dragged objects. - - - - - Get the model object that is being dropped upon. - - This is only value for TargetLocation == Item - - - - Refresh all the objects involved in the operation - - - - - A data transfer object that knows how to transform a list of model - objects into a text and HTML representation. - - - - - Create a data object from the selected objects in the given ObjectListView - - The source of the data object - - - - Create a data object which operates on the given model objects - in the given ObjectListView - - The source of the data object - The model objects to be put into the data object - - - - Gets or sets whether hidden columns will also be included in the text - and HTML representation. If this is false, only visible columns will - be included. - - - - - Gets or sets whether column headers will also be included in the text - and HTML representation. - - - - - Gets the ObjectListView that is being used as the source of the data - - - - - Gets the model objects that are to be placed in the data object - - - - - Put a text and HTML representation of our model objects - into the data object. - - - - - Create an exporter for the data contained in this object - - - - - - Make a HTML representation of our model objects - - - - - Convert the fragment of HTML into the Clipboards HTML format. - - The HTML format is found here http://msdn2.microsoft.com/en-us/library/aa767917.aspx - - The HTML to put onto the clipboard. It must be valid HTML! - A string that can be put onto the clipboard and will be recognized as HTML - - - - A FastDataListView virtualizes the display of data from a DataSource. It operates on - DataSets and DataTables in the same way as a DataListView, but does so much more efficiently. - - - - A FastDataListView still has to load all its data from the DataSource. If you have SQL statement - that returns 1 million rows, all 1 million rows will still need to read from the database. - However, once the rows are loaded, the FastDataListView will only build rows as they are displayed. - - - - - - - - - - - - 获取或设置在设置DataSource时是否自动生成列以显示列。 - - 必须在设置DataSource之前设置此设置。之后就没有效果了。 - - - - 获取或设置将在此列表视图中显示的VirtualListDataSource。 - - VirtualListDataSource应实现 , , - 或 . 以下是一些常见的对象类型 - - - - - - - - 绑定到列表容器时 (即，实现 接口, 比如 ) - 您还必须实现 属性，以便标识要显示的特定列表。您也可以设置 属性， - 即使当VirtualListDataSource引用列表时也是如此, 因为 还可以用于导航列表之间的关系. - - - - - Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. - - If the data source is not a DataSet or DataViewManager, this property has no effect - - - - Gets or sets the DataSourceAdaptor that does the bulk of the work needed - for data binding. - - - - - Create the DataSourceAdapter that this control will use. - - A DataSourceAdapter configured for this list - Subclasses should override this to create their - own specialized adapters - - - - Change the Unfreeze behaviour - - - - - A FastObjectListView trades function for speed. - - - On my mid-range laptop, this view builds a list of 10,000 objects in 0.1 seconds, - as opposed to a normal ObjectListView which takes 10-15 seconds. Lists of up to 50,000 items should be - able to be handled with sub-second response times even on low end machines. - - A FastObjectListView is implemented as a virtual list with many of the virtual modes limits (e.g. no sorting) - fixed through coding. There are some functions that simply cannot be provided. Specifically, a FastObjectListView cannot: - - use Tile view - show groups on XP - - - - - - - Make a FastObjectListView - - - - - Gets the collection of objects that survive any filtering that may be in place. - - - - - Get/set the collection of objects that this list will show - - - - The contents of the control will be updated immediately after setting this property. - - This method preserves selection, if possible. Use SetObjects() if - you do not want to preserve the selection. Preserving selection is the slowest part of this - code and performance is O(n) where n is the number of selected rows. - This method is not thread safe. - - - - - Move the given collection of objects to the given index. - - This operation only makes sense on non-grouped ObjectListViews. - - - - - - 删除任何排序并恢复到模型对象的给定顺序 - - To be really honest, Unsort() doesn't work on FastObjectListViews since - the original ordering of model objects is lost when Sort() is called. So this method - effectively just turns off sorting. - - - - 为FastObjectListView提供数据源 - - - This class isn't intended to be used directly, but it is left as a public - class just in case someone wants to subclass it. - - - - - Create a FastObjectListDataSource - - - - - - Get n'th object - - - - - - - How many items are in the data source - - - - - - Get the index of the given model - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Remove the given collection of models from this source. - - - - - - - - - - - - Update/replace the nth object with the given object - - - - - - - Apply the given filters to this data source. One or both may be null. - - - - - - - Gets the full list of objects being used for this fast list. - This list is unfiltered. - - - - - Gets the list of objects from ObjectList which survive any installed filters. - - - - - Rebuild the map that remembers which model object is displayed at which line - - - - - Build our filtered list from our full list. - - - - - Concrete implementation of the ICluster interface. - - - - - Create a cluster - - The key for the cluster - - - - Return a string representation of this cluster - - - - - - Gets or sets how many items belong to this cluster - - - - - Gets or sets the label that will be shown to the user to represent - this cluster - - - - - Gets or sets the actual data object that all members of this cluster - have commonly returned. - - - - - Return an indication of the ordering between this object and the given one - - - - - - - This class provides a useful base implemention of a clustering - strategy where the clusters are grouped around the value of a given column. - - - - - This field is the text that will be shown to the user when a cluster - key is null. It is exposed so it can be localized. - - - - - This field is the text that will be shown to the user when a cluster - key is empty (i.e. a string of zero length). It is exposed so it can be localized. - - - - - Gets or sets the format that will be used by default for clusters that only - contain 1 item. The format string must accept two placeholders: - - {0} is the cluster key converted to a string - - {1} is the number of items in the cluster (always 1 in this case) - - - - - Gets or sets the format that will be used by default for clusters that - contain 0 or two or more items. The format string must accept two placeholders: - - {0} is the cluster key converted to a string - - {1} is the number of items in the cluster - - - - - Create a clustering strategy - - - - - Gets or sets the column upon which this strategy is operating - - - - - Gets or sets the format that will be used when the cluster - contains only 1 item. The format string must accept two placeholders: - - {0} is the cluster key converted to a string - - {1} is the number of items in the cluster (always 1 in this case) - - If this is not set, the value from - ClusteringStrategy.DefaultDisplayLabelFormatSingular will be used - - - - Gets or sets the format that will be used when the cluster - contains 0 or two or more items. The format string must accept two placeholders: - - {0} is the cluster key converted to a string - - {1} is the number of items in the cluster - - If this is not set, the value from - ClusteringStrategy.DefaultDisplayLabelFormatPlural will be used - - - - Get the cluster key by which the given model will be partitioned by this strategy - - - - - - - Create a cluster to hold the given cluster key - - - - - - - Gets the display label that the given cluster should use - - - - - - - Create a filter that will include only model objects that - match one or more of the given values. - - - - - - - Create a label that combines the string representation of the cluster - key with a format string that holds an "X [N items in cluster]" type layout. - - - - - - - - This class calculates clusters from the groups that the column uses. - - - - This is the default strategy for all non-date, filterable columns. - - - This class does not strictly mimic the groups created by the given column. - In particular, if the programmer changes the default grouping technique - by listening for grouping events, this class will not mimic that behaviour. - - - - - - Get the cluster key by which the given model will be partitioned by this strategy - - - - - - - Gets the display label that the given cluster should use - - - - - - - This enum is used to indicate various portions of a datetime - - - - - Year - - - - - Month - - - - - Day of the month - - - - - Hour - - - - - Minute - - - - - Second - - - - - This class implements a strategy where the model objects are clustered - according to some portion of the datetime value in the configured column. - - To create a strategy that grouped people who were born in - the same month, you would create a strategy that extracted just - the month, and formatted it to show just the month's name. Like this: - - - someColumn.ClusteringStrategy = new DateTimeClusteringStrategy(DateTimePortion.Month, "MMMM"); - - - - - Create a strategy that clusters by month/year - - - - - Create a strategy that clusters around the given parts - - - - - - - Gets or sets the format string will will be used to create a user-presentable - version of the cluster key. - - The format should use the date/time format strings, as documented - in the Windows SDK. Both standard formats and custom format will work. - "D" - long date pattern - "MMMM, yyyy" - "January, 1999" - - - - Gets or sets the parts of the DateTime that will be extracted when - determining the clustering key for an object. - - - - - Get the cluster key by which the given model will be partitioned by this strategy - - - - - - - Gets the display label that the given cluster should use - - - - - - - Convert the given date into a user presentable string - - - - - - - Instances of this class know how to build a Filter menu. - It is responsible for clustering the values in the target column, - build a menu that shows those clusters, and then constructing - a filter that will enact the users choices. - - - Almost all of the methods in this class are declared as "virtual protected" - so that subclasses can provide alternative behaviours. - - - - - Gets or sets the string that labels the Apply button. - Exposed so it can be localized. - - - - - Gets or sets the string that labels the Clear All menu item. - Exposed so it can be localized. - - - - - Gets or sets the string that labels the Filtering menu as a whole.. - Exposed so it can be localized. - - - - - Gets or sets the string that represents Select All values. - If this is set to null or empty, no Select All option will be included. - Exposed so it can be localized. - - - - - Gets or sets the image that will be placed next to the Clear Filtering menu item - - - - - Gets or sets the image that will be placed next to all "Apply" menu items on the filtering menu - - - - - Gets or sets whether null should be considered as a valid data value. - If this is true (the default), then a cluster will null as a key will be allow. - If this is false, object that return a cluster key of null will ignored. - - - - - Gets or sets the maximum number of objects that the clustering strategy - will consider. This should be large enough to collect all unique clusters, - but small enough to finish in a reasonable time. - - The default value is 10,000. This should be perfectly - acceptable for almost all lists. - - - - Create a Filter menu on the given tool tip for the given column in the given ObjectListView. - - This is the main entry point into this class. - - - - The strip that should be shown to the user - - - - Create a collection of clusters that should be presented to the user - - - - - - - - - Order the given list of clusters in the manner in which they should be presented to the user. - - - - - - - Do the work of making a menu that shows the clusters to the users - - - - - - - - Wrap a protected section around the real HandleItemChecked method, so that if - that method tries to change a "checkedness" of an item, we don't get a recursive - stack error. Effectively, this ensure that HandleItemChecked is only called - in response to a user action. - - - - - - - Handle a user-generated ItemCheck event - - - - - - - Handle any checking/unchecking of the Select All option, and keep - its checkedness in sync with everything else that is checked. - - - - - - - - Clear all the filters that are applied to the given column - - The column from which filters are to be removed - - - - Apply the selected values from the given list as a filter on the given column - - A list in which the checked items should be used as filters - The column for which a filter should be generated - - - - Interface for model-by-model filtering - - - - - Should the given model be included when this filter is installed - - The model object to consider - Returns true if the model will be included by the filter - - - - Interface for whole list filtering - - - - - Return a subset of the given list of model objects as the new - contents of the ObjectListView - - The collection of model objects that the list will possibly display - The filtered collection that holds the model objects that will be displayed. - - - - Base class for model-by-model filters - - - - - Should the given model be included when this filter is installed - - The model object to consider - Returns true if the model will be included by the filter - - - - This filter calls a given Predicate to decide if a model object should be included - - - - - Create a filter based on the given predicate - - The function that will filter objects - - - - Gets or sets the predicate used to filter model objects - - - - - Should the given model object be included? - - - - - - - A CompositeFilter joins several other filters together. - If there are no filters, all model objects are included - - - - - Create an empty filter - - - - - Create a composite filter from the given list of filters - - A list of filters - - - - Gets or sets the filters used by this composite - - - - - Get the sub filters that are text match filters - - - - - Decide whether or not the given model should be included by the filter - - - True if the object is included by the filter - - - - Decide whether or not the given model should be included by the filter - - Filters is guaranteed to be non-empty when this method is called - The model object under consideration - True if the object is included by the filter - - - - A CompositeAllFilter joins several other filters together. - A model object must satisfy all filters to be included. - If there are no filters, all model objects are included - - - - - Create a filter - - - - - - Decide whether or not the given model should be included by the filter - - Filters is guaranteed to be non-empty when this method is called - The model object under consideration - True if the object is included by the filter - - - - A CompositeAllFilter joins several other filters together. - A model object must only satisfy one of the filters to be included. - If there are no filters, all model objects are included - - - - - Create a filter from the given filters - - - - - - Decide whether or not the given model should be included by the filter - - Filters is guaranteed to be non-empty when this method is called - The model object under consideration - True if the object is included by the filter - - - - Instances of this class extract a value from the model object - and compare that value to a list of fixed values. The model - object is included if the extracted value is in the list - - If there is no delegate installed or there are - no values to match, no model objects will be matched - - - - Create a filter that will use the given delegate to extract values - - - - - - Create a filter that will extract values using the given delegate - and compare them to the values in the given list. - - - - - - - Gets or sets the delegate that will be used to extract values - from model objects - - - - - Gets or sets the list of values that the value extracted from - the model object must match in order to be included. - - - - - Should the given model object be included? - - - - - - - Decides if the given property is a match for the values in the PossibleValues collection - - - - - - - Instances of this class match a property of a model objects against - a list of bit flags. The property should be an xor-ed collection - of bits flags. - - Both the property compared and the list of possible values - must be convertible to ulongs. - - - - Create an instance - - - - - - - Gets or sets the collection of values that will be matched. - These must be ulongs (or convertible to ulongs). - - - - - Decides if the given property is a match for the values in the PossibleValues collection - - - - - - - Base class for whole list filters - - - - - Return a subset of the given list of model objects as the new - contents of the ObjectListView - - The collection of model objects that the list will possibly display - The filtered collection that holds the model objects that will be displayed. - - - - Instance of this class implement delegate based whole list filtering - - - - - A delegate that filters on a whole list - - - - - - - Create a ListFilter - - - - - - Gets or sets the delegate that will filter the list - - - - - Do the actual work of filtering - - - - - - - Filter the list so only the last N entries are displayed - - - - - Create a no-op tail filter - - - - - Create a filter that includes on the last N model objects - - - - - - Gets or sets the number of model objects that will be - returned from the tail of the list - - - - - Return the last N subset of the model objects - - - - - - - Instances of this class cluster model objects on the basis of a - property that holds an xor-ed collection of bit flags. - - - - - Create a clustering strategy that operates on the flags of the given enum - - - - - - Create a clustering strategy around the given collections of flags and their display labels. - There must be the same number of elements in both collections. - - The list of flags. - - - - - Gets the value that will be xor-ed to test for the presence of a particular value. - - - - - Gets the labels that will be used when the corresponding Value is XOR present in the data. - - - - - Get the cluster key by which the given model will be partitioned by this strategy - - - - - - - Gets the display label that the given cluster should use - - - - - - - Create a filter that will include only model objects that - match one or more of the given values. - - - - - - - A cluster is a like collection of objects that can be usefully filtered - as whole using the filtering UI provided by the ObjectListView. - - - - - Gets or sets how many items belong to this cluster - - - - - Gets or sets the label that will be shown to the user to represent - this cluster - - - - - Gets or sets the actual data object that all members of this cluster - have commonly returned. - - - - - Implementation of this interface control the selecting of cluster keys - and how those clusters will be presented to the user - - - - - Gets or sets the column upon which this strategy will operate - - - - - Get the cluster key by which the given model will be partitioned by this strategy - - If the returned value is an IEnumerable, the given model is considered - to belong to multiple clusters - - - - - - Create a cluster to hold the given cluster key - - - - - - - Gets the display label that the given cluster should use - - - - - - - Create a filter that will include only model objects that - match one or more of the given values. - - - - - - - Instances of this class include only those rows of the listview - that match one or more given strings. - - This class can match strings by prefix, regex, or simple containment. - There are factory methods for each of these matching strategies. - - - - Create a text filter that will include rows where any cell matches - any of the given regex expressions. - - - - - Any string that is not a valid regex expression will be ignored. - - - - Create a text filter that includes rows where any cell begins with one of the given strings - - - - - - - - Create a text filter that includes rows where any cell contains any of the given strings. - - - - - - - - Create a TextFilter - - - - - - Create a TextFilter that finds the given string - - - - - - - Create a TextFilter that finds the given string using the given comparison - - - - - - - - Gets or sets which columns will be used for the comparisons? If this is null, all columns will be used - - - - - Gets or sets additional columns which will be used in the comparison. These will be used - in addition to either the Columns property or to all columns taken from the control. - - - - - Gets or sets the collection of strings that will be used for - contains matching. Setting this replaces all previous texts - of any kind. - - - - - Gets whether or not this filter has any search criteria - - - - - Gets or set the ObjectListView upon which this filter will work - - - You cannot really rebase a filter after it is created, so do not change this value. - It is included so that it can be set in an object initializer. - - - - - Gets or sets the collection of strings that will be used for - prefix matching. Setting this replaces all previous texts - of any kind. - - - - - Gets or sets the options that will be used when compiling the regular expression. - - - This is only used when doing Regex matching (obviously). - If this is not set specifically, the appropriate options are chosen to match the - StringComparison setting (culture invariant, case sensitive). - - - - - Gets or sets the collection of strings that will be used for - regex pattern matching. Setting this replaces all previous texts - of any kind. - - - - - Gets or sets how the filter will match text - - - - - Loop over the columns that are being considering by the filter - - - - - - Do the actual work of filtering - - - - - - - Find all the ways in which this filter matches the given string. - - This is used by the renderer to decide which bits of - the string should be highlighted - - A list of character ranges indicating the matched substrings - - - - Is the given column one of the columns being used by this filter? - - - - - - - Base class for the various types of string matching that TextMatchFilter provides - - - - - Gets how the filter will match text - - - - - Gets the text filter to which this component belongs - - - - - Gets or sets the text that will be matched - - - - - Find all the ways in which this filter matches the given string. - - - - This is used by the renderer to decide which bits of - the string should be highlighted. - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - A list of character ranges indicating the matched substrings - - - - Does the given text match the filter - - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - Return true if the given cellText matches our strategy - - - - This component provides text contains matching strategy. - - - - - Create a text contains strategy - - - - - - - Does the given text match the filter - - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - Return true if the given cellText matches our strategy - - - - Find all the ways in which this filter matches the given string. - - - - This is used by the renderer to decide which bits of - the string should be highlighted. - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - A list of character ranges indicating the matched substrings - - - - This component provides text begins with matching strategy. - - - - - Create a text begins strategy - - - - - - - Does the given text match the filter - - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - Return true if the given cellText matches our strategy - - - - Find all the ways in which this filter matches the given string. - - - - This is used by the renderer to decide which bits of - the string should be highlighted. - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - A list of character ranges indicating the matched substrings - - - - This component provides regex matching strategy. - - - - - Creates a regex strategy - - - - - - - Gets or sets the options that will be used when compiling the regular expression. - - - - - Gets or sets a compilex regular expression, based on our current Text and RegexOptions. - - - If Text fails to compile as a regular expression, this will return a Regex object - that will match all strings. - - - - - Gets whether or not our current regular expression is a valid regex - - - - - Does the given text match the filter - - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - Return true if the given cellText matches our strategy - - - - Find all the ways in which this filter matches the given string. - - - - This is used by the renderer to decide which bits of - the string should be highlighted. - - this.Text will not be null or empty when this is called. - - The text of the cell we want to search - A list of character ranges indicating the matched substrings - - - - This attribute is used to mark a property of a model - class that should be noticed by Generator class. - - - All the attributes of this class match their equivilent properties on OLVColumn. - - - - - Create a new OLVColumnAttribute - - - - - Create a new OLVColumnAttribute with the given title - - The title of the column - - - - - - - - - - - - - - - - - - - - - - - - - - - - - An array of IComparables that mark the cutoff points for values when - grouping on this column. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Properties marked with [OLVChildren] will be used as the children source in a TreeListView. - - - - - Properties marked with [OLVIgnore] will not have columns generated for them. - - - - - ColumnComparer is the workhorse for all comparison between two values of a particular column. - If the column has a specific comparer, use that to compare the values. Otherwise, do - a case insensitive string compare of the string representations of the values. - - This class inherits from both IComparer and its generic counterpart - so that it can be used on untyped and typed collections. - This is used by normal (non-virtual) ObjectListViews. Virtual lists use - ModelObjectComparer - - - - - Gets or sets the method that will be used to compare two strings. - The default is to compare on the current culture, case-insensitive - - - - - Create a ColumnComparer that will order the rows in a list view according - to the values in a given column - - The column whose values will be compared - The ordering for column values - - - - Create a ColumnComparer that will order the rows in a list view according - to the values in a given column, and by a secondary column if the primary - column is equal. - - The column whose values will be compared - The ordering for column values - The column whose values will be compared for secondary sorting - The ordering for secondary column values - - - - Compare two rows - - row1 - row2 - An ordering indication: -1, 0, 1 - - - - Compare two rows - - row1 - row2 - An ordering indication: -1, 0, 1 - - - - Compare the actual values to be used for sorting - - The aspect extracted from the first row - The aspect extracted from the second row - An ordering indication: -1, 0, 1 - - - - This comparer sort list view groups. OLVGroups have a "SortValue" property, - which is used if present. Otherwise, the titles of the groups will be compared. - - - - - Create a group comparer - - The ordering for column values - - - - Compare the two groups. OLVGroups have a "SortValue" property, - which is used if present. Otherwise, the titles of the groups will be compared. - - group1 - group2 - An ordering indication: -1, 0, 1 - - - - This comparer can be used to sort a collection of model objects by a given column - - - This is used by virtual ObjectListViews. Non-virtual lists use - ColumnComparer - - - - - Gets or sets the method that will be used to compare two strings. - The default is to compare on the current culture, case-insensitive - - - - - Create a model object comparer - - - - - - - Create a model object comparer with a secondary sorting column - - - - - - - - - Compare the two model objects - - - - - - - - Compare the actual values - - - - - - - - A helper class that translates DataSource events for an ObjectListView - - - - - Make a DataSourceAdapter - - - - - Finalize this object - - - - - Release all the resources used by this instance - - - - - Release all the resources used by this instance - - - - - Gets or sets whether or not columns will be automatically generated to show the - columns when the DataSource is set. - - This must be set before the DataSource is set. It has no effect afterwards. - - - - Get or set the DataSource that will be displayed in this list view. - - - - - Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. - - If the data source is not a DataSet or DataViewManager, this property has no effect - - - - Gets the ObjectListView upon which this adaptor will operate - - - - - Gets or sets the currency manager which is handling our binding context - - - - - - - - - - - - - - - - - - - - - - - - - - - Our data source has changed. Figure out how to handle the new source - - - - - Our data source has changed. Figure out how to handle the new source - - - - - The data source for this control has changed. Reconfigure the control for the new source - - - - - Take the contents of the currently bound list and put them into the control - - - - - Create columns for the listview based on what properties are available in the data source - - - This method will create columns if there is not already a column displaying that property. - - - - - Decide if a new column should be added to the control to display - the given property - - - - - - - Configure the given column to show the given property. - The title and aspect name of the column are already filled in. - - - - - - - Generate aspect getters and putters for any columns that are missing them (and for which we have - enough information to actually generate a getter) - - - - - CurrencyManager ListChanged event handler. - Deals with fine-grained changes to list items. - - - It's actually difficult to deal with these changes in a fine-grained manner. - If our listview is grouped, then any change may make a new group appear or - an old group disappear. It is rarely enough to simply update the affected row. - - - - - - - Handle PropertyDescriptor* events - - - - - - Handle ItemMoved event - - - - - - Handle the ItemDeleted event - - - - - - Handle an ItemAdded event. - - - - - - Handle the Reset event - - - - - - Handle ItemChanged event. This is triggered when a single item - has changed, so just refresh that one item. - - - Even in this simple case, we should probably rebuild the list. - For example, the change could put the item into its own new group. - - - - The CurrencyManager calls this if the data source looks - different. We just reload everything. - - - - - CHECK: Do we need this if we are handle ListChanged metadata events? - - - - - Called by the CurrencyManager when the currently selected item - changes. We update the ListView selection so that we stay in sync - with any other controls bound to the same source. - - - - - - - Change the control's position (which is it's currently selected row) - to the nth row in the dataset - - The index of the row to be selected - - - - Handle the selection changing in our ListView. - We need to tell our currency manager about the new position. - - - - - - - Handle the frozenness of our ListView changing. - - - - - - - Handle a change to the BindingContext of our ListView. - - - - - - - These delegates are used to extract an aspect from a row object - - - - - These delegates are used to put a changed value back into a model object - - - - - These delegates can be used to convert an aspect value to a display string, - instead of using the default ToString() - - - - - These delegates are used to get the tooltip for a cell - - - - - These delegates are used to the state of the checkbox for a row object. - - - For reasons known only to someone in Microsoft, we can only set - a boolean on the ListViewItem to indicate it's "checked-ness", but when - we receive update events, we have to use a tristate CheckState. So we can - be told about an indeterminate state, but we can't set it ourselves. - - As of version 2.0, we can now return indeterminate state. - - - - - These delegates are used to get the state of the checkbox for a row object. - - - - - - - These delegates are used to put a changed check state back into a model object - - - - - These delegates are used to put a changed check state back into a model object - - - - - - - - These delegates are used to get the renderer for a particular cell - - - - - The callbacks for RightColumnClick events - - - - - This delegate will be used to own draw header column. - - - - - This delegate is called when a group has been created but not yet made - into a real ListViewGroup. The user can take this opportunity to fill - in lots of other details about the group. - - - - - These delegates are used to retrieve the object that is the key of the group to which the given row belongs. - - - - - These delegates are used to convert a group key into a title for the group - - - - - These delegates are used to get the tooltip for a column header - - - - - These delegates are used to fetch the image selector that should be used - to choose an image for this column. - - - - - These delegates are used to draw a cell - - - - - These delegates are used to fetch a row object for virtual lists - - - - - These delegates are used to format a listviewitem before it is added to the control. - - - - - These delegates can be used to return the array of texts that should be searched for text filtering - - - - - These delegates are used to sort the listview in some custom fashion - - - - - These delegates are used to order two strings. - x cannot be null. y can be null. - - - - - An ObjectListView is a much easier to use, and much more powerful, version of the ListView. - - - - An ObjectListView automatically populates a ListView control with information taken - from a given collection of objects. It can do this because each column is configured - to know which bit of the model object (the "aspect") it should be displaying. Columns similarly - understand how to sort the list based on their aspect, and how to construct groups - using their aspect. - - - Aspects are extracted by giving the name of a method to be called or a - property to be fetched. These names can be simple names or they can be dotted - to chain property access e.g. "Owner.Address.Postcode". - Aspects can also be extracted by installing a delegate. - - - An ObjectListView can show a "this list is empty" message when there is nothing to show in the list, - so that the user knows the control is supposed to be empty. - - - Right clicking on a column header should present a menu which can contain: - commands (sort, group, ungroup); filtering; and column selection. Whether these - parts of the menu appear is controlled by ShowCommandMenuOnRightClick, - ShowFilterMenuOnRightClick and SelectColumnsOnRightClick respectively. - - - The groups created by an ObjectListView can be configured to include other formatting - information, including a group icon, subtitle and task button. Using some undocumented - interfaces, these groups can even on virtual lists. - - - ObjectListView supports dragging rows to other places, including other application. - Special support is provide for drops from other ObjectListViews in the same application. - In many cases, an ObjectListView becomes a full drag source by setting to - true. Similarly, to accept drops, it is usually enough to set to true, - and then handle the and events (or the and - events, if you only want to handle drops from other ObjectListViews in your application). - - - For these classes to build correctly, the project must have references to these assemblies: - - - System - System.Data - System.Design - System.Drawing - System.Windows.Forms (obviously) - - - - - - How does a user indicate that they want to edit cells? - - - - - 列表将不支持编辑(同时F2按键无效) - - - - - 单击 单元格 将编辑值. - 选择该行，就像正常选择行一样。用户必须按F2键才能编辑主列。 - - - - - 双击子项或主列将编辑该单元格。 - F2键将编辑主列。 - - - - - 按F2键是编辑单元格的唯一方法。一旦主列被编辑， - 行中的其他单元格可以通过按Tab键进行编辑。 - - - - - 只需单击任意单元格即可编辑值，即使是主列也是如此。 - - - - - 这些值指定向用户显示列选择的方式 - - - - - 不会显示任何列选择 - - - - - 这些列将显示在主菜单中 - - - - - 这些列将显示在子菜单中 - - - - - 将显示一个模式对话框，允许用户选择列 - - - - - Triggered after a ObjectListView has been searched by the user typing into the list - - - - - Triggered after a ObjectListView has been sorted - - - - - Triggered before a ObjectListView is searched by the user typing into the list - - - Set Cancelled to true to prevent the searching from taking place. - Changing StringToFind or StartSearchFrom will change the subsequent search. - - - - - Triggered before a ObjectListView is sorted - - - Set Cancelled to true to prevent the sort from taking place. - Changing ColumnToSort or SortOrder will change the subsequent sort. - - - - - Triggered after a ObjectListView has created groups - - - - - Triggered before a ObjectListView begins to create groups - - - Set Groups to prevent the default group creation process - - - - - Triggered just before a ObjectListView creates groups - - - You can make changes to the groups, which have been created, before those - groups are created within the listview. - - - - - Triggered when a button in a cell is left clicked. - - - - - This event is triggered when the user moves a drag over an ObjectListView that - has a SimpleDropSink installed as the drop handler. - - - Handlers for this event should set the Effect argument and optionally the - InfoMsg property. They can also change any of the DropTarget* setttings to change - the target of the drop. - - - - - Triggered when a cell has finished being edited. - - - - - Triggered when a cell is about to finish being edited. - - If Cancel is already true, the user is cancelling the edit operation. - Set Cancel to true to prevent the value from the cell being written into the model. - You cannot prevent the editing from finishing within this event -- you need - the CellEditValidating event for that. - - - - Triggered when a cell is about to be edited. - - Set Cancel to true to prevent the cell being edited. - You can change the the Control to be something completely different. - - - - Triggered when a cell editor needs to be validated - - - If this event is cancelled, focus will remain on the cell editor. - - - - - Triggered when a cell is left clicked. - - - - - Triggered when the mouse is above a cell. - - - - - Triggered when a cell is right clicked. - - - - - This event is triggered when a cell needs a tool tip. - - - - - This event is triggered when a checkbox is checked/unchecked on a subitem - - - - - Triggered when a column header is right clicked. - - - - - This event is triggered when the user releases a drag over an ObjectListView that - has a SimpleDropSink installed as the drop handler. - - - - - This event is triggered when the control needs to filter its collection of objects. - - - - - This event is triggered when a cell needs to be formatted. - - - - - This event is triggered when the frozeness of the control changes. - - - - - This event is triggered when a row needs to be formatted. - - - - - This event is triggered when a group is about to collapse or expand. - This can be cancelled to prevent the expansion. - - - - - This event is triggered when a group changes state. - - - - - This event is triggered when a header checkbox is changing value - - - - - This event is triggered when a header needs a tool tip. - - - - - Triggered when the "hot" item changes - - - - - Triggered when a hyperlink cell is clicked. - - - - - Triggered when the task text of a group is clicked. - - - - - Is the value in the given cell a hyperlink. - - - - - Some new objects are about to be added to an ObjectListView. - - - - - The contents of the ObjectListView has changed. - - - - - The contents of the ObjectListView is about to change via a SetObjects call - - - Set Cancelled to true to prevent the contents of the list changing. This does not work with virtual lists. - - - - - Some objects are about to be removed from an ObjectListView. - - - - - This event is triggered when the user moves a drag over an ObjectListView that - has a SimpleDropSink installed as the drop handler, and when the source control - for the drag was an ObjectListView. - - - Handlers for this event should set the Effect argument and optionally the - InfoMsg property. They can also change any of the DropTarget* setttings to change - the target of the drop. - - - - - This event is triggered when the user releases a drag over an ObjectListView that - has a SimpleDropSink installed as the drop handler and when the source control - for the drag was an ObjectListView. - - - - - This event is triggered once per user action that changes the selection state - of one or more rows. - - - - - This event is triggered when the contents of the ObjectListView has scrolled. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Tell the world when a cell is about to be edited. - - - - - Tell the world when a cell is about to finish being edited. - - - - - Tell the world when a cell is about to finish being edited. - - - - - Tell the world when a cell has finished being edited. - - - - - 创建一个 ObjectListView - - - - - Dispose of any resources this instance has been using - - - - - - 获取鼠标左键是否在此时按下。 - - - - - 获取该程序是否在Vista或更高版本上运行 - - - - - 获取该程序是否在Win7或更高版本上运行 - - - - - Gets or sets how what smoothing mode will be applied to graphic operations. - - - - - Gets or sets how should text be renderered. - - - - - 获取或设置当组Key为Null时将用于标题组的字符串。将其公开以使其可以本地化。 - - - - - Convert the given enumerable into an ArrayList as efficiently as possible - - The source collection - If true, this method will always create a new - collection. - An ArrayList with the same contents as the given collection. - - When we move to .NET 3.5, we can use LINQ and not need this method. - - - - - Return the count of items in the given enumerable - - - - When we move to .NET 3.5, we can use LINQ and not need this method. - - - - Return whether or not the given enumerable is empty. A string is regarded as - an empty collection. - - - True if the given collection is null or empty - - When we move to .NET 3.5, we can use LINQ and not need this method. - - - - - Gets or sets whether all ObjectListViews will silently ignore missing aspect errors. - - - - By default, if an ObjectListView is asked to display an aspect - (i.e. a field/property/method) - that does not exist from a model, it displays an error message in that cell, since that - condition is normally a programming error. There are some use cases where - this is not an error -- in those cases, set this to true and ObjectListView will - simply display an empty cell. - - Be warned: if you set this to true, it can be very difficult to track down - typing mistakes or name changes in AspectNames. - - - - - Gets or sets whether the control will draw a rectangle in each cell showing the cell padding. - - - - This can help with debugging display problems from cell padding. - - As with all cell padding, this setting only takes effect when the control is owner drawn. - - - - - Gets the style that will be used by default to format disabled rows - - - - - Gets the style that will be used by default to format hot rows - - - - - Gets or sets an model filter that is combined with any column filtering that the end-user specifies. - - This is different from the ModelFilter property, since setting that will replace - any column filtering, whereas setting this will combine this filter with the column filtering - - - - Get or set all the columns that this control knows about. - Only those columns where IsVisible is true will be seen by the user. - - - - If you want to add new columns programmatically, add them to - AllColumns and then call RebuildColumns(). Normally, you do not have to - deal with this property directly. Just use the IDE. - - If you do add or remove columns from the AllColumns collection, - you have to call RebuildColumns() to make those changes take effect. - - - - - 获取或设置每隔一行的背景色 - - - - - 获取已设置的交替行背景色或默认颜色 - - - - - 此属性强制ObjectListView始终按给定列对项进行分组。 - - - - - 如果AlwaysGroupByColumn不为空，则此属性将用于确定如何对这些组进行排序。 - 如果此属性的值为SortOrder.None，则排序顺序将根据用户上次单击的标题切换。 - - - - - Give access to the image list that is actually being used by the control - - - Normally, it is preferable to use SmallImageList. Only use this property - if you know exactly what you are doing. - - - - - 获取或设置编辑单元格的方式 - - Columns can also be marked as editable. - - - - 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ - 默认值为 true. - - - This is always treated as true when the control is NOT owner drawn. - - When this is false and the control is owner drawn, - ObjectListView will try to calculate the width of the cell's - actual contents, and then size the editing control to be just the right width. If this is true, - the whole width of the cell will be used, regardless of the cell's contents. - - Each column can have a different value for property. This value from the control is only - used when a column is not specified one way or another. - Regardless of this setting, developers can specify the exact size of the editing control - by listening for the CellEditStarting event. - - - - - Gets or sets the engine that will handle key presses during a cell edit operation. - Settings this to null will reset it to default value. - - - - - 获取当前用于编辑单元格的控件。 - - This will obviously be null if no cell is being edited. - - - - 获取或设置编辑控件左边缘或右边缘的单元格时Tab键的行为。 - 如果为False(默认值)，则按Tab键将换行到同一行的另一侧。 - 如果为True，编辑最右边的单元格时按Tab键将前进到下一行， - 编辑最左边的单元格时按Shift-Tab组合键将更改为上一行。 - - - - - 获取或设置编辑单元格时Enter键的行为。 - 如果为False(默认值)，则按Enter键将简单地完成编辑操作。 - 如果为True，则Enter将完成编辑操作，并在当前单元格下方的单元格上启动新的编辑操作，在位于底部单元格时换行到下一行的顶部。 - - - - - 获取显示单元格提示的工具提示控件 - - - - - 获取或设置该项的每个单元格周围将留空的像素数。单元格内容在考虑填充后对齐。 - - - Each value of the given rectangle will be treated as an inset from - the corresponding side. The width of the rectangle is the padding for the - right cell edge. The height of the rectangle is the padding for the bottom - cell edge. - - - So, this.olv1.CellPadding = new Rectangle(1, 2, 3, 4); will leave one pixel - of space to the left of the cell, 2 pixels at the top, 3 pixels of space - on the right edge, and 4 pixels of space at the bottom of each cell. - - - This setting only takes effect when the control is owner drawn. - - This setting only affects the contents of the cell. The background is - not affected. - If you set this to a foolish value, your control will appear to be empty. - - - - - 获取或设置默认情况下单元格垂直对齐的方式。 - - This setting only takes effect when the control is owner drawn. It will only be noticable - when RowHeight has been set such that there is some vertical space in each row. - - - - Should this list show checkboxes? - - - - - 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL - - - - - Get or set the collection of model objects that are checked. - When setting this property, any row whose model object isn't - in the given collection will be unchecked. Setting to null is - equivilent to unchecking all. - - - - This property returns a simple collection. Changes made to the returned - collection do NOT affect the list. This is different to the behaviour of - CheckedIndicies collection. - - - .NET's CheckedItems property is not helpful. It is just a short-hand for - iterating through the list looking for items that are checked. - - - The performance of the get method is O(n), where n is the number of items - in the control. The performance of the set method is - O(n + m) where m is the number of objects being checked. Be careful on long lists. - - - - - - 获取或设置可枚举对象中的选中对象。 - - - Useful for checking all objects in the list. - - - this.olv1.CheckedObjectsEnumerable = this.olv1.Objects; - - - - - Gets Columns for this list. We hide the original so we can associate - a specialised editor with it. - - - - - 获取/设置当列表切换到TileView(平铺视图)时应使用的列的列表。 - - - - - 按向用户显示的顺序返回可见列 - - - - - 获取显示列表的控件区域，减去任何标题控件 - - - - - 获取或设置当用户按Ctrl+C组合键时是否应将选定行复制到剪贴板 - - - - - 获取或设置按Ctrl+C键复制到剪贴板功能是否应使用安装的DragSource创建放置到剪贴板上的数据对象。 - - This is normally what is desired, unless a custom DragSource is installed - that does some very specialized drag-drop behaviour. - - - - Gets the list of decorations that will be drawn the ListView - - - - Do not modify the contents of this list directly. Use the AddDecoration() and RemoveDecoration() methods. - - - A decoration scrolls with the list contents. An overlay is fixed in place. - - - - - - 所有者绘制时，此渲染器将绘制未指定特定渲染器的列 - - 如果尝试将其设置为NULL，则它将恢复为HighlightTextRenende - - - - 获取用于绘制给定单元格的渲染器。 - - The row model for the row - The column to be drawn - The renderer used for drawing a cell. Must not return null. - - - - 获取或设置将应用于禁用项的样式。 - - If this is not set explicitly, will be used. - - - - 获取或设置已禁用的模型对象的列表。无法选择或激活已禁用的对象。 - - - - - 判断此给定模型对象是否已禁用 - - - - - - - 禁用给定的模型对象。禁用的对象无法选择或激活。 - - Must not be null - - - - 禁用所有给定的模型对象 - - - - - - 启用给定的模型对象，以便可以再次选择并激活它。 - - Must not be null - - - - 启用所有给定的模型对象 - - - - - - 忽略所有禁用的对象。这不会触发重绘或重建 - - - - - Gets or sets the object that controls how drags start from this control - - - - - Gets or sets the object that controls how drops are accepted and processed - by this ListView. - - - - If the given sink is an instance of SimpleDropSink, then events from the drop sink - will be automatically forwarded to the ObjectListView (which means that handlers - for those event can be configured within the IDE). - - If this is set to null, the control will not accept drops. - - - - - This registry decides what control should be used to edit what cells, based - on the type of the value in the cell. - - - All instances of ObjectListView share the same editor registry. - - - - 获取或设置在此列表视图中没有项时应显示的文本。 - - If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, - this property does nothing - - - - 获取或设置绘制列表空消息时应使用的字体 - - If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, - this property does nothing - - - - 返回“列表为空”消息的字体或合理的默认值 - - - - - Gets or sets the overlay responsible for drawing the List Empty msg. - - - - - 获取在筛选中幸存下来的对象的集合。 - - - - This collection is the result of filtering the current list of objects. - It is not a snapshot of the filtered list that was last used to build the control. - - - Normal warnings apply when using this with virtual lists. It will work, but it - may take a while. - - - - - - 获取或设置将用于生成筛选器菜单的策略对象 - - 如果为NULL，则不会生成筛选器菜单。 - - - - 获取或设置具有键盘焦点的行 - - - - Setting an object to be focused does *not* select it. If you want to select and focus a row, - use . - - - This property is not generally used and is only useful in specialized situations. - - - - - - 隐藏Groups集合，使其在“属性”网格中不可见。 - - - - - 获取或设置分组使用的ImageList - - 如果未设置此选项，则分组标题将不会显示任何图像。 - - - - 获取在组为空或包含多个项目时应如何设置组标签的格式 - - - 给定的格式字符串必须有两个占位符： - - {0} - 原来的组标题 - {1} - 组中的项目数 - - - "[{0} [{1} 项]" - - - - 返回this.GroupWithItemCountFormat或合理的默认值 - - - - - 获取在组仅包含单个项目时应如何设置组标签的格式 - - - 给定的格式字符串必须有两个占位符： - - {0} - 原来的组标题 - {1} - 组中的项目数 (总是1) - - - "[{0} [{1} 项]" - - - - 获取GroupWithItemCountSingularFormat或合理的默认值 - - - - - 获取或设置此ObjectListView中的组是否应可折叠。 - - - 此特性只支持Vista或之后的系统. - - - - - 获取当前列表是否存在当列表为空时显示的文本 - - - - - 获取是否有要绘制的叠加层 - - - - - 获取ListView的列头控件 - - - - - 获取或设置列标题文本的绘制字体 - - 单个列可以通过其HeaderFormatStyle属性重写此设置。 - - - - 获取或设置将用于绘制列表视图的列标题的样式 - - - - 仅当HeaderUsesThemes为false时才使用此选项。 - - - 单个列可以通过其HeaderFormatStyle属性重写此设置。 - - - - - - 获取或设置标题的最大高度。-1表示没有最大值。 - - - - - 获取或设置标题的最小高度。-1表示没有最小值。 - - - - - 获取或设置是否严格按照操作系统的主题绘制标题。 - - - - 如果设置为true，则列头将完全由系统呈现，不需要ObjectListViews的任何特殊处理。 - 页眉中将没有图像、没有过滤器指示符、没有文字换行、没有页眉样式、没有复选框。 - - 如果将其设置为False，ObjectListView将以其认为最好的方式呈现标题。 - 如果不需要特殊功能，则ObjectListView会将渲染委托给操作系统。 - 否则，ObjectListView将根据配置设置绘制标题。 - - - 没有主题的效果会因操作系统不同而不同。至少，分类指示器不会是标准的。 - - - - - - 获取或设置列头标题中的文本是否自动换行。 - - - 将在单词之间应用换行符。过长的单词仍将被省略。 - - 与所有使列头看起来不同的设置一样，HeaderUsesThemes必须设置为false，否则操作系统将负责绘制列头，并且不允许自动换行文本。 - - - - - - 获取显示列标题提示的工具提示 - - - - - 获取鼠标当前所在行的索引。 - - - - - 获取鼠标当前所在列的索引 - - - - - 获取鼠标当前所在的项/子项的一部分 - - - - - Gets an extended indication of the part of item/subitem/group that the mouse is currently over - - - - - 获取鼠标所在的组。 - - - - - 处于“热”状态的项的索引，即在光标下方。-1表示没有项目。 - - - - - 获取和设置对游标下的行应用哪种格式 - - - - 这仅在UseHotItem为true时生效。 - - 如果样式具有叠加层，则必须对其进行设置。*之前* 将其分配给此属性。之后添加它将被忽略。 - - - - - 获取已安装的热点项样式或合理的默认值。 - - - - - 获取和设置应将哪种格式应用于超链接 - - - - - 获取和设置所选行的背景应该使用什么颜色 - - - - - 返回应用于选定行的背景颜色或合理的默认值 - - - - - 获取和设置所选行的字体应该使用什么颜色 - - - - - 返回应用于选定行的字体颜色或合理的默认值 - - - - - 使用 SelectedBackColor 代替 - - - - - 使用 SelectedBackColorOrDefault 代替 - - - - - 使用 SelectedForeColor 代替 - - - - - 使用 SelectedForeColorOrDefault 代替 - - - - - 使用 UnfocusedSelectedBackColor 代替 - - - - - 使用 UnfocusedSelectedBackColorOrDefault 代替 - - - - - 使用 UnfocusedSelectedForeColor 代替 - - - - - 使用 UnfocusedSelectedForeColorOrDefault 代替 - - - - - 获取或设置是否应将隐藏列包括在复制或拖动到其他应用程序的行的文本表示形式中。 - 如果为False(默认值)，则仅包括可见列。 - - - - - 获取或设置复制行时，列标题是否在文本中。 - 如果为False(默认值)，在文本中将不会显示列标题。 - - - - - 如果当前正在进行单元格编辑操作，则返回TRUE - - - - - 如果在开发环境中使用ObjectListView，则返回true。 - - - - - 获取当前列表是否正在筛选其内容 - - - - - 当用户在列表中键入内容时，是否应该搜索当前排序列中的值以查找匹配项？ - 如果为False，则无论排序列是什么，都将始终使用主列。 - - When this is true, the behavior is like that of ITunes. - - - - 获取或设置此控件是否将使用SimpleDropSink接收拖动 - - - - 此设置将替换任何以前的DropSink。 - - - 将其设置为true后，SimpleDropSink仍需要配置为说明它何时可以接受拖动， - 以及在拖动某些内容时应该执行什么操作。需要执行这些操作使此属性几乎毫无用处 :( - - - - - - 获取或设置此控件是否将使用SimpleDragSource来启动拖动 - - 此设置将替换之前的任何DragSource - - - - 隐藏Items集合，使其在“属性”网格中不可见。 - - - - - 当列表中的项目处于非详细视图中时，此渲染器会绘制项目。在详细信息视图中，负责个体列的呈现器。 - - - - - 获取或设置最后一次排序的列 - - 这是PrimarySortColumn的别名 - - - - 获取或设置最后一次排序的方向 - - 这是 PrimarySortOrder的别名 - - - - 获取或设置应用于整个对象列表的筛选器。 - - - 列表将立即更新以反映此筛选器。 - - - - - 获取或设置应用于列表中每个模型对象的筛选器 - - - 您可能需要考虑使用 而不是此属性， - 因为AdditionalFilter在运行时与列筛选相结合。 - 设置此属性只是替换用户可能已给出的任何列筛选器。 - - The list is updated immediately to reflect this filter. - - - - - - Gets the hit test info last time the mouse was moved. - - Useful for hot item processing. - - - - 获取或设置列表显示的组列表。 - - - 此属性与.NET Groups属性的工作方式不同，应将其视为只读属性。 - 对列表所做的更改不会反映在ListView本身中。 - 在此列表中添加或删除组是没有意义的，这样的修改不会起到任何作用。 - 要执行此类操作，必须侦听BeforeCreatingGroups或AboutToCreateGroups事件， - 并更改这些事件中的组列表。 - - - - - 获取或设置折叠的OLVGroups的集合。 - - - - - Gets or sets whether the user wants to owner draw the header control - themselves. If this is false (the default), ObjectListView will use - custom drawing to render the header, if needed. - - - If you listen for the DrawColumnHeader event, you need to set this to true, - otherwise your event handler will not be called. - - - - - 获取/设置此列表将显示的对象集合 - - - - 设置此属性后，控件的内容将立即更新。 - - 如果可能，此方法将保留所选内容。使用 if - 如果您不想保留所选内容，请执行以下操作。 - 保留选择是该代码中最慢的部分，性能为O(N)，其中n是选定的行数。 - 此方法不是线程安全的。 - 该属性确实适用于虚拟列表：设置是没有问题的，但如果您尝试获取它， - 并且列表有1000万个对象，则可能需要一些时间才能返回。 - 此集合未经过筛选。使用 只访问那些在任何已安装的筛选器中幸存下来的对象。 - - - - - 获取当前控件所有对象组成的列表 - - - - - 获取创建群集时将考虑的对象集合。 - (用于生成类似Excel的列筛选器) - - - - - 获取或设置将在ListView顶部绘制的图像 - - - - - 获取或设置将在ListView顶部绘制的文本 - - - - - 获取或设置所有覆盖图的透明度。0表示完全透明，255表示完全不透明。 - - - 这已经过时了，请在每个覆盖上使用Transparency。 - - - - - 获取将在ListView顶部绘制的覆盖列表 - - - You can add new overlays and remove overlays that you have added, but - don't mess with the overlays that you didn't create. - - - - - Gets or sets whether the ObjectListView will be owner drawn. Defaults to true. - - - - When this is true, all of ObjectListView's neat features are available. - - We have to reimplement this property, even though we just call the base - property, in order to change the [DefaultValue] to true. - - - - - - 获取或设置主复选框是否在列表重新生成和筛选操作中保持其值。 - - - - 此属性仅在未显式设置CheckStateGetter/Putter时才有用。 - 如果您使用CheckStateGetter/Putter，那么这些方法已经持久化了行的检查性。 - - 此默认值为true。如果为False，则在重新生成或筛选列表时，复选框将丢失其值。 - 如果在虚拟列表中将其设置为false，则必须安装CheckStateGetter/Putters。 - - - - - 获取或设置记住模型对象的复选框状态的字典 - - 当PersistentCheckBoxs值为TRUE时，此选项用于虚拟列表. - - - - 获取或设置最后一次排序的列 - - - - - 获取或设置最后一次排序的方向 - - - - - 获取或设置不可编辑复选框是否绘制为禁用。默认是false。 - - - 这仅在所有者描述模式(owner drawn mode)下有效。 - - - - - 以像素为单位指定控件中每行的高度。 - - 列表视图中的行高通常由字体大小和小图像列表大小决定。 - 此设置允许覆盖该计算(原因是：您仍然不能将行高设置为小于控件中使用的字体的行高)。 - 将其设置为-1表示使用正常计算方法。 - 此功能是体验功能！如果您使用此功能，您的程序可能会发生意想不到的事情。 - - - - - 获取每行有多少像素高 - - - - - 获取此控件的每页上显示多少行 - - - - - 获取/设置将用于解析排序时相等的比较的列(第二排序列)。 - - 此设置没有用户界面。它必须以编程方式设置。 - - - - 获取或设置当使用Second darySortColumn时，它将以什么顺序比较结果 - - - - - 获取或设置当用户按Ctrl+A组合键时是否应选择所有行 - - - - - 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许用户选择视图中将显示哪些列 - - 这只是SelectColumnsOnRightClickBehaviour的兼容性包装属性. - - - - 获取或设置当右键单击标题时用户如何能够选择列 - - - - - 当列选择菜单打开时，是否应在选择项目后保持打开状态？保持打开状态允许用户一次打开或关闭多个列。 - - SelectColumnsOnRightClickBehaviour设置为InlineMenu时才有效。当行为设置为SubMenu菜单时，该选项不起作用。 - - - - 获取或设置选定列 - - - - 如果TintSortColumn为true，则排序列将自动成为选定列。 - - - 色调的颜色由SelectedColumnTint控制。 - - - - - - Gets or sets the decoration that will be drawn on all selected rows - - - - - 获取或设置应该使用什么颜色来给选定的列着色 - - - 色调颜色必须是Alpha可混合的，因此如果给定的颜色是纯色(即Alpha=255)，则会将其更改为具有合理的Alpha值。 - - - - - 获取或设置当前选定行的索引。 - 获取索引时，如果没有选择任何行，或者选择了多个行，则返回-1。 - - - - - 获取或设置当前选定的ListViewItem。如果未选择任何行，或者选择了多个行，则返回NULL。 - - - - - 如果只选择了一行，则从当前选定的行获取模型对象。 - 如果未选择任何行，或选择了多个行，则返回NULL。 - 设置时，这将选择显示给定模型对象的行，并将焦点放在该行上，取消选择所有其他行。 - - - - - 从当前选定的行中获取模型对象。 - 如果未选中任何行，则返回的列表为空。 - 设置此值时，请选择显示给定模型对象的行，取消选择所有其他行。 - - - - - 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许他们选择要在列表视图上执行的常见任务 - - - - - 获取或设置当右键单击标题控件时，此ObjectListView是否像筛选菜单一样显示表格 - - - - - 获取或设置是否应按组显示其项目 - - - - - 列表视图是否应该在列标题中显示位图以显示排序方向 - - - The only reason for not wanting to have sort indicators is that, on pre-XP versions of - Windows, having sort indicators required the ListView to have a small image list, and - as soon as you give a ListView a SmallImageList, the text of column 0 is bumped 16 - pixels to the right, even if you never used an image. - - - - - 列表视图是否应该显示子项上的图像 - - - 虚拟列表必须是所有者绘制的，才能在子项上显示图像 - - - - - 此属性控制分组标签是否显示该分组项目数量 - - - 后缀的格式由GroupWithItemCountFormat/GroupWithItemCountSingularFormat属性控制 - - - - - 获取或设置控件是在所有视图中显示列标题(True)，还是仅在详细信息视图中显示列标题(False) - - - - 此属性工作不正常。JPP 2010/04/06。 - 如果它是在创建控件之前设置的，则可以正常工作。 - 但是，如果在创建控件后将其关闭，则控件将丢失其复选框(奇怪！) - - - 要在创建控件后更改此设置，事情会很复杂。 - 如果它是关闭的，而我们想要打开它，我们必须更改视图，标题就会出现。 - 如果它当前处于打开状态，而我们想要将其关闭，则必须更改视图并重新创建控制柄。 - 重新创建句柄是一个问题，因为它会使我们的复选框样式消失。 - - - 该属性不能工作在 Win XP 系统. - - - - - 重写SmallImageList属性，以便我们可以正确地隐藏其操作。 - - 如果使用RowHeight属性指定行高，则必须在设置/更改RowHeight之前完全初始化SmallImageList。 - 如果在设置行高之后将新图像添加到图像列表，则必须再次将图像列表分配给控件。像这样简单的事情会奏效的： - listView1.SmallImageList = listView1.SmallImageList; - - - - - 返回小图像列表中图像的大小或合理的默认值 - - - - - 当列表视图分组时，项是否应该按主列排序？如果为False，则项目将按分组时的同一列进行排序。 - - - - - 当列表视图分组时，一个组的末尾和下一个组的开头之间应该有多少像素 - - - - - 排序列是否应该显示轻微的色调？ - - - - - 获取或设置是否使用三态复选框？ - - - 如果为True，用户可以选择第三种状态(通常是不确定的)。 - 否则，用户在选中和取消选中之间交替单击。 - 当此设置为False时，CheckStateGetter仍可以返回不确定。 - - - - - 获取或设置列表顶部项目的索引 - - - - 此属性仅在列表视图处于详细信息视图中且不显示组时才起作用。 - - - 显示组时不起作用的原因是，当启用组时，无论滚动位置如何， - Windows msg LVM_GETTOPINDEX总是返回0。 - - - - - - 获取或设置将鼠标移到标题上是否会触发CellOver事件。 - 默认为true。 - - - 将鼠标移动到标题上之前不会触发CellOver事件，因为Header被视为单独的控件。 - 如果此行为更改导致您的应用程序出现问题，请将其设置为False。 - 如果您想知道鼠标何时在标题上移动，请将此属性设置为true(默认值)。 - - - - - 通过拖动分隔线调整列的大小时，是否应在每次鼠标移动时调整填充空格的列的大小？ - 如果为False，则释放鼠标时将更新填充栏。 - - - - 如果空间填充列位于正在调整大小的列的左侧，这看起来会很奇怪：该列的右边缘将被拖动，但由于空间填充列正在收缩，其左边缘将会移动。 - - 这是合乎逻辑的行为--只是看起来不对。 - - - 考虑到上述行为，如果空间填充列不是最右边的列，最好关闭该属性。 - - - - - 当控件没有焦点时，应该使用什么颜色作为选定行的背景 - - - - - 当控件没有焦点或合理的默认值时，返回应用于选定行的背景的颜色 - - - - - 当控件没有焦点时，应该使用什么颜色作为选定行的字体颜色。 - - - - - 当控件没有焦点或合理的默认值时，返回应用于选定行的字体颜色 - - - - - 获取或设置列表是否每隔一行提供不同的背景色？默认值为false。 - - 交替行的颜色由AlternateRowBackColor提供。 - 在.NET中，列表视图在非整行选择模式下有一个“功能”，在这种模式下，所选行不会使用正确的背景色绘制。 - - - - 是否应该为控件中的每个单元格调用FormatCell事件？ - - - 在许多情况下，不执行单元格级格式设置。 - 如果除非需要，ObjectListView不会为每个单元格触发Format Cell事件，则它的运行速度会稍快一些。 - 因此，默认情况下，它不会为每个单元格引发事件。 - - ObjectListView*确实*在每次重新生成行时引发FormatRow事件。各行可以决定是否对行中的每个单元格引发FormatCell事件。 - - - 无论此设置如何，只有当ObjectListView处于详细视图中时才会引发FormatCell事件。 - - - - - 所选行是否应使用非标准前景色和背景色绘制？ - - V2.9不再需要此属性 - - - - 获取或设置此ObjectListView是否将使用与Vista资源管理器相同的热项和选择机制。 - - - - 此属性有许多缺陷： - - 这仅适用于Vista及更高版本 - 它不能很好地与AlternateRowBackColors配合使用。 - 它不能很好地与HotItemStyles配合使用。 - 如果FullRowSelect为false，这看起来有点傻。 - 当列表是所有者绘制的时，它根本不起作用(因为所有的绘制都是由渲染器完成的)。 - 因此，它不能与TreeListView一起工作，因为它们“必须”是所有者绘制的。你仍然可以设置它，但它不会生效。 - - 但如果你一定要看起来像Vista/Win7，这是你的权限。如果这项设置搞砸了其他事情，请不要抱怨。 - - - 当此属性设置为True时，ObjectListView将不是所有者描述的。 - 这将禁用ObjectListView的许多漂亮的基于绘图的功能。 - - - - - - 获取或设置列表是否应启用筛选 - - - - - 获取或设置列表是否应将指示符放入列的标题中，以表明它正在筛选该列 - - 如果将其设置为true，HeaderUsesThemes将自动设置为false，因为我们只能在不使用主题标题时绘制筛选器指示器。 - - - - 鼠标下方的控件(复选框或按钮)是否应该被绘制为“Hot” - - - 如果为False，则当鼠标悬停在控件上时，控件的绘制方式不会有所不同。 - - 如果为False，且UseHotItem和UseHyperLinks为False，则ObjectListView可以跳过鼠标移动的某些处理。这使得鼠标移动处理几乎不使用CPU。 - - - - - - 光标下的项是否应以特殊方式设置格式？ - - - - - 获取或设置此列表视图是否应在单元格中显示超链接。 - - - - - 此控件是否应显示覆盖(Overlays) - - 覆盖(Overlays)在默认情况下是启用的，只有在它们在您的开发环境中造成问题时才需要禁用。 - - - - 是否应将此控件配置为在子项上显示复选框？ - - 如果将其设置为True，则将为该控件提供一个SmallImageList(如果它还没有一个SmallImageList)。 - 此外，如果它是一个虚拟列表，它将被设置为所有者描述的，因为虚拟列表不能在没有所有者描述的情况下绘制复选框。 - - - - 获取或设置ObjectListView是否将使用类似Vista的半透明选择机制。 - - - - 与UseExplorerTheme不同的是，这个类似Vista的方案可以在XP上运行，并且既适用于所有者描述的列表，也适用于非所有者描述的列表。 - - - 这将替换任何已安装的SelectedRowDecory。 - - - 如果您不喜欢用于选择的颜色，请忽略此属性， - 只需创建您自己的RowBorderDecory并将其分配给SelectedRowDecory， - 就像此属性设置器所做的那样。 - - - - - - 获取或设置ObjectListView是否将使用类似于Vista的半透明热行突出显示机制。 - - - - 设置此项将替换任何已安装的HotItemStyle。 - - - 如果您不喜欢热项目使用的颜色，请忽略此属性， - 只需创建您自己的HotItemStyle，填充所需的值， - 并将其分配给HotItemStyle属性，就像此属性设置器所做的那样。 - - - - - - 获取/设置此列表视图正在使用的视图样式 - - 切换到平铺(Tile)或详细信息(Details)视图会安装适合该视图的列。令人困惑的是，在平铺视图中，每列都显示为一行信息。 - - - - 此委托仅将对象的检查性作为布尔值获取。 - - 如果您永远不想担心不确定状态(这是相当常见的)，请使用此选项。 - - 这是CheckStateGetter属性的便捷包装。 - - - - - - This delegate sets the checkedness of an object as a boolean only. It must return - true or false indicating if the object was checked or not. - - Use this if you never want to worry about the - Indeterminate state (which is fairly common). - - This is a convenience wrapper around the CheckStatePutter property. - - - - - - 获取此列表视图是否能够显示组 - - - - - 获取或设置ObjectListView是否可以依赖正在引发的Application.Idle事件。 - - 在某些主机环境中(例如，在VisualStudio和Office中作为扩展运行时)，从不引发Application.Idle事件。 - 如果不会引发Idle事件，则将其设置为False，ObjectListView将自行引发这些事件。 - - - - - This delegate fetches the renderer for a particular cell. - - - - If this returns null (or is not installed), the renderer for the column will be used. - If the column renderer is null, then will be used. - - - This is called every time any cell is drawn. It must be efficient! - - - - - - This delegate is called when the list wants to show a tooltip for a particular cell. - The delegate should return the text to display, or null to use the default behavior - (which is to show the full text of truncated cell values). - - - Displaying the full text of truncated cell values only work for FullRowSelect listviews. - This is MS's behavior, not mine. Don't complain to me :) - - - - - 保存是否选中模型的属性(或字段)的名称。 - - - 该属性是可修改的。它必须具有bool(或bool？)返回类型。如果TriStateCheckBooks为真)。 - 设置此属性将替换任何已安装的CheckStateGetter或CheckStatePutter。 - 相反，稍后设置CheckStateGetter或CheckStatePutter属性将优先于此属性的行为。 - - - - - 只要ObjectListView需要知道与给定模型对象关联的行的检查状态，就会调用此委托。 - - - .NET has no support for indeterminate values, but as of v2.0, this class allows - indeterminate values. - - - - - This delegate will be called whenever the user tries to change the check state of a row. - The delegate should return the state that was actually set, which may be different - to the state given. - - - - - 此委托可用于以自定义方式对表进行排序。 - - - - 委托必须在ObjectListView上安装ListViewItemSorter。 - 安装ItemSorter会执行对ListViewItems进行排序的实际工作。 - 有关ItemSorter必须执行的操作的示例，请参见代码中的ColumnCompeller。 - - - 请勿在VirtualObjectListView上安装CustomSorter。改为重写IVirtualListDataSource的SortObjects()方法。 - - - - - - This delegate is called when the list wants to show a tooltip for a particular header. - The delegate should return the text to display, or null to use the default behavior - (which is to not show any tooltip). - - - Installing a HeaderToolTipGetter takes precedence over any text in OLVColumn.ToolTipText. - - - - - This delegate can be used to format a OLVListItem before it is added to the control. - - - The model object for the row can be found through the RowObject property of the OLVListItem object. - All subitems normally have the same style as list item, so setting the forecolor on one - subitem changes the forecolor of all subitems. - To allow subitems to have different attributes, do this: - myListViewItem.UseItemStyleForSubItems = false;. - - If UseAlternatingBackColors is true, the backcolor of the listitem will be calculated - by the control and cannot be controlled by the RowFormatter delegate. - In general, trying to use a RowFormatter - when UseAlternatingBackColors is true does not work well. - As it says in the summary, this is called before the item is added to the control. - Many properties of the OLVListItem itself are not available at that point, including: - Index, Selected, Focused, Bounds, Checked, DisplayIndex. - - - - - 将给定的模型对象添加到此控件。 - - 要显示的模型对象 - See AddObjects() for more details - - - - 将给定的模型对象集合添加到此控件。 - - 要显示的模型对象集合 - - 如果排序处于活动状态(即，如果PrimarySortColumn不为空)，则添加的对象将出现在其正确的排序位置。否则，它们将出现在列表的末尾。 - 不执行任何检查以查看是否有任何对象已在ListView中。 - 空对象将被静默忽略。 - - - - - 将列的大小调整到页眉宽度和数据的最大值。 - - - - - 设置任何自动初始化的列宽(宽度为0或-1的列将分别调整为其内容或标题的宽度)。 - - - 显然，这只会起作用一次。一旦运行，列宽将更改为其他值(不是0或-1)，因此第二次运行时不会执行任何操作。 - 若要强制所有列更改其大小，请使用 。 - - - - - 根据最后一个排序列或第一列(如果没有最后一个排序列)将视图项组织到组中 - - - - - 根据给定列将视图项组织成组 - - - - 如果AlwaysGroupByColumn属性不为Null，则列表视图项将按该列组织，并且将忽略‘Column’参数。 - - 此方法触发排序事件：BeforeSorting和AfterSorting。 - - 其值应用于排序的列。 - - - - - 根据给定列将视图项组织成组 - - 将使用哪一列进行分组 - 组将使用什么顺序 - 其值应用于排序的列。不能为空 - 列中值的排序顺序 - 当‘column’中的值相等时，请使用此列提供的值 - 次级值将如何排序 - 此方法不会触发排序事件。使用BuildGroups()执行此操作 - - - - 收集并返回影响组创建的所有变量 - - - - - - Make a list of groups that should be shown according to the given parameters - - - The list of groups to be created - This should not change the state of the control. It is possible that the - groups created will not be used. They may simply be discarded. - - - - 生成/重新生成列表中的所有列表视图项，尽可能多地保留状态 - - - - - 生成/重新生成列表中的所有列表视图项 - - If this is true, the control will try to preserve the selection, - focused item, and the scroll position (see Remarks) - - - - Use this method in situations were the contents of the list is basically the same - as previously. - - - - - - 清除此列表可能一直在使用的所有缓存信息 - - - - - Apply all required extended styles to our control. - - - - Whenever .NET code sets an extended style, it erases all other extended styles - that it doesn't use. So, we have to explicit reapply the styles that we have - added. - - - Normally, we would override CreateParms property and update - the ExStyle member, but ListView seems to ignore all ExStyles that - it doesn't already know about. Worse, when we set the LVS_EX_HEADERINALLVIEWS - value, bad things happen (the control crashes!). - - - - - - Give the listview a reasonable size of its tiles, based on the number of lines of - information that each tile is going to display. - - - - - Rebuild this list for the given view - - - - - - 移除所有对象(线程安全) - - This method can safely be called from background threads. - - - - 重置已访问其URL的内存 - - - - - 将选定行的文本和HTML表示复制到剪贴板上。 - - Be careful when using this with virtual lists. If the user has selected - 10,000,000 rows, this method will faithfully try to copy all of them to the clipboard. - From the user's point of view, your program will appear to have hung. - - - - 将给定对象的文本和HTML表示复制到剪贴板上。 - - - - - 将所有对象的文本和HTML表示复制到剪贴板上。 - - - - - 返回给定对象的html表示形式 - - - - - 取消选择列表视图中的所有行 - - - - - 返回紧跟在给定项后面的ListViewItem。 - 如果给定项为空，则返回列表中的第一个项。 - 如果给定项是最后一项，则返回NULL。 - - The item that is before the item that is returned, or null - A ListViewItem - - - - 按向用户显示的顺序返回最后一项。 - 如果控件未分组，则显示顺序与排序的列表顺序相同。 - 但如果列表是分组的，则显示顺序不同。 - - - - - - 按向用户显示的顺序返回第n项(从0开始)。 - 如果控件未分组，则显示顺序与排序的列表顺序相同。 - 但如果列表是分组的，则显示顺序不同。 - - - - - - - 返回给定listviewitem索引的显示索引。 - 如果控件未分组，则显示顺序与排序的列表顺序相同。 - 但如果列表是分组的，则显示顺序不同。 - - - - - - - 返回紧接在给定项之前出现的ListViewItem。 - 如果给定项为空，则返回列表中的最后一项。 - 如果给定项是第一项，则返回NULL。 - - The item that is before the item that is returned - A ListViewItem - - - - 在给定位置之前插入给定的对象集合 - - Where to insert the objects - The objects to be inserted - - - This operation only makes sense of non-sorted, non-grouped - lists, since any subsequent sort/group operation will rearrange - the list. - - This method only works on ObjectListViews and FastObjectListViews. - - - - - 如果选择了表示给定模型的行，则返回TRUE - - The model object to look for - Is the row selected - - - - 给定的URL是否已被访问 - - The string to be consider - Has it been visited - - - - 按给定的值增量滚动ListView。 - - Horizontal delta - Vertical delta - - - - Return a point that represents the current horizontal and vertical scroll positions - - - - - 记住给定的URL已被访问 - - The url to be remembered - This does not cause the control be redrawn - - - - 将给定的对象集合移动到给定的索引。 - - 此操作仅对未分组的ObjectListViews有意义。 - - - - - - 计算在给定点下的项目是什么？ - - - - - - - - 使用Windows控件的SUBITEMHITTEST消息执行点击测试。 - 这提供了标准ListView.HitTest()不提供的有关组点击的信息。 - - - - - - - - What is under the given point? This takes the various parts of a cell into accout, including - any custom parts that a custom renderer might use - - - - An information block about what is under the point - - - - Perform a hit test when the control is not owner drawn - - - - - - - - Perform a hit test when the control is owner drawn. This hands off responsibility - to the renderer. - - - - - - - - Pause (or unpause) all animations in the list - - true to pause, false to unpause - - - - Rebuild the columns based upon its current view and column visibility settings - - - - - 从ListView中删除给定的模型对象 - - The model to be removed - See RemoveObjects() for more details - This method is thread-safe. - - - - - 从控件中移除所有给定对象。 - - Collection of objects to be removed - - Nulls and model objects that are not in the ListView are silently ignored. - This method is thread-safe. - - - - - 选择列表视图中的所有行 - - - - - 在列表视图的右下角设置要固定的给定图像。 - 当列表视图滚动时，此图像不会滚动。 - - - - 此方法使用ListView的原生功能显示背景图像。 - 它有几个限制： - - - 它在owner drawn模式下不能很好地工作。在owner drawn绘制模式下， - 每个单元格都会绘制自身，包括覆盖背景图像的背景。 - 启用网格线时看起来不是很好，因为网格线是在图像上绘制的。 - 它在XP上完全不起作用。 - 显然，当启用交替行背景色时，效果不佳。 - - - 如果你能忍受这些限制，原生水印就相当不错了。 - 它们是真实的背景，而不是像OverlayImage使用的半透明覆盖。 - 与覆盖相比，它们也有明显的优势，因为即使在MDI应用程序中，它们也可以正常工作。 - - 设置此选项将清除所有背景图像。 - - The image to be drawn. If null, any existing image will be removed. - - - - 将给定的图像设置为ListView的背景，以便它在列表中以给定的百分比偏移量显示。 - - - 这具有与 中所述的相同限制. - 在使用该方法之前，请确保了解这些限制。 - 这非常类似于 属性， - 但标准Backround Image不能正确处理具有透明区域的图像--它将透明区域呈现为黑色。这种方法没有这个问题。 - 设置此选项将清除所有背景水印。 - - The image to be drawn. If null, any existing image will be removed. - The horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. - The vertical percentage where the image will be placed. - - - - 将给定图像设置为ListView的平铺背景。 - - - 这具有与 和 相同的限制. - 在使用该方法之前，请确保了解这些限制。 - - 要绘制的图像。如果为null，则将删除所有现有图像。 - - - - 设置将在此列表视图中显示的对象集合。 - - 可以从后台线程安全地调用此方法。 - 该列表将立即更新 - The objects to be displayed - - - - 设置将在此列表视图中显示的对象集合。 - - 可以从后台线程安全地调用此方法. - 该列表将立即更新 - The objects to be displayed - 是否应尽可能保留列表的状态。 - - - - 将给定的模型对象更新到ListView中。 - 如果该模型尚不存在，则会添加该模型。 - - The model to be updated - - - See for more details - - 此方法是线程安全的。 - 此方法将导致重新排序列表。 - 此方法仅适用于ObjectListViews和FastObjectListViews。 - - - - - 更新与给定对象相等的预先存在的模型。 - 如果控件中不存在任何模型，则会添加它们。 - - Collection of objects to be updated/added - - 此方法将导致重新排序列表。 - null值将被静默忽略。 - 此方法是线程安全的。 - 此方法仅适用于ObjectListViews和FastObjectListViews。 - - - - - 更改当前模型对象上对INotifyPropertyChanged事件的任何订阅， - 以便我们不再侦听旧模型上的事件，而侦听给定集合上的事件。 - - This does nothing if UseNotifyPropertyChanged is false. - - - - - 获取或设置ObjectListView是否应订阅它给定的模型对象上的INotifyPropertyChanged事件。 - - - - 这应该在调用SetObjects()之前设置。如果将其设置为False，ObjectListView将取消订阅所有当前模型对象。 - - 如果在虚拟列表上将其设置为true，ObjectListView将遍历列表中尝试订阅更改通知的所有对象。 - 如果您的虚拟列表中有10,000,000个项目，这可能需要一些时间。 - - - - - Subscribe to INotifyPropertyChanges on the given collection of objects. - - - - - - Unsubscribe from INotifyPropertyChanges on the given collection of objects. - If the given collection is null, unsubscribe from all current subscriptions - - - - - - Return a byte array that represents the current state of the ObjectListView, such - that the state can be restored by RestoreState() - - - The state of an ObjectListView includes the attributes that the user can modify: - - current view (i.e. Details, Tile, Large Icon...) - sort column and direction - column order - column widths - column visibility - - - - It does not include selection or the scroll position. - - - A byte array representing the state of the ObjectListView - - - - Restore the state of the control from the given string, which must have been - produced by SaveState() - - A byte array returned from SaveState() - Returns true if the state was restored - - - - Instances of this class are used to store the state of an ObjectListView. - - - - - The application is idle. Trigger a SelectionChanged event. - - - - - - - The application is idle. Handle the column resizing event. - - - - - - - Handle the BeginScroll listview notification - - - True if the event was completely handled - - - - Handle the EndScroll listview notification - - - True if the event was completely handled - - - - Handle the LinkClick listview notification - - - True if the event was completely handled - - - - The cell tooltip control wants information about the tool tip that it should show. - - - - - - - Allow the HeaderControl to call back into HandleHeaderToolTipShowing without making that method public - - - - - - - The header tooltip control wants information about the tool tip that it should show. - - - - - - - Event handler for the column click event - - - - - Override the basic message pump for this control - - - - - - Handle the search for item m if possible. - - The m to be processed - bool to indicate if the msg has been handled - - - - The user wants to see the context menu. - - The windows m - A bool indicating if this m has been handled - - We want to ignore context menu requests that are triggered by right clicks on the header - - - - - Handle the Custom draw series of notifications - - The message - True if the message has been handled - - - - Handle the underlying control being destroyed - - - - - - - Handle the search for item m if possible. - - The m to be processed - bool to indicate if the msg has been handled - - - - Find the first row after the given start in which the text value in the - comparison column begins with the given text. The comparison column is column 0, - unless IsSearchOnSortColumn is true, in which case the current sort column is used. - - The text to be prefix matched - The index of the first row to consider - Which direction should be searched? - The index of the first row that matched, or -1 - The text comparison is a case-insensitive, prefix match. The search will - search the every row until a match is found, wrapping at the end if needed. - - - - Find the first row in the given range of rows that prefix matches the string value of the given column. - - - - - - The index of the matched row, or -1 - - - - Handle the Group Info series of notifications - - The message - True if the message has been handled - - - - Handle a key down message - - - True if the msg has been handled - - - - Toggle the checkedness of the selected rows - - - - Actually, this doesn't actually toggle all rows. It toggles the first row, and - all other rows get the check state of that first row. This is actually a much - more useful behaviour. - - - If no rows are selected, this method does nothing. - - - - - - Catch the Left Button down event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle a left mouse down at the given hit test location - - Subclasses can override this to do something unique - - True if the message has been handled - - - - Catch the Left Button up event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Trigger a GroupExpandCollapse event and return true if the action was cancelled - - - - - - - Catch the Right Button down event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle a left mouse down at the given hit test location - - Subclasses can override this to do something unique - - True if the message has been handled - - - - Catch the Left Button double click event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle a mouse double click at the given hit test location - - Subclasses can override this to do something unique - - True if the message has been handled - - - - Catch the right Button double click event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle a right mouse double click at the given hit test location - - Subclasses can override this to do something unique - - True if the message has been handled - - - - Catch the MouseMove event. - - The m to be processed - bool to indicate if the msg has been handled - - - - Handle notifications that have been reflected back from the parent window - - The m to be processed - bool to indicate if the msg has been handled - - - - In the notification messages, we handle attempts to change the width of our columns - - The m to be processed - bool to indicate if the msg has been handled - - - - Create a ToolTipControl to manage the tooltip control used by the listview control - - - - - Update the handle used by our cell tooltip to be the tooltip used by - the underlying Windows listview control. - - - - - Handle the WM_PAINT event - - - Return true if the msg has been handled and nothing further should be done - - - - Perform any steps needed before painting the control - - - - - Perform any steps needed after painting the control - - - - - Handle the window position changing. - - The m to be processed - bool to indicate if the msg has been handled - - - - The user has right clicked on the column headers. Do whatever is required - - Return true if this event has been handle - - - - Show a menu that is appropriate when the given column header is clicked. - - The index of the header that was clicked. This - can be -1, indicating that the header was clicked outside of a column - Where should the menu be shown - True if a menu was displayed - - - - Create the menu that should be displayed when the user right clicks - on the given column header. - - Index of the column that was right clicked. - This can be negative, which indicates a click outside of any header. - The toolstrip that should be displayed - - - - The user has right clicked on the column headers. Do whatever is required - - Return true if this event has been handle - - - - Show a popup menu at the given point which will allow the user to choose which columns - are visible on this listview - - Where should the menu be placed - - - - Show a popup menu at the given point which will allow the user to choose which columns - are visible on this listview - - - Where should the menu be placed - - - - 获取或设置要用于升序排序命令的文本 - - - - - 获取或设置要用于降序排序命令的文本 - - - - - 获取或设置要用于分组命令的文本 - - - - - 获取或设置要用于锁定分组命令的文本 - - - - - 获取或设置要用于不锁定分组命令的文本 - - - - - 获取或设置要用于关闭分组命令的文本 - - - - - 获取或设置要用于不排序命令的文本 - - - - - 获取或设置要用于列描述的文本 - - - - - 获取或设置要用于选择列描述的文本 - - - - - Gets or sets the image that will be place next to the Sort Ascending command - - - - - Gets or sets the image that will be placed next to the Sort Descending command - - - - - Append the column selection menu items to the given menu strip. - - The menu to which the items will be added. - - Return the menu to which the items were added - - - - Append the column selection menu items to the given menu strip. - - The menu to which the items will be added. - Return the menu to which the items were added - - - - Create the menu items that will allow columns to be choosen and add them to the - given collection - - - - - - Create a Filtering menu - - - - - - - - Override the OnColumnReordered method to do what we want - - - - - - When the column widths are changing, resize the space filling columns - - - - - - - When the column widths change, resize the space filling columns - - - - - - - When the size of the control changes, we have to resize our space filling columns. - - - - - - - Resize our space filling columns so they fill any unoccupied width in the control - - - - - Resize our space filling columns so they fill any unoccupied width in the control - - - - - Check all rows - - - - - Check the checkbox in the given column header - - If the given columns header check box is linked to the cell check boxes, - then checkboxes in all cells will also be checked. - - - - - Mark the checkbox in the given column header as having an indeterminate value - - - - - - Mark the given object as indeterminate check state - - The model object to be marked indeterminate - - - - Mark the given object as checked in the list - - The model object to be checked - - - - Mark the given objects as checked in the list - - The model object to be checked - - - - Put a check into the check box at the given cell - - - - - - - Put an indeterminate check into the check box at the given cell - - - - - - - Return true of the given object is checked - - The model object whose checkedness is returned - Is the given object checked? - If the given object is not in the list, this method returns false. - - - - Return true of the given object is indeterminately checked - - The model object whose checkedness is returned - Is the given object indeterminately checked? - If the given object is not in the list, this method returns false. - - - - Is there a check at the check box at the given cell - - - - - - - Get the checkedness of an object from the model. Returning null means the - model does not know and the value from the control will be used. - - - - - - - Record the change of checkstate for the given object in the model. - This does not update the UI -- only the model - - - - The check state that was recorded and that should be used to update - the control. - - - - Change the check state of the given object to be the given state. - - - If the given model object isn't in the list, we still try to remember - its state, in case it is referenced in the future. - - - True if the checkedness of the model changed - - - - Toggle the checkedness of the given object. A checked object becomes - unchecked; an unchecked or indeterminate object becomes checked. - If the list has tristate checkboxes, the order is: - unchecked -> checked -> indeterminate -> unchecked ... - - The model object to be checked - - - - Toggle the checkbox in the header of the given column - - Obviously, this is only useful if the column actually has a header checkbox. - - - - - Toggle the check at the check box of the given cell - - - - - - - Uncheck all rows - - - - - Mark the given object as unchecked in the list - - The model object to be unchecked - - - - Mark the given objects as unchecked in the list - - The model object to be checked - - - - Uncheck the checkbox in the given column header - - - - - - Uncheck the check at the given cell - - - - - - - 返回给定索引处的列 - - Index of the column to be returned - An OLVColumn - - - - 返回给定标题处的列,如果有多个符合要求的标题,则默认只返回第一个 - - 要返回的列的名称 - An OLVColumn - - - - 返回给定视图可见的列的集合。只有Tile和Details有列；所有其他视图都有0列。 - - 正在为哪个视图计算列？ - A list of columns - - - - 返回列表中的项目数 - - 列表中的项目数 - 如果安装了筛选器，这将返回与筛选器匹配的项目数。 - - - - 返回给定索引处的项 - - Index of the item to be returned - An OLVListItem - - - - 返回给定索引处的模型对象 - - Index of the model object to be returned - A model object - - - - 找出在给定的坐标下的行和列 - X 坐标 - Y 坐标 - 给定点下的列项 - 在给定坐标点下的行项。可以为null。 - - - - 返回给定索引/列的子项 - - Index of the item to be returned - Index of the subitem to be returned - An OLVListSubItem - - - - 滚动列表视图，使给定组位于顶部。 - - The group to be revealed - - 如果该组可见，如果可能，列表仍将滚动以将该组移至顶部。 - - 这只在列表显示分组时才有效(显然)。 - 这在虚拟列表上不起作用，因为虚拟列表不使用ListViewGroups进行分组。使用 代替. - - - - - 使给定的模型对象可见 - - The model object to be revealed - - - - 返回选定行的模型对象，如果没有选择或有多个选择，则返回null - - Model object or null - - - - 返回选定行的模型对象，如果没有选择，则返回空集合 - - ArrayList - - - - 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL - - Model object or null - 使用 CheckedObject 属性代替本方法 - - - - 获取选中的模型对象的集合。 - - 使用 CheckedObjects 属性代替本方法 - - - - 在列表视图中查找给定的模型对象并返回其索引 - - The model object to be found - The index of the object. -1 means the object was not present - - - - Rebuild the given ListViewItem with the data from its associated model. - - This method does not resort or regroup the view. It simply updates - the displayed data of the given item - - - - Rebuild the data on the row that is showing the given object. - - - - This method does not resort or regroup the view. - - - The given object is *not* used as the source of data for the rebuild. - It is only used to locate the matching model in the collection, - then that matching model is used as the data source. This distinction is - only important in model classes that have overridden the Equals() method. - - - If you want the given model object to replace the pre-existing model, - use . - - - - - - Update the rows that are showing the given objects - - - This method does not resort or regroup the view. - This method can safely be called from background threads. - - - - - 更新选定的行 - - This method does not resort or regroup the view. - - - - 除任何当前选择外，还选择显示给定模型对象的行。 - - The object to be selected - Use the property to deselect all other rows - - - - 除任何当前选择外，还选择显示给定模型对象的行。 - - The object to be selected - 对象是否也应该被聚焦 - Use the property to deselect all other rows - - - - 选择显示任意给定模型对象的行。取消选择所有其他行。 - - A collection of model objects - - - - 获取或设置是否冻结列表视图。当列表视图被冻结时，它不会自我更新。 - - Frozen属性与Freeze()/UnFreeze()方法类似， - 不同之处在于将Frozen属性设置为False会立即解冻控件， - 而不管有多少未完成的Freeze()调用。 - objectListView1.Frozen = false; // unfreeze the control now! - - - - - 冻结列表视图，使其不再自我更新。 - - Freeze()/Unfreeze() calls nest correctly - - - - 解冻列表视图。如果此调用是最外层的unFreeze()，则将重新构建listview的内容。 - - Freeze()/Unfreeze() calls nest correctly - - - - 在冻结列表视图时执行所需的实际工作 - - - - - 解冻列表视图时执行所需的实际工作 - - - - - 如果选择事件当前挂起，则返回TRUE。在挂起选择事件时，不会引发SelectedIndexChanged或SelectionChanged事件。 - - - - - Suspend selection events until a matching ResumeSelectionEvents() - is called. - - Calls to this method nest correctly. Every call to SuspendSelectionEvents() - must have a matching ResumeSelectionEvents(). - - - - Resume raising selection events. - - - - - Returns a disposable that will disable selection events - during a using() block. - - - - - - Implementation only class that suspends and resumes selection - events on instance creation and disposal. - - - - - 按最后一个排序列和顺序对项目进行排序 - - - - - 按给定列中的值和上次排序顺序对列表视图中的项进行排序 - - 其值将用于排序的列的名称 - - - - 按给定列中的值和上次排序顺序对列表视图中的项进行排序 - - 其值将用于排序的列的索引 - - - - 按给定列中的值和上次排序顺序对列表视图中的项进行排序 - - 其值将用于排序的列 - - - - 按给定列中的值和上次排序顺序对列表视图中的项进行排序 - - The column whose values will be used for the sorting. - If null, the first column will be used. - The ordering to be used for sorting. If this is None, - this.Sorting and then SortOrder.Ascending will be used - If ShowGroups is true, the rows will be grouped by the given column. - If AlwaysGroupsByColumn is not null, the rows will be grouped by that column, - and the rows within each group will be sorted by the given column. - - - - Put a sort indicator next to the text of the sort column - - - - - Put a sort indicator next to the text of the given given column - - The column to be marked - The sort order in effect on that column - - - - The name of the image used when a column is sorted ascending - - This image is only used on pre-XP systems. System images are used for XP and later - - - - The name of the image used when a column is sorted descending - - This image is only used on pre-XP systems. System images are used for XP and later - - - - If the sort indicator images don't already exist, this method will make and install them - - - - - Remove any sorting and revert to the given order of the model objects - - - - - Do the actual work of creating the given list of groups - - - - - - For some reason, UseItemStyleForSubItems doesn't work for the colors - when owner drawing the list, so we have to specifically give each subitem - the desired colors - - The item whose subitems are to be corrected - Cells drawn via BaseRenderer don't need this, but it is needed - when an owner drawn cell uses DrawDefault=true - - - - Fill in the given OLVListItem with values of the given row - - the OLVListItem that is to be stuff with values - the model object from which values will be taken - - - - Make sure the ListView has the extended style that says to display subitem images. - - This method must be called after any .NET call that update the extended styles - since they seem to erase this setting. - - - - Convert the given image selector to an index into our image list. - Return -1 if that's not possible - - - Index of the image in the imageList, or -1 - - - - Return the tooltip that should be shown when the mouse is hovered over the given column - - The column index whose tool tip is to be fetched - A string or null if no tool tip is to be shown - - - - 返回当鼠标悬停在给定单元格上时应显示的工具提示 - - The column index whose tool tip is to be fetched - The row index whose tool tip is to be fetched - A string or null if no tool tip is to be shown - - - - 返回显示给定模型对象的OLVListItem - - The modelObject whose item is to be found - The OLVListItem that displays the model, or null - This method has O(n) performance. - - - - Do the work required after the items in a listview have been created - - - - - Do the work required after one item in a listview have been created - - - - - 准备列表视图以显示交替的行背景色 - - We cannot rely on lvi.Index in this method. - In a straight list, lvi.Index is the display index, and can be used to determine - whether the row should be colored. But when organised by groups, lvi.Index is not - useable because it still refers to the position in the overall list, not the display order. - - - - - Setup all subitem images on all rows - - - - - 告诉基础列表控件针对子项显示哪些图像 - - the index at which the item occurs - the item whose subitems are to be set - - - - Tell the underlying list control which images to show against the subitems - - the index at which the item occurs - the item whose subitems are to be set - will existing images be cleared if no new image is provided? - - - - Set the subitem image natively - - - - - - - - - Take ownership of the 'objects' collection. This separats our collection from the source. - - - - This method - separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject - calls will modify our collection and not the original colleciton. - - - This method has the intentional side-effect of converting our list of objects to an ArrayList. - - - - - - 触发给定项目的FormatRow和可能的FormatCell事件 - - - - - - - - 触发给定项目的FormatCell事件 - - - - - - - - Make the list forget everything -- all rows and all columns - - Use if you want to remove just the rows. - - - - Update our externally visible image list so it holds the same images as our shadow list, but sized correctly - - - - - Return a copy of the given source image list, where each image has been resized to be height x height in size. - If source is null, an empty image list of the given size is returned - - Height and width of the new images - Height and width of the new images - Source of the images (can be null) - A new image list - - - - Return a bitmap of the given height x height, which shows the given image, centred. - - Height and width of new bitmap - Height and width of new bitmap - Image to be centred - The background color - A new bitmap - - - - Initialize the state image list with the required checkbox images - - - - - The name of the image used when a check box is checked - - - - - The name of the image used when a check box is unchecked - - - - - The name of the image used when a check box is Indeterminate - - - - - Setup this control so it can display check boxes on subitems - (or primary checkboxes in virtual mode) - - This gives the ListView a small image list, if it doesn't already have one. - - - - Make sure the small image list for this control has checkbox images - (used for sub-item checkboxes). - - - - This gives the ListView a small image list, if it doesn't already have one. - - - ObjectListView has to manage checkboxes on subitems separate from the checkboxes on each row. - The underlying ListView knows about the per-row checkboxes, and to make them work, OLV has to - correctly configure the StateImageList. However, the ListView cannot do checkboxes in subitems, - so ObjectListView has to handle them in a differnt fashion. So, per-row checkboxes are controlled - by images in the StateImageList, but per-cell checkboxes are handled by images in the SmallImageList. - - - - - - Owner draw the column header - - - - - - Owner draw the item - - - - - - Owner draw a single subitem - - - - - - We need the click count in the mouse up event, but that is always 1. - So we have to remember the click count from the preceding mouse down event. - - - - - - When the mouse leaves the control, remove any hot item highlighting - - - - - - When the mouse moves, we might need to change the hot item. - - - - - - Check to see if we need to start editing a cell - - - - - - Tell the world that a hyperlink was clicked and if the event isn't handled, - do the default processing. - - - - - - Do the default processing for a hyperlink clicked event, which - is to try and open the url. - - - - - - The user right clicked on the control - - - - - - This method is called every time a row is selected or deselected. This can be - a pain if the user shift-clicks 100 rows. We override this method so we can - trigger one event for any number of select/deselects that come from one user action - - - - - - Called when the handle of the underlying control is created - - - - - - This method is called after the control has been fully created. - - - - - Should we start editing the cell in response to the given mouse button event? - - - - - - - Handle a key press on this control. We specifically look for F2 which edits the primary column, - or a Tab character during an edit operation, which tries to start editing on the next (or previous) cell. - - - - - - - Start an editing operation on the first editable column of the given model. - - - - - If the model doesn't exist, or there are no editable columns, this method - will do nothing. - - This will start an edit operation regardless of CellActivationMode. - - - - - - Begin an edit operation on the given cell. - - This performs various sanity checks and passes off the real work to StartCellEdit(). - The row to be edited - The index of the cell to be edited - - - - Really start an edit operation on a given cell. The parameters are assumed to be sane. - - The row to be edited - The index of the cell to be edited - - - - Calculate the bounds of the edit control for the given item/column - - - - - - - - - Calculate the bounds of the edit control for the given item/column, when the listview - is being owner drawn. - - - - - - A rectangle that is the bounds of the cell editor - - - - Calculate the bounds of the edit control for the given item/column, when the listview - is not being owner drawn. - - - - - - A rectangle that is the bounds of the cell editor - - - - Try to give the given value to the provided control. Fall back to assigning a string - if the value assignment fails. - - A control - The value to be given to the control - The string to be given if the value doesn't work - - - - Setup the given control to be a cell editor - - - - - Return the value that the given control is showing - - - - - - - Called when the cell editor could be about to lose focus. Time to commit the change - - - - - - - Return the bounds of the given cell - - The row to be edited - The index of the cell to be edited - A Rectangle - - - - Return the bounds of the given cell only until the edge of the current text - - The row to be edited - The index of the cell to be edited - A Rectangle - - - - Calculate the visible bounds of the given column. The column's bottom edge is - either the bottom of the last row or the bottom of the control. - - The bounds of the control itself - The column - A Rectangle - This returns an empty rectnage if the control isn't in Details mode, - OR has doesn't have any rows, OR if the given column is hidden. - - - - Return a control that can be used to edit the value of the given cell. - - The row to be edited - The index of the cell to be edited - A Control to edit the given cell - - - - Get the first non-null value of the given column. - At most 1000 rows will be considered. - - - The first non-null value, or null if no non-null values were found - - - - Return a TextBox that can be used as a default cell editor. - - What column does the cell belong to? - - - - - Configure the given text box to autocomplete unique values - from the given column. At most 1000 rows will be considered. - - The textbox to configure - The column used to calculate values - - - - Configure the given text box to autocomplete unique values - from the given column. At most 1000 rows will be considered. - - The textbox to configure - The column used to calculate values - Consider only this many rows - - - - Stop editing a cell and throw away any changes. - - - - - If a cell edit is in progress, finish the edit. - - Returns false if the finishing process was cancelled - (i.e. the cell editor is still on screen) - This method does not guarantee that the editing will finish. The validation - process can cause the finishing to be aborted. Developers should check the return value - or use IsCellEditing property after calling this method to see if the user is still - editing a cell. - - - - If a cell edit is in progress, finish the edit. - - Returns false if the finishing process was cancelled - (i.e. the cell editor is still on screen) - This method does not guarantee that the editing will finish. The validation - process can cause the finishing to be aborted. Developers should check the return value - or use IsCellEditing property after calling this method to see if the user is still - editing a cell. - True if it is likely that another cell is going to be - edited immediately after this cell finishes editing - - - - Finish the cell edit operation, writing changed data back to the model object - - This method does not trigger a Validating event, so it always finishes - the cell edit. - - - - Finish the cell edit operation, writing changed data back to the model object - - This method does not trigger a Validating event, so it always finishes - the cell edit. - True if it is likely that another cell is going to be - edited immediately after this cell finishes editing - - - - Remove all trace of any existing cell edit operation - - True if it is likely that another cell is going to be - edited immediately after this cell finishes editing - True if the cell editor should be disposed - - - - Force the hot item to be recalculated - - - - - Force the hot item to be recalculated - - - - - The mouse has moved to the given pt. See if the hot item needs to be updated - - Where is the mouse? - This is the main entry point for hot item handling - - - - The mouse has moved to the given pt. See if the hot item needs to be updated - - - This is the main entry point for hot item handling - - - - Update the given row using the current hot item information - - - - - - Update the given row using the given hot item information - - - - - - - - - Apply a style to the given row - - - - - - - Apply a style to a cell - - - - - - - - Remove hot item styling from the given row - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Add the given decoration to those on this list and make it appear - - The decoration - - A decoration scrolls with the listview. An overlay stays fixed in place. - - - - - Add the given overlay to those on this list and make it appear - - The overlay - - - - Draw all the decorations - - A Graphics - The items that were redrawn and whose decorations should also be redrawn - - - - Is the given decoration shown on this list - - The overlay - - - - Is the given overlay shown on this list? - - The overlay - - - - Hide any overlays. - - - This is only a temporary hiding -- the overlays will be shown - the next time the ObjectListView redraws. - - - - - Create and configure the empty list msg overlay - - - - - Initialize the standard image and text overlays - - - - - Make sure that any overlays are visible. - - - - - Refresh the display of the overlays - - - - - Refresh the display of just one overlays - - - - - Remove the given decoration from this list - - The decoration to remove - - - - Remove the given overlay to those on this list - - The overlay - - - - 创建一个筛选器，该筛选器将执行当前安装在可见列上的所有筛选。 - - - - - Do the actual work of filtering - - - - - - - - - 删除所有列筛选。 - - - - - 根据每列中定义的值筛选更新此ObjectListView的筛选 - - - - - When some setting related to filtering changes, this method is called. - - - - - 使用当前安装的模型过滤器更新所有渲染器 - - - - - 获取给定模型的复选框状态。 - - The model - 模型的复选框状态。默认为未选中。 - - - - 设置给定模型对象的复选框状态 - - The model to be remembered - The model's checkedness - The state given to the method - - - - 忽略任何持久复选框状态 - - - - - The callbacks for CellEditing events - - this - We could replace this with EventHandler<CellEditEventArgs> but that would break all - cell editing event code from v1.x. - - - - - A TreeListView combines an expandable tree structure with list view columns. - - - To support tree operations, two delegates must be provided: - - - - CanExpandGetter - - - This delegate must accept a model object and return a boolean indicating - if that model should be expandable. - - - - - ChildrenGetter - - - This delegate must accept a model object and return an IEnumerable of model - objects that will be displayed as children of the parent model. This delegate will only be called - for a model object if the CanExpandGetter has already returned true for that model. - - - - - ParentGetter - - - This delegate must accept a model object and return the parent model. - This delegate will only be called when HierarchicalCheckboxes is true OR when Reveal() is called. - - - - - The top level branches of the tree are set via the Roots property. SetObjects(), AddObjects() - and RemoveObjects() are interpreted as operations on this collection of roots. - - - To add new children to an existing branch, make changes to your model objects and then - call RefreshObject() on the parent. - - The tree must be a directed acyclic graph -- no cycles are allowed. Put more mundanely, - each model object must appear only once in the tree. If the same model object appears in two - places in the tree, the control will become confused. - - - - - This event is triggered when user input requests the expansion of a list item. - - - - - This event is triggered when user input requests the collapse of a list item. - - - - - This event is triggered after the expansion of a list item due to user input. - - - - - This event is triggered after the collapse of a list item due to user input. - - - - - Trigger the expanding event - - - - - - Trigger the collapsing event - - - - - - Trigger the expanded event - - - - - - Trigger the collapsed event - - - - - - This class handles drawing the tree structure of the primary column. - - - - - Create a TreeRenderer - - - - - Should the renderer draw glyphs at the expansion points? - - The expansion points will still function to expand/collapse even if this is false. - - - - Should the renderer draw lines connecting siblings? - - - - - Return the pen that will be used to draw the lines between branches - - - - - Should the renderer draw triangles as the expansion glyphs? - - - This looks best with ShowLines = false - - - - - Return the branch that the renderer is currently drawing. - - - - - Return the TreeListView for which the renderer is being used. - - - - - How many pixels will be reserved for each level of indentation? - - - - - The real work of drawing the tree is done in this method - - - - - - - Draw the expansion indicator - - - - - - - - Gets whether or not we should render using styles - - - - - Draw the expansion indicator using styles - - - - - - - - Is the mouse over a checkbox in this cell? - - - - - Draw the expansion indicator without using styles - - - - - - - - Draw the lines of the tree - - - - - - - - - - Do the hit test - - - - - - - - - Calculate the edit rect - - - - - - - - - - - Make a default TreeListView - - - - - This is the delegate that will be used to decide if a model object can be expanded. - - - - This is called *often* -- on every mouse move when required. It must be fast. - Don't do database lookups, linear searches, or pi calculations. Just return the - value of a property. - - - When this delegate is called, the TreeListView is not in a stable state. Don't make - calls back into the control. - - - - - - Gets whether or not this listview is capable of showing groups - - - - - This is the delegate that will be used to fetch the children of a model object - - - - This delegate will only be called if the CanExpand delegate has - returned true for the model object. - - - When this delegate is called, the TreeListView is not in a stable state. Don't do anything - that will result in calls being made back into the control. - - - - - - This is the delegate that will be used to fetch the parent of a model object - - The parent of the given model, or null if the model doesn't exist or - if the model is a root - - - - Get or set the collection of model objects that are checked. - When setting this property, any row whose model object isn't - in the given collection will be unchecked. Setting to null is - equivalent to unchecking all. - - - - This property returns a simple collection. Changes made to the returned - collection do NOT affect the list. This is different to the behaviour of - CheckedIndicies collection. - - - When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. - When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus - the number of objects to be checked. - - - If the ListView is not currently showing CheckBoxes, this property does nothing. It does - not remember any check box settings made. - - - - - - Gets or sets the model objects that are expanded. - - - This can be used to expand model objects before they are seen. - - Setting this does *not* force the control to rebuild - its display. You need to call RebuildAll(true). - - - - - - Gets or sets the filter that is applied to our whole list of objects. - TreeListViews do not currently support whole list filters. - - - - - Gets or sets whether this tree list view will display hierarchical checkboxes. - Hierarchical checkboxes is when a parent's "checkedness" is calculated from - the "checkedness" of its children. If all children are checked, the parent - will be checked. If all children are unchecked, the parent will also be unchecked. - If some children are checked and others are not, the parent will be indeterminate. - - - Hierarchical checkboxes don't work with either CheckStateGetters or CheckedAspectName - (which is basically the same thing). This is because it is too expensive to build the - initial state of the control if these are installed, since the control would have to walk - *every* branch recursively since a single bottom level leaf could change the checkedness - of the top root. - - - - - Gets or sets the collection of root objects of the tree - - - - - Gets the collection of objects that will be considered when creating clusters - (which are used to generate Excel-like column filters) - - - - - After expanding a branch, should the TreeListView attempts to show as much of the - revealed descendents as possible. - - - - - The model objects that form the top level branches of the tree. - - Setting this does NOT reset the state of the control. - In particular, it does not collapse branches. - - - - Make sure that at least one column is displaying a tree. - If no columns is showing the tree, make column 0 do it. - - - - - Gets or sets the renderer that will be used to draw the tree structure. - Setting this to null resets the renderer to default. - - If a column is currently rendering the tree, the renderer - for that column will be replaced. If no column is rendering the tree, - column 0 will be given this renderer. - - - - This is the delegate that will be used to create the underlying Tree structure - that the TreeListView uses to manage the information about the tree. - - - The factory must not return null. - - Most users of TreeListView will never have to use this delegate. - - - - - - Should a wait cursor be shown when a branch is being expanded? - - When this is true, the wait cursor will be shown whilst the children of the - branch are being fetched. If the children of the branch have already been cached, - the cursor will not change. - - - - Gets the model that is used to manage the tree structure - - - Don't mess with this property unless you really know what you are doing. - If you don't already know what it's for, you don't need it. - - - - Return true if the branch at the given model is expanded - - - - - - - Collapse the subtree underneath the given model - - - - - - Collapse all subtrees within this control - - - - - Remove all items from this list - - This method can safely be called from background threads. - - - - Collapse all roots and forget everything we know about all models - - - - - Expand the subtree underneath the given model object - - - - - - Expand all the branches within this tree recursively. - - Be careful: this method could take a long time for large trees. - - - - Completely rebuild the tree structure - - If true, the control will try to preserve selection and expansion - - - - Completely rebuild the tree structure - - If not null, this list of objects will be selected after the tree is rebuilt - If not null, this collection of objects will be expanded after the tree is rebuilt - If not null, this collection of objects will be checked after the tree is rebuilt - - - - Unroll all the ancestors of the given model and make sure it is then visible. - - This works best when a ParentGetter is installed. - The object to be revealed - If true, the model will be selected and focused after being revealed - True if the object was found and revealed. False if it was not found. - - - - Update the rows that are showing the given objects - - - - - Change the check state of the given object to be the given state. - - - If the given model object isn't in the list, we still try to remember - its state, in case it is referenced in the future. - - - True if the checkedness of the model changed - - - - Toggle the expanded state of the branch at the given model object - - - - - - Return whether or not the given model can expand. - - - The given model must have already been seen in the tree - - - - Return the model object that is the parent of the given model object. - - - - The given model must have already been seen in the tree. - - - - Return the collection of model objects that are the children of the - given model as they exist in the tree at the moment. - - - - - This method returns the collection of children as the tree knows them. If the given - model has never been presented to the user (e.g. it belongs to a parent that has - never been expanded), then this method will return an empty collection. - - Because of this, if you want to traverse the whole tree, this is not the method to use. - It's better to traverse the your data model directly. - - - If the given model has not already been seen in the tree or - if it is not expandable, an empty collection will be returned. - - - - - - Delegates of this type are use to decide if the given model object can be expanded - - The model under consideration - Can the given model be expanded? - - - - Delegates of this type are used to fetch the children of the given model object - - The parent whose children should be fetched - An enumerable over the children - - - - Delegates of this type are used to fetch the parent of the given model object. - - The child whose parent should be fetched - The parent of the child or null if the child is a root - - - - Delegates of this type are used to create a new underlying Tree structure. - - The view for which the Tree is being created - A subclass of Tree - - - - Handle a left button down event - - - - - - - Create a OLVListItem for given row index - - The index of the row that is needed - An OLVListItem - This differs from the base method by also setting up the IndentCount property. - - - - Reinitialize the Tree structure - - - - - Recalculate the state of the checkboxes of all the items in the given list - and their ancestors. - - This only makes sense when HierarchicalCheckboxes is true. - - - - - Recalculate the hierarchy state of the given item and its ancestors - - This only makes sense when HierarchicalCheckboxes is true. - - - - - Yield the unique ancestors of the given collection of objects. - The order of the ancestors is guaranteed to be deeper objects first. - Roots will always be last. - - - Unique ancestors of the given objects - - - - Return all the ancestors of the given model - - - - This uses ParentGetter if possible. - - If the given model is a root OR if the model doesn't exist, the collection will be empty - - The model whose ancestors should be calculated - Return a collection of ancestors of the given model. - - - - The application is idle and a SelectionChanged event has been scheduled - - - - - - - Decide if the given key event should be handled as a normal key input to the control? - - - - - - - Handle focus being lost, including making sure that the whole control is redrawn. - - - - - - Handle the keyboard input to mimic a TreeView. - - - Was the key press handled? - - - - A Tree object represents a tree structure data model that supports both - tree and flat list operations as well as fast access to branches. - - If you create a subclass of Tree, you must install it in the TreeListView - via the TreeFactory delegate. - - - - Create a Tree - - - - - - This is the delegate that will be used to decide if a model object can be expanded. - - - - - This is the delegate that will be used to fetch the children of a model object - - This delegate will only be called if the CanExpand delegate has - returned true for the model object. - - - - Get or return the top level model objects in the tree - - - - - What tree view is this Tree the model for? - - - - - Collapse the subtree underneath the given model - - The model to be collapsed. If the model isn't in the tree, - or if it is already collapsed, the command does nothing. - The index of the model in flat list version of the tree - - - - Collapse all branches in this tree - - Nothing useful - - - - Expand the subtree underneath the given model object - - The model to be expanded. - The index of the model in flat list version of the tree - - If the model isn't in the tree, - if it cannot be expanded or if it is already expanded, the command does nothing. - - - - - Expand all branches in this tree - - Return the index of the first branch that was expanded - - - - Return the Branch object that represents the given model in the tree - - The model whose branches is to be returned - The branch that represents the given model, or null if the model - isn't in the tree. - - - - Return the number of visible descendents that are below the given model. - - The model whose descendent count is to be returned - The number of visible descendents. 0 if the model doesn't exist or is collapsed - - - - Rebuild the children of the given model, refreshing any cached information held about the given object - - - The index of the model in flat list version of the tree - - - - Is the given model expanded? - - - - - - - Remember whether or not the given model was expanded - - - - - - - Insert the children of the given branch into the given position - - The branch whose children should be inserted - The index where the children should be inserted - - - - Rebuild our flat internal list of objects. - - - - - Rebuild our reverse index that maps an object to its location - in the filteredObjectList array. - - - - - - Create a new branch within this tree - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Sort the tree on the given column and in the given order - - - - - - - - - - - - - Add the given collection of objects to the roots of this tree - - - - - - - - - - - - - Remove all of the given objects from the roots of the tree. - Any objects that is not already in the roots collection is ignored. - - - - - - Set the roots of this tree to be the given collection - - - - - - Update/replace the nth object with the given object - - - - - - - - - - - - - - Is this list currently being filtered? - - - - - Should the given model be included in this control? - - The model to consider - True if it will be included - - - - - - - - - - - - - - A Branch represents a sub-tree within a tree - - - - - Indicators for branches - - - - - FirstBranch of tree - - - - - LastChild of parent - - - - - OnlyBranch of tree - - - - - Create a Branch - - - - - - - - Get the ancestor branches of this branch, with the 'oldest' ancestor first. - - - - - Can this branch be expanded? - - - - - Gets or sets our children - - - - - Get/set the model objects that are beneath this branch - - - - - Gets a list of all the branches that survive filtering - - - - - Gets or set whether this branch is expanded - - - - - Return true if this branch is the first branch of the entire tree - - - - - Return true if this branch is the last child of its parent - - - - - Return true if this branch is the only top level branch - - - - - Gets the depth level of this branch - - - - - Gets or sets which model is represented by this branch - - - - - Return the number of descendents of this branch that are currently visible - - - - - - Gets or sets our parent branch - - - - - Gets or sets our overall tree - - - - - Is this branch currently visible? A branch is visible - if it has no parent (i.e. it's a root), or its parent - is visible and expanded. - - - - - Clear any cached information that this branch is holding - - - - - Collapse this branch - - - - - Expand this branch - - - - - Expand this branch recursively - - - - - Collapse all branches in this tree - - Nothing useful - - - - Fetch the children of this branch. - - This should only be called when CanExpand is true. - - - - Collapse the visible descendents of this branch into list of model objects - - - - - - Flatten this branch's visible descendents onto the given list. - - - The branch itself is not included in the list. - - - - Force a refresh of all children recursively - - - - - Sort the sub-branches and their descendents so they are ordered according - to the given comparer. - - The comparer that orders the branches - - - - This class sorts branches according to how their respective model objects are sorted - - - - - Create a BranchComparer - - - - - - Order the two branches - - - - - - - - Let the world know that a cell edit operation is beginning or ending - - - - - Create an event args - - - - - - - - - - Change this to true to cancel the cell editing operation. - - - During the CellEditStarting event, setting this to true will prevent the cell from being edited. - During the CellEditFinishing event, if this value is already true, this indicates that the user has - cancelled the edit operation and that the handler should perform cleanup only. Setting this to true, - will prevent the ObjectListView from trying to write the new value into the model object. - - - - - During the CellEditStarting event, this can be modified to be the control that you want - to edit the value. You must fully configure the control before returning from the event, - including its bounds and the value it is showing. - During the CellEditFinishing event, you can use this to get the value that the user - entered and commit that value to the model. Changing the control during the finishing - event has no effect. - - - - - The column of the cell that is going to be or has been edited. - - - - - The model object of the row of the cell that is going to be or has been edited. - - - - - The listview item of the cell that is going to be or has been edited. - - - - - The data value of the cell as it stands in the control. - - Only validate during Validating and Finishing events. - - - - The index of the cell that is going to be or has been edited. - - - - - The data value of the cell before the edit operation began. - - - - - The bounds of the cell that is going to be or has been edited. - - - - - Gets or sets whether the control used for editing should be auto matically disposed - when the cell edit operation finishes. Defaults to true - - If the control is expensive to create, you might want to cache it and reuse for - for various cells. If so, you don't want ObjectListView to dispose of the control automatically - - - - Event blocks for events that can be cancelled - - - - - Has this event been cancelled by the event handler? - - - - - BeforeSorting - - - - - Create BeforeSortingEventArgs - - - - - - - - - Create BeforeSortingEventArgs - - - - - - - - - - - Did the event handler already do the sorting for us? - - - - - What column will be used for grouping - - - - - How will groups be ordered - - - - - What column will be used for sorting - - - - - What order will be used for sorting. None means no sorting. - - - - - What column will be used for secondary sorting? - - - - - What order will be used for secondary sorting? - - - - - Sorting has just occurred. - - - - - Create a AfterSortingEventArgs - - - - - - - - - - - Create a AfterSortingEventArgs - - - - - - What column was used for grouping? - - - - - What ordering was used for grouping? - - - - - What column was used for sorting? - - - - - What ordering was used for sorting? - - - - - What column was used for secondary sorting? - - - - - What order was used for secondary sorting? - - - - - This event is triggered when the contents of a list have changed - and we want the world to have a chance to filter the list. - - - - - Create a FilterEventArgs - - - - - - Gets or sets what objects are being filtered - - - - - Gets or sets what objects survived the filtering - - - - - This event is triggered after the items in the list have been changed, - either through SetObjects, AddObjects or RemoveObjects. - - - - - Create a ItemsChangedEventArgs - - - - - Constructor for this event when used by a virtual list - - - - - - - Gets how many items were in the list before it changed - - - - - Gets how many objects are in the list after the change. - - - - - This event is triggered by AddObjects before any change has been made to the list. - - - - - Create an ItemsAddingEventArgs - - - - - - Create an ItemsAddingEventArgs - - - - - - - Gets or sets where the collection is going to be inserted. - - - - - Gets or sets the objects to be added to the list - - - - - This event is triggered by SetObjects before any change has been made to the list. - - - When used with a virtual list, OldObjects will always be null. - - - - - Create ItemsChangingEventArgs - - - - - - - Gets the objects that were in the list before it change. - For virtual lists, this will always be null. - - - - - Gets or sets the objects that will be in the list after it changes. - - - - - This event is triggered by RemoveObjects before any change has been made to the list. - - - - - Create an ItemsRemovingEventArgs - - - - - - Gets or sets the objects that will be removed - - - - - Triggered after the user types into a list - - - - - Create an AfterSearchingEventArgs - - - - - - - Gets the string that was actually searched for - - - - - Gets or sets whether an the event handler already handled this event - - - - - Gets the index of the row that was selected by the search. - -1 means that no row was matched - - - - - Triggered when the user types into a list - - - - - Create BeforeSearchingEventArgs - - - - - - - Gets or sets the string that will be found by the search routine - - Modifying this value does not modify the memory of what the user has typed. - When the user next presses a character, the search string will revert to what - the user has actually typed. - - - - Gets or sets the index of the first row that will be considered to matching. - - - - - The parameter block when telling the world about a cell based event - - - - - Gets the ObjectListView that is the source of the event - - - - - Gets the model object under the cell - - This is null for events triggered by the header. - - - - Gets the row index of the cell - - This is -1 for events triggered by the header. - - - - Gets the column index of the cell - - This is -1 when the view is not in details view. - - - - Gets the column of the cell - - This is null when the view is not in details view. - - - - Gets the location of the mouse at the time of the event - - - - - Gets the state of the modifier keys at the time of the event - - - - - Gets the item of the cell - - - - - Gets the subitem of the cell - - This is null when the view is not in details view and - for event triggered by the header - - - - Gets the HitTest object that determined which cell was hit - - - - - Gets or set if this event completelely handled. If it was, no further processing - will be done for it. - - - - - Tells the world that a cell was clicked - - - - - Gets or sets the number of clicks associated with this event - - - - - Tells the world that a cell was right clicked - - - - - Gets or sets the menu that should be displayed as a result of this event. - - The menu will be positioned at Location, so changing that property changes - where the menu will be displayed. - - - - Tell the world that the mouse is over a given cell - - - - - Tells the world that the frozen-ness of the ObjectListView has changed. - - - - - Make a FreezeEventArgs - - - - - - How frozen is the control? 0 means that the control is unfrozen, - more than 0 indicates froze. - - - - - The parameter block when telling the world that a tool tip is about to be shown. - - - - - Gets the tooltip control that is triggering the tooltip event - - - - - Gets or sets the text should be shown on the tooltip for this event - - Setting this to empty or null prevents any tooltip from showing - - - - In what direction should the text for this tooltip be drawn? - - - - - Should the tooltip for this event been shown in bubble style? - - This doesn't work reliable under Vista - - - - What color should be used for the background of the tooltip - - Setting this does nothing under Vista - - - - What color should be used for the foreground of the tooltip - - Setting this does nothing under Vista - - - - What string should be used as the title for the tooltip for this event? - - - - - Which standard icon should be used for the tooltip for this event - - - - - How many milliseconds should the tooltip remain before it automatically - disappears. - - - - - What font should be used to draw the text of the tooltip? - - - - - Common information to all hyperlink events - - - - - Gets the ObjectListView that is the source of the event - - - - - Gets the model object under the cell - - - - - Gets the row index of the cell - - - - - Gets the column index of the cell - - This is -1 when the view is not in details view. - - - - Gets the column of the cell - - This is null when the view is not in details view. - - - - Gets the item of the cell - - - - - Gets the subitem of the cell - - This is null when the view is not in details view - - - - Gets the ObjectListView that is the source of the event - - - - - Gets or set if this event completelely handled. If it was, no further processing - will be done for it. - - - - - - - - - - Gets the ObjectListView that is the source of the event - - - - - Gets the model object under the cell - - - - - Gets the column of the cell - - This is null when the view is not in details view. - - - - Gets the text of the cell - - - - - Gets or sets whether or not this cell is a hyperlink. - Defaults to true for enabled rows and false for disabled rows. - - - - - Gets or sets the url that should be invoked when this cell is clicked. - - Setting this to None or String.Empty means that this cell is not a hyperlink - - - - - - - - Gets the ObjectListView that is the source of the event - - - - - Gets the item of the cell - - - - - Gets the model object under the cell - - - - - Gets the row index of the cell - - - - - Gets the display index of the row - - - - - Should events be triggered for each cell in this row? - - - - - Parameter block for FormatCellEvent - - - - - Gets the column index of the cell - - This is -1 when the view is not in details view. - - - - Gets the column of the cell - - This is null when the view is not in details view. - - - - Gets the subitem of the cell - - This is null when the view is not in details view - - - - Gets the model value that is being displayed by the cell. - - This is null when the view is not in details view - - - - The event args when a hyperlink is clicked - - - - - Gets the url that was associated with this cell. - - - - - The event args when the check box in a column header is changing - - - - - Get the column whose checkbox is changing - - - - - Get or set the new state that should be used by the column - - - - - The event args when the hot item changed - - - - - Gets or set if this event completelely handled. If it was, no further processing - will be done for it. - - - - - Gets the part of the cell that the mouse is over - - - - - Gets an extended indication of the part of item/subitem/group that the mouse is currently over - - - - - Gets the index of the column that the mouse is over - - In non-details view, this will always be 0. - - - - Gets the index of the row that the mouse is over - - - - - Gets the group that the mouse is over - - - - - Gets the part of the cell that the mouse used to be over - - - - - Gets an extended indication of the part of item/subitem/group that the mouse used to be over - - - - - Gets the index of the column that the mouse used to be over - - - - - Gets the index of the row that the mouse used to be over - - - - - Gets the group that the mouse used to be over - - - - - Returns a string that represents the current object. - - - A string that represents the current object. - - 2 - - - - Let the world know that a checkbox on a subitem is changing - - - - - Create a new event block - - - - - - - - - - The column of the cell that is having its checkbox changed. - - - - - The model object of the row of the cell that is having its checkbox changed. - - - - - The listview item of the cell that is having its checkbox changed. - - - - - The current check state of the cell. - - - - - The proposed new check state of the cell. - - - - - The index of the cell that is going to be or has been edited. - - - - - This event argument block is used when groups are created for a list. - - - - - Create a CreateGroupsEventArgs - - - - - - Gets the settings that control the creation of groups - - - - - Gets or sets the groups that should be used - - - - - Has this event been cancelled by the event handler? - - - - - This event argument block is used when the text of a group task is clicked - - - - - Create a GroupTaskClickedEventArgs - - - - - - Gets which group was clicked - - - - - This event argument block is used when a group is about to expand or collapse - - - - - Create a GroupExpandingCollapsingEventArgs - - - - - - Gets which group is expanding/collapsing - - - - - Gets whether this event is going to expand the group. - If this is false, the group must be collapsing. - - - - - This event argument block is used when the state of group has changed (collapsed, selected) - - - - - Create a GroupStateChangedEventArgs - - - - - - - - Gets whether the group was collapsed by this event - - - - - Gets whether the group was focused by this event - - - - - Gets whether the group was selected by this event - - - - - Gets whether the group was uncollapsed by this event - - - - - Gets whether the group was unfocused by this event - - - - - Gets whether the group was unselected by this event - - - - - Gets which group had its state changed - - - - - Gets the previous state of the group - - - - - Gets the new state of the group - - - - - This event argument block is used when a branch of a tree is about to be expanded - - - - - Create a new event args - - - - - - - Gets the model that is about to expand. If null, all branches are going to be expanded. - - - - - Gets the OLVListItem that is about to be expanded - - - - - This event argument block is used when a branch of a tree has just been expanded - - - - - Create a new event args - - - - - - - Gets the model that is was expanded. If null, all branches were expanded. - - - - - Gets the OLVListItem that was expanded - - - - - This event argument block is used when a branch of a tree is about to be collapsed - - - - - Create a new event args - - - - - - - Gets the model that is about to collapse. If this is null, all models are going to collapse. - - - - - Gets the OLVListItem that is about to be collapsed. Can be null - - - - - This event argument block is used when a branch of a tree has just been collapsed - - - - - Create a new event args - - - - - - - Gets the model that is was collapsed. If null, all branches were collapsed - - - - - Gets the OLVListItem that was collapsed - - - - - This class contains all the settings used when groups are created - - - - - Create a GroupingParameters - - - - - - - - - - - - - - - Gets or sets the ObjectListView being grouped - - - - - Gets or sets the column used to create groups - - - - - In what order will the groups themselves be sorted? - - - - - If this is set, this comparer will be used to order the groups - - - - - If this is set, this comparer will be used to order items within each group - - - - - Gets or sets the column that will be the primary sort - - - - - Gets or sets the ordering for the primary sort - - - - - Gets or sets the column used for secondary sorting - - - - - Gets or sets the ordering for the secondary sort - - - - - Gets or sets the title format used for groups with zero or more than one element - - - - - Gets or sets the title format used for groups with only one element - - - - - Gets or sets whether the items should be sorted by the primary column - - - - - These values indicate what is the state of the group. These values - are taken directly from the SDK and many are not used by ObjectListView. - - - - - Normal - - - - - Collapsed - - - - - Hidden - - - - - NoHeader - - - - - Can be collapsed - - - - - Has focus - - - - - Is Selected - - - - - Is subsetted - - - - - Subset link has focus - - - - - All styles - - - - - This mask indicates which members of a LVGROUP have valid data. These values - are taken directly from the SDK and many are not used by ObjectListView. - - - - - No mask - - - - - Group has header - - - - - Group has footer - - - - - Group has state - - - - - - - - - - - - - - - pszSubtitle is valid - - - - - pszTask is valid - - - - - pszDescriptionTop is valid - - - - - pszDescriptionBottom is valid - - - - - iTitleImage is valid - - - - - iExtendedImage is valid - - - - - iFirstItem and cItems are valid - - - - - pszSubsetTitle is valid - - - - - readonly, cItems holds count of items in visible subset, iFirstItem is valid - - - - - This mask indicates which members of a GROUPMETRICS structure are valid - - - - - - - - - - - - - - - - - - - - - - - - - Instances of this class enhance the capabilities of a normal ListViewGroup, - enabling the functionality that was released in v6 of the common controls. - - - - In this implementation (2009-09), these objects are essentially passive. - Setting properties does not automatically change the associated group in - the listview. Collapsed and Collapsible are two exceptions to this and - give immediate results. - - - This really should be a subclass of ListViewGroup, but that class is - sealed (why is that?). So this class provides the same interface as a - ListViewGroup, plus many other new properties. - - - - - - Create an OLVGroup - - - - - 按指定标题创建分组 - - 分组标题 - - - - Gets or sets the bottom description of the group - - - Descriptions only appear when group is centered and there is a title image - - - - - Gets or sets whether or not this group is collapsed - - - - - Gets or sets whether or not this group can be collapsed - - - - - Gets or sets some representation of the contents of this group - - This is user defined (like Tag) - - - - Gets whether this group has been created. - - - - - Gets or sets the int or string that will select the extended image to be shown against the title - - - - - Gets or sets the footer of the group - - - - - Gets the internal id of our associated ListViewGroup. - - - - - Gets or sets the header of the group - - - - - Gets or sets the horizontal alignment of the group header - - - - - Gets or sets the internally created id of the group - - - - - Gets or sets ListViewItems that are members of this group - - Listener of the BeforeCreatingGroups event can populate this collection. - It is only used on non-virtual lists. - - - - Gets or sets the key that was used to partition objects into this group - - This is user defined (like Tag) - - - - Gets the ObjectListView that this group belongs to - - If this is null, the group has not yet been created. - - - - Gets or sets the name of the group - - As of 2009-09-01, this property is not used. - - - - Gets or sets whether this group is focused - - - - - Gets or sets whether this group is selected - - - - - Gets or sets the text that will show that this group is subsetted - - - As of WinSDK v7.0, subsetting of group is officially unimplemented. - We can get around this using undocumented interfaces and may do so. - - - - - Gets or set the subtitleof the task - - - - - Gets or sets the value by which this group will be sorted. - - - - - Gets or sets the state of the group - - - - - Gets or sets which bits of State are valid - - - - - Gets or sets whether this group is showing only a subset of its elements - - - As of WinSDK v7.0, this property officially does nothing. - - - - - Gets or sets the user-defined data attached to this group - - - - - Gets or sets the task of this group - - This task is the clickable text that appears on the right margin - of the group header. - - - - Gets or sets the int or string that will select the image to be shown against the title - - - - - Gets or sets the top description of the group - - - Descriptions only appear when group is centered and there is a title image - - - - - Gets or sets the number of items that are within this group. - - This should only be used for virtual groups. - - - - Gets or sets the ListViewGroup that is shadowed by this group. - - For virtual groups, this will always be null. - - - - Calculate the index into the group image list of the given image selector - - - - - - - Convert this object to a string representation - - - - - - Insert a native group into the underlying Windows control, - *without* using a ListViewGroup - - - This is used when creating virtual groups - - - - Insert a native group into the underlying control via a ListViewGroup - - - - - - Change the members of the group to match the current contents of Items, - using a ListViewGroup - - - - - Create a native LVGROUP structure that matches this group - - - - - Get the current state of this group from the underlying control - - - - - Get the current state of this group from the underlying control - - - - - An instance of Munger gets a value from or puts a value into a target object. The property - to be peeked (or poked) is determined from a string. The peeking or poking is done using reflection. - - - Name of the aspect to be peeked can be a field, property or parameterless method. The name of an - aspect to poke can be a field, writable property or single parameter method. - - Aspect names can be dotted to chain a series of references. - - Order.Customer.HomeAddress.State - - - - - Create a do nothing Munger - - - - - Create a Munger that works on the given aspect name - - The name of the - - - - A helper method to put the given value into the given aspect of the given object. - - This method catches and silently ignores any errors that occur - while modifying the target object - The object to be modified - The name of the property/field to be modified - The value to be assigned - Did the modification work? - - - - Gets or sets whether Mungers will silently ignore missing aspect errors. - - - - By default, if a Munger is asked to fetch a field/property/method - that does not exist from a model, it returns an error message, since that - condition is normally a programming error. There are some use cases where - this is not an error, and the munger should simply keep quiet. - - By default this is true during release builds. - - - - - The name of the aspect that is to be peeked or poked. - - - - This name can be a field, property or parameter-less method. - - - The name can be dotted, which chains references. If any link in the chain returns - null, the entire chain is considered to return null. - - - "DateOfBirth" - "Owner.HomeAddress.Postcode" - - - - Extract the value indicated by our AspectName from the given target. - - If the aspect name is null or empty, this will return null. - The object that will be peeked - The value read from the target - - - - Extract the value indicated by our AspectName from the given target, raising exceptions - if the munger fails. - - If the aspect name is null or empty, this will return null. - The object that will be peeked - The value read from the target - - - - Poke the given value into the given target indicated by our AspectName. - - - - If the AspectName is a dotted path, all the selectors bar the last - are used to find the object that should be updated, and the last - selector is used as the property to update on that object. - - - So, if 'target' is a Person and the AspectName is "HomeAddress.Postcode", - this method will first fetch "HomeAddress" property, and then try to set the - "Postcode" property on the home address object. - - - The object that will be poked - The value that will be poked into the target - bool indicating whether the put worked - - - - Gets the list of SimpleMungers that match our AspectName - - - - - Convert a possibly dotted AspectName into a list of SimpleMungers - - - - - - - Evaluate the given chain of SimpleMungers against an initial target. - - - - - - - - A SimpleMunger deals with a single property/field/method on its target. - - - Munger uses a chain of these resolve a dotted aspect name. - - - - - Create a SimpleMunger - - - - - - The name of the aspect that is to be peeked or poked. - - - - This name can be a field, property or method. - When using a method to get a value, the method must be parameter-less. - When using a method to set a value, the method must accept 1 parameter. - - - It cannot be a dotted name. - - - - - - Get a value from the given target - - - - - - - Poke the given value into the given target indicated by our AspectName. - - The object that will be poked - The value that will be poked into the target - bool indicating if the put worked - - - - These exceptions are raised when a munger finds something it cannot process - - - - - Create a MungerException - - - - - - - - Get the munger that raised the exception - - - - - Gets the target that threw the exception - - - - - Wrapper for all native method calls on ListView controls - - - - - Put an image under the ListView. - - - - The ListView must have its handle created before calling this. - - - This doesn't work very well. Specifically, it doesn't play well with owner drawn, - and grid lines are drawn over it. - - - - The image to be used as the background. If this is null, any existing background image will be cleared. - If this is true, the image is pinned to the bottom right and does not scroll. The other parameters are ignored - If this is true, the image will be tiled to fill the whole control background. The offset parameters will be ignored. - If both watermark and tiled are false, this indicates the horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. - If both watermark and tiled are false, this indicates the vertical percentage where the image will be placed. - - - - - Flags controlling how the Image List item is - drawn - - - - - Draw item normally. - - - - - Draw item transparently. - - - - - Draw item blended with 25% of the specified foreground colour - or the Highlight colour if no foreground colour specified. - - - - - Draw item blended with 50% of the specified foreground colour - or the Highlight colour if no foreground colour specified. - - - - - Draw the icon's mask - - - - - Draw the icon image without using the mask - - - - - Draw the icon using the ROP specified. - - - - - Preserves the alpha channel in dest. XP only. - - - - - Scale the image to cx, cy instead of clipping it. XP only. - - - - - Scale the image to the current DPI of the display. XP only. - - - - - Enumeration containing XP ImageList Draw State options - - - - - The image state is not modified. - - - - - Adds a glow effect to the icon, which causes the icon to appear to glow - with a given color around the edges. (Note: does not appear to be implemented) - - - - - Adds a drop shadow effect to the icon. (Note: does not appear to be implemented) - - - - - Saturates the icon by increasing each color component - of the RGB triplet for each pixel in the icon. (Note: only ever appears to result in a completely unsaturated icon) - - - - - Alpha blends the icon. Alpha blending controls the transparency - level of an icon, according to the value of its alpha channel. - (Note: does not appear to be implemented). - - - - - Draws an image using the specified flags and state on XP systems. - - The image list from which an item will be drawn - Device context to draw to - Index of image to draw - X Position to draw at - Y Position to draw at - Drawing flags - Width to draw - Height to draw - State flags - - - - Make sure the ListView has the extended style that says to display subitem images. - - This method must be called after any .NET call that update the extended styles - since they seem to erase this setting. - The listview to send a m to - - - - Change the virtual list size of the given ListView (which must be in virtual mode) - - This will not change the scroll position - The listview to send a message to - How many rows should the list have? - - - - Make sure the ListView has the extended style that says to display subitem images. - - This method must be called after any .NET call that update the extended styles - since they seem to erase this setting. - The listview to send a m to - - - - - - Calculates the number of items that can fit vertically in the visible area of a list-view (which - must be in details or list view. - - The listView - Number of visible items per page - - - - For the given item and subitem, make it display the given image - - The listview to send a m to - row number (0 based) - subitem (0 is the item itself) - index into the image list - - - - Setup the given column of the listview to show the given image to the right of the text. - If the image index is -1, any previous image is cleared - - The listview to send a m to - Index of the column to modifiy - - Index into the small image list - - - - Does this version of the operating system have builtin sort indicators? - - Are there builtin sort indicators - XP and later have these - - - - Return the bounds of the update region on the given control. - - The BeginPaint() system call validates the update region, effectively wiping out this information. - So this call has to be made before the BeginPaint() call. - The control whose update region is be calculated - A rectangle - - - - Validate an area of the given control. A validated area will not be repainted at the next redraw. - - The control to be validated - The area of the control to be validated - - - - Select all rows on the given listview - - The listview whose items are to be selected - - - - Deselect all rows on the given listview - - The listview whose items are to be deselected - - - - Deselect a single row - - - - - - - Set the item state on the given item - - The listview whose item's state is to be changed - The index of the item to be changed - Which bits of the value are to be set? - The value to be set - - - - Scroll the given listview by the given deltas - - - - - true if the scroll succeeded - - - - Return the handle to the header control on the given list - - The listview whose header control is to be returned - The handle to the header control - - - - Return the edges of the given column. - - - - A Point holding the left and right co-ords of the column. - -1 means that the sides could not be retrieved. - - - - Return the edges of the given column. - - - - A Point holding the left and right co-ords of the column. - -1 means that the sides could not be retrieved. - - - - Return the index of the column of the header that is under the given point. - Return -1 if no column is under the pt - - The list we are interested in - The client co-ords - The index of the column under the point, or -1 if no column header is under that point - - - - Return the index of the divider under the given point. Return -1 if no divider is under the pt - - The list we are interested in - The client co-ords - The index of the divider under the point, or -1 if no divider is under that point - - - - Get the scroll position of the given scroll bar - - - - - - - - Change the z-order to the window 'toBeMoved' so it appear directly on top of 'reference' - - - - - - - - Make the given control/window a topmost window - - - - - - - Change the size of the window without affecting any other attributes - - - - - - - - - Show the given window without activating it - - The window to show - - - - Mark the given column as being selected. - - - The OLVColumn or null to clear - - This method works, but it prevents subitems in the given column from having - back colors. - - - - - A simple-minded implementation of a Dictionary that can handle null as a key. - - The type of the dictionary key - The type of the values to be stored - This is not a full implementation and is only meant to handle - collecting groups by their keys, since groups can have null as a key value. - - - - OLVListItems are specialized ListViewItems that know which row object they came from, - and the row index at which they are displayed, even when in group view mode. They - also know the image they should draw against themselves - - - - - Create a OLVListItem for the given row object - - - - - Create a OLVListItem for the given row object, represented by the given string and image - - - - - Gets the bounding rectangle of the item, including all subitems - - - - - Gets or sets how many pixels will be left blank around each cell of this item - - This setting only takes effect when the control is owner drawn. - - - - Gets or sets how the cells of this item will be vertically aligned - - This setting only takes effect when the control is owner drawn. - - - - Gets or sets the checkedness of this item. - - - Virtual lists don't handle checkboxes well, so we have to intercept attempts to change them - through the items, and change them into something that will work. - Unfortunately, this won't work if this property is set through the base class, since - the property is not declared as virtual. - - - - - Enable tri-state checkbox. - - .NET's Checked property was not built to handle tri-state checkboxes, - and will return True for both Checked and Indeterminate states. - - - - Gets if this item has any decorations set for it. - - - - - Gets or sets the decoration that will be drawn over this item - - Setting this replaces all other decorations - - - - Gets the collection of decorations that will be drawn over this item - - - - - Gets whether or not this row can be selected and activated - - - - - Gets whether any cell on this item is showing a hyperlink - - - - - Get or set the image that should be shown against this item - - This can be an Image, a string or an int. A string or an int will - be used as an index into the small image list. - - - - Gets or sets the the model object that is source of the data for this list item. - - - - - Gets or sets the color that will be used for this row's background when it is selected and - the control is focused. - - - To work reliably, this property must be set during a FormatRow event. - - If this is not set, the normal selection BackColor will be used. - - - - - - Gets or sets the color that will be used for this row's foreground when it is selected and - the control is focused. - - - To work reliably, this property must be set during a FormatRow event. - - If this is not set, the normal selection ForeColor will be used. - - - - - - Return the sub item at the given index - - Index of the subitem to be returned - An OLVListSubItem - - - - Return bounds of the given subitem - - This correctly calculates the bounds even for column 0. - - - - A ListViewSubItem that knows which image should be drawn against it. - - - - - Create a OLVListSubItem - - - - - Create a OLVListSubItem that shows the given string and image - - - - - Gets or sets how many pixels will be left blank around this cell - - This setting only takes effect when the control is owner drawn. - - - - Gets or sets how this cell will be vertically aligned - - This setting only takes effect when the control is owner drawn. - - - - Gets or sets the model value is being displayed by this subitem. - - - - - Gets if this subitem has any decorations set for it. - - - - - Gets or sets the decoration that will be drawn over this item - - Setting this replaces all other decorations - - - - Gets the collection of decorations that will be drawn over this item - - - - - Get or set the image that should be shown against this item - - This can be an Image, a string or an int. A string or an int will - be used as an index into the small image list. - - - - Gets or sets the url that should be invoked when this subitem is clicked - - - - - Gets or sets whether this cell is selected - - - - - Return the state of the animatation of the image on this subitem. - Null means there is either no image, or it is not an animation - - - - - An indication of where a hit was within ObjectListView cell - - - - - Nowhere - - - - - On the text - - - - - On the image - - - - - On the checkbox - - - - - On the expand button (TreeListView) - - - - - in a button (cell must have ButtonRenderer) - - - - - in the cell but not in any more specific location - - - - - UserDefined location1 (used for custom renderers) - - - - - On the expand/collapse widget of the group - - - - - Somewhere on a group - - - - - Somewhere in a column header - - - - - Somewhere in a column header checkbox - - - - - Somewhere in a header divider - - - - - A collection of ListViewHitTest constants - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Instances of this class encapsulate the information gathered during a OlvHitTest() - operation. - - Custom renderers can use HitTestLocation.UserDefined and the UserData - object to store more specific locations for use during event handlers. - - - - Create a OlvListViewHitTestInfo - - - - - Create a OlvListViewHitTestInfo when the header was hit - - - - - Where is the hit location? - - - - - Where is the hit location? - - - - - Which group was hit? - - - - - Custom renderers can use this information to supply more details about the hit location - - - - - Gets the item that was hit - - - - - Gets the subitem that was hit - - - - - Gets the part of the subitem that was hit - - - - - Gets the ObjectListView that was tested - - - - - Gets the model object that was hit - - - - - Gets the index of the row under the hit point or -1 - - - - - Gets the index of the column under the hit point - - - - - Gets the index of the header divider - - - - - Gets the column that was hit - - - - - Returns a string that represents the current object. - - - A string that represents the current object. - - 2 - - - - A TreeDataSourceAdapter knows how to build a tree structure from a binding list. - - To build a tree - - - - Create a data source adaptor that knows how to build a tree structure - - - - - - Gets or sets the name of the property/column that uniquely identifies each row. - - - - The value contained by this column must be unique across all rows - in the data source. Odd and unpredictable things will happen if two - rows have the same id. - - Null cannot be a valid key value. - - - - - Gets or sets the name of the property/column that contains the key of - the parent of a row. - - - - The test condition for deciding if one row is the parent of another is functionally - equivilent to this: - - Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) - - - Unlike key value, parent keys can be null but a null parent key can only be used - to identify root objects. - - - - - Gets or sets the value that identifies a row as a root object. - When the ParentKey of a row equals the RootKeyValue, that row will - be treated as root of the TreeListView. - - - - The test condition for deciding a root object is functionally - equivilent to this: - - Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) - - - The RootKeyValue can be null. - - - - - Gets or sets whether or not the key columns (id and parent id) should - be shown to the user. - - This must be set before the DataSource is set. It has no effect - afterwards. - - - - Gets the DataTreeListView that is being managed - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - A IVirtualGroups is the interface that a virtual list must implement to support virtual groups - - - - - Return the list of groups that should be shown according to the given parameters - - - - - - - Return the index of the item that appears at the given position within the given group. - - - - - - - - Return the index of the group to which the given item belongs - - - - - - - Return the index at which the given item is shown in the given group - - - - - - - - A hint that the given range of items are going to be required - - - - - - - - - This is a safe, do nothing implementation of a grouping strategy - - - - - Return the list of groups that should be shown according to the given parameters - - - - - - - Return the index of the item that appears at the given position within the given group. - - - - - - - - Return the index of the group to which the given item belongs - - - - - - - Return the index at which the given item is shown in the given group - - - - - - - - A hint that the given range of items are going to be required - - - - - - - - - Provides grouping functionality to a FastObjectListView - - - - - Create groups for FastListView - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This is the COM interface that a ListView must be given in order for groups in virtual lists to work. - - - This interface is NOT documented by MS. It was found on Greg Chapell's site. This means that there is - no guarantee that it will work on future versions of Windows, nor continue to work on current ones. - - - - - Not sure what this does - - - - - - - Not sure what this does - - - - - - - Get the index of the item that occurs at the n'th position of the indicated group. - - Index of the group - Index within the group - Index of the item within the whole list - - - - Get the index of the group to which the given item belongs - - Index of the item within the whole list - Which occurences of the item is wanted - Index of the group - - - - Get the number of groups that contain the given item - - Index of the item within the whole list - How many groups does it occur within - - - - A hint to prepare any cache for the given range of requests - - - - - - - A default implementation of the IOwnerDataCallback interface - - - - - A VirtualListDataSource is a complete manner to provide functionality to a virtual list. - An object that implements this interface provides a VirtualObjectListView with all the - information it needs to be fully functional. - - Implementors must provide functioning implementations of at least GetObjectCount() - and GetNthObject(), otherwise nothing will appear in the list. - - - - Return the object that should be displayed at the n'th row. - - The index of the row whose object is to be returned. - The model object at the n'th row, or null if the fetching was unsuccessful. - - - - Return the number of rows that should be visible in the virtual list - - The number of rows the list view should have. - - - - Get the index of the row that is showing the given model object - - The model object sought - The index of the row showing the model, or -1 if the object could not be found. - - - - The ListView is about to request the given range of items. Do - whatever caching seems appropriate. - - - - - - - Find the first row that "matches" the given text in the given range. - - The text typed by the user - Start searching from this index. This may be greater than the 'to' parameter, - in which case the search should descend - Do not search beyond this index. This may be less than the 'from' parameter. - The column that should be considered when looking for a match. - Return the index of row that was matched, or -1 if no match was found - - - - Sort the model objects in the data source. - - - - - - - Add the given collection of model objects to this control. - - A collection of model objects - - - - Insert the given collection of model objects to this control at the position - - Index where the collection will be added - A collection of model objects - - - - Remove all of the given objects from the control - - Collection of objects to be removed - - - - Set the collection of objects that this control will show. - - - - - - Update/replace the nth object with the given object - - - - - - - This extension allow virtual lists to filter their contents - - - - - All subsequent retrievals on this data source should be filtered - through the given filters. null means no filtering of that kind. - - - - - - - A do-nothing implementation of the VirtualListDataSource interface. - - - - - Creates an AbstractVirtualListDataSource - - - - - - The list view that this data source is giving information to. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Update/replace the nth object with the given object - - - - - - - This is a useful default implementation of SearchText method, intended to be called - by implementors of IVirtualListDataSource. - - - - - - - - - - - - - - - - - - This class mimics the behavior of VirtualObjectListView v1.x. - - - - - Creates a VirtualListVersion1DataSource - - - - - - How will the n'th object of the data source be fetched? - - - - - - - - - - - - - - - - - - - - - - Designer for and its subclasses. - - - - This designer removes properties and events that are available on ListView but that are not - useful on ObjectListView. - - - We can't inherit from System.Windows.Forms.Design.ListViewDesigner, since it is marked internal. - So, this class uses reflection to create a ListViewDesigner and then forwards messages to that designer. - - - - - - Initializes the designer with the specified component. - - The to associate the designer with. This component must always be an instance of, or derive from, . - - - - Initializes a newly created component. - - A name/value dictionary of default values to apply to properties. May be null if no default values are specified. - - - - Releases the unmanaged resources used by the and optionally releases the managed resources. - - true to release both managed and unmanaged resources; false to release only unmanaged resources. - - - - Removes the duplicate DockingActionList added by this designer to the . - - - adds an internal DockingActionList : 'Dock/Undock in Parent Container'. - But the default designer has already added that action list. So we need to remove one. - - - - - Adjusts the set of properties the component exposes through a . - - An containing the properties for the class of the component. - - - - Allows a designer to add to the set of events that it exposes through a . - - The events for the class of the component. - - - - Allows a designer to change or remove items from the set of attributes that it exposes through a . - - The attributes for the class of the component. - - - - Allows a designer to change or remove items from the set of events that it exposes through a . - - The events for the class of the component. - - - - Gets the design-time action lists supported by the component associated with the designer. - - - The design-time action lists supported by the component associated with the designer. - - - - - Gets the collection of components associated with the component managed by the designer. - - - The components that are associated with the component managed by the designer. - - - - - Indicates whether a mouse click at the specified point should be handled by the control. - - - true if a click at the specified point is to be handled by the control; otherwise, false. - - A indicating the position at which the mouse was clicked, in screen coordinates. - - - - Processes Windows messages and optionally routes them to the control. - - The to process. - - - - This class modifies a ListViewActionList, by removing the "Edit Items" and "Edit Groups" actions. - - - - That class is internal, so we cannot simply subclass it, which would be simplier. - - - Action lists use reflection to determine if that action can be executed, so we not - only have to modify the returned collection of actions, but we have to implement - the properties and commands that the returned actions use. - - - - - This class works in conjunction with the OLVColumns property to allow OLVColumns - to be added to the ObjectListView. - - - - - Create a OLVColumnCollectionEditor - - - - - - What type of object does this editor create? - - - - - - Edit a given value - - - - - - - - - What text should be shown in the list for the given object? - - - - - - - Control how the overlay is presented in the IDE - - - - - An OLVColumn knows which aspect of an object it should present. - - - The column knows how to: - - extract its aspect from the row object - convert an aspect to a string - calculate the image for the row object - extract a group "key" from the row object - convert a group "key" into a title for the group - - For sorting to work correctly, aspects from the same column - must be of the same type, that is, the same aspect cannot sometimes - return strings and other times integers. - - - - - How should the button be sized? - - - - - 每个单元格都将具有相同大小的按钮，如ButtonSize属性所示 - - - - - 每个单元格都将绘制一个填充单元格的按钮，该按钮由ButtonPadding插入 - - - - - 将调整每个按钮的大小以包含文本内容 - - - - - Create an OLVColumn - - - - - Initialize a column to have the given title, and show the given aspect - - The title of the column - The aspect to be shown in the column - - - - 此委托将用于提取要在此列中显示的值。 - - - 如果设置, AspectName属性将被忽略. - - - - - 请记住，如果当前列的AspectGetter是内部生成的，依旧可以随意重新生成 - - - - - 应调用以获取要在此列中显示的值的属性或方法的名称。 - 仅当未指定ValueGetterDelegate时才使用此选项。 - - 此名称可以用来表示对属性或无参数方法的链引用。 - "DateOfBirth" - "Owner.HomeAddress.Postcode" - - - - 此委托将用于将编辑后的值放回模型对象中。 - - - 如果IsEdable==false，则不执行任何操作。 - - - - - 用于将要在此列中显示的Aspect转换为字符串的委托。 - - 如果设置了此值，AspectToStringFormat将被忽略。 - - - - 将Aspect转换成字符串的格式文本 - - - 此字符串作为第一个参数传递给String.Format()方法。 - 仅当尚未设置AspectToStringConverter时才使用此选项。 - "{0:C}" 表示转换数字到货币 - - - - 获取或设置单元格编辑器是否应使用自动完成 - - - - - 获取或设置单元格编辑器是否应使用自动完成 - - - - - 获取用户操作是否可以隐藏此列 - - 这会同时考虑Hideable属性以及此列是否为列表视图的主列(列0)。 - - - - 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ - - - 如果控件不是所有者绘制(owner drawn)的，则始终将其视为true。 - - 如果该值为False(默认值)并且控件是所有者绘制(owner drawn)的， - ObjectListView将尝试计算单元格实际内容的宽度，然后将编辑控件的大小调整为恰到好处的宽度。 - 如果为真，则无论单元格的内容如何，都将使用单元格的整个宽度。 - - 如果未在列上设置此属性，则将使用控件中的值 - - 仅当控件处于详细信息视图中时才使用此值。 - 无论此设置如何，开发人员都可以通过侦听CellEditStarting事件来指定编辑控件的确切大小。 - - - - - 获取编辑此列中的单元格时是否应使用整个单元格 - - 这将计算当前有效值，该值可能与CellEditUseWholeCell不同 - - - - 获取或设置此列中此单元格周围将留空的像素数 - - 此设置仅在控件为所有者绘制(owner drawn)时生效。 - - - - 获取或设置此列中的单元格垂直对齐的方式。 - - - - 此设置仅在控件为所有者绘制(owner drawn)时生效。 - - - 如果未设置，将使用控件本身的值。 - - - - - - 获取或设置此列是否显示复选框。 - - - 在第0列上设置此选项不起作用。列0复选框由ObjectListView本身的CheckBox属性控制。 - - - - - Gets or sets the clustering strategy used for this column. - - - - The clustering strategy is used to build a Filtering menu for this item. - If this is null, a useful default will be chosen. - - - To disable filtering on this colummn, set UseFiltering to false. - - - Cluster strategies belong to a particular column. The same instance - cannot be shared between multiple columns. - - - - - - 获取或设置是否启用此列中的按钮(如果此列是按钮)，即使该行本身被禁用 - - - - - 此列是否应该调整大小以填充列表视图中的空闲空间？ - - - - 如果希望两列(或更多列)平均共享可用空间，请将此属性设置为True。 - 如果希望此列具有更大或更小的可用空间份额，则必须显式设置FreeSpaceProportion属性。 - - - 空间填充列仍然由MinimumWidth和MaximumWidth属性控制。 - - /// - - - - 控件中未占用的水平空间应分配给此列的比例是多少？ - - - - 在某些情况下，如果列(通常是最右边的列)可以随着列表视图的扩展而扩展， - 这样就可以在不必水平滚动的情况下尽可能多地看到列(您永远不应该让用户必须水平滚动任何内容！)。 - - - 调整空间填充列的大小以占据列表视图的未占用宽度的一部分(未占用宽度是一旦所有非填充列都被赋予其空间后剩余的宽度)。 - 此属性指示将分配给此列的未占用空间的相对比例。此属性的实际值并不重要，重要的是它的值相对于其他列中的值。 - 例子: - - - 如果只有一个空间填充列，则无论FreeSpaceProportion中的值如何，都将为其提供所有可用空间。 - - - 如果有两个或多个空间填充列，并且它们的FreeSpaceProportion值都相同，则它们将平等地共享空闲空间。 - - - 如果FreeSpaceProportion有三个值为3、2和1的空间填充列，则第一列将占用一半的空闲空间，第二列将占用三分之一的空闲空间，第三列将占用六分之一的空闲空间。 - - - - - - - - 获取或设置在单击此列的标题时是否对此列值重新生成组。 - - - 此设置仅在ShowGroups为true时使用。 - - 如果为False，则单击标题不会重建组。 - - 如果为false，则仍会激发BeforeCreatingGroups事件，这些事件可用于根据具体情况进行分组或提供反馈。 - - - - - 当组已创建但尚未成为真正的ListViewGroup时，将调用此委托。用户可以利用此机会填写有关该组的许多其他详细信息。 - - - - - 调用此委托以获取对象，该对象是给定行所属的组的键。 - - - - - 调用此委托将组键转换为该组的标题。 - - - - - 当列表视图按此列分组并且组标题有项目计数时，应如何设置标签的格式 - - - 给定的格式字符串支持以下两个占位符： - - {0} - 原组标题 - {1} - 该组项目数 - - - "{0} [{1} items]" - - - - 获取this.GroupWithItemCountFormat或默认值 - - - 如果未设置GroupWithItemCountFormat，则如果可能，将从ObjectListView中获取其值。 - - - - - 当列表视图按此列分组并且组标题有项目计数时，如果组中只有一个项目，标签应该如何格式化 - - - 给定的格式字符串支持以下两个占位符： - - {0} - 原组标题 - {1} - 该组项目数 (始终为1) - - - "{0} [{1} item]" - - - - 获取this.GroupWithItemCountSingularFormat或默认值 - - - 如果未设置此值，将使用列表视图中的值 - - - - - 获取是否应在列标题中使用筛选器指示符绘制此列。 - - - - - 获取或设置将用于所有者绘制标题列的委托。 - - - - - 获取或设置将用于绘制此列标题的样式 - - 仅当拥有的ObjectListView将HeaderUsesThemes设置为False时才使用此选项。 - - - - 获取或设置绘制此列的标题时使用的字体 - - 您可能应该使用HeaderFormatStyle而不是此属性 - 这仅在HeaderUsesThemes为false时使用。 - - - - 获取或设置绘制此列标题文本的颜色 - - 您可能应该使用HeaderFormatStyle而不是此属性 - 这仅在HeaderUsesThemes为false时使用。 - - - - 获取或设置将在列标题中显示的图像键 - - 这仅在HeaderUsesThemes为false时使用 - - - - 获取或设置Header文本的对齐方式 - - - - - 返回Header的文本对齐方式。这将是显式设置的，或者将遵循列中文本的对齐方式 - - - - - 获取转换为StringAlignment的Header对齐方式 - - - - - 获取此列的标题中是否有图像 - - - - - 获取或设置此Header是否在Header中放置复选框 - - - - - 获取或设置此Header是否在Header中放置三态复选框 - - - - - 获取或设置此列Header中复选框的选中状态 - - - - - 获取或设置选中/取消选中标题复选框的值是否会导致将此列中所有单元格的复选框设置为相同的选中/取消选中。 - 默认值为true. - - - - 当单元格的复选框状态改变时，该函数不会与自动更新标题的功能相反。 - - - 此属性在TreeListView上的行为最好描述为未定义，应该避免。 - - - 此操作(检查/取消检查所有行)的性能为O(n)，其中n是行数。它将在大型虚拟列表上工作，但可能需要一些时间。 - - - - - - 获取或设置是否禁用标题中的复选框 - - - 单击禁用的复选框不会更改其值，但会引发HeaderCheckBoxChanging事件，使程序员有机会执行适当的操作。 - - - - 获取或设置用户是否可以隐藏此列。 - - - 无论此设置如何，列0永远不能隐藏。 - - - - - 获取或设置此列中的文本值是否类似于超链接 - - - - - 这是属性的名称，将调用该属性来获取应该在此列中显示的图像的图像选择器。 - 它可以返回int、String、Image或NULL。 - - - 如果ImageGetter不为空，则忽略此项。 - 该属性可以使用以下返回值来标识图像： - - null或-1 --表示无图像 - int -- Int值将用作图像列表的索引 - String -- 字符串值将用作图像列表的关键字 - Image -- 将直接绘制图像(仅在OwnerDrawn模式下) - - - - - - 调用此委托以获取应该在此列中显示的图像的图像选择器。它可以返回int、String、Image或NULL。 - - - 该属性可以使用以下返回值来标识图像： - - null或-1 --表示无图像 - int -- Int值将用作图像列表的索引 - String -- 字符串值将用作图像列表的关键字 - Image -- 将直接绘制图像(仅在OwnerDrawn模式下) - - - - - - 获取或设置此列是否在其单元格中绘制按钮 - - - - 如果将其设置为true，则列的呈现器将成为ColumnButtonRenender(如果尚未成为ColumnButtonRenender)。如果设置为False，则将丢弃以前的任何按钮渲染器 - - 如果单元格的Aspect为Null或空，则不会在单元格中绘制任何内容。 - - - - Create a ColumnButtonRenderer to draw buttons in this column - - - - - - Fill in details to our ColumnButtonRenderer based on the properties set on the column - - - - - 获取或设置按钮可以占用的最大宽度。 - -1 表示不限制最大宽度 - - 仅当SizingMode为TextBound时才生效 - - - - 获取或设置当SizingMode为TextBound时单元格周围的额外空间 - - - - - 获取或设置SizingMode为FixedBound时按钮的大小 - - 如果未设置，将使用单元格的边界 - - - - 获取或设置此列显示按钮时如何调整每个按钮的大小 - - - - - 此列中显示的值是否可以编辑 - - 此默认值为false，因为控制列表视图的可编辑性的主要方法是列表视图本身。 - 列表视图可编辑后，所有列也可编辑，除非程序员显式将它们标记为不可编辑 - - - - 是否是固定宽度 - - - - - 获取/设置当视图切换到平铺视图(TileView)时是否使用此列。 - - 无论此设置如何，第0列始终包含在平铺视图中。平铺视图不能很好地处理许多“列”信息。两三个最好。 - - - - 获取或设置Header的文本是否应垂直呈现。 - - - 如果为True，最好将ToolTipText设置为列的名称，以便于阅读。 - 垂直Header仅为文本。他们不会画出图像。 - - - - - 该列是否可见 - - 更改此值后，必须调用RebuildColumns()才能使更改生效。 - - - - 此列最后一次定位在详细信息视图列中的位置是什么 - - DisplayIndex是易失性的。一旦从控件中移除列，就无法发现它在显示顺序中的位置。 - 即使列不在列表视图的活动列中，此属性也会保护该信息。 - - - - 列最大宽度 - - -1表示不限制. 将该值指定为与MinimumWidth相同的值，以生成固定宽度的列。 - - - - 列最小宽度 - - -1表示不限制. 将该值指定为与MaximumWidth相同的值，以生成固定宽度的列。 - - - - Get/set the renderer that will be invoked when a cell needs to be redrawn - - - - - This delegate is called when a cell needs to be drawn in OwnerDrawn mode. - - This method is kept primarily for backwards compatibility. - New code should implement an IRenderer, though this property will be maintained. - - - - 获取或设置执行文本搜索时是否使用此列的单元格中的文本。 - - - - 如果为False，则文本筛选器在查找匹配项时不会尝试搜索此列单元格。 - - - - - - 获取或设置一个委托，该委托将返回在使用基于文本的筛选器时应考虑进行文本匹配的文本值数组。 - - - - - 获取或设置此列的标题是否将包括该列的文本。 - - - - 如果为false，则列标题中呈现的唯一内容将是来自 . - - 只有在以下情况下才会考虑此设置: ObjectListView中的 为false . - - - - - 获取或设置当用户单击此列的标题时是否重新排序列表内容。 - - - - 如果为False，则单击标题将不会对列表进行排序，但也不会提供有关列表未排序原因的任何反馈。提供适当的反馈是程序员的责任。 - - 如果为false，则仍会触发BeforeSorting事件，该事件可用于根据具体情况进行排序或提供反馈。 - - - - - 获取或设置列内容的水平对齐方式。 - - NET将不允许列0具有除左对齐以外的任何对齐方式。我们不能更改列表视图的基本行为，但当所有者绘制时，列0现在可以有其他对齐方式。 - - - - 获取列文本对齐的StringAlignment等效项 - - - - - 当鼠标悬停在该列的标题上时，应该显示什么字符串？ - - 如果拥有的ObjectListView上安装了HeaderToolTipGetter，则将忽略此值。 - - - - 此列是否应该有一个三态复选框 - - - 如果为True，用户可以选择第三种状态(通常是不确定的)。 - - - - - 按列纵横比的首字母对对象进行分组 - - - 一种常见的模式是按该组的值的首字母对列进行分组。aspect必须是字符串(显然)。 - - - - - 获取或设置此列是否应为用户可筛选的列 - - - - - Gets or sets a filter that will only include models where the model's value - for this column is one of the values in ValuesChosenForFiltering - - - - - Gets or sets the values that will be used to generate a filter for this - column. For a model to be included by the generated filter, its value for this column - must be in this list. If the list is null or empty, this column will - not be used for filtering. - - - - - 列宽 - - - - - 获取或设置此列单元格的内容是否应自动换行 - - 如果此列使用自定义IRenender(即，不是从BaseRenender派生的)，则该呈现器负责实现自动换行。 - - - - For a given group value, return the string that should be used as the groups title. - - The group key that is being converted to a title - string - - - - Get the checkedness of the given object for this column - - The row object that is being displayed - The checkedness of the object - - - - Put the checkedness of the given object for this column - - The row object that is being displayed - - The checkedness of the object - - - - For a given row object, extract the value indicated by the AspectName property of this column. - - The row object that is being displayed - An object, which is the aspect named by AspectName - - - - For a given row object, return the object that is the key of the group that this row belongs to. - - The row object that is being displayed - Group key object - - - - For a given row object, return the image selector of the image that should displayed in this column. - - The row object that is being displayed - int or string or Image. int or string will be used as index into image list. null or -1 means no image - - - - Return the image that represents the check box for the given model - - - - - - - For a given row object, return the strings that will be searched when trying to filter by string. - - - This will normally be the simple GetStringValue result, but if this column is non-textual (e.g. image) - you might want to install a SearchValueGetter delegate which can return something that could be used - for text filtering. - - - The array of texts to be searched. If this returns null, search will not match that object. - - - - For a given row object, return the string representation of the value shown in this column. - - - For aspects that are string (e.g. aPerson.Name), the aspect and its string representation are the same. - For non-strings (e.g. aPerson.DateOfBirth), the string representation is very different. - - - - - - - For a given row object, return the object that is to be displayed in this column. - - The row object that is being displayed - An object, which is the aspect to be displayed - - - - Update the given model object with the given value using the column's - AspectName. - - The model object to be updated - The value to be put into the model - - - - Update the given model object with the given value - - The model object to be updated - The value to be put into the model - - - - Convert the aspect object to its string representation. - - - If the column has been given a AspectToStringConverter, that will be used to do - the conversion, otherwise just use ToString(). - The returned value will not be null. Nulls are always converted - to empty strings. - - The value of the aspect that should be displayed - A string representation of the aspect - - - - Convert the aspect object to its string representation. - - - If the column has been given a AspectToStringConverter, that will be used to do - the conversion, otherwise just use ToString(). - The returned value will not be null. Nulls are always converted - to empty strings. - - - The value of the aspect that should be displayed - A string representation of the aspect - - - - Decide the clustering strategy that will be used for this column - - - - - - Gets or sets the type of data shown in this column. - - If this is not set, it will try to get the type - by looking through the rows of the listview. - - - - This event is triggered when the visibility of this column changes. - - - - - Tell the world when visibility of a column changes. - - - - - Create groupies - This is an untyped version to help with Generator and OLVColumn attributes - - - - - - - Create groupies - - - - - - - - Create groupies - - - - - - - - - Create groupies - - - - - - - - - - Create groupies. - Install delegates that will group the columns aspects into progressive partitions. - If an aspect is less than value[n], it will be grouped with description[n]. - If an aspect has a value greater than the last element in "values", it will be grouped - with the last element in "descriptions". - - Array of values. Values must be able to be - compared to the aspect (using IComparable) - The description for the matching value. The last element is the default description. - If there are n values, there must be n+1 descriptions. - - this.salaryColumn.MakeGroupies( - new UInt32[] { 20000, 100000 }, - new string[] { "Lowly worker", "Middle management", "Rarified elevation"}); - - - - - - - - - Create groupies based on exact value matches. - - - Install delegates that will group rows into partitions based on equality of this columns aspects. - If an aspect is equal to value[n], it will be grouped with description[n]. - If an aspect is not equal to any value, it will be grouped with "[other]". - - Array of values. Values must be able to be - equated to the aspect - The description for the matching value. - - this.marriedColumn.MakeEqualGroupies( - new MaritalStatus[] { MaritalStatus.Single, MaritalStatus.Married, MaritalStatus.Divorced, MaritalStatus.Partnered }, - new string[] { "Looking", "Content", "Looking again", "Mostly content" }); - - - - - - - - - An adorment is the common base for overlays and decorations. - - - - - Gets or sets the corner of the adornment that will be positioned at the reference corner - - - - - Gets or sets location within the reference rectange where the adornment will be drawn - - This is a simplied interface to ReferenceCorner and AdornmentCorner - - - - Gets or sets the offset by which the position of the adornment will be adjusted - - - - - Gets or sets the point of the reference rectangle to which the adornment will be aligned. - - - - - Gets or sets the degree of rotation by which the adornment will be transformed. - The centre of rotation will be the center point of the adornment. - - - - - Gets or sets the transparency of the overlay. - 0 is completely transparent, 255 is completely opaque. - - - - - Calculate the location of rectangle of the given size, - so that it's indicated corner would be at the given point. - - The point - - Which corner will be positioned at the reference point - - CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.TopLeft) -> Point(50, 100) - CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.MiddleCenter) -> Point(45, 90) - CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.BottomRight) -> Point(40, 80) - - - - Calculate a rectangle that has the given size which is positioned so that - its alignment point is at the reference location of the given rect. - - - - - - - - Create a rectangle of the given size which is positioned so that - its indicated corner is at the indicated corner of the reference rect. - - - - - - - - - Creates a rectangle so that its bottom left is at the centre of the reference: - corner=BottomLeft, referenceCorner=MiddleCenter - This is a powerful concept that takes some getting used to, but is - very neat once you understand it. - - - - - Return the point at the indicated corner of the given rectangle (it doesn't - have to be a corner, but a named location) - - The reference rectangle - Which point of the rectangle should be returned? - A point - CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.TopLeft) -> Point(0, 0) - CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.MiddleCenter) -> Point(25, 50) - CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.BottomRight) -> Point(50, 100) - - - - Given the item and the subitem, calculate its bounds. - - - - - - - - Apply any specified rotation to the Graphic content. - - The Graphics to be transformed - The rotation will be around the centre of this rect - - - - Reverse the rotation created by ApplyRotation() - - - - - - An overlay that will draw an image over the top of the ObjectListView - - - - - Gets or sets the image that will be drawn - - - - - Gets or sets if the image will be shrunk to fit with its horizontal bounds - - - - - Draw the image in its specified location - - The Graphics used for drawing - The bounds of the rendering - - - - Draw the image in its specified location - - The image to be drawn - The Graphics used for drawing - The bounds of the rendering - How transparent should the image be (0 is completely transparent, 255 is opaque) - - - - Draw the image in its specified location - - The image to be drawn - The Graphics used for drawing - The bounds of the rendering - How big should the image be? - How transparent should the image be (0 is completely transparent, 255 is opaque) - - - - Draw the image in its specified location, scaled so that it is not wider - than the given rectangle. Height is scaled proportional to the width. - - The image to be drawn - The Graphics used for drawing - The bounds of the rendering - How transparent should the image be (0 is completely transparent, 255 is opaque) - - - - Utility to draw a bitmap transparenly. - - - - - - - - - An adornment that will draw text - - - - - Gets or sets the background color of the text - Set this to Color.Empty to not draw a background - - - - - Gets the brush that will be used to paint the text - - - - - Gets or sets the color of the border around the billboard. - Set this to Color.Empty to remove the border - - - - - Gets the brush that will be used to paint the text - - - - - Gets or sets the width of the border around the text - - - - - How rounded should the corners of the border be? 0 means no rounding. - - If this value is too large, the edges of the border will appear odd. - - - - Gets or sets the font that will be used to draw the text - - - - - Gets the font that will be used to draw the text or a reasonable default - - - - - Does this text have a background? - - - - - Does this overlay have a border? - - - - - Gets or sets the maximum width of the text. Text longer than this will wrap. - 0 means no maximum. - - - - - Gets or sets the formatting that should be used on the text - - - - - Gets or sets the text that will be drawn - - - - - Gets the brush that will be used to paint the text - - - - - Gets or sets the color of the text - - - - - Gets or sets whether the text will wrap when it exceeds its bounds - - - - - Draw our text with our stored configuration in relation to the given - reference rectangle - - The Graphics used for drawing - The reference rectangle in relation to which the text will be drawn - - - - Draw the given text with our stored configuration - - The Graphics used for drawing - The reference rectangle in relation to which the text will be drawn - The text to draw - How opaque should be text be - - - - Draw the text with a border - - The Graphics used for drawing - The bounds within which the text should be drawn - The text to draw - How opaque should be text be - - - - Return the rectangle that will be the precise bounds of the displayed text - - - - - The bounds of the text - - - - Return a GraphicPath that is a round cornered rectangle - - The rectangle - The diameter of the corners - A round cornered rectagle path - If I could rely on people using C# 3.0+, this should be - an extension method of GraphicsPath. - - - - A decoration is an overlay that draws itself in relation to a given row or cell. - Decorations scroll when the listview scrolls. - - - - - Gets or sets the row that is to be decorated - - - - - Gets or sets the subitem that is to be decorated - - - - - An AbstractDecoration is a safe do-nothing implementation of the IDecoration interface - - - - - Gets or sets the row that is to be decorated - - - - - Gets or sets the subitem that is to be decorated - - - - - Gets the bounds of the decorations row - - - - - Get the bounds of the decorations cell - - - - - Draw the decoration - - - - - - - - This decoration draws a slight tint over a column of the - owning listview. If no column is explicitly set, the selected - column in the listview will be used. - The selected column is normally the sort column, but does not have to be. - - - - - Create a TintedColumnDecoration - - - - - Create a TintedColumnDecoration - - - - - - Gets or sets the column that will be tinted - - - - - Gets or sets the color that will be 'tinted' over the selected column - - - - - Draw a slight colouring over our tinted column - - - This overlay only works when: - - the list is in Details view - - there is at least one row - - there is a selected column (or a specified tint column) - - - - - - - - This decoration draws an optionally filled border around a rectangle. - Subclasses must override CalculateBounds(). - - - - - Create a BorderDecoration - - - - - Create a BorderDecoration - - The pen used to draw the border - - - - Create a BorderDecoration - - The pen used to draw the border - The brush used to fill the rectangle - - - - Gets or sets the pen that will be used to draw the border - - - - - Gets or sets the padding that will be added to the bounds of the item - before drawing the border and fill. - - - - - How rounded should the corners of the border be? 0 means no rounding. - - If this value is too large, the edges of the border will appear odd. - - - - Gets or sets the brush that will be used to fill the border - - This value is ignored when using gradient brush - - - - Gets or sets the color that will be used as the start of a gradient fill. - - This and FillGradientTo must be given value to show a gradient - - - - Gets or sets the color that will be used as the end of a gradient fill. - - This and FillGradientFrom must be given value to show a gradient - - - - Gets or sets the fill mode that will be used for the gradient. - - - - - Draw a filled border - - - - - - - - Subclasses should override this to say where the border should be drawn - - - - - - Do the actual work of drawing the filled border - - - - - - - Create a GraphicsPath that represents a round cornered rectangle. - - - If this is 0 or less, the rectangle will not be rounded. - - - - - Instances of this class draw a border around the decorated row - - - - - Gets or sets the index of the left most column to be used for the border - - - - - Gets or sets the index of the right most column to be used for the border - - - - - Calculate the boundaries of the border - - - - - - Instances of this class draw a border around the decorated subitem. - - - - - Calculate the boundaries of the border - - - - - - This decoration puts a border around the cell being edited and - optionally "lightboxes" the cell (makes the rest of the control dark). - - - - - Create a EditingCellBorderDecoration - - - - - Create a EditingCellBorderDecoration - - Should the decoration use a lighbox display style? - - - - Gets or set whether the decoration should make the rest of - the control dark when a cell is being edited - - If this is true, FillBrush is used to overpaint - the control. - - - - Draw the decoration - - - - - - - - This decoration causes everything *except* the row under the mouse to be overpainted - with a tint, making the row under the mouse stand out in comparison. - The darker and more opaque the fill color, the more obvious the - decorated row becomes. - - - - - Create a LightBoxDecoration - - - - - Draw a tint over everything in the ObjectListView except the - row under the mouse. - - - - - - - - Instances of this class put an Image over the row/cell that it is decorating - - - - - Create an image decoration - - - - - Create an image decoration - - - - - - Create an image decoration - - - - - - - Create an image decoration - - - - - - - Create an image decoration - - - - - - - - Gets or sets the item being decorated - - - - - Gets or sets the sub item being decorated - - - - - Draw this decoration - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - Instances of this class draw some text over the row/cell that they are decorating - - - - - Create a TextDecoration - - - - - Create a TextDecoration - - - - - - Create a TextDecoration - - - - - - - Create a TextDecoration - - - - - - - Create a TextDecoration - - - - - - - - Gets or sets the item being decorated - - - - - Gets or sets the sub item being decorated - - - - - Draw this decoration - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - The interface for an object which can draw itself over the top of - an ObjectListView. - - - - - Draw this overlay - - The ObjectListView that is being overlaid - The Graphics onto the given OLV - The content area of the OLV - - - - An interface for an overlay that supports variable levels of transparency - - - - - Gets or sets the transparency of the overlay. - 0 is completely transparent, 255 is completely opaque. - - - - - A null implementation of the IOverlay interface - - - - - Draw this overlay - - The ObjectListView that is being overlaid - The Graphics onto the given OLV - The content area of the OLV - - - - How transparent should this overlay be? - - - - - An overlay that will draw an image over the top of the ObjectListView - - - - - Create an ImageOverlay - - - - - Gets or sets the horizontal inset by which the position of the overlay will be adjusted - - - - - Gets or sets the vertical inset by which the position of the overlay will be adjusted - - - - - Draw this overlay - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - An overlay that will draw text over the top of the ObjectListView - - - - - Create a TextOverlay - - - - - Gets or sets the horizontal inset by which the position of the overlay will be adjusted - - - - - Gets or sets the vertical inset by which the position of the overlay will be adjusted - - - - - Gets or sets whether the border will be drawn with rounded corners - - - - - Draw this overlay - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - A Billboard overlay is a TextOverlay positioned at an absolute point - - - - - Create a BillboardOverlay - - - - - Gets or sets where should the top left of the billboard be placed - - - - - Draw this overlay - - The ObjectListView being decorated - The Graphics used for drawing - The bounds of the rendering - - - - Renderers are the mechanism used for owner drawing cells. As such, they can also handle - hit detection and positioning of cell editing rectangles. - - - - - Render the whole item within an ObjectListView. This is only used in non-Details views. - - The event - A Graphics for rendering - The bounds of the item - The model object to be drawn - Return true to indicate that the event was handled and no further processing is needed. - - - - Render one cell within an ObjectListView when it is in Details mode. - - The event - A Graphics for rendering - The bounds of the cell - The model object to be drawn - Return true to indicate that the event was handled and no further processing is needed. - - - - What is under the given point? - - - x co-ordinate - y co-ordinate - This method should only alter HitTestLocation and/or UserData. - - - - When the value in the given cell is to be edited, where should the edit rectangle be placed? - - - - - - - - - - - Renderers that implement this interface will have the filter property updated, - each time the filter on the ObjectListView is updated. - - - - - - - - - - An AbstractRenderer is a do-nothing implementation of the IRenderer interface. - - - - - Render the whole item within an ObjectListView. This is only used in non-Details views. - - The event - A Graphics for rendering - The bounds of the item - The model object to be drawn - Return true to indicate that the event was handled and no further processing is needed. - - - - Render one cell within an ObjectListView when it is in Details mode. - - The event - A Graphics for rendering - The bounds of the cell - The model object to be drawn - Return true to indicate that the event was handled and no further processing is needed. - - - - What is under the given point? - - - x co-ordinate - y co-ordinate - This method should only alter HitTestLocation and/or UserData. - - - - When the value in the given cell is to be edited, where should the edit rectangle be placed? - - - - - - - - - - - This class provides compatibility for v1 RendererDelegates - - - - - The renderer delegate that this renderer wraps - - - - - A BaseRenderer provides useful base level functionality for any custom renderer. - - - Subclasses will normally override the Render or OptionalRender method, and use the other - methods as helper functions. - - - - - Can the renderer wrap lines that do not fit completely within the cell? - - Wrapping text doesn't work with the GDI renderer. - - - - Gets or sets how many pixels will be left blank around this cell - - - - This setting only takes effect when the control is owner drawn. - - for more details. - - - - - Gets the horiztonal alignment of the column - - - - - Gets or sets how cells drawn by this renderer will be vertically aligned. - - - - If this is not set, the value from the column or control itself will be used. - - - - - - Gets the optional padding that this renderer should apply before drawing. - This property considers all possible sources of padding - - - - - Gets the vertical cell alignment that should govern the rendering. - This property considers all possible sources. - - - - - Gets or sets the image list from which keyed images will be fetched - - - - - When rendering multiple images, how many pixels should be between each image? - - - - - Should text be rendered using GDI routines? This makes the text look more - like a native List view control. - - - - - Get or set the aspect of the model object that this renderer should draw - - - - - What are the bounds of the cell that is being drawn? - - - - - Get or set the OLVColumn that this renderer will draw - - - - - Get/set the event that caused this renderer to be called - - - - - Get/set the event that caused this renderer to be called - - - - - Gets or sets the font to be used for text in this cell - - - - - Gets the image list from which keyed images will be fetched - - - - - Should this renderer fill in the background before drawing? - - - - - Cache whether or not our item is selected - - - - - Is this renderer being used on a printer context? - - - - - Get or set the listitem that this renderer will be drawing - - - - - Get/set the listview for which the drawing is to be done - - - - - Get the specialized OLVSubItem that this renderer is drawing - - This returns null for column 0. - - - - Get or set the model object that this renderer should draw - - - - - Get or set the list subitem that this renderer will be drawing - - - - - The brush that will be used to paint the text - - - - - Will this renderer use the custom images from the parent ObjectListView - to draw the checkbox images. - - - - If this is true, the renderer will use the images from the - StateImageList to represent checkboxes. 0 - unchecked, 1 - checked, 2 - indeterminate. - - If this is false (the default), then the renderer will use .NET's standard - CheckBoxRenderer. - - - - - Align the second rectangle with the first rectangle, - according to the alignment of the column - - The cell's bounds - The rectangle to be aligned within the bounds - An aligned rectangle - - - - Calculate the left edge of the rectangle that aligns the outer rectangle with the inner one - according to this renderer's horizontal alignment - - - - - - - - Calculate the top of the rectangle that aligns the outer rectangle with the inner rectangle - according to this renders vertical alignment - - - - - - - - Calculate the top of the rectangle that aligns the outer rectangle with a rectangle of the given height - according to this renderer's vertical alignment - - - - - - - - Calculate the space that our rendering will occupy and then align that space - with the given rectangle, according to the Column alignment - - - Pre-padded bounds of the cell - - - - - Calculate the size of the content of this cell. - - - Pre-padded bounds of the cell - The width and height of the content - - - - Calculate the bounds of a checkbox given the (pre-padded) cell bounds - - - Pre-padded cell bounds - - - - - How much space will the check box for this cell occupy? - - Only column 0 can have check boxes. Sub item checkboxes are - treated as images - - - - - - How much space will the check box for this row occupy? - If the list doesn't have checkboxes, or this isn't the primary column, - this returns an empty size. - - - - - - - How much horizontal space will the image of this cell occupy? - - - - - - - - How much vertical space will the image of this cell occupy? - - - - - - - - How much space will the image of this cell occupy? - - - - - - - - How much horizontal space will the text of this cell occupy? - - - - - - - - - How much space will the text of this cell occupy? - - - - - - - - - Return the Color that is the background color for this item's cell - - The background color of the subitem - - - - Return the color of the background color when the item is selected - - The background color of the subitem - - - - Return the color to be used for text in this cell - - The text color of the subitem - - - - Return the color of the foreground color when the item is selected - - The foreground color of the subitem - - - - Return the image that should be drawn against this subitem - - An Image or null if no image should be drawn. - - - - Return the actual image that should be drawn when keyed by the given image selector. - An image selector can be: - an int, giving the index into the image list - a string, giving the image key into the image list - an Image, being the image itself - - - The value that indicates the image to be used - An Image or null - - - - - - - - Return the string that should be drawn within this - - - - - - Return the Color that is the background color for this item's text - - The background color of the subitem's text - - - - Render the whole item in a non-details view. - - - - - - - - - - Prepare this renderer to draw in response to the given event - - - - - Use this if you want to chain a second renderer within a primary renderer. - - - - Render one cell - - - - - - - - - - Prepare this renderer to draw in response to the given event - - - - - Use this if you want to chain a second renderer within a primary renderer. - - - - Calculate which part of this cell was hit - - - - - - - - Calculate the edit rectangle - - - - - - - - - - - Draw our data into the given rectangle using the given graphics context. - - - Subclasses should override this method. - The graphics context that should be used for drawing - The bounds of the subitem cell - Returns whether the rendering has already taken place. - If this returns false, the default processing will take over. - - - - - Draw our data into the given rectangle using the given graphics context. - - - Subclasses should override this method if they never want - to fall back on the default processing - The graphics context that should be used for drawing - The bounds of the subitem cell - - - - Do the actual work of hit testing. Subclasses should override this rather than HitTest() - - - - - - - - - Handle a HitTest request after all state information has been initialized - - - - - - - - - - - Draw the standard "[checkbox] [image] [text]" cell after the state properties have been initialized. - - - - - - - Change the bounds of the given rectangle to take any cell padding into account - - - - - - - Perform normal hit testing relative to the given aligned content bounds - - - - - - - - - - This method calculates the bounds of the text within a standard layout - (i.e. optional checkbox, optional image, text) - - This method only works correctly if the state of the renderer - has been fully initialized (see BaseRenderer.GetEditRectangle) - - - - - - - - Apply any padding to the given bounds, and then align a rectangle of the given - size within that padded area. - - - - - - - - - Draw the given image aligned horizontally within the column. - - - Over tall images are scaled to fit. Over-wide images are - truncated. This is by design! - - Graphics context to use for drawing - Bounds of the cell - The image to be drawn - - - - Draw our subitems image and text - - Graphics context to use for drawing - Pre-padded bounds of the cell - - - - Fill in the background of this cell - - Graphics context to use for drawing - Bounds of the cell - - - - Draw the primary check box of this row (checkboxes in other sub items use a different method) - - Graphics context to use for drawing - The pre-aligned and padded target rectangle - - - - Calculate the CheckBoxState we need to correctly draw the given state - - - - - - - Should this checkbox be drawn as disabled? - - - - - Is the current item hot (i.e. under the mouse)? - - - - - Is the mouse over a checkbox in this cell? - - - - - Draw the given text and optional image in the "normal" fashion - - Graphics context to use for drawing - Bounds of the cell - The optional image to be drawn - - - - Draw our subitems image and text - - Graphics context to use for drawing - Bounds of the cell - - - - Draw the given collection of image selectors - - - - - - - - Draw the given text and optional image in the "normal" fashion - - Graphics context to use for drawing - Bounds of the cell - The string to be drawn - - - - Print the given text in the given rectangle using only GDI routines - - - - - - The native list control uses GDI routines to do its drawing, so using them - here makes the owner drawn mode looks more natural. - This method doesn't honour the CanWrap setting on the renderer. All - text is single line - - - - - Gets the cell's vertical alignment as a TextFormatFlag - - - - - - Gets the StringFormat needed when drawing text using GDI+ - - - - - Print the given text in the given rectangle using normal GDI+ .NET methods - - Printing to a printer dc has to be done using this method. - - - - This renderer highlights substrings that match a given text filter. - - - - - Create a HighlightTextRenderer - - - - - Create a HighlightTextRenderer - - - - - - Create a HighlightTextRenderer - - - - - - Gets or set how rounded will be the corners of the text match frame - - - - - Gets or set the brush will be used to paint behind the matched substrings. - Set this to null to not fill the frame. - - - - - Gets or sets the filter that is filtering the ObjectListView and for - which this renderer should highlight text - - - - - When a filter changes, keep track of the text matching filters - - - - - Gets or set the pen will be used to frame the matched substrings. - Set this to null to not draw a frame. - - - - - Gets or sets whether the frame around a text match will have rounded corners - - - - - Gets or set the text that will be highlighted - - - - - Gets or sets the manner in which substring will be compared. - - - Use this to control if substring matches are case sensitive or insensitive. - - - - Handle a HitTest request after all state information has been initialized - - - - - - - - - - - Draw text using GDI - - - - - - - - Draw the highlighted text using GDI - - - - - - - - Draw an indication around the given frame that shows a text match - - - - - - - - - - Draw the text using GDI+ - - - - - - - - Draw the highlighted text using GDI+ - - - - - - - - Gets whether the renderer should actually draw highlighting - - - - - Return a GraphicPath that is a round cornered rectangle - - A round cornered rectangle path - If I could rely on people using C# 3.0+, this should be - an extension method of GraphicsPath. - - - - - - - - - Return a GraphicPath that is a round cornered rectangle - - The rectangle - The diameter of the corners - A round cornered rectangle path - If I could rely on people using C# 3.0+, this should be - an extension method of GraphicsPath. - - - - This class maps a data value to an image that should be drawn for that value. - - It is useful for drawing data that is represented as an enum or boolean. - - - - Return a renderer that draw boolean values using the given images - - Draw this when our data value is true - Draw this when our data value is false - A Renderer - - - - Return a renderer that draw tristate boolean values using the given images - - Draw this when our data value is true - Draw this when our data value is false - Draw this when our data value is null - A Renderer - - - - Make a new empty renderer - - - - - Make a new renderer that will show the given image when the given key is the aspect value - - The data value to be matched - The image to be shown when the key is matched - - - - Make a new renderer that will show the given images when it receives the given keys - - - - - - - - - Build a renderer from the given array of keys and their matching images - - An array of key/image pairs - - - - Register the image that should be drawn when our Aspect has the data value. - - Value that the Aspect must match - An ImageSelector -- an int, string or image - - - - Render our value - - - - - - - Draw a collection of images - - - - - - - - Draw one image - - - - - - - - This renderer draws just a checkbox to match the check state of our model object. - - - - - Draw our cell - - - - - - - Handle the GetEditRectangle request - - - - - - - - - - - Handle the HitTest request - - - - - - - - - Render an image that comes from our data source. - - The image can be sourced from: - - a byte-array (normally when the image to be shown is - stored as a value in a database) - an int, which is treated as an index into the image list - a string, which is treated first as a file name, and failing that as an index into the image list - an ICollection of ints or strings, which will be drawn as consecutive images - - If an image is an animated GIF, it's state is stored in the SubItem object. - By default, the image renderer does not render animations (it begins life with animations paused). - To enable animations, you must call Unpause(). - In the current implementation (2009-09), each column showing animated gifs must have a - different instance of ImageRenderer assigned to it. You cannot share the same instance of - an image renderer between two animated gif columns. If you do, only the last column will be - animated. - - - - - Make an empty image renderer - - - - - Make an empty image renderer that begins life ready for animations - - - - - Finalizer - - - - - Should the animations in this renderer be paused? - - - - - Gets a timer that can be used to trigger redraws on animations - - - - - Pause any animations - - - - - Unpause any animations - - - - - Draw our image - - - - - - - Translate our Aspect into an image. - - The strategy is: - If its a byte array, we treat it as an in-memory image - If it's an int, we use that as an index into our image list - If it's a string, we try to load a file by that name. If we can't, - we use the string as an index into our image list. - - An image - - - - This is the method that is invoked by the timer. It basically switches control to the listview thread. - - not used - - - - This is the OnTimer callback, but invoked in the same thread as the creator of the ListView. - This method can use all of ListViews methods without creating a CrossThread exception. - - - - - Instances of this class kept track of the animation state of a single image. - - - - - Is the given image an animation - - The image to be tested - Is the image an animation? - - - - Create an AnimationState in a quiet state - - - - - Create an animation state for the given image, which may or may not - be an animation - - The image to be rendered - - - - Does this state represent a valid animation - - - - - Advance our images current frame and calculate when it will expire - - - - - Render our Aspect as a progress bar - - - - - Make a BarRenderer - - - - - Make a BarRenderer for the given range of data values - - - - - Make a BarRenderer using a custom bar scheme - - - - - Make a BarRenderer using a custom bar scheme - - - - - Make a BarRenderer that uses a horizontal gradient - - - - - Make a BarRenderer that uses a horizontal gradient - - - - - 此栏是否应以系统样式绘制？ - - - - - 将从我们的单元格边框开始绘制多少像素的条形图 - - - - - 在绘制进度条之前，将使用什么颜色填充控件内部？ - - - - - 进度条边框颜色 - - - - - 进度条的边框像素宽 - - - - - 进度条的“填充”部分应该是什么颜色？ - - 仅当GradientStartColor为Color.Empty时才使用此选项 - - - - 使用渐变以此颜色开始填充进度条 - - - - - 使用渐变填充以此颜色结尾的进度条 - - - - - 使用渐变以此颜色开始填充渐满进度条 - - - - - 使用渐变填充以此颜色结尾的渐满进度条 - - - - - 无论列变得多宽，进度条都不会比这个宽。 - - - - - 无论单元格有多高，进度条都不会比这个高 - - - - - 预期的最小数据值。小于此值的值将显示一个空条。 - - - - - 接近满时的值,高于该值时，显示不同颜色，小于等于MinimumValue或大于MaximumValue值，则表示未设置该值 - - - - - 范围的最大值。大于此值的值将给出一个完整的条形。 - - - - - The Pen that will draw the frame surrounding this bar - - - - - The brush that will be used to fill the bar - - - - - The brush that will be used to fill the bar - - - - - The brush that will be used to fill the background of the bar - - - - - Draw this progress bar using a gradient - - - - - - - Draw our aspect - - - - - - - Handle the GetEditRectangle request - - - - - - - - - - - An ImagesRenderer draws zero or more images depending on the data returned by its Aspect. - - This renderer's Aspect must return a ICollection of ints, strings or Images, - each of which will be drawn horizontally one after the other. - As of v2.1, this functionality has been absorbed into ImageRenderer and this is now an - empty shell, solely for backwards compatibility. - - - - - A MultiImageRenderer draws the same image a number of times based on our data value - - The stars in the Rating column of iTunes is a good example of this type of renderer. - - - - Make a quiet renderer - - - - - Make an image renderer that will draw the indicated image, at most maxImages times. - - - - - - - - - The index of the image that should be drawn - - - - - The name of the image that should be drawn - - - - - The image selector that will give the image to be drawn - - Like all image selectors, this can be an int, string or Image - - - - What is the maximum number of images that this renderer should draw? - - - - - Values less than or equal to this will have 0 images drawn - - - - - Values greater than or equal to this will have MaxNumberImages images drawn - - - - - Draw our data value - - - - - - - A class to render a value that contains a bitwise-OR'ed collection of values. - - - - - Register the given image to the given value - - When this flag is present... - ...draw this image - - - - Draw the flags - - - - - - - Do the actual work of hit testing. Subclasses should override this rather than HitTest() - - - - - - - - - This renderer draws an image, a single line title, and then multi-line description - under the title. - - - This class works best with FullRowSelect = true. - It's not designed to work with cell editing -- it will work but will look odd. - - It's not RightToLeft friendly. - - - - - - Create a DescribedTaskRenderer - - - - - Should text be rendered using GDI routines? This makes the text look more - like a native List view control. - - - - - Gets or set the font that will be used to draw the title of the task - - If this is null, the ListView's font will be used - - - - Return a font that has been set for the title or a reasonable default - - - - - Gets or set the color of the title of the task - - This color is used when the task is not selected or when the listview - has a translucent selection mechanism. - - - - Return the color of the title of the task or a reasonable default - - - - - Gets or set the font that will be used to draw the description of the task - - If this is null, the ListView's font will be used - - - - Return a font that has been set for the title or a reasonable default - - - - - Gets or set the color of the description of the task - - This color is used when the task is not selected or when the listview - has a translucent selection mechanism. - - - - Return the color of the description of the task or a reasonable default - - - - - Gets or sets the number of pixels that will be left between the image and the text - - - - - 顶部留白像素 - - - - - Gets or sets the number of pixels that will be left between the title and the description - - - - - Gets or sets the name of the aspect of the model object that contains the task description - - - - - Gets or sets the filter that is filtering the ObjectListView and for - which this renderer should highlight text - - - - - When a filter changes, keep track of the text matching filters - - - - - Fetch the description from the model class - - - - - - - - - - - - - - - Draw our item - - - - - - - Draw the task - - - - - - - - - - Handle the HitTest request - - - - - - - - - This renderer draws a functioning button in its cell - - - - - Gets or sets how each button will be sized - - - - - Gets or sets the size of the button when the SizingMode is FixedBounds - - If this is not set, the bounds of the cell will be used - - - - Gets or sets the extra space that surrounds the cell when the SizingMode is TextBounds - - - - - Gets or sets the maximum width that a button can occupy. - -1 means there is no maximum width. - - This is only considered when the SizingMode is TextBounds - - - - Gets or sets the minimum width that a button can occupy. - -1 means there is no minimum width. - - This is only considered when the SizingMode is TextBounds - - - - 获取或设置此列按钮的字体颜色(如果有按钮的话) - - - - - 获取或设置此列按钮的背景颜色(如果有按钮的话) - - - - - 获取或设置此列按钮的边框颜色(如果有按钮的话) - - - - - 获取或设置此列按钮的内边框颜色(如果有按钮的话) - - - - - 获取或设置此列按钮是否画边框(如果有按钮的话) - - - - - Calculate the size of the contents - - - - - - - - Draw the button - - - - - - - What part of the control is under the given point? - - - - - - - - - - What is the state of the button? - - - - - - Is the mouse over the button? - - - - - The common interface supported by all style objects - - - - - Gets or set the font that will be used by this style - - - - - Gets or set the font style - - - - - Gets or sets the ForeColor - - - - - Gets or sets the BackColor - - - - - Basic implementation of IItemStyle - - - - - Gets or sets the font that will be applied by this style - - - - - Gets or sets the style of font that will be applied by this style - - - - - Gets or sets the color of the text that will be applied by this style - - - - - Gets or sets the background color that will be applied by this style - - - - - Instances of this class specify how should "hot items" (non-selected - rows under the cursor) be renderered. - - - - - Gets or sets the overlay that should be drawn as part of the hot item - - - - - Gets or sets the decoration that should be drawn as part of the hot item - - A decoration is different from an overlay in that an decoration - scrolls with the listview contents, whilst an overlay does not. - - - - This class defines how a cell should be formatted - - - - - Gets or sets the font that will be applied by this style - - - - - Gets or sets the style of font that will be applied by this style - - - - - Gets or sets the color of the text that will be applied by this style - - - - - Gets or sets the background color that will be applied by this style - - - - - Instances of this class describe how hyperlinks will appear - - - - - Create a HyperlinkStyle - - - - - What sort of formatting should be applied to hyperlinks in their normal state? - - - - - What sort of formatting should be applied to hyperlinks when the mouse is over them? - - - - - What sort of formatting should be applied to hyperlinks after they have been clicked? - - - - - Gets or sets the cursor that should be shown when the mouse is over a hyperlink. - - - - - Instances of this class control one the styling of one particular state - (normal, hot, pressed) of a header control - - - - - Gets or sets the font that will be applied by this style - - - - - Gets or sets the color of the text that will be applied by this style - - - - - Gets or sets the background color that will be applied by this style - - - - - Gets or sets the color in which a frame will be drawn around the header for this column - - - - - Gets or sets the width of the frame that will be drawn around the header for this column - - - - - This class defines how a header should be formatted in its various states. - - - - - Create a new HeaderFormatStyle - - - - - What sort of formatting should be applied to a column header when the mouse is over it? - - - - - What sort of formatting should be applied to a column header in its normal state? - - - - - What sort of formatting should be applied to a column header when pressed? - - - - - Set the font for all three states - - - - - - Set the fore color for all three states - - - - - - Set the back color for all three states - - - - - - 正常为选中按钮 - - - - - 获得焦点的按钮 - - - - - 鼠标经过样式 - - - - - 获得焦点并鼠标经过 - - - - - 自定义GDI工具，绘制按钮 - - - - - 绘制圆形按钮（用法同矩形按钮） - - - - - - - - - - 绘制圆角按钮 - - 要绘制的文字 - Graphics 对象 - 要填充的矩形 - - - - - 根据普通矩形得到圆角矩形的路径 - - 原始矩形 - 半径 - 图形路径 - - - - A GlassPanelForm sits transparently over an ObjectListView to show overlays. - - - - - Get the low-level windows flag that will be given to CreateWindow. - - - - - Attach this form to the given ObjectListView - - - - - Made the overlay panel invisible - - - - - Show the overlay panel in its correctly location - - - If the panel is always shown, this method does nothing. - If the panel is being resized, this method also does nothing. - - - - - Detach this glass panel from its previous ObjectListView - - - You should unbind the overlay panel before making any changes to the - widget hierarchy. - - - - - Handle when the form that owns the ObjectListView begins to be resized - - - - - - - Handle when the form that owns the ObjectListView finished to be resized - - - - - - - The owning form has moved. Move the overlay panel too. - - - - - - - The owning form is resizing. Hide our overlay panel until the resizing stops - - - - - - - Handle when the bound OLV changes its location. The overlay panel must - be moved too, IFF it is currently visible. - - - - - - - Handle when the bound OLV changes size. The overlay panel must - resize too, IFF it is currently visible. - - - - - - - Handle when the bound OLV is part of a TabControl and that - TabControl changes tabs. The overlay panel is hidden. The - first time the bound OLV is redrawn, the overlay panel will - be shown again. - - - - - - - Somewhere the parent of the bound OLV has changed. Update - our events. - - - - - - - Handle when the bound OLV changes its visibility. - The overlay panel should match the OLV's visibility. - - - - - - - Class used to capture window messages for the header of the list view - control. - - - - - Create a header control for the given ObjectListView. - - - - - - Return the index of the column under the current cursor position, - or -1 if the cursor is not over a column - - Index of the column under the cursor, or -1 - - - - 返回此控件的Windows句柄 - - - 当ObjectListView被初始化为UserControl的一部分时，GetHeaderControl()方法返回0，直到UserControl完全初始化。 - 因此，构造函数中的AssignHandle()调用不起作用。因此，我们覆盖了Handle属性，以便值始终为当前值。 - - - - - Gets or sets a style that should be applied to the font of the - column's header text when the mouse is over that column - - THIS IS EXPERIMENTAL. USE AT OWN RISK. August 2009 - - - - 如果光标位于其复选框上，则获取光标下列的索引 - - - - - Gets the client rectangle for the header - - - - - 如果给定坐标点在给定列的复选框上方，则返回TRUE。 - - - - - - - - 获取光标是否位于“锁定”的分隔线上，即用户无法拖动的分隔线。 - - - - - 获取或设置此标头所属的列表视图 - - - - - 获取标题的最大高度。-1表示没有最大值。 - - - - - 获取标题的最小高度。-1表示没有最低要求。 - - - - - Get or set the ToolTip that shows tips for the header - - - - - 获取或设置当列标题中的文本太长而无法放入列中时，是否应对其进行自动换行 - - - - - Calculate how height the header needs to be - - Height in pixels - - - - Get the bounds of the checkbox against the given column - - - - - - - Should the given column be drawn with a checkbox against it? - - - - - - - Should the given column show a sort indicator? - - - - - - - Should the given column be drawn with a filter indicator against it? - - - - - - - Should the given column show a non-themed sort indicator? - - - - - - - Return the bounds of the item with the given index - - - - - - - Return the bounds within which the given column will be drawn - - - - - - - Force the header to redraw by invalidating it - - - - - Force the header to redraw a single column by invalidating it - - - - - Create a native tool tip control for this listview - - - - - Override the basic message pump - - - - - - Handle the LButtonDown windows message - - - - - - - Handle the LButtonUp windows message - - - - - - - Handle the SetCursor windows message - - - - - - - Handle the MouseMove windows message - - - - - - - Handle the MouseLeave windows message - - - - - - - Handle the Notify windows message - - - - - - - Handle the CustomDraw windows message - - - - - - - The message divides a ListView's space between the header and the rows of the listview. - The WINDOWPOS structure controls the headers bounds, the RECT controls the listview bounds. - - - - - - - Handle when the underlying header control is destroyed - - - - - - - Does this header need to be custom drawn? - - Word wrapping and colored text require custom drawning. Funnily enough, we - can change the font natively. - - - - Draw one cell of the header - - - - - - - - Draw a background for the header, without using Themes. - - - - - - - - - - - Draw a more-or-less pure themed header background. - - - - - - - - - - Draw a sort indicator using themes - - - - - - - Draw a sort indicator without using themes - - - - - - - - Draw an indication that this column has a filter applied to it - - - - - - - - Draw the header's image and text - - - - - - - - - Return the header format that should be used for the given column - - - - - - - What style should be applied to the header? - - - - - - - - - What font should be used to draw the header text? - - - - - - - - - What flags will be used when drawing text - - - - - Perform a HitTest for the header control - - - - Null if the given point isn't over the header - - - - Instances of this class put a CheckedListBox into a tool strip menu item. - - - - - Create a ToolStripCheckedListBox - - - - - Gets the control embedded in the menu - - - - - Gets the items shown in the checkedlistbox - - - - - Gets or sets whether an item should be checked when it is clicked - - - - - Gets a collection of the checked items - - - - - Add a possibly checked item to the control - - - - - - - Add an item with the given state to the control - - - - - - - Gets the checkedness of the i'th item - - - - - - - Set the checkedness of the i'th item - - - - - - - Check all the items in the control - - - - - Unchecked all the items in the control - - - - - Listen for events on the underlying control - - - - - - Stop listening for events on the underlying control - - - - - - Tell the world that an item was checked - - - - - Trigger the ItemCheck event - - - - - - - A limited wrapper around a Windows tooltip window. - - - - - These are the standard icons that a tooltip can display. - - - - - No icon - - - - - Info - - - - - Warning - - - - - Error - - - - - Large info (Vista and later only) - - - - - Large warning (Vista and later only) - - - - - Large error (Vista and later only) - - - - - - - - - - - - - - - - - - - - - - - - - Get or set if the style of the tooltip control - - - - - Get or set if the tooltip should be shown as a ballon - - - - - Get or set if the tooltip should be shown as a ballon - - - - - Get or set the background color of the tooltip - - - - - Get or set the color of the text and border on the tooltip. - - - - - Get or set the title that will be shown on the tooltip. - - - - - Get or set the icon that will be shown on the tooltip. - - - - - Gets or sets the font that will be used to draw this control. - is still. - - Setting this to null reverts to the default font. - - - - Gets or sets how many milliseconds the tooltip will remain visible while the mouse - is still. - - - - - Gets or sets how many milliseconds the mouse must be still before the tooltip is shown. - - - - - Gets or sets how many milliseconds the mouse must be still before the tooltip is shown again. - - - - - Create the underlying control. - - The parent of the tooltip - This does nothing if the control has already been created - - - - Take a copy of the current settings and restore them when the - tooltip is poppped. - - - This call cannot be nested. Subsequent calls to this method will be ignored - until PopSettings() is called. - - - - - Restore the settings of the tooltip as they were when PushSettings() - was last called. - - - - - Add the given window to those for whom this tooltip will show tips - - The window - - - - Hide any currently visible tooltip - - - - - - Remove the given window from those managed by this tooltip - - - - - - Set the maximum width of a tooltip string. - - - - - Set the maximum width of a tooltip string. - - Setting this ensures that line breaks in the tooltip are honoured. - - - - Make a TOOLINFO structure for the given window - - - A filled in TOOLINFO - - - - Handle a WmNotify message - - The msg - True if the message has been handled - - - - Handle a get display info message - - The msg - True if the message has been handled - - - - Handle a TTN_LINKCLICK message - - The msg - True if the message has been handled - This cannot call base.WndProc() since the msg may have come from another control. - - - - Handle a TTN_POP message - - The msg - True if the message has been handled - This cannot call base.WndProc() since the msg may have come from another control. - - - - Handle a TTN_SHOW message - - The msg - True if the message has been handled - This cannot call base.WndProc() since the msg may have come from another control. - - - - Handle a reflected notify message - - The msg - True if the message has been handled - - - - Mess with the basic message pump of the tooltip - - - - - - Tell the world that a tooltip is about to show - - - - - Tell the world that a tooltip is about to disappear - - - - - - - - - - - - - - - - - This form is an example of how an application could allows the user to select which columns - an ObjectListView will display, as well as select which order the columns are displayed in. - - - In Tile view, ColumnHeader.DisplayIndex does nothing. To reorder the columns you have - to change the order of objects in the Columns property. - Remember that the first column is special! - It has to remain the first column. - - - - - Make a new ColumnSelectionForm - - - - - Open this form so it will edit the columns that are available in the listview's current view - - The ObjectListView whose columns are to be altered - - - - Open this form so it will edit the columns that are available in the given listview - when the listview is showing the given type of view. - - The ObjectListView whose columns are to be altered - The view that is to be altered. Must be View.Details or View.Tile - - - - Initialize the form to show the columns of the given view - - - - - - - The user has pressed OK. Do what's requied. - - - - - - - Enable the controls on the dialog to match the current state - - - - - A Comparer that will sort a list of columns so that visible ones come before hidden ones, - and that are ordered by their display order. - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - An object that implements the IGenerator interface provides the ability - to dynamically create columns - for an ObjectListView based on the characteristics of a given collection - of model objects. - - - - - Generate columns into the given ObjectListView that come from the given - model object type. - - The ObjectListView to modify - The model type whose attributes will be considered. - Will columns be generated for properties that are not marked with [OLVColumn]. - - - - Generate a list of OLVColumns based on the attributes of the given type - If allProperties to true, all public properties will have a matching column generated. - If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. - - - Will columns be generated for properties that are not marked with [OLVColumn]. - A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. - - - - The Generator class provides methods to dynamically create columns - for an ObjectListView based on the characteristics of a given collection - of model objects. - - - For a given type, a Generator can create columns to match the public properties - of that type. The generator can consider all public properties or only those public properties marked with - [OLVColumn] attribute. - - - - - Gets or sets the actual generator used by the static convinence methods. - - If you subclass the standard generator or implement IGenerator yourself, - you should install an instance of your subclass/implementation here. - - - - Replace all columns of the given ObjectListView with columns generated - from the first member of the given enumerable. If the enumerable is - empty or null, the ObjectListView will be cleared. - - The ObjectListView to modify - The collection whose first element will be used to generate columns. - - - - Replace all columns of the given ObjectListView with columns generated - from the first member of the given enumerable. If the enumerable is - empty or null, the ObjectListView will be cleared. - - The ObjectListView to modify - The collection whose first element will be used to generate columns. - Will columns be generated for properties that are not marked with [OLVColumn]. - - - - Generate columns into the given ObjectListView that come from the public properties of the given - model object type. - - The ObjectListView to modify - The model type whose attributes will be considered. - - - - Generate columns into the given ObjectListView that come from the public properties of the given - model object type. - - The ObjectListView to modify - The model type whose attributes will be considered. - Will columns be generated for properties that are not marked with [OLVColumn]. - - - - Generate a list of OLVColumns based on the public properties of the given type - that have a OLVColumn attribute. - - - A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. - - - - Generate columns into the given ObjectListView that come from the given - model object type. - - The ObjectListView to modify - The model type whose attributes will be considered. - Will columns be generated for properties that are not marked with [OLVColumn]. - - - - Generate a list of OLVColumns based on the attributes of the given type - If allProperties to true, all public properties will have a matching column generated. - If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. - - - Will columns be generated for properties that are not marked with [OLVColumn]. - A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. - - - - Replace all the columns in the given listview with the given list of columns. - - - - - - - Post process columns after creating them and adding them to the AllColumns collection. - - - - - - Create a column from the given PropertyInfo and OLVColumn attribute - - - - - - - - Make a column from the given PropertyInfo - - - - - - - Make a column from the given PropertyDescriptor - - - - - - - Create a column with all the given information - - - - - - - - - - - Create a column. - - - - - - - - - Convert a property name to a displayable title. - - - - - - - Configure the given column to show a checkbox if appropriate - - - - - - - If this given type has an property marked with [OLVChildren], make delegates that will - traverse that property as the children of an instance of the model - - - - - - - Generate CanExpand and ChildrenGetter delegates from the given property. - - - - - - - An OLVExporter converts a collection of rows from an ObjectListView - into a variety of textual formats. - - - - - What format will be used for exporting - - - - - Tab separated values, according to http://www.iana.org/assignments/media-types/text/tab-separated-values - - - - - Alias for TabSeparated - - - - - Comma separated values, according to http://www.ietf.org/rfc/rfc4180.txt - - - - - HTML table, according to me - - - - - Create an empty exporter - - - - - Create an exporter that will export all the rows of the given ObjectListView - - - - - - Create an exporter that will export all the given rows from the given ObjectListView - - - - - - - Gets or sets whether hidden columns will also be included in the textual - representation. If this is false (the default), only visible columns will - be included. - - - - - Gets or sets whether column headers will also be included in the text - and HTML representation. Default is true. - - - - - Gets the ObjectListView that is being used as the source of the data - to be exported - - - - - Gets the model objects that are to be placed in the data object - - - - - Export the nominated rows from the nominated ObjectListView. - Returns the result in the expected format. - - - - This will perform only one conversion, even if called multiple times with different formats. - - - - Convert - - - - - Encode a string such that it can be used as a value in a CSV file. - This basically means replacing any quote mark with two quote marks, - and enclosing the whole string in quotes. - - - - - - - HTML-encodes a string and returns the encoded string. - - The text string to encode. - The HTML-encoded text. - Taken from http://www.west-wind.com/weblog/posts/2009/Feb/05/Html-and-Uri-String-Encoding-without-SystemWeb - - - - A TypedObjectListView is a type-safe wrapper around an ObjectListView. - - - VCS does not support generics on controls. It can be faked to some degree, but it - cannot be completely overcome. In our case in particular, there is no way to create - the custom OLVColumn's that we need to truly be generic. So this wrapper is an - experiment in providing some type-safe access in a way that is useful and available today. - A TypedObjectListView is not more efficient than a normal ObjectListView. - Underneath, the same name of casts are performed. But it is easier to use since you - do not have to write the casts yourself. - - - The class of model object that the list will manage - - To use a TypedObjectListView, you write code like this: - - TypedObjectListView<Person> tlist = new TypedObjectListView<Person>(this.listView1); - tlist.CheckStateGetter = delegate(Person x) { return x.IsActive; }; - tlist.GetColumn(0).AspectGetter = delegate(Person x) { return x.Name; }; - ... - - To iterate over the selected objects, you can write something elegant like this: - - foreach (Person x in tlist.SelectedObjects) { - x.GrantSalaryIncrease(); - } - - - - - - Create a typed wrapper around the given list. - - The listview to be wrapped - - - - Return the model object that is checked, if only one row is checked. - If zero rows are checked, or more than one row, null is returned. - - - - - Return the list of all the checked model objects - - - - - The ObjectListView that is being wrapped - - - - - Get or set the list of all model objects - - - - - Return the model object that is selected, if only one row is selected. - If zero rows are selected, or more than one row, null is returned. - - - - - The list of model objects that are selected. - - - - - Return a typed wrapper around the column at the given index - - The index of the column - A typed column or null - - - - Return a typed wrapper around the column with the given name - - The name of the column - A typed column or null - - - - Return the model object at the given index - - The index of the model object - The model object or null - - - - CheckStateGetter - - - - - - - Gets or sets the check state getter - - - - - BooleanCheckStateGetter - - - - - - - Gets or sets the boolean check state getter - - - - - CheckStatePutter - - - - - - - - Gets or sets the check state putter delegate - - - - - BooleanCheckStatePutter - - - - - - - - Gets or sets the boolean check state putter - - - - - ToolTipGetter - - - - - - - - Gets or sets the cell tooltip getter - - - - - Gets or sets the header tool tip getter - - - - - This method will generate AspectGetters for any column that has an AspectName. - - - - - A type-safe wrapper around an OLVColumn - - - - - - Creates a TypedColumn - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Generate an aspect getter that does the same thing as the AspectName, - except without using reflection. - - - - If you have an AspectName of "Owner.Address.Postcode", this will generate - the equivilent of: this.AspectGetter = delegate (object x) { - return x.Owner.Address.Postcode; - } - - - - If AspectName is empty, this method will do nothing, otherwise - this will replace any existing AspectGetter. - - - - - - Generates an aspect getter method dynamically. The method will execute - the given dotted chain of selectors against a model object given at runtime. - - The type of model object to be passed to the generated method - A dotted chain of selectors. Each selector can be the name of a - field, property or parameter-less method. - A typed delegate - - - - This method generates the actual IL for the method. - - - - - - - - A virtual object list view operates in virtual mode, that is, it only gets model objects for - a row when it is needed. This gives it the ability to handle very large numbers of rows with - minimal resources. - - A listview is not a great user interface for a large number of items. But if you've - ever wanted to have a list with 10 million items, go ahead, knock yourself out. - Virtual lists can never iterate their contents. That would defeat the whole purpose. - Animated GIFs should not be used in virtual lists. Animated GIFs require some state - information to be stored for each animation, but virtual lists specifically do not keep any state information. - In any case, you really do not want to keep state information for 10 million animations! - - Although it isn't documented, .NET virtual lists cannot have checkboxes. This class codes around this limitation, - but you must use the functions provided by ObjectListView: CheckedObjects, CheckObject(), UncheckObject() and their friends. - If you use the normal check box properties (CheckedItems or CheckedIndicies), they will throw an exception, since the - list is in virtual mode, and .NET "knows" it can't handle checkboxes in virtual mode. - - Due to the limits of the underlying Windows control, virtual lists do not trigger ItemCheck/ItemChecked events. - Use a CheckStatePutter instead. - To enable grouping, you must provide an implmentation of IVirtualGroups interface, via the GroupingStrategy property. - Similarly, to enable filtering on the list, your VirtualListDataSource must also implement the IFilterableDataSource interface. - - - - - Create a VirtualObjectListView - - - - - Gets whether or not this listview is capabale of showing groups - - - - - Get or set the collection of model objects that are checked. - When setting this property, any row whose model object isn't - in the given collection will be unchecked. Setting to null is - equivilent to unchecking all. - - - - This property returns a simple collection. Changes made to the returned - collection do NOT affect the list. This is different to the behaviour of - CheckedIndicies collection. - - - When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. - When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus - the number of objects to be checked. - - - If the ListView is not currently showing CheckBoxes, this property does nothing. It does - not remember any check box settings made. - - - This class optimizes the management of CheckStates so that it will work efficiently even on - large lists of item. However, those optimizations are impossible if you install a CheckStateGetter. - With a CheckStateGetter installed, the performance of this method is O(n) where n is the size - of the list. This could be painfully slow. - - - - - Gets or sets whether or not an object will be included in the CheckedObjects - collection, even if it is not present in the control at the moment - - - This property is an implementation detail and should not be altered. - - - - - Gets the collection of objects that survive any filtering that may be in place. - - - - - Gets or sets the strategy that will be used to create groups - - - This must be provided for a virtual list to show groups. - - - - - Gets whether or not the current list is filtering its contents - - - This is only possible if our underlying data source supports filtering. - - - - - Get/set the collection of objects that this list will show - - - - The contents of the control will be updated immediately after setting this property. - - Setting this property preserves selection, if possible. Use SetObjects() if - you do not want to preserve the selection. Preserving selection is the slowest part of this - code -- performance is O(n) where n is the number of selected rows. - This method is not thread safe. - The property DOES work on virtual lists, but if you try to iterate through a list - of 10 million objects, it may take some time :) - - - - - This delegate is used to fetch a rowObject, given it's index within the list - - Only use this property if you are not using a VirtualListDataSource. - - - - Should this list show its items in groups? - - - - - Get/set the data source that is behind this virtual list - - Setting this will cause the list to redraw. - - - - Gets or sets the number of rows in this virtual list. - - - There is an annoying feature/bug in the .NET ListView class. - When you change the VirtualListSize property, it always scrolls so - that the focused item is the top item. This is annoying since it makes - the virtual list seem to flicker as the control scrolls to show the focused - item and then scrolls back to where ObjectListView wants it to be. - - - - - Return the number of items in the list - - the number of items in the list - - - - Return the model object at the given index - - Index of the model object to be returned - A model object - - - - Find the given model object within the listview and return its index - - The model object to be found - The index of the object. -1 means the object was not present - - - - Return the OLVListItem that displays the given model object - - The modelObject whose item is to be found - The OLVListItem that displays the model, or null - This method has O(n) performance. - - - - Add the given collection of model objects to this control. - - A collection of model objects - - The added objects will appear in their correct sort position, if sorting - is active. Otherwise, they will appear at the end of the list. - No check is performed to see if any of the objects are already in the ListView. - Null objects are silently ignored. - - - - - Remove all items from this list - - This method can safely be called from background threads. - - - - Scroll the listview so that the given group is at the top. - - The index of the group to be revealed - - If the group is already visible, the list will still be scrolled to move - the group to the top, if that is possible. - - This only works when the list is showing groups (obviously). - - - - - Inserts the given collection of model objects to this control at hte given location - - - A collection of model objects - - The added objects will appear in their correct sort position, if sorting - is active. Otherwise, they will appear at the given position of the list. - No check is performed to see if any of the objects are already in the ListView. - Null objects are silently ignored. - - - - - Update the rows that are showing the given objects - - This method does not resort the items. - - - - Update the rows that are selected - - This method does not resort or regroup the view. - - - - Remove all of the given objects from the control - - Collection of objects to be removed - - Nulls and model objects that are not in the ListView are silently ignored. - Due to problems in the underlying ListView, if you remove all the objects from - the control using this method and the list scroll vertically when you do so, - then when you subsequenially add more objects to the control, - the vertical scroll bar will become confused and the control will draw one or more - blank lines at the top of the list. - - - - - Select the row that is displaying the given model object. All other rows are deselected. - - Model object to select - Should the object be focused as well? - - - - Select the rows that is displaying any of the given model object. All other rows are deselected. - - A collection of model objects - This method has O(n) performance where n is the number of model objects passed. - Do not use this to select all the rows in the list -- use SelectAll() for that. - - - - Set the collection of objects that this control will show. - - - Should the state of the list be preserved as far as is possible. - - - - Get the checkedness of an object from the model. Returning null means the - model does know and the value from the control will be used. - - - - - - - Rebuild the list with its current contents. - - - Invalidate any cached information when we rebuild the list. - - - - - Clear any cached info this list may have been using - - - - - Do the work of creating groups for this control - - - - - - Do the plumbing to disable groups on a virtual list - - - - - Do the plumbing to enable groups on a virtual list - - - - - Return the position of the given itemIndex in the list as it currently shown to the user. - If the control is not grouped, the display order is the same as the - sorted list order. But if the list is grouped, the display order is different. - - - - - - - Return the last item in the order they are shown to the user. - If the control is not grouped, the display order is the same as the - sorted list order. But if the list is grouped, the display order is different. - - - - - - Return the n'th item (0-based) in the order they are shown to the user. - If the control is not grouped, the display order is the same as the - sorted list order. But if the list is grouped, the display order is different. - - - - - - - Return the ListViewItem that appears immediately after the given item. - If the given item is null, the first item in the list will be returned. - Return null if the given item is the last item. - - The item that is before the item that is returned, or null - A OLVListItem - - - - Return the ListViewItem that appears immediately before the given item. - If the given item is null, the last item in the list will be returned. - Return null if the given item is the first item. - - The item that is before the item that is returned - A ListViewItem - - - - Make a list of groups that should be shown according to the given parameters - - - - - - - Create a OLVListItem for given row index - - The index of the row that is needed - An OLVListItem - - - - On virtual lists, this cannot work. - - - - - Record the change of checkstate for the given object in the model. - This does not update the UI -- only the model - - - - The check state that was recorded and that should be used to update - the control. - - - - Refresh the given item in the list - - The item to refresh - - - - Change the size of the list - - - - - - Take ownership of the 'objects' collection. This separates our collection from the source. - - - - This method - separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject - calls will modify our collection and not the original colleciton. - - - VirtualObjectListViews always own their collections, so this is a no-op. - - - - - - Change the state of the control to reflect changes in filtering - - - - - Change the size of the virtual list so that it matches its data source - - - - - Handle the CacheVirtualItems event - - - - - - - Handle a RetrieveVirtualItem - - - - - - - Handle the SearchForVirtualList event, which is called when the user types into a virtual list - - - - - - - Find the first row in the given range of rows that prefix matches the string value of the given column. - - - - - - The index of the matched row, or -1 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 初始化的时候给个alpha值,这样在灰图片的时候可以半透明 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 使图片单色化 - - - - - - - - - - - - 自定义 - - - - - 预置 - - - - - 系统 - - - - - 颜色表示法 - - - - - 根据颜色表示字符串获取对应的颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - 从文件中获取Image对象 - 这个函数的主要功能是处理一些ico文件 - 一些ico文件的格式可能比较新，直接Image.FormFile，会报内存不足的异常 - - - 是否将文件读入内存操作，如果为false,将直接返回Image.FromFile，在此情况下， - 必须手动释放Image对象，否则文件将一直处于占用状态，如果为true,则在内存中拷贝副本 - - - - - - 将图像转为Icon对象,使用png格式 - - - - - - - 将图像转为Icon对象 - - - - - - - - 返回适应指定容器大小的图像 - 如果图像的尺寸(长或宽)超出了容器范围,将按比例获取图像的缩略图返回,否则直接返回图像 - 此方法最终调用 Image.GetThumbnailImage - 但是注意,在指定的容器尺寸过小时,返回的Image尺寸不可知,是在为了显示16x16的小缩略图是发现了此问题 - 使用 GetScaleImage - - - - - - - - - 返回适应指定容器大小的图像 - 在需要的情况下,此方法创建一个新对象,进行绘制 - - - - - - - - 返回适应指定容器大小的图像 - 在需要的情况下,此方法创建一个新对象,进行绘制 - - - - - - - - - Gets the bounding rectangle of an image required to fit - in to the given rectangle keeping the image aspect ratio. - - The source image. - The rectangle to fit in to. - Horizontal image aligment in percent. - Vertical image aligment in percent. - New image size. - - - - Gets the bounding rectangle of an image required to fit - in to the given rectangle keeping the image aspect ratio. - The image will be centered in the fit box. - - The source image. - The rectangle to fit in to. - New image size. - - - - Gets the scaled size of an image required to fit - in to the given size keeping the image aspect ratio. - - The source image. - The size to fit in to. - New image size. - - - - 获取一个圆角矩形 - - - - 角度 - - - - - 获取一个圆角矩形 - - - 角度 - - - - - - - - - - - - - - - - - - - - - - 返回一个表示箭头的Path - 如果开始坐标和结束坐标之间的距离大于箭头的大小，箭头向结束坐标对齐，顶着结束坐标 - - 开始坐标 - 结束坐标（顶点，方向） - 箭头的长短，大小 - 箭头的粗细 - - - - - 在指定的Image上绘制特定标记 - - - - - 文件不存在 - - - - - - 文件不存在 - - - - - - 无法读取文件 - - - - - - - - - - - - - - - - - - - - - 验证失败中显示错误信息时用的标题 - - - - - 验证失败时是否需要高亮显示（改变背景色） - - - - - 验证控件的输入 - - - - - - - 自定义验证方法 - 在基础验证都通过后，才会调用自定义验证方法（如果有） - - - - - - - - - - 是否支持 Windows Vista 以上的玻璃效果 - - - - - 是否打开了玻璃效果 - - - - - 获取应用程序主窗体 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 这个缓存是全局的 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 所对应的绑定数据类型 - - - - - 是否对 DataBoundType 的子类型有效 - 默认无效 - 如果设置为 true，又同时添加了基类与子类的 codon，则运行时会取到哪个codon不确定 - 通常取先添加的那个 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 获取授予该组件的许可证密钥 - - - - - 0:未验证 - 1:验证失败 - 2:验证通过 - - - - - 获取组件的实例或类型的许可证（如果已给定上下文并确定拒绝许可证是否引发异常）。 - - - - - - - - - - 强类型资源类，用于查找本地化字符串等。 - - - - - - - - - - 返回此类使用的缓存 ResourceManager 实例。 - - - - - 为使用此强类型资源类的所有资源查找 - 重写当前线程的 CurrentUICulture 属性。 - - - - - 查找类似 消息 的本地化字符串。 - - - - - 查找类似 底部 的本地化字符串。 - - - - - 查找类似 顶部 的本地化字符串。 - - - - - 查找类似 更大 (48x48) 的本地化字符串。 - - - - - 查找类似 大 (32x32) 的本地化字符串。 - - - - - 查找类似 中 (24x24) 的本地化字符串。 - - - - - 查找类似 小 (16x16) 的本地化字符串。 - - - - - Returns true if the current language is the default language. - - - - - Returns a System.String that represents the current System.Object. - - - - - - - - - - 返回此类使用的缓存 ResourceManager 实例。 - - - - - 为使用此强类型资源类的所有资源查找 - 重写当前线程的 CurrentUICulture 属性。 - - - - - 查找类似 消息 的本地化字符串。 - - - - - 查找类似 底部 的本地化字符串。 - - - - - 查找类似 顶部 的本地化字符串。 - - - - - 查找类似 更大 (48x48) 的本地化字符串。 - - - - - 查找类似 大 (32x32) 的本地化字符串。 - - - - - 查找类似 中 (24x24) 的本地化字符串。 - - - - - 查找类似 小 (16x16) 的本地化字符串。 - - - - - Returns true if the current language is the default language. - - - - - - - - - - Call GetLanguages() to retrieve a list of possible languages that can be used to set this property. - The default value is the default language. - - - - - Gets a list of available languages defined in this assembly. - - - - - - - - - - - - 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 - - - - - - - Represents a pop-up window. - - - - - Gets the content of the pop-up. - - - - - Determines which animation to use while showing the pop-up window. - - - - - Determines which animation to use while hiding the pop-up window. - - - - - Determines the duration of the animation. - - - - - Gets or sets a value indicating whether the content should receive the focus after the pop-up has been opened. - - true if the content should be focused after the pop-up has been opened; otherwise, false. - If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. - - - - Gets or sets a value indicating whether presing the alt key should close the pop-up. - - true if presing the alt key does not close the pop-up; otherwise, false. - - - - Gets or sets a value indicating whether the is resizable. - - true if resizable; otherwise, false. - - - - Gets or sets a minimum size of the pop-up. - - An ordered pair of type representing the width and height of a rectangle. - - - - Gets or sets a maximum size of the pop-up. - - An ordered pair of type representing the width and height of a rectangle. - - - - Gets parameters of a new window. - - An object of type used when creating a new window. - - - - Initializes a new instance of the class. - - The content of the pop-up. - - Pop-up will be disposed immediately after disposion of the content control. - - is null. - - - - Raises the event. - - An that contains the event data. - - - - Processes a dialog box key. - - One of the values that represents the key to process. - - true if the key was processed by the control; otherwise, false. - - - - - Updates the pop-up region. - - - - - Shows the pop-up window below the specified control. - - The control below which the pop-up will be shown. - - When there is no space below the specified control, the pop-up control is shown above it. - - is null. - - - - Shows the pop-up window below the specified area of the specified control. - - The control used to compute screen location of specified area. - The area of control below which the pop-up will be shown. - - When there is no space below specified area, the pop-up control is shown above it. - - is null. - - - - Raises the event. - - An that contains the event data. - - - - Raises the event. - - A that contains the event data. - - - - Raises the event. - - An that contains the event data. - - - - Raises the event. - - A that contains the event data. - - - - Processes Windows messages. - - The Windows to process. - - - - Processes the resizing messages. - - The message. - true, if the WndProc method from the base class shouldn't be invoked. - - - - Paints the sizing grip. - - The instance containing the event data. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - Types of animation of the pop-up window. - - - - - Uses no animation. - - - - - Animates the window from left to right. This flag can be used with roll or slide animation. - - - - - Animates the window from right to left. This flag can be used with roll or slide animation. - - - - - Animates the window from top to bottom. This flag can be used with roll or slide animation. - - - - - Animates the window from bottom to top. This flag can be used with roll or slide animation. - - - - - Makes the window appear to collapse inward if it is hiding or expand outward if the window is showing. - - - - - Uses a slide animation. - - - - - Uses a fade effect. - - - - - Uses a roll animation. - - - - - Uses a default animation. - - - - - Represents a Windows combo box control with a custom popup control attached. - - - - - Initializes a new instance of the class. - - - - - Gets or sets the drop down control. - - The drop down control. - - - - Gets or sets a value indicating whether the combo box is displaying its drop-down portion. - - - true if the drop-down portion is displayed; otherwise, false. The default is false. - - - - - Occurs when the drop-down portion of a is shown. - - - - - Shows the drop down. - - - - - Occurs when the drop-down portion of the is no longer visible. - - - - - Hides the drop down. - - - - - Processes Windows messages. - - The Windows to process. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - This property is not relevant for this class. - This property is not relevant for this class. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - Represents a Windows combo box control which can be used in a popup's content control. - - - - - Initializes a new instance of the PopupControl.ComboBox class. - - - - - Raises the event. - - An that contains the event data. - - - - Raises the event. - - An that contains the event data. - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 白色到灰色的垂直渐变 - - - - - - - - - - This method handles the RenderToolStripBorder event. - - - - - - - - - - - - A ToolstripManager rendering class with advanced control features - - - - - Creates a new EasyRender class for modifications - - - - - - - - - - - - - - - - - - - - Gets the manager to edit and change the appearance of the Toolstrip - - - - - Gets the manager to edit and change the appearance of Toolstrip buttons - - - - - Gets the manager to edit and change the appearance of other Toolstrip controls - - - - - Gets the manager to edit and change the appearance of the Panels - - - - - Gets the manager to edit and change the appearance of the Toolstrip split buttons - - - - - Gets the manager to edit and change the appearance of the Status-bar - - - - - Gets or sets whether to smooth the font text on all controls - - - - - Gets or sets the color of the text if the AlterColor is set to true - - - - - Gets or sets whether to override the font-color on all controls - - - - - Creates a GraphicsPath that appreciates an area where things can be drawn - - The rectangular area which will serve as the base - The curve amount of the corners - - - - - Creates a triangle based on the size and bounds sectors - - The area which the triangle is confined to - The size of the triangle - The direction which the triangle is pointing - - - - - Gets a color array based on the state of a normal button - - The button to check the state of - - - - - - Gets a color array based on the state of a split-button - - The button to check the state of - - - - - - Gets a color array based on the state of a menu-item - - The button to check the state of - - - - - - Gets a color array based on the state of a drop-down button - - The button to check the state of - - - - - - Gets a blending property for a specified type of Toolstrip item - - The Toolstrip item - The type of item this is - - - - - Fills a specified boundary with color - - The Graphics object to draw onto - The boundaries to draw the color - The brush to fill the color - - - - Fills a specified boundary with a gradient with specified colors - - The Graphics object to draw onto - The boundaries to draw the color - The color of the gradient at the top - The color of the gradient at the bottom - - - - Fills a specified boundary with a gradient with specified colors at a given angle - - The Graphics object to draw onto - The boundaries to draw the color - The color of the gradient at the top - The color of the gradient at the bottom - The angle which the gradient is drawn (null defaults to 90f) - - - - Fills a specified boundary with a gradient with specified colors at a given angle and with blending properties - - The Graphics object to draw onto - The boundaries to draw the color - The color of the gradient at the top - The color of the gradient at the bottom - The angle which the gradient is drawn (null defaults to 90f) - The blending options to draw the gradient - - - - Draws a set path with a defined brush - - The Graphics object to draw onto - The path to draw along - The brush to fill the color - - - - Draws a set path with specified colors - - The Graphics object to draw onto - The path to draw along - The area of span the border gradient covers - The color of the gradient at the top - The color of the gradient at the bottom - - - - Draws a set path with specified colors at a given angle - - The Graphics object to draw onto - The path to draw along - The area of span the border gradient covers - The color of the gradient at the top - The color of the gradient at the bottom - The angle which the gradient is drawn (null defaults to 90f) - - - - Draws a set path with specified colors at a given angle with blending properties - - The Graphics object to draw onto - The path to draw along - - The color of the gradient at the top - The color of the gradient at the bottom - The angle which the gradient is drawn (null defaults to 90f) - The blending options to draw the gradient - - - - Draws a Toolstrip button - - The Toolstrip button - The Graphics object to handle - The parent Toolstrip - - - - Draws a Toolstrip button - - The Toolstrip button - The Graphics object to handle - The parent Toolstrip - - - - Draws the Toolstrip background - - The Toolstrip being drawn - The Graphics object to handle - The affected bounds - - - - Draws a Toolstrip split-button - - The Toolstrip split-button - The Graphics object to handle - The parent Toolstrip - - - - Draws the Statusbar background - - The Statusbar being drawn - The Graphics object to handle - The affected bounds - - - - Draws a Menustrip item - - The Menustrip item - The Graphics object to handle - The parent Toolstrip - - - - Covers the button background rendering - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Applies any and all changes made to the Renderer - - - - - A class designed to be used in the EasyRender master control to customize the look and feel of the base Toolstrip - - - - - Creates a new IToolstrip class for customization - - - - - Creates a new IToolstrip class for customization - - The IToolstrip to import the settings from - - - - Disposes of the IToolstrip class and clears all resources related to it - - - - - Gets or sets the color of the Toolstrip background gradient from the top - - - - - Gets or sets the color of the Toolstrip background gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Toolstrip background - If set to null, the Toolstrip will simply draw the gradient - - - - - Gets or sets the angle which the Toolstrip background will be drawn - - - - - Gets or sets the color of the Toolstrip border gradient from the top - - - - - Gets or sets the color of the Toolstrip border gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Toolstrip border - If set to null, the Toolstrip will simply draw the border - - - - - Gets or sets the angle which the Toolstrip border will be drawn - - - - - Gets or sets the curve of the border of the Toolstrip - - - - - Imports the settings from a previous or pre-defined IToolstrip and applies it to the current - - The IToolstrip to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - - - - - - Creates a new IToolstripControls class for customization - - - - - Disposes of the IToolstripControls class and clears all resources related to it - - - - - Gets or sets the color of the Toolstrip seperator on the dark side - - - - - Gets or sets the color of the Toolstrip seperator on the light side - - - - - Gets or sets the height of the Toolstrip seperator control - - - - - Gets or sets the color of the grip dots/line at the top - - - - - Gets or sets the color of the grip shadow - - - - - Gets or sets in what mode the grip will be drawn - - - - - Gets or sets the distance, in pixels, between each grip dot - - - - - Gets or sets the size of the dots or lines for the grip - - - - - Imports the settings from a previous or pre-defined IToolstripControls and applies it to the current - - The IToolstripControls to import the settings from - - - - - - - - - Creates a new IButton class for customization - - - - - Creates a new IButton class for customization - - The IButton to import the settings from - - - - Disposes of the IButton class and clears all resources related to it - - - - - Gets or sets the color of the Button background at the top, when hovered over - - - - - Gets or sets the color of the Button background at the bottom, when hovered over - - - - - Gets or sets the color of the Button background at the top, when clicked - - - - - Gets or sets the color of the Button background at the bottom, when clicked - - - - - Gets or sets the blending that will occur when rendering the Button background - If set to null, the Button will simply draw the gradient - - - - - Gets or sets the angle which the Button background will be drawn - - - - - Gets or sets the color of the Button border gradient from the top - - - - - Gets or sets the color of the Button border gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Button border - If set to null, the Button will simply draw the border - - - - - Gets or sets the angle which the Button border will be drawn - - - - - Gets or sets the color of the inside border - - - - - Gets or sets when to apply the rendering ("Normal" does not apply here) - - - - - Gets or sets the curve of the border of the Button - - - - - Imports the settings from a previous or pre-defined IButton and applies it to the current - - The IButton to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - - - - - - Creates a new IButton class for customization - - - - - Creates a new IButton class for customization - - The IButton to import the settings from - - - - Disposes of the IButton class and clears all resources related to it - - - - - Gets or sets the color of the Button background at the top, when hovered over - - - - - Gets or sets the color of the Button background at the bottom, when hovered over - - - - - Gets or sets the blending that will occur when rendering the Button background - If set to null, the Button will simply draw the gradient - - - - - Gets or sets the angle which the Button background will be drawn - - - - - Gets or sets the color of the Button border gradient from the top - - - - - Gets or sets the color of the Button border gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Button border - If set to null, the Button will simply draw the border - - - - - Gets or sets the angle which the Button border will be drawn - - - - - Gets or sets the color of the inside border - - - - - Gets or sets when to apply the rendering ("Normal" and "Click" do not apply here) - - - - - Gets or sets the curve of the border of the Button - - - - - Imports the settings from a previous or pre-defined IDropDownButton and applies it to the current - - The IDropDownButton to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - - - - - - Creates a new ISplitButton class for customization - - - - - Disposes of the ISplitButton class and clears all resources related to it - - - - - Gets or sets the color of the Button background at the top, when hovered over - - - - - Gets or sets the color of the Button background at the bottom, when hovered over - - - - - Gets or sets the color of the Button background at the top, when clicked - - - - - Gets or sets the color of the Button background at the bottom, when clicked - - - - - Gets or sets the blending that will occur when rendering the Button background - If set to null, the Button will simply draw the gradient - - - - - Gets or sets the angle which the Button background will be drawn - - - - - Gets or sets the color of the Button border gradient from the top - - - - - Gets or sets the color of the Button border gradient from the bottom - - - - - Gets or sets the blending that will occur when rendering the Button border - If set to null, the Button will simply draw the border - - - - - Gets or sets the angle which the Button border will be drawn - - - - - Gets or sets the color of the inside border - - - - - Gets or sets when to apply the rendering ("Normal" does not apply here) - - - - - Gets or sets the curve of the border of the Button - - - - - Gets or sets when to display the drop-down arrow - - - - - Gets or sets the color of the drop-down arrow - - - - - Imports the settings from a previous or pre-defined ISplitButton and applies it to the current - - The ISplitButton to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - - - - - - Creates a new IPanel class for customization - - - - - Disposes of the IButton class and clears all resources related to it - - - - - Gets or sets the color of the gradient at the top of the content panel - - - - - Gets or sets the color of the gradient at the bottom of the content panel - - - - - Gets or sets whether each panel inherits the shading from the content panel - - - - - Gets or sets the angle which the background gradient is drawn - - - - - Gets or sets the blend of the background - - - - - Gets or sets a mode to render the background in - - - - - - - - - - Creates a new IStatusBar class for customization - - - - - Disposes of the IButton class and clears all resources related to it - - - - - Gets or sets the color of the gradient of the background at the top - - - - - Gets or sets the color of the gradient of the background at the bottom - - - - - Gets or sets the blending that will apply to the background - - - - - Gets or sets the angle which the background gradient will be drawn - - - - - Gets or sets the color of the dark border - - - - - Gets or sets the color of the light border - - - - - Gets or sets the color of the grip at the top-most - - - - - Gets or sets the color of the grip at the bottom-most - - - - - Gets or sets the spacing of the grip blocks - - - - - Imports the settings from a previous or pre-defined IStatusBar and applies it to the current - - The IStatusBar to import the settings from - - - - Sets the blending for both border and background to their defaults - - - - - A class designed to be used in the EasyRender master control to customize the look and feel of the base Menustrip - - - - - Creates a new IToolstrip class for customization - - - - - Creates a new IMenustrip class for customization - - The IMenustrip to import the settings from - - - - Disposes of the IMenustrip class and clears all resources related to it - - - - - Gets or sets the color of the menu-strip border (dark) - - - - - Gets or sets the color of the menu-strip border (light) - - - - - Gets or sets how the background of the menu-strip is inherited - - - - - If inheritence is set to none, the color of the background gradient at the top - - - - - If inheritence is set to none, the color of the background gradient at the bottom - - - - - If inheritence is set to none, the blending option for the background - - - - - Gets or sets the color of the margin gradient at the left - - - - - Gets or sets the color of the margin gradient at the right - - - - - Gets or sets the color of the margin border (displayed to the right) - - - - - Gets or sets the color of the root menu-strip button background when it is selected - - - - - Gets or sets the color of the root menu-strip button border when it is selected - - - - - Gets or sets the color of the seperator dark color - - - - - Gets or sets the color of the seperator light color - - - - - Gets or sets the inset position of the seperator from the left - - - - - Gets the class that handles the look and feel of the menu-strip items - - - - - Imports the settings from a previous or pre-defined IMenustrip and applies it to the current - - The IMenustrip to import the settings from - - - - Sets the blending for the background to it's default - - - - - Defines when to show an arrow - - - - - - - - - - - - - - - - - - - - Defines when to use a blend property - - - - - Use the blend when the object is drawn - - - - - Use the blend when the object is hovered over - - - - - Use the blend when the object is clicked - - - - - Use the blend when the object is checked - - - - - Always use the blend regardless of the state of the object - - - - - Defines a method of drawing a grip on a control - - - - - Draws the grip as a set of dots - - - - - Draws the grip as two lines - - - - - Does not draw the grip at all, but the object remains moveable - - - - - Defines a specific type of button to search by - - - - - - - - - - - - - - - - - - - - - - - - - Defines a method for background or object inheritence - - - - - - - - - - - - - - - Defines a method of rendering - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 主菜单 - - - - - 背景透明的工具条 - - - - - 银白色至白色渐变 - - - - - 白色至银白色渐变 - - - - - - - - - - - - - - - 当前工作区窗体所关联并激活的工具栏 - - - - - 模拟运行时的外观 - - - - - Represents the visual state of an image list view item. - - - - - 没有任何选择状态，处于一般正常状态 - - - - - 项处于选中状态 - - - - - 鼠标滑过 - - - - - 控件的高度根据内容自动调整，忽略外部设置 - - - - - 边框宽度 - - - - - 文本和description文本之间的间距 - - - - - 最大显示的项数 - - - - - - - - - - 是否显示说明字段，此属性不影响弹出面板是否显示 - 弹出面板是否显示由DescriptionMember是否设置决定 - - - - - - - - - - - - - - - 下拉列表的布局模式 - - - - - - - - - - 是否允许空 - - - - - - - - - - 测量当前控件应该的高度 - - - - - - 整个可用的绘图表面 - - - - - 右边按钮的绘图表面 - - - - - 绘制边框 - - - - - - 绘制背景 - - - - - - 绘制文本 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 当前热点项生改变 - - - - - - - - - - - - - - - - - - - - - 通过外能事件获取用于绘制项的文本 - - - - - - - - - - - - - - - - - - - - - - - - - - 标题 - - - - - 验证失败时是否需要高亮显示（改变背景色） - - - - - - - - - - - - - - - - - - - - - - 排序箭头开始颜色 - - - - - 排序箭头开始颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 控件的背景画布颜色 - 因为控件的边框和过度色都有依靠改变透明度实现渐变，所以一个白色的底版就非常重要 - 使过度色不受控件本身背景色的影响，光不绘制背景不行，要刷上白色背景 - - - - - 控件背景色 - - - - - - - - - - - - - - - 边框颜色 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Represents the visual state of an image list view item. - - - - - 没有任何选择状态，处于一般正常状态 - - - - - 项处于选中状态 - - - - - 该项具有输入焦点 - - - - - 鼠标滑过 - - - - - - - - - - The item is not visible. - - - - - The item is partially visible. - - - - - The item is fully visible. - - - - - 布局方式 - - - - - 标准布局 - - - - - 使项带有描述的布局 - - - - - 双击项事件参数 - - - - - - - - - - - - - - - - 项被删除事件参数 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 为项绘制带有描述信息的渲染器 - - - - - 字的高度是否已初始化 - 在第一次绘制时，测量文本的高度 - - - - - - - - - - - 默认布局引擎，以类似微软ListView的方式按行排列项 - - - - - 框选的最短开始长度 - - - - - 框选时滚动条的自动滚动速度 - - - - - 用于鼠标框选时，框出了控件中项的显示范围时，自动滚动滚动条 - - - - - 自动滚动时，滚动值 - - - - - 是否处于框选状态中 - - - - - 内框offset，内框offset是绝对相对于滚动条的 - - - - - 整个可显示项的边界的offset，包括上下padding部分 - - - - - 鼠标按下时项区域边界的offset，即 _itemsAreaOffset - 用于框选时，跨越可视部队画框 - - - - - 当前所能显示的最大行数 - - - - - - - - - - Gets whether the shift key is down. - - - - - Gets whether the control key is down. - - - - - - - - - - - - - - - - - - - - - - - - - 没有任何项 - - - - - 没有任何项处于可显示状态 - - - - - 整个控件区域 - - - - - 整个可用于绘制项的可视区域 - 去除左右Padding部分，去除滚动条 - - - - - 用于绘制项的区域 - 考虑边距间隔大小和滚动条区域 - - - - - 项的尺寸 - 不放在ListView本身中定义而是放在LayoutManager中定义，是因为不同的布局方式 - 可能会是带长宽的Size做为itemSize，比如平铺的方式 - - - - - 项周围的边距 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 更新整个布局引擎的状态 - - - - - 判断指定的项是否处于可见状态 - - - - - - - 获取项的呈现区域 - - - - - - - - - - - - - - - - - - - - 获取当前所有可见项 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Calculates the maximum number of rows and columns - that can be fully displayed. - - - - - 计算当前可见项的index范围 - - - - - 更新滚动条状态 - - - - - 创建框选框 - - - - - - 根据矩形区域选择项 - - - - - - 应用导航键，如上下左右，返回应用导航键之后的项的坐标 - - - - - 使指定下标的项处于可见状态 - - - - - - 默认渲染器，不绘制项的实际内容，但是绘制DEBUG信息 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 用于子类重写时删除相应的缓存 - - - - - - 绘制项的背景 - - The System.Drawing.Graphics to draw on. - The client coordinates of the item area. - - - - 绘制最终的前景 - - - - - - 绘制选择边框 - - The System.Drawing.Graphics to draw on. - The client coordinates of the selection rectangle. - - - - 绘制项的边框 - - - - - - - - 绘制项 - - - - - - - 绘制项的背景 - - - - - - - 绘制项的内容 - - - - - - - - 绘制背景 - - - - - - 绘制当前所有可见项 - - - - - - Renders the selection rectangle. - - The graphics to draw on. - - - - 默认渲染器，以类似微软ListView的方式按行绘制项，只绘制简单的文本 - - - - - 字的高度是否已初始化 - 在第一次绘制时，测量文本的高度 - - - - - - - - - - - - - - - - - - - - - - - - - 项的背景色 - - - - - 控件背景色 - - - - - 项的边框色 - - - - - 选择框颜色 - - - - - 选择框的边框色 - - - - - 当控件具有焦点时选定项的背景色 - - - - - - - - - - 控件失去焦点时选定项的背景色 - - - - - - - - - - 热点项的背景色 - - - - - - - - - - 图像内边框颜色 - - - - - 图像外边框颜色 - - - - - - - - - - Creates a control with a border. - - - - - Specifies that the control has a border with a sunken edge. - - - - - - - - - - 是否需要在调用 ResumeLayout 时重绘 - - - - - 为项扩展的用于呈现的属性 - - - - - Gets whether the shift key is down. - - - - - Gets whether the control key is down. - - - - - 鼠标左键是否处于按下状态 - - - - - 鼠标右键是否处于按下状态 - - - - - 鼠标最后点击的位置 - - - - - 当前鼠标经过的项 - - - - - - - - - - - - - - - 配色方案 - - - - - 当前布局中项的高度 - - - - - - - - - - 是否没有任何项 - - - - - - - - - - 获取当前具有输入焦点的项 - - - - - 默认的用于呈现为项中文本的Property - - - - - - - - - - 更改了选择的项 - - - - - 双击项 - - - - - - 请求在下次调用 ResumeLayout 时重绘 - - - - - 获取当前选中的所有项 - - - - - - - - - - - - 设置扩展属性供特定LayoutEngine使用 - 如果指定的 ExtendMember 已存在，覆盖之 - 用String.Empty 或 null 做为 propertyName传入，表示删除指定的 member - - - - - - - - - - - - - - - - - - - - - 恢复正常的布局逻辑。 - - - - - - - - - - - 临时挂起控件的布局逻辑。 - - - - - - - - - - 获取当前选中项所绑定的对象 - 如果没有选中项，返回null，如果选中多项，返回选中项集合中的第一个 - - - - - - 根据指定的绑定项对象 - 设置当前列表中选定的项 - - - - - - 获取当前选中的所有项的绑定对象集合 - 如果当前没有选中任何项，返回空集合 - - - - - - 取消所有项的选择 - - - - - - - - - - - - - - - - 获取创建控件句柄时所需要的创建参数 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 更改了选择的项 - - - - - 双击项 - - - - - 项被删除 - - - - - 通过外能事件获取用于绘制项的文本 - - - - - Represents the color palette of the image list view. - - - - - Gets or sets the background color of the ImageListView control. - - - - - Gets or sets the background color of the ImageListViewItem. - - - - - Gets or sets the background color of alternating cells in Details View. - - - - - Gets or sets the border color of the ImageListViewItem. - - - - - Gets or sets the foreground color of the ImageListViewItem. - - - - - Gets or sets the background gradient color1 of the ImageListViewItem if the control is not focused. - - - - - Gets or sets the background gradient color2 of the ImageListViewItem if the control is not focused. - - - - - Gets or sets the border color of the ImageListViewItem if the control is not focused. - - - - - Gets or sets the fore color of the ImageListViewItem if the control is not focused. - - - - - Gets or sets the background gradient color1 if the ImageListViewItem is hovered. - - - - - Gets or sets the background gradient color2 if the ImageListViewItem is hovered. - - - - - Gets or sets the border color of the ImageListViewItem if the item is hovered. - - - - - Gets or sets the color of the insertion caret. - - - - - Gets or sets the background gradient color1 if the ImageListViewItem is selected. - - - - - Gets or sets the background gradient color2 if the ImageListViewItem is selected. - - - - - Gets or sets the border color of the ImageListViewItem if the item is selected. - - - - - Gets or sets the fore color of the ImageListViewItem if the item is selected. - - - - - Gets or sets the background gradient color1 of the column header. - - - - - Gets or sets the background gradient color2 of the column header. - - - - - Gets or sets the background hover gradient color1 of the column header. - - - - - Gets or sets the background hover gradient color2 of the column header. - - - - - Gets or sets the cells foreground color of the column header text. - - - - - Gets or sets the cells background color if column is selected in Details View. - - - - - Gets or sets the color of the separator in Details View. - - - - - Gets or sets the foreground color of the cell text in Details View. - - - - - Gets or sets the foreground color of alternating cells text in Details View. - - - - - Gets or sets the background color of the image pane. - - - - - Gets or sets the separator line color between image pane and thumbnail view. - - - - - Gets or sets the color of labels in pane view. - - - - - Gets or sets the image inner border color for thumbnails and pane. - - - - - Gets or sets the image outer border color for thumbnails and pane. - - - - - Gets or sets the background color1 of the selection rectangle. - - - - - Gets or sets the background color2 of the selection rectangle. - - - - - Gets or sets the color of the selection rectangle border. - - - - - Initializes a new instance of the ImageListViewColor class. - - - - - Initializes a new instance of the ImageListViewColor class - from its string representation. - - String representation of the object. - - - - Copies color values from the given object. - - The source object. - - - - Represents the default color theme. - - - - - Represents the noir color theme. - - - - - Represents the mandarin color theme. - - - - - Sets the color palette to default colors. - - - - - Sets the color palette to mandarin colors. - - - - - Sets the color palette to noir colors. - - - - - Determines whether all color values of the specified - ImageListViewColor are equal to this instance. - - The object to compare with this instance. - true if the two instances have the same color values; - otherwise false. - - - - Returns a hash code for this instance. - - - A hash code for this instance, suitable for use in - hashing algorithms and data structures like a hash table. - - - - - Returns a string that represents this instance. - - - A string that represents this instance. - - - - - 测试坐标 - - - - - 项的坐标 - - - - - 是否点击了项 - - - - - - - - - - - - - - - - - - - - - - 该项当前的选中状态 - - - - - - - - - - - - - - - - - - - - 所绑定的对象 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 将指定的事件移动到(紧邻)另一个事件之前 - - - - - - - 将指定的事件移动到(紧邻)另一个事件之后 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Modify a WinForms TreeView control to use the new Explorer style theme - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - WM_COPYDATA消息所要求的数据结构 - - - - - - - - - - - - - - - - - - - - - - - - - 通过窗口的标题来查找窗口的句柄 - - - - - - - - 发送 Windows 消息 - - - - - - - - - - 还原 - - - - - 移动 - - - - - 大小 - - - - - 最小化 - - - - - 最大化 - - - - - 关闭 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 发送消息，只能传递一个自定义的消息ID和消息字符串，想传一个结构，但没成功 - - 目标进程名称，如果有多个，则给每个都发送 - 自定义数据，可以通过这个来决定如何解析下面的strMsg - 传递的消息，是一个字符串 - - - - 接收消息，得到消息字符串 - - System.Windows.Forms.Message m - 接收到的消息字符串 - - - - - - - - - 最大圆角半径 - - - - - 最小矩形边长，用于自动处理圆角大小 - - - - - 绘制一个圆角矩形. - - 当前屏幕的图形对象 - 画笔 - 矩形左上角X坐标 - 矩形左上角Y坐标 - 矩形右下角X坐标 - 矩形右下角Y坐标 - 圆角的半径长度 - - - - 绘制一个圆角矩形. - - 当前屏幕的图形对象 - 画笔 - 要绘制的矩形对象 - 圆角的半径长度 - - - - 绘制一个圆角矩形. - - 当前屏幕的图形对象 - 画笔 - 要绘制的矩形对象 - - - - 填充一个圆角矩形. - - 当前屏幕的图形对象 - 笔刷 - 矩形左上角X坐标 - 矩形左上角Y坐标 - 矩形右下角X坐标 - 矩形右下角Y坐标 - 圆角的半径长度 - - - - 填充一个圆角矩形. - - 当前屏幕的图形对象 - 笔刷 - 要填充的矩形 - 填充区域针对矩形的缩进距离 - 圆角的半径长度 - - - - 填充一个圆角矩形. - - 当前屏幕的图形对象 - 笔刷 - 要填充的矩形 - - - - 使图片单色化 - - - - - - - 获取颜色 - - - - - - - - - - - - - 颜色变化时激发 - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - + + + + RaUIV3 + + + + + 基于XML实现的权限类 + + + + + 用户名 + + + + + 用户id + + + + + 密码 + + + + + 权限控制Id + + + + + 用户备注 + + + + + 是否是管理员权限 + + + + + 是否是超级管理员权限 + + + + + 设置权限 + + 权限名称 + 权限值 + 返回是否设置成功 + + + + 获取权限 + + 权限名称 + 默认权限值 + 返回权限值 + + + + 获取权限 + + 权限名称 + 返回权限值 + + + + 批量导入权限 + + 权限相关的内容 + 返回是否执行成功 + + + + 导出权限 + + 返回导出文本 + + + + 清除所有权限 + + 返回是否执行成功 + + + + Json扩展 + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + Ini操作类 + + + + + 写入Ini + + + + + + + + + + 获取Ini + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 获取所有节点名称(Section) + + 存放节点名称的内存地址,每个节点之间用\0分隔 + 内存大小(characters) + Ini文件 + 内容的实际长度,为0表示没有内容,为nSize-2表示内存大小不够 + + + + 编码 + + + + + Ini操作类 + + + + + + 根据section取所有key和值 + + + + + + + 读取INI文件中指定INI文件中的所有节点名称(Section) + + 所有节点,没有内容返回string[0] + + + + 读取INI文件 + + 段，格式[] + 键 + 返回byte类型的section组或键值组 + + + + 根据section取所有key + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入Ini + + + + + + + + 读取Ini + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + + + 写入ini + + + + + + + + + 删除Ini的Key + + + + + + + 删除Ini节点 + + + + + + 汉字转拼音静态类,包括功能全拼和缩写，方法全部是静态的 + + + + + 汉字的机内码数组 + + + + + 机内码对应的拼音数组 + + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(首拼) + + 汉字字符串 + 转换后的拼音(首拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 用指定字符分隔 + 转换后的拼音(全拼)字符串 + + + + 汉字转拼音缩写 + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串) (小写) (空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (大写) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串)(大写)(空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 控件信息 + + + + + id + + + + + 控件对象 + + + + + 控件值类型 + + + + + 默认值 + + + + + 值类型 + + + + + 默认 + + + + + 取列表顺序值 + + + + + 取当前选择的列表值 + + + + + 取对象值 + + + + + 保存的设置类型 + + + + + Ini + + + + + XML + + + + + 对象值 + + + + + 显示的文本 + + + + + 图片序号 + + + + + id + + + + + Tag值 + + + + + 显示文本值 + + + + + + 星期数据 + + + + + 一周的开始时间 + + + + + 一周的结束时间 + + + + + 图片类型 + + + + + Bmp图片 + + + + + Jpeg图片 + + + + + Png图片 + + + + + Gif动态图片 + + + + + Tiff图片 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + XML操作类 + + + + + XML操作类 + + + + + 从XML文本中加载数据 + + + + + + 从指定的XML文本中加载 + + XML文本 + 如为1，表示加载成功，为0为失败 + + + + 载入空的XML文档 + + 如为1，表示加载成功，为0为失败 + + + + 从指定的文件中加载 + + XML文件路径 + 如为1，表示加载成功，为0为失败 + + + + 保存到指定文件中 + + 文件路径 + 如为1，表示保存成功，为0为失败 + + + + 判断节点是否存在 + + 属性名 + 属性值 + 返回1，表示存在，其它表示不存在 + + + + 定位节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 定位节点,如果找不到节点，就新建一个节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 + + 返回第一个符合要求的结果 + + + + 定位设置节点 + + 返回第一个符合要求的结果 + + + + 在节点后插入数据 + + + + + + + 在节点前插入数据 + + + + + + + 获取节点数量 + + 属性名 + 属性值 + 返回符合要求的结果数量 + + + + 获取节点数量 + + 返回符合要求的结果数量 + + + + 获取节点数量 + + 属性名 + 属性值 + + + + 返回符合要求的结果数量 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 读取指定节点的值(string) + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 获取属性值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取所有的节点名称 + + + + + + 读取指定节点的值(string) + + + + + + + + 读取指定节点的值(int) + + + + + + + + 读取指定节点的值(decimal) + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 获取XML文件的根元素 + + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 新增节点 + + + + + + + + 新增节点并定位到新节点 + + + + + + + + 新增设置节点并定位 + + + + + + 在指定节点前新增节点并定位到新节点 + + + + + + + + + 获取当前节点 + + + + + + 删除节点 + + + + + + 获取XML文本 + + + + + + 获取XML文本 + + + + + + 获取文本 + + + + + + 获取文本 + + + + + + 字符串操作类 + + + + + 字符串转Base64 + + + + + + + Base64转字符串 + + + + + + + 转换指定字符串为布尔类型 + + + + + 转换指定字符串为Double类型 + + + + + 已重载.计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 已重载.计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定布尔类型为Int类型,true为1，false为0 + + + + + 判断指定字符串是否是布尔类型 + + + + + 判断指定字符串是否是Double类型 + + + + + 判断指定字符串是否是Int类型 + + + + + 根据年月日转换成日期 + + + + + + + + + 追加字符 + + + + + 获取2个字符串中间的内容,point1为空表示从首位开始算，point2为空表示算到结尾。 + + + + + 判断字符串是否只包含数字或英文 + + + + + + + 判断字符串是否只包含英文 + + + + + + + 判断字符串是否只包含数字 + + + + + + + 判断字符串是否匹配,支持?*通配符 + + 待匹配的字符串 + 匹配的通配符 + + + + + 通配符替换 + + + + + + + + + 支持忽略大小写的替换功能 + + + + + 是否忽略大小写 + + + + + 获取匹配的内容 + + + + + + + + + 文件时间 + + + + + 创建时间 + + + + + 最后修改时间 + + + + + 访问时间 + + + + + 对变量的拓展 + + + + + 替换文本(忽略大小写) + + + 需要替换的内容 + 替换后的内容 + + + + + 替换文本(忽略大小写),可支持通配符 + + + + + 是否是通配符表达式,不是，则普通替换，忽略大小写，是，则启用通配符替换 + + + + + 将颜色转换为Html颜色格式 + + + + + + + 支持忽略大小写的替换文本功能 + + + + + 是否忽略大小写 + + + + + 获取符合要求的第一个结果 + + + + 是否是正则 + + + + + 查找字符串,忽略大小写 + + + + + + + + + 查找字符串,忽略大小写 + + + + + + + + 判断字符串是否是数字或英文 + + + + + + + 判断字符串是否是英文 + + + + + + + 判断字符串是否是数字(不同于IsInt,本函数是判断字符串是否只含有数字,对字符串长度没有限制) + + + + + + + 是否在指定范围内 + + + + + + + + + 是否在指定范围内 + + + + + + + + + 转换指定字符串为Int类型 + + + 最小值 + 最大值 + 如果字符串不在范围内，则使用本默认值 + + + + + 转换指定布尔类型到Int类型,true为1，false为0 + + + + + + + 将指定类型转换成整型 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将指定类型转换成整型 + + + + + + + 将指定类型转换成长整型,如果时间时间类型,则转换为Unix时间戳 + + + + + + + + 转换为Unix时间戳 + + + + + + + 转换为Js时间戳 + + + + + + + 转换为Unix时间戳 + + + + + + + 将指定类型转换成长整型 + + + + + + + 转换指定类型为Double类型 + + + + + + + + 转换指定类型为Double类型 + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + + 转换DateTime类型到日期时间字符串(例如 2000-01-01 08:08:08) + + + + + + + 转换DateTime类型到日期字符串(例如 2000-01-01) + + + + + + + 转换DateTime类型到日期星期字符串(例如 2000-01-01 星期六) + + + + + + + 转换DateTime类型到Unix时间戳 + + + + + + + 转换Unix时间戳到DateTime类型 + + + + + + + 判断字符串是否与内容匹配 + + + + + + + + 将变量值转换成Double类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换到文件大小字符串 + + + + + + + 转换到文件大小字符串 + + + + + + + 转换指定类型为Decimal类型 + + + + + + + + 将变量值转换成Decimal类型 + + + + + + + 将变量值转换成Decimal类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换指定类型为DateTime类型 + + + + + + + + 将变量值转换成DateTime类型 + + + + + + + 转换指定类型为布尔类型 + + + + + + + 追加字符 + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + + + + 判断指定字符串是否是Int类型 + + + + + + + 判断指定字符串是否是Double类型 + + + + + + + 判断是否是布尔类型 + + + + + + + 将字符串转换为Base64类型 + + + + + + + 判断字符串是否在指定长度 + + + + + + + + + 判断能否转换成日期格式 + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 大文件与批量文件操作类,支持中途取消操作,本类需要实例化操作 + + + + + 传输进度 + + 当前传输完成的值 + 全部值,为-1表示无法获取 + 当前传输的百分比,为-1表示无法获取 + + + + 传输进度 + + + + + 取消事件 + + + + + 大文件按流复制文件,支持自动创建目标文件夹。 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + + + + + 复制文件夹到目标文件夹,不支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持中途取消 + + 源文件夹 + 目标文件夹 + 初始的文件数量 + 总数量,如果不计算,则使用-1 + 操作的数量,包含成功的和失败的 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 获取文件夹中的文件数量 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 获取文件夹的大小 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 文件信息 + + + + + 获取版本号 + + + + + 获取版本号 + + + + + + + 根据版本字符串输出double类型的版本号 + + + + + + + + 比较两个版本号大小 + + + + oldVer小于newVer,返回1,大于则返回-1,相等返回0,不支持则返回-1000 + + + + 从字符串中提取版本号 + + + + + + + 比较版本号 + + + + + + old小于new,返回1,大于则返回-1,相等返回0 + + + + 判断是否是管理员方式运行 + + + + + + Hosts操作类 + + + + + 获取并转换hosts内容 + + hosts内容 + + + + + 获取hosts并转换hosts内容 + + + + + + 追加内容到hosts里 + + 要追加的内容列表，每一行为ip 域名的格式 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + write为true,追加内容到hosts里;为false,判断是否需要追加 + + 要追加的内容列表，每一行为ip 域名的格式 + 是否要写入,如果为false,则只判断是否需要追加,而不写入Hosts文件 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + 要追加的内容 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + ip地址 + 域名 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 从hosts文件里删除内容 + + 要删除的内容 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + 从hosts文件里删除内容 + + ip地址 + 域名 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + Host信息 + + + + + IP + + + + + 域名 + + + + + 注释 + + + + + 是否要删除 + + + + + 文件操作类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 永久删除单个文件。 + + 永久删除的文件名 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除一组文件。 + + 字符串数组，表示一组文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + + + + + 移动一个文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 移动一组文件到指定的路径下 + + 要移动的文件名数组 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制一组文件到指定的路径 + + 要复制的文件名数组 + 复制到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 大文件多次复制文件 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 重命名一个文件为新名称，建议您使用更方便的Microsoft.VisualBasic.FileSystem.ReName();替换该方法 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 删除单个或多个文件 + + 删除的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动或复制一个或多个文件到指定路径下 + + 操作类型，是移动操作还是复制操作 + 要移动或复制的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 移动到的目的位置 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 如果指定文件夹不存在，则创建文件夹 + + + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 解释错误代码 + + 代码号 + 返回关于错误代码的文字描述 + + + + 运行文件 + + + + + + + + /运行文件 + + + + + + + + + 运行程序 + + + + + + + 打开文件 + + + + + + + 打开文件夹并定位文件 + + + + + + + 打开网址 + + + + + + + 判断是否为空的文件夹 + + + + + + + 文件或文件夹是否存在 + + + + + + + 判断文件名是否有效 + + + + + + + 转换到有效文件名 + + + + + + + 追加日志 + + + + + + + 追加文件 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + + 写入所有文本行到文件,如果文件夹不存在，会自动创建 + + + + + + + + 写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + + 以UTF-8格式写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + 从文件中加载图片,使用本方法，不会导致图片文件被占用。 + + + + + + 获取文件大小 + + + + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 获取文件大小字符串 + + + + + + + 根据文件大小字符串获取长整型表示的文件大小 + + + + + + + 获取文件大小字符串 + + + + + + + 复制内容到剪切板 + + + + + + 添加某个控件为支持拖放属性 + + + + + + + 使管理员方式运行时支持拖放 + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 获取绝对路径 + + + + + + + 获取相对路径 + + + + + + + 获取图标 + + + + + + + + + + + + + + 销毁图标 + + + + + + + 获取文件图标 + + + + + + + + + + 图片相关API + + + + + 从文件或Url中加载图片,使用本方法，不会导致图片文件被占用。 + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 以逆时针为方向对图像进行旋转 + + 位图流 + 旋转角度[0,360](前台给的) + + + + + 是否包括透明像素 + + + + 操作失败 + + + + 矩形边界 + + + + + + + + 计算水印位置 + + + + + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 计算最大字体大小 + + + + + + + + + + + 计算旋转矩形大小 + + + + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + + + + + 缩放 + + + 宽 + 高 + 插值算法 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 缩放 + + + 宽 + 高 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 根据原边长和新边长计算绘制的起始点坐标 + + + + + + + + 获取缩放模式 + + + + + + 是否裁剪图片 + + + + + 裁剪或填充 + + + + + 背景色 + 插值算法 + + Image 不能为 null + 操作失败 + + + + 裁剪 + + + 宽度 + 高度 + + 返回裁剪后的图片 + Image 不能为 null + 新的图片尺寸的宽度和高度必须大于零 + 操作失败 + + + + 调整宽度 + + + + + + + + 根据最大宽度调整图片尺寸 + + + 最大宽度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最大高度调整图片尺寸 + + + 最大高度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 调整高度 + + + + + + + + 调整图片大小 + + + + + + + + + + 调整图片大小 + + + + + + + + + + + 调整图片大小 + + + + + + + + + + + + + 转换Image为Icon + + 要转换为图标的Image对象 + 当image为null时是否返回null。false则抛空引用异常 + + + + + 缩放模式 + + + + + 宽度优先(不裁剪宽) + + + + + 高度优先(不裁剪高) + + + + + 水印位置 + + + + + 左上角 + + + + + 中上 + + + + + 右上角 + + + + + 左中 + + + + + 居中 + + + + + 右中 + + + + + 左下角 + + + + + 中下 + + + + + 右下角 + + + + + 全屏平铺 + + + + + 音频播放类 + + + + + 临时音频文件 + + + + + 父窗口句柄 + + + + + 声音标签 + + + + play synchronously (default) + + + play asynchronously + + + silence (!default) if sound not found + + + pszSound points to a memory file + + + loop the sound until next sndPlaySound + + + don’t stop any currently playing sound + + + Stop Playing Wave + + + don’t wait if the driver is busy + + + name is a registry alias + + + alias is a predefined id + + + name is file name + + + name is resource name or atom + + + + 音频播放类 + + embedded music file + 临时保存的文件位置 + 父窗口句柄 + + + + 音频播放类 + + 要播放的音频位置 + 父窗口句柄 + + + + 音频播放类 + + + 父窗口句柄 + + + + 播放音频 + + + + + + 播放音频 + + + + + 关闭音频 + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 取得一个文本文件的编码方式。如果无法在文件头部找到有效的前导符，Encoding.Default将被返回。 + + 文件名。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + + + + + 取得一个文本文件的编码方式。 + + 文件名。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 通过给定的文件流，判断文件的编码类型 + + 文件流 + 文件的编码类型 + + + + 判断是否是不带 BOM 的 UTF8 格式 + + + + + + + 数据库操作扩展 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据,如果没有数据,则返回null + + + + + + + 获取第一行第一列的值 + + + + + + + 获取第一张表的指定行数据 + + + 指定第几行 + + + + + 对鼠标或键盘的自动化操作 + + + + + 鼠标左键 + + + + + 鼠标中键 + + + + + 鼠标右键 + + + + + 模拟键盘按键 + + + + 按下还是抬起 + + + + 鼠标滚轮 + + + + + + + + 鼠标移动 + + + + + + + + 自定义鼠标按下或抬起 + + + + + + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 粘贴文本 + + + + + + 获取指定句柄的大小及位置 + + + + + + + + 设置指定句柄的大小 + + + + + + + 判断鼠标位置是不是在指定的矩形中 + + + + + + + + 判断2张图是否相似度超90 + + + + + + + + /获取2种颜色的相似度,范围为0~100 + + + + + + + + 新模态窗体 + + + + + 设置窗体返回的结果值，并关闭窗体。 + + 当前窗体 + 模态变量 + 防止 + + + + 窗体返回的结果事件 + + + + + + + 当打开的窗体返回结果时激发 + + + + + 窗体返回的状态 + + + + + 实例化类 + + 父窗体,如果为null,则取桌面为父窗体 + + + + + 获取最顶级的父窗口 + + + + + + 显示新模态窗体,会暂时禁用父窗体,关闭当前窗体后,父窗体会恢复。 + + + + + 只运行一个实例,打开后,所有窗体都依然有效。 + + + + + + 显示窗体 + + 显示的位置 + + + + 显示在父窗体中间 + + + + + 窗体显示位置 + + + + + 右上角 + + + + + 顶部中间 + + + + + 顶部右边 + + + + + 中间 + + + + + 左下角 + + + + + 底部中间 + + + + + 右下角 + + + + + 父窗体居中 + + + + + + + + + + + + + + + + + + + + + + + + + 设置线程数量 + + + + + 要计算的总数量 + + + + + 每个线程要计算的数量 + + + + + + + + + + 当前已使用的时间 + + + + + + + 线程数量 + 要计算的事务数量 + + + + + + + + + + + + + + + + + + + + + + + 多线程计算时激发 + + + + + 在所有线程执行完毕后发生 + + + + + 在线程执行完毕后发生,最后一个执行完毕的线程将不收到本事件通知 + + + + + 进程相关接口 + + + + + 获取进程路径 + + + + + + + 获取进程路径 + + + + + + + 获取命令行 + + + + + + + 获取命令行 + + + + + + + 运行库检测类 + + + + + 获取产品状态 + + + + + + + 判断是否已安装VC运行库 + + + + + + 判断是否已安装VC运行库 + + + + + + 安装状态 + + + + + 组件禁用 + + + + + 配置数据已损坏 + + + + + 安装已暂停或正在进行 + + + + + 从源运行，源不可用 + + + + + 返回缓冲区溢出 + + + + + 无效的参数传递给该函数。 + + + + + 不公布或者未安装该产品。 + + + + + 损坏 + + + + + 该产品已公布但尚未安装。 + + + + + 正在移除的组件（操作状态，不可设置） + + + + + 不同的用户安装该产品。 + + + + + 安装在本地驱动器上 + + + + + 从源代码、CD或网络运行 + + + + + 为当前用户安装该产品。 + + + + + 安装的版本,是x86还是x64，还是全部安装了 + + + + + 判断32位和64位运行库是否已安装 + + + + + 判断32位运行库是否已安装 + + + + + 判断64位运行库是否已安装 + + + + + 判断是否已安装VC2005运行库 + + + + + + 判断是否已安装VC2005SP1运行库 + + + + + + 判断是否已安装VC2008运行库 + + + + + + 判断是否已安装VC2008SP1运行库 + + + + + + 判断是否已安装VC2010运行库 + + + + + + 判断是否已安装VC2010SP1运行库 + + + + + + 判断是否已安装VC2012运行库 + + + + + + 判断是否已安装VC2013运行库 + + + + + + 判断是否已安装VC2015或以上运行库 + + + + + + 判断是否已安装VC2017运行库或以上运行库 + + + + + + 判断是否已安装VC2019运行库或以上运行库 + + + + + + 判断是否已安装VC2022运行库或以上运行库 + + + + + + 判断当前系统是否安装了WebView2组件 + + + + + + 判断当前系统是否安装了.NET 4.8 + + + + + + 日期时间的操作类 + + + + + 获取当前是周几,周一到周日，分别是1-7. + + + + + + + 获取当前是周几,1-7，分别是返回一到日. + + + + + + + 获取当前是周几,输入日期，根据周几，分别是返回一到日. + + + + + + + 获取一周的开始和结束,开始时间为第一天的0点，结束时间以最后一天的0点为结束时间 + + + + + + + 获取2个日期相差几周 + + + + + + + + 获取2个日期相差几个月 + + + + + + + + 获取一个月的开始 + + + + + + + 判断是否在同一个星期。 + + + + + + + + 判断是否在同一个月。 + + + + + + + + 判断是否在同一天 + + + + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + 是否显示秒 + + + + + 将秒数显示成中文表达式 + + + + + + + 计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 将c# DateTime时间格式转换为Unix时间戳格式 + + 时间 + long + + + + 时间戳转为C#格式时间 + + + + + + + 时间戳转为C#格式时间 + + + + + + + 将c# DateTime时间格式转换为js时间戳格式 + + 时间 + long + + + + JS时间戳转为C#格式时间 + + + + + + + JS时间戳转为C#格式时间 + + + + + + + 根据年月日转换成日期 + + + + + + + + + 根据日期和时间转换成日期时间 + + + + + + + + 将时间转换成当前分钟开始的时间 + + + + + + + 将时间转换成当前秒钟开始的时间 + + + + + + + 当前时间在这一天里的秒数 + + + + + + + 窗体操作类 + + + + + 设置Comobox的行间距 + + + + + + + 移除关闭按钮。返回值，非零表示成功，零表示失败。 + + 窗口的句柄 + 是否成功 + + + + 把窗体放到最前 + + + + + + 显示窗体 + + + + + + + + 设置窗体是否置顶 + + + + + + + 显示没有焦点的窗口 + + + + + + 根据句柄获取窗口文本 + + + + + + + 根据句柄获取窗口类 + + + + + + + 获取当前活动的窗口句柄 + + + + + + 获取当前前台的窗口句柄 + + + + + + 设置为当前活动窗口 + + + + + + + 根据窗口句柄来获得进程id + + + + + + + 显示窗体 + + + + + + 设置窗体父窗体为桌面,不会随着显示桌面而最小化,但无法设置窗体透明度 + + + + + + 结束进程 + + + + + + + 打开窗体,只打开一个实例(非模态) + + + + + + + 将窗体植入到容器控件中 + + + 作为窗体容器的控件 + + + + + 重新调整窗体大小以适配容器大小 + + + 作为窗体容器的控件 + + + + + 设置注册表操作,部分功能需要管理员权限 + + + + + 访问的注册表位置(64位还是32位) + + + + + 访问的注册表节点 + + + + + 判断注册表项是否存在 + + + + + + + + + 删除注册表键(如果存在子键,子键将一并被删除) + + + + + + + + + + 删除注册表键值 + + + + + + + + + + 获取注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + 启动命令 + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + + + + + 把指定文件设置为开机启动或取消开机启动 + + 是否开机启动 + 开机启动名称 + 要开机启动的文件路径 + + + + + 检查是否开机启动 + + 开机启动名称 + 开机启动命令 + + + + + 检查是否开机启动 + + 开机启动名称 + + + + + 判断指定文件是否是开机启动 + + 开机启动名称 + 文件路径 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + 启动命令行 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置文件关联 + + 扩展名(如.apk) + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 设置文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 在指定文件格式右键菜单中增加菜单 + + 扩展名(如.apk) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 删除文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 获取文件关联是否存在 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 采用的IE模式 + + + + + IE7兼容视图 + + + + + IE8 标准模式 + + + + + IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE9 标准模式 + + + + + IE9 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE10 标准模式 + + + + + IE10 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置当前软件的浏览器控件内核版本 + + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + IE内核版本 + + + + + 设置当前软件的浏览器控件内核版本 + + IE内核版本 + + + + + 系统音量操作类 + + + + + 判断系统是否正处于静音 + + + + + + 系统函数 + + + + + + + + + + 红 + + + + + 绿 + + + + + 蓝 + + + + + 获取屏幕伽马值 + + + + + + + + 设置屏幕伽马值 + + + + + + + + 获取键盘和鼠标没有操作的时间 + + + + + + 设置屏幕 Gamma值 + + + + + + + + + 设置屏幕亮度 + + + + + + + 获取系统名称,注意需要在app.manifest文件中设置兼容win10 + + + + + + SOURCE CODE FROM THE WEBSITE. + LAST UPDATE:WWW.VJSDN.COM易学论坛,2009/08/03 by Jonny Sun + + + + + Mutes the left hand channel and transfers audio fully to the right + + + + + Mutes the right hand channel and transfers audio fully to the left + + + + + SOURCE CODE FROM THE WEBSITE. + LAST UPDATE:WWW.VJSDN.COM易学论坛,2009/08/03 by Jonny Sun + + + + + Mutes the left hand channel and transfers audio fully to the right + + + + + Mutes the right hand channel and transfers audio fully to the left + + + + + 窗体操作类 + + + + + 构造函数 + + + + + + 析构 + + + + + 设置让窗体支持移动 + + + + + 是否允许可调节大小 + + + + + 可调节窗体大小的宽度 + + + + + + + + + + + + + + + + + + + + + + + 开始截图 + + 是否截取鼠标指针 + + + + + 自动排列控件 + + + + + 最大列数 + + + + + 开始排列的坐标 + + + + + 下一项的位置 + + + + + 下一项的右下角坐标 + + + + + 竖向间隔像素 + + + + + 横向间隔像素 + + + + + 最小保留右边距,只对ReDraw2有效 + + + + + 自动排列控件构造函数 + + + + + + 自动排列控件构造函数 + + + + + + + + 开始排列控件 + + + + + 开始排列控件,当列数超过显示空间时，自动换行 + + + + + 加入的控件列表 + + + + + 初始化添加,自动将容器设置为滚动条自动显示 + + + + + + 添加控件 + + + + + + + 删除控件 + + + + + + 删除控件 + + + + + + 清空所有控件 + + + + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据当前节点生成HtmlDocument + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据XPath来查找节点 + + + + + + + + 在当前节点下根据xpath来查找符合的第一个节点 + + + + + + + + 在当前节点下根据xpath来查找所有符合的节点 + + + + + + + + A utility class to compute CRC32. + + + + + Compute a checksum for a given array of bytes. + + The array of bytes to compute the checksum for. + The computed checksum. + + + + Compute a checksum for a given string. + + The string to compute the checksum for. + The computed checksum. + + + + Represents an HTML attribute. + + + + + Gets the line number of this attribute in the document. + + + + + Gets the column number of this attribute in the document. + + + + + Gets the stream position of the value of this attribute in the document, relative to the start of the document. + + + + + Gets the length of the value. + + + + + + + + + + Gets the qualified name of the attribute. + + + + + Name of attribute with original case + + + + + Gets the HTML document to which this attribute belongs. + + + + + Gets the HTML node to which this attribute belongs. + + + + + Specifies what type of quote the data should be wrapped in + + + + + Specifies what type of quote the data should be wrapped in (internal to keep backward compatibility) + + + + + Gets the stream position of this attribute in the document, relative to the start of the document. + + + + + Gets or sets the value of the attribute. + + + + + Gets the DeEntitized value of the attribute. + + + + + Gets a valid XPath string that points to this Attribute + + + + + Compares the current instance with another attribute. Comparison is based on attributes' name. + + An attribute to compare with this instance. + A 32-bit signed integer that indicates the relative order of the names comparison. + + + + Creates a duplicate of this attribute. + + The cloned attribute. + + + + Removes this attribute from it's parents collection + + + + + An Enum representing different types of Quotes used for surrounding attribute values + + + + + A single quote mark ' + + + + + A double quote mark " + + + + + No quote mark + + + + + The initial value (current value) + + + + + Represents a combined list and collection of HTML nodes. + + + + + Gets the number of elements actually contained in the list. + + + + + Gets readonly status of colelction + + + + + Gets the attribute at the specified index. + + + + + Gets a given attribute from the list using its name. + + + + + Adds a new attribute to the collection with the given values + + + + + + + Adds supplied item to collection + + + + + Adds a range supplied items to collection. + An IEnumerable<HtmlAttribute> of items to append to this. + + + Adds a range supplied items to collection using a dictionary. + A Dictionary<string,string> of items to append to this. + + + + Explicit clear + + + + + Retreives existence of supplied item + + + + + + + Copies collection to array + + + + + + + Get Explicit enumerator + + + + + + Explicit non-generic enumerator + + + + + + Retrieves the index for the supplied item, -1 if not found + + + + + + + Inserts given item into collection at supplied index + + + + + + + Explicit collection remove + + + + + + + Removes the attribute at the specified index. + + The index of the attribute to remove. + + + + Inserts the specified attribute as the last attribute in the collection. + + The attribute to insert. May not be null. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The value of the attribute to insert. + The appended attribute. + + + + Checks for existance of attribute with given name + + + + + + + Inserts the specified attribute as the first node in the collection. + + The attribute to insert. May not be null. + The prepended attribute. + + + + Removes a given attribute from the list. + + The attribute to remove. May not be null. + + + + Removes an attribute from the list, using its name. If there are more than one attributes with this name, they will all be removed. + + The attribute's name. May not be null. + + + + Remove all attributes in the list. + + + + + Returns all attributes with specified name. Handles case insentivity + + Name of the attribute + + + + + Removes all attributes from the collection + + + + + Clears the attribute collection + + + + + Represents an HTML comment. + + + + + Gets or Sets the comment text of the node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Represents a complete HTML document. + + + + True to disable, false to enable the behavior tag p. + + + Default builder to use in the HtmlDocument constructor + + + Action to execute before the Parse is executed + + + + Defines the max level we would go deep into the html document + + + + The HtmlDocument Text. Careful if you modify it. + + + True to stay backward compatible with previous version of HAP. This option does not guarantee 100% compatibility. + + + + Adds Debugging attributes to node. Default is false. + + + + + Defines if closing for non closed nodes must be done at the end or directly in the document. + Setting this to true can actually change how browsers render the page. Default is false. + + + + + Defines if non closed nodes will be checked at the end of parsing. Default is true. + + + + + Defines if a checksum must be computed for the document while parsing. Default is false. + + + + + Defines if SelectNodes method will return null or empty collection when no node matched the XPath expression. + Setting this to true will return empty collection and false will return null. Default is false. + + + + True to disable, false to enable the server side code. + + + + Defines the default stream encoding to use. Default is System.Text.Encoding.Default. + + + + + Force to take the original comment instead of creating it + + + + + Defines if source text must be extracted while parsing errors. + If the document has a lot of errors, or cascading errors, parsing performance can be dramatically affected if set to true. + Default is false. + + + + + Defines the maximum length of source text or parse errors. Default is 100. + + + + + Defines if LI, TR, TH, TD tags must be partially fixed when nesting errors are detected. Default is false. + + + + + Defines if output must conform to XML, instead of HTML. Default is false. + + + + + If used together with and enabled, Xml namespaces in element names are preserved. Default is false. + + + + + Defines if attribute value output must be optimized (not bound with double quotes if it is possible). Default is false. + + + + Defines the global attribute value quote. When specified, it will always win. + + + + Defines if name must be output with it's original case. Useful for asp.net tags and attributes. Default is false. + + + + + Defines if name must be output in uppercase. Default is false. + + + + + Defines if declared encoding must be read from the document. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node. + Default is true. + + + + + Defines the name of a node that will throw the StopperNodeException when found as an end node. Default is null. + + + + + Defines if the 'id' attribute must be specifically used. Default is true. + + + + + Defines if empty nodes must be written as closed during output. Default is false. + + + + + The max number of nested child nodes. + Added to prevent stackoverflow problem when a page has tens of thousands of opening html tags with no closing tags + + + + + Creates an instance of an HTML document. + + + + Gets the parsed text. + The parsed text. + + + + Defines the max level we would go deep into the html document. If this depth level is exceeded, and exception is + thrown. + + + + + Gets the document CRC32 checksum if OptionComputeChecksum was set to true before parsing, 0 otherwise. + + + + + Gets the document's declared encoding. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node (pre-HTML5) or the meta charset="XXXXX" html node (HTML5). + + + + + Gets the root node of the document. + + + + + Gets the document's output encoding. + + + + + Gets a list of parse errors found in the document. + + + + + Gets the remaining text. + Will always be null if OptionStopperNodeName is null. + + + + + Gets the offset of Remainder in the original Html text. + If OptionStopperNodeName is null, this will return the length of the original Html text. + + + + + Gets the document's stream encoding. + + + + + Gets a valid XML name. + + Any text. + A string that is a valid XML name. + + + + + + + + + + + + + + + + + + + Applies HTML encoding to a specified string. + + The input string to encode. May not be null. + The encoded string. + + + + Determines if the specified character is considered as a whitespace character. + + The character to check. + true if if the specified character is considered as a whitespace character. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The new HTML attribute. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The value of the attribute. + The new HTML attribute. + + + + Creates an HTML comment node. + + The new HTML comment node. + + + + Creates an HTML comment node with the specified comment text. + + The comment text. May not be null. + The new HTML comment node. + + + + Creates an HTML element node with the specified name. + + The qualified name of the element. May not be null. + The new HTML node. + + + + Creates an HTML text node. + + The new HTML text node. + + + + Creates an HTML text node with the specified text. + + The text of the node. May not be null. + The new HTML text node. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The html is checked. + The detected encoding. + + + + Detects the encoding of an HTML text provided on a TextReader. + + The TextReader used to feed the HTML. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML text. + + The input html text. May not be null. + The detected encoding. + + + + Gets the HTML node with the specified 'id' attribute value. + + The attribute id to match. May not be null. + The HTML node with the matching id or null if not found. + + + + Loads an HTML document from a stream. + + The input stream. + + + + Loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Loads the HTML document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. May not be null. + + + + Loads the HTML document from the specified string. + + String containing the HTML document to load. May not be null. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. May not be null. + The character encoding to use. May not be null. + + + + Saves the HTML document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the HTML document to the specified TextWriter. + + The TextWriter to which you want to save. May not be null. + + + + Saves the HTML document to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. May not be null. + true to detect encoding, false otherwise. + + + + Detects the encoding of an HTML file. + + Path for the file containing the HTML document to detect. May not be null. + The detected encoding. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. May not be null. + The character encoding to use. May not be null. + + + + Creates a new XPathNavigator object for navigating this HTML document. + + An XPathNavigator object. The XPathNavigator is positioned on the root of the document. + + + + Flags that describe the behavior of an Element node. + + + + + The node is a CDATA node. + + + + + The node is empty. META or IMG are example of such nodes. + + + + + The node will automatically be closed during parsing. + + + + + The node can overlap. + + + + + A utility class to replace special characters by entities and vice-versa. + Follows HTML 4.0 specification found at http://www.w3.org/TR/html4/sgml/entities.html + Follows Additional specification found at https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references + See also: https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references + + + + + + + + + + A collection of entities indexed by name. + + + + + A collection of entities indexed by value. + + + + + Replace known entities by characters. + + The source text. + The result text. + + + + Clone and entitize an HtmlNode. This will affect attribute values and nodes' text. It will also entitize all child nodes. + + The node to entitize. + An entitized cloned node. + + + + Replace characters above 127 by entities. + + The source text. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + If set to true, the [quote], [ampersand], [lower than] and [greather than] characters will be entitized. + The result text + + + + Represents an HTML node. + + + + + Gets the name of a comment node. It is actually defined as '#comment'. + + + + + Gets the name of the document node. It is actually defined as '#document'. + + + + + Gets the name of a text node. It is actually defined as '#text'. + + + + + Gets a collection of flags that define specific behaviors for specific element nodes. + The table contains a DictionaryEntry list with the lowercase tag name as the Key, and a combination of HtmlElementFlags as the Value. + + + + + Initialize HtmlNode. Builds a list of all tags that have special allowances + + + + + Initializes HtmlNode, providing type, owner and where it exists in a collection + + + + + + + + Gets the collection of HTML attributes for this node. May not be null. + + + + + Gets all the children of the node. + + + + + Gets a value indicating if this node has been closed or not. + + + + + Gets the collection of HTML attributes for the closing tag. May not be null. + + + + + Gets the closing tag of the node, null if the node is self-closing. + + + + + Gets the first child of the node. + + + + + Gets a value indicating whether the current node has any attributes. + + + + + Gets a value indicating whether this node has any child nodes. + + + + + Gets a value indicating whether the current node has any attributes on the closing tag. + + + + + Gets or sets the value of the 'id' HTML attribute. The document must have been parsed using the OptionUseIdAttribute set to true. + + + + + Gets or Sets the HTML between the start and end tags of the object. + + + + + Gets the text between the start and end tags of the object. + + + + Gets direct inner text. + The direct inner text. + + + + Gets the last child of the node. + + + + + Gets the line number of this node in the document. + + + + + Gets the column number of this node in the document. + + + + + Gets the stream position of the area between the opening and closing tag of the node, relative to the start of the document. + + + + + Gets the stream position of the area of the beginning of the tag, relative to the start of the document. + + + + + Gets the length of the area between the opening and closing tag of the node. + + + + + Gets the length of the entire node, opening and closing tag included. + + + + + Gets or sets this node's name. + + + + + Gets the HTML node immediately following this element. + + + + + Gets the type of this node. + + + + + The original unaltered name of the tag + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets the to which this node belongs. + + + + + Gets the parent of this node (for nodes that can have parents). + + + + + Gets the node immediately preceding this node. + + + + + Gets the stream position of this node in the document, relative to the start of the document. + + + + + Gets a valid XPath string that points to this node + + + + + The depth of the node relative to the opening root html element. This value is used to determine if a document has to many nested html nodes which can cause stack overflows + + + + + Determines if an element node can be kept overlapped. + + The name of the element node to check. May not be null. + true if the name is the name of an element node that can be kept overlapped, false otherwise. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The newly created node instance. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The HTML Document builder. + The newly created node instance. + + + + Determines if an element node is a CDATA element node. + + The name of the element node to check. May not be null. + true if the name is the name of a CDATA element node, false otherwise. + + + + Determines if an element node is closed. + + The name of the element node to check. May not be null. + true if the name is the name of a closed element node, false otherwise. + + + + Determines if an element node is defined as empty. + + The name of the element node to check. May not be null. + true if the name is the name of an empty element node, false otherwise. + + + + Determines if a text corresponds to the closing tag of an node that can be kept overlapped. + + The text to check. May not be null. + true or false. + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Get Ancestors with matching name + + + + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Gets all anscestor nodes and the current node + + + + + + + Adds the specified node to the end of the list of children of this node. + + The node to add. May not be null. + The node added. + + + Sets child nodes identifier. + The chil node. + + + + Adds the specified node to the end of the list of children of this node. + + The node list to add. May not be null. + + + + Gets all Attributes with name + + + + + + + Creates a duplicate of the node + + + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + The cloned node. + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node. + + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node and the subtree under it. + + The node to duplicate. May not be null. + + + + Creates a duplicate of the node. + + The node to duplicate. May not be null. + true to recursively clone the subtree under the specified node, false to clone only the node itself. + + + + Gets all Descendant nodes for this node and each of child nodes + + The depth level of the node to parse in the html tree + the current element as an HtmlNode + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Get all descendant nodes with matching name + + + + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all descendant nodes including this node + + + + + + + Gets first generation child node matching name + + + + + + + Gets matching first generation child nodes matching name + + + + + + Gets data attribute. + The key. + The data attribute. + + + Gets the data attributes in this collection. + + An enumerator that allows foreach to be used to process the data attributes in this + collection. + + + + Gets the attributes in this collection. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + Gets the attributes in this collection. + A variable-length parameters list containing attribute names. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, + the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Inserts the specified node immediately after the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newNode is placed after the refNode. + The node being inserted. + + + + Inserts the specified node immediately before the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newChild is placed before this node. + The node being inserted. + + + + Adds the specified node to the beginning of the list of children of this node. + + The node to add. May not be null. + The node added. + + + + Adds the specified node list to the beginning of the list of children of this node. + + The node list to add. May not be null. + + + + Removes node from parent collection + + + + + Removes all the children and/or attributes of the current node. + + + + + Removes all the children of the current node. + + + + Removes all id for node described by node. + The node. + + + Move a node already associated and append it to this node instead. + The child node to move. + + + Move a children collection already associated and append it to this node instead. + The children collection already associated to move to another node. + + + Removes the children collection for this node. + The old children collection to remove. + + + + Removes the specified child node. + + The node being removed. May not be null. + The node removed. + + + + Removes the specified child node. + + The node being removed. May not be null. + true to keep grand children of the node, false otherwise. + The node removed. + + + + Replaces the child node oldChild with newChild node. + + The new node to put in the child list. + The node being replaced in the list. + The node replaced. + + + + Helper method to set the value of an attribute of this node. If the attribute is not found, it will be created automatically. + + The name of the attribute to set. May not be null. + The value for the attribute. + The corresponding attribute instance. + + + + Saves all the children of the node to the specified TextWriter. + + The TextWriter to which you want to save. + Identifies the level we are in starting at root with 0 + + + + Saves all the children of the node to a string. + + The saved string. + + + + Saves the current node to the specified TextWriter. + + The TextWriter to which you want to save. + identifies the level we are in starting at root with 0 + + + + Saves the current node to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Saves the current node to a string. + + The saved string. + + + + Sets the parent Html node and properly determines the current node's depth using the parent node's depth. + + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + true to throw Error if class name exists, false otherwise. + + + + Removes the class attribute from the node. + + + + + Removes the class attribute from the node. + + true to throw Error if class name doesn't exist, false otherwise. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + true to throw Error if class name doesn't exist, false otherwise. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + true to throw Error if class name doesn't exist, false otherwise. + + + Gets the CSS Class from the node. + + The CSS Class from the node + + + + Check if the node class has the parameter class. + The class. + True if node class has the parameter class, false if not. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type targetType including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Creates a new XPathNavigator object for navigating this HTML node. + + An XPathNavigator object. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document. + + + + Creates an XPathNavigator using the root of this document. + + + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects the first XmlNode that matches the XPath expression. + + The XPath expression. May not be null. + The first that matches the XPath query or a null reference if no matching node was found. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Includes tools that GetEncapsulatedData method uses them. + + + + + Determine if a type define an attribute or not , supporting both .NetStandard and .NetFramework2.0 + + Type you want to test it. + Attribute that type must have or not. + If true , The type parameter define attributeType parameter. + + + + Retrive properties of type that defined . + + Type that you want to find it's XPath-Defined properties. + IEnumerable of property infos of a type , that defined specific attribute. + + + + Determine if a has implemented BUT is considered as NONE-IEnumerable ! + + The property info you want to test. + True if property info is IEnumerable. + + + + Returns T type(first generic type) of or . + + IEnumerable-Implemented property + List of generic types. + + + + Find and Return a mehtod that defined in a class by it's name. + + Type of class include requested method. + Name of requested method as string. + Method info of requested method. + + + + Create of given type. + + Type that you want to make a List of it. + Returns IList of given type. + + + + Returns the part of value of you want as . + + A htmlNode instance. + Attribute that includes ReturnType + String that choosen from HtmlNode as result. + + + + Returns parts of values of you want as . + + that you want to retrive each value. + A instnce incules . + Type of IList generic you want. + + + + + Simulate Func method to use in Lambada Expression. + + + + + + + + + This method works like Where method in LINQ. + + + + + + + + + Check if the type can instantiated. + + + + + + + Returns count of elements stored in IEnumerable of T + + + + + + + + Specify which part of is requested. + + + + + The text between the start and end tags of the object. + + + + + The HTML between the start and end tags of the object + + + + + The object and its content in HTML + + + + + Just mark and flag classes to show they have properties that defined . + + + + + Includes XPath and . XPath for finding html tags and for specify which part of you want to return. + + + + + XPath Expression that is used to find related html node. + + + + + Html Attribute name + + + + + The methode of output + + + + + Specify Xpath to find related Html Node. + + + + + + Specify Xpath to find related Html Node. + + + Specify you want the output include html text too. + + + + Specify Xpath and Attribute to find related Html Node and its attribute value. + + + + + + + Tagging a property with this Attribute make Encapsulator to ignore that property if it causes an error. + + + + + Exception that often occures when there is no way to bind a XPath to a Html Tag. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no way to bind a XPath to a HtmlTag Attribute. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no property that assigned with XPath Property in Class. + + + + + + + + + + + + + + + + + + + + + + + Represents a combined list and collection of HTML nodes. + + + + + Initialize the HtmlNodeCollection with the base parent node + + The base node of the collection + + + Gets the parent node associated to the collection. + + + + Gets a given node from the list. + + + + + Get node with tag name + + + + + + + Gets the number of elements actually contained in the list. + + + + + Is collection read only + + + + + Gets the node at the specified index. + + + + + Add node to the collection + + + + + + Add node to the collection + + + + + + + Clears out the collection of HtmlNodes. Removes each nodes reference to parentnode, nextnode and prevnode + + + + + Gets existence of node in collection + + + + + + + Copy collection to array + + + + + + + Get Enumerator + + + + + + Get Explicit Enumerator + + + + + + Get index of node + + + + + + + Insert node at index + + + + + + + Remove node + + + + + + + Remove at index + + + + + + Get first instance of node in supplied collection + + + + + + + + Add node to the end of the collection + + + + + + Get first instance of node with name + + + + + + + Get index of node + + + + + + + Add node to the beginning of the collection + + + + + + Remove node at index + + + + + + + Replace node at index + + + + + + + Get all node descended from this collection + + + + + + Get all node descended from this collection with matching name + + + + + + Gets all first generation elements in collection + + + + + + Gets all first generation elements matching name + + + + + + + All first generation nodes in collection + + + + + + Represents an HTML navigator on an HTML document seen as a data store. + + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Gets the base URI for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the current HTML document. + + + + + Gets the current HTML node. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node is an empty element. + + + + + Gets the name of the current HTML node without the namespace prefix. + + + + + Gets the qualified name of the current node. + + + + + Gets the namespace URI (as defined in the W3C Namespace Specification) of the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the associated with this implementation. + + + + + Gets the type of the current node. + + + + + Gets the prefix associated with the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the text value of the current node. + + + + + Gets the xml:lang scope for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Creates a new HtmlNavigator positioned at the same node as this HtmlNavigator. + + A new HtmlNavigator object positioned at the same node as the original HtmlNavigator. + + + + Gets the value of the HTML attribute with the specified LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + The value of the specified HTML attribute. String.Empty or null if a matching attribute is not found or if the navigator is not positioned on an element node. + + + + Returns the value of the namespace node corresponding to the specified local name. + Always returns string.Empty for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns string.Empty for the HtmlNavigator implementation. + + + + Determines whether the current HtmlNavigator is at the same position as the specified HtmlNavigator. + + The HtmlNavigator that you want to compare against. + true if the two navigators have the same position, otherwise, false. + + + + Moves to the same position as the specified HtmlNavigator. + + The HtmlNavigator positioned on the node that you want to move to. + true if successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves to the HTML attribute with matching LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + true if the HTML attribute is found, otherwise, false. If false, the position of the navigator does not change. + + + + Moves to the first sibling of the current node. + + true if the navigator is successful moving to the first sibling node, false if there is no first sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the first HTML attribute. + + true if the navigator is successful moving to the first HTML attribute, otherwise, false. + + + + Moves to the first child of the current node. + + true if there is a first child node, otherwise false. + + + + Moves the XPathNavigator to the first namespace node of the current element. + Always returns false for the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the node that has an attribute of type ID whose value matches the specified string. + + A string representing the ID value of the node to which you want to move. This argument does not need to be atomized. + true if the move was successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves the XPathNavigator to the namespace node with the specified local name. + Always returns false for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the next sibling of the current node. + + true if the navigator is successful moving to the next sibling node, false if there are no more siblings or if the navigator is currently positioned on an attribute node. If false, the position of the navigator is unchanged. + + + + Moves to the next HTML attribute. + + + + + + Moves the XPathNavigator to the next namespace node. + Always returns falsefor the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the parent of the current node. + + true if there is a parent node, otherwise false. + + + + Moves to the previous sibling of the current node. + + true if the navigator is successful moving to the previous sibling node, false if there is no previous sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the root node to which the current node belongs. + + + + + Represents the type of a node. + + + + + The root of a document. + + + + + An HTML element. + + + + + An HTML comment. + + + + + A text node is always the child of an element or a document node. + + + + + Represents a parsing error found during document parsing. + + + + + Gets the type of error. + + + + + Gets the line number of this error in the document. + + + + + Gets the column number of this error in the document. + + + + + Gets a description for the error. + + + + + Gets the the full text of the line containing the error. + + + + + Gets the absolute stream position of this error in the document, relative to the start of the document. + + + + + Represents the type of parsing error. + + + + + A tag was not closed. + + + + + A tag was not opened. + + + + + There is a charset mismatch between stream and declared (META) encoding. + + + + + An end tag was not required. + + + + + An end tag is invalid at this position. + + + + + Represents an HTML text node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets or Sets the text of the node. + + + + + A utility class to get HTML document from HTTP. + + + + + Represents the method that will handle the PostResponse event. + + + + + Represents the method that will handle the PreHandleDocument event. + + + + + Represents the method that will handle the PreRequest event. + + + + + Occurs after an HTTP request has been executed. + + + + + Occurs before an HTML document is handled. + + + + + Occurs before an HTTP request is executed. + + + + + Gets or Sets a value indicating if document encoding must be automatically detected. + + + + + Gets or sets the Encoding used to override the response stream from any web request + + + + + Gets or Sets a value indicating whether to get document only from the cache. + If this is set to true and document is not found in the cache, nothing will be loaded. + + + + + Gets or Sets a value indicating whether to get document from the cache if exists, otherwise from the web + A value indicating whether to get document from the cache if exists, otherwise from the web + + + + + Gets or Sets the cache path. If null, no caching mechanism will be used. + + + + + Gets a value indicating if the last document was retrieved from the cache. + + + + + Gets the last request duration in milliseconds. + + + + + Gets the URI of the Internet resource that actually responded to the request. + + + + + Gets the last request status. + + + + + Gets or Sets the size of the buffer used for memory operations. + + + + + Gets or Sets a value indicating if cookies will be stored. + + + + Gets or sets a value indicating whether redirect should be captured instead of the current location. + True if capture redirect, false if not. + + + + Gets or Sets the User Agent HTTP 1.1 header sent on any webrequest + + + + + Gets or Sets a value indicating whether the caching mechanisms should be used or not. + + + + + Gets the MIME content type for a given path extension. + + The input path extension. + The default content type to return if any error occurs. + The path extension's MIME content type. + + + + Gets the path extension for a given MIME content type. + + The input MIME content type. + The default path extension to return if any error occurs. + The MIME content type's path extension. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The requested type. + An newly created instance. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. - Proxy aware + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. Understands Proxies + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + + Gets the cache file path for a specified url. + + The url fo which to retrieve the cache path. May not be null. + The cache file path. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The XmlTextWriter to which you want to save to. + + + Gets or sets the web browser timeout. + + + + Gets or sets the web browser delay. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + An newly created instance. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + An newly created instance. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". May not be null. + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + + + + Represents an exception thrown by the HtmlWeb utility class. + + + + + Creates an instance of the HtmlWebException. + + The exception's message. + + + + Represents a document with mixed code and text. ASP, ASPX, JSP, are good example of such documents. + + + + + Gets or sets the token representing code end. + + + + + Gets or sets the token representing code start. + + + + + Gets or sets the token representing code directive. + + + + + Gets or sets the token representing response write directive. + + + + + Creates a mixed code document instance. + + + + + Gets the code represented by the mixed code document seen as a template. + + + + + Gets the list of code fragments in the document. + + + + + Gets the list of all fragments in the document. + + + + + Gets the encoding of the stream used to read the document. + + + + + Gets the list of text fragments in the document. + + + + + Create a code fragment instances. + + The newly created code fragment instance. + + + + Create a text fragment instances. + + The newly created text fragment instance. + + + + Loads a mixed code document from a stream. + + The input stream. + + + + Loads a mixed code document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads the mixed code document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Loads a mixed document from a text + + The text to load. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + The character encoding to use. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + The character encoding to use. + + + + Saves the mixed document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the mixed document to the specified TextWriter. + + The TextWriter to which you want to save. + + + + Represents a fragment of code in a mixed code document. + + + + + Gets the fragment code text. + + + + + Represents a base class for fragments in a mixed code document. + + + + + Gets the fragement text. + + + + + Gets the type of fragment. + + + + + Gets the line number of the fragment. + + + + + Gets the line position (column) of the fragment. + + + + + Gets the fragment position in the document's stream. + + + + + Represents a list of mixed code fragments. + + + + + Gets the Document + + + + + Gets the number of fragments contained in the list. + + + + + Gets a fragment from the list using its index. + + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Appends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Prepends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Remove a fragment from the list of fragments. If this fragment was not in the list, an exception will be raised. + + The fragment to remove. May not be null. + + + + Remove all fragments from the list. + + + + + Remove a fragment from the list of fragments, using its index in the list. + + The index of the fragment to remove. + + + + Represents a fragment enumerator. + + + + + Gets the current element in the collection. + + + + + Gets the current element in the collection. + + + + + Advances the enumerator to the next element of the collection. + + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + + + + Sets the enumerator to its initial position, which is before the first element in the collection. + + + + + Represents the type of fragment in a mixed code document. + + + + + The fragment contains code. + + + + + The fragment contains text. + + + + + Represents a fragment of text in a mixed code document. + + + + + Gets the fragment text. + + + + + 给控件增加拖放功能的类 + + + + + 拖放实例 + + + + + 高级拖放事件 + + + + + + + + + + + + + + + + + + + + + + + + + 使管理员方式运行时支持拖放 + + + + + + 使支持拖放属性 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取WMI内容 + + + + + + + 获取WMI内容 + + + + + + + 获取内存信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取硬盘信息 + + + + + + 获取主板信息 + + + + + + 获取处理器信息 + + + + + + 获取主要硬件信息 + + + + + + 获取主要硬件信息 + + 是否获取XML格式 + + + + + 网络操作类 + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 根据mac字符串来获取最终的mac地址,可以是各种MAC地址格式,非法的内容将返回null + + + + + + + 远程唤醒 + + + + + + + + 远程唤醒 + + + + + + + + + 消息服务器 + + + + + 消息事件 + + + + + + + 大小改变事件 + + + + + + + + 即将关闭事件 + + + + + + + 当收到消息时激发 + + + + + 消息处理类 + + + + + + + + + + + + + + + + + + + + + + + 发送消息,采用单线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 发送消息，采用多线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 消息类 + + + + + 是否取消 + + + + + 来源句柄 + + + + + + + + + + 消息文本 + + + + + 需要回复的内容 + + + + + 消息客户端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 最后一次接收消息的时间,可用来判断服务端是否有响应 + + + + + 主句柄 + + + + + 当收到消息时激发 + + + + + 连接上主服务器时触发 + + + + + 收到服务端关闭通知 + + + + + 收到服务端关闭通知，即将关闭 + + + + + 服务端大小改变时激发 + + + + + 实例化客户端 + + 服务端ID + 当前客户端ID,会向服务器报告当前ID + 客户端 + + + + + + + + + 断开服务端连接 + + + + + 发送消息,采用多线程发送 + + + + + + + 向服务端发送心跳包 + + + + + 判断服务端句柄是否存在。 + + + + + + 消息服务端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 当收到消息时激发 + + + + + 当收到自定义消息时(非系统消息)激发 + + + + + 有消息客户端发起连接请求时激发 + + + + + 有消息客户端连接成功时激发 + + + + + 有消息客户端断开连接时激发 + + + + + + + 服务端ID,需要唯一性,共客户端识别 + 服务端 + + + + 释放资源 + + + + + 判断是否包含指定客户端 + + + + + + + + + + + + 设置客户端大小 + + + + + 根据客户端ID,获取客户端对象 + + + + + + + 根据客户端句柄,获取客户端对象 + + + + + + + 关闭所有客户端 + + + + + 关闭指定客户端 + + + + + + 关闭指定客户端 + + + + + + 向所有客户端发送消息，单线程 + + + + + + + 向指定客户端发送消息 + + + + + + + + 关闭在指定时间前失去响应的子客户端 + + + + + + 客户端信息 + + + + + 客户端句柄 + + + + + 客户端ID + + + + + 客户端连接时间 + + + + + 心跳时间 + + + + + 共享内存 + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 删除内存映射 + + + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + 发送消息的窗口句柄 + 发送消息 + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射对象 + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射字节数据 + + + + 数据库引擎 + + + + + 数据库枚举类型 + + + + + Odbc引擎 + + + + + OleDb引擎 + + + + + Oracle引擎 + + + + + MSSQL引擎 + + + + + SQLite引擎 + + + + + MySql引擎 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据 + + + + + + + 获取第一行第一列的值 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + + 数据库操作接口 + + + + + 连接数据库 + + + + + + 数据库是否已连接 + + + + + 断开数据库 + + + + + + 获取数量 + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + + 获取分页语句 + + + + + + + + + + 添加Parameter参数 + + + + + + + 清空Parameter参数 + + + + + + + 获取Parameter值 + + + + + + 根据RyQuickSQL类来获取Parameter值 + + + + + + + 开始执行事务 + + + + + 提交事务 + + + + + 判断是否包含数据 + + + + + + + + 返回-1000表示该数据库不支持本接口 + + + + + + + 读取数据 + + + + + + + 读取数据 + + + + + + + + 读取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + 执行SQL语句 + + + + + + + 根据id号删除数据 + + + + + + + + 根据id号删除数据 + + + + + + + + 创建数据库 + + + + + + + 释放资源 + + + + + 最后一个错误信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + SQL字段类型 + + + + + SQL字段类型 + + + + + + + SQL字段类型 + + + + + + + + SQL字段名 + + + + + SQL字段值 + + + + + SQL字段长度 + + + + + 不是真的值，而是用于计算的值 + + + + + SQL快速操作类 + + + + + SQL快速操作类 + + + + + + 表名 + + + + + 操作字段列表 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + 操作参数列表 + + + + + 操作参数列表 + + + + + 添加字符串字段 + + + + + + + 添加null值字段 + + + + + + 添加日期字段 + + + + + + + 添加int字段 + + + + + + + 添加double字段 + + + + + + + 添加decimal字段 + + + + + + + 添加byte[]字段 + + + + + + + 添加bool字段 + + + + + + + 添加用于计算的值 + + + + + + + 添加Int64字段 + + + + + + + 清空内容 + + + + + 数量 + + + + + + + + + + 输出多条件搜索。 + + 字段名,多个字段请用逗号分隔。 + 多个条件之间请用空格隔开 + + + + + 获取插入SQL语句 + + + + + + 获取更新SQL语句 + + + + + + 添加参数 + + + + + + + 获取Ole参数 + + + + + + 获取SQL参数 + + + + + + + + + + + + + + + + + + + + + + + 数据库路径 + 数据库密码 + + + + + + + 数据库路径 + + + + + + + + + + + + + + + + + + + + 连接数据库 + + + + + + 设置路径和密码 + + + + + + 连接数据库 + + + + + + + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 创建数据库 + + SQL语句 + + + + + 根据内置例子创建数据库 + + + + + + 保存信息，如果Name不存在，系统会自动创建 + + 返回1，表示成功，0表示失败 + + + + 获取信息 + + + + + + 获取信息 + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Shell + + + + + 根据路径获取 IShellFolder 和 PIDL + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 弹出系统右键菜单 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使用的数据库接口 + + + + + 使用的数据库连接字符串 + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 使用的数据库接口 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + FTP数据管理类(不含上传下载功能) + + + + + + + + + + + + 获取指定id的FTP信息 + + + + + + + 获取指定name的FTP信息 + + + + + + + 打开FTP管理界面 + + + + + 创建SQLite数据库表 + + + + + FTP信息 + + + + + id + + + + + 名称 + + + + + IP + + + + + 端口 + + + + + 用户名 + + + + + 密码 + + + + + 远程目录 + + + + + 加密方式 + + + + + 添加时间 + + + + + + + + + + 备注 + + + + + 添加时间字符串 + + + + + 设置 + + + + + 部门列表 + + + + + + + + + + 远程文件信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + Http连接操作帮助类 + + + + + + + + + + + + 根据相传入的数据，得到相应页面数据 + + 参数类对象 + 返回HttpResult类型 + + + + 获取数据的并解析的方法 + + + + + + + 设置编码 + + HttpItem + HttpResult + byte[] + + + + 提取网页Byte + + + + + + 为请求准备参数 + + 参数列表 + + + + 设置证书 + + + + + + 设置多个证书 + + + + + + 设置Cookie + + Http参数 + + + + 设置Post数据 + + Http参数 + + + + 设置代理 + + 参数对象 + + + + 回调验证证书问题 + + 流对象 + 证书 + X509Chain + SslPolicyErrors + bool + + + + 通过设置这个属性，可以在发出连接的时候绑定客户端发出连接所使用的IP地址。 + + + + + + + + + Http请求参考类 + + + + + 请求URL必须填写 + + + + + 请求方式默认为GET方式,当为POST方式时必须设置Postdata的值 + + + + + 默认请求超时时间 + + + + + 默认写入Post数据超时间 + + + + + 设置Host的标头信息 + + + + + 获取或设置一个值，该值指示是否与 Internet 资源建立持久性连接默认为true。 + + + + + 请求标头值 默认为text/html, application/xhtml+xml, */* + + + + + 请求返回类型默认 text/html + + + + + 客户端访问信息默认Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0) + + + + + 返回数据编码默认为NUll,可以自动识别,一般为utf-8,gbk,gb2312 + + + + + Post的数据类型 + + + + + Post请求时要发送的字符串Post数据 + + + + + Post请求时要发送的Byte类型的Post数据 + + + + + Cookie对象集合 + + + + + 请求时的Cookie + + + + + 来源地址，上次访问地址 + + + + + 证书绝对路径 + + + + + 设置代理对象，不想使用IE默认配置就设置为Null，而且不要设置ProxyIp + + + + + 是否设置为全文小写，默认为不转化 + + + + + 获取或设置要在 HTTP 请求中使用的 Date HTTP 标头值。默认不填写 + + + + + 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 + + + + + 最大连接数 + + + + + 代理Proxy 服务器用户名 + + + + + 代理 服务器密码 + + + + + 代理 服务IP,如果要使用IE代理就设置为ieproxy + + + + + 设置返回类型String和Byte + + + + + header对象 + + + + + 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 + + + + + 获取或设置一个 System.Boolean 值，该值确定是否使用 100-Continue 行为。如果 POST 请求需要 100-Continue 响应，则为 true；否则为 false。默认值为 true。 + + + + + 设置509证书集合 + + + + + 设置或获取Post参数编码,默认的为Default编码 + + + + + Cookie返回类型,默认的是只返回字符串类型 + + + + + 获取或设置请求的身份验证信息。 + + + + + 设置请求将跟随的重定向的最大数目 + + + + + 获取和设置IfModifiedSince，默认为当前日期和时间 + + + + + 设置本地的出口ip和端口 + ] + + item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); + + + + + 是否重置request,response的值，默认不重置，当设置为True时request,response将被设置为Null + + + + + Http返回参数类 + + + + + Http请求返回的Cookie + + + + + Cookie对象集合 + + + + + 返回的String类型数据 只有ResultType.String时才返回数据，其它情况为空 + + + + + 返回的Byte数组 只有ResultType.Byte时才返回数据，其它情况为空 + + + + + header对象 + + + + + 返回状态说明 + + + + + 返回状态码,默认为OK + + + + + 最后访问的URl + + + + + 获取重定向的URl + + + + + 返回类型 + + + + + 表示只返回字符串 只有Html有数据 + + + + + 表示返回字符串和字节流 ResultByte和Html都有数据返回 + + + + + Post的数据格式默认为string + + + + + 字符串类型，这时编码Encoding可不设置 + + + + + Byte类型，需要设置PostdataByte参数的值编码Encoding可设置为空 + + + + + 传文件，Postdata必须设置为文件的绝对路径，必须设置Encoding的值 + + + + + Cookie返回类型 + + + + + 只返回字符串类型的Cookie + + + + + CookieCollection格式的Cookie集合同时也返回String类型的cookie + + + + + Http服务器类 + + + + + + + + + + + + 当收到Get事件时激发 + + + + + 当收到Post事件时激发 + + + + + 监听的主机,默认是localhost + + + + + 最后一次错误信息 + + + + + 在此端口建立Http服务类 + + 端口号 + + + + + + + + + + 开始服务 + + + + + 退出服务 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超时时间 + + + + 以post方式获取网页源码 + + + + + + + + + 以post方式提交json内容 + + + + + + + + + 以post方式提交json内容 + + + + + + + + 以post方式获取网页源码 + + + + + + + + + + 以post方式获取网页源码 + + + + + + + + 获取网址对应的文件大小 + + + + + + + 获取网址对应的文件大小 + + + + + + + + 代理 + + + + + + + + + + 是否自动跳转 + + + + + 获取网页源码 + + + + + + + + 获取网页源码 + + + + + + + + + 获取网页源码 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将相对网址转换成绝对网址 + + 相对网址 + 当前页面地址 + 转换后的绝对网址 + + + + WebDav接口 + + + + + WebDav初始化 + + + + + + + + 删除文件 + + 相对路径,不包括域名 + + + + + 下载文件 + + + + + + + + 下载文件 + + + + + + + + + 上传文件 + + + + + + + + 上传文件 + + + + + + + + + 新建文件夹 + + + + + + + 新建文件夹 + + 文件夹路径 + + + + + + 新建文件夹 + + + + + + + + 将文件或目录列出来 + + + + + + + + 定义每个文件或目录的属性 + + + + + 文件名 + + + + + 是否是文件夹 + + + + + 网址 + + + + + 最后修改时间 + + + + + + + + + + + + + + + url解密 + + + + + + + + url解密,按UTF8方式解密 + + + + + + + Url加密 + + + + + + + + Url加密,按UTF8方式加密 + + + + + + + 解密 + + + + + + + 加密 + + + + + + + + + + + + + + + + + + + + + + + + + url加密,Unicode + + + + + + + + + + + + + + + + + + + + + + Html解码,将html里未转义成功的重新转义。 + + + + + + + 将url里的字段分解成表单字典 + + + + + + + + + 根据表单字段名获取值 + + + + + + + + + AES加密解密类 + + + + + AES加密算法 + + 明文字符串 + 密钥 + 返回加密后的密文字节数组 + + + + AES解密 + + 密文字节数组 + 密钥 + 返回解密后的字符串 + + + + 加密 + + + + + + + + 解码 + + + + + + + + 转换密钥到合法密钥 + + + + + + + Base64编码类 + + + + + 编码 + + + + + + + 把字符串编码成Base64字符串 + + + + + + + + 解码 + + + + + + + MD5和SHA1操作类 + + + + + 计算文件MD5。 + 通过MD5CryptoServiceProvider类中的ComputeHash方法直接传入一个FileStream类实现计算MD5 + 操作简单，代码少，调用即可 + + 文件地址 + MD5Hash + + + + 计算文件MD5。 + 通过HashAlgorithm的TransformBlock方法对流进行叠加运算获得MD5 + 实现稍微复杂，但可使用与传输文件或接收文件时同步计算MD5值 + 可自定义缓冲区大小，计算速度较快 + + 文件地址 + MD5Hash + + + + 获取MD5 + + + + + + + 获取MD5 + + + + + + + 获取SHA1 + + + + + + + 获取SHA1 + + + + + + + 获取HmacSHA1 + + + + + + + + 获取SHA256 + + + + + + + 获取HmacSHA256 + + + + + + + + 获取SHA224 + + + + + + + 获取SHA512 + + + + + + + 获取HmacSHA512 + + + + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 内部类 + + + + 读写锁对象 + + + + 是否为写入模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 构造函数 + + 读写锁 + 写入模式为true,读取模式为false + + + 释放对象时退出指定锁定模式 + + + + 空的可释放对象,免去了调用时需要判断是否为null的问题 + 内部类 + + + + 空的可释放对象 + + + + 空的释放方法 + + + + 读写锁 + + + + 保存数据 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + 为Data属性设置初始值 + + + + 获取或设置当前对象中保存数据的值 + + 获取数据时未进入读取或写入锁定模式 + 设置数据时未进入写入锁定模式 + + + 是否启用,当该值为false时,Read()和Write()方法将返回 Disposable.Empty + + + + 进入读取锁定模式,该模式下允许多个读操作同时进行 + 退出读锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在读取或写入锁定模式下重复执行,返回Disposable.Empty; + + + + 进入写入锁定模式,该模式下只允许同时执行一个写操作 + 退出写锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在写入锁定模式下重复执行,返回Disposable.Empty; + + 读取模式下不能进入写入锁定状态 + + + + 中国农历类,最大支持公元0-9999年 + + 日期：2019-02-09 + 作者：http://www.cnblogs.com/zjfree/ + + + + 日历类型 + + + + + 无效 + + + + + Julian 日历 + + + + + Gregorian 日历 + + + + + 有效 + + + + + 公历节日 + + + + + 农历节日 + + + + + 某个月第n个星期几 + + + + + 获取农历 + + + + + + + 获取农历 + + + + + + + + + 获得某农历年的闰月，返回 1~12 对应一月到十二月，返回 0 表示无闰月 + + + + + + + 农历搜索方向 + + + + + 无效 + + + + + 向上 + + + + + 向下 + + + + + {* 日月食类型， 无， 日食， 月全食， 月偏食 } + + + + + 无 + + + + + 日食 + + + + + 月全食 + + + + + 月偏食 + + + + + {* 月相， 无， 朔， 望} + + + + + 无 + + + + + 朔 + + + + + 望 + + + + + 获得某公历年月日的农历日数和该日月相以及日月食类型和时刻 + + + + + + + + + + + + 获得某公历年月日的农历月数 + + + + + + + + + 获取阳历日期对应的农历日期 + + + + + + + + + + + + + 获得某公历年月日的农历月日和是否闰月的信息 + + + + + + + + + + + + 获得等效标准日数对应的某公历日，倒推而来 + + + + + + + + + + 比较两个农历日期（包括闰月信息），1 大于2返回1、1等于2返回0、1小于2返回-1 + + + + + + + + + + + + + + 获得某农历年月日（加是否闰月）的公历年月日 + 该函数采用反向二分法查找 + + + + + + + + + + + + + 获取农历某一个月的总天数 + + + + + + + + + 获取农历年份，范围约1901-2101年 + + + + + + + 获取农历年份，范围约0-9999年 + + + + + + + + + 获取农历月份，范围约1901-2101年 + + + + + + + 获取农历月份，范围约0-9999年 + + + + + + + + + 获取中文表示的农历月份 + + + + + + + 获取农历日，范围约1901-2101年 + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 返回y年第n个节气（如小寒为1）的日差天数值（pd取值真假，分别表示平气和定气） + + + + pd取值真假，分别表示平气和定气 + + + + + 获取等效标准日数 + + + + + + + + + 取本月天数，不考虑 1582 年 10 月的特殊情况 + + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 获取节气 + + + + + + + + + + + + 获取公历节日 + + + + + + + 获取公历节日 + + + + + + + + + 获取指定月份的第n个星期几的节日 + + + + + + + 返回星座，范围约1901-2101年 + + + + + 返回星座，范围约0-9999年 + + + + + 获取农历节日 + + + + + + + + + 获取农历节日 + + + + + + + 判断y年m月(1,2,..,12,下同)d日是Gregorian历还是Julian历（opt=1,2,3分别表示标准日历,Gregorge历和Julian历）,是则返回1，是Julian历则返回0，若是Gregorge历所删去的那10天则返回-1 + + + + + 返回阳历y年m月d日的日差天数（在y年年内所走过的天数，如2000年3月1日为61） + + + + + 返回阳历y年日差天数为x时所对应的月日数（如y=2000，x=274时，返回1001(表示10月1日，即返回100*m+d)） + + + + + 获取指定日期的节气。 + + 要获取的年 + 要获取的月 + + + 立春：立是开始的意思，春是蠢动，表示万物开始有生气，这一天春天开始。 + 雨水：降雨开始，雨水将多。 + 惊蛰：春雷响动，惊动蛰伏地下冬眠的生物，它们将开始出土活动。 + 春分：这是春季九十天的中分点，这一天昼夜相等，所以古代曾称春分秋分为昼夜分。 + 清明：明洁晴朗，气候温暖，草木开始萌发繁茂。 + 谷雨：雨生百谷的意思。雨水增多，适时的降雨对谷物生长很为有利。 + 立夏：夏天开始，万物渐将随温暖的气候而生长。 + 小满：满指籽粒饱满，麦类等夏热作物这时开始结籽灌浆，即将饱满。 + 芒种：有芒作物开始成熟，此时也是秋季作物播种的最繁忙时节。 + 夏至：白天最长，黑夜最短，这一天中午太阳位置最高，日影短至终极，古代又称这一天为日北至或长日至。 + 小暑：暑是炎热，此时还未到达最热。 + 大暑：炎热的程度到达高峰。 + 立秋：秋天开始，植物快成熟了。 + 处暑：处是住的意思，表示暑气到此为止。 + 白露：地面水气凝结为露，色白，是天气开始转凉了。 + 秋分：秋季九十天的中间，这一天昼夜相等，同春分一样，太阳从正东升起正西落下。 + 寒露：水露先白而后寒，是气候将逐渐转冷的意思。 + 霜降：水气开始凝结成霜。 + 立冬：冬是终了，作物收割后要收藏起来的意思，这一天起冬天开始。 + 小雪：开始降雪，但还不多。 + 大雪：雪量由小增大。 + 冬至：这一天中午太阳在天空中位置最低，日影最长，白天最短， 黑夜最长，古代又称短日至或日南至。 + 小寒：冷气积久而为寒，此时尚未冷到顶点。 + 大寒：天候达到最寒冷的程度 + + + + + 获取年柱。 + + + + + 获得月柱 + + + + + + + 获取日柱。 + + + + + 返回甲子数x对应的天干数（如33为3） + + + + + 返回甲子数x对应的地支数（如33为9） + + + + + 获取日的天干地支 + + + + + + + 返回甲子数x对应的天干字符串 + + + + + 返回甲子数x对应的地支字符串 + + + + + 返回甲子数x对应的干支字符串 + + + + + + + 获取三伏开始时间 + + + 0表示1伏，1表示2伏，2表示3伏 + + + + + 节气 + + + + + 节气的时间。 + + + + + 节气名。 + + + + + 热键转换类 + + + + + 功能键。 + + + + + 修改键。 + + + + + 转换功能键到谷歌浏览器专用 + + + + + 将chrome功能键转换为普通功能键 + + + + + + + 按键值。 + + + + + 初始化类 的新实例。 + + The modifiers. + The key code. + + + + + + + + + + + + + + + + + 初始化类 的新实例。 + + + + + 加载热键 + + + + + + + 加载热键 + + + + + + 加载热键 + + + + + + 判断是否是热键 + + + + + 获取当前热键 + + + + + 已重载，返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 功能键 + + + + + 无 + + + + + Alt键 + + + + + Ctrl键 + + + + + Alt+Ctrl键 + + + + + Shift键 + + + + + Shift+Alt键 + + + + + Shift+Ctrl键 + + + + + Alt+Shift+Ctrl键 + + + + + Win键 + + + + + 热键类 + + + + + 热键类 + + + + + + 热键注销 + + + + + 热键是否有效 + + + + + 释放热键 + + + + + 获取热键Tag + + + + + + + 获取热键id + + + + + + + 获取热键id + + + + + + + + 判断热键id是否存在 + + + + + + + 判断热键Tag是否存在 + + + + + + + 判断热键是否存在 + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + + 获取热键数量 + + + + + 删除热键 + + + + + + + 删除所有热键 + + + + + 删除所有热键 + + + + + 热键事件 + + + + + + 当使用热键时发生的事件 + + + + + 热键消息过滤 + + + + + + + 热键类型 + + + + + 热键id + + + + + 热键Tag + + + + + 功能键 + + + + + 普通键 + + + + + 热键类型 + + + + + + + + 热键类型 + + + + + + + + + 热键类型 + + + + + Win32 API + + + + + + + + + + WM_COPYDATA消息的主要目的是允许在进程间传递只读数据。 + + + + + 系统通道ID + + + + + 用户通道ID + + + + + 获取消息 + + + + + + + + 发送消息 + + + + + + + + + + 设置父窗口 + + + + + + + + + + + + + + 删除一个逻辑笔、画笔、字体、位图、区域或者调色板，释放所有与该对象有关的系统资源，在对象被删除之后，指定的句柄也就失效了。 + + + + + + + 选择一对象到指定的设备上下文环境中，该新对象替换先前的相同类型的对象。 + + + + + + + + 创建一个与指定设备兼容的内存设备上下文环境（DC）。 + + + + + + + 为一个设备创建设备上下文环境。 + + + + + + + + + + 删除指定的设备上下文环境（Dc）。 + + + + + + + + + + + + 结束进程 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 模拟鼠标点击 + + + + + + + + + + + 模拟按键 + + + + + + + + + 返回hWnd参数所指定的窗口的设备环境。 + + + + + + + 移动窗口 + + + + + + + + + + + + 将消息信息传送给指定的窗口过程的函数。使用函数CallWindowsProc可进行窗口子分类。 + 通常来说，同一类的所有窗口共享一个窗口过程。子类是一个窗口或者相同类的一套窗口， + 在其消息被传送到该类的窗口过程之前，这些消息是由另一个窗口过程进行解释和处理的。 + + + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 设置弹出式窗口，层叠窗口或子窗口的父窗口 + + + + + + + + 获得一个指定子窗口的父窗口句柄 + + Handle to the window whose parent window handle is to be retrieved. + If the window is a child window, the return value is a handle to the parent window. If the window is a top-level window, the return value is a handle to the owner window. If the window is a top-level unowned window or if the function fails, the return value is NULL. + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作 + + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作。 + 如果此参数为FALSE，GetSystemMenu返回当前使用窗口菜单的拷贝的句柄。该拷贝初始时与窗口菜单相同，但可以被修改。 + 如果此参数为TRUE，GetSystemMenu重置窗口菜单到缺省状态。如果存在先前的窗口菜单，将被销毁。 + + 如果参数bRevert为FALSE，返回值是窗口菜单的拷贝的句柄：如果参数bRevert为TRUE，返回值是NULL。 + + + + 从指定菜单删除一个菜单项或分离一个子菜单。 + 备注：只要一个菜单被修改，无论它是否在显示窗口里，应用程序都必须调用函数DrawMenuBar。 + + 将被修改的菜单的句柄。 + 指定将被删除的菜单项，其含义由参数wFlags决定。 + + 如果函数调用成功，返回非零值；如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。 + + + + 设置前台窗口 + + + + + + + 获取当前前台窗口句柄 + + + + + + 获得当前活动窗体 + + 活动窗口的句柄。如没有窗口处于活动状态或处于活动状态的窗口非当前线程创建，则返回零。 + + + + 设置活动窗体 + + + + + + + 获取类名 + + + + + + + + + 获取当前线程对应的进程ID + + + + + + + + 判断指定句柄是否是一个窗口 + + + + + + + 获取窗口标题 + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + 从文件中载入指针 + + + + + + + 判断窗口是否可见 + + + + + + + 查找窗口 + + + + + + + + The FindWindowEx function retrieves a handle to a window whose class name and window name match the specified strings. The function searches child windows, beginning with the one following the specified child window. + + Handle to the parent window whose child windows are to be searched. + Handle to a child window. + Specifies class name. + Pointer to a null-terminated string that specifies the window name (the window's title). + If the function succeeds, the return value is a handle to the window that has the specified class and window names.If the function fails, the return value is NULL. + + + + The InvalidateRect function adds a rectangle to the specified window's update region. + + Handle to window. + Rectangle coordinates. + Erase state. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + The ValidateRect function validates the client area within a rectangle by removing the rectangle from the update region of the specified window. + + Handle to window. + Validation rectangle coordinates. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + 获取指定窗口的有关信息，也可用于获取窗口内存中指定偏移的32位度整型值。 + + + + + + + + 检索一指定窗口的客户区域或整个屏幕的显示设备上下文环境的句柄，以后可以在GDI函数中使用该句柄来在设备上下文环境中绘图。 + + + + + + + 释放设备上下文环境（DC）供其他应用程序使用。函数的效果与设备上下文环境类型有关。它只释放公用的和设备上下文环境，对于类或私有的则无效。 + + + + + + + + 获取桌面句柄 + + + + + + 获取窗口客户区的大小。注意一下：窗口的客户区为窗口中除标题栏、菜单栏之外的地方。 + + + + + + + + 返回指定窗口的边框矩形的尺寸。该尺寸以相对于屏幕坐标左上角的屏幕坐标给出。 + + + + + + + + 更新一个分层窗口的位置，大小，形状，内容和半透明度 + + + + + + + + + + + + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + + + + + + + + + + + + 设置指针位置 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置是否捕获鼠标 + + + + + 获取或设置是否显示图像信息 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框边框颜色 + + + + + 获取或设置放大图形的原始尺寸 + + + + + 获取或设置放大图像的倍数 + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置用于被操作的图像 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框线条的颜色 + + + + + 获取当前选中的区域 + + + + + 获取或设置放大图像的原图大小尺寸 + + + + + 获取或设置图像放大的倍数 + + + + + 获取或设置是否绘制操作框点 + + + + + 获取或设置是否限制鼠标操作区域 + + + + + 获取或设置是否绘制信息展示 + + + + + 获取或设置是否根据图像大小自动调整控件尺寸 + + + + + 获取当前是否绘制的有区域 + + + + + 获取当前是否开始绘制 + + + + + 获取当前操作框是否正在移动 + + + + + 获取或设置操作框是否锁定 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 响应四个按键实现精确移动 + + + + + + + + + + + + 绘制操作框 + + + + + + 绘制图像放大信息 + + + + + + 清空所有操作 + + + + + 手动设置一个块选中区域 + + 要选中区域 + + + + 手动设置一个块选中区域 + + 要选中区域的坐标 + 要选中区域的大小 + + + + 手动设置一个块选中区域 + + 要选中区域的x坐标 + 要选中区域的y坐标 + 要选中区域的宽度 + 要选中区域的高度 + + + + 手动设置信息显示的位置 + + 要显示的位置 + + + + 手动设置信息显示的位置 + + 要显示位置的x坐标 + 要显示位置的y坐标 + + + + 获取操作框内的图像 + + 结果图像 + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标结构信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置Hook + + + + + + 卸载Hook + + + + + + 鼠标状态枚举值 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 升级地址 + + + + + + + + + + 隔多久后再次检查更新 + + + + + 本地保存的配置信息 + + + + + 当前安装的软件版本 + + + + + 当前安装的软件修正版本 + + + + + 当前安装的数据库版本 + + + + + + + + + + + + + + + + + + + + 获取当前更新的类型 + + + + + 每隔n小时检测一次更新 + + + + + 读取版本信息完成后激发 + + + + + 没有版本更新时激发 + + + + + 发现新版本时激发 + + + + + 发生错误后激发 + + + + + 更新进度变化后激发 + + + + + 开始检测新版本 + + + + + + + + + + 初始化升级函数 + + 为null,则表示事件运行在多线程模式下，否则,事件是在窗体所在线程下 + + + + + + + + + + + + + + 获取版本信息 + + + + + 开始下载 + + + + + 开始下载 + + + + + 下载,不使用多线程 + + + + + 结束下载 + + + + + + + + + + + + + + + 设置升级 + + + + + 是否是在线更新 + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + 提示文本 + + + + + 更新日期 + + + + + 更新版本 + + + + + 更新描述 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新类型,soft或者data + + + + + 更新描述Url + + + + + 更新描述 + + + + + 版本 + + + + + 更新日期 + + + + + 更新地址 + + + + + 在下载升级包前首先要下载的内容 + + + + + 升级程序要使用的设置xml + + + + + + + + + + 错误字符串 + + + + + 错误id + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前登陆用户 + + + + + + + + + + 没有版本更新时激发 + + + + + + + + + + + 取消更新。 + + + + + + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + Martin Lottering : 2007-10-27 + -------------------------------- + This is a usefull control in Filters. Allows you to save space and can replace a Grouped Box of CheckBoxes. + Currently used on the TasksFilter for TaskStatusses, which means the user can select which Statusses to include + in the "Search". + This control does not implement a CheckBoxListBox, instead it adds a wrapper for the normal ComboBox and Items. + See the CheckBoxItems property. + ---------------- + ALSO IMPORTANT: In Data Binding when setting the DataSource. The ValueMember must be a bool type property, because it will + be binded to the Checked property of the displayed CheckBox. Also see the DisplayMemberSingleItem for more information. + ---------------- + Extends the CodeProject PopupComboBox "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp" + by Lukasz Swiatkowski. + + + + + + + + + + The checkbox list control. The public CheckBoxItems property provides a direct reference to its Items. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation and its formatting however is controlled + by the Binded object, since it owns that property. + + + + + Builds a CSV string of the items selected. + + + + + A direct reference to the Items of CheckBoxComboBoxListControl. + You can use it to Get or Set the Checked status of items manually if you want. + But do not manipulate the List itself directly, e.g. Adding and Removing, + since the list is synchronised when shown with the ComboBox.Items. So for changing + the list contents, use Items instead. + + + + + The DataSource of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + The ValueMember of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation however is controlled by the Binded + object, since it owns that property. + + + + + Made this property Browsable again, since the Base Popup hides it. This class uses it again. + Gets an object representing the collection of the items contained in this + System.Windows.Forms.ComboBox. + + A System.Windows.Forms.ComboBox.ObjectCollection representing the items in + the System.Windows.Forms.ComboBox. + + + + + + + + + + + + + + + + + Will add an invisible item when the style is DropDownList, + to help maintain the correct text in main TextBox. + + + + + + + + + + + + A function to clear/reset the list. + (Ubiklou : http://www.codeproject.com/KB/combobox/extending_combobox.aspx?msg=2526813#xx2526813xx) + + + + + Uncheck all items. + + + + + The properties that will be assigned to the checkboxes as default values. + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + A container control for the ListControl to ensure the ScrollBar on the ListControl does not + Paint over the Size grip. Setting the Padding or Margin on the Popup or host control does + not work as I expected. + + + + + + + + + + Prescribed by the Popup class to ensure Resize operations work correctly. + + + + + + This ListControl that pops up to the User. It contains the CheckBoxComboBoxItems. + The items are docked DockStyle.Top in this control. + + + + + + + + + + + Simply a reference to the CheckBoxComboBox. + + + + + A Typed list of ComboBoxCheckBoxItems. + + + + + + + + + + Prescribed by the Popup control to enable Resize operations. + + + + + + + + + + + + Maintains the controls displayed in the list by keeping them in sync with the actual + items in the combobox. (e.g. removing and adding as well as ordering) + + + + + The CheckBox items displayed in the Popup of the ComboBox. + + + + + + + A reference to the CheckBoxComboBox. + A reference to the item in the ComboBox.Items that this object is extending. + + + + A reference to the CheckBoxComboBox. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + When using Data Binding operations via the DataSource property of the ComboBox. This + adds the required Bindings for the CheckBoxes. + + + + + + + + + + + Added this handler because the control doesn't seem + to initialize correctly until shown for the first + time, which also means the summary text value + of the combo is out of sync initially. + + + + + A Typed List of the CheckBox items. + Simply a wrapper for the CheckBoxComboBox.Items. A list of CheckBoxComboBoxItem objects. + This List is automatically synchronised with the Items of the ComboBox and extended to + handle the additional boolean value. That said, do not Add or Remove using this List, + it will be lost or regenerated from the ComboBox.Items. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Returns the item with the specified displayName or Text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Called when any property changes. + + + + + + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com Simple pop-up control http://www.codeproject.com/cs/miscctrl/simplepopup.asp. + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Gets a value indicating whether the PopupControl.Popup uses the fade effect. + + true if pop-up uses the fade effect; otherwise, false. + To use the fade effect, the FocusOnOpen property also has to be set to true. + + + + Gets or sets a value indicating whether to focus the content after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether this PopupControl.Popup is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets the size that is the lower limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the size that is the upper limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the PopupControl.Popup class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows pop-up window below the specified area of specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Adjusts the size of the owner to accommodate the if the owner is currently displayed, or clears and resets active child controls of the if the is not currently displayed. + + true if the owner is currently displayed; otherwise, false. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + + + + + + + + + + + + + + + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the size grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the PopupControl.PopupComboBox class. + + + + + The pop-up wrapper for the dropDownControl. + Made PROTECTED instead of PRIVATE so descendent classes can set its Resizable property. + Note however the pop-up properties must be set after the dropDownControl is assigned, since this + popup wrapper is recreated when the dropDownControl is assigned. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Shows the drop down. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Maintains an additional "Selected" and "Count" value for each item in a List. + Useful in the CheckBoxComboBox. It holds a reference to the List[Index] Item and + whether it is selected or not. + It also caters for a Count, if needed. + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. And no Counts will be displayed + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + Is a Count indicator used. + + + + + The original List of values wrapped. A "Selected" and possibly "Count" functionality is added. + + + + + Used to indicate NOT to use ToString(), but read this property instead as a display value. + + + + + When specified, indicates that ToString() should not be performed on the items. + This property will be read instead. + This is specifically useful on DataTable implementations, where PropertyDescriptors are used to read the values. + + + + + Builds a concatenation list of selected items in the list. + + + + + Indicates whether the Item display value (Name) should include a count. + + + + + Reset all counts to zero. + + + + + Creates a ObjectSelectionWrapper item. + Note that the constructor signature of sub classes classes are important. + + + + + + + + + + + + + + Used together with the ListSelectionWrapper in order to wrap data sources for a CheckBoxComboBox. + It helps to ensure you don't add an extra "Selected" property to a class that don't really need or want that information. + + + + + + + + + + + + Used as a count indicator for the item. Not necessarily displayed. + + + + + Is this item selected. + + + + + A reference to the wrapped item. + + + + + The containing list for these selections. + + + + + An indicator of how many items with the specified status is available for the current filter level. + Thaught this would make the app a bit more user-friendly and help not to miss items in Statusses + that are not often used. + + + + + A reference to the item wrapped. + + + + + The item display value. If ShowCount is true, it displays the "Name [Count]". + + + + + The textbox display value. The names concatenated. + + + + + Indicates whether the item is selected. + + + + + + + + + + + + + + + + 控件的状态。 + + + + + 正常 + + + + + 鼠标经过 + + + + + 鼠标按下 + + + + + 鼠标的当前位置 + + + + + + + + + + + + + + + + + + + + 美化按钮 + + + + + 普通按钮矩形位置 + + + + + 美化按钮 + + + + + 分割按钮的宽度 + + + + + 是否启用分割按钮 + + + + + 优先使用默认皮肤 + + + + + 按钮基础背景色 + + + + + 按钮字体颜色 + + + + + 图片宽度,默认值为18px，最小12px + + + + + 圆角的位置,默认全部都是圆角 + + + + + 设置圆角半径 + + + + + 背景色是否渐变 + + + + + 图片高度 + + + + + 图片与文字之间的间距 + + + + + 当鼠标按下时图片和文字是否产生偏移 + + + + + 鼠标进入时 + + + + + + 鼠标离开 + + + + + + 鼠标按下 + + + + + + 鼠标弹起 + + + + + + 鼠标当前所在位置 + + + + + 获取图像以及文字的位置 + + + + + + + + + + + + + + + + + + + + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强版Label(禁用了双击Label会自动复制文本到剪切板的功能) + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强富文本控件 + + + + + 开始更新 + + + + + 结束更新 + + + + + RichTextBox + + + + + + + + + + + + + + + + + + + + + + + 在自带菜单弹出前激发 + + + + + 根据标签获得菜单项 + + + + + + + 只允许输入文本(只对设置之后的人工输入有效) + + + + + 按下按键 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标按下 + + + + + + + + + + + + + + + + + + 当文本框为空时,显示的内容。 + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 消息列表控件 + + + + + 最大高度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 增强时间控件 + + + + + 增强时间控件 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 选择文本框 + + + + + 选择文本框 + + + + + 按钮基础背景色 + + + + + 优先使用默认皮肤 + + + + + 选择的id + + + + + 选择的名称 + + + + + 选择的名称 + + + + + 字体 + + + + + 重新设置大小 + + + + + 在选择时激发 + + + + + 点击选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 建立圆角路径的样式。 + + + + + 四个角都不是圆角。 + + + + + 四个角都为圆角。 + + + + + 左边两个角为圆角。 + + + + + 右边两个角为圆角。 + + + + + 上边两个角为圆角。 + + + + + 下边两个角为圆角。 + + + + + 左下角为圆角。 + + + + + 右下角为圆角。 + + + + + 画图相关API + + + + + 建立带有圆角样式的路径。 + + 用来建立路径的矩形。 + 圆角的大小。 + 圆角的样式。 + 是否把矩形长宽减 1,以便画出边框。 + 建立的路径。 + + + + 窗体皮肤 + + + + + 窗体皮肤 + + + + + 标题属性 + + + + + 是否使用父窗口的图标 + + + + + 点击最小化按钮是最小化还是隐藏 + + + + + 最大化按钮 + + + + + 最小化按钮 + + + + + 标题栏关闭按钮是否显示 + + + + + 当窗口位于后台时，是否标注显示。 + + + + + + + + + + 标题栏字体颜色 + + + + + 标题栏不处于活动状态时的字体颜色 + + + + + 标题栏背景颜色 + + + + + 标题栏不处于活动状态时的背景颜色 + + + + + 是否允许拖拉窗体边缘来改变窗体大小 + + + + + + + + + + + 画边框 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 热键文本框 + + + + + 热键文本框 + + + + + + + + + + + + + + + + + 在控件大小变化时发生 + + + + + + 此属性无效 + + + + + 载入热键配置 + + + + + + 保存热键 + + + + + + 是否含义热键 + + + + + 读取或设置热键 + + + + + 功能键 + + + + + 热键按键 + + + + + KeyDown事件 + + + + + + KeyDown事件 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 可以改变文本行距（行间距）的Label + + + + + 行间距 + + + + + 可以改变文本行距（行间距）的Label + + + + + + + + + + 字体高度 + + + + + + + + + + 文本 + + + + + + + + + + + + + + + + + + + 图标列表控件 + + + + + 图标列表控件 + + + + + 图标大小 + + + + + 文本显示高度(从底部算起) + + + + + 默认图标 + + + + + 是否显示图标 + + + + + 是否显示网格线 + + + + + 角标图标合集 + + + + + 画项 + + + + + + 选择项的背景开始颜色 + + + + + 选择项的背景结束颜色 + + + + + 选择项的边框颜色 + + + + + 选择项的字体颜色 + + + + + 重绘选中时背景 + + + + + 重绘图标 + + + 区域大小 + + + + + + + + 重绘文本 + + + + + 获取文本对齐 + + + + + 水平滚动条滚动事件 + + + + + 垂直滚动条滚动事件 + + + + + + + + + + + 列表项 + + + + + 图标 + + + + + 角标图片序号,为-1表示无角标 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + 内容 + + + + + 网址 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 计算两个日期的时间间隔,返回的是日期值+ + + 时间值,将显示在返回的值里 + 参照时间 + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 控件边框颜色 + + + + + 控件背景颜色 + + + + + 圆角弧度大小 + + + + + 圆角风格 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 图标 + + + + + 标题 + + + + + 悬浮提示 + + + + + 标题颜色 + + + + + 设置按钮 + + + + + + + 判断和设置是否选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 绘制边框 + + 消息 + + + + 类说明：CContextMenuStrip控件的实现用来代替系统的ContextMenuStrip控件 + + + + + + + + + + + + + + + + 重写OnCreateControl + + + + + 重写OnPaint事件 + + + + + + CreateRoundedRectanglePath + + Rectangle + + + + + + 系统热键数据类。 + + + + + 系统热键数据类 + + + + + 使多行属性失效掉 + + + + + 使只读属性失效掉 + + + + + 获取热键文本 + + + + + 功能键 + + + + + 热键按键 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 在搜索时激发 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + + + + + + 文本为空时的显示效果 + + + + + 文本不选中 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + 字体 + + + + + 优先使用默认皮肤 + + + + + 背景色是否渐变 + + + + + 按钮基础背景色 + + + + + 按钮圆角部分背景颜色 + + + + + + + + + + 重新设置大小 + + + + + 点击搜索按钮 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 使用公共皮肤 + + + + + 按钮颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 皮肤公共类 + + + + + 是否使用默认皮肤 + + + + + 按钮皮肤 + + + + + 按钮皮肤类 + + + + + 背景颜色 + + + + + 字体颜色 + + + + + 是否颜色渐变 + + + + + 类说明：帮助类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 修改控件或窗体的边框，例如Textbox或是Form窗体 + + 消息 + 控件对象 + 边框像素 + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 图片所在上级域名 + + + + + 图片资源所在上级文件夹 + + + + + 根据不同前缀，加载不同格式图片。i:表示工程内置图片;s:表示T_ImageDomain域名下的图片,u:表示指定url的图片;f:表示本地图片 + + + + + + 加载本地图片,加载完毕不会占用本地图片 + + + + + + 加载指定url图片 + + url位置 + 是否异步 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 选项发生变化时激发 + + + + + 标签选择的序号 + + + + + + + + + + 选择的颜色 + + + + + 多标签控件颜色 + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 获取对应的标签 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获得当前进程，以便重绘控件 + + + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点边框颜色 + + + + + 是否鼠标MouseOver状态 + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点时边框颜色 + + + + + + + + + + 鼠标移动到该控件上时 + + + + + + 当鼠标从该控件移开时 + + + + + + 当该控件获得焦点时 + + + + + + 当该控件失去焦点时 + + + + + + 获得操作系统消息 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 美化文本框控件 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + 是否只能输入数字 + + + + + 是否多行 + + + + + 是否在显示不下时换行 + + + + + 最大长度 + + + + + + + + + + 背景颜色 + + + + + 右键菜单 + + + + + 字体颜色 + + + + + 选择的开始位置 + + + + + 选择的长度 + + + + + 选择的文本 + + + + + 提示文本 + + + + + 选择全部 + + + + + 密码 + + + + + 是否只读 + + + + + + + + + + + 文本为空时的显示效果 + + + + + 字体 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + + + + + + 选择文本框中的文本范围 + + 文本框中当前选定文本的第一个字符的位置。 + 要选择的字符数 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Define some Windows message constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This class adds to the functionality provided in System.Windows.Forms.MenuStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + This class adds to the functionality provided in System.Windows.Forms.ToolStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 透明图片控件 + + + + + 是否使用透明,默认为True + + + + + 设置透明度 + + + + + 要绑定的控件 + + + + + 透明图片控件 + + + + + 图片 + + + + + 初始化加载控件 + + 透明度 + 是否显示加载图片 + 图片 + + + + + + + + + + + + + + + 显示加载 + + + + + 隐藏加载 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日历控件 + + + + + 单击事件 + + + + + + + 单击某个日期事件 + + + + + 日历控件 + + + + + 设置日期 + + + + + 放假数据表 + + + + + 是否处于设计模式 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日控件 + + + + + 日控件 + + + + + 当前日期 + + + + + 在发生页码变化前激发 + + + + + 设置休息状态,1为休息,-1为上班，其它为不显示 + + + + + + 日期 + + + + + 农历 + + + + + 阳历日期字体颜色 + + + + + 阳历日期字体 + + + + + 农历日期字体 + + + + + 农历部分字体颜色 + + + + + 是否选中 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + 类 名:ColorHSL + 功 能:H 色相 \ S 饱和度(纯度) \ L 亮度 颜色模型 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + HSL颜色 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 饱和度 + + + + + 类 名:ColorHSV + 功 能:H 色相 \ S 饱和度(纯度) \ V 明度 颜色模型 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 明度 + + + + + 类 名:ColorRGB + 功 能:R 红色 \ G 绿色 \ B 蓝色 颜色模型 + 所有颜色模型的基类,RGB是用于输出到屏幕的颜色模式,所以所有模型都将转换成RGB输出 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + + + + + + + 红色 + + + + + 绿色 + + + + + 蓝色 + + + + + 获取实际颜色 + + + + + + 类 名:ColorHelper + 功 能:提供从RGB到HSV/HSL色彩空间的相互转换 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + RGB转换HSV + + + + + + + HSV转换RGB + + + + + + + RGB转换HSL + + + + + + + HSL转换RGB + + H, S and L input range = 0 -1.0 + + + + + RGB转CMYK + + + + + + + + + + RGB转CMYK + + + + + + + + + + + + CMYK转RGB + + + + + + + + + + Standard-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Standard-RGB,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Adobe-RGB,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Adobe-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Yxy转RGB + + + + + + + + + RGB转Yxy + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 超级颜色选择控件 + + + 分页控件 + + + + + + + + + + + + + + + + + + + + + + + + + + 获取网页颜色 + + + + + 超级颜色选择控件 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Chrome风格的多标签控件 + + + + + 设置选项卡处于选中状态时第一背景色. + + + + + 设置选项卡处于选中状态时第二背景色. + + + + + 设置选项卡处于非选中状态时第一背景色. + + + + + 设置选项卡处于非选中状态时第二背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第一背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第二背景色. + + + + + 设置选项卡工作区背景色. + + + + + 设置选项卡工作区背景图. + + + + + 是否显示关闭按钮 + + + + + 是否显示新增按钮 + + + + + 是否允许拖拽标签 + + + + + 标签最大宽度 + + + + + 标签右键菜单 + + + + + 鼠标按下标签时激发 + + + + + 鼠标放开标签时激发 + + + + + Chrome风格的多标签控件 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置圆角半径 + + + + + Tab文字左边距离 + + + + + + + + + + + + + + 画标签文字 + + + + + + + + + 画标签图标 + + + + + + + 画关闭按钮 + + + + + + + + 获取所有选项卡合起来的宽度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 添加新标签 + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + The position is not over a tab. + + + + + The position is over a tab's icon. + + + + + The position is over a tab's text. + + + + + The position is over a tab but not over its icon or its text. For owner-drawn tab controls, this value is specified if the position is anywhere over a tab. + TCHT_ONITEM is a bitwise-OR operation on TCHT_ONITEMICON and TCHT_ONITEMLABEL. + + + + + Specifies values from SetWindowPosZ enumeration. + + + + + Specified HWND_TOP enumeration value. + + + + + Specified HWND_BOTTOM enumeration value. + + + + + Specified HWND_TOPMOST enumeration value. + + + + + Specified HWND_NOTOPMOST enumeration value. + + + + + Invalidates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_INVALIDATE invalidates the entire window. + + + + Causes the OS to post a WM_PAINT message to the window regardless of whether a portion of the window is invalid. + + + + Causes the window to receive a WM_ERASEBKGND message when the window is repainted. + Specify this value in combination with the RDW_INVALIDATE value; otherwise, RDW_ERASE has no effect. + + + + + Validates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_VALIDATE validates the entire window. + This value does not affect internal WM_PAINT messages. + + + + Suppresses any pending WM_ERASEBKGND messages. + + + Excludes child windows, if any, from the repainting operation. + + + Includes child windows, if any, in the repainting operation. + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND and WM_PAINT messages before the RedrawWindow returns, if necessary. + + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND messages before RedrawWindow returns, if necessary. + The affected windows receive WM_PAINT messages at the ordinary time. + + + + + Specifies values from Msgs enumeration. + + + + + Specified WM_NULL enumeration value. + + + + + Specified WM_CREATE enumeration value. + + + + + Specified WM_DESTROY enumeration value. + + + + + Specified WM_MOVE enumeration value. + + + + + Specified WM_SIZE enumeration value. + + + + + Specified WM_ACTIVATE enumeration value. + + + + + Specified WM_SETFOCUS enumeration value. + + + + + Specified WM_KILLFOCUS enumeration value. + + + + + Specified WM_ENABLE enumeration value. + + + + + Specified WM_SETREDRAW enumeration value. + + + + + Specified WM_SETTEXT enumeration value. + + + + + Specified WM_GETTEXT enumeration value. + + + + + Specified WM_GETTEXTLENGTH enumeration value. + + + + + Specified WM_PAINT enumeration value. + + + + + Specified WM_CLOSE enumeration value. + + + + + Specified WM_QUERYENDSESSION enumeration value. + + + + + Specified WM_QUIT enumeration value. + + + + + Specified WM_QUERYOPEN enumeration value. + + + + + Specified WM_ERASEBKGND enumeration value. + + + + + Specified WM_SYSCOLORCHANGE enumeration value. + + + + + Specified WM_ENDSESSION enumeration value. + + + + + Specified WM_SHOWWINDOW enumeration value. + + + + + Specified WM_WININICHANGE enumeration value. + + + + + Specified WM_SETTINGCHANGE enumeration value. + + + + + Specified WM_DEVMODECHANGE enumeration value. + + + + + Specified WM_ACTIVATEAPP enumeration value. + + + + + Specified WM_FONTCHANGE enumeration value. + + + + + Specified WM_TIMECHANGE enumeration value. + + + + + Specified WM_CANCELMODE enumeration value. + + + + + Specified WM_SETCURSOR enumeration value. + + + + + Specified WM_MOUSEACTIVATE enumeration value. + + + + + Specified WM_CHILDACTIVATE enumeration value. + + + + + Specified WM_QUEUESYNC enumeration value. + + + + + Specified WM_GETMINMAXINFO enumeration value. + + + + + Specified WM_PAINTICON enumeration value. + + + + + Specified WM_ICONERASEBKGND enumeration value. + + + + + Specified WM_NEXTDLGCTL enumeration value. + + + + + Specified WM_SPOOLERSTATUS enumeration value. + + + + + Specified WM_DRAWITEM enumeration value. + + + + + Specified WM_MEASUREITEM enumeration value. + + + + + Specified WM_DELETEITEM enumeration value. + + + + + Specified WM_VKEYTOITEM enumeration value. + + + + + Specified WM_CHARTOITEM enumeration value. + + + + + Specified WM_SETFONT enumeration value. + + + + + Specified WM_GETFONT enumeration value. + + + + + Specified WM_SETHOTKEY enumeration value. + + + + + Specified WM_GETHOTKEY enumeration value. + + + + + Specified WM_QUERYDRAGICON enumeration value. + + + + + Specified WM_COMPAREITEM enumeration value. + + + + + Specified WM_GETOBJECT enumeration value. + + + + + Specified WM_COMPACTING enumeration value. + + + + + Specified WM_COMMNOTIFY enumeration value. + + + + + Specified WM_WINDOWPOSCHANGING enumeration value. + + + + + Specified WM_WINDOWPOSCHANGED enumeration value. + + + + + Specified WM_POWER enumeration value. + + + + + Specified WM_COPYDATA enumeration value. + + + + + Specified WM_CANCELJOURNAL enumeration value. + + + + + Specified WM_NOTIFY enumeration value. + + + + + Specified WM_INPUTLANGCHANGEREQUEST enumeration value. + + + + + Specified WM_INPUTLANGCHANGE enumeration value. + + + + + Specified WM_TCARD enumeration value. + + + + + Specified WM_HELP enumeration value. + + + + + Specified WM_USERCHANGED enumeration value. + + + + + Specified WM_NOTIFYFORMAT enumeration value. + + + + + Specified WM_CONTEXTMENU enumeration value. + + + + + Specified WM_STYLECHANGING enumeration value. + + + + + Specified WM_STYLECHANGED enumeration value. + + + + + Specified WM_DISPLAYCHANGE enumeration value. + + + + + Specified WM_GETICON enumeration value. + + + + + Specified WM_SETICON enumeration value. + + + + + Specified WM_NCCREATE enumeration value. + + + + + Specified VK_RMENU enumeration value. + + + + + Specified WM_NCCALCSIZE enumeration value. + + + + + Specified WM_NCHITTEST enumeration value. + + + + + Specified WM_NCPAINT enumeration value. + + + + + Specified WM_NCACTIVATE enumeration value. + + + + + Specified WM_GETDLGCODE enumeration value. + + + + + Specified WM_SYNCPAINT enumeration value. + + + + + Specified WM_NCMOUSEMOVE enumeration value. + + + + + Specified WM_NCLBUTTONDOWN enumeration value. + + + + + Specified WM_NCLBUTTONUP enumeration value. + + + + + Specified WM_NCLBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCRBUTTONDOWN enumeration value. + + + + + Specified WM_NCRBUTTONUP enumeration value. + + + + + Specified WM_NCRBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCMBUTTONDOWN enumeration value. + + + + + Specified WM_NCMBUTTONUP enumeration value. + + + + + Specified WM_NCMBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCXBUTTONDOWN enumeration value. + + + + + Specified WM_NCXBUTTONUP enumeration value. + + + + + Specified WM_KEYDOWN enumeration value. + + + + + Specified WM_KEYUP enumeration value. + + + + + Specified WM_CHAR enumeration value. + + + + + Specified WM_DEADCHAR enumeration value. + + + + + Specified WM_SYSKEYDOWN enumeration value. + + + + + Specified WM_SYSKEYUP enumeration value. + + + + + Specified WM_SYSCHAR enumeration value. + + + + + Specified WM_SYSDEADCHAR enumeration value. + + + + + Specified WM_KEYLAST enumeration value. + + + + + Specified WM_IME_STARTCOMPOSITION enumeration value. + + + + + Specified WM_IME_ENDCOMPOSITION enumeration value. + + + + + Specified WM_IME_COMPOSITION enumeration value. + + + + + Specified WM_IME_KEYLAST enumeration value. + + + + + Specified WM_INITDIALOG enumeration value. + + + + + Specified WM_COMMAND enumeration value. + + + + + Specified WM_SYSCOMMAND enumeration value. + + + + + Specified WM_TIMER enumeration value. + + + + + Specified WM_HSCROLL enumeration value. + + + + + Specified WM_VSCROLL enumeration value. + + + + + Specified WM_INITMENU enumeration value. + + + + + Specified WM_INITMENUPOPUP enumeration value. + + + + + Specified WM_MENUSELECT enumeration value. + + + + + Specified WM_MENUCHAR enumeration value. + + + + + Specified WM_ENTERIDLE enumeration value. + + + + + Specified WM_MENURBUTTONUP enumeration value. + + + + + Specified WM_MENUDRAG enumeration value. + + + + + Specified WM_MENUGETOBJECT enumeration value. + + + + + Specified WM_UNINITMENUPOPUP enumeration value. + + + + + Specified WM_MENUCOMMAND enumeration value. + + + + + Specified WM_CTLCOLORMSGBOX enumeration value. + + + + + Specified WM_CTLCOLOREDIT enumeration value. + + + + + Specified WM_CTLCOLORLISTBOX enumeration value. + + + + + Specified WM_CTLCOLORBTN enumeration value. + + + + + Specified WM_CTLCOLORDLG enumeration value. + + + + + Specified WM_CTLCOLORSCROLLBAR enumeration value. + + + + + Specified WM_CTLCOLORSTATIC enumeration value. + + + + + Specified WM_MOUSEMOVE enumeration value. + + + + + Specified WM_LBUTTONDOWN enumeration value. + + + + + Specified WM_LBUTTONUP enumeration value. + + + + + Specified WM_LBUTTONDBLCLK enumeration value. + + + + + Specified WM_RBUTTONDOWN enumeration value. + + + + + Specified WM_RBUTTONUP enumeration value. + + + + + Specified WM_RBUTTONDBLCLK enumeration value. + + + + + Specified WM_MBUTTONDOWN enumeration value. + + + + + Specified WM_MBUTTONUP enumeration value. + + + + + Specified WM_MBUTTONDBLCLK enumeration value. + + + + + Specified WM_MOUSEWHEEL enumeration value. + + + + + Specified WM_XBUTTONDOWN enumeration value. + + + + + Specified WM_XBUTTONUP enumeration value. + + + + + Specified WM_XBUTTONDBLCLK enumeration value. + + + + + Specified WM_PARENTNOTIFY enumeration value. + + + + + Specified WM_ENTERMENULOOP enumeration value. + + + + + Specified WM_EXITMENULOOP enumeration value. + + + + + Specified WM_NEXTMENU enumeration value. + + + + + Specified WM_SIZING enumeration value. + + + + + Specified WM_CAPTURECHANGED enumeration value. + + + + + Specified WM_MOVING enumeration value. + + + + + Specified WM_DEVICECHANGE enumeration value. + + + + + Specified WM_MDICREATE enumeration value. + + + + + Specified WM_MDIDESTROY enumeration value. + + + + + Specified WM_MDIACTIVATE enumeration value. + + + + + Specified WM_MDIRESTORE enumeration value. + + + + + Specified WM_MDINEXT enumeration value. + + + + + Specified WM_MDIMAXIMIZE enumeration value. + + + + + Specified WM_MDITILE enumeration value. + + + + + Specified WM_MDICASCADE enumeration value. + + + + + Specified WM_MDIICONARRANGE enumeration value. + + + + + Specified WM_MDIGETACTIVE enumeration value. + + + + + Specified WM_MDISETMENU enumeration value. + + + + + Specified WM_ENTERSIZEMOVE enumeration value. + + + + + Specified WM_EXITSIZEMOVE enumeration value. + + + + + Specified WM_DROPFILES enumeration value. + + + + + Specified WM_MDIREFRESHMENU enumeration value. + + + + + Specified WM_IME_SETCONTEXT enumeration value. + + + + + Specified WM_IME_NOTIFY enumeration value. + + + + + Specified WM_IME_CONTROL enumeration value. + + + + + Specified WM_IME_COMPOSITIONFULL enumeration value. + + + + + Specified WM_IME_SELECT enumeration value. + + + + + Specified WM_IME_CHAR enumeration value. + + + + + Specified WM_IME_REQUEST enumeration value. + + + + + Specified WM_IME_KEYDOWN enumeration value. + + + + + Specified WM_IME_KEYUP enumeration value. + + + + + Specified WM_MOUSEHOVER enumeration value. + + + + + Specified WM_UNDO enumeration value. + + + + + Specified WM_RENDERFORMAT enumeration value. + + + + + Specified WM_RENDERALLFORMATS enumeration value. + + + + + Specified WM_DESTROYCLIPBOARD enumeration value. + + + + + Specified WM_DRAWCLIPBOARD enumeration value. + + + + + Specified WM_PAINTCLIPBOARD enumeration value. + + + + + Specified WM_VSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_SIZECLIPBOARD enumeration value. + + + + + Specified WM_ASKCBFORMATNAME enumeration value. + + + + + Specified WM_CHANGECBCHAIN enumeration value. + + + + + Specified WM_HSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_QUERYNEWPALETTE enumeration value. + + + + + Specified WM_PALETTEISCHANGING enumeration value. + + + + + Specified WM_PALETTECHANGED enumeration value. + + + + + Specified WM_HOTKEY enumeration value. + + + + + Specified WM_PRINT enumeration value. + + + + + Specified WM_PRINTCLIENT enumeration value. + + + + + Specified WM_HANDHELDFIRST enumeration value. + + + + + Specified WM_HANDHELDLAST enumeration value. + + + + + Specified WM_AFXFIRST enumeration value. + + + + + Specified WM_AFXLAST enumeration value. + + + + + Specified WM_PENWINFIRST enumeration value. + + + + + Specified WM_PENWINLAST enumeration value. + + + + + Specified WM_APP enumeration value. + + + + + Specified WM_USER enumeration value. + + + + + Specified WM_REFLECT enumeration value. + + + + + Specified WM_THEMECHANGED enumeration value. + + + + + + + + + + 关键词 + + + + + 密码 + + + + + 权限用户id + + + + + + + + + + + + + 返回关键词 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 树形控件，用于分类用 + + + + + 显示在第一位的名称 + + + + + 是否显示菜单 + + + + + 树形控件 + + + + + 判断指定节点是否是目标节点的子节点 + + + + + + + + + 判断当前节点，当前用户是否有权限访问 + + + + + + + + + 权限事件 + + + + + + + + 选择权限用户时发生 + + + + + 数据变化时发生 + + + + + 数据变化前发生 + + + + + 操作事件 + + + + + + + 在添加分组前发生 + + + + + 在修改分组前发生 + + + + + 在删除分组前发生 + + + + + 在设置密码前发生 + + + + + 在设置权限前发生 + + + + + 获取新的关键词分类 + + + + + + 根据id获取节点 + + + + + + + 根据节点获取节点信息 + + + + + + + 设置节点信息 + + + + + + + 设置节点关键词和密码 + + + + + + + + 设置节点密码 + + + + + + + 设置节点关键词 + + + + + + + 设置节点用户 + + + + + + + RecursionTreeControl:表示将XML文件的内容显示在TreeView控件中 + + 将要加载的XML文件中的节点元素 + 将要加载的XML文件中的节点集合 + + + + 把XML文本载入到列表中 + + + + + + 把XML文件载入到列表中 + + + + + + 将列表保存为xml文本 + + + + + + 改变所有子节点的状态 + + + + + + + 反选子节点 + + + + + + 根据关键词来选中列表 + + + + + + 根据关键词来选中列表 + + + + + + 格式化关键字(会去除重复项)，以便存入数据库 + + + + + + + 去除掉重复项 + + + + + + + 获取当前选中项以及所有父项的关键词组合 + + + + + + 获取选中的 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 是否为添加 + + + + + 选择的文本 + + + + + 选择的Tag + + + + + 选择的图片序号 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + 旧密码 + + + + + 新密码 + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 控件状态 + + + + + 无 + + + + + 获得焦点 + + + + + 失去焦点 + + + + + 鼠标指针进入控件 + + + + + Toolbar控件 + + + + + + + + + + + + + + + 获取或设置控件显示的图片 + + + + + 重写控件焦点属性 + + + + + 自定义绘制 + + + + + + 焦点进入 + + + + + + 失去焦点 + + + + + + 禁止调整大小 + + + + + + + + + + + + + + + + + + 只响应单击鼠标左键事件 + + + + + + 按比例缩放图片 + + + + + + + 图片缩放 + + 源图片 + 缩放图片的宽度 + 缩放图片的高度 + 缩放的图片 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 绘图对像 + + 绘图对像 + 图片 + 绘置的图片大小、坐标 + 绘置的图片边界 + 当前状态 + 状态总数 + + + + 绘图对像 + + 绘图对像 + 图片对像 + 绘置的图片大小、坐标 + 当前状态 + 状态总数 + + + + + + + + + 得到要绘置的图片对像 + + 图像在程序集中的地址 + + + + + 得到要绘置的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 获取资源图标 + + + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的地址 + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 颜色标签 + + + + + 行间距 + + + + + 颜色标签 + + + + + 更新 + + + + + 字体高度 + + + + + 控件高 + + + + + 控件文本 + + + + + 获取过滤掉颜色的字 + + + + + + + 改变字体 + + + + + + + + + + + + + + 分页控件 + + + + + 首页文本 + + + + + 上一页文本 + + + + + 下一页文本 + + + + + 末页文本 + + + + + 跳页文本 + + + + + 页面信息文本 + + + + + 存储SQL参数 + + + + + 最后一页的页码 + + + + + 在发生页码变化时激发 + + + + + 在发生页码变化前激发 + + + + + 设置/返回每页显示的量大小 + + + + + 设置/返回记录总数 + + + + + 设置/返回分页SQL语句,{pagecount}表示页数,{recordcount}表示记录总数,{pagesize}表示页面大小, + {pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 设置/返回当{recordnum}小于等于0时的分页SQL语句(比如第一页),如果为空，则默认使用SQLText值。{pagecount}表示页数, + {recordcount}表示记录总数,{pagesize}表示页面大小,{pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 获取当前页码 + + + + + + 设置分页语句 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取数据库指定条件的记录总数 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MySQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MySQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MSSQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MSSQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 获取SQLite数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 返回分页SQL语句 + + + + + 分页控件 + + + + + 设置当前页为指定页 + + + + + + 下一页 + + + + + 上一页 + + + + + 末页 + + + + + 首页 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 密码控件 + + + + + + + + + + 密码 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + This enum represents the possible browser commands + + + + + Used when no commans are available + + + + + Used in the new navigation events + + + + + The URL to navigate to + + + + + The name of the frame to navigate to + + + + + The flags when opening a new window + + + + + The pointer to ppDisp + + + + + Creates a new instance of WebBrowserExtendedNavigatingEventArgs + + Pointer to the automation object of the browser + The URL to go to + The name of the frame + The new window flags + + + + + + + + + Used in the new navigation events + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 查看源码 + + + + + 复制当前选中区 + + + + + 粘贴当前选中区 + + + + + 剪切当前选中区 + + + + + 全选 + + + + + 清除当前选中区的选中状态。 + + + + + 从当前选中区中删除全部超级链接。 + + + + + 从当前选中区中删除全部书签。 + + + + + 删除当前选中区 + + + + + 重做 + + + + + 撤销 + + + + + 从当前选中区中删除格式化标签。 + + + + + 点击节点 + + + + + + + + 点击节点 + + + + + + + + + 点击元素 + + 节点名 + 属性 + 属性值 + 等待毫秒数 + 第几个符合的元素,从1开始 + + + + 等待多时毫秒 + + + + + + Represents event information for the main form, when the command state of the active browser changes + + + + + Creates a new instance of the class + + A list of commands that are available + + + + Gets a list of commands that are available + + + + + An extended version of the control. + + + + + + + + + + + + 在页面弹出消息对话框时激发 + + + + + + + + + + + + + + + + + + + + + + 打开页面并等待页面加载完毕 + + 要打开的页面地址 + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待页面加载完毕 + + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待指定毫秒 + + 等待指定毫秒 + + + + 获取网页源代码,可以自动去除乱码 + + + + + + 加载html文本到浏览器中 + + + + + + + 加载html文本到浏览器中 + + + + + + 强制用本窗体打开新链接 + + + + + + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is created. + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is discarded. + + + + + Returns the automation object for the web browser + + + + + This method will be called to give you a chance to create your own event sink + + + + + Detaches the event sink + + + + + 在文档下载开始时激发 + + + + + Raises the event + + Empty + + You could start an animation or a notification that downloading is starting + + + + + 下载完成后触发 + + + Here you could start monitoring for script errors. + + + + + Raises the event + + Empty + + + + 在开始浏览新网页时激发. + + + + + 在打开新的网页窗口时激发 + + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 新窗口事件,只限Window XP SP2或以上系统支持 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Overridden + + The send to this procedure + + + + A list of all the available window messages + + + + + Raises the event + + + + + 在网页窗口关闭时激发 + + + Do not confuse this with DWebBrowserEvents2.Quit... That's something else. + + + + + Flags used by INewWindowManager::EvaluateNewWindow. + These values are taken into account in the decision of whether to display a pop-up window. + + + + + No information Present + + + + + The page is unloading. This flag is set in response to the onbeforeunload and onunload events. + Some pages load pop-up windows when you leave them rather than when you enter. This flag is used to identify those situations. + + + + + The call to INewWindowManager::EvaluateNewWindow is the result of a user-initiated action + (a mouse click or key press). Use this flag in conjunction with the NWMF_FIRST_USERINITED flag + to determine whether the call is a direct or indirect result of the user-initiated action. + + + + + When NWMF_USERINITED is present, this flag indicates that the call to + INewWindowManager::EvaluateNewWindow is the first query that results from this user-initiated action. + Always use this flag in conjunction with NWMF_USERINITED. + + + + + The override key (ALT) was pressed. The override key is used to bypass the pop-up manager梐llowing + all pop-up windows to display梐nd must be held down at the time that INewWindowManager::EvaluateNewWindow is called. + + + + + The new window attempting to load is the result of a call to the showHelp method. Help is sometimes displayed in a separate window, + and this flag is valuable in those cases. + + + + + The new window is a dialog box that displays HTML content. + + + + + Indicates that the EvaluateNewWindow method is being called through a marshalled Component Object Model (COM) proxy + from another thread. In this situation, the method should make a decision and return immediately without performing + blocking operations such as showing modal user interface (UI). Lengthy operations will cause the calling thread to + appear unresponsive. + + + + + HRESULT constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + a form that supports custom theme + + + + + 标签新建按钮事件 + + + + + 标签关闭按钮事件 + + + + + 标签创建时事件 + + + + + 标签激活前事件 + + + + + 标签激活后事件 + + + + + 在标签栏创建时激发 + + + + + + + 内边距 + + + + + 默认内边距 + + + + + 标题 + + + + + 皮肤/主题 + + + + + 是否可拖动改变窗体大小 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 标题栏高度 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 控制按钮相对于右上角的偏移量 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 标题栏图标尺寸 + + + + + 窗体图标,如果设置本项,将不使用Icon属性 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题距离左边的距离 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 是否显示阴影 + + + + + 窗体阴影宽度 + + + + + 使用阴影来缩放 + + + + + 窗体阴影颜色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区区域，坐标相对于窗体左上角 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区大小 + + + + + 表示MDI标签栏的区域，包括bottom-region + + + + + MGdUI皮肤 + + + + + + + + + + + + + + + + + 获取子窗体 + + + + + + 通过sendmessage方式激活子窗体以避免闪烁 + + + + + + 当子窗体关闭时激发 + + + + + + + 子窗体可视化变化 + + + + + + + 获取当前的子窗体列表 + + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最小化 + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最大化 + + + + + to make the client area to have 3D view + + + + + 双击事件 + + + + + 消息 + + + + + + 画UI + + + + + + 在画背景时激发 + + + + + + 重写该方法解决在VS设计器中，每次保存一个新的尺寸，再打开尺寸会变大的问题 + + + + + 创建控件时激发 + + + + + 窗体可见变化时激发 + + + + + + 大小改变时激发 + + + + + + 在位置变化时激发 + + + + + + 窗体激活 + + + + + + 窗体关闭后激发 + + + + + + 加载时 + + + + + + 在子窗体激活时激发 + + + + + + 标签菜单 + + + + + 窗体上移动鼠标时激发 + + + + + + 获取当前点击的标签项 + + + + + 在窗体上按下鼠标时激发 + + + + + + 在窗体上放开鼠标时激发 + + + + + + 在鼠标离开窗体时激发 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 该类处理mdi-bar的绘制及鼠标事件管理 + + + + + use left,top,right to location the bar in owner form, + the margin is from Form.ClientRectangle + + + + + 整个标签栏高度,包含标签栏底部区域、标签、标签顶部空隙 + + + + + 标签栏底部区域的高度 + + + + + 是否显示标签栏边框 + + + + + 是否显示标签栏背景 + + + + + 标签栏左内边距 + + + + + 标签栏右内边距 + + + + + 标签高度 + + + + + 激活的标签高度 + + + + + tab顶部与bar顶部的空间,这个值用来计算 BarHeight + + + + + 每个标签的左右边界可以不是垂直的，而是都有一个斜度 + + + + + tab与tab之间的距离，用负值可以使tab有重叠的效果 + + + + + 标签是否显示图标 + + + + + 是否显示标签关闭按钮 + + + + + 标签图标大小 + + + + + 标签图标距离左边的距离 + + + + + 标签文字距离左边的距离 + + + + + 标签关闭按钮的大小 + + + + + 标签关闭按钮距离右边的距离 + + + + + 是否显示新建标签按钮 + + + + + 新建标签按钮的大小 + + + + + 新建标签距离左边的距离 + + + + + 按钮与Bar底部的距离 + + + + + 一个tab允许的最小宽度 + + + + + 一个tab允许的最大显示宽度 + + + + + 标签正常宽度 + + + + + 同步_listTabItems与mdi主窗体实际存在的子form + + + + + 为每个tab分配空间，如果tab数目太多，则有些会被隐藏 + + + + + 重绘整个标签栏 + + + + + + 处理鼠标事件。该方法会触发一些click事件，重刷一些按钮等 + + + + + + + 该类表示一个单独的标签项 + + + + + 该标签所对应的窗体 + + + + + 最终分配到的整个tab的宽度 + + + + + 表示所对应的form是否仍未被关闭 + + + + + 是否因空间不足而被隐藏 + + + + + 返回全部显示该标签文本所需的长度 + + + + + + 返回显示全部文本时该tab所需的宽度,该宽度不超过bar-container + 规定的tabmaxwidth + + + + + + 居左 + + + + + 显示在最后一个标签后面 + + + + + 该类封装设置一个主题所需的信息，可以继承该类实现不同的主题 + + + + + 主题名称，用于标识主题，对主题进行简单描述 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 窗体标题栏高度 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题栏图标尺寸 + + + + + 标题栏文本左边距 + + + + + 控制按钮（关闭按钮）相对于窗体右上角的偏移量 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 是否使用默认的圆角样式，该样式为左上角和右上角圆角， + 最好在窗体边框较粗时才使用该样式 + + + + + 是否在标题栏上绘制图标 + + + + + 是否在标题栏上绘制文本 + + + + + 是否显示窗体阴影 + + + + + 窗体阴影大小 + + + + + 拖动窗体阴影是否可以改变窗体大小 + + + + + 阴影的颜色，可以设置成其他颜色而不一定是黑色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 是否在客户区边界画线使其看起来有立体感 + + + + + 窗体标题栏文字是否居中显示 + + + + + 窗体边框最外一像素的颜色 + + + + + 窗体边框第二最外像素的颜色 + + + + + 窗体边框其他部分颜色，如果窗体边框大小大于2，则其他像素将用此颜色画出 + + + + + 标题栏颜色是从上到下渐变的，这个值设置上边的颜色值 + + + + + 标题栏颜色是从上到下渐变的，这个值设置下边的颜色值 + + + + + 标题栏文字颜色 + + + + + 窗体背景颜色，该值将覆盖窗体自带的BackColor属性值 + + + + + 窗体关闭按钮的颜色集合 + + + + + 窗体最大化/还原按钮的颜色集合 + + + + + 窗体最小化按钮的颜色集合 + + + + + 默认状态下关闭按钮背景图片 + + + + + 鼠标移过去时关闭按钮背景图片 + + + + + 鼠标按下时关闭按钮背景图片 + + + + + 默认状态下最大化按钮背景图片 + + + + + 鼠标移过去时最大化按钮背景图片 + + + + + 鼠标按下时最大化按钮背景图片 + + + + + 默认状态下恢复按钮背景图片 + + + + + 鼠标移过去时恢复按钮背景图片 + + + + + 鼠标按下时恢复按钮背景图片 + + + + + 默认状态下最小化按钮背景图片 + + + + + 鼠标移过去时最小化按钮背景图片 + + + + + 鼠标按下时最小化按钮背景图片 + + + + + 是否用SendMessage的方式切换子窗体，以避免子窗体切换时产生的闪烁 + + + + + Mdi-Bar与窗体左、上、右边界的距离，只用到这三个值，Bottom值没用到。 + 用这三个值来确定Mdi-Bar的宽度及其在窗体中的位置 + + + + + 内部左边空白，第一个标签将从这个空白距离之后开始 + + + + + 标签栏内部右边空白 + + + + + 标签栏背景颜色 + + + + + 标签栏边框颜色 + + + + + 标签栏背景图片 + + + + + 是否显示标签栏边框 + + + + + 标签栏下边区域的背景颜色 + + + + + 标签栏下边区域的高度 + + + + + 标签高度 + + + + + 被选中的标签高度，可以设置成与TabHeight不一样的值，以突出显示被选中状态 + + + + + 标签之间的距离，设成负值可以使标签有重叠的效果 + + + + + 标签的最大宽度，任何情况下标签都不能超过这个宽度 + + + + + 标签正常宽度，如果标签需要很短的宽度（比如20像素）就可以显示完上面的文字， + 但是Mdi-Bar上有足够的空间时，标签会以正常宽度（比如100像素）显示 + + + + + 标签最小宽度，当标签小于这个宽度时将被隐藏 + + + + + 标签梯度大小，标签可以不以矩形方式显示，而是有一个梯度/斜度。 + + + + + 标签顶部空白，这个值用于参与计算Mdi-Bar高度，计算方式为： + Mdi-Bar Height = BottomRegionHeight + TabHeight + TabTopSpace + + + + + 标签上是否显示子窗体图标 + + + + + 标签上是否显示子窗体关闭图标 + + + + + 选中状态的标签的上部背景色，与下部背景色不同时，标签背景色就有渐变效果 + + + + + 选中状态的标签的下部背景色，与上部背景色不同时，标签背景色就有渐变效果 + + + + + 标签激活时字体颜色 + + + + + 非选中状态的标签的字体颜色 + + + + + 非选中状态的标签的上部背景色 + + + + + 非选中状态的标签的下部背景色 + + + + + 标签外边框颜色 + + + + + 标签内边框颜色，这个颜色一般具有一定的透明度 + + + + + 是否显示标签边框 + + + + + 是否显示默认的新建标签按钮(NewTabBtn) + + + + + NewTabBtn与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 新建标签按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 新建标签按钮大小 + + + + + 按钮颜色集合 + + + + + 是否一直显示ListAllBtn，即使在没有标签被隐藏的情况下 + + + + + 《显示全部标签》按钮的位置 + + + + + 《显示全部标签》按钮与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 《显示全部标签》按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 《显示全部标签》按钮的颜色 + + + + + 《显示全部标签》按钮的大小 + + + + + 皮肤主题 + + + + + 设置百分比 + + + + + + + + + 引发 ValueChanged 事件 + + + + + + 引发 ThemeChanged 事件 + + + + + + 指示鼠标位于哪个区域 + + + + + 控件Value值发生变化后引发 + + + + + 控件绘制MainLine前引发, 可以设置Cancel参数来取消默认的绘制 + + + + + 控件绘制Button前引发 + + + + + 引发 ValueChanged 事件 + + + + + 引发 BeforePaintMainLine 事件 + + + + + 引发 BeforePaintButton 事件 + + + + + 将Value值加一个LargeChange量 + + + + + 将Value值减一个LargeChange量 + + + + + 将Value值加一个SmallChange量 + + + + + 将Value值减一个SmallChange量 + + + + + 提供产生各种路径的静态方法，比如圆角路径、关闭按钮上的x路径、+号路径 + + + + + 圆角样式 + + + + + 无 + + + + + 所有 + + + + + 上 + + + + + 下 + + + + + 左 + + + + + 右 + + + + + SimpleObject指的是只有一种状态（不像普通按钮一样有三种状态），并且其上的元素 + 布局比较简单的Object + + + + + + + + + + + + + + + + + + + + DevExpress风格皮肤 + + + + + DevExpress风格皮肤 + + + + + 新风格皮肤 + + + + + 新风格皮肤 + + + + + 基础皮肤 + + + + + VS2013风格皮肤 + + + + + this theme is just for chrome one quarter style + + + + + for diamond ring style only + + + + + Location of cursor hot spot returnet in WM_NCHITTEST. + + + + + On the screen background or on a dividing line between windows + (same as HTNOWHERE, except that the DefWindowProc function produces a system beep to indicate an error). + + + + + In a window currently covered by another window in the same thread + (the message will be sent to underlying windows in the same thread until one of them returns a code that is not HTTRANSPARENT). + + + + + On the screen background or on a dividing line between windows. + + + + In a client area. + + + In a title bar. + + + In a window menu or in a Close button in a child window. + + + In a size box (same as HTSIZE). + + + In a menu. + + + In a horizontal scroll bar. + + + In the vertical scroll bar. + + + In a Minimize button. + + + In a Maximize button. + + + In the left border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the right border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the upper-horizontal border of a window. + + + In the upper-left corner of a window border. + + + In the upper-right corner of a window border. + + + In the lower-horizontal border of a resizable window + (the user can click the mouse to resize the window vertically). + + + In the lower-left corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the lower-right corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the border of a window that does not have a sizing border. + + + In a Close button. + + + In a Help button. + + + + Contains the new coordinates of a window that has been moved or resized, that is, it is the proposed new window coordinates. + + + + + Contains the coordinates of the window before it was moved or resized. + + + + + Contains the coordinates of the window's client area before the window was moved or resized. + + + + + Pointer to a WINDOWPOS structure that contains the size and position values specified in the operation that moved or resized the window. + + + + + + + + + + 是否在这个按钮上按下了鼠标未释放 + + + + + 是否可见 + + + + + + + + + + 画两次可以加深颜色 + + + + + 用于在click事件中传回数据 + + + + + 获取或设置是否将绘制完全限制在指定的区域内 + + + + + + + + + + + + + + + + + Adapter for WinForms brushes objects for core. + + + + + The actual WinForms brush instance. + + + + + If to dispose the brush when is called.
+ Ignore dispose for cached brushes. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms context menu for core. + + + + + the underline win forms context menu + + + + + Init. + + + + + Adapter for WinForms Control for core. + + + + + the underline win forms control. + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Get the underline win forms control + + + + + Adapter for WinForms Font object for core. + + + + + the underline win-forms font. + + + + + a handle to this Font. + + + + + the vertical offset of the font underline location from the top of the font. + + + + + Cached font height. + + + + + Cached font whitespace width. + + + + + Init. + + + + + the underline win-forms font. + + + + + Get the handle to this Font. + + + + + Set font metrics to be cached for the font for future use. + + the full height of the font + the vertical offset of the font underline location from the top of the font. + + + + Adapter for WinForms Font family object for core. + + + + + the underline win-forms font. + + + + + Init. + + + + + the underline win-forms font family. + + + + + Adapter for WinForms Graphics for core. + + + + + used for calculation. + + + + + used for calculation. + + + + + Used for GDI+ measure string. + + + + + The string format to use for measuring strings for GDI+ text rendering + + + + + The string format to use for rendering strings for GDI+ text rendering + + + + + The wrapped WinForms graphics object + + + + + Use GDI+ text rendering to measure/draw text. + + + + + the initialized HDC used + + + + + if to release the graphics object on dispose + + + + + If text alignment was set to RTL + + + + + Init static resources. + + + + + Init. + + the win forms graphics object to use + Use GDI+ text rendering to measure/draw text + optional: if to release the graphics object on dispose (default - false) + + + + Release current HDC to be able to use methods. + + + + + Init HDC for the current graphics object to be used to call GDI directly. + + + + + Set a resource (e.g. a font) for the specified device context. + WARNING: Calling Font.ToHfont() many times without releasing the font handle crashes the app. + + + + + Set the text color of the device context. + + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Special draw logic to draw transparent text using GDI.
+ 1. Create in-memory DC
+ 2. Copy background to in-memory DC
+ 3. Draw the text to in-memory DC
+ 4. Copy the in-memory DC to the proper location with alpha blend
+ + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Adapter for WinForms graphics path object for core. + + + + + The actual WinForms graphics path instance. + + + + + the last point added to the path to begin next segment from + + + + + The actual WinForms graphics path instance. + + + + + Get arc start angle for the given corner. + + + + + Adapter for WinForms Image object for core. + + + + + the underline win-forms image. + + + + + Initializes a new instance of the class. + + + + + the underline win-forms image. + + + + + Adapter for WinForms pens objects for core. + + + + + The actual WinForms brush instance. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms platforms. + + + + + Singleton instance of global adapter. + + + + + Init installed font families and set default font families mapping. + + + + + Singleton instance of global adapter. + + + + + Low level handling of Html Renderer logic, this class is used by , + , and .
+ + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + returns page list + + + + + returns page list count + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrappable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given printer device. + + the printer device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + mouse event args + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the mouse event args + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + + + + + + Create HtmlRenderer mouse event from win forms mouse event. + + + + + Create HtmlRenderer key event from win forms key event. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ Using and client can control how the html content effects the + size of the label. Either case scrollbars are never shown and html content outside of client bounds will be clipped. + and with AutoSize can limit the max/min size of the control
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoSize:

+ AutoSize = AutoSizeHeightOnly = false
+ The label size will not change by the html content. MaximumSize and MinimumSize are ignored.
+
+ AutoSize = true
+ The width and height is adjustable by the html content, the width will be longest line in the html, MaximumSize.Width will restrict it but it can be lower than that.
+
+ AutoSizeHeightOnly = true
+ The width of the label is set and will not change by the content, the height is adjustable by the html content with restrictions to the MaximumSize.Height and MinimumSize.Height values.
+ + +

LinkClicked event

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + the current html text set in the control + + + + + is to handle auto size of the control height only + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + Creates a new HTML Label + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Automatically sets the size of the label by content size + + + + + Automatically sets the height of the label by content height (width is not effected). + + + + + Gets or sets the max size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the min size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the html of this control. + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform paint of the html in the control. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ If is true and the layout of the html resulted in its content beyond the client bounds + of the panel it will show scrollbars (horizontal/vertical) allowing to scroll the content.
+ If is false html content outside the client bounds will be clipped.
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoScroll:

+ Allows showing scrollbars if html content is placed outside the visible boundaries of the panel. + + +

LinkClicked event:

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the control + + + + + the current html text set in the control + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + The last position of the scrollbars to know if it has changed to update mouse + + + + + Creates a new HtmlPanel and sets a basic css for it's styling. + + + + + + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. + + + + + Gets or sets the text of this panel + + + + + + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Adjust the scrollbar of the panel on html element by the given id.
+ The top of the html element rectangle will be at the top of the panel, if there + is not enough height to scroll to the top the scroll will be at maximum.
+ + the id of the element to scroll to + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform html container layout by the current panel client size. + + + + + Perform paint of the html in the control. + + + + + Set focus on the control for keyboard scrollbars handling. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Handle key down event for selection, copy and scrollbars handling. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + On html renderer scroll request adjust the scrolling of the panel to the requested location. + + + + + Adjust the scrolling of the panel to the requested location. + + the location to adjust the scroll to + + + + call mouse move to handle paint after scroll or html change affecting mouse cursor. + + + + + Used to add arrow keys to the handled keys in . + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Standalone static class for simple and direct HTML rendering.
+ For WinForms UI prefer using HTML controls: or .
+ For low-level control and performance consider using .
+ + + + GDI vs. GDI+ text rendering
+ Windows supports two text rendering technologies: GDI and GDI+.
+ GDI is older, has better performance and looks better on standard monitors but doesn't support alpha channel for transparency.
+ GDI+ is newer, device independent so work better for printers but is slower and looks worse on monitors.
+ HtmlRender supports both GDI and GDI+ text rendering to accommodate different needs, GDI+ text rendering methods have "GdiPlus" suffix + in their name where GDI do not.
+ + + Rendering to image
+ See https://htmlrenderer.codeplex.com/wikipage?title=Image%20generation
+ Because of GDI text rendering issue with alpha channel clear type text rendering rendering to image requires special handling.
+ Solid color background - generate an image where the background is filled with solid color and all the html is rendered on top + of the background color, GDI text rendering will be used. (RenderToImage method where the first argument is html string)
+ Image background - render html on top of existing image with whatever currently exist but it cannot have transparent pixels, + GDI text rendering will be used. (RenderToImage method where the first argument is Image object)
+ Transparent background - render html to empty image using GDI+ text rendering, the generated image can be transparent. + Text rendering can be controlled using , note that + doesn't render well on transparent background. (RenderToImageGdiPlus method)
+ + + Overwrite stylesheet resolution
+ Exposed by optional "stylesheetLoad" delegate argument.
+ Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + Overwrite image resolution
+ Exposed by optional "imageLoad" delegate argument.
+ Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ Note: Cannot use asynchronous scheme overwrite scheme.
+ + + + + Simple rendering
+ HtmlRender.Render(g, "Hello World]]>");
+ HtmlRender.Render(g, "Hello World]]>", 10, 10, 500, CssData.Parse("body {font-size: 20px}")");
+ + + Image rendering
+ HtmlRender.RenderToImage("Hello World]]>", new Size(600,400));
+ HtmlRender.RenderToImage("Hello World]]>", 600);
+ HtmlRender.RenderToImage(existingImage, "Hello World]]>");
+ + + + + + Adds a font family to be used in html rendering.
+ The added font will be used by all rendering function including and all WinForms controls. + + + The given font family instance must be remain alive while the renderer is in use.
+ If loaded to then the collection must be alive.
+ If loaded from file then the file must not be deleted. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + + This fonts mapping can be used as a fallback in case the requested font is not installed in the client system. + + the font family to replace + the font family to replace with + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI text rendering, note has no effect. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI+ text rending, use to control text rendering. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Renders the specified HTML source on the specified location and max width restriction.
+ Use GDI text rendering, note has no effect.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI text rendering, note has no effect.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ The HTML will be layout by the given image size but may be clipped if cannot fit.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + optional: the top-left most location to start render the html at (default - 0,0) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Measure the size (width and height) required to draw the given html under given width and height restrictions.
+ + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size of the html by performing layout under the given restrictions. + + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Clip the graphics so the html will not be rendered outside the max height bound given.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Copy all the bitmap bits from memory bitmap buffer to the given image. + + the source memory bitmap buffer to copy from + the destination bitmap image to copy to + + + + Provides HTML rendering on the tooltips. + + + + + the container to render and handle the html shown in the tooltip + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + The text rendering hint to be used for text rendering. + + + + + The CSS class used for tooltip html root div + + + + + the control that the tooltip is currently showing on.
+ Used for link handling. + + + + + timer used to handle mouse move events when mouse is over the tooltip.
+ Used for link handling. + + + + + the handle of the actual tooltip window used to know when the tooltip is hidden
+ Used for link handling. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + The CSS class used for tooltip html root div (default: htmltooltip)
+ Setting to 'null' clear base style on the tooltip.
+ Set custom class found in to change the base style of the tooltip. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Gets or sets the max size the tooltip. + + An ordered pair of type representing the width and height of a rectangle. + + + + On tooltip appear set the html by the associated control, layout and set the tooltip size by the html size. + + + + + Draw the html using the tooltip graphics. + + + + + Adjust the location of the tooltip window to the location of the mouse and handle + if the tooltip window will try to appear outside the boundaries of the control. + + the control the tooltip is appearing on + the size of the tooltip window + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Raised on link handling timer tick, used for: + 1. Know when the tooltip is hidden by checking the visibility of the tooltip window. + 2. Call HandleMouseMove so the mouse cursor will react if over a link element. + 3. Call HandleMouseDown and HandleMouseUp to simulate click on a link if one was clicked. + + + + + Unsubscribe from events and dispose of . + + + + + Helper to encode and set HTML fragment to clipboard.
+ See http://theartofdev.wordpress.com/2012/11/11/setting-html-and-plain-text-formatting-to-clipboard/.
+ . + + + The MIT License (MIT) Copyright (c) 2014 Arthur Teplitzki. + + + + + The string contains index references to other spots in the string, so we need placeholders so we can compute the offsets.
+ The _ strings are just placeholders. We'll back-patch them actual values afterwards.
+ The string layout () also ensures that it can't appear in the body of the html because the
+ character must be escaped.
+ + + + + html comment to point the beginning of html fragment + + + + + html comment to point the end of html fragment + + + + + Used to calculate characters byte count in UTF-8 + + + + + Create with given html and plain-text ready to be used for clipboard or drag and drop.
+ Handle missing ]]> tags, specified start\end segments and Unicode characters. + + + + Windows Clipboard works with UTF-8 Unicode encoding while .NET strings use with UTF-16 so for clipboard to correctly + decode Unicode string added to it from .NET we needs to be re-encoded it using UTF-8 encoding. + + + Builds the CF_HTML header correctly for all possible HTMLs
+ If given html contains start/end fragments then it will use them in the header: + hello world]]> + If given html contains html/body tags then it will inject start/end fragments to exclude html/body tags: + hello world]]> + If given html doesn't contain html/body tags then it will inject the tags and start/end fragments properly: + world]]> + In all cases creating a proper CF_HTML header:
+ + + hello world + ]]> + + See format specification here: http://msdn.microsoft.com/library/default.asp?url=/workshop/networking/clipboard/htmlclipboard.asp + + + a html fragment + the plain text + + + + Clears clipboard and sets the given HTML and plain text fragment to the clipboard, providing additional meta-information for HTML.
+ See for HTML fragment details.
+ + + ClipboardHelper.CopyToClipboard("Hello World", "Hello World"); + + a html fragment + the plain text + + + + Clears clipboard and sets the given plain text fragment to the clipboard.
+ + the plain text + + + + Generate HTML fragment data string with header that is required for the clipboard. + + the html to generate for + the resulted string + + + + Calculates the number of bytes produced by encoding the string in the string builder in UTF-8 and not .NET default string encoding. + + the string builder to count its string + optional: the start index to calculate from (default - start of string) + optional: the end index to calculate to (default - end of string) + the number of bytes required to encode the string in UTF-8 + + + + Utilities for converting WinForms entities to HtmlRenderer core entities. + + + + + Convert from WinForms point to core point. + + + + + Convert from WinForms point to core point. + + + + + Convert from core point to WinForms point. + + + + + Convert from core point to WinForms point. + + + + + Convert from WinForms size to core size. + + + + + Convert from core size to WinForms size. + + + + + Convert from core size to WinForms size. + + + + + Convert from WinForms rectangle to core rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from WinForms color to core color. + + + + + Convert from core color to WinForms color. + + + + + Utility for Win32 API. + + + + + Const for BitBlt copy raster-operation code. + + + + + Const for BitBlt paint raster-operation code. + + + + + Create a compatible memory HDC from the given HDC.
+ The memory HDC can be rendered into without effecting the original HDC.
+ The returned memory HDC and must be released using . + + the HDC to create memory HDC from + the width of the memory HDC to create + the height of the memory HDC to create + returns used bitmap memory section that must be released when done with memory HDC + memory HDC + + + + Release the given memory HDC and dib section created from . + + Memory HDC to release + bitmap section to release + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + A pointer to a RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + If the function succeeds, the return value is nonzero. + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ARGB (alpha, red, green, blue) color. + + + + + Represents a color that is null. + + 1 + + + + Gets a system-defined color. + + + + + Gets a system-defined color that has an ARGB value of #FF000000. + + + + + Gets a system-defined color that has an ARGB value of #FFFFFFFF. + + + + + Gets a system-defined color that has an ARGB value of #FFF5F5F5. + + + + + Gets a system-defined color that has an ARGB value of #FFD3D3D3. + + + + + Gets the red component value of this structure. + + + + + Gets the green component value of this structure. + + + + + Gets the blue component value of this structure. + + + + + Gets the alpha component value of this structure. + + + + + Specifies whether this structure is uninitialized. + + + This property returns true if this color is uninitialized; otherwise, false. + + 1 + + + + Tests whether two specified structures are equivalent. + + + true if the two structures are equal; otherwise, false. + + + The that is to the left of the equality operator. + + + The that is to the right of the equality operator. + + 3 + + + + Tests whether two specified structures are different. + + + true if the two structures are different; otherwise, false. + + + The that is to the left of the inequality operator. + + + The that is to the right of the inequality operator. + + 3 + + + + Creates a structure from the four ARGB component (alpha, red, green, and blue) values. Although this method allows a 32-bit value to be passed for each component, the value of each component is limited to 8 bits. + + + The that this method creates. + + The alpha component. Valid values are 0 through 255. + The red component. Valid values are 0 through 255. + The green component. Valid values are 0 through 255. + The blue component. Valid values are 0 through 255. + + , , , or is less than 0 or greater than 255. + + 1 + + + + Creates a structure from the specified 8-bit color values (red, green, and blue). The alpha value is implicitly 255 (fully opaque). Although this method allows a 32-bit value to be passed for each color component, the value of each component is limited to 8 bits. + + + The that this method creates. + + + The red component value for the new . Valid values are 0 through 255. + + + The green component value for the new . Valid values are 0 through 255. + + + The blue component value for the new . Valid values are 0 through 255. + + + , , or is less than 0 or greater than 255. + + 1 + + + + Tests whether the specified object is a structure and is equivalent to this + + structure. + + + true if is a structure equivalent to this + + structure; otherwise, false. + + The object to test. + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies the hash code for this . + + 1 + + + + Converts this structure to a human-readable string. + + + + + Specifies the style of dashed lines drawn with a object. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 自定义 + + + + + Specifies style information applied to text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + Init. + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + Is the left mouse button participated in the event + + + + + Init. + + + + + Is the left mouse button participated in the event + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ordered pair of floating-point x- and y-coordinates that defines a point in a two-dimensional plane. + + + + + Represents a new instance of the class with member data left uninitialized. + + 1 + + + + Initializes a new instance of the class with the specified coordinates. + + The horizontal position of the point. + The vertical position of the point. + + + + + + Gets a value indicating whether this is empty. + + + true if both and + + are 0; otherwise, false. + + 1 + + + + Gets or sets the x-coordinate of this . + + + The x-coordinate of this . + + 1 + + + + Gets or sets the y-coordinate of this . + + + The y-coordinate of this . + + 1 + + + + Translates the by the specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the x- and y-coordinates of the + + . + + + + + Translates a by the negative of a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Compares two structures. The result specifies whether the values of the + + and properties of the two + + structures are equal. + + + true if the and + + values of the left and right + + structures are equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Determines whether the coordinates of the specified points are not equal. + + + true to indicate the and + + values of and + + are not equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Translates a given by a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the coordinates of + + . + + + + + Translates a by the negative of a specified size. + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Specifies whether this contains the same coordinates as the specified + + . + + + This method returns true if is a and has the same coordinates as this + + . + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts this to a human readable string. + + + A string that represents this . + + 1 + + + + Stores a set of four floating-point numbers that represent the location and size of a rectangle. + + + + + Represents an instance of the class with its members uninitialized. + + + + + Initializes a new instance of the class with the specified location and size. + + The x-coordinate of the upper-left corner of the rectangle. + The y-coordinate of the upper-left corner of the rectangle. + The width of the rectangle. + The height of the rectangle. + + + + Initializes a new instance of the class with the specified location and size. + + A that represents the upper-left corner of the rectangular region. + A that represents the width and height of the rectangular region. + + + + Gets or sets the coordinates of the upper-left corner of this structure. + + A that represents the upper-left corner of this structure. + + + + Gets or sets the size of this . + + A that represents the width and height of this structure. + + + + Gets or sets the x-coordinate of the upper-left corner of this structure. + + + The x-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the y-coordinate of the upper-left corner of this structure. + + + The y-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the width of this structure. + + + The width of this structure. + + + + + Gets or sets the height of this structure. + + + The height of this structure. + + + + + Gets the x-coordinate of the left edge of this structure. + + + The x-coordinate of the left edge of this structure. + + + + + Gets the y-coordinate of the top edge of this structure. + + + The y-coordinate of the top edge of this structure. + + + + + Gets the x-coordinate that is the sum of and + + of this structure. + + + The x-coordinate that is the sum of and + + of this structure. + + + + + Gets the y-coordinate that is the sum of and + + of this structure. + + + The y-coordinate that is the sum of and + + of this structure. + + + + + Tests whether the or + + property of this has a value of zero. + + + This property returns true if the or + + property of this has a value of zero; otherwise, false. + + + + + Tests whether two structures have equal location and size. + + + This operator returns true if the two specified structures have equal + , , , and properties. + + + The structure that is to the left of the equality operator. + + + The structure that is to the right of the equality operator. + + + + + Tests whether two structures differ in location or size. + + + This operator returns true if any of the , + , , or + properties of the two structures are unequal; otherwise false. + + + The structure that is to the left of the inequality operator. + + + The structure that is to the right of the inequality operator. + + + + + Creates a structure with upper-left corner and lower-right corner at the specified locations. + + + The new that this method creates. + + The x-coordinate of the upper-left corner of the rectangular region. + The y-coordinate of the upper-left corner of the rectangular region. + The x-coordinate of the lower-right corner of the rectangular region. + The y-coordinate of the lower-right corner of the rectangular region. + + + + Tests whether is a with the same location and size of this + . + + + This method returns true if is a and its X, Y, Width, and Height properties are equal to the corresponding properties of this + ; otherwise, false. + + + The to test. + + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point defined by and is contained within this + + structure; otherwise false. + + The x-coordinate of the point to test. + The y-coordinate of the point to test. + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point represented by the parameter is contained within this + + structure; otherwise false. + + The to test. + + + + Determines if the rectangular region represented by is entirely contained within this + + structure. + + + This method returns true if the rectangular region represented by is entirely contained within the rectangular region represented by this + + ; otherwise false. + + + The to test. + + + + + Inflates this structure by the specified amount. + + + The amount to inflate this structure horizontally. + + + The amount to inflate this structure vertically. + + + + + Inflates this by the specified amount. + + The amount to inflate this rectangle. + + + + Creates and returns an inflated copy of the specified structure. The copy is inflated by the specified amount. The original rectangle remains unmodified. + + + The inflated . + + + The to be copied. This rectangle is not modified. + + The amount to inflate the copy of the rectangle horizontally. + The amount to inflate the copy of the rectangle vertically. + + + + Replaces this structure with the intersection of itself and the specified + + structure. + + The rectangle to intersect. + + + + Returns a structure that represents the intersection of two rectangles. If there is no intersection, and empty + + is returned. + + + A third structure the size of which represents the overlapped area of the two specified rectangles. + + A rectangle to intersect. + A rectangle to intersect. + + + + Determines if this rectangle intersects with . + + + This method returns true if there is any intersection. + + The rectangle to test. + + + + Creates the smallest possible third rectangle that can contain both of two rectangles that form a union. + + + A third structure that contains both of the two rectangles that form the union. + + A rectangle to union. + A rectangle to union. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location horizontally. + The amount to offset the location vertically. + + + + Gets the hash code for this structure. For information about the use of hash codes, see Object.GetHashCode. + + The hash code for this + + + + Converts the Location and Size of this to a human-readable string. + + + A string that contains the position, width, and height of this structure for example, "{X=20, Y=20, Width=100, Height=50}". + + + + + Stores an ordered pair of floating-point numbers, typically the width and height of a rectangle. + + + + + Gets a structure that has a + + and + + value of 0. + + + A structure that has a + + and + + value of 0. + + 1 + + + + Initializes a new instance of the structure from the specified existing + + structure. + + + The structure from which to create the new + + structure. + + + + + Initializes a new instance of the structure from the specified structure. + + The structure from which to initialize this structure. + + + + Initializes a new instance of the structure from the specified dimensions. + + + The width component of the new structure. + + + The height component of the new structure. + + + + + Gets a value that indicates whether this structure has zero width and height. + + + This property returns true when this structure has both a width and height of zero; otherwise, false. + + 1 + + + + Gets or sets the horizontal component of this structure. + + + The horizontal component of this structure, typically measured in pixels. + + 1 + + + + Gets or sets the vertical component of this structure. + + + The vertical component of this structure, typically measured in pixels. + + 1 + + + + Converts the specified structure to a + structure. + + The structure to which this operator converts. + The structure to be converted + + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + 3 + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A that is the result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + 3 + + + + Tests whether two structures are equal. + + + This operator returns true if and have equal width and height; otherwise, false. + + + The structure on the left side of the equality operator. + + + The structure on the right of the equality operator. + + 3 + + + + Tests whether two structures are different. + + + This operator returns true if and differ either in width or height; false if + + and are equal. + + + The structure on the left of the inequality operator. + + + The structure on the right of the inequality operator. + + 3 + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A structure that is a result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + + + + Tests to see whether the specified object is a structure with the same dimensions as this + + structure. + + + This method returns true if is a and has the same width and height as this + + ; otherwise, false. + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts a structure to a structure. + + + Returns a structure. + + + + + Creates a human-readable string that represents this structure. + + + A string that represents this structure. + + 1 + + + + + + + Platform adapter to bridge platform specific objects to HTML Renderer core library.
+ Core uses abstract renderer objects (RAdapter/RControl/REtc...) to access platform specific functionality, the concrete platforms + implements those objects to provide concrete platform implementation. Those allowing the core library to be platform agnostic. + + Platforms: WinForms, WPF, Metro, PDF renders, etc.
+ Objects: UI elements(Controls), Graphics(Render context), Colors, Brushes, Pens, Fonts, Images, Clipboard, etc.
+ + + + It is best to have a singleton instance of this class for concrete implementation!
+ This is because it holds caches of default CssData, Images, Fonts and Brushes. + + + + + cache of brush color to brush instance + + + + + cache of pen color to pen instance + + + + + cache of all the font used not to create same font again and again + + + + + default CSS parsed data singleton + + + + + image used to draw loading image icon + + + + + image used to draw error image icon + + + + + Init. + + + + + Get the default CSS stylesheet data. + + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Check if the given font exists in the system by font family name. + + the font name to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get image to be used while HTML image is loading. + + + + + Get image to be used if HTML image load failed. + + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard
+ Not relevant for platforms that don't render HTML on UI element. + + the text to set + + + + Set the given html and plain text data to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + + + + Set the given image to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the image object to set to clipboard + + + + Create a context menu that can be used on the control
+ Not relevant for platforms that don't render HTML on UI element. + + new context menu + + + + Save the given image to file by showing save dialog to the client.
+ Not relevant for platforms that don't render HTML on UI element. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard + + the text to set + + + + Set the given html and plain text data to clipboard. + + the html data + the plain text data + + + + Set the given image to clipboard. + + + + + + Create a context menu that can be used on the control + + new context menu + + + + Save the given image to file by showing save dialog to the client. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Adapter for platform specific brush objects - used to fill graphics (rectangles, polygons and paths).
+ The brush can be solid color, gradient or image. + + + + + + + + + + Adapter for platform specific context menu - used to create and show context menu at specific location.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The total number of items in the context menu + + + + + Add divider item to the context menu.
+ The divider is a non clickable place holder used to separate items. + + + + + Add item to the context menu with the given text that will raise the given event when clicked. + the text to set on the new context menu itemif to set the item as enabled or disabledthe event to raise when the item is clicked + + + + Remove the last item from the context menu iff it is a divider + + + + + Show the context menu in the given parent control at the given location. + the parent control to show inthe location to show at relative to the parent control + + + + + + + + + Adapter for platform specific control object - used to handle updating the control that the html is rendered on.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The platform adapter. + + + + + Init control with platform adapter. + + + + + The platform adapter. + + + + + Is the left mouse button is currently in pressed state + + + + + Is the right mouse button is currently in pressed state + + + + + Get the current location of the mouse relative to the control + + + + + Set the cursor over the control to default cursor + + + + + Set the cursor over the control to hand cursor + + + + + Set the cursor over the control to I beam cursor + + + + + Do drag-drop copy operation for the given data object. + + the drag-drop data object + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Invalidates the entire surface of the control and causes the control to be redrawn. + + + + + Adapter for platform specific font object - used to render text using specific font. + + + + + Gets the em-size of this Font measured in the units specified by the Unit property. + + + + + The line spacing, in pixels, of this font. + + + + + Get the vertical offset of the font underline location from the top of the font. + + + + + Get the left padding, in pixels, of the font. + + + + + + + + + + + + Adapter for platform specific font family object - define the available font families to use.
+ Required for custom fonts handling: fonts that are not installed on the system. + + + + + Gets the name of this Font Family. + + + + + Adapter for platform specific graphics rendering object - used to render graphics and text in platform specific context.
+ The core HTML Renderer components use this class for rendering logic, extending this + class in different platform: WinForms, WPF, Metro, PDF, etc. + + + + + the global adapter + + + + + Te clipping bound stack as clips are pushed/poped to/from the graphics + + + + + Init. + + + + + Get color pen. + + the color to get the pen for + pen instance + + + + Get solid color brush. + + the color to get the brush for + solid color brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Gets a Rectangle structure that bounds the clipping region of this Graphics. + + A rectangle structure that represents a bounding rectangle for the clipping region of this Graphics. + + + + Pop the latest clip push. + + + + + Push the clipping region of this Graphics to interception of current clipping rectangle and the given rectangle. + + Rectangle to clip to. + + + + Push the clipping region of this Graphics to exclude the given rectangle from the current clipping rectangle. + + Rectangle to exclude clipping in. + + + + Set the graphics smooth mode to use anti-alias.
+ Use to return back the mode used. + + the previous smooth mode before the change + + + + Return to previous smooth mode before anti-alias was set as returned from . + + the previous mode to set + + + + Get TextureBrush object that uses the specified image and bounding rectangle. + + The Image object with which this TextureBrush object fills interiors. + A Rectangle structure that represents the bounding rectangle for this TextureBrush object. + The dimension by which to translate the transformation + + + + Get GraphicsPath object. + + graphics path instance + + + + Measure the width and height of string when drawn on device context HDC + using the given font . + + the string to measure + the font to measure string with + the size of the string + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ Not relevant for platforms that don't render HTML on UI element. + + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Draw the given string using the given font and foreground color at given location. + + the string to draw + the font to use to draw the string + the text color to set + the location to start string draw (top-left) + used to know the size of the rendered text for transparent text support + is to render the string right-to-left (true - RTL, false - LTR) + + + + Draws a line connecting the two points specified by the coordinate pairs. + + Pen that determines the color, width, and style of the line. + The x-coordinate of the first point. + The y-coordinate of the first point. + The x-coordinate of the second point. + The y-coordinate of the second point. + + + + Draws a rectangle specified by a coordinate pair, a width, and a height. + + A Pen that determines the color, width, and style of the rectangle. + The x-coordinate of the upper-left corner of the rectangle to draw. + The y-coordinate of the upper-left corner of the rectangle to draw. + The width of the rectangle to draw. + The height of the rectangle to draw. + + + + Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height. + + Brush that determines the characteristics of the fill. + The x-coordinate of the upper-left corner of the rectangle to fill. + The y-coordinate of the upper-left corner of the rectangle to fill. + Width of the rectangle to fill. + Height of the rectangle to fill. + + + + Draws the specified portion of the specified at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. The image is scaled to fit the rectangle. + Rectangle structure that specifies the portion of the object to draw. + + + + Draws the specified Image at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. + + + + Draws a GraphicsPath. + + Pen that determines the color, width, and style of the path. + GraphicsPath to draw. + + + + Fills the interior of a GraphicsPath. + + Brush that determines the characteristics of the fill. + GraphicsPath that represents the path to fill. + + + + Fills the interior of a polygon defined by an array of points specified by Point structures. + + Brush that determines the characteristics of the fill. + Array of Point structures that represent the vertices of the polygon to fill. + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Adapter for platform specific graphics path object - used to render (draw/fill) path shape. + + + + + Start path at the given point. + + + + + Add stright line to the given point from te last point. + + + + + Add circular arc of the given size to the given point from the last point. + + + + + Release path resources. + + + + + The 4 corners that are handled in arc rendering. + + + + + + + + + + + + + + + + + + + + + + + + + Adapter for platform specific image object - used to render images. + + + + + Get the width, in pixels, of the image. + + + + + Get the height, in pixels, of the image. + + + + + + + + + + Adapter for platform specific pen objects - used to draw graphics (lines, rectangles and paths) + + + + + Gets or sets the width of this Pen, in units of the Graphics object used for drawing. + + + + + Gets or sets the style used for dashed lines drawn with this Pen. + + + + + Holds parsed stylesheet css blocks arranged by media and classes.
+ + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + used to return empty array + + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data. + + + + + Init. + + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + Platform adapter + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data + + + + + Check if there are css blocks for the given class selector. + + the class selector to check for css blocks by + optional: the css media type (default - all) + true - has css blocks for the class, false - otherwise + + + + Get collection of css blocks for the requested class selector.
+ the can be: class name, html element name, html element and + class name (elm.class), hash tag with element id (#id).
+ returned all the blocks that word on the requested class selector, it can contain simple + selector or hierarchy selector. + + the class selector to get css blocks by + optional: the css media type (default - all) + collection of css blocks, empty collection if no blocks exists (never null) + + + + Add the given css block to the css data, merging to existing block if required. + + + If there is no css blocks for the same class it will be added to data collection.
+ If there is already css blocks for the same class it will check for each existing block + if the hierarchical selectors match (or not exists). if do the two css blocks will be merged into + one where the new block properties overwrite existing if needed. if the new block doesn't mach any + existing it will be added either to the beginning of the list if it has no hierarchical selectors or at the end.
+ Css block without hierarchical selectors must be added to the beginning of the list so more specific block + can overwrite it when the style is applied. + + the media type to add the CSS to + the css block to add + + + + Combine this CSS data blocks with CSS blocks for each media.
+ Merge blocks if exists in both. + + the CSS data to combine with + + + + Create deep copy of the css data with cloned css blocks. + + cloned object + + + + CSS Specification's Default Style Sheet for HTML 4 + + + http://www.w3.org/TR/CSS21/sample.html + + + + + Border types + + + + + Represents a CSS Box of text or replaced elements. + + + The Box can contains other boxes, that's the way that the CSS Tree + is composed. + + To know more about boxes visit CSS spec: + http://www.w3.org/TR/CSS21/box.html + + + + + the parent css box of this css box in the hierarchy + + + + + the root container for the hierarchy + + + + + the html tag that is associated with this css box, null if anonymous box + + + + + the inner text of the box + + + + + Do not use or alter this flag + + + Flag that indicates that CssTable algorithm already made fixes on it. + + + + + handler for loading background image + + + + + Init. + + optional: the parent of this css box in html + optional: the html tag associated with this css box + + + + Gets the HtmlContainer of the Box. + WARNING: May be null. + + + + + Gets or sets the parent box of this box + + + + + Gets the children boxes of this box + + + + + Is the box is of "br" element. + + + + + is the box "Display" is "Inline", is this is an inline box and not block. + + + + + is the box "Display" is "Block", is this is an block box and not inline. + + + + + Is the css box clickable (by default only "a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + Gets the containing block-box of this box. (The nearest parent box with display=block) + + + + + Gets the HTMLTag that hosts this box + + + + + Gets if this box represents an image + + + + + Tells if the box is empty or contains just blank spaces + + + + + Gets or sets the inner text of the box + + + + + Gets the line-boxes of this box (if block box) + + + + + Gets the linebox(es) that contains words of this box (if inline) + + + + + Gets the rectangles where this box should be painted + + + + + Gets the BoxWords of text in the box + + + + + Gets the first word of the box + + + + + Gets or sets the first linebox where content of this box appear + + + + + Gets or sets the last linebox where content of this box appear + + + + + Create new css box for the given parent with the given html tag.
+ + the html tag to define the box + the box to add the new box to it as child + the new box + + + + Create new css box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous inline boxes visit: http://www.w3.org/TR/CSS21/visuren.html#anonymous + + the box to add the new box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new box + + + + Create new css block box. + + the new block box + + + + Create new css block box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous block boxes visit CSS spec: + http://www.w3.org/TR/CSS21/visuren.html#anonymous-block-level + + the box to add the new block box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new block box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + Device context to use + + + + Prints the fragment + + Device context to use + + + + + + Set this box in + + + + + + Move all child boxes from to this box. + + the box to move all its child boxes from + + + + Splits the text into words and saves the result + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions.
+ + Device context to use + + + + Assigns words its width and height + + + + + + Get the parent of this css properties instance. + + + + + + Gets the index of the box to be used on a (ordered) list + + + + + + Creates the + + + + + + Searches for the first word occurrence inside the box, on the specified linebox + + + + + + + + Gets the specified Attribute, returns string.Empty if no attribute specified + + Attribute to retrieve + Attribute value or string.Empty if no attribute specified + + + + Gets the value of the specified attribute of the source HTML tag. + + Attribute to retrieve + Value to return if attribute is not specified + Attribute value or defaultValue if no attribute specified + + + + Gets the minimum width that the box can be.
+ The box can be as thin as the longest word plus padding.
+ The check is deep thru box tree.
+ + the min width of the box + + + + Gets the longest word (in width) inside the box, deeply. + + + + + + + + + Get the total margin value (left and right) from the given box to the given end box.
+ + the box to start calculation from. + the total margin + + + + Gets the maximum bottom of the boxes inside the startBox + + + + + + + + Get the and width of the box content.
+ + The minimum width the content must be so it won't overflow (largest word + padding). + The total width the content can take without line wrapping (with padding). + + + + Get the and of the box words content and .
+ + the box to calculate for + the width that allows for each word to fit (width of the longest word) + the max width a single line of words can take without wrapping + the total amount of padding the content has + + + + + + Gets if this box has only inline siblings (including itself) + + + + + + Gets the rectangles where inline box will be drawn. See Remarks for more info. + + Rectangles where content should be placed + + Inline boxes can be split across different LineBoxes, that's why this method + Delivers a rectangle for each LineBox related to this box, if inline. + + + Inherits inheritable values from parent. + + + + + Gets the result of collapsing the vertical margins of the two boxes + + the previous box under the same parent + Resulting top margin + + + + Calculate the actual right of the box by the actual right of the child boxes if this box actual right is not set. + + the calculated actual right value + + + + Gets the result of collapsing the vertical margins of the two boxes + + Resulting bottom margin + + + + Deeply offsets the top of the box and its contents + + + + + + Paints the fragment + + the device to draw to + + + + Prints the fragment + + the device to draw to + + + + + + Paints the background of the box + + the device to draw into + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Paint all the words in the box. + + the device to draw into + the current scroll offset to offset the words + + + + Paints the text decoration (underline/strike-through/over-line) + + the device to draw into + + + + + + + Offsets the rectangle of the specified linebox by the specified gap, + and goes deep for rectangles of children in that linebox. + + + + + + + Resets the array + + + + + On image load process complete with image request refresh for it to be painted. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Get brush for the text depending if there is selected text color set. + + + + + Get brush for selection background depending if it has external and if alpha is required for images. + + + used for images so they will have alpha effect + + + + ToString override. + + + + + + CSS box for iframe element.
+ If the iframe is of embedded YouTube or Vimeo video it will show image with play. + + + + + the image word of this image box + + + + + is the iframe is of embeded video + + + + + the title of the video + + + + + the url of the video thumbnail image + + + + + link to the video on the site + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Is the css box clickable ("a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + is the iframe is of embeded video + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Load YouTube video data (title, image, link) by calling YouTube API. + + + + + Parse YouTube API response to get video data (title, image, link). + + + + + Load Vimeo video data (title, image, link) by calling Vimeo API. + + + + + Parse Vimeo API response to get video data (title, image, link). + + + + + Handle error occurred during video data load to handle if the video was not found. + + the exception that occurred during data load web request + the name of the video source (YouTube/Vimeo/Etc.) + + + + Create image handler for downloading video image if found and release the WebClient instance used for API call. + + + + + Paints the fragment + + the device to draw to + + + + Draw video image over the iframe if found. + + + + + Draw video title on top of the iframe if found. + + + + + Draw play over the iframe if we found link url. + + + + + Assigns words its width and height + + the device to use + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + CSS box for hr element. + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + the device to draw to + + + + CSS box for image element. + + + + + the image word of this image box + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Get the image of this image box. + + + + + Paints the fragment + + the device to draw to + + + + Assigns words its width and height + + the device to use + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Base class for css box to handle the css properties.
+ Has field and property for every css property that can be set, the properties add additional parsing like + setting the correct border depending what border value was set (single, two , all four).
+ Has additional fields to control the location and size of the box and 'actual' css values for some properties + that require additional calculations and parsing.
+ + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + the width of whitespace between words + + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + Gets the bounds of the box + + + + + Gets the width available on the box, counting padding and margin. + + + + + Gets the right of the box. When setting, it will affect only the width of the box. + + + + + Gets or sets the bottom of the box. + (When setting, alters only the Size.Height of the box) + + + + + Gets the left of the client rectangle (Where content starts rendering) + + + + + Gets the top of the client rectangle (Where content starts rendering) + + + + + Gets the right of the client rectangle + + + + + Gets the bottom of the client rectangle + + + + + Gets the client rectangle + + + + + Gets the actual height + + + + + Gets the actual height + + + + + Gets the actual top's padding + + + + + Gets the actual padding on the left + + + + + Gets the actual Padding of the bottom + + + + + Gets the actual padding on the right + + + + + Gets the actual top's Margin + + + + + The margin top value if was effected by margin collapse. + + + + + Gets the actual Margin on the left + + + + + Gets the actual Margin of the bottom + + + + + Gets the actual Margin on the right + + + + + Gets the actual top border width + + + + + Gets the actual Left border width + + + + + Gets the actual Bottom border width + + + + + Gets the actual Right border width + + + + + Gets the actual top border Color + + + + + Gets the actual Left border Color + + + + + Gets the actual Bottom border Color + + + + + Gets the actual Right border Color + + + + + Gets the actual length of the north west corner + + + + + Gets the actual length of the north east corner + + + + + Gets the actual length of the south east corner + + + + + Gets the actual length of the south west corner + + + + + Gets a value indicating if at least one of the corners of the box is rounded + + + + + Gets the actual width of whitespace between words. + + + + + + Gets the actual color for the text. + + + + + Gets the actual background color of the box + + + + + Gets the second color that creates a gradient for the background + + + + + Gets the actual angle specified for the background gradient + + + + + Gets the actual font of the parent + + + + + Gets the font that should be actually used to paint the text of the box + + + + + Gets the line height + + + + + Gets the text indentation (on first line only) + + + + + Gets the actual horizontal border spacing for tables + + + + + Gets the actual vertical border spacing for tables + + + + + Get the parent of this css properties instance. + + + + + + Gets the height of the font in the specified units + + + + + + Ensures that the specified length is converted to pixels if necessary + + + + + + Set the style/width/color for all 4 borders on the box.
+ if null is given for a value it will not be set. + + optional: the style to set + optional: the width to set + optional: the color to set + + + + Measures the width of whitespace between words (set ). + + + + + Inherits inheritable values from specified box. + + Set to true to inherit all CSS properties instead of only the ineritables + Box to inherit the properties + + + + Helps on CSS Layout. + + + + + Measure image box size by the width\height set on the box and the actual rendered image size.
+ If no image exists for the box error icon will be set. + + the image word to measure + + + + Creates line boxes for the specified blockbox + + + + + + + Applies special vertical alignment for table-cells + + + + + + + Recursively flows the content of the box using the inline model + + Device Info + Blockbox that contains the text flow + Current box to flow its content + Maximum reached right + Space to use between rows of text + x starting coordinate for when breaking lines of text + Current linebox being used + Current x coordinate that will be the left of the next word + Current y coordinate that will be the top of the next word + Maximum right reached so far + Maximum bottom reached so far + + + + Adjust the position of absolute elements by letf and top margins. + + + + + Recursively creates the rectangles of the blockBox, by bubbling from deep to outside of the boxes + in the rectangle structure + + + + + Applies vertical and horizontal alignment to words in lineboxes + + + + + + + Applies right to left direction to words + + + + + + + Applies RTL direction to all the words on the line. + + the line to apply RTL to + + + + Applies RTL direction to specific box words on the line. + + + + + + + Applies vertical alignment to the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies right alignment to the text on the linebox + + + + + + + Simplest alignment, just arrange words. + + + + + + + Layout engine for tables executing the complex layout of tables with rows/columns/headers/etc. + + + + + the main box of the table + + + + + + + + + + collection of all rows boxes + + + + + collection of all columns boxes + + + + + + + + + + Init. + + + + + + Get the table cells spacing for all the cells in the table.
+ Used to calculate the spacing the table has in addition to regular padding and borders. + + the table box to calculate the spacing for + the calculated spacing + + + + + + + + + + + Analyzes the Table and assigns values to this CssTable object. + To be called from the constructor + + + + + Get the table boxes into the proper fields. + + + + + Insert EmptyBoxes for vertical cell spanning. + + + + + Determine Row and Column Count, and ColumnWidths + + + + + + + + + + + + While table width is larger than it should, and width is reductable.
+ If table max width is limited by we need to lower the columns width even if it will result in clipping
+ + + + + Check for minimum sizes (increment widths if necessary) + + + + + Layout the cells by the calculated table layout + + + + + + Gets the spanned width of a cell (With of all columns it spans minus one). + + + + + Gets the cell column index checking its position and other cells colspans + + + + + + + + Gets the cells width, taking colspan and being in the specified column + + + + + + + + Gets the colspan of the specified box + + + + + + Gets the rowspan of the specified box + + + + + + Recursively measures words inside the box + + the box to measure + Device to use + + + + Tells if the columns widths can be reduced, + by checking the minimum widths of all cells + + + + + + Tells if the specified column can be reduced, + by checking its minimum width + + + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Calculate the min and max width for each column of the table by the content in all rows.
+ the min width possible without clipping content
+ the max width the cell content can take without wrapping
+ + if to measure only columns that have no calculated width + return the min width for each column - the min width possible without clipping content + return the max width for each column - the max width the cell content can take without wrapping + + + + Gets the width available for cells + + + + It takes away the cell-spacing from + + + + + Gets the current sum of column widths + + + + + + Gets the span attribute of the tag of the specified box + + + + + + Gets the minimum width of each column + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual vertical spacing of the table + + + + + Represents and gets info about a CSS Length + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + Creates a new CssLength from a length specified on a CSS style sheet or fragment + + Length as specified in the Style Sheet or style fragment + + + + Gets the number in the length + + + + + Gets if the length has some parsing error + + + + + Gets if the length represents a precentage (not actually a length) + + + + + Gets if the length is specified in relative units + + + + + Gets the unit of the length + + + + + Gets the length as specified in the string + + + + + If length is in Ems, returns its value in points + + Em size factor to multiply + Points size of this em + If length has an error or isn't in ems + + + + If length is in Ems, returns its value in pixels + + Pixel size factor to multiply + Pixels size of this em + If length has an error or isn't in ems + + + + Returns the length formatted ready for CSS interpreting. + + + + + + Represents a line of text. + + + To learn more about line-boxes see CSS spec: + http://www.w3.org/TR/CSS21/visuren.html + + + + + Creates a new LineBox + + + + + Gets a list of boxes related with the linebox. + To know the words of the box inside this linebox, use the method. + + + + + Gets the words inside the linebox + + + + + Gets the owner box + + + + + Gets a List of rectangles that are to be painted on this linebox + + + + + Get the height of this box line (the max height of all the words) + + + + + Get the bottom of this box line (the max bottom of all the words) + + + + + Lets the linebox add the word an its box to their lists if necessary. + + + + + + Return the words of the specified box that live in this linebox + + + + + + + Updates the specified rectangle of the specified box. + + + + + + + + + + Copies the rectangles to their specified box + + + + + Sets the baseline of the words of the specified box to certain height + + Device info + box to check words + baseline + + + + Check if the given word is the last selected word in the line.
+ It can either be the last word in the line or the next word has no selection. + + the word to check + + + + + Returns the words of the linebox + + + + + + Represents a word inside an inline box + + + Because of performance, words of text are the most atomic + element in the project. It should be characters, but come on, + imagine the performance when drawing char by char on the device.
+ It may change for future versions of the library. + + + + + the CSS box owner of the word + + + + + Rectangle + + + + + If the word is selected this points to the selection handler for more data + + + + + Init. + + the CSS box owner of the word + + + + Gets the Box where this word belongs. + + + + + Gets or sets the bounds of the rectangle + + + + + Left of the rectangle + + + + + Top of the rectangle + + + + + Width of the rectangle + + + + + Get the full width of the word including the spacing. + + + + + Gets the actual width of whitespace between words. + + + + + Height of the rectangle + + + + + Gets or sets the right of the rectangle. When setting, it only affects the Width of the rectangle. + + + + + Gets or sets the bottom of the rectangle. When setting, it only affects the Height of the rectangle. + + + + + If the word is selected this points to the selection handler for more data + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + is the word is currently selected + + + + + the selection start index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the word is partially selected (-1 if not selected or fully selected) + + + + + Gets or sets an offset to be considered in measurements + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + the image object if it is image word (can be null if not loaded) + + + + + the image rectangle restriction as returned from image load event + + + + + Creates a new BoxWord which represents an image + + the CSS box owner of the word + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + the image rectange restriction as returned from image load event + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + The word text + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Init. + + the CSS box owner of the word + the word chars + was there a whitespace before the word chars (before trim) + was there a whitespace after the word chars (before trim) + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + Represents this word for debugging purposes + + + + + + Used to make space on vertical cell combination + + + + + the index of the row where box starts + + + + + the index of the row where box ends + + + + + Gets the index of the row where box starts + + + + + Gets the index of the row where box ends + + + + + Represents the possible units of the CSS lengths + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + CSS boxes that have ":hover" selector on them. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + Init. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + the name of the html tag + + + + + if the tag is single placed; in other words it doesn't have a separate closing tag; + + + + + collection of attributes and their value the html tag has + + + + + Init. + + the name of the html tag + if the tag is single placed; in other words it doesn't have a separate closing tag; + collection of attributes and their value the html tag has + + + + Gets the name of this tag + + + + + Gets collection of attributes and their value the html tag has + + + + + Gets if the tag is single placed; in other words it doesn't have a separate closing tag;
+ e.g. <br> + + + + + is the html tag has attributes. + + true - has attributes, false - otherwise + + + + Gets a boolean indicating if the attribute list has the specified attribute + + attribute name to check if exists + true - attribute exists, false - otherwise + + + + Get attribute value for given attribute name or null if not exists. + + attribute name to get by + optional: value to return if attribute is not specified + attribute value or null if not found + + + + Represents a block of CSS property values.
+ Contains collection of key-value pairs that are CSS properties for specific css class.
+ Css class can be either custom or html tag name. + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + the name of the css class of the block + + + + + the CSS block properties and values + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + is the css block has :hover pseudo-class + + + + + Creates a new block from the block's source + + the name of the css class of the block + the CSS block properties and values + optional: additional selectors to used in hierarchy + optional: is the css block has :hover pseudo-class + + + + the name of the css class of the block + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + Gets the CSS block properties and its values + + + + + is the css block has :hover pseudo-class + + + + + Merge the other block properties into this css block.
+ Other block properties can overwrite this block properties. + + the css block to merge with + + + + Create deep copy of the CssBlock. + + new CssBlock with same data + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Check if the selectors of the css blocks is the same. + + the other block to compare to + true - the selectors on blocks are the same, false - otherwise + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Serves as a hash function for a particular type. + + A hash code for the current . + + + + Returns a that represents the current . + + + + + Holds single class selector in css block hierarchical selection (p class1 > div.class2) + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Creates a new block from the block's source + + the name of the css class of the block + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Returns a that represents the current . + + + + + Controls the way styles are generated when html is generated. + + + + + styles are not generated at all + + + + + style are inserted in style attribute for each html tag + + + + + style section is generated in the head of the html + + + + + Callback used in to allow setting image externally and async.
+ The callback can provide path to image file path, URL or the actual image to use.
+ If is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + the image to use + optional: limit to specific rectangle in the loaded image + + + + Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and + provide file path to load the image from. Can also use the asynchronous image overwrite not to block HTML rendering is applicable.
+ If no alternative data is provided the original source will be used.
+ + + + + use to cancel the image loading by html renderer, the provided image will be used. + + + + + the source of the image (file path or uri) + + + + + collection of all the attributes that are defined on the image element + + + + + Callback used to allow setting image externally and async. + + + + + Init. + + the source of the image (file path or Uri) + collection of all the attributes that are defined on the image element + Callback used to allow setting image externally and async. + + + + the source of the image (file path, URL or inline data) + + + + + collection of all the attributes that are defined on the image element or CSS style + + + + + Indicate the image load is handled asynchronously. + Cancel this image loading and overwrite the image asynchronously using callback method.
+ + + + + Callback to overwrite the loaded image with error image.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + the path to the image to load (file path or URL) + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + + + + + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ If imageRectangle is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + + + + + Raised when the user clicks on a link in the html. + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + Init. + + the link href that was clicked + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + + + + + + + Exception thrown when client code subscribed to LinkClicked event thrown exception. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a specified error message. + + The message that describes the error. + + + + Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ It can happen if some async event has occurred that requires re-paint and re-layout of the html.
+ Example: async download of image is complete. + + + + + is re-layout is required for the refresh + + + + + Init. + + is re-layout is required for the refresh + + + + is re-layout is required for the refresh + + + + + + + + + + + Raised when an error occurred during html rendering. + + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + Init. + + the type of error to report + the error message + optional: the exception that occurred + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + + + + + + + Enum of possible error types that can be reported. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + the location to scroll to + + + + + Init. + + the location to scroll to + + + + the x location to scroll to + + + + + the x location to scroll to + + + + + + + + + + + Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Init. + + the source of the image (file path or URL) + collection of all the attributes that are defined on the image element + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Holds data on link element in HTML.
+ Used to expose data outside of HTML Renderer internal structure. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Init. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Is the link is directed to another element in the html + + + + + Return the id of the element this anchor link is referencing. + + + + + + + + + + + Contains all the paint code to paint different background images. + + + + + Draw the background image of the given box in the given rectangle.
+ Handle background-repeat and background-position values. + + the device to draw into + the box to draw its background image + the handler that loads image to draw + the rectangle to draw image in + + + + Get top-left location to start drawing the image at depending on background-position value. + + the background-position value + the rectangle to position image in + the size of the image + the top-left location + + + + Draw the background image at the required location repeating it over the X axis.
+ Adjust location to left if starting location doesn't include all the range (adjusted to center or right). + + + + + Draw the background image at the required location repeating it over the Y axis.
+ Adjust location to top if starting location doesn't include all the range (adjusted to center or bottom). + + + + + Draw the background image at the required location repeating it over the X and Y axis.
+ Adjust location to left-top if starting location doesn't include all the range (adjusted to center or bottom/right). + + + + + Contains all the complex paint code to paint different style borders. + + + + + used for all border paint to use the same points and not create new array each time. + + + + + Draws all the border of the box with respect to style, width, etc. + + the device to draw into + the box to draw borders for + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Draw simple border. + + Desired border + the device to draw to + Box which the border corresponds + the brush to use + the bounding rectangle to draw in + Beveled border path, null if there is no rounded corners + + + + Draw specific border (top/bottom/left/right) with the box data (style/width/rounded).
+ + desired border to draw + the box to draw its borders, contain the borders data + the device to draw into + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + + + + Set rectangle for inset/outset border as it need diagonal connection to other borders. + + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + Beveled border path, null if there is no rounded corners + + + + Makes a border path for rounded borders.
+ To support rounded dotted/dashed borders we need to use arc in the border path.
+ Return null if the border is not rounded.
+ + the device to draw into + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Beveled border path, null if there is no rounded corners + + + + Get pen to be used for border draw respecting its style. + + + + + Get the border color for the given box border. + + + + + Get the border width for the given box border. + + + + + Get the border style for the given box border. + + + + + Makes the specified color darker for inset/outset borders. + + + + + Handle context menu. + + + + + select all text + + + + + copy selected text + + + + + copy the link source + + + + + open link (as left mouse click) + + + + + copy the source of the image + + + + + copy image to clipboard + + + + + save image to disk + + + + + open video in browser + + + + + copy video url to browser + + + + + the selection handler linked to the context menu handler + + + + + the html container the handler is on + + + + + the last context menu shown + + + + + the control that the context menu was shown on + + + + + the css rectangle that context menu shown on + + + + + the css link box that context menu shown on + + + + + Init context menu items strings. + + + + + Init. + + the selection handler linked to the context menu handler + the html container the handler is on + + + + Show context menu clicked on given rectangle. + + the parent control to show the context menu on + the rectangle that was clicked to show context menu + the link that was clicked to show context menu on + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Dispose of the last used context menu. + + + + + Handle link click. + + + + + Copy the href of a link to clipboard. + + + + + Open save as dialog to save the image + + + + + Copy the image source to clipboard. + + + + + Copy image object to clipboard. + + + + + Copy selected text. + + + + + Select all text. + + + + + Utilities for fonts and fonts families handling. + + + + + + + + + + Allow to map not installed fonts to different + + + + + collection of all installed and added font families to check if font exists + + + + + cache of all the font used not to create same font again and again + + + + + Init. + + + + + Check if the given font family exists by name + + the font to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get cached font instance for the given font properties.
+ Improve performance not to create same font multiple times. + + cached font instance + + + + Get cached font if it exists in cache or null if it is not. + + + + + create font (try using existing font family to support custom fonts) + + + + + Handler for all loading image logic.
+

+ Loading by .
+ Loading by file path.
+ Loading by URI.
+

+ + + + Supports sync and async image loading. + + + If the image object is created by the handler on calling dispose of the handler the image will be released, this + makes release of unused images faster as they can be large.
+ Disposing image load handler will also cancel download of image from the web. + + + + + + the container of the html to handle load image for + + + + + callback raised when image load process is complete with image or without + + + + + the web client used to download image from URL (to cancel on dispose) + + + + + Must be open as long as the image is in use + + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + to know if image load event callback was sync or async raised + + + + + flag to indicate if to release the image object on box dispose (only if image was loaded by the box) + + + + + is the handler has been disposed + + + + + Init. + + the container of the html to handle load image for + callback raised when image load process is complete with image or without + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + Set image of this image box by analyzing the src attribute.
+ Load the image from inline base64 encoded string.
+ Or from calling property/method on the bridge object that returns image or URL to image.
+ Or from file path
+ Or from URI. + + + File path and URI image loading is executed async and after finishing calling + on the main thread and not thread-pool. + + the source of the image to load + the collection of attributes on the element to use in event + the image object (null if failed) + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set the image using callback from load image event, use the given data. + + the path to the image to load (file path or uri) + the image to load + optional: limit to specific rectangle of the image and not all of it + + + + Load the image from inline base64 encoded string data. + + the source that has the base64 encoded image + + + + Extract image object from inline base64 encoded data in the src of the html img element. + + the source that has the base64 encoded image + image from base64 data string or null if failed + + + + Load image from path of image file or URL. + + the file path or uri to load image from + + + + Load the image file on thread-pool thread and calling after. + + the file path to get the image from + + + + Load the image file on thread-pool thread and calling after.
+ Calling on the main thread and not thread-pool. + + the file path to get the image from + + + + Load image from the given URI by downloading it.
+ Create local file name in temp folder from the URI, if the file already exists use it as it has already been downloaded. + If not download the file using . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + key value pair of URL and file info to download the file to + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + Flag image load complete and request refresh for re-layout and invalidate. + + + + + Release the image and client objects. + + + + + Handler for text selection in the html. + + + + + the root of the handled html tree + + + + + handler for showing context menu on right click + + + + + the mouse location when selection started used to ignore small selections + + + + + the starting word of html selection
+ where the user started the selection, if the selection is backwards then it will be the last selected word. + + + + + the ending word of html selection
+ where the user ended the selection, if the selection is backwards then it will be the first selected word. + + + + + the selection start index if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + is the selection goes backward in the html, the starting word comes after the ending word in DFS traversing.
+ + + + + used to ignore mouse up after selection + + + + + current selection process is after double click (full word selection) + + + + + used to know if selection is in the control or started outside so it needs to be ignored + + + + + used to handle drag and drop + + + + + is the cursor on the control has been changed by the selection handler + + + + + used to know if double click selection is requested + + + + + used to know if drag and drop was already started not to execute the same operation over + + + + + Init. + + the root of the handled html tree + + + + Select all the words in the html. + + the control hosting the html to invalidate + + + + Select the word at the given location if found. + + the control hosting the html to invalidate + the location to select word at + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse on the html + + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + is the left mouse button has been released + is the mouse up should be ignored + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse on the html + + + + On mouse leave change the cursor back to default. + + the control hosting the html to set cursor and invalidate + + + + Copy the currently selected html segment to clipboard.
+ Copy rich html text and plain text. + + + + + Get the currently selected text segment in the html.
+ + + + + Copy the currently selected html segment with style.
+ + + + + The selection start index if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start index for + data value or -1 if not applicable + + + + The selection end index if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end index for + + + + The selection start offset if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start offset for + + + + The selection end offset if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end offset for + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Handle html text selection by mouse move over the html with left mouse button pressed.
+ Calculate the words in the selected range and set their selected property. + + the control hosting the html to invalidate + the mouse location + true - partial word selection allowed, false - only full words selection + + + + Clear the current selection. + + + + + Clear the selection from all the words in the css box recursively. + + the css box to selectionStart clear at + + + + Start drag and drop operation on the currently selected html segment. + + the control to start the drag and drop on + + + + Select all the words that are under DOM hierarchy.
+ + the box to start select all at + + + + Check if the current selection is non empty, has some selection data. + + + true - partial word selection allowed, false - only full words selection + true - is non empty selection, false - empty selection + + + + Select all the words that are between word and word in the DOM hierarchy.
+ + the root of the DOM sub-tree the selection is in + selection start word limit + selection end word limit + + + + Select all the words that are between word and word in the DOM hierarchy. + + the current traversal node + selection start word limit + selection end word limit + used to know the traversal is currently in selected range + + + + + Calculate the character index and offset by characters for the given word and given offset.
+ . + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + to set the starting or ending char and offset data + + + + Calculate the character index and offset by characters for the given word and given offset.
+ If the location is below the word line then set the selection to the end.
+ If the location is to the right of the word then set the selection to the end.
+ If the offset is to the left of the word set the selection to the beginning.
+ Otherwise calculate the width of each substring to find the char the location is on. + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + is to include the first character in the calculation + return the index of the char under the location + return the offset of the char under the location + + + + Check if the selection direction is forward or backward.
+ Is the selection start word is before the selection end word in DFS traversal. + + + + + Handler for loading a stylesheet data. + + + + + Load stylesheet data from the given source.
+ The source can be local file or web URI.
+ First raise event to allow the client to overwrite the stylesheet loading.
+ If the stylesheet is downloaded from URI we will try to correct local URIs to absolute.
+ + the container of the html to handle load stylesheet for + the source of the element to load the stylesheet by + the attributes of the link element + return the stylesheet string that has been loaded (null if failed or is given) + return stylesheet data object that was provided by overwrite (null if failed or is given) + + + + Load stylesheet string from given source (file path or uri). + + the container of the html to handle load stylesheet for + the file path or uri to load the stylesheet from + the stylesheet string + + + + Load the stylesheet from local file by given path. + + the container of the html to handle load stylesheet for + the stylesheet file to load + the loaded stylesheet string + + + + Load the stylesheet from uri by downloading the string. + + the container of the html to handle load stylesheet for + the uri to download from + the loaded stylesheet string + + + + Make relative URLs absolute in the stylesheet using the URI of the stylesheet. + + the stylesheet to correct + the stylesheet uri to use to create absolute URLs + Corrected stylesheet + + + + Low level handling of Html Renderer logic.
+ Allows html layout and rendering without association to actual control, those allowing to handle html rendering on any graphics object.
+ Using this class will require the client to handle all propagation's of mouse/keyboard events, layout/paint calls, scrolling offset, + location/size/rectangle handling and UI refresh requests.
+ + + + MaxSize and ActualSize:
+ The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can exceed the max size by layout restrictions (unwrap-able line, set image size, etc.).
+ Set zero for unlimited (width/height separately).
+ + + ScrollOffset:
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ Element that is rendered at location (50,100) with offset of (0,200) will not be rendered + at -100, therefore outside the client rectangle. + + + LinkClicked event
+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link to overwrite by custom logic.
+ If error occurred in event handler it will propagate up the stack. + + + StylesheetLoad event:
+ Raised when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + ImageLoad event:
+ Raised when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ + + Refresh event:
+ Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + RenderError event:
+ Raised when an error occurred during html rendering.
+ + + + + + + + + + + + + + + + parser for CSS data + + + + + the root css box of the parsed html + + + + + list of all css boxes that have ":hover" selector on them + + + + + Handler for text selection in the html. + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + the parsed stylesheet data used for handling the html + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled (default - true) + + + + + Gets or sets a value indicating if anti-aliasing should be avoided + for geometry like backgrounds and borders + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ + + + + the top-left most location of the rendered html + + + + + the max width and height of the rendered html, effects layout, actual size cannot exceed this values.
+ Set zero for unlimited.
+ + + + + Gets or sets the scroll offset of the document for scroll controls + + + + + The actual size of the rendered html (after layout) + + + + + Init. + + + + + + + + + + parser for CSS data + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrapable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + the root css box of the parsed html + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + + + + + + + Clear the content of the HTML container releasing any resources used to render previously existing content. + + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given device. + + the device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the location of the mouse + the mouse event data + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + Raise the stylesheet load event with the given event args. + + the event args + + + + Raise the image load event with the given event args. + + the event args + + + + Request invalidation and re-layout of the control hosting the renderer. + + is re-layout is required for the refresh + + + + Report error in html render process. + + the type of error to report + the error message + optional: the exception that occured + + + + Handle link clicked going over event and using if not canceled. + + the control hosting the html to invalidate + the location of the mouse + the link that was clicked + + + + Add css box that has ":hover" selector to be handled on mouse hover. + + the box that has the hover selector + the css block with the css data with the selector + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Adjust the offset of the given location by the current scroll offset. + + the location to adjust + the adjusted location + + + + Check if the mouse is currently on the html container.
+ Relevant if the html container is not filled in the hosted control (location is not zero and the size is not the full size of the control). + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + General utilities. + + + + + Measure the size of the html by performing layout under the given restrictions. + + the graphics to use + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Perform the layout of the html container by given size restrictions returning the final size.
+ The layout can be effected by the HTML content in the if or + is set to true.
+ Handle minimum and maximum size restrictions.
+ Handle auto size and auto size for height only. if is true + is ignored.
+ + the graphics used for layout + the html container to layout + the current size + the min size restriction - can be empty for no restriction + the max size restriction - can be empty for no restriction + if to modify the size (width and height) by html content layout + if to modify the height by html content layout + + + + Parser to parse CSS stylesheet source string into CSS objects. + + + + + split CSS rule + + + + + + + + + + Utility for value parsing. + + + + + The chars to trim the css class name by + + + + + Init. + + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + raw css stylesheet to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the CSS data with parsed CSS objects (never null) + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ The parsed css blocks are added to the given css data, merged if class name already exists. + + the CSS data to fill with parsed CSS objects + raw css stylesheet to parse + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the font-family value to parse + parsed font-family value + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + color value + + + + Remove comments from the given stylesheet. + + the stylesheet to remove comments from + stylesheet without comments + + + + Parse given stylesheet for CSS blocks
+ This blocks are added under the "all" keyword. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Parse given stylesheet for media CSS blocks
+ This blocks are added under the specific media block they are found. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Feeds the style with a block about the specific media.
+ When no media is specified, "all" will be used. + + + the CSS block to handle + optional: the media (default - all) + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse css block selector to support hierarchical selector (p class1 > class2). + + the class selector to parse + return the main class the css block is on + returns the hierarchy of classes or null if single class selector + + + + Parse the properties of the given css block into a key-value dictionary. + + the raw css block to parse + dictionary with parsed css block properties + + + + Add the given property to the given properties collection, if the property is complex containing + multiple css properties then parse them and add the inner properties. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse length property to add only valid lengths. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse color property to add only valid color. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse a complex font property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + + + the value of the property to parse + parsed value + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the value of the property to parse + parsed font-family value + + + + Parse a complex border property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the left, top, right or bottom direction of the border to parse + the properties collection to add the specific properties to + + + + Parse a complex margin property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border style property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border width property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border color property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex padding property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Split multi direction value into the proper direction values (left, top, right, bottom). + + + + + Split the value by the specified separator; e.g. Useful in values like 'padding:5 4 3 inherit' + + Value to be splitted + + Splitted and trimmed values + + + + + + + + + + + + + Parse the given substring to extract border width substring. + Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse CSS properties values like numbers, Urls, etc. + + + + + + + + + + Init. + + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid double number, false - otherwise + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid int number, false - otherwise + + + + Check if the given string is a valid length value. + + the string value to check + true - valid, false - invalid + + + + Evals a number and returns it. If number is a percentage, it will be multiplied by hundredPercent + + Number to be parsed + Number that represents the 100% if parsed number is a percentage + Parsed number. Zero if error while parsing. + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + if the length is in pixels and the length is font related it needs to use 72/96 factor + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + if the length is in pixels and the length is font related it needs to use 72/96 factor + Allows the return double to be in points. If false, result will be pixels + the parsed length value with adjustments + + + + Get the unit to use for the length, use default if no unit found in length string. + + + + + Check if the given color string value is valid. + + color string value to parse + true - valid, false - invalid + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + Color value + + + + Parses a color value in CSS style; e.g. #ff0000, RED, RGB(255,0,0), RGB(100%, 0, 0) + + color substring value to parse + substring start idx + substring length + return the parsed color + true - valid color, false - otherwise + + + + Parses a border value in CSS style; e.g. 1px, 1, thin, thick, medium + + + + + + + + Get color by parsing given hex value color string (#A28B34). + + true - valid color, false - otherwise + + + + Get color by parsing given RGB value color string (RGB(255,180,90)) + + true - valid color, false - otherwise + + + + Get color by parsing given RGBA value color string (RGBA(255,180,90,180)) + + true - valid color, false - otherwise + + + + Get color by given name, including .NET name. + + true - valid color, false - otherwise + + + + Parse the given decimal number string to positive int value.
+ Start at given , ignore whitespaces and take + as many digits as possible to parse to int. + + the string to parse + the index to start parsing at + parsed int or 0 + + + + Parse the given decimal number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Parse the given hex number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Handle css DOM tree generation from raw html and stylesheet. + + + + + Parser for CSS + + + + + Init. + + + + + Generate css tree by parsing the given html and applying the given css style data on it. + + the html to parse + the html container to use for reference resolve + the css data to use + the root of the generated tree + + + + Read styles defined inside the dom structure in links and style elements.
+ If the html tag is "style" tag parse it content and add to the css data for all future tags parsing.
+ If the html tag is "link" that point to style data parse it content and add to the css data for all future tags parsing.
+ + the box to parse style data in + the html container to use for reference resolve + the style data to fill with found styles + check if the css data has been modified by the handled html not to change the base css data + + + + Applies style to all boxes in the tree.
+ If the html tag has style defined for each apply that style to the css box of the tag.
+ If the html tag has "class" attribute and the class name has style defined apply that style on the tag css box.
+ If the html tag has "style" attribute parse it and apply the parsed style on the tag css box.
+ + the box to apply the style to + the style data for the html + + + + Set the selected text style (selection text color and background color). + + + the style data + + + + Assigns the given css classes to the given css box checking if matching.
+ Support multiple classes in single attribute separated by whitespace. + + the css box to assign css to + the css data to use to get the matching css blocks + + + + Assigns the given css style blocks to the given css box checking if matching. + + the css box to assign css to + the css data to use to get the matching css blocks + the class selector to search for css blocks + + + + Check if the given css block is assignable to the given css box.
+ the block is assignable if it has no hierarchical selectors or if the hierarchy matches.
+ Special handling for ":hover" pseudo-class.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Check if the given css block is assignable to the given css box by validating the selector.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Assigns the given css style block properties to the given css box. + + the css box to assign css to + the css block to assign + + + + Check if the given style is allowed to be set on the given css box.
+ Used to prevent invalid CssBoxes creation like table with inline display style. + + the css box to assign css to + the style key to cehck + the style value to check + true - style allowed, false - not allowed + + + + Clone css data if it has not already been cloned.
+ Used to preserve the base css data used when changed by style inside html. + + + + + + + + + + + + Converts an HTML length into a Css length + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Execute action on all the "td" cells of the table.
+ Handle if there is "theader" or "tbody" exists. + + the table element + the action to execute + + + + Go over all the text boxes (boxes that have some text that will be rendered) and + remove all boxes that have only white-spaces but are not 'preformatted' so they do not effect + the rendered html. + + the current box to correct its sub-tree + + + + Go over all image boxes and if its display style is set to block, put it inside another block but set the image to inline. + + the current box to correct its sub-tree + + + + Correct the DOM tree recursively by replacing "br" html boxes with anonymous blocks that respect br spec.
+ If the "br" tag is after inline box then the anon block will have zero height only acting as newline, + but if it is after block box then it will have min-height of the font size so it will create empty line. + + the current box to correct its sub-tree + used to know if the br is following a box so it should create an empty line or not so it only + move to a new line + + + + Correct DOM tree if there is block boxes that are inside inline blocks.
+ Need to rearrange the tree so block box will be only the child of other block box. + + the current box to correct its sub-tree + + + + Rearrange the DOM of the box to have block box with boxes before the inner block box and after. + + the box that has the problem + + + + Split bad box that has inline and block boxes into two parts, the left - before the block box + and right - after the block box. + + the parent box that has the problem + the box to split into different boxes + the left block box that is created for the split + + + + Makes block boxes be among only block boxes and all inline boxes have block parent box.
+ Inline boxes should live in a pool of Inline boxes only so they will define a single block.
+ At the end of this process a block box will have only block siblings and inline box will have + only inline siblings. + + the current box to correct its sub-tree + + + + Check if the given box contains only inline child boxes in all subtree. + + the box to check + true - only inline child boxes, false - otherwise + + + + Check if the given box contains inline and block child boxes. + + the box to check + true - has variant child boxes, false - otherwise + + + + + + + + + Parses the source html to css boxes tree structure. + + the html source to parse + + + + Add html text anon box to the current box, this box will have the rendered text
+ Adding box also for text that contains only whitespaces because we don't know yet if + the box is preformatted. At later stage they will be removed if not relevant. + + the html source to parse + the start of the html part + the index of the next html tag + the current box in html tree parsing + + + + Parse the html part, the part from prev parsing index to the beginning of the next html tag.
+ + the html source to parse + the index of the next html tag + the current box in html tree parsing + the end of the parsed part, the new start index + + + + Parse raw html tag source to object.
+ Extract attributes found on the tag. + + the html source to parse + the start index of the tag in the source + the length of the tag from the start index in the source + return the name of the html tag + return the dictionary of tag attributes + true - the tag is closing tag, false - otherwise + + + + Extract html tag attributes from the given sub-string. + + the html source to parse + the start index of the tag attributes in the source + the length of the tag attributes from the start index in the source + return the dictionary of tag attributes + + + + Collection of regular expressions used when parsing + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + Static class that contains argument-checking methods + + + + + Validate given condition is true, otherwise throw exception. + + Exception type to throw. + Condition to assert. + Exception message in-case of assert failure. + + + + Validate given argument isn't Null. + + argument to validate + Name of the argument checked + if is Null + + + + Validate given argument isn't . + + argument to validate + Name of the argument checked + if is + + + + Validate given argument isn't Null or empty. + + argument to validate + Name of the argument checked + if is Null or empty + + + + Validate given argument isn't Null. + + Type expected of arg + argument to validate + Name of the argument checked + if is Null + arg cast as T + + + + Validate given argument isn't Null or empty AND argument value is the path of existing file. + + argument to validate + Name of the argument checked + if is Null or empty + if arg file-path not exist + + + + Utility methods for general stuff. + + + + + Table to convert numbers into roman digits + + + + + Check if the given char is of Asian range. + + the character to check + true - Asian char, false - otherwise + + + + Check if the given char is a digit character (0-9) and (0-9, a-f for HEX) + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Convert the given char to digit. + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Get size that is max of and for width and height separately. + + + + + Get Uri object for the given path if it is valid uri path. + + the path to get uri for + uri or null if not valid + + + + Get the first value in the given dictionary. + + the type of dictionary key + the type of dictionary value + the dictionary + optional: the default value to return of no elements found in dictionary + first element or default value + + + + Get file info object for the given path if it is valid file path. + + the path to get file info for + file info or null if not valid + + + + Get web client response content type. + + the web client to get the response content type from + response content type or null + + + + Gets the representation of the online uri on the local disk. + + The online image uri. + The path of the file on the disk. + + + + Get substring seperated by whitespace starting from the given idex. + + the string to get substring in + the index to start substring search from + return the length of the found string + the index of the substring, -1 if no valid sub-string found + + + + Compare that the substring of is equal to + Assume given substring is not empty and all indexes are valid!
+ + true - equals, false - not equals + + + + Replaces invalid filename chars to '_' + + The possibly-not-valid filename + A valid filename. + + + + Convert number to alpha numeric system by the requested style (UpperAlpha, LowerRoman, Hebrew, etc.). + + the number to convert + the css style to convert by + converted string + + + + Convert the given integer into alphabetic numeric format (D, AU, etc.) + + the number to convert + is to use lowercase + the roman number string + + + + Convert the given integer into alphabetic numeric format (alpha, AU, etc.) + + the number to convert + the roman number string + + + + Convert the given integer into roman numeric format (II, VI, IX, etc.) + + the number to convert + if to use lowercase letters for roman digits + the roman number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + String constants to avoid typing errors. + + + + + Centimeters + + + + + Millimeters + + + + + Pixels + + + + + Inches + + + + + Em - The font size of the relevant font + + + + + The 'x-height' of the relevan font + + + + + Points + + + + + Picas + + + + + Default font size in points. Change this value to modify the default font size. + + + + + Default font used for the generic 'serif' family + + + + + Utility method for handling CSS stuff. + + + + + Brush for selection background + + + + + Brush for selection background + + + + + Gets the white space width of the specified box + + + + + + + + Get CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to get it's property value + the name of the CSS property + the value of the property, null if no such property exists + + + + Set CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to set it's property value + the name of the CSS property + the value to set + + + + Utility class for traversing DOM structure and execution stuff on it. + + + + + Check if the given location is inside the given box deep.
+ Check inner boxes and all lines that the given box spans to. + + the box to check + the location to check + true - location inside the box, false - otherwise + + + + Check if the given box contains only inline child boxes. + + the box to check + true - only inline child boxes, false - otherwise + + + + Recursively searches for the parent with the specified HTML Tag name + + + + + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + fix word space for first word in inline tag. + + the box to check + + + + Gets the next sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Get attribute value by given key starting search from given box, search up the tree until + attribute found or root. + + the box to start lookup at + the attribute to get + the value of the attribute or null if not found + + + + Get css box under the given sub-tree at the given x,y location, get the inner most.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + Optional: if to get only visible boxes (default - true) + css link box if exists or null + + + + Collect all link boxes found in the HTML tree. + + the box to start search from + collection to add all link boxes to + + + + Get css link box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + css link box if exists or null + + + + Get css box under the given sub-tree with the given id.
+ + the box to start search from + the id to find the box by + css box if exists or null + + + + Get css line box under the given sub-tree at the given y location or the nearest line from the top.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the line box to search in + the location to find the box at + css word box if exists or null + + + + Find the css line box that the given word is in. + + the word to search for it's line box + line box that the word is in + + + + Get selected plain text of the given html sub-tree. + + the DOM box to get selected text from its sub-tree + the selected plain text string + + + + Generate html from the given DOM tree.
+ Generate all the style inside the html, in header or for every tag depending on value. + + the box of the html generate html from + Optional: controls the way styles are generated when html is generated + Optional: true - generate only selected html subset, false - generate all (default - false) + generated html + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the root to generate tree from + generated tree + + + + Get selected plain text of the given html sub-tree.
+ Append all the selected words. + + the builder to append the selected text to + the DOM box to get selected text from its sub-tree + the index of the last word appended + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ + the box to check its sub-tree + the collection to add the selected tags to + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ Use to handle boxes that are between selected words but don't have selected word inside.
+ + the box to check its sub-tree + the hash to add the selected boxes to + used to handle boxes that are between selected words but don't have selected word inside + is the current box is in selected sub-tree + + + + find the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + the root of the boxes tree + the selected boxes to find selection root in + the box that is the root of selected boxes + + + + Check if the given box has a names child box (has html tag) recursively. + + the box to check + true - in sub-tree there is a named box, false - otherwise + + + + Write the given html DOM sub-tree into the given string builder.
+ If are given write html only from those tags. + + used to parse CSS data + the string builder to write html into + the html sub-tree to write + Controls the way styles are generated when html is generated + Control if to generate only selected boxes, if given only boxes found in hash will be generated + the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + + + Write the given html tag with all its attributes and styles. + + used to parse CSS data + the string builder to write html into + the css box with the html tag to write + Controls the way styles are generated when html is generated + + + + Clean the given style collection by removing default styles so only custom styles remain.
+ Return new collection where the old remains unchanged. + + the box the styles apply to, used to know the default style + the collection of styles to clean + new cleaned styles collection + + + + Write stylesheet data inline into the html. + + the string builder to write stylesheet into + the css data to write to the head + + + + Get the selected word with respect to partial selected words. + + the word to append + is to get selected text or all the text in the word + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the box to generate for + the string builder to generate to + the current indent level to set indent of generated text + + + + Defines HTML strings + + + + + List of html tags that don't have content + + + + + the html encode\decode pairs + + + + + the html decode only pairs + + + + + Init. + + + + + Is the given html tag is single tag or can have content. + + the tag to check (must be lower case) + true - is single tag, false - otherwise + + + + Decode html encoded string to regular string.
+ Handles <, >, "&. + + the string to decode + decoded string + + + + Encode regular string into html encoded string.
+ Handles <, >, "&. + + the string to encode + encoded string + + + + Decode html special charecters encoded using char entity code (€) + + the string to decode + decoded string + + + + Decode html special charecters encoded using char entity name + + the string to decode + decoded string + + + + Provides some drawing functionality + + + + + Check if the given color is visible if painted (has alpha and color values) + + the color to check + true - visible, false - not visible + + + + Clip the region the graphics will draw on by the overflow style of the containing block.
+ Recursively travel up the tree to find containing block that has overflow style set to hidden. if not + block found there will be no clipping and null will be returned. + + the graphics to clip + the box that is rendered to get containing blocks + true - was clipped, false - not clipped + + + + Draw image loading icon. + + the device to draw into + + the rectangle to draw icon in + + + + Draw image failed to load icon. + + the device to draw into + + the rectangle to draw icon in + + + + Creates a rounded rectangle using the specified corner radius
+ NW-----NE + | | + | | + SW-----SE + + the device to draw into + Rectangle to round + Radius of the north east corner + Radius of the north west corner + Radius of the south east corner + Radius of the south west corner + GraphicsPath with the lines of the rounded rectangle ready to be painted + + + + Represents sub-string of a full string starting at specific location with a specific length. + + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Init sub-string that is the full string. + + the full string that this sub-string is part of + + + + Init. + + the full string that this sub-string is part of + the start index of the sub-string + the length of the sub-string starting at + is null + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Get string char at specific index. + + the idx to get the char at + char at index + + + + Is the sub-string is empty string. + + true - empty string, false - otherwise + + + + Is the sub-string is empty string or contains only whitespaces. + + true - empty or whitespace string, false - otherwise + + + + Is the sub-string contains only whitespaces (at least one). + + true - empty or whitespace string, false - otherwise + + + + Get a string of the sub-string.
+ This will create a new string object! + + new string that is the sub-string represented by this instance + + + + Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length. + + The zero-based starting character position of a substring in this instance. + The number of characters in the substring. + A String equivalent to the substring of length length that begins at startIndex in this instance, or + Empty if startIndex is equal to the length of this instance and length is zero. + + + + Collection of regular expressions used when parsing + + + + + Extracts CSS style comments; e.g. /* comment */ + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts CSS colors; e.g. black white #fff #fe98cd rgb(5,5,5) rgb(45%, 0, 0) + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts CSS border styles; e.g. solid none dotted + + + + + Extracts CSS border widthe; e.g. 1px thin 3em + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + Extracts HTML tags + + + + + Extracts attributes from a HTML tag; e.g. att=value, att="value" + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + 线条图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + 初始化参数 + + + + + 返回或设置X轴间隔 + + + + + 标题 + + + + + 返回图片的宽度 + + + + + 返回或设置图片的高度 + + + + + X轴的间距 + + + + + Y轴的间距 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 背景颜色 + + + + + X轴的颜色 + + + + + Y轴的颜色 + + + + + 返回X轴数据的最大值(供给Painter调用) + + + + + 返回图片数据 + + + + + 画布 + + + + + 作图器 + + + + + 释放内容资源 + + + + + 获取X轴中的最大值 + + + + + + + 获取所有X轴列中的最大值 + + + + + + + 初始化图片 + + X轴的数据 + + + + + 画一条走势图 + + + + + + 画多条走势图 + + + + + + 作图器的基础类 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 返回此作图器的相关链走势图 + + + + + 获取某值在Y轴上的位置 + + 当前点的值 + 点坐标 + + + + 画XY轴线 + + 画布 + X轴的数据 + + + + 画标题 + + + + + + 画走势线 + + 画布 + X轴数据 + + + + 方块图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图的X轴数据 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + + + 标题 + + + + + 值 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 值的颜色 + + + + + 值的字体 + + + + + 绘制颜色 + + + + + 值是否可见 + + + + + 克隆自身 + + + + + + 定义X轴的数据集合 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + 添加一批数据 + + 轴的标题 + + + + 添加一批数据 + + 轴的标题 + 轴的值 + + + + 重置轴的值 + + 轴的值 + + + + 克隆数据 + + + + + + Indicates the behavior of a key when a cell "on the edge" is being edited. + and the normal behavior of that key would exceed the edge. For example, + for a key that normally moves one column to the left, the "edge" would be + the left most column, since the normal action of the key cannot be taken + (since there are no more columns to the left). + + + + + 按键将被忽略 + + + + + 按键将导致单元格编辑环绕到相对边缘的单元格。 + + + + + 按键将Wrap，但该列将更改为相应的相邻列。这只对正常操作为ChangeRow的键有意义。 + + + + + 按键将Wrap，但该行将更改为相应的相邻行。这只对正常操作为ChangeColumn的键有意义. + + + + + 该键将导致当前编辑操作结束。 + + + + + Indicates the normal behaviour of a key when used during a cell edit + operation. + + + + + The key press will be ignored + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the left. + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the right. + + + + + The key press will end the current edit and begin an edit + operation on the row above. + + + + + The key press will end the current edit and begin an edit + operation on the row below + + + + + The key press will cancel the current edit + + + + + The key press will finish the current edit operation + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Instances of this class handle key presses during a cell edit operation. + + + + + 设置给定键的行为 + + + + + + + + 处理按键操作 + + + + True if the key was completely handled. + + + + Gets or sets the ObjectListView on which the current key is being handled. + This cannot be null. + + + + + Gets the row of the cell that is currently being edited + + + + + Gets the index of the column of the cell that is being edited + + + + + Gets or sets the map that remembers the normal behaviour of keys + + + + + Gets or sets the map that remembers the desired behaviour of keys + on edge cases. + + + + + Setup the default key mapping + + + + + Handle the end edit command + + + + + Handle the cancel edit command + + + + + Placeholder that subclasses can override to handle any custom verbs + + + + + + + + Handle a change row command + + + + + + + Handle a change column command + + + + + + + Start editing the indicated cell if that cell is not already being edited + + The row to edit + The cell within that row to edit + + + + Gets the adjacent item to the given item in the given direction. + If that item is disabled, continue in that direction until an enabled item is found. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more enabled items in that direction. + + + + Gets the adjacent item to the given item in the given direction, wrapping if needed. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more items in that direction. + + + + Gets a collection of columns that are editable in the order they are shown to the user + + + + + These items allow combo boxes to remember a value and its description. + + + + + + + + + + + + + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + This editor shows and auto completes values from the given listview column. + + + + + Create an AutoCompleteCellEditor + + + + + + + This combo box is specialised to allow editing of an enum. + + + + + + + + + + + This editor simply shows and edits integer values. + + + + + + + + + + Gets or sets the value shown by this editor + + + + + This editor simply shows and edits unsigned integer values. + + This class can't be made public because unsigned int is not a + CLS-compliant type. If you want to use, just copy the code to this class + into your project and use it from there. + + + + This editor simply shows and edits boolean values. + + + + + + + + + + This editor simply shows and edits boolean values using a checkbox + + + + + Gets or sets the value shown by this editor + + + + + Gets or sets how the checkbox will be aligned + + + + + This editor simply shows and edits floating point values. + + You can intercept the CellEditStarting event if you want + to change the characteristics of the editor. For example, by increasing + the number of decimal places. + + + + + + + + + Gets or sets the value shown by this editor + + + + + A delegate that creates an editor for the given value + + The model from which that value came + The column for which the editor is being created + A representative value of the type to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A control which can edit the given value + + + + An editor registry gives a way to decide what cell editor should be used to edit + the value of a cell. Programmers can register non-standard types and the control that + should be used to edit instances of that type. + + + All ObjectListViews share the same editor registry. + + + + + Create an EditorRegistry + + + + + Register that values of 'type' should be edited by instances of 'controlType'. + + The type of value to be edited + The type of the Control that will edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), typeof(MySpecialColorEditor)); + + + + + Register the given delegate so that it is called to create editors + for values of the given type + + The type of value to be edited + The delegate that will create a control that can edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), CreateColorEditor); + ... + public Control CreateColorEditor(Object model, OLVColumn column, Object value) + { + return new MySpecialColorEditor(); + } + + + + + Register a delegate that will be called to create an editor for values + that have not been handled. + + The delegate that will create a editor for all other types + + + + Register a delegate that will be given a chance to create a control + before any other option is considered. + + The delegate that will create a control + + + + Remove the registered handler for the given type + + Does nothing if the given type doesn't exist + The type whose registration is to be removed + + + + Create and return an editor that is appropriate for the given value. + Return null if no appropriate editor can be found. + + The model involved + The column to be edited + The value to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A Control that can edit the given type of values + + + + Create and return an editor that will edit values of the given type + + A enum type + + + + A DataListView is a ListView that can be bound to a datasource (which would normally be a DataTable or DataView). + + + This listview keeps itself in sync with its source datatable by listening for change events. + The DataListView will automatically create columns to show all of the data source's columns/properties, if there is not already + a column showing that property. This allows you to define one or two columns in the designer and then have the others generated automatically. + If you don't want any column to be auto generated, set to false. + These generated columns will be only the simplest view of the world, and would look more interesting with a few delegates installed. + This listview will also automatically generate missing aspect getters to fetch the values from the data view. + Changing data sources is possible, but error prone. Before changing data sources, the programmer is responsible for modifying/resetting + the column collection to be valid for the new data source. + Internally, a CurrencyManager controls keeping the data source in-sync with other users of the data source (as per normal .NET + behavior). This means that the model objects in the DataListView are DataRowView objects. If you write your own AspectGetters/Setters, + they will be given DataRowView objects. + + + + + Make a DataListView + + + + + + + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + When a DataSource is set, the control will create OLVColumns to show any + data source columns that are not already shown. + If the DataSource is changed, you will have to remove any previously + created columns, since they will be configured for the previous DataSource. + . + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + Adaptors cannot be shared between controls. Each DataListView needs its own adapter. + + + + + Add the given collection of model objects to this control. + + A collection of model objects + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Insert the given collection of objects before the given position + + Where to insert the objects + The objects to be inserted + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Remove the given collection of model objects from this control. + + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Change the Unfreeze behaviour + + + + + Handles parent binding context changes + + Unused EventArgs. + + + + A DataTreeListView is a TreeListView that calculates its hierarchy based on + information in the data source. + + + Like a , a DataTreeListView sources all its information + from a combination of and . + can be a DataTable, DataSet, + or anything that implements . + + + To function properly, the DataTreeListView requires: + + the table to have a column which holds a unique for the row. The name of this column must be set in . + the table to have a column which holds id of the hierarchical parent of the row. The name of this column must be set in . + a value which identifies which rows are the roots of the tree (). + + The hierarchy structure is determined finding all the rows where the parent key is equal to . These rows + become the root objects of the hierarchy. + + Like a TreeListView, the hierarchy must not contain cycles. Bad things will happen if the data is cyclic. + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. Actually, it can be any value that can + be compared for equality against a basic type. + If this is set to the wrong value (i.e. to a value that no row + has in the parent id column), the list will be empty. + + + + + Gets or sets the value that identifies a row as a root object. + . The RootKeyValue can be of any type, + but the IDE cannot sensibly represent a value of any type, + so this is a typed wrapper around that property. + + + If you want the root value to be something other than a string, + you will have set it yourself. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + An IDragSource controls how drag out from the ObjectListView will behave + + + + + A drag operation is beginning. Return the data object that will be used + for data transfer. Return null to prevent the drag from starting. The data + object will normally include all the selected objects. + + + The returned object is later passed to the GetAllowedEffect() and EndDrag() + methods. + + What ObjectListView is being dragged from. + Which mouse button is down? + What item was directly dragged by the user? There may be more than just this + item selected. + The data object that will be used for data transfer. This will often be a subclass + of DataObject, but does not need to be. + + + + What operations are possible for this drag? This controls the icon shown during the drag + + The data object returned by StartDrag() + A combination of DragDropEffects flags + + + + The drag operation is complete. Do whatever is necessary to complete the action. + + The data object returned by StartDrag() + The value returned from GetAllowedEffects() + + + + A do-nothing implementation of IDragSource that can be safely subclassed. + + + + + See IDragSource documentation + + + + + + + + + See IDragSource documentation + + + + + + + See IDragSource documentation + + + + + + + A reasonable implementation of IDragSource that provides normal + drag source functionality. It creates a data object that supports + inter-application dragging of text and HTML representation of + the dragged rows. It can optionally force a refresh of all dragged + rows when the drag is complete. + + Subclasses can override GetDataObject() to add new + data formats to the data transfer object. + + + + Construct a SimpleDragSource + + + + + Construct a SimpleDragSource that refreshes the dragged rows when + the drag is complete + + + + + + Gets or sets whether the dragged rows should be refreshed when the + drag operation is complete. + + + + + Create a DataObject when the user does a left mouse drag operation. + See IDragSource for further information. + + + + + + + + + Which operations are allowed in the operation? By default, all operations are supported. + + + All opertions are supported + + + + The drag operation is finished. Refreshe the dragged rows if so configured. + + + + + + + Create a data object that will be used to as the data object + for the drag operation. + + + Subclasses can override this method add new formats to the data object. + + The ObjectListView that is the source of the drag + A data object for the drag + + + + Objects that implement this interface can acts as the receiver for drop + operation for an ObjectListView. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Should the drag be allowed to continue? + + + + + + This is a do-nothing implementation of IDropSink that is a useful + base class for more sophisticated implementations. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Change the cursor to reflect the current drag operation. + + You only need to override this if you want non-standard cursors. + The standard cursors are supplied automatically. + + + + + Should the drag be allowed to continue? + + + You only need to override this if you want the user to be able + to end the drop in some non-standard way, e.g. dragging to a + certain point even without releasing the mouse, or going outside + the bounds of the application. + + + + + + This is called when the mouse leaves the drop region and after the + drop has completed. + + + + + The enum indicates which target has been found for a drop operation + + + + + No applicable target has been found + + + + + The list itself is the target of the drop + + + + + An item is the target + + + + + Between two items (or above the top item or below the bottom item) + can be the target. This is not actually ever a target, only a value indicate + that it is valid to drop between items + + + + + Above an item is the target + + + + + Below an item is the target + + + + + A subitem is the target of the drop + + + + + On the right of an item is the target (not currently used) + + + + + On the left of an item is the target (not currently used) + + + + + This class represents a simple implementation of a drop sink. + + + Actually, it should be called CleverDropSink -- it's far from simple and can do quite a lot in its own right. + + + + + Make a new drop sink + + + + + Get or set the locations where a drop is allowed to occur (OR-ed together) + + + + + Gets or sets whether this sink allows model objects to be dragged from other lists. Defaults to true. + + + + + Gets or sets whether the ObjectListView should scroll when the user drags + something near to the top or bottom rows. Defaults to true. + + AutoScroll does not scroll horizontally. + + + + Gets the billboard overlay that will be used to display feedback + messages during a drag operation. + + Set this to null to stop the feedback. + + + + Get or set whether a drop can occur between items of the list + + + + + Get or set whether a drop can occur on the listview itself + + + + + Get or set whether a drop can occur on items in the list + + + + + Get or set whether a drop can occur on a subitem in the list + + + + + Gets or sets whether the drop sink should draw feedback onto the given list + during the drag operation. Defaults to true. + + If this is false, you will have to give the user feedback in some + other fashion, like cursor changes + + + + Get or set the index of the item that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get or set the color that will be used to provide drop feedback + + + + + Get whether the alt key was down during this drop event + + + + + Get whether any modifier key was down during this drop event + + + + + Get whether the control key was down during this drop event + + + + + Get whether the left mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the shift key was down during this drop event + + + + + Get or set the state of the keys during this drop event + + + + + Gets or sets whether the drop sink will automatically use cursors + based on the drop effect. By default, this is true. If this is + set to false, you must set the Cursor yourself. + + + + + Triggered when the sink needs to know if a drop can occur. + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + + + + + Triggered when the sink needs to know if a drop can occur + AND the source is an ObjectListView + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + AND the source is an ObjectListView + + + + + Cleanup the drop sink when the mouse has left the control or + the drag has finished. + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag is moving over this control. + + + + + + Trigger the Dropped events + + + + + + Trigger CanDrop + + + + + + Trigger Dropped + + + + + + Trigger ModelCanDrop + + + + + + Trigger ModelDropped + + + + + + Handle the timer tick event, which is sent when the listview should + scroll + + + + + When the mouse is at the given point, what should the target of the drop be? + + This method should update the DropTarget* members of the given arg block + + The mouse point, in client co-ordinates + + + + What sort of action is possible when the mouse is at the given point? + + + + + + + + + + Based solely on the state of the modifier keys, what drop operation should + be used? + + The drop operation that matches the state of the keys + + + + Should the listview be made to scroll when the mouse is at the given point? + + + + + + Update the state of our sink to reflect the information that + may have been written into the drop event args. + + + + + + Draw the feedback that shows that the background is the target + + + + + + + Draw the feedback that shows that an item (or a subitem) is the target + + + + + DropTargetItem and DropTargetSubItemIndex tells what is the target + + + + + Draw the feedback that shows the drop will occur before target + + + + + + + Draw the feedback that shows the drop will occur after target + + + + + + + Return a GraphicPath that is round corner rectangle. + + + + + + + + Calculate the target rectangle when the given item (and possible subitem) + is the target of the drop. + + + + + + + + Draw a "between items" line at the given co-ordinates + + + + + + + + + + This drop sink allows items within the same list to be rearranged, + as well as allowing items to be dropped from other lists. + + + + This class can only be used on plain ObjectListViews and FastObjectListViews. + The other flavours have no way to implement the insert operation that is required. + + + This class does not work with grouping. + + + This class works when the OLV is sorted, but it is up to the programmer + to decide what rearranging such lists "means". Example: if the control is sorting + students by academic grade, and the user drags a "Fail" grade student up amonst the "A+" + students, it is the responsibility of the programmer to makes the appropriate changes + to the model and redraw/rebuild the control so that the users action makes sense. + + + Users of this class should listen for the CanDrop event to decide + if models from another OLV can be moved to OLV under this sink. + + + + + + Create a RearrangingDropSink + + + + + Create a RearrangingDropSink + + + + + + Trigger OnModelCanDrop + + + + + + Trigger OnModelDropped + + + + + + Do the work of processing the dropped items + + + + + + When a drop sink needs to know if something can be dropped, or + to notify that a drop has occured, it uses an instance of this class. + + + + + Create a OlvDropEventArgs + + + + + Get the original drag-drop event args + + + + + Get the data object that is being dragged + + + + + Get the drop sink that originated this event + + + + + Get or set the index of the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the drag effect that should be used for this operation + + + + + Get or set if this event was handled. No further processing will be done for a handled event. + + + + + Get or set the feedback message for this operation + + + If this is not null, it will be displayed as a feedback message + during the drag. + + + + + Get the ObjectListView that is being dropped on + + + + + Get the location of the mouse (in target ListView co-ords) + + + + + Get the drop action indicated solely by the state of the modifier keys + + + + + These events are triggered when the drag source is an ObjectListView. + + + + + Create a ModelDropEventArgs + + + + + Gets the model objects that are being dragged. + + + + + Gets the ObjectListView that is the source of the dragged objects. + + + + + Get the model object that is being dropped upon. + + This is only value for TargetLocation == Item + + + + Refresh all the objects involved in the operation + + + + + A data transfer object that knows how to transform a list of model + objects into a text and HTML representation. + + + + + Create a data object from the selected objects in the given ObjectListView + + The source of the data object + + + + Create a data object which operates on the given model objects + in the given ObjectListView + + The source of the data object + The model objects to be put into the data object + + + + Gets or sets whether hidden columns will also be included in the text + and HTML representation. If this is false, only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. + + + + + Gets the ObjectListView that is being used as the source of the data + + + + + Gets the model objects that are to be placed in the data object + + + + + Put a text and HTML representation of our model objects + into the data object. + + + + + Create an exporter for the data contained in this object + + + + + + Make a HTML representation of our model objects + + + + + Convert the fragment of HTML into the Clipboards HTML format. + + The HTML format is found here http://msdn2.microsoft.com/en-us/library/aa767917.aspx + + The HTML to put onto the clipboard. It must be valid HTML! + A string that can be put onto the clipboard and will be recognized as HTML + + + + A FastDataListView virtualizes the display of data from a DataSource. It operates on + DataSets and DataTables in the same way as a DataListView, but does so much more efficiently. + + + + A FastDataListView still has to load all its data from the DataSource. If you have SQL statement + that returns 1 million rows, all 1 million rows will still need to read from the database. + However, once the rows are loaded, the FastDataListView will only build rows as they are displayed. + + + + + + + + + + + + 获取或设置在设置DataSource时是否自动生成列以显示列。 + + 必须在设置DataSource之前设置此设置。之后就没有效果了。 + + + + 获取或设置将在此列表视图中显示的VirtualListDataSource。 + + VirtualListDataSource应实现 , , + 或 . 以下是一些常见的对象类型 + + + + + + + + 绑定到列表容器时 (即，实现 接口, 比如 ) + 您还必须实现 属性，以便标识要显示的特定列表。您也可以设置 属性， + 即使当VirtualListDataSource引用列表时也是如此, 因为 还可以用于导航列表之间的关系. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + Create the DataSourceAdapter that this control will use. + + A DataSourceAdapter configured for this list + Subclasses should override this to create their + own specialized adapters + + + + Change the Unfreeze behaviour + + + + + A FastObjectListView trades function for speed. + + + On my mid-range laptop, this view builds a list of 10,000 objects in 0.1 seconds, + as opposed to a normal ObjectListView which takes 10-15 seconds. Lists of up to 50,000 items should be + able to be handled with sub-second response times even on low end machines. + + A FastObjectListView is implemented as a virtual list with many of the virtual modes limits (e.g. no sorting) + fixed through coding. There are some functions that simply cannot be provided. Specifically, a FastObjectListView cannot: + + use Tile view + show groups on XP + + + + + + + Make a FastObjectListView + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + This method preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code and performance is O(n) where n is the number of selected rows. + This method is not thread safe. + + + + + Move the given collection of objects to the given index. + + This operation only makes sense on non-grouped ObjectListViews. + + + + + + 删除任何排序并恢复到模型对象的给定顺序 + + To be really honest, Unsort() doesn't work on FastObjectListViews since + the original ordering of model objects is lost when Sort() is called. So this method + effectively just turns off sorting. + + + + 为FastObjectListView提供数据源 + + + This class isn't intended to be used directly, but it is left as a public + class just in case someone wants to subclass it. + + + + + Create a FastObjectListDataSource + + + + + + Get n'th object + + + + + + + How many items are in the data source + + + + + + Get the index of the given model + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Remove the given collection of models from this source. + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + Apply the given filters to this data source. One or both may be null. + + + + + + + Gets the full list of objects being used for this fast list. + This list is unfiltered. + + + + + Gets the list of objects from ObjectList which survive any installed filters. + + + + + Rebuild the map that remembers which model object is displayed at which line + + + + + Build our filtered list from our full list. + + + + + Concrete implementation of the ICluster interface. + + + + + Create a cluster + + The key for the cluster + + + + Return a string representation of this cluster + + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Return an indication of the ordering between this object and the given one + + + + + + + This class provides a useful base implemention of a clustering + strategy where the clusters are grouped around the value of a given column. + + + + + This field is the text that will be shown to the user when a cluster + key is null. It is exposed so it can be localized. + + + + + This field is the text that will be shown to the user when a cluster + key is empty (i.e. a string of zero length). It is exposed so it can be localized. + + + + + Gets or sets the format that will be used by default for clusters that only + contain 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + + + + Gets or sets the format that will be used by default for clusters that + contain 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + + + + Create a clustering strategy + + + + + Gets or sets the column upon which this strategy is operating + + + + + Gets or sets the format that will be used when the cluster + contains only 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatSingular will be used + + + + Gets or sets the format that will be used when the cluster + contains 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatPlural will be used + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Create a label that combines the string representation of the cluster + key with a format string that holds an "X [N items in cluster]" type layout. + + + + + + + + This class calculates clusters from the groups that the column uses. + + + + This is the default strategy for all non-date, filterable columns. + + + This class does not strictly mimic the groups created by the given column. + In particular, if the programmer changes the default grouping technique + by listening for grouping events, this class will not mimic that behaviour. + + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + This enum is used to indicate various portions of a datetime + + + + + Year + + + + + Month + + + + + Day of the month + + + + + Hour + + + + + Minute + + + + + Second + + + + + This class implements a strategy where the model objects are clustered + according to some portion of the datetime value in the configured column. + + To create a strategy that grouped people who were born in + the same month, you would create a strategy that extracted just + the month, and formatted it to show just the month's name. Like this: + + + someColumn.ClusteringStrategy = new DateTimeClusteringStrategy(DateTimePortion.Month, "MMMM"); + + + + + Create a strategy that clusters by month/year + + + + + Create a strategy that clusters around the given parts + + + + + + + Gets or sets the format string will will be used to create a user-presentable + version of the cluster key. + + The format should use the date/time format strings, as documented + in the Windows SDK. Both standard formats and custom format will work. + "D" - long date pattern + "MMMM, yyyy" - "January, 1999" + + + + Gets or sets the parts of the DateTime that will be extracted when + determining the clustering key for an object. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Convert the given date into a user presentable string + + + + + + + Instances of this class know how to build a Filter menu. + It is responsible for clustering the values in the target column, + build a menu that shows those clusters, and then constructing + a filter that will enact the users choices. + + + Almost all of the methods in this class are declared as "virtual protected" + so that subclasses can provide alternative behaviours. + + + + + Gets or sets the string that labels the Apply button. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Clear All menu item. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Filtering menu as a whole.. + Exposed so it can be localized. + + + + + Gets or sets the string that represents Select All values. + If this is set to null or empty, no Select All option will be included. + Exposed so it can be localized. + + + + + Gets or sets the image that will be placed next to the Clear Filtering menu item + + + + + Gets or sets the image that will be placed next to all "Apply" menu items on the filtering menu + + + + + Gets or sets whether null should be considered as a valid data value. + If this is true (the default), then a cluster will null as a key will be allow. + If this is false, object that return a cluster key of null will ignored. + + + + + Gets or sets the maximum number of objects that the clustering strategy + will consider. This should be large enough to collect all unique clusters, + but small enough to finish in a reasonable time. + + The default value is 10,000. This should be perfectly + acceptable for almost all lists. + + + + Create a Filter menu on the given tool tip for the given column in the given ObjectListView. + + This is the main entry point into this class. + + + + The strip that should be shown to the user + + + + Create a collection of clusters that should be presented to the user + + + + + + + + + Order the given list of clusters in the manner in which they should be presented to the user. + + + + + + + Do the work of making a menu that shows the clusters to the users + + + + + + + + Wrap a protected section around the real HandleItemChecked method, so that if + that method tries to change a "checkedness" of an item, we don't get a recursive + stack error. Effectively, this ensure that HandleItemChecked is only called + in response to a user action. + + + + + + + Handle a user-generated ItemCheck event + + + + + + + Handle any checking/unchecking of the Select All option, and keep + its checkedness in sync with everything else that is checked. + + + + + + + + Clear all the filters that are applied to the given column + + The column from which filters are to be removed + + + + Apply the selected values from the given list as a filter on the given column + + A list in which the checked items should be used as filters + The column for which a filter should be generated + + + + Interface for model-by-model filtering + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + Interface for whole list filtering + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Base class for model-by-model filters + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + This filter calls a given Predicate to decide if a model object should be included + + + + + Create a filter based on the given predicate + + The function that will filter objects + + + + Gets or sets the predicate used to filter model objects + + + + + Should the given model object be included? + + + + + + + A CompositeFilter joins several other filters together. + If there are no filters, all model objects are included + + + + + Create an empty filter + + + + + Create a composite filter from the given list of filters + + A list of filters + + + + Gets or sets the filters used by this composite + + + + + Get the sub filters that are text match filters + + + + + Decide whether or not the given model should be included by the filter + + + True if the object is included by the filter + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must satisfy all filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must only satisfy one of the filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter from the given filters + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + Instances of this class extract a value from the model object + and compare that value to a list of fixed values. The model + object is included if the extracted value is in the list + + If there is no delegate installed or there are + no values to match, no model objects will be matched + + + + Create a filter that will use the given delegate to extract values + + + + + + Create a filter that will extract values using the given delegate + and compare them to the values in the given list. + + + + + + + Gets or sets the delegate that will be used to extract values + from model objects + + + + + Gets or sets the list of values that the value extracted from + the model object must match in order to be included. + + + + + Should the given model object be included? + + + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Instances of this class match a property of a model objects against + a list of bit flags. The property should be an xor-ed collection + of bits flags. + + Both the property compared and the list of possible values + must be convertible to ulongs. + + + + Create an instance + + + + + + + Gets or sets the collection of values that will be matched. + These must be ulongs (or convertible to ulongs). + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Base class for whole list filters + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Instance of this class implement delegate based whole list filtering + + + + + A delegate that filters on a whole list + + + + + + + Create a ListFilter + + + + + + Gets or sets the delegate that will filter the list + + + + + Do the actual work of filtering + + + + + + + Filter the list so only the last N entries are displayed + + + + + Create a no-op tail filter + + + + + Create a filter that includes on the last N model objects + + + + + + Gets or sets the number of model objects that will be + returned from the tail of the list + + + + + Return the last N subset of the model objects + + + + + + + Instances of this class cluster model objects on the basis of a + property that holds an xor-ed collection of bit flags. + + + + + Create a clustering strategy that operates on the flags of the given enum + + + + + + Create a clustering strategy around the given collections of flags and their display labels. + There must be the same number of elements in both collections. + + The list of flags. + + + + + Gets the value that will be xor-ed to test for the presence of a particular value. + + + + + Gets the labels that will be used when the corresponding Value is XOR present in the data. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + A cluster is a like collection of objects that can be usefully filtered + as whole using the filtering UI provided by the ObjectListView. + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Implementation of this interface control the selecting of cluster keys + and how those clusters will be presented to the user + + + + + Gets or sets the column upon which this strategy will operate + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + If the returned value is an IEnumerable, the given model is considered + to belong to multiple clusters + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Instances of this class include only those rows of the listview + that match one or more given strings. + + This class can match strings by prefix, regex, or simple containment. + There are factory methods for each of these matching strategies. + + + + Create a text filter that will include rows where any cell matches + any of the given regex expressions. + + + + + Any string that is not a valid regex expression will be ignored. + + + + Create a text filter that includes rows where any cell begins with one of the given strings + + + + + + + + Create a text filter that includes rows where any cell contains any of the given strings. + + + + + + + + Create a TextFilter + + + + + + Create a TextFilter that finds the given string + + + + + + + Create a TextFilter that finds the given string using the given comparison + + + + + + + + Gets or sets which columns will be used for the comparisons? If this is null, all columns will be used + + + + + Gets or sets additional columns which will be used in the comparison. These will be used + in addition to either the Columns property or to all columns taken from the control. + + + + + Gets or sets the collection of strings that will be used for + contains matching. Setting this replaces all previous texts + of any kind. + + + + + Gets whether or not this filter has any search criteria + + + + + Gets or set the ObjectListView upon which this filter will work + + + You cannot really rebase a filter after it is created, so do not change this value. + It is included so that it can be set in an object initializer. + + + + + Gets or sets the collection of strings that will be used for + prefix matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + This is only used when doing Regex matching (obviously). + If this is not set specifically, the appropriate options are chosen to match the + StringComparison setting (culture invariant, case sensitive). + + + + + Gets or sets the collection of strings that will be used for + regex pattern matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets how the filter will match text + + + + + Loop over the columns that are being considering by the filter + + + + + + Do the actual work of filtering + + + + + + + Find all the ways in which this filter matches the given string. + + This is used by the renderer to decide which bits of + the string should be highlighted + + A list of character ranges indicating the matched substrings + + + + Is the given column one of the columns being used by this filter? + + + + + + + Base class for the various types of string matching that TextMatchFilter provides + + + + + Gets how the filter will match text + + + + + Gets the text filter to which this component belongs + + + + + Gets or sets the text that will be matched + + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + This component provides text contains matching strategy. + + + + + Create a text contains strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides text begins with matching strategy. + + + + + Create a text begins strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides regex matching strategy. + + + + + Creates a regex strategy + + + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + + + Gets or sets a compilex regular expression, based on our current Text and RegexOptions. + + + If Text fails to compile as a regular expression, this will return a Regex object + that will match all strings. + + + + + Gets whether or not our current regular expression is a valid regex + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This attribute is used to mark a property of a model + class that should be noticed by Generator class. + + + All the attributes of this class match their equivilent properties on OLVColumn. + + + + + Create a new OLVColumnAttribute + + + + + Create a new OLVColumnAttribute with the given title + + The title of the column + + + + + + + + + + + + + + + + + + + + + + + + + + + + + An array of IComparables that mark the cutoff points for values when + grouping on this column. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Properties marked with [OLVChildren] will be used as the children source in a TreeListView. + + + + + Properties marked with [OLVIgnore] will not have columns generated for them. + + + + + ColumnComparer is the workhorse for all comparison between two values of a particular column. + If the column has a specific comparer, use that to compare the values. Otherwise, do + a case insensitive string compare of the string representations of the values. + + This class inherits from both IComparer and its generic counterpart + so that it can be used on untyped and typed collections. + This is used by normal (non-virtual) ObjectListViews. Virtual lists use + ModelObjectComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column + + The column whose values will be compared + The ordering for column values + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column, and by a secondary column if the primary + column is equal. + + The column whose values will be compared + The ordering for column values + The column whose values will be compared for secondary sorting + The ordering for secondary column values + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare the actual values to be used for sorting + + The aspect extracted from the first row + The aspect extracted from the second row + An ordering indication: -1, 0, 1 + + + + This comparer sort list view groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + + + + Create a group comparer + + The ordering for column values + + + + Compare the two groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + group1 + group2 + An ordering indication: -1, 0, 1 + + + + This comparer can be used to sort a collection of model objects by a given column + + + This is used by virtual ObjectListViews. Non-virtual lists use + ColumnComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a model object comparer + + + + + + + Create a model object comparer with a secondary sorting column + + + + + + + + + Compare the two model objects + + + + + + + + Compare the actual values + + + + + + + + A helper class that translates DataSource events for an ObjectListView + + + + + Make a DataSourceAdapter + + + + + Finalize this object + + + + + Release all the resources used by this instance + + + + + Release all the resources used by this instance + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets the ObjectListView upon which this adaptor will operate + + + + + Gets or sets the currency manager which is handling our binding context + + + + + + + + + + + + + + + + + + + + + + + + + + + Our data source has changed. Figure out how to handle the new source + + + + + Our data source has changed. Figure out how to handle the new source + + + + + The data source for this control has changed. Reconfigure the control for the new source + + + + + Take the contents of the currently bound list and put them into the control + + + + + Create columns for the listview based on what properties are available in the data source + + + This method will create columns if there is not already a column displaying that property. + + + + + Decide if a new column should be added to the control to display + the given property + + + + + + + Configure the given column to show the given property. + The title and aspect name of the column are already filled in. + + + + + + + Generate aspect getters and putters for any columns that are missing them (and for which we have + enough information to actually generate a getter) + + + + + CurrencyManager ListChanged event handler. + Deals with fine-grained changes to list items. + + + It's actually difficult to deal with these changes in a fine-grained manner. + If our listview is grouped, then any change may make a new group appear or + an old group disappear. It is rarely enough to simply update the affected row. + + + + + + + Handle PropertyDescriptor* events + + + + + + Handle ItemMoved event + + + + + + Handle the ItemDeleted event + + + + + + Handle an ItemAdded event. + + + + + + Handle the Reset event + + + + + + Handle ItemChanged event. This is triggered when a single item + has changed, so just refresh that one item. + + + Even in this simple case, we should probably rebuild the list. + For example, the change could put the item into its own new group. + + + + The CurrencyManager calls this if the data source looks + different. We just reload everything. + + + + + CHECK: Do we need this if we are handle ListChanged metadata events? + + + + + Called by the CurrencyManager when the currently selected item + changes. We update the ListView selection so that we stay in sync + with any other controls bound to the same source. + + + + + + + Change the control's position (which is it's currently selected row) + to the nth row in the dataset + + The index of the row to be selected + + + + Handle the selection changing in our ListView. + We need to tell our currency manager about the new position. + + + + + + + Handle the frozenness of our ListView changing. + + + + + + + Handle a change to the BindingContext of our ListView. + + + + + + + These delegates are used to extract an aspect from a row object + + + + + These delegates are used to put a changed value back into a model object + + + + + These delegates can be used to convert an aspect value to a display string, + instead of using the default ToString() + + + + + These delegates are used to get the tooltip for a cell + + + + + These delegates are used to the state of the checkbox for a row object. + + + For reasons known only to someone in Microsoft, we can only set + a boolean on the ListViewItem to indicate it's "checked-ness", but when + we receive update events, we have to use a tristate CheckState. So we can + be told about an indeterminate state, but we can't set it ourselves. + + As of version 2.0, we can now return indeterminate state. + + + + + These delegates are used to get the state of the checkbox for a row object. + + + + + + + These delegates are used to put a changed check state back into a model object + + + + + These delegates are used to put a changed check state back into a model object + + + + + + + + These delegates are used to get the renderer for a particular cell + + + + + The callbacks for RightColumnClick events + + + + + This delegate will be used to own draw header column. + + + + + This delegate is called when a group has been created but not yet made + into a real ListViewGroup. The user can take this opportunity to fill + in lots of other details about the group. + + + + + These delegates are used to retrieve the object that is the key of the group to which the given row belongs. + + + + + These delegates are used to convert a group key into a title for the group + + + + + These delegates are used to get the tooltip for a column header + + + + + These delegates are used to fetch the image selector that should be used + to choose an image for this column. + + + + + These delegates are used to draw a cell + + + + + These delegates are used to fetch a row object for virtual lists + + + + + These delegates are used to format a listviewitem before it is added to the control. + + + + + These delegates can be used to return the array of texts that should be searched for text filtering + + + + + These delegates are used to sort the listview in some custom fashion + + + + + These delegates are used to order two strings. + x cannot be null. y can be null. + + + + + An ObjectListView is a much easier to use, and much more powerful, version of the ListView. + + + + An ObjectListView automatically populates a ListView control with information taken + from a given collection of objects. It can do this because each column is configured + to know which bit of the model object (the "aspect") it should be displaying. Columns similarly + understand how to sort the list based on their aspect, and how to construct groups + using their aspect. + + + Aspects are extracted by giving the name of a method to be called or a + property to be fetched. These names can be simple names or they can be dotted + to chain property access e.g. "Owner.Address.Postcode". + Aspects can also be extracted by installing a delegate. + + + An ObjectListView can show a "this list is empty" message when there is nothing to show in the list, + so that the user knows the control is supposed to be empty. + + + Right clicking on a column header should present a menu which can contain: + commands (sort, group, ungroup); filtering; and column selection. Whether these + parts of the menu appear is controlled by ShowCommandMenuOnRightClick, + ShowFilterMenuOnRightClick and SelectColumnsOnRightClick respectively. + + + The groups created by an ObjectListView can be configured to include other formatting + information, including a group icon, subtitle and task button. Using some undocumented + interfaces, these groups can even on virtual lists. + + + ObjectListView supports dragging rows to other places, including other application. + Special support is provide for drops from other ObjectListViews in the same application. + In many cases, an ObjectListView becomes a full drag source by setting to + true. Similarly, to accept drops, it is usually enough to set to true, + and then handle the and events (or the and + events, if you only want to handle drops from other ObjectListViews in your application). + + + For these classes to build correctly, the project must have references to these assemblies: + + + System + System.Data + System.Design + System.Drawing + System.Windows.Forms (obviously) + + + + + + How does a user indicate that they want to edit cells? + + + + + 列表将不支持编辑(同时F2按键无效) + + + + + 单击 单元格 将编辑值. + 选择该行，就像正常选择行一样。用户必须按F2键才能编辑主列。 + + + + + 双击子项或主列将编辑该单元格。 + F2键将编辑主列。 + + + + + 按F2键是编辑单元格的唯一方法。一旦主列被编辑， + 行中的其他单元格可以通过按Tab键进行编辑。 + + + + + 只需单击任意单元格即可编辑值，即使是主列也是如此。 + + + + + 这些值指定向用户显示列选择的方式 + + + + + 不会显示任何列选择 + + + + + 这些列将显示在主菜单中 + + + + + 这些列将显示在子菜单中 + + + + + 将显示一个模式对话框，允许用户选择列 + + + + + Triggered after a ObjectListView has been searched by the user typing into the list + + + + + Triggered after a ObjectListView has been sorted + + + + + Triggered before a ObjectListView is searched by the user typing into the list + + + Set Cancelled to true to prevent the searching from taking place. + Changing StringToFind or StartSearchFrom will change the subsequent search. + + + + + Triggered before a ObjectListView is sorted + + + Set Cancelled to true to prevent the sort from taking place. + Changing ColumnToSort or SortOrder will change the subsequent sort. + + + + + Triggered after a ObjectListView has created groups + + + + + Triggered before a ObjectListView begins to create groups + + + Set Groups to prevent the default group creation process + + + + + Triggered just before a ObjectListView creates groups + + + You can make changes to the groups, which have been created, before those + groups are created within the listview. + + + + + Triggered when a button in a cell is left clicked. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when a cell has finished being edited. + + + + + Triggered when a cell is about to finish being edited. + + If Cancel is already true, the user is cancelling the edit operation. + Set Cancel to true to prevent the value from the cell being written into the model. + You cannot prevent the editing from finishing within this event -- you need + the CellEditValidating event for that. + + + + Triggered when a cell is about to be edited. + + Set Cancel to true to prevent the cell being edited. + You can change the the Control to be something completely different. + + + + Triggered when a cell editor needs to be validated + + + If this event is cancelled, focus will remain on the cell editor. + + + + + Triggered when a cell is left clicked. + + + + + Triggered when the mouse is above a cell. + + + + + Triggered when a cell is right clicked. + + + + + This event is triggered when a cell needs a tool tip. + + + + + This event is triggered when a checkbox is checked/unchecked on a subitem + + + + + Triggered when a column header is right clicked. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + + + This event is triggered when the control needs to filter its collection of objects. + + + + + This event is triggered when a cell needs to be formatted. + + + + + This event is triggered when the frozeness of the control changes. + + + + + This event is triggered when a row needs to be formatted. + + + + + This event is triggered when a group is about to collapse or expand. + This can be cancelled to prevent the expansion. + + + + + This event is triggered when a group changes state. + + + + + This event is triggered when a header checkbox is changing value + + + + + This event is triggered when a header needs a tool tip. + + + + + Triggered when the "hot" item changes + + + + + Triggered when a hyperlink cell is clicked. + + + + + Triggered when the task text of a group is clicked. + + + + + Is the value in the given cell a hyperlink. + + + + + Some new objects are about to be added to an ObjectListView. + + + + + The contents of the ObjectListView has changed. + + + + + The contents of the ObjectListView is about to change via a SetObjects call + + + Set Cancelled to true to prevent the contents of the list changing. This does not work with virtual lists. + + + + + Some objects are about to be removed from an ObjectListView. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler, and when the source control + for the drag was an ObjectListView. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler and when the source control + for the drag was an ObjectListView. + + + + + This event is triggered once per user action that changes the selection state + of one or more rows. + + + + + This event is triggered when the contents of the ObjectListView has scrolled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Tell the world when a cell is about to be edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell has finished being edited. + + + + + 创建一个 ObjectListView + + + + + Dispose of any resources this instance has been using + + + + + + 获取鼠标左键是否在此时按下。 + + + + + 获取该程序是否在Vista或更高版本上运行 + + + + + 获取该程序是否在Win7或更高版本上运行 + + + + + Gets or sets how what smoothing mode will be applied to graphic operations. + + + + + Gets or sets how should text be renderered. + + + + + 获取或设置当组Key为Null时将用于标题组的字符串。将其公开以使其可以本地化。 + + + + + Convert the given enumerable into an ArrayList as efficiently as possible + + The source collection + If true, this method will always create a new + collection. + An ArrayList with the same contents as the given collection. + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Return the count of items in the given enumerable + + + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + Return whether or not the given enumerable is empty. A string is regarded as + an empty collection. + + + True if the given collection is null or empty + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Gets or sets whether all ObjectListViews will silently ignore missing aspect errors. + + + + By default, if an ObjectListView is asked to display an aspect + (i.e. a field/property/method) + that does not exist from a model, it displays an error message in that cell, since that + condition is normally a programming error. There are some use cases where + this is not an error -- in those cases, set this to true and ObjectListView will + simply display an empty cell. + + Be warned: if you set this to true, it can be very difficult to track down + typing mistakes or name changes in AspectNames. + + + + + Gets or sets whether the control will draw a rectangle in each cell showing the cell padding. + + + + This can help with debugging display problems from cell padding. + + As with all cell padding, this setting only takes effect when the control is owner drawn. + + + + + Gets the style that will be used by default to format disabled rows + + + + + Gets the style that will be used by default to format hot rows + + + + + Gets or sets an model filter that is combined with any column filtering that the end-user specifies. + + This is different from the ModelFilter property, since setting that will replace + any column filtering, whereas setting this will combine this filter with the column filtering + + + + Get or set all the columns that this control knows about. + Only those columns where IsVisible is true will be seen by the user. + + + + If you want to add new columns programmatically, add them to + AllColumns and then call RebuildColumns(). Normally, you do not have to + deal with this property directly. Just use the IDE. + + If you do add or remove columns from the AllColumns collection, + you have to call RebuildColumns() to make those changes take effect. + + + + + 获取或设置每隔一行的背景色 + + + + + 获取已设置的交替行背景色或默认颜色 + + + + + 此属性强制ObjectListView始终按给定列对项进行分组。 + + + + + 如果AlwaysGroupByColumn不为空，则此属性将用于确定如何对这些组进行排序。 + 如果此属性的值为SortOrder.None，则排序顺序将根据用户上次单击的标题切换。 + + + + + Give access to the image list that is actually being used by the control + + + Normally, it is preferable to use SmallImageList. Only use this property + if you know exactly what you are doing. + + + + + 获取或设置编辑单元格的方式 + + Columns can also be marked as editable. + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + 默认值为 true. + + + This is always treated as true when the control is NOT owner drawn. + + When this is false and the control is owner drawn, + ObjectListView will try to calculate the width of the cell's + actual contents, and then size the editing control to be just the right width. If this is true, + the whole width of the cell will be used, regardless of the cell's contents. + + Each column can have a different value for property. This value from the control is only + used when a column is not specified one way or another. + Regardless of this setting, developers can specify the exact size of the editing control + by listening for the CellEditStarting event. + + + + + Gets or sets the engine that will handle key presses during a cell edit operation. + Settings this to null will reset it to default value. + + + + + 获取当前用于编辑单元格的控件。 + + This will obviously be null if no cell is being edited. + + + + 获取或设置编辑控件左边缘或右边缘的单元格时Tab键的行为。 + 如果为False(默认值)，则按Tab键将换行到同一行的另一侧。 + 如果为True，编辑最右边的单元格时按Tab键将前进到下一行， + 编辑最左边的单元格时按Shift-Tab组合键将更改为上一行。 + + + + + 获取或设置编辑单元格时Enter键的行为。 + 如果为False(默认值)，则按Enter键将简单地完成编辑操作。 + 如果为True，则Enter将完成编辑操作，并在当前单元格下方的单元格上启动新的编辑操作，在位于底部单元格时换行到下一行的顶部。 + + + + + 获取显示单元格提示的工具提示控件 + + + + + 获取或设置该项的每个单元格周围将留空的像素数。单元格内容在考虑填充后对齐。 + + + Each value of the given rectangle will be treated as an inset from + the corresponding side. The width of the rectangle is the padding for the + right cell edge. The height of the rectangle is the padding for the bottom + cell edge. + + + So, this.olv1.CellPadding = new Rectangle(1, 2, 3, 4); will leave one pixel + of space to the left of the cell, 2 pixels at the top, 3 pixels of space + on the right edge, and 4 pixels of space at the bottom of each cell. + + + This setting only takes effect when the control is owner drawn. + + This setting only affects the contents of the cell. The background is + not affected. + If you set this to a foolish value, your control will appear to be empty. + + + + + 获取或设置默认情况下单元格垂直对齐的方式。 + + This setting only takes effect when the control is owner drawn. It will only be noticable + when RowHeight has been set such that there is some vertical space in each row. + + + + Should this list show checkboxes? + + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + .NET's CheckedItems property is not helpful. It is just a short-hand for + iterating through the list looking for items that are checked. + + + The performance of the get method is O(n), where n is the number of items + in the control. The performance of the set method is + O(n + m) where m is the number of objects being checked. Be careful on long lists. + + + + + + 获取或设置可枚举对象中的选中对象。 + + + Useful for checking all objects in the list. + + + this.olv1.CheckedObjectsEnumerable = this.olv1.Objects; + + + + + Gets Columns for this list. We hide the original so we can associate + a specialised editor with it. + + + + + 获取/设置当列表切换到TileView(平铺视图)时应使用的列的列表。 + + + + + 按向用户显示的顺序返回可见列 + + + + + 获取显示列表的控件区域，减去任何标题控件 + + + + + 获取或设置当用户按Ctrl+C组合键时是否应将选定行复制到剪贴板 + + + + + 获取或设置按Ctrl+C键复制到剪贴板功能是否应使用安装的DragSource创建放置到剪贴板上的数据对象。 + + This is normally what is desired, unless a custom DragSource is installed + that does some very specialized drag-drop behaviour. + + + + Gets the list of decorations that will be drawn the ListView + + + + Do not modify the contents of this list directly. Use the AddDecoration() and RemoveDecoration() methods. + + + A decoration scrolls with the list contents. An overlay is fixed in place. + + + + + + 所有者绘制时，此渲染器将绘制未指定特定渲染器的列 + + 如果尝试将其设置为NULL，则它将恢复为HighlightTextRenende + + + + 获取用于绘制给定单元格的渲染器。 + + The row model for the row + The column to be drawn + The renderer used for drawing a cell. Must not return null. + + + + 获取或设置将应用于禁用项的样式。 + + If this is not set explicitly, will be used. + + + + 获取或设置已禁用的模型对象的列表。无法选择或激活已禁用的对象。 + + + + + 判断此给定模型对象是否已禁用 + + + + + + + 禁用给定的模型对象。禁用的对象无法选择或激活。 + + Must not be null + + + + 禁用所有给定的模型对象 + + + + + + 启用给定的模型对象，以便可以再次选择并激活它。 + + Must not be null + + + + 启用所有给定的模型对象 + + + + + + 忽略所有禁用的对象。这不会触发重绘或重建 + + + + + Gets or sets the object that controls how drags start from this control + + + + + Gets or sets the object that controls how drops are accepted and processed + by this ListView. + + + + If the given sink is an instance of SimpleDropSink, then events from the drop sink + will be automatically forwarded to the ObjectListView (which means that handlers + for those event can be configured within the IDE). + + If this is set to null, the control will not accept drops. + + + + + This registry decides what control should be used to edit what cells, based + on the type of the value in the cell. + + + All instances of ObjectListView share the same editor registry. + + + + 获取或设置在此列表视图中没有项时应显示的文本。 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 获取或设置绘制列表空消息时应使用的字体 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 返回“列表为空”消息的字体或合理的默认值 + + + + + Gets or sets the overlay responsible for drawing the List Empty msg. + + + + + 获取在筛选中幸存下来的对象的集合。 + + + + This collection is the result of filtering the current list of objects. + It is not a snapshot of the filtered list that was last used to build the control. + + + Normal warnings apply when using this with virtual lists. It will work, but it + may take a while. + + + + + + 获取或设置将用于生成筛选器菜单的策略对象 + + 如果为NULL，则不会生成筛选器菜单。 + + + + 获取或设置具有键盘焦点的行 + + + + Setting an object to be focused does *not* select it. If you want to select and focus a row, + use . + + + This property is not generally used and is only useful in specialized situations. + + + + + + 隐藏Groups集合，使其在“属性”网格中不可见。 + + + + + 获取或设置分组使用的ImageList + + 如果未设置此选项，则分组标题将不会显示任何图像。 + + + + 获取在组为空或包含多个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 + + + "[{0} [{1} 项]" + + + + 返回this.GroupWithItemCountFormat或合理的默认值 + + + + + 获取在组仅包含单个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 (总是1) + + + "[{0} [{1} 项]" + + + + 获取GroupWithItemCountSingularFormat或合理的默认值 + + + + + 获取或设置此ObjectListView中的组是否应可折叠。 + + + 此特性只支持Vista或之后的系统. + + + + + 获取当前列表是否存在当列表为空时显示的文本 + + + + + 获取是否有要绘制的叠加层 + + + + + 获取ListView的列头控件 + + + + + 获取或设置列标题文本的绘制字体 + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + 获取或设置将用于绘制列表视图的列标题的样式 + + + + 仅当HeaderUsesThemes为false时才使用此选项。 + + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + + + 获取或设置标题的最大高度。-1表示没有最大值。 + + + + + 获取或设置标题的最小高度。-1表示没有最小值。 + + + + + 获取或设置是否严格按照操作系统的主题绘制标题。 + + + + 如果设置为true，则列头将完全由系统呈现，不需要ObjectListViews的任何特殊处理。 + 页眉中将没有图像、没有过滤器指示符、没有文字换行、没有页眉样式、没有复选框。 + + 如果将其设置为False，ObjectListView将以其认为最好的方式呈现标题。 + 如果不需要特殊功能，则ObjectListView会将渲染委托给操作系统。 + 否则，ObjectListView将根据配置设置绘制标题。 + + + 没有主题的效果会因操作系统不同而不同。至少，分类指示器不会是标准的。 + + + + + + 获取或设置列头标题中的文本是否自动换行。 + + + 将在单词之间应用换行符。过长的单词仍将被省略。 + + 与所有使列头看起来不同的设置一样，HeaderUsesThemes必须设置为false，否则操作系统将负责绘制列头，并且不允许自动换行文本。 + + + + + + 获取显示列标题提示的工具提示 + + + + + 获取鼠标当前所在行的索引。 + + + + + 获取鼠标当前所在列的索引 + + + + + 获取鼠标当前所在的项/子项的一部分 + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + 获取鼠标所在的组。 + + + + + 处于“热”状态的项的索引，即在光标下方。-1表示没有项目。 + + + + + 获取和设置对游标下的行应用哪种格式 + + + + 这仅在UseHotItem为true时生效。 + + 如果样式具有叠加层，则必须对其进行设置。*之前* 将其分配给此属性。之后添加它将被忽略。 + + + + + 获取已安装的热点项样式或合理的默认值。 + + + + + 获取和设置应将哪种格式应用于超链接 + + + + + 获取和设置所选行的背景应该使用什么颜色 + + + + + 返回应用于选定行的背景颜色或合理的默认值 + + + + + 获取和设置所选行的字体应该使用什么颜色 + + + + + 返回应用于选定行的字体颜色或合理的默认值 + + + + + 使用 SelectedBackColor 代替 + + + + + 使用 SelectedBackColorOrDefault 代替 + + + + + 使用 SelectedForeColor 代替 + + + + + 使用 SelectedForeColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedBackColor 代替 + + + + + 使用 UnfocusedSelectedBackColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedForeColor 代替 + + + + + 使用 UnfocusedSelectedForeColorOrDefault 代替 + + + + + 获取或设置是否应将隐藏列包括在复制或拖动到其他应用程序的行的文本表示形式中。 + 如果为False(默认值)，则仅包括可见列。 + + + + + 获取或设置复制行时，列标题是否在文本中。 + 如果为False(默认值)，在文本中将不会显示列标题。 + + + + + 如果当前正在进行单元格编辑操作，则返回TRUE + + + + + 如果在开发环境中使用ObjectListView，则返回true。 + + + + + 获取当前列表是否正在筛选其内容 + + + + + 当用户在列表中键入内容时，是否应该搜索当前排序列中的值以查找匹配项？ + 如果为False，则无论排序列是什么，都将始终使用主列。 + + When this is true, the behavior is like that of ITunes. + + + + 获取或设置此控件是否将使用SimpleDropSink接收拖动 + + + + 此设置将替换任何以前的DropSink。 + + + 将其设置为true后，SimpleDropSink仍需要配置为说明它何时可以接受拖动， + 以及在拖动某些内容时应该执行什么操作。需要执行这些操作使此属性几乎毫无用处 :( + + + + + + 获取或设置此控件是否将使用SimpleDragSource来启动拖动 + + 此设置将替换之前的任何DragSource + + + + 隐藏Items集合，使其在“属性”网格中不可见。 + + + + + 当列表中的项目处于非详细视图中时，此渲染器会绘制项目。在详细信息视图中，负责个体列的呈现器。 + + + + + 获取或设置最后一次排序的列 + + 这是PrimarySortColumn的别名 + + + + 获取或设置最后一次排序的方向 + + 这是 PrimarySortOrder的别名 + + + + 获取或设置应用于整个对象列表的筛选器。 + + + 列表将立即更新以反映此筛选器。 + + + + + 获取或设置应用于列表中每个模型对象的筛选器 + + + 您可能需要考虑使用 而不是此属性， + 因为AdditionalFilter在运行时与列筛选相结合。 + 设置此属性只是替换用户可能已给出的任何列筛选器。 + + The list is updated immediately to reflect this filter. + + + + + + Gets the hit test info last time the mouse was moved. + + Useful for hot item processing. + + + + 获取或设置列表显示的组列表。 + + + 此属性与.NET Groups属性的工作方式不同，应将其视为只读属性。 + 对列表所做的更改不会反映在ListView本身中。 + 在此列表中添加或删除组是没有意义的，这样的修改不会起到任何作用。 + 要执行此类操作，必须侦听BeforeCreatingGroups或AboutToCreateGroups事件， + 并更改这些事件中的组列表。 + + + + + 获取或设置折叠的OLVGroups的集合。 + + + + + Gets or sets whether the user wants to owner draw the header control + themselves. If this is false (the default), ObjectListView will use + custom drawing to render the header, if needed. + + + If you listen for the DrawColumnHeader event, you need to set this to true, + otherwise your event handler will not be called. + + + + + 获取/设置此列表将显示的对象集合 + + + + 设置此属性后，控件的内容将立即更新。 + + 如果可能，此方法将保留所选内容。使用 if + 如果您不想保留所选内容，请执行以下操作。 + 保留选择是该代码中最慢的部分，性能为O(N)，其中n是选定的行数。 + 此方法不是线程安全的。 + 该属性确实适用于虚拟列表：设置是没有问题的，但如果您尝试获取它， + 并且列表有1000万个对象，则可能需要一些时间才能返回。 + 此集合未经过筛选。使用 只访问那些在任何已安装的筛选器中幸存下来的对象。 + + + + + 获取当前控件所有对象组成的列表 + + + + + 获取创建群集时将考虑的对象集合。 + (用于生成类似Excel的列筛选器) + + + + + 获取或设置将在ListView顶部绘制的图像 + + + + + 获取或设置将在ListView顶部绘制的文本 + + + + + 获取或设置所有覆盖图的透明度。0表示完全透明，255表示完全不透明。 + + + 这已经过时了，请在每个覆盖上使用Transparency。 + + + + + 获取将在ListView顶部绘制的覆盖列表 + + + You can add new overlays and remove overlays that you have added, but + don't mess with the overlays that you didn't create. + + + + + Gets or sets whether the ObjectListView will be owner drawn. Defaults to true. + + + + When this is true, all of ObjectListView's neat features are available. + + We have to reimplement this property, even though we just call the base + property, in order to change the [DefaultValue] to true. + + + + + + 获取或设置主复选框是否在列表重新生成和筛选操作中保持其值。 + + + + 此属性仅在未显式设置CheckStateGetter/Putter时才有用。 + 如果您使用CheckStateGetter/Putter，那么这些方法已经持久化了行的检查性。 + + 此默认值为true。如果为False，则在重新生成或筛选列表时，复选框将丢失其值。 + 如果在虚拟列表中将其设置为false，则必须安装CheckStateGetter/Putters。 + + + + + 获取或设置记住模型对象的复选框状态的字典 + + 当PersistentCheckBoxs值为TRUE时，此选项用于虚拟列表. + + + + 获取或设置最后一次排序的列 + + + + + 获取或设置最后一次排序的方向 + + + + + 获取或设置不可编辑复选框是否绘制为禁用。默认是false。 + + + 这仅在所有者描述模式(owner drawn mode)下有效。 + + + + + 以像素为单位指定控件中每行的高度。 + + 列表视图中的行高通常由字体大小和小图像列表大小决定。 + 此设置允许覆盖该计算(原因是：您仍然不能将行高设置为小于控件中使用的字体的行高)。 + 将其设置为-1表示使用正常计算方法。 + 此功能是体验功能！如果您使用此功能，您的程序可能会发生意想不到的事情。 + + + + + 获取每行有多少像素高 + + + + + 获取此控件的每页上显示多少行 + + + + + 获取/设置将用于解析排序时相等的比较的列(第二排序列)。 + + 此设置没有用户界面。它必须以编程方式设置。 + + + + 获取或设置当使用Second darySortColumn时，它将以什么顺序比较结果 + + + + + 获取或设置当用户按Ctrl+A组合键时是否应选择所有行 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许用户选择视图中将显示哪些列 + + 这只是SelectColumnsOnRightClickBehaviour的兼容性包装属性. + + + + 获取或设置当右键单击标题时用户如何能够选择列 + + + + + 当列选择菜单打开时，是否应在选择项目后保持打开状态？保持打开状态允许用户一次打开或关闭多个列。 + + SelectColumnsOnRightClickBehaviour设置为InlineMenu时才有效。当行为设置为SubMenu菜单时，该选项不起作用。 + + + + 获取或设置选定列 + + + + 如果TintSortColumn为true，则排序列将自动成为选定列。 + + + 色调的颜色由SelectedColumnTint控制。 + + + + + + Gets or sets the decoration that will be drawn on all selected rows + + + + + 获取或设置应该使用什么颜色来给选定的列着色 + + + 色调颜色必须是Alpha可混合的，因此如果给定的颜色是纯色(即Alpha=255)，则会将其更改为具有合理的Alpha值。 + + + + + 获取或设置当前选定行的索引。 + 获取索引时，如果没有选择任何行，或者选择了多个行，则返回-1。 + + + + + 获取或设置当前选定的ListViewItem。如果未选择任何行，或者选择了多个行，则返回NULL。 + + + + + 如果只选择了一行，则从当前选定的行获取模型对象。 + 如果未选择任何行，或选择了多个行，则返回NULL。 + 设置时，这将选择显示给定模型对象的行，并将焦点放在该行上，取消选择所有其他行。 + + + + + 从当前选定的行中获取模型对象。 + 如果未选中任何行，则返回的列表为空。 + 设置此值时，请选择显示给定模型对象的行，取消选择所有其他行。 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许他们选择要在列表视图上执行的常见任务 + + + + + 获取或设置当右键单击标题控件时，此ObjectListView是否像筛选菜单一样显示表格 + + + + + 获取或设置是否应按组显示其项目 + + + + + 列表视图是否应该在列标题中显示位图以显示排序方向 + + + The only reason for not wanting to have sort indicators is that, on pre-XP versions of + Windows, having sort indicators required the ListView to have a small image list, and + as soon as you give a ListView a SmallImageList, the text of column 0 is bumped 16 + pixels to the right, even if you never used an image. + + + + + 列表视图是否应该显示子项上的图像 + + + 虚拟列表必须是所有者绘制的，才能在子项上显示图像 + + + + + 此属性控制分组标签是否显示该分组项目数量 + + + 后缀的格式由GroupWithItemCountFormat/GroupWithItemCountSingularFormat属性控制 + + + + + 获取或设置控件是在所有视图中显示列标题(True)，还是仅在详细信息视图中显示列标题(False) + + + + 此属性工作不正常。JPP 2010/04/06。 + 如果它是在创建控件之前设置的，则可以正常工作。 + 但是，如果在创建控件后将其关闭，则控件将丢失其复选框(奇怪！) + + + 要在创建控件后更改此设置，事情会很复杂。 + 如果它是关闭的，而我们想要打开它，我们必须更改视图，标题就会出现。 + 如果它当前处于打开状态，而我们想要将其关闭，则必须更改视图并重新创建控制柄。 + 重新创建句柄是一个问题，因为它会使我们的复选框样式消失。 + + + 该属性不能工作在 Win XP 系统. + + + + + 重写SmallImageList属性，以便我们可以正确地隐藏其操作。 + + 如果使用RowHeight属性指定行高，则必须在设置/更改RowHeight之前完全初始化SmallImageList。 + 如果在设置行高之后将新图像添加到图像列表，则必须再次将图像列表分配给控件。像这样简单的事情会奏效的： + listView1.SmallImageList = listView1.SmallImageList; + + + + + 返回小图像列表中图像的大小或合理的默认值 + + + + + 当列表视图分组时，项是否应该按主列排序？如果为False，则项目将按分组时的同一列进行排序。 + + + + + 当列表视图分组时，一个组的末尾和下一个组的开头之间应该有多少像素 + + + + + 排序列是否应该显示轻微的色调？ + + + + + 获取或设置是否使用三态复选框？ + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + 否则，用户在选中和取消选中之间交替单击。 + 当此设置为False时，CheckStateGetter仍可以返回不确定。 + + + + + 获取或设置列表顶部项目的索引 + + + + 此属性仅在列表视图处于详细信息视图中且不显示组时才起作用。 + + + 显示组时不起作用的原因是，当启用组时，无论滚动位置如何， + Windows msg LVM_GETTOPINDEX总是返回0。 + + + + + + 获取或设置将鼠标移到标题上是否会触发CellOver事件。 + 默认为true。 + + + 将鼠标移动到标题上之前不会触发CellOver事件，因为Header被视为单独的控件。 + 如果此行为更改导致您的应用程序出现问题，请将其设置为False。 + 如果您想知道鼠标何时在标题上移动，请将此属性设置为true(默认值)。 + + + + + 通过拖动分隔线调整列的大小时，是否应在每次鼠标移动时调整填充空格的列的大小？ + 如果为False，则释放鼠标时将更新填充栏。 + + + + 如果空间填充列位于正在调整大小的列的左侧，这看起来会很奇怪：该列的右边缘将被拖动，但由于空间填充列正在收缩，其左边缘将会移动。 + + 这是合乎逻辑的行为--只是看起来不对。 + + + 考虑到上述行为，如果空间填充列不是最右边的列，最好关闭该属性。 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的背景 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的背景的颜色 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的字体颜色。 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的字体颜色 + + + + + 获取或设置列表是否每隔一行提供不同的背景色？默认值为false。 + + 交替行的颜色由AlternateRowBackColor提供。 + 在.NET中，列表视图在非整行选择模式下有一个“功能”，在这种模式下，所选行不会使用正确的背景色绘制。 + + + + 是否应该为控件中的每个单元格调用FormatCell事件？ + + + 在许多情况下，不执行单元格级格式设置。 + 如果除非需要，ObjectListView不会为每个单元格触发Format Cell事件，则它的运行速度会稍快一些。 + 因此，默认情况下，它不会为每个单元格引发事件。 + + ObjectListView*确实*在每次重新生成行时引发FormatRow事件。各行可以决定是否对行中的每个单元格引发FormatCell事件。 + + + 无论此设置如何，只有当ObjectListView处于详细视图中时才会引发FormatCell事件。 + + + + + 所选行是否应使用非标准前景色和背景色绘制？ + + V2.9不再需要此属性 + + + + 获取或设置此ObjectListView是否将使用与Vista资源管理器相同的热项和选择机制。 + + + + 此属性有许多缺陷： + + 这仅适用于Vista及更高版本 + 它不能很好地与AlternateRowBackColors配合使用。 + 它不能很好地与HotItemStyles配合使用。 + 如果FullRowSelect为false，这看起来有点傻。 + 当列表是所有者绘制的时，它根本不起作用(因为所有的绘制都是由渲染器完成的)。 + 因此，它不能与TreeListView一起工作，因为它们“必须”是所有者绘制的。你仍然可以设置它，但它不会生效。 + + 但如果你一定要看起来像Vista/Win7，这是你的权限。如果这项设置搞砸了其他事情，请不要抱怨。 + + + 当此属性设置为True时，ObjectListView将不是所有者描述的。 + 这将禁用ObjectListView的许多漂亮的基于绘图的功能。 + + + + + + 获取或设置列表是否应启用筛选 + + + + + 获取或设置列表是否应将指示符放入列的标题中，以表明它正在筛选该列 + + 如果将其设置为true，HeaderUsesThemes将自动设置为false，因为我们只能在不使用主题标题时绘制筛选器指示器。 + + + + 鼠标下方的控件(复选框或按钮)是否应该被绘制为“Hot” + + + 如果为False，则当鼠标悬停在控件上时，控件的绘制方式不会有所不同。 + + 如果为False，且UseHotItem和UseHyperLinks为False，则ObjectListView可以跳过鼠标移动的某些处理。这使得鼠标移动处理几乎不使用CPU。 + + + + + + 光标下的项是否应以特殊方式设置格式？ + + + + + 获取或设置此列表视图是否应在单元格中显示超链接。 + + + + + 此控件是否应显示覆盖(Overlays) + + 覆盖(Overlays)在默认情况下是启用的，只有在它们在您的开发环境中造成问题时才需要禁用。 + + + + 是否应将此控件配置为在子项上显示复选框？ + + 如果将其设置为True，则将为该控件提供一个SmallImageList(如果它还没有一个SmallImageList)。 + 此外，如果它是一个虚拟列表，它将被设置为所有者描述的，因为虚拟列表不能在没有所有者描述的情况下绘制复选框。 + + + + 获取或设置ObjectListView是否将使用类似Vista的半透明选择机制。 + + + + 与UseExplorerTheme不同的是，这个类似Vista的方案可以在XP上运行，并且既适用于所有者描述的列表，也适用于非所有者描述的列表。 + + + 这将替换任何已安装的SelectedRowDecory。 + + + 如果您不喜欢用于选择的颜色，请忽略此属性， + 只需创建您自己的RowBorderDecory并将其分配给SelectedRowDecory， + 就像此属性设置器所做的那样。 + + + + + + 获取或设置ObjectListView是否将使用类似于Vista的半透明热行突出显示机制。 + + + + 设置此项将替换任何已安装的HotItemStyle。 + + + 如果您不喜欢热项目使用的颜色，请忽略此属性， + 只需创建您自己的HotItemStyle，填充所需的值， + 并将其分配给HotItemStyle属性，就像此属性设置器所做的那样。 + + + + + + 获取/设置此列表视图正在使用的视图样式 + + 切换到平铺(Tile)或详细信息(Details)视图会安装适合该视图的列。令人困惑的是，在平铺视图中，每列都显示为一行信息。 + + + + 此委托仅将对象的检查性作为布尔值获取。 + + 如果您永远不想担心不确定状态(这是相当常见的)，请使用此选项。 + + 这是CheckStateGetter属性的便捷包装。 + + + + + + This delegate sets the checkedness of an object as a boolean only. It must return + true or false indicating if the object was checked or not. + + Use this if you never want to worry about the + Indeterminate state (which is fairly common). + + This is a convenience wrapper around the CheckStatePutter property. + + + + + + 获取此列表视图是否能够显示组 + + + + + 获取或设置ObjectListView是否可以依赖正在引发的Application.Idle事件。 + + 在某些主机环境中(例如，在VisualStudio和Office中作为扩展运行时)，从不引发Application.Idle事件。 + 如果不会引发Idle事件，则将其设置为False，ObjectListView将自行引发这些事件。 + + + + + This delegate fetches the renderer for a particular cell. + + + + If this returns null (or is not installed), the renderer for the column will be used. + If the column renderer is null, then will be used. + + + This is called every time any cell is drawn. It must be efficient! + + + + + + This delegate is called when the list wants to show a tooltip for a particular cell. + The delegate should return the text to display, or null to use the default behavior + (which is to show the full text of truncated cell values). + + + Displaying the full text of truncated cell values only work for FullRowSelect listviews. + This is MS's behavior, not mine. Don't complain to me :) + + + + + 保存是否选中模型的属性(或字段)的名称。 + + + 该属性是可修改的。它必须具有bool(或bool？)返回类型。如果TriStateCheckBooks为真)。 + 设置此属性将替换任何已安装的CheckStateGetter或CheckStatePutter。 + 相反，稍后设置CheckStateGetter或CheckStatePutter属性将优先于此属性的行为。 + + + + + 只要ObjectListView需要知道与给定模型对象关联的行的检查状态，就会调用此委托。 + + + .NET has no support for indeterminate values, but as of v2.0, this class allows + indeterminate values. + + + + + This delegate will be called whenever the user tries to change the check state of a row. + The delegate should return the state that was actually set, which may be different + to the state given. + + + + + 此委托可用于以自定义方式对表进行排序。 + + + + 委托必须在ObjectListView上安装ListViewItemSorter。 + 安装ItemSorter会执行对ListViewItems进行排序的实际工作。 + 有关ItemSorter必须执行的操作的示例，请参见代码中的ColumnCompeller。 + + + 请勿在VirtualObjectListView上安装CustomSorter。改为重写IVirtualListDataSource的SortObjects()方法。 + + + + + + This delegate is called when the list wants to show a tooltip for a particular header. + The delegate should return the text to display, or null to use the default behavior + (which is to not show any tooltip). + + + Installing a HeaderToolTipGetter takes precedence over any text in OLVColumn.ToolTipText. + + + + + This delegate can be used to format a OLVListItem before it is added to the control. + + + The model object for the row can be found through the RowObject property of the OLVListItem object. + All subitems normally have the same style as list item, so setting the forecolor on one + subitem changes the forecolor of all subitems. + To allow subitems to have different attributes, do this: + myListViewItem.UseItemStyleForSubItems = false;. + + If UseAlternatingBackColors is true, the backcolor of the listitem will be calculated + by the control and cannot be controlled by the RowFormatter delegate. + In general, trying to use a RowFormatter + when UseAlternatingBackColors is true does not work well. + As it says in the summary, this is called before the item is added to the control. + Many properties of the OLVListItem itself are not available at that point, including: + Index, Selected, Focused, Bounds, Checked, DisplayIndex. + + + + + 将给定的模型对象添加到此控件。 + + 要显示的模型对象 + See AddObjects() for more details + + + + 将给定的模型对象集合添加到此控件。 + + 要显示的模型对象集合 + + 如果排序处于活动状态(即，如果PrimarySortColumn不为空)，则添加的对象将出现在其正确的排序位置。否则，它们将出现在列表的末尾。 + 不执行任何检查以查看是否有任何对象已在ListView中。 + 空对象将被静默忽略。 + + + + + 将列的大小调整到页眉宽度和数据的最大值。 + + + + + 设置任何自动初始化的列宽(宽度为0或-1的列将分别调整为其内容或标题的宽度)。 + + + 显然，这只会起作用一次。一旦运行，列宽将更改为其他值(不是0或-1)，因此第二次运行时不会执行任何操作。 + 若要强制所有列更改其大小，请使用 。 + + + + + 根据最后一个排序列或第一列(如果没有最后一个排序列)将视图项组织到组中 + + + + + 根据给定列将视图项组织成组 + + + + 如果AlwaysGroupByColumn属性不为Null，则列表视图项将按该列组织，并且将忽略‘Column’参数。 + + 此方法触发排序事件：BeforeSorting和AfterSorting。 + + 其值应用于排序的列。 + + + + + 根据给定列将视图项组织成组 + + 将使用哪一列进行分组 + 组将使用什么顺序 + 其值应用于排序的列。不能为空 + 列中值的排序顺序 + 当‘column’中的值相等时，请使用此列提供的值 + 次级值将如何排序 + 此方法不会触发排序事件。使用BuildGroups()执行此操作 + + + + 收集并返回影响组创建的所有变量 + + + + + + Make a list of groups that should be shown according to the given parameters + + + The list of groups to be created + This should not change the state of the control. It is possible that the + groups created will not be used. They may simply be discarded. + + + + 生成/重新生成列表中的所有列表视图项，尽可能多地保留状态 + + + + + 生成/重新生成列表中的所有列表视图项 + + If this is true, the control will try to preserve the selection, + focused item, and the scroll position (see Remarks) + + + + Use this method in situations were the contents of the list is basically the same + as previously. + + + + + + 清除此列表可能一直在使用的所有缓存信息 + + + + + Apply all required extended styles to our control. + + + + Whenever .NET code sets an extended style, it erases all other extended styles + that it doesn't use. So, we have to explicit reapply the styles that we have + added. + + + Normally, we would override CreateParms property and update + the ExStyle member, but ListView seems to ignore all ExStyles that + it doesn't already know about. Worse, when we set the LVS_EX_HEADERINALLVIEWS + value, bad things happen (the control crashes!). + + + + + + Give the listview a reasonable size of its tiles, based on the number of lines of + information that each tile is going to display. + + + + + Rebuild this list for the given view + + + + + + 移除所有对象(线程安全) + + This method can safely be called from background threads. + + + + 重置已访问其URL的内存 + + + + + 将选定行的文本和HTML表示复制到剪贴板上。 + + Be careful when using this with virtual lists. If the user has selected + 10,000,000 rows, this method will faithfully try to copy all of them to the clipboard. + From the user's point of view, your program will appear to have hung. + + + + 将给定对象的文本和HTML表示复制到剪贴板上。 + + + + + 将所有对象的文本和HTML表示复制到剪贴板上。 + + + + + 返回给定对象的html表示形式 + + + + + 取消选择列表视图中的所有行 + + + + + 返回紧跟在给定项后面的ListViewItem。 + 如果给定项为空，则返回列表中的第一个项。 + 如果给定项是最后一项，则返回NULL。 + + The item that is before the item that is returned, or null + A ListViewItem + + + + 按向用户显示的顺序返回最后一项。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + 按向用户显示的顺序返回第n项(从0开始)。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回给定listviewitem索引的显示索引。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回紧接在给定项之前出现的ListViewItem。 + 如果给定项为空，则返回列表中的最后一项。 + 如果给定项是第一项，则返回NULL。 + + The item that is before the item that is returned + A ListViewItem + + + + 在给定位置之前插入给定的对象集合 + + Where to insert the objects + The objects to be inserted + + + This operation only makes sense of non-sorted, non-grouped + lists, since any subsequent sort/group operation will rearrange + the list. + + This method only works on ObjectListViews and FastObjectListViews. + + + + + 如果选择了表示给定模型的行，则返回TRUE + + The model object to look for + Is the row selected + + + + 给定的URL是否已被访问 + + The string to be consider + Has it been visited + + + + 按给定的值增量滚动ListView。 + + Horizontal delta + Vertical delta + + + + Return a point that represents the current horizontal and vertical scroll positions + + + + + 记住给定的URL已被访问 + + The url to be remembered + This does not cause the control be redrawn + + + + 将给定的对象集合移动到给定的索引。 + + 此操作仅对未分组的ObjectListViews有意义。 + + + + + + 计算在给定点下的项目是什么？ + + + + + + + + 使用Windows控件的SUBITEMHITTEST消息执行点击测试。 + 这提供了标准ListView.HitTest()不提供的有关组点击的信息。 + + + + + + + + What is under the given point? This takes the various parts of a cell into accout, including + any custom parts that a custom renderer might use + + + + An information block about what is under the point + + + + Perform a hit test when the control is not owner drawn + + + + + + + + Perform a hit test when the control is owner drawn. This hands off responsibility + to the renderer. + + + + + + + + Pause (or unpause) all animations in the list + + true to pause, false to unpause + + + + Rebuild the columns based upon its current view and column visibility settings + + + + + 从ListView中删除给定的模型对象 + + The model to be removed + See RemoveObjects() for more details + This method is thread-safe. + + + + + 从控件中移除所有给定对象。 + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + This method is thread-safe. + + + + + 选择列表视图中的所有行 + + + + + 在列表视图的右下角设置要固定的给定图像。 + 当列表视图滚动时，此图像不会滚动。 + + + + 此方法使用ListView的原生功能显示背景图像。 + 它有几个限制： + + + 它在owner drawn模式下不能很好地工作。在owner drawn绘制模式下， + 每个单元格都会绘制自身，包括覆盖背景图像的背景。 + 启用网格线时看起来不是很好，因为网格线是在图像上绘制的。 + 它在XP上完全不起作用。 + 显然，当启用交替行背景色时，效果不佳。 + + + 如果你能忍受这些限制，原生水印就相当不错了。 + 它们是真实的背景，而不是像OverlayImage使用的半透明覆盖。 + 与覆盖相比，它们也有明显的优势，因为即使在MDI应用程序中，它们也可以正常工作。 + + 设置此选项将清除所有背景图像。 + + The image to be drawn. If null, any existing image will be removed. + + + + 将给定的图像设置为ListView的背景，以便它在列表中以给定的百分比偏移量显示。 + + + 这具有与 中所述的相同限制. + 在使用该方法之前，请确保了解这些限制。 + 这非常类似于 属性， + 但标准Backround Image不能正确处理具有透明区域的图像--它将透明区域呈现为黑色。这种方法没有这个问题。 + 设置此选项将清除所有背景水印。 + + The image to be drawn. If null, any existing image will be removed. + The horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + The vertical percentage where the image will be placed. + + + + 将给定图像设置为ListView的平铺背景。 + + + 这具有与 和 相同的限制. + 在使用该方法之前，请确保了解这些限制。 + + 要绘制的图像。如果为null，则将删除所有现有图像。 + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法。 + 该列表将立即更新 + The objects to be displayed + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法. + 该列表将立即更新 + The objects to be displayed + 是否应尽可能保留列表的状态。 + + + + 将给定的模型对象更新到ListView中。 + 如果该模型尚不存在，则会添加该模型。 + + The model to be updated + + + See for more details + + 此方法是线程安全的。 + 此方法将导致重新排序列表。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更新与给定对象相等的预先存在的模型。 + 如果控件中不存在任何模型，则会添加它们。 + + Collection of objects to be updated/added + + 此方法将导致重新排序列表。 + null值将被静默忽略。 + 此方法是线程安全的。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更改当前模型对象上对INotifyPropertyChanged事件的任何订阅， + 以便我们不再侦听旧模型上的事件，而侦听给定集合上的事件。 + + This does nothing if UseNotifyPropertyChanged is false. + + + + + 获取或设置ObjectListView是否应订阅它给定的模型对象上的INotifyPropertyChanged事件。 + + + + 这应该在调用SetObjects()之前设置。如果将其设置为False，ObjectListView将取消订阅所有当前模型对象。 + + 如果在虚拟列表上将其设置为true，ObjectListView将遍历列表中尝试订阅更改通知的所有对象。 + 如果您的虚拟列表中有10,000,000个项目，这可能需要一些时间。 + + + + + Subscribe to INotifyPropertyChanges on the given collection of objects. + + + + + + Unsubscribe from INotifyPropertyChanges on the given collection of objects. + If the given collection is null, unsubscribe from all current subscriptions + + + + + + Return a byte array that represents the current state of the ObjectListView, such + that the state can be restored by RestoreState() + + + The state of an ObjectListView includes the attributes that the user can modify: + + current view (i.e. Details, Tile, Large Icon...) + sort column and direction + column order + column widths + column visibility + + + + It does not include selection or the scroll position. + + + A byte array representing the state of the ObjectListView + + + + Restore the state of the control from the given string, which must have been + produced by SaveState() + + A byte array returned from SaveState() + Returns true if the state was restored + + + + Instances of this class are used to store the state of an ObjectListView. + + + + + The application is idle. Trigger a SelectionChanged event. + + + + + + + The application is idle. Handle the column resizing event. + + + + + + + Handle the BeginScroll listview notification + + + True if the event was completely handled + + + + Handle the EndScroll listview notification + + + True if the event was completely handled + + + + Handle the LinkClick listview notification + + + True if the event was completely handled + + + + The cell tooltip control wants information about the tool tip that it should show. + + + + + + + Allow the HeaderControl to call back into HandleHeaderToolTipShowing without making that method public + + + + + + + The header tooltip control wants information about the tool tip that it should show. + + + + + + + Event handler for the column click event + + + + + Override the basic message pump for this control + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user wants to see the context menu. + + The windows m + A bool indicating if this m has been handled + + We want to ignore context menu requests that are triggered by right clicks on the header + + + + + Handle the Custom draw series of notifications + + The message + True if the message has been handled + + + + Handle the underlying control being destroyed + + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + Find the first row after the given start in which the text value in the + comparison column begins with the given text. The comparison column is column 0, + unless IsSearchOnSortColumn is true, in which case the current sort column is used. + + The text to be prefix matched + The index of the first row to consider + Which direction should be searched? + The index of the first row that matched, or -1 + The text comparison is a case-insensitive, prefix match. The search will + search the every row until a match is found, wrapping at the end if needed. + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + 是否只匹配开头 + The index of the matched row, or -1 + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + Handle the Group Info series of notifications + + The message + True if the message has been handled + + + + Handle a key down message + + + True if the msg has been handled + + + + Toggle the checkedness of the selected rows + + + + Actually, this doesn't actually toggle all rows. It toggles the first row, and + all other rows get the check state of that first row. This is actually a much + more useful behaviour. + + + If no rows are selected, this method does nothing. + + + + + + Catch the Left Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button up event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Trigger a GroupExpandCollapse event and return true if the action was cancelled + + + + + + + Catch the Right Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the right Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a right mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the MouseMove event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle notifications that have been reflected back from the parent window + + The m to be processed + bool to indicate if the msg has been handled + + + + In the notification messages, we handle attempts to change the width of our columns + + The m to be processed + bool to indicate if the msg has been handled + + + + Create a ToolTipControl to manage the tooltip control used by the listview control + + + + + Update the handle used by our cell tooltip to be the tooltip used by + the underlying Windows listview control. + + + + + Handle the WM_PAINT event + + + Return true if the msg has been handled and nothing further should be done + + + + Perform any steps needed before painting the control + + + + + Perform any steps needed after painting the control + + + + + Handle the window position changing. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a menu that is appropriate when the given column header is clicked. + + The index of the header that was clicked. This + can be -1, indicating that the header was clicked outside of a column + Where should the menu be shown + True if a menu was displayed + + + + Create the menu that should be displayed when the user right clicks + on the given column header. + + Index of the column that was right clicked. + This can be negative, which indicates a click outside of any header. + The toolstrip that should be displayed + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + Where should the menu be placed + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + + Where should the menu be placed + + + + 获取或设置要用于升序排序命令的文本 + + + + + 获取或设置要用于降序排序命令的文本 + + + + + 获取或设置要用于分组命令的文本 + + + + + 获取或设置要用于锁定分组命令的文本 + + + + + 获取或设置要用于不锁定分组命令的文本 + + + + + 获取或设置要用于关闭分组命令的文本 + + + + + 获取或设置要用于不排序命令的文本 + + + + + 获取或设置要用于列描述的文本 + + + + + 获取或设置要用于选择列描述的文本 + + + + + Gets or sets the image that will be place next to the Sort Ascending command + + + + + Gets or sets the image that will be placed next to the Sort Descending command + + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + + Return the menu to which the items were added + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + Return the menu to which the items were added + + + + Create the menu items that will allow columns to be choosen and add them to the + given collection + + + + + + Create a Filtering menu + + + + + + + + Override the OnColumnReordered method to do what we want + + + + + + When the column widths are changing, resize the space filling columns + + + + + + + When the column widths change, resize the space filling columns + + + + + + + When the size of the control changes, we have to resize our space filling columns. + + + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Check all rows + + + + + Check the checkbox in the given column header + + If the given columns header check box is linked to the cell check boxes, + then checkboxes in all cells will also be checked. + + + + + Mark the checkbox in the given column header as having an indeterminate value + + + + + + Mark the given object as indeterminate check state + + The model object to be marked indeterminate + + + + Mark the given object as checked in the list + + The model object to be checked + + + + Mark the given objects as checked in the list + + The model object to be checked + + + + Put a check into the check box at the given cell + + + + + + + Put an indeterminate check into the check box at the given cell + + + + + + + Return true of the given object is checked + + The model object whose checkedness is returned + Is the given object checked? + If the given object is not in the list, this method returns false. + + + + Return true of the given object is indeterminately checked + + The model object whose checkedness is returned + Is the given object indeterminately checked? + If the given object is not in the list, this method returns false. + + + + Is there a check at the check box at the given cell + + + + + + + Get the checkedness of an object from the model. Returning null means the + model does not know and the value from the control will be used. + + + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the checkedness of the given object. A checked object becomes + unchecked; an unchecked or indeterminate object becomes checked. + If the list has tristate checkboxes, the order is: + unchecked -> checked -> indeterminate -> unchecked ... + + The model object to be checked + + + + Toggle the checkbox in the header of the given column + + Obviously, this is only useful if the column actually has a header checkbox. + + + + + Toggle the check at the check box of the given cell + + + + + + + Uncheck all rows + + + + + Mark the given object as unchecked in the list + + The model object to be unchecked + + + + Mark the given objects as unchecked in the list + + The model object to be checked + + + + Uncheck the checkbox in the given column header + + + + + + Uncheck the check at the given cell + + + + + + + 返回给定索引处的列 + + Index of the column to be returned + An OLVColumn + + + + 返回给定标题处的列,如果有多个符合要求的标题,则默认只返回第一个 + + 要返回的列的名称 + An OLVColumn + + + + 返回给定视图可见的列的集合。只有Tile和Details有列；所有其他视图都有0列。 + + 正在为哪个视图计算列？ + A list of columns + + + + 返回列表中的项目数 + + 列表中的项目数 + 如果安装了筛选器，这将返回与筛选器匹配的项目数。 + + + + 返回给定索引处的项 + + Index of the item to be returned + An OLVListItem + + + + 返回给定索引处的模型对象 + + Index of the model object to be returned + A model object + + + + 找出在给定的坐标下的行和列 + X 坐标 + Y 坐标 + 给定点下的列项 + 在给定坐标点下的行项。可以为null。 + + + + 返回给定索引/列的子项 + + Index of the item to be returned + Index of the subitem to be returned + An OLVListSubItem + + + + 滚动列表视图，使给定组位于顶部。 + + The group to be revealed + + 如果该组可见，如果可能，列表仍将滚动以将该组移至顶部。 + + 这只在列表显示分组时才有效(显然)。 + 这在虚拟列表上不起作用，因为虚拟列表不使用ListViewGroups进行分组。使用 代替. + + + + + 使给定的模型对象可见 + + The model object to be revealed + + + + 返回选定行的模型对象，如果没有选择或有多个选择，则返回null + + Model object or null + + + + 返回选定行的模型对象，如果没有选择，则返回空集合 + + ArrayList + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + Model object or null + 使用 CheckedObject 属性代替本方法 + + + + 获取选中的模型对象的集合。 + + 使用 CheckedObjects 属性代替本方法 + + + + 在列表视图中查找给定的模型对象并返回其索引 + + The model object to be found + The index of the object. -1 means the object was not present + + + + Rebuild the given ListViewItem with the data from its associated model. + + This method does not resort or regroup the view. It simply updates + the displayed data of the given item + + + + Rebuild the data on the row that is showing the given object. + + + + This method does not resort or regroup the view. + + + The given object is *not* used as the source of data for the rebuild. + It is only used to locate the matching model in the collection, + then that matching model is used as the data source. This distinction is + only important in model classes that have overridden the Equals() method. + + + If you want the given model object to replace the pre-existing model, + use . + + + + + + Update the rows that are showing the given objects + + + This method does not resort or regroup the view. + This method can safely be called from background threads. + + + + + 更新选定的行 + + This method does not resort or regroup the view. + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + Use the property to deselect all other rows + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + 对象是否也应该被聚焦 + Use the property to deselect all other rows + + + + 选择显示任意给定模型对象的行。取消选择所有其他行。 + + A collection of model objects + + + + 获取或设置是否冻结列表视图。当列表视图被冻结时，它不会自我更新。 + + Frozen属性与Freeze()/UnFreeze()方法类似， + 不同之处在于将Frozen属性设置为False会立即解冻控件， + 而不管有多少未完成的Freeze()调用。 + objectListView1.Frozen = false; // unfreeze the control now! + + + + + 冻结列表视图，使其不再自我更新。 + + Freeze()/Unfreeze() calls nest correctly + + + + 解冻列表视图。如果此调用是最外层的unFreeze()，则将重新构建listview的内容。 + + Freeze()/Unfreeze() calls nest correctly + + + + 在冻结列表视图时执行所需的实际工作 + + + + + 解冻列表视图时执行所需的实际工作 + + + + + 如果选择事件当前挂起，则返回TRUE。在挂起选择事件时，不会引发SelectedIndexChanged或SelectionChanged事件。 + + + + + Suspend selection events until a matching ResumeSelectionEvents() + is called. + + Calls to this method nest correctly. Every call to SuspendSelectionEvents() + must have a matching ResumeSelectionEvents(). + + + + Resume raising selection events. + + + + + Returns a disposable that will disable selection events + during a using() block. + + + + + + Implementation only class that suspends and resumes selection + events on instance creation and disposal. + + + + + 按最后一个排序列和顺序对项目进行排序 + + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的名称 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的索引 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + The column whose values will be used for the sorting. + If null, the first column will be used. + The ordering to be used for sorting. If this is None, + this.Sorting and then SortOrder.Ascending will be used + If ShowGroups is true, the rows will be grouped by the given column. + If AlwaysGroupsByColumn is not null, the rows will be grouped by that column, + and the rows within each group will be sorted by the given column. + + + + Put a sort indicator next to the text of the sort column + + + + + Put a sort indicator next to the text of the given given column + + The column to be marked + The sort order in effect on that column + + + + The name of the image used when a column is sorted ascending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + The name of the image used when a column is sorted descending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + If the sort indicator images don't already exist, this method will make and install them + + + + + Remove any sorting and revert to the given order of the model objects + + + + + Do the actual work of creating the given list of groups + + + + + + For some reason, UseItemStyleForSubItems doesn't work for the colors + when owner drawing the list, so we have to specifically give each subitem + the desired colors + + The item whose subitems are to be corrected + Cells drawn via BaseRenderer don't need this, but it is needed + when an owner drawn cell uses DrawDefault=true + + + + Fill in the given OLVListItem with values of the given row + + the OLVListItem that is to be stuff with values + the model object from which values will be taken + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + + + + Convert the given image selector to an index into our image list. + Return -1 if that's not possible + + + Index of the image in the imageList, or -1 + + + + Return the tooltip that should be shown when the mouse is hovered over the given column + + The column index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回当鼠标悬停在给定单元格上时应显示的工具提示 + + The column index whose tool tip is to be fetched + The row index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回显示给定模型对象的OLVListItem + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Do the work required after the items in a listview have been created + + + + + Do the work required after one item in a listview have been created + + + + + 准备列表视图以显示交替的行背景色 + + We cannot rely on lvi.Index in this method. + In a straight list, lvi.Index is the display index, and can be used to determine + whether the row should be colored. But when organised by groups, lvi.Index is not + useable because it still refers to the position in the overall list, not the display order. + + + + + Setup all subitem images on all rows + + + + + 告诉基础列表控件针对子项显示哪些图像 + + the index at which the item occurs + the item whose subitems are to be set + + + + Tell the underlying list control which images to show against the subitems + + the index at which the item occurs + the item whose subitems are to be set + will existing images be cleared if no new image is provided? + + + + Set the subitem image natively + + + + + + + + + Take ownership of the 'objects' collection. This separats our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + This method has the intentional side-effect of converting our list of objects to an ArrayList. + + + + + + 触发给定项目的FormatRow和可能的FormatCell事件 + + + + + + + + 触发给定项目的FormatCell事件 + + + + + + + + Make the list forget everything -- all rows and all columns + + Use if you want to remove just the rows. + + + + Update our externally visible image list so it holds the same images as our shadow list, but sized correctly + + + + + Return a copy of the given source image list, where each image has been resized to be height x height in size. + If source is null, an empty image list of the given size is returned + + Height and width of the new images + Height and width of the new images + Source of the images (can be null) + A new image list + + + + Return a bitmap of the given height x height, which shows the given image, centred. + + Height and width of new bitmap + Height and width of new bitmap + Image to be centred + The background color + A new bitmap + + + + Initialize the state image list with the required checkbox images + + + + + The name of the image used when a check box is checked + + + + + The name of the image used when a check box is unchecked + + + + + The name of the image used when a check box is Indeterminate + + + + + Setup this control so it can display check boxes on subitems + (or primary checkboxes in virtual mode) + + This gives the ListView a small image list, if it doesn't already have one. + + + + Make sure the small image list for this control has checkbox images + (used for sub-item checkboxes). + + + + This gives the ListView a small image list, if it doesn't already have one. + + + ObjectListView has to manage checkboxes on subitems separate from the checkboxes on each row. + The underlying ListView knows about the per-row checkboxes, and to make them work, OLV has to + correctly configure the StateImageList. However, the ListView cannot do checkboxes in subitems, + so ObjectListView has to handle them in a differnt fashion. So, per-row checkboxes are controlled + by images in the StateImageList, but per-cell checkboxes are handled by images in the SmallImageList. + + + + + + Owner draw the column header + + + + + + Owner draw the item + + + + + + Owner draw a single subitem + + + + + + We need the click count in the mouse up event, but that is always 1. + So we have to remember the click count from the preceding mouse down event. + + + + + + When the mouse leaves the control, remove any hot item highlighting + + + + + + When the mouse moves, we might need to change the hot item. + + + + + + Check to see if we need to start editing a cell + + + + + + Tell the world that a hyperlink was clicked and if the event isn't handled, + do the default processing. + + + + + + Do the default processing for a hyperlink clicked event, which + is to try and open the url. + + + + + + The user right clicked on the control + + + + + + This method is called every time a row is selected or deselected. This can be + a pain if the user shift-clicks 100 rows. We override this method so we can + trigger one event for any number of select/deselects that come from one user action + + + + + + Called when the handle of the underlying control is created + + + + + + This method is called after the control has been fully created. + + + + + Should we start editing the cell in response to the given mouse button event? + + + + + + + Handle a key press on this control. We specifically look for F2 which edits the primary column, + or a Tab character during an edit operation, which tries to start editing on the next (or previous) cell. + + + + + + + Start an editing operation on the first editable column of the given model. + + + + + If the model doesn't exist, or there are no editable columns, this method + will do nothing. + + This will start an edit operation regardless of CellActivationMode. + + + + + + Begin an edit operation on the given cell. + + This performs various sanity checks and passes off the real work to StartCellEdit(). + The row to be edited + The index of the cell to be edited + + + + Really start an edit operation on a given cell. The parameters are assumed to be sane. + + The row to be edited + The index of the cell to be edited + + + + Calculate the bounds of the edit control for the given item/column + + + + + + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is not being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Try to give the given value to the provided control. Fall back to assigning a string + if the value assignment fails. + + A control + The value to be given to the control + The string to be given if the value doesn't work + + + + Setup the given control to be a cell editor + + + + + Return the value that the given control is showing + + + + + + + Called when the cell editor could be about to lose focus. Time to commit the change + + + + + + + Return the bounds of the given cell + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Return the bounds of the given cell only until the edge of the current text + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Calculate the visible bounds of the given column. The column's bottom edge is + either the bottom of the last row or the bottom of the control. + + The bounds of the control itself + The column + A Rectangle + This returns an empty rectnage if the control isn't in Details mode, + OR has doesn't have any rows, OR if the given column is hidden. + + + + Return a control that can be used to edit the value of the given cell. + + The row to be edited + The index of the cell to be edited + A Control to edit the given cell + + + + Get the first non-null value of the given column. + At most 1000 rows will be considered. + + + The first non-null value, or null if no non-null values were found + + + + Return a TextBox that can be used as a default cell editor. + + What column does the cell belong to? + + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + Consider only this many rows + + + + Stop editing a cell and throw away any changes. + + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Remove all trace of any existing cell edit operation + + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + True if the cell editor should be disposed + + + + Force the hot item to be recalculated + + + + + Force the hot item to be recalculated + + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + Where is the mouse? + This is the main entry point for hot item handling + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + + This is the main entry point for hot item handling + + + + Update the given row using the current hot item information + + + + + + Update the given row using the given hot item information + + + + + + + + + Apply a style to the given row + + + + + + + Apply a style to a cell + + + + + + + + Remove hot item styling from the given row + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Add the given decoration to those on this list and make it appear + + The decoration + + A decoration scrolls with the listview. An overlay stays fixed in place. + + + + + Add the given overlay to those on this list and make it appear + + The overlay + + + + Draw all the decorations + + A Graphics + The items that were redrawn and whose decorations should also be redrawn + + + + Is the given decoration shown on this list + + The overlay + + + + Is the given overlay shown on this list? + + The overlay + + + + Hide any overlays. + + + This is only a temporary hiding -- the overlays will be shown + the next time the ObjectListView redraws. + + + + + Create and configure the empty list msg overlay + + + + + Initialize the standard image and text overlays + + + + + Make sure that any overlays are visible. + + + + + Refresh the display of the overlays + + + + + Refresh the display of just one overlays + + + + + Remove the given decoration from this list + + The decoration to remove + + + + Remove the given overlay to those on this list + + The overlay + + + + 创建一个筛选器，该筛选器将执行当前安装在可见列上的所有筛选。 + + + + + Do the actual work of filtering + + + + + + + + + 删除所有列筛选。 + + + + + 根据每列中定义的值筛选更新此ObjectListView的筛选 + + + + + When some setting related to filtering changes, this method is called. + + + + + 使用当前安装的模型过滤器更新所有渲染器 + + + + + 获取给定模型的复选框状态。 + + The model + 模型的复选框状态。默认为未选中。 + + + + 设置给定模型对象的复选框状态 + + The model to be remembered + The model's checkedness + The state given to the method + + + + 忽略任何持久复选框状态 + + + + + The callbacks for CellEditing events + + this + We could replace this with EventHandler<CellEditEventArgs> but that would break all + cell editing event code from v1.x. + + + + + A TreeListView combines an expandable tree structure with list view columns. + + + To support tree operations, two delegates must be provided: + + + + CanExpandGetter + + + This delegate must accept a model object and return a boolean indicating + if that model should be expandable. + + + + + ChildrenGetter + + + This delegate must accept a model object and return an IEnumerable of model + objects that will be displayed as children of the parent model. This delegate will only be called + for a model object if the CanExpandGetter has already returned true for that model. + + + + + ParentGetter + + + This delegate must accept a model object and return the parent model. + This delegate will only be called when HierarchicalCheckboxes is true OR when Reveal() is called. + + + + + The top level branches of the tree are set via the Roots property. SetObjects(), AddObjects() + and RemoveObjects() are interpreted as operations on this collection of roots. + + + To add new children to an existing branch, make changes to your model objects and then + call RefreshObject() on the parent. + + The tree must be a directed acyclic graph -- no cycles are allowed. Put more mundanely, + each model object must appear only once in the tree. If the same model object appears in two + places in the tree, the control will become confused. + + + + + This event is triggered when user input requests the expansion of a list item. + + + + + This event is triggered when user input requests the collapse of a list item. + + + + + This event is triggered after the expansion of a list item due to user input. + + + + + This event is triggered after the collapse of a list item due to user input. + + + + + Trigger the expanding event + + + + + + Trigger the collapsing event + + + + + + Trigger the expanded event + + + + + + Trigger the collapsed event + + + + + + This class handles drawing the tree structure of the primary column. + + + + + Create a TreeRenderer + + + + + Should the renderer draw glyphs at the expansion points? + + The expansion points will still function to expand/collapse even if this is false. + + + + Should the renderer draw lines connecting siblings? + + + + + Return the pen that will be used to draw the lines between branches + + + + + Should the renderer draw triangles as the expansion glyphs? + + + This looks best with ShowLines = false + + + + + Return the branch that the renderer is currently drawing. + + + + + Return the TreeListView for which the renderer is being used. + + + + + How many pixels will be reserved for each level of indentation? + + + + + The real work of drawing the tree is done in this method + + + + + + + Draw the expansion indicator + + + + + + + + Gets whether or not we should render using styles + + + + + Draw the expansion indicator using styles + + + + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the expansion indicator without using styles + + + + + + + + Draw the lines of the tree + + + + + + + + + + Do the hit test + + + + + + + + + Calculate the edit rect + + + + + + + + + + + Make a default TreeListView + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + This is called *often* -- on every mouse move when required. It must be fast. + Don't do database lookups, linear searches, or pi calculations. Just return the + value of a property. + + + When this delegate is called, the TreeListView is not in a stable state. Don't make + calls back into the control. + + + + + + Gets whether or not this listview is capable of showing groups + + + + + This is the delegate that will be used to fetch the children of a model object + + + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + When this delegate is called, the TreeListView is not in a stable state. Don't do anything + that will result in calls being made back into the control. + + + + + + This is the delegate that will be used to fetch the parent of a model object + + The parent of the given model, or null if the model doesn't exist or + if the model is a root + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivalent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + + + + Gets or sets the model objects that are expanded. + + + This can be used to expand model objects before they are seen. + + Setting this does *not* force the control to rebuild + its display. You need to call RebuildAll(true). + + + + + + Gets or sets the filter that is applied to our whole list of objects. + TreeListViews do not currently support whole list filters. + + + + + Gets or sets whether this tree list view will display hierarchical checkboxes. + Hierarchical checkboxes is when a parent's "checkedness" is calculated from + the "checkedness" of its children. If all children are checked, the parent + will be checked. If all children are unchecked, the parent will also be unchecked. + If some children are checked and others are not, the parent will be indeterminate. + + + Hierarchical checkboxes don't work with either CheckStateGetters or CheckedAspectName + (which is basically the same thing). This is because it is too expensive to build the + initial state of the control if these are installed, since the control would have to walk + *every* branch recursively since a single bottom level leaf could change the checkedness + of the top root. + + + + + Gets or sets the collection of root objects of the tree + + + + + Gets the collection of objects that will be considered when creating clusters + (which are used to generate Excel-like column filters) + + + + + After expanding a branch, should the TreeListView attempts to show as much of the + revealed descendents as possible. + + + + + The model objects that form the top level branches of the tree. + + Setting this does NOT reset the state of the control. + In particular, it does not collapse branches. + + + + Make sure that at least one column is displaying a tree. + If no columns is showing the tree, make column 0 do it. + + + + + Gets or sets the renderer that will be used to draw the tree structure. + Setting this to null resets the renderer to default. + + If a column is currently rendering the tree, the renderer + for that column will be replaced. If no column is rendering the tree, + column 0 will be given this renderer. + + + + This is the delegate that will be used to create the underlying Tree structure + that the TreeListView uses to manage the information about the tree. + + + The factory must not return null. + + Most users of TreeListView will never have to use this delegate. + + + + + + Should a wait cursor be shown when a branch is being expanded? + + When this is true, the wait cursor will be shown whilst the children of the + branch are being fetched. If the children of the branch have already been cached, + the cursor will not change. + + + + Gets the model that is used to manage the tree structure + + + Don't mess with this property unless you really know what you are doing. + If you don't already know what it's for, you don't need it. + + + + Return true if the branch at the given model is expanded + + + + + + + Collapse the subtree underneath the given model + + + + + + Collapse all subtrees within this control + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Collapse all roots and forget everything we know about all models + + + + + Expand the subtree underneath the given model object + + + + + + Expand all the branches within this tree recursively. + + Be careful: this method could take a long time for large trees. + + + + Completely rebuild the tree structure + + If true, the control will try to preserve selection and expansion + + + + Completely rebuild the tree structure + + If not null, this list of objects will be selected after the tree is rebuilt + If not null, this collection of objects will be expanded after the tree is rebuilt + If not null, this collection of objects will be checked after the tree is rebuilt + + + + Unroll all the ancestors of the given model and make sure it is then visible. + + This works best when a ParentGetter is installed. + The object to be revealed + If true, the model will be selected and focused after being revealed + True if the object was found and revealed. False if it was not found. + + + + Update the rows that are showing the given objects + + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the expanded state of the branch at the given model object + + + + + + Return whether or not the given model can expand. + + + The given model must have already been seen in the tree + + + + Return the model object that is the parent of the given model object. + + + + The given model must have already been seen in the tree. + + + + Return the collection of model objects that are the children of the + given model as they exist in the tree at the moment. + + + + + This method returns the collection of children as the tree knows them. If the given + model has never been presented to the user (e.g. it belongs to a parent that has + never been expanded), then this method will return an empty collection. + + Because of this, if you want to traverse the whole tree, this is not the method to use. + It's better to traverse the your data model directly. + + + If the given model has not already been seen in the tree or + if it is not expandable, an empty collection will be returned. + + + + + + Delegates of this type are use to decide if the given model object can be expanded + + The model under consideration + Can the given model be expanded? + + + + Delegates of this type are used to fetch the children of the given model object + + The parent whose children should be fetched + An enumerable over the children + + + + Delegates of this type are used to fetch the parent of the given model object. + + The child whose parent should be fetched + The parent of the child or null if the child is a root + + + + Delegates of this type are used to create a new underlying Tree structure. + + The view for which the Tree is being created + A subclass of Tree + + + + Handle a left button down event + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + This differs from the base method by also setting up the IndentCount property. + + + + Reinitialize the Tree structure + + + + + Recalculate the state of the checkboxes of all the items in the given list + and their ancestors. + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Recalculate the hierarchy state of the given item and its ancestors + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Yield the unique ancestors of the given collection of objects. + The order of the ancestors is guaranteed to be deeper objects first. + Roots will always be last. + + + Unique ancestors of the given objects + + + + Return all the ancestors of the given model + + + + This uses ParentGetter if possible. + + If the given model is a root OR if the model doesn't exist, the collection will be empty + + The model whose ancestors should be calculated + Return a collection of ancestors of the given model. + + + + The application is idle and a SelectionChanged event has been scheduled + + + + + + + Decide if the given key event should be handled as a normal key input to the control? + + + + + + + Handle focus being lost, including making sure that the whole control is redrawn. + + + + + + Handle the keyboard input to mimic a TreeView. + + + Was the key press handled? + + + + A Tree object represents a tree structure data model that supports both + tree and flat list operations as well as fast access to branches. + + If you create a subclass of Tree, you must install it in the TreeListView + via the TreeFactory delegate. + + + + Create a Tree + + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + + This is the delegate that will be used to fetch the children of a model object + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + + Get or return the top level model objects in the tree + + + + + What tree view is this Tree the model for? + + + + + Collapse the subtree underneath the given model + + The model to be collapsed. If the model isn't in the tree, + or if it is already collapsed, the command does nothing. + The index of the model in flat list version of the tree + + + + Collapse all branches in this tree + + Nothing useful + + + + Expand the subtree underneath the given model object + + The model to be expanded. + The index of the model in flat list version of the tree + + If the model isn't in the tree, + if it cannot be expanded or if it is already expanded, the command does nothing. + + + + + Expand all branches in this tree + + Return the index of the first branch that was expanded + + + + Return the Branch object that represents the given model in the tree + + The model whose branches is to be returned + The branch that represents the given model, or null if the model + isn't in the tree. + + + + Return the number of visible descendents that are below the given model. + + The model whose descendent count is to be returned + The number of visible descendents. 0 if the model doesn't exist or is collapsed + + + + Rebuild the children of the given model, refreshing any cached information held about the given object + + + The index of the model in flat list version of the tree + + + + Is the given model expanded? + + + + + + + Remember whether or not the given model was expanded + + + + + + + Insert the children of the given branch into the given position + + The branch whose children should be inserted + The index where the children should be inserted + + + + Rebuild our flat internal list of objects. + + + + + Rebuild our reverse index that maps an object to its location + in the filteredObjectList array. + + + + + + Create a new branch within this tree + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Sort the tree on the given column and in the given order + + + + + + + + + + + + + Add the given collection of objects to the roots of this tree + + + + + + + + + + + + + Remove all of the given objects from the roots of the tree. + Any objects that is not already in the roots collection is ignored. + + + + + + Set the roots of this tree to be the given collection + + + + + + Update/replace the nth object with the given object + + + + + + + + + + + + + + Is this list currently being filtered? + + + + + Should the given model be included in this control? + + The model to consider + True if it will be included + + + + + + + + + + + + + + A Branch represents a sub-tree within a tree + + + + + Indicators for branches + + + + + FirstBranch of tree + + + + + LastChild of parent + + + + + OnlyBranch of tree + + + + + Create a Branch + + + + + + + + Get the ancestor branches of this branch, with the 'oldest' ancestor first. + + + + + Can this branch be expanded? + + + + + Gets or sets our children + + + + + Get/set the model objects that are beneath this branch + + + + + Gets a list of all the branches that survive filtering + + + + + Gets or set whether this branch is expanded + + + + + Return true if this branch is the first branch of the entire tree + + + + + Return true if this branch is the last child of its parent + + + + + Return true if this branch is the only top level branch + + + + + Gets the depth level of this branch + + + + + Gets or sets which model is represented by this branch + + + + + Return the number of descendents of this branch that are currently visible + + + + + + Gets or sets our parent branch + + + + + Gets or sets our overall tree + + + + + Is this branch currently visible? A branch is visible + if it has no parent (i.e. it's a root), or its parent + is visible and expanded. + + + + + Clear any cached information that this branch is holding + + + + + Collapse this branch + + + + + Expand this branch + + + + + Expand this branch recursively + + + + + Collapse all branches in this tree + + Nothing useful + + + + Fetch the children of this branch. + + This should only be called when CanExpand is true. + + + + Collapse the visible descendents of this branch into list of model objects + + + + + + Flatten this branch's visible descendents onto the given list. + + + The branch itself is not included in the list. + + + + Force a refresh of all children recursively + + + + + Sort the sub-branches and their descendents so they are ordered according + to the given comparer. + + The comparer that orders the branches + + + + This class sorts branches according to how their respective model objects are sorted + + + + + Create a BranchComparer + + + + + + Order the two branches + + + + + + + + Let the world know that a cell edit operation is beginning or ending + + + + + Create an event args + + + + + + + + + + Change this to true to cancel the cell editing operation. + + + During the CellEditStarting event, setting this to true will prevent the cell from being edited. + During the CellEditFinishing event, if this value is already true, this indicates that the user has + cancelled the edit operation and that the handler should perform cleanup only. Setting this to true, + will prevent the ObjectListView from trying to write the new value into the model object. + + + + + During the CellEditStarting event, this can be modified to be the control that you want + to edit the value. You must fully configure the control before returning from the event, + including its bounds and the value it is showing. + During the CellEditFinishing event, you can use this to get the value that the user + entered and commit that value to the model. Changing the control during the finishing + event has no effect. + + + + + The column of the cell that is going to be or has been edited. + + + + + The model object of the row of the cell that is going to be or has been edited. + + + + + The listview item of the cell that is going to be or has been edited. + + + + + The data value of the cell as it stands in the control. + + Only validate during Validating and Finishing events. + + + + The index of the cell that is going to be or has been edited. + + + + + The data value of the cell before the edit operation began. + + + + + The bounds of the cell that is going to be or has been edited. + + + + + Gets or sets whether the control used for editing should be auto matically disposed + when the cell edit operation finishes. Defaults to true + + If the control is expensive to create, you might want to cache it and reuse for + for various cells. If so, you don't want ObjectListView to dispose of the control automatically + + + + Event blocks for events that can be cancelled + + + + + Has this event been cancelled by the event handler? + + + + + BeforeSorting + + + + + Create BeforeSortingEventArgs + + + + + + + + + Create BeforeSortingEventArgs + + + + + + + + + + + Did the event handler already do the sorting for us? + + + + + What column will be used for grouping + + + + + How will groups be ordered + + + + + What column will be used for sorting + + + + + What order will be used for sorting. None means no sorting. + + + + + What column will be used for secondary sorting? + + + + + What order will be used for secondary sorting? + + + + + Sorting has just occurred. + + + + + Create a AfterSortingEventArgs + + + + + + + + + + + Create a AfterSortingEventArgs + + + + + + What column was used for grouping? + + + + + What ordering was used for grouping? + + + + + What column was used for sorting? + + + + + What ordering was used for sorting? + + + + + What column was used for secondary sorting? + + + + + What order was used for secondary sorting? + + + + + This event is triggered when the contents of a list have changed + and we want the world to have a chance to filter the list. + + + + + Create a FilterEventArgs + + + + + + Gets or sets what objects are being filtered + + + + + Gets or sets what objects survived the filtering + + + + + This event is triggered after the items in the list have been changed, + either through SetObjects, AddObjects or RemoveObjects. + + + + + Create a ItemsChangedEventArgs + + + + + Constructor for this event when used by a virtual list + + + + + + + Gets how many items were in the list before it changed + + + + + Gets how many objects are in the list after the change. + + + + + This event is triggered by AddObjects before any change has been made to the list. + + + + + Create an ItemsAddingEventArgs + + + + + + Create an ItemsAddingEventArgs + + + + + + + Gets or sets where the collection is going to be inserted. + + + + + Gets or sets the objects to be added to the list + + + + + This event is triggered by SetObjects before any change has been made to the list. + + + When used with a virtual list, OldObjects will always be null. + + + + + Create ItemsChangingEventArgs + + + + + + + Gets the objects that were in the list before it change. + For virtual lists, this will always be null. + + + + + Gets or sets the objects that will be in the list after it changes. + + + + + This event is triggered by RemoveObjects before any change has been made to the list. + + + + + Create an ItemsRemovingEventArgs + + + + + + Gets or sets the objects that will be removed + + + + + Triggered after the user types into a list + + + + + Create an AfterSearchingEventArgs + + + + + + + Gets the string that was actually searched for + + + + + Gets or sets whether an the event handler already handled this event + + + + + Gets the index of the row that was selected by the search. + -1 means that no row was matched + + + + + Triggered when the user types into a list + + + + + Create BeforeSearchingEventArgs + + + + + + + Gets or sets the string that will be found by the search routine + + Modifying this value does not modify the memory of what the user has typed. + When the user next presses a character, the search string will revert to what + the user has actually typed. + + + + Gets or sets the index of the first row that will be considered to matching. + + + + + The parameter block when telling the world about a cell based event + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + This is null for events triggered by the header. + + + + Gets the row index of the cell + + This is -1 for events triggered by the header. + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the location of the mouse at the time of the event + + + + + Gets the state of the modifier keys at the time of the event + + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view and + for event triggered by the header + + + + Gets the HitTest object that determined which cell was hit + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Tells the world that a cell was clicked + + + + + Gets or sets the number of clicks associated with this event + + + + + Tells the world that a cell was right clicked + + + + + Gets or sets the menu that should be displayed as a result of this event. + + The menu will be positioned at Location, so changing that property changes + where the menu will be displayed. + + + + Tell the world that the mouse is over a given cell + + + + + Tells the world that the frozen-ness of the ObjectListView has changed. + + + + + Make a FreezeEventArgs + + + + + + How frozen is the control? 0 means that the control is unfrozen, + more than 0 indicates froze. + + + + + The parameter block when telling the world that a tool tip is about to be shown. + + + + + Gets the tooltip control that is triggering the tooltip event + + + + + Gets or sets the text should be shown on the tooltip for this event + + Setting this to empty or null prevents any tooltip from showing + + + + In what direction should the text for this tooltip be drawn? + + + + + Should the tooltip for this event been shown in bubble style? + + This doesn't work reliable under Vista + + + + What color should be used for the background of the tooltip + + Setting this does nothing under Vista + + + + What color should be used for the foreground of the tooltip + + Setting this does nothing under Vista + + + + What string should be used as the title for the tooltip for this event? + + + + + Which standard icon should be used for the tooltip for this event + + + + + How many milliseconds should the tooltip remain before it automatically + disappears. + + + + + What font should be used to draw the text of the tooltip? + + + + + Common information to all hyperlink events + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the ObjectListView that is the source of the event + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the text of the cell + + + + + Gets or sets whether or not this cell is a hyperlink. + Defaults to true for enabled rows and false for disabled rows. + + + + + Gets or sets the url that should be invoked when this cell is clicked. + + Setting this to None or String.Empty means that this cell is not a hyperlink + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the item of the cell + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the display index of the row + + + + + Should events be triggered for each cell in this row? + + + + + Parameter block for FormatCellEvent + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the model value that is being displayed by the cell. + + This is null when the view is not in details view + + + + The event args when a hyperlink is clicked + + + + + Gets the url that was associated with this cell. + + + + + The event args when the check box in a column header is changing + + + + + Get the column whose checkbox is changing + + + + + Get or set the new state that should be used by the column + + + + + The event args when the hot item changed + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Gets the part of the cell that the mouse is over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + Gets the index of the column that the mouse is over + + In non-details view, this will always be 0. + + + + Gets the index of the row that the mouse is over + + + + + Gets the group that the mouse is over + + + + + Gets the part of the cell that the mouse used to be over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse used to be over + + + + + Gets the index of the column that the mouse used to be over + + + + + Gets the index of the row that the mouse used to be over + + + + + Gets the group that the mouse used to be over + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + Let the world know that a checkbox on a subitem is changing + + + + + Create a new event block + + + + + + + + + + The column of the cell that is having its checkbox changed. + + + + + The model object of the row of the cell that is having its checkbox changed. + + + + + The listview item of the cell that is having its checkbox changed. + + + + + The current check state of the cell. + + + + + The proposed new check state of the cell. + + + + + The index of the cell that is going to be or has been edited. + + + + + This event argument block is used when groups are created for a list. + + + + + Create a CreateGroupsEventArgs + + + + + + Gets the settings that control the creation of groups + + + + + Gets or sets the groups that should be used + + + + + Has this event been cancelled by the event handler? + + + + + This event argument block is used when the text of a group task is clicked + + + + + Create a GroupTaskClickedEventArgs + + + + + + Gets which group was clicked + + + + + This event argument block is used when a group is about to expand or collapse + + + + + Create a GroupExpandingCollapsingEventArgs + + + + + + Gets which group is expanding/collapsing + + + + + Gets whether this event is going to expand the group. + If this is false, the group must be collapsing. + + + + + This event argument block is used when the state of group has changed (collapsed, selected) + + + + + Create a GroupStateChangedEventArgs + + + + + + + + Gets whether the group was collapsed by this event + + + + + Gets whether the group was focused by this event + + + + + Gets whether the group was selected by this event + + + + + Gets whether the group was uncollapsed by this event + + + + + Gets whether the group was unfocused by this event + + + + + Gets whether the group was unselected by this event + + + + + Gets which group had its state changed + + + + + Gets the previous state of the group + + + + + Gets the new state of the group + + + + + This event argument block is used when a branch of a tree is about to be expanded + + + + + Create a new event args + + + + + + + Gets the model that is about to expand. If null, all branches are going to be expanded. + + + + + Gets the OLVListItem that is about to be expanded + + + + + This event argument block is used when a branch of a tree has just been expanded + + + + + Create a new event args + + + + + + + Gets the model that is was expanded. If null, all branches were expanded. + + + + + Gets the OLVListItem that was expanded + + + + + This event argument block is used when a branch of a tree is about to be collapsed + + + + + Create a new event args + + + + + + + Gets the model that is about to collapse. If this is null, all models are going to collapse. + + + + + Gets the OLVListItem that is about to be collapsed. Can be null + + + + + This event argument block is used when a branch of a tree has just been collapsed + + + + + Create a new event args + + + + + + + Gets the model that is was collapsed. If null, all branches were collapsed + + + + + Gets the OLVListItem that was collapsed + + + + + This class contains all the settings used when groups are created + + + + + Create a GroupingParameters + + + + + + + + + + + + + + + Gets or sets the ObjectListView being grouped + + + + + Gets or sets the column used to create groups + + + + + In what order will the groups themselves be sorted? + + + + + If this is set, this comparer will be used to order the groups + + + + + If this is set, this comparer will be used to order items within each group + + + + + Gets or sets the column that will be the primary sort + + + + + Gets or sets the ordering for the primary sort + + + + + Gets or sets the column used for secondary sorting + + + + + Gets or sets the ordering for the secondary sort + + + + + Gets or sets the title format used for groups with zero or more than one element + + + + + Gets or sets the title format used for groups with only one element + + + + + Gets or sets whether the items should be sorted by the primary column + + + + + These values indicate what is the state of the group. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + Normal + + + + + Collapsed + + + + + Hidden + + + + + NoHeader + + + + + Can be collapsed + + + + + Has focus + + + + + Is Selected + + + + + Is subsetted + + + + + Subset link has focus + + + + + All styles + + + + + This mask indicates which members of a LVGROUP have valid data. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + No mask + + + + + Group has header + + + + + Group has footer + + + + + Group has state + + + + + + + + + + + + + + + pszSubtitle is valid + + + + + pszTask is valid + + + + + pszDescriptionTop is valid + + + + + pszDescriptionBottom is valid + + + + + iTitleImage is valid + + + + + iExtendedImage is valid + + + + + iFirstItem and cItems are valid + + + + + pszSubsetTitle is valid + + + + + readonly, cItems holds count of items in visible subset, iFirstItem is valid + + + + + This mask indicates which members of a GROUPMETRICS structure are valid + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class enhance the capabilities of a normal ListViewGroup, + enabling the functionality that was released in v6 of the common controls. + + + + In this implementation (2009-09), these objects are essentially passive. + Setting properties does not automatically change the associated group in + the listview. Collapsed and Collapsible are two exceptions to this and + give immediate results. + + + This really should be a subclass of ListViewGroup, but that class is + sealed (why is that?). So this class provides the same interface as a + ListViewGroup, plus many other new properties. + + + + + + Create an OLVGroup + + + + + 按指定标题创建分组 + + 分组标题 + + + + Gets or sets the bottom description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets whether or not this group is collapsed + + + + + Gets or sets whether or not this group can be collapsed + + + + + Gets or sets some representation of the contents of this group + + This is user defined (like Tag) + + + + Gets whether this group has been created. + + + + + Gets or sets the int or string that will select the extended image to be shown against the title + + + + + Gets or sets the footer of the group + + + + + Gets the internal id of our associated ListViewGroup. + + + + + Gets or sets the header of the group + + + + + Gets or sets the horizontal alignment of the group header + + + + + Gets or sets the internally created id of the group + + + + + Gets or sets ListViewItems that are members of this group + + Listener of the BeforeCreatingGroups event can populate this collection. + It is only used on non-virtual lists. + + + + Gets or sets the key that was used to partition objects into this group + + This is user defined (like Tag) + + + + Gets the ObjectListView that this group belongs to + + If this is null, the group has not yet been created. + + + + Gets or sets the name of the group + + As of 2009-09-01, this property is not used. + + + + Gets or sets whether this group is focused + + + + + Gets or sets whether this group is selected + + + + + Gets or sets the text that will show that this group is subsetted + + + As of WinSDK v7.0, subsetting of group is officially unimplemented. + We can get around this using undocumented interfaces and may do so. + + + + + Gets or set the subtitleof the task + + + + + Gets or sets the value by which this group will be sorted. + + + + + Gets or sets the state of the group + + + + + Gets or sets which bits of State are valid + + + + + Gets or sets whether this group is showing only a subset of its elements + + + As of WinSDK v7.0, this property officially does nothing. + + + + + Gets or sets the user-defined data attached to this group + + + + + Gets or sets the task of this group + + This task is the clickable text that appears on the right margin + of the group header. + + + + Gets or sets the int or string that will select the image to be shown against the title + + + + + Gets or sets the top description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets the number of items that are within this group. + + This should only be used for virtual groups. + + + + Gets or sets the ListViewGroup that is shadowed by this group. + + For virtual groups, this will always be null. + + + + Calculate the index into the group image list of the given image selector + + + + + + + Convert this object to a string representation + + + + + + Insert a native group into the underlying Windows control, + *without* using a ListViewGroup + + + This is used when creating virtual groups + + + + Insert a native group into the underlying control via a ListViewGroup + + + + + + Change the members of the group to match the current contents of Items, + using a ListViewGroup + + + + + Create a native LVGROUP structure that matches this group + + + + + Get the current state of this group from the underlying control + + + + + Get the current state of this group from the underlying control + + + + + An instance of Munger gets a value from or puts a value into a target object. The property + to be peeked (or poked) is determined from a string. The peeking or poking is done using reflection. + + + Name of the aspect to be peeked can be a field, property or parameterless method. The name of an + aspect to poke can be a field, writable property or single parameter method. + + Aspect names can be dotted to chain a series of references. + + Order.Customer.HomeAddress.State + + + + + Create a do nothing Munger + + + + + Create a Munger that works on the given aspect name + + The name of the + + + + A helper method to put the given value into the given aspect of the given object. + + This method catches and silently ignores any errors that occur + while modifying the target object + The object to be modified + The name of the property/field to be modified + The value to be assigned + Did the modification work? + + + + Gets or sets whether Mungers will silently ignore missing aspect errors. + + + + By default, if a Munger is asked to fetch a field/property/method + that does not exist from a model, it returns an error message, since that + condition is normally a programming error. There are some use cases where + this is not an error, and the munger should simply keep quiet. + + By default this is true during release builds. + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or parameter-less method. + + + The name can be dotted, which chains references. If any link in the chain returns + null, the entire chain is considered to return null. + + + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + Extract the value indicated by our AspectName from the given target. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Extract the value indicated by our AspectName from the given target, raising exceptions + if the munger fails. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Poke the given value into the given target indicated by our AspectName. + + + + If the AspectName is a dotted path, all the selectors bar the last + are used to find the object that should be updated, and the last + selector is used as the property to update on that object. + + + So, if 'target' is a Person and the AspectName is "HomeAddress.Postcode", + this method will first fetch "HomeAddress" property, and then try to set the + "Postcode" property on the home address object. + + + The object that will be poked + The value that will be poked into the target + bool indicating whether the put worked + + + + Gets the list of SimpleMungers that match our AspectName + + + + + Convert a possibly dotted AspectName into a list of SimpleMungers + + + + + + + Evaluate the given chain of SimpleMungers against an initial target. + + + + + + + + A SimpleMunger deals with a single property/field/method on its target. + + + Munger uses a chain of these resolve a dotted aspect name. + + + + + Create a SimpleMunger + + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or method. + When using a method to get a value, the method must be parameter-less. + When using a method to set a value, the method must accept 1 parameter. + + + It cannot be a dotted name. + + + + + + Get a value from the given target + + + + + + + Poke the given value into the given target indicated by our AspectName. + + The object that will be poked + The value that will be poked into the target + bool indicating if the put worked + + + + These exceptions are raised when a munger finds something it cannot process + + + + + Create a MungerException + + + + + + + + Get the munger that raised the exception + + + + + Gets the target that threw the exception + + + + + Wrapper for all native method calls on ListView controls + + + + + Put an image under the ListView. + + + + The ListView must have its handle created before calling this. + + + This doesn't work very well. Specifically, it doesn't play well with owner drawn, + and grid lines are drawn over it. + + + + The image to be used as the background. If this is null, any existing background image will be cleared. + If this is true, the image is pinned to the bottom right and does not scroll. The other parameters are ignored + If this is true, the image will be tiled to fill the whole control background. The offset parameters will be ignored. + If both watermark and tiled are false, this indicates the horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + If both watermark and tiled are false, this indicates the vertical percentage where the image will be placed. + + + + + Flags controlling how the Image List item is + drawn + + + + + Draw item normally. + + + + + Draw item transparently. + + + + + Draw item blended with 25% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw item blended with 50% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw the icon's mask + + + + + Draw the icon image without using the mask + + + + + Draw the icon using the ROP specified. + + + + + Preserves the alpha channel in dest. XP only. + + + + + Scale the image to cx, cy instead of clipping it. XP only. + + + + + Scale the image to the current DPI of the display. XP only. + + + + + Enumeration containing XP ImageList Draw State options + + + + + The image state is not modified. + + + + + Adds a glow effect to the icon, which causes the icon to appear to glow + with a given color around the edges. (Note: does not appear to be implemented) + + + + + Adds a drop shadow effect to the icon. (Note: does not appear to be implemented) + + + + + Saturates the icon by increasing each color component + of the RGB triplet for each pixel in the icon. (Note: only ever appears to result in a completely unsaturated icon) + + + + + Alpha blends the icon. Alpha blending controls the transparency + level of an icon, according to the value of its alpha channel. + (Note: does not appear to be implemented). + + + + + Draws an image using the specified flags and state on XP systems. + + The image list from which an item will be drawn + Device context to draw to + Index of image to draw + X Position to draw at + Y Position to draw at + Drawing flags + Width to draw + Height to draw + State flags + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + Change the virtual list size of the given ListView (which must be in virtual mode) + + This will not change the scroll position + The listview to send a message to + How many rows should the list have? + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + + + Calculates the number of items that can fit vertically in the visible area of a list-view (which + must be in details or list view. + + The listView + Number of visible items per page + + + + For the given item and subitem, make it display the given image + + The listview to send a m to + row number (0 based) + subitem (0 is the item itself) + index into the image list + + + + Setup the given column of the listview to show the given image to the right of the text. + If the image index is -1, any previous image is cleared + + The listview to send a m to + Index of the column to modifiy + + Index into the small image list + + + + Does this version of the operating system have builtin sort indicators? + + Are there builtin sort indicators + XP and later have these + + + + Return the bounds of the update region on the given control. + + The BeginPaint() system call validates the update region, effectively wiping out this information. + So this call has to be made before the BeginPaint() call. + The control whose update region is be calculated + A rectangle + + + + Validate an area of the given control. A validated area will not be repainted at the next redraw. + + The control to be validated + The area of the control to be validated + + + + Select all rows on the given listview + + The listview whose items are to be selected + + + + Deselect all rows on the given listview + + The listview whose items are to be deselected + + + + Deselect a single row + + + + + + + Set the item state on the given item + + The listview whose item's state is to be changed + The index of the item to be changed + Which bits of the value are to be set? + The value to be set + + + + Scroll the given listview by the given deltas + + + + + true if the scroll succeeded + + + + Return the handle to the header control on the given list + + The listview whose header control is to be returned + The handle to the header control + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the index of the column of the header that is under the given point. + Return -1 if no column is under the pt + + The list we are interested in + The client co-ords + The index of the column under the point, or -1 if no column header is under that point + + + + Return the index of the divider under the given point. Return -1 if no divider is under the pt + + The list we are interested in + The client co-ords + The index of the divider under the point, or -1 if no divider is under that point + + + + Get the scroll position of the given scroll bar + + + + + + + + Change the z-order to the window 'toBeMoved' so it appear directly on top of 'reference' + + + + + + + + Make the given control/window a topmost window + + + + + + + Change the size of the window without affecting any other attributes + + + + + + + + + Show the given window without activating it + + The window to show + + + + Mark the given column as being selected. + + + The OLVColumn or null to clear + + This method works, but it prevents subitems in the given column from having + back colors. + + + + + A simple-minded implementation of a Dictionary that can handle null as a key. + + The type of the dictionary key + The type of the values to be stored + This is not a full implementation and is only meant to handle + collecting groups by their keys, since groups can have null as a key value. + + + + OLVListItems are specialized ListViewItems that know which row object they came from, + and the row index at which they are displayed, even when in group view mode. They + also know the image they should draw against themselves + + + + + Create a OLVListItem for the given row object + + + + + Create a OLVListItem for the given row object, represented by the given string and image + + + + + Gets the bounding rectangle of the item, including all subitems + + + + + Gets or sets how many pixels will be left blank around each cell of this item + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how the cells of this item will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the checkedness of this item. + + + Virtual lists don't handle checkboxes well, so we have to intercept attempts to change them + through the items, and change them into something that will work. + Unfortunately, this won't work if this property is set through the base class, since + the property is not declared as virtual. + + + + + Enable tri-state checkbox. + + .NET's Checked property was not built to handle tri-state checkboxes, + and will return True for both Checked and Indeterminate states. + + + + Gets if this item has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Gets whether or not this row can be selected and activated + + + + + Gets whether any cell on this item is showing a hyperlink + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the the model object that is source of the data for this list item. + + + + + Gets or sets the color that will be used for this row's background when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection BackColor will be used. + + + + + + Gets or sets the color that will be used for this row's foreground when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection ForeColor will be used. + + + + + + Return the sub item at the given index + + Index of the subitem to be returned + An OLVListSubItem + + + + Return bounds of the given subitem + + This correctly calculates the bounds even for column 0. + + + + A ListViewSubItem that knows which image should be drawn against it. + + + + + Create a OLVListSubItem + + + + + Create a OLVListSubItem that shows the given string and image + + + + + Gets or sets how many pixels will be left blank around this cell + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how this cell will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the model value is being displayed by this subitem. + + + + + Gets if this subitem has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the url that should be invoked when this subitem is clicked + + + + + Gets or sets whether this cell is selected + + + + + Return the state of the animatation of the image on this subitem. + Null means there is either no image, or it is not an animation + + + + + An indication of where a hit was within ObjectListView cell + + + + + Nowhere + + + + + On the text + + + + + On the image + + + + + On the checkbox + + + + + On the expand button (TreeListView) + + + + + in a button (cell must have ButtonRenderer) + + + + + in the cell but not in any more specific location + + + + + UserDefined location1 (used for custom renderers) + + + + + On the expand/collapse widget of the group + + + + + Somewhere on a group + + + + + Somewhere in a column header + + + + + Somewhere in a column header checkbox + + + + + Somewhere in a header divider + + + + + A collection of ListViewHitTest constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class encapsulate the information gathered during a OlvHitTest() + operation. + + Custom renderers can use HitTestLocation.UserDefined and the UserData + object to store more specific locations for use during event handlers. + + + + Create a OlvListViewHitTestInfo + + + + + Create a OlvListViewHitTestInfo when the header was hit + + + + + Where is the hit location? + + + + + Where is the hit location? + + + + + Which group was hit? + + + + + Custom renderers can use this information to supply more details about the hit location + + + + + Gets the item that was hit + + + + + Gets the subitem that was hit + + + + + Gets the part of the subitem that was hit + + + + + Gets the ObjectListView that was tested + + + + + Gets the model object that was hit + + + + + Gets the index of the row under the hit point or -1 + + + + + Gets the index of the column under the hit point + + + + + Gets the index of the header divider + + + + + Gets the column that was hit + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + A TreeDataSourceAdapter knows how to build a tree structure from a binding list. + + To build a tree + + + + Create a data source adaptor that knows how to build a tree structure + + + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets the DataTreeListView that is being managed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A IVirtualGroups is the interface that a virtual list must implement to support virtual groups + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + This is a safe, do nothing implementation of a grouping strategy + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + Provides grouping functionality to a FastObjectListView + + + + + Create groups for FastListView + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This is the COM interface that a ListView must be given in order for groups in virtual lists to work. + + + This interface is NOT documented by MS. It was found on Greg Chapell's site. This means that there is + no guarantee that it will work on future versions of Windows, nor continue to work on current ones. + + + + + Not sure what this does + + + + + + + Not sure what this does + + + + + + + Get the index of the item that occurs at the n'th position of the indicated group. + + Index of the group + Index within the group + Index of the item within the whole list + + + + Get the index of the group to which the given item belongs + + Index of the item within the whole list + Which occurences of the item is wanted + Index of the group + + + + Get the number of groups that contain the given item + + Index of the item within the whole list + How many groups does it occur within + + + + A hint to prepare any cache for the given range of requests + + + + + + + A default implementation of the IOwnerDataCallback interface + + + + + A VirtualListDataSource is a complete manner to provide functionality to a virtual list. + An object that implements this interface provides a VirtualObjectListView with all the + information it needs to be fully functional. + + Implementors must provide functioning implementations of at least GetObjectCount() + and GetNthObject(), otherwise nothing will appear in the list. + + + + Return the object that should be displayed at the n'th row. + + The index of the row whose object is to be returned. + The model object at the n'th row, or null if the fetching was unsuccessful. + + + + Return the number of rows that should be visible in the virtual list + + The number of rows the list view should have. + + + + Get the index of the row that is showing the given model object + + The model object sought + The index of the row showing the model, or -1 if the object could not be found. + + + + The ListView is about to request the given range of items. Do + whatever caching seems appropriate. + + + + + + + Find the first row that "matches" the given text in the given range. + + The text typed by the user + Start searching from this index. This may be greater than the 'to' parameter, + in which case the search should descend + Do not search beyond this index. This may be less than the 'from' parameter. + The column that should be considered when looking for a match. + Return the index of row that was matched, or -1 if no match was found + + + + Sort the model objects in the data source. + + + + + + + Add the given collection of model objects to this control. + + A collection of model objects + + + + Insert the given collection of model objects to this control at the position + + Index where the collection will be added + A collection of model objects + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + + + Set the collection of objects that this control will show. + + + + + + Update/replace the nth object with the given object + + + + + + + This extension allow virtual lists to filter their contents + + + + + All subsequent retrievals on this data source should be filtered + through the given filters. null means no filtering of that kind. + + + + + + + A do-nothing implementation of the VirtualListDataSource interface. + + + + + Creates an AbstractVirtualListDataSource + + + + + + The list view that this data source is giving information to. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + This is a useful default implementation of SearchText method, intended to be called + by implementors of IVirtualListDataSource. + + + + + + + + + + + + + + + + + + This class mimics the behavior of VirtualObjectListView v1.x. + + + + + Creates a VirtualListVersion1DataSource + + + + + + How will the n'th object of the data source be fetched? + + + + + + + + + + + + + + + + + + + + + + Designer for and its subclasses. + + + + This designer removes properties and events that are available on ListView but that are not + useful on ObjectListView. + + + We can't inherit from System.Windows.Forms.Design.ListViewDesigner, since it is marked internal. + So, this class uses reflection to create a ListViewDesigner and then forwards messages to that designer. + + + + + + Initializes the designer with the specified component. + + The to associate the designer with. This component must always be an instance of, or derive from, . + + + + Initializes a newly created component. + + A name/value dictionary of default values to apply to properties. May be null if no default values are specified. + + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Removes the duplicate DockingActionList added by this designer to the . + + + adds an internal DockingActionList : 'Dock/Undock in Parent Container'. + But the default designer has already added that action list. So we need to remove one. + + + + + Adjusts the set of properties the component exposes through a . + + An containing the properties for the class of the component. + + + + Allows a designer to add to the set of events that it exposes through a . + + The events for the class of the component. + + + + Allows a designer to change or remove items from the set of attributes that it exposes through a . + + The attributes for the class of the component. + + + + Allows a designer to change or remove items from the set of events that it exposes through a . + + The events for the class of the component. + + + + Gets the design-time action lists supported by the component associated with the designer. + + + The design-time action lists supported by the component associated with the designer. + + + + + Gets the collection of components associated with the component managed by the designer. + + + The components that are associated with the component managed by the designer. + + + + + Indicates whether a mouse click at the specified point should be handled by the control. + + + true if a click at the specified point is to be handled by the control; otherwise, false. + + A indicating the position at which the mouse was clicked, in screen coordinates. + + + + Processes Windows messages and optionally routes them to the control. + + The to process. + + + + This class modifies a ListViewActionList, by removing the "Edit Items" and "Edit Groups" actions. + + + + That class is internal, so we cannot simply subclass it, which would be simplier. + + + Action lists use reflection to determine if that action can be executed, so we not + only have to modify the returned collection of actions, but we have to implement + the properties and commands that the returned actions use. + + + + + This class works in conjunction with the OLVColumns property to allow OLVColumns + to be added to the ObjectListView. + + + + + Create a OLVColumnCollectionEditor + + + + + + What type of object does this editor create? + + + + + + Edit a given value + + + + + + + + + What text should be shown in the list for the given object? + + + + + + + Control how the overlay is presented in the IDE + + + + + An OLVColumn knows which aspect of an object it should present. + + + The column knows how to: + + extract its aspect from the row object + convert an aspect to a string + calculate the image for the row object + extract a group "key" from the row object + convert a group "key" into a title for the group + + For sorting to work correctly, aspects from the same column + must be of the same type, that is, the same aspect cannot sometimes + return strings and other times integers. + + + + + How should the button be sized? + + + + + 每个单元格都将具有相同大小的按钮，如ButtonSize属性所示 + + + + + 每个单元格都将绘制一个填充单元格的按钮，该按钮由ButtonPadding插入 + + + + + 将调整每个按钮的大小以包含文本内容 + + + + + Create an OLVColumn + + + + + Initialize a column to have the given title, and show the given aspect + + The title of the column + The aspect to be shown in the column + + + + 此委托将用于提取要在此列中显示的值。 + + + 如果设置, AspectName属性将被忽略. + + + + + 请记住，如果当前列的AspectGetter是内部生成的，依旧可以随意重新生成 + + + + + 应调用以获取要在此列中显示的值的属性或方法的名称。 + 仅当未指定ValueGetterDelegate时才使用此选项。 + + 此名称可以用来表示对属性或无参数方法的链引用。 + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + 此委托将用于将编辑后的值放回模型对象中。 + + + 如果IsEdable==false，则不执行任何操作。 + + + + + 用于将要在此列中显示的Aspect转换为字符串的委托。 + + 如果设置了此值，AspectToStringFormat将被忽略。 + + + + 将Aspect转换成字符串的格式文本 + + + 此字符串作为第一个参数传递给String.Format()方法。 + 仅当尚未设置AspectToStringConverter时才使用此选项。 + "{0:C}" 表示转换数字到货币 + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取用户操作是否可以隐藏此列 + + 这会同时考虑Hideable属性以及此列是否为列表视图的主列(列0)。 + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + + + 如果控件不是所有者绘制(owner drawn)的，则始终将其视为true。 + + 如果该值为False(默认值)并且控件是所有者绘制(owner drawn)的， + ObjectListView将尝试计算单元格实际内容的宽度，然后将编辑控件的大小调整为恰到好处的宽度。 + 如果为真，则无论单元格的内容如何，都将使用单元格的整个宽度。 + + 如果未在列上设置此属性，则将使用控件中的值 + + 仅当控件处于详细信息视图中时才使用此值。 + 无论此设置如何，开发人员都可以通过侦听CellEditStarting事件来指定编辑控件的确切大小。 + + + + + 获取编辑此列中的单元格时是否应使用整个单元格 + + 这将计算当前有效值，该值可能与CellEditUseWholeCell不同 + + + + 获取或设置此列中此单元格周围将留空的像素数 + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + + 获取或设置此列中的单元格垂直对齐的方式。 + + + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + 如果未设置，将使用控件本身的值。 + + + + + + 获取或设置此列是否显示复选框。 + + + 在第0列上设置此选项不起作用。列0复选框由ObjectListView本身的CheckBox属性控制。 + + + + + Gets or sets the clustering strategy used for this column. + + + + The clustering strategy is used to build a Filtering menu for this item. + If this is null, a useful default will be chosen. + + + To disable filtering on this colummn, set UseFiltering to false. + + + Cluster strategies belong to a particular column. The same instance + cannot be shared between multiple columns. + + + + + + 获取或设置是否启用此列中的按钮(如果此列是按钮)，即使该行本身被禁用 + + + + + 此列是否应该调整大小以填充列表视图中的空闲空间？ + + + + 如果希望两列(或更多列)平均共享可用空间，请将此属性设置为True。 + 如果希望此列具有更大或更小的可用空间份额，则必须显式设置FreeSpaceProportion属性。 + + + 空间填充列仍然由MinimumWidth和MaximumWidth属性控制。 + + /// + + + + 控件中未占用的水平空间应分配给此列的比例是多少？ + + + + 在某些情况下，如果列(通常是最右边的列)可以随着列表视图的扩展而扩展， + 这样就可以在不必水平滚动的情况下尽可能多地看到列(您永远不应该让用户必须水平滚动任何内容！)。 + + + 调整空间填充列的大小以占据列表视图的未占用宽度的一部分(未占用宽度是一旦所有非填充列都被赋予其空间后剩余的宽度)。 + 此属性指示将分配给此列的未占用空间的相对比例。此属性的实际值并不重要，重要的是它的值相对于其他列中的值。 + 例子: + + + 如果只有一个空间填充列，则无论FreeSpaceProportion中的值如何，都将为其提供所有可用空间。 + + + 如果有两个或多个空间填充列，并且它们的FreeSpaceProportion值都相同，则它们将平等地共享空闲空间。 + + + 如果FreeSpaceProportion有三个值为3、2和1的空间填充列，则第一列将占用一半的空闲空间，第二列将占用三分之一的空闲空间，第三列将占用六分之一的空闲空间。 + + + + + + + + 获取或设置在单击此列的标题时是否对此列值重新生成组。 + + + 此设置仅在ShowGroups为true时使用。 + + 如果为False，则单击标题不会重建组。 + + 如果为false，则仍会激发BeforeCreatingGroups事件，这些事件可用于根据具体情况进行分组或提供反馈。 + + + + + 当组已创建但尚未成为真正的ListViewGroup时，将调用此委托。用户可以利用此机会填写有关该组的许多其他详细信息。 + + + + + 调用此委托以获取对象，该对象是给定行所属的组的键。 + + + + + 调用此委托将组键转换为该组的标题。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，应如何设置标签的格式 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 + + + "{0} [{1} items]" + + + + 获取this.GroupWithItemCountFormat或默认值 + + + 如果未设置GroupWithItemCountFormat，则如果可能，将从ObjectListView中获取其值。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，如果组中只有一个项目，标签应该如何格式化 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 (始终为1) + + + "{0} [{1} item]" + + + + 获取this.GroupWithItemCountSingularFormat或默认值 + + + 如果未设置此值，将使用列表视图中的值 + + + + + 获取是否应在列标题中使用筛选器指示符绘制此列。 + + + + + 获取或设置将用于所有者绘制标题列的委托。 + + + + + 获取或设置将用于绘制此列标题的样式 + + 仅当拥有的ObjectListView将HeaderUsesThemes设置为False时才使用此选项。 + + + + 获取或设置绘制此列的标题时使用的字体 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置绘制此列标题文本的颜色 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置将在列标题中显示的图像键 + + 这仅在HeaderUsesThemes为false时使用 + + + + 获取或设置Header文本的对齐方式 + + + + + 返回Header的文本对齐方式。这将是显式设置的，或者将遵循列中文本的对齐方式 + + + + + 获取转换为StringAlignment的Header对齐方式 + + + + + 获取此列的标题中是否有图像 + + + + + 获取或设置此Header是否在Header中放置复选框 + + + + + 获取或设置此Header是否在Header中放置三态复选框 + + + + + 获取或设置此列Header中复选框的选中状态 + + + + + 获取或设置选中/取消选中标题复选框的值是否会导致将此列中所有单元格的复选框设置为相同的选中/取消选中。 + 默认值为true. + + + + 当单元格的复选框状态改变时，该函数不会与自动更新标题的功能相反。 + + + 此属性在TreeListView上的行为最好描述为未定义，应该避免。 + + + 此操作(检查/取消检查所有行)的性能为O(n)，其中n是行数。它将在大型虚拟列表上工作，但可能需要一些时间。 + + + + + + 获取或设置是否禁用标题中的复选框 + + + 单击禁用的复选框不会更改其值，但会引发HeaderCheckBoxChanging事件，使程序员有机会执行适当的操作。 + + + + 获取或设置用户是否可以隐藏此列。 + + + 无论此设置如何，列0永远不能隐藏。 + + + + + 获取或设置此列中的文本值是否类似于超链接 + + + + + 这是属性的名称，将调用该属性来获取应该在此列中显示的图像的图像选择器。 + 它可以返回int、String、Image或NULL。 + + + 如果ImageGetter不为空，则忽略此项。 + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 调用此委托以获取应该在此列中显示的图像的图像选择器。它可以返回int、String、Image或NULL。 + + + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 获取或设置此列是否在其单元格中绘制按钮 + + + + 如果将其设置为true，则列的呈现器将成为ColumnButtonRenender(如果尚未成为ColumnButtonRenender)。如果设置为False，则将丢弃以前的任何按钮渲染器 + + 如果单元格的Aspect为Null或空，则不会在单元格中绘制任何内容。 + + + + Create a ColumnButtonRenderer to draw buttons in this column + + + + + + Fill in details to our ColumnButtonRenderer based on the properties set on the column + + + + + 获取或设置按钮可以占用的最大宽度。 + -1 表示不限制最大宽度 + + 仅当SizingMode为TextBound时才生效 + + + + 获取或设置当SizingMode为TextBound时单元格周围的额外空间 + + + + + 获取或设置SizingMode为FixedBound时按钮的大小 + + 如果未设置，将使用单元格的边界 + + + + 获取或设置此列显示按钮时如何调整每个按钮的大小 + + + + + 此列中显示的值是否可以编辑 + + 此默认值为false，因为控制列表视图的可编辑性的主要方法是列表视图本身。 + 列表视图可编辑后，所有列也可编辑，除非程序员显式将它们标记为不可编辑 + + + + 是否是固定宽度 + + + + + 获取/设置当视图切换到平铺视图(TileView)时是否使用此列。 + + 无论此设置如何，第0列始终包含在平铺视图中。平铺视图不能很好地处理许多“列”信息。两三个最好。 + + + + 获取或设置Header的文本是否应垂直呈现。 + + + 如果为True，最好将ToolTipText设置为列的名称，以便于阅读。 + 垂直Header仅为文本。他们不会画出图像。 + + + + + 该列是否可见 + + 更改此值后，必须调用RebuildColumns()才能使更改生效。 + + + + 此列最后一次定位在详细信息视图列中的位置是什么 + + DisplayIndex是易失性的。一旦从控件中移除列，就无法发现它在显示顺序中的位置。 + 即使列不在列表视图的活动列中，此属性也会保护该信息。 + + + + 列最大宽度 + + -1表示不限制. 将该值指定为与MinimumWidth相同的值，以生成固定宽度的列。 + + + + 列最小宽度 + + -1表示不限制. 将该值指定为与MaximumWidth相同的值，以生成固定宽度的列。 + + + + Get/set the renderer that will be invoked when a cell needs to be redrawn + + + + + This delegate is called when a cell needs to be drawn in OwnerDrawn mode. + + This method is kept primarily for backwards compatibility. + New code should implement an IRenderer, though this property will be maintained. + + + + 获取或设置执行文本搜索时是否使用此列的单元格中的文本。 + + + + 如果为False，则文本筛选器在查找匹配项时不会尝试搜索此列单元格。 + + + + + + 获取或设置一个委托，该委托将返回在使用基于文本的筛选器时应考虑进行文本匹配的文本值数组。 + + + + + 获取或设置此列的标题是否将包括该列的文本。 + + + + 如果为false，则列标题中呈现的唯一内容将是来自 . + + 只有在以下情况下才会考虑此设置: ObjectListView中的 为false . + + + + + 获取或设置当用户单击此列的标题时是否重新排序列表内容。 + + + + 如果为False，则单击标题将不会对列表进行排序，但也不会提供有关列表未排序原因的任何反馈。提供适当的反馈是程序员的责任。 + + 如果为false，则仍会触发BeforeSorting事件，该事件可用于根据具体情况进行排序或提供反馈。 + + + + + 获取或设置列内容的水平对齐方式。 + + NET将不允许列0具有除左对齐以外的任何对齐方式。我们不能更改列表视图的基本行为，但当所有者绘制时，列0现在可以有其他对齐方式。 + + + + 获取列文本对齐的StringAlignment等效项 + + + + + 当鼠标悬停在该列的标题上时，应该显示什么字符串？ + + 如果拥有的ObjectListView上安装了HeaderToolTipGetter，则将忽略此值。 + + + + 此列是否应该有一个三态复选框 + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + + + + + 按列纵横比的首字母对对象进行分组 + + + 一种常见的模式是按该组的值的首字母对列进行分组。aspect必须是字符串(显然)。 + + + + + 获取或设置此列是否应为用户可筛选的列 + + + + + Gets or sets a filter that will only include models where the model's value + for this column is one of the values in ValuesChosenForFiltering + + + + + Gets or sets the values that will be used to generate a filter for this + column. For a model to be included by the generated filter, its value for this column + must be in this list. If the list is null or empty, this column will + not be used for filtering. + + + + + 列宽 + + + + + 获取或设置此列单元格的内容是否应自动换行 + + 如果此列使用自定义IRenender(即，不是从BaseRenender派生的)，则该呈现器负责实现自动换行。 + + + + For a given group value, return the string that should be used as the groups title. + + The group key that is being converted to a title + string + + + + Get the checkedness of the given object for this column + + The row object that is being displayed + The checkedness of the object + + + + Put the checkedness of the given object for this column + + The row object that is being displayed + + The checkedness of the object + + + + For a given row object, extract the value indicated by the AspectName property of this column. + + The row object that is being displayed + An object, which is the aspect named by AspectName + + + + For a given row object, return the object that is the key of the group that this row belongs to. + + The row object that is being displayed + Group key object + + + + For a given row object, return the image selector of the image that should displayed in this column. + + The row object that is being displayed + int or string or Image. int or string will be used as index into image list. null or -1 means no image + + + + Return the image that represents the check box for the given model + + + + + + + For a given row object, return the strings that will be searched when trying to filter by string. + + + This will normally be the simple GetStringValue result, but if this column is non-textual (e.g. image) + you might want to install a SearchValueGetter delegate which can return something that could be used + for text filtering. + + + The array of texts to be searched. If this returns null, search will not match that object. + + + + For a given row object, return the string representation of the value shown in this column. + + + For aspects that are string (e.g. aPerson.Name), the aspect and its string representation are the same. + For non-strings (e.g. aPerson.DateOfBirth), the string representation is very different. + + + + + + + For a given row object, return the object that is to be displayed in this column. + + The row object that is being displayed + An object, which is the aspect to be displayed + + + + Update the given model object with the given value using the column's + AspectName. + + The model object to be updated + The value to be put into the model + + + + Update the given model object with the given value + + The model object to be updated + The value to be put into the model + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Decide the clustering strategy that will be used for this column + + + + + + Gets or sets the type of data shown in this column. + + If this is not set, it will try to get the type + by looking through the rows of the listview. + + + + This event is triggered when the visibility of this column changes. + + + + + Tell the world when visibility of a column changes. + + + + + Create groupies + This is an untyped version to help with Generator and OLVColumn attributes + + + + + + + Create groupies + + + + + + + + Create groupies + + + + + + + + + Create groupies + + + + + + + + + + Create groupies. + Install delegates that will group the columns aspects into progressive partitions. + If an aspect is less than value[n], it will be grouped with description[n]. + If an aspect has a value greater than the last element in "values", it will be grouped + with the last element in "descriptions". + + Array of values. Values must be able to be + compared to the aspect (using IComparable) + The description for the matching value. The last element is the default description. + If there are n values, there must be n+1 descriptions. + + this.salaryColumn.MakeGroupies( + new UInt32[] { 20000, 100000 }, + new string[] { "Lowly worker", "Middle management", "Rarified elevation"}); + + + + + + + + + Create groupies based on exact value matches. + + + Install delegates that will group rows into partitions based on equality of this columns aspects. + If an aspect is equal to value[n], it will be grouped with description[n]. + If an aspect is not equal to any value, it will be grouped with "[other]". + + Array of values. Values must be able to be + equated to the aspect + The description for the matching value. + + this.marriedColumn.MakeEqualGroupies( + new MaritalStatus[] { MaritalStatus.Single, MaritalStatus.Married, MaritalStatus.Divorced, MaritalStatus.Partnered }, + new string[] { "Looking", "Content", "Looking again", "Mostly content" }); + + + + + + + + + An adorment is the common base for overlays and decorations. + + + + + Gets or sets the corner of the adornment that will be positioned at the reference corner + + + + + Gets or sets location within the reference rectange where the adornment will be drawn + + This is a simplied interface to ReferenceCorner and AdornmentCorner + + + + Gets or sets the offset by which the position of the adornment will be adjusted + + + + + Gets or sets the point of the reference rectangle to which the adornment will be aligned. + + + + + Gets or sets the degree of rotation by which the adornment will be transformed. + The centre of rotation will be the center point of the adornment. + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + Calculate the location of rectangle of the given size, + so that it's indicated corner would be at the given point. + + The point + + Which corner will be positioned at the reference point + + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.TopLeft) -> Point(50, 100) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.MiddleCenter) -> Point(45, 90) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.BottomRight) -> Point(40, 80) + + + + Calculate a rectangle that has the given size which is positioned so that + its alignment point is at the reference location of the given rect. + + + + + + + + Create a rectangle of the given size which is positioned so that + its indicated corner is at the indicated corner of the reference rect. + + + + + + + + + Creates a rectangle so that its bottom left is at the centre of the reference: + corner=BottomLeft, referenceCorner=MiddleCenter + This is a powerful concept that takes some getting used to, but is + very neat once you understand it. + + + + + Return the point at the indicated corner of the given rectangle (it doesn't + have to be a corner, but a named location) + + The reference rectangle + Which point of the rectangle should be returned? + A point + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.TopLeft) -> Point(0, 0) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.MiddleCenter) -> Point(25, 50) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.BottomRight) -> Point(50, 100) + + + + Given the item and the subitem, calculate its bounds. + + + + + + + + Apply any specified rotation to the Graphic content. + + The Graphics to be transformed + The rotation will be around the centre of this rect + + + + Reverse the rotation created by ApplyRotation() + + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Gets or sets the image that will be drawn + + + + + Gets or sets if the image will be shrunk to fit with its horizontal bounds + + + + + Draw the image in its specified location + + The Graphics used for drawing + The bounds of the rendering + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How big should the image be? + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location, scaled so that it is not wider + than the given rectangle. Height is scaled proportional to the width. + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Utility to draw a bitmap transparenly. + + + + + + + + + An adornment that will draw text + + + + + Gets or sets the background color of the text + Set this to Color.Empty to not draw a background + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the border around the billboard. + Set this to Color.Empty to remove the border + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the width of the border around the text + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the font that will be used to draw the text + + + + + Gets the font that will be used to draw the text or a reasonable default + + + + + Does this text have a background? + + + + + Does this overlay have a border? + + + + + Gets or sets the maximum width of the text. Text longer than this will wrap. + 0 means no maximum. + + + + + Gets or sets the formatting that should be used on the text + + + + + Gets or sets the text that will be drawn + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the text + + + + + Gets or sets whether the text will wrap when it exceeds its bounds + + + + + Draw our text with our stored configuration in relation to the given + reference rectangle + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + + + + Draw the given text with our stored configuration + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + The text to draw + How opaque should be text be + + + + Draw the text with a border + + The Graphics used for drawing + The bounds within which the text should be drawn + The text to draw + How opaque should be text be + + + + Return the rectangle that will be the precise bounds of the displayed text + + + + + The bounds of the text + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectagle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + A decoration is an overlay that draws itself in relation to a given row or cell. + Decorations scroll when the listview scrolls. + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + An AbstractDecoration is a safe do-nothing implementation of the IDecoration interface + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + Gets the bounds of the decorations row + + + + + Get the bounds of the decorations cell + + + + + Draw the decoration + + + + + + + + This decoration draws a slight tint over a column of the + owning listview. If no column is explicitly set, the selected + column in the listview will be used. + The selected column is normally the sort column, but does not have to be. + + + + + Create a TintedColumnDecoration + + + + + Create a TintedColumnDecoration + + + + + + Gets or sets the column that will be tinted + + + + + Gets or sets the color that will be 'tinted' over the selected column + + + + + Draw a slight colouring over our tinted column + + + This overlay only works when: + - the list is in Details view + - there is at least one row + - there is a selected column (or a specified tint column) + + + + + + + + This decoration draws an optionally filled border around a rectangle. + Subclasses must override CalculateBounds(). + + + + + Create a BorderDecoration + + + + + Create a BorderDecoration + + The pen used to draw the border + + + + Create a BorderDecoration + + The pen used to draw the border + The brush used to fill the rectangle + + + + Gets or sets the pen that will be used to draw the border + + + + + Gets or sets the padding that will be added to the bounds of the item + before drawing the border and fill. + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the brush that will be used to fill the border + + This value is ignored when using gradient brush + + + + Gets or sets the color that will be used as the start of a gradient fill. + + This and FillGradientTo must be given value to show a gradient + + + + Gets or sets the color that will be used as the end of a gradient fill. + + This and FillGradientFrom must be given value to show a gradient + + + + Gets or sets the fill mode that will be used for the gradient. + + + + + Draw a filled border + + + + + + + + Subclasses should override this to say where the border should be drawn + + + + + + Do the actual work of drawing the filled border + + + + + + + Create a GraphicsPath that represents a round cornered rectangle. + + + If this is 0 or less, the rectangle will not be rounded. + + + + + Instances of this class draw a border around the decorated row + + + + + Gets or sets the index of the left most column to be used for the border + + + + + Gets or sets the index of the right most column to be used for the border + + + + + Calculate the boundaries of the border + + + + + + Instances of this class draw a border around the decorated subitem. + + + + + Calculate the boundaries of the border + + + + + + This decoration puts a border around the cell being edited and + optionally "lightboxes" the cell (makes the rest of the control dark). + + + + + Create a EditingCellBorderDecoration + + + + + Create a EditingCellBorderDecoration + + Should the decoration use a lighbox display style? + + + + Gets or set whether the decoration should make the rest of + the control dark when a cell is being edited + + If this is true, FillBrush is used to overpaint + the control. + + + + Draw the decoration + + + + + + + + This decoration causes everything *except* the row under the mouse to be overpainted + with a tint, making the row under the mouse stand out in comparison. + The darker and more opaque the fill color, the more obvious the + decorated row becomes. + + + + + Create a LightBoxDecoration + + + + + Draw a tint over everything in the ObjectListView except the + row under the mouse. + + + + + + + + Instances of this class put an Image over the row/cell that it is decorating + + + + + Create an image decoration + + + + + Create an image decoration + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Instances of this class draw some text over the row/cell that they are decorating + + + + + Create a TextDecoration + + + + + Create a TextDecoration + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + The interface for an object which can draw itself over the top of + an ObjectListView. + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + An interface for an overlay that supports variable levels of transparency + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + A null implementation of the IOverlay interface + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + How transparent should this overlay be? + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Create an ImageOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + An overlay that will draw text over the top of the ObjectListView + + + + + Create a TextOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Gets or sets whether the border will be drawn with rounded corners + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + A Billboard overlay is a TextOverlay positioned at an absolute point + + + + + Create a BillboardOverlay + + + + + Gets or sets where should the top left of the billboard be placed + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Renderers are the mechanism used for owner drawing cells. As such, they can also handle + hit detection and positioning of cell editing rectangles. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + Renderers that implement this interface will have the filter property updated, + each time the filter on the ObjectListView is updated. + + + + + + + + + + An AbstractRenderer is a do-nothing implementation of the IRenderer interface. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + This class provides compatibility for v1 RendererDelegates + + + + + The renderer delegate that this renderer wraps + + + + + A BaseRenderer provides useful base level functionality for any custom renderer. + + + Subclasses will normally override the Render or OptionalRender method, and use the other + methods as helper functions. + + + + + Can the renderer wrap lines that do not fit completely within the cell? + + Wrapping text doesn't work with the GDI renderer. + + + + Gets or sets how many pixels will be left blank around this cell + + + + This setting only takes effect when the control is owner drawn. + + for more details. + + + + + Gets the horiztonal alignment of the column + + + + + Gets or sets how cells drawn by this renderer will be vertically aligned. + + + + If this is not set, the value from the column or control itself will be used. + + + + + + Gets the optional padding that this renderer should apply before drawing. + This property considers all possible sources of padding + + + + + Gets the vertical cell alignment that should govern the rendering. + This property considers all possible sources. + + + + + Gets or sets the image list from which keyed images will be fetched + + + + + When rendering multiple images, how many pixels should be between each image? + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Get or set the aspect of the model object that this renderer should draw + + + + + What are the bounds of the cell that is being drawn? + + + + + Get or set the OLVColumn that this renderer will draw + + + + + Get/set the event that caused this renderer to be called + + + + + Get/set the event that caused this renderer to be called + + + + + Gets or sets the font to be used for text in this cell + + + + + Gets the image list from which keyed images will be fetched + + + + + Should this renderer fill in the background before drawing? + + + + + Cache whether or not our item is selected + + + + + Is this renderer being used on a printer context? + + + + + Get or set the listitem that this renderer will be drawing + + + + + Get/set the listview for which the drawing is to be done + + + + + Get the specialized OLVSubItem that this renderer is drawing + + This returns null for column 0. + + + + Get or set the model object that this renderer should draw + + + + + Get or set the list subitem that this renderer will be drawing + + + + + The brush that will be used to paint the text + + + + + Will this renderer use the custom images from the parent ObjectListView + to draw the checkbox images. + + + + If this is true, the renderer will use the images from the + StateImageList to represent checkboxes. 0 - unchecked, 1 - checked, 2 - indeterminate. + + If this is false (the default), then the renderer will use .NET's standard + CheckBoxRenderer. + + + + + Align the second rectangle with the first rectangle, + according to the alignment of the column + + The cell's bounds + The rectangle to be aligned within the bounds + An aligned rectangle + + + + Calculate the left edge of the rectangle that aligns the outer rectangle with the inner one + according to this renderer's horizontal alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with the inner rectangle + according to this renders vertical alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with a rectangle of the given height + according to this renderer's vertical alignment + + + + + + + + Calculate the space that our rendering will occupy and then align that space + with the given rectangle, according to the Column alignment + + + Pre-padded bounds of the cell + + + + + Calculate the size of the content of this cell. + + + Pre-padded bounds of the cell + The width and height of the content + + + + Calculate the bounds of a checkbox given the (pre-padded) cell bounds + + + Pre-padded cell bounds + + + + + How much space will the check box for this cell occupy? + + Only column 0 can have check boxes. Sub item checkboxes are + treated as images + + + + + + How much space will the check box for this row occupy? + If the list doesn't have checkboxes, or this isn't the primary column, + this returns an empty size. + + + + + + + How much horizontal space will the image of this cell occupy? + + + + + + + + How much vertical space will the image of this cell occupy? + + + + + + + + How much space will the image of this cell occupy? + + + + + + + + How much horizontal space will the text of this cell occupy? + + + + + + + + + How much space will the text of this cell occupy? + + + + + + + + + Return the Color that is the background color for this item's cell + + The background color of the subitem + + + + Return the color of the background color when the item is selected + + The background color of the subitem + + + + Return the color to be used for text in this cell + + The text color of the subitem + + + + Return the color of the foreground color when the item is selected + + The foreground color of the subitem + + + + Return the image that should be drawn against this subitem + + An Image or null if no image should be drawn. + + + + Return the actual image that should be drawn when keyed by the given image selector. + An image selector can be: + an int, giving the index into the image list + a string, giving the image key into the image list + an Image, being the image itself + + + The value that indicates the image to be used + An Image or null + + + + + + + + Return the string that should be drawn within this + + + + + + Return the Color that is the background color for this item's text + + The background color of the subitem's text + + + + Render the whole item in a non-details view. + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Render one cell + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Calculate which part of this cell was hit + + + + + + + + Calculate the edit rectangle + + + + + + + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method. + The graphics context that should be used for drawing + The bounds of the subitem cell + Returns whether the rendering has already taken place. + If this returns false, the default processing will take over. + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method if they never want + to fall back on the default processing + The graphics context that should be used for drawing + The bounds of the subitem cell + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw the standard "[checkbox] [image] [text]" cell after the state properties have been initialized. + + + + + + + Change the bounds of the given rectangle to take any cell padding into account + + + + + + + Perform normal hit testing relative to the given aligned content bounds + + + + + + + + + + This method calculates the bounds of the text within a standard layout + (i.e. optional checkbox, optional image, text) + + This method only works correctly if the state of the renderer + has been fully initialized (see BaseRenderer.GetEditRectangle) + + + + + + + + Apply any padding to the given bounds, and then align a rectangle of the given + size within that padded area. + + + + + + + + + Draw the given image aligned horizontally within the column. + + + Over tall images are scaled to fit. Over-wide images are + truncated. This is by design! + + Graphics context to use for drawing + Bounds of the cell + The image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Pre-padded bounds of the cell + + + + Fill in the background of this cell + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the primary check box of this row (checkboxes in other sub items use a different method) + + Graphics context to use for drawing + The pre-aligned and padded target rectangle + + + + Calculate the CheckBoxState we need to correctly draw the given state + + + + + + + Should this checkbox be drawn as disabled? + + + + + Is the current item hot (i.e. under the mouse)? + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The optional image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the given collection of image selectors + + + + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The string to be drawn + + + + Print the given text in the given rectangle using only GDI routines + + + + + + The native list control uses GDI routines to do its drawing, so using them + here makes the owner drawn mode looks more natural. + This method doesn't honour the CanWrap setting on the renderer. All + text is single line + + + + + Gets the cell's vertical alignment as a TextFormatFlag + + + + + + Gets the StringFormat needed when drawing text using GDI+ + + + + + Print the given text in the given rectangle using normal GDI+ .NET methods + + Printing to a printer dc has to be done using this method. + + + + This renderer highlights substrings that match a given text filter. + + + + + Create a HighlightTextRenderer + + + + + Create a HighlightTextRenderer + + + + + + Create a HighlightTextRenderer + + + + + + Gets or set how rounded will be the corners of the text match frame + + + + + Gets or set the brush will be used to paint behind the matched substrings. + Set this to null to not fill the frame. + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Gets or set the pen will be used to frame the matched substrings. + Set this to null to not draw a frame. + + + + + Gets or sets whether the frame around a text match will have rounded corners + + + + + Gets or set the text that will be highlighted + + + + + Gets or sets the manner in which substring will be compared. + + + Use this to control if substring matches are case sensitive or insensitive. + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw text using GDI + + + + + + + + Draw the highlighted text using GDI + + + + + + + + Draw an indication around the given frame that shows a text match + + + + + + + + + + Draw the text using GDI+ + + + + + + + + Draw the highlighted text using GDI+ + + + + + + + + Gets whether the renderer should actually draw highlighting + + + + + Return a GraphicPath that is a round cornered rectangle + + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + + + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + This class maps a data value to an image that should be drawn for that value. + + It is useful for drawing data that is represented as an enum or boolean. + + + + Return a renderer that draw boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + A Renderer + + + + Return a renderer that draw tristate boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + Draw this when our data value is null + A Renderer + + + + Make a new empty renderer + + + + + Make a new renderer that will show the given image when the given key is the aspect value + + The data value to be matched + The image to be shown when the key is matched + + + + Make a new renderer that will show the given images when it receives the given keys + + + + + + + + + Build a renderer from the given array of keys and their matching images + + An array of key/image pairs + + + + Register the image that should be drawn when our Aspect has the data value. + + Value that the Aspect must match + An ImageSelector -- an int, string or image + + + + Render our value + + + + + + + Draw a collection of images + + + + + + + + Draw one image + + + + + + + + This renderer draws just a checkbox to match the check state of our model object. + + + + + Draw our cell + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + Handle the HitTest request + + + + + + + + + Render an image that comes from our data source. + + The image can be sourced from: + + a byte-array (normally when the image to be shown is + stored as a value in a database) + an int, which is treated as an index into the image list + a string, which is treated first as a file name, and failing that as an index into the image list + an ICollection of ints or strings, which will be drawn as consecutive images + + If an image is an animated GIF, it's state is stored in the SubItem object. + By default, the image renderer does not render animations (it begins life with animations paused). + To enable animations, you must call Unpause(). + In the current implementation (2009-09), each column showing animated gifs must have a + different instance of ImageRenderer assigned to it. You cannot share the same instance of + an image renderer between two animated gif columns. If you do, only the last column will be + animated. + + + + + Make an empty image renderer + + + + + Make an empty image renderer that begins life ready for animations + + + + + Finalizer + + + + + Should the animations in this renderer be paused? + + + + + Gets a timer that can be used to trigger redraws on animations + + + + + Pause any animations + + + + + Unpause any animations + + + + + Draw our image + + + + + + + Translate our Aspect into an image. + + The strategy is: + If its a byte array, we treat it as an in-memory image + If it's an int, we use that as an index into our image list + If it's a string, we try to load a file by that name. If we can't, + we use the string as an index into our image list. + + An image + + + + This is the method that is invoked by the timer. It basically switches control to the listview thread. + + not used + + + + This is the OnTimer callback, but invoked in the same thread as the creator of the ListView. + This method can use all of ListViews methods without creating a CrossThread exception. + + + + + Instances of this class kept track of the animation state of a single image. + + + + + Is the given image an animation + + The image to be tested + Is the image an animation? + + + + Create an AnimationState in a quiet state + + + + + Create an animation state for the given image, which may or may not + be an animation + + The image to be rendered + + + + Does this state represent a valid animation + + + + + Advance our images current frame and calculate when it will expire + + + + + Render our Aspect as a progress bar + + + + + Make a BarRenderer + + + + + Make a BarRenderer for the given range of data values + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + 此栏是否应以系统样式绘制？ + + + + + 将从我们的单元格边框开始绘制多少像素的条形图 + + + + + 在绘制进度条之前，将使用什么颜色填充控件内部？ + + + + + 进度条边框颜色 + + + + + 进度条的边框像素宽 + + + + + 进度条的“填充”部分应该是什么颜色？ + + 仅当GradientStartColor为Color.Empty时才使用此选项 + + + + 使用渐变以此颜色开始填充进度条 + + + + + 使用渐变填充以此颜色结尾的进度条 + + + + + 使用渐变以此颜色开始填充渐满进度条 + + + + + 使用渐变填充以此颜色结尾的渐满进度条 + + + + + 无论列变得多宽，进度条都不会比这个宽。 + + + + + 无论单元格有多高，进度条都不会比这个高 + + + + + 预期的最小数据值。小于此值的值将显示一个空条。 + + + + + 接近满时的值,高于该值时，显示不同颜色，小于等于MinimumValue或大于MaximumValue值，则表示未设置该值 + + + + + 范围的最大值。大于此值的值将给出一个完整的条形。 + + + + + The Pen that will draw the frame surrounding this bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the background of the bar + + + + + Draw this progress bar using a gradient + + + + + + + Draw our aspect + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + An ImagesRenderer draws zero or more images depending on the data returned by its Aspect. + + This renderer's Aspect must return a ICollection of ints, strings or Images, + each of which will be drawn horizontally one after the other. + As of v2.1, this functionality has been absorbed into ImageRenderer and this is now an + empty shell, solely for backwards compatibility. + + + + + A MultiImageRenderer draws the same image a number of times based on our data value + + The stars in the Rating column of iTunes is a good example of this type of renderer. + + + + Make a quiet renderer + + + + + Make an image renderer that will draw the indicated image, at most maxImages times. + + + + + + + + + The index of the image that should be drawn + + + + + The name of the image that should be drawn + + + + + The image selector that will give the image to be drawn + + Like all image selectors, this can be an int, string or Image + + + + What is the maximum number of images that this renderer should draw? + + + + + Values less than or equal to this will have 0 images drawn + + + + + Values greater than or equal to this will have MaxNumberImages images drawn + + + + + Draw our data value + + + + + + + A class to render a value that contains a bitwise-OR'ed collection of values. + + + + + Register the given image to the given value + + When this flag is present... + ...draw this image + + + + Draw the flags + + + + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + This renderer draws an image, a single line title, and then multi-line description + under the title. + + + This class works best with FullRowSelect = true. + It's not designed to work with cell editing -- it will work but will look odd. + + It's not RightToLeft friendly. + + + + + + Create a DescribedTaskRenderer + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Gets or set the font that will be used to draw the title of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the title of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the title of the task or a reasonable default + + + + + Gets or set the font that will be used to draw the description of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the description of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the description of the task or a reasonable default + + + + + Gets or sets the number of pixels that will be left between the image and the text + + + + + 顶部留白像素 + + + + + Gets or sets the number of pixels that will be left between the title and the description + + + + + Gets or sets the name of the aspect of the model object that contains the task description + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Fetch the description from the model class + + + + + + + + + + + + + + + Draw our item + + + + + + + Draw the task + + + + + + + + + + Handle the HitTest request + + + + + + + + + This renderer draws a functioning button in its cell + + + + + Gets or sets how each button will be sized + + + + + Gets or sets the size of the button when the SizingMode is FixedBounds + + If this is not set, the bounds of the cell will be used + + + + Gets or sets the extra space that surrounds the cell when the SizingMode is TextBounds + + + + + Gets or sets the maximum width that a button can occupy. + -1 means there is no maximum width. + + This is only considered when the SizingMode is TextBounds + + + + Gets or sets the minimum width that a button can occupy. + -1 means there is no minimum width. + + This is only considered when the SizingMode is TextBounds + + + + 获取或设置此列按钮的字体颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的背景颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的内边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮是否画边框(如果有按钮的话) + + + + + Calculate the size of the contents + + + + + + + + Draw the button + + + + + + + What part of the control is under the given point? + + + + + + + + + + What is the state of the button? + + + + + + Is the mouse over the button? + + + + + The common interface supported by all style objects + + + + + Gets or set the font that will be used by this style + + + + + Gets or set the font style + + + + + Gets or sets the ForeColor + + + + + Gets or sets the BackColor + + + + + Basic implementation of IItemStyle + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class specify how should "hot items" (non-selected + rows under the cursor) be renderered. + + + + + Gets or sets the overlay that should be drawn as part of the hot item + + + + + Gets or sets the decoration that should be drawn as part of the hot item + + A decoration is different from an overlay in that an decoration + scrolls with the listview contents, whilst an overlay does not. + + + + This class defines how a cell should be formatted + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class describe how hyperlinks will appear + + + + + Create a HyperlinkStyle + + + + + What sort of formatting should be applied to hyperlinks in their normal state? + + + + + What sort of formatting should be applied to hyperlinks when the mouse is over them? + + + + + What sort of formatting should be applied to hyperlinks after they have been clicked? + + + + + Gets or sets the cursor that should be shown when the mouse is over a hyperlink. + + + + + Instances of this class control one the styling of one particular state + (normal, hot, pressed) of a header control + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Gets or sets the color in which a frame will be drawn around the header for this column + + + + + Gets or sets the width of the frame that will be drawn around the header for this column + + + + + This class defines how a header should be formatted in its various states. + + + + + Create a new HeaderFormatStyle + + + + + What sort of formatting should be applied to a column header when the mouse is over it? + + + + + What sort of formatting should be applied to a column header in its normal state? + + + + + What sort of formatting should be applied to a column header when pressed? + + + + + Set the font for all three states + + + + + + Set the fore color for all three states + + + + + + Set the back color for all three states + + + + + + 正常为选中按钮 + + + + + 获得焦点的按钮 + + + + + 鼠标经过样式 + + + + + 获得焦点并鼠标经过 + + + + + 自定义GDI工具，绘制按钮 + + + + + 绘制圆形按钮（用法同矩形按钮） + + + + + + + + + + 绘制圆角按钮 + + 要绘制的文字 + Graphics 对象 + 要填充的矩形 + + + + + 根据普通矩形得到圆角矩形的路径 + + 原始矩形 + 半径 + 图形路径 + + + + A GlassPanelForm sits transparently over an ObjectListView to show overlays. + + + + + Get the low-level windows flag that will be given to CreateWindow. + + + + + Attach this form to the given ObjectListView + + + + + Made the overlay panel invisible + + + + + Show the overlay panel in its correctly location + + + If the panel is always shown, this method does nothing. + If the panel is being resized, this method also does nothing. + + + + + Detach this glass panel from its previous ObjectListView + + + You should unbind the overlay panel before making any changes to the + widget hierarchy. + + + + + Handle when the form that owns the ObjectListView begins to be resized + + + + + + + Handle when the form that owns the ObjectListView finished to be resized + + + + + + + The owning form has moved. Move the overlay panel too. + + + + + + + The owning form is resizing. Hide our overlay panel until the resizing stops + + + + + + + Handle when the bound OLV changes its location. The overlay panel must + be moved too, IFF it is currently visible. + + + + + + + Handle when the bound OLV changes size. The overlay panel must + resize too, IFF it is currently visible. + + + + + + + Handle when the bound OLV is part of a TabControl and that + TabControl changes tabs. The overlay panel is hidden. The + first time the bound OLV is redrawn, the overlay panel will + be shown again. + + + + + + + Somewhere the parent of the bound OLV has changed. Update + our events. + + + + + + + Handle when the bound OLV changes its visibility. + The overlay panel should match the OLV's visibility. + + + + + + + Class used to capture window messages for the header of the list view + control. + + + + + Create a header control for the given ObjectListView. + + + + + + Return the index of the column under the current cursor position, + or -1 if the cursor is not over a column + + Index of the column under the cursor, or -1 + + + + 返回此控件的Windows句柄 + + + 当ObjectListView被初始化为UserControl的一部分时，GetHeaderControl()方法返回0，直到UserControl完全初始化。 + 因此，构造函数中的AssignHandle()调用不起作用。因此，我们覆盖了Handle属性，以便值始终为当前值。 + + + + + Gets or sets a style that should be applied to the font of the + column's header text when the mouse is over that column + + THIS IS EXPERIMENTAL. USE AT OWN RISK. August 2009 + + + + 如果光标位于其复选框上，则获取光标下列的索引 + + + + + Gets the client rectangle for the header + + + + + 如果给定坐标点在给定列的复选框上方，则返回TRUE。 + + + + + + + + 获取光标是否位于“锁定”的分隔线上，即用户无法拖动的分隔线。 + + + + + 获取或设置此标头所属的列表视图 + + + + + 获取标题的最大高度。-1表示没有最大值。 + + + + + 获取标题的最小高度。-1表示没有最低要求。 + + + + + Get or set the ToolTip that shows tips for the header + + + + + 获取或设置当列标题中的文本太长而无法放入列中时，是否应对其进行自动换行 + + + + + Calculate how height the header needs to be + + Height in pixels + + + + Get the bounds of the checkbox against the given column + + + + + + + Should the given column be drawn with a checkbox against it? + + + + + + + Should the given column show a sort indicator? + + + + + + + Should the given column be drawn with a filter indicator against it? + + + + + + + Should the given column show a non-themed sort indicator? + + + + + + + Return the bounds of the item with the given index + + + + + + + Return the bounds within which the given column will be drawn + + + + + + + Force the header to redraw by invalidating it + + + + + Force the header to redraw a single column by invalidating it + + + + + Create a native tool tip control for this listview + + + + + Override the basic message pump + + + + + + Handle the LButtonDown windows message + + + + + + + Handle the LButtonUp windows message + + + + + + + Handle the SetCursor windows message + + + + + + + Handle the MouseMove windows message + + + + + + + Handle the MouseLeave windows message + + + + + + + Handle the Notify windows message + + + + + + + Handle the CustomDraw windows message + + + + + + + The message divides a ListView's space between the header and the rows of the listview. + The WINDOWPOS structure controls the headers bounds, the RECT controls the listview bounds. + + + + + + + Handle when the underlying header control is destroyed + + + + + + + Does this header need to be custom drawn? + + Word wrapping and colored text require custom drawning. Funnily enough, we + can change the font natively. + + + + Draw one cell of the header + + + + + + + + Draw a background for the header, without using Themes. + + + + + + + + + + + Draw a more-or-less pure themed header background. + + + + + + + + + + Draw a sort indicator using themes + + + + + + + Draw a sort indicator without using themes + + + + + + + + Draw an indication that this column has a filter applied to it + + + + + + + + Draw the header's image and text + + + + + + + + + Return the header format that should be used for the given column + + + + + + + What style should be applied to the header? + + + + + + + + + What font should be used to draw the header text? + + + + + + + + + What flags will be used when drawing text + + + + + Perform a HitTest for the header control + + + + Null if the given point isn't over the header + + + + Instances of this class put a CheckedListBox into a tool strip menu item. + + + + + Create a ToolStripCheckedListBox + + + + + Gets the control embedded in the menu + + + + + Gets the items shown in the checkedlistbox + + + + + Gets or sets whether an item should be checked when it is clicked + + + + + Gets a collection of the checked items + + + + + Add a possibly checked item to the control + + + + + + + Add an item with the given state to the control + + + + + + + Gets the checkedness of the i'th item + + + + + + + Set the checkedness of the i'th item + + + + + + + Check all the items in the control + + + + + Unchecked all the items in the control + + + + + Listen for events on the underlying control + + + + + + Stop listening for events on the underlying control + + + + + + Tell the world that an item was checked + + + + + Trigger the ItemCheck event + + + + + + + A limited wrapper around a Windows tooltip window. + + + + + These are the standard icons that a tooltip can display. + + + + + No icon + + + + + Info + + + + + Warning + + + + + Error + + + + + Large info (Vista and later only) + + + + + Large warning (Vista and later only) + + + + + Large error (Vista and later only) + + + + + + + + + + + + + + + + + + + + + + + + + Get or set if the style of the tooltip control + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set the background color of the tooltip + + + + + Get or set the color of the text and border on the tooltip. + + + + + Get or set the title that will be shown on the tooltip. + + + + + Get or set the icon that will be shown on the tooltip. + + + + + Gets or sets the font that will be used to draw this control. + is still. + + Setting this to null reverts to the default font. + + + + Gets or sets how many milliseconds the tooltip will remain visible while the mouse + is still. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown again. + + + + + Create the underlying control. + + The parent of the tooltip + This does nothing if the control has already been created + + + + Take a copy of the current settings and restore them when the + tooltip is poppped. + + + This call cannot be nested. Subsequent calls to this method will be ignored + until PopSettings() is called. + + + + + Restore the settings of the tooltip as they were when PushSettings() + was last called. + + + + + Add the given window to those for whom this tooltip will show tips + + The window + + + + Hide any currently visible tooltip + + + + + + Remove the given window from those managed by this tooltip + + + + + + Set the maximum width of a tooltip string. + + + + + Set the maximum width of a tooltip string. + + Setting this ensures that line breaks in the tooltip are honoured. + + + + Make a TOOLINFO structure for the given window + + + A filled in TOOLINFO + + + + Handle a WmNotify message + + The msg + True if the message has been handled + + + + Handle a get display info message + + The msg + True if the message has been handled + + + + Handle a TTN_LINKCLICK message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_POP message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_SHOW message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a reflected notify message + + The msg + True if the message has been handled + + + + Mess with the basic message pump of the tooltip + + + + + + Tell the world that a tooltip is about to show + + + + + Tell the world that a tooltip is about to disappear + + + + + + + + + + + + + + + + + This form is an example of how an application could allows the user to select which columns + an ObjectListView will display, as well as select which order the columns are displayed in. + + + In Tile view, ColumnHeader.DisplayIndex does nothing. To reorder the columns you have + to change the order of objects in the Columns property. + Remember that the first column is special! + It has to remain the first column. + + + + + Make a new ColumnSelectionForm + + + + + Open this form so it will edit the columns that are available in the listview's current view + + The ObjectListView whose columns are to be altered + + + + Open this form so it will edit the columns that are available in the given listview + when the listview is showing the given type of view. + + The ObjectListView whose columns are to be altered + The view that is to be altered. Must be View.Details or View.Tile + + + + Initialize the form to show the columns of the given view + + + + + + + The user has pressed OK. Do what's requied. + + + + + + + Enable the controls on the dialog to match the current state + + + + + A Comparer that will sort a list of columns so that visible ones come before hidden ones, + and that are ordered by their display order. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + An object that implements the IGenerator interface provides the ability + to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + The Generator class provides methods to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + For a given type, a Generator can create columns to match the public properties + of that type. The generator can consider all public properties or only those public properties marked with + [OLVColumn] attribute. + + + + + Gets or sets the actual generator used by the static convinence methods. + + If you subclass the standard generator or implement IGenerator yourself, + you should install an instance of your subclass/implementation here. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the public properties of the given type + that have a OLVColumn attribute. + + + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Replace all the columns in the given listview with the given list of columns. + + + + + + + Post process columns after creating them and adding them to the AllColumns collection. + + + + + + Create a column from the given PropertyInfo and OLVColumn attribute + + + + + + + + Make a column from the given PropertyInfo + + + + + + + Make a column from the given PropertyDescriptor + + + + + + + Create a column with all the given information + + + + + + + + + + + Create a column. + + + + + + + + + Convert a property name to a displayable title. + + + + + + + Configure the given column to show a checkbox if appropriate + + + + + + + If this given type has an property marked with [OLVChildren], make delegates that will + traverse that property as the children of an instance of the model + + + + + + + Generate CanExpand and ChildrenGetter delegates from the given property. + + + + + + + An OLVExporter converts a collection of rows from an ObjectListView + into a variety of textual formats. + + + + + What format will be used for exporting + + + + + Tab separated values, according to http://www.iana.org/assignments/media-types/text/tab-separated-values + + + + + Alias for TabSeparated + + + + + Comma separated values, according to http://www.ietf.org/rfc/rfc4180.txt + + + + + HTML table, according to me + + + + + Create an empty exporter + + + + + Create an exporter that will export all the rows of the given ObjectListView + + + + + + Create an exporter that will export all the given rows from the given ObjectListView + + + + + + + Gets or sets whether hidden columns will also be included in the textual + representation. If this is false (the default), only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. Default is true. + + + + + Gets the ObjectListView that is being used as the source of the data + to be exported + + + + + Gets the model objects that are to be placed in the data object + + + + + Export the nominated rows from the nominated ObjectListView. + Returns the result in the expected format. + + + + This will perform only one conversion, even if called multiple times with different formats. + + + + Convert + + + + + Encode a string such that it can be used as a value in a CSV file. + This basically means replacing any quote mark with two quote marks, + and enclosing the whole string in quotes. + + + + + + + HTML-encodes a string and returns the encoded string. + + The text string to encode. + The HTML-encoded text. + Taken from http://www.west-wind.com/weblog/posts/2009/Feb/05/Html-and-Uri-String-Encoding-without-SystemWeb + + + + A TypedObjectListView is a type-safe wrapper around an ObjectListView. + + + VCS does not support generics on controls. It can be faked to some degree, but it + cannot be completely overcome. In our case in particular, there is no way to create + the custom OLVColumn's that we need to truly be generic. So this wrapper is an + experiment in providing some type-safe access in a way that is useful and available today. + A TypedObjectListView is not more efficient than a normal ObjectListView. + Underneath, the same name of casts are performed. But it is easier to use since you + do not have to write the casts yourself. + + + The class of model object that the list will manage + + To use a TypedObjectListView, you write code like this: + + TypedObjectListView<Person> tlist = new TypedObjectListView<Person>(this.listView1); + tlist.CheckStateGetter = delegate(Person x) { return x.IsActive; }; + tlist.GetColumn(0).AspectGetter = delegate(Person x) { return x.Name; }; + ... + + To iterate over the selected objects, you can write something elegant like this: + + foreach (Person x in tlist.SelectedObjects) { + x.GrantSalaryIncrease(); + } + + + + + + Create a typed wrapper around the given list. + + The listview to be wrapped + + + + Return the model object that is checked, if only one row is checked. + If zero rows are checked, or more than one row, null is returned. + + + + + Return the list of all the checked model objects + + + + + The ObjectListView that is being wrapped + + + + + Get or set the list of all model objects + + + + + Return the model object that is selected, if only one row is selected. + If zero rows are selected, or more than one row, null is returned. + + + + + The list of model objects that are selected. + + + + + Return a typed wrapper around the column at the given index + + The index of the column + A typed column or null + + + + Return a typed wrapper around the column with the given name + + The name of the column + A typed column or null + + + + Return the model object at the given index + + The index of the model object + The model object or null + + + + CheckStateGetter + + + + + + + Gets or sets the check state getter + + + + + BooleanCheckStateGetter + + + + + + + Gets or sets the boolean check state getter + + + + + CheckStatePutter + + + + + + + + Gets or sets the check state putter delegate + + + + + BooleanCheckStatePutter + + + + + + + + Gets or sets the boolean check state putter + + + + + ToolTipGetter + + + + + + + + Gets or sets the cell tooltip getter + + + + + Gets or sets the header tool tip getter + + + + + This method will generate AspectGetters for any column that has an AspectName. + + + + + A type-safe wrapper around an OLVColumn + + + + + + Creates a TypedColumn + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Generate an aspect getter that does the same thing as the AspectName, + except without using reflection. + + + + If you have an AspectName of "Owner.Address.Postcode", this will generate + the equivilent of: this.AspectGetter = delegate (object x) { + return x.Owner.Address.Postcode; + } + + + + If AspectName is empty, this method will do nothing, otherwise + this will replace any existing AspectGetter. + + + + + + Generates an aspect getter method dynamically. The method will execute + the given dotted chain of selectors against a model object given at runtime. + + The type of model object to be passed to the generated method + A dotted chain of selectors. Each selector can be the name of a + field, property or parameter-less method. + A typed delegate + + + + This method generates the actual IL for the method. + + + + + + + + A virtual object list view operates in virtual mode, that is, it only gets model objects for + a row when it is needed. This gives it the ability to handle very large numbers of rows with + minimal resources. + + A listview is not a great user interface for a large number of items. But if you've + ever wanted to have a list with 10 million items, go ahead, knock yourself out. + Virtual lists can never iterate their contents. That would defeat the whole purpose. + Animated GIFs should not be used in virtual lists. Animated GIFs require some state + information to be stored for each animation, but virtual lists specifically do not keep any state information. + In any case, you really do not want to keep state information for 10 million animations! + + Although it isn't documented, .NET virtual lists cannot have checkboxes. This class codes around this limitation, + but you must use the functions provided by ObjectListView: CheckedObjects, CheckObject(), UncheckObject() and their friends. + If you use the normal check box properties (CheckedItems or CheckedIndicies), they will throw an exception, since the + list is in virtual mode, and .NET "knows" it can't handle checkboxes in virtual mode. + + Due to the limits of the underlying Windows control, virtual lists do not trigger ItemCheck/ItemChecked events. + Use a CheckStatePutter instead. + To enable grouping, you must provide an implmentation of IVirtualGroups interface, via the GroupingStrategy property. + Similarly, to enable filtering on the list, your VirtualListDataSource must also implement the IFilterableDataSource interface. + + + + + Create a VirtualObjectListView + + + + + Gets whether or not this listview is capabale of showing groups + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + This class optimizes the management of CheckStates so that it will work efficiently even on + large lists of item. However, those optimizations are impossible if you install a CheckStateGetter. + With a CheckStateGetter installed, the performance of this method is O(n) where n is the size + of the list. This could be painfully slow. + + + + + Gets or sets whether or not an object will be included in the CheckedObjects + collection, even if it is not present in the control at the moment + + + This property is an implementation detail and should not be altered. + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Gets or sets the strategy that will be used to create groups + + + This must be provided for a virtual list to show groups. + + + + + Gets whether or not the current list is filtering its contents + + + This is only possible if our underlying data source supports filtering. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + Setting this property preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code -- performance is O(n) where n is the number of selected rows. + This method is not thread safe. + The property DOES work on virtual lists, but if you try to iterate through a list + of 10 million objects, it may take some time :) + + + + + This delegate is used to fetch a rowObject, given it's index within the list + + Only use this property if you are not using a VirtualListDataSource. + + + + Should this list show its items in groups? + + + + + Get/set the data source that is behind this virtual list + + Setting this will cause the list to redraw. + + + + Gets or sets the number of rows in this virtual list. + + + There is an annoying feature/bug in the .NET ListView class. + When you change the VirtualListSize property, it always scrolls so + that the focused item is the top item. This is annoying since it makes + the virtual list seem to flicker as the control scrolls to show the focused + item and then scrolls back to where ObjectListView wants it to be. + + + + + Return the number of items in the list + + the number of items in the list + + + + Return the model object at the given index + + Index of the model object to be returned + A model object + + + + Find the given model object within the listview and return its index + + The model object to be found + The index of the object. -1 means the object was not present + + + + Return the OLVListItem that displays the given model object + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Add the given collection of model objects to this control. + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the end of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Scroll the listview so that the given group is at the top. + + The index of the group to be revealed + + If the group is already visible, the list will still be scrolled to move + the group to the top, if that is possible. + + This only works when the list is showing groups (obviously). + + + + + Inserts the given collection of model objects to this control at hte given location + + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the given position of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Update the rows that are showing the given objects + + This method does not resort the items. + + + + Update the rows that are selected + + This method does not resort or regroup the view. + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + Due to problems in the underlying ListView, if you remove all the objects from + the control using this method and the list scroll vertically when you do so, + then when you subsequenially add more objects to the control, + the vertical scroll bar will become confused and the control will draw one or more + blank lines at the top of the list. + + + + + Select the row that is displaying the given model object. All other rows are deselected. + + Model object to select + Should the object be focused as well? + + + + Select the rows that is displaying any of the given model object. All other rows are deselected. + + A collection of model objects + This method has O(n) performance where n is the number of model objects passed. + Do not use this to select all the rows in the list -- use SelectAll() for that. + + + + Set the collection of objects that this control will show. + + + Should the state of the list be preserved as far as is possible. + + + + Get the checkedness of an object from the model. Returning null means the + model does know and the value from the control will be used. + + + + + + + Rebuild the list with its current contents. + + + Invalidate any cached information when we rebuild the list. + + + + + Clear any cached info this list may have been using + + + + + Do the work of creating groups for this control + + + + + + Do the plumbing to disable groups on a virtual list + + + + + Do the plumbing to enable groups on a virtual list + + + + + Return the position of the given itemIndex in the list as it currently shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the last item in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + Return the n'th item (0-based) in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the ListViewItem that appears immediately after the given item. + If the given item is null, the first item in the list will be returned. + Return null if the given item is the last item. + + The item that is before the item that is returned, or null + A OLVListItem + + + + Return the ListViewItem that appears immediately before the given item. + If the given item is null, the last item in the list will be returned. + Return null if the given item is the first item. + + The item that is before the item that is returned + A ListViewItem + + + + Make a list of groups that should be shown according to the given parameters + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + + + + On virtual lists, this cannot work. + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Refresh the given item in the list + + The item to refresh + + + + Change the size of the list + + + + + + Take ownership of the 'objects' collection. This separates our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + VirtualObjectListViews always own their collections, so this is a no-op. + + + + + + Change the state of the control to reflect changes in filtering + + + + + Change the size of the virtual list so that it matches its data source + + + + + Handle the CacheVirtualItems event + + + + + + + Handle a RetrieveVirtualItem + + + + + + + Handle the SearchForVirtualList event, which is called when the user types into a virtual list + + + + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 初始化的时候给个alpha值,这样在灰图片的时候可以半透明 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使图片单色化 + + + + + + + + + + + + 自定义 + + + + + 预置 + + + + + 系统 + + + + + 颜色表示法 + + + + + 根据颜色表示字符串获取对应的颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 从文件中获取Image对象 + 这个函数的主要功能是处理一些ico文件 + 一些ico文件的格式可能比较新，直接Image.FormFile，会报内存不足的异常 + + + 是否将文件读入内存操作，如果为false,将直接返回Image.FromFile，在此情况下， + 必须手动释放Image对象，否则文件将一直处于占用状态，如果为true,则在内存中拷贝副本 + + + + + + 将图像转为Icon对象,使用png格式 + + + + + + + 将图像转为Icon对象 + + + + + + + + 返回适应指定容器大小的图像 + 如果图像的尺寸(长或宽)超出了容器范围,将按比例获取图像的缩略图返回,否则直接返回图像 + 此方法最终调用 Image.GetThumbnailImage + 但是注意,在指定的容器尺寸过小时,返回的Image尺寸不可知,是在为了显示16x16的小缩略图是发现了此问题 + 使用 GetScaleImage + + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + + The source image. + The rectangle to fit in to. + Horizontal image aligment in percent. + Vertical image aligment in percent. + New image size. + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + The image will be centered in the fit box. + + The source image. + The rectangle to fit in to. + New image size. + + + + Gets the scaled size of an image required to fit + in to the given size keeping the image aspect ratio. + + The source image. + The size to fit in to. + New image size. + + + + 获取一个圆角矩形 + + + + 角度 + + + + + 获取一个圆角矩形 + + + 角度 + + + + + + + + + + + + + + + + + + + + + + 返回一个表示箭头的Path + 如果开始坐标和结束坐标之间的距离大于箭头的大小，箭头向结束坐标对齐，顶着结束坐标 + + 开始坐标 + 结束坐标（顶点，方向） + 箭头的长短，大小 + 箭头的粗细 + + + + + 在指定的Image上绘制特定标记 + + + + + 文件不存在 + + + + + + 文件不存在 + + + + + + 无法读取文件 + + + + + + + + + + + + + + + + + + + + + 验证失败中显示错误信息时用的标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + 验证控件的输入 + + + + + + + 自定义验证方法 + 在基础验证都通过后，才会调用自定义验证方法（如果有） + + + + + + + + + + 是否支持 Windows Vista 以上的玻璃效果 + + + + + 是否打开了玻璃效果 + + + + + 获取应用程序主窗体 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 这个缓存是全局的 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 所对应的绑定数据类型 + + + + + 是否对 DataBoundType 的子类型有效 + 默认无效 + 如果设置为 true，又同时添加了基类与子类的 codon，则运行时会取到哪个codon不确定 + 通常取先添加的那个 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取授予该组件的许可证密钥 + + + + + 0:未验证 + 1:验证失败 + 2:验证通过 + + + + + 获取组件的实例或类型的许可证（如果已给定上下文并确定拒绝许可证是否引发异常）。 + + + + + + + + + + 强类型资源类，用于查找本地化字符串等。 + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + Returns a System.String that represents the current System.Object. + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + + + + + + Call GetLanguages() to retrieve a list of possible languages that can be used to set this property. + The default value is the default language. + + + + + Gets a list of available languages defined in this assembly. + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Determines which animation to use while showing the pop-up window. + + + + + Determines which animation to use while hiding the pop-up window. + + + + + Determines the duration of the animation. + + + + + Gets or sets a value indicating whether the content should receive the focus after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether the is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets a minimum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets a maximum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows the pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows the pop-up window below the specified area of the specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the sizing grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Types of animation of the pop-up window. + + + + + Uses no animation. + + + + + Animates the window from left to right. This flag can be used with roll or slide animation. + + + + + Animates the window from right to left. This flag can be used with roll or slide animation. + + + + + Animates the window from top to bottom. This flag can be used with roll or slide animation. + + + + + Animates the window from bottom to top. This flag can be used with roll or slide animation. + + + + + Makes the window appear to collapse inward if it is hiding or expand outward if the window is showing. + + + + + Uses a slide animation. + + + + + Uses a fade effect. + + + + + Uses a roll animation. + + + + + Uses a default animation. + + + + + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the class. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Gets or sets a value indicating whether the combo box is displaying its drop-down portion. + + + true if the drop-down portion is displayed; otherwise, false. The default is false. + + + + + Occurs when the drop-down portion of a is shown. + + + + + Shows the drop down. + + + + + Occurs when the drop-down portion of the is no longer visible. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Represents a Windows combo box control which can be used in a popup's content control. + + + + + Initializes a new instance of the PopupControl.ComboBox class. + + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 白色到灰色的垂直渐变 + + + + + + + + + + This method handles the RenderToolStripBorder event. + + + + + + + + + + + + A ToolstripManager rendering class with advanced control features + + + + + Creates a new EasyRender class for modifications + + + + + + + + + + + + + + + + + + + + Gets the manager to edit and change the appearance of the Toolstrip + + + + + Gets the manager to edit and change the appearance of Toolstrip buttons + + + + + Gets the manager to edit and change the appearance of other Toolstrip controls + + + + + Gets the manager to edit and change the appearance of the Panels + + + + + Gets the manager to edit and change the appearance of the Toolstrip split buttons + + + + + Gets the manager to edit and change the appearance of the Status-bar + + + + + Gets or sets whether to smooth the font text on all controls + + + + + Gets or sets the color of the text if the AlterColor is set to true + + + + + Gets or sets whether to override the font-color on all controls + + + + + Creates a GraphicsPath that appreciates an area where things can be drawn + + The rectangular area which will serve as the base + The curve amount of the corners + + + + + Creates a triangle based on the size and bounds sectors + + The area which the triangle is confined to + The size of the triangle + The direction which the triangle is pointing + + + + + Gets a color array based on the state of a normal button + + The button to check the state of + + + + + + Gets a color array based on the state of a split-button + + The button to check the state of + + + + + + Gets a color array based on the state of a menu-item + + The button to check the state of + + + + + + Gets a color array based on the state of a drop-down button + + The button to check the state of + + + + + + Gets a blending property for a specified type of Toolstrip item + + The Toolstrip item + The type of item this is + + + + + Fills a specified boundary with color + + The Graphics object to draw onto + The boundaries to draw the color + The brush to fill the color + + + + Fills a specified boundary with a gradient with specified colors + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + + + + Fills a specified boundary with a gradient with specified colors at a given angle + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Fills a specified boundary with a gradient with specified colors at a given angle and with blending properties + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a set path with a defined brush + + The Graphics object to draw onto + The path to draw along + The brush to fill the color + + + + Draws a set path with specified colors + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + + + + Draws a set path with specified colors at a given angle + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Draws a set path with specified colors at a given angle with blending properties + + The Graphics object to draw onto + The path to draw along + + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Toolstrip background + + The Toolstrip being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Toolstrip split-button + + The Toolstrip split-button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Statusbar background + + The Statusbar being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Menustrip item + + The Menustrip item + The Graphics object to handle + The parent Toolstrip + + + + Covers the button background rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Applies any and all changes made to the Renderer + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Toolstrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IToolstrip class for customization + + The IToolstrip to import the settings from + + + + Disposes of the IToolstrip class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip background gradient from the top + + + + + Gets or sets the color of the Toolstrip background gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip background + If set to null, the Toolstrip will simply draw the gradient + + + + + Gets or sets the angle which the Toolstrip background will be drawn + + + + + Gets or sets the color of the Toolstrip border gradient from the top + + + + + Gets or sets the color of the Toolstrip border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip border + If set to null, the Toolstrip will simply draw the border + + + + + Gets or sets the angle which the Toolstrip border will be drawn + + + + + Gets or sets the curve of the border of the Toolstrip + + + + + Imports the settings from a previous or pre-defined IToolstrip and applies it to the current + + The IToolstrip to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IToolstripControls class for customization + + + + + Disposes of the IToolstripControls class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip seperator on the dark side + + + + + Gets or sets the color of the Toolstrip seperator on the light side + + + + + Gets or sets the height of the Toolstrip seperator control + + + + + Gets or sets the color of the grip dots/line at the top + + + + + Gets or sets the color of the grip shadow + + + + + Gets or sets in what mode the grip will be drawn + + + + + Gets or sets the distance, in pixels, between each grip dot + + + + + Gets or sets the size of the dots or lines for the grip + + + + + Imports the settings from a previous or pre-defined IToolstripControls and applies it to the current + + The IToolstripControls to import the settings from + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IButton and applies it to the current + + The IButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" and "Click" do not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IDropDownButton and applies it to the current + + The IDropDownButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new ISplitButton class for customization + + + + + Disposes of the ISplitButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Gets or sets when to display the drop-down arrow + + + + + Gets or sets the color of the drop-down arrow + + + + + Imports the settings from a previous or pre-defined ISplitButton and applies it to the current + + The ISplitButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IPanel class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient at the top of the content panel + + + + + Gets or sets the color of the gradient at the bottom of the content panel + + + + + Gets or sets whether each panel inherits the shading from the content panel + + + + + Gets or sets the angle which the background gradient is drawn + + + + + Gets or sets the blend of the background + + + + + Gets or sets a mode to render the background in + + + + + + + + + + Creates a new IStatusBar class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient of the background at the top + + + + + Gets or sets the color of the gradient of the background at the bottom + + + + + Gets or sets the blending that will apply to the background + + + + + Gets or sets the angle which the background gradient will be drawn + + + + + Gets or sets the color of the dark border + + + + + Gets or sets the color of the light border + + + + + Gets or sets the color of the grip at the top-most + + + + + Gets or sets the color of the grip at the bottom-most + + + + + Gets or sets the spacing of the grip blocks + + + + + Imports the settings from a previous or pre-defined IStatusBar and applies it to the current + + The IStatusBar to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Menustrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IMenustrip class for customization + + The IMenustrip to import the settings from + + + + Disposes of the IMenustrip class and clears all resources related to it + + + + + Gets or sets the color of the menu-strip border (dark) + + + + + Gets or sets the color of the menu-strip border (light) + + + + + Gets or sets how the background of the menu-strip is inherited + + + + + If inheritence is set to none, the color of the background gradient at the top + + + + + If inheritence is set to none, the color of the background gradient at the bottom + + + + + If inheritence is set to none, the blending option for the background + + + + + Gets or sets the color of the margin gradient at the left + + + + + Gets or sets the color of the margin gradient at the right + + + + + Gets or sets the color of the margin border (displayed to the right) + + + + + Gets or sets the color of the root menu-strip button background when it is selected + + + + + Gets or sets the color of the root menu-strip button border when it is selected + + + + + Gets or sets the color of the seperator dark color + + + + + Gets or sets the color of the seperator light color + + + + + Gets or sets the inset position of the seperator from the left + + + + + Gets the class that handles the look and feel of the menu-strip items + + + + + Imports the settings from a previous or pre-defined IMenustrip and applies it to the current + + The IMenustrip to import the settings from + + + + Sets the blending for the background to it's default + + + + + Defines when to show an arrow + + + + + + + + + + + + + + + + + + + + Defines when to use a blend property + + + + + Use the blend when the object is drawn + + + + + Use the blend when the object is hovered over + + + + + Use the blend when the object is clicked + + + + + Use the blend when the object is checked + + + + + Always use the blend regardless of the state of the object + + + + + Defines a method of drawing a grip on a control + + + + + Draws the grip as a set of dots + + + + + Draws the grip as two lines + + + + + Does not draw the grip at all, but the object remains moveable + + + + + Defines a specific type of button to search by + + + + + + + + + + + + + + + + + + + + + + + + + Defines a method for background or object inheritence + + + + + + + + + + + + + + + Defines a method of rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 主菜单 + + + + + 背景透明的工具条 + + + + + 银白色至白色渐变 + + + + + 白色至银白色渐变 + + + + + + + + + + + + + + + 当前工作区窗体所关联并激活的工具栏 + + + + + 模拟运行时的外观 + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 鼠标滑过 + + + + + 控件的高度根据内容自动调整，忽略外部设置 + + + + + 边框宽度 + + + + + 文本和description文本之间的间距 + + + + + 最大显示的项数 + + + + + + + + + + 是否显示说明字段，此属性不影响弹出面板是否显示 + 弹出面板是否显示由DescriptionMember是否设置决定 + + + + + + + + + + + + + + + 下拉列表的布局模式 + + + + + + + + + + 是否允许空 + + + + + + + + + + 测量当前控件应该的高度 + + + + + + 整个可用的绘图表面 + + + + + 右边按钮的绘图表面 + + + + + 绘制边框 + + + + + + 绘制背景 + + + + + + 绘制文本 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前热点项生改变 + + + + + + + + + + + + + + + + + + + + + 通过外能事件获取用于绘制项的文本 + + + + + + + + + + + + + + + + + + + + + + + + + + 标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + + + + + + + + + + + + + + + + + + 排序箭头开始颜色 + + + + + 排序箭头开始颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 控件的背景画布颜色 + 因为控件的边框和过度色都有依靠改变透明度实现渐变，所以一个白色的底版就非常重要 + 使过度色不受控件本身背景色的影响，光不绘制背景不行，要刷上白色背景 + + + + + 控件背景色 + + + + + + + + + + + + + + + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 该项具有输入焦点 + + + + + 鼠标滑过 + + + + + + + + + + The item is not visible. + + + + + The item is partially visible. + + + + + The item is fully visible. + + + + + 布局方式 + + + + + 标准布局 + + + + + 使项带有描述的布局 + + + + + 双击项事件参数 + + + + + + + + + + + + + + + + 项被删除事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 为项绘制带有描述信息的渲染器 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + 默认布局引擎，以类似微软ListView的方式按行排列项 + + + + + 框选的最短开始长度 + + + + + 框选时滚动条的自动滚动速度 + + + + + 用于鼠标框选时，框出了控件中项的显示范围时，自动滚动滚动条 + + + + + 自动滚动时，滚动值 + + + + + 是否处于框选状态中 + + + + + 内框offset，内框offset是绝对相对于滚动条的 + + + + + 整个可显示项的边界的offset，包括上下padding部分 + + + + + 鼠标按下时项区域边界的offset，即 _itemsAreaOffset + 用于框选时，跨越可视部队画框 + + + + + 当前所能显示的最大行数 + + + + + + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + + + + + + + + + + + + + + + + + + + + + 没有任何项 + + + + + 没有任何项处于可显示状态 + + + + + 整个控件区域 + + + + + 整个可用于绘制项的可视区域 + 去除左右Padding部分，去除滚动条 + + + + + 用于绘制项的区域 + 考虑边距间隔大小和滚动条区域 + + + + + 项的尺寸 + 不放在ListView本身中定义而是放在LayoutManager中定义，是因为不同的布局方式 + 可能会是带长宽的Size做为itemSize，比如平铺的方式 + + + + + 项周围的边距 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新整个布局引擎的状态 + + + + + 判断指定的项是否处于可见状态 + + + + + + + 获取项的呈现区域 + + + + + + + + + + + + + + + + + + + + 获取当前所有可见项 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculates the maximum number of rows and columns + that can be fully displayed. + + + + + 计算当前可见项的index范围 + + + + + 更新滚动条状态 + + + + + 创建框选框 + + + + + + 根据矩形区域选择项 + + + + + + 应用导航键，如上下左右，返回应用导航键之后的项的坐标 + + + + + 使指定下标的项处于可见状态 + + + + + + 默认渲染器，不绘制项的实际内容，但是绘制DEBUG信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 用于子类重写时删除相应的缓存 + + + + + + 绘制项的背景 + + The System.Drawing.Graphics to draw on. + The client coordinates of the item area. + + + + 绘制最终的前景 + + + + + + 绘制选择边框 + + The System.Drawing.Graphics to draw on. + The client coordinates of the selection rectangle. + + + + 绘制项的边框 + + + + + + + + 绘制项 + + + + + + + 绘制项的背景 + + + + + + + 绘制项的内容 + + + + + + + + 绘制背景 + + + + + + 绘制当前所有可见项 + + + + + + Renders the selection rectangle. + + The graphics to draw on. + + + + 默认渲染器，以类似微软ListView的方式按行绘制项，只绘制简单的文本 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + + + + + + + + + + + + + + + 项的背景色 + + + + + 控件背景色 + + + + + 项的边框色 + + + + + 选择框颜色 + + + + + 选择框的边框色 + + + + + 当控件具有焦点时选定项的背景色 + + + + + + + + + + 控件失去焦点时选定项的背景色 + + + + + + + + + + 热点项的背景色 + + + + + + + + + + 图像内边框颜色 + + + + + 图像外边框颜色 + + + + + + + + + + Creates a control with a border. + + + + + Specifies that the control has a border with a sunken edge. + + + + + + + + + + 是否需要在调用 ResumeLayout 时重绘 + + + + + 为项扩展的用于呈现的属性 + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + 鼠标左键是否处于按下状态 + + + + + 鼠标右键是否处于按下状态 + + + + + 鼠标最后点击的位置 + + + + + 当前鼠标经过的项 + + + + + + + + + + + + + + + 配色方案 + + + + + 当前布局中项的高度 + + + + + + + + + + 是否没有任何项 + + + + + + + + + + 获取当前具有输入焦点的项 + + + + + 默认的用于呈现为项中文本的Property + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + + 请求在下次调用 ResumeLayout 时重绘 + + + + + 获取当前选中的所有项 + + + + + + + + + + + + 设置扩展属性供特定LayoutEngine使用 + 如果指定的 ExtendMember 已存在，覆盖之 + 用String.Empty 或 null 做为 propertyName传入，表示删除指定的 member + + + + + + + + + + + + + + + + + + + + + 恢复正常的布局逻辑。 + + + + + + + + + + + 临时挂起控件的布局逻辑。 + + + + + + + + + + 获取当前选中项所绑定的对象 + 如果没有选中项，返回null，如果选中多项，返回选中项集合中的第一个 + + + + + + 根据指定的绑定项对象 + 设置当前列表中选定的项 + + + + + + 获取当前选中的所有项的绑定对象集合 + 如果当前没有选中任何项，返回空集合 + + + + + + 取消所有项的选择 + + + + + + + + + + + + + + + + 获取创建控件句柄时所需要的创建参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + 项被删除 + + + + + 通过外能事件获取用于绘制项的文本 + + + + + Represents the color palette of the image list view. + + + + + Gets or sets the background color of the ImageListView control. + + + + + Gets or sets the background color of the ImageListViewItem. + + + + + Gets or sets the background color of alternating cells in Details View. + + + + + Gets or sets the border color of the ImageListViewItem. + + + + + Gets or sets the foreground color of the ImageListViewItem. + + + + + Gets or sets the background gradient color1 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color2 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the border color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the fore color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is hovered. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is hovered. + + + + + Gets or sets the border color of the ImageListViewItem if the item is hovered. + + + + + Gets or sets the color of the insertion caret. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is selected. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is selected. + + + + + Gets or sets the border color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the fore color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the background gradient color1 of the column header. + + + + + Gets or sets the background gradient color2 of the column header. + + + + + Gets or sets the background hover gradient color1 of the column header. + + + + + Gets or sets the background hover gradient color2 of the column header. + + + + + Gets or sets the cells foreground color of the column header text. + + + + + Gets or sets the cells background color if column is selected in Details View. + + + + + Gets or sets the color of the separator in Details View. + + + + + Gets or sets the foreground color of the cell text in Details View. + + + + + Gets or sets the foreground color of alternating cells text in Details View. + + + + + Gets or sets the background color of the image pane. + + + + + Gets or sets the separator line color between image pane and thumbnail view. + + + + + Gets or sets the color of labels in pane view. + + + + + Gets or sets the image inner border color for thumbnails and pane. + + + + + Gets or sets the image outer border color for thumbnails and pane. + + + + + Gets or sets the background color1 of the selection rectangle. + + + + + Gets or sets the background color2 of the selection rectangle. + + + + + Gets or sets the color of the selection rectangle border. + + + + + Initializes a new instance of the ImageListViewColor class. + + + + + Initializes a new instance of the ImageListViewColor class + from its string representation. + + String representation of the object. + + + + Copies color values from the given object. + + The source object. + + + + Represents the default color theme. + + + + + Represents the noir color theme. + + + + + Represents the mandarin color theme. + + + + + Sets the color palette to default colors. + + + + + Sets the color palette to mandarin colors. + + + + + Sets the color palette to noir colors. + + + + + Determines whether all color values of the specified + ImageListViewColor are equal to this instance. + + The object to compare with this instance. + true if the two instances have the same color values; + otherwise false. + + + + Returns a hash code for this instance. + + + A hash code for this instance, suitable for use in + hashing algorithms and data structures like a hash table. + + + + + Returns a string that represents this instance. + + + A string that represents this instance. + + + + + 测试坐标 + + + + + 项的坐标 + + + + + 是否点击了项 + + + + + + + + + + + + + + + + + + + + + + 该项当前的选中状态 + + + + + + + + + + + + + + + + + + + + 所绑定的对象 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将指定的事件移动到(紧邻)另一个事件之前 + + + + + + + 将指定的事件移动到(紧邻)另一个事件之后 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Modify a WinForms TreeView control to use the new Explorer style theme + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + WM_COPYDATA消息所要求的数据结构 + + + + + + + + + + + + + + + + + + + + + + + + + 通过窗口的标题来查找窗口的句柄 + + + + + + + + 发送 Windows 消息 + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 发送消息，只能传递一个自定义的消息ID和消息字符串，想传一个结构，但没成功 + + 目标进程名称，如果有多个，则给每个都发送 + 自定义数据，可以通过这个来决定如何解析下面的strMsg + 传递的消息，是一个字符串 + + + + 接收消息，得到消息字符串 + + System.Windows.Forms.Message m + 接收到的消息字符串 + + + + + + + + + 最大圆角半径 + + + + + 最小矩形边长，用于自动处理圆角大小 + + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + 填充区域针对矩形的缩进距离 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + + + + 使图片单色化 + + + + + + + 获取颜色 + + + + + + + + + + + + + 颜色变化时激发 + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + The top left rectangle in auto hide strip area. + + + + + The top right rectangle in auto hide strip area. + + + + + The bottom left rectangle in auto hide strip area. + + + + + The bottom right rectangle in auto hide strip area. + + + + + Gets one of the four auto hide strip rectangles. + + Dock state. + The desired rectangle. + + As the corners are represented by , , , and , + the four strips can be easily calculated out as the borders. + + + + + Context menu. + + + This property should be obsolete as it does not support theming. Please use instead. + + + + + Context menu strip. + + + + + Overridden to avoid resize issues with nested controls + + + http://blogs.msdn.com/b/alejacma/archive/2008/11/20/controls-won-t-get-resized-once-the-nesting-hierarchy-of-windows-exceeds-a-certain-depth-x64.aspx + http://support.microsoft.com/kb/953934 + + + + + Determines whether the close button is visible on the content + + + + + There's a bug in the WinForms layout engine + that can result in a deferred layout to not + properly clear out the cached layout args after + the layout operation is performed. + Specifically, this bug is hit when the bounds of + the Pane change, initiating a layout on the parent + (DockWindow) which is where the bug hits. + To work around it, when a pane loses the DockWindow + as its parent, that parent DockWindow needs to + perform a layout to flush the cached args, if they exist. + + + + + Gets a value indicating whether dock panel can be dragged when in auto hide mode. + Default is false. + + + + + Determines the color with which the client rectangle will be drawn. + If this property is used instead of the BackColor it will not have any influence on the borders to the surrounding controls (DockPane). + The BackColor property changes the borders of surrounding controls (DockPane). + Alternatively both properties may be used (BackColor to draw and define the color of the borders and DockBackColor to define the color of the client rectangle). + For Backgroundimages: Set your prefered Image, then set the DockBackColor and the BackColor to the same Color (Control) + + + + + Dock area. + + + This is the center rectangle of control. + + Excluded spaces are for the following visual elements, + * Auto hide strips on four sides. + * Necessary paddings defined in themes. + + Therefore, all dock contents mainly fall into this area (except auto hide window, which might slightly move beyond this area). + + + + + Flag to show autohide content on mouse hover. Default value is true. + + + This flag is ignored in VS2012/2013 themes. Such themes assume it is always false. + + + + + DragHandlerBase is the base class for drag handlers. The derived class should: + 1. Define its public method BeginDrag. From within this public BeginDrag method, + DragHandlerBase.BeginDrag should be called to initialize the mouse capture + and message filtering. + 2. Override the OnDragging and OnEndDrag methods. + + + + + Loads layout from XML file. + + The file name. + Deserialization handler. + Deserialization might throw exceptions. + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + Deserialization might throw exceptions. + + The stream is closed after deserialization. + + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + The flag to close the stream after deserialization. + Deserialization might throw exceptions. + + + + Deserialization handler of layout file/stream. + + Strings stored in layout file/stream. + Dock content deserialized from layout/stream. + + The deserialization handler method should handle all possible exceptions. + + If any exception happens during deserialization and is not handled, the program might crash or experience other issues. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The skin to use when displaying the DockPanel. + The skin allows custom gradient color schemes to be used when drawing the + DockStrips and Tabs. + + + + + The skin used to display the auto hide strips and tabs. + + + + + The skin used to display the Document and ToolWindow style DockStrips and Tabs. + + + + + The skin used to display the auto hide strip and tabs. + + + + + The gradient color skin for the DockStrips. + + + + + The gradient color skin for the Tabs. + + + + + The gradient color skin for the Tabs. + + + + + Font used in AutoHideStrip elements. + + + + + The skin used to display the document and tool strips and tabs. + + + + + The skin used to display the Document style DockPane strip and tab. + + + + + The skin used to display the ToolWindow style DockPane strip and tab. + + + + + Font used in DockPaneStrip elements. + + + + + The skin used to display the DockPane ToolWindow strip and tab. + + + + + The skin used to display the active ToolWindow caption. + + + + + The skin used to display the inactive ToolWindow caption. + + + + + The skin used to display the DockPane strip and tab. + + + + + The gradient color skin for the DockStrip. + + + + + The skin used to display the active DockPane tabs. + + + + + The skin used to display the inactive DockPane tabs. + + + + + The skin used to display the dock pane tab + + + + + The text color. + + + + + The skin used to display the dock pane tab + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient color skin. + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient mode to display the colors. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Dock window base class. + + + + + Dock window of Visual Studio 2003/2005 theme. + + + + + The location to draw the DockPaneStrip for Document style windows. + + + + + + + + + + + + + + + Gets images for tabs and captions. + + + + + + + + + + Gets images for docking indicators. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Switches a pane with its first child in the pane hierarchy. (The actual hiding happens elsewhere.) + + Pane to switch + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 停靠 的本地化字符串。 + + + + + 查找类似 停靠通知 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 属性已更改 的本地化字符串。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 确定是否允许最终用户拖放停靠 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 启用/禁用DockContent的关闭按钮。 的本地化字符串。 + + + + + 查找类似 显示或隐藏DockContent的关闭按钮。此属性不适用于系统MDI文档样式。 的本地化字符串。 + + + + + 查找类似 窗体的类型必须为IDockContent。 的本地化字符串。 + + + + + 查找类似 获取或设置一个值，该值指示允许在DockPanel的哪个区域显示内容。 的本地化字符串。 + + + + + 查找类似 当DockState属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 指示DockContent将隐藏而不是关闭。 的本地化字符串。 + + + + + 查找类似 首次显示时所需的停靠状态。 的本地化字符串。 + + + + + 查找类似 显示停靠窗格选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 停靠窗格中显示的选项卡文本。如果未设置，将使用Text属性。 的本地化字符串。 + + + + + 查找类似 鼠标悬停在选项卡上时显示的文本。 的本地化字符串。 + + + + + 查找类似 提供的值超出范围。 的本地化字符串。 + + + + + 查找类似 无效值：DockAreas的值与当前DockState冲突。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 无效值，与DockableAreas属性冲突。 的本地化字符串。 + + + + + 查找类似 停靠状态无效。 的本地化字符串。 + + + + + 查找类似 DockPanel 为 null 的本地化字符串。 + + + + + 查找类似 beforeContent无效，它必须包含在pane中。 的本地化字符串。 + + + + + 查找类似 DockState无效：DockContent不能显示为“未知”或“隐藏”。 的本地化字符串。 + + + + + 查找类似 上一个Pane无效。它不能为null，其停靠状态不能自动隐藏。 的本地化字符串。 + + + + + 查找类似 DockPanel不能为null。 的本地化字符串。 + + + + + 查找类似 Pane不能为null。 的本地化字符串。 + + + + + 查找类似 无效值，请检查DockableAreas属性。 的本地化字符串。 + + + + + 查找类似 显示DockPanel选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 按SHIFT键以停靠到完全侧。 的本地化字符串。 + + + + + 查找类似 无效内容：ActiveContent必须是可见内容之一，如果没有可见内容，则为null。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent的DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 指定的容器与IsFloat属性冲突。 的本地化字符串。 + + + + + 查找类似 嵌套DockPanel集合中不存在上一个Pane。 的本地化字符串。 + + + + + 查找类似 容器不能为空。 的本地化字符串。 + + + + + 查找类似 当嵌套DockPanel集合不为空时，上一个Pane不能为空。 的本地化字符串。 + + + + + 查找类似 上一个Pane不能是其本身。 的本地化字符串。 + + + + + 查找类似 当DockState为DockState.Float时，FloatWindow属性不能设置为“null”。 的本地化字符串。 + + + + + 查找类似 无效内容：内容不在集合中。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 DockPanel的状态无效。 的本地化字符串。 + + + + + 查找类似 自动隐藏 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 属性 的本地化字符串。 + + + + + 查找类似 无效DockContent：DockContent必须为自动隐藏状态并与此DockPanel关联。 的本地化字符串。 + + + + + 查找类似 当AutoHideWindow的ActiveContent值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveContentProperty值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveDocument属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActivePane属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放停靠。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放嵌套停靠。 的本地化字符串。 + + + + + 查找类似 当DockContent添加到DockPanel时发生。 的本地化字符串。 + + + + + 查找类似 从DockPanel中删除DockContent时发生。 的本地化字符串。 + + + + + 查找类似 浮动窗口的默认大小。 的本地化字符串。 + + + + + 查找类似 提供Visual Studio.Net样式的停靠。 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 显示停靠窗口时要使用的视觉外观。 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 在停靠面板中拖动文档或Pane时发生。 的本地化字符串。 + + + + + 查找类似 文档窗口的样式。 的本地化字符串。 + + + + + 查找类似 确定绘制文档样式内容的选项卡栏的位置。 的本地化字符串。 + + + + + 查找类似 DockPanel已初始化。 的本地化字符串。 + + + + + 查找类似 配置文件的版本无效。 的本地化字符串。 + + + + + 查找类似 XML文件格式无效。 的本地化字符串。 + + + + + 查找类似 父窗体无效。使用DockingMdi或SystemMdi文档样式时，DockPanel控件必须是主MDI容器窗体的子控件。 的本地化字符串。 + + + + + 查找类似 DockPanel配置文件。作者：罗伟芬，版权所有。 的本地化字符串。 + + + + + 查找类似 !!! 自动生成的文件。不要修改！！！ 的本地化字符串。 + + + + + 查找类似 指示当RightToLeft属性设置为“是”时，控件布局是否从右向左。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 悬停在选项卡上时显示隐藏的自动隐藏内容。禁用时，必须单击选项卡才能显示内容。 的本地化字符串。 + + + + + 查找类似 在每个选项卡上显示关闭按钮 的本地化字符串。 + + + + + 查找类似 确定是否在选项卡栏中显示文档图标。 的本地化字符串。 + + + + + 查找类似 支持深度嵌套控件。禁用此设置可能会提高调整大小的性能，但可能会导致嵌套严重的内容无法调整大小。 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 窗口列表 的本地化字符串。 + + + + + 查找类似 无效参数：DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 无效DockPanel. 的本地化字符串。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Determines whether the close button is visible on the content + + + + + Calculate which tabs are displayed and in what order. + + + + + Visual Studio 2005 theme (default theme). + + + + + + + + + + X for this inside the logical strip rectangle. + + + + + Width of this . + + + + + Dock window of Visual Studio 2012 Light theme. + + + + + Initializes a new instance of the class. + + The dock panel. + State of the dock. + + + + Determines whether the close button is visible on the content + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 Docking 的本地化字符串。 + + + + + 查找类似 Docking Notification 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 Property Changed 的本地化字符串。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 Determines if end user drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 Enable/Disable the close button of the content. 的本地化字符串。 + + + + + 查找类似 Shows or hides the close button of the content. This property does not function with System MDI Document Style. 的本地化字符串。 + + + + + 查找类似 The form must be of type IDockContent. 的本地化字符串。 + + + + + 查找类似 Gets or sets a value indicating in which area of the DockPanel the content allowed to show. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of DockState property changed. 的本地化字符串。 + + + + + 查找类似 Indicates the content will be hidden instead of being closed. 的本地化字符串。 + + + + + 查找类似 The desired docking state when first showing. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找类似 The tab text displayed in the dock pane. If not set, the Text property will be used. 的本地化字符串。 + + + + + 查找类似 The text displayed when mouse hovers over the tab. 的本地化字符串。 + + + + + 查找类似 The provided value is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Value: The value of DockAreas conflicts with current DockState. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 Invalid value, conflicts with DockableAreas property. 的本地化字符串。 + + + + + 查找类似 The dock state is invalid. 的本地化字符串。 + + + + + 查找类似 The dock panel is null. 的本地化字符串。 + + + + + 查找类似 Invalid beforeContent, it must be contained by the pane. 的本地化字符串。 + + + + + 查找类似 Invalid DockState: Content can not be showed as "Unknown" or "Hidden". 的本地化字符串。 + + + + + 查找类似 The previous pane is invalid. It can not be null, and its docking state must not be auto-hide. 的本地化字符串。 + + + + + 查找类似 DockPanel can not be null. 的本地化字符串。 + + + + + 查找类似 The Pane can not be null. 的本地化字符串。 + + + + + 查找类似 Invalid value, check DockableAreas property. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找类似 Press SHIFT for docking to full side. 的本地化字符串。 + + + + + 查找类似 Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content. 的本地化字符串。 + + + + + 查找类似 Invalid argument: Content can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid argument: The content's DockPanel can not be "null". 的本地化字符串。 + + + + + 查找类似 The specified container conflicts with the IsFloat property. 的本地化字符串。 + + + + + 查找类似 The previous pane does not exist in the nested docking pane collection. 的本地化字符串。 + + + + + 查找类似 The container can not be null. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be null when the nested docking pane collection is not empty. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be itself. 的本地化字符串。 + + + + + 查找类似 FloatWindow property can not be set to "null" when DockState is DockState.Float. 的本地化字符串。 + + + + + 查找类似 Invalid Content: Content not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 The state for the dock pane is invalid. 的本地化字符串。 + + + + + 查找类似 Auto Hide 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window Position 的本地化字符串。 + + + + + 查找类似 Invalid Content: The content must be auto-hide state and associates with this DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of the AutoHideWindow's ActiveContent changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveContentProperty changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveDocument property changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActivePane property changed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop nested docking is allowed. 的本地化字符串。 + + + + + 查找类似 Occurs when a content added to the DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when a content removed from the DockPanel. 的本地化字符串。 + + + + + 查找类似 The default size of float window. 的本地化字符串。 + + + + + 查找类似 Provides Visual Studio .Net style docking. 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The visual skin to use when displaying the docked windows. 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The style of the document window. 的本地化字符串。 + + + + + 查找类似 Determines where the tab strip for Document style content is drawn. 的本地化字符串。 + + + + + 查找类似 The DockPanel has already been initialized. 的本地化字符串。 + + + + + 查找类似 The configuration file's version is invalid. 的本地化字符串。 + + + + + 查找类似 The XML file format is invalid. 的本地化字符串。 + + + + + 查找类似 Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form. 的本地化字符串。 + + + + + 查找类似 DockPanel configuration file. Author: Weifen Luo, all rights reserved. 的本地化字符串。 + + + + + 查找类似 !!! AUTOMATICALLY GENERATED FILE. DO NOT MODIFY !!! 的本地化字符串。 + + + + + 查找类似 Indicates whether the control layout is right-to-left when the RightToLeft property is set to Yes. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Shows the hidden autohide content when hovering over the tab. When disabled, the tab must be clicked to show the content. 的本地化字符串。 + + + + + 查找类似 Show close button on each tab 的本地化字符串。 + + + + + 查找类似 Determines if the document icon will be displayed in the tab strip. 的本地化字符串。 + + + + + 查找类似 Support deeply nested controls. Disabling this setting may improve resize performance but may cause heavily nested content not to resize. 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window List 的本地化字符串。 + + + + + 查找类似 Invalid argument: DockPanel can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid DockPanel. 的本地化字符串。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculate which tabs are displayed and in what order. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 theme base. + + + + + + + + + + + + + + + + diff --git a/Bin/Debug/CommonControls/.NET4/RyPrint.dll b/Bin/Debug/CommonControls/.NET4/RyPrint.dll deleted file mode 100644 index c639d9e..0000000 Binary files a/Bin/Debug/CommonControls/.NET4/RyPrint.dll and /dev/null differ diff --git a/Bin/Debug/CommonControls/.NET4/RyWeb.dll b/Bin/Debug/CommonControls/.NET4/RyWeb.dll deleted file mode 100644 index 44dd329..0000000 Binary files a/Bin/Debug/CommonControls/.NET4/RyWeb.dll and /dev/null differ diff --git a/Bin/Debug/CommonControls/.NET4/RyWeb.xml b/Bin/Debug/CommonControls/.NET4/RyWeb.xml deleted file mode 100644 index 0f17d55..0000000 --- a/Bin/Debug/CommonControls/.NET4/RyWeb.xml +++ /dev/null @@ -1,603 +0,0 @@ - - - - RyWeb - - - - - Http连接操作帮助类 - - - - - - - - - - - - 根据相传入的数据，得到相应页面数据 - - 参数类对象 - 返回HttpResult类型 - - - - 获取数据的并解析的方法 - - - - - - - 设置编码 - - HttpItem - HttpResult - byte[] - - - - 提取网页Byte - - - - - - 为请求准备参数 - - 参数列表 - - - - 设置证书 - - - - - - 设置多个证书 - - - - - - 设置Cookie - - Http参数 - - - - 设置Post数据 - - Http参数 - - - - 设置代理 - - 参数对象 - - - - 回调验证证书问题 - - 流对象 - 证书 - X509Chain - SslPolicyErrors - bool - - - - 通过设置这个属性，可以在发出连接的时候绑定客户端发出连接所使用的IP地址。 - - - - - - - - - Http请求参考类 - - - - - 请求URL必须填写 - - - - - 请求方式默认为GET方式,当为POST方式时必须设置Postdata的值 - - - - - 默认请求超时时间 - - - - - 默认写入Post数据超时间 - - - - - 设置Host的标头信息 - - - - - 获取或设置一个值，该值指示是否与 Internet 资源建立持久性连接默认为true。 - - - - - 请求标头值 默认为text/html, application/xhtml+xml, */* - - - - - 请求返回类型默认 text/html - - - - - 客户端访问信息默认Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0) - - - - - 返回数据编码默认为NUll,可以自动识别,一般为utf-8,gbk,gb2312 - - - - - Post的数据类型 - - - - - Post请求时要发送的字符串Post数据 - - - - - Post请求时要发送的Byte类型的Post数据 - - - - - Cookie对象集合 - - - - - 请求时的Cookie - - - - - 来源地址，上次访问地址 - - - - - 证书绝对路径 - - - - - 设置代理对象，不想使用IE默认配置就设置为Null，而且不要设置ProxyIp - - - - - 是否设置为全文小写，默认为不转化 - - - - - 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 - - - - - 最大连接数 - - - - - 代理Proxy 服务器用户名 - - - - - 代理 服务器密码 - - - - - 代理 服务IP,如果要使用IE代理就设置为ieproxy - - - - - 设置返回类型String和Byte - - - - - header对象 - - - - - 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 - - - - - 获取或设置一个 System.Boolean 值，该值确定是否使用 100-Continue 行为。如果 POST 请求需要 100-Continue 响应，则为 true；否则为 false。默认值为 true。 - - - - - 设置509证书集合 - - - - - 设置或获取Post参数编码,默认的为Default编码 - - - - - Cookie返回类型,默认的是只返回字符串类型 - - - - - 获取或设置请求的身份验证信息。 - - - - - 设置请求将跟随的重定向的最大数目 - - - - - 获取和设置IfModifiedSince，默认为当前日期和时间 - - - - - 设置本地的出口ip和端口 - ] - - item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); - - - - - Http返回参数类 - - - - - Http请求返回的Cookie - - - - - Cookie对象集合 - - - - - 返回的String类型数据 只有ResultType.String时才返回数据，其它情况为空 - - - - - 返回的Byte数组 只有ResultType.Byte时才返回数据，其它情况为空 - - - - - header对象 - - - - - 返回状态说明 - - - - - 返回状态码,默认为OK - - - - - 最后访问的URl - - - - - 获取重定向的URl - - - - - 返回类型 - - - - - 表示只返回字符串 只有Html有数据 - - - - - 表示返回字符串和字节流 ResultByte和Html都有数据返回 - - - - - Post的数据格式默认为string - - - - - 字符串类型，这时编码Encoding可不设置 - - - - - Byte类型，需要设置PostdataByte参数的值编码Encoding可设置为空 - - - - - 传文件，Postdata必须设置为文件的绝对路径，必须设置Encoding的值 - - - - - Cookie返回类型 - - - - - 只返回字符串类型的Cookie - - - - - CookieCollection格式的Cookie集合同时也返回String类型的cookie - - - - - - - - - - 以post方式获取网页源码 - - - - - - - - - 以post方式提交json内容 - - - - - - - - - 以post方式提交json内容 - - - - - - - - 以post方式获取网页源码 - - - - - - - - - - 以post方式获取网页源码 - - - - - - - - 获取网址对应的文件大小 - - - - - - - - - - - - 获取网页源码 - - - - - - - - 获取网页源码 - - - - - - - - - 获取网页源码 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 将相对网址转换成绝对网址 - - 相对网址 - 当前页面地址 - 转换后的绝对网址 - - - - - - - - - - - - - - url解密 - - - - - - - - url解密,按UTF8方式解密 - - - - - - - Url加密 - - - - - - - - Url加密,按UTF8方式加密 - - - - - - - 解密 - - - - - - - 加密 - - - - - - - - - - - - - - - - - - - - - - - - - url加密,Unicode - - - - - - - - - - - - - - - - - - - - - - Html解码,将html里未转义成功的重新转义。 - - - - - - diff --git a/Bin/Debug/CommonControls/.NET4/ryControls.dll b/Bin/Debug/CommonControls/.NET4/ryControls.dll deleted file mode 100644 index 893428e..0000000 Binary files a/Bin/Debug/CommonControls/.NET4/ryControls.dll and /dev/null differ diff --git a/Bin/Debug/CommonControls/.NET4/ryUpdate.dll b/Bin/Debug/CommonControls/.NET4/ryUpdate.dll index 1567cfd..886a228 100644 Binary files a/Bin/Debug/CommonControls/.NET4/ryUpdate.dll and b/Bin/Debug/CommonControls/.NET4/ryUpdate.dll differ diff --git a/Bin/Release/CommonControls/.NET4 示例/Itrycn_Project.exe b/Bin/Release/CommonControls/.NET4 示例/Itrycn_Project.exe index edd2f05..72875aa 100644 Binary files a/Bin/Release/CommonControls/.NET4 示例/Itrycn_Project.exe and b/Bin/Release/CommonControls/.NET4 示例/Itrycn_Project.exe differ diff --git a/Bin/Release/CommonControls/.NET4 示例/Itrycn_Project2.exe b/Bin/Release/CommonControls/.NET4 示例/Itrycn_Project2.exe index 18f6e1c..b766a0f 100644 Binary files a/Bin/Release/CommonControls/.NET4 示例/Itrycn_Project2.exe and b/Bin/Release/CommonControls/.NET4 示例/Itrycn_Project2.exe differ diff --git a/Bin/Release/CommonControls/.NET4 示例/MyDb.dll b/Bin/Release/CommonControls/.NET4 示例/MyDb.dll index c9aa0fe..80404b2 100644 Binary files a/Bin/Release/CommonControls/.NET4 示例/MyDb.dll and b/Bin/Release/CommonControls/.NET4 示例/MyDb.dll differ diff --git a/Bin/Release/CommonControls/.NET4 示例/MyDb.xml b/Bin/Release/CommonControls/.NET4 示例/MyDb.xml index a616cd0..a9f0931 100644 --- a/Bin/Release/CommonControls/.NET4 示例/MyDb.xml +++ b/Bin/Release/CommonControls/.NET4 示例/MyDb.xml @@ -1090,6 +1090,13 @@ 是否是通配符表达式,不是，则普通替换，忽略大小写，是，则启用通配符替换 + + + 将颜色转换为Html颜色格式 + + + + 支持忽略大小写的替换文本功能 @@ -1595,8 +1602,15 @@ 比较两个版本号大小 - - oldVer小于newVer,返回1,大于则返回-1,相等返回0 + + oldVer小于newVer,返回1,大于则返回-1,相等返回0,不支持则返回-1000 + + + + 从字符串中提取版本号 + + + @@ -1653,6 +1667,14 @@ 目标文件夹 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + 复制文件夹到目标文件夹,支持进度事件,支持中途取消 @@ -1784,6 +1806,429 @@ 是否要删除 + + + 图片相关API + + + + + 从文件或Url中加载图片,使用本方法，不会导致图片文件被占用。 + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 以逆时针为方向对图像进行旋转 + + 位图流 + 旋转角度[0,360](前台给的) + + + + + 是否包括透明像素 + + + + 操作失败 + + + + 矩形边界 + + + + + + + + 计算水印位置 + + + + + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 计算最大字体大小 + + + + + + + + + + + 计算旋转矩形大小 + + + + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + + + + + 缩放 + + + 宽 + 高 + 插值算法 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 缩放 + + + 宽 + 高 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 根据原边长和新边长计算绘制的起始点坐标 + + + + + + + + 获取缩放模式 + + + + + + 是否裁剪图片 + + + + + 裁剪或填充 + + + + + 背景色 + 插值算法 + + Image 不能为 null + 操作失败 + + + + 裁剪 + + + 宽度 + 高度 + + 返回裁剪后的图片 + Image 不能为 null + 新的图片尺寸的宽度和高度必须大于零 + 操作失败 + + + + 调整宽度 + + + + + + + + 根据最大宽度调整图片尺寸 + + + 最大宽度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最大高度调整图片尺寸 + + + 最大高度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 调整高度 + + + + + + + + 调整图片大小 + + + + + + + + + + 调整图片大小 + + + + + + + + + + + 调整图片大小 + + + + + + + + + + + + + 转换Image为Icon + + 要转换为图标的Image对象 + 当image为null时是否返回null。false则抛空引用异常 + + + + + 缩放模式 + + + + + 宽度优先(不裁剪宽) + + + + + 高度优先(不裁剪高) + + + + + 水印位置 + + + + + 左上角 + + + + + 中上 + + + + + 右上角 + + + + + 左中 + + + + + 居中 + + + + + 右中 + + + + + 左下角 + + + + + 中下 + + + + + 右下角 + + + + + 全屏平铺 + + 音频播放类 @@ -2072,6 +2517,14 @@ 复制目标文件路径 + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) @@ -2186,6 +2639,20 @@ + + + 判断是否为空的文件夹 + + + + + + + 文件或文件夹是否存在 + + + + 判断文件名是否有效 @@ -2260,6 +2727,13 @@ + + + 以UTF-8格式写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + 从文件中加载图片,使用本方法，不会导致图片文件被占用。 @@ -2290,6 +2764,13 @@ + + + 根据文件大小字符串获取长整型表示的文件大小 + + + + 获取文件大小字符串 @@ -2451,7 +2932,7 @@ 判断是否是不带 BOM 的 UTF8 格式 - + @@ -2780,6 +3261,125 @@ 父窗体居中 + + + + + + + + + + + + + + + + + + + + + + + 设置线程数量 + + + + + 要计算的总数量 + + + + + 每个线程要计算的数量 + + + + + + + + + + 当前已使用的时间 + + + + + + + 线程数量 + 要计算的事务数量 + + + + + + + + + + + + + + + + + + + + + + + 多线程计算时激发 + + + + + 在所有线程执行完毕后发生 + + + + + 在线程执行完毕后发生,最后一个执行完毕的线程将不收到本事件通知 + + + + + 进程相关接口 + + + + + 获取进程路径 + + + + + + + 获取进程路径 + + + + + + + 获取命令行 + + + + + + + 获取命令行 + + + + 运行库检测类 @@ -6854,6 +7454,11 @@ + + + + + 使管理员方式运行时支持拖放 @@ -6903,6 +7508,80 @@ + + + + + + + + 获取WMI内容 + + + + + + + 获取WMI内容 + + + + + + + 获取内存信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取硬盘信息 + + + + + + 获取主板信息 + + + + + + 获取处理器信息 + + + + + + 获取主要硬件信息 + + + + + + 获取主要硬件信息 + + 是否获取XML格式 + + 网络操作类 @@ -7039,6 +7718,61 @@ 文件映射对象的名称 + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 删除内存映射 + + + + 写共享内存 @@ -7624,6 +8358,12 @@ 释放资源 + + + 最后一个错误信息 + + + @@ -7779,6 +8519,12 @@ + + + 获取最后一次错误信息 + + + @@ -8535,6 +9281,11 @@ 是否设置为全文小写，默认为不转化 + + + 获取或设置要在 HTTP 请求中使用的 Date HTTP 标头值。默认不填写 + + 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 @@ -8618,6 +9369,11 @@ item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); + + + 是否重置request,response的值，默认不重置，当设置为True时request,response将被设置为Null + + Http返回参数类 @@ -8792,6 +9548,11 @@ + + + + + @@ -8817,6 +9578,26 @@ + + + + + + + + + + + + + + + + + + + + @@ -8917,6 +9698,11 @@ + + + 是否自动跳转 + + 获取网页源码 @@ -8964,6 +9750,13 @@ + + + + + + + 将相对网址转换成绝对网址 @@ -8972,6 +9765,116 @@ 当前页面地址 转换后的绝对网址 + + + WebDav接口 + + + + + WebDav初始化 + + + + + + + + 删除文件 + + 相对路径,不包括域名 + + + + + 下载文件 + + + + + + + + 下载文件 + + + + + + + + + 上传文件 + + + + + + + + 上传文件 + + + + + + + + + 新建文件夹 + + + + + + + 新建文件夹 + + 文件夹路径 + + + + + + 新建文件夹 + + + + + + + + 将文件或目录列出来 + + + + + + + + 定义每个文件或目录的属性 + + + + + 文件名 + + + + + 是否是文件夹 + + + + + 网址 + + + + + 最后修改时间 + + @@ -10222,6 +11125,22 @@ + + + + + + + + + + + + + + + + @@ -10732,6 +11651,20 @@ + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 diff --git a/Bin/Release/CommonControls/.NET4 示例/MyDb_SQLite.dll b/Bin/Release/CommonControls/.NET4 示例/MyDb_SQLite.dll index cd8754b..fa2c602 100644 Binary files a/Bin/Release/CommonControls/.NET4 示例/MyDb_SQLite.dll and b/Bin/Release/CommonControls/.NET4 示例/MyDb_SQLite.dll differ diff --git a/Bin/Release/CommonControls/.NET4 示例/MyDb_SQLite.xml b/Bin/Release/CommonControls/.NET4 示例/MyDb_SQLite.xml index 2fe5ccb..b80291c 100644 --- a/Bin/Release/CommonControls/.NET4 示例/MyDb_SQLite.xml +++ b/Bin/Release/CommonControls/.NET4 示例/MyDb_SQLite.xml @@ -213,6 +213,12 @@ + + + 获取最后一次错误信息 + + + diff --git a/Bin/Release/CommonControls/.NET4 示例/RyPrint.dll b/Bin/Release/CommonControls/.NET4 示例/RyPrint.dll index d08761b..4d5e46b 100644 Binary files a/Bin/Release/CommonControls/.NET4 示例/RyPrint.dll and b/Bin/Release/CommonControls/.NET4 示例/RyPrint.dll differ diff --git a/Bin/Release/CommonControls/.NET4 示例/ryControls.dll b/Bin/Release/CommonControls/.NET4 示例/ryControls.dll index c4cf250..06067d5 100644 Binary files a/Bin/Release/CommonControls/.NET4 示例/ryControls.dll and b/Bin/Release/CommonControls/.NET4 示例/ryControls.dll differ diff --git a/Bin/Release/CommonControls/.NET4 示例/ryControls.xml b/Bin/Release/CommonControls/.NET4 示例/ryControls.xml index b1b565f..61b6e79 100644 --- a/Bin/Release/CommonControls/.NET4 示例/ryControls.xml +++ b/Bin/Release/CommonControls/.NET4 示例/ryControls.xml @@ -5182,6 +5182,9 @@ 超级颜色选择控件 + + 分页控件 + @@ -7028,6 +7031,193 @@ the contents of this method with the code editor. + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + Looks up a localized resource of type System.Byte[]. + + + + + Looks up a localized resource of type System.Byte[]. + + 颜色标签 @@ -8625,6 +8815,16 @@ 标签创建时事件 + + + 标签激活前事件 + + + + + 标签激活后事件 + + 在标签栏创建时激发 @@ -8777,6 +8977,18 @@ MGdUI皮肤 + + + + + + + + + + + + 获取子窗体 @@ -8824,6 +9036,11 @@ to make the client area to have 3D view + + + 双击事件 + + 消息 @@ -9951,6 +10168,9851 @@ + + + Adapter for WinForms brushes objects for core. + + + + + The actual WinForms brush instance. + + + + + If to dispose the brush when is called.
+ Ignore dispose for cached brushes. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms context menu for core. + + + + + the underline win forms context menu + + + + + Init. + + + + + Adapter for WinForms Control for core. + + + + + the underline win forms control. + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Get the underline win forms control + + + + + Adapter for WinForms Font object for core. + + + + + the underline win-forms font. + + + + + a handle to this Font. + + + + + the vertical offset of the font underline location from the top of the font. + + + + + Cached font height. + + + + + Cached font whitespace width. + + + + + Init. + + + + + the underline win-forms font. + + + + + Get the handle to this Font. + + + + + Set font metrics to be cached for the font for future use. + + the full height of the font + the vertical offset of the font underline location from the top of the font. + + + + Adapter for WinForms Font family object for core. + + + + + the underline win-forms font. + + + + + Init. + + + + + the underline win-forms font family. + + + + + Adapter for WinForms Graphics for core. + + + + + used for calculation. + + + + + used for calculation. + + + + + Used for GDI+ measure string. + + + + + The string format to use for measuring strings for GDI+ text rendering + + + + + The string format to use for rendering strings for GDI+ text rendering + + + + + The wrapped WinForms graphics object + + + + + Use GDI+ text rendering to measure/draw text. + + + + + the initialized HDC used + + + + + if to release the graphics object on dispose + + + + + If text alignment was set to RTL + + + + + Init static resources. + + + + + Init. + + the win forms graphics object to use + Use GDI+ text rendering to measure/draw text + optional: if to release the graphics object on dispose (default - false) + + + + Release current HDC to be able to use methods. + + + + + Init HDC for the current graphics object to be used to call GDI directly. + + + + + Set a resource (e.g. a font) for the specified device context. + WARNING: Calling Font.ToHfont() many times without releasing the font handle crashes the app. + + + + + Set the text color of the device context. + + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Special draw logic to draw transparent text using GDI.
+ 1. Create in-memory DC
+ 2. Copy background to in-memory DC
+ 3. Draw the text to in-memory DC
+ 4. Copy the in-memory DC to the proper location with alpha blend
+ + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Adapter for WinForms graphics path object for core. + + + + + The actual WinForms graphics path instance. + + + + + the last point added to the path to begin next segment from + + + + + The actual WinForms graphics path instance. + + + + + Get arc start angle for the given corner. + + + + + Adapter for WinForms Image object for core. + + + + + the underline win-forms image. + + + + + Initializes a new instance of the class. + + + + + the underline win-forms image. + + + + + Adapter for WinForms pens objects for core. + + + + + The actual WinForms brush instance. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms platforms. + + + + + Singleton instance of global adapter. + + + + + Init installed font families and set default font families mapping. + + + + + Singleton instance of global adapter. + + + + + Low level handling of Html Renderer logic, this class is used by , + , and .
+ + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + returns page list + + + + + returns page list count + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrappable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given printer device. + + the printer device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + mouse event args + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the mouse event args + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + + + + + + Create HtmlRenderer mouse event from win forms mouse event. + + + + + Create HtmlRenderer key event from win forms key event. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ Using and client can control how the html content effects the + size of the label. Either case scrollbars are never shown and html content outside of client bounds will be clipped. + and with AutoSize can limit the max/min size of the control
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoSize:

+ AutoSize = AutoSizeHeightOnly = false
+ The label size will not change by the html content. MaximumSize and MinimumSize are ignored.
+
+ AutoSize = true
+ The width and height is adjustable by the html content, the width will be longest line in the html, MaximumSize.Width will restrict it but it can be lower than that.
+
+ AutoSizeHeightOnly = true
+ The width of the label is set and will not change by the content, the height is adjustable by the html content with restrictions to the MaximumSize.Height and MinimumSize.Height values.
+ + +

LinkClicked event

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + the current html text set in the control + + + + + is to handle auto size of the control height only + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + Creates a new HTML Label + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Automatically sets the size of the label by content size + + + + + Automatically sets the height of the label by content height (width is not effected). + + + + + Gets or sets the max size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the min size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the html of this control. + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform paint of the html in the control. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ If is true and the layout of the html resulted in its content beyond the client bounds + of the panel it will show scrollbars (horizontal/vertical) allowing to scroll the content.
+ If is false html content outside the client bounds will be clipped.
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoScroll:

+ Allows showing scrollbars if html content is placed outside the visible boundaries of the panel. + + +

LinkClicked event:

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the control + + + + + the current html text set in the control + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + The last position of the scrollbars to know if it has changed to update mouse + + + + + Creates a new HtmlPanel and sets a basic css for it's styling. + + + + + + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. + + + + + Gets or sets the text of this panel + + + + + + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Adjust the scrollbar of the panel on html element by the given id.
+ The top of the html element rectangle will be at the top of the panel, if there + is not enough height to scroll to the top the scroll will be at maximum.
+ + the id of the element to scroll to + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform html container layout by the current panel client size. + + + + + Perform paint of the html in the control. + + + + + Set focus on the control for keyboard scrollbars handling. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Handle key down event for selection, copy and scrollbars handling. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + On html renderer scroll request adjust the scrolling of the panel to the requested location. + + + + + Adjust the scrolling of the panel to the requested location. + + the location to adjust the scroll to + + + + call mouse move to handle paint after scroll or html change affecting mouse cursor. + + + + + Used to add arrow keys to the handled keys in . + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Standalone static class for simple and direct HTML rendering.
+ For WinForms UI prefer using HTML controls: or .
+ For low-level control and performance consider using .
+ + + + GDI vs. GDI+ text rendering
+ Windows supports two text rendering technologies: GDI and GDI+.
+ GDI is older, has better performance and looks better on standard monitors but doesn't support alpha channel for transparency.
+ GDI+ is newer, device independent so work better for printers but is slower and looks worse on monitors.
+ HtmlRender supports both GDI and GDI+ text rendering to accommodate different needs, GDI+ text rendering methods have "GdiPlus" suffix + in their name where GDI do not.
+ + + Rendering to image
+ See https://htmlrenderer.codeplex.com/wikipage?title=Image%20generation
+ Because of GDI text rendering issue with alpha channel clear type text rendering rendering to image requires special handling.
+ Solid color background - generate an image where the background is filled with solid color and all the html is rendered on top + of the background color, GDI text rendering will be used. (RenderToImage method where the first argument is html string)
+ Image background - render html on top of existing image with whatever currently exist but it cannot have transparent pixels, + GDI text rendering will be used. (RenderToImage method where the first argument is Image object)
+ Transparent background - render html to empty image using GDI+ text rendering, the generated image can be transparent. + Text rendering can be controlled using , note that + doesn't render well on transparent background. (RenderToImageGdiPlus method)
+ + + Overwrite stylesheet resolution
+ Exposed by optional "stylesheetLoad" delegate argument.
+ Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + Overwrite image resolution
+ Exposed by optional "imageLoad" delegate argument.
+ Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ Note: Cannot use asynchronous scheme overwrite scheme.
+ + + + + Simple rendering
+ HtmlRender.Render(g, "Hello World]]>");
+ HtmlRender.Render(g, "Hello World]]>", 10, 10, 500, CssData.Parse("body {font-size: 20px}")");
+ + + Image rendering
+ HtmlRender.RenderToImage("Hello World]]>", new Size(600,400));
+ HtmlRender.RenderToImage("Hello World]]>", 600);
+ HtmlRender.RenderToImage(existingImage, "Hello World]]>");
+ + + + + + Adds a font family to be used in html rendering.
+ The added font will be used by all rendering function including and all WinForms controls. + + + The given font family instance must be remain alive while the renderer is in use.
+ If loaded to then the collection must be alive.
+ If loaded from file then the file must not be deleted. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + + This fonts mapping can be used as a fallback in case the requested font is not installed in the client system. + + the font family to replace + the font family to replace with + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI text rendering, note has no effect. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI+ text rending, use to control text rendering. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Renders the specified HTML source on the specified location and max width restriction.
+ Use GDI text rendering, note has no effect.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI text rendering, note has no effect.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ The HTML will be layout by the given image size but may be clipped if cannot fit.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + optional: the top-left most location to start render the html at (default - 0,0) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Measure the size (width and height) required to draw the given html under given width and height restrictions.
+ + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size of the html by performing layout under the given restrictions. + + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Clip the graphics so the html will not be rendered outside the max height bound given.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Copy all the bitmap bits from memory bitmap buffer to the given image. + + the source memory bitmap buffer to copy from + the destination bitmap image to copy to + + + + Provides HTML rendering on the tooltips. + + + + + the container to render and handle the html shown in the tooltip + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + The text rendering hint to be used for text rendering. + + + + + The CSS class used for tooltip html root div + + + + + the control that the tooltip is currently showing on.
+ Used for link handling. + + + + + timer used to handle mouse move events when mouse is over the tooltip.
+ Used for link handling. + + + + + the handle of the actual tooltip window used to know when the tooltip is hidden
+ Used for link handling. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + The CSS class used for tooltip html root div (default: htmltooltip)
+ Setting to 'null' clear base style on the tooltip.
+ Set custom class found in to change the base style of the tooltip. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Gets or sets the max size the tooltip. + + An ordered pair of type representing the width and height of a rectangle. + + + + On tooltip appear set the html by the associated control, layout and set the tooltip size by the html size. + + + + + Draw the html using the tooltip graphics. + + + + + Adjust the location of the tooltip window to the location of the mouse and handle + if the tooltip window will try to appear outside the boundaries of the control. + + the control the tooltip is appearing on + the size of the tooltip window + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Raised on link handling timer tick, used for: + 1. Know when the tooltip is hidden by checking the visibility of the tooltip window. + 2. Call HandleMouseMove so the mouse cursor will react if over a link element. + 3. Call HandleMouseDown and HandleMouseUp to simulate click on a link if one was clicked. + + + + + Unsubscribe from events and dispose of . + + + + + Helper to encode and set HTML fragment to clipboard.
+ See http://theartofdev.wordpress.com/2012/11/11/setting-html-and-plain-text-formatting-to-clipboard/.
+ . + + + The MIT License (MIT) Copyright (c) 2014 Arthur Teplitzki. + + + + + The string contains index references to other spots in the string, so we need placeholders so we can compute the offsets.
+ The _ strings are just placeholders. We'll back-patch them actual values afterwards.
+ The string layout () also ensures that it can't appear in the body of the html because the
+ character must be escaped.
+ + + + + html comment to point the beginning of html fragment + + + + + html comment to point the end of html fragment + + + + + Used to calculate characters byte count in UTF-8 + + + + + Create with given html and plain-text ready to be used for clipboard or drag and drop.
+ Handle missing ]]> tags, specified start\end segments and Unicode characters. + + + + Windows Clipboard works with UTF-8 Unicode encoding while .NET strings use with UTF-16 so for clipboard to correctly + decode Unicode string added to it from .NET we needs to be re-encoded it using UTF-8 encoding. + + + Builds the CF_HTML header correctly for all possible HTMLs
+ If given html contains start/end fragments then it will use them in the header: + hello world]]> + If given html contains html/body tags then it will inject start/end fragments to exclude html/body tags: + hello world]]> + If given html doesn't contain html/body tags then it will inject the tags and start/end fragments properly: + world]]> + In all cases creating a proper CF_HTML header:
+ + + hello world + ]]> + + See format specification here: http://msdn.microsoft.com/library/default.asp?url=/workshop/networking/clipboard/htmlclipboard.asp + + + a html fragment + the plain text + + + + Clears clipboard and sets the given HTML and plain text fragment to the clipboard, providing additional meta-information for HTML.
+ See for HTML fragment details.
+ + + ClipboardHelper.CopyToClipboard("Hello World", "Hello World"); + + a html fragment + the plain text + + + + Clears clipboard and sets the given plain text fragment to the clipboard.
+ + the plain text + + + + Generate HTML fragment data string with header that is required for the clipboard. + + the html to generate for + the resulted string + + + + Calculates the number of bytes produced by encoding the string in the string builder in UTF-8 and not .NET default string encoding. + + the string builder to count its string + optional: the start index to calculate from (default - start of string) + optional: the end index to calculate to (default - end of string) + the number of bytes required to encode the string in UTF-8 + + + + Utilities for converting WinForms entities to HtmlRenderer core entities. + + + + + Convert from WinForms point to core point. + + + + + Convert from WinForms point to core point. + + + + + Convert from core point to WinForms point. + + + + + Convert from core point to WinForms point. + + + + + Convert from WinForms size to core size. + + + + + Convert from core size to WinForms size. + + + + + Convert from core size to WinForms size. + + + + + Convert from WinForms rectangle to core rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from WinForms color to core color. + + + + + Convert from core color to WinForms color. + + + + + Utility for Win32 API. + + + + + Const for BitBlt copy raster-operation code. + + + + + Const for BitBlt paint raster-operation code. + + + + + Create a compatible memory HDC from the given HDC.
+ The memory HDC can be rendered into without effecting the original HDC.
+ The returned memory HDC and must be released using . + + the HDC to create memory HDC from + the width of the memory HDC to create + the height of the memory HDC to create + returns used bitmap memory section that must be released when done with memory HDC + memory HDC + + + + Release the given memory HDC and dib section created from . + + Memory HDC to release + bitmap section to release + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + A pointer to a RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + If the function succeeds, the return value is nonzero. + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ARGB (alpha, red, green, blue) color. + + + + + Represents a color that is null. + + 1 + + + + Gets a system-defined color. + + + + + Gets a system-defined color that has an ARGB value of #FF000000. + + + + + Gets a system-defined color that has an ARGB value of #FFFFFFFF. + + + + + Gets a system-defined color that has an ARGB value of #FFF5F5F5. + + + + + Gets a system-defined color that has an ARGB value of #FFD3D3D3. + + + + + Gets the red component value of this structure. + + + + + Gets the green component value of this structure. + + + + + Gets the blue component value of this structure. + + + + + Gets the alpha component value of this structure. + + + + + Specifies whether this structure is uninitialized. + + + This property returns true if this color is uninitialized; otherwise, false. + + 1 + + + + Tests whether two specified structures are equivalent. + + + true if the two structures are equal; otherwise, false. + + + The that is to the left of the equality operator. + + + The that is to the right of the equality operator. + + 3 + + + + Tests whether two specified structures are different. + + + true if the two structures are different; otherwise, false. + + + The that is to the left of the inequality operator. + + + The that is to the right of the inequality operator. + + 3 + + + + Creates a structure from the four ARGB component (alpha, red, green, and blue) values. Although this method allows a 32-bit value to be passed for each component, the value of each component is limited to 8 bits. + + + The that this method creates. + + The alpha component. Valid values are 0 through 255. + The red component. Valid values are 0 through 255. + The green component. Valid values are 0 through 255. + The blue component. Valid values are 0 through 255. + + , , , or is less than 0 or greater than 255. + + 1 + + + + Creates a structure from the specified 8-bit color values (red, green, and blue). The alpha value is implicitly 255 (fully opaque). Although this method allows a 32-bit value to be passed for each color component, the value of each component is limited to 8 bits. + + + The that this method creates. + + + The red component value for the new . Valid values are 0 through 255. + + + The green component value for the new . Valid values are 0 through 255. + + + The blue component value for the new . Valid values are 0 through 255. + + + , , or is less than 0 or greater than 255. + + 1 + + + + Tests whether the specified object is a structure and is equivalent to this + + structure. + + + true if is a structure equivalent to this + + structure; otherwise, false. + + The object to test. + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies the hash code for this . + + 1 + + + + Converts this structure to a human-readable string. + + + + + Specifies the style of dashed lines drawn with a object. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 自定义 + + + + + Specifies style information applied to text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + Init. + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + Is the left mouse button participated in the event + + + + + Init. + + + + + Is the left mouse button participated in the event + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ordered pair of floating-point x- and y-coordinates that defines a point in a two-dimensional plane. + + + + + Represents a new instance of the class with member data left uninitialized. + + 1 + + + + Initializes a new instance of the class with the specified coordinates. + + The horizontal position of the point. + The vertical position of the point. + + + + + + Gets a value indicating whether this is empty. + + + true if both and + + are 0; otherwise, false. + + 1 + + + + Gets or sets the x-coordinate of this . + + + The x-coordinate of this . + + 1 + + + + Gets or sets the y-coordinate of this . + + + The y-coordinate of this . + + 1 + + + + Translates the by the specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the x- and y-coordinates of the + + . + + + + + Translates a by the negative of a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Compares two structures. The result specifies whether the values of the + + and properties of the two + + structures are equal. + + + true if the and + + values of the left and right + + structures are equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Determines whether the coordinates of the specified points are not equal. + + + true to indicate the and + + values of and + + are not equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Translates a given by a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the coordinates of + + . + + + + + Translates a by the negative of a specified size. + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Specifies whether this contains the same coordinates as the specified + + . + + + This method returns true if is a and has the same coordinates as this + + . + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts this to a human readable string. + + + A string that represents this . + + 1 + + + + Stores a set of four floating-point numbers that represent the location and size of a rectangle. + + + + + Represents an instance of the class with its members uninitialized. + + + + + Initializes a new instance of the class with the specified location and size. + + The x-coordinate of the upper-left corner of the rectangle. + The y-coordinate of the upper-left corner of the rectangle. + The width of the rectangle. + The height of the rectangle. + + + + Initializes a new instance of the class with the specified location and size. + + A that represents the upper-left corner of the rectangular region. + A that represents the width and height of the rectangular region. + + + + Gets or sets the coordinates of the upper-left corner of this structure. + + A that represents the upper-left corner of this structure. + + + + Gets or sets the size of this . + + A that represents the width and height of this structure. + + + + Gets or sets the x-coordinate of the upper-left corner of this structure. + + + The x-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the y-coordinate of the upper-left corner of this structure. + + + The y-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the width of this structure. + + + The width of this structure. + + + + + Gets or sets the height of this structure. + + + The height of this structure. + + + + + Gets the x-coordinate of the left edge of this structure. + + + The x-coordinate of the left edge of this structure. + + + + + Gets the y-coordinate of the top edge of this structure. + + + The y-coordinate of the top edge of this structure. + + + + + Gets the x-coordinate that is the sum of and + + of this structure. + + + The x-coordinate that is the sum of and + + of this structure. + + + + + Gets the y-coordinate that is the sum of and + + of this structure. + + + The y-coordinate that is the sum of and + + of this structure. + + + + + Tests whether the or + + property of this has a value of zero. + + + This property returns true if the or + + property of this has a value of zero; otherwise, false. + + + + + Tests whether two structures have equal location and size. + + + This operator returns true if the two specified structures have equal + , , , and properties. + + + The structure that is to the left of the equality operator. + + + The structure that is to the right of the equality operator. + + + + + Tests whether two structures differ in location or size. + + + This operator returns true if any of the , + , , or + properties of the two structures are unequal; otherwise false. + + + The structure that is to the left of the inequality operator. + + + The structure that is to the right of the inequality operator. + + + + + Creates a structure with upper-left corner and lower-right corner at the specified locations. + + + The new that this method creates. + + The x-coordinate of the upper-left corner of the rectangular region. + The y-coordinate of the upper-left corner of the rectangular region. + The x-coordinate of the lower-right corner of the rectangular region. + The y-coordinate of the lower-right corner of the rectangular region. + + + + Tests whether is a with the same location and size of this + . + + + This method returns true if is a and its X, Y, Width, and Height properties are equal to the corresponding properties of this + ; otherwise, false. + + + The to test. + + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point defined by and is contained within this + + structure; otherwise false. + + The x-coordinate of the point to test. + The y-coordinate of the point to test. + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point represented by the parameter is contained within this + + structure; otherwise false. + + The to test. + + + + Determines if the rectangular region represented by is entirely contained within this + + structure. + + + This method returns true if the rectangular region represented by is entirely contained within the rectangular region represented by this + + ; otherwise false. + + + The to test. + + + + + Inflates this structure by the specified amount. + + + The amount to inflate this structure horizontally. + + + The amount to inflate this structure vertically. + + + + + Inflates this by the specified amount. + + The amount to inflate this rectangle. + + + + Creates and returns an inflated copy of the specified structure. The copy is inflated by the specified amount. The original rectangle remains unmodified. + + + The inflated . + + + The to be copied. This rectangle is not modified. + + The amount to inflate the copy of the rectangle horizontally. + The amount to inflate the copy of the rectangle vertically. + + + + Replaces this structure with the intersection of itself and the specified + + structure. + + The rectangle to intersect. + + + + Returns a structure that represents the intersection of two rectangles. If there is no intersection, and empty + + is returned. + + + A third structure the size of which represents the overlapped area of the two specified rectangles. + + A rectangle to intersect. + A rectangle to intersect. + + + + Determines if this rectangle intersects with . + + + This method returns true if there is any intersection. + + The rectangle to test. + + + + Creates the smallest possible third rectangle that can contain both of two rectangles that form a union. + + + A third structure that contains both of the two rectangles that form the union. + + A rectangle to union. + A rectangle to union. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location horizontally. + The amount to offset the location vertically. + + + + Gets the hash code for this structure. For information about the use of hash codes, see Object.GetHashCode. + + The hash code for this + + + + Converts the Location and Size of this to a human-readable string. + + + A string that contains the position, width, and height of this structure for example, "{X=20, Y=20, Width=100, Height=50}". + + + + + Stores an ordered pair of floating-point numbers, typically the width and height of a rectangle. + + + + + Gets a structure that has a + + and + + value of 0. + + + A structure that has a + + and + + value of 0. + + 1 + + + + Initializes a new instance of the structure from the specified existing + + structure. + + + The structure from which to create the new + + structure. + + + + + Initializes a new instance of the structure from the specified structure. + + The structure from which to initialize this structure. + + + + Initializes a new instance of the structure from the specified dimensions. + + + The width component of the new structure. + + + The height component of the new structure. + + + + + Gets a value that indicates whether this structure has zero width and height. + + + This property returns true when this structure has both a width and height of zero; otherwise, false. + + 1 + + + + Gets or sets the horizontal component of this structure. + + + The horizontal component of this structure, typically measured in pixels. + + 1 + + + + Gets or sets the vertical component of this structure. + + + The vertical component of this structure, typically measured in pixels. + + 1 + + + + Converts the specified structure to a + structure. + + The structure to which this operator converts. + The structure to be converted + + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + 3 + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A that is the result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + 3 + + + + Tests whether two structures are equal. + + + This operator returns true if and have equal width and height; otherwise, false. + + + The structure on the left side of the equality operator. + + + The structure on the right of the equality operator. + + 3 + + + + Tests whether two structures are different. + + + This operator returns true if and differ either in width or height; false if + + and are equal. + + + The structure on the left of the inequality operator. + + + The structure on the right of the inequality operator. + + 3 + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A structure that is a result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + + + + Tests to see whether the specified object is a structure with the same dimensions as this + + structure. + + + This method returns true if is a and has the same width and height as this + + ; otherwise, false. + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts a structure to a structure. + + + Returns a structure. + + + + + Creates a human-readable string that represents this structure. + + + A string that represents this structure. + + 1 + + + + + + + Platform adapter to bridge platform specific objects to HTML Renderer core library.
+ Core uses abstract renderer objects (RAdapter/RControl/REtc...) to access platform specific functionality, the concrete platforms + implements those objects to provide concrete platform implementation. Those allowing the core library to be platform agnostic. + + Platforms: WinForms, WPF, Metro, PDF renders, etc.
+ Objects: UI elements(Controls), Graphics(Render context), Colors, Brushes, Pens, Fonts, Images, Clipboard, etc.
+ + + + It is best to have a singleton instance of this class for concrete implementation!
+ This is because it holds caches of default CssData, Images, Fonts and Brushes. + + + + + cache of brush color to brush instance + + + + + cache of pen color to pen instance + + + + + cache of all the font used not to create same font again and again + + + + + default CSS parsed data singleton + + + + + image used to draw loading image icon + + + + + image used to draw error image icon + + + + + Init. + + + + + Get the default CSS stylesheet data. + + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Check if the given font exists in the system by font family name. + + the font name to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get image to be used while HTML image is loading. + + + + + Get image to be used if HTML image load failed. + + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard
+ Not relevant for platforms that don't render HTML on UI element. + + the text to set + + + + Set the given html and plain text data to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + + + + Set the given image to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the image object to set to clipboard + + + + Create a context menu that can be used on the control
+ Not relevant for platforms that don't render HTML on UI element. + + new context menu + + + + Save the given image to file by showing save dialog to the client.
+ Not relevant for platforms that don't render HTML on UI element. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard + + the text to set + + + + Set the given html and plain text data to clipboard. + + the html data + the plain text data + + + + Set the given image to clipboard. + + + + + + Create a context menu that can be used on the control + + new context menu + + + + Save the given image to file by showing save dialog to the client. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Adapter for platform specific brush objects - used to fill graphics (rectangles, polygons and paths).
+ The brush can be solid color, gradient or image. + + + + + + + + + + Adapter for platform specific context menu - used to create and show context menu at specific location.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The total number of items in the context menu + + + + + Add divider item to the context menu.
+ The divider is a non clickable place holder used to separate items. + + + + + Add item to the context menu with the given text that will raise the given event when clicked. + the text to set on the new context menu itemif to set the item as enabled or disabledthe event to raise when the item is clicked + + + + Remove the last item from the context menu iff it is a divider + + + + + Show the context menu in the given parent control at the given location. + the parent control to show inthe location to show at relative to the parent control + + + + + + + + + Adapter for platform specific control object - used to handle updating the control that the html is rendered on.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The platform adapter. + + + + + Init control with platform adapter. + + + + + The platform adapter. + + + + + Is the left mouse button is currently in pressed state + + + + + Is the right mouse button is currently in pressed state + + + + + Get the current location of the mouse relative to the control + + + + + Set the cursor over the control to default cursor + + + + + Set the cursor over the control to hand cursor + + + + + Set the cursor over the control to I beam cursor + + + + + Do drag-drop copy operation for the given data object. + + the drag-drop data object + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Invalidates the entire surface of the control and causes the control to be redrawn. + + + + + Adapter for platform specific font object - used to render text using specific font. + + + + + Gets the em-size of this Font measured in the units specified by the Unit property. + + + + + The line spacing, in pixels, of this font. + + + + + Get the vertical offset of the font underline location from the top of the font. + + + + + Get the left padding, in pixels, of the font. + + + + + + + + + + + + Adapter for platform specific font family object - define the available font families to use.
+ Required for custom fonts handling: fonts that are not installed on the system. + + + + + Gets the name of this Font Family. + + + + + Adapter for platform specific graphics rendering object - used to render graphics and text in platform specific context.
+ The core HTML Renderer components use this class for rendering logic, extending this + class in different platform: WinForms, WPF, Metro, PDF, etc. + + + + + the global adapter + + + + + Te clipping bound stack as clips are pushed/poped to/from the graphics + + + + + Init. + + + + + Get color pen. + + the color to get the pen for + pen instance + + + + Get solid color brush. + + the color to get the brush for + solid color brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Gets a Rectangle structure that bounds the clipping region of this Graphics. + + A rectangle structure that represents a bounding rectangle for the clipping region of this Graphics. + + + + Pop the latest clip push. + + + + + Push the clipping region of this Graphics to interception of current clipping rectangle and the given rectangle. + + Rectangle to clip to. + + + + Push the clipping region of this Graphics to exclude the given rectangle from the current clipping rectangle. + + Rectangle to exclude clipping in. + + + + Set the graphics smooth mode to use anti-alias.
+ Use to return back the mode used. + + the previous smooth mode before the change + + + + Return to previous smooth mode before anti-alias was set as returned from . + + the previous mode to set + + + + Get TextureBrush object that uses the specified image and bounding rectangle. + + The Image object with which this TextureBrush object fills interiors. + A Rectangle structure that represents the bounding rectangle for this TextureBrush object. + The dimension by which to translate the transformation + + + + Get GraphicsPath object. + + graphics path instance + + + + Measure the width and height of string when drawn on device context HDC + using the given font . + + the string to measure + the font to measure string with + the size of the string + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ Not relevant for platforms that don't render HTML on UI element. + + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Draw the given string using the given font and foreground color at given location. + + the string to draw + the font to use to draw the string + the text color to set + the location to start string draw (top-left) + used to know the size of the rendered text for transparent text support + is to render the string right-to-left (true - RTL, false - LTR) + + + + Draws a line connecting the two points specified by the coordinate pairs. + + Pen that determines the color, width, and style of the line. + The x-coordinate of the first point. + The y-coordinate of the first point. + The x-coordinate of the second point. + The y-coordinate of the second point. + + + + Draws a rectangle specified by a coordinate pair, a width, and a height. + + A Pen that determines the color, width, and style of the rectangle. + The x-coordinate of the upper-left corner of the rectangle to draw. + The y-coordinate of the upper-left corner of the rectangle to draw. + The width of the rectangle to draw. + The height of the rectangle to draw. + + + + Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height. + + Brush that determines the characteristics of the fill. + The x-coordinate of the upper-left corner of the rectangle to fill. + The y-coordinate of the upper-left corner of the rectangle to fill. + Width of the rectangle to fill. + Height of the rectangle to fill. + + + + Draws the specified portion of the specified at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. The image is scaled to fit the rectangle. + Rectangle structure that specifies the portion of the object to draw. + + + + Draws the specified Image at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. + + + + Draws a GraphicsPath. + + Pen that determines the color, width, and style of the path. + GraphicsPath to draw. + + + + Fills the interior of a GraphicsPath. + + Brush that determines the characteristics of the fill. + GraphicsPath that represents the path to fill. + + + + Fills the interior of a polygon defined by an array of points specified by Point structures. + + Brush that determines the characteristics of the fill. + Array of Point structures that represent the vertices of the polygon to fill. + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Adapter for platform specific graphics path object - used to render (draw/fill) path shape. + + + + + Start path at the given point. + + + + + Add stright line to the given point from te last point. + + + + + Add circular arc of the given size to the given point from the last point. + + + + + Release path resources. + + + + + The 4 corners that are handled in arc rendering. + + + + + + + + + + + + + + + + + + + + + + + + + Adapter for platform specific image object - used to render images. + + + + + Get the width, in pixels, of the image. + + + + + Get the height, in pixels, of the image. + + + + + + + + + + Adapter for platform specific pen objects - used to draw graphics (lines, rectangles and paths) + + + + + Gets or sets the width of this Pen, in units of the Graphics object used for drawing. + + + + + Gets or sets the style used for dashed lines drawn with this Pen. + + + + + Holds parsed stylesheet css blocks arranged by media and classes.
+ + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + used to return empty array + + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data. + + + + + Init. + + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + Platform adapter + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data + + + + + Check if there are css blocks for the given class selector. + + the class selector to check for css blocks by + optional: the css media type (default - all) + true - has css blocks for the class, false - otherwise + + + + Get collection of css blocks for the requested class selector.
+ the can be: class name, html element name, html element and + class name (elm.class), hash tag with element id (#id).
+ returned all the blocks that word on the requested class selector, it can contain simple + selector or hierarchy selector. + + the class selector to get css blocks by + optional: the css media type (default - all) + collection of css blocks, empty collection if no blocks exists (never null) + + + + Add the given css block to the css data, merging to existing block if required. + + + If there is no css blocks for the same class it will be added to data collection.
+ If there is already css blocks for the same class it will check for each existing block + if the hierarchical selectors match (or not exists). if do the two css blocks will be merged into + one where the new block properties overwrite existing if needed. if the new block doesn't mach any + existing it will be added either to the beginning of the list if it has no hierarchical selectors or at the end.
+ Css block without hierarchical selectors must be added to the beginning of the list so more specific block + can overwrite it when the style is applied. + + the media type to add the CSS to + the css block to add + + + + Combine this CSS data blocks with CSS blocks for each media.
+ Merge blocks if exists in both. + + the CSS data to combine with + + + + Create deep copy of the css data with cloned css blocks. + + cloned object + + + + CSS Specification's Default Style Sheet for HTML 4 + + + http://www.w3.org/TR/CSS21/sample.html + + + + + Border types + + + + + Represents a CSS Box of text or replaced elements. + + + The Box can contains other boxes, that's the way that the CSS Tree + is composed. + + To know more about boxes visit CSS spec: + http://www.w3.org/TR/CSS21/box.html + + + + + the parent css box of this css box in the hierarchy + + + + + the root container for the hierarchy + + + + + the html tag that is associated with this css box, null if anonymous box + + + + + the inner text of the box + + + + + Do not use or alter this flag + + + Flag that indicates that CssTable algorithm already made fixes on it. + + + + + handler for loading background image + + + + + Init. + + optional: the parent of this css box in html + optional: the html tag associated with this css box + + + + Gets the HtmlContainer of the Box. + WARNING: May be null. + + + + + Gets or sets the parent box of this box + + + + + Gets the children boxes of this box + + + + + Is the box is of "br" element. + + + + + is the box "Display" is "Inline", is this is an inline box and not block. + + + + + is the box "Display" is "Block", is this is an block box and not inline. + + + + + Is the css box clickable (by default only "a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + Gets the containing block-box of this box. (The nearest parent box with display=block) + + + + + Gets the HTMLTag that hosts this box + + + + + Gets if this box represents an image + + + + + Tells if the box is empty or contains just blank spaces + + + + + Gets or sets the inner text of the box + + + + + Gets the line-boxes of this box (if block box) + + + + + Gets the linebox(es) that contains words of this box (if inline) + + + + + Gets the rectangles where this box should be painted + + + + + Gets the BoxWords of text in the box + + + + + Gets the first word of the box + + + + + Gets or sets the first linebox where content of this box appear + + + + + Gets or sets the last linebox where content of this box appear + + + + + Create new css box for the given parent with the given html tag.
+ + the html tag to define the box + the box to add the new box to it as child + the new box + + + + Create new css box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous inline boxes visit: http://www.w3.org/TR/CSS21/visuren.html#anonymous + + the box to add the new box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new box + + + + Create new css block box. + + the new block box + + + + Create new css block box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous block boxes visit CSS spec: + http://www.w3.org/TR/CSS21/visuren.html#anonymous-block-level + + the box to add the new block box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new block box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + Device context to use + + + + Prints the fragment + + Device context to use + + + + + + Set this box in + + + + + + Move all child boxes from to this box. + + the box to move all its child boxes from + + + + Splits the text into words and saves the result + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions.
+ + Device context to use + + + + Assigns words its width and height + + + + + + Get the parent of this css properties instance. + + + + + + Gets the index of the box to be used on a (ordered) list + + + + + + Creates the + + + + + + Searches for the first word occurrence inside the box, on the specified linebox + + + + + + + + Gets the specified Attribute, returns string.Empty if no attribute specified + + Attribute to retrieve + Attribute value or string.Empty if no attribute specified + + + + Gets the value of the specified attribute of the source HTML tag. + + Attribute to retrieve + Value to return if attribute is not specified + Attribute value or defaultValue if no attribute specified + + + + Gets the minimum width that the box can be.
+ The box can be as thin as the longest word plus padding.
+ The check is deep thru box tree.
+ + the min width of the box + + + + Gets the longest word (in width) inside the box, deeply. + + + + + + + + + Get the total margin value (left and right) from the given box to the given end box.
+ + the box to start calculation from. + the total margin + + + + Gets the maximum bottom of the boxes inside the startBox + + + + + + + + Get the and width of the box content.
+ + The minimum width the content must be so it won't overflow (largest word + padding). + The total width the content can take without line wrapping (with padding). + + + + Get the and of the box words content and .
+ + the box to calculate for + the width that allows for each word to fit (width of the longest word) + the max width a single line of words can take without wrapping + the total amount of padding the content has + + + + + + Gets if this box has only inline siblings (including itself) + + + + + + Gets the rectangles where inline box will be drawn. See Remarks for more info. + + Rectangles where content should be placed + + Inline boxes can be split across different LineBoxes, that's why this method + Delivers a rectangle for each LineBox related to this box, if inline. + + + Inherits inheritable values from parent. + + + + + Gets the result of collapsing the vertical margins of the two boxes + + the previous box under the same parent + Resulting top margin + + + + Calculate the actual right of the box by the actual right of the child boxes if this box actual right is not set. + + the calculated actual right value + + + + Gets the result of collapsing the vertical margins of the two boxes + + Resulting bottom margin + + + + Deeply offsets the top of the box and its contents + + + + + + Paints the fragment + + the device to draw to + + + + Prints the fragment + + the device to draw to + + + + + + Paints the background of the box + + the device to draw into + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Paint all the words in the box. + + the device to draw into + the current scroll offset to offset the words + + + + Paints the text decoration (underline/strike-through/over-line) + + the device to draw into + + + + + + + Offsets the rectangle of the specified linebox by the specified gap, + and goes deep for rectangles of children in that linebox. + + + + + + + Resets the array + + + + + On image load process complete with image request refresh for it to be painted. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Get brush for the text depending if there is selected text color set. + + + + + Get brush for selection background depending if it has external and if alpha is required for images. + + + used for images so they will have alpha effect + + + + ToString override. + + + + + + CSS box for iframe element.
+ If the iframe is of embedded YouTube or Vimeo video it will show image with play. + + + + + the image word of this image box + + + + + is the iframe is of embeded video + + + + + the title of the video + + + + + the url of the video thumbnail image + + + + + link to the video on the site + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Is the css box clickable ("a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + is the iframe is of embeded video + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Load YouTube video data (title, image, link) by calling YouTube API. + + + + + Parse YouTube API response to get video data (title, image, link). + + + + + Load Vimeo video data (title, image, link) by calling Vimeo API. + + + + + Parse Vimeo API response to get video data (title, image, link). + + + + + Handle error occurred during video data load to handle if the video was not found. + + the exception that occurred during data load web request + the name of the video source (YouTube/Vimeo/Etc.) + + + + Create image handler for downloading video image if found and release the WebClient instance used for API call. + + + + + Paints the fragment + + the device to draw to + + + + Draw video image over the iframe if found. + + + + + Draw video title on top of the iframe if found. + + + + + Draw play over the iframe if we found link url. + + + + + Assigns words its width and height + + the device to use + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + CSS box for hr element. + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + the device to draw to + + + + CSS box for image element. + + + + + the image word of this image box + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Get the image of this image box. + + + + + Paints the fragment + + the device to draw to + + + + Assigns words its width and height + + the device to use + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Base class for css box to handle the css properties.
+ Has field and property for every css property that can be set, the properties add additional parsing like + setting the correct border depending what border value was set (single, two , all four).
+ Has additional fields to control the location and size of the box and 'actual' css values for some properties + that require additional calculations and parsing.
+ + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + the width of whitespace between words + + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + Gets the bounds of the box + + + + + Gets the width available on the box, counting padding and margin. + + + + + Gets the right of the box. When setting, it will affect only the width of the box. + + + + + Gets or sets the bottom of the box. + (When setting, alters only the Size.Height of the box) + + + + + Gets the left of the client rectangle (Where content starts rendering) + + + + + Gets the top of the client rectangle (Where content starts rendering) + + + + + Gets the right of the client rectangle + + + + + Gets the bottom of the client rectangle + + + + + Gets the client rectangle + + + + + Gets the actual height + + + + + Gets the actual height + + + + + Gets the actual top's padding + + + + + Gets the actual padding on the left + + + + + Gets the actual Padding of the bottom + + + + + Gets the actual padding on the right + + + + + Gets the actual top's Margin + + + + + The margin top value if was effected by margin collapse. + + + + + Gets the actual Margin on the left + + + + + Gets the actual Margin of the bottom + + + + + Gets the actual Margin on the right + + + + + Gets the actual top border width + + + + + Gets the actual Left border width + + + + + Gets the actual Bottom border width + + + + + Gets the actual Right border width + + + + + Gets the actual top border Color + + + + + Gets the actual Left border Color + + + + + Gets the actual Bottom border Color + + + + + Gets the actual Right border Color + + + + + Gets the actual length of the north west corner + + + + + Gets the actual length of the north east corner + + + + + Gets the actual length of the south east corner + + + + + Gets the actual length of the south west corner + + + + + Gets a value indicating if at least one of the corners of the box is rounded + + + + + Gets the actual width of whitespace between words. + + + + + + Gets the actual color for the text. + + + + + Gets the actual background color of the box + + + + + Gets the second color that creates a gradient for the background + + + + + Gets the actual angle specified for the background gradient + + + + + Gets the actual font of the parent + + + + + Gets the font that should be actually used to paint the text of the box + + + + + Gets the line height + + + + + Gets the text indentation (on first line only) + + + + + Gets the actual horizontal border spacing for tables + + + + + Gets the actual vertical border spacing for tables + + + + + Get the parent of this css properties instance. + + + + + + Gets the height of the font in the specified units + + + + + + Ensures that the specified length is converted to pixels if necessary + + + + + + Set the style/width/color for all 4 borders on the box.
+ if null is given for a value it will not be set. + + optional: the style to set + optional: the width to set + optional: the color to set + + + + Measures the width of whitespace between words (set ). + + + + + Inherits inheritable values from specified box. + + Set to true to inherit all CSS properties instead of only the ineritables + Box to inherit the properties + + + + Helps on CSS Layout. + + + + + Measure image box size by the width\height set on the box and the actual rendered image size.
+ If no image exists for the box error icon will be set. + + the image word to measure + + + + Creates line boxes for the specified blockbox + + + + + + + Applies special vertical alignment for table-cells + + + + + + + Recursively flows the content of the box using the inline model + + Device Info + Blockbox that contains the text flow + Current box to flow its content + Maximum reached right + Space to use between rows of text + x starting coordinate for when breaking lines of text + Current linebox being used + Current x coordinate that will be the left of the next word + Current y coordinate that will be the top of the next word + Maximum right reached so far + Maximum bottom reached so far + + + + Adjust the position of absolute elements by letf and top margins. + + + + + Recursively creates the rectangles of the blockBox, by bubbling from deep to outside of the boxes + in the rectangle structure + + + + + Applies vertical and horizontal alignment to words in lineboxes + + + + + + + Applies right to left direction to words + + + + + + + Applies RTL direction to all the words on the line. + + the line to apply RTL to + + + + Applies RTL direction to specific box words on the line. + + + + + + + Applies vertical alignment to the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies right alignment to the text on the linebox + + + + + + + Simplest alignment, just arrange words. + + + + + + + Layout engine for tables executing the complex layout of tables with rows/columns/headers/etc. + + + + + the main box of the table + + + + + + + + + + collection of all rows boxes + + + + + collection of all columns boxes + + + + + + + + + + Init. + + + + + + Get the table cells spacing for all the cells in the table.
+ Used to calculate the spacing the table has in addition to regular padding and borders. + + the table box to calculate the spacing for + the calculated spacing + + + + + + + + + + + Analyzes the Table and assigns values to this CssTable object. + To be called from the constructor + + + + + Get the table boxes into the proper fields. + + + + + Insert EmptyBoxes for vertical cell spanning. + + + + + Determine Row and Column Count, and ColumnWidths + + + + + + + + + + + + While table width is larger than it should, and width is reductable.
+ If table max width is limited by we need to lower the columns width even if it will result in clipping
+ + + + + Check for minimum sizes (increment widths if necessary) + + + + + Layout the cells by the calculated table layout + + + + + + Gets the spanned width of a cell (With of all columns it spans minus one). + + + + + Gets the cell column index checking its position and other cells colspans + + + + + + + + Gets the cells width, taking colspan and being in the specified column + + + + + + + + Gets the colspan of the specified box + + + + + + Gets the rowspan of the specified box + + + + + + Recursively measures words inside the box + + the box to measure + Device to use + + + + Tells if the columns widths can be reduced, + by checking the minimum widths of all cells + + + + + + Tells if the specified column can be reduced, + by checking its minimum width + + + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Calculate the min and max width for each column of the table by the content in all rows.
+ the min width possible without clipping content
+ the max width the cell content can take without wrapping
+ + if to measure only columns that have no calculated width + return the min width for each column - the min width possible without clipping content + return the max width for each column - the max width the cell content can take without wrapping + + + + Gets the width available for cells + + + + It takes away the cell-spacing from + + + + + Gets the current sum of column widths + + + + + + Gets the span attribute of the tag of the specified box + + + + + + Gets the minimum width of each column + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual vertical spacing of the table + + + + + Represents and gets info about a CSS Length + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + Creates a new CssLength from a length specified on a CSS style sheet or fragment + + Length as specified in the Style Sheet or style fragment + + + + Gets the number in the length + + + + + Gets if the length has some parsing error + + + + + Gets if the length represents a precentage (not actually a length) + + + + + Gets if the length is specified in relative units + + + + + Gets the unit of the length + + + + + Gets the length as specified in the string + + + + + If length is in Ems, returns its value in points + + Em size factor to multiply + Points size of this em + If length has an error or isn't in ems + + + + If length is in Ems, returns its value in pixels + + Pixel size factor to multiply + Pixels size of this em + If length has an error or isn't in ems + + + + Returns the length formatted ready for CSS interpreting. + + + + + + Represents a line of text. + + + To learn more about line-boxes see CSS spec: + http://www.w3.org/TR/CSS21/visuren.html + + + + + Creates a new LineBox + + + + + Gets a list of boxes related with the linebox. + To know the words of the box inside this linebox, use the method. + + + + + Gets the words inside the linebox + + + + + Gets the owner box + + + + + Gets a List of rectangles that are to be painted on this linebox + + + + + Get the height of this box line (the max height of all the words) + + + + + Get the bottom of this box line (the max bottom of all the words) + + + + + Lets the linebox add the word an its box to their lists if necessary. + + + + + + Return the words of the specified box that live in this linebox + + + + + + + Updates the specified rectangle of the specified box. + + + + + + + + + + Copies the rectangles to their specified box + + + + + Sets the baseline of the words of the specified box to certain height + + Device info + box to check words + baseline + + + + Check if the given word is the last selected word in the line.
+ It can either be the last word in the line or the next word has no selection. + + the word to check + + + + + Returns the words of the linebox + + + + + + Represents a word inside an inline box + + + Because of performance, words of text are the most atomic + element in the project. It should be characters, but come on, + imagine the performance when drawing char by char on the device.
+ It may change for future versions of the library. + + + + + the CSS box owner of the word + + + + + Rectangle + + + + + If the word is selected this points to the selection handler for more data + + + + + Init. + + the CSS box owner of the word + + + + Gets the Box where this word belongs. + + + + + Gets or sets the bounds of the rectangle + + + + + Left of the rectangle + + + + + Top of the rectangle + + + + + Width of the rectangle + + + + + Get the full width of the word including the spacing. + + + + + Gets the actual width of whitespace between words. + + + + + Height of the rectangle + + + + + Gets or sets the right of the rectangle. When setting, it only affects the Width of the rectangle. + + + + + Gets or sets the bottom of the rectangle. When setting, it only affects the Height of the rectangle. + + + + + If the word is selected this points to the selection handler for more data + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + is the word is currently selected + + + + + the selection start index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the word is partially selected (-1 if not selected or fully selected) + + + + + Gets or sets an offset to be considered in measurements + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + the image object if it is image word (can be null if not loaded) + + + + + the image rectangle restriction as returned from image load event + + + + + Creates a new BoxWord which represents an image + + the CSS box owner of the word + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + the image rectange restriction as returned from image load event + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + The word text + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Init. + + the CSS box owner of the word + the word chars + was there a whitespace before the word chars (before trim) + was there a whitespace after the word chars (before trim) + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + Represents this word for debugging purposes + + + + + + Used to make space on vertical cell combination + + + + + the index of the row where box starts + + + + + the index of the row where box ends + + + + + Gets the index of the row where box starts + + + + + Gets the index of the row where box ends + + + + + Represents the possible units of the CSS lengths + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + CSS boxes that have ":hover" selector on them. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + Init. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + the name of the html tag + + + + + if the tag is single placed; in other words it doesn't have a separate closing tag; + + + + + collection of attributes and their value the html tag has + + + + + Init. + + the name of the html tag + if the tag is single placed; in other words it doesn't have a separate closing tag; + collection of attributes and their value the html tag has + + + + Gets the name of this tag + + + + + Gets collection of attributes and their value the html tag has + + + + + Gets if the tag is single placed; in other words it doesn't have a separate closing tag;
+ e.g. <br> + + + + + is the html tag has attributes. + + true - has attributes, false - otherwise + + + + Gets a boolean indicating if the attribute list has the specified attribute + + attribute name to check if exists + true - attribute exists, false - otherwise + + + + Get attribute value for given attribute name or null if not exists. + + attribute name to get by + optional: value to return if attribute is not specified + attribute value or null if not found + + + + Represents a block of CSS property values.
+ Contains collection of key-value pairs that are CSS properties for specific css class.
+ Css class can be either custom or html tag name. + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + the name of the css class of the block + + + + + the CSS block properties and values + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + is the css block has :hover pseudo-class + + + + + Creates a new block from the block's source + + the name of the css class of the block + the CSS block properties and values + optional: additional selectors to used in hierarchy + optional: is the css block has :hover pseudo-class + + + + the name of the css class of the block + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + Gets the CSS block properties and its values + + + + + is the css block has :hover pseudo-class + + + + + Merge the other block properties into this css block.
+ Other block properties can overwrite this block properties. + + the css block to merge with + + + + Create deep copy of the CssBlock. + + new CssBlock with same data + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Check if the selectors of the css blocks is the same. + + the other block to compare to + true - the selectors on blocks are the same, false - otherwise + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Serves as a hash function for a particular type. + + A hash code for the current . + + + + Returns a that represents the current . + + + + + Holds single class selector in css block hierarchical selection (p class1 > div.class2) + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Creates a new block from the block's source + + the name of the css class of the block + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Returns a that represents the current . + + + + + Controls the way styles are generated when html is generated. + + + + + styles are not generated at all + + + + + style are inserted in style attribute for each html tag + + + + + style section is generated in the head of the html + + + + + Callback used in to allow setting image externally and async.
+ The callback can provide path to image file path, URL or the actual image to use.
+ If is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + the image to use + optional: limit to specific rectangle in the loaded image + + + + Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and + provide file path to load the image from. Can also use the asynchronous image overwrite not to block HTML rendering is applicable.
+ If no alternative data is provided the original source will be used.
+ + + + + use to cancel the image loading by html renderer, the provided image will be used. + + + + + the source of the image (file path or uri) + + + + + collection of all the attributes that are defined on the image element + + + + + Callback used to allow setting image externally and async. + + + + + Init. + + the source of the image (file path or Uri) + collection of all the attributes that are defined on the image element + Callback used to allow setting image externally and async. + + + + the source of the image (file path, URL or inline data) + + + + + collection of all the attributes that are defined on the image element or CSS style + + + + + Indicate the image load is handled asynchronously. + Cancel this image loading and overwrite the image asynchronously using callback method.
+ + + + + Callback to overwrite the loaded image with error image.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + the path to the image to load (file path or URL) + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + + + + + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ If imageRectangle is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + + + + + Raised when the user clicks on a link in the html. + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + Init. + + the link href that was clicked + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + + + + + + + Exception thrown when client code subscribed to LinkClicked event thrown exception. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a specified error message. + + The message that describes the error. + + + + Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ It can happen if some async event has occurred that requires re-paint and re-layout of the html.
+ Example: async download of image is complete. + + + + + is re-layout is required for the refresh + + + + + Init. + + is re-layout is required for the refresh + + + + is re-layout is required for the refresh + + + + + + + + + + + Raised when an error occurred during html rendering. + + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + Init. + + the type of error to report + the error message + optional: the exception that occurred + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + + + + + + + Enum of possible error types that can be reported. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + the location to scroll to + + + + + Init. + + the location to scroll to + + + + the x location to scroll to + + + + + the x location to scroll to + + + + + + + + + + + Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Init. + + the source of the image (file path or URL) + collection of all the attributes that are defined on the image element + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Holds data on link element in HTML.
+ Used to expose data outside of HTML Renderer internal structure. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Init. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Is the link is directed to another element in the html + + + + + Return the id of the element this anchor link is referencing. + + + + + + + + + + + Contains all the paint code to paint different background images. + + + + + Draw the background image of the given box in the given rectangle.
+ Handle background-repeat and background-position values. + + the device to draw into + the box to draw its background image + the handler that loads image to draw + the rectangle to draw image in + + + + Get top-left location to start drawing the image at depending on background-position value. + + the background-position value + the rectangle to position image in + the size of the image + the top-left location + + + + Draw the background image at the required location repeating it over the X axis.
+ Adjust location to left if starting location doesn't include all the range (adjusted to center or right). + + + + + Draw the background image at the required location repeating it over the Y axis.
+ Adjust location to top if starting location doesn't include all the range (adjusted to center or bottom). + + + + + Draw the background image at the required location repeating it over the X and Y axis.
+ Adjust location to left-top if starting location doesn't include all the range (adjusted to center or bottom/right). + + + + + Contains all the complex paint code to paint different style borders. + + + + + used for all border paint to use the same points and not create new array each time. + + + + + Draws all the border of the box with respect to style, width, etc. + + the device to draw into + the box to draw borders for + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Draw simple border. + + Desired border + the device to draw to + Box which the border corresponds + the brush to use + the bounding rectangle to draw in + Beveled border path, null if there is no rounded corners + + + + Draw specific border (top/bottom/left/right) with the box data (style/width/rounded).
+ + desired border to draw + the box to draw its borders, contain the borders data + the device to draw into + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + + + + Set rectangle for inset/outset border as it need diagonal connection to other borders. + + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + Beveled border path, null if there is no rounded corners + + + + Makes a border path for rounded borders.
+ To support rounded dotted/dashed borders we need to use arc in the border path.
+ Return null if the border is not rounded.
+ + the device to draw into + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Beveled border path, null if there is no rounded corners + + + + Get pen to be used for border draw respecting its style. + + + + + Get the border color for the given box border. + + + + + Get the border width for the given box border. + + + + + Get the border style for the given box border. + + + + + Makes the specified color darker for inset/outset borders. + + + + + Handle context menu. + + + + + select all text + + + + + copy selected text + + + + + copy the link source + + + + + open link (as left mouse click) + + + + + copy the source of the image + + + + + copy image to clipboard + + + + + save image to disk + + + + + open video in browser + + + + + copy video url to browser + + + + + the selection handler linked to the context menu handler + + + + + the html container the handler is on + + + + + the last context menu shown + + + + + the control that the context menu was shown on + + + + + the css rectangle that context menu shown on + + + + + the css link box that context menu shown on + + + + + Init context menu items strings. + + + + + Init. + + the selection handler linked to the context menu handler + the html container the handler is on + + + + Show context menu clicked on given rectangle. + + the parent control to show the context menu on + the rectangle that was clicked to show context menu + the link that was clicked to show context menu on + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Dispose of the last used context menu. + + + + + Handle link click. + + + + + Copy the href of a link to clipboard. + + + + + Open save as dialog to save the image + + + + + Copy the image source to clipboard. + + + + + Copy image object to clipboard. + + + + + Copy selected text. + + + + + Select all text. + + + + + Utilities for fonts and fonts families handling. + + + + + + + + + + Allow to map not installed fonts to different + + + + + collection of all installed and added font families to check if font exists + + + + + cache of all the font used not to create same font again and again + + + + + Init. + + + + + Check if the given font family exists by name + + the font to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get cached font instance for the given font properties.
+ Improve performance not to create same font multiple times. + + cached font instance + + + + Get cached font if it exists in cache or null if it is not. + + + + + create font (try using existing font family to support custom fonts) + + + + + Handler for all loading image logic.
+

+ Loading by .
+ Loading by file path.
+ Loading by URI.
+

+ + + + Supports sync and async image loading. + + + If the image object is created by the handler on calling dispose of the handler the image will be released, this + makes release of unused images faster as they can be large.
+ Disposing image load handler will also cancel download of image from the web. + + + + + + the container of the html to handle load image for + + + + + callback raised when image load process is complete with image or without + + + + + the web client used to download image from URL (to cancel on dispose) + + + + + Must be open as long as the image is in use + + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + to know if image load event callback was sync or async raised + + + + + flag to indicate if to release the image object on box dispose (only if image was loaded by the box) + + + + + is the handler has been disposed + + + + + Init. + + the container of the html to handle load image for + callback raised when image load process is complete with image or without + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + Set image of this image box by analyzing the src attribute.
+ Load the image from inline base64 encoded string.
+ Or from calling property/method on the bridge object that returns image or URL to image.
+ Or from file path
+ Or from URI. + + + File path and URI image loading is executed async and after finishing calling + on the main thread and not thread-pool. + + the source of the image to load + the collection of attributes on the element to use in event + the image object (null if failed) + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set the image using callback from load image event, use the given data. + + the path to the image to load (file path or uri) + the image to load + optional: limit to specific rectangle of the image and not all of it + + + + Load the image from inline base64 encoded string data. + + the source that has the base64 encoded image + + + + Extract image object from inline base64 encoded data in the src of the html img element. + + the source that has the base64 encoded image + image from base64 data string or null if failed + + + + Load image from path of image file or URL. + + the file path or uri to load image from + + + + Load the image file on thread-pool thread and calling after. + + the file path to get the image from + + + + Load the image file on thread-pool thread and calling after.
+ Calling on the main thread and not thread-pool. + + the file path to get the image from + + + + Load image from the given URI by downloading it.
+ Create local file name in temp folder from the URI, if the file already exists use it as it has already been downloaded. + If not download the file using . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + key value pair of URL and file info to download the file to + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + Flag image load complete and request refresh for re-layout and invalidate. + + + + + Release the image and client objects. + + + + + Handler for text selection in the html. + + + + + the root of the handled html tree + + + + + handler for showing context menu on right click + + + + + the mouse location when selection started used to ignore small selections + + + + + the starting word of html selection
+ where the user started the selection, if the selection is backwards then it will be the last selected word. + + + + + the ending word of html selection
+ where the user ended the selection, if the selection is backwards then it will be the first selected word. + + + + + the selection start index if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + is the selection goes backward in the html, the starting word comes after the ending word in DFS traversing.
+ + + + + used to ignore mouse up after selection + + + + + current selection process is after double click (full word selection) + + + + + used to know if selection is in the control or started outside so it needs to be ignored + + + + + used to handle drag and drop + + + + + is the cursor on the control has been changed by the selection handler + + + + + used to know if double click selection is requested + + + + + used to know if drag and drop was already started not to execute the same operation over + + + + + Init. + + the root of the handled html tree + + + + Select all the words in the html. + + the control hosting the html to invalidate + + + + Select the word at the given location if found. + + the control hosting the html to invalidate + the location to select word at + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse on the html + + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + is the left mouse button has been released + is the mouse up should be ignored + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse on the html + + + + On mouse leave change the cursor back to default. + + the control hosting the html to set cursor and invalidate + + + + Copy the currently selected html segment to clipboard.
+ Copy rich html text and plain text. + + + + + Get the currently selected text segment in the html.
+ + + + + Copy the currently selected html segment with style.
+ + + + + The selection start index if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start index for + data value or -1 if not applicable + + + + The selection end index if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end index for + + + + The selection start offset if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start offset for + + + + The selection end offset if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end offset for + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Handle html text selection by mouse move over the html with left mouse button pressed.
+ Calculate the words in the selected range and set their selected property. + + the control hosting the html to invalidate + the mouse location + true - partial word selection allowed, false - only full words selection + + + + Clear the current selection. + + + + + Clear the selection from all the words in the css box recursively. + + the css box to selectionStart clear at + + + + Start drag and drop operation on the currently selected html segment. + + the control to start the drag and drop on + + + + Select all the words that are under DOM hierarchy.
+ + the box to start select all at + + + + Check if the current selection is non empty, has some selection data. + + + true - partial word selection allowed, false - only full words selection + true - is non empty selection, false - empty selection + + + + Select all the words that are between word and word in the DOM hierarchy.
+ + the root of the DOM sub-tree the selection is in + selection start word limit + selection end word limit + + + + Select all the words that are between word and word in the DOM hierarchy. + + the current traversal node + selection start word limit + selection end word limit + used to know the traversal is currently in selected range + + + + + Calculate the character index and offset by characters for the given word and given offset.
+ . + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + to set the starting or ending char and offset data + + + + Calculate the character index and offset by characters for the given word and given offset.
+ If the location is below the word line then set the selection to the end.
+ If the location is to the right of the word then set the selection to the end.
+ If the offset is to the left of the word set the selection to the beginning.
+ Otherwise calculate the width of each substring to find the char the location is on. + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + is to include the first character in the calculation + return the index of the char under the location + return the offset of the char under the location + + + + Check if the selection direction is forward or backward.
+ Is the selection start word is before the selection end word in DFS traversal. + + + + + Handler for loading a stylesheet data. + + + + + Load stylesheet data from the given source.
+ The source can be local file or web URI.
+ First raise event to allow the client to overwrite the stylesheet loading.
+ If the stylesheet is downloaded from URI we will try to correct local URIs to absolute.
+ + the container of the html to handle load stylesheet for + the source of the element to load the stylesheet by + the attributes of the link element + return the stylesheet string that has been loaded (null if failed or is given) + return stylesheet data object that was provided by overwrite (null if failed or is given) + + + + Load stylesheet string from given source (file path or uri). + + the container of the html to handle load stylesheet for + the file path or uri to load the stylesheet from + the stylesheet string + + + + Load the stylesheet from local file by given path. + + the container of the html to handle load stylesheet for + the stylesheet file to load + the loaded stylesheet string + + + + Load the stylesheet from uri by downloading the string. + + the container of the html to handle load stylesheet for + the uri to download from + the loaded stylesheet string + + + + Make relative URLs absolute in the stylesheet using the URI of the stylesheet. + + the stylesheet to correct + the stylesheet uri to use to create absolute URLs + Corrected stylesheet + + + + Low level handling of Html Renderer logic.
+ Allows html layout and rendering without association to actual control, those allowing to handle html rendering on any graphics object.
+ Using this class will require the client to handle all propagation's of mouse/keyboard events, layout/paint calls, scrolling offset, + location/size/rectangle handling and UI refresh requests.
+ + + + MaxSize and ActualSize:
+ The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can exceed the max size by layout restrictions (unwrap-able line, set image size, etc.).
+ Set zero for unlimited (width/height separately).
+ + + ScrollOffset:
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ Element that is rendered at location (50,100) with offset of (0,200) will not be rendered + at -100, therefore outside the client rectangle. + + + LinkClicked event
+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link to overwrite by custom logic.
+ If error occurred in event handler it will propagate up the stack. + + + StylesheetLoad event:
+ Raised when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + ImageLoad event:
+ Raised when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ + + Refresh event:
+ Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + RenderError event:
+ Raised when an error occurred during html rendering.
+ + + + + + + + + + + + + + + + parser for CSS data + + + + + the root css box of the parsed html + + + + + list of all css boxes that have ":hover" selector on them + + + + + Handler for text selection in the html. + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + the parsed stylesheet data used for handling the html + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled (default - true) + + + + + Gets or sets a value indicating if anti-aliasing should be avoided + for geometry like backgrounds and borders + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ + + + + the top-left most location of the rendered html + + + + + the max width and height of the rendered html, effects layout, actual size cannot exceed this values.
+ Set zero for unlimited.
+ + + + + Gets or sets the scroll offset of the document for scroll controls + + + + + The actual size of the rendered html (after layout) + + + + + Init. + + + + + + + + + + parser for CSS data + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrapable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + the root css box of the parsed html + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + + + + + + + Clear the content of the HTML container releasing any resources used to render previously existing content. + + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given device. + + the device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the location of the mouse + the mouse event data + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + Raise the stylesheet load event with the given event args. + + the event args + + + + Raise the image load event with the given event args. + + the event args + + + + Request invalidation and re-layout of the control hosting the renderer. + + is re-layout is required for the refresh + + + + Report error in html render process. + + the type of error to report + the error message + optional: the exception that occured + + + + Handle link clicked going over event and using if not canceled. + + the control hosting the html to invalidate + the location of the mouse + the link that was clicked + + + + Add css box that has ":hover" selector to be handled on mouse hover. + + the box that has the hover selector + the css block with the css data with the selector + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Adjust the offset of the given location by the current scroll offset. + + the location to adjust + the adjusted location + + + + Check if the mouse is currently on the html container.
+ Relevant if the html container is not filled in the hosted control (location is not zero and the size is not the full size of the control). + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + General utilities. + + + + + Measure the size of the html by performing layout under the given restrictions. + + the graphics to use + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Perform the layout of the html container by given size restrictions returning the final size.
+ The layout can be effected by the HTML content in the if or + is set to true.
+ Handle minimum and maximum size restrictions.
+ Handle auto size and auto size for height only. if is true + is ignored.
+ + the graphics used for layout + the html container to layout + the current size + the min size restriction - can be empty for no restriction + the max size restriction - can be empty for no restriction + if to modify the size (width and height) by html content layout + if to modify the height by html content layout + + + + Parser to parse CSS stylesheet source string into CSS objects. + + + + + split CSS rule + + + + + + + + + + Utility for value parsing. + + + + + The chars to trim the css class name by + + + + + Init. + + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + raw css stylesheet to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the CSS data with parsed CSS objects (never null) + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ The parsed css blocks are added to the given css data, merged if class name already exists. + + the CSS data to fill with parsed CSS objects + raw css stylesheet to parse + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the font-family value to parse + parsed font-family value + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + color value + + + + Remove comments from the given stylesheet. + + the stylesheet to remove comments from + stylesheet without comments + + + + Parse given stylesheet for CSS blocks
+ This blocks are added under the "all" keyword. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Parse given stylesheet for media CSS blocks
+ This blocks are added under the specific media block they are found. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Feeds the style with a block about the specific media.
+ When no media is specified, "all" will be used. + + + the CSS block to handle + optional: the media (default - all) + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse css block selector to support hierarchical selector (p class1 > class2). + + the class selector to parse + return the main class the css block is on + returns the hierarchy of classes or null if single class selector + + + + Parse the properties of the given css block into a key-value dictionary. + + the raw css block to parse + dictionary with parsed css block properties + + + + Add the given property to the given properties collection, if the property is complex containing + multiple css properties then parse them and add the inner properties. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse length property to add only valid lengths. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse color property to add only valid color. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse a complex font property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + + + the value of the property to parse + parsed value + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the value of the property to parse + parsed font-family value + + + + Parse a complex border property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the left, top, right or bottom direction of the border to parse + the properties collection to add the specific properties to + + + + Parse a complex margin property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border style property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border width property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border color property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex padding property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Split multi direction value into the proper direction values (left, top, right, bottom). + + + + + Split the value by the specified separator; e.g. Useful in values like 'padding:5 4 3 inherit' + + Value to be splitted + + Splitted and trimmed values + + + + + + + + + + + + + Parse the given substring to extract border width substring. + Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse CSS properties values like numbers, Urls, etc. + + + + + + + + + + Init. + + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid double number, false - otherwise + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid int number, false - otherwise + + + + Check if the given string is a valid length value. + + the string value to check + true - valid, false - invalid + + + + Evals a number and returns it. If number is a percentage, it will be multiplied by hundredPercent + + Number to be parsed + Number that represents the 100% if parsed number is a percentage + Parsed number. Zero if error while parsing. + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + if the length is in pixels and the length is font related it needs to use 72/96 factor + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + if the length is in pixels and the length is font related it needs to use 72/96 factor + Allows the return double to be in points. If false, result will be pixels + the parsed length value with adjustments + + + + Get the unit to use for the length, use default if no unit found in length string. + + + + + Check if the given color string value is valid. + + color string value to parse + true - valid, false - invalid + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + Color value + + + + Parses a color value in CSS style; e.g. #ff0000, RED, RGB(255,0,0), RGB(100%, 0, 0) + + color substring value to parse + substring start idx + substring length + return the parsed color + true - valid color, false - otherwise + + + + Parses a border value in CSS style; e.g. 1px, 1, thin, thick, medium + + + + + + + + Get color by parsing given hex value color string (#A28B34). + + true - valid color, false - otherwise + + + + Get color by parsing given RGB value color string (RGB(255,180,90)) + + true - valid color, false - otherwise + + + + Get color by parsing given RGBA value color string (RGBA(255,180,90,180)) + + true - valid color, false - otherwise + + + + Get color by given name, including .NET name. + + true - valid color, false - otherwise + + + + Parse the given decimal number string to positive int value.
+ Start at given , ignore whitespaces and take + as many digits as possible to parse to int. + + the string to parse + the index to start parsing at + parsed int or 0 + + + + Parse the given decimal number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Parse the given hex number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Handle css DOM tree generation from raw html and stylesheet. + + + + + Parser for CSS + + + + + Init. + + + + + Generate css tree by parsing the given html and applying the given css style data on it. + + the html to parse + the html container to use for reference resolve + the css data to use + the root of the generated tree + + + + Read styles defined inside the dom structure in links and style elements.
+ If the html tag is "style" tag parse it content and add to the css data for all future tags parsing.
+ If the html tag is "link" that point to style data parse it content and add to the css data for all future tags parsing.
+ + the box to parse style data in + the html container to use for reference resolve + the style data to fill with found styles + check if the css data has been modified by the handled html not to change the base css data + + + + Applies style to all boxes in the tree.
+ If the html tag has style defined for each apply that style to the css box of the tag.
+ If the html tag has "class" attribute and the class name has style defined apply that style on the tag css box.
+ If the html tag has "style" attribute parse it and apply the parsed style on the tag css box.
+ + the box to apply the style to + the style data for the html + + + + Set the selected text style (selection text color and background color). + + + the style data + + + + Assigns the given css classes to the given css box checking if matching.
+ Support multiple classes in single attribute separated by whitespace. + + the css box to assign css to + the css data to use to get the matching css blocks + + + + Assigns the given css style blocks to the given css box checking if matching. + + the css box to assign css to + the css data to use to get the matching css blocks + the class selector to search for css blocks + + + + Check if the given css block is assignable to the given css box.
+ the block is assignable if it has no hierarchical selectors or if the hierarchy matches.
+ Special handling for ":hover" pseudo-class.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Check if the given css block is assignable to the given css box by validating the selector.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Assigns the given css style block properties to the given css box. + + the css box to assign css to + the css block to assign + + + + Check if the given style is allowed to be set on the given css box.
+ Used to prevent invalid CssBoxes creation like table with inline display style. + + the css box to assign css to + the style key to cehck + the style value to check + true - style allowed, false - not allowed + + + + Clone css data if it has not already been cloned.
+ Used to preserve the base css data used when changed by style inside html. + + + + + + + + + + + + Converts an HTML length into a Css length + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Execute action on all the "td" cells of the table.
+ Handle if there is "theader" or "tbody" exists. + + the table element + the action to execute + + + + Go over all the text boxes (boxes that have some text that will be rendered) and + remove all boxes that have only white-spaces but are not 'preformatted' so they do not effect + the rendered html. + + the current box to correct its sub-tree + + + + Go over all image boxes and if its display style is set to block, put it inside another block but set the image to inline. + + the current box to correct its sub-tree + + + + Correct the DOM tree recursively by replacing "br" html boxes with anonymous blocks that respect br spec.
+ If the "br" tag is after inline box then the anon block will have zero height only acting as newline, + but if it is after block box then it will have min-height of the font size so it will create empty line. + + the current box to correct its sub-tree + used to know if the br is following a box so it should create an empty line or not so it only + move to a new line + + + + Correct DOM tree if there is block boxes that are inside inline blocks.
+ Need to rearrange the tree so block box will be only the child of other block box. + + the current box to correct its sub-tree + + + + Rearrange the DOM of the box to have block box with boxes before the inner block box and after. + + the box that has the problem + + + + Split bad box that has inline and block boxes into two parts, the left - before the block box + and right - after the block box. + + the parent box that has the problem + the box to split into different boxes + the left block box that is created for the split + + + + Makes block boxes be among only block boxes and all inline boxes have block parent box.
+ Inline boxes should live in a pool of Inline boxes only so they will define a single block.
+ At the end of this process a block box will have only block siblings and inline box will have + only inline siblings. + + the current box to correct its sub-tree + + + + Check if the given box contains only inline child boxes in all subtree. + + the box to check + true - only inline child boxes, false - otherwise + + + + Check if the given box contains inline and block child boxes. + + the box to check + true - has variant child boxes, false - otherwise + + + + + + + + + Parses the source html to css boxes tree structure. + + the html source to parse + + + + Add html text anon box to the current box, this box will have the rendered text
+ Adding box also for text that contains only whitespaces because we don't know yet if + the box is preformatted. At later stage they will be removed if not relevant. + + the html source to parse + the start of the html part + the index of the next html tag + the current box in html tree parsing + + + + Parse the html part, the part from prev parsing index to the beginning of the next html tag.
+ + the html source to parse + the index of the next html tag + the current box in html tree parsing + the end of the parsed part, the new start index + + + + Parse raw html tag source to object.
+ Extract attributes found on the tag. + + the html source to parse + the start index of the tag in the source + the length of the tag from the start index in the source + return the name of the html tag + return the dictionary of tag attributes + true - the tag is closing tag, false - otherwise + + + + Extract html tag attributes from the given sub-string. + + the html source to parse + the start index of the tag attributes in the source + the length of the tag attributes from the start index in the source + return the dictionary of tag attributes + + + + Collection of regular expressions used when parsing + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + Static class that contains argument-checking methods + + + + + Validate given condition is true, otherwise throw exception. + + Exception type to throw. + Condition to assert. + Exception message in-case of assert failure. + + + + Validate given argument isn't Null. + + argument to validate + Name of the argument checked + if is Null + + + + Validate given argument isn't . + + argument to validate + Name of the argument checked + if is + + + + Validate given argument isn't Null or empty. + + argument to validate + Name of the argument checked + if is Null or empty + + + + Validate given argument isn't Null. + + Type expected of arg + argument to validate + Name of the argument checked + if is Null + arg cast as T + + + + Validate given argument isn't Null or empty AND argument value is the path of existing file. + + argument to validate + Name of the argument checked + if is Null or empty + if arg file-path not exist + + + + Utility methods for general stuff. + + + + + Table to convert numbers into roman digits + + + + + Check if the given char is of Asian range. + + the character to check + true - Asian char, false - otherwise + + + + Check if the given char is a digit character (0-9) and (0-9, a-f for HEX) + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Convert the given char to digit. + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Get size that is max of and for width and height separately. + + + + + Get Uri object for the given path if it is valid uri path. + + the path to get uri for + uri or null if not valid + + + + Get the first value in the given dictionary. + + the type of dictionary key + the type of dictionary value + the dictionary + optional: the default value to return of no elements found in dictionary + first element or default value + + + + Get file info object for the given path if it is valid file path. + + the path to get file info for + file info or null if not valid + + + + Get web client response content type. + + the web client to get the response content type from + response content type or null + + + + Gets the representation of the online uri on the local disk. + + The online image uri. + The path of the file on the disk. + + + + Get substring seperated by whitespace starting from the given idex. + + the string to get substring in + the index to start substring search from + return the length of the found string + the index of the substring, -1 if no valid sub-string found + + + + Compare that the substring of is equal to + Assume given substring is not empty and all indexes are valid!
+ + true - equals, false - not equals + + + + Replaces invalid filename chars to '_' + + The possibly-not-valid filename + A valid filename. + + + + Convert number to alpha numeric system by the requested style (UpperAlpha, LowerRoman, Hebrew, etc.). + + the number to convert + the css style to convert by + converted string + + + + Convert the given integer into alphabetic numeric format (D, AU, etc.) + + the number to convert + is to use lowercase + the roman number string + + + + Convert the given integer into alphabetic numeric format (alpha, AU, etc.) + + the number to convert + the roman number string + + + + Convert the given integer into roman numeric format (II, VI, IX, etc.) + + the number to convert + if to use lowercase letters for roman digits + the roman number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + String constants to avoid typing errors. + + + + + Centimeters + + + + + Millimeters + + + + + Pixels + + + + + Inches + + + + + Em - The font size of the relevant font + + + + + The 'x-height' of the relevan font + + + + + Points + + + + + Picas + + + + + Default font size in points. Change this value to modify the default font size. + + + + + Default font used for the generic 'serif' family + + + + + Utility method for handling CSS stuff. + + + + + Brush for selection background + + + + + Brush for selection background + + + + + Gets the white space width of the specified box + + + + + + + + Get CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to get it's property value + the name of the CSS property + the value of the property, null if no such property exists + + + + Set CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to set it's property value + the name of the CSS property + the value to set + + + + Utility class for traversing DOM structure and execution stuff on it. + + + + + Check if the given location is inside the given box deep.
+ Check inner boxes and all lines that the given box spans to. + + the box to check + the location to check + true - location inside the box, false - otherwise + + + + Check if the given box contains only inline child boxes. + + the box to check + true - only inline child boxes, false - otherwise + + + + Recursively searches for the parent with the specified HTML Tag name + + + + + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + fix word space for first word in inline tag. + + the box to check + + + + Gets the next sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Get attribute value by given key starting search from given box, search up the tree until + attribute found or root. + + the box to start lookup at + the attribute to get + the value of the attribute or null if not found + + + + Get css box under the given sub-tree at the given x,y location, get the inner most.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + Optional: if to get only visible boxes (default - true) + css link box if exists or null + + + + Collect all link boxes found in the HTML tree. + + the box to start search from + collection to add all link boxes to + + + + Get css link box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + css link box if exists or null + + + + Get css box under the given sub-tree with the given id.
+ + the box to start search from + the id to find the box by + css box if exists or null + + + + Get css line box under the given sub-tree at the given y location or the nearest line from the top.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the line box to search in + the location to find the box at + css word box if exists or null + + + + Find the css line box that the given word is in. + + the word to search for it's line box + line box that the word is in + + + + Get selected plain text of the given html sub-tree. + + the DOM box to get selected text from its sub-tree + the selected plain text string + + + + Generate html from the given DOM tree.
+ Generate all the style inside the html, in header or for every tag depending on value. + + the box of the html generate html from + Optional: controls the way styles are generated when html is generated + Optional: true - generate only selected html subset, false - generate all (default - false) + generated html + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the root to generate tree from + generated tree + + + + Get selected plain text of the given html sub-tree.
+ Append all the selected words. + + the builder to append the selected text to + the DOM box to get selected text from its sub-tree + the index of the last word appended + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ + the box to check its sub-tree + the collection to add the selected tags to + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ Use to handle boxes that are between selected words but don't have selected word inside.
+ + the box to check its sub-tree + the hash to add the selected boxes to + used to handle boxes that are between selected words but don't have selected word inside + is the current box is in selected sub-tree + + + + find the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + the root of the boxes tree + the selected boxes to find selection root in + the box that is the root of selected boxes + + + + Check if the given box has a names child box (has html tag) recursively. + + the box to check + true - in sub-tree there is a named box, false - otherwise + + + + Write the given html DOM sub-tree into the given string builder.
+ If are given write html only from those tags. + + used to parse CSS data + the string builder to write html into + the html sub-tree to write + Controls the way styles are generated when html is generated + Control if to generate only selected boxes, if given only boxes found in hash will be generated + the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + + + Write the given html tag with all its attributes and styles. + + used to parse CSS data + the string builder to write html into + the css box with the html tag to write + Controls the way styles are generated when html is generated + + + + Clean the given style collection by removing default styles so only custom styles remain.
+ Return new collection where the old remains unchanged. + + the box the styles apply to, used to know the default style + the collection of styles to clean + new cleaned styles collection + + + + Write stylesheet data inline into the html. + + the string builder to write stylesheet into + the css data to write to the head + + + + Get the selected word with respect to partial selected words. + + the word to append + is to get selected text or all the text in the word + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the box to generate for + the string builder to generate to + the current indent level to set indent of generated text + + + + Defines HTML strings + + + + + List of html tags that don't have content + + + + + the html encode\decode pairs + + + + + the html decode only pairs + + + + + Init. + + + + + Is the given html tag is single tag or can have content. + + the tag to check (must be lower case) + true - is single tag, false - otherwise + + + + Decode html encoded string to regular string.
+ Handles <, >, "&. + + the string to decode + decoded string + + + + Encode regular string into html encoded string.
+ Handles <, >, "&. + + the string to encode + encoded string + + + + Decode html special charecters encoded using char entity code (€) + + the string to decode + decoded string + + + + Decode html special charecters encoded using char entity name + + the string to decode + decoded string + + + + Provides some drawing functionality + + + + + Check if the given color is visible if painted (has alpha and color values) + + the color to check + true - visible, false - not visible + + + + Clip the region the graphics will draw on by the overflow style of the containing block.
+ Recursively travel up the tree to find containing block that has overflow style set to hidden. if not + block found there will be no clipping and null will be returned. + + the graphics to clip + the box that is rendered to get containing blocks + true - was clipped, false - not clipped + + + + Draw image loading icon. + + the device to draw into + + the rectangle to draw icon in + + + + Draw image failed to load icon. + + the device to draw into + + the rectangle to draw icon in + + + + Creates a rounded rectangle using the specified corner radius
+ NW-----NE + | | + | | + SW-----SE + + the device to draw into + Rectangle to round + Radius of the north east corner + Radius of the north west corner + Radius of the south east corner + Radius of the south west corner + GraphicsPath with the lines of the rounded rectangle ready to be painted + + + + Represents sub-string of a full string starting at specific location with a specific length. + + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Init sub-string that is the full string. + + the full string that this sub-string is part of + + + + Init. + + the full string that this sub-string is part of + the start index of the sub-string + the length of the sub-string starting at + is null + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Get string char at specific index. + + the idx to get the char at + char at index + + + + Is the sub-string is empty string. + + true - empty string, false - otherwise + + + + Is the sub-string is empty string or contains only whitespaces. + + true - empty or whitespace string, false - otherwise + + + + Is the sub-string contains only whitespaces (at least one). + + true - empty or whitespace string, false - otherwise + + + + Get a string of the sub-string.
+ This will create a new string object! + + new string that is the sub-string represented by this instance + + + + Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length. + + The zero-based starting character position of a substring in this instance. + The number of characters in the substring. + A String equivalent to the substring of length length that begins at startIndex in this instance, or + Empty if startIndex is equal to the length of this instance and length is zero. + + + + Collection of regular expressions used when parsing + + + + + Extracts CSS style comments; e.g. /* comment */ + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts CSS colors; e.g. black white #fff #fe98cd rgb(5,5,5) rgb(45%, 0, 0) + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts CSS border styles; e.g. solid none dotted + + + + + Extracts CSS border widthe; e.g. 1px thin 3em + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + Extracts HTML tags + + + + + Extracts attributes from a HTML tag; e.g. att=value, att="value" + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + 线条图 @@ -32826,5 +42888,2509 @@ the contents of this method with the code editor. + + + The top left rectangle in auto hide strip area. + + + + + The top right rectangle in auto hide strip area. + + + + + The bottom left rectangle in auto hide strip area. + + + + + The bottom right rectangle in auto hide strip area. + + + + + Gets one of the four auto hide strip rectangles. + + Dock state. + The desired rectangle. + + As the corners are represented by , , , and , + the four strips can be easily calculated out as the borders. + + + + + Context menu. + + + This property should be obsolete as it does not support theming. Please use instead. + + + + + Context menu strip. + + + + + Overridden to avoid resize issues with nested controls + + + http://blogs.msdn.com/b/alejacma/archive/2008/11/20/controls-won-t-get-resized-once-the-nesting-hierarchy-of-windows-exceeds-a-certain-depth-x64.aspx + http://support.microsoft.com/kb/953934 + + + + + Determines whether the close button is visible on the content + + + + + There's a bug in the WinForms layout engine + that can result in a deferred layout to not + properly clear out the cached layout args after + the layout operation is performed. + Specifically, this bug is hit when the bounds of + the Pane change, initiating a layout on the parent + (DockWindow) which is where the bug hits. + To work around it, when a pane loses the DockWindow + as its parent, that parent DockWindow needs to + perform a layout to flush the cached args, if they exist. + + + + + Gets a value indicating whether dock panel can be dragged when in auto hide mode. + Default is false. + + + + + Determines the color with which the client rectangle will be drawn. + If this property is used instead of the BackColor it will not have any influence on the borders to the surrounding controls (DockPane). + The BackColor property changes the borders of surrounding controls (DockPane). + Alternatively both properties may be used (BackColor to draw and define the color of the borders and DockBackColor to define the color of the client rectangle). + For Backgroundimages: Set your prefered Image, then set the DockBackColor and the BackColor to the same Color (Control) + + + + + Dock area. + + + This is the center rectangle of control. + + Excluded spaces are for the following visual elements, + * Auto hide strips on four sides. + * Necessary paddings defined in themes. + + Therefore, all dock contents mainly fall into this area (except auto hide window, which might slightly move beyond this area). + + + + + Flag to show autohide content on mouse hover. Default value is true. + + + This flag is ignored in VS2012/2013 themes. Such themes assume it is always false. + + + + + DragHandlerBase is the base class for drag handlers. The derived class should: + 1. Define its public method BeginDrag. From within this public BeginDrag method, + DragHandlerBase.BeginDrag should be called to initialize the mouse capture + and message filtering. + 2. Override the OnDragging and OnEndDrag methods. + + + + + Loads layout from XML file. + + The file name. + Deserialization handler. + Deserialization might throw exceptions. + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + Deserialization might throw exceptions. + + The stream is closed after deserialization. + + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + The flag to close the stream after deserialization. + Deserialization might throw exceptions. + + + + Deserialization handler of layout file/stream. + + Strings stored in layout file/stream. + Dock content deserialized from layout/stream. + + The deserialization handler method should handle all possible exceptions. + + If any exception happens during deserialization and is not handled, the program might crash or experience other issues. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The skin to use when displaying the DockPanel. + The skin allows custom gradient color schemes to be used when drawing the + DockStrips and Tabs. + + + + + The skin used to display the auto hide strips and tabs. + + + + + The skin used to display the Document and ToolWindow style DockStrips and Tabs. + + + + + The skin used to display the auto hide strip and tabs. + + + + + The gradient color skin for the DockStrips. + + + + + The gradient color skin for the Tabs. + + + + + The gradient color skin for the Tabs. + + + + + Font used in AutoHideStrip elements. + + + + + The skin used to display the document and tool strips and tabs. + + + + + The skin used to display the Document style DockPane strip and tab. + + + + + The skin used to display the ToolWindow style DockPane strip and tab. + + + + + Font used in DockPaneStrip elements. + + + + + The skin used to display the DockPane ToolWindow strip and tab. + + + + + The skin used to display the active ToolWindow caption. + + + + + The skin used to display the inactive ToolWindow caption. + + + + + The skin used to display the DockPane strip and tab. + + + + + The gradient color skin for the DockStrip. + + + + + The skin used to display the active DockPane tabs. + + + + + The skin used to display the inactive DockPane tabs. + + + + + The skin used to display the dock pane tab + + + + + The text color. + + + + + The skin used to display the dock pane tab + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient color skin. + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient mode to display the colors. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Dock window base class. + + + + + Dock window of Visual Studio 2003/2005 theme. + + + + + The location to draw the DockPaneStrip for Document style windows. + + + + + + + + + + + + + + + Gets images for tabs and captions. + + + + + + + + + + Gets images for docking indicators. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Switches a pane with its first child in the pane hierarchy. (The actual hiding happens elsewhere.) + + Pane to switch + + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + Looks up a localized resource of type System.Drawing.Bitmap. + + + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized string similar to Docking. + + + + + Looks up a localized string similar to Docking Notification. + + + + + Looks up a localized string similar to Performance. + + + + + Looks up a localized string similar to Property Changed. + + + + + Looks up a localized string similar to (Float). + + + + + Looks up a localized string similar to Determines if end user drag and drop docking is allowed.. + + + + + Looks up a localized string similar to The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel.. + + + + + Looks up a localized string similar to Enable/Disable the close button of the content.. + + + + + Looks up a localized string similar to Shows or hides the close button of the content. This property does not function with System MDI Document Style.. + + + + + Looks up a localized string similar to The form must be of type IDockContent.. + + + + + Looks up a localized string similar to Gets or sets a value indicating in which area of the DockPanel the content allowed to show.. + + + + + Looks up a localized string similar to Occurs when the value of DockState property changed.. + + + + + Looks up a localized string similar to Indicates the content will be hidden instead of being closed.. + + + + + Looks up a localized string similar to The desired docking state when first showing.. + + + + + Looks up a localized string similar to Context menu displayed for the dock pane tab strip.. + + + + + Looks up a localized string similar to The tab text displayed in the dock pane. If not set, the Text property will be used.. + + + + + Looks up a localized string similar to The text displayed when mouse hovers over the tab.. + + + + + Looks up a localized string similar to The provided value is out of range.. + + + + + Looks up a localized string similar to Invalid Value: The value of DockAreas conflicts with current DockState.. + + + + + Looks up a localized string similar to The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane.. + + + + + Looks up a localized string similar to The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane.. + + + + + Looks up a localized string similar to Invalid value, conflicts with DockableAreas property.. + + + + + Looks up a localized string similar to The dock state is invalid.. + + + + + Looks up a localized string similar to The dock panel is null.. + + + + + Looks up a localized string similar to Invalid beforeContent, it must be contained by the pane.. + + + + + Looks up a localized string similar to Invalid DockState: Content can not be showed as "Unknown" or "Hidden".. + + + + + Looks up a localized string similar to The previous pane is invalid. It can not be null, and its docking state must not be auto-hide.. + + + + + Looks up a localized string similar to DockPanel can not be null.. + + + + + Looks up a localized string similar to The Pane can not be null.. + + + + + Looks up a localized string similar to Invalid value, check DockableAreas property.. + + + + + Looks up a localized string similar to Context menu displayed for the dock pane tab strip.. + + + + + Looks up a localized string similar to Press SHIFT for docking to full side.. + + + + + Looks up a localized string similar to Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content.. + + + + + Looks up a localized string similar to Invalid argument: Content can not be "null".. + + + + + Looks up a localized string similar to Invalid argument: The content's DockPanel can not be "null".. + + + + + Looks up a localized string similar to The specified container conflicts with the IsFloat property.. + + + + + Looks up a localized string similar to The previous pane does not exist in the nested docking pane collection.. + + + + + Looks up a localized string similar to The container can not be null.. + + + + + Looks up a localized string similar to The previous pane can not be null when the nested docking pane collection is not empty.. + + + + + Looks up a localized string similar to The previous pane can not be itself.. + + + + + Looks up a localized string similar to FloatWindow property can not be set to "null" when DockState is DockState.Float.. + + + + + Looks up a localized string similar to Invalid Content: Content not within the collection.. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to The state for the dock pane is invalid.. + + + + + Looks up a localized string similar to Auto Hide. + + + + + Looks up a localized string similar to Close. + + + + + Looks up a localized string similar to Options. + + + + + Looks up a localized string similar to Invalid Content: The content must be auto-hide state and associates with this DockPanel.. + + + + + Looks up a localized string similar to Occurs when the value of the AutoHideWindow's ActiveContent changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActiveContentProperty changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActiveDocument property changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActivePane property changed.. + + + + + Looks up a localized string similar to Determines if the drag and drop docking is allowed.. + + + + + Looks up a localized string similar to Determines if the drag and drop nested docking is allowed.. + + + + + Looks up a localized string similar to Occurs when a content added to the DockPanel.. + + + + + Looks up a localized string similar to Occurs when a content removed from the DockPanel.. + + + + + Looks up a localized string similar to The default size of float window.. + + + + + Looks up a localized string similar to Provides Visual Studio .Net style docking.. + + + + + Looks up a localized string similar to Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to The visual skin to use when displaying the docked windows.. + + + + + Looks up a localized string similar to Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Occurs when a document or pane is dragged within the dock panel.. + + + + + Looks up a localized string similar to The style of the document window.. + + + + + Looks up a localized string similar to Determines where the tab strip for Document style content is drawn.. + + + + + Looks up a localized string similar to The DockPanel has already been initialized.. + + + + + Looks up a localized string similar to The configuration file's version is invalid.. + + + + + Looks up a localized string similar to The XML file format is invalid.. + + + + + Looks up a localized string similar to Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form.. + + + + + Looks up a localized string similar to DockPanel configuration file. Author: Weifen Luo, all rights reserved.. + + + + + Looks up a localized string similar to !!! AUTOMATICALLY GENERATED FILE. DO NOT MODIFY !!!. + + + + + Looks up a localized string similar to Indicates whether the control layout is right-to-left when the RightToLeft property is set to Yes.. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to Invalid Pane: DockPane not within the collection.. + + + + + Looks up a localized string similar to Shows the hidden autohide content when hovering over the tab. When disabled, the tab must be clicked to show the content.. + + + + + Looks up a localized string similar to Show close button on each tab. + + + + + Looks up a localized string similar to Determines if the document icon will be displayed in the tab strip.. + + + + + Looks up a localized string similar to Support deeply nested controls. Disabling this setting may improve resize performance but may cause heavily nested content not to resize.. + + + + + Looks up a localized string similar to Close. + + + + + Looks up a localized string similar to Window List. + + + + + Looks up a localized string similar to Invalid argument: DockPanel can not be "null".. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to Invalid Pane: DockPane not within the collection.. + + + + + Looks up a localized string similar to Invalid DockPanel.. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Determines whether the close button is visible on the content + + + + + Calculate which tabs are displayed and in what order. + + + + + Visual Studio 2005 theme (default theme). + + + + + + + + + + X for this inside the logical strip rectangle. + + + + + Width of this . + + + + + Dock window of Visual Studio 2012 Light theme. + + + + + Initializes a new instance of the class. + + The dock panel. + State of the dock. + + + + Determines whether the close button is visible on the content + + + + + A strongly-typed resource class, for looking up localized strings, etc. + + + + + Returns the cached ResourceManager instance used by this class. + + + + + Overrides the current thread's CurrentUICulture property for all + resource lookups using this strongly typed resource class. + + + + + Looks up a localized string similar to Docking. + + + + + Looks up a localized string similar to Docking Notification. + + + + + Looks up a localized string similar to Performance. + + + + + Looks up a localized string similar to Property Changed. + + + + + Looks up a localized string similar to (Float). + + + + + Looks up a localized string similar to Determines if end user drag and drop docking is allowed.. + + + + + Looks up a localized string similar to The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel.. + + + + + Looks up a localized string similar to Enable/Disable the close button of the content.. + + + + + Looks up a localized string similar to Shows or hides the close button of the content. This property does not function with System MDI Document Style.. + + + + + Looks up a localized string similar to The form must be of type IDockContent.. + + + + + Looks up a localized string similar to Gets or sets a value indicating in which area of the DockPanel the content allowed to show.. + + + + + Looks up a localized string similar to Occurs when the value of DockState property changed.. + + + + + Looks up a localized string similar to Indicates the content will be hidden instead of being closed.. + + + + + Looks up a localized string similar to The desired docking state when first showing.. + + + + + Looks up a localized string similar to Context menu displayed for the dock pane tab strip.. + + + + + Looks up a localized string similar to The tab text displayed in the dock pane. If not set, the Text property will be used.. + + + + + Looks up a localized string similar to The text displayed when mouse hovers over the tab.. + + + + + Looks up a localized string similar to The provided value is out of range.. + + + + + Looks up a localized string similar to Invalid Value: The value of DockAreas conflicts with current DockState.. + + + + + Looks up a localized string similar to The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane.. + + + + + Looks up a localized string similar to The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane.. + + + + + Looks up a localized string similar to Invalid value, conflicts with DockableAreas property.. + + + + + Looks up a localized string similar to The dock state is invalid.. + + + + + Looks up a localized string similar to The dock panel is null.. + + + + + Looks up a localized string similar to Invalid beforeContent, it must be contained by the pane.. + + + + + Looks up a localized string similar to Invalid DockState: Content can not be showed as "Unknown" or "Hidden".. + + + + + Looks up a localized string similar to The previous pane is invalid. It can not be null, and its docking state must not be auto-hide.. + + + + + Looks up a localized string similar to DockPanel can not be null.. + + + + + Looks up a localized string similar to The Pane can not be null.. + + + + + Looks up a localized string similar to Invalid value, check DockableAreas property.. + + + + + Looks up a localized string similar to Context menu displayed for the dock pane tab strip.. + + + + + Looks up a localized string similar to Press SHIFT for docking to full side.. + + + + + Looks up a localized string similar to Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content.. + + + + + Looks up a localized string similar to Invalid argument: Content can not be "null".. + + + + + Looks up a localized string similar to Invalid argument: The content's DockPanel can not be "null".. + + + + + Looks up a localized string similar to The specified container conflicts with the IsFloat property.. + + + + + Looks up a localized string similar to The previous pane does not exist in the nested docking pane collection.. + + + + + Looks up a localized string similar to The container can not be null.. + + + + + Looks up a localized string similar to The previous pane can not be null when the nested docking pane collection is not empty.. + + + + + Looks up a localized string similar to The previous pane can not be itself.. + + + + + Looks up a localized string similar to FloatWindow property can not be set to "null" when DockState is DockState.Float.. + + + + + Looks up a localized string similar to Invalid Content: Content not within the collection.. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to The state for the dock pane is invalid.. + + + + + Looks up a localized string similar to Auto Hide. + + + + + Looks up a localized string similar to Close. + + + + + Looks up a localized string similar to Window Position. + + + + + Looks up a localized string similar to Invalid Content: The content must be auto-hide state and associates with this DockPanel.. + + + + + Looks up a localized string similar to Occurs when the value of the AutoHideWindow's ActiveContent changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActiveContentProperty changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActiveDocument property changed.. + + + + + Looks up a localized string similar to Occurs when the value of ActivePane property changed.. + + + + + Looks up a localized string similar to Determines if the drag and drop docking is allowed.. + + + + + Looks up a localized string similar to Determines if the drag and drop nested docking is allowed.. + + + + + Looks up a localized string similar to Occurs when a content added to the DockPanel.. + + + + + Looks up a localized string similar to Occurs when a content removed from the DockPanel.. + + + + + Looks up a localized string similar to The default size of float window.. + + + + + Looks up a localized string similar to Provides Visual Studio .Net style docking.. + + + + + Looks up a localized string similar to Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to The visual skin to use when displaying the docked windows.. + + + + + Looks up a localized string similar to Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels.. + + + + + Looks up a localized string similar to The style of the document window.. + + + + + Looks up a localized string similar to Determines where the tab strip for Document style content is drawn.. + + + + + Looks up a localized string similar to The DockPanel has already been initialized.. + + + + + Looks up a localized string similar to The configuration file's version is invalid.. + + + + + Looks up a localized string similar to The XML file format is invalid.. + + + + + Looks up a localized string similar to Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form.. + + + + + Looks up a localized string similar to DockPanel configuration file. Author: Weifen Luo, all rights reserved.. + + + + + Looks up a localized string similar to !!! AUTOMATICALLY GENERATED FILE. DO NOT MODIFY !!!. + + + + + Looks up a localized string similar to Indicates whether the control layout is right-to-left when the RightToLeft property is set to Yes.. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to Invalid Pane: DockPane not within the collection.. + + + + + Looks up a localized string similar to Shows the hidden autohide content when hovering over the tab. When disabled, the tab must be clicked to show the content.. + + + + + Looks up a localized string similar to Show close button on each tab. + + + + + Looks up a localized string similar to Determines if the document icon will be displayed in the tab strip.. + + + + + Looks up a localized string similar to Support deeply nested controls. Disabling this setting may improve resize performance but may cause heavily nested content not to resize.. + + + + + Looks up a localized string similar to Close. + + + + + Looks up a localized string similar to Window List. + + + + + Looks up a localized string similar to Invalid argument: DockPanel can not be "null".. + + + + + Looks up a localized string similar to Invalid Index: The index is out of range.. + + + + + Looks up a localized string similar to Invalid Pane: DockPane not within the collection.. + + + + + Looks up a localized string similar to Invalid DockPanel.. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculate which tabs are displayed and in what order. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 theme base. + + + + + + + + + + + + + + diff --git a/Bin/Release/CommonControls/.NET4 示例/ryUpdate.dll b/Bin/Release/CommonControls/.NET4 示例/ryUpdate.dll index adf37b2..7d39380 100644 Binary files a/Bin/Release/CommonControls/.NET4 示例/ryUpdate.dll and b/Bin/Release/CommonControls/.NET4 示例/ryUpdate.dll differ diff --git a/Bin/Release/CommonControls/.NET4/MyDb.dll b/Bin/Release/CommonControls/.NET4/MyDb.dll deleted file mode 100644 index c9aa0fe..0000000 Binary files a/Bin/Release/CommonControls/.NET4/MyDb.dll and /dev/null differ diff --git a/Bin/Release/CommonControls/.NET4/MyDb.xml b/Bin/Release/CommonControls/.NET4/MyDb.xml deleted file mode 100644 index a616cd0..0000000 --- a/Bin/Release/CommonControls/.NET4/MyDb.xml +++ /dev/null @@ -1,11589 +0,0 @@ - - - - MyDb - - - - - 基于XML实现的权限类 - - - - - 用户名 - - - - - 用户id - - - - - 密码 - - - - - 权限控制Id - - - - - 用户备注 - - - - - 是否是管理员权限 - - - - - 是否是超级管理员权限 - - - - - 设置权限 - - 权限名称 - 权限值 - 返回是否设置成功 - - - - 获取权限 - - 权限名称 - 默认权限值 - 返回权限值 - - - - 获取权限 - - 权限名称 - 返回权限值 - - - - 批量导入权限 - - 权限相关的内容 - 返回是否执行成功 - - - - 导出权限 - - 返回导出文本 - - - - 清除所有权限 - - 返回是否执行成功 - - - - 汉字转拼音静态类,包括功能全拼和缩写，方法全部是静态的 - - - - - 汉字的机内码数组 - - - - - 机内码对应的拼音数组 - - - - - 把汉字转换成拼音(全拼) - - 汉字字符串 - 转换后的拼音(全拼)字符串 - - - - 把汉字转换成拼音(全拼) - - 汉字字符串 - 转换后的拼音(全拼)字符串 - - - - 把汉字转换成拼音(首拼) - - 汉字字符串 - 转换后的拼音(首拼)字符串 - - - - 把汉字转换成拼音(全拼) - - 汉字字符串 - 用指定字符分隔 - 转换后的拼音(全拼)字符串 - - - - 汉字转拼音缩写 - - 要转换的汉字字符串 - 拼音缩写 - - - - 汉字转拼音缩写 (字符串) (小写) (空格间隔) - - 要转换的汉字字符串 - 拼音缩写 - - - - 汉字转拼音缩写 (大写) - - 要转换的汉字字符串 - 拼音缩写 - - - - 汉字转拼音缩写 (字符串)(大写)(空格间隔) - - 要转换的汉字字符串 - 拼音缩写 - - - - 取单个字符的拼音声母 - - 要转换的单个汉字 - 拼音声母 - - - - 取单个字符的拼音声母 - - 要转换的单个汉字 - 拼音声母 - - - - Ini操作类 - - - - - 写入Ini - - - - - - - - - - 获取Ini - - - - - - - - - - - - 声明INI文件的读操作函数 GetPrivateProfileString() - - - - - - - - - - - - 声明INI文件的读操作函数 GetPrivateProfileString() - - - - - - - - - - 声明INI文件的读操作函数 GetPrivateProfileString() - - - - - - - - - - - - 获取所有节点名称(Section) - - 存放节点名称的内存地址,每个节点之间用\0分隔 - 内存大小(characters) - Ini文件 - 内容的实际长度,为0表示没有内容,为nSize-2表示内存大小不够 - - - - 编码 - - - - - Ini操作类 - - - - - - 根据section取所有key和值 - - - - - - - 读取INI文件中指定INI文件中的所有节点名称(Section) - - 所有节点,没有内容返回string[0] - - - - 读取INI文件 - - 段，格式[] - 键 - 返回byte类型的section组或键值组 - - - - 根据section取所有key - - - - - - - 写入ini - - - - - - - - 写入ini - - - - - - - - 写入ini - - - - - - - - 写入ini - - - - - - - - 写入ini - - - - - - - - 写入Ini - - - - - - - - 读取Ini - - - - - - - - 读取Ini - - - - - - - - - 读取Ini - - - - - - - - - 读取Ini - - - - - - - - - - - 写入ini - - - - - - - - - 删除Ini的Key - - - - - - - 删除Ini节点 - - - - - - 控件信息 - - - - - id - - - - - 控件对象 - - - - - 控件值类型 - - - - - 默认值 - - - - - 值类型 - - - - - 默认 - - - - - 取列表顺序值 - - - - - 取当前选择的列表值 - - - - - 取对象值 - - - - - 保存的设置类型 - - - - - Ini - - - - - XML - - - - - 对象值 - - - - - 显示的文本 - - - - - 图片序号 - - - - - id - - - - - Tag值 - - - - - 显示文本值 - - - - - - 星期数据 - - - - - 一周的开始时间 - - - - - 一周的结束时间 - - - - - XML操作类 - - - - - XML操作类 - - - - - 从XML文本中加载数据 - - - - - - 从指定的XML文本中加载 - - XML文本 - 如为1，表示加载成功，为0为失败 - - - - 载入空的XML文档 - - 如为1，表示加载成功，为0为失败 - - - - 从指定的文件中加载 - - XML文件路径 - 如为1，表示加载成功，为0为失败 - - - - 保存到指定文件中 - - 文件路径 - 如为1，表示保存成功，为0为失败 - - - - 判断节点是否存在 - - 属性名 - 属性值 - 返回1，表示存在，其它表示不存在 - - - - 定位节点 - - 属性名 - 属性值 - 返回第一个符合要求的结果 - - - - 定位节点,如果找不到节点，就新建一个节点 - - 属性名 - 属性值 - 返回第一个符合要求的结果 - - - - 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 - - 返回第一个符合要求的结果 - - - - 定位设置节点 - - 返回第一个符合要求的结果 - - - - 在节点后插入数据 - - - - - - - 在节点前插入数据 - - - - - - - 获取节点数量 - - 属性名 - 属性值 - 返回符合要求的结果数量 - - - - 获取节点数量 - - 返回符合要求的结果数量 - - - - 获取节点数量 - - 属性名 - 属性值 - - - - 返回符合要求的结果数量 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 设置节点值 - - 属性名 - 属性值 - 如为1，表示加载成功，为0为失败 - - - - 读取指定节点的值(string) - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 获取属性值 - - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 读取所有的节点名称 - - - - - - 读取指定节点的值(string) - - - - - - - - 读取指定节点的值(int) - - - - - - - - 读取指定节点的值(decimal) - - - - - - - - 读取指定节点的值 - - - - - - - - 读取指定节点的值 - - - - - - - - 获取XML文件的根元素 - - - - - 获取所有列表 - - 如为1，表示获取成功，为0为失败 - - - - 获取所有列表 - - 如为1，表示获取成功，为0为失败 - - - - 新增节点 - - - - - - - - 新增节点并定位到新节点 - - - - - - - - 新增设置节点并定位 - - - - - - 在指定节点前新增节点并定位到新节点 - - - - - - - - - 获取当前节点 - - - - - - 删除节点 - - - - - - 获取XML文本 - - - - - - 获取XML文本 - - - - - - 获取文本 - - - - - - 获取文本 - - - - - - 字符串操作类 - - - - - 字符串转Base64 - - - - - - - Base64转字符串 - - - - - - - 转换指定字符串为布尔类型 - - - - - 转换指定字符串为Double类型 - - - - - 已重载.计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. - - 第一个日期和时间 - 第二个日期和时间 - - - - - 已重载.计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. - - 一个日期和时间 - - - - - 转换指定字符串为Int类型 - - - - - 转换指定字符串为Int类型 - - - - - 转换指定布尔类型为Int类型,true为1，false为0 - - - - - 判断指定字符串是否是布尔类型 - - - - - 判断指定字符串是否是Double类型 - - - - - 判断指定字符串是否是Int类型 - - - - - 根据年月日转换成日期 - - - - - - - - - 追加字符 - - - - - 获取2个字符串中间的内容,point1为空表示从首位开始算，point2为空表示算到结尾。 - - - - - 判断字符串是否只包含数字或英文 - - - - - - - 判断字符串是否只包含英文 - - - - - - - 判断字符串是否只包含数字 - - - - - - - 判断字符串是否匹配,支持?*通配符 - - 待匹配的字符串 - 匹配的通配符 - - - - - 通配符替换 - - - - - - - - - 支持忽略大小写的替换功能 - - - - - 是否忽略大小写 - - - - - 获取匹配的内容 - - - - - - - - - 文件时间 - - - - - 创建时间 - - - - - 最后修改时间 - - - - - 访问时间 - - - - - 图片类型 - - - - - Bmp图片 - - - - - Jpeg图片 - - - - - Png图片 - - - - - Gif动态图片 - - - - - Tiff图片 - - - - - 对变量的拓展 - - - - - 替换文本(忽略大小写) - - - 需要替换的内容 - 替换后的内容 - - - - - 替换文本(忽略大小写),可支持通配符 - - - - - 是否是通配符表达式,不是，则普通替换，忽略大小写，是，则启用通配符替换 - - - - - 支持忽略大小写的替换文本功能 - - - - - 是否忽略大小写 - - - - - 获取符合要求的第一个结果 - - - - 是否是正则 - - - - - 查找字符串,忽略大小写 - - - - - - - - - 查找字符串,忽略大小写 - - - - - - - - 判断字符串是否是数字或英文 - - - - - - - 判断字符串是否是英文 - - - - - - - 判断字符串是否是数字(不同于IsInt,本函数是判断字符串是否只含有数字,对字符串长度没有限制) - - - - - - - 是否在指定范围内 - - - - - - - - - 是否在指定范围内 - - - - - - - - - 转换指定字符串为Int类型 - - - 最小值 - 最大值 - 如果字符串不在范围内，则使用本默认值 - - - - - 转换指定布尔类型到Int类型,true为1，false为0 - - - - - - - 将指定类型转换成整型 - - - - - - - - 将数字转换成字符串,小数点末尾后面不包含0 - - - - - - - 将数字转换成字符串,小数点末尾后面不包含0 - - - - - - - - 将数字转换成字符串,小数点末尾后面不包含0 - - - - - - - 将数字转换成字符串,小数点末尾后面不包含0 - - - - - - - - 将指定类型转换成整型 - - - - - - - 将指定类型转换成长整型,如果时间时间类型,则转换为Unix时间戳 - - - - - - - - 转换为Unix时间戳 - - - - - - - 转换为Js时间戳 - - - - - - - 转换为Unix时间戳 - - - - - - - 将指定类型转换成长整型 - - - - - - - 转换指定类型为Double类型 - - - - - - - - 转换指定类型为Double类型 - - - - - - - 判断时间是否在指定时间上 - - - - - - - - - 判断时间是否在指定时间上 - - - - - - - - - - 判断时间是否在指定日期 - - - - - - - - - 判断时间是否在指定日期 - - - - - - - - - - 转换DateTime类型到日期时间字符串(例如 2000-01-01 08:08:08) - - - - - - - 转换DateTime类型到日期字符串(例如 2000-01-01) - - - - - - - 转换DateTime类型到日期星期字符串(例如 2000-01-01 星期六) - - - - - - - 转换DateTime类型到Unix时间戳 - - - - - - - 转换Unix时间戳到DateTime类型 - - - - - - - 判断字符串是否与内容匹配 - - - - - - - - 将变量值转换成Double类型,如果不在指定区域范围内，则使用默认值 - - - - - - - - - - 转换到文件大小字符串 - - - - - - - 转换到文件大小字符串 - - - - - - - 转换指定类型为Decimal类型 - - - - - - - - 将变量值转换成Decimal类型 - - - - - - - 将变量值转换成Decimal类型,如果不在指定区域范围内，则使用默认值 - - - - - - - - - - 转换指定类型为DateTime类型 - - - - - - - - 将变量值转换成DateTime类型 - - - - - - - 转换指定类型为布尔类型 - - - - - - - 追加字符 - - - - - - - - 获取指定字符串之间的内容 - - - - - - - - - 获取指定字符串之间的内容 - - - - - - - - - - - - 判断指定字符串是否是Int类型 - - - - - - - 判断指定字符串是否是Double类型 - - - - - - - 判断是否是布尔类型 - - - - - - - 将字符串转换为Base64类型 - - - - - - - 判断字符串是否在指定长度 - - - - - - - - - 判断能否转换成日期格式 - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 根据表单字段名,获取对应的值 - - - - - - - - - 文件信息 - - - - - 获取版本号 - - - - - 获取版本号 - - - - - - - 根据版本字符串输出double类型的版本号 - - - - - - - - 比较两个版本号大小 - - - - oldVer小于newVer,返回1,大于则返回-1,相等返回0 - - - - 比较版本号 - - - - - - old小于new,返回1,大于则返回-1,相等返回0 - - - - 判断是否是管理员方式运行 - - - - - - 大文件与批量文件操作类,支持中途取消操作,本类需要实例化操作 - - - - - 传输进度 - - 当前传输完成的值 - 全部值,为-1表示无法获取 - 当前传输的百分比,为-1表示无法获取 - - - - 传输进度 - - - - - 取消事件 - - - - - 大文件按流复制文件,支持自动创建目标文件夹。 true：复制成功 false：复制失败 - - 原始文件路径 - 复制目标文件路径 - - - - - 复制文件夹到目标文件夹,不支持进度事件,支持中途取消 - - 源文件夹 - 目标文件夹 - 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 - - - - 复制文件夹到目标文件夹,支持进度事件,支持中途取消 - - 源文件夹 - 目标文件夹 - 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 - - - - 复制文件夹到目标文件夹,支持中途取消 - - 源文件夹 - 目标文件夹 - 初始的文件数量 - 总数量,如果不计算,则使用-1 - 操作的数量,包含成功的和失败的 - 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 - - - - 获取文件夹中的文件数量 - - 文件夹路径 - 返回文件数量,中途取消则返回-1 - - - - 获取文件夹的大小 - - 文件夹路径 - 返回文件数量,中途取消则返回-1 - - - - 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) - - 要添加的文件路径 - 要添加到的文件夹 - 是否根据时间进行重命名 - 返回是否成功执行 - 成功执行则返回路径，否则返回空 - - - - Hosts操作类 - - - - - 获取并转换hosts内容 - - hosts内容 - - - - - 获取hosts并转换hosts内容 - - - - - - 追加内容到hosts里 - - 要追加的内容列表，每一行为ip 域名的格式 - 0表示无需新增,-1表示添加失败,1表示追加成功 - - - - write为true,追加内容到hosts里;为false,判断是否需要追加 - - 要追加的内容列表，每一行为ip 域名的格式 - 是否要写入,如果为false,则只判断是否需要追加,而不写入Hosts文件 - 0表示无需新增,-1表示添加失败,1表示追加成功 - - - - 追加内容到hosts里 - - 要追加的内容 - 0表示无需新增,-1表示添加失败,1表示追加成功 - - - - 追加内容到hosts里 - - ip地址 - 域名 - 0表示无需新增,-1表示添加失败,1表示追加成功 - - - - 从hosts文件里删除内容 - - 要删除的内容 - 0表示无需删除,-1表示添加失败,1表示删除成功 - - - - 从hosts文件里删除内容 - - ip地址 - 域名 - 0表示无需删除,-1表示添加失败,1表示删除成功 - - - - Host信息 - - - - - IP - - - - - 域名 - - - - - 注释 - - - - - 是否要删除 - - - - - 音频播放类 - - - - - 临时音频文件 - - - - - 父窗口句柄 - - - - - 声音标签 - - - - play synchronously (default) - - - play asynchronously - - - silence (!default) if sound not found - - - pszSound points to a memory file - - - loop the sound until next sndPlaySound - - - don’t stop any currently playing sound - - - Stop Playing Wave - - - don’t wait if the driver is busy - - - name is a registry alias - - - alias is a predefined id - - - name is file name - - - name is resource name or atom - - - - 音频播放类 - - embedded music file - 临时保存的文件位置 - 父窗口句柄 - - - - 音频播放类 - - 要播放的音频位置 - 父窗口句柄 - - - - 音频播放类 - - - 父窗口句柄 - - - - 播放音频 - - - - - - 播放音频 - - - - - 关闭音频 - - - - - 文件操作类 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 删除单个文件。 - - 删除的文件名 - 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 - 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 - 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 - 反馈错误消息的字符串 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 删除单个文件。 - - 删除的文件名 - 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 永久删除单个文件。 - - 永久删除的文件名 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 删除一组文件。 - - 字符串数组，表示一组文件名 - 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 - 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 - 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 - 反馈错误消息的字符串 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 移动文件到指定路径下 - - 要移动的文件名 - 移动到的目的路径 - - - - - 移动一个文件到指定路径下 - - 要移动的文件名 - 移动到的目的路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 反馈错误消息的字符串 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 - - - - 移动一组文件到指定的路径下 - - 要移动的文件名数组 - 移动到的目的路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 反馈错误消息的字符串 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 - - - - 复制文件到指定的文件名或路径 - - 要复制的文件名 - 复制到的目的文件名或路径 - - - - - 复制文件到指定的文件名或路径 - - 要复制的文件名 - 复制到的目的文件名或路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 返回错误信息 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 - - - - 复制一组文件到指定的路径 - - 要复制的文件名数组 - 复制到的目的路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 返回错误信息 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 - - - - 大文件多次复制文件 true：复制成功 false：复制失败 - - 原始文件路径 - 复制目标文件路径 - - - - - 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) - - 源文件夹 - 目标文件夹 - 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 - - - - 重命名一个文件为新名称，建议您使用更方便的Microsoft.VisualBasic.FileSystem.ReName();替换该方法 - - 要复制的文件名 - 复制到的目的文件名或路径 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 返回错误信息 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 - - - - 删除单个或多个文件 - - 删除的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 - 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 - 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 - 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 - 反馈错误消息的字符串 - 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 - - - - 移动或复制一个或多个文件到指定路径下 - - 操作类型，是移动操作还是复制操作 - 要移动或复制的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 - 移动到的目的位置 - 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 - 指示是否显示进度对话框 - 指示当文件名重复时，是否自动为新文件加上后缀名 - 反馈错误消息的字符串 - 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 - - - - 如果指定文件夹不存在，则创建文件夹 - - - - - - 获取一个文件的全名 - - 文件名 - 返回生成文件的完整路径名 - - - - 获取一个文件的全名 - - 文件名 - 返回生成文件的完整路径名 - - - - 解释错误代码 - - 代码号 - 返回关于错误代码的文字描述 - - - - 运行文件 - - - - - - - - /运行文件 - - - - - - - - - 运行程序 - - - - - - - 打开文件 - - - - - - - 打开文件夹并定位文件 - - - - - - - 打开网址 - - - - - - - 判断文件名是否有效 - - - - - - - 转换到有效文件名 - - - - - - - 追加日志 - - - - - - - 追加文件 - - - - - - - 读取文件内容,可以自动识别文件编码 - - - - - - - 读取文件内容,可以自动识别文件编码 - - - - - - - - 读取文件所有行,可以自动识别文件编码 - - - - - - - 读取文件所有行,可以自动识别文件编码 - - - - - - - - 写入所有文本行到文件,如果文件夹不存在，会自动创建 - - - - - - - - 写入所有文本到文件,如果文件夹不存在，会自动创建 - - - - - - - - 从文件中加载图片,使用本方法，不会导致图片文件被占用。 - - - - - - 获取文件大小 - - - - - - - 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) - - 要添加的文件路径 - 要添加到的文件夹 - 是否根据时间进行重命名 - 返回是否成功执行 - 成功执行则返回路径，否则返回空 - - - - 获取文件大小字符串 - - - - - - - 获取文件大小字符串 - - - - - - - 复制内容到剪切板 - - - - - - 添加某个控件为支持拖放属性 - - - - - - - 使管理员方式运行时支持拖放 - - - - - - - 保存高质量不失真照片 - - - - - - - - 保存高质量不失真照片 - - - - - - - - 保存高质量不失真照片 - - - - - - - - 保存高质量不失真照片 - - - - - - - 保存高质量不失真照片 - - - - - - - 获取绝对路径 - - - - - - - 获取相对路径 - - - - - - - 获取图标 - - - - - - - - - - - - - - 销毁图标 - - - - - - - 获取文件图标 - - - - - - - - - - 用于取得一个文本文件的编码方式(Encoding)。 - - - - - 用于取得一个文本文件的编码方式(Encoding)。 - - - - - 取得一个文本文件的编码方式。如果无法在文件头部找到有效的前导符，Encoding.Default将被返回。 - - 文件名。 - - - - - 取得一个文本文件流的编码方式。 - - 文本文件流。 - - - - - 取得一个文本文件的编码方式。 - - 文件名。 - 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 - - - - - 取得一个文本文件流的编码方式。 - - 文本文件流。 - 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 - - - - - 通过给定的文件流，判断文件的编码类型 - - 文件流 - 文件的编码类型 - - - - 判断是否是不带 BOM 的 UTF8 格式 - - - - - - - 数据库操作扩展 - - - - - 判断DataSet是否包含数据 - - - - - - - 获取首行数据,如果没有数据,则返回null - - - - - - - 获取第一行第一列的值 - - - - - - - 获取第一张表的指定行数据 - - - 指定第几行 - - - - - 对鼠标或键盘的自动化操作 - - - - - 鼠标左键 - - - - - 鼠标中键 - - - - - 鼠标右键 - - - - - 模拟键盘按键 - - - - 按下还是抬起 - - - - 鼠标滚轮 - - - - - - - - 鼠标移动 - - - - - - - - 自定义鼠标按下或抬起 - - - - - - - - - 左键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标x(句柄内的坐标,非屏幕坐标) - 坐标y(句柄内的坐标,非屏幕坐标) - - - - 左键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标(句柄内的坐标,非屏幕坐标) - - - - 右键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标x(句柄内的坐标,非屏幕坐标) - 坐标y(句柄内的坐标,非屏幕坐标) - - - - 右键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标(句柄内的坐标,非屏幕坐标) - - - - 中键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标x(句柄内的坐标,非屏幕坐标) - 坐标y(句柄内的坐标,非屏幕坐标) - - - - 中键单击鼠标(支持后台单击) - - 指定要发送单击命令的句柄 - 坐标(句柄内的坐标,非屏幕坐标) - - - - 左键单击鼠标(不支持后台单击) - - 坐标x(屏幕坐标) - 坐标y(屏幕坐标) - - - - 左键单击鼠标(不支持后台单击) - - 坐标(屏幕坐标) - - - - 右键单击鼠标(不支持后台单击) - - 坐标x(屏幕坐标) - 坐标y(屏幕坐标) - - - - 右键单击鼠标(不支持后台单击) - - 坐标(屏幕坐标) - - - - 中键单击鼠标(不支持后台单击) - - 坐标x(屏幕坐标) - 坐标y(屏幕坐标) - - - - 中键单击鼠标(不支持后台单击) - - 坐标(屏幕坐标) - - - - 粘贴文本 - - - - - - 获取指定句柄的大小及位置 - - - - - - - - 设置指定句柄的大小 - - - - - - - 判断鼠标位置是不是在指定的矩形中 - - - - - - - - 判断2张图是否相似度超90 - - - - - - - - /获取2种颜色的相似度,范围为0~100 - - - - - - - - 新模态窗体 - - - - - 设置窗体返回的结果值，并关闭窗体。 - - 当前窗体 - 模态变量 - 防止 - - - - 窗体返回的结果事件 - - - - - - - 当打开的窗体返回结果时激发 - - - - - 窗体返回的状态 - - - - - 实例化类 - - 父窗体,如果为null,则取桌面为父窗体 - - - - - 获取最顶级的父窗口 - - - - - - 显示新模态窗体,会暂时禁用父窗体,关闭当前窗体后,父窗体会恢复。 - - - - - 只运行一个实例,打开后,所有窗体都依然有效。 - - - - - - 显示窗体 - - 显示的位置 - - - - 显示在父窗体中间 - - - - - 窗体显示位置 - - - - - 右上角 - - - - - 顶部中间 - - - - - 顶部右边 - - - - - 中间 - - - - - 左下角 - - - - - 底部中间 - - - - - 右下角 - - - - - 父窗体居中 - - - - - 运行库检测类 - - - - - 获取产品状态 - - - - - - - 判断是否已安装VC运行库 - - - - - - 判断是否已安装VC运行库 - - - - - - 安装状态 - - - - - 组件禁用 - - - - - 配置数据已损坏 - - - - - 安装已暂停或正在进行 - - - - - 从源运行，源不可用 - - - - - 返回缓冲区溢出 - - - - - 无效的参数传递给该函数。 - - - - - 不公布或者未安装该产品。 - - - - - 损坏 - - - - - 该产品已公布但尚未安装。 - - - - - 正在移除的组件（操作状态，不可设置） - - - - - 不同的用户安装该产品。 - - - - - 安装在本地驱动器上 - - - - - 从源代码、CD或网络运行 - - - - - 为当前用户安装该产品。 - - - - - 安装的版本,是x86还是x64，还是全部安装了 - - - - - 判断32位和64位运行库是否已安装 - - - - - 判断32位运行库是否已安装 - - - - - 判断64位运行库是否已安装 - - - - - 判断是否已安装VC2005运行库 - - - - - - 判断是否已安装VC2005SP1运行库 - - - - - - 判断是否已安装VC2008运行库 - - - - - - 判断是否已安装VC2008SP1运行库 - - - - - - 判断是否已安装VC2010运行库 - - - - - - 判断是否已安装VC2010SP1运行库 - - - - - - 判断是否已安装VC2012运行库 - - - - - - 判断是否已安装VC2013运行库 - - - - - - 判断是否已安装VC2015或以上运行库 - - - - - - 判断是否已安装VC2017运行库或以上运行库 - - - - - - 判断是否已安装VC2019运行库或以上运行库 - - - - - - 判断是否已安装VC2022运行库或以上运行库 - - - - - - 判断当前系统是否安装了WebView2组件 - - - - - - 判断当前系统是否安装了.NET 4.8 - - - - - - 日期时间的操作类 - - - - - 获取当前是周几,周一到周日，分别是1-7. - - - - - - - 获取当前是周几,1-7，分别是返回一到日. - - - - - - - 获取当前是周几,输入日期，根据周几，分别是返回一到日. - - - - - - - 获取一周的开始和结束,开始时间为第一天的0点，结束时间以最后一天的0点为结束时间 - - - - - - - 获取2个日期相差几周 - - - - - - - - 获取2个日期相差几个月 - - - - - - - - 获取一个月的开始 - - - - - - - 判断是否在同一个星期。 - - - - - - - - 判断是否在同一个月。 - - - - - - - - 判断是否在同一天 - - - - - - - - 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. - - 第一个日期和时间 - 第二个日期和时间 - - - - - 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. - - 第一个日期和时间 - 第二个日期和时间 - 是否显示秒 - - - - - 将秒数显示成中文表达式 - - - - - - - 计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. - - 一个日期和时间 - - - - - 将c# DateTime时间格式转换为Unix时间戳格式 - - 时间 - long - - - - 时间戳转为C#格式时间 - - - - - - - 时间戳转为C#格式时间 - - - - - - - 将c# DateTime时间格式转换为js时间戳格式 - - 时间 - long - - - - JS时间戳转为C#格式时间 - - - - - - - JS时间戳转为C#格式时间 - - - - - - - 根据年月日转换成日期 - - - - - - - - - 根据日期和时间转换成日期时间 - - - - - - - - 将时间转换成当前分钟开始的时间 - - - - - - - 将时间转换成当前秒钟开始的时间 - - - - - - - 当前时间在这一天里的秒数 - - - - - - - 窗体操作类 - - - - - 设置Comobox的行间距 - - - - - - - 移除关闭按钮。返回值，非零表示成功，零表示失败。 - - 窗口的句柄 - 是否成功 - - - - 把窗体放到最前 - - - - - - 显示窗体 - - - - - - - - 设置窗体是否置顶 - - - - - - - 显示没有焦点的窗口 - - - - - - 根据句柄获取窗口文本 - - - - - - - 根据句柄获取窗口类 - - - - - - - 获取当前活动的窗口句柄 - - - - - - 获取当前前台的窗口句柄 - - - - - - 设置为当前活动窗口 - - - - - - - 根据窗口句柄来获得进程id - - - - - - - 显示窗体 - - - - - - 设置窗体父窗体为桌面,不会随着显示桌面而最小化,但无法设置窗体透明度 - - - - - - 结束进程 - - - - - - - 打开窗体,只打开一个实例(非模态) - - - - - - - 将窗体植入到容器控件中 - - - 作为窗体容器的控件 - - - - - 重新调整窗体大小以适配容器大小 - - - 作为窗体容器的控件 - - - - - 设置注册表操作,部分功能需要管理员权限 - - - - - 访问的注册表位置(64位还是32位) - - - - - 访问的注册表节点 - - - - - 判断注册表项是否存在 - - - - - - - - - 删除注册表键(如果存在子键,子键将一并被删除) - - - - - - - - - - 删除注册表键值 - - - - - - - - - - 获取注册表键值 - - - - - - - - - - - 设置注册表键值 - - - - - - - - - - - 设置注册表键值 - - - - - - - - - - - 设置是否开机启动 - - 是否开机启动 - 开机启动名称 - 启动命令 - - - - - 设置是否开机启动 - - 是否开机启动 - 开机启动名称 - - - - - 把指定文件设置为开机启动或取消开机启动 - - 是否开机启动 - 开机启动名称 - 要开机启动的文件路径 - - - - - 检查是否开机启动 - - 开机启动名称 - 开机启动命令 - - - - - 检查是否开机启动 - - 开机启动名称 - - - - - 判断指定文件是否是开机启动 - - 开机启动名称 - 文件路径 - - - - - 判断当前程序是否是开机启动 - - 开机启动名称 - - - - - 判断当前程序是否是开机启动 - - 开机启动名称 - 启动命令行 - - - - - 设置指定文件的浏览器控件内核版本 - - 文件名，要求不带路径 - 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - 设置文件关联 - - 扩展名(如.apk) - 映射的扩展名(如apkfile) - app名称(建议用英文数字) - 文件关联描述 - 文件路径 - - - - 设置文件关联 - - 映射的扩展名(如apkfile) - app名称(建议用英文数字) - 文件关联描述 - 文件路径 - - - - 在指定文件格式右键菜单中增加菜单 - - 扩展名(如.apk) - app名称(建议用英文数字) - 文件关联描述 - 文件路径 - - - - 删除文件关联 - - 映射的扩展名(如apkfile) - app名称(建议用英文数字) - - - - 获取文件关联是否存在 - - 映射的扩展名(如apkfile) - app名称(建议用英文数字) - - - - 采用的IE模式 - - - - - IE7兼容视图 - - - - - IE8 标准模式 - - - - - IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - IE9 标准模式 - - - - - IE9 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - IE10 标准模式 - - - - - IE10 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - 设置当前软件的浏览器控件内核版本 - - 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 - - - - - 设置指定文件的浏览器控件内核版本 - - 文件名，要求不带路径 - IE内核版本 - - - - - 设置当前软件的浏览器控件内核版本 - - IE内核版本 - - - - - 系统函数 - - - - - - - - - - 红 - - - - - 绿 - - - - - 蓝 - - - - - 获取屏幕伽马值 - - - - - - - - 设置屏幕伽马值 - - - - - - - - 获取键盘和鼠标没有操作的时间 - - - - - - 设置屏幕 Gamma值 - - - - - - - - - 设置屏幕亮度 - - - - - - - 获取系统名称,注意需要在app.manifest文件中设置兼容win10 - - - - - - 窗体操作类 - - - - - 构造函数 - - - - - - 析构 - - - - - 设置让窗体支持移动 - - - - - 是否允许可调节大小 - - - - - 可调节窗体大小的宽度 - - - - - - - - - - - - - - - - - - - - - - - 开始截图 - - 是否截取鼠标指针 - - - - - - - - - - 根据XPath来获取属性值 - - - - 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml - - - - - - 根据当前节点生成HtmlDocument - - - - - - - 根据XPath来获取属性值 - - - - 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml - - - - - - 根据XPath来查找节点 - - - - - - - - 在当前节点下根据xpath来查找符合的第一个节点 - - - - - - - - 在当前节点下根据xpath来查找所有符合的节点 - - - - - - - - A utility class to compute CRC32. - - - - - Compute a checksum for a given array of bytes. - - The array of bytes to compute the checksum for. - The computed checksum. - - - - Compute a checksum for a given string. - - The string to compute the checksum for. - The computed checksum. - - - - Represents an HTML attribute. - - - - - Gets the line number of this attribute in the document. - - - - - Gets the column number of this attribute in the document. - - - - - Gets the stream position of the value of this attribute in the document, relative to the start of the document. - - - - - Gets the length of the value. - - - - - - - - - - Gets the qualified name of the attribute. - - - - - Name of attribute with original case - - - - - Gets the HTML document to which this attribute belongs. - - - - - Gets the HTML node to which this attribute belongs. - - - - - Specifies what type of quote the data should be wrapped in - - - - - Specifies what type of quote the data should be wrapped in (internal to keep backward compatibility) - - - - - Gets the stream position of this attribute in the document, relative to the start of the document. - - - - - Gets or sets the value of the attribute. - - - - - Gets the DeEntitized value of the attribute. - - - - - Gets a valid XPath string that points to this Attribute - - - - - Compares the current instance with another attribute. Comparison is based on attributes' name. - - An attribute to compare with this instance. - A 32-bit signed integer that indicates the relative order of the names comparison. - - - - Creates a duplicate of this attribute. - - The cloned attribute. - - - - Removes this attribute from it's parents collection - - - - - An Enum representing different types of Quotes used for surrounding attribute values - - - - - A single quote mark ' - - - - - A double quote mark " - - - - - No quote mark - - - - - The initial value (current value) - - - - - Represents a combined list and collection of HTML nodes. - - - - - Gets the number of elements actually contained in the list. - - - - - Gets readonly status of colelction - - - - - Gets the attribute at the specified index. - - - - - Gets a given attribute from the list using its name. - - - - - Adds a new attribute to the collection with the given values - - - - - - - Adds supplied item to collection - - - - - Adds a range supplied items to collection. - An IEnumerable<HtmlAttribute> of items to append to this. - - - Adds a range supplied items to collection using a dictionary. - A Dictionary<string,string> of items to append to this. - - - - Explicit clear - - - - - Retreives existence of supplied item - - - - - - - Copies collection to array - - - - - - - Get Explicit enumerator - - - - - - Explicit non-generic enumerator - - - - - - Retrieves the index for the supplied item, -1 if not found - - - - - - - Inserts given item into collection at supplied index - - - - - - - Explicit collection remove - - - - - - - Removes the attribute at the specified index. - - The index of the attribute to remove. - - - - Inserts the specified attribute as the last attribute in the collection. - - The attribute to insert. May not be null. - The appended attribute. - - - - Creates and inserts a new attribute as the last attribute in the collection. - - The name of the attribute to insert. - The appended attribute. - - - - Creates and inserts a new attribute as the last attribute in the collection. - - The name of the attribute to insert. - The value of the attribute to insert. - The appended attribute. - - - - Checks for existance of attribute with given name - - - - - - - Inserts the specified attribute as the first node in the collection. - - The attribute to insert. May not be null. - The prepended attribute. - - - - Removes a given attribute from the list. - - The attribute to remove. May not be null. - - - - Removes an attribute from the list, using its name. If there are more than one attributes with this name, they will all be removed. - - The attribute's name. May not be null. - - - - Remove all attributes in the list. - - - - - Returns all attributes with specified name. Handles case insentivity - - Name of the attribute - - - - - Removes all attributes from the collection - - - - - Clears the attribute collection - - - - - Represents an HTML comment. - - - - - Gets or Sets the comment text of the node. - - - - - Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. - - - - - Gets or Sets the object and its content in HTML. - - - - - Represents a complete HTML document. - - - - True to disable, false to enable the behavior tag p. - - - Default builder to use in the HtmlDocument constructor - - - Action to execute before the Parse is executed - - - - Defines the max level we would go deep into the html document - - - - The HtmlDocument Text. Careful if you modify it. - - - True to stay backward compatible with previous version of HAP. This option does not guarantee 100% compatibility. - - - - Adds Debugging attributes to node. Default is false. - - - - - Defines if closing for non closed nodes must be done at the end or directly in the document. - Setting this to true can actually change how browsers render the page. Default is false. - - - - - Defines if non closed nodes will be checked at the end of parsing. Default is true. - - - - - Defines if a checksum must be computed for the document while parsing. Default is false. - - - - - Defines if SelectNodes method will return null or empty collection when no node matched the XPath expression. - Setting this to true will return empty collection and false will return null. Default is false. - - - - True to disable, false to enable the server side code. - - - - Defines the default stream encoding to use. Default is System.Text.Encoding.Default. - - - - - Force to take the original comment instead of creating it - - - - - Defines if source text must be extracted while parsing errors. - If the document has a lot of errors, or cascading errors, parsing performance can be dramatically affected if set to true. - Default is false. - - - - - Defines the maximum length of source text or parse errors. Default is 100. - - - - - Defines if LI, TR, TH, TD tags must be partially fixed when nesting errors are detected. Default is false. - - - - - Defines if output must conform to XML, instead of HTML. Default is false. - - - - - If used together with and enabled, Xml namespaces in element names are preserved. Default is false. - - - - - Defines if attribute value output must be optimized (not bound with double quotes if it is possible). Default is false. - - - - Defines the global attribute value quote. When specified, it will always win. - - - - Defines if name must be output with it's original case. Useful for asp.net tags and attributes. Default is false. - - - - - Defines if name must be output in uppercase. Default is false. - - - - - Defines if declared encoding must be read from the document. - Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node. - Default is true. - - - - - Defines the name of a node that will throw the StopperNodeException when found as an end node. Default is null. - - - - - Defines if the 'id' attribute must be specifically used. Default is true. - - - - - Defines if empty nodes must be written as closed during output. Default is false. - - - - - The max number of nested child nodes. - Added to prevent stackoverflow problem when a page has tens of thousands of opening html tags with no closing tags - - - - - Creates an instance of an HTML document. - - - - Gets the parsed text. - The parsed text. - - - - Defines the max level we would go deep into the html document. If this depth level is exceeded, and exception is - thrown. - - - - - Gets the document CRC32 checksum if OptionComputeChecksum was set to true before parsing, 0 otherwise. - - - - - Gets the document's declared encoding. - Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node (pre-HTML5) or the meta charset="XXXXX" html node (HTML5). - - - - - Gets the root node of the document. - - - - - Gets the document's output encoding. - - - - - Gets a list of parse errors found in the document. - - - - - Gets the remaining text. - Will always be null if OptionStopperNodeName is null. - - - - - Gets the offset of Remainder in the original Html text. - If OptionStopperNodeName is null, this will return the length of the original Html text. - - - - - Gets the document's stream encoding. - - - - - Gets a valid XML name. - - Any text. - A string that is a valid XML name. - - - - - - - - - - - - - - - - - - - Applies HTML encoding to a specified string. - - The input string to encode. May not be null. - The encoded string. - - - - Determines if the specified character is considered as a whitespace character. - - The character to check. - true if if the specified character is considered as a whitespace character. - - - - Creates an HTML attribute with the specified name. - - The name of the attribute. May not be null. - The new HTML attribute. - - - - Creates an HTML attribute with the specified name. - - The name of the attribute. May not be null. - The value of the attribute. - The new HTML attribute. - - - - Creates an HTML comment node. - - The new HTML comment node. - - - - Creates an HTML comment node with the specified comment text. - - The comment text. May not be null. - The new HTML comment node. - - - - Creates an HTML element node with the specified name. - - The qualified name of the element. May not be null. - The new HTML node. - - - - Creates an HTML text node. - - The new HTML text node. - - - - Creates an HTML text node with the specified text. - - The text of the node. May not be null. - The new HTML text node. - - - - Detects the encoding of an HTML stream. - - The input stream. May not be null. - The detected encoding. - - - - Detects the encoding of an HTML stream. - - The input stream. May not be null. - The html is checked. - The detected encoding. - - - - Detects the encoding of an HTML text provided on a TextReader. - - The TextReader used to feed the HTML. May not be null. - The detected encoding. - - - - Detects the encoding of an HTML text. - - The input html text. May not be null. - The detected encoding. - - - - Gets the HTML node with the specified 'id' attribute value. - - The attribute id to match. May not be null. - The HTML node with the matching id or null if not found. - - - - Loads an HTML document from a stream. - - The input stream. - - - - Loads an HTML document from a stream. - - The input stream. - Indicates whether to look for byte order marks at the beginning of the stream. - - - - Loads an HTML document from a stream. - - The input stream. - The character encoding to use. - - - - Loads an HTML document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the stream. - - - - Loads an HTML document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the stream. - The minimum buffer size. - - - - Loads the HTML document from the specified TextReader. - - The TextReader used to feed the HTML data into the document. May not be null. - - - - Loads the HTML document from the specified string. - - String containing the HTML document to load. May not be null. - - - - Saves the HTML document to the specified stream. - - The stream to which you want to save. - - - - Saves the HTML document to the specified stream. - - The stream to which you want to save. May not be null. - The character encoding to use. May not be null. - - - - Saves the HTML document to the specified StreamWriter. - - The StreamWriter to which you want to save. - - - - Saves the HTML document to the specified TextWriter. - - The TextWriter to which you want to save. May not be null. - - - - Saves the HTML document to the specified XmlWriter. - - The XmlWriter to which you want to save. - - - - Detects the encoding of an HTML document from a file first, and then loads the file. - - The complete file path to be read. - - - - Detects the encoding of an HTML document from a file first, and then loads the file. - - The complete file path to be read. May not be null. - true to detect encoding, false otherwise. - - - - Detects the encoding of an HTML file. - - Path for the file containing the HTML document to detect. May not be null. - The detected encoding. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - The character encoding to use. May not be null. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - The character encoding to use. May not be null. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads an HTML document from a file. - - The complete file path to be read. May not be null. - The character encoding to use. May not be null. - Indicates whether to look for byte order marks at the beginning of the file. - The minimum buffer size. - - - - Saves the mixed document to the specified file. - - The location of the file where you want to save the document. - - - - Saves the mixed document to the specified file. - - The location of the file where you want to save the document. May not be null. - The character encoding to use. May not be null. - - - - Creates a new XPathNavigator object for navigating this HTML document. - - An XPathNavigator object. The XPathNavigator is positioned on the root of the document. - - - - Flags that describe the behavior of an Element node. - - - - - The node is a CDATA node. - - - - - The node is empty. META or IMG are example of such nodes. - - - - - The node will automatically be closed during parsing. - - - - - The node can overlap. - - - - - A utility class to replace special characters by entities and vice-versa. - Follows HTML 4.0 specification found at http://www.w3.org/TR/html4/sgml/entities.html - Follows Additional specification found at https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references - See also: https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references - - - - - - - - - - A collection of entities indexed by name. - - - - - A collection of entities indexed by value. - - - - - Replace known entities by characters. - - The source text. - The result text. - - - - Clone and entitize an HtmlNode. This will affect attribute values and nodes' text. It will also entitize all child nodes. - - The node to entitize. - An entitized cloned node. - - - - Replace characters above 127 by entities. - - The source text. - The result text. - - - - Replace characters above 127 by entities. - - The source text. - If set to false, the function will not use known entities name. Default is true. - The result text. - - - - Replace characters above 127 by entities. - - The source text. - If set to false, the function will not use known entities name. Default is true. - If set to true, the [quote], [ampersand], [lower than] and [greather than] characters will be entitized. - The result text - - - - Represents an HTML node. - - - - - Gets the name of a comment node. It is actually defined as '#comment'. - - - - - Gets the name of the document node. It is actually defined as '#document'. - - - - - Gets the name of a text node. It is actually defined as '#text'. - - - - - Gets a collection of flags that define specific behaviors for specific element nodes. - The table contains a DictionaryEntry list with the lowercase tag name as the Key, and a combination of HtmlElementFlags as the Value. - - - - - Initialize HtmlNode. Builds a list of all tags that have special allowances - - - - - Initializes HtmlNode, providing type, owner and where it exists in a collection - - - - - - - - Gets the collection of HTML attributes for this node. May not be null. - - - - - Gets all the children of the node. - - - - - Gets a value indicating if this node has been closed or not. - - - - - Gets the collection of HTML attributes for the closing tag. May not be null. - - - - - Gets the closing tag of the node, null if the node is self-closing. - - - - - Gets the first child of the node. - - - - - Gets a value indicating whether the current node has any attributes. - - - - - Gets a value indicating whether this node has any child nodes. - - - - - Gets a value indicating whether the current node has any attributes on the closing tag. - - - - - Gets or sets the value of the 'id' HTML attribute. The document must have been parsed using the OptionUseIdAttribute set to true. - - - - - Gets or Sets the HTML between the start and end tags of the object. - - - - - Gets the text between the start and end tags of the object. - - - - Gets direct inner text. - The direct inner text. - - - - Gets the last child of the node. - - - - - Gets the line number of this node in the document. - - - - - Gets the column number of this node in the document. - - - - - Gets the stream position of the area between the opening and closing tag of the node, relative to the start of the document. - - - - - Gets the stream position of the area of the beginning of the tag, relative to the start of the document. - - - - - Gets the length of the area between the opening and closing tag of the node. - - - - - Gets the length of the entire node, opening and closing tag included. - - - - - Gets or sets this node's name. - - - - - Gets the HTML node immediately following this element. - - - - - Gets the type of this node. - - - - - The original unaltered name of the tag - - - - - Gets or Sets the object and its content in HTML. - - - - - Gets the to which this node belongs. - - - - - Gets the parent of this node (for nodes that can have parents). - - - - - Gets the node immediately preceding this node. - - - - - Gets the stream position of this node in the document, relative to the start of the document. - - - - - Gets a valid XPath string that points to this node - - - - - The depth of the node relative to the opening root html element. This value is used to determine if a document has to many nested html nodes which can cause stack overflows - - - - - Determines if an element node can be kept overlapped. - - The name of the element node to check. May not be null. - true if the name is the name of an element node that can be kept overlapped, false otherwise. - - - - Creates an HTML node from a string representing literal HTML. - - The HTML text. - The newly created node instance. - - - - Creates an HTML node from a string representing literal HTML. - - The HTML text. - The HTML Document builder. - The newly created node instance. - - - - Determines if an element node is a CDATA element node. - - The name of the element node to check. May not be null. - true if the name is the name of a CDATA element node, false otherwise. - - - - Determines if an element node is closed. - - The name of the element node to check. May not be null. - true if the name is the name of a closed element node, false otherwise. - - - - Determines if an element node is defined as empty. - - The name of the element node to check. May not be null. - true if the name is the name of an empty element node, false otherwise. - - - - Determines if a text corresponds to the closing tag of an node that can be kept overlapped. - - The text to check. May not be null. - true or false. - - - - Returns a collection of all ancestor nodes of this element. - - - - - - Get Ancestors with matching name - - - - - - - Returns a collection of all ancestor nodes of this element. - - - - - - Gets all anscestor nodes and the current node - - - - - - - Adds the specified node to the end of the list of children of this node. - - The node to add. May not be null. - The node added. - - - Sets child nodes identifier. - The chil node. - - - - Adds the specified node to the end of the list of children of this node. - - The node list to add. May not be null. - - - - Gets all Attributes with name - - - - - - - Creates a duplicate of the node - - - - - - Creates a duplicate of the node and changes its name at the same time. - - The new name of the cloned node. May not be null. - The cloned node. - - - - Creates a duplicate of the node and changes its name at the same time. - - The new name of the cloned node. May not be null. - true to recursively clone the subtree under the specified node; false to clone only the node itself. - The cloned node. - - - - Creates a duplicate of the node. - - true to recursively clone the subtree under the specified node; false to clone only the node itself. - The cloned node. - - - - Creates a duplicate of the node and the subtree under it. - - The node to duplicate. May not be null. - - - - Creates a duplicate of the node. - - The node to duplicate. May not be null. - true to recursively clone the subtree under the specified node, false to clone only the node itself. - - - - Gets all Descendant nodes for this node and each of child nodes - - The depth level of the node to parse in the html tree - the current element as an HtmlNode - - - - Returns a collection of all descendant nodes of this element, in document order - - - - - - Gets all Descendant nodes in enumerated list - - - - - - Gets all Descendant nodes in enumerated list - - - - - - Get all descendant nodes with matching name - - - - - - - Returns a collection of all descendant nodes of this element, in document order - - - - - - Gets all descendant nodes including this node - - - - - - - Gets first generation child node matching name - - - - - - - Gets matching first generation child nodes matching name - - - - - - Gets data attribute. - The key. - The data attribute. - - - Gets the data attributes in this collection. - - An enumerator that allows foreach to be used to process the data attributes in this - collection. - - - - Gets the attributes in this collection. - - An enumerator that allows foreach to be used to process the attributes in this collection. - - - - Gets the attributes in this collection. - A variable-length parameters list containing attribute names. - - An enumerator that allows foreach to be used to process the attributes in this collection. - - - - - Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. - - The name of the attribute to get. May not be null. - The default value to return if not found. - The value of the attribute if found, the default value if not found. - - - - Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. - - The name of the attribute to get. May not be null. - The default value to return if not found. - The value of the attribute if found, the default value if not found. - - - - Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. - - The name of the attribute to get. May not be null. - The default value to return if not found. - The value of the attribute if found, the default value if not found. - - - - Helper method to get the value of an attribute of this node. If the attribute is not found, - the default value will be returned. - - The name of the attribute to get. May not be null. - The default value to return if not found. - The value of the attribute if found, the default value if not found. - - - - Inserts the specified node immediately after the specified reference node. - - The node to insert. May not be null. - The node that is the reference node. The newNode is placed after the refNode. - The node being inserted. - - - - Inserts the specified node immediately before the specified reference node. - - The node to insert. May not be null. - The node that is the reference node. The newChild is placed before this node. - The node being inserted. - - - - Adds the specified node to the beginning of the list of children of this node. - - The node to add. May not be null. - The node added. - - - - Adds the specified node list to the beginning of the list of children of this node. - - The node list to add. May not be null. - - - - Removes node from parent collection - - - - - Removes all the children and/or attributes of the current node. - - - - - Removes all the children of the current node. - - - - Removes all id for node described by node. - The node. - - - Move a node already associated and append it to this node instead. - The child node to move. - - - Move a children collection already associated and append it to this node instead. - The children collection already associated to move to another node. - - - Removes the children collection for this node. - The old children collection to remove. - - - - Removes the specified child node. - - The node being removed. May not be null. - The node removed. - - - - Removes the specified child node. - - The node being removed. May not be null. - true to keep grand children of the node, false otherwise. - The node removed. - - - - Replaces the child node oldChild with newChild node. - - The new node to put in the child list. - The node being replaced in the list. - The node replaced. - - - - Helper method to set the value of an attribute of this node. If the attribute is not found, it will be created automatically. - - The name of the attribute to set. May not be null. - The value for the attribute. - The corresponding attribute instance. - - - - Saves all the children of the node to the specified TextWriter. - - The TextWriter to which you want to save. - Identifies the level we are in starting at root with 0 - - - - Saves all the children of the node to a string. - - The saved string. - - - - Saves the current node to the specified TextWriter. - - The TextWriter to which you want to save. - identifies the level we are in starting at root with 0 - - - - Saves the current node to the specified XmlWriter. - - The XmlWriter to which you want to save. - - - - Saves the current node to a string. - - The saved string. - - - - Sets the parent Html node and properly determines the current node's depth using the parent node's depth. - - - - - Adds one or more classes to this node. - - The node list to add. May not be null. - - - - Adds one or more classes to this node. - - The node list to add. May not be null. - true to throw Error if class name exists, false otherwise. - - - - Removes the class attribute from the node. - - - - - Removes the class attribute from the node. - - true to throw Error if class name doesn't exist, false otherwise. - - - - Removes the specified class from the node. - - The class being removed. May not be null. - - - - Removes the specified class from the node. - - The class being removed. May not be null. - true to throw Error if class name doesn't exist, false otherwise. - - - - Replaces the class name oldClass with newClass name. - - The new class name. - The class being replaced. - - - - Replaces the class name oldClass with newClass name. - - The new class name. - The class being replaced. - true to throw Error if class name doesn't exist, false otherwise. - - - Gets the CSS Class from the node. - - The CSS Class from the node - - - - Check if the node class has the parameter class. - The class. - True if node class has the parameter class, false if not. - - - - Fill an object and go through it's properties and fill them too. - - Type of object to want to fill. It should have atleast one property that defined XPath. - Returns an object of type T including Encapsulated data. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - - - - Fill an object and go through it's properties and fill them too. - - Type of object to want to fill. It should have atleast one property that defined XPath. - If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. - Returns an object of type T including Encapsulated data. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - - - - Fill an object and go through it's properties and fill them too. - - Type of object to want to fill. It should have atleast one property that defined XPath. - If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. - Returns an object of type targetType including Encapsulated data. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - Why it's thrown. - - - - Creates a new XPathNavigator object for navigating this HTML node. - - An XPathNavigator object. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document. - - - - Creates an XPathNavigator using the root of this document. - - - - - - Selects a list of nodes matching the expression. - - The XPath expression. - An containing a collection of nodes matching the query, or null if no node matched the XPath expression. - - - - Selects a list of nodes matching the expression. - - The XPath expression. - An containing a collection of nodes matching the query, or null if no node matched the XPath expression. - - - - Selects the first XmlNode that matches the XPath expression. - - The XPath expression. May not be null. - The first that matches the XPath query or a null reference if no matching node was found. - - - - Selects a list of nodes matching the expression. - - The XPath expression. - An containing a collection of nodes matching the query, or null if no node matched the XPath expression. - - - - Includes tools that GetEncapsulatedData method uses them. - - - - - Determine if a type define an attribute or not , supporting both .NetStandard and .NetFramework2.0 - - Type you want to test it. - Attribute that type must have or not. - If true , The type parameter define attributeType parameter. - - - - Retrive properties of type that defined . - - Type that you want to find it's XPath-Defined properties. - IEnumerable of property infos of a type , that defined specific attribute. - - - - Determine if a has implemented BUT is considered as NONE-IEnumerable ! - - The property info you want to test. - True if property info is IEnumerable. - - - - Returns T type(first generic type) of or . - - IEnumerable-Implemented property - List of generic types. - - - - Find and Return a mehtod that defined in a class by it's name. - - Type of class include requested method. - Name of requested method as string. - Method info of requested method. - - - - Create of given type. - - Type that you want to make a List of it. - Returns IList of given type. - - - - Returns the part of value of you want as . - - A htmlNode instance. - Attribute that includes ReturnType - String that choosen from HtmlNode as result. - - - - Returns parts of values of you want as . - - that you want to retrive each value. - A instnce incules . - Type of IList generic you want. - - - - - Simulate Func method to use in Lambada Expression. - - - - - - - - - This method works like Where method in LINQ. - - - - - - - - - Check if the type can instantiated. - - - - - - - Returns count of elements stored in IEnumerable of T - - - - - - - - Specify which part of is requested. - - - - - The text between the start and end tags of the object. - - - - - The HTML between the start and end tags of the object - - - - - The object and its content in HTML - - - - - Just mark and flag classes to show they have properties that defined . - - - - - Includes XPath and . XPath for finding html tags and for specify which part of you want to return. - - - - - XPath Expression that is used to find related html node. - - - - - Html Attribute name - - - - - The methode of output - - - - - Specify Xpath to find related Html Node. - - - - - - Specify Xpath to find related Html Node. - - - Specify you want the output include html text too. - - - - Specify Xpath and Attribute to find related Html Node and its attribute value. - - - - - - - Tagging a property with this Attribute make Encapsulator to ignore that property if it causes an error. - - - - - Exception that often occures when there is no way to bind a XPath to a Html Tag. - - - - - - - - - - - - - - - - - - - - - - - Exception that often occures when there is no way to bind a XPath to a HtmlTag Attribute. - - - - - - - - - - - - - - - - - - - - - - - Exception that often occures when there is no property that assigned with XPath Property in Class. - - - - - - - - - - - - - - - - - - - - - - - Represents a combined list and collection of HTML nodes. - - - - - Initialize the HtmlNodeCollection with the base parent node - - The base node of the collection - - - Gets the parent node associated to the collection. - - - - Gets a given node from the list. - - - - - Get node with tag name - - - - - - - Gets the number of elements actually contained in the list. - - - - - Is collection read only - - - - - Gets the node at the specified index. - - - - - Add node to the collection - - - - - - Add node to the collection - - - - - - - Clears out the collection of HtmlNodes. Removes each nodes reference to parentnode, nextnode and prevnode - - - - - Gets existence of node in collection - - - - - - - Copy collection to array - - - - - - - Get Enumerator - - - - - - Get Explicit Enumerator - - - - - - Get index of node - - - - - - - Insert node at index - - - - - - - Remove node - - - - - - - Remove at index - - - - - - Get first instance of node in supplied collection - - - - - - - - Add node to the end of the collection - - - - - - Get first instance of node with name - - - - - - - Get index of node - - - - - - - Add node to the beginning of the collection - - - - - - Remove node at index - - - - - - - Replace node at index - - - - - - - Get all node descended from this collection - - - - - - Get all node descended from this collection with matching name - - - - - - Gets all first generation elements in collection - - - - - - Gets all first generation elements matching name - - - - - - - All first generation nodes in collection - - - - - - Represents an HTML navigator on an HTML document seen as a data store. - - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - Indicates whether to look for byte order marks at the beginning of the stream. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - The character encoding to use. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the stream. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the stream. - The minimum buffer size. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a TextReader. - - The TextReader used to feed the HTML data into the document. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - The character encoding to use. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. - - The complete file path to be read. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - The minimum buffer size. - - - - Gets the base URI for the current node. - Always returns string.Empty in the case of HtmlNavigator implementation. - - - - - Gets the current HTML document. - - - - - Gets the current HTML node. - - - - - Gets a value indicating whether the current node has child nodes. - - - - - Gets a value indicating whether the current node has child nodes. - - - - - Gets a value indicating whether the current node is an empty element. - - - - - Gets the name of the current HTML node without the namespace prefix. - - - - - Gets the qualified name of the current node. - - - - - Gets the namespace URI (as defined in the W3C Namespace Specification) of the current node. - Always returns string.Empty in the case of HtmlNavigator implementation. - - - - - Gets the associated with this implementation. - - - - - Gets the type of the current node. - - - - - Gets the prefix associated with the current node. - Always returns string.Empty in the case of HtmlNavigator implementation. - - - - - Gets the text value of the current node. - - - - - Gets the xml:lang scope for the current node. - Always returns string.Empty in the case of HtmlNavigator implementation. - - - - - Creates a new HtmlNavigator positioned at the same node as this HtmlNavigator. - - A new HtmlNavigator object positioned at the same node as the original HtmlNavigator. - - - - Gets the value of the HTML attribute with the specified LocalName and NamespaceURI. - - The local name of the HTML attribute. - The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. - The value of the specified HTML attribute. String.Empty or null if a matching attribute is not found or if the navigator is not positioned on an element node. - - - - Returns the value of the namespace node corresponding to the specified local name. - Always returns string.Empty for the HtmlNavigator implementation. - - The local name of the namespace node. - Always returns string.Empty for the HtmlNavigator implementation. - - - - Determines whether the current HtmlNavigator is at the same position as the specified HtmlNavigator. - - The HtmlNavigator that you want to compare against. - true if the two navigators have the same position, otherwise, false. - - - - Moves to the same position as the specified HtmlNavigator. - - The HtmlNavigator positioned on the node that you want to move to. - true if successful, otherwise false. If false, the position of the navigator is unchanged. - - - - Moves to the HTML attribute with matching LocalName and NamespaceURI. - - The local name of the HTML attribute. - The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. - true if the HTML attribute is found, otherwise, false. If false, the position of the navigator does not change. - - - - Moves to the first sibling of the current node. - - true if the navigator is successful moving to the first sibling node, false if there is no first sibling or if the navigator is currently positioned on an attribute node. - - - - Moves to the first HTML attribute. - - true if the navigator is successful moving to the first HTML attribute, otherwise, false. - - - - Moves to the first child of the current node. - - true if there is a first child node, otherwise false. - - - - Moves the XPathNavigator to the first namespace node of the current element. - Always returns false for the HtmlNavigator implementation. - - An XPathNamespaceScope value describing the namespace scope. - Always returns false for the HtmlNavigator implementation. - - - - Moves to the node that has an attribute of type ID whose value matches the specified string. - - A string representing the ID value of the node to which you want to move. This argument does not need to be atomized. - true if the move was successful, otherwise false. If false, the position of the navigator is unchanged. - - - - Moves the XPathNavigator to the namespace node with the specified local name. - Always returns false for the HtmlNavigator implementation. - - The local name of the namespace node. - Always returns false for the HtmlNavigator implementation. - - - - Moves to the next sibling of the current node. - - true if the navigator is successful moving to the next sibling node, false if there are no more siblings or if the navigator is currently positioned on an attribute node. If false, the position of the navigator is unchanged. - - - - Moves to the next HTML attribute. - - - - - - Moves the XPathNavigator to the next namespace node. - Always returns falsefor the HtmlNavigator implementation. - - An XPathNamespaceScope value describing the namespace scope. - Always returns false for the HtmlNavigator implementation. - - - - Moves to the parent of the current node. - - true if there is a parent node, otherwise false. - - - - Moves to the previous sibling of the current node. - - true if the navigator is successful moving to the previous sibling node, false if there is no previous sibling or if the navigator is currently positioned on an attribute node. - - - - Moves to the root node to which the current node belongs. - - - - - Represents the type of a node. - - - - - The root of a document. - - - - - An HTML element. - - - - - An HTML comment. - - - - - A text node is always the child of an element or a document node. - - - - - Represents a parsing error found during document parsing. - - - - - Gets the type of error. - - - - - Gets the line number of this error in the document. - - - - - Gets the column number of this error in the document. - - - - - Gets a description for the error. - - - - - Gets the the full text of the line containing the error. - - - - - Gets the absolute stream position of this error in the document, relative to the start of the document. - - - - - Represents the type of parsing error. - - - - - A tag was not closed. - - - - - A tag was not opened. - - - - - There is a charset mismatch between stream and declared (META) encoding. - - - - - An end tag was not required. - - - - - An end tag is invalid at this position. - - - - - Represents an HTML text node. - - - - - Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. - - - - - Gets or Sets the object and its content in HTML. - - - - - Gets or Sets the text of the node. - - - - - A utility class to get HTML document from HTTP. - - - - - Represents the method that will handle the PostResponse event. - - - - - Represents the method that will handle the PreHandleDocument event. - - - - - Represents the method that will handle the PreRequest event. - - - - - Occurs after an HTTP request has been executed. - - - - - Occurs before an HTML document is handled. - - - - - Occurs before an HTTP request is executed. - - - - - Gets or Sets a value indicating if document encoding must be automatically detected. - - - - - Gets or sets the Encoding used to override the response stream from any web request - - - - - Gets or Sets a value indicating whether to get document only from the cache. - If this is set to true and document is not found in the cache, nothing will be loaded. - - - - - Gets or Sets a value indicating whether to get document from the cache if exists, otherwise from the web - A value indicating whether to get document from the cache if exists, otherwise from the web - - - - - Gets or Sets the cache path. If null, no caching mechanism will be used. - - - - - Gets a value indicating if the last document was retrieved from the cache. - - - - - Gets the last request duration in milliseconds. - - - - - Gets the URI of the Internet resource that actually responded to the request. - - - - - Gets the last request status. - - - - - Gets or Sets the size of the buffer used for memory operations. - - - - - Gets or Sets a value indicating if cookies will be stored. - - - - Gets or sets a value indicating whether redirect should be captured instead of the current location. - True if capture redirect, false if not. - - - - Gets or Sets the User Agent HTTP 1.1 header sent on any webrequest - - - - - Gets or Sets a value indicating whether the caching mechanisms should be used or not. - - - - - Gets the MIME content type for a given path extension. - - The input path extension. - The default content type to return if any error occurs. - The path extension's MIME content type. - - - - Gets the path extension for a given MIME content type. - - The input MIME content type. - The default path extension to return if any error occurs. - The MIME content type's path extension. - - - - Creates an instance of the given type from the specified Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The requested type. - An newly created instance. - - - - Gets an HTML document from an Internet resource and saves it to the specified file. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The location of the file where you want to save the document. - - - - Gets an HTML document from an Internet resource and saves it to the specified file. - Proxy aware - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The location of the file where you want to save the document. - - - - - - Gets an HTML document from an Internet resource and saves it to the specified file. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The location of the file where you want to save the document. - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - - - - Gets an HTML document from an Internet resource and saves it to the specified file. Understands Proxies - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The location of the file where you want to save the document. - - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - - - - - Gets the cache file path for a specified url. - - The url fo which to retrieve the cache path. May not be null. - The cache file path. - - - - Gets an HTML document from an Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - A new HTML document. - - - - Gets an HTML document from an Internet resource. - - The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). - A new HTML document. - - - - Gets an HTML document from an Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - Host to use for Proxy - Port the Proxy is on - User Id for Authentication - Password for Authentication - A new HTML document. - - - - Gets an HTML document from an Internet resource. - - The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). - Host to use for Proxy - Port the Proxy is on - User Id for Authentication - Password for Authentication - A new HTML document. - - - - Loads an HTML document from an Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - A new HTML document. - - - - Loads an HTML document from an Internet resource. - - The requested URL, such as new Uri("http://Myserver/Mypath/Myfile.asp"). - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - A new HTML document. - - - - Loads an HTML document from an Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - Proxy to use with this request - Credentials to use when authenticating - A new HTML document. - - - - Loads an HTML document from an Internet resource. - - The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). - The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. - Proxy to use with this request - Credentials to use when authenticating - A new HTML document. - - - - Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The XmlTextWriter to which you want to save to. - - - - Creates an instance of the given type from the specified Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The URL that specifies the XSLT stylesheet to load. - An containing the namespace-qualified arguments used as input to the transform. - The requested type. - An newly created instance. - - - - Creates an instance of the given type from the specified Internet resource. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The URL that specifies the XSLT stylesheet to load. - An containing the namespace-qualified arguments used as input to the transform. - The requested type. - A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. - An newly created instance. - - - - Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". - The URL that specifies the XSLT stylesheet to load. - An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. - The XmlTextWriter to which you want to save. - - - - Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. - - The requested URL, such as "http://Myserver/Mypath/Myfile.asp". May not be null. - The URL that specifies the XSLT stylesheet to load. - An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. - The XmlTextWriter to which you want to save. - A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. - - - - Represents an exception thrown by the HtmlWeb utility class. - - - - - Creates an instance of the HtmlWebException. - - The exception's message. - - - - Represents a document with mixed code and text. ASP, ASPX, JSP, are good example of such documents. - - - - - Gets or sets the token representing code end. - - - - - Gets or sets the token representing code start. - - - - - Gets or sets the token representing code directive. - - - - - Gets or sets the token representing response write directive. - - - - - Creates a mixed code document instance. - - - - - Gets the code represented by the mixed code document seen as a template. - - - - - Gets the list of code fragments in the document. - - - - - Gets the list of all fragments in the document. - - - - - Gets the encoding of the stream used to read the document. - - - - - Gets the list of text fragments in the document. - - - - - Create a code fragment instances. - - The newly created code fragment instance. - - - - Create a text fragment instances. - - The newly created text fragment instance. - - - - Loads a mixed code document from a stream. - - The input stream. - - - - Loads a mixed code document from a stream. - - The input stream. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads a mixed code document from a stream. - - The input stream. - The character encoding to use. - - - - Loads a mixed code document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads a mixed code document from a stream. - - The input stream. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - The minimum buffer size. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - The character encoding to use. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - - - - Loads a mixed code document from a file. - - The complete file path to be read. - The character encoding to use. - Indicates whether to look for byte order marks at the beginning of the file. - The minimum buffer size. - - - - Loads the mixed code document from the specified TextReader. - - The TextReader used to feed the HTML data into the document. - - - - Loads a mixed document from a text - - The text to load. - - - - Saves the mixed document to the specified stream. - - The stream to which you want to save. - - - - Saves the mixed document to the specified stream. - - The stream to which you want to save. - The character encoding to use. - - - - Saves the mixed document to the specified file. - - The location of the file where you want to save the document. - - - - Saves the mixed document to the specified file. - - The location of the file where you want to save the document. - The character encoding to use. - - - - Saves the mixed document to the specified StreamWriter. - - The StreamWriter to which you want to save. - - - - Saves the mixed document to the specified TextWriter. - - The TextWriter to which you want to save. - - - - Represents a fragment of code in a mixed code document. - - - - - Gets the fragment code text. - - - - - Represents a base class for fragments in a mixed code document. - - - - - Gets the fragement text. - - - - - Gets the type of fragment. - - - - - Gets the line number of the fragment. - - - - - Gets the line position (column) of the fragment. - - - - - Gets the fragment position in the document's stream. - - - - - Represents a list of mixed code fragments. - - - - - Gets the Document - - - - - Gets the number of fragments contained in the list. - - - - - Gets a fragment from the list using its index. - - - - - Gets an enumerator that can iterate through the fragment list. - - - - - Appends a fragment to the list of fragments. - - The fragment to append. May not be null. - - - - Gets an enumerator that can iterate through the fragment list. - - - - - Prepends a fragment to the list of fragments. - - The fragment to append. May not be null. - - - - Remove a fragment from the list of fragments. If this fragment was not in the list, an exception will be raised. - - The fragment to remove. May not be null. - - - - Remove all fragments from the list. - - - - - Remove a fragment from the list of fragments, using its index in the list. - - The index of the fragment to remove. - - - - Represents a fragment enumerator. - - - - - Gets the current element in the collection. - - - - - Gets the current element in the collection. - - - - - Advances the enumerator to the next element of the collection. - - true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. - - - - Sets the enumerator to its initial position, which is before the first element in the collection. - - - - - Represents the type of fragment in a mixed code document. - - - - - The fragment contains code. - - - - - The fragment contains text. - - - - - Represents a fragment of text in a mixed code document. - - - - - Gets the fragment text. - - - - - 给控件增加拖放功能的类 - - - - - 拖放实例 - - - - - 高级拖放事件 - - - - - - - - - - - - - - - - - - - - 使管理员方式运行时支持拖放 - - - - - - 使支持拖放属性 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 网络操作类 - - - - - 通过NetworkInterface读取网卡Mac - - - - - - 通过NetworkInterface读取网卡Mac - - - - - - 根据mac字符串来获取最终的mac地址,可以是各种MAC地址格式,非法的内容将返回null - - - - - - - 远程唤醒 - - - - - - - - 远程唤醒 - - - - - - - - - 消息客户端类 - - - - - 判断当前消息主服务器是否创建成功 - - - - - 最后一次接收消息的时间,可用来判断服务端是否有响应 - - - - - 主句柄 - - - - - 当收到消息时激发 - - - - - 连接上主服务器时触发 - - - - - 收到服务端关闭通知 - - - - - 收到服务端关闭通知，即将关闭 - - - - - 服务端大小改变时激发 - - - - - 实例化客户端 - - 服务端ID - 当前客户端ID,会向服务器报告当前ID - 客户端 - - - - - - - - - 断开服务端连接 - - - - - 发送消息,采用多线程发送 - - - - - - - 向服务端发送心跳包 - - - - - 判断服务端句柄是否存在。 - - - - - - 共享内存 - - - - - 写共享内存 - - 需要映射的文件的字节数量 - 映射对象（简单类型、结构体等） - 文件映射对象的名称 - - - - - 写共享内存 - - 需要映射的文件的字节数量 - 映射对象（简单类型、结构体等） - 文件映射对象的名称 - 发送消息的窗口句柄 - 发送消息 - - - - - 读共享内存 - - - - - - - - 读共享内存 - - - - - - - - 读共享内存 - - - - - - - - - 读共享内存 - - 需要映射的文件的字节数量 - 类型 - 文件映射对象的名称 - 返回读到的映射对象 - - - - 读共享内存 - - 需要映射的文件的字节数量 - 类型 - 文件映射对象的名称 - 返回读到的映射字节数据 - - - - 消息服务器 - - - - - 消息事件 - - - - - - - 大小改变事件 - - - - - - - - 即将关闭事件 - - - - - - - 当收到消息时激发 - - - - - 消息处理类 - - - - - - - - - - - - - - - - - - - - - - - 发送消息,采用单线程发送 - - 要发送到的句柄 - 编号 - 消息内容 - - - - 发送消息，采用多线程发送 - - 要发送到的句柄 - 编号 - 消息内容 - - - - 消息类 - - - - - 是否取消 - - - - - 来源句柄 - - - - - - - - - - 消息文本 - - - - - 需要回复的内容 - - - - - 消息服务端类 - - - - - 判断当前消息主服务器是否创建成功 - - - - - 当收到消息时激发 - - - - - 当收到自定义消息时(非系统消息)激发 - - - - - 有消息客户端发起连接请求时激发 - - - - - 有消息客户端连接成功时激发 - - - - - 有消息客户端断开连接时激发 - - - - - - - 服务端ID,需要唯一性,共客户端识别 - 服务端 - - - - 释放资源 - - - - - 判断是否包含指定客户端 - - - - - - - - - - - - 设置客户端大小 - - - - - 根据客户端ID,获取客户端对象 - - - - - - - 根据客户端句柄,获取客户端对象 - - - - - - - 关闭所有客户端 - - - - - 关闭指定客户端 - - - - - - 关闭指定客户端 - - - - - - 向所有客户端发送消息，单线程 - - - - - - - 向指定客户端发送消息 - - - - - - - - 关闭在指定时间前失去响应的子客户端 - - - - - - 客户端信息 - - - - - 客户端句柄 - - - - - 客户端ID - - - - - 客户端连接时间 - - - - - 心跳时间 - - - - - 数据库引擎 - - - - - 数据库枚举类型 - - - - - Odbc引擎 - - - - - OleDb引擎 - - - - - Oracle引擎 - - - - - MSSQL引擎 - - - - - SQLite引擎 - - - - - MySql引擎 - - - - - 判断DataSet是否包含数据 - - - - - - - 获取首行数据 - - - - - - - 获取第一行第一列的值 - - - - - - - 将DataSet类型转换为RyQuickSQL列表类型 - - - - - - - 将DataSet类型转换为RyQuickSQL列表类型 - - - - - - - - 数据库操作接口 - - - - - 连接数据库 - - - - - - 断开数据库 - - - - - - 获取数量 - - - - - - - - 获取分页语句 - - - - - - - - - 获取分页语句 - - - - - - - - - 获取分页语句 - - - - - - - - - - 获取分页语句 - - - - - - - - - - 添加Parameter参数 - - - - - - - 清空Parameter参数 - - - - - - - 获取Parameter值 - - - - - - 根据RyQuickSQL类来获取Parameter值 - - - - - - - 开始执行事务 - - - - - 提交事务 - - - - - 判断是否包含数据 - - - - - - - - 返回-1000表示该数据库不支持本接口 - - - - - - - 读取数据 - - - - - - - 读取数据 - - - - - - - - 读取数据 - - - - - - - - 根据id号获取数据 - - - - - - - - 执行SQL语句 - - - - - - - - 执行SQL语句 - - - - - - - - 执行SQL语句 - - - 只针对IsAdd为false才生效，where 以后的sql语句 - 是新增还是更新 - - - - - 插入数据库 - - - - - - - 更新数据库 - - - where 以后的sql语句 - - - - - 执行SQL语句 - - - - - - - 根据id号删除数据 - - - - - - - - 创建数据库 - - - - - - - 释放资源 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 连接数据库 - - 数据库连接字符串 - - - - - 连接数据库 - - 数据源 - 数据库名称 - 用户id - 用户密码 - - - - - - - - - 连接数据库 - - - - - - 关闭数据库 - - - - - - 运行SQL命令 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令 - - SQL语句 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 数组第一个默认的值 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 数组第一个默认的值 - 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 判断指定值是否存在 - - 表名 - 指定值所属字段 - 指定值 - 当前id，如果是新增记录，请填写-1 - - - - - 判断SQL语句是否有结果返回 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 判断SQL语句是否有结果返回 - - SQL语句 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 执行SQL语句 - - - 只针对IsAdd为false才生效，where 以后的sql语句 - 是新增还是更新 - - - - - 插入数据库 - - - - - - - 更新数据库 - - - where 以后的sql语句 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SQL字段类型 - - - - - SQL字段类型 - - - - - - - SQL字段类型 - - - - - - - - SQL字段名 - - - - - SQL字段值 - - - - - SQL字段长度 - - - - - 不是真的值，而是用于计算的值 - - - - - SQL快速操作类 - - - - - SQL快速操作类 - - - - - - 表名 - - - - - 操作字段列表 - - - - - 清理使用资源 - - - - - 清理使用资源 - - - - - 清理使用资源 - - - - - 操作参数列表 - - - - - 操作参数列表 - - - - - 添加字符串字段 - - - - - - - 添加null值字段 - - - - - - 添加日期字段 - - - - - - - 添加int字段 - - - - - - - 添加double字段 - - - - - - - 添加decimal字段 - - - - - - - 添加byte[]字段 - - - - - - - 添加bool字段 - - - - - - - 添加用于计算的值 - - - - - - - 添加Int64字段 - - - - - - - 清空内容 - - - - - 数量 - - - - - - - - - - 输出多条件搜索。 - - 字段名,多个字段请用逗号分隔。 - 多个条件之间请用空格隔开 - - - - - 获取插入SQL语句 - - - - - - 获取更新SQL语句 - - - - - - 添加参数 - - - - - - - 获取Ole参数 - - - - - - 获取SQL参数 - - - - - - 一个强类型的资源类，用于查找本地化的字符串等。 - - - - - 返回此类使用的缓存的 ResourceManager 实例。 - - - - - 重写当前线程的 CurrentUICulture 属性，对 - 使用此强类型资源类的所有资源查找执行重写。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - 查找 System.Drawing.Bitmap 类型的本地化资源。 - - - - - Win32 API - - - - - - - - - - WM_COPYDATA消息的主要目的是允许在进程间传递只读数据。 - - - - - 系统通道ID - - - - - 用户通道ID - - - - - 获取消息 - - - - - - - - 发送消息 - - - - - - - - - - 设置父窗口 - - - - - - - - - Http连接操作帮助类 - - - - - - - - - - - - 根据相传入的数据，得到相应页面数据 - - 参数类对象 - 返回HttpResult类型 - - - - 获取数据的并解析的方法 - - - - - - - 设置编码 - - HttpItem - HttpResult - byte[] - - - - 提取网页Byte - - - - - - 为请求准备参数 - - 参数列表 - - - - 设置证书 - - - - - - 设置多个证书 - - - - - - 设置Cookie - - Http参数 - - - - 设置Post数据 - - Http参数 - - - - 设置代理 - - 参数对象 - - - - 回调验证证书问题 - - 流对象 - 证书 - X509Chain - SslPolicyErrors - bool - - - - 通过设置这个属性，可以在发出连接的时候绑定客户端发出连接所使用的IP地址。 - - - - - - - - - Http请求参考类 - - - - - 请求URL必须填写 - - - - - 请求方式默认为GET方式,当为POST方式时必须设置Postdata的值 - - - - - 默认请求超时时间 - - - - - 默认写入Post数据超时间 - - - - - 设置Host的标头信息 - - - - - 获取或设置一个值，该值指示是否与 Internet 资源建立持久性连接默认为true。 - - - - - 请求标头值 默认为text/html, application/xhtml+xml, */* - - - - - 请求返回类型默认 text/html - - - - - 客户端访问信息默认Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0) - - - - - 返回数据编码默认为NUll,可以自动识别,一般为utf-8,gbk,gb2312 - - - - - Post的数据类型 - - - - - Post请求时要发送的字符串Post数据 - - - - - Post请求时要发送的Byte类型的Post数据 - - - - - Cookie对象集合 - - - - - 请求时的Cookie - - - - - 来源地址，上次访问地址 - - - - - 证书绝对路径 - - - - - 设置代理对象，不想使用IE默认配置就设置为Null，而且不要设置ProxyIp - - - - - 是否设置为全文小写，默认为不转化 - - - - - 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 - - - - - 最大连接数 - - - - - 代理Proxy 服务器用户名 - - - - - 代理 服务器密码 - - - - - 代理 服务IP,如果要使用IE代理就设置为ieproxy - - - - - 设置返回类型String和Byte - - - - - header对象 - - - - - 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 - - - - - 获取或设置一个 System.Boolean 值，该值确定是否使用 100-Continue 行为。如果 POST 请求需要 100-Continue 响应，则为 true；否则为 false。默认值为 true。 - - - - - 设置509证书集合 - - - - - 设置或获取Post参数编码,默认的为Default编码 - - - - - Cookie返回类型,默认的是只返回字符串类型 - - - - - 获取或设置请求的身份验证信息。 - - - - - 设置请求将跟随的重定向的最大数目 - - - - - 获取和设置IfModifiedSince，默认为当前日期和时间 - - - - - 设置本地的出口ip和端口 - ] - - item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); - - - - - Http返回参数类 - - - - - Http请求返回的Cookie - - - - - Cookie对象集合 - - - - - 返回的String类型数据 只有ResultType.String时才返回数据，其它情况为空 - - - - - 返回的Byte数组 只有ResultType.Byte时才返回数据，其它情况为空 - - - - - header对象 - - - - - 返回状态说明 - - - - - 返回状态码,默认为OK - - - - - 最后访问的URl - - - - - 获取重定向的URl - - - - - 返回类型 - - - - - 表示只返回字符串 只有Html有数据 - - - - - 表示返回字符串和字节流 ResultByte和Html都有数据返回 - - - - - Post的数据格式默认为string - - - - - 字符串类型，这时编码Encoding可不设置 - - - - - Byte类型，需要设置PostdataByte参数的值编码Encoding可设置为空 - - - - - 传文件，Postdata必须设置为文件的绝对路径，必须设置Encoding的值 - - - - - Cookie返回类型 - - - - - 只返回字符串类型的Cookie - - - - - CookieCollection格式的Cookie集合同时也返回String类型的cookie - - - - - Http服务器类 - - - - - - - - - - - - 当收到Get事件时激发 - - - - - 当收到Post事件时激发 - - - - - 监听的主机,默认是localhost - - - - - 最后一次错误信息 - - - - - 在此端口建立Http服务类 - - 端口号 - - - - - - - - - - 开始服务 - - - - - 退出服务 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 超时时间 - - - - 以post方式获取网页源码 - - - - - - - - - 以post方式提交json内容 - - - - - - - - - 以post方式提交json内容 - - - - - - - - 以post方式获取网页源码 - - - - - - - - - - 以post方式获取网页源码 - - - - - - - - 获取网址对应的文件大小 - - - - - - - 获取网址对应的文件大小 - - - - - - - - 代理 - - - - - - - - - - 获取网页源码 - - - - - - - - 获取网页源码 - - - - - - - - - 获取网页源码 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 将相对网址转换成绝对网址 - - 相对网址 - 当前页面地址 - 转换后的绝对网址 - - - - - - - - - - - - - - url解密 - - - - - - - - url解密,按UTF8方式解密 - - - - - - - Url加密 - - - - - - - - Url加密,按UTF8方式加密 - - - - - - - 解密 - - - - - - - 加密 - - - - - - - - - - - - - - - - - - - - - - - - - url加密,Unicode - - - - - - - - - - - - - - - - - - - - - - Html解码,将html里未转义成功的重新转义。 - - - - - - - 将url里的字段分解成表单字典 - - - - - - - - - 根据表单字段名获取值 - - - - - - - - - AES加密解密类 - - - - - AES加密算法 - - 明文字符串 - 密钥 - 返回加密后的密文字节数组 - - - - AES解密 - - 密文字节数组 - 密钥 - 返回解密后的字符串 - - - - 加密 - - - - - - - - 解码 - - - - - - - - 转换密钥到合法密钥 - - - - - - - Base64编码类 - - - - - 编码 - - - - - - - 把字符串编码成Base64字符串 - - - - - - - - 解码 - - - - - - - MD5和SHA1操作类 - - - - - 计算文件MD5。 - 通过MD5CryptoServiceProvider类中的ComputeHash方法直接传入一个FileStream类实现计算MD5 - 操作简单，代码少，调用即可 - - 文件地址 - MD5Hash - - - - 计算文件MD5。 - 通过HashAlgorithm的TransformBlock方法对流进行叠加运算获得MD5 - 实现稍微复杂，但可使用与传输文件或接收文件时同步计算MD5值 - 可自定义缓冲区大小，计算速度较快 - - 文件地址 - MD5Hash - - - - 获取MD5 - - - - - - - 获取MD5 - - - - - - - 获取SHA1 - - - - - - - 获取SHA1 - - - - - - - 获取HmacSHA1 - - - - - - - - 获取SHA256 - - - - - - - 获取HmacSHA256 - - - - - - - - 获取SHA224 - - - - - - - 获取SHA512 - - - - - - - 获取HmacSHA512 - - - - - - - 使用using代替lock操作的对象,可指定写入和读取锁定模式 - - - - 利用IDisposable的using语法糖方便的释放锁定操作 - 内部类 - - - - 读写锁对象 - - - - 是否为写入模式 - - - - 利用IDisposable的using语法糖方便的释放锁定操作 - 构造函数 - - 读写锁 - 写入模式为true,读取模式为false - - - 释放对象时退出指定锁定模式 - - - - 空的可释放对象,免去了调用时需要判断是否为null的问题 - 内部类 - - - - 空的可释放对象 - - - - 空的释放方法 - - - - 读写锁 - - - - 保存数据 - - - - 使用using代替lock操作的对象,可指定写入和读取锁定模式 - 构造函数 - - - - 使用using代替lock操作的对象,可指定写入和读取锁定模式 - 构造函数 - 为Data属性设置初始值 - - - - 获取或设置当前对象中保存数据的值 - - 获取数据时未进入读取或写入锁定模式 - 设置数据时未进入写入锁定模式 - - - 是否启用,当该值为false时,Read()和Write()方法将返回 Disposable.Empty - - - - 进入读取锁定模式,该模式下允许多个读操作同时进行 - 退出读锁请将返回对象释放,建议使用using语块 - Enabled为false时,返回Disposable.Empty; - 在读取或写入锁定模式下重复执行,返回Disposable.Empty; - - - - 进入写入锁定模式,该模式下只允许同时执行一个读操作 - 退出读锁请将返回对象释放,建议使用using语块 - Enabled为false时,返回Disposable.Empty; - 在写入锁定模式下重复执行,返回Disposable.Empty; - - 读取模式下不能进入写入锁定状态 - - - - 中国农历类,最大支持公元0-9999年 - - 日期：2019-02-09 - 作者：http://www.cnblogs.com/zjfree/ - - - - 日历类型 - - - - - 无效 - - - - - Julian 日历 - - - - - Gregorian 日历 - - - - - 有效 - - - - - 公历节日 - - - - - 农历节日 - - - - - 某个月第n个星期几 - - - - - 获取农历 - - - - - - - 获取农历 - - - - - - - - - 获得某农历年的闰月，返回 1~12 对应一月到十二月，返回 0 表示无闰月 - - - - - - - 农历搜索方向 - - - - - 无效 - - - - - 向上 - - - - - 向下 - - - - - {* 日月食类型， 无， 日食， 月全食， 月偏食 } - - - - - 无 - - - - - 日食 - - - - - 月全食 - - - - - 月偏食 - - - - - {* 月相， 无， 朔， 望} - - - - - 无 - - - - - 朔 - - - - - 望 - - - - - 获得某公历年月日的农历日数和该日月相以及日月食类型和时刻 - - - - - - - - - - - - 获得某公历年月日的农历月数 - - - - - - - - - 获取阳历日期对应的农历日期 - - - - - - - - - - - - - 获得某公历年月日的农历月日和是否闰月的信息 - - - - - - - - - - - - 获得等效标准日数对应的某公历日，倒推而来 - - - - - - - - - - 比较两个农历日期（包括闰月信息），1 大于2返回1、1等于2返回0、1小于2返回-1 - - - - - - - - - - - - - - 获得某农历年月日（加是否闰月）的公历年月日 - 该函数采用反向二分法查找 - - - - - - - - - - - - - 获取农历某一个月的总天数 - - - - - - - - - 获取农历年份，范围约1901-2101年 - - - - - - - 获取农历年份，范围约0-9999年 - - - - - - - - - 获取农历月份，范围约1901-2101年 - - - - - - - 获取农历月份，范围约0-9999年 - - - - - - - - - 获取中文表示的农历月份 - - - - - - - 获取农历日，范围约1901-2101年 - - - - - - - 获取农历日，范围约0-9999年 - - - - - - - - - 获取农历日，范围约0-9999年 - - - - - - - 获取节气，范围约1901-2101年 - - - - - - - 获取节气，范围约0-9999年 - - - - - - - - - 返回y年第n个节气（如小寒为1）的日差天数值（pd取值真假，分别表示平气和定气） - - - - pd取值真假，分别表示平气和定气 - - - - - 获取等效标准日数 - - - - - - - - - 取本月天数，不考虑 1582 年 10 月的特殊情况 - - - - - - - - 获取节气，范围约1901-2101年 - - - - - - - 获取节气，范围约0-9999年 - - - - - - - - - 获取节气 - - - - - - - - - - - - 获取公历节日 - - - - - - - 获取公历节日 - - - - - - - - - 获取指定月份的第n个星期几的节日 - - - - - - - 返回星座，范围约1901-2101年 - - - - - 返回星座，范围约0-9999年 - - - - - 获取农历节日 - - - - - - - - - 获取农历节日 - - - - - - - 判断y年m月(1,2,..,12,下同)d日是Gregorian历还是Julian历（opt=1,2,3分别表示标准日历,Gregorge历和Julian历）,是则返回1，是Julian历则返回0，若是Gregorge历所删去的那10天则返回-1 - - - - - 返回阳历y年m月d日的日差天数（在y年年内所走过的天数，如2000年3月1日为61） - - - - - 返回阳历y年日差天数为x时所对应的月日数（如y=2000，x=274时，返回1001(表示10月1日，即返回100*m+d)） - - - - - 获取指定日期的节气。 - - 要获取的年 - 要获取的月 - - - 立春：立是开始的意思，春是蠢动，表示万物开始有生气，这一天春天开始。 - 雨水：降雨开始，雨水将多。 - 惊蛰：春雷响动，惊动蛰伏地下冬眠的生物，它们将开始出土活动。 - 春分：这是春季九十天的中分点，这一天昼夜相等，所以古代曾称春分秋分为昼夜分。 - 清明：明洁晴朗，气候温暖，草木开始萌发繁茂。 - 谷雨：雨生百谷的意思。雨水增多，适时的降雨对谷物生长很为有利。 - 立夏：夏天开始，万物渐将随温暖的气候而生长。 - 小满：满指籽粒饱满，麦类等夏热作物这时开始结籽灌浆，即将饱满。 - 芒种：有芒作物开始成熟，此时也是秋季作物播种的最繁忙时节。 - 夏至：白天最长，黑夜最短，这一天中午太阳位置最高，日影短至终极，古代又称这一天为日北至或长日至。 - 小暑：暑是炎热，此时还未到达最热。 - 大暑：炎热的程度到达高峰。 - 立秋：秋天开始，植物快成熟了。 - 处暑：处是住的意思，表示暑气到此为止。 - 白露：地面水气凝结为露，色白，是天气开始转凉了。 - 秋分：秋季九十天的中间，这一天昼夜相等，同春分一样，太阳从正东升起正西落下。 - 寒露：水露先白而后寒，是气候将逐渐转冷的意思。 - 霜降：水气开始凝结成霜。 - 立冬：冬是终了，作物收割后要收藏起来的意思，这一天起冬天开始。 - 小雪：开始降雪，但还不多。 - 大雪：雪量由小增大。 - 冬至：这一天中午太阳在天空中位置最低，日影最长，白天最短， 黑夜最长，古代又称短日至或日南至。 - 小寒：冷气积久而为寒，此时尚未冷到顶点。 - 大寒：天候达到最寒冷的程度 - - - - - 获取年柱。 - - - - - 获得月柱 - - - - - - - 获取日柱。 - - - - - 返回甲子数x对应的天干数（如33为3） - - - - - 返回甲子数x对应的地支数（如33为9） - - - - - 获取日的天干地支 - - - - - - - 返回甲子数x对应的天干字符串 - - - - - 返回甲子数x对应的地支字符串 - - - - - 返回甲子数x对应的干支字符串 - - - - - - - 获取三伏开始时间 - - - 0表示1伏，1表示2伏，2表示3伏 - - - - - 节气 - - - - - 节气的时间。 - - - - - 节气名。 - - - - - 热键转换类 - - - - - 功能键。 - - - - - 修改键。 - - - - - 转换功能键到谷歌浏览器专用 - - - - - 将chrome功能键转换为普通功能键 - - - - - - - 按键值。 - - - - - 初始化类 的新实例。 - - The modifiers. - The key code. - - - - - - - - - - - - - - - - - 初始化类 的新实例。 - - - - - 加载热键 - - - - - - - 加载热键 - - - - - - 加载热键 - - - - - - 判断是否是热键 - - - - - 获取当前热键 - - - - - 已重载，返回“Ctrl+Alt+A”格式的字符串。 - - 类似“Ctrl+Alt+A”格式的字符串 - - - - 返回“Ctrl+Alt+A”格式的字符串。 - - 类似“Ctrl+Alt+A”格式的字符串 - - - - 功能键 - - - - - 无 - - - - - Alt键 - - - - - Ctrl键 - - - - - Alt+Ctrl键 - - - - - Shift键 - - - - - Shift+Alt键 - - - - - Shift+Ctrl键 - - - - - Alt+Shift+Ctrl键 - - - - - Win键 - - - - - 热键类 - - - - - 热键类 - - - - - - 热键注销 - - - - - 热键是否有效 - - - - - 释放热键 - - - - - 获取热键Tag - - - - - - - 获取热键id - - - - - - - 获取热键id - - - - - - - - 判断热键id是否存在 - - - - - - - 判断热键Tag是否存在 - - - - - - - 判断热键是否存在 - - - - - - - - 注册热键 - - - - - - - - - 注册热键 - - - - - - - - - 注册热键 - - - - - - - - - - 获取热键数量 - - - - - 删除热键 - - - - - - - 删除所有热键 - - - - - 删除所有热键 - - - - - 热键事件 - - - - - - 当使用热键时发生的事件 - - - - - 热键消息过滤 - - - - - - - 热键类型 - - - - - 热键id - - - - - 热键Tag - - - - - 功能键 - - - - - 普通键 - - - - - 热键类型 - - - - - - - - 热键类型 - - - - - - - - - 热键类型 - - - - - - - - - - 结束进程 - - - - - - - - - - - - - - - - - - - - - - - / - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - / - - - - - / - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 删除一个逻辑笔、画笔、字体、位图、区域或者调色板，释放所有与该对象有关的系统资源，在对象被删除之后，指定的句柄也就失效了。 - - - - - - - 选择一对象到指定的设备上下文环境中，该新对象替换先前的相同类型的对象。 - - - - - - - - 创建一个与指定设备兼容的内存设备上下文环境（DC）。 - - - - - - - 为一个设备创建设备上下文环境。 - - - - - - - - - - 删除指定的设备上下文环境（Dc）。 - - - - - - - - - - - - 模拟鼠标点击 - - - - - - - - - - - 模拟按键 - - - - - - - - - 返回hWnd参数所指定的窗口的设备环境。 - - - - - - - 移动窗口 - - - - - - - - - - - - 将消息信息传送给指定的窗口过程的函数。使用函数CallWindowsProc可进行窗口子分类。 - 通常来说，同一类的所有窗口共享一个窗口过程。子类是一个窗口或者相同类的一套窗口， - 在其消息被传送到该类的窗口过程之前，这些消息是由另一个窗口过程进行解释和处理的。 - - - - - - - - - - - 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 - - - - - - - - - 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 - - - - - - - - - 设置弹出式窗口，层叠窗口或子窗口的父窗口 - - - - - - - - 获得一个指定子窗口的父窗口句柄 - - Handle to the window whose parent window handle is to be retrieved. - If the window is a child window, the return value is a handle to the parent window. If the window is a top-level window, the return value is a handle to the owner window. If the window is a top-level unowned window or if the function fails, the return value is NULL. - - - - 获取系统菜单的句柄 - - 拥有窗口菜单拷贝的窗口的句柄 - 标志位，指定将执行的操作 - - - - - 获取系统菜单的句柄 - - 拥有窗口菜单拷贝的窗口的句柄 - 标志位，指定将执行的操作。 - 如果此参数为FALSE，GetSystemMenu返回当前使用窗口菜单的拷贝的句柄。该拷贝初始时与窗口菜单相同，但可以被修改。 - 如果此参数为TRUE，GetSystemMenu重置窗口菜单到缺省状态。如果存在先前的窗口菜单，将被销毁。 - - 如果参数bRevert为FALSE，返回值是窗口菜单的拷贝的句柄：如果参数bRevert为TRUE，返回值是NULL。 - - - - 从指定菜单删除一个菜单项或分离一个子菜单。 - 备注：只要一个菜单被修改，无论它是否在显示窗口里，应用程序都必须调用函数DrawMenuBar。 - - 将被修改的菜单的句柄。 - 指定将被删除的菜单项，其含义由参数wFlags决定。 - - 如果函数调用成功，返回非零值；如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。 - - - - 设置前台窗口 - - - - - - - 获取当前前台窗口句柄 - - - - - - 获得当前活动窗体 - - 活动窗口的句柄。如没有窗口处于活动状态或处于活动状态的窗口非当前线程创建，则返回零。 - - - - 设置活动窗体 - - - - - - - 获取类名 - - - - - - - - - 获取当前线程对应的进程ID - - - - - - - - 判断指定句柄是否是一个窗口 - - - - - - - 获取窗口标题 - - - - - - - - - 发送消息 - - - - - - - - - - 发送消息 - - - - - - - - - - 发送消息 - - - - - - - - - - 发送消息 - - - - - - - - - - 发送消息 - - - - - - - - - 从文件中载入指针 - - - - - - - 判断窗口是否可见 - - - - - - - 查找窗口 - - - - - - - - The FindWindowEx function retrieves a handle to a window whose class name and window name match the specified strings. The function searches child windows, beginning with the one following the specified child window. - - Handle to the parent window whose child windows are to be searched. - Handle to a child window. - Specifies class name. - Pointer to a null-terminated string that specifies the window name (the window's title). - If the function succeeds, the return value is a handle to the window that has the specified class and window names.If the function fails, the return value is NULL. - - - - The InvalidateRect function adds a rectangle to the specified window's update region. - - Handle to window. - Rectangle coordinates. - Erase state. - If the function succeeds, the return value is true.If the function fails, the return value is false. - - - - The ValidateRect function validates the client area within a rectangle by removing the rectangle from the update region of the specified window. - - Handle to window. - Validation rectangle coordinates. - If the function succeeds, the return value is true.If the function fails, the return value is false. - - - - 获取指定窗口的有关信息，也可用于获取窗口内存中指定偏移的32位度整型值。 - - - - - - - - 检索一指定窗口的客户区域或整个屏幕的显示设备上下文环境的句柄，以后可以在GDI函数中使用该句柄来在设备上下文环境中绘图。 - - - - - - - 释放设备上下文环境（DC）供其他应用程序使用。函数的效果与设备上下文环境类型有关。它只释放公用的和设备上下文环境，对于类或私有的则无效。 - - - - - - - - 获取桌面句柄 - - - - - - 获取窗口客户区的大小。注意一下：窗口的客户区为窗口中除标题栏、菜单栏之外的地方。 - - - - - - - - 返回指定窗口的边框矩形的尺寸。该尺寸以相对于屏幕坐标左上角的屏幕坐标给出。 - - - - - - - - 更新一个分层窗口的位置，大小，形状，内容和半透明度 - - - - - - - - - - - - - - - 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 - 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 - - A handle to the window. - A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. - Specifies the new position of the left side of the window, in client coordinates. - Specifies the new position of the top of the window, in client coordinates. - Specifies the new width of the window, in pixels. - Specifies the new height of the window, in pixels. - Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. - If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. - - - - 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 - 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 - - - - - - - - - - - - - 设置指针位置 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 获取或设置是否捕获鼠标 - - - - - 获取或设置是否显示图像信息 - - - - - 获取或设置操作框点的颜色 - - - - - 获取或设置操作框边框颜色 - - - - - 获取或设置放大图形的原始尺寸 - - - - - 获取或设置放大图像的倍数 - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - 获取或设置用于被操作的图像 - - - - - 获取或设置操作框点的颜色 - - - - - 获取或设置操作框线条的颜色 - - - - - 获取当前选中的区域 - - - - - 获取或设置放大图像的原图大小尺寸 - - - - - 获取或设置图像放大的倍数 - - - - - 获取或设置是否绘制操作框点 - - - - - 获取或设置是否限制鼠标操作区域 - - - - - 获取或设置是否绘制信息展示 - - - - - 获取或设置是否根据图像大小自动调整控件尺寸 - - - - - 获取当前是否绘制的有区域 - - - - - 获取当前是否开始绘制 - - - - - 获取当前操作框是否正在移动 - - - - - 获取或设置操作框是否锁定 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 响应四个按键实现精确移动 - - - - - - - - - - - - 绘制操作框 - - - - - - 绘制图像放大信息 - - - - - - 清空所有操作 - - - - - 手动设置一个块选中区域 - - 要选中区域 - - - - 手动设置一个块选中区域 - - 要选中区域的坐标 - 要选中区域的大小 - - - - 手动设置一个块选中区域 - - 要选中区域的x坐标 - 要选中区域的y坐标 - 要选中区域的宽度 - 要选中区域的高度 - - - - 手动设置信息显示的位置 - - 要显示的位置 - - - - 手动设置信息显示的位置 - - 要显示位置的x坐标 - 要显示位置的y坐标 - - - - 获取操作框内的图像 - - 结果图像 - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 鼠标结构信息 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 设置Hook - - - - - - 卸载Hook - - - - - - 鼠标状态枚举值 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 事件参数 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Bin/Release/CommonControls/.NET4/MyDb_MSSQL.dll b/Bin/Release/CommonControls/.NET4/MyDb_MSSQL.dll deleted file mode 100644 index 802a582..0000000 Binary files a/Bin/Release/CommonControls/.NET4/MyDb_MSSQL.dll and /dev/null differ diff --git a/Bin/Release/CommonControls/.NET4/MyDb_MSSQL.xml b/Bin/Release/CommonControls/.NET4/MyDb_MSSQL.xml deleted file mode 100644 index 2602e60..0000000 --- a/Bin/Release/CommonControls/.NET4/MyDb_MSSQL.xml +++ /dev/null @@ -1,348 +0,0 @@ - - - - MyDb_MSSQL - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 连接数据库 - - 数据库连接字符串 - - - - - 连接数据库 - - 数据源 - 数据库名称 - 用户id - 用户密码 - - - - - - - - - 连接数据库 - - - - - - 关闭数据库 - - - - - - 运行SQL命令 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令 - - SQL语句 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 数组第一个默认的值 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 数组第一个默认的值 - 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 判断指定值是否存在 - - 表名 - 指定值所属字段 - 指定值 - 当前id，如果是新增记录，请填写-1 - - - - - 判断SQL语句是否有结果返回 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 判断SQL语句是否有结果返回 - - SQL语句 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Bin/Release/CommonControls/.NET4/MyDb_MySQL.dll b/Bin/Release/CommonControls/.NET4/MyDb_MySQL.dll deleted file mode 100644 index eb98bf2..0000000 Binary files a/Bin/Release/CommonControls/.NET4/MyDb_MySQL.dll and /dev/null differ diff --git a/Bin/Release/CommonControls/.NET4/MyDb_MySQL.xml b/Bin/Release/CommonControls/.NET4/MyDb_MySQL.xml deleted file mode 100644 index 03e8fc1..0000000 --- a/Bin/Release/CommonControls/.NET4/MyDb_MySQL.xml +++ /dev/null @@ -1,372 +0,0 @@ - - - - MyDb_MySQL - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 连接数据库 - - 数据库连接字符串 - - - - - 连接数据库 - - 数据源 - 数据库名称 - 用户id - 用户密码 - - - - - - - - - 连接数据库 - - - - - - 关闭数据库 - - - - - - 运行SQL命令 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令 - - SQL语句 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 数组第一个默认的值 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 数组第一个默认的值 - 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 判断指定值是否存在 - - 表名 - 指定值所属字段 - 指定值 - 当前id，如果是新增记录，请填写-1 - - - - - 判断SQL语句是否有结果返回 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 判断SQL语句是否有结果返回 - - SQL语句 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 执行SQL语句 - - - 只针对IsAdd为false才生效，where 以后的sql语句 - 是新增还是更新 - - - - - 插入数据库 - - - - - - - 更新数据库 - - - where 以后的sql语句 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Bin/Release/CommonControls/.NET4/MyDb_SQLite.dll b/Bin/Release/CommonControls/.NET4/MyDb_SQLite.dll deleted file mode 100644 index cd8754b..0000000 Binary files a/Bin/Release/CommonControls/.NET4/MyDb_SQLite.dll and /dev/null differ diff --git a/Bin/Release/CommonControls/.NET4/MyDb_SQLite.xml b/Bin/Release/CommonControls/.NET4/MyDb_SQLite.xml deleted file mode 100644 index 2fe5ccb..0000000 --- a/Bin/Release/CommonControls/.NET4/MyDb_SQLite.xml +++ /dev/null @@ -1,431 +0,0 @@ - - - - MyDb_SQLite - - - - - - - - - - - - - - - - - - - - - - 数据库路径 - 数据库密码 - - - - - - - 数据库路径 - - - - - - - - - - - - - - - - - - - - 连接数据库 - - - - - - 设置路径和密码 - - - - - - 连接数据库 - - - - - - - - - - - - 连接或创建数据库，如果数据库不存在，就创建，否则连接 - - - - - - 连接或创建数据库，如果数据库不存在，就创建，否则连接 - - - - - - 关闭数据库 - - - - - - 运行SQL命令 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令 - - SQL语句 - 运行失败，则返回-1，否则返回影响的行数 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - SQL命令参数 - 数组第一个默认的值 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 运行失败，则返回null，否则返回以数组显示的字符串 - - - - 运行SQL命令,并返回结果 - - SQL语句 - 数组第一个默认的值 - 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 清空指定表的所有数据 - - 表名 - 运行失败，则返回-1，否则返回影响的行数 - - - - 判断指定值是否存在 - - 表名 - 指定值所属字段 - 指定值 - 当前id，如果是新增记录，请填写-1 - - - - - 判断SQL语句是否有结果返回 - - SQL语句 - SQL命令参数 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 判断SQL语句是否有结果返回 - - SQL语句 - 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 - - - - 创建数据库 - - SQL语句 - - - - - 根据内置例子创建数据库 - - - - - - 保存信息，如果Name不存在，系统会自动创建 - - 返回1，表示成功，0表示失败 - - - - 获取信息 - - - - - - 获取信息 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 执行SQL语句 - - - 只针对IsAdd为false才生效，where 以后的sql语句 - 是新增还是更新 - - - - - 插入数据库 - - - - - - - 更新数据库 - - - where 以后的sql语句 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Bin/Release/CommonControls/.NET4/Newtonsoft.Json.dll b/Bin/Release/CommonControls/.NET4/Newtonsoft.Json.dll new file mode 100644 index 0000000..7af125a Binary files /dev/null and b/Bin/Release/CommonControls/.NET4/Newtonsoft.Json.dll differ diff --git a/Bin/Release/CommonControls/.NET4/Newtonsoft.Json.xml b/Bin/Release/CommonControls/.NET4/Newtonsoft.Json.xml new file mode 100644 index 0000000..0cbf62c --- /dev/null +++ b/Bin/Release/CommonControls/.NET4/Newtonsoft.Json.xml @@ -0,0 +1,9646 @@ + + + + Newtonsoft.Json + + + + + Represents a BSON Oid (object id). + + + + + Gets or sets the value of the Oid. + + The value of the Oid. + + + + Initializes a new instance of the class. + + The Oid value. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. + + + + + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. + + + true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. + + + + + Gets or sets a value indicating whether the root object will be read as a JSON array. + + + true if the root object will be read as a JSON array; otherwise, false. + + + + + Gets or sets the used when reading values from BSON. + + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. + + + + + Gets or sets the used when writing values to BSON. + When set to no conversion will occur. + + The used when writing values to BSON. + + + + Initializes a new instance of the class. + + The to write to. + + + + Initializes a new instance of the class. + + The to write to. + + + + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. + + + + + Writes the end. + + The token. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + + + + Writes the beginning of a JSON array. + + + + + Writes the beginning of a JSON object. + + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value that represents a BSON object id. + + The Object ID value to write. + + + + Writes a BSON regex. + + The regex pattern. + The regex options. + + + + Specifies how constructors are used when initializing objects during deserialization by the . + + + + + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. + + + + + Json.NET will use a non-public default constructor before falling back to a parameterized constructor. + + + + + Converts a binary value to and from a base 64 string value. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Creates a custom object. + + The object type to convert. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Creates an object which will then be populated by the serializer. + + Type of the object. + The created object. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + + + + Provides a base class for converting a to and from JSON. + + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a F# discriminated union type to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an Entity Framework to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). + + + + + Gets or sets the date time styles used when converting a date to and from JSON. + + The date time styles used when converting a date to and from JSON. + + + + Gets or sets the date time format used when converting a date to and from JSON. + + The date time format used when converting a date to and from JSON. + + + + Gets or sets the culture used when converting a date to and from JSON. + + The culture used when converting a date to and from JSON. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from its name string value. + + + + + Gets or sets a value indicating whether the written enum text should be camel case. + The default value is false. + + true if the written enum text will be camel case; otherwise, false. + + + + Gets or sets the naming strategy used to resolve how enum text is written. + + The naming strategy used to resolve how enum text is written. + + + + Gets or sets a value indicating whether integer values are allowed when serializing and deserializing. + The default value is true. + + true if integers are allowed when serializing and deserializing; otherwise, false. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class. + + true if the written enum text will be camel case; otherwise, false. + + + + Initializes a new instance of the class. + + The naming strategy used to resolve how enum text is written. + true if integers are allowed when serializing and deserializing; otherwise, false. + + + + Initializes a new instance of the class. + + The of the used to write enum text. + + + + Initializes a new instance of the class. + + The of the used to write enum text. + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + + Initializes a new instance of the class. + + The of the used to write enum text. + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + true if integers are allowed when serializing and deserializing; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from Unix epoch time + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Converts a to and from a string (e.g. "1.2.3.4"). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts XML to and from JSON. + + + + + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. + + The name of the deserialized root element. + + + + Gets or sets a value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + true if the array attribute is written to the XML; otherwise, false. + + + + Gets or sets a value indicating whether to write the root JSON object. + + true if the JSON root object is omitted; otherwise, false. + + + + Gets or sets a value indicating whether to encode special characters when converting JSON to XML. + If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify + XML namespaces, attributes or processing directives. Instead special characters are encoded and written + as part of the XML element name. + + true if special characters are encoded; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The calling serializer. + The value. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Checks if the is a namespace attribute. + + Attribute name to test. + The attribute name prefix if it has one, otherwise an empty string. + true if attribute name is for a namespace attribute, otherwise false. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + + + + Specifies how dates are formatted when writing JSON text. + + + + + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + + + + + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + + + + + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + + + + + Date formatted strings are not parsed to a date type and are read as strings. + + + + + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + + + + + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + + + + + Specifies how to treat the time value when converting between string and . + + + + + Treat as local time. If the object represents a Coordinated Universal Time (UTC), it is converted to the local time. + + + + + Treat as a UTC. If the object represents a local time, it is converted to a UTC. + + + + + Treat as a local time if a is being converted to a string. + If a string is being converted to , convert to a local time if a time zone is specified. + + + + + Time zone information should be preserved when converting. + + + + + The default JSON name table implementation. + + + + + Initializes a new instance of the class. + + + + + Gets a string containing the same characters as the specified range of characters in the given array. + + The character array containing the name to find. + The zero-based index into the array specifying the first character of the name. + The number of characters in the name. + A string containing the same characters as the specified range of characters in the given array. + + + + Adds the specified string into name table. + + The string to add. + This method is not thread-safe. + The resolved string. + + + + Specifies default value handling options for the . + + + + + + + + + Include members where the member value is the same as the member's default value when serializing objects. + Included members are written to JSON. Has no effect when deserializing. + + + + + Ignore members where the member value is the same as the member's default value when serializing objects + so that it is not written to JSON. + This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, + decimals and floating point numbers; and false for booleans). The default value ignored can be changed by + placing the on the property. + + + + + Members with a default value but no JSON will be set to their default value when deserializing. + + + + + Ignore members where the member value is the same as the member's default value when serializing objects + and set members to their default value when deserializing. + + + + + Specifies float format handling options when writing special floating point numbers, e.g. , + and with . + + + + + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + + + + + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Note that this will produce non-valid JSON. + + + + + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. + + + + + Specifies how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + + + + + Floating point numbers are parsed to . + + + + + Floating point numbers are parsed to . + + + + + Specifies formatting options for the . + + + + + No special formatting is applied. This is the default. + + + + + Causes child objects to be indented according to the and settings. + + + + + Provides an interface for using pooled arrays. + + The array type content. + + + + Rent an array from the pool. This array must be returned when it is no longer needed. + + The minimum required length of the array. The returned array may be longer. + The rented array from the pool. This array must be returned when it is no longer needed. + + + + Return an array to the pool. + + The array that is being returned. + + + + Provides an interface to enable a class to return line and position information. + + + + + Gets a value indicating whether the class can return line information. + + + true if and can be provided; otherwise, false. + + + + + Gets the current line number. + + The current line number or 0 if no line information is available (for example, when returns false). + + + + Gets the current line position. + + The current line position or 0 if no line information is available (for example, when returns false). + + + + Instructs the how to serialize the collection. + + + + + Gets or sets a value indicating whether null items are allowed in the collection. + + true if null items are allowed in the collection; otherwise, false. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a flag indicating whether the array can contain null items. + + A flag indicating whether the array can contain null items. + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Instructs the to use the specified constructor when deserializing that object. + + + + + Instructs the how to serialize the object. + + + + + Gets or sets the id. + + The id. + + + + Gets or sets the title. + + The title. + + + + Gets or sets the description. + + The description. + + + + Gets or sets the collection's items converter. + + The collection's items converter. + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets the of the . + + The of the . + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets a value that indicates whether to preserve object references. + + + true to keep object reference; otherwise, false. The default is false. + + + + + Gets or sets a value that indicates whether to preserve collection's items references. + + + true to keep collection's items object references; otherwise, false. The default is false. + + + + + Gets or sets the reference loop handling used when serializing the collection's items. + + The reference loop handling. + + + + Gets or sets the type name handling used when serializing the collection's items. + + The type name handling. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Provides methods for converting between .NET types and JSON types. + + + + + + + + Gets or sets a function that creates default . + Default settings are automatically used by serialization methods on , + and and on . + To serialize without using any default settings create a with + . + + + + + Represents JavaScript's boolean value true as a string. This field is read-only. + + + + + Represents JavaScript's boolean value false as a string. This field is read-only. + + + + + Represents JavaScript's null as a string. This field is read-only. + + + + + Represents JavaScript's undefined as a string. This field is read-only. + + + + + Represents JavaScript's positive infinity as a string. This field is read-only. + + + + + Represents JavaScript's negative infinity as a string. This field is read-only. + + + + + Represents JavaScript's NaN as a string. This field is read-only. + + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation using the specified. + + The value to convert. + The format the date will be converted to. + The time zone handling when the date is converted to a string. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation using the specified. + + The value to convert. + The format the date will be converted to. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + The string delimiter character. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + The string delimiter character. + The string escape handling. + A JSON string representation of the . + + + + Converts the to its JSON string representation. + + The value to convert. + A JSON string representation of the . + + + + Serializes the specified object to a JSON string. + + The object to serialize. + A JSON string representation of the object. + + + + Serializes the specified object to a JSON string using formatting. + + The object to serialize. + Indicates how the output should be formatted. + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using a collection of . + + The object to serialize. + A collection of converters used while serializing. + A JSON string representation of the object. + + + + Serializes the specified object to a JSON string using formatting and a collection of . + + The object to serialize. + Indicates how the output should be formatted. + A collection of converters used while serializing. + A JSON string representation of the object. + + + + Serializes the specified object to a JSON string using . + + The object to serialize. + The used to serialize the object. + If this is null, default serialization settings will be used. + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using a type, formatting and . + + The object to serialize. + The used to serialize the object. + If this is null, default serialization settings will be used. + + The type of the value being serialized. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using formatting and . + + The object to serialize. + Indicates how the output should be formatted. + The used to serialize the object. + If this is null, default serialization settings will be used. + + A JSON string representation of the object. + + + + + Serializes the specified object to a JSON string using a type, formatting and . + + The object to serialize. + Indicates how the output should be formatted. + The used to serialize the object. + If this is null, default serialization settings will be used. + + The type of the value being serialized. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + A JSON string representation of the object. + + + + + Deserializes the JSON to a .NET object. + + The JSON to deserialize. + The deserialized object from the JSON string. + + + + Deserializes the JSON to a .NET object using . + + The JSON to deserialize. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type. + + The JSON to deserialize. + The of object being deserialized. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type. + + The type of the object to deserialize to. + The JSON to deserialize. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the given anonymous type. + + + The anonymous type to deserialize to. This can't be specified + traditionally and must be inferred from the anonymous type passed + as a parameter. + + The JSON to deserialize. + The anonymous type object. + The deserialized anonymous type from the JSON string. + + + + Deserializes the JSON to the given anonymous type using . + + + The anonymous type to deserialize to. This can't be specified + traditionally and must be inferred from the anonymous type passed + as a parameter. + + The JSON to deserialize. + The anonymous type object. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized anonymous type from the JSON string. + + + + Deserializes the JSON to the specified .NET type using a collection of . + + The type of the object to deserialize to. + The JSON to deserialize. + Converters to use while deserializing. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type using . + + The type of the object to deserialize to. + The object to deserialize. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type using a collection of . + + The JSON to deserialize. + The type of the object to deserialize. + Converters to use while deserializing. + The deserialized object from the JSON string. + + + + Deserializes the JSON to the specified .NET type using . + + The JSON to deserialize. + The type of the object to deserialize to. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + The deserialized object from the JSON string. + + + + Populates the object with values from the JSON string. + + The JSON to populate values from. + The target object to populate values onto. + + + + Populates the object with values from the JSON string using . + + The JSON to populate values from. + The target object to populate values onto. + + The used to deserialize the object. + If this is null, default serialization settings will be used. + + + + + Serializes the to a JSON string. + + The node to serialize. + A JSON string of the . + + + + Serializes the to a JSON string using formatting. + + The node to serialize. + Indicates how the output should be formatted. + A JSON string of the . + + + + Serializes the to a JSON string using formatting and omits the root object if is true. + + The node to serialize. + Indicates how the output should be formatted. + Omits writing the root object. + A JSON string of the . + + + + Deserializes the from a JSON string. + + The JSON string. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by . + + The JSON string. + The name of the root element to append when deserializing. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by , + writes a Json.NET array attribute for collections, and encodes special characters. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + + A value to indicate whether to encode special characters when converting JSON to XML. + If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify + XML namespaces, attributes or processing directives. Instead special characters are encoded and written + as part of the XML element name. + + The deserialized . + + + + Serializes the to a JSON string. + + The node to convert to JSON. + A JSON string of the . + + + + Serializes the to a JSON string using formatting. + + The node to convert to JSON. + Indicates how the output should be formatted. + A JSON string of the . + + + + Serializes the to a JSON string using formatting and omits the root object if is true. + + The node to serialize. + Indicates how the output should be formatted. + Omits writing the root object. + A JSON string of the . + + + + Deserializes the from a JSON string. + + The JSON string. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by . + + The JSON string. + The name of the root element to append when deserializing. + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + The deserialized . + + + + Deserializes the from a JSON string nested in a root element specified by , + writes a Json.NET array attribute for collections, and encodes special characters. + + The JSON string. + The name of the root element to append when deserializing. + + A value to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + + A value to indicate whether to encode special characters when converting JSON to XML. + If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify + XML namespaces, attributes or processing directives. Instead special characters are encoded and written + as part of the XML element name. + + The deserialized . + + + + Converts an object to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can read JSON. + + true if this can read JSON; otherwise, false. + + + + Gets a value indicating whether this can write JSON. + + true if this can write JSON; otherwise, false. + + + + Converts an object to and from JSON. + + The object type to convert. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. If there is no existing value then null will be used. + The existing value has a value. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Instructs the to use the specified when serializing the member or class. + + + + + Gets the of the . + + The of the . + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + + + + + Initializes a new instance of the class. + + Type of the . + + + + Initializes a new instance of the class. + + Type of the . + Parameter list to use when constructing the . Can be null. + + + + Represents a collection of . + + + + + Instructs the how to serialize the collection. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + The exception thrown when an error occurs during JSON serialization or deserialization. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Instructs the to deserialize properties with no matching class member into the specified collection + and write values during serialization. + + + + + Gets or sets a value that indicates whether to write extension data when serializing the object. + + + true to write extension data when serializing the object; otherwise, false. The default is true. + + + + + Gets or sets a value that indicates whether to read extension data when deserializing the object. + + + true to read extension data when deserializing the object; otherwise, false. The default is true. + + + + + Initializes a new instance of the class. + + + + + Instructs the not to serialize the public field or public read/write property value. + + + + + Base class for a table of atomized string objects. + + + + + Gets a string containing the same characters as the specified range of characters in the given array. + + The character array containing the name to find. + The zero-based index into the array specifying the first character of the name. + The number of characters in the name. + A string containing the same characters as the specified range of characters in the given array. + + + + Instructs the how to serialize the object. + + + + + Gets or sets the member serialization. + + The member serialization. + + + + Gets or sets the missing member handling used when deserializing this object. + + The missing member handling. + + + + Gets or sets how the object's properties with null values are handled during serialization and deserialization. + + How the object's properties with null values are handled during serialization and deserialization. + + + + Gets or sets a value that indicates whether the object's properties are required. + + + A value indicating whether the object's properties are required. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified member serialization. + + The member serialization. + + + + Initializes a new instance of the class with the specified container Id. + + The container Id. + + + + Instructs the to always serialize the member with the specified name. + + + + + Gets or sets the type used when serializing the property's collection items. + + The collection's items type. + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets the of the . + + The of the . + + + + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, + order, and type of these parameters. + + + + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + + + + + + Gets or sets the null value handling used when serializing this property. + + The null value handling. + + + + Gets or sets the default value handling used when serializing this property. + + The default value handling. + + + + Gets or sets the reference loop handling used when serializing this property. + + The reference loop handling. + + + + Gets or sets the object creation handling used when deserializing this property. + + The object creation handling. + + + + Gets or sets the type name handling used when serializing this property. + + The type name handling. + + + + Gets or sets whether this property's value is serialized as a reference. + + Whether this property's value is serialized as a reference. + + + + Gets or sets the order of serialization of a member. + + The numeric order of serialization. + + + + Gets or sets a value indicating whether this property is required. + + + A value indicating whether this property is required. + + + + + Gets or sets the name of the property. + + The name of the property. + + + + Gets or sets the reference loop handling used when serializing the property's collection items. + + The collection's items reference loop handling. + + + + Gets or sets the type name handling used when serializing the property's collection items. + + The collection's items type name handling. + + + + Gets or sets whether this property's collection items are serialized as a reference. + + Whether this property's collection items are serialized as a reference. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with the specified name. + + Name of the property. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + + + Specifies the state of the reader. + + + + + A read method has not been called. + + + + + The end of the file has been reached successfully. + + + + + Reader is at a property. + + + + + Reader is at the start of an object. + + + + + Reader is in an object. + + + + + Reader is at the start of an array. + + + + + Reader is in an array. + + + + + The method has been called. + + + + + Reader has just read a value. + + + + + Reader is at the start of a constructor. + + + + + Reader is in a constructor. + + + + + An error occurred that prevents the read operation from continuing. + + + + + The end of the file has been reached successfully. + + + + + Gets the current reader state. + + The current reader state. + + + + Gets or sets a value indicating whether the source should be closed when this reader is closed. + + + true to close the source when this reader is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether multiple pieces of JSON content can + be read from a continuous stream without erroring. + + + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. + + + + + Gets the quotation mark character used to enclose the value of a string. + + + + + Gets or sets how time zones are handled when reading JSON. + + + + + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + + + + + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + + + + + Gets or sets how custom date formatted strings are parsed when reading JSON. + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + + + + + Gets the type of the current JSON token. + + + + + Gets the text value of the current JSON token. + + + + + Gets the .NET type for the current JSON token. + + + + + Gets the depth of the current token in the JSON document. + + The depth of the current token in the JSON document. + + + + Gets the path of the current JSON token. + + + + + Gets or sets the culture used when reading JSON. Defaults to . + + + + + Initializes a new instance of the class. + + + + + Reads the next JSON token from the source. + + true if the next token was read successfully; false if there are no more tokens to read. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a []. + + A [] or null if the next JSON token is null. This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the source as a of . + + A of . This method will return null at the end of an array. + + + + Skips the children of the current token. + + + + + Sets the current token. + + The new token. + + + + Sets the current token and value. + + The new token. + The value. + + + + Sets the current token and value. + + The new token. + The value. + A flag indicating whether the position index inside an array should be updated. + + + + Sets the state based on current token type. + + + + + Releases unmanaged and - optionally - managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Changes the reader's state to . + If is set to true, the source is also closed. + + + + + The exception thrown when an error occurs while reading JSON text. + + + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Initializes a new instance of the class + with a specified error message, JSON path, line number, line position, and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The path to the JSON where the error occurred. + The line number indicating where the error occurred. + The line position indicating where the error occurred. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Instructs the to always serialize the member, and to require that the member has a value. + + + + + The exception thrown when an error occurs during JSON serialization or deserialization. + + + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Initializes a new instance of the class + with a specified error message, JSON path, line number, line position, and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The path to the JSON where the error occurred. + The line number indicating where the error occurred. + The line position indicating where the error occurred. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Serializes and deserializes objects into and from the JSON format. + The enables you to control how objects are encoded into JSON. + + + + + Occurs when the errors during serialization and deserialization. + + + + + Gets or sets the used by the serializer when resolving references. + + + + + Gets or sets the used by the serializer when resolving type names. + + + + + Gets or sets the used by the serializer when resolving type names. + + + + + Gets or sets the used by the serializer when writing trace messages. + + The trace writer. + + + + Gets or sets the equality comparer used by the serializer when comparing references. + + The equality comparer. + + + + Gets or sets how type name writing and reading is handled by the serializer. + The default value is . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how object references are preserved by the serializer. + The default value is . + + + + + Gets or sets how reference loops (e.g. a class referencing itself) is handled. + The default value is . + + + + + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + The default value is . + + + + + Gets or sets how null values are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how default values are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how objects are created during deserialization. + The default value is . + + The object creation handling. + + + + Gets or sets how constructors are used during deserialization. + The default value is . + + The constructor handling. + + + + Gets or sets how metadata properties are used during deserialization. + The default value is . + + The metadata properties handling. + + + + Gets a collection that will be used during serialization. + + Collection that will be used during serialization. + + + + Gets or sets the contract resolver used by the serializer when + serializing .NET objects to JSON and vice versa. + + + + + Gets or sets the used by the serializer when invoking serialization callback methods. + + The context. + + + + Indicates how JSON text output is formatted. + The default value is . + + + + + Gets or sets how dates are written to JSON text. + The default value is . + + + + + Gets or sets how time zones are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + The default value is . + + + + + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + The default value is . + + + + + Gets or sets how special floating point numbers, e.g. , + and , + are written as JSON text. + The default value is . + + + + + Gets or sets how strings are escaped when writing JSON text. + The default value is . + + + + + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. + The default value is "yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK". + + + + + Gets or sets the culture used when reading JSON. + The default value is . + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + A null value means there is no maximum. + The default value is null. + + + + + Gets a value indicating whether there will be a check for additional JSON content after deserializing an object. + The default value is false. + + + true if there will be a check for additional JSON content after deserializing an object; otherwise, false. + + + + + Initializes a new instance of the class. + + + + + Creates a new instance. + The will not use default settings + from . + + + A new instance. + The will not use default settings + from . + + + + + Creates a new instance using the specified . + The will not use default settings + from . + + The settings to be applied to the . + + A new instance using the specified . + The will not use default settings + from . + + + + + Creates a new instance. + The will use default settings + from . + + + A new instance. + The will use default settings + from . + + + + + Creates a new instance using the specified . + The will use default settings + from as well as the specified . + + The settings to be applied to the . + + A new instance using the specified . + The will use default settings + from as well as the specified . + + + + + Populates the JSON values onto the target object. + + The that contains the JSON structure to read values from. + The target object to populate values onto. + + + + Populates the JSON values onto the target object. + + The that contains the JSON structure to read values from. + The target object to populate values onto. + + + + Deserializes the JSON structure contained by the specified . + + The that contains the JSON structure to deserialize. + The being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The of object being deserialized. + The instance of being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The type of the object to deserialize. + The instance of being deserialized. + + + + Deserializes the JSON structure contained by the specified + into an instance of the specified type. + + The containing the object. + The of object being deserialized. + The instance of being deserialized. + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + The type of the value being serialized. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + The type of the value being serialized. + This parameter is used when is Auto to write out the type name if the type of the value does not match. + Specifying the type is optional. + + + + + Serializes the specified and writes the JSON structure + using the specified . + + The used to write the JSON structure. + The to serialize. + + + + Specifies the settings on a object. + + + + + Gets or sets how reference loops (e.g. a class referencing itself) are handled. + The default value is . + + Reference loop handling. + + + + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + The default value is . + + Missing member handling. + + + + Gets or sets how objects are created during deserialization. + The default value is . + + The object creation handling. + + + + Gets or sets how null values are handled during serialization and deserialization. + The default value is . + + Null value handling. + + + + Gets or sets how default values are handled during serialization and deserialization. + The default value is . + + The default value handling. + + + + Gets or sets a collection that will be used during serialization. + + The converters. + + + + Gets or sets how object references are preserved by the serializer. + The default value is . + + The preserve references handling. + + + + Gets or sets how type name writing and reading is handled by the serializer. + The default value is . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + The type name handling. + + + + Gets or sets how metadata properties are used during deserialization. + The default value is . + + The metadata properties handling. + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is . + + The type name assembly format. + + + + Gets or sets how constructors are used during deserialization. + The default value is . + + The constructor handling. + + + + Gets or sets the contract resolver used by the serializer when + serializing .NET objects to JSON and vice versa. + + The contract resolver. + + + + Gets or sets the equality comparer used by the serializer when comparing references. + + The equality comparer. + + + + Gets or sets the used by the serializer when resolving references. + + The reference resolver. + + + + Gets or sets a function that creates the used by the serializer when resolving references. + + A function that creates the used by the serializer when resolving references. + + + + Gets or sets the used by the serializer when writing trace messages. + + The trace writer. + + + + Gets or sets the used by the serializer when resolving type names. + + The binder. + + + + Gets or sets the used by the serializer when resolving type names. + + The binder. + + + + Gets or sets the error handler called during serialization and deserialization. + + The error handler called during serialization and deserialization. + + + + Gets or sets the used by the serializer when invoking serialization callback methods. + + The context. + + + + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. + The default value is "yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK". + + + + + Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . + A null value means there is no maximum. + The default value is null. + + + + + Indicates how JSON text output is formatted. + The default value is . + + + + + Gets or sets how dates are written to JSON text. + The default value is . + + + + + Gets or sets how time zones are handled during serialization and deserialization. + The default value is . + + + + + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + The default value is . + + + + + Gets or sets how special floating point numbers, e.g. , + and , + are written as JSON. + The default value is . + + + + + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + The default value is . + + + + + Gets or sets how strings are escaped when writing JSON text. + The default value is . + + + + + Gets or sets the culture used when reading JSON. + The default value is . + + + + + Gets a value indicating whether there will be a check for additional content after deserializing an object. + The default value is false. + + + true if there will be a check for additional content after deserializing an object; otherwise, false. + + + + + Initializes a new instance of the class. + + + + + Represents a reader that provides fast, non-cached, forward-only access to JSON text data. + + + + + Initializes a new instance of the class with the specified . + + The containing the JSON data to read. + + + + Gets or sets the reader's property name table. + + + + + Gets or sets the reader's character buffer pool. + + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a []. + + A [] or null if the next JSON token is null. This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Gets a value indicating whether the class can return line information. + + + true if and can be provided; otherwise, false. + + + + + Gets the current line number. + + + The current line number or 0 if no line information is available (for example, returns false). + + + + + Gets the current line position. + + + The current line position or 0 if no line information is available (for example, returns false). + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets or sets the writer's character array pool. + + + + + Gets or sets how many s to write for each level in the hierarchy when is set to . + + + + + Gets or sets which character to use to quote attribute values. + + + + + Gets or sets which character to use for indenting when is set to . + + + + + Gets or sets a value indicating whether object names will be surrounded with quotes. + + + + + Initializes a new instance of the class using the specified . + + The to write to. + + + + Flushes whatever is in the buffer to the underlying and also flushes the underlying . + + + + + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes the beginning of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the specified end token. + + The end token to write. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + + + + Writes indent characters. + + + + + Writes the JSON value delimiter. + + + + + Writes an indent space. + + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a value. + + The value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the given white space. + + The string of white space characters. + + + + Specifies the type of JSON token. + + + + + This is returned by the if a read method has not been called. + + + + + An object start token. + + + + + An array start token. + + + + + A constructor start token. + + + + + An object property name. + + + + + A comment. + + + + + Raw JSON. + + + + + An integer. + + + + + A float. + + + + + A string. + + + + + A boolean. + + + + + A null token. + + + + + An undefined token. + + + + + An object end token. + + + + + An array end token. + + + + + A constructor end token. + + + + + A Date. + + + + + Byte data. + + + + + + Represents a reader that provides validation. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Sets an event handler for receiving schema validation errors. + + + + + Gets the text value of the current JSON token. + + + + + + Gets the depth of the current token in the JSON document. + + The depth of the current token in the JSON document. + + + + Gets the path of the current JSON token. + + + + + Gets the quotation mark character used to enclose the value of a string. + + + + + + Gets the type of the current JSON token. + + + + + + Gets the .NET type for the current JSON token. + + + + + + Initializes a new instance of the class that + validates the content returned from the given . + + The to read from while validating. + + + + Gets or sets the schema. + + The schema. + + + + Gets the used to construct this . + + The specified in the constructor. + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a []. + + + A [] or null if the next JSON token is null. + + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets or sets a value indicating whether the destination should be closed when this writer is closed. + + + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. + + + + + Gets the top. + + The top. + + + + Gets the state of the writer. + + + + + Gets the path of the writer. + + + + + Gets or sets a value indicating how JSON text output should be formatted. + + + + + Gets or sets how dates are written to JSON text. + + + + + Gets or sets how time zones are handled when writing JSON text. + + + + + Gets or sets how strings are escaped when writing JSON text. + + + + + Gets or sets how special floating point numbers, e.g. , + and , + are written to JSON text. + + + + + Gets or sets how and values are formatted when writing JSON text. + + + + + Gets or sets the culture used when writing JSON. Defaults to . + + + + + Initializes a new instance of the class. + + + + + Flushes whatever is in the buffer to the destination and also flushes the destination. + + + + + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes the beginning of a JSON object. + + + + + Writes the end of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the end of an array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the end constructor. + + + + + Writes the property name of a name/value pair of a JSON object. + + The name of the property. + + + + Writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + + + + Writes the end of the current JSON object or array. + + + + + Writes the current token and its children. + + The to read the token from. + + + + Writes the current token. + + The to read the token from. + A flag indicating whether the current token's children should be written. + + + + Writes the token and its value. + + The to write. + + The value to write. + A value is only required for tokens that have an associated value, e.g. the property name for . + null can be passed to the method for tokens that don't have a value, e.g. . + + + + + Writes the token. + + The to write. + + + + Writes the specified end token. + + The end token to write. + + + + Writes indent characters. + + + + + Writes the JSON value delimiter. + + + + + Writes an indent space. + + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON without changing the writer's state. + + The raw JSON to write. + + + + Writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a of value. + + The of value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the given white space. + + The string of white space characters. + + + + Releases unmanaged and - optionally - managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Sets the state of the . + + The being written. + The value being written. + + + + The exception thrown when an error occurs while writing JSON text. + + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + Initializes a new instance of the class + with a specified error message, JSON path and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The path to the JSON where the error occurred. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Specifies how JSON comments are handled when loading JSON. + + + + + Ignore comments. + + + + + Load comments as a with type . + + + + + Specifies how duplicate property names are handled when loading JSON. + + + + + Replace the existing value when there is a duplicate property. The value of the last property in the JSON object will be used. + + + + + Ignore the new value when there is a duplicate property. The value of the first property in the JSON object will be used. + + + + + Throw a when a duplicate property is encountered. + + + + + Contains the LINQ to JSON extension methods. + + + + + Returns a collection of tokens that contains the ancestors of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains the ancestors of every token in the source collection. + + + + Returns a collection of tokens that contains every token in the source collection, and the ancestors of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains every token in the source collection, the ancestors of every token in the source collection. + + + + Returns a collection of tokens that contains the descendants of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains the descendants of every token in the source collection. + + + + Returns a collection of tokens that contains every token in the source collection, and the descendants of every token in the source collection. + + The type of the objects in source, constrained to . + An of that contains the source collection. + An of that contains every token in the source collection, and the descendants of every token in the source collection. + + + + Returns a collection of child properties of every object in the source collection. + + An of that contains the source collection. + An of that contains the properties of every object in the source collection. + + + + Returns a collection of child values of every object in the source collection with the given key. + + An of that contains the source collection. + The token key. + An of that contains the values of every token in the source collection with the given key. + + + + Returns a collection of child values of every object in the source collection. + + An of that contains the source collection. + An of that contains the values of every token in the source collection. + + + + Returns a collection of converted child values of every object in the source collection with the given key. + + The type to convert the values to. + An of that contains the source collection. + The token key. + An that contains the converted values of every token in the source collection with the given key. + + + + Returns a collection of converted child values of every object in the source collection. + + The type to convert the values to. + An of that contains the source collection. + An that contains the converted values of every token in the source collection. + + + + Converts the value. + + The type to convert the value to. + A cast as a of . + A converted value. + + + + Converts the value. + + The source collection type. + The type to convert the value to. + A cast as a of . + A converted value. + + + + Returns a collection of child tokens of every array in the source collection. + + The source collection type. + An of that contains the source collection. + An of that contains the values of every token in the source collection. + + + + Returns a collection of converted child tokens of every array in the source collection. + + An of that contains the source collection. + The type to convert the values to. + The source collection type. + An that contains the converted values of every token in the source collection. + + + + Returns the input typed as . + + An of that contains the source collection. + The input typed as . + + + + Returns the input typed as . + + The source collection type. + An of that contains the source collection. + The input typed as . + + + + Represents a collection of objects. + + The type of token. + + + + Gets the of with the specified key. + + + + + + Represents a JSON array. + + + + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified content. + + The contents of the array. + + + + Initializes a new instance of the class with the specified content. + + The contents of the array. + + + + Loads an from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads an from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + + + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + + + + + + Creates a from an object. + + The object that will be used to create . + A with the values of the specified object. + + + + Creates a from an object. + + The object that will be used to create . + The that will be used to read the object. + A with the values of the specified object. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets or sets the at the specified index. + + + + + + Determines the index of a specific item in the . + + The object to locate in the . + + The index of if found in the list; otherwise, -1. + + + + + Inserts an item to the at the specified index. + + The zero-based index at which should be inserted. + The object to insert into the . + + is not a valid index in the . + + + + + Removes the item at the specified index. + + The zero-based index of the item to remove. + + is not a valid index in the . + + + + + Returns an enumerator that iterates through the collection. + + + A of that can be used to iterate through the collection. + + + + + Adds an item to the . + + The object to add to the . + + + + Removes all items from the . + + + + + Determines whether the contains a specific value. + + The object to locate in the . + + true if is found in the ; otherwise, false. + + + + + Copies the elements of the to an array, starting at a particular array index. + + The array. + Index of the array. + + + + Gets a value indicating whether the is read-only. + + true if the is read-only; otherwise, false. + + + + Removes the first occurrence of a specific object from the . + + The object to remove from the . + + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + + + + + Represents a JSON constructor. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets or sets the name of this constructor. + + The constructor name. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified name and content. + + The constructor name. + The contents of the constructor. + + + + Initializes a new instance of the class with the specified name and content. + + The constructor name. + The contents of the constructor. + + + + Initializes a new instance of the class with the specified name. + + The constructor name. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified key. + + The with the specified key. + + + + Loads a from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Represents a token that can contain other tokens. + + + + + Occurs when the list changes or an item in the list changes. + + + + + Occurs before an item is added to the collection. + + + + + Occurs when the items list of the collection has changed, or the collection is reset. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Raises the event. + + The instance containing the event data. + + + + Raises the event. + + The instance containing the event data. + + + + Raises the event. + + The instance containing the event data. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Get the first child token of this token. + + + A containing the first child token of the . + + + + + Get the last child token of this token. + + + A containing the last child token of the . + + + + + Returns a collection of the child tokens of this token, in document order. + + + An of containing the child tokens of this , in document order. + + + + + Returns a collection of the child values of this token, in document order. + + The type to convert the values to. + + A containing the child values of this , in document order. + + + + + Returns a collection of the descendant tokens for this token in document order. + + An of containing the descendant tokens of the . + + + + Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. + + An of containing this token, and all the descendant tokens of the . + + + + Adds the specified content as children of this . + + The content to be added. + + + + Adds the specified content as the first children of this . + + The content to be added. + + + + Creates a that can be used to add tokens to the . + + A that is ready to have content written to it. + + + + Replaces the child nodes of this token with the specified content. + + The content. + + + + Removes the child nodes from this token. + + + + + Merge the specified content into this . + + The content to be merged. + + + + Merge the specified content into this using . + + The content to be merged. + The used to merge the content. + + + + Gets the count of child JSON tokens. + + The count of child JSON tokens. + + + + Represents a collection of objects. + + The type of token. + + + + An empty collection of objects. + + + + + Initializes a new instance of the struct. + + The enumerable. + + + + Returns an enumerator that can be used to iterate through the collection. + + + A that can be used to iterate through the collection. + + + + + Gets the of with the specified key. + + + + + + Determines whether the specified is equal to this instance. + + The to compare with this instance. + + true if the specified is equal to this instance; otherwise, false. + + + + + Determines whether the specified is equal to this instance. + + The to compare with this instance. + + true if the specified is equal to this instance; otherwise, false. + + + + + Returns a hash code for this instance. + + + A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table. + + + + + Represents a JSON object. + + + + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Occurs when a property value changes. + + + + + Occurs when a property value is changing. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the specified content. + + The contents of the object. + + + + Initializes a new instance of the class with the specified content. + + The contents of the object. + + + + Gets the node type for this . + + The type. + + + + Gets an of of this object's properties. + + An of of this object's properties. + + + + Gets a with the specified name. + + The property name. + A with the specified name or null. + + + + Gets the with the specified name. + The exact name will be searched for first and if no matching property is found then + the will be used to match a property. + + The property name. + One of the enumeration values that specifies how the strings will be compared. + A matched with the specified name or null. + + + + Gets a of of this object's property values. + + A of of this object's property values. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets or sets the with the specified property name. + + + + + + Loads a from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + is not valid JSON. + + + + + Loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + is not valid JSON. + + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + is not valid JSON. + + + + + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + is not valid JSON. + + + + + + + + Creates a from an object. + + The object that will be used to create . + A with the values of the specified object. + + + + Creates a from an object. + + The object that will be used to create . + The that will be used to read the object. + A with the values of the specified object. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Gets the with the specified property name. + + Name of the property. + The with the specified property name. + + + + Gets the with the specified property name. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + Name of the property. + One of the enumeration values that specifies how the strings will be compared. + The with the specified property name. + + + + Tries to get the with the specified property name. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + Name of the property. + The value. + One of the enumeration values that specifies how the strings will be compared. + true if a value was successfully retrieved; otherwise, false. + + + + Adds the specified property name. + + Name of the property. + The value. + + + + Determines whether the JSON object has the specified property name. + + Name of the property. + true if the JSON object has the specified property name; otherwise, false. + + + + Removes the property with the specified name. + + Name of the property. + true if item was successfully removed; otherwise, false. + + + + Tries to get the with the specified property name. + + Name of the property. + The value. + true if a value was successfully retrieved; otherwise, false. + + + + Returns an enumerator that can be used to iterate through the collection. + + + A that can be used to iterate through the collection. + + + + + Raises the event with the provided arguments. + + Name of the property. + + + + Raises the event with the provided arguments. + + Name of the property. + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Represents a JSON property. + + + + + Gets the container's children tokens. + + The container's children tokens. + + + + Gets the property name. + + The property name. + + + + Gets or sets the property value. + + The property value. + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Gets the node type for this . + + The type. + + + + Initializes a new instance of the class. + + The property name. + The property content. + + + + Initializes a new instance of the class. + + The property name. + The property content. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Loads a from a . + + A that will be read for the content of the . + A that contains the JSON that was read from the specified . + + + + Loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + A that contains the JSON that was read from the specified . + + + + Represents a view of a . + + + + + Initializes a new instance of the class. + + The name. + + + + When overridden in a derived class, returns whether resetting an object changes its value. + + + true if resetting the component changes its value; otherwise, false. + + The component to test for reset capability. + + + + When overridden in a derived class, gets the current value of the property on a component. + + + The value of a property for a given component. + + The component with the property for which to retrieve the value. + + + + When overridden in a derived class, resets the value for this property of the component to the default value. + + The component with the property value that is to be reset to the default value. + + + + When overridden in a derived class, sets the value of the component to a different value. + + The component with the property value that is to be set. + The new value. + + + + When overridden in a derived class, determines a value indicating whether the value of this property needs to be persisted. + + + true if the property should be persisted; otherwise, false. + + The component with the property to be examined for persistence. + + + + When overridden in a derived class, gets the type of the component this property is bound to. + + + A that represents the type of component this property is bound to. + When the or + + methods are invoked, the object specified might be an instance of this type. + + + + + When overridden in a derived class, gets a value indicating whether this property is read-only. + + + true if the property is read-only; otherwise, false. + + + + + When overridden in a derived class, gets the type of the property. + + + A that represents the type of the property. + + + + + Gets the hash code for the name of the member. + + + + The hash code for the name of the member. + + + + + Represents a raw JSON string. + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class. + + The raw json. + + + + Creates an instance of with the content of the reader's current token. + + The reader. + An instance of with the content of the reader's current token. + + + + Specifies the settings used when loading JSON. + + + + + Initializes a new instance of the class. + + + + + Gets or sets how JSON comments are handled when loading JSON. + The default value is . + + The JSON comment handling. + + + + Gets or sets how JSON line info is handled when loading JSON. + The default value is . + + The JSON line info handling. + + + + Gets or sets how duplicate property names in JSON objects are handled when loading JSON. + The default value is . + + The JSON duplicate property name handling. + + + + Specifies the settings used when merging JSON. + + + + + Initializes a new instance of the class. + + + + + Gets or sets the method used when merging JSON arrays. + + The method used when merging JSON arrays. + + + + Gets or sets how null value properties are merged. + + How null value properties are merged. + + + + Gets or sets the comparison used to match property names while merging. + The exact property name will be searched for first and if no matching property is found then + the will be used to match a property. + + The comparison used to match property names while merging. + + + + Represents an abstract JSON token. + + + + + Gets a comparer that can compare two tokens for value equality. + + A that can compare two nodes for value equality. + + + + Gets or sets the parent. + + The parent. + + + + Gets the root of this . + + The root of this . + + + + Gets the node type for this . + + The type. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Compares the values of two tokens, including the values of all descendant tokens. + + The first to compare. + The second to compare. + true if the tokens are equal; otherwise false. + + + + Gets the next sibling token of this node. + + The that contains the next sibling token. + + + + Gets the previous sibling token of this node. + + The that contains the previous sibling token. + + + + Gets the path of the JSON token. + + + + + Adds the specified content immediately after this token. + + A content object that contains simple content or a collection of content objects to be added after this token. + + + + Adds the specified content immediately before this token. + + A content object that contains simple content or a collection of content objects to be added before this token. + + + + Returns a collection of the ancestor tokens of this token. + + A collection of the ancestor tokens of this token. + + + + Returns a collection of tokens that contain this token, and the ancestors of this token. + + A collection of tokens that contain this token, and the ancestors of this token. + + + + Returns a collection of the sibling tokens after this token, in document order. + + A collection of the sibling tokens after this tokens, in document order. + + + + Returns a collection of the sibling tokens before this token, in document order. + + A collection of the sibling tokens before this token, in document order. + + + + Gets the with the specified key. + + The with the specified key. + + + + Gets the with the specified key converted to the specified type. + + The type to convert the token to. + The token key. + The converted token value. + + + + Get the first child token of this token. + + A containing the first child token of the . + + + + Get the last child token of this token. + + A containing the last child token of the . + + + + Returns a collection of the child tokens of this token, in document order. + + An of containing the child tokens of this , in document order. + + + + Returns a collection of the child tokens of this token, in document order, filtered by the specified type. + + The type to filter the child tokens on. + A containing the child tokens of this , in document order. + + + + Returns a collection of the child values of this token, in document order. + + The type to convert the values to. + A containing the child values of this , in document order. + + + + Removes this token from its parent. + + + + + Replaces this token with the specified token. + + The value. + + + + Writes this token to a . + + A into which this method will write. + A collection of which will be used when writing the token. + + + + Returns the indented JSON for this token. + + + ToString() returns a non-JSON string value for tokens with a type of . + If you want the JSON for all token types then you should use . + + + The indented JSON for this token. + + + + + Returns the JSON for this token using the given formatting and converters. + + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. + The JSON for this token using the given formatting and converters. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to []. + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to of . + + The value. + The result of the conversion. + + + + Performs an explicit conversion from to . + + The value. + The result of the conversion. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from [] to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from to . + + The value to create a from. + The initialized with the specified value. + + + + Performs an implicit conversion from of to . + + The value to create a from. + The initialized with the specified value. + + + + Creates a for this token. + + A that can be used to read this token and its descendants. + + + + Creates a from an object. + + The object that will be used to create . + A with the value of the specified object. + + + + Creates a from an object using the specified . + + The object that will be used to create . + The that will be used when reading the object. + A with the value of the specified object. + + + + Creates an instance of the specified .NET type from the . + + The object type that the token will be deserialized to. + The new object created from the JSON value. + + + + Creates an instance of the specified .NET type from the . + + The object type that the token will be deserialized to. + The new object created from the JSON value. + + + + Creates an instance of the specified .NET type from the using the specified . + + The object type that the token will be deserialized to. + The that will be used when creating the object. + The new object created from the JSON value. + + + + Creates an instance of the specified .NET type from the using the specified . + + The object type that the token will be deserialized to. + The that will be used when creating the object. + The new object created from the JSON value. + + + + Creates a from a . + + A positioned at the token to read into this . + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Creates a from a . + + An positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Load a from a string that contains JSON. + + A that contains JSON. + A populated from the string that contains JSON. + + + + Load a from a string that contains JSON. + + A that contains JSON. + The used to load the JSON. + If this is null, default load settings will be used. + A populated from the string that contains JSON. + + + + Creates a from a . + + A positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Creates a from a . + + A positioned at the token to read into this . + + A that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Selects a using a JSONPath expression. Selects the token that matches the object path. + + + A that contains a JSONPath expression. + + A , or null. + + + + Selects a using a JSONPath expression. Selects the token that matches the object path. + + + A that contains a JSONPath expression. + + A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. + A . + + + + Selects a collection of elements using a JSONPath expression. + + + A that contains a JSONPath expression. + + An of that contains the selected elements. + + + + Selects a collection of elements using a JSONPath expression. + + + A that contains a JSONPath expression. + + A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. + An of that contains the selected elements. + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Creates a new instance of the . All child tokens are recursively cloned. + + A new instance of the . + + + + Adds an object to the annotation list of this . + + The annotation to add. + + + + Get the first annotation object of the specified type from this . + + The type of the annotation to retrieve. + The first annotation object that matches the specified type, or null if no annotation is of the specified type. + + + + Gets the first annotation object of the specified type from this . + + The of the annotation to retrieve. + The first annotation object that matches the specified type, or null if no annotation is of the specified type. + + + + Gets a collection of annotations of the specified type for this . + + The type of the annotations to retrieve. + An that contains the annotations for this . + + + + Gets a collection of annotations of the specified type for this . + + The of the annotations to retrieve. + An of that contains the annotations that match the specified type for this . + + + + Removes the annotations of the specified type from this . + + The type of annotations to remove. + + + + Removes the annotations of the specified type from this . + + The of annotations to remove. + + + + Compares tokens to determine whether they are equal. + + + + + Determines whether the specified objects are equal. + + The first object of type to compare. + The second object of type to compare. + + true if the specified objects are equal; otherwise, false. + + + + + Returns a hash code for the specified object. + + The for which a hash code is to be returned. + A hash code for the specified object. + The type of is a reference type and is null. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + + + Gets the at the reader's current position. + + + + + Initializes a new instance of the class. + + The token to read from. + + + + Initializes a new instance of the class. + + The token to read from. + The initial path of the token. It is prepended to the returned . + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Gets the path of the current JSON token. + + + + + Specifies the type of token. + + + + + No token type has been set. + + + + + A JSON object. + + + + + A JSON array. + + + + + A JSON constructor. + + + + + A JSON object property. + + + + + A comment. + + + + + An integer value. + + + + + A float value. + + + + + A string value. + + + + + A boolean value. + + + + + A null value. + + + + + An undefined value. + + + + + A date value. + + + + + A raw JSON value. + + + + + A collection of bytes value. + + + + + A Guid value. + + + + + A Uri value. + + + + + A TimeSpan value. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + + + Gets the at the writer's current position. + + + + + Gets the token being written. + + The token being written. + + + + Initializes a new instance of the class writing to the given . + + The container being written to. + + + + Initializes a new instance of the class. + + + + + Flushes whatever is in the buffer to the underlying . + + + + + Closes this writer. + If is set to true, the JSON is auto-completed. + + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + + + + + Writes the beginning of a JSON object. + + + + + Writes the beginning of a JSON array. + + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes the end. + + The token. + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Writes a value. + An error will be raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Represents a value in JSON (string, integer, date, etc). + + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Initializes a new instance of the class with the given value. + + The value. + + + + Gets a value indicating whether this token has child tokens. + + + true if this token has child values; otherwise, false. + + + + + Creates a comment with the given value. + + The value. + A comment with the given value. + + + + Creates a string with the given value. + + The value. + A string with the given value. + + + + Creates a null value. + + A null value. + + + + Creates a undefined value. + + A undefined value. + + + + Gets the node type for this . + + The type. + + + + Gets or sets the underlying token value. + + The underlying token value. + + + + Writes this token to a . + + A into which this method will write. + A collection of s which will be used when writing the token. + + + + Indicates whether the current object is equal to another object of the same type. + + + true if the current object is equal to the parameter; otherwise, false. + + An object to compare with this object. + + + + Determines whether the specified is equal to the current . + + The to compare with the current . + + true if the specified is equal to the current ; otherwise, false. + + + + + Serves as a hash function for a particular type. + + + A hash code for the current . + + + + + Returns a that represents this instance. + + + ToString() returns a non-JSON string value for tokens with a type of . + If you want the JSON for all token types then you should use . + + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format. + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format provider. + + A that represents this instance. + + + + + Returns a that represents this instance. + + The format. + The format provider. + + A that represents this instance. + + + + + Returns the responsible for binding operations performed on this object. + + The expression tree representation of the runtime value. + + The to bind this object. + + + + + Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object. + + An object to compare with this instance. + + A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has these meanings: + Value + Meaning + Less than zero + This instance is less than . + Zero + This instance is equal to . + Greater than zero + This instance is greater than . + + + is not of the same type as this instance. + + + + + Specifies how line information is handled when loading JSON. + + + + + Ignore line information. + + + + + Load line information. + + + + + Specifies how JSON arrays are merged together. + + + + Concatenate arrays. + + + Union arrays, skipping items that already exist. + + + Replace all array items. + + + Merge array items together, matched by index. + + + + Specifies how null value properties are merged. + + + + + The content's null value properties will be ignored during merging. + + + + + The content's null value properties will be merged. + + + + + Specifies the member serialization options for the . + + + + + All public members are serialized by default. Members can be excluded using or . + This is the default member serialization mode. + + + + + Only members marked with or are serialized. + This member serialization mode can also be set by marking the class with . + + + + + All public and private fields are serialized. Members can be excluded using or . + This member serialization mode can also be set by marking the class with + and setting IgnoreSerializableAttribute on to false. + + + + + Specifies metadata property handling options for the . + + + + + Read metadata properties located at the start of a JSON object. + + + + + Read metadata properties located anywhere in a JSON object. Note that this setting will impact performance. + + + + + Do not try to read metadata properties. + + + + + Specifies missing member handling options for the . + + + + + Ignore a missing member and do not attempt to deserialize it. + + + + + Throw a when a missing member is encountered during deserialization. + + + + + Specifies null value handling options for the . + + + + + + + + + Include null values when serializing and deserializing objects. + + + + + Ignore null values when serializing and deserializing objects. + + + + + Specifies how object creation is handled by the . + + + + + Reuse existing objects, create new objects when needed. + + + + + Only reuse existing objects. + + + + + Always create new objects. + + + + + Specifies reference handling options for the . + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . + + + + + + + + Do not preserve references when serializing types. + + + + + Preserve references when serializing into a JSON object structure. + + + + + Preserve references when serializing into a JSON array structure. + + + + + Preserve references when serializing. + + + + + Specifies reference loop handling options for the . + + + + + Throw a when a loop is encountered. + + + + + Ignore loop references and do not serialize. + + + + + Serialize loop references. + + + + + Indicating whether a property is required. + + + + + The property is not required. The default state. + + + + + The property must be defined in JSON but can be a null value. + + + + + The property must be defined in JSON and cannot be a null value. + + + + + The property is not required but it cannot be a null value. + + + + + + Contains the JSON schema extension methods. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + + Determines whether the is valid. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + + true if the specified is valid; otherwise, false. + + + + + + Determines whether the is valid. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + When this method returns, contains any error messages generated while validating. + + true if the specified is valid; otherwise, false. + + + + + + Validates the specified . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + + + + + Validates the specified . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + The source to test. + The schema to test with. + The validation event handler. + + + + + An in-memory representation of a JSON Schema. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets or sets the id. + + + + + Gets or sets the title. + + + + + Gets or sets whether the object is required. + + + + + Gets or sets whether the object is read-only. + + + + + Gets or sets whether the object is visible to users. + + + + + Gets or sets whether the object is transient. + + + + + Gets or sets the description of the object. + + + + + Gets or sets the types of values allowed by the object. + + The type. + + + + Gets or sets the pattern. + + The pattern. + + + + Gets or sets the minimum length. + + The minimum length. + + + + Gets or sets the maximum length. + + The maximum length. + + + + Gets or sets a number that the value should be divisible by. + + A number that the value should be divisible by. + + + + Gets or sets the minimum. + + The minimum. + + + + Gets or sets the maximum. + + The maximum. + + + + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). + + A flag indicating whether the value can not equal the number defined by the minimum attribute (). + + + + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). + + A flag indicating whether the value can not equal the number defined by the maximum attribute (). + + + + Gets or sets the minimum number of items. + + The minimum number of items. + + + + Gets or sets the maximum number of items. + + The maximum number of items. + + + + Gets or sets the of items. + + The of items. + + + + Gets or sets a value indicating whether items in an array are validated using the instance at their array position from . + + + true if items are validated using their array position; otherwise, false. + + + + + Gets or sets the of additional items. + + The of additional items. + + + + Gets or sets a value indicating whether additional items are allowed. + + + true if additional items are allowed; otherwise, false. + + + + + Gets or sets whether the array items must be unique. + + + + + Gets or sets the of properties. + + The of properties. + + + + Gets or sets the of additional properties. + + The of additional properties. + + + + Gets or sets the pattern properties. + + The pattern properties. + + + + Gets or sets a value indicating whether additional properties are allowed. + + + true if additional properties are allowed; otherwise, false. + + + + + Gets or sets the required property if this property is present. + + The required property if this property is present. + + + + Gets or sets the a collection of valid enum values allowed. + + A collection of valid enum values allowed. + + + + Gets or sets disallowed types. + + The disallowed types. + + + + Gets or sets the default value. + + The default value. + + + + Gets or sets the collection of that this schema extends. + + The collection of that this schema extends. + + + + Gets or sets the format. + + The format. + + + + Initializes a new instance of the class. + + + + + Reads a from the specified . + + The containing the JSON Schema to read. + The object representing the JSON Schema. + + + + Reads a from the specified . + + The containing the JSON Schema to read. + The to use when resolving schema references. + The object representing the JSON Schema. + + + + Load a from a string that contains JSON Schema. + + A that contains JSON Schema. + A populated from the string that contains JSON Schema. + + + + Load a from a string that contains JSON Schema using the specified . + + A that contains JSON Schema. + The resolver. + A populated from the string that contains JSON Schema. + + + + Writes this schema to a . + + A into which this method will write. + + + + Writes this schema to a using the specified . + + A into which this method will write. + The resolver used. + + + + Returns a that represents the current . + + + A that represents the current . + + + + + + Returns detailed information about the schema exception. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets the line number indicating where the error occurred. + + The line number indicating where the error occurred. + + + + Gets the line position indicating where the error occurred. + + The line position indicating where the error occurred. + + + + Gets the path to the JSON where the error occurred. + + The path to the JSON where the error occurred. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class + with a specified error message. + + The error message that explains the reason for the exception. + + + + Initializes a new instance of the class + with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Initializes a new instance of the class. + + The that holds the serialized object data about the exception being thrown. + The that contains contextual information about the source or destination. + The parameter is null. + The class name is null or is zero (0). + + + + + Generates a from a specified . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets or sets how undefined schemas are handled by the serializer. + + + + + Gets or sets the contract resolver. + + The contract resolver. + + + + Generate a from the specified type. + + The type to generate a from. + A generated from the specified type. + + + + Generate a from the specified type. + + The type to generate a from. + The used to resolve schema references. + A generated from the specified type. + + + + Generate a from the specified type. + + The type to generate a from. + Specify whether the generated root will be nullable. + A generated from the specified type. + + + + Generate a from the specified type. + + The type to generate a from. + The used to resolve schema references. + Specify whether the generated root will be nullable. + A generated from the specified type. + + + + + Resolves from an id. + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets or sets the loaded schemas. + + The loaded schemas. + + + + Initializes a new instance of the class. + + + + + Gets a for the specified reference. + + The id. + A for the specified reference. + + + + + The value types allowed by the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + No type specified. + + + + + String type. + + + + + Float type. + + + + + Integer type. + + + + + Boolean type. + + + + + Object type. + + + + + Array type. + + + + + Null type. + + + + + Any type. + + + + + + Specifies undefined schema Id handling options for the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Do not infer a schema Id. + + + + + Use the .NET type name as the schema Id. + + + + + Use the assembly qualified .NET type name as the schema Id. + + + + + + Returns detailed information related to the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + Gets the associated with the validation error. + + The JsonSchemaException associated with the validation error. + + + + Gets the path of the JSON location where the validation error occurred. + + The path of the JSON location where the validation error occurred. + + + + Gets the text description corresponding to the validation error. + + The text description. + + + + + Represents the callback method that will handle JSON schema validation events and the . + + + JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. + + + + + + A camel case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Resolves member mappings for a type, camel casing property names. + + + + + Initializes a new instance of the class. + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + Used by to resolve a for a given . + + + + + Gets a value indicating whether members are being get and set using dynamic code generation. + This value is determined by the runtime permissions available. + + + true if using dynamic code generation; otherwise, false. + + + + + Gets or sets the default members search flags. + + The default members search flags. + + + + Gets or sets a value indicating whether compiler generated members should be serialized. + + + true if serialized compiler generated members; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore the interface when serializing and deserializing types. + + + true if the interface will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore the attribute when serializing and deserializing types. + + + true if the attribute will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore IsSpecified members when serializing and deserializing types. + + + true if the IsSpecified members will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets a value indicating whether to ignore ShouldSerialize members when serializing and deserializing types. + + + true if the ShouldSerialize members will be ignored when serializing and deserializing types; otherwise, false. + + + + + Gets or sets the naming strategy used to resolve how property names and dictionary keys are serialized. + + The naming strategy used to resolve how property names and dictionary keys are serialized. + + + + Initializes a new instance of the class. + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + Gets the serializable members for the type. + + The type to get serializable members for. + The serializable members for the type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates the constructor parameters. + + The constructor to create properties for. + The type's member properties. + Properties for the given . + + + + Creates a for the given . + + The matching member property. + The constructor parameter. + A created for the given . + + + + Resolves the default for the contract. + + Type of the object. + The contract's default . + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Creates a for the given type. + + Type of the object. + A for the given type. + + + + Determines which contract type is created for the given type. + + Type of the object. + A for the given type. + + + + Creates properties for the given . + + The type to create properties for. + /// The member serialization mode for the type. + Properties for the given . + + + + Creates the used by the serializer to get and set values from a member. + + The member. + The used by the serializer to get and set values from a member. + + + + Creates a for the given . + + The member's parent . + The member to create a for. + A created for the given . + + + + Resolves the name of the property. + + Name of the property. + Resolved name of the property. + + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + + + + Resolves the key of the dictionary. By default is used to resolve dictionary keys. + + Key of the dictionary. + Resolved key of the dictionary. + + + + Gets the resolved name of the property. + + Name of the property. + Name of the property. + + + + The default naming strategy. Property names and dictionary keys are unchanged. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + The default serialization binder used when resolving and loading classes from type names. + + + + + Initializes a new instance of the class. + + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + The type of the object the formatter creates a new instance of. + + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + The type of the object the formatter creates a new instance of. + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + + + Represents a trace writer that writes to the application's instances. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of will exclude messages and include , + and messages. + + + The that will be used to filter the trace messages passed to the writer. + + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Get and set values for a using dynamic methods. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + Provides information surrounding an error. + + + + + Gets the error. + + The error. + + + + Gets the original object that caused the error. + + The original object that caused the error. + + + + Gets the member that caused the error. + + The member that caused the error. + + + + Gets the path of the JSON location where the error occurred. + + The path of the JSON location where the error occurred. + + + + Gets or sets a value indicating whether this is handled. + + true if handled; otherwise, false. + + + + Provides data for the Error event. + + + + + Gets the current object the error event is being raised against. + + The current object the error event is being raised against. + + + + Gets the error context. + + The error context. + + + + Initializes a new instance of the class. + + The current object. + The error context. + + + + Get and set values for a using dynamic methods. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + Provides methods to get attributes. + + + + + Returns a collection of all of the attributes, or an empty collection if there are no attributes. + + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. + + The type of the attributes. + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Used by to resolve a for a given . + + + + + + + + + Resolves the contract for a given type. + + The type to resolve a contract for. + The contract for a given type. + + + + Used to resolve references when serializing and deserializing JSON by the . + + + + + Resolves a reference to its object. + + The serialization context. + The reference to resolve. + The object that was resolved from the reference. + + + + Gets the reference for the specified object. + + The serialization context. + The object to get a reference for. + The reference to the object. + + + + Determines whether the specified object is referenced. + + The serialization context. + The object to test for a reference. + + true if the specified object is referenced; otherwise, false. + + + + + Adds a reference to the specified object. + + The serialization context. + The reference. + The object to reference. + + + + Allows users to control class loading and mandate what class to load. + + + + + When implemented, controls the binding of a serialized object to a type. + + Specifies the name of the serialized object. + Specifies the name of the serialized object + The type of the object the formatter creates a new instance of. + + + + When implemented, controls the binding of a serialized object to a type. + + The type of the object the formatter creates a new instance of. + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + + + Represents a trace writer. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of will exclude messages and include , + and messages. + + The that will be used to filter the trace messages passed to the writer. + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Provides methods to get and set values. + + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + Contract details for a used by the . + + + + + Gets the of the collection items. + + The of the collection items. + + + + Gets a value indicating whether the collection type is a multidimensional array. + + true if the collection type is a multidimensional array; otherwise, false. + + + + Gets or sets the function used to create the object. When set this function will override . + + The function used to create the object. + + + + Gets a value indicating whether the creator has a parameter with the collection values. + + true if the creator has a parameter with the collection values; otherwise, false. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets or sets the default collection items . + + The converter. + + + + Gets or sets a value indicating whether the collection items preserve object references. + + true if collection items preserve object references; otherwise, false. + + + + Gets or sets the collection item reference loop handling. + + The reference loop handling. + + + + Gets or sets the collection item type name handling. + + The type name handling. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Handles serialization callback events. + + The object that raised the callback event. + The streaming context. + + + + Handles serialization error callback events. + + The object that raised the callback event. + The streaming context. + The error context. + + + + Sets extension data for an object during deserialization. + + The object to set extension data on. + The extension data key. + The extension data value. + + + + Gets extension data for an object during serialization. + + The object to set extension data on. + + + + Contract details for a used by the . + + + + + Gets the underlying type for the contract. + + The underlying type for the contract. + + + + Gets or sets the type created during deserialization. + + The type created during deserialization. + + + + Gets or sets whether this type contract is serialized as a reference. + + Whether this type contract is serialized as a reference. + + + + Gets or sets the default for this contract. + + The converter. + + + + Gets the internally resolved for the contract's type. + This converter is used as a fallback converter when no other converter is resolved. + Setting will always override this converter. + + + + + Gets or sets all methods called immediately after deserialization of the object. + + The methods called immediately after deserialization of the object. + + + + Gets or sets all methods called during deserialization of the object. + + The methods called during deserialization of the object. + + + + Gets or sets all methods called after serialization of the object graph. + + The methods called after serialization of the object graph. + + + + Gets or sets all methods called before serialization of the object. + + The methods called before serialization of the object. + + + + Gets or sets all method called when an error is thrown during the serialization of the object. + + The methods called when an error is thrown during the serialization of the object. + + + + Gets or sets the default creator method used to create the object. + + The default creator method used to create the object. + + + + Gets or sets a value indicating whether the default creator is non-public. + + true if the default object creator is non-public; otherwise, false. + + + + Contract details for a used by the . + + + + + Gets or sets the dictionary key resolver. + + The dictionary key resolver. + + + + Gets the of the dictionary keys. + + The of the dictionary keys. + + + + Gets the of the dictionary values. + + The of the dictionary values. + + + + Gets or sets the function used to create the object. When set this function will override . + + The function used to create the object. + + + + Gets a value indicating whether the creator has a parameter with the dictionary values. + + true if the creator has a parameter with the dictionary values; otherwise, false. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets the object's properties. + + The object's properties. + + + + Gets or sets the property name resolver. + + The property name resolver. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets or sets the object constructor. + + The object constructor. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Gets or sets the object member serialization. + + The member object serialization. + + + + Gets or sets the missing member handling used when deserializing this object. + + The missing member handling. + + + + Gets or sets a value that indicates whether the object's properties are required. + + + A value indicating whether the object's properties are required. + + + + + Gets or sets how the object's properties with null values are handled during serialization and deserialization. + + How the object's properties with null values are handled during serialization and deserialization. + + + + Gets the object's properties. + + The object's properties. + + + + Gets a collection of instances that define the parameters used with . + + + + + Gets or sets the function used to create the object. When set this function will override . + This function is called with a collection of arguments which are defined by the collection. + + The function used to create the object. + + + + Gets or sets the extension data setter. + + + + + Gets or sets the extension data getter. + + + + + Gets or sets the extension data value type. + + + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Contract details for a used by the . + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Maps a JSON property to a .NET member or constructor parameter. + + + + + Gets or sets the name of the property. + + The name of the property. + + + + Gets or sets the type that declared this property. + + The type that declared this property. + + + + Gets or sets the order of serialization of a member. + + The numeric order of serialization. + + + + Gets or sets the name of the underlying member or parameter. + + The name of the underlying member or parameter. + + + + Gets the that will get and set the during serialization. + + The that will get and set the during serialization. + + + + Gets or sets the for this property. + + The for this property. + + + + Gets or sets the type of the property. + + The type of the property. + + + + Gets or sets the for the property. + If set this converter takes precedence over the contract converter for the property type. + + The converter. + + + + Gets or sets the member converter. + + The member converter. + + + + Gets or sets a value indicating whether this is ignored. + + true if ignored; otherwise, false. + + + + Gets or sets a value indicating whether this is readable. + + true if readable; otherwise, false. + + + + Gets or sets a value indicating whether this is writable. + + true if writable; otherwise, false. + + + + Gets or sets a value indicating whether this has a member attribute. + + true if has a member attribute; otherwise, false. + + + + Gets the default value. + + The default value. + + + + Gets or sets a value indicating whether this is required. + + A value indicating whether this is required. + + + + Gets a value indicating whether has a value specified. + + + + + Gets or sets a value indicating whether this property preserves object references. + + + true if this instance is reference; otherwise, false. + + + + + Gets or sets the property null value handling. + + The null value handling. + + + + Gets or sets the property default value handling. + + The default value handling. + + + + Gets or sets the property reference loop handling. + + The reference loop handling. + + + + Gets or sets the property object creation handling. + + The object creation handling. + + + + Gets or sets or sets the type name handling. + + The type name handling. + + + + Gets or sets a predicate used to determine whether the property should be serialized. + + A predicate used to determine whether the property should be serialized. + + + + Gets or sets a predicate used to determine whether the property should be deserialized. + + A predicate used to determine whether the property should be deserialized. + + + + Gets or sets a predicate used to determine whether the property should be serialized. + + A predicate used to determine whether the property should be serialized. + + + + Gets or sets an action used to set whether the property has been deserialized. + + An action used to set whether the property has been deserialized. + + + + Returns a that represents this instance. + + + A that represents this instance. + + + + + Gets or sets the converter used when serializing the property's collection items. + + The collection's items converter. + + + + Gets or sets whether this property's collection items are serialized as a reference. + + Whether this property's collection items are serialized as a reference. + + + + Gets or sets the type name handling used when serializing the property's collection items. + + The collection's items type name handling. + + + + Gets or sets the reference loop handling used when serializing the property's collection items. + + The collection's items reference loop handling. + + + + A collection of objects. + + + + + Initializes a new instance of the class. + + The type. + + + + When implemented in a derived class, extracts the key from the specified element. + + The element from which to extract the key. + The key for the specified element. + + + + Adds a object. + + The property to add to the collection. + + + + Gets the closest matching object. + First attempts to get an exact case match of and then + a case insensitive match. + + Name of the property. + A matching property if found. + + + + Gets a property by property name. + + The name of the property to get. + Type property name string comparison. + A matching property if found. + + + + Contract details for a used by the . + + + + + Initializes a new instance of the class. + + The underlying type for the contract. + + + + Lookup and create an instance of the type described by the argument. + + The type to create. + Optional arguments to pass to an initializing constructor of the JsonConverter. + If null, the default constructor is used. + + + + A kebab case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Represents a trace writer that writes to memory. When the trace message limit is + reached then old trace messages will be removed as new messages are added. + + + + + Gets the that will be used to filter the trace messages passed to the writer. + For example a filter level of will exclude messages and include , + and messages. + + + The that will be used to filter the trace messages passed to the writer. + + + + + Initializes a new instance of the class. + + + + + Writes the specified trace level, message and optional exception. + + The at which to write this trace. + The trace message. + The trace exception. This parameter is optional. + + + + Returns an enumeration of the most recent trace messages. + + An enumeration of the most recent trace messages. + + + + Returns a of the most recent trace messages. + + + A of the most recent trace messages. + + + + + A base class for resolving how property names and dictionary keys are serialized. + + + + + A flag indicating whether dictionary keys should be processed. + Defaults to false. + + + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + + + + A flag indicating whether explicitly specified property names, + e.g. a property name customized with a , should be processed. + Defaults to false. + + + + + Gets the serialized name for a given property name. + + The initial property name. + A flag indicating whether the property has had a name explicitly specified. + The serialized property name. + + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + + + + Gets the serialized key for a given dictionary key. + + The initial dictionary key. + The serialized dictionary key. + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Hash code calculation + + + + + + Object equality implementation + + + + + + + Compare to another NamingStrategy + + + + + + + Represents a method that constructs an object. + + The object type to create. + + + + When applied to a method, specifies that the method is called when an error occurs serializing an object. + + + + + Provides methods to get attributes from a , , or . + + + + + Initializes a new instance of the class. + + The instance to get attributes for. This parameter should be a , , or . + + + + Returns a collection of all of the attributes, or an empty collection if there are no attributes. + + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. + + The type of the attributes. + When true, look up the hierarchy chain for the inherited custom attribute. + A collection of s, or an empty collection. + + + + Get and set values for a using reflection. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + + + + A snake case naming strategy. + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + + + + Initializes a new instance of the class. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Specifies how strings are escaped when writing JSON text. + + + + + Only control characters (e.g. newline) are escaped. + + + + + All non-ASCII and control characters (e.g. newline) are escaped. + + + + + HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped. + + + + + Indicates the method that will be used during deserialization for locating and loading assemblies. + + + + + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. + + + + + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. + + + + + Specifies type name handling options for the . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + + + + Do not include the .NET type name when serializing types. + + + + + Include the .NET type name when serializing into a JSON object structure. + + + + + Include the .NET type name when serializing into a JSON array structure. + + + + + Always include the .NET type name when serializing. + + + + + Include the .NET type name when the type of the object being serialized is not the same as its declared type. + Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON + you must specify a root type object with + or . + + + + + Determines whether the collection is null or empty. + + The collection. + + true if the collection is null or empty; otherwise, false. + + + + + Adds the elements of the specified collection to the specified generic . + + The list to add to. + The collection of elements to add. + + + + Converts the value to the specified type. If the value is unable to be converted, the + value is checked whether it assignable to the specified type. + + The value to convert. + The culture to use when converting. + The type to convert or cast the value to. + + The converted type. If conversion was unsuccessful, the initial value + is returned if assignable to the target type. + + + + + Helper method for generating a MetaObject which calls a + specific method on Dynamic that returns a result + + + + + Helper method for generating a MetaObject which calls a + specific method on Dynamic, but uses one of the arguments for + the result. + + + + + Helper method for generating a MetaObject which calls a + specific method on Dynamic, but uses one of the arguments for + the result. + + + + + Returns a Restrictions object which includes our current restrictions merged + with a restriction limiting our type + + + + + Helper class for serializing immutable collections. + Note that this is used by all builds, even those that don't support immutable collections, in case the DLL is GACed + https://github.com/JamesNK/Newtonsoft.Json/issues/652 + + + + + Gets the type of the typed collection's items. + + The type. + The type of the typed collection's items. + + + + Gets the member's underlying type. + + The member. + The underlying type of the member. + + + + Determines whether the property is an indexed property. + + The property. + + true if the property is an indexed property; otherwise, false. + + + + + Gets the member's value on the object. + + The member. + The target object. + The member's value on the object. + + + + Sets the member's value on the target object. + + The member. + The target. + The value. + + + + Determines whether the specified MemberInfo can be read. + + The MemberInfo to determine whether can be read. + /// if set to true then allow the member to be gotten non-publicly. + + true if the specified MemberInfo can be read; otherwise, false. + + + + + Determines whether the specified MemberInfo can be set. + + The MemberInfo to determine whether can be set. + if set to true then allow the member to be set non-publicly. + if set to true then allow the member to be set if read-only. + + true if the specified MemberInfo can be set; otherwise, false. + + + + + Builds a string. Unlike this class lets you reuse its internal buffer. + + + + + Determines whether the string is all white space. Empty string will return false. + + The string to test whether it is all white space. + + true if the string is all white space; otherwise, false. + + + + + Specifies the state of the . + + + + + An exception has been thrown, which has left the in an invalid state. + You may call the method to put the in the Closed state. + Any other method calls result in an being thrown. + + + + + The method has been called. + + + + + An object is being written. + + + + + An array is being written. + + + + + A constructor is being written. + + + + + A property is being written. + + + + + A write method has not been called. + + + + Specifies that an output will not be null even if the corresponding type allows it. + + + Specifies that when a method returns , the parameter will not be null even if the corresponding type allows it. + + + Initializes the attribute with the specified return value condition. + + The return value condition. If the method returns this value, the associated parameter will not be null. + + + + Gets the return value condition. + + + Specifies that an output may be null even if the corresponding type disallows it. + + + Specifies that null is allowed as an input even if the corresponding type disallows it. + + + + Specifies that the method will not return if the associated Boolean parameter is passed the specified value. + + + + + Initializes a new instance of the class. + + + The condition parameter value. Code after the method will be considered unreachable by diagnostics if the argument to + the associated parameter matches this value. + + + + Gets the condition parameter value. + + + diff --git a/Bin/Release/CommonControls/.NET4/OpenXmlPowerTools.dll b/Bin/Release/CommonControls/.NET4/OpenXmlPowerTools.dll new file mode 100644 index 0000000..c225873 Binary files /dev/null and b/Bin/Release/CommonControls/.NET4/OpenXmlPowerTools.dll differ diff --git a/Bin/Release/CommonControls/.NET4/RaUI.dll b/Bin/Release/CommonControls/.NET4/RaUI.dll new file mode 100644 index 0000000..cc9d4ef Binary files /dev/null and b/Bin/Release/CommonControls/.NET4/RaUI.dll differ diff --git a/Bin/Release/CommonControls/.NET4/RaUI.xml b/Bin/Release/CommonControls/.NET4/RaUI.xml new file mode 100644 index 0000000..3d8c4b0 --- /dev/null +++ b/Bin/Release/CommonControls/.NET4/RaUI.xml @@ -0,0 +1,61435 @@ + + + + RaUI + + + + + 基于XML实现的权限类 + + + + + 用户名 + + + + + 用户id + + + + + 密码 + + + + + 权限控制Id + + + + + 用户备注 + + + + + 是否是管理员权限 + + + + + 是否是超级管理员权限 + + + + + 设置权限 + + 权限名称 + 权限值 + 返回是否设置成功 + + + + 获取权限 + + 权限名称 + 默认权限值 + 返回权限值 + + + + 获取权限 + + 权限名称 + 返回权限值 + + + + 批量导入权限 + + 权限相关的内容 + 返回是否执行成功 + + + + 导出权限 + + 返回导出文本 + + + + 清除所有权限 + + 返回是否执行成功 + + + + 字符串字数统计 + + + + + 返回字数统计信息 + + + + + + + 字符串统计信息 + + + + + 汉字数量 + + + + + 英文字母数量 + + + + + 英文单词数量 + + + + + 数字数量(一个数字字符算一个数) + + + + + 数字数量(一串数字算一个数) + + + + + 字节总数(汉字算2个字节) + + + + + 总数(英文单词算一个数，一串数字算一个数) + + + + + 可见字符总数(一个字母算一个数,一个数字算一个数) + + + + + 汉字转拼音静态类,包括功能全拼和缩写，方法全部是静态的 + + + + + 汉字的机内码数组 + + + + + 机内码对应的拼音数组 + + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 转换后的拼音(全拼)字符串 + + + + 把汉字转换成拼音(首拼) + + 汉字字符串 + 转换后的拼音(首拼)字符串 + + + + 把汉字转换成拼音(全拼) + + 汉字字符串 + 用指定字符分隔 + 转换后的拼音(全拼)字符串 + + + + 汉字转拼音缩写 + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串) (小写) (空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (大写) + + 要转换的汉字字符串 + 拼音缩写 + + + + 汉字转拼音缩写 (字符串)(大写)(空格间隔) + + 要转换的汉字字符串 + 拼音缩写 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 取单个字符的拼音声母 + + 要转换的单个汉字 + 拼音声母 + + + + 字符串操作类 + + + + + 字符串转Base64 + + + + + + + Base64转字符串 + + + + + + + 判断是否包含日文平假和片假 + + + + + + + 转换指定字符串为布尔类型 + + + + + 转换指定字符串为Double类型 + + + + + 已重载.计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 已重载.计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定字符串为Int类型 + + + + + 转换指定布尔类型为Int类型,true为1，false为0 + + + + + 判断指定字符串是否是布尔类型 + + + + + 判断指定字符串是否是Double类型 + + + + + 判断指定字符串是否是Int类型 + + + + + 根据年月日转换成日期 + + + + + + + + + 追加字符 + + + + + 获取2个字符串中间的内容,point1为空表示从首位开始算，point2为空表示算到结尾。 + + + + + 判断字符串是否只包含数字或英文 + + + + + + + 判断字符串是否只包含英文 + + + + + + + 判断字符串是否只包含数字 + + + + + + + 判断字符串是否匹配,支持?*通配符 + + 待匹配的字符串 + 匹配的通配符 + + + + + 通配符替换 + + + + + + + + + 支持忽略大小写的替换功能 + + + + + 是否忽略大小写 + + + + + 获取匹配的内容 + + + + + + + + + Json扩展 + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 获取值 + + + + + + + + + 对变量的拓展 + + + + + 替换文本(忽略大小写) + + + 需要替换的内容 + 替换后的内容 + + + + + 替换文本(忽略大小写),可支持通配符 + + + + + 是否是通配符表达式,不是，则普通替换，忽略大小写，是，则启用通配符替换 + + + + + 将颜色转换为Html颜色格式 + + + + + + + 支持忽略大小写的替换文本功能 + + + + + 是否忽略大小写 + + + + + 获取字数信息 + + + + + + + 获取符合要求的第一个结果 + + + + 是否是正则 + + + + + 查找字符串,忽略大小写 + + + + + + + + + 查找字符串,忽略大小写 + + + + + + + + 判断字符串是否是数字或英文 + + + + + + + 判断字符串是否含有日文 + + + + + + + 判断字符串是否是英文 + + + + + + + 判断字符串是否是数字(不同于IsInt,本函数是判断字符串是否只含有数字,对字符串长度没有限制) + + + + + + + 是否在指定范围内 + + + + + + + + + 是否在指定范围内 + + + + + + + + + 转换指定字符串为Int类型 + + + 最小值 + 最大值 + 如果字符串不在范围内，则使用本默认值 + + + + + 转换指定布尔类型到Int类型,true为1，false为0 + + + + + + + 将指定类型转换成整型 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + 将数字转换成字符串,小数点末尾后面不包含0 + + + + + + + + 将指定类型转换成整型 + + + + + + + 将指定类型转换成长整型,如果时间时间类型,则转换为Unix时间戳 + + + + + + + + 转换为Unix时间戳 + + + + + + + 转换为Js时间戳 + + + + + + + 转换为Unix时间戳 + + + + + + + 将指定类型转换成长整型 + + + + + + + 转换指定类型为Double类型 + + + + + + + + 转换指定类型为Double类型 + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + 判断时间是否在指定时间上 + + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + 判断时间是否在指定日期 + + + + + + + + + + 转换DateTime类型到日期时间字符串(例如 2000-01-01 08:08:08) + + + + + + + 转换DateTime类型到日期字符串(例如 2000-01-01) + + + + + + + 转换DateTime类型到日期星期字符串(例如 2000-01-01 星期六) + + + + + + + 转换DateTime类型到Unix时间戳 + + + + + + + 转换Unix时间戳到DateTime类型 + + + + + + + 判断字符串是否与内容匹配 + + + + + + + + 将变量值转换成Double类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换到文件大小字符串 + + + + + + + 转换到文件大小字符串 + + + + + + + 转换指定类型为Decimal类型 + + + + + + + + 将变量值转换成Decimal类型 + + + + + + + 将变量值转换成Decimal类型,如果不在指定区域范围内，则使用默认值 + + + + + + + + + + 转换指定类型为DateTime类型 + + + + + + + + 将变量值转换成DateTime类型 + + + + + + + 转换指定类型为布尔类型 + + + + + + + 追加字符 + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + 获取指定字符串之间的内容 + + + + + + + + + + + + 判断指定字符串是否是Int类型 + + + + + + + 判断指定字符串是否是Double类型 + + + + + + + 判断是否是布尔类型 + + + + + + + 将字符串转换为Base64类型 + + + + + + + 判断字符串是否在指定长度 + + + + + + + + + 判断能否转换成日期格式 + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 根据表单字段名,获取对应的值 + + + + + + + + + 大文件与批量文件操作类,支持中途取消操作,本类需要实例化操作 + + + + + 传输进度 + + 当前传输完成的值 + 全部值,为-1表示无法获取 + 当前传输的百分比,为-1表示无法获取 + 当前下载速度(值为每秒下载的字节数),为-1表示无法获取 + 携带的参数(可选) + + + + 传输失败的事件 + + 错误描述 + 携带的参数(可选) + + + + 文件传输出错 + + + + + 文件传输进度 + + + + + 文件夹传输进度 + + + + + 取消事件 + + + + + 大文件按流复制文件,支持自动创建目标文件夹。 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + 携带的参数(可选) + + + + + 复制文件夹到目标文件夹,不支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持进度事件,支持中途取消 + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹,支持中途取消 + + 源文件夹 + 目标文件夹 + 初始的文件数量 + 总数量,如果不计算,则使用-1 + 操作的数量,包含成功的和失败的 + 携带的参数(可选) + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 获取文件夹中的文件数量 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 获取文件夹的大小 + + 文件夹路径 + 返回文件数量,中途取消则返回-1 + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 文件信息 + + + + + 获取版本号 + + + + + 获取版本号 + + + + + + + 根据版本字符串输出double类型的版本号 + + + + + + + + 比较两个版本号大小 + + + + oldVer小于newVer,返回1,大于则返回-1,相等返回0,不支持则返回-1000 + + + + 从字符串中提取版本号 + + + + + + + 比较版本号 + + + + + + old小于new,返回1,大于则返回-1,相等返回0 + + + + 判断是否是管理员方式运行 + + + + + + Hosts操作类 + + + + + 获取并转换hosts内容 + + hosts内容 + + + + + 获取hosts并转换hosts内容 + + + + + + 追加内容到hosts里 + + 要追加的内容列表，每一行为ip 域名的格式 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + write为true,追加内容到hosts里;为false,判断是否需要追加 + + 要追加的内容列表，每一行为ip 域名的格式 + 是否要写入,如果为false,则只判断是否需要追加,而不写入Hosts文件 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + 要追加的内容 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 追加内容到hosts里 + + ip地址 + 域名 + 0表示无需新增,-1表示添加失败,1表示追加成功 + + + + 从hosts文件里删除内容 + + 要删除的内容 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + 从hosts文件里删除内容 + + ip地址 + 域名 + 0表示无需删除,-1表示添加失败,1表示删除成功 + + + + Host信息 + + + + + IP + + + + + 域名 + + + + + 注释 + + + + + 是否要删除 + + + + + Ini操作类 + + + + + 写入Ini + + + + + + + + + + 获取Ini + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + 声明INI文件的读操作函数 GetPrivateProfileString() + + + + + + + + + + + + 获取所有节点名称(Section) + + 存放节点名称的内存地址,每个节点之间用\0分隔 + 内存大小(characters) + Ini文件 + 内容的实际长度,为0表示没有内容,为nSize-2表示内存大小不够 + + + + 编码 + + + + + Ini操作类 + + + + + + 根据section取所有key和值 + + + + + + + 读取INI文件中指定INI文件中的所有节点名称(Section) + + 所有节点,没有内容返回string[0] + + + + 读取INI文件 + + 段，格式[] + 键 + 返回byte类型的section组或键值组 + + + + 根据section取所有key + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入ini + + + + + + + + 写入Ini + + + + + + + + 读取Ini + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + 读取Ini + + + + + + + + + + + 写入ini + + + + + + + + + 删除Ini的Key + + + + + + + 删除Ini节点 + + + + + + 控件信息 + + + + + id + + + + + 控件对象 + + + + + 控件值类型 + + + + + 默认值 + + + + + 值类型 + + + + + 默认 + + + + + 取列表顺序值 + + + + + 取当前选择的列表值 + + + + + 取对象值 + + + + + 保存的设置类型 + + + + + Ini + + + + + XML + + + + + 对象值 + + + + + 显示的文本 + + + + + 图片序号 + + + + + id + + + + + Tag值 + + + + + 显示文本值 + + + + + + 星期数据 + + + + + 一周的开始时间 + + + + + 一周的结束时间 + + + + + 图片类型 + + + + + Bmp图片 + + + + + Jpeg图片 + + + + + Png图片 + + + + + Gif动态图片 + + + + + Tiff图片 + + + + + 文件操作类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除单个文件。 + + 删除的文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 永久删除单个文件。 + + 永久删除的文件名 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 删除一组文件。 + + 字符串数组，表示一组文件名 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + + + + + 移动一个文件到指定路径下 + + 要移动的文件名 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 移动一组文件到指定的路径下 + + 要移动的文件名数组 + 移动到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + + + + + 复制文件到指定的文件名或路径 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 复制一组文件到指定的路径 + + 要复制的文件名数组 + 复制到的目的路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 大文件多次复制文件 true：复制成功 false：复制失败 + + 原始文件路径 + 复制目标文件路径 + + + + + 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + + 源路径 + 目标路径 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) + + 源文件夹 + 目标文件夹 + 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + + + + 重命名一个文件为新名称，建议您使用更方便的Microsoft.VisualBasic.FileSystem.ReName();替换该方法 + + 要复制的文件名 + 复制到的目的文件名或路径 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 返回错误信息 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码,-200:表示其他异常 + + + + 删除单个或多个文件 + + 删除的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 指示是将文件放入回收站还是永久删除，true-放入回收站，false-永久删除 + 指示是否显示确认对话框，true-显示确认删除对话框，false-不显示确认删除对话框 + 指示是否显示进度对话框，true-显示，false-不显示。该参数当指定永久删除文件时有效 + 反馈错误消息的字符串 + 操作执行结果标识，删除文件成功返回0，否则，返回错误代码 + + + + 移动或复制一个或多个文件到指定路径下 + + 操作类型，是移动操作还是复制操作 + 要移动或复制的文件名，如果是多个文件，文件名之间以字符串结尾符'\0'隔开 + 移动到的目的位置 + 指示是否显示确认对话框，true-显示确认对话框，false-不显示确认对话框 + 指示是否显示进度对话框 + 指示当文件名重复时，是否自动为新文件加上后缀名 + 反馈错误消息的字符串 + 返回移动操作是否成功的标识，成功返回0，失败返回错误代码 + + + + 如果指定文件夹不存在，则创建文件夹 + + + + + + 根据指定文件夹路径,生成一个随机不存在的文件名 + + + 扩展名,比如.jpg + 前缀 + + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 获取一个文件的全名 + + 文件名 + 返回生成文件的完整路径名 + + + + 解释错误代码 + + 代码号 + 返回关于错误代码的文字描述 + + + + 运行文件 + + + + + + + + /运行文件 + + + + + + + + + 运行程序 + + + + + + + 打开文件 + + + + + + + 打开文件夹并定位文件 + + + + + + + 打开网址 + + + + + + + 判断是否为空的文件夹 + + + + + + + 文件或文件夹是否存在 + + + + + + + 判断文件名是否有效 + + + + + + + 转换到有效文件名 + + + + + + + 追加日志 + + + + + + + 追加文件 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + 读取文件内容,可以自动识别文件编码 + + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + 读取文件所有行,可以自动识别文件编码 + + + + + + + + 写入所有文本行到文件,如果文件夹不存在，会自动创建 + + + + + + + + 写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + + 以UTF-8格式写入所有文本到文件,如果文件夹不存在，会自动创建 + + + + + + + 从文件中加载图片,使用本方法，不会导致图片文件被占用。 + + + + + + 获取文件大小 + + + + + + + 添加文件到指定文件夹,会进行自动重命名，并返回重命名后的文件名(含路径) + + 要添加的文件路径 + 要添加到的文件夹 + 是否根据时间进行重命名 + 返回是否成功执行 + 成功执行则返回路径，否则返回空 + + + + 获取文件大小字符串 + + + + + + + 根据文件大小字符串获取长整型表示的文件大小 + + + + + + + 获取文件大小字符串 + + + + + + + 复制内容到剪切板 + + + + + + 添加某个控件为支持拖放属性 + + + + + + + 使管理员方式运行时支持拖放 + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 获取绝对路径 + + + + + + + 获取相对路径 + + + + + + + 获取图标 + + + + + + + + + + + + + + 销毁图标 + + + + + + + 获取文件图标 + + + + + + + + 获取文件图标 + + + + + + + + + + 图片相关API + + + + + 检测文件真实扩展名 + + + + + + + 检测文件真实扩展名 + + + + + + + 从文件或Url中加载图片,使用本方法，不会导致图片文件被占用。(如果是webp格式,需要引入OpenXmlPowerTools) + + + + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + 图片质量,0~100 + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + 图片质量,0~100 + + + + 保存高质量不失真照片 + + + + + + + + 保存高质量不失真照片 + + + + + 图片质量,0~100 + + + + 保存高质量不失真照片 + + + + + + + 保存高质量不失真照片 + + + + + + + 以逆时针为方向对图像进行旋转 + + 位图流 + 旋转角度[0,360](前台给的) + + + + + 是否包括透明像素 + + + + 操作失败 + + + + 矩形边界 + + + + + + + + 计算水印位置 + + + + + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印 + + 原图 + 水印图片 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 计算最大字体大小 + + + + + + + + + + + 计算旋转矩形大小 + + + + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + x坐标偏移 + y坐标偏移 + 不透明度(0~1),越小越透明 + + + + + 写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 旋转角度 + 水印位置 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + 不透明度(0~1),越小越透明 + + + + + 往图片右下角写入水印文字 + + 图片 + 水印文字 + 水印字体名字 + 字体颜色 + 字体大小 + + + + + 缩放 + + + 宽 + 高 + 插值算法 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 缩放 + + + 宽 + 高 + 返回缩放后的图片 + Image 不能为 null + 操作失败 + + + + 根据原边长和新边长计算绘制的起始点坐标 + + + + + + + + 获取缩放模式 + + + + + + 是否裁剪图片 + + + + + 裁剪或填充 + + + + + 背景色 + 插值算法 + + Image 不能为 null + 操作失败 + + + + 裁剪 + + + 宽度 + 高度 + + 返回裁剪后的图片 + Image 不能为 null + 新的图片尺寸的宽度和高度必须大于零 + 操作失败 + + + + 调整宽度 + + + + + + + + 根据最大宽度调整图片尺寸 + + + 最大宽度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最大高度调整图片尺寸 + + + 最大高度 + 返回调整后的图片 + Image 不能为 null + 最大宽度必须大于零 + 操作失败 + + + + 根据最长边调整图片尺寸 + + + 设置最长边允许的值,当最长边大于这个值时,自动缩放 + 返回调整后的图片 + Image 不能为 null + 最大值必须大于零 + 操作失败 + + + + 调整高度 + + + + + + + + 调整图片大小 + + + + + + + + + + 调整图片大小 + + + + + + + + + + + 调整图片大小 + + + + + + + + + + + + + 转换Image为Icon + + 要转换为图标的Image对象 + 当image为null时是否返回null。false则抛空引用异常 + + + + + 缩放模式 + + + + + 宽度优先(不裁剪宽) + + + + + 高度优先(不裁剪高) + + + + + 水印位置 + + + + + 左上角 + + + + + 中上 + + + + + 右上角 + + + + + 左中 + + + + + 居中 + + + + + 右中 + + + + + 左下角 + + + + + 中下 + + + + + 右下角 + + + + + 全屏平铺 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + 音频播放类 + + + + + 临时音频文件 + + + + + 父窗口句柄 + + + + + 声音标签 + + + + play synchronously (default) + + + play asynchronously + + + silence (!default) if sound not found + + + pszSound points to a memory file + + + loop the sound until next sndPlaySound + + + don’t stop any currently playing sound + + + Stop Playing Wave + + + don’t wait if the driver is busy + + + name is a registry alias + + + alias is a predefined id + + + name is file name + + + name is resource name or atom + + + + 音频播放类 + + embedded music file + 临时保存的文件位置 + 父窗口句柄 + + + + 音频播放类 + + 要播放的音频位置 + 父窗口句柄 + + + + 音频播放类 + + + 父窗口句柄 + + + + 播放音频 + + + + + + 播放音频 + + + + + 关闭音频 + + + + + XML操作类 + + + + + XML操作类 + + + + + 从XML文本中加载数据 + + + + + + 从指定的XML文本中加载 + + XML文本 + 如为1，表示加载成功，为0为失败 + + + + 载入空的XML文档 + + 如为1，表示加载成功，为0为失败 + + + + 从指定的文件中加载 + + XML文件路径 + 如为1，表示加载成功，为0为失败 + + + + 保存到指定文件中 + + 文件路径 + 如为1，表示保存成功，为0为失败 + + + + 判断节点是否存在 + + 属性名 + 属性值 + 返回1，表示存在，其它表示不存在 + + + + 定位节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 定位节点,如果找不到节点，就新建一个节点 + + 属性名 + 属性值 + 返回第一个符合要求的结果 + + + + 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 + + 返回第一个符合要求的结果 + + + + 定位设置节点 + + 返回第一个符合要求的结果 + + + + 在节点后插入数据 + + + + + + + 在节点前插入数据 + + + + + + + 获取节点数量 + + 属性名 + 属性值 + 返回符合要求的结果数量 + + + + 获取节点数量 + + 返回符合要求的结果数量 + + + + 获取节点数量 + + 属性名 + 属性值 + + + + 返回符合要求的结果数量 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 设置节点值 + + 属性名 + 属性值 + 如为1，表示加载成功，为0为失败 + + + + 读取指定节点的值(string) + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + + + 获取属性值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 读取所有的节点名称 + + + + + + 读取指定节点的值(string) + + + + + + + + 读取指定节点的值(int) + + + + + + + + 读取指定节点的值(decimal) + + + + + + + + 读取指定节点的值 + + + + + + + + 读取指定节点的值 + + + + + + + + 获取XML文件的根元素 + + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 获取所有列表 + + 如为1，表示获取成功，为0为失败 + + + + 新增节点 + + + + + + + + 新增节点并定位到新节点 + + + + + + + + 新增设置节点并定位 + + + + + + 在指定节点前新增节点并定位到新节点 + + + + + + + + + 获取当前节点 + + + + + + 删除节点 + + + + + + 获取XML文本 + + + + + + 获取XML文本 + + + + + + 获取文本 + + + + + + 获取文本 + + + + + + 文件时间 + + + + + 创建时间 + + + + + 最后修改时间 + + + + + 访问时间 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 用于取得一个文本文件的编码方式(Encoding)。 + + + + + 取得一个文本文件的编码方式。如果无法在文件头部找到有效的前导符，Encoding.Default将被返回。 + + 文件名。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + + + + + 取得一个文本文件的编码方式。 + + 文件名。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 取得一个文本文件流的编码方式。 + + 文本文件流。 + 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + + + + + 通过给定的文件流，判断文件的编码类型 + + 文件流 + 文件的编码类型 + + + + 判断是否是不带 BOM 的 UTF8 格式 + + + + + + + + + + + Read a WebP file + WebP file to load + Bitmap with the WebP image + + + Decode a WebP image + The data to uncompress + Bitmap with the WebP image + + + Decode a WebP image + the data to uncompress + Options for advanced decode + Bitmap with the WebP image + + + Get Thumbnail from webP in mode faster/low quality + The data to uncompress + Wanted width of thumbnail + Wanted height of thumbnail + Bitmap with the WebP thumbnail in 24bpp + + + Thumbnail from webP in mode slow/high quality + The data to uncompress + Wanted width of thumbnail + Wanted height of thumbnail + Bitmap with the WebP thumbnail + + + Save bitmap to file in WebP format + Bitmap with the WebP image + The file to write + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + + + Lossy encoding bitmap to WebP (Simple encoding API) + Bitmap with the image + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + Compressed data + + + Lossy encoding bitmap to WebP (Advanced encoding API) + Bitmap with the image + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + Between 0 (fastest, lowest compression) and 9 (slower, best compression) + + Compressed data + + + Lossless encoding bitmap to WebP (Simple encoding API) + Bitmap with the image + Compressed data + + + Lossless encoding image in bitmap (Advanced encoding API) + Bitmap with the image + Between 0 (fastest, lowest compression) and 9 (slower, best compression) + Compressed data + + + Near lossless encoding image in bitmap + Bitmap with the image + Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + Between 0 (fastest, lowest compression) and 9 (slower, best compression) + Compress data + + + Get the libwebp version + Version of library + + + Get info of WEBP data + The data of WebP + width of image + height of image + Image has alpha channel + Image is a animation + Format of image: 0 = undefined (/mixed), 1 = lossy, 2 = lossless + + + Compute PSNR, SSIM or LSIM distortion metric between two pictures. Warning: this function is rather CPU-intensive. + Picture to measure + Reference picture + 0 = PSNR, 1 = SSIM, 2 = LSIM + dB in the Y/U/V/Alpha/All order + + + Encoding image using Advanced encoding API + Bitmap with the image + Config for encode + True if need encode info. + Compressed data + + + Free memory + + + This function will initialize the configuration according to a predefined set of parameters (referred to by 'preset') and a given quality factor. + The WebPConfig struct + Type of image + Quality of compresion + 0 if error + + + Get info of WepP image + Bytes[] of webp image + Size of rawWebP + Features of WebP image + VP8StatusCode + + + Activate the lossless compression mode with the desired efficiency. + The WebPConfig struct + between 0 (fastest, lowest compression) and 9 (slower, best compression) + 0 in case of parameter errorr + + + Check that 'config' is non-NULL and all configuration parameters are within their valid ranges. + The WebPConfig struct + 1 if config are OK + + + Init the struct WebPPicture ckecking the dll version + The WebPPicture struct + 1 if not error + + + Colorspace conversion function to import RGB samples. + The WebPPicture struct + Point to BGR data + stride of BGR data + Returns 0 in case of memory error. + + + Colorspace conversion function to import RGB samples. + The WebPPicture struct + Point to BGRA data + stride of BGRA data + Returns 0 in case of memory error. + + + Colorspace conversion function to import RGB samples. + The WebPPicture struct + Point to BGR data + stride of BGR data + Returns 0 in case of memory error. + + + The writer type for output compress data + Data returned + Size of data returned + Picture struct + + + + Compress to webp format + The config struct for compresion parameters + 'picture' hold the source samples in both YUV(A) or ARGB input + Returns 0 in case of error, 1 otherwise. In case of error, picture->error_code is updated accordingly. + + + Release the memory allocated by WebPPictureAlloc() or WebPPictureImport*() + Note that this function does _not_ free the memory used by the 'picture' object itself. + Besides memory (which is reclaimed) all other fields of 'picture' are preserved. + Picture struct + + + Validate the WebP image header and retrieve the image height and width. Pointers *width and *height can be passed NULL if deemed irrelevant + Pointer to WebP image data + This is the size of the memory block pointed to by data containing the image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + 1 if success, otherwise error code returned in the case of (a) formatting error(s). + + + Decode WEBP image pointed to by *data and returns BGR samples into a pre-allocated buffer + Pointer to WebP image data + This is the size of the memory block pointed to by data containing the image data + Pointer to decoded WebP image + Size of allocated buffer + Specifies the distance between scanlines + output_buffer if function succeeds; NULL otherwise + + + Decode WEBP image pointed to by *data and returns BGR samples into a pre-allocated buffer + Pointer to WebP image data + This is the size of the memory block pointed to by data containing the image data + Pointer to decoded WebP image + Size of allocated buffer + Specifies the distance between scanlines + output_buffer if function succeeds; NULL otherwise + + + Initialize the configuration as empty. This function must always be called first, unless WebPGetFeatures() is to be called. + Configuration struct + False in case of mismatched version. + + + Decodes the full data at once, taking 'config' into account. + WebP raw data to decode + Size of WebP data + Configuration struct + VP8_STATUS_OK if the decoding was successful + + + Free any memory associated with the buffer. Must always be called last. Doesn't free the 'buffer' structure itself. + WebPDecBuffer + + + Lossy encoding images + Pointer to BGR image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + Ranges from 0 (lower quality) to 100 (highest quality). Controls the loss and quality during compression + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Lossy encoding images + Pointer to BGRA image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + Ranges from 0 (lower quality) to 100 (highest quality). Controls the loss and quality during compression + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Lossless encoding images pointed to by *data in WebP format + Pointer to BGR image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Lossless encoding images pointed to by *data in WebP format + Pointer to BGR image data + The range is limited currently from 1 to 16383 + The range is limited currently from 1 to 16383 + Specifies the distance between scanlines + output_buffer with WebP image + Size of WebP Image or 0 if an error occurred + + + Releases memory returned by the WebPEncode + Pointer to memory + + + Get the webp version library + 8bits for each of major/minor/revision packet in integer. E.g: v2.5.7 is 0x020507 + + + Compute PSNR, SSIM or LSIM distortion metric between two pictures. + Picture to measure + Reference picture + 0 = PSNR, 1 = SSIM, 2 = LSIM + dB in the Y/U/V/Alpha/All order + False in case of error (src and ref don't have same dimension, ...) + + + Enumerate some predefined settings for WebPConfig, depending on the type of source picture. These presets are used when calling WebPConfigPreset(). + + + Default preset. + + + Digital picture, like portrait, inner shot. + + + Outdoor photograph, with natural lighting. + + + Hand or line drawing, with high-contrast details. + + + Small-sized colorful images. + + + Text-like. + + + Encoding error conditions. + + + No error. + + + Memory error allocating objects. + + + Memory error while flushing bits. + + + A pointer parameter is NULL. + + + Configuration is invalid. + + + Picture has invalid width/height. + + + Partition is bigger than 512k. + + + Partition is bigger than 16M. + + + Error while flushing bytes. + + + File is bigger than 4G. + + + Abort request by user. + + + List terminator. always last. + + + Enumeration of the status codes. + + + No error. + + + Memory error allocating objects. + + + Configuration is invalid. + + + + + + + + Configuration is invalid. + + + + + + + + Abort request by user. + + + + + + + + Image characteristics hint for the underlying encoder. + + + Default preset. + + + Digital picture, like portrait, inner shot + + + Outdoor photograph, with natural lighting + + + Discrete tone image (graph, map-tile etc). + + + list terminator. always last. + + + Describes the byte-ordering of packed samples in memory. + + + Byte-order: R,G,B,R,G,B,... + + + Byte-order: R,G,B,A,R,G,B,A,... + + + Byte-order: B,G,R,B,G,R,... + + + Byte-order: B,G,R,A,B,G,R,A,... + + + Byte-order: A,R,G,B,A,R,G,B,... + + + Byte-order: RGB-565: [a4 a3 a2 a1 a0 r5 r4 r3], [r2 r1 r0 g4 g3 g2 g1 g0], ... + WEBP_SWAP_16BITS_CSP is defined, + Byte-order: RGB-565: [a4 a3 a2 a1 a0 b5 b4 b3], [b2 b1 b0 g4 g3 g2 g1 g0], ... + + + Byte-order: RGB-565: [r4 r3 r2 r1 r0 g5 g4 g3], [g2 g1 g0 b4 b3 b2 b1 b0], ... + WEBP_SWAP_16BITS_CSP is defined, + Byte-order: [b3 b2 b1 b0 a3 a2 a1 a0], [r3 r2 r1 r0 g3 g2 g1 g0], ... + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + RGB-premultiplied transparent modes (alpha value is preserved) + + + yuv 4:2:0 + + + yuv 4:2:0 + + + MODE_LAST -> 13 + + + + Decoding states. State normally flows as: + WEBP_HEADER->VP8_HEADER->VP8_PARTS0->VP8_DATA->DONE for a lossy image, and + WEBP_HEADER->VP8L_HEADER->VP8L_DATA->DONE for a lossless image. + If there is any error the decoder goes into state ERROR. + + + + Features gathered from the bitstream + + + Width in pixels, as read from the bitstream. + + + Height in pixels, as read from the bitstream. + + + True if the bitstream contains an alpha channel. + + + True if the bitstream is an animation. + + + 0 = undefined (/mixed), 1 = lossy, 2 = lossless + + + Padding for later use. + + + Compression parameters. + + + Lossless encoding (0=lossy(default), 1=lossless). + + + Between 0 (smallest file) and 100 (biggest) + + + Quality/speed trade-off (0=fast, 6=slower-better) + + + Hint for image type (lossless only for now). + + + If non-zero, set the desired target size in bytes. Takes precedence over the 'compression' parameter. + + + If non-zero, specifies the minimal distortion to try to achieve. Takes precedence over target_size. + + + Maximum number of segments to use, in [1..4] + + + Spatial Noise Shaping. 0=off, 100=maximum. + + + Range: [0 = off .. 100 = strongest] + + + Range: [0 = off .. 7 = least sharp] + + + Filtering type: 0 = simple, 1 = strong (only used if filter_strength > 0 or autofilter > 0) + + + Auto adjust filter's strength [0 = off, 1 = on] + + + Algorithm for encoding the alpha plane (0 = none, 1 = compressed with WebP lossless). Default is 1. + + + Predictive filtering method for alpha plane. 0: none, 1: fast, 2: best. Default if 1. + + + Between 0 (smallest size) and 100 (lossless). Default is 100. + + + Number of entropy-analysis passes (in [1..10]). + + + If true, export the compressed picture back. In-loop filtering is not applied. + + + Preprocessing filter (0=none, 1=segment-smooth, 2=pseudo-random dithering) + + + Log2(number of token partitions) in [0..3] Default is set to 0 for easier progressive decoding. + + + Quality degradation allowed to fit the 512k limit on prediction modes coding (0: no degradation, 100: maximum possible degradation). + + + If true, compression parameters will be remapped to better match the expected output size from JPEG compression. Generally, the output size will be similar but the degradation will be lower. + + + If non-zero, try and use multi-threaded encoding. + + + If set, reduce memory usage (but increase CPU use). + + + Near lossless encoding [0 = max loss .. 100 = off (default)]. + + + If non-zero, preserve the exact RGB values under transparent area. Otherwise, discard this invisible RGB information for better compression. The default value is 0. + + + Reserved for future lossless feature + + + if needed, use sharp (and slow) RGB->YUV conversion + + + Padding for later use. + + + Main exchange structure (input samples, output bytes, statistics) + + + Main flag for encoder selecting between ARGB or YUV input. Recommended to use ARGB input (*argb, argb_stride) for lossless, and YUV input (*y, *u, *v, etc.) for lossy + + + colorspace: should be YUV420 for now (=Y'CbCr). Value = 0 + + + Width of picture (less or equal to WEBP_MAX_DIMENSION) + + + Height of picture (less or equal to WEBP_MAX_DIMENSION) + + + Pointer to luma plane. + + + Pointer to chroma U plane. + + + Pointer to chroma V plane. + + + Luma stride. + + + Chroma stride. + + + Pointer to the alpha plane + + + stride of the alpha plane + + + Padding for later use. + + + Pointer to argb (32 bit) plane. + + + This is stride in pixels units, not bytes. + + + Padding for later use. + + + Byte-emission hook, to store compressed bytes as they are ready. + + + Can be used by the writer. + + + 1: intra type, 2: segment, 3: quant, 4: intra-16 prediction mode, 5: chroma prediction mode, 6: bit cost, 7: distortion + + + if not NULL, points to an array of size ((width + 15) / 16) * ((height + 15) / 16) that will be filled with a macroblock map, depending on extra_info_type. + + + Pointer to side statistics (updated only if not NULL) + + + Error code for the latest error encountered during encoding + + + If not NULL, report progress during encoding. + + + this field is free to be set to any value and used during callbacks (like progress-report e.g.). + + + Padding for later use. + + + Row chunk of memory for yuva planes + + + row chunk of memory for argb planes + + + Padding for later use. + + + + + + + + + Structure for storing auxiliary statistics (mostly for lossy encoding). + + + Final size + + + Peak-signal-to-noise ratio for Y + + + Peak-signal-to-noise ratio for U + + + Peak-signal-to-noise ratio for V + + + Peak-signal-to-noise ratio for All + + + Peak-signal-to-noise ratio for Alpha + + + Number of intra4 + + + Number of intra16 + + + Number of skipped macroblocks + + + Approximate number of bytes spent for header + + + Approximate number of bytes spent for mode-partition #0 + + + Approximate number of bytes spent for DC coefficients for segment 0. + + + Approximate number of bytes spent for AC coefficients for segment 0. + + + Approximate number of bytes spent for uv coefficients for segment 0. + + + Approximate number of bytes spent for DC coefficients for segment 1. + + + Approximate number of bytes spent for AC coefficients for segment 1. + + + Approximate number of bytes spent for uv coefficients for segment 1. + + + Approximate number of bytes spent for DC coefficients for segment 2. + + + Approximate number of bytes spent for AC coefficients for segment 2. + + + Approximate number of bytes spent for uv coefficients for segment 2. + + + Approximate number of bytes spent for DC coefficients for segment 3. + + + Approximate number of bytes spent for AC coefficients for segment 3. + + + Approximate number of bytes spent for uv coefficients for segment 3. + + + Number of macroblocks in segments 0 + + + Number of macroblocks in segments 1 + + + Number of macroblocks in segments 2 + + + Number of macroblocks in segments 3 + + + Quantizer values for segment 0 + + + Quantizer values for segment 1 + + + Quantizer values for segment 2 + + + Quantizer values for segment 3 + + + Filtering strength for segment 0 [0..63] + + + Filtering strength for segment 1 [0..63] + + + Filtering strength for segment 2 [0..63] + + + Filtering strength for segment 3 [0..63] + + + Size of the transparency data + + + Size of the enhancement layer data + + + bit0:predictor bit1:cross-color transform bit2:subtract-green bit3:color indexing + + + Number of precision bits of histogram + + + Precision bits for transform + + + Number of bits for color cache lookup + + + Number of color in palette, if used + + + Final lossless size + + + Lossless header (transform, huffman etc) size + + + Lossless image data size + + + Padding for later use. + + + + + + + + Immutable bitstream features (optional) + + + Output buffer (can point to external mem) + + + Decoding options + + + Output buffer + + + Colorspace. + + + Width of image. + + + Height of image. + + + If non-zero, 'internal_memory' pointer is not used. If value is '2' or more, the external memory is considered 'slow' and multiple read/write will be avoided. + + + Output buffer parameters. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + Internally allocated memory (only when is_external_memory is 0). Should not be used externally, but accessed via WebPRGBABuffer. + + + Union of buffer parameters + + + + + + + + + + + + + + + + + + Pointer to luma samples + + + Pointer to chroma U samples + + + Pointer to chroma V samples + + + Pointer to alpha samples + + + luma stride + + + chroma U stride + + + chroma V stride + + + alpha stride + + + luma plane size + + + chroma plane U size + + + chroma plane V size + + + alpha plane size + + + Generic structure for describing the output sample buffer. + + + pointer to RGBA samples. + + + stride in bytes from one scanline to the next. + + + total size of the rgba buffer. + + + Decoding options + + + if true, skip the in-loop filtering. + + + if true, use faster pointwise upsampler. + + + if true, cropping is applied _first_ + + + left position for cropping. Will be snapped to even values. + + + top position for cropping. Will be snapped to even values. + + + width of the cropping area + + + height of the cropping area + + + if true, scaling is applied _afterward_ + + + final width + + + final height + + + if true, use multi-threaded decoding + + + dithering strength (0=Off, 100=full) + + + flip output vertically + + + alpha dithering strength in [0..100] + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + padding for later use. + + + + 数据库操作扩展 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据,如果没有数据,则返回null + + + + + + + 获取第一行第一列的值 + + + + + + + 获取第一张表的指定行数据 + + + 指定第几行 + + + + + 获取第一张表的行数 + + + + + + + + + + + + 获取和设置aapt.exe的完整路径 + + + + + 获取和设置缓存文件夹 + + + + + 是否开启深度分析,深度分析需要解压apk进行分析，会更耗时。 + + + + + 读取adb内容 + + + + + + + + + + + + app名称 + + + + + 包名 + + + + + 版本号 + + + + + 版本字符串 + + + + + 权限 + + + + + 最小SDK + + + + + 应用图标,需开启DeepAnaly_On开关，否则无法获取 + + + + + 文件名 + + + + + 文件路径 + + + + + 文件创建时间 + + + + + 文件修改时间 + + + + + 错误信息 + + + + + 对鼠标或键盘的自动化操作 + + + + + 鼠标左键 + + + + + 鼠标中键 + + + + + 鼠标右键 + + + + + 模拟键盘按键 + + + + 按下还是抬起 + + + + 鼠标滚轮 + + + + + + + + 鼠标移动 + + + + + + + + 自定义鼠标按下或抬起 + + + + + + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 右键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标x(句柄内的坐标,非屏幕坐标) + 坐标y(句柄内的坐标,非屏幕坐标) + + + + 中键单击鼠标(支持后台单击) + + 指定要发送单击命令的句柄 + 坐标(句柄内的坐标,非屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 左键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 右键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标x(屏幕坐标) + 坐标y(屏幕坐标) + + + + 中键单击鼠标(不支持后台单击) + + 坐标(屏幕坐标) + + + + 粘贴文本 + + + + + + 获取指定句柄的大小及位置 + + + + + + + + 设置指定句柄的大小 + + + + + + + 判断鼠标位置是不是在指定的矩形中 + + + + + + + + 判断2张图是否相似度超90 + + + + + + + + /获取2种颜色的相似度,范围为0~100 + + + + + + + + 新模态窗体 + + + + + 设置窗体返回的结果值，并关闭窗体。 + + 当前窗体 + 模态变量 + 防止 + + + + 窗体返回的结果事件 + + + + + + + 当打开的窗体返回结果时激发 + + + + + 窗体返回的状态 + + + + + 实例化类 + + 父窗体,如果为null,则取桌面为父窗体 + + + + + 获取最顶级的父窗口 + + + + + + 显示新模态窗体,会暂时禁用父窗体,关闭当前窗体后,父窗体会恢复。 + + + + + 只运行一个实例,打开后,所有窗体都依然有效。 + + + + + + 显示窗体 + + 显示的位置 + + + + 显示在父窗体中间 + + + + + 窗体显示位置 + + + + + 右上角 + + + + + 顶部中间 + + + + + 顶部右边 + + + + + 中间 + + + + + 左下角 + + + + + 底部中间 + + + + + 右下角 + + + + + 父窗体居中 + + + + + + + + + + + + + + + + + + + + + + + + + 设置线程数量 + + + + + 要计算的总数量 + + + + + 每个线程要计算的数量 + + + + + + + + + + 当前已使用的时间 + + + + + + + 线程数量 + 要计算的事务数量 + + + + + + + + + + + + + + + + + + + + + + + 多线程计算时激发 + + + + + 在所有线程执行完毕后发生 + + + + + 在线程执行完毕后发生,最后一个执行完毕的线程将不收到本事件通知 + + + + + 进程相关接口 + + + + + 获取进程路径 + + + + + + + 获取进程路径 + + + + + + + 获取命令行 + + + + + + + 获取命令行 + + + + + + + 运行库检测类 + + + + + 获取产品状态 + + + + + + + 判断是否已安装VC运行库 + + + + + + 判断是否已安装VC运行库 + + + + + + 安装状态 + + + + + 组件禁用 + + + + + 配置数据已损坏 + + + + + 安装已暂停或正在进行 + + + + + 从源运行，源不可用 + + + + + 返回缓冲区溢出 + + + + + 无效的参数传递给该函数。 + + + + + 不公布或者未安装该产品。 + + + + + 损坏 + + + + + 该产品已公布但尚未安装。 + + + + + 正在移除的组件（操作状态，不可设置） + + + + + 不同的用户安装该产品。 + + + + + 安装在本地驱动器上 + + + + + 从源代码、CD或网络运行 + + + + + 为当前用户安装该产品。 + + + + + 安装的版本,是x86还是x64，还是全部安装了 + + + + + 判断32位和64位运行库是否已安装 + + + + + 判断32位运行库是否已安装 + + + + + 判断64位运行库是否已安装 + + + + + 判断是否已安装VC2005运行库 + + + + + + 判断是否已安装VC2005SP1运行库 + + + + + + 判断是否已安装VC2008运行库 + + + + + + 判断是否已安装VC2008SP1运行库 + + + + + + 判断是否已安装VC2010运行库 + + + + + + 判断是否已安装VC2010SP1运行库 + + + + + + 判断是否已安装VC2012运行库 + + + + + + 判断是否已安装VC2013运行库 + + + + + + 判断是否已安装VC2015或以上运行库 + + + + + + 判断是否已安装VC2017运行库或以上运行库 + + + + + + 判断是否已安装VC2019运行库或以上运行库 + + + + + + 判断是否已安装VC2022运行库或以上运行库 + + + + + + 判断当前系统是否安装了WebView2组件 + + + + + + 判断当前系统是否安装了.NET 4.8 + + + + + + 日期时间的操作类 + + + + + 获取当前是周几,周一到周日，分别是1-7. + + + + + + + 获取当前是周几,1-7，分别是返回一到日. + + + + + + + 获取当前是周几,输入日期，根据周几，分别是返回一到日. + + + + + + + 获取一周的开始和结束,开始时间为第一天的0点，结束时间以最后一天的0点为结束时间 + + + + + + + 获取2个日期相差几周 + + + + + + + + 获取2个日期相差几个月 + + + + + + + + 获取一个月的开始 + + + + + + + 判断是否在同一个星期。 + + + + + + + + 判断是否在同一个月。 + + + + + + + + 判断是否在同一天 + + + + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + + + + + 计算两个日期的时间间隔,返回的是时间间隔的日期差的绝对值. + + 第一个日期和时间 + 第二个日期和时间 + 是否显示秒 + + + + + 将秒数显示成中文表达式 + + + + + + + 计算一个时间与当前本地日期和时间的时间间隔,返回的是时间间隔的日期差的绝对值. + + 一个日期和时间 + + + + + 将c# DateTime时间格式转换为Unix时间戳格式 + + 时间 + long + + + + 时间戳转为C#格式时间 + + + + + + + 时间戳转为C#格式时间 + + + + + + + 将c# DateTime时间格式转换为js时间戳格式 + + 时间 + long + + + + JS时间戳转为C#格式时间 + + + + + + + JS时间戳转为C#格式时间 + + + + + + + 根据年月日转换成日期 + + + + + + + + + 根据日期和时间转换成日期时间 + + + + + + + + 将时间转换成当前分钟开始的时间 + + + + + + + 将时间转换成当前秒钟开始的时间 + + + + + + + 当前时间在这一天里的秒数 + + + + + + + 窗体操作类 + + + + + 设置Comobox的行间距 + + + + + + + 移除关闭按钮。返回值，非零表示成功，零表示失败。 + + 窗口的句柄 + 是否成功 + + + + 把窗体放到最前 + + + + + + 显示窗体 + + + + + + + + 设置窗体是否置顶 + + + + + + + 显示没有焦点的窗口 + + + + + + 根据句柄获取窗口文本 + + + + + + + 根据句柄获取窗口类 + + + + + + + 获取当前活动的窗口句柄 + + + + + + 获取当前前台的窗口句柄 + + + + + + 设置为当前活动窗口 + + + + + + + 根据窗口句柄来获得进程id + + + + + + + 显示窗体 + + + + + + 设置窗体父窗体为桌面,不会随着显示桌面而最小化,但无法设置窗体透明度 + + + + + + 结束进程 + + + + + + + 打开窗体,只打开一个实例(非模态) + + + + + + + 将窗体植入到容器控件中 + + + 作为窗体容器的控件 + + + + + 重新调整窗体大小以适配容器大小 + + + 作为窗体容器的控件 + + + + + 设置注册表操作,部分功能需要管理员权限 + + + + + 访问的注册表位置(64位还是32位) + + + + + 访问的注册表节点 + + + + + 判断注册表项是否存在 + + + + + + + + + 删除注册表键(如果存在子键,子键将一并被删除) + + + + + + + + + + 删除注册表键值 + + + + + + + + + + 获取注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置注册表键值 + + + + + + + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + 启动命令 + + + + + 设置是否开机启动 + + 是否开机启动 + 开机启动名称 + + + + + 把指定文件设置为开机启动或取消开机启动 + + 是否开机启动 + 开机启动名称 + 要开机启动的文件路径 + + + + + 检查是否开机启动 + + 开机启动名称 + 开机启动命令 + + + + + 检查是否开机启动 + + 开机启动名称 + + + + + 判断指定文件是否是开机启动 + + 开机启动名称 + 文件路径 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + + + + + 判断当前程序是否是开机启动 + + 开机启动名称 + 启动命令行 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置文件关联 + + 扩展名(如.apk) + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 设置文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 在指定文件格式右键菜单中增加菜单 + + 扩展名(如.apk) + app名称(建议用英文数字) + 文件关联描述 + 文件路径 + + + + 删除文件关联 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 获取文件关联是否存在 + + 映射的扩展名(如apkfile) + app名称(建议用英文数字) + + + + 采用的IE模式 + + + + + IE7兼容视图 + + + + + IE8 标准模式 + + + + + IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE9 标准模式 + + + + + IE9 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + IE10 标准模式 + + + + + IE10 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置当前软件的浏览器控件内核版本 + + 7000 表示IE7兼容视图模式;8000 表示IE8 标准模式 ;8888 表示IE8 强制标准模式，在渲染失败的情况下不尝试用兼容视图模式 + + + + + 设置指定文件的浏览器控件内核版本 + + 文件名，要求不带路径 + IE内核版本 + + + + + 设置当前软件的浏览器控件内核版本 + + IE内核版本 + + + + + 系统音量操作类 + + + + + 判断系统是否正处于静音(暂不支持XP或以下系统) + + + + + + 系统函数 + + + + + + + + + + 红 + + + + + 绿 + + + + + 蓝 + + + + + 获取屏幕伽马值 + + + + + + + + 设置屏幕伽马值 + + + + + + + + 获取键盘和鼠标没有操作的时间 + + + + + + 设置屏幕 Gamma值 + + + + + + + + + 设置屏幕亮度 + + + + + + + 获取系统名称,注意需要在app.manifest文件中设置兼容win10 + + + + + + SOURCE CODE FROM THE WEBSITE. + LAST UPDATE:WWW.VJSDN.COM易学论坛,2009/08/03 by Jonny Sun + + + + + Mutes the left hand channel and transfers audio fully to the right + + + + + Mutes the right hand channel and transfers audio fully to the left + + + + + 窗体操作类 + + + + + 构造函数 + + + + + + 析构 + + + + + 设置让窗体支持移动 + + + + + 是否允许可调节大小 + + + + + 可调节窗体大小的宽度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 提供一个任务调度程序，确保在ThreadPool之上运行时具有最大并发级别。 + + + + Whether the current thread is processing work items. + + + The list of tasks to be executed. + + + The maximum concurrency level allowed by this scheduler. + + + Whether the scheduler is currently processing work items. + + + + Initializes an instance of the LimitedConcurrencyLevelTaskScheduler class with the + specified degree of parallelism. + + The maximum degree of parallelism provided by this scheduler. + + + Queues a task to the scheduler. + The task to be queued. + + + + Informs the ThreadPool that there's work to be executed for this scheduler. + + + + Attempts to execute the specified task on the current thread. + The task to be executed. + + Whether the task could be executed on the current thread. + + + Attempts to remove a previously scheduled task from the scheduler. + The task to be removed. + Whether the task could be found and removed. + + + Gets the maximum concurrency level supported by this scheduler. + + + Gets an enumerable of the tasks currently scheduled on this scheduler. + An enumerable of the tasks currently scheduled. + + + + + + + + + + + + + + + + 开始截图 + + 是否截取鼠标指针 + + + + + 自动排列控件 + + + + + 最大列数 + + + + + 开始排列的坐标 + + + + + 下一项的位置 + + + + + 下一项的右下角坐标 + + + + + 竖向间隔像素 + + + + + 横向间隔像素 + + + + + 最小保留右边距,只对ReDraw2有效 + + + + + 自动排列控件构造函数 + + + + + + 自动排列控件构造函数 + + + + + + + + 开始排列控件 + + + + + 开始排列控件,当列数超过显示空间时，自动换行 + + + + + 加入的控件列表 + + + + + 初始化添加,自动将容器设置为滚动条自动显示 + + + + + + 添加控件 + + + + + + + 删除控件 + + + + + + 删除控件 + + + + + + 清空所有控件 + + + + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据当前节点生成HtmlDocument + + + + + + + 根据XPath来获取属性值 + + + + 属性名,为空则输出InnerText,-1则输出InnerHtml,-2则输出OuterHtml + + + + + + 根据XPath来查找节点 + + + + + + + + 在当前节点下根据xpath来查找符合的第一个节点 + + + + + + + + 在当前节点下根据xpath来查找所有符合的节点 + + + + + + + + A utility class to compute CRC32. + + + + + Compute a checksum for a given array of bytes. + + The array of bytes to compute the checksum for. + The computed checksum. + + + + Compute a checksum for a given string. + + The string to compute the checksum for. + The computed checksum. + + + + Represents an HTML attribute. + + + + + Gets the line number of this attribute in the document. + + + + + Gets the column number of this attribute in the document. + + + + + Gets the stream position of the value of this attribute in the document, relative to the start of the document. + + + + + Gets the length of the value. + + + + + + + + + + Gets the qualified name of the attribute. + + + + + Name of attribute with original case + + + + + Gets the HTML document to which this attribute belongs. + + + + + Gets the HTML node to which this attribute belongs. + + + + + Specifies what type of quote the data should be wrapped in + + + + + Specifies what type of quote the data should be wrapped in (internal to keep backward compatibility) + + + + + Gets the stream position of this attribute in the document, relative to the start of the document. + + + + + Gets or sets the value of the attribute. + + + + + Gets the DeEntitized value of the attribute. + + + + + Gets a valid XPath string that points to this Attribute + + + + + Compares the current instance with another attribute. Comparison is based on attributes' name. + + An attribute to compare with this instance. + A 32-bit signed integer that indicates the relative order of the names comparison. + + + + Creates a duplicate of this attribute. + + The cloned attribute. + + + + Removes this attribute from it's parents collection + + + + + An Enum representing different types of Quotes used for surrounding attribute values + + + + + A single quote mark ' + + + + + A double quote mark " + + + + + No quote mark + + + + + The initial value (current value) + + + + + Represents a combined list and collection of HTML nodes. + + + + + Gets the number of elements actually contained in the list. + + + + + Gets readonly status of colelction + + + + + Gets the attribute at the specified index. + + + + + Gets a given attribute from the list using its name. + + + + + Adds a new attribute to the collection with the given values + + + + + + + Adds supplied item to collection + + + + + Adds a range supplied items to collection. + An IEnumerable<HtmlAttribute> of items to append to this. + + + Adds a range supplied items to collection using a dictionary. + A Dictionary<string,string> of items to append to this. + + + + Explicit clear + + + + + Retreives existence of supplied item + + + + + + + Copies collection to array + + + + + + + Get Explicit enumerator + + + + + + Explicit non-generic enumerator + + + + + + Retrieves the index for the supplied item, -1 if not found + + + + + + + Inserts given item into collection at supplied index + + + + + + + Explicit collection remove + + + + + + + Removes the attribute at the specified index. + + The index of the attribute to remove. + + + + Inserts the specified attribute as the last attribute in the collection. + + The attribute to insert. May not be null. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The appended attribute. + + + + Creates and inserts a new attribute as the last attribute in the collection. + + The name of the attribute to insert. + The value of the attribute to insert. + The appended attribute. + + + + Checks for existance of attribute with given name + + + + + + + Inserts the specified attribute as the first node in the collection. + + The attribute to insert. May not be null. + The prepended attribute. + + + + Removes a given attribute from the list. + + The attribute to remove. May not be null. + + + + Removes an attribute from the list, using its name. If there are more than one attributes with this name, they will all be removed. + + The attribute's name. May not be null. + + + + Remove all attributes in the list. + + + + + Returns all attributes with specified name. Handles case insentivity + + Name of the attribute + + + + + Removes all attributes from the collection + + + + + Clears the attribute collection + + + + + Represents an HTML comment. + + + + + Gets or Sets the comment text of the node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Represents a complete HTML document. + + + + True to disable, false to enable the behavior tag p. + + + Default builder to use in the HtmlDocument constructor + + + Action to execute before the Parse is executed + + + + Defines the max level we would go deep into the html document + + + + The HtmlDocument Text. Careful if you modify it. + + + True to stay backward compatible with previous version of HAP. This option does not guarantee 100% compatibility. + + + + Adds Debugging attributes to node. Default is false. + + + + + Defines if closing for non closed nodes must be done at the end or directly in the document. + Setting this to true can actually change how browsers render the page. Default is false. + + + + + Defines if non closed nodes will be checked at the end of parsing. Default is true. + + + + + Defines if a checksum must be computed for the document while parsing. Default is false. + + + + + Defines if SelectNodes method will return null or empty collection when no node matched the XPath expression. + Setting this to true will return empty collection and false will return null. Default is false. + + + + True to disable, false to enable the server side code. + + + + Defines the default stream encoding to use. Default is System.Text.Encoding.Default. + + + + + Force to take the original comment instead of creating it + + + + + Defines if source text must be extracted while parsing errors. + If the document has a lot of errors, or cascading errors, parsing performance can be dramatically affected if set to true. + Default is false. + + + + + Defines the maximum length of source text or parse errors. Default is 100. + + + + + Defines if LI, TR, TH, TD tags must be partially fixed when nesting errors are detected. Default is false. + + + + + Defines if output must conform to XML, instead of HTML. Default is false. + + + + + If used together with and enabled, Xml namespaces in element names are preserved. Default is false. + + + + + Defines if attribute value output must be optimized (not bound with double quotes if it is possible). Default is false. + + + + Defines the global attribute value quote. When specified, it will always win. + + + + Defines if name must be output with it's original case. Useful for asp.net tags and attributes. Default is false. + + + + + Defines if name must be output in uppercase. Default is false. + + + + + Defines if declared encoding must be read from the document. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node. + Default is true. + + + + + Defines the name of a node that will throw the StopperNodeException when found as an end node. Default is null. + + + + + Defines if the 'id' attribute must be specifically used. Default is true. + + + + + Defines if empty nodes must be written as closed during output. Default is false. + + + + + The max number of nested child nodes. + Added to prevent stackoverflow problem when a page has tens of thousands of opening html tags with no closing tags + + + + + Creates an instance of an HTML document. + + + + Gets the parsed text. + The parsed text. + + + + Defines the max level we would go deep into the html document. If this depth level is exceeded, and exception is + thrown. + + + + + Gets the document CRC32 checksum if OptionComputeChecksum was set to true before parsing, 0 otherwise. + + + + + Gets the document's declared encoding. + Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node (pre-HTML5) or the meta charset="XXXXX" html node (HTML5). + + + + + Gets the root node of the document. + + + + + Gets the document's output encoding. + + + + + Gets a list of parse errors found in the document. + + + + + Gets the remaining text. + Will always be null if OptionStopperNodeName is null. + + + + + Gets the offset of Remainder in the original Html text. + If OptionStopperNodeName is null, this will return the length of the original Html text. + + + + + Gets the document's stream encoding. + + + + + Gets a valid XML name. + + Any text. + A string that is a valid XML name. + + + + + + + + + + + + + + + + + + + Applies HTML encoding to a specified string. + + The input string to encode. May not be null. + The encoded string. + + + + Determines if the specified character is considered as a whitespace character. + + The character to check. + true if if the specified character is considered as a whitespace character. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The new HTML attribute. + + + + Creates an HTML attribute with the specified name. + + The name of the attribute. May not be null. + The value of the attribute. + The new HTML attribute. + + + + Creates an HTML comment node. + + The new HTML comment node. + + + + Creates an HTML comment node with the specified comment text. + + The comment text. May not be null. + The new HTML comment node. + + + + Creates an HTML element node with the specified name. + + The qualified name of the element. May not be null. + The new HTML node. + + + + Creates an HTML text node. + + The new HTML text node. + + + + Creates an HTML text node with the specified text. + + The text of the node. May not be null. + The new HTML text node. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML stream. + + The input stream. May not be null. + The html is checked. + The detected encoding. + + + + Detects the encoding of an HTML text provided on a TextReader. + + The TextReader used to feed the HTML. May not be null. + The detected encoding. + + + + Detects the encoding of an HTML text. + + The input html text. May not be null. + The detected encoding. + + + + Gets the HTML node with the specified 'id' attribute value. + + The attribute id to match. May not be null. + The HTML node with the matching id or null if not found. + + + + Loads an HTML document from a stream. + + The input stream. + + + + Loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Loads the HTML document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. May not be null. + + + + Loads the HTML document from the specified string. + + String containing the HTML document to load. May not be null. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. + + + + Saves the HTML document to the specified stream. + + The stream to which you want to save. May not be null. + The character encoding to use. May not be null. + + + + Saves the HTML document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the HTML document to the specified TextWriter. + + The TextWriter to which you want to save. May not be null. + + + + Saves the HTML document to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. + + + + Detects the encoding of an HTML document from a file first, and then loads the file. + + The complete file path to be read. May not be null. + true to detect encoding, false otherwise. + + + + Detects the encoding of an HTML file. + + Path for the file containing the HTML document to detect. May not be null. + The detected encoding. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads an HTML document from a file. + + The complete file path to be read. May not be null. + The character encoding to use. May not be null. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. May not be null. + The character encoding to use. May not be null. + + + + Creates a new XPathNavigator object for navigating this HTML document. + + An XPathNavigator object. The XPathNavigator is positioned on the root of the document. + + + + Flags that describe the behavior of an Element node. + + + + + The node is a CDATA node. + + + + + The node is empty. META or IMG are example of such nodes. + + + + + The node will automatically be closed during parsing. + + + + + The node can overlap. + + + + + A utility class to replace special characters by entities and vice-versa. + Follows HTML 4.0 specification found at http://www.w3.org/TR/html4/sgml/entities.html + Follows Additional specification found at https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references + See also: https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references + + + + + + + + + + A collection of entities indexed by name. + + + + + A collection of entities indexed by value. + + + + + Replace known entities by characters. + + The source text. + The result text. + + + + Clone and entitize an HtmlNode. This will affect attribute values and nodes' text. It will also entitize all child nodes. + + The node to entitize. + An entitized cloned node. + + + + Replace characters above 127 by entities. + + The source text. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + The result text. + + + + Replace characters above 127 by entities. + + The source text. + If set to false, the function will not use known entities name. Default is true. + If set to true, the [quote], [ampersand], [lower than] and [greather than] characters will be entitized. + The result text + + + + Represents an HTML node. + + + + + Gets the name of a comment node. It is actually defined as '#comment'. + + + + + Gets the name of the document node. It is actually defined as '#document'. + + + + + Gets the name of a text node. It is actually defined as '#text'. + + + + + Gets a collection of flags that define specific behaviors for specific element nodes. + The table contains a DictionaryEntry list with the lowercase tag name as the Key, and a combination of HtmlElementFlags as the Value. + + + + + Initialize HtmlNode. Builds a list of all tags that have special allowances + + + + + Initializes HtmlNode, providing type, owner and where it exists in a collection + + + + + + + + Gets the collection of HTML attributes for this node. May not be null. + + + + + Gets all the children of the node. + + + + + Gets a value indicating if this node has been closed or not. + + + + + Gets the collection of HTML attributes for the closing tag. May not be null. + + + + + Gets the closing tag of the node, null if the node is self-closing. + + + + + Gets the first child of the node. + + + + + Gets a value indicating whether the current node has any attributes. + + + + + Gets a value indicating whether this node has any child nodes. + + + + + Gets a value indicating whether the current node has any attributes on the closing tag. + + + + + Gets or sets the value of the 'id' HTML attribute. The document must have been parsed using the OptionUseIdAttribute set to true. + + + + + Gets or Sets the HTML between the start and end tags of the object. + + + + + Gets the text between the start and end tags of the object. + + + + Gets direct inner text. + The direct inner text. + + + + Gets the last child of the node. + + + + + Gets the line number of this node in the document. + + + + + Gets the column number of this node in the document. + + + + + Gets the stream position of the area between the opening and closing tag of the node, relative to the start of the document. + + + + + Gets the stream position of the area of the beginning of the tag, relative to the start of the document. + + + + + Gets the length of the area between the opening and closing tag of the node. + + + + + Gets the length of the entire node, opening and closing tag included. + + + + + Gets or sets this node's name. + + + + + Gets the HTML node immediately following this element. + + + + + Gets the type of this node. + + + + + The original unaltered name of the tag + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets the to which this node belongs. + + + + + Gets the parent of this node (for nodes that can have parents). + + + + + Gets the node immediately preceding this node. + + + + + Gets the stream position of this node in the document, relative to the start of the document. + + + + + Gets a valid XPath string that points to this node + + + + + The depth of the node relative to the opening root html element. This value is used to determine if a document has to many nested html nodes which can cause stack overflows + + + + + Determines if an element node can be kept overlapped. + + The name of the element node to check. May not be null. + true if the name is the name of an element node that can be kept overlapped, false otherwise. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The newly created node instance. + + + + Creates an HTML node from a string representing literal HTML. + + The HTML text. + The HTML Document builder. + The newly created node instance. + + + + Determines if an element node is a CDATA element node. + + The name of the element node to check. May not be null. + true if the name is the name of a CDATA element node, false otherwise. + + + + Determines if an element node is closed. + + The name of the element node to check. May not be null. + true if the name is the name of a closed element node, false otherwise. + + + + Determines if an element node is defined as empty. + + The name of the element node to check. May not be null. + true if the name is the name of an empty element node, false otherwise. + + + + Determines if a text corresponds to the closing tag of an node that can be kept overlapped. + + The text to check. May not be null. + true or false. + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Get Ancestors with matching name + + + + + + + Returns a collection of all ancestor nodes of this element. + + + + + + Gets all anscestor nodes and the current node + + + + + + + Adds the specified node to the end of the list of children of this node. + + The node to add. May not be null. + The node added. + + + Sets child nodes identifier. + The chil node. + + + + Adds the specified node to the end of the list of children of this node. + + The node list to add. May not be null. + + + + Gets all Attributes with name + + + + + + + Creates a duplicate of the node + + + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + The cloned node. + + + + Creates a duplicate of the node and changes its name at the same time. + + The new name of the cloned node. May not be null. + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node. + + true to recursively clone the subtree under the specified node; false to clone only the node itself. + The cloned node. + + + + Creates a duplicate of the node and the subtree under it. + + The node to duplicate. May not be null. + + + + Creates a duplicate of the node. + + The node to duplicate. May not be null. + true to recursively clone the subtree under the specified node, false to clone only the node itself. + + + + Gets all Descendant nodes for this node and each of child nodes + + The depth level of the node to parse in the html tree + the current element as an HtmlNode + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Gets all Descendant nodes in enumerated list + + + + + + Get all descendant nodes with matching name + + + + + + + Returns a collection of all descendant nodes of this element, in document order + + + + + + Gets all descendant nodes including this node + + + + + + + Gets first generation child node matching name + + + + + + + Gets matching first generation child nodes matching name + + + + + + Gets data attribute. + The key. + The data attribute. + + + Gets the data attributes in this collection. + + An enumerator that allows foreach to be used to process the data attributes in this + collection. + + + + Gets the attributes in this collection. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + Gets the attributes in this collection. + A variable-length parameters list containing attribute names. + + An enumerator that allows foreach to be used to process the attributes in this collection. + + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Helper method to get the value of an attribute of this node. If the attribute is not found, + the default value will be returned. + + The name of the attribute to get. May not be null. + The default value to return if not found. + The value of the attribute if found, the default value if not found. + + + + Inserts the specified node immediately after the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newNode is placed after the refNode. + The node being inserted. + + + + Inserts the specified node immediately before the specified reference node. + + The node to insert. May not be null. + The node that is the reference node. The newChild is placed before this node. + The node being inserted. + + + + Adds the specified node to the beginning of the list of children of this node. + + The node to add. May not be null. + The node added. + + + + Adds the specified node list to the beginning of the list of children of this node. + + The node list to add. May not be null. + + + + Removes node from parent collection + + + + + Removes all the children and/or attributes of the current node. + + + + + Removes all the children of the current node. + + + + Removes all id for node described by node. + The node. + + + Move a node already associated and append it to this node instead. + The child node to move. + + + Move a children collection already associated and append it to this node instead. + The children collection already associated to move to another node. + + + Removes the children collection for this node. + The old children collection to remove. + + + + Removes the specified child node. + + The node being removed. May not be null. + The node removed. + + + + Removes the specified child node. + + The node being removed. May not be null. + true to keep grand children of the node, false otherwise. + The node removed. + + + + Replaces the child node oldChild with newChild node. + + The new node to put in the child list. + The node being replaced in the list. + The node replaced. + + + + Helper method to set the value of an attribute of this node. If the attribute is not found, it will be created automatically. + + The name of the attribute to set. May not be null. + The value for the attribute. + The corresponding attribute instance. + + + + Saves all the children of the node to the specified TextWriter. + + The TextWriter to which you want to save. + Identifies the level we are in starting at root with 0 + + + + Saves all the children of the node to a string. + + The saved string. + + + + Saves the current node to the specified TextWriter. + + The TextWriter to which you want to save. + identifies the level we are in starting at root with 0 + + + + Saves the current node to the specified XmlWriter. + + The XmlWriter to which you want to save. + + + + Saves the current node to a string. + + The saved string. + + + + Sets the parent Html node and properly determines the current node's depth using the parent node's depth. + + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + + + + Adds one or more classes to this node. + + The node list to add. May not be null. + true to throw Error if class name exists, false otherwise. + + + + Removes the class attribute from the node. + + + + + Removes the class attribute from the node. + + true to throw Error if class name doesn't exist, false otherwise. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + + + + Removes the specified class from the node. + + The class being removed. May not be null. + true to throw Error if class name doesn't exist, false otherwise. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + + + + Replaces the class name oldClass with newClass name. + + The new class name. + The class being replaced. + true to throw Error if class name doesn't exist, false otherwise. + + + Gets the CSS Class from the node. + + The CSS Class from the node + + + + Check if the node class has the parameter class. + The class. + True if node class has the parameter class, false if not. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type T including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Fill an object and go through it's properties and fill them too. + + Type of object to want to fill. It should have atleast one property that defined XPath. + If htmlDocument includes data , leave this parameter null. Else pass your specific htmldocument. + Returns an object of type targetType including Encapsulated data. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + Why it's thrown. + + + + Creates a new XPathNavigator object for navigating this HTML node. + + An XPathNavigator object. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document. + + + + Creates an XPathNavigator using the root of this document. + + + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Selects the first XmlNode that matches the XPath expression. + + The XPath expression. May not be null. + The first that matches the XPath query or a null reference if no matching node was found. + + + + Selects a list of nodes matching the expression. + + The XPath expression. + An containing a collection of nodes matching the query, or null if no node matched the XPath expression. + + + + Includes tools that GetEncapsulatedData method uses them. + + + + + Determine if a type define an attribute or not , supporting both .NetStandard and .NetFramework2.0 + + Type you want to test it. + Attribute that type must have or not. + If true , The type parameter define attributeType parameter. + + + + Retrive properties of type that defined . + + Type that you want to find it's XPath-Defined properties. + IEnumerable of property infos of a type , that defined specific attribute. + + + + Determine if a has implemented BUT is considered as NONE-IEnumerable ! + + The property info you want to test. + True if property info is IEnumerable. + + + + Returns T type(first generic type) of or . + + IEnumerable-Implemented property + List of generic types. + + + + Find and Return a mehtod that defined in a class by it's name. + + Type of class include requested method. + Name of requested method as string. + Method info of requested method. + + + + Create of given type. + + Type that you want to make a List of it. + Returns IList of given type. + + + + Returns the part of value of you want as . + + A htmlNode instance. + Attribute that includes ReturnType + String that choosen from HtmlNode as result. + + + + Returns parts of values of you want as . + + that you want to retrive each value. + A instnce incules . + Type of IList generic you want. + + + + + Simulate Func method to use in Lambada Expression. + + + + + + + + + This method works like Where method in LINQ. + + + + + + + + + Check if the type can instantiated. + + + + + + + Returns count of elements stored in IEnumerable of T + + + + + + + + Specify which part of is requested. + + + + + The text between the start and end tags of the object. + + + + + The HTML between the start and end tags of the object + + + + + The object and its content in HTML + + + + + Just mark and flag classes to show they have properties that defined . + + + + + Includes XPath and . XPath for finding html tags and for specify which part of you want to return. + + + + + XPath Expression that is used to find related html node. + + + + + Html Attribute name + + + + + The methode of output + + + + + Specify Xpath to find related Html Node. + + + + + + Specify Xpath to find related Html Node. + + + Specify you want the output include html text too. + + + + Specify Xpath and Attribute to find related Html Node and its attribute value. + + + + + + + Tagging a property with this Attribute make Encapsulator to ignore that property if it causes an error. + + + + + Exception that often occures when there is no way to bind a XPath to a Html Tag. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no way to bind a XPath to a HtmlTag Attribute. + + + + + + + + + + + + + + + + + + + + + + + Exception that often occures when there is no property that assigned with XPath Property in Class. + + + + + + + + + + + + + + + + + + + + + + + Represents a combined list and collection of HTML nodes. + + + + + Initialize the HtmlNodeCollection with the base parent node + + The base node of the collection + + + Gets the parent node associated to the collection. + + + + Gets a given node from the list. + + + + + Get node with tag name + + + + + + + Gets the number of elements actually contained in the list. + + + + + Is collection read only + + + + + Gets the node at the specified index. + + + + + Add node to the collection + + + + + + Add node to the collection + + + + + + + Clears out the collection of HtmlNodes. Removes each nodes reference to parentnode, nextnode and prevnode + + + + + Gets existence of node in collection + + + + + + + Copy collection to array + + + + + + + Get Enumerator + + + + + + Get Explicit Enumerator + + + + + + Get index of node + + + + + + + Insert node at index + + + + + + + Remove node + + + + + + + Remove at index + + + + + + Get first instance of node in supplied collection + + + + + + + + Add node to the end of the collection + + + + + + Get first instance of node with name + + + + + + + Get index of node + + + + + + + Add node to the beginning of the collection + + + + + + Remove node at index + + + + + + + Replace node at index + + + + + + + Get all node descended from this collection + + + + + + Get all node descended from this collection with matching name + + + + + + Gets all first generation elements in collection + + + + + + Gets all first generation elements matching name + + + + + + + All first generation nodes in collection + + + + + + Represents an HTML navigator on an HTML document seen as a data store. + + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the stream. + The minimum buffer size. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Initializes a new instance of the HtmlNavigator and loads an HTML document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Gets the base URI for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the current HTML document. + + + + + Gets the current HTML node. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node has child nodes. + + + + + Gets a value indicating whether the current node is an empty element. + + + + + Gets the name of the current HTML node without the namespace prefix. + + + + + Gets the qualified name of the current node. + + + + + Gets the namespace URI (as defined in the W3C Namespace Specification) of the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the associated with this implementation. + + + + + Gets the type of the current node. + + + + + Gets the prefix associated with the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Gets the text value of the current node. + + + + + Gets the xml:lang scope for the current node. + Always returns string.Empty in the case of HtmlNavigator implementation. + + + + + Creates a new HtmlNavigator positioned at the same node as this HtmlNavigator. + + A new HtmlNavigator object positioned at the same node as the original HtmlNavigator. + + + + Gets the value of the HTML attribute with the specified LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + The value of the specified HTML attribute. String.Empty or null if a matching attribute is not found or if the navigator is not positioned on an element node. + + + + Returns the value of the namespace node corresponding to the specified local name. + Always returns string.Empty for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns string.Empty for the HtmlNavigator implementation. + + + + Determines whether the current HtmlNavigator is at the same position as the specified HtmlNavigator. + + The HtmlNavigator that you want to compare against. + true if the two navigators have the same position, otherwise, false. + + + + Moves to the same position as the specified HtmlNavigator. + + The HtmlNavigator positioned on the node that you want to move to. + true if successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves to the HTML attribute with matching LocalName and NamespaceURI. + + The local name of the HTML attribute. + The namespace URI of the attribute. Unsupported with the HtmlNavigator implementation. + true if the HTML attribute is found, otherwise, false. If false, the position of the navigator does not change. + + + + Moves to the first sibling of the current node. + + true if the navigator is successful moving to the first sibling node, false if there is no first sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the first HTML attribute. + + true if the navigator is successful moving to the first HTML attribute, otherwise, false. + + + + Moves to the first child of the current node. + + true if there is a first child node, otherwise false. + + + + Moves the XPathNavigator to the first namespace node of the current element. + Always returns false for the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the node that has an attribute of type ID whose value matches the specified string. + + A string representing the ID value of the node to which you want to move. This argument does not need to be atomized. + true if the move was successful, otherwise false. If false, the position of the navigator is unchanged. + + + + Moves the XPathNavigator to the namespace node with the specified local name. + Always returns false for the HtmlNavigator implementation. + + The local name of the namespace node. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the next sibling of the current node. + + true if the navigator is successful moving to the next sibling node, false if there are no more siblings or if the navigator is currently positioned on an attribute node. If false, the position of the navigator is unchanged. + + + + Moves to the next HTML attribute. + + + + + + Moves the XPathNavigator to the next namespace node. + Always returns falsefor the HtmlNavigator implementation. + + An XPathNamespaceScope value describing the namespace scope. + Always returns false for the HtmlNavigator implementation. + + + + Moves to the parent of the current node. + + true if there is a parent node, otherwise false. + + + + Moves to the previous sibling of the current node. + + true if the navigator is successful moving to the previous sibling node, false if there is no previous sibling or if the navigator is currently positioned on an attribute node. + + + + Moves to the root node to which the current node belongs. + + + + + Represents the type of a node. + + + + + The root of a document. + + + + + An HTML element. + + + + + An HTML comment. + + + + + A text node is always the child of an element or a document node. + + + + + Represents a parsing error found during document parsing. + + + + + Gets the type of error. + + + + + Gets the line number of this error in the document. + + + + + Gets the column number of this error in the document. + + + + + Gets a description for the error. + + + + + Gets the the full text of the line containing the error. + + + + + Gets the absolute stream position of this error in the document, relative to the start of the document. + + + + + Represents the type of parsing error. + + + + + A tag was not closed. + + + + + A tag was not opened. + + + + + There is a charset mismatch between stream and declared (META) encoding. + + + + + An end tag was not required. + + + + + An end tag is invalid at this position. + + + + + Represents an HTML text node. + + + + + Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + + + + + Gets or Sets the object and its content in HTML. + + + + + Gets or Sets the text of the node. + + + + + A utility class to get HTML document from HTTP. + + + + + Represents the method that will handle the PostResponse event. + + + + + Represents the method that will handle the PreHandleDocument event. + + + + + Represents the method that will handle the PreRequest event. + + + + + Occurs after an HTTP request has been executed. + + + + + Occurs before an HTML document is handled. + + + + + Occurs before an HTTP request is executed. + + + + + Gets or Sets a value indicating if document encoding must be automatically detected. + + + + + Gets or sets the Encoding used to override the response stream from any web request + + + + + Gets or Sets a value indicating whether to get document only from the cache. + If this is set to true and document is not found in the cache, nothing will be loaded. + + + + + Gets or Sets a value indicating whether to get document from the cache if exists, otherwise from the web + A value indicating whether to get document from the cache if exists, otherwise from the web + + + + + Gets or Sets the cache path. If null, no caching mechanism will be used. + + + + + Gets a value indicating if the last document was retrieved from the cache. + + + + + Gets the last request duration in milliseconds. + + + + + Gets the URI of the Internet resource that actually responded to the request. + + + + + Gets the last request status. + + + + + Gets or Sets the size of the buffer used for memory operations. + + + + + Gets or Sets a value indicating if cookies will be stored. + + + + Gets or sets a value indicating whether redirect should be captured instead of the current location. + True if capture redirect, false if not. + + + + Gets or Sets the User Agent HTTP 1.1 header sent on any webrequest + + + + + Gets or Sets a value indicating whether the caching mechanisms should be used or not. + + + + + Gets the MIME content type for a given path extension. + + The input path extension. + The default content type to return if any error occurs. + The path extension's MIME content type. + + + + Gets the path extension for a given MIME content type. + + The input MIME content type. + The default path extension to return if any error occurs. + The MIME content type's path extension. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The requested type. + An newly created instance. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. - Proxy aware + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + + + + + Gets an HTML document from an Internet resource and saves it to the specified file. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + Gets an HTML document from an Internet resource and saves it to the specified file. Understands Proxies + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The location of the file where you want to save the document. + + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + + + + + Gets the cache file path for a specified url. + + The url fo which to retrieve the cache path. May not be null. + The cache file path. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Gets an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + Host to use for Proxy + Port the Proxy is on + User Id for Authentication + Password for Authentication + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource. + + The requested Uri, such as new Uri("http://Myserver/Mypath/Myfile.asp"). + The HTTP method used to open the connection, such as GET, POST, PUT, or PROPFIND. + Proxy to use with this request + Credentials to use when authenticating + A new HTML document. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The XmlTextWriter to which you want to save to. + + + Gets or sets the web browser timeout. + + + + Gets or sets the web browser delay. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + Loads HTML using a WebBrowser and Application.DoEvents. + Thrown when an exception error condition occurs. + The requested URL, such as "http://html-agility-pack.net/". + (Optional) Check if the browser script has all been run and completed. + A new HTML document. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + An newly created instance. + + + + Creates an instance of the given type from the specified Internet resource. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An containing the namespace-qualified arguments used as input to the transform. + The requested type. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + An newly created instance. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + + + + Loads an HTML document from an Internet resource and saves it to the specified XmlTextWriter, after an XSLT transformation. + + The requested URL, such as "http://Myserver/Mypath/Myfile.asp". May not be null. + The URL that specifies the XSLT stylesheet to load. + An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. + The XmlTextWriter to which you want to save. + A file path where the temporary XML before transformation will be saved. Mostly used for debugging purposes. + + + + Represents an exception thrown by the HtmlWeb utility class. + + + + + Creates an instance of the HtmlWebException. + + The exception's message. + + + + Represents a document with mixed code and text. ASP, ASPX, JSP, are good example of such documents. + + + + + Gets or sets the token representing code end. + + + + + Gets or sets the token representing code start. + + + + + Gets or sets the token representing code directive. + + + + + Gets or sets the token representing response write directive. + + + + + Creates a mixed code document instance. + + + + + Gets the code represented by the mixed code document seen as a template. + + + + + Gets the list of code fragments in the document. + + + + + Gets the list of all fragments in the document. + + + + + Gets the encoding of the stream used to read the document. + + + + + Gets the list of text fragments in the document. + + + + + Create a code fragment instances. + + The newly created code fragment instance. + + + + Create a text fragment instances. + + The newly created text fragment instance. + + + + Loads a mixed code document from a stream. + + The input stream. + + + + Loads a mixed code document from a stream. + + The input stream. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a stream. + + The input stream. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + + + + Loads a mixed code document from a file. + + The complete file path to be read. + The character encoding to use. + Indicates whether to look for byte order marks at the beginning of the file. + The minimum buffer size. + + + + Loads the mixed code document from the specified TextReader. + + The TextReader used to feed the HTML data into the document. + + + + Loads a mixed document from a text + + The text to load. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + + + + Saves the mixed document to the specified stream. + + The stream to which you want to save. + The character encoding to use. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + + + + Saves the mixed document to the specified file. + + The location of the file where you want to save the document. + The character encoding to use. + + + + Saves the mixed document to the specified StreamWriter. + + The StreamWriter to which you want to save. + + + + Saves the mixed document to the specified TextWriter. + + The TextWriter to which you want to save. + + + + Represents a fragment of code in a mixed code document. + + + + + Gets the fragment code text. + + + + + Represents a base class for fragments in a mixed code document. + + + + + Gets the fragement text. + + + + + Gets the type of fragment. + + + + + Gets the line number of the fragment. + + + + + Gets the line position (column) of the fragment. + + + + + Gets the fragment position in the document's stream. + + + + + Represents a list of mixed code fragments. + + + + + Gets the Document + + + + + Gets the number of fragments contained in the list. + + + + + Gets a fragment from the list using its index. + + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Appends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Gets an enumerator that can iterate through the fragment list. + + + + + Prepends a fragment to the list of fragments. + + The fragment to append. May not be null. + + + + Remove a fragment from the list of fragments. If this fragment was not in the list, an exception will be raised. + + The fragment to remove. May not be null. + + + + Remove all fragments from the list. + + + + + Remove a fragment from the list of fragments, using its index in the list. + + The index of the fragment to remove. + + + + Represents a fragment enumerator. + + + + + Gets the current element in the collection. + + + + + Gets the current element in the collection. + + + + + Advances the enumerator to the next element of the collection. + + true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. + + + + Sets the enumerator to its initial position, which is before the first element in the collection. + + + + + Represents the type of fragment in a mixed code document. + + + + + The fragment contains code. + + + + + The fragment contains text. + + + + + Represents a fragment of text in a mixed code document. + + + + + Gets the fragment text. + + + + + 给控件增加拖放功能的类 + + + + + 拖放实例 + + + + + 高级拖放事件 + + + + + + + + + + + + + + + + + + + + + + + + + 使管理员方式运行时支持拖放 + + + + + + 使支持拖放属性 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取WMI内容 + + + + + + + 获取WMI内容 + + + + + + + 获取内存信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取显卡信息 + + + + + + 获取硬盘信息 + + + + + + 获取主板信息 + + + + + + 获取处理器信息 + + + + + + 获取主要硬件信息 + + + + + + 获取主要硬件信息 + + 是否获取XML格式 + + + + + 网络操作类 + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 通过NetworkInterface读取网卡Mac + + + + + + 根据mac字符串来获取最终的mac地址,可以是各种MAC地址格式,非法的内容将返回null + + + + + + + 远程唤醒 + + + + + + + + 远程唤醒 + + + + + + + + + 消息服务器 + + + + + 消息事件 + + + + + + + 大小改变事件 + + + + + + + + 即将关闭事件 + + + + + + + 当收到消息时激发 + + + + + 消息处理类 + + + + + + + + + + + + + + + + + + + + + + + 发送消息,采用单线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 发送消息，采用多线程发送 + + 要发送到的句柄 + 编号 + 消息内容 + + + + 消息类 + + + + + 是否取消 + + + + + 来源句柄 + + + + + + + + + + 消息文本 + + + + + 需要回复的内容 + + + + + 消息客户端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 最后一次接收消息的时间,可用来判断服务端是否有响应 + + + + + 主句柄 + + + + + 当收到消息时激发 + + + + + 连接上主服务器时触发 + + + + + 收到服务端关闭通知 + + + + + 收到服务端关闭通知，即将关闭 + + + + + 服务端大小改变时激发 + + + + + 实例化客户端 + + 服务端ID + 当前客户端ID,会向服务器报告当前ID + 客户端 + + + + + + + + + 断开服务端连接 + + + + + 发送消息,采用多线程发送 + + + + + + + 向服务端发送心跳包 + + + + + 判断服务端句柄是否存在。 + + + + + + 消息服务端类 + + + + + 判断当前消息主服务器是否创建成功 + + + + + 当收到消息时激发 + + + + + 当收到自定义消息时(非系统消息)激发 + + + + + 有消息客户端发起连接请求时激发 + + + + + 有消息客户端连接成功时激发 + + + + + 有消息客户端断开连接时激发 + + + + + + + 服务端ID,需要唯一性,共客户端识别 + 服务端 + + + + 释放资源 + + + + + 判断是否包含指定客户端 + + + + + + + + + + + + 设置客户端大小 + + + + + 根据客户端ID,获取客户端对象 + + + + + + + 根据客户端句柄,获取客户端对象 + + + + + + + 关闭所有客户端 + + + + + 关闭指定客户端 + + + + + + 关闭指定客户端 + + + + + + 向所有客户端发送消息，单线程 + + + + + + + 向指定客户端发送消息 + + + + + + + + 关闭在指定时间前失去响应的子客户端 + + + + + + 客户端信息 + + + + + 客户端句柄 + + + + + 客户端ID + + + + + 客户端连接时间 + + + + + 心跳时间 + + + + + 共享内存 + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 写共享内存 + + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + + + + + 删除内存映射 + + + + + + + 写共享内存 + + 需要映射的文件的字节数量 + 映射对象（简单类型、结构体等） + 文件映射对象的名称 + 发送消息的窗口句柄 + 发送消息 + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + 读共享内存 + + + + + + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射对象 + + + + 读共享内存 + + 需要映射的文件的字节数量 + 类型 + 文件映射对象的名称 + 返回读到的映射字节数据 + + + + 数据库引擎 + + + + + 数据库枚举类型 + + + + + Odbc引擎 + + + + + OleDb引擎 + + + + + Oracle引擎 + + + + + MSSQL引擎 + + + + + SQLite引擎 + + + + + MySql引擎 + + + + + 判断DataSet是否包含数据 + + + + + + + 获取首行数据 + + + + + + + 获取第一行第一列的值 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + 将DataSet类型转换为RyQuickSQL列表类型 + + + + + + + + 建立访问数据库的实例 + + 数据库枚举类型 + + + + + 数据库操作接口 + + + + + 连接数据库 + + + + + + 数据库是否已连接 + + + + + 断开数据库 + + + + + + 获取数量 + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + 获取分页语句 + + + + + + + + + + 获取分页语句 + + + + + + + + + + 添加Parameter参数 + + + + + + + 清空Parameter参数 + + + + + + + 获取Parameter值 + + + + + + 根据RyQuickSQL类来获取Parameter值 + + + + + + + 开始执行事务 + + + + + 提交事务 + + + + + 判断是否包含数据 + + + + + + + + 返回-1000表示该数据库不支持本接口 + + + + + + + 读取数据 + + + + + + + 读取数据 + + + + + + + + 读取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 根据id号获取数据 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + 执行SQL语句 + + + + + + + 根据id号删除数据 + + + + + + + + 根据id号删除数据 + + + + + + + + 创建数据库 + + + + + + + 释放资源 + + + + + 最后一个错误信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 连接数据库 + + 数据库连接字符串 + + + + + 连接数据库 + + 数据源 + 数据库名称 + 用户id + 用户密码 + + + + + + + + + 连接数据库 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + SQL字段类型 + + + + + SQL字段类型 + + + + + + + SQL字段类型 + + + + + + + + SQL字段名 + + + + + SQL字段值 + + + + + SQL字段长度 + + + + + 不是真的值，而是用于计算的值 + + + + + SQL快速操作类 + + + + + SQL快速操作类 + + + + + + 表名 + + + + + 操作字段列表 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + 清理使用资源 + + + + + + + + + + + + 操作参数列表 + + + + + 操作参数列表 + + + + + 添加字符串字段 + + + + + + + 添加null值字段 + + + + + + 添加日期字段 + + + + + + + 添加int字段 + + + + + + + 添加double字段 + + + + + + + 添加decimal字段 + + + + + + + 添加byte[]字段 + + + + + + + 添加bool字段 + + + + + + + 添加用于计算的值 + + + + + + + 添加Int64字段 + + + + + + + 清空内容 + + + + + 数量 + + + + + + + + + + 输出多条件搜索。 + + 字段名,多个字段请用逗号分隔。 + 多个条件之间请用空格隔开 + + + + + 获取插入SQL语句 + + + + + + 获取更新SQL语句 + + + + + + 添加参数 + + + + + + + 获取Ole参数 + + + + + + 获取SQL参数 + + + + + + + + + + + + + + + + + + + + + + + 数据库路径 + 数据库密码 + + + + + + + 数据库路径 + + + + + + + + + + + + + + + + + + + + 连接数据库 + + + + + + 设置路径和密码 + + + + + + 连接数据库 + + + + + + + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 连接或创建数据库，如果数据库不存在，就创建，否则连接 + + + + + + 关闭数据库 + + + + + + 运行SQL命令 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令 + + SQL语句 + 运行失败，则返回-1，否则返回影响的行数 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + SQL命令参数 + 数组第一个默认的值 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 运行失败，则返回null，否则返回以数组显示的字符串 + + + + 运行SQL命令,并返回结果 + + SQL语句 + 数组第一个默认的值 + 运行失败，则返回DefFristValue，否则返回以数组显示的字符串 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 清空指定表的所有数据 + + 表名 + 运行失败，则返回-1，否则返回影响的行数 + + + + 判断指定值是否存在 + + 表名 + 指定值所属字段 + 指定值 + 当前id，如果是新增记录，请填写-1 + + + + + 判断SQL语句是否有结果返回 + + SQL语句 + SQL命令参数 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 判断SQL语句是否有结果返回 + + SQL语句 + 运行失败，则返回-1；存在结果，返回1；不存在结果，返回0 + + + + 创建数据库 + + SQL语句 + + + + + 根据内置例子创建数据库 + + + + + + 保存信息，如果Name不存在，系统会自动创建 + + 返回1，表示成功，0表示失败 + + + + 获取信息 + + + + + + 获取信息 + + + + + + + + + + + 获取最后一次错误信息 + + + + + + + + + + + + + + + + + + + + + + + + 数据库是否已连接,为1则表示已连接,0表示未连接,负数表示连接出错 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 执行SQL语句 + + + 只针对IsAdd为false才生效，where 以后的sql语句 + 是新增还是更新 + + + + + 插入数据库 + + + + + + + 更新数据库 + + + where 以后的sql语句 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Http连接操作帮助类 + + + + + + + + + + + + 根据相传入的数据，得到相应页面数据 + + 参数类对象 + 返回HttpResult类型 + + + + 获取数据的并解析的方法 + + + + + + + 设置编码 + + HttpItem + HttpResult + byte[] + + + + 提取网页Byte + + + + + + 为请求准备参数 + + 参数列表 + + + + 设置证书 + + + + + + 设置多个证书 + + + + + + 设置Cookie + + Http参数 + + + + 设置Post数据 + + Http参数 + + + + 设置代理 + + 参数对象 + + + + 回调验证证书问题 + + 流对象 + 证书 + X509Chain + SslPolicyErrors + bool + + + + 通过设置这个属性，可以在发出连接的时候绑定客户端发出连接所使用的IP地址。 + + + + + + + + + Http请求参考类 + + + + + 请求URL必须填写 + + + + + 请求方式默认为GET方式,当为POST方式时必须设置Postdata的值 + + + + + 默认请求超时时间 + + + + + 默认写入Post数据超时间 + + + + + 设置Host的标头信息 + + + + + 获取或设置一个值，该值指示是否与 Internet 资源建立持久性连接默认为true。 + + + + + 请求标头值 默认为text/html, application/xhtml+xml, */* + + + + + 请求返回类型默认 text/html + + + + + 客户端访问信息默认Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0) + + + + + 返回数据编码默认为NUll,可以自动识别,一般为utf-8,gbk,gb2312 + + + + + Post的数据类型 + + + + + Post请求时要发送的字符串Post数据 + + + + + Post请求时要发送的Byte类型的Post数据 + + + + + Cookie对象集合 + + + + + 请求时的Cookie + + + + + 来源地址，上次访问地址 + + + + + 证书绝对路径 + + + + + 设置代理对象，不想使用IE默认配置就设置为Null，而且不要设置ProxyIp + + + + + 是否设置为全文小写，默认为不转化 + + + + + 获取或设置要在 HTTP 请求中使用的 Date HTTP 标头值。默认不填写 + + + + + 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 + + + + + 最大连接数 + + + + + 代理Proxy 服务器用户名 + + + + + 代理 服务器密码 + + + + + 代理 服务IP,如果要使用IE代理就设置为ieproxy + + + + + 设置返回类型String和Byte + + + + + header对象 + + + + + 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 + + + + + 获取或设置一个 System.Boolean 值，该值确定是否使用 100-Continue 行为。如果 POST 请求需要 100-Continue 响应，则为 true；否则为 false。默认值为 true。 + + + + + 设置509证书集合 + + + + + 设置或获取Post参数编码,默认的为Default编码 + + + + + Cookie返回类型,默认的是只返回字符串类型 + + + + + 获取或设置请求的身份验证信息。 + + + + + 设置请求将跟随的重定向的最大数目 + + + + + 获取和设置IfModifiedSince，默认为当前日期和时间 + + + + + 设置本地的出口ip和端口 + ] + + item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); + + + + + 是否重置request,response的值，默认不重置，当设置为True时request,response将被设置为Null + + + + + Http返回参数类 + + + + + Http请求返回的Cookie + + + + + Cookie对象集合 + + + + + 返回的String类型数据 只有ResultType.String时才返回数据，其它情况为空 + + + + + 返回的Byte数组 只有ResultType.Byte时才返回数据，其它情况为空 + + + + + header对象 + + + + + 返回状态说明 + + + + + 返回状态码,默认为OK + + + + + 最后访问的URl + + + + + 获取重定向的URl + + + + + 返回类型 + + + + + 表示只返回字符串 只有Html有数据 + + + + + 表示返回字符串和字节流 ResultByte和Html都有数据返回 + + + + + Post的数据格式默认为string + + + + + 字符串类型，这时编码Encoding可不设置 + + + + + Byte类型，需要设置PostdataByte参数的值编码Encoding可设置为空 + + + + + 传文件，Postdata必须设置为文件的绝对路径，必须设置Encoding的值 + + + + + Cookie返回类型 + + + + + 只返回字符串类型的Cookie + + + + + CookieCollection格式的Cookie集合同时也返回String类型的cookie + + + + + Http服务器类 + + + + + + + + + + + + 当收到Get事件时激发 + + + + + 当收到Post事件时激发 + + + + + 监听的主机,默认是localhost + + + + + 最后一次错误信息 + + + + + 在此端口建立Http服务类 + + 端口号 + + + + + + + + + + 开始服务 + + + + + 退出服务 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超时时间 + + + + 以post方式获取网页源码 + + + + + + + + + 以post方式提交json内容 + + + + + + + + + 以post方式提交json内容 + + + + + + + + 头信息 + + + + + 以post方式获取网页源码 + + + + + + + + + + 以post方式获取网页源码 + + + + + + + + 获取网址对应的文件大小 + + + + + + + 获取网址对应的文件大小 + + + + + + + + 获取网址对应的文件大小 + + + + + + + + + 代理 + + + + + 代理用户名 + + + + + 代理密码 + + + + + + + + + + 是否自动跳转 + + + + + 获取网页源码 + + + + + + + + + + 获取网页源码 + + + + + + + + 获取网页源码 + + + + + + + + 获取网页源码 + + + + + + + + + 获取网页源码 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将相对网址转换成绝对网址 + + 相对网址 + 当前页面地址 + 转换后的绝对网址 + + + + WebDav接口 + + + + + WebDav初始化 + + + + + + + + 删除文件 + + 相对路径,不包括域名 + + + + + 下载文件 + + + + + + + + 下载文件 + + + + + + + + + 上传文件 + + + + + + + + 上传文件 + + + + + + + + + 新建文件夹 + + + + + + + 新建文件夹 + + 文件夹路径 + + + + + + 新建文件夹 + + + + + + + + 将文件或目录列出来 + + + + + + + + 定义每个文件或目录的属性 + + + + + 文件名 + + + + + 是否是文件夹 + + + + + 网址 + + + + + 最后修改时间 + + + + + + + + + + + + + + + url解密 + + + + + + + + url解密,按UTF8方式解密 + + + + + + + Url加密 + + + + + + + + Url加密,按UTF8方式加密 + + + + + + + 解密 + + + + + + + 加密 + + + + + + + + + + + + + + + + + + + + + + + + + url加密,Unicode + + + + + + + + + + + + + + + + + + + + + + Html解码,将html里未转义成功的重新转义。 + + + + + + + 将url里的字段分解成表单字典 + + + + + + + + + 根据表单字段名获取值 + + + + + + + + + AES加密解密类 + + + + + AES加密算法 + + 明文字符串 + 密钥 + 返回加密后的密文字节数组 + + + + AES解密 + + 密文字节数组 + 密钥 + 返回解密后的字符串 + + + + 加密 + + + + + + + + 解码 + + + + + + + + 转换密钥到合法密钥 + + + + + + + Base64编码类 + + + + + 编码 + + + + + + + 把字符串编码成Base64字符串 + + + + + + + + 解码 + + + + + + + MD5和SHA1操作类 + + + + + 计算文件MD5。 + 通过MD5CryptoServiceProvider类中的ComputeHash方法直接传入一个FileStream类实现计算MD5 + 操作简单，代码少，调用即可 + + 文件地址 + MD5Hash + + + + 计算文件MD5。 + 通过HashAlgorithm的TransformBlock方法对流进行叠加运算获得MD5 + 实现稍微复杂，但可使用与传输文件或接收文件时同步计算MD5值 + 可自定义缓冲区大小，计算速度较快 + + 文件地址 + MD5Hash + + + + 获取MD5 + + + + + + + 获取MD5 + + + + + + + 获取SHA1 + + + + + + + 获取SHA1 + + + + + + + 获取HmacSHA1 + + + + + + + + 获取SHA256 + + + + + + + 获取HmacSHA256 + + + + + + + + 获取SHA224 + + + + + + + 获取SHA512 + + + + + + + 获取HmacSHA512 + + + + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 内部类 + + + + 读写锁对象 + + + + 是否为写入模式 + + + + 利用IDisposable的using语法糖方便的释放锁定操作 + 构造函数 + + 读写锁 + 写入模式为true,读取模式为false + + + 释放对象时退出指定锁定模式 + + + + 空的可释放对象,免去了调用时需要判断是否为null的问题 + 内部类 + + + + 空的可释放对象 + + + + 空的释放方法 + + + + 读写锁 + + + + 保存数据 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + + + + 使用using代替lock操作的对象,可指定写入和读取锁定模式 + 构造函数 + 为Data属性设置初始值 + + + + 获取或设置当前对象中保存数据的值 + + 获取数据时未进入读取或写入锁定模式 + 设置数据时未进入写入锁定模式 + + + 是否启用,当该值为false时,Read()和Write()方法将返回 Disposable.Empty + + + + 进入读取锁定模式,该模式下允许多个读操作同时进行 + 退出读锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在读取或写入锁定模式下重复执行,返回Disposable.Empty; + + + + 进入写入锁定模式,该模式下只允许同时执行一个写操作 + 退出写锁请将返回对象释放,建议使用using语块 + Enabled为false时,返回Disposable.Empty; + 在写入锁定模式下重复执行,返回Disposable.Empty; + + 读取模式下不能进入写入锁定状态 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Shell + + + + + 根据路径获取 IShellFolder 和 PIDL + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 弹出系统右键菜单 + + + + + + + + 中国农历类,最大支持公元0-9999年 + + 日期：2019-02-09 + 作者：http://www.cnblogs.com/zjfree/ + + + + 日历类型 + + + + + 无效 + + + + + Julian 日历 + + + + + Gregorian 日历 + + + + + 有效 + + + + + 公历节日 + + + + + 农历节日 + + + + + 某个月第n个星期几 + + + + + 获取农历 + + + + + + + 获取农历 + + + + + + + + + 获得某农历年的闰月，返回 1~12 对应一月到十二月，返回 0 表示无闰月 + + + + + + + 农历搜索方向 + + + + + 无效 + + + + + 向上 + + + + + 向下 + + + + + {* 日月食类型， 无， 日食， 月全食， 月偏食 } + + + + + 无 + + + + + 日食 + + + + + 月全食 + + + + + 月偏食 + + + + + {* 月相， 无， 朔， 望} + + + + + 无 + + + + + 朔 + + + + + 望 + + + + + 获得某公历年月日的农历日数和该日月相以及日月食类型和时刻 + + + + + + + + + + + + 获得某公历年月日的农历月数 + + + + + + + + + 获取阳历日期对应的农历日期 + + + + + + + + + + + + + 获得某公历年月日的农历月日和是否闰月的信息 + + + + + + + + + + + + 获得等效标准日数对应的某公历日，倒推而来 + + + + + + + + + + 比较两个农历日期（包括闰月信息），1 大于2返回1、1等于2返回0、1小于2返回-1 + + + + + + + + + + + + + + 获得某农历年月日（加是否闰月）的公历年月日 + 该函数采用反向二分法查找 + + + + + + + + + + + + + 获取农历某一个月的总天数 + + + + + + + + + 获取农历年份，范围约1901-2101年 + + + + + + + 获取农历年份，范围约0-9999年 + + + + + + + + + 获取农历月份，范围约1901-2101年 + + + + + + + 获取农历月份，范围约0-9999年 + + + + + + + + + 获取中文表示的农历月份 + + + + + + + 获取农历日，范围约1901-2101年 + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + + + 获取农历日，范围约0-9999年 + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 返回y年第n个节气（如小寒为1）的日差天数值（pd取值真假，分别表示平气和定气） + + + + pd取值真假，分别表示平气和定气 + + + + + 获取等效标准日数 + + + + + + + + + 取本月天数，不考虑 1582 年 10 月的特殊情况 + + + + + + + + 获取节气，范围约1901-2101年 + + + + + + + 获取节气，范围约0-9999年 + + + + + + + + + 获取节气 + + + + + + + + + + + + 获取公历节日 + + + + + + + 获取公历节日 + + + + + + + + + 获取指定月份的第n个星期几的节日 + + + + + + + 返回星座，范围约1901-2101年 + + + + + 返回星座，范围约0-9999年 + + + + + 获取农历节日 + + + + + + + + + 获取农历节日 + + + + + + + 判断y年m月(1,2,..,12,下同)d日是Gregorian历还是Julian历（opt=1,2,3分别表示标准日历,Gregorge历和Julian历）,是则返回1，是Julian历则返回0，若是Gregorge历所删去的那10天则返回-1 + + + + + 返回阳历y年m月d日的日差天数（在y年年内所走过的天数，如2000年3月1日为61） + + + + + 返回阳历y年日差天数为x时所对应的月日数（如y=2000，x=274时，返回1001(表示10月1日，即返回100*m+d)） + + + + + 获取指定日期的节气。 + + 要获取的年 + 要获取的月 + + + 立春：立是开始的意思，春是蠢动，表示万物开始有生气，这一天春天开始。 + 雨水：降雨开始，雨水将多。 + 惊蛰：春雷响动，惊动蛰伏地下冬眠的生物，它们将开始出土活动。 + 春分：这是春季九十天的中分点，这一天昼夜相等，所以古代曾称春分秋分为昼夜分。 + 清明：明洁晴朗，气候温暖，草木开始萌发繁茂。 + 谷雨：雨生百谷的意思。雨水增多，适时的降雨对谷物生长很为有利。 + 立夏：夏天开始，万物渐将随温暖的气候而生长。 + 小满：满指籽粒饱满，麦类等夏热作物这时开始结籽灌浆，即将饱满。 + 芒种：有芒作物开始成熟，此时也是秋季作物播种的最繁忙时节。 + 夏至：白天最长，黑夜最短，这一天中午太阳位置最高，日影短至终极，古代又称这一天为日北至或长日至。 + 小暑：暑是炎热，此时还未到达最热。 + 大暑：炎热的程度到达高峰。 + 立秋：秋天开始，植物快成熟了。 + 处暑：处是住的意思，表示暑气到此为止。 + 白露：地面水气凝结为露，色白，是天气开始转凉了。 + 秋分：秋季九十天的中间，这一天昼夜相等，同春分一样，太阳从正东升起正西落下。 + 寒露：水露先白而后寒，是气候将逐渐转冷的意思。 + 霜降：水气开始凝结成霜。 + 立冬：冬是终了，作物收割后要收藏起来的意思，这一天起冬天开始。 + 小雪：开始降雪，但还不多。 + 大雪：雪量由小增大。 + 冬至：这一天中午太阳在天空中位置最低，日影最长，白天最短， 黑夜最长，古代又称短日至或日南至。 + 小寒：冷气积久而为寒，此时尚未冷到顶点。 + 大寒：天候达到最寒冷的程度 + + + + + 获取年柱。 + + + + + 获得月柱 + + + + + + + 获取日柱。 + + + + + 返回甲子数x对应的天干数（如33为3） + + + + + 返回甲子数x对应的地支数（如33为9） + + + + + 获取日的天干地支 + + + + + + + 返回甲子数x对应的天干字符串 + + + + + 返回甲子数x对应的地支字符串 + + + + + 返回甲子数x对应的干支字符串 + + + + + + + 获取三伏开始时间 + + + 0表示1伏，1表示2伏，2表示3伏 + + + + + 节气 + + + + + 节气的时间。 + + + + + 节气名。 + + + + + 热键转换类 + + + + + 功能键。 + + + + + 修改键。 + + + + + 转换功能键到谷歌浏览器专用 + + + + + 将chrome功能键转换为普通功能键 + + + + + + + 按键值。 + + + + + 初始化类 的新实例。 + + The modifiers. + The key code. + + + + + + + + + + + + + + + + + 初始化类 的新实例。 + + + + + 加载热键 + + + + + + + 加载热键 + + + + + + 加载热键 + + + + + + 判断是否是热键 + + + + + 获取当前热键 + + + + + 已重载，返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 返回“Ctrl+Alt+A”格式的字符串。 + + 类似“Ctrl+Alt+A”格式的字符串 + + + + 功能键 + + + + + 无 + + + + + Alt键 + + + + + Ctrl键 + + + + + Alt+Ctrl键 + + + + + Shift键 + + + + + Shift+Alt键 + + + + + Shift+Ctrl键 + + + + + Alt+Shift+Ctrl键 + + + + + Win键 + + + + + 热键类 + + + + + 热键类 + + + + + + 热键注销 + + + + + 热键是否有效 + + + + + 释放热键 + + + + + 获取热键Tag + + + + + + + 获取热键id + + + + + + + 获取热键id + + + + + + + + 判断热键id是否存在 + + + + + + + 判断热键Tag是否存在 + + + + + + + 判断热键是否存在 + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + 注册热键 + + + + + + + + + + 获取热键数量 + + + + + 删除热键 + + + + + + + 删除所有热键 + + + + + 删除所有热键 + + + + + 热键事件 + + + + + + 当使用热键时发生的事件 + + + + + 热键消息过滤 + + + + + + + 热键类型 + + + + + 热键id + + + + + 热键Tag + + + + + 功能键 + + + + + 普通键 + + + + + 热键类型 + + + + + + + + 热键类型 + + + + + + + + + 热键类型 + + + + + Win32 API + + + + + + + + + + WM_COPYDATA消息的主要目的是允许在进程间传递只读数据。 + + + + + 系统通道ID + + + + + 用户通道ID + + + + + 获取消息 + + + + + + + + 发送消息 + + + + + + + + + + 设置父窗口 + + + + + + + + + + + + + + 删除一个逻辑笔、画笔、字体、位图、区域或者调色板，释放所有与该对象有关的系统资源，在对象被删除之后，指定的句柄也就失效了。 + + + + + + + 选择一对象到指定的设备上下文环境中，该新对象替换先前的相同类型的对象。 + + + + + + + + 创建一个与指定设备兼容的内存设备上下文环境（DC）。 + + + + + + + 为一个设备创建设备上下文环境。 + + + + + + + + + + 删除指定的设备上下文环境（Dc）。 + + + + + + + + + + + + 结束进程 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 模拟鼠标点击 + + + + + + + + + + + 模拟按键 + + + + + + + + + 返回hWnd参数所指定的窗口的设备环境。 + + + + + + + 移动窗口 + + + + + + + + + + + + 将消息信息传送给指定的窗口过程的函数。使用函数CallWindowsProc可进行窗口子分类。 + 通常来说，同一类的所有窗口共享一个窗口过程。子类是一个窗口或者相同类的一套窗口， + 在其消息被传送到该类的窗口过程之前，这些消息是由另一个窗口过程进行解释和处理的。 + + + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 用来改变指定窗口的属性．函数也将指定的一个32位值设置在窗口的额外存储空间的指定偏移位置。 + + + + + + + + + 设置弹出式窗口，层叠窗口或子窗口的父窗口 + + + + + + + + 获得一个指定子窗口的父窗口句柄 + + Handle to the window whose parent window handle is to be retrieved. + If the window is a child window, the return value is a handle to the parent window. If the window is a top-level window, the return value is a handle to the owner window. If the window is a top-level unowned window or if the function fails, the return value is NULL. + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作 + + + + + 获取系统菜单的句柄 + + 拥有窗口菜单拷贝的窗口的句柄 + 标志位，指定将执行的操作。 + 如果此参数为FALSE，GetSystemMenu返回当前使用窗口菜单的拷贝的句柄。该拷贝初始时与窗口菜单相同，但可以被修改。 + 如果此参数为TRUE，GetSystemMenu重置窗口菜单到缺省状态。如果存在先前的窗口菜单，将被销毁。 + + 如果参数bRevert为FALSE，返回值是窗口菜单的拷贝的句柄：如果参数bRevert为TRUE，返回值是NULL。 + + + + 从指定菜单删除一个菜单项或分离一个子菜单。 + 备注：只要一个菜单被修改，无论它是否在显示窗口里，应用程序都必须调用函数DrawMenuBar。 + + 将被修改的菜单的句柄。 + 指定将被删除的菜单项，其含义由参数wFlags决定。 + + 如果函数调用成功，返回非零值；如果函数调用失败，返回值是零。若想获得更多的错误信息，请调用GetLastError函数。 + + + + 设置前台窗口 + + + + + + + 获取当前前台窗口句柄 + + + + + + 获得当前活动窗体 + + 活动窗口的句柄。如没有窗口处于活动状态或处于活动状态的窗口非当前线程创建，则返回零。 + + + + 设置活动窗体 + + + + + + + 获取类名 + + + + + + + + + 获取当前线程对应的进程ID + + + + + + + + 判断指定句柄是否是一个窗口 + + + + + + + 获取窗口标题 + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + + 发送消息 + + + + + + + + + 从文件中载入指针 + + + + + + + 判断窗口是否可见 + + + + + + + 查找窗口 + + + + + + + + The FindWindowEx function retrieves a handle to a window whose class name and window name match the specified strings. The function searches child windows, beginning with the one following the specified child window. + + Handle to the parent window whose child windows are to be searched. + Handle to a child window. + Specifies class name. + Pointer to a null-terminated string that specifies the window name (the window's title). + If the function succeeds, the return value is a handle to the window that has the specified class and window names.If the function fails, the return value is NULL. + + + + The InvalidateRect function adds a rectangle to the specified window's update region. + + Handle to window. + Rectangle coordinates. + Erase state. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + The ValidateRect function validates the client area within a rectangle by removing the rectangle from the update region of the specified window. + + Handle to window. + Validation rectangle coordinates. + If the function succeeds, the return value is true.If the function fails, the return value is false. + + + + 获取指定窗口的有关信息，也可用于获取窗口内存中指定偏移的32位度整型值。 + + + + + + + + 检索一指定窗口的客户区域或整个屏幕的显示设备上下文环境的句柄，以后可以在GDI函数中使用该句柄来在设备上下文环境中绘图。 + + + + + + + 释放设备上下文环境（DC）供其他应用程序使用。函数的效果与设备上下文环境类型有关。它只释放公用的和设备上下文环境，对于类或私有的则无效。 + + + + + + + + 获取桌面句柄 + + + + + + 获取窗口客户区的大小。注意一下：窗口的客户区为窗口中除标题栏、菜单栏之外的地方。 + + + + + + + + 返回指定窗口的边框矩形的尺寸。该尺寸以相对于屏幕坐标左上角的屏幕坐标给出。 + + + + + + + + 更新一个分层窗口的位置，大小，形状，内容和半透明度 + + + + + + + + + + + + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + A handle to the window. + A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + Specifies the new position of the left side of the window, in client coordinates. + Specifies the new position of the top of the window, in client coordinates. + Specifies the new width of the window, in pixels. + Specifies the new height of the window, in pixels. + Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + + + + 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + + + + + + + + + + + + + 设置指针位置 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使用的数据库接口 + + + + + 使用的数据库连接字符串 + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 使用的数据库接口 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + FTP数据管理类(不含上传下载功能) + + + + + + + + + + + + 获取指定id的FTP信息 + + + + + + + 获取指定name的FTP信息 + + + + + + + 打开FTP管理界面 + + + + + 创建SQLite数据库表 + + + + + FTP信息 + + + + + id + + + + + 名称 + + + + + IP + + + + + 端口 + + + + + 用户名 + + + + + 密码 + + + + + 远程目录 + + + + + 加密方式 + + + + + 添加时间 + + + + + + + + + + 备注 + + + + + 添加时间字符串 + + + + + 设置 + + + + + 部门列表 + + + + + + + + + + 远程文件信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 升级地址 + + + + + + + + + + 隔多久后再次检查更新 + + + + + 本地保存的配置信息 + + + + + 当前安装的软件版本 + + + + + 当前安装的软件修正版本 + + + + + 当前安装的数据库版本 + + + + + + + + + + + + + + + + + + + + 获取当前更新的类型 + + + + + 每隔n小时检测一次更新 + + + + + 读取版本信息完成后激发 + + + + + 没有版本更新时激发 + + + + + 发现新版本时激发 + + + + + 发生错误后激发 + + + + + 更新进度变化后激发 + + + + + 开始检测新版本 + + + + + + + + + + 初始化升级函数 + + 为null,则表示事件运行在多线程模式下，否则,事件是在窗体所在线程下 + + + + + + + + + + + + + + 获取版本信息 + + + + + 开始下载 + + + + + 开始下载 + + + + + 下载,不使用多线程 + + + + + 结束下载 + + + + + + + + + + + + + + + 设置升级 + + + + + 是否是在线更新 + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + 提示文本 + + + + + 更新日期 + + + + + 更新版本 + + + + + 更新描述 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新类型,soft或者data + + + + + 更新描述Url + + + + + 更新描述 + + + + + 版本 + + + + + 更新日期 + + + + + 更新地址 + + + + + 在下载升级包前首先要下载的内容 + + + + + 升级程序要使用的设置xml + + + + + + + + + + 错误字符串 + + + + + 错误id + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前登陆用户 + + + + + + + + + + 没有版本更新时激发 + + + + + + + + + + + 取消更新。 + + + + + + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 Docking 的本地化字符串。 + + + + + 查找类似 Docking Notification 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 Property Changed 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 Determines if end user drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 Enable/Disable the close button of the content. 的本地化字符串。 + + + + + 查找类似 Shows or hides the close button of the content. This property does not function with System MDI Document Style. 的本地化字符串。 + + + + + 查找类似 The form must be of type IDockContent. 的本地化字符串。 + + + + + 查找类似 Gets or sets a value indicating in which area of the DockPanel the content allowed to show. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of DockState property changed. 的本地化字符串。 + + + + + 查找类似 Indicates the content will be hidden instead of being closed. 的本地化字符串。 + + + + + 查找类似 The desired docking state when first showing. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找类似 The tab text displayed in the dock pane. If not set, the Text property will be used. 的本地化字符串。 + + + + + 查找类似 The text displayed when mouse hovers over the tab. 的本地化字符串。 + + + + + 查找类似 The provided value is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Value: The value of DockAreas conflicts with current DockState. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 The pane is invalid. Check the IsFloat and DockPanel properties of this dock pane. 的本地化字符串。 + + + + + 查找类似 Invalid value, conflicts with DockableAreas property. 的本地化字符串。 + + + + + 查找类似 The dock state is invalid. 的本地化字符串。 + + + + + 查找类似 The dock panel is null. 的本地化字符串。 + + + + + 查找类似 Invalid beforeContent, it must be contained by the pane. 的本地化字符串。 + + + + + 查找类似 Invalid DockState: Content can not be showed as "Unknown" or "Hidden". 的本地化字符串。 + + + + + 查找类似 The previous pane is invalid. It can not be null, and its docking state must not be auto-hide. 的本地化字符串。 + + + + + 查找类似 DockPanel can not be null. 的本地化字符串。 + + + + + 查找类似 The Pane can not be null. 的本地化字符串。 + + + + + 查找类似 Invalid value, check DockableAreas property. 的本地化字符串。 + + + + + 查找类似 Context menu displayed for the dock pane tab strip. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Press SHIFT for docking to full side. 的本地化字符串。 + + + + + 查找类似 Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid argument: Content can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid argument: The content's DockPanel can not be "null". 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 The specified container conflicts with the IsFloat property. 的本地化字符串。 + + + + + 查找类似 The previous pane does not exist in the nested docking pane collection. 的本地化字符串。 + + + + + 查找类似 The container can not be null. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be null when the nested docking pane collection is not empty. 的本地化字符串。 + + + + + 查找类似 The previous pane can not be itself. 的本地化字符串。 + + + + + 查找类似 FloatWindow property can not be set to "null" when DockState is DockState.Float. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid Content: Content not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 The state for the dock pane is invalid. 的本地化字符串。 + + + + + 查找类似 Auto Hide 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window Position 的本地化字符串。 + + + + + 查找类似 Invalid Content: The content must be auto-hide state and associates with this DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of the AutoHideWindow's ActiveContent changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveContentProperty changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActiveDocument property changed. 的本地化字符串。 + + + + + 查找类似 Occurs when the value of ActivePane property changed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop docking is allowed. 的本地化字符串。 + + + + + 查找类似 Determines if the drag and drop nested docking is allowed. 的本地化字符串。 + + + + + 查找类似 Occurs when a content added to the DockPanel. 的本地化字符串。 + + + + + 查找类似 Occurs when a content removed from the DockPanel. 的本地化字符串。 + + + + + 查找类似 The default size of float window. 的本地化字符串。 + + + + + 查找类似 Provides Visual Studio .Net style docking. 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The visual skin to use when displaying the docked windows. 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 The style of the document window. 的本地化字符串。 + + + + + 查找类似 Determines where the tab strip for Document style content is drawn. 的本地化字符串。 + + + + + 查找类似 The DockPanel has already been initialized. 的本地化字符串。 + + + + + 查找类似 The configuration file's version is invalid. 的本地化字符串。 + + + + + 查找类似 The XML file format is invalid. 的本地化字符串。 + + + + + 查找类似 Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form. 的本地化字符串。 + + + + + 查找类似 DockPanel configuration file. Author: Weifen Luo, all rights reserved. 的本地化字符串。 + + + + + 查找类似 !!! AUTOMATICALLY GENERATED FILE. DO NOT MODIFY !!! 的本地化字符串。 + + + + + 查找类似 Indicates whether the control layout is right-to-left when the RightToLeft property is set to Yes. 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Shows the hidden autohide content when hovering over the tab. When disabled, the tab must be clicked to show the content. 的本地化字符串。 + + + + + 查找类似 Show close button on each tab 的本地化字符串。 + + + + + 查找类似 Determines if the document icon will be displayed in the tab strip. 的本地化字符串。 + + + + + 查找类似 Support deeply nested controls. Disabling this setting may improve resize performance but may cause heavily nested content not to resize. 的本地化字符串。 + + + + + 查找类似 Close 的本地化字符串。 + + + + + 查找类似 Window List 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找类似 Invalid argument: DockPanel can not be "null". 的本地化字符串。 + + + + + 查找类似 Invalid Index: The index is out of range. 的本地化字符串。 + + + + + 查找类似 Invalid Pane: DockPane not within the collection. 的本地化字符串。 + + + + + 查找类似 Invalid DockPanel. 的本地化字符串。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 查找 System.Byte[] 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 查找 System.Drawing.Bitmap 类型的本地化资源。 + + + + + 一个强类型的资源类，用于查找本地化的字符串等。 + + + + + 返回此类使用的缓存的 ResourceManager 实例。 + + + + + 重写当前线程的 CurrentUICulture 属性，对 + 使用此强类型资源类的所有资源查找执行重写。 + + + + + 查找类似 停靠 的本地化字符串。 + + + + + 查找类似 停靠通知 的本地化字符串。 + + + + + 查找类似 Performance 的本地化字符串。 + + + + + 查找类似 属性已更改 的本地化字符串。 + + + + + 查找类似 (Float) 的本地化字符串。 + + + + + 查找类似 确定是否允许最终用户拖放停靠 的本地化字符串。 + + + + + 查找类似 The size to display the content in auto hide mode. Value < 1 to specify the size in portion; value >= 1 to specify the size in pixel. 的本地化字符串。 + + + + + 查找类似 启用/禁用DockContent的关闭按钮。 的本地化字符串。 + + + + + 查找类似 显示或隐藏DockContent的关闭按钮。此属性不适用于系统MDI文档样式。 的本地化字符串。 + + + + + 查找类似 窗体的类型必须为IDockContent。 的本地化字符串。 + + + + + 查找类似 获取或设置一个值，该值指示允许在DockPanel的哪个区域显示内容。 的本地化字符串。 + + + + + 查找类似 当DockState属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 指示DockContent将隐藏而不是关闭。 的本地化字符串。 + + + + + 查找类似 首次显示时所需的停靠状态。 的本地化字符串。 + + + + + 查找类似 显示停靠窗格选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 停靠窗格中显示的选项卡文本。如果未设置，将使用Text属性。 的本地化字符串。 + + + + + 查找类似 鼠标悬停在选项卡上时显示的文本。 的本地化字符串。 + + + + + 查找类似 提供的值超出范围。 的本地化字符串。 + + + + + 查找类似 无效值：DockAreas的值与当前DockState冲突。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 Pane无效。检查此DockPane的IsFloat和DockPanel属性。 的本地化字符串。 + + + + + 查找类似 无效值，与DockableAreas属性冲突。 的本地化字符串。 + + + + + 查找类似 停靠状态无效。 的本地化字符串。 + + + + + 查找类似 DockPanel 为 null 的本地化字符串。 + + + + + 查找类似 beforeContent无效，它必须包含在pane中。 的本地化字符串。 + + + + + 查找类似 DockState无效：DockContent不能显示为“未知”或“隐藏”。 的本地化字符串。 + + + + + 查找类似 上一个Pane无效。它不能为null，其停靠状态不能自动隐藏。 的本地化字符串。 + + + + + 查找类似 DockPanel不能为null。 的本地化字符串。 + + + + + 查找类似 Pane不能为null。 的本地化字符串。 + + + + + 查找类似 无效值，请检查DockableAreas属性。 的本地化字符串。 + + + + + 查找类似 显示DockPanel选项卡条的上下文菜单。 的本地化字符串。 + + + + + 查找类似 按SHIFT键以停靠到完全侧。 的本地化字符串。 + + + + + 查找类似 无效内容：ActiveContent必须是可见内容之一，如果没有可见内容，则为null。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效参数：DockContent的DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 指定的容器与IsFloat属性冲突。 的本地化字符串。 + + + + + 查找类似 嵌套DockPanel集合中不存在上一个Pane。 的本地化字符串。 + + + + + 查找类似 容器不能为空。 的本地化字符串。 + + + + + 查找类似 当嵌套DockPanel集合不为空时，上一个Pane不能为空。 的本地化字符串。 + + + + + 查找类似 上一个Pane不能是其本身。 的本地化字符串。 + + + + + 查找类似 当DockState为DockState.Float时，FloatWindow属性不能设置为“null”。 的本地化字符串。 + + + + + 查找类似 无效内容：内容不在集合中。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 DockPanel的状态无效。 的本地化字符串。 + + + + + 查找类似 自动隐藏 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 属性 的本地化字符串。 + + + + + 查找类似 无效DockContent：DockContent必须为自动隐藏状态并与此DockPanel关联。 的本地化字符串。 + + + + + 查找类似 当AutoHideWindow的ActiveContent值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveContentProperty值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActiveDocument属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 ActivePane属性的值更改时发生。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放停靠。 的本地化字符串。 + + + + + 查找类似 确定是否允许拖放嵌套停靠。 的本地化字符串。 + + + + + 查找类似 当DockContent添加到DockPanel时发生。 的本地化字符串。 + + + + + 查找类似 从DockPanel中删除DockContent时发生。 的本地化字符串。 + + + + + 查找类似 浮动窗口的默认大小。 的本地化字符串。 + + + + + 查找类似 提供Visual Studio.Net样式的停靠。 的本地化字符串。 + + + + + 查找类似 Size of the bottom docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the left docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 显示停靠窗口时要使用的视觉外观。 的本地化字符串。 + + + + + 查找类似 Size of the right docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 Size of the top docking window. Value < 1 to specify the size in portion; value > 1 to specify the size in pixels. 的本地化字符串。 + + + + + 查找类似 在停靠面板中拖动文档或Pane时发生。 的本地化字符串。 + + + + + 查找类似 文档窗口的样式。 的本地化字符串。 + + + + + 查找类似 确定绘制文档样式内容的选项卡栏的位置。 的本地化字符串。 + + + + + 查找类似 DockPanel已初始化。 的本地化字符串。 + + + + + 查找类似 配置文件的版本无效。 的本地化字符串。 + + + + + 查找类似 XML文件格式无效。 的本地化字符串。 + + + + + 查找类似 父窗体无效。使用DockingMdi或SystemMdi文档样式时，DockPanel控件必须是主MDI容器窗体的子控件。 的本地化字符串。 + + + + + 查找类似 DockPanel配置文件。作者：罗伟芬，版权所有。 的本地化字符串。 + + + + + 查找类似 !!! 自动生成的文件。不要修改！！！ 的本地化字符串。 + + + + + 查找类似 指示当RightToLeft属性设置为“是”时，控件布局是否从右向左。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 悬停在选项卡上时显示隐藏的自动隐藏内容。禁用时，必须单击选项卡才能显示内容。 的本地化字符串。 + + + + + 查找类似 在每个选项卡上显示关闭按钮 的本地化字符串。 + + + + + 查找类似 确定是否在选项卡栏中显示文档图标。 的本地化字符串。 + + + + + 查找类似 支持深度嵌套控件。禁用此设置可能会提高调整大小的性能，但可能会导致嵌套严重的内容无法调整大小。 的本地化字符串。 + + + + + 查找类似 关闭 的本地化字符串。 + + + + + 查找类似 窗口列表 的本地化字符串。 + + + + + 查找类似 无效参数：DockPanel不能为“null”。 的本地化字符串。 + + + + + 查找类似 无效索引：索引超出范围。 的本地化字符串。 + + + + + 查找类似 无效Pane：DockPane不在集合中。 的本地化字符串。 + + + + + 查找类似 无效DockPanel. 的本地化字符串。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置是否捕获鼠标 + + + + + 获取或设置是否显示图像信息 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框边框颜色 + + + + + 获取或设置放大图形的原始尺寸 + + + + + 获取或设置放大图像的倍数 + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + 获取或设置用于被操作的图像 + + + + + 获取或设置操作框点的颜色 + + + + + 获取或设置操作框线条的颜色 + + + + + 获取当前选中的区域 + + + + + 获取或设置放大图像的原图大小尺寸 + + + + + 获取或设置图像放大的倍数 + + + + + 获取或设置是否绘制操作框点 + + + + + 获取或设置是否限制鼠标操作区域 + + + + + 获取或设置是否绘制信息展示 + + + + + 获取或设置是否根据图像大小自动调整控件尺寸 + + + + + 获取当前是否绘制的有区域 + + + + + 获取当前是否开始绘制 + + + + + 获取当前操作框是否正在移动 + + + + + 获取或设置操作框是否锁定 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 响应四个按键实现精确移动 + + + + + + + + + + + + 绘制操作框 + + + + + + 绘制图像放大信息 + + + + + + 清空所有操作 + + + + + 手动设置一个块选中区域 + + 要选中区域 + + + + 手动设置一个块选中区域 + + 要选中区域的坐标 + 要选中区域的大小 + + + + 手动设置一个块选中区域 + + 要选中区域的x坐标 + 要选中区域的y坐标 + 要选中区域的宽度 + 要选中区域的高度 + + + + 手动设置信息显示的位置 + + 要显示的位置 + + + + 手动设置信息显示的位置 + + 要显示位置的x坐标 + 要显示位置的y坐标 + + + + 获取操作框内的图像 + + 结果图像 + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标结构信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置Hook + + + + + + 卸载Hook + + + + + + 鼠标状态枚举值 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Martin Lottering : 2007-10-27 + -------------------------------- + This is a usefull control in Filters. Allows you to save space and can replace a Grouped Box of CheckBoxes. + Currently used on the TasksFilter for TaskStatusses, which means the user can select which Statusses to include + in the "Search". + This control does not implement a CheckBoxListBox, instead it adds a wrapper for the normal ComboBox and Items. + See the CheckBoxItems property. + ---------------- + ALSO IMPORTANT: In Data Binding when setting the DataSource. The ValueMember must be a bool type property, because it will + be binded to the Checked property of the displayed CheckBox. Also see the DisplayMemberSingleItem for more information. + ---------------- + Extends the CodeProject PopupComboBox "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp" + by Lukasz Swiatkowski. + + + + + + + + + + The checkbox list control. The public CheckBoxItems property provides a direct reference to its Items. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation and its formatting however is controlled + by the Binded object, since it owns that property. + + + + + Builds a CSV string of the items selected. + + + + + A direct reference to the Items of CheckBoxComboBoxListControl. + You can use it to Get or Set the Checked status of items manually if you want. + But do not manipulate the List itself directly, e.g. Adding and Removing, + since the list is synchronised when shown with the ComboBox.Items. So for changing + the list contents, use Items instead. + + + + + The DataSource of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + The ValueMember of the combobox. Refreshes the CheckBox wrappers when this is set. + + + + + In DataBinding operations, this property will be used as the DisplayMember in the CheckBoxComboBoxListBox. + The normal/existing "DisplayMember" property is used by the TextBox of the ComboBox to display + a concatenated Text of the items selected. This concatenation however is controlled by the Binded + object, since it owns that property. + + + + + Made this property Browsable again, since the Base Popup hides it. This class uses it again. + Gets an object representing the collection of the items contained in this + System.Windows.Forms.ComboBox. + + A System.Windows.Forms.ComboBox.ObjectCollection representing the items in + the System.Windows.Forms.ComboBox. + + + + + + + + + + + + + + + + + Will add an invisible item when the style is DropDownList, + to help maintain the correct text in main TextBox. + + + + + + + + + + + + A function to clear/reset the list. + (Ubiklou : http://www.codeproject.com/KB/combobox/extending_combobox.aspx?msg=2526813#xx2526813xx) + + + + + Uncheck all items. + + + + + The properties that will be assigned to the checkboxes as default values. + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + A container control for the ListControl to ensure the ScrollBar on the ListControl does not + Paint over the Size grip. Setting the Padding or Margin on the Popup or host control does + not work as I expected. + + + + + + + + + + Prescribed by the Popup class to ensure Resize operations work correctly. + + + + + + This ListControl that pops up to the User. It contains the CheckBoxComboBoxItems. + The items are docked DockStyle.Top in this control. + + + + + + + + + + + Simply a reference to the CheckBoxComboBox. + + + + + A Typed list of ComboBoxCheckBoxItems. + + + + + + + + + + Prescribed by the Popup control to enable Resize operations. + + + + + + + + + + + + Maintains the controls displayed in the list by keeping them in sync with the actual + items in the combobox. (e.g. removing and adding as well as ordering) + + + + + The CheckBox items displayed in the Popup of the ComboBox. + + + + + + + A reference to the CheckBoxComboBox. + A reference to the item in the ComboBox.Items that this object is extending. + + + + A reference to the CheckBoxComboBox. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + A reference to the Item in ComboBox.Items that this object is extending. + + + + + When using Data Binding operations via the DataSource property of the ComboBox. This + adds the required Bindings for the CheckBoxes. + + + + + + + + + + + Added this handler because the control doesn't seem + to initialize correctly until shown for the first + time, which also means the summary text value + of the combo is out of sync initially. + + + + + A Typed List of the CheckBox items. + Simply a wrapper for the CheckBoxComboBox.Items. A list of CheckBoxComboBoxItem objects. + This List is automatically synchronised with the Items of the ComboBox and extended to + handle the additional boolean value. That said, do not Add or Remove using this List, + it will be lost or regenerated from the ComboBox.Items. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Returns the item with the specified displayName or Text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Called when any property changes. + + + + + + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + + + + + CodeProject.com Simple pop-up control http://www.codeproject.com/cs/miscctrl/simplepopup.asp. + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Gets a value indicating whether the PopupControl.Popup uses the fade effect. + + true if pop-up uses the fade effect; otherwise, false. + To use the fade effect, the FocusOnOpen property also has to be set to true. + + + + Gets or sets a value indicating whether to focus the content after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether this PopupControl.Popup is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets the size that is the lower limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the size that is the upper limit that can specify. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the PopupControl.Popup class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows pop-up window below the specified area of specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Adjusts the size of the owner to accommodate the if the owner is currently displayed, or clears and resets active child controls of the if the is not currently displayed. + + true if the owner is currently displayed; otherwise, false. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + + + + + + + + + + + + + + + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the size grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + CodeProject.com "Simple pop-up control" "http://www.codeproject.com/cs/miscctrl/simplepopup.asp". + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the PopupControl.PopupComboBox class. + + + + + The pop-up wrapper for the dropDownControl. + Made PROTECTED instead of PRIVATE so descendent classes can set its Resizable property. + Note however the pop-up properties must be set after the dropDownControl is assigned, since this + popup wrapper is recreated when the dropDownControl is assigned. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Shows the drop down. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Maintains an additional "Selected" and "Count" value for each item in a List. + Useful in the CheckBoxComboBox. It holds a reference to the List[Index] Item and + whether it is selected or not. + It also caters for a Count, if needed. + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. And no Counts will be displayed + + + + + No property on the object is specified for display purposes, so simple ToString() operation + will be performed. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + A Display "Name" property is specified. ToString() will not be performed on items. + This is specifically useful on DataTable implementations, or where PropertyDescriptors are used to read the values. + If a PropertyDescriptor is not found, a Property will be used. + + + + + Is a Count indicator used. + + + + + The original List of values wrapped. A "Selected" and possibly "Count" functionality is added. + + + + + Used to indicate NOT to use ToString(), but read this property instead as a display value. + + + + + When specified, indicates that ToString() should not be performed on the items. + This property will be read instead. + This is specifically useful on DataTable implementations, where PropertyDescriptors are used to read the values. + + + + + Builds a concatenation list of selected items in the list. + + + + + Indicates whether the Item display value (Name) should include a count. + + + + + Reset all counts to zero. + + + + + Creates a ObjectSelectionWrapper item. + Note that the constructor signature of sub classes classes are important. + + + + + + + + + + + + + + Used together with the ListSelectionWrapper in order to wrap data sources for a CheckBoxComboBox. + It helps to ensure you don't add an extra "Selected" property to a class that don't really need or want that information. + + + + + + + + + + + + Used as a count indicator for the item. Not necessarily displayed. + + + + + Is this item selected. + + + + + A reference to the wrapped item. + + + + + The containing list for these selections. + + + + + An indicator of how many items with the specified status is available for the current filter level. + Thaught this would make the app a bit more user-friendly and help not to miss items in Statusses + that are not often used. + + + + + A reference to the item wrapped. + + + + + The item display value. If ShowCount is true, it displays the "Name [Count]". + + + + + The textbox display value. The names concatenated. + + + + + Indicates whether the item is selected. + + + + + + + + + + + + + + + + 控件的状态。 + + + + + 正常 + + + + + 鼠标经过 + + + + + 鼠标按下 + + + + + 鼠标的当前位置 + + + + + + + + + + + + + + + + + + + + 美化按钮 + + + + + 普通按钮矩形位置 + + + + + 美化按钮 + + + + + 分割按钮的宽度 + + + + + 是否启用分割按钮 + + + + + 优先使用默认皮肤 + + + + + 按钮基础背景色 + + + + + 按钮字体颜色 + + + + + 图片宽度,默认值为18px，最小12px + + + + + 圆角的位置,默认全部都是圆角 + + + + + 设置圆角半径 + + + + + 背景色是否渐变 + + + + + 图片高度 + + + + + 图片与文字之间的间距 + + + + + 当鼠标按下时图片和文字是否产生偏移 + + + + + 鼠标进入时 + + + + + + 鼠标离开 + + + + + + 鼠标按下 + + + + + + 鼠标弹起 + + + + + + 鼠标当前所在位置 + + + + + 获取图像以及文字的位置 + + + + + + + + + + + + + + + + + + + + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强版Label(禁用了双击Label会自动复制文本到剪切板的功能) + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 增强富文本控件 + + + + + 开始更新 + + + + + 结束更新 + + + + + RichTextBox + + + + + + + + + + + + + + + + + + + + + + + 在自带菜单弹出前激发 + + + + + 根据标签获得菜单项 + + + + + + + 只允许输入文本(只对设置之后的人工输入有效) + + + + + 按下按键 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 鼠标按下 + + + + + + + + + + + + + + + + + + 当文本框为空时,显示的内容。 + + + + + 添加菜单分隔线 + + + + + + 添加菜单 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 消息列表控件 + + + + + 最大高度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 增强时间控件 + + + + + 增强时间控件 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 选择文本框 + + + + + 选择文本框 + + + + + 按钮基础背景色 + + + + + 优先使用默认皮肤 + + + + + 选择的id + + + + + 选择的名称 + + + + + 选择的名称 + + + + + 字体 + + + + + 重新设置大小 + + + + + 在选择时激发 + + + + + 点击选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 建立圆角路径的样式。 + + + + + 四个角都不是圆角。 + + + + + 四个角都为圆角。 + + + + + 左边两个角为圆角。 + + + + + 右边两个角为圆角。 + + + + + 上边两个角为圆角。 + + + + + 下边两个角为圆角。 + + + + + 左下角为圆角。 + + + + + 右下角为圆角。 + + + + + 画图相关API + + + + + 建立带有圆角样式的路径。 + + 用来建立路径的矩形。 + 圆角的大小。 + 圆角的样式。 + 是否把矩形长宽减 1,以便画出边框。 + 建立的路径。 + + + + 窗体皮肤 + + + + + 窗体皮肤 + + + + + 标题属性 + + + + + 是否使用父窗口的图标 + + + + + 点击最小化按钮是最小化还是隐藏 + + + + + 最大化按钮 + + + + + 最小化按钮 + + + + + 标题栏关闭按钮是否显示 + + + + + 当窗口位于后台时，是否标注显示。 + + + + + + + + + + 标题栏字体颜色 + + + + + 标题栏不处于活动状态时的字体颜色 + + + + + 标题栏背景颜色 + + + + + 标题栏不处于活动状态时的背景颜色 + + + + + 是否允许拖拉窗体边缘来改变窗体大小 + + + + + + + + + + + 画边框 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 热键文本框 + + + + + 热键文本框 + + + + + + + + + + + + + + + + + 在控件大小变化时发生 + + + + + + 此属性无效 + + + + + 载入热键配置 + + + + + + 保存热键 + + + + + + 是否含义热键 + + + + + 读取或设置热键 + + + + + 功能键 + + + + + 热键按键 + + + + + KeyDown事件 + + + + + + KeyDown事件 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 可以改变文本行距（行间距）的Label + + + + + 行间距 + + + + + 可以改变文本行距（行间距）的Label + + + + + + + + + + 字体高度 + + + + + + + + + + 文本 + + + + + + + + + + + + + + + + + + + 图标列表控件 + + + + + + + + + + + + 图标列表控件 + + + + + 图标大小 + + + + + 文本显示高度(从底部算起) + + + + + 默认图标 + + + + + 是否显示图标 + + + + + 是否显示网格线 + + + + + 角标图标合集 + + + + + 画项 + + + + + + 选择项的背景开始颜色 + + + + + 选择项的背景结束颜色 + + + + + 选择项的边框颜色 + + + + + 选择项的字体颜色 + + + + + 重绘选中时背景 + + + + + 重绘图标 + + + 区域大小 + + + + + + + + 重绘文本 + + + + + 获取文本对齐 + + + + + 水平滚动条滚动事件 + + + + + 垂直滚动条滚动事件 + + + + + + + + + + + 列表项 + + + + + 图标 + + + + + 角标图片序号,为-1表示无角标 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 最大高度 + + + + + 标题 + + + + + 是否显示时间 + + + + + 添加时间 + + + + + 内容 + + + + + 网址 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 计算两个日期的时间间隔,返回的是日期值+ + + 时间值,将显示在返回的值里 + 参照时间 + + + + + + + + + + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 控件边框颜色 + + + + + 控件背景颜色 + + + + + 圆角弧度大小 + + + + + 圆角风格 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 图标 + + + + + 标题 + + + + + 悬浮提示 + + + + + 标题颜色 + + + + + 设置按钮 + + + + + + + 判断和设置是否选择 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 绘制边框 + + 消息 + + + + 类说明：CContextMenuStrip控件的实现用来代替系统的ContextMenuStrip控件 + + + + + + + + + + + + + + + + 重写OnCreateControl + + + + + 重写OnPaint事件 + + + + + + CreateRoundedRectanglePath + + Rectangle + + + + + + 系统热键数据类。 + + + + + 系统热键数据类 + + + + + 使多行属性失效掉 + + + + + 使只读属性失效掉 + + + + + 获取热键文本 + + + + + 功能键 + + + + + 热键按键 + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 在搜索时激发 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + + + + + + 文本为空时的显示效果 + + + + + 文本不选中 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + 字体 + + + + + 优先使用默认皮肤 + + + + + 背景色是否渐变 + + + + + 按钮基础背景色 + + + + + 按钮圆角部分背景颜色 + + + + + + + + + + 重新设置大小 + + + + + 点击搜索按钮 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + + + + + + 使用公共皮肤 + + + + + 按钮颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 皮肤公共类 + + + + + 是否使用默认皮肤 + + + + + 按钮皮肤 + + + + + 按钮皮肤类 + + + + + 背景颜色 + + + + + 字体颜色 + + + + + 是否颜色渐变 + + + + + 类说明：帮助类 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 修改控件或窗体的边框，例如Textbox或是Form窗体 + + 消息 + 控件对象 + 边框像素 + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 超级图片控件,支持加载工程内部图片、异步加载网络图片 + + + + + 图片所在上级域名 + + + + + 图片资源所在上级文件夹 + + + + + 根据不同前缀，加载不同格式图片。i:表示工程内置图片;s:表示T_ImageDomain域名下的图片,u:表示指定url的图片;f:表示本地图片 + + + + + + 加载本地图片,加载完毕不会占用本地图片 + + + + + + 加载指定url图片 + + url位置 + 是否异步 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 选项发生变化时激发 + + + + + 标签选择的序号 + + + + + + + + + + 选择的颜色 + + + + + 多标签控件颜色 + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 多标签控件 + + + + + + + + + + 获取对应的标签 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获得当前进程，以便重绘控件 + + + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点边框颜色 + + + + + 是否鼠标MouseOver状态 + + + + + 是否启用热点效果 + + + + + 边框颜色 + + + + + 热点时边框颜色 + + + + + + + + + + 鼠标移动到该控件上时 + + + + + + 当鼠标从该控件移开时 + + + + + + 当该控件获得焦点时 + + + + + + 当该控件失去焦点时 + + + + + + 获得操作系统消息 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 美化文本框控件 + + + + + 文本变化时激发 + + + + + 文本变化时激发 + + + + + 双击时激发 + + + + + + + + + + 是否只能输入数字 + + + + + 是否多行 + + + + + 是否在显示不下时换行 + + + + + 最大长度 + + + + + + + + + + 背景颜色 + + + + + 右键菜单 + + + + + 字体颜色 + + + + + 选择的开始位置 + + + + + 选择的长度 + + + + + 选择的文本 + + + + + 提示文本 + + + + + 选择全部 + + + + + 密码 + + + + + 是否只读 + + + + + + + + + + + 文本为空时的显示效果 + + + + + 字体 + + + + + 有内容时的显示效果 + + + + + 当文本框为空时,显示的内容。 + + + + + + + + + + 选择文本框中的文本范围 + + 文本框中当前选定文本的第一个字符的位置。 + 要选择的字符数 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Define some Windows message constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This class adds to the functionality provided in System.Windows.Forms.MenuStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + This class adds to the functionality provided in System.Windows.Forms.ToolStrip. + + It allows you to "ClickThrough" to the MenuStrip so that you don't have to click once to + bring the form into focus and once more to take the desired action + + It also implements a SuppressHighlighting property to turn off the highlighting + that occures on mouseover when the form is not active + + + + + Gets or sets whether the control honors item clicks when its containing form does + not have input focus. + + + Default value is false, which is the same behavior provided by the base ToolStrip class. + + + + + Gets or sets whether the control shows highlighting on mouseover + + + Default value is true, which is the same behavior provided by the base MenuStrip class. + + + + + This method overrides the procedure that responds to Windows messages. + + It intercepts the WM_MOUSEMOVE message + and ignores it if SuppressHighlighting is on and the TopLevelControl does not contain the focus. + Otherwise, it calls the base class procedure to handle the message. + + It also intercepts the WM_MOUSEACTIVATE message and replaces an "Activate and Eat" result with + an "Activate" result if ClickThrough is enabled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 透明图片控件 + + + + + 是否使用透明,默认为True + + + + + 设置透明度 + + + + + 要绑定的控件 + + + + + 透明图片控件 + + + + + 图片 + + + + + 初始化加载控件 + + 透明度 + 是否显示加载图片 + 图片 + + + + + + + + + + + + + + + 显示加载 + + + + + 隐藏加载 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日历控件 + + + + + 单击事件 + + + + + + + 单击某个日期事件 + + + + + 日历控件 + + + + + 设置日期 + + + + + 放假数据表 + + + + + 是否处于设计模式 + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 日控件 + + + + + 日控件 + + + + + 当前日期 + + + + + 在发生页码变化前激发 + + + + + 设置休息状态,1为休息,-1为上班，其它为不显示 + + + + + + 日期 + + + + + 农历 + + + + + 阳历日期字体颜色 + + + + + 阳历日期字体 + + + + + 农历日期字体 + + + + + 农历部分字体颜色 + + + + + 是否选中 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + 设置管理类,快速添加设置。 + + + + + + 存储类型 + + + + + 配置存储路径 + + + + + 设置XML内容 + + + + + 添加控件 + + + + + + + + 设置值 + + + + + + + + 添加控件 + + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 添加控件 + + + + + + + + + 读取配置 + + + + + 保存配置 + + + + + 类 名:ColorHSL + 功 能:H 色相 \ S 饱和度(纯度) \ L 亮度 颜色模型 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + HSL颜色 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 饱和度 + + + + + 类 名:ColorHSV + 功 能:H 色相 \ S 饱和度(纯度) \ V 明度 颜色模型 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + 色相 + + + + + 饱和度(纯度) + + + + + 明度 + + + + + 类 名:ColorRGB + 功 能:R 红色 \ G 绿色 \ B 蓝色 颜色模型 + 所有颜色模型的基类,RGB是用于输出到屏幕的颜色模式,所以所有模型都将转换成RGB输出 + 日 期:2015-01-22 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + 构造方法 + + + + + + + + + + + + + + 红色 + + + + + 绿色 + + + + + 蓝色 + + + + + 获取实际颜色 + + + + + + 类 名:ColorHelper + 功 能:提供从RGB到HSV/HSL色彩空间的相互转换 + 日 期:2015-02-08 + 修 改:2015-03-20 + 作 者:ls9512 + + + + + RGB转换HSV + + + + + + + HSV转换RGB + + + + + + + RGB转换HSL + + + + + + + HSL转换RGB + + H, S and L input range = 0 -1.0 + + + + + RGB转CMYK + + + + + + + + + + RGB转CMYK + + + + + + + + + + + + CMYK转RGB + + + + + + + + + + Standard-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Standard-RGB,X、Y、Z 使用 D65/2°标准光源. + + + + + + + + + XYZ → Adobe-RGB,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Adobe-RGB → XYZ,X、Y、Z 使用 D65/2°标准光源.RGB Adobe 1998 + + + + + + + + + Yxy转RGB + + + + + + + + + RGB转Yxy + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + 超级颜色选择控件 + + + 分页控件 + + + + + + + + + + + + + + + + + + + + + + + + + + 获取网页颜色 + + + + + 超级颜色选择控件 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要修改 + 使用代码编辑器修改此方法的内容。 + + + + + Chrome风格的多标签控件 + + + + + 设置选项卡处于选中状态时第一背景色. + + + + + 设置选项卡处于选中状态时第二背景色. + + + + + 设置选项卡处于非选中状态时第一背景色. + + + + + 设置选项卡处于非选中状态时第二背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第一背景色. + + + + + 设置鼠标移动到非选中状态选项卡时第二背景色. + + + + + 设置选项卡工作区背景色. + + + + + 设置选项卡工作区背景图. + + + + + 是否显示关闭按钮 + + + + + 是否显示新增按钮 + + + + + 是否允许拖拽标签 + + + + + 标签最大宽度 + + + + + 标签右键菜单 + + + + + 鼠标按下标签时激发 + + + + + 鼠标放开标签时激发 + + + + + Chrome风格的多标签控件 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 设置圆角半径 + + + + + Tab文字左边距离 + + + + + + + + + + + + + + 画标签文字 + + + + + + + + + 画标签图标 + + + + + + + 画关闭按钮 + + + + + + + + 获取所有选项卡合起来的宽度 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 添加新标签 + + + + + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + The position is not over a tab. + + + + + The position is over a tab's icon. + + + + + The position is over a tab's text. + + + + + The position is over a tab but not over its icon or its text. For owner-drawn tab controls, this value is specified if the position is anywhere over a tab. + TCHT_ONITEM is a bitwise-OR operation on TCHT_ONITEMICON and TCHT_ONITEMLABEL. + + + + + Specifies values from SetWindowPosZ enumeration. + + + + + Specified HWND_TOP enumeration value. + + + + + Specified HWND_BOTTOM enumeration value. + + + + + Specified HWND_TOPMOST enumeration value. + + + + + Specified HWND_NOTOPMOST enumeration value. + + + + + Invalidates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_INVALIDATE invalidates the entire window. + + + + Causes the OS to post a WM_PAINT message to the window regardless of whether a portion of the window is invalid. + + + + Causes the window to receive a WM_ERASEBKGND message when the window is repainted. + Specify this value in combination with the RDW_INVALIDATE value; otherwise, RDW_ERASE has no effect. + + + + + Validates the rectangle or region that you specify in lprcUpdate or hrgnUpdate. + You can set only one of these parameters to a non-NULL value. If both are NULL, RDW_VALIDATE validates the entire window. + This value does not affect internal WM_PAINT messages. + + + + Suppresses any pending WM_ERASEBKGND messages. + + + Excludes child windows, if any, from the repainting operation. + + + Includes child windows, if any, in the repainting operation. + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND and WM_PAINT messages before the RedrawWindow returns, if necessary. + + + + Causes the affected windows, which you specify by setting the RDW_ALLCHILDREN and RDW_NOCHILDREN values, to receive WM_ERASEBKGND messages before RedrawWindow returns, if necessary. + The affected windows receive WM_PAINT messages at the ordinary time. + + + + + Specifies values from Msgs enumeration. + + + + + Specified WM_NULL enumeration value. + + + + + Specified WM_CREATE enumeration value. + + + + + Specified WM_DESTROY enumeration value. + + + + + Specified WM_MOVE enumeration value. + + + + + Specified WM_SIZE enumeration value. + + + + + Specified WM_ACTIVATE enumeration value. + + + + + Specified WM_SETFOCUS enumeration value. + + + + + Specified WM_KILLFOCUS enumeration value. + + + + + Specified WM_ENABLE enumeration value. + + + + + Specified WM_SETREDRAW enumeration value. + + + + + Specified WM_SETTEXT enumeration value. + + + + + Specified WM_GETTEXT enumeration value. + + + + + Specified WM_GETTEXTLENGTH enumeration value. + + + + + Specified WM_PAINT enumeration value. + + + + + Specified WM_CLOSE enumeration value. + + + + + Specified WM_QUERYENDSESSION enumeration value. + + + + + Specified WM_QUIT enumeration value. + + + + + Specified WM_QUERYOPEN enumeration value. + + + + + Specified WM_ERASEBKGND enumeration value. + + + + + Specified WM_SYSCOLORCHANGE enumeration value. + + + + + Specified WM_ENDSESSION enumeration value. + + + + + Specified WM_SHOWWINDOW enumeration value. + + + + + Specified WM_WININICHANGE enumeration value. + + + + + Specified WM_SETTINGCHANGE enumeration value. + + + + + Specified WM_DEVMODECHANGE enumeration value. + + + + + Specified WM_ACTIVATEAPP enumeration value. + + + + + Specified WM_FONTCHANGE enumeration value. + + + + + Specified WM_TIMECHANGE enumeration value. + + + + + Specified WM_CANCELMODE enumeration value. + + + + + Specified WM_SETCURSOR enumeration value. + + + + + Specified WM_MOUSEACTIVATE enumeration value. + + + + + Specified WM_CHILDACTIVATE enumeration value. + + + + + Specified WM_QUEUESYNC enumeration value. + + + + + Specified WM_GETMINMAXINFO enumeration value. + + + + + Specified WM_PAINTICON enumeration value. + + + + + Specified WM_ICONERASEBKGND enumeration value. + + + + + Specified WM_NEXTDLGCTL enumeration value. + + + + + Specified WM_SPOOLERSTATUS enumeration value. + + + + + Specified WM_DRAWITEM enumeration value. + + + + + Specified WM_MEASUREITEM enumeration value. + + + + + Specified WM_DELETEITEM enumeration value. + + + + + Specified WM_VKEYTOITEM enumeration value. + + + + + Specified WM_CHARTOITEM enumeration value. + + + + + Specified WM_SETFONT enumeration value. + + + + + Specified WM_GETFONT enumeration value. + + + + + Specified WM_SETHOTKEY enumeration value. + + + + + Specified WM_GETHOTKEY enumeration value. + + + + + Specified WM_QUERYDRAGICON enumeration value. + + + + + Specified WM_COMPAREITEM enumeration value. + + + + + Specified WM_GETOBJECT enumeration value. + + + + + Specified WM_COMPACTING enumeration value. + + + + + Specified WM_COMMNOTIFY enumeration value. + + + + + Specified WM_WINDOWPOSCHANGING enumeration value. + + + + + Specified WM_WINDOWPOSCHANGED enumeration value. + + + + + Specified WM_POWER enumeration value. + + + + + Specified WM_COPYDATA enumeration value. + + + + + Specified WM_CANCELJOURNAL enumeration value. + + + + + Specified WM_NOTIFY enumeration value. + + + + + Specified WM_INPUTLANGCHANGEREQUEST enumeration value. + + + + + Specified WM_INPUTLANGCHANGE enumeration value. + + + + + Specified WM_TCARD enumeration value. + + + + + Specified WM_HELP enumeration value. + + + + + Specified WM_USERCHANGED enumeration value. + + + + + Specified WM_NOTIFYFORMAT enumeration value. + + + + + Specified WM_CONTEXTMENU enumeration value. + + + + + Specified WM_STYLECHANGING enumeration value. + + + + + Specified WM_STYLECHANGED enumeration value. + + + + + Specified WM_DISPLAYCHANGE enumeration value. + + + + + Specified WM_GETICON enumeration value. + + + + + Specified WM_SETICON enumeration value. + + + + + Specified WM_NCCREATE enumeration value. + + + + + Specified VK_RMENU enumeration value. + + + + + Specified WM_NCCALCSIZE enumeration value. + + + + + Specified WM_NCHITTEST enumeration value. + + + + + Specified WM_NCPAINT enumeration value. + + + + + Specified WM_NCACTIVATE enumeration value. + + + + + Specified WM_GETDLGCODE enumeration value. + + + + + Specified WM_SYNCPAINT enumeration value. + + + + + Specified WM_NCMOUSEMOVE enumeration value. + + + + + Specified WM_NCLBUTTONDOWN enumeration value. + + + + + Specified WM_NCLBUTTONUP enumeration value. + + + + + Specified WM_NCLBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCRBUTTONDOWN enumeration value. + + + + + Specified WM_NCRBUTTONUP enumeration value. + + + + + Specified WM_NCRBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCMBUTTONDOWN enumeration value. + + + + + Specified WM_NCMBUTTONUP enumeration value. + + + + + Specified WM_NCMBUTTONDBLCLK enumeration value. + + + + + Specified WM_NCXBUTTONDOWN enumeration value. + + + + + Specified WM_NCXBUTTONUP enumeration value. + + + + + Specified WM_KEYDOWN enumeration value. + + + + + Specified WM_KEYUP enumeration value. + + + + + Specified WM_CHAR enumeration value. + + + + + Specified WM_DEADCHAR enumeration value. + + + + + Specified WM_SYSKEYDOWN enumeration value. + + + + + Specified WM_SYSKEYUP enumeration value. + + + + + Specified WM_SYSCHAR enumeration value. + + + + + Specified WM_SYSDEADCHAR enumeration value. + + + + + Specified WM_KEYLAST enumeration value. + + + + + Specified WM_IME_STARTCOMPOSITION enumeration value. + + + + + Specified WM_IME_ENDCOMPOSITION enumeration value. + + + + + Specified WM_IME_COMPOSITION enumeration value. + + + + + Specified WM_IME_KEYLAST enumeration value. + + + + + Specified WM_INITDIALOG enumeration value. + + + + + Specified WM_COMMAND enumeration value. + + + + + Specified WM_SYSCOMMAND enumeration value. + + + + + Specified WM_TIMER enumeration value. + + + + + Specified WM_HSCROLL enumeration value. + + + + + Specified WM_VSCROLL enumeration value. + + + + + Specified WM_INITMENU enumeration value. + + + + + Specified WM_INITMENUPOPUP enumeration value. + + + + + Specified WM_MENUSELECT enumeration value. + + + + + Specified WM_MENUCHAR enumeration value. + + + + + Specified WM_ENTERIDLE enumeration value. + + + + + Specified WM_MENURBUTTONUP enumeration value. + + + + + Specified WM_MENUDRAG enumeration value. + + + + + Specified WM_MENUGETOBJECT enumeration value. + + + + + Specified WM_UNINITMENUPOPUP enumeration value. + + + + + Specified WM_MENUCOMMAND enumeration value. + + + + + Specified WM_CTLCOLORMSGBOX enumeration value. + + + + + Specified WM_CTLCOLOREDIT enumeration value. + + + + + Specified WM_CTLCOLORLISTBOX enumeration value. + + + + + Specified WM_CTLCOLORBTN enumeration value. + + + + + Specified WM_CTLCOLORDLG enumeration value. + + + + + Specified WM_CTLCOLORSCROLLBAR enumeration value. + + + + + Specified WM_CTLCOLORSTATIC enumeration value. + + + + + Specified WM_MOUSEMOVE enumeration value. + + + + + Specified WM_LBUTTONDOWN enumeration value. + + + + + Specified WM_LBUTTONUP enumeration value. + + + + + Specified WM_LBUTTONDBLCLK enumeration value. + + + + + Specified WM_RBUTTONDOWN enumeration value. + + + + + Specified WM_RBUTTONUP enumeration value. + + + + + Specified WM_RBUTTONDBLCLK enumeration value. + + + + + Specified WM_MBUTTONDOWN enumeration value. + + + + + Specified WM_MBUTTONUP enumeration value. + + + + + Specified WM_MBUTTONDBLCLK enumeration value. + + + + + Specified WM_MOUSEWHEEL enumeration value. + + + + + Specified WM_XBUTTONDOWN enumeration value. + + + + + Specified WM_XBUTTONUP enumeration value. + + + + + Specified WM_XBUTTONDBLCLK enumeration value. + + + + + Specified WM_PARENTNOTIFY enumeration value. + + + + + Specified WM_ENTERMENULOOP enumeration value. + + + + + Specified WM_EXITMENULOOP enumeration value. + + + + + Specified WM_NEXTMENU enumeration value. + + + + + Specified WM_SIZING enumeration value. + + + + + Specified WM_CAPTURECHANGED enumeration value. + + + + + Specified WM_MOVING enumeration value. + + + + + Specified WM_DEVICECHANGE enumeration value. + + + + + Specified WM_MDICREATE enumeration value. + + + + + Specified WM_MDIDESTROY enumeration value. + + + + + Specified WM_MDIACTIVATE enumeration value. + + + + + Specified WM_MDIRESTORE enumeration value. + + + + + Specified WM_MDINEXT enumeration value. + + + + + Specified WM_MDIMAXIMIZE enumeration value. + + + + + Specified WM_MDITILE enumeration value. + + + + + Specified WM_MDICASCADE enumeration value. + + + + + Specified WM_MDIICONARRANGE enumeration value. + + + + + Specified WM_MDIGETACTIVE enumeration value. + + + + + Specified WM_MDISETMENU enumeration value. + + + + + Specified WM_ENTERSIZEMOVE enumeration value. + + + + + Specified WM_EXITSIZEMOVE enumeration value. + + + + + Specified WM_DROPFILES enumeration value. + + + + + Specified WM_MDIREFRESHMENU enumeration value. + + + + + Specified WM_IME_SETCONTEXT enumeration value. + + + + + Specified WM_IME_NOTIFY enumeration value. + + + + + Specified WM_IME_CONTROL enumeration value. + + + + + Specified WM_IME_COMPOSITIONFULL enumeration value. + + + + + Specified WM_IME_SELECT enumeration value. + + + + + Specified WM_IME_CHAR enumeration value. + + + + + Specified WM_IME_REQUEST enumeration value. + + + + + Specified WM_IME_KEYDOWN enumeration value. + + + + + Specified WM_IME_KEYUP enumeration value. + + + + + Specified WM_MOUSEHOVER enumeration value. + + + + + Specified WM_UNDO enumeration value. + + + + + Specified WM_RENDERFORMAT enumeration value. + + + + + Specified WM_RENDERALLFORMATS enumeration value. + + + + + Specified WM_DESTROYCLIPBOARD enumeration value. + + + + + Specified WM_DRAWCLIPBOARD enumeration value. + + + + + Specified WM_PAINTCLIPBOARD enumeration value. + + + + + Specified WM_VSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_SIZECLIPBOARD enumeration value. + + + + + Specified WM_ASKCBFORMATNAME enumeration value. + + + + + Specified WM_CHANGECBCHAIN enumeration value. + + + + + Specified WM_HSCROLLCLIPBOARD enumeration value. + + + + + Specified WM_QUERYNEWPALETTE enumeration value. + + + + + Specified WM_PALETTEISCHANGING enumeration value. + + + + + Specified WM_PALETTECHANGED enumeration value. + + + + + Specified WM_HOTKEY enumeration value. + + + + + Specified WM_PRINT enumeration value. + + + + + Specified WM_PRINTCLIENT enumeration value. + + + + + Specified WM_HANDHELDFIRST enumeration value. + + + + + Specified WM_HANDHELDLAST enumeration value. + + + + + Specified WM_AFXFIRST enumeration value. + + + + + Specified WM_AFXLAST enumeration value. + + + + + Specified WM_PENWINFIRST enumeration value. + + + + + Specified WM_PENWINLAST enumeration value. + + + + + Specified WM_APP enumeration value. + + + + + Specified WM_USER enumeration value. + + + + + Specified WM_REFLECT enumeration value. + + + + + Specified WM_THEMECHANGED enumeration value. + + + + + + + + + + 关键词 + + + + + 密码 + + + + + 权限用户id + + + + + + + + + + + + + 返回关键词 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 树形控件，用于分类用 + + + + + 显示在第一位的名称 + + + + + 是否显示菜单 + + + + + 树形控件 + + + + + 判断指定节点是否是目标节点的子节点 + + + + + + + + + 判断当前节点，当前用户是否有权限访问 + + + + + + + + + 权限事件 + + + + + + + + 选择权限用户时发生 + + + + + 数据变化时发生 + + + + + 数据变化前发生 + + + + + 操作事件 + + + + + + + 在添加分组前发生 + + + + + 在修改分组前发生 + + + + + 在删除分组前发生 + + + + + 在设置密码前发生 + + + + + 在设置权限前发生 + + + + + 获取新的关键词分类 + + + + + + 根据id获取节点 + + + + + + + 根据节点获取节点信息 + + + + + + + 设置节点信息 + + + + + + + 设置节点关键词和密码 + + + + + + + + 设置节点密码 + + + + + + + 设置节点关键词 + + + + + + + 设置节点用户 + + + + + + + RecursionTreeControl:表示将XML文件的内容显示在TreeView控件中 + + 将要加载的XML文件中的节点元素 + 将要加载的XML文件中的节点集合 + + + + 把XML文本载入到列表中 + + + + + + 把XML文件载入到列表中 + + + + + + 将列表保存为xml文本 + + + + + + 改变所有子节点的状态 + + + + + + + 反选子节点 + + + + + + 根据关键词来选中列表 + + + + + + 根据关键词来选中列表 + + + + + + 格式化关键字(会去除重复项)，以便存入数据库 + + + + + + + 去除掉重复项 + + + + + + + 获取当前选中项以及所有父项的关键词组合 + + + + + + 获取选中的 + + + + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + + + + + + 是否为添加 + + + + + 选择的文本 + + + + + 选择的Tag + + + + + 选择的图片序号 + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + 旧密码 + + + + + 新密码 + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 控件状态 + + + + + 无 + + + + + 获得焦点 + + + + + 失去焦点 + + + + + 鼠标指针进入控件 + + + + + Toolbar控件 + + + + + + + + + + + + + + + 获取或设置控件显示的图片 + + + + + 重写控件焦点属性 + + + + + 自定义绘制 + + + + + + 焦点进入 + + + + + + 失去焦点 + + + + + + 禁止调整大小 + + + + + + + + + + + + + + + + + + 只响应单击鼠标左键事件 + + + + + + 按比例缩放图片 + + + + + + + 图片缩放 + + 源图片 + 缩放图片的宽度 + 缩放图片的高度 + 缩放的图片 + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 绘图对像 + + 绘图对像 + 图片 + 绘置的图片大小、坐标 + 绘置的图片边界 + 当前状态 + 状态总数 + + + + 绘图对像 + + 绘图对像 + 图片对像 + 绘置的图片大小、坐标 + 当前状态 + 状态总数 + + + + + + + + + 得到要绘置的图片对像 + + 图像在程序集中的地址 + + + + + 得到要绘置的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 获取资源图标 + + + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的地址 + + + + + 得到图程序集中的图片对像 + + 图像在程序集中的路径 + 图像在程序集中的地址 + + + + + 颜色标签 + + + + + 行间距 + + + + + 颜色标签 + + + + + 更新 + + + + + 字体高度 + + + + + 控件高 + + + + + 控件文本 + + + + + 获取过滤掉颜色的字 + + + + + + + 改变字体 + + + + + + + + + + + + + + 分页控件 + + + + + 首页文本 + + + + + 上一页文本 + + + + + 下一页文本 + + + + + 末页文本 + + + + + 跳页文本 + + + + + 页面信息文本 + + + + + 存储SQL参数 + + + + + 最后一页的页码 + + + + + 在发生页码变化时激发 + + + + + 在发生页码变化前激发 + + + + + 设置/返回每页显示的量大小 + + + + + 设置/返回记录总数 + + + + + 设置/返回分页SQL语句,{pagecount}表示页数,{recordcount}表示记录总数,{pagesize}表示页面大小, + {pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 设置/返回当{recordnum}小于等于0时的分页SQL语句(比如第一页),如果为空，则默认使用SQLText值。{pagecount}表示页数, + {recordcount}表示记录总数,{pagesize}表示页面大小,{pageindex}表示当前页数,{recordnum}表示当前页记录数,{pageendnum}表示当前页最后一条记录的记录数 + + + + + 获取当前页码 + + + + + + 设置分页语句 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取数据库指定条件的记录总数 + + 数据库类型 + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MySQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MySQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + + + + + 设置分页语句为MSSQL分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 获取MSSQL数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,以及不包含排序语句;,如果不存在条件判断语句，请为空 + 排序语句，必须包含Order By;,如果不存在排序语句，请为空 + + + + + 设置分页语句为SQLite分页语句 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 获取SQLite数据库指定条件的记录总数 + + 表名 + 条件判断sql语句，注意不包含where,可包含order by,如果不存在条件判断语句，请为空 + + + + + 返回分页SQL语句 + + + + + 分页控件 + + + + + 设置当前页为指定页 + + + + + + 下一页 + + + + + 上一页 + + + + + 末页 + + + + + 首页 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + 密码控件 + + + + + + + + + + 密码 + + + + + 必需的设计器变量。 + + + + + 清理所有正在使用的资源。 + + 如果应释放托管资源，为 true；否则为 false。 + + + + 设计器支持所需的方法 - 不要 + 使用代码编辑器修改此方法的内容。 + + + + + This enum represents the possible browser commands + + + + + Used when no commans are available + + + + + Used in the new navigation events + + + + + The URL to navigate to + + + + + The name of the frame to navigate to + + + + + The flags when opening a new window + + + + + The pointer to ppDisp + + + + + Creates a new instance of WebBrowserExtendedNavigatingEventArgs + + Pointer to the automation object of the browser + The URL to go to + The name of the frame + The new window flags + + + + + + + + + Used in the new navigation events + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 查看源码 + + + + + 复制当前选中区 + + + + + 粘贴当前选中区 + + + + + 剪切当前选中区 + + + + + 全选 + + + + + 清除当前选中区的选中状态。 + + + + + 从当前选中区中删除全部超级链接。 + + + + + 从当前选中区中删除全部书签。 + + + + + 删除当前选中区 + + + + + 重做 + + + + + 撤销 + + + + + 从当前选中区中删除格式化标签。 + + + + + 点击节点 + + + + + + + + 点击节点 + + + + + + + + + 点击元素 + + 节点名 + 属性 + 属性值 + 等待毫秒数 + 第几个符合的元素,从1开始 + + + + 等待多时毫秒 + + + + + + Represents event information for the main form, when the command state of the active browser changes + + + + + Creates a new instance of the class + + A list of commands that are available + + + + Gets a list of commands that are available + + + + + An extended version of the control. + + + + + + + + + + + + 在页面弹出消息对话框时激发 + + + + + + + + + + + + + + + + + + + + + + 打开页面并等待页面加载完毕 + + 要打开的页面地址 + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待页面加载完毕 + + 小于等于0,则表示一直等待,否则表示等待指定秒后，如果依然没有加载完毕，就直接返回 + + + + 等待指定毫秒 + + 等待指定毫秒 + + + + 获取网页源代码,可以自动去除乱码 + + + + + + 加载html文本到浏览器中 + + + + + + + 加载html文本到浏览器中 + + + + + + 强制用本窗体打开新链接 + + + + + + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is created. + + + + + + This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + Called by the control when the underlying ActiveX control is discarded. + + + + + Returns the automation object for the web browser + + + + + This method will be called to give you a chance to create your own event sink + + + + + Detaches the event sink + + + + + 在文档下载开始时激发 + + + + + Raises the event + + Empty + + You could start an animation or a notification that downloading is starting + + + + + 下载完成后触发 + + + Here you could start monitoring for script errors. + + + + + Raises the event + + Empty + + + + 在开始浏览新网页时激发. + + + + + 在打开新的网页窗口时激发 + + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + Raises the event + + Thrown when BrowserExtendedNavigatingEventArgs is null + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 新窗口事件,只限Window XP SP2或以上系统支持 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Overridden + + The send to this procedure + + + + A list of all the available window messages + + + + + Raises the event + + + + + 在网页窗口关闭时激发 + + + Do not confuse this with DWebBrowserEvents2.Quit... That's something else. + + + + + Flags used by INewWindowManager::EvaluateNewWindow. + These values are taken into account in the decision of whether to display a pop-up window. + + + + + No information Present + + + + + The page is unloading. This flag is set in response to the onbeforeunload and onunload events. + Some pages load pop-up windows when you leave them rather than when you enter. This flag is used to identify those situations. + + + + + The call to INewWindowManager::EvaluateNewWindow is the result of a user-initiated action + (a mouse click or key press). Use this flag in conjunction with the NWMF_FIRST_USERINITED flag + to determine whether the call is a direct or indirect result of the user-initiated action. + + + + + When NWMF_USERINITED is present, this flag indicates that the call to + INewWindowManager::EvaluateNewWindow is the first query that results from this user-initiated action. + Always use this flag in conjunction with NWMF_USERINITED. + + + + + The override key (ALT) was pressed. The override key is used to bypass the pop-up manager梐llowing + all pop-up windows to display梐nd must be held down at the time that INewWindowManager::EvaluateNewWindow is called. + + + + + The new window attempting to load is the result of a call to the showHelp method. Help is sometimes displayed in a separate window, + and this flag is valuable in those cases. + + + + + The new window is a dialog box that displays HTML content. + + + + + Indicates that the EvaluateNewWindow method is being called through a marshalled Component Object Model (COM) proxy + from another thread. In this situation, the method should make a decision and return immediately without performing + blocking operations such as showing modal user interface (UI). Lengthy operations will cause the calling thread to + appear unresponsive. + + + + + HRESULT constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + a form that supports custom theme + + + + + 标签新建按钮事件 + + + + + 标签关闭按钮事件 + + + + + 标签创建时事件 + + + + + 标签激活前事件 + + + + + 标签激活后事件 + + + + + 在标签栏创建时激发 + + + + + + + 内边距 + + + + + 默认内边距 + + + + + 标题 + + + + + 皮肤/主题 + + + + + 是否可拖动改变窗体大小 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 标题栏高度 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 控制按钮相对于右上角的偏移量 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 标题栏图标尺寸 + + + + + 窗体图标,如果设置本项,将不使用Icon属性 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题距离左边的距离 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 是否显示阴影 + + + + + 窗体阴影宽度 + + + + + 使用阴影来缩放 + + + + + 窗体阴影颜色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区区域，坐标相对于窗体左上角 + + + + + 表示去掉自画的边框及标题栏后，剩下的可用的客户区大小 + + + + + 表示MDI标签栏的区域，包括bottom-region + + + + + MGdUI皮肤 + + + + + + + + + + + + + + + + + 获取子窗体 + + + + + + 通过sendmessage方式激活子窗体以避免闪烁 + + + + + + 当子窗体关闭时激发 + + + + + + + 子窗体可视化变化 + + + + + + + 获取当前的子窗体列表 + + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最小化 + + + + + 判断所接收到的 wm_nc-calc-size 消息是否指示窗体即将最大化 + + + + + to make the client area to have 3D view + + + + + 双击事件 + + + + + 消息 + + + + + + 画UI + + + + + + 在画背景时激发 + + + + + + 重写该方法解决在VS设计器中，每次保存一个新的尺寸，再打开尺寸会变大的问题 + + + + + 创建控件时激发 + + + + + 窗体可见变化时激发 + + + + + + 大小改变时激发 + + + + + + 在位置变化时激发 + + + + + + 窗体激活 + + + + + + 窗体关闭后激发 + + + + + + 加载时 + + + + + + 在子窗体激活时激发 + + + + + + 标签菜单 + + + + + 窗体上移动鼠标时激发 + + + + + + 获取当前点击的标签项 + + + + + 在窗体上按下鼠标时激发 + + + + + + 在窗体上放开鼠标时激发 + + + + + + 在鼠标离开窗体时激发 + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + 该类处理mdi-bar的绘制及鼠标事件管理 + + + + + use left,top,right to location the bar in owner form, + the margin is from Form.ClientRectangle + + + + + 整个标签栏高度,包含标签栏底部区域、标签、标签顶部空隙 + + + + + 标签栏底部区域的高度 + + + + + 是否显示标签栏边框 + + + + + 是否显示标签栏背景 + + + + + 标签栏左内边距 + + + + + 标签栏右内边距 + + + + + 标签高度 + + + + + 激活的标签高度 + + + + + tab顶部与bar顶部的空间,这个值用来计算 BarHeight + + + + + 每个标签的左右边界可以不是垂直的，而是都有一个斜度 + + + + + tab与tab之间的距离，用负值可以使tab有重叠的效果 + + + + + 标签是否显示图标 + + + + + 是否显示标签关闭按钮 + + + + + 标签图标大小 + + + + + 标签图标距离左边的距离 + + + + + 标签文字距离左边的距离 + + + + + 标签关闭按钮的大小 + + + + + 标签关闭按钮距离右边的距离 + + + + + 是否显示新建标签按钮 + + + + + 新建标签按钮的大小 + + + + + 新建标签距离左边的距离 + + + + + 按钮与Bar底部的距离 + + + + + 一个tab允许的最小宽度 + + + + + 一个tab允许的最大显示宽度 + + + + + 标签正常宽度 + + + + + 同步_listTabItems与mdi主窗体实际存在的子form + + + + + 为每个tab分配空间，如果tab数目太多，则有些会被隐藏 + + + + + 重绘整个标签栏 + + + + + + 处理鼠标事件。该方法会触发一些click事件，重刷一些按钮等 + + + + + + + 该类表示一个单独的标签项 + + + + + 该标签所对应的窗体 + + + + + 最终分配到的整个tab的宽度 + + + + + 表示所对应的form是否仍未被关闭 + + + + + 是否因空间不足而被隐藏 + + + + + 返回全部显示该标签文本所需的长度 + + + + + + 返回显示全部文本时该tab所需的宽度,该宽度不超过bar-container + 规定的tabmaxwidth + + + + + + 居左 + + + + + 显示在最后一个标签后面 + + + + + 该类封装设置一个主题所需的信息，可以继承该类实现不同的主题 + + + + + 主题名称，用于标识主题，对主题进行简单描述 + + + + + 窗体边界大小，鼠标移动到该边界将变成指针形状，拖动可改变窗体大小 + + + + + 窗体边框大小 + + + + + 窗体标题栏高度 + + + + + 标题栏图标与窗体左边框的距离 + + + + + 标题栏图标尺寸 + + + + + 标题栏文本左边距 + + + + + 控制按钮（关闭按钮）相对于窗体右上角的偏移量 + + + + + 窗体关闭按钮的尺寸 + + + + + 窗体最大化/还原按钮的大小 + + + + + 窗体最小化按钮的大小 + + + + + 关闭/最大化/最小化按钮之间的距离，可以设置成负值使它们重叠 + + + + + 窗体圆角程度 + + + + + 窗体圆角样式 + + + + + 是否使用默认的圆角样式，该样式为左上角和右上角圆角， + 最好在窗体边框较粗时才使用该样式 + + + + + 是否在标题栏上绘制图标 + + + + + 是否在标题栏上绘制文本 + + + + + 是否显示窗体阴影 + + + + + 窗体阴影大小 + + + + + 拖动窗体阴影是否可以改变窗体大小 + + + + + 阴影的颜色，可以设置成其他颜色而不一定是黑色 + + + + + 阴影从里到外是逐渐变浅的，这个值设置深色部分的透明度，ARGB中的A值 + + + + + 阴影从里到外是逐渐变浅的，这个值设置浅色部分的透明度，ARGB中的A值 + + + + + 是否在客户区边界画线使其看起来有立体感 + + + + + 窗体标题栏文字是否居中显示 + + + + + 窗体边框最外一像素的颜色 + + + + + 窗体边框第二最外像素的颜色 + + + + + 窗体边框其他部分颜色，如果窗体边框大小大于2，则其他像素将用此颜色画出 + + + + + 标题栏颜色是从上到下渐变的，这个值设置上边的颜色值 + + + + + 标题栏颜色是从上到下渐变的，这个值设置下边的颜色值 + + + + + 标题栏文字颜色 + + + + + 窗体背景颜色，该值将覆盖窗体自带的BackColor属性值 + + + + + 窗体关闭按钮的颜色集合 + + + + + 窗体最大化/还原按钮的颜色集合 + + + + + 窗体最小化按钮的颜色集合 + + + + + 默认状态下关闭按钮背景图片 + + + + + 鼠标移过去时关闭按钮背景图片 + + + + + 鼠标按下时关闭按钮背景图片 + + + + + 默认状态下最大化按钮背景图片 + + + + + 鼠标移过去时最大化按钮背景图片 + + + + + 鼠标按下时最大化按钮背景图片 + + + + + 默认状态下恢复按钮背景图片 + + + + + 鼠标移过去时恢复按钮背景图片 + + + + + 鼠标按下时恢复按钮背景图片 + + + + + 默认状态下最小化按钮背景图片 + + + + + 鼠标移过去时最小化按钮背景图片 + + + + + 鼠标按下时最小化按钮背景图片 + + + + + 是否用SendMessage的方式切换子窗体，以避免子窗体切换时产生的闪烁 + + + + + Mdi-Bar与窗体左、上、右边界的距离，只用到这三个值，Bottom值没用到。 + 用这三个值来确定Mdi-Bar的宽度及其在窗体中的位置 + + + + + 内部左边空白，第一个标签将从这个空白距离之后开始 + + + + + 标签栏内部右边空白 + + + + + 标签栏背景颜色 + + + + + 标签栏边框颜色 + + + + + 标签栏背景图片 + + + + + 是否显示标签栏边框 + + + + + 标签栏下边区域的背景颜色 + + + + + 标签栏下边区域的高度 + + + + + 标签高度 + + + + + 被选中的标签高度，可以设置成与TabHeight不一样的值，以突出显示被选中状态 + + + + + 标签之间的距离，设成负值可以使标签有重叠的效果 + + + + + 标签的最大宽度，任何情况下标签都不能超过这个宽度 + + + + + 标签正常宽度，如果标签需要很短的宽度（比如20像素）就可以显示完上面的文字， + 但是Mdi-Bar上有足够的空间时，标签会以正常宽度（比如100像素）显示 + + + + + 标签最小宽度，当标签小于这个宽度时将被隐藏 + + + + + 标签梯度大小，标签可以不以矩形方式显示，而是有一个梯度/斜度。 + + + + + 标签顶部空白，这个值用于参与计算Mdi-Bar高度，计算方式为： + Mdi-Bar Height = BottomRegionHeight + TabHeight + TabTopSpace + + + + + 标签上是否显示子窗体图标 + + + + + 标签上是否显示子窗体关闭图标 + + + + + 选中状态的标签的上部背景色，与下部背景色不同时，标签背景色就有渐变效果 + + + + + 选中状态的标签的下部背景色，与上部背景色不同时，标签背景色就有渐变效果 + + + + + 标签激活时字体颜色 + + + + + 非选中状态的标签的字体颜色 + + + + + 非选中状态的标签的上部背景色 + + + + + 非选中状态的标签的下部背景色 + + + + + 标签外边框颜色 + + + + + 标签内边框颜色，这个颜色一般具有一定的透明度 + + + + + 是否显示标签边框 + + + + + 是否显示默认的新建标签按钮(NewTabBtn) + + + + + NewTabBtn与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 新建标签按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 新建标签按钮大小 + + + + + 按钮颜色集合 + + + + + 是否一直显示ListAllBtn，即使在没有标签被隐藏的情况下 + + + + + 《显示全部标签》按钮的位置 + + + + + 《显示全部标签》按钮与下边框的距离，这个值用来定位按钮的Y坐标 + + + + + 《显示全部标签》按钮与左边框的距离，这个值用来定位按钮的X坐标 + + + + + 《显示全部标签》按钮的颜色 + + + + + 《显示全部标签》按钮的大小 + + + + + 皮肤主题 + + + + + 设置百分比 + + + + + + + + + 引发 ValueChanged 事件 + + + + + + 引发 ThemeChanged 事件 + + + + + + 指示鼠标位于哪个区域 + + + + + 控件Value值发生变化后引发 + + + + + 控件绘制MainLine前引发, 可以设置Cancel参数来取消默认的绘制 + + + + + 控件绘制Button前引发 + + + + + 引发 ValueChanged 事件 + + + + + 引发 BeforePaintMainLine 事件 + + + + + 引发 BeforePaintButton 事件 + + + + + 将Value值加一个LargeChange量 + + + + + 将Value值减一个LargeChange量 + + + + + 将Value值加一个SmallChange量 + + + + + 将Value值减一个SmallChange量 + + + + + 提供产生各种路径的静态方法，比如圆角路径、关闭按钮上的x路径、+号路径 + + + + + 圆角样式 + + + + + 无 + + + + + 所有 + + + + + 上 + + + + + 下 + + + + + 左 + + + + + 右 + + + + + SimpleObject指的是只有一种状态（不像普通按钮一样有三种状态），并且其上的元素 + 布局比较简单的Object + + + + + + + + + + + + + + + + + + + + DevExpress风格皮肤 + + + + + DevExpress风格皮肤 + + + + + 新风格皮肤 + + + + + 新风格皮肤 + + + + + 基础皮肤 + + + + + VS2013风格皮肤 + + + + + this theme is just for chrome one quarter style + + + + + for diamond ring style only + + + + + Location of cursor hot spot returnet in WM_NCHITTEST. + + + + + On the screen background or on a dividing line between windows + (same as HTNOWHERE, except that the DefWindowProc function produces a system beep to indicate an error). + + + + + In a window currently covered by another window in the same thread + (the message will be sent to underlying windows in the same thread until one of them returns a code that is not HTTRANSPARENT). + + + + + On the screen background or on a dividing line between windows. + + + + In a client area. + + + In a title bar. + + + In a window menu or in a Close button in a child window. + + + In a size box (same as HTSIZE). + + + In a menu. + + + In a horizontal scroll bar. + + + In the vertical scroll bar. + + + In a Minimize button. + + + In a Maximize button. + + + In the left border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the right border of a resizable window + (the user can click the mouse to resize the window horizontally). + + + + In the upper-horizontal border of a window. + + + In the upper-left corner of a window border. + + + In the upper-right corner of a window border. + + + In the lower-horizontal border of a resizable window + (the user can click the mouse to resize the window vertically). + + + In the lower-left corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the lower-right corner of a border of a resizable window + (the user can click the mouse to resize the window diagonally). + + + In the border of a window that does not have a sizing border. + + + In a Close button. + + + In a Help button. + + + + Contains the new coordinates of a window that has been moved or resized, that is, it is the proposed new window coordinates. + + + + + Contains the coordinates of the window before it was moved or resized. + + + + + Contains the coordinates of the window's client area before the window was moved or resized. + + + + + Pointer to a WINDOWPOS structure that contains the size and position values specified in the operation that moved or resized the window. + + + + + + + + + + 是否在这个按钮上按下了鼠标未释放 + + + + + 是否可见 + + + + + + + + + + 画两次可以加深颜色 + + + + + 用于在click事件中传回数据 + + + + + 获取或设置是否将绘制完全限制在指定的区域内 + + + + + + + + + + + + + + + + + Adapter for WinForms brushes objects for core. + + + + + The actual WinForms brush instance. + + + + + If to dispose the brush when is called.
+ Ignore dispose for cached brushes. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms context menu for core. + + + + + the underline win forms context menu + + + + + Init. + + + + + Adapter for WinForms Control for core. + + + + + the underline win forms control. + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Get the underline win forms control + + + + + Adapter for WinForms Font object for core. + + + + + the underline win-forms font. + + + + + a handle to this Font. + + + + + the vertical offset of the font underline location from the top of the font. + + + + + Cached font height. + + + + + Cached font whitespace width. + + + + + Init. + + + + + the underline win-forms font. + + + + + Get the handle to this Font. + + + + + Set font metrics to be cached for the font for future use. + + the full height of the font + the vertical offset of the font underline location from the top of the font. + + + + Adapter for WinForms Font family object for core. + + + + + the underline win-forms font. + + + + + Init. + + + + + the underline win-forms font family. + + + + + Adapter for WinForms Graphics for core. + + + + + used for calculation. + + + + + used for calculation. + + + + + Used for GDI+ measure string. + + + + + The string format to use for measuring strings for GDI+ text rendering + + + + + The string format to use for rendering strings for GDI+ text rendering + + + + + The wrapped WinForms graphics object + + + + + Use GDI+ text rendering to measure/draw text. + + + + + the initialized HDC used + + + + + if to release the graphics object on dispose + + + + + If text alignment was set to RTL + + + + + Init static resources. + + + + + Init. + + the win forms graphics object to use + Use GDI+ text rendering to measure/draw text + optional: if to release the graphics object on dispose (default - false) + + + + Release current HDC to be able to use methods. + + + + + Init HDC for the current graphics object to be used to call GDI directly. + + + + + Set a resource (e.g. a font) for the specified device context. + WARNING: Calling Font.ToHfont() many times without releasing the font handle crashes the app. + + + + + Set the text color of the device context. + + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Special draw logic to draw transparent text using GDI.
+ 1. Create in-memory DC
+ 2. Copy background to in-memory DC
+ 3. Draw the text to in-memory DC
+ 4. Copy the in-memory DC to the proper location with alpha blend
+ + + + + Change text align to Left-to-Right or Right-to-Left if required. + + + + + Adapter for WinForms graphics path object for core. + + + + + The actual WinForms graphics path instance. + + + + + the last point added to the path to begin next segment from + + + + + The actual WinForms graphics path instance. + + + + + Get arc start angle for the given corner. + + + + + Adapter for WinForms Image object for core. + + + + + the underline win-forms image. + + + + + Initializes a new instance of the class. + + + + + the underline win-forms image. + + + + + Adapter for WinForms pens objects for core. + + + + + The actual WinForms brush instance. + + + + + Init. + + + + + The actual WinForms brush instance. + + + + + Adapter for WinForms platforms. + + + + + Singleton instance of global adapter. + + + + + Init installed font families and set default font families mapping. + + + + + Singleton instance of global adapter. + + + + + Low level handling of Html Renderer logic, this class is used by , + , and .
+ + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + returns page list + + + + + returns page list count + + + + + The internal core html container + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrappable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given printer device. + + the printer device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the mouse event args + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + mouse event args + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the mouse event args + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + + + + + + Create HtmlRenderer mouse event from win forms mouse event. + + + + + Create HtmlRenderer key event from win forms key event. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ Using and client can control how the html content effects the + size of the label. Either case scrollbars are never shown and html content outside of client bounds will be clipped. + and with AutoSize can limit the max/min size of the control
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoSize:

+ AutoSize = AutoSizeHeightOnly = false
+ The label size will not change by the html content. MaximumSize and MinimumSize are ignored.
+
+ AutoSize = true
+ The width and height is adjustable by the html content, the width will be longest line in the html, MaximumSize.Width will restrict it but it can be lower than that.
+
+ AutoSizeHeightOnly = true
+ The width of the label is set and will not change by the content, the height is adjustable by the html content with restrictions to the MaximumSize.Height and MinimumSize.Height values.
+ + +

LinkClicked event

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + the current html text set in the control + + + + + is to handle auto size of the control height only + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + Creates a new HTML Label + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Automatically sets the size of the label by content size + + + + + Automatically sets the height of the label by content height (width is not effected). + + + + + Gets or sets the max size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the min size the control get be set by or . + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets the html of this control. + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform paint of the html in the control. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Provides HTML rendering using the text property.
+ WinForms control that will render html content in it's client rectangle.
+ If is true and the layout of the html resulted in its content beyond the client bounds + of the panel it will show scrollbars (horizontal/vertical) allowing to scroll the content.
+ If is false html content outside the client bounds will be clipped.
+ The control will handle mouse and keyboard events on it to support html text selection, copy-paste and mouse clicks.
+ + The major differential to use HtmlPanel or HtmlLabel is size and scrollbars.
+ If the size of the control depends on the html content the HtmlLabel should be used.
+ If the size is set by some kind of layout then HtmlPanel is more suitable, also shows scrollbars if the html contents is larger than the control client rectangle.
+ + +

AutoScroll:

+ Allows showing scrollbars if html content is placed outside the visible boundaries of the panel. + + +

LinkClicked event:

+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + +

StylesheetLoad event:

+ Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + +

ImageLoad event:

+ Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + +

RenderError event:

+ Raised when an error occurred during html rendering.
+ + + + + + Underline html container instance. + + + + + The current border style of the control + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the control + + + + + the current html text set in the control + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + The text rendering hint to be used for text rendering. + + + + + The last position of the scrollbars to know if it has changed to update mouse + + + + + Creates a new HtmlPanel and sets a basic css for it's styling. + + + + + + + + + + Raised when the BorderStyle property value changes. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + If to use cursors defined by the operating system or .NET cursors + + + + + Gets or sets the border style. + + The border style. + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. + + + + + Gets or sets the text of this panel + + + + + + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + Get html from the current DOM tree with inline style. + + generated html + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Adjust the scrollbar of the panel on html element by the given id.
+ The top of the html element rectangle will be at the top of the panel, if there + is not enough height to scroll to the top the scroll will be at maximum.
+ + the id of the element to scroll to + + + + Override to support border for the control. + + + + + Perform the layout of the html in the control. + + + + + Perform html container layout by the current panel client size. + + + + + Perform paint of the html in the control. + + + + + Set focus on the control for keyboard scrollbars handling. + + + + + Handle mouse move to handle hover cursor and text selection. + + + + + Handle mouse leave to handle cursor change. + + + + + Handle mouse down to handle selection. + + + + + Handle mouse up to handle selection and link click. + + + + + Handle mouse double click to select word under the mouse. + + + + + Handle key down event for selection, copy and scrollbars handling. + + + + + Raises the event. + + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Handle html renderer invalidate and re-layout as requested. + + + + + On html renderer scroll request adjust the scrolling of the panel to the requested location. + + + + + Adjust the scrolling of the panel to the requested location. + + the location to adjust the scroll to + + + + call mouse move to handle paint after scroll or html change affecting mouse cursor. + + + + + Used to add arrow keys to the handled keys in . + + + + + Override the proc processing method to set OS specific hand cursor. + + The Windows to process. + + + + Release the html container resources. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Not applicable. + + + + + Standalone static class for simple and direct HTML rendering.
+ For WinForms UI prefer using HTML controls: or .
+ For low-level control and performance consider using .
+ + + + GDI vs. GDI+ text rendering
+ Windows supports two text rendering technologies: GDI and GDI+.
+ GDI is older, has better performance and looks better on standard monitors but doesn't support alpha channel for transparency.
+ GDI+ is newer, device independent so work better for printers but is slower and looks worse on monitors.
+ HtmlRender supports both GDI and GDI+ text rendering to accommodate different needs, GDI+ text rendering methods have "GdiPlus" suffix + in their name where GDI do not.
+ + + Rendering to image
+ See https://htmlrenderer.codeplex.com/wikipage?title=Image%20generation
+ Because of GDI text rendering issue with alpha channel clear type text rendering rendering to image requires special handling.
+ Solid color background - generate an image where the background is filled with solid color and all the html is rendered on top + of the background color, GDI text rendering will be used. (RenderToImage method where the first argument is html string)
+ Image background - render html on top of existing image with whatever currently exist but it cannot have transparent pixels, + GDI text rendering will be used. (RenderToImage method where the first argument is Image object)
+ Transparent background - render html to empty image using GDI+ text rendering, the generated image can be transparent. + Text rendering can be controlled using , note that + doesn't render well on transparent background. (RenderToImageGdiPlus method)
+ + + Overwrite stylesheet resolution
+ Exposed by optional "stylesheetLoad" delegate argument.
+ Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + Overwrite image resolution
+ Exposed by optional "imageLoad" delegate argument.
+ Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ Note: Cannot use asynchronous scheme overwrite scheme.
+ + + + + Simple rendering
+ HtmlRender.Render(g, "Hello World]]>");
+ HtmlRender.Render(g, "Hello World]]>", 10, 10, 500, CssData.Parse("body {font-size: 20px}")");
+ + + Image rendering
+ HtmlRender.RenderToImage("Hello World]]>", new Size(600,400));
+ HtmlRender.RenderToImage("Hello World]]>", 600);
+ HtmlRender.RenderToImage(existingImage, "Hello World]]>");
+ + + + + + Adds a font family to be used in html rendering.
+ The added font will be used by all rendering function including and all WinForms controls. + + + The given font family instance must be remain alive while the renderer is in use.
+ If loaded to then the collection must be alive.
+ If loaded from file then the file must not be deleted. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + + This fonts mapping can be used as a fallback in case the requested font is not installed in the client system. + + the font family to replace + the font family to replace with + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI text rendering, note has no effect. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size (width and height) required to draw the given html under given max width restriction.
+ If no max width restriction is given the layout will use the maximum possible width required by the content, + it can be the longest text line or full image width.
+ Use GDI+ text rending, use to control text rendering. + + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Renders the specified HTML source on the specified location and max width restriction.
+ Use GDI text rendering, note has no effect.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI text rendering, note has no effect.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + optional: the left most location to start render the html at (default - 0) + optional: the top most location to start render the html at (default - 0) + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ Use GDI+ text rending, use to control text rendering.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ The HTML will be layout by the given image size but may be clipped if cannot fit.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + optional: the top-left most location to start render the html at (default - 0,0) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML on top of the given image.
+ will contain the rendered html in it on top of original content.
+ must not contain transparent pixels as it will corrupt the rendered html text.
+ See "Rendering to image" remarks section on .
+ + the image to render the html on + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+

+ Limitation: The image cannot have transparent background, by default it will be white.
+ See "Rendering to image" remarks section on .
+

+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: the color to fill the image with (default - white) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + if is . + + + + Renders the specified HTML into a new image of the requested size.
+ The HTML will be layout by the given size but will be clipped if cannot fit.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + The size of the image to render into, layout html by width and clipped by height + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the max width of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: the max height of the rendered html, if not zero and html cannot be layout within the limit it will be clipped + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Renders the specified HTML into a new image of unknown size that will be determined by min/max width/height and HTML layout.
+ If is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ If (Width/Height) is above zero the rendered image will not be smaller than the given min size.
+ The generated image have transparent background that the html is rendered on.
+ GDI+ text rending can be controlled by providing .
+ See "Rendering to image" remarks section on .
+ + HTML source to render + optional: the min size of the rendered html (zero - not limit the width/height) + optional: the max size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + optional: (default - SingleBitPerPixelGridFit) + optional: the style to use for html rendering (default - use W3 default style) + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the generated image of the html + + + + Measure the size (width and height) required to draw the given html under given width and height restrictions.
+ + Device to use for measure + HTML source to render + optional: bound the width of the html to render in (default - 0, unlimited) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the size required for the html + + + + Measure the size of the html by performing layout under the given restrictions. + + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Clip the graphics so the html will not be rendered outside the max height bound given.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Renders the specified HTML source on the specified location and max size restriction.
+ If .Width is zero the html will use all the required width, otherwise it will perform line + wrap as specified in the html
+ If .Height is zero the html will use all the required height, otherwise it will clip at the + given max height not rendering the html below it.
+ Returned is the actual width and height of the rendered html.
+ + Device to render with + HTML source to render + the top-left most location to start render the html at + the max size of the rendered html (if height above zero it will be clipped) + optional: the style to use for html rendering (default - use W3 default style) + true - use GDI+ text rendering, false - use GDI text rendering + optional: can be used to overwrite stylesheet resolution logic + optional: can be used to overwrite image resolution logic + the actual size of the rendered html + + + + Copy all the bitmap bits from memory bitmap buffer to the given image. + + the source memory bitmap buffer to copy from + the destination bitmap image to copy to + + + + Provides HTML rendering on the tooltips. + + + + + the container to render and handle the html shown in the tooltip + + + + + the raw base stylesheet data used in the control + + + + + the base stylesheet data used in the panel + + + + + The text rendering hint to be used for text rendering. + + + + + The CSS class used for tooltip html root div + + + + + the control that the tooltip is currently showing on.
+ Used for link handling. + + + + + timer used to handle mouse move events when mouse is over the tooltip.
+ Used for link handling. + + + + + the handle of the actual tooltip window used to know when the tooltip is hidden
+ Used for link handling. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Init. + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when an error occurred during html rendering.
+ + + + + Raised when aa stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + Use GDI+ text rendering to measure/draw text.
+ + + + GDI+ text rendering is less smooth than GDI text rendering but it natively supports alpha channel + thus allows creating transparent images. + + + While using GDI+ text rendering you can control the text rendering using , note that + using doesn't work well with transparent background. + + + + + + The text rendering hint to be used for text rendering. + + + + + Set base stylesheet to be used by html rendered in the panel. + + + + + The CSS class used for tooltip html root div (default: htmltooltip)
+ Setting to 'null' clear base style on the tooltip.
+ Set custom class found in to change the base style of the tooltip. + + + + + If to handle links in the tooltip (default: false).
+ When set to true the mouse pointer will change to hand when hovering over a tooltip and + if clicked the event will be raised although the tooltip will be closed. + + + + + Gets or sets the max size the tooltip. + + An ordered pair of type representing the width and height of a rectangle. + + + + On tooltip appear set the html by the associated control, layout and set the tooltip size by the html size. + + + + + Draw the html using the tooltip graphics. + + + + + Adjust the location of the tooltip window to the location of the mouse and handle + if the tooltip window will try to appear outside the boundaries of the control. + + the control the tooltip is appearing on + the size of the tooltip window + + + + Propagate the LinkClicked event from root container. + + + + + Propagate the Render Error event from root container. + + + + + Propagate the stylesheet load event from root container. + + + + + Propagate the image load event from root container. + + + + + Raised on link handling timer tick, used for: + 1. Know when the tooltip is hidden by checking the visibility of the tooltip window. + 2. Call HandleMouseMove so the mouse cursor will react if over a link element. + 3. Call HandleMouseDown and HandleMouseUp to simulate click on a link if one was clicked. + + + + + Unsubscribe from events and dispose of . + + + + + Helper to encode and set HTML fragment to clipboard.
+ See http://theartofdev.wordpress.com/2012/11/11/setting-html-and-plain-text-formatting-to-clipboard/.
+ . + + + The MIT License (MIT) Copyright (c) 2014 Arthur Teplitzki. + + + + + The string contains index references to other spots in the string, so we need placeholders so we can compute the offsets.
+ The _ strings are just placeholders. We'll back-patch them actual values afterwards.
+ The string layout () also ensures that it can't appear in the body of the html because the
+ character must be escaped.
+ + + + + html comment to point the beginning of html fragment + + + + + html comment to point the end of html fragment + + + + + Used to calculate characters byte count in UTF-8 + + + + + Create with given html and plain-text ready to be used for clipboard or drag and drop.
+ Handle missing ]]> tags, specified start\end segments and Unicode characters. + + + + Windows Clipboard works with UTF-8 Unicode encoding while .NET strings use with UTF-16 so for clipboard to correctly + decode Unicode string added to it from .NET we needs to be re-encoded it using UTF-8 encoding. + + + Builds the CF_HTML header correctly for all possible HTMLs
+ If given html contains start/end fragments then it will use them in the header: + hello world]]> + If given html contains html/body tags then it will inject start/end fragments to exclude html/body tags: + hello world]]> + If given html doesn't contain html/body tags then it will inject the tags and start/end fragments properly: + world]]> + In all cases creating a proper CF_HTML header:
+ + + hello world + ]]> + + See format specification here: http://msdn.microsoft.com/library/default.asp?url=/workshop/networking/clipboard/htmlclipboard.asp + + + a html fragment + the plain text + + + + Clears clipboard and sets the given HTML and plain text fragment to the clipboard, providing additional meta-information for HTML.
+ See for HTML fragment details.
+ + + ClipboardHelper.CopyToClipboard("Hello World", "Hello World"); + + a html fragment + the plain text + + + + Clears clipboard and sets the given plain text fragment to the clipboard.
+ + the plain text + + + + Generate HTML fragment data string with header that is required for the clipboard. + + the html to generate for + the resulted string + + + + Calculates the number of bytes produced by encoding the string in the string builder in UTF-8 and not .NET default string encoding. + + the string builder to count its string + optional: the start index to calculate from (default - start of string) + optional: the end index to calculate to (default - end of string) + the number of bytes required to encode the string in UTF-8 + + + + Utilities for converting WinForms entities to HtmlRenderer core entities. + + + + + Convert from WinForms point to core point. + + + + + Convert from WinForms point to core point. + + + + + Convert from core point to WinForms point. + + + + + Convert from core point to WinForms point. + + + + + Convert from WinForms size to core size. + + + + + Convert from core size to WinForms size. + + + + + Convert from core size to WinForms size. + + + + + Convert from WinForms rectangle to core rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from core rectangle to WinForms rectangle. + + + + + Convert from WinForms color to core color. + + + + + Convert from core color to WinForms color. + + + + + Utility for Win32 API. + + + + + Const for BitBlt copy raster-operation code. + + + + + Const for BitBlt paint raster-operation code. + + + + + Create a compatible memory HDC from the given HDC.
+ The memory HDC can be rendered into without effecting the original HDC.
+ The returned memory HDC and must be released using . + + the HDC to create memory HDC from + the width of the memory HDC to create + the height of the memory HDC to create + returns used bitmap memory section that must be released when done with memory HDC + memory HDC + + + + Release the given memory HDC and dib section created from . + + Memory HDC to release + bitmap section to release + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + A pointer to a RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + If the function succeeds, the return value is nonzero. + + + + Retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen. + + + In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, + the pixel at (right, bottom) lies immediately outside the rectangle. + + A handle to the window. + RECT structure that receives the screen coordinates of the upper-left and lower-right corners of the window. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ARGB (alpha, red, green, blue) color. + + + + + Represents a color that is null. + + 1 + + + + Gets a system-defined color. + + + + + Gets a system-defined color that has an ARGB value of #FF000000. + + + + + Gets a system-defined color that has an ARGB value of #FFFFFFFF. + + + + + Gets a system-defined color that has an ARGB value of #FFF5F5F5. + + + + + Gets a system-defined color that has an ARGB value of #FFD3D3D3. + + + + + Gets the red component value of this structure. + + + + + Gets the green component value of this structure. + + + + + Gets the blue component value of this structure. + + + + + Gets the alpha component value of this structure. + + + + + Specifies whether this structure is uninitialized. + + + This property returns true if this color is uninitialized; otherwise, false. + + 1 + + + + Tests whether two specified structures are equivalent. + + + true if the two structures are equal; otherwise, false. + + + The that is to the left of the equality operator. + + + The that is to the right of the equality operator. + + 3 + + + + Tests whether two specified structures are different. + + + true if the two structures are different; otherwise, false. + + + The that is to the left of the inequality operator. + + + The that is to the right of the inequality operator. + + 3 + + + + Creates a structure from the four ARGB component (alpha, red, green, and blue) values. Although this method allows a 32-bit value to be passed for each component, the value of each component is limited to 8 bits. + + + The that this method creates. + + The alpha component. Valid values are 0 through 255. + The red component. Valid values are 0 through 255. + The green component. Valid values are 0 through 255. + The blue component. Valid values are 0 through 255. + + , , , or is less than 0 or greater than 255. + + 1 + + + + Creates a structure from the specified 8-bit color values (red, green, and blue). The alpha value is implicitly 255 (fully opaque). Although this method allows a 32-bit value to be passed for each color component, the value of each component is limited to 8 bits. + + + The that this method creates. + + + The red component value for the new . Valid values are 0 through 255. + + + The green component value for the new . Valid values are 0 through 255. + + + The blue component value for the new . Valid values are 0 through 255. + + + , , or is less than 0 or greater than 255. + + 1 + + + + Tests whether the specified object is a structure and is equivalent to this + + structure. + + + true if is a structure equivalent to this + + structure; otherwise, false. + + The object to test. + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies the hash code for this . + + 1 + + + + Converts this structure to a human-readable string. + + + + + Specifies the style of dashed lines drawn with a object. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 自定义 + + + + + Specifies style information applied to text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + Init. + + + + + is control is pressed + + + + + is 'A' key is pressed + + + + + is 'C' key is pressed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Even class for handling keyboard events in . + + + + + Is the left mouse button participated in the event + + + + + Init. + + + + + Is the left mouse button participated in the event + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents an ordered pair of floating-point x- and y-coordinates that defines a point in a two-dimensional plane. + + + + + Represents a new instance of the class with member data left uninitialized. + + 1 + + + + Initializes a new instance of the class with the specified coordinates. + + The horizontal position of the point. + The vertical position of the point. + + + + + + Gets a value indicating whether this is empty. + + + true if both and + + are 0; otherwise, false. + + 1 + + + + Gets or sets the x-coordinate of this . + + + The x-coordinate of this . + + 1 + + + + Gets or sets the y-coordinate of this . + + + The y-coordinate of this . + + 1 + + + + Translates the by the specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the x- and y-coordinates of the + + . + + + + + Translates a by the negative of a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Compares two structures. The result specifies whether the values of the + + and properties of the two + + structures are equal. + + + true if the and + + values of the left and right + + structures are equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Determines whether the coordinates of the specified points are not equal. + + + true to indicate the and + + values of and + + are not equal; otherwise, false. + + + A to compare. + + + A to compare. + + 3 + + + + Translates a given by a specified + + . + + + The translated . + + + The to translate. + + + The that specifies the numbers to add to the coordinates of + + . + + + + + Translates a by the negative of a specified size. + + + The translated . + + + The to translate. + + + The that specifies the numbers to subtract from the coordinates of + + . + + + + + Specifies whether this contains the same coordinates as the specified + + . + + + This method returns true if is a and has the same coordinates as this + + . + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts this to a human readable string. + + + A string that represents this . + + 1 + + + + Stores a set of four floating-point numbers that represent the location and size of a rectangle. + + + + + Represents an instance of the class with its members uninitialized. + + + + + Initializes a new instance of the class with the specified location and size. + + The x-coordinate of the upper-left corner of the rectangle. + The y-coordinate of the upper-left corner of the rectangle. + The width of the rectangle. + The height of the rectangle. + + + + Initializes a new instance of the class with the specified location and size. + + A that represents the upper-left corner of the rectangular region. + A that represents the width and height of the rectangular region. + + + + Gets or sets the coordinates of the upper-left corner of this structure. + + A that represents the upper-left corner of this structure. + + + + Gets or sets the size of this . + + A that represents the width and height of this structure. + + + + Gets or sets the x-coordinate of the upper-left corner of this structure. + + + The x-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the y-coordinate of the upper-left corner of this structure. + + + The y-coordinate of the upper-left corner of this structure. + + + + + Gets or sets the width of this structure. + + + The width of this structure. + + + + + Gets or sets the height of this structure. + + + The height of this structure. + + + + + Gets the x-coordinate of the left edge of this structure. + + + The x-coordinate of the left edge of this structure. + + + + + Gets the y-coordinate of the top edge of this structure. + + + The y-coordinate of the top edge of this structure. + + + + + Gets the x-coordinate that is the sum of and + + of this structure. + + + The x-coordinate that is the sum of and + + of this structure. + + + + + Gets the y-coordinate that is the sum of and + + of this structure. + + + The y-coordinate that is the sum of and + + of this structure. + + + + + Tests whether the or + + property of this has a value of zero. + + + This property returns true if the or + + property of this has a value of zero; otherwise, false. + + + + + Tests whether two structures have equal location and size. + + + This operator returns true if the two specified structures have equal + , , , and properties. + + + The structure that is to the left of the equality operator. + + + The structure that is to the right of the equality operator. + + + + + Tests whether two structures differ in location or size. + + + This operator returns true if any of the , + , , or + properties of the two structures are unequal; otherwise false. + + + The structure that is to the left of the inequality operator. + + + The structure that is to the right of the inequality operator. + + + + + Creates a structure with upper-left corner and lower-right corner at the specified locations. + + + The new that this method creates. + + The x-coordinate of the upper-left corner of the rectangular region. + The y-coordinate of the upper-left corner of the rectangular region. + The x-coordinate of the lower-right corner of the rectangular region. + The y-coordinate of the lower-right corner of the rectangular region. + + + + Tests whether is a with the same location and size of this + . + + + This method returns true if is a and its X, Y, Width, and Height properties are equal to the corresponding properties of this + ; otherwise, false. + + + The to test. + + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point defined by and is contained within this + + structure; otherwise false. + + The x-coordinate of the point to test. + The y-coordinate of the point to test. + + + + Determines if the specified point is contained within this structure. + + + This method returns true if the point represented by the parameter is contained within this + + structure; otherwise false. + + The to test. + + + + Determines if the rectangular region represented by is entirely contained within this + + structure. + + + This method returns true if the rectangular region represented by is entirely contained within the rectangular region represented by this + + ; otherwise false. + + + The to test. + + + + + Inflates this structure by the specified amount. + + + The amount to inflate this structure horizontally. + + + The amount to inflate this structure vertically. + + + + + Inflates this by the specified amount. + + The amount to inflate this rectangle. + + + + Creates and returns an inflated copy of the specified structure. The copy is inflated by the specified amount. The original rectangle remains unmodified. + + + The inflated . + + + The to be copied. This rectangle is not modified. + + The amount to inflate the copy of the rectangle horizontally. + The amount to inflate the copy of the rectangle vertically. + + + + Replaces this structure with the intersection of itself and the specified + + structure. + + The rectangle to intersect. + + + + Returns a structure that represents the intersection of two rectangles. If there is no intersection, and empty + + is returned. + + + A third structure the size of which represents the overlapped area of the two specified rectangles. + + A rectangle to intersect. + A rectangle to intersect. + + + + Determines if this rectangle intersects with . + + + This method returns true if there is any intersection. + + The rectangle to test. + + + + Creates the smallest possible third rectangle that can contain both of two rectangles that form a union. + + + A third structure that contains both of the two rectangles that form the union. + + A rectangle to union. + A rectangle to union. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location. + + + + Adjusts the location of this rectangle by the specified amount. + + The amount to offset the location horizontally. + The amount to offset the location vertically. + + + + Gets the hash code for this structure. For information about the use of hash codes, see Object.GetHashCode. + + The hash code for this + + + + Converts the Location and Size of this to a human-readable string. + + + A string that contains the position, width, and height of this structure for example, "{X=20, Y=20, Width=100, Height=50}". + + + + + Stores an ordered pair of floating-point numbers, typically the width and height of a rectangle. + + + + + Gets a structure that has a + + and + + value of 0. + + + A structure that has a + + and + + value of 0. + + 1 + + + + Initializes a new instance of the structure from the specified existing + + structure. + + + The structure from which to create the new + + structure. + + + + + Initializes a new instance of the structure from the specified structure. + + The structure from which to initialize this structure. + + + + Initializes a new instance of the structure from the specified dimensions. + + + The width component of the new structure. + + + The height component of the new structure. + + + + + Gets a value that indicates whether this structure has zero width and height. + + + This property returns true when this structure has both a width and height of zero; otherwise, false. + + 1 + + + + Gets or sets the horizontal component of this structure. + + + The horizontal component of this structure, typically measured in pixels. + + 1 + + + + Gets or sets the vertical component of this structure. + + + The vertical component of this structure, typically measured in pixels. + + 1 + + + + Converts the specified structure to a + structure. + + The structure to which this operator converts. + The structure to be converted + + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + 3 + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A that is the result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + 3 + + + + Tests whether two structures are equal. + + + This operator returns true if and have equal width and height; otherwise, false. + + + The structure on the left side of the equality operator. + + + The structure on the right of the equality operator. + + 3 + + + + Tests whether two structures are different. + + + This operator returns true if and differ either in width or height; false if + + and are equal. + + + The structure on the left of the inequality operator. + + + The structure on the right of the inequality operator. + + 3 + + + + Adds the width and height of one structure to the width and height of another + + structure. + + + A structure that is the result of the addition operation. + + + The first structure to add. + + + The second structure to add. + + + + + Subtracts the width and height of one structure from the width and height of another + + structure. + + + A structure that is a result of the subtraction operation. + + + The structure on the left side of the subtraction operator. + + + The structure on the right side of the subtraction operator. + + + + + Tests to see whether the specified object is a structure with the same dimensions as this + + structure. + + + This method returns true if is a and has the same width and height as this + + ; otherwise, false. + + + The to test. + + 1 + + + + Returns a hash code for this structure. + + + An integer value that specifies a hash value for this structure. + + 1 + + + + Converts a structure to a structure. + + + Returns a structure. + + + + + Creates a human-readable string that represents this structure. + + + A string that represents this structure. + + 1 + + + + + + + Platform adapter to bridge platform specific objects to HTML Renderer core library.
+ Core uses abstract renderer objects (RAdapter/RControl/REtc...) to access platform specific functionality, the concrete platforms + implements those objects to provide concrete platform implementation. Those allowing the core library to be platform agnostic. + + Platforms: WinForms, WPF, Metro, PDF renders, etc.
+ Objects: UI elements(Controls), Graphics(Render context), Colors, Brushes, Pens, Fonts, Images, Clipboard, etc.
+ + + + It is best to have a singleton instance of this class for concrete implementation!
+ This is because it holds caches of default CssData, Images, Fonts and Brushes. + + + + + cache of brush color to brush instance + + + + + cache of pen color to pen instance + + + + + cache of all the font used not to create same font again and again + + + + + default CSS parsed data singleton + + + + + image used to draw loading image icon + + + + + image used to draw error image icon + + + + + Init. + + + + + Get the default CSS stylesheet data. + + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Check if the given font exists in the system by font family name. + + the font name to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get image to be used while HTML image is loading. + + + + + Get image to be used if HTML image load failed. + + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard
+ Not relevant for platforms that don't render HTML on UI element. + + the text to set + + + + Set the given html and plain text data to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the html data + the plain text data + + + + Set the given image to clipboard.
+ Not relevant for platforms that don't render HTML on UI element. + + the image object to set to clipboard + + + + Create a context menu that can be used on the control
+ Not relevant for platforms that don't render HTML on UI element. + + new context menu + + + + Save the given image to file by showing save dialog to the client.
+ Not relevant for platforms that don't render HTML on UI element. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Resolve color value from given color name. + + the color name + color value + + + + Get cached pen instance for the given color. + + the color to get pen for + pen instance + + + + Get cached solid brush instance for the given color. + + the color to get brush for + brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Convert image object returned from to . + + the image returned from load event + converted image or null + + + + Create an object from the given stream. + + the stream to create image from + new image instance + + + + Get font instance by given font family name, size and style. + + the font family name + font size + font style + font instance + + + + Get font instance by given font family instance, size and style.
+ Used to support custom fonts that require explicit font family instance to be created. + + the font family instance + font size + font style + font instance + + + + Get data object for the given html and plain text data.
+ The data object can be used for clipboard or drag-drop operation. + + the html data + the plain text data + drag-drop data object + + + + Set the given text to the clipboard + + the text to set + + + + Set the given html and plain text data to clipboard. + + the html data + the plain text data + + + + Set the given image to clipboard. + + + + + + Create a context menu that can be used on the control + + new context menu + + + + Save the given image to file by showing save dialog to the client. + + the image to save + the name of the image for save dialog + the extension of the image for save dialog + optional: the control to show the dialog on + + + + Adapter for platform specific brush objects - used to fill graphics (rectangles, polygons and paths).
+ The brush can be solid color, gradient or image. + + + + + + + + + + Adapter for platform specific context menu - used to create and show context menu at specific location.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The total number of items in the context menu + + + + + Add divider item to the context menu.
+ The divider is a non clickable place holder used to separate items. + + + + + Add item to the context menu with the given text that will raise the given event when clicked. + the text to set on the new context menu itemif to set the item as enabled or disabledthe event to raise when the item is clicked + + + + Remove the last item from the context menu iff it is a divider + + + + + Show the context menu in the given parent control at the given location. + the parent control to show inthe location to show at relative to the parent control + + + + + + + + + Adapter for platform specific control object - used to handle updating the control that the html is rendered on.
+ Not relevant for platforms that don't render HTML on UI element. + + + + + The platform adapter. + + + + + Init control with platform adapter. + + + + + The platform adapter. + + + + + Is the left mouse button is currently in pressed state + + + + + Is the right mouse button is currently in pressed state + + + + + Get the current location of the mouse relative to the control + + + + + Set the cursor over the control to default cursor + + + + + Set the cursor over the control to hand cursor + + + + + Set the cursor over the control to I beam cursor + + + + + Do drag-drop copy operation for the given data object. + + the drag-drop data object + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Invalidates the entire surface of the control and causes the control to be redrawn. + + + + + Adapter for platform specific font object - used to render text using specific font. + + + + + Gets the em-size of this Font measured in the units specified by the Unit property. + + + + + The line spacing, in pixels, of this font. + + + + + Get the vertical offset of the font underline location from the top of the font. + + + + + Get the left padding, in pixels, of the font. + + + + + + + + + + + + Adapter for platform specific font family object - define the available font families to use.
+ Required for custom fonts handling: fonts that are not installed on the system. + + + + + Gets the name of this Font Family. + + + + + Adapter for platform specific graphics rendering object - used to render graphics and text in platform specific context.
+ The core HTML Renderer components use this class for rendering logic, extending this + class in different platform: WinForms, WPF, Metro, PDF, etc. + + + + + the global adapter + + + + + Te clipping bound stack as clips are pushed/poped to/from the graphics + + + + + Init. + + + + + Get color pen. + + the color to get the pen for + pen instance + + + + Get solid color brush. + + the color to get the brush for + solid color brush instance + + + + Get linear gradient color brush from to . + + the rectangle to get the brush for + the start color of the gradient + the end color of the gradient + the angle to move the gradient from start color to end color in the rectangle + linear gradient color brush instance + + + + Gets a Rectangle structure that bounds the clipping region of this Graphics. + + A rectangle structure that represents a bounding rectangle for the clipping region of this Graphics. + + + + Pop the latest clip push. + + + + + Push the clipping region of this Graphics to interception of current clipping rectangle and the given rectangle. + + Rectangle to clip to. + + + + Push the clipping region of this Graphics to exclude the given rectangle from the current clipping rectangle. + + Rectangle to exclude clipping in. + + + + Set the graphics smooth mode to use anti-alias.
+ Use to return back the mode used. + + the previous smooth mode before the change + + + + Return to previous smooth mode before anti-alias was set as returned from . + + the previous mode to set + + + + Get TextureBrush object that uses the specified image and bounding rectangle. + + The Image object with which this TextureBrush object fills interiors. + A Rectangle structure that represents the bounding rectangle for this TextureBrush object. + The dimension by which to translate the transformation + + + + Get GraphicsPath object. + + graphics path instance + + + + Measure the width and height of string when drawn on device context HDC + using the given font . + + the string to measure + the font to measure string with + the size of the string + + + + Measure the width of string under max width restriction calculating the number of characters that can fit and the width those characters take.
+ Not relevant for platforms that don't render HTML on UI element. + + the string to measure + the font to measure string with + the max width to calculate fit characters + the number of characters that will fit under maxWidth restriction + the width that only the characters that fit into max width take + + + + Draw the given string using the given font and foreground color at given location. + + the string to draw + the font to use to draw the string + the text color to set + the location to start string draw (top-left) + used to know the size of the rendered text for transparent text support + is to render the string right-to-left (true - RTL, false - LTR) + + + + Draws a line connecting the two points specified by the coordinate pairs. + + Pen that determines the color, width, and style of the line. + The x-coordinate of the first point. + The y-coordinate of the first point. + The x-coordinate of the second point. + The y-coordinate of the second point. + + + + Draws a rectangle specified by a coordinate pair, a width, and a height. + + A Pen that determines the color, width, and style of the rectangle. + The x-coordinate of the upper-left corner of the rectangle to draw. + The y-coordinate of the upper-left corner of the rectangle to draw. + The width of the rectangle to draw. + The height of the rectangle to draw. + + + + Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height. + + Brush that determines the characteristics of the fill. + The x-coordinate of the upper-left corner of the rectangle to fill. + The y-coordinate of the upper-left corner of the rectangle to fill. + Width of the rectangle to fill. + Height of the rectangle to fill. + + + + Draws the specified portion of the specified at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. The image is scaled to fit the rectangle. + Rectangle structure that specifies the portion of the object to draw. + + + + Draws the specified Image at the specified location and with the specified size. + + Image to draw. + Rectangle structure that specifies the location and size of the drawn image. + + + + Draws a GraphicsPath. + + Pen that determines the color, width, and style of the path. + GraphicsPath to draw. + + + + Fills the interior of a GraphicsPath. + + Brush that determines the characteristics of the fill. + GraphicsPath that represents the path to fill. + + + + Fills the interior of a polygon defined by an array of points specified by Point structures. + + Brush that determines the characteristics of the fill. + Array of Point structures that represent the vertices of the polygon to fill. + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Adapter for platform specific graphics path object - used to render (draw/fill) path shape. + + + + + Start path at the given point. + + + + + Add stright line to the given point from te last point. + + + + + Add circular arc of the given size to the given point from the last point. + + + + + Release path resources. + + + + + The 4 corners that are handled in arc rendering. + + + + + + + + + + + + + + + + + + + + + + + + + Adapter for platform specific image object - used to render images. + + + + + Get the width, in pixels, of the image. + + + + + Get the height, in pixels, of the image. + + + + + + + + + + Adapter for platform specific pen objects - used to draw graphics (lines, rectangles and paths) + + + + + Gets or sets the width of this Pen, in units of the Graphics object used for drawing. + + + + + Gets or sets the style used for dashed lines drawn with this Pen. + + + + + Holds parsed stylesheet css blocks arranged by media and classes.
+ + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + used to return empty array + + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data. + + + + + Init. + + + + + Parse the given stylesheet to object.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + Platform adapter + the stylesheet source to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the parsed css data + + + + dictionary of media type to dictionary of css class name to the cssBlocks collection with all the data + + + + + Check if there are css blocks for the given class selector. + + the class selector to check for css blocks by + optional: the css media type (default - all) + true - has css blocks for the class, false - otherwise + + + + Get collection of css blocks for the requested class selector.
+ the can be: class name, html element name, html element and + class name (elm.class), hash tag with element id (#id).
+ returned all the blocks that word on the requested class selector, it can contain simple + selector or hierarchy selector. + + the class selector to get css blocks by + optional: the css media type (default - all) + collection of css blocks, empty collection if no blocks exists (never null) + + + + Add the given css block to the css data, merging to existing block if required. + + + If there is no css blocks for the same class it will be added to data collection.
+ If there is already css blocks for the same class it will check for each existing block + if the hierarchical selectors match (or not exists). if do the two css blocks will be merged into + one where the new block properties overwrite existing if needed. if the new block doesn't mach any + existing it will be added either to the beginning of the list if it has no hierarchical selectors or at the end.
+ Css block without hierarchical selectors must be added to the beginning of the list so more specific block + can overwrite it when the style is applied. + + the media type to add the CSS to + the css block to add + + + + Combine this CSS data blocks with CSS blocks for each media.
+ Merge blocks if exists in both. + + the CSS data to combine with + + + + Create deep copy of the css data with cloned css blocks. + + cloned object + + + + CSS Specification's Default Style Sheet for HTML 4 + + + http://www.w3.org/TR/CSS21/sample.html + + + + + Border types + + + + + Represents a CSS Box of text or replaced elements. + + + The Box can contains other boxes, that's the way that the CSS Tree + is composed. + + To know more about boxes visit CSS spec: + http://www.w3.org/TR/CSS21/box.html + + + + + the parent css box of this css box in the hierarchy + + + + + the root container for the hierarchy + + + + + the html tag that is associated with this css box, null if anonymous box + + + + + the inner text of the box + + + + + Do not use or alter this flag + + + Flag that indicates that CssTable algorithm already made fixes on it. + + + + + handler for loading background image + + + + + Init. + + optional: the parent of this css box in html + optional: the html tag associated with this css box + + + + Gets the HtmlContainer of the Box. + WARNING: May be null. + + + + + Gets or sets the parent box of this box + + + + + Gets the children boxes of this box + + + + + Is the box is of "br" element. + + + + + is the box "Display" is "Inline", is this is an inline box and not block. + + + + + is the box "Display" is "Block", is this is an block box and not inline. + + + + + Is the css box clickable (by default only "a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + Gets the containing block-box of this box. (The nearest parent box with display=block) + + + + + Gets the HTMLTag that hosts this box + + + + + Gets if this box represents an image + + + + + Tells if the box is empty or contains just blank spaces + + + + + Gets or sets the inner text of the box + + + + + Gets the line-boxes of this box (if block box) + + + + + Gets the linebox(es) that contains words of this box (if inline) + + + + + Gets the rectangles where this box should be painted + + + + + Gets the BoxWords of text in the box + + + + + Gets the first word of the box + + + + + Gets or sets the first linebox where content of this box appear + + + + + Gets or sets the last linebox where content of this box appear + + + + + Create new css box for the given parent with the given html tag.
+ + the html tag to define the box + the box to add the new box to it as child + the new box + + + + Create new css box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous inline boxes visit: http://www.w3.org/TR/CSS21/visuren.html#anonymous + + the box to add the new box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new box + + + + Create new css block box. + + the new block box + + + + Create new css block box for the given parent with the given optional html tag and insert it either + at the end or before the given optional box.
+ If no html tag is given the box will be anonymous.
+ If no before box is given the new box will be added at the end of parent boxes collection.
+ If before box doesn't exists in parent box exception is thrown.
+ + + To learn more about anonymous block boxes visit CSS spec: + http://www.w3.org/TR/CSS21/visuren.html#anonymous-block-level + + the box to add the new block box to it as child + optional: the html tag to define the box + optional: to insert as specific location in parent box + the new block box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + Device context to use + + + + Prints the fragment + + Device context to use + + + + + + Set this box in + + + + + + Move all child boxes from to this box. + + the box to move all its child boxes from + + + + Splits the text into words and saves the result + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions.
+ + Device context to use + + + + Assigns words its width and height + + + + + + Get the parent of this css properties instance. + + + + + + Gets the index of the box to be used on a (ordered) list + + + + + + Creates the + + + + + + Searches for the first word occurrence inside the box, on the specified linebox + + + + + + + + Gets the specified Attribute, returns string.Empty if no attribute specified + + Attribute to retrieve + Attribute value or string.Empty if no attribute specified + + + + Gets the value of the specified attribute of the source HTML tag. + + Attribute to retrieve + Value to return if attribute is not specified + Attribute value or defaultValue if no attribute specified + + + + Gets the minimum width that the box can be.
+ The box can be as thin as the longest word plus padding.
+ The check is deep thru box tree.
+ + the min width of the box + + + + Gets the longest word (in width) inside the box, deeply. + + + + + + + + + Get the total margin value (left and right) from the given box to the given end box.
+ + the box to start calculation from. + the total margin + + + + Gets the maximum bottom of the boxes inside the startBox + + + + + + + + Get the and width of the box content.
+ + The minimum width the content must be so it won't overflow (largest word + padding). + The total width the content can take without line wrapping (with padding). + + + + Get the and of the box words content and .
+ + the box to calculate for + the width that allows for each word to fit (width of the longest word) + the max width a single line of words can take without wrapping + the total amount of padding the content has + + + + + + Gets if this box has only inline siblings (including itself) + + + + + + Gets the rectangles where inline box will be drawn. See Remarks for more info. + + Rectangles where content should be placed + + Inline boxes can be split across different LineBoxes, that's why this method + Delivers a rectangle for each LineBox related to this box, if inline. + + + Inherits inheritable values from parent. + + + + + Gets the result of collapsing the vertical margins of the two boxes + + the previous box under the same parent + Resulting top margin + + + + Calculate the actual right of the box by the actual right of the child boxes if this box actual right is not set. + + the calculated actual right value + + + + Gets the result of collapsing the vertical margins of the two boxes + + Resulting bottom margin + + + + Deeply offsets the top of the box and its contents + + + + + + Paints the fragment + + the device to draw to + + + + Prints the fragment + + the device to draw to + + + + + + Paints the background of the box + + the device to draw into + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Paint all the words in the box. + + the device to draw into + the current scroll offset to offset the words + + + + Paints the text decoration (underline/strike-through/over-line) + + the device to draw into + + + + + + + Offsets the rectangle of the specified linebox by the specified gap, + and goes deep for rectangles of children in that linebox. + + + + + + + Resets the array + + + + + On image load process complete with image request refresh for it to be painted. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Get brush for the text depending if there is selected text color set. + + + + + Get brush for selection background depending if it has external and if alpha is required for images. + + + used for images so they will have alpha effect + + + + ToString override. + + + + + + CSS box for iframe element.
+ If the iframe is of embedded YouTube or Vimeo video it will show image with play. + + + + + the image word of this image box + + + + + is the iframe is of embeded video + + + + + the title of the video + + + + + the url of the video thumbnail image + + + + + link to the video on the site + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Is the css box clickable ("a" element is clickable) + + + + + Get the href link of the box (by default get "href" attribute) + + + + + is the iframe is of embeded video + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Load YouTube video data (title, image, link) by calling YouTube API. + + + + + Parse YouTube API response to get video data (title, image, link). + + + + + Load Vimeo video data (title, image, link) by calling Vimeo API. + + + + + Parse Vimeo API response to get video data (title, image, link). + + + + + Handle error occurred during video data load to handle if the video was not found. + + the exception that occurred during data load web request + the name of the video source (YouTube/Vimeo/Etc.) + + + + Create image handler for downloading video image if found and release the WebClient instance used for API call. + + + + + Paints the fragment + + the device to draw to + + + + Draw video image over the iframe if found. + + + + + Draw video title on top of the iframe if found. + + + + + Draw play over the iframe if we found link url. + + + + + Assigns words its width and height + + the device to use + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + CSS box for hr element. + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Measures the bounds of box and children, recursively.
+ Performs layout of the DOM structure creating lines by set bounds restrictions. + + Device context to use + + + + Paints the fragment + + the device to draw to + + + + CSS box for image element. + + + + + the image word of this image box + + + + + handler used for image loading by source + + + + + is image load is finished, used to know if no image is found + + + + + Init. + + the parent box of this box + the html tag data of this box + + + + Get the image of this image box. + + + + + Paints the fragment + + the device to draw to + + + + Assigns words its width and height + + the device to use + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set error image border on the image box. + + + + + On image load process is complete with image or without update the image box. + + the image loaded or null if failed + the source rectangle to draw in the image (empty - draw everything) + is the callback was called async to load image call + + + + Base class for css box to handle the css properties.
+ Has field and property for every css property that can be set, the properties add additional parsing like + setting the correct border depending what border value was set (single, two , all four).
+ Has additional fields to control the location and size of the box and 'actual' css values for some properties + that require additional calculations and parsing.
+ + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + the width of whitespace between words + + + + + Gets or sets the location of the box + + + + + Gets or sets the size of the box + + + + + Gets the bounds of the box + + + + + Gets the width available on the box, counting padding and margin. + + + + + Gets the right of the box. When setting, it will affect only the width of the box. + + + + + Gets or sets the bottom of the box. + (When setting, alters only the Size.Height of the box) + + + + + Gets the left of the client rectangle (Where content starts rendering) + + + + + Gets the top of the client rectangle (Where content starts rendering) + + + + + Gets the right of the client rectangle + + + + + Gets the bottom of the client rectangle + + + + + Gets the client rectangle + + + + + Gets the actual height + + + + + Gets the actual height + + + + + Gets the actual top's padding + + + + + Gets the actual padding on the left + + + + + Gets the actual Padding of the bottom + + + + + Gets the actual padding on the right + + + + + Gets the actual top's Margin + + + + + The margin top value if was effected by margin collapse. + + + + + Gets the actual Margin on the left + + + + + Gets the actual Margin of the bottom + + + + + Gets the actual Margin on the right + + + + + Gets the actual top border width + + + + + Gets the actual Left border width + + + + + Gets the actual Bottom border width + + + + + Gets the actual Right border width + + + + + Gets the actual top border Color + + + + + Gets the actual Left border Color + + + + + Gets the actual Bottom border Color + + + + + Gets the actual Right border Color + + + + + Gets the actual length of the north west corner + + + + + Gets the actual length of the north east corner + + + + + Gets the actual length of the south east corner + + + + + Gets the actual length of the south west corner + + + + + Gets a value indicating if at least one of the corners of the box is rounded + + + + + Gets the actual width of whitespace between words. + + + + + + Gets the actual color for the text. + + + + + Gets the actual background color of the box + + + + + Gets the second color that creates a gradient for the background + + + + + Gets the actual angle specified for the background gradient + + + + + Gets the actual font of the parent + + + + + Gets the font that should be actually used to paint the text of the box + + + + + Gets the line height + + + + + Gets the text indentation (on first line only) + + + + + Gets the actual horizontal border spacing for tables + + + + + Gets the actual vertical border spacing for tables + + + + + Get the parent of this css properties instance. + + + + + + Gets the height of the font in the specified units + + + + + + Ensures that the specified length is converted to pixels if necessary + + + + + + Set the style/width/color for all 4 borders on the box.
+ if null is given for a value it will not be set. + + optional: the style to set + optional: the width to set + optional: the color to set + + + + Measures the width of whitespace between words (set ). + + + + + Inherits inheritable values from specified box. + + Set to true to inherit all CSS properties instead of only the ineritables + Box to inherit the properties + + + + Helps on CSS Layout. + + + + + Measure image box size by the width\height set on the box and the actual rendered image size.
+ If no image exists for the box error icon will be set. + + the image word to measure + + + + Creates line boxes for the specified blockbox + + + + + + + Applies special vertical alignment for table-cells + + + + + + + Recursively flows the content of the box using the inline model + + Device Info + Blockbox that contains the text flow + Current box to flow its content + Maximum reached right + Space to use between rows of text + x starting coordinate for when breaking lines of text + Current linebox being used + Current x coordinate that will be the left of the next word + Current y coordinate that will be the top of the next word + Maximum right reached so far + Maximum bottom reached so far + + + + Adjust the position of absolute elements by letf and top margins. + + + + + Recursively creates the rectangles of the blockBox, by bubbling from deep to outside of the boxes + in the rectangle structure + + + + + Applies vertical and horizontal alignment to words in lineboxes + + + + + + + Applies right to left direction to words + + + + + + + Applies RTL direction to all the words on the line. + + the line to apply RTL to + + + + Applies RTL direction to specific box words on the line. + + + + + + + Applies vertical alignment to the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies centered alignment to the text on the linebox + + + + + + + Applies right alignment to the text on the linebox + + + + + + + Simplest alignment, just arrange words. + + + + + + + Layout engine for tables executing the complex layout of tables with rows/columns/headers/etc. + + + + + the main box of the table + + + + + + + + + + collection of all rows boxes + + + + + collection of all columns boxes + + + + + + + + + + Init. + + + + + + Get the table cells spacing for all the cells in the table.
+ Used to calculate the spacing the table has in addition to regular padding and borders. + + the table box to calculate the spacing for + the calculated spacing + + + + + + + + + + + Analyzes the Table and assigns values to this CssTable object. + To be called from the constructor + + + + + Get the table boxes into the proper fields. + + + + + Insert EmptyBoxes for vertical cell spanning. + + + + + Determine Row and Column Count, and ColumnWidths + + + + + + + + + + + + While table width is larger than it should, and width is reductable.
+ If table max width is limited by we need to lower the columns width even if it will result in clipping
+ + + + + Check for minimum sizes (increment widths if necessary) + + + + + Layout the cells by the calculated table layout + + + + + + Gets the spanned width of a cell (With of all columns it spans minus one). + + + + + Gets the cell column index checking its position and other cells colspans + + + + + + + + Gets the cells width, taking colspan and being in the specified column + + + + + + + + Gets the colspan of the specified box + + + + + + Gets the rowspan of the specified box + + + + + + Recursively measures words inside the box + + the box to measure + Device to use + + + + Tells if the columns widths can be reduced, + by checking the minimum widths of all cells + + + + + + Tells if the specified column can be reduced, + by checking its minimum width + + + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Gets the available width for the whole table. + It also sets the value of WidthSpecified + + + + The table's width can be larger than the result of this method, because of the minimum + size that individual boxes. + + + + + Calculate the min and max width for each column of the table by the content in all rows.
+ the min width possible without clipping content
+ the max width the cell content can take without wrapping
+ + if to measure only columns that have no calculated width + return the min width for each column - the min width possible without clipping content + return the max width for each column - the max width the cell content can take without wrapping + + + + Gets the width available for cells + + + + It takes away the cell-spacing from + + + + + Gets the current sum of column widths + + + + + + Gets the span attribute of the tag of the specified box + + + + + + Gets the minimum width of each column + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual horizontal spacing of the table + + + + + Gets the actual vertical spacing of the table + + + + + Represents and gets info about a CSS Length + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + Creates a new CssLength from a length specified on a CSS style sheet or fragment + + Length as specified in the Style Sheet or style fragment + + + + Gets the number in the length + + + + + Gets if the length has some parsing error + + + + + Gets if the length represents a precentage (not actually a length) + + + + + Gets if the length is specified in relative units + + + + + Gets the unit of the length + + + + + Gets the length as specified in the string + + + + + If length is in Ems, returns its value in points + + Em size factor to multiply + Points size of this em + If length has an error or isn't in ems + + + + If length is in Ems, returns its value in pixels + + Pixel size factor to multiply + Pixels size of this em + If length has an error or isn't in ems + + + + Returns the length formatted ready for CSS interpreting. + + + + + + Represents a line of text. + + + To learn more about line-boxes see CSS spec: + http://www.w3.org/TR/CSS21/visuren.html + + + + + Creates a new LineBox + + + + + Gets a list of boxes related with the linebox. + To know the words of the box inside this linebox, use the method. + + + + + Gets the words inside the linebox + + + + + Gets the owner box + + + + + Gets a List of rectangles that are to be painted on this linebox + + + + + Get the height of this box line (the max height of all the words) + + + + + Get the bottom of this box line (the max bottom of all the words) + + + + + Lets the linebox add the word an its box to their lists if necessary. + + + + + + Return the words of the specified box that live in this linebox + + + + + + + Updates the specified rectangle of the specified box. + + + + + + + + + + Copies the rectangles to their specified box + + + + + Sets the baseline of the words of the specified box to certain height + + Device info + box to check words + baseline + + + + Check if the given word is the last selected word in the line.
+ It can either be the last word in the line or the next word has no selection. + + the word to check + + + + + Returns the words of the linebox + + + + + + Represents a word inside an inline box + + + Because of performance, words of text are the most atomic + element in the project. It should be characters, but come on, + imagine the performance when drawing char by char on the device.
+ It may change for future versions of the library. + + + + + the CSS box owner of the word + + + + + Rectangle + + + + + If the word is selected this points to the selection handler for more data + + + + + Init. + + the CSS box owner of the word + + + + Gets the Box where this word belongs. + + + + + Gets or sets the bounds of the rectangle + + + + + Left of the rectangle + + + + + Top of the rectangle + + + + + Width of the rectangle + + + + + Get the full width of the word including the spacing. + + + + + Gets the actual width of whitespace between words. + + + + + Height of the rectangle + + + + + Gets or sets the right of the rectangle. When setting, it only affects the Width of the rectangle. + + + + + Gets or sets the bottom of the rectangle. When setting, it only affects the Height of the rectangle. + + + + + If the word is selected this points to the selection handler for more data + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + is the word is currently selected + + + + + the selection start index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the word is partially selected (-1 if not selected or fully selected) + + + + + Gets or sets an offset to be considered in measurements + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + the image object if it is image word (can be null if not loaded) + + + + + the image rectangle restriction as returned from image load event + + + + + Creates a new BoxWord which represents an image + + the CSS box owner of the word + + + + Gets the image this words represents (if one exists) + + + + + Gets if the word represents an image. + + + + + the image rectange restriction as returned from image load event + + + + + Represents this word for debugging purposes + + + + + + Represents a word inside an inline box + + + + + The word text + + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Init. + + the CSS box owner of the word + the word chars + was there a whitespace before the word chars (before trim) + was there a whitespace after the word chars (before trim) + + + + was there a whitespace before the word chars (before trim) + + + + + was there a whitespace after the word chars (before trim) + + + + + Gets a bool indicating if this word is composed only by spaces. + Spaces include tabs and line breaks + + + + + Gets if the word is composed by only a line break + + + + + Gets the text of the word + + + + + Represents this word for debugging purposes + + + + + + Used to make space on vertical cell combination + + + + + the index of the row where box starts + + + + + the index of the row where box ends + + + + + Gets the index of the row where box starts + + + + + Gets the index of the row where box ends + + + + + Represents the possible units of the CSS lengths + + + http://www.w3.org/TR/CSS21/syndata.html#length-units + + + + + CSS boxes that have ":hover" selector on them. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + Init. + + + + + the box that has :hover css on + + + + + the :hover style block data + + + + + the name of the html tag + + + + + if the tag is single placed; in other words it doesn't have a separate closing tag; + + + + + collection of attributes and their value the html tag has + + + + + Init. + + the name of the html tag + if the tag is single placed; in other words it doesn't have a separate closing tag; + collection of attributes and their value the html tag has + + + + Gets the name of this tag + + + + + Gets collection of attributes and their value the html tag has + + + + + Gets if the tag is single placed; in other words it doesn't have a separate closing tag;
+ e.g. <br> + + + + + is the html tag has attributes. + + true - has attributes, false - otherwise + + + + Gets a boolean indicating if the attribute list has the specified attribute + + attribute name to check if exists + true - attribute exists, false - otherwise + + + + Get attribute value for given attribute name or null if not exists. + + attribute name to get by + optional: value to return if attribute is not specified + attribute value or null if not found + + + + Represents a block of CSS property values.
+ Contains collection of key-value pairs that are CSS properties for specific css class.
+ Css class can be either custom or html tag name. + + + To learn more about CSS blocks visit CSS spec: http://www.w3.org/TR/CSS21/syndata.html#block + + + + + the name of the css class of the block + + + + + the CSS block properties and values + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + is the css block has :hover pseudo-class + + + + + Creates a new block from the block's source + + the name of the css class of the block + the CSS block properties and values + optional: additional selectors to used in hierarchy + optional: is the css block has :hover pseudo-class + + + + the name of the css class of the block + + + + + additional selectors to used in hierarchy (p className1 > className2) + + + + + Gets the CSS block properties and its values + + + + + is the css block has :hover pseudo-class + + + + + Merge the other block properties into this css block.
+ Other block properties can overwrite this block properties. + + the css block to merge with + + + + Create deep copy of the CssBlock. + + new CssBlock with same data + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Check if the selectors of the css blocks is the same. + + the other block to compare to + true - the selectors on blocks are the same, false - otherwise + + + + Check if the two css blocks are the same (same class, selectors and properties). + + the other block to compare to + true - the two blocks are the same, false - otherwise + + + + Serves as a hash function for a particular type. + + A hash code for the current . + + + + Returns a that represents the current . + + + + + Holds single class selector in css block hierarchical selection (p class1 > div.class2) + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Creates a new block from the block's source + + the name of the css class of the block + + + + + the name of the css class of the block + + + + + is the selector item has to be direct parent + + + + + Returns a that represents the current . + + + + + Controls the way styles are generated when html is generated. + + + + + styles are not generated at all + + + + + style are inserted in style attribute for each html tag + + + + + style section is generated in the head of the html + + + + + Callback used in to allow setting image externally and async.
+ The callback can provide path to image file path, URL or the actual image to use.
+ If is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + the image to use + optional: limit to specific rectangle in the loaded image + + + + Invoked when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and + provide file path to load the image from. Can also use the asynchronous image overwrite not to block HTML rendering is applicable.
+ If no alternative data is provided the original source will be used.
+ + + + + use to cancel the image loading by html renderer, the provided image will be used. + + + + + the source of the image (file path or uri) + + + + + collection of all the attributes that are defined on the image element + + + + + Callback used to allow setting image externally and async. + + + + + Init. + + the source of the image (file path or Uri) + collection of all the attributes that are defined on the image element + Callback used to allow setting image externally and async. + + + + the source of the image (file path, URL or inline data) + + + + + collection of all the attributes that are defined on the image element or CSS style + + + + + Indicate the image load is handled asynchronously. + Cancel this image loading and overwrite the image asynchronously using callback method.
+ + + + + Callback to overwrite the loaded image with error image.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ + the path to the image to load (file path or URL) + + + + Callback to overwrite the loaded image with image to load from given URI.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the path to the image to load (file path or URL) + + + + + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ If imageRectangle is given (not ) then only the specified rectangle will + be used from the loaded image and not all of it, also the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + Callback to overwrite the loaded image with given image object.
+ Can be called directly from delegate handler or asynchronously after setting to True.
+ Only the specified rectangle (x,y,width,height) will be used from the loaded image and not all of it, also + the rectangle will be used for size and not the actual image size.
+ + the image to load + + + + + + + + Raised when the user clicks on a link in the html. + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + Init. + + the link href that was clicked + + + + + the link href that was clicked + + + + + collection of all the attributes that are defined on the link element + + + + + use to cancel the execution of the link + + + + + + + + + + + Exception thrown when client code subscribed to LinkClicked event thrown exception. + + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class with a specified error message. + + The message that describes the error. + + + + Initializes a new instance of the class with a specified error message and a reference to the inner exception that is the cause of this exception. + + The error message that explains the reason for the exception. The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ It can happen if some async event has occurred that requires re-paint and re-layout of the html.
+ Example: async download of image is complete. + + + + + is re-layout is required for the refresh + + + + + Init. + + is re-layout is required for the refresh + + + + is re-layout is required for the refresh + + + + + + + + + + + Raised when an error occurred during html rendering. + + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + Init. + + the type of error to report + the error message + optional: the exception that occurred + + + + error type that is reported + + + + + the error message + + + + + the exception that occurred (can be null) + + + + + + + + + + + Enum of possible error types that can be reported. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + the location to scroll to + + + + + Init. + + the location to scroll to + + + + the x location to scroll to + + + + + the x location to scroll to + + + + + + + + + + + Invoked when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Init. + + the source of the image (file path or URL) + collection of all the attributes that are defined on the image element + + + + the source of the stylesheet as found in the HTML (file path or URL) + + + + + collection of all the attributes that are defined on the link element + + + + + provide the new source (file path or URL) to load stylesheet from + + + + + provide the stylesheet to load + + + + + provide the stylesheet data to load + + + + + Holds data on link element in HTML.
+ Used to expose data outside of HTML Renderer internal structure. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Init. + + + + + the id of the link element if present + + + + + the href data of the link + + + + + the rectangle of element as calculated by html layout + + + + + Is the link is directed to another element in the html + + + + + Return the id of the element this anchor link is referencing. + + + + + + + + + + + Contains all the paint code to paint different background images. + + + + + Draw the background image of the given box in the given rectangle.
+ Handle background-repeat and background-position values. + + the device to draw into + the box to draw its background image + the handler that loads image to draw + the rectangle to draw image in + + + + Get top-left location to start drawing the image at depending on background-position value. + + the background-position value + the rectangle to position image in + the size of the image + the top-left location + + + + Draw the background image at the required location repeating it over the X axis.
+ Adjust location to left if starting location doesn't include all the range (adjusted to center or right). + + + + + Draw the background image at the required location repeating it over the Y axis.
+ Adjust location to top if starting location doesn't include all the range (adjusted to center or bottom). + + + + + Draw the background image at the required location repeating it over the X and Y axis.
+ Adjust location to left-top if starting location doesn't include all the range (adjusted to center or bottom/right). + + + + + Contains all the complex paint code to paint different style borders. + + + + + used for all border paint to use the same points and not create new array each time. + + + + + Draws all the border of the box with respect to style, width, etc. + + the device to draw into + the box to draw borders for + the bounding rectangle to draw in + is it the first rectangle of the element + is it the last rectangle of the element + + + + Draw simple border. + + Desired border + the device to draw to + Box which the border corresponds + the brush to use + the bounding rectangle to draw in + Beveled border path, null if there is no rounded corners + + + + Draw specific border (top/bottom/left/right) with the box data (style/width/rounded).
+ + desired border to draw + the box to draw its borders, contain the borders data + the device to draw into + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + + + + Set rectangle for inset/outset border as it need diagonal connection to other borders. + + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Specifies if the border is for a starting line (no bevel on left) + Specifies if the border is for an ending line (no bevel on right) + Beveled border path, null if there is no rounded corners + + + + Makes a border path for rounded borders.
+ To support rounded dotted/dashed borders we need to use arc in the border path.
+ Return null if the border is not rounded.
+ + the device to draw into + Desired border + Box which the border corresponds + the rectangle the border is enclosing + Beveled border path, null if there is no rounded corners + + + + Get pen to be used for border draw respecting its style. + + + + + Get the border color for the given box border. + + + + + Get the border width for the given box border. + + + + + Get the border style for the given box border. + + + + + Makes the specified color darker for inset/outset borders. + + + + + Handle context menu. + + + + + select all text + + + + + copy selected text + + + + + copy the link source + + + + + open link (as left mouse click) + + + + + copy the source of the image + + + + + copy image to clipboard + + + + + save image to disk + + + + + open video in browser + + + + + copy video url to browser + + + + + the selection handler linked to the context menu handler + + + + + the html container the handler is on + + + + + the last context menu shown + + + + + the control that the context menu was shown on + + + + + the css rectangle that context menu shown on + + + + + the css link box that context menu shown on + + + + + Init context menu items strings. + + + + + Init. + + the selection handler linked to the context menu handler + the html container the handler is on + + + + Show context menu clicked on given rectangle. + + the parent control to show the context menu on + the rectangle that was clicked to show context menu + the link that was clicked to show context menu on + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Dispose of the last used context menu. + + + + + Handle link click. + + + + + Copy the href of a link to clipboard. + + + + + Open save as dialog to save the image + + + + + Copy the image source to clipboard. + + + + + Copy image object to clipboard. + + + + + Copy selected text. + + + + + Select all text. + + + + + Utilities for fonts and fonts families handling. + + + + + + + + + + Allow to map not installed fonts to different + + + + + collection of all installed and added font families to check if font exists + + + + + cache of all the font used not to create same font again and again + + + + + Init. + + + + + Check if the given font family exists by name + + the font to check + true - font exists by given family name, false - otherwise + + + + Adds a font family to be used. + + The font family to add. + + + + Adds a font mapping from to iff the is not found.
+ When the font is used in rendered html and is not found in existing + fonts (installed or added) it will be replaced by .
+ + the font family to replace + the font family to replace with + + + + Get cached font instance for the given font properties.
+ Improve performance not to create same font multiple times. + + cached font instance + + + + Get cached font if it exists in cache or null if it is not. + + + + + create font (try using existing font family to support custom fonts) + + + + + Handler for all loading image logic.
+

+ Loading by .
+ Loading by file path.
+ Loading by URI.
+

+ + + + Supports sync and async image loading. + + + If the image object is created by the handler on calling dispose of the handler the image will be released, this + makes release of unused images faster as they can be large.
+ Disposing image load handler will also cancel download of image from the web. + + + + + + the container of the html to handle load image for + + + + + callback raised when image load process is complete with image or without + + + + + the web client used to download image from URL (to cancel on dispose) + + + + + Must be open as long as the image is in use + + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + to know if image load event callback was sync or async raised + + + + + flag to indicate if to release the image object on box dispose (only if image was loaded by the box) + + + + + is the handler has been disposed + + + + + Init. + + the container of the html to handle load image for + callback raised when image load process is complete with image or without + + + + the image instance of the loaded image + + + + + the image rectangle restriction as returned from image load event + + + + + Set image of this image box by analyzing the src attribute.
+ Load the image from inline base64 encoded string.
+ Or from calling property/method on the bridge object that returns image or URL to image.
+ Or from file path
+ Or from URI. + + + File path and URI image loading is executed async and after finishing calling + on the main thread and not thread-pool. + + the source of the image to load + the collection of attributes on the element to use in event + the image object (null if failed) + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + Set the image using callback from load image event, use the given data. + + the path to the image to load (file path or uri) + the image to load + optional: limit to specific rectangle of the image and not all of it + + + + Load the image from inline base64 encoded string data. + + the source that has the base64 encoded image + + + + Extract image object from inline base64 encoded data in the src of the html img element. + + the source that has the base64 encoded image + image from base64 data string or null if failed + + + + Load image from path of image file or URL. + + the file path or uri to load image from + + + + Load the image file on thread-pool thread and calling after. + + the file path to get the image from + + + + Load the image file on thread-pool thread and calling after.
+ Calling on the main thread and not thread-pool. + + the file path to get the image from + + + + Load image from the given URI by downloading it.
+ Create local file name in temp folder from the URI, if the file already exists use it as it has already been downloaded. + If not download the file using . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + + + + Download the requested file in the URI to the given file path.
+ Use async sockets API to download from web, . + + key value pair of URL and file info to download the file to + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + On download image complete to local file use to load the image file.
+ If the download canceled do nothing, if failed report error. + + + + + Flag image load complete and request refresh for re-layout and invalidate. + + + + + Release the image and client objects. + + + + + Handler for text selection in the html. + + + + + the root of the handled html tree + + + + + handler for showing context menu on right click + + + + + the mouse location when selection started used to ignore small selections + + + + + the starting word of html selection
+ where the user started the selection, if the selection is backwards then it will be the last selected word. + + + + + the ending word of html selection
+ where the user ended the selection, if the selection is backwards then it will be the first selected word. + + + + + the selection start index if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end index if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection start offset if the first selected word is partially selected (-1 if not selected or fully selected) + + + + + the selection end offset if the last selected word is partially selected (-1 if not selected or fully selected) + + + + + is the selection goes backward in the html, the starting word comes after the ending word in DFS traversing.
+ + + + + used to ignore mouse up after selection + + + + + current selection process is after double click (full word selection) + + + + + used to know if selection is in the control or started outside so it needs to be ignored + + + + + used to handle drag and drop + + + + + is the cursor on the control has been changed by the selection handler + + + + + used to know if double click selection is requested + + + + + used to know if drag and drop was already started not to execute the same operation over + + + + + Init. + + the root of the handled html tree + + + + Select all the words in the html. + + the control hosting the html to invalidate + + + + Select the word at the given location if found. + + the control hosting the html to invalidate + the location to select word at + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse on the html + + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + is the left mouse button has been released + is the mouse up should be ignored + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse on the html + + + + On mouse leave change the cursor back to default. + + the control hosting the html to set cursor and invalidate + + + + Copy the currently selected html segment to clipboard.
+ Copy rich html text and plain text. + + + + + Get the currently selected text segment in the html.
+ + + + + Copy the currently selected html segment with style.
+ + + + + The selection start index if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start index for + data value or -1 if not applicable + + + + The selection end index if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end index for + + + + The selection start offset if the first selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection start offset for + + + + The selection end offset if the last selected word is partially selected (-1 if not selected or fully selected)
+ if the given word is not starting or ending selection word -1 is returned as full word selection is in place. + + + Handles backward selecting by returning the selection end data instead of start. + + the word to return the selection end offset for + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Handle html text selection by mouse move over the html with left mouse button pressed.
+ Calculate the words in the selected range and set their selected property. + + the control hosting the html to invalidate + the mouse location + true - partial word selection allowed, false - only full words selection + + + + Clear the current selection. + + + + + Clear the selection from all the words in the css box recursively. + + the css box to selectionStart clear at + + + + Start drag and drop operation on the currently selected html segment. + + the control to start the drag and drop on + + + + Select all the words that are under DOM hierarchy.
+ + the box to start select all at + + + + Check if the current selection is non empty, has some selection data. + + + true - partial word selection allowed, false - only full words selection + true - is non empty selection, false - empty selection + + + + Select all the words that are between word and word in the DOM hierarchy.
+ + the root of the DOM sub-tree the selection is in + selection start word limit + selection end word limit + + + + Select all the words that are between word and word in the DOM hierarchy. + + the current traversal node + selection start word limit + selection end word limit + used to know the traversal is currently in selected range + + + + + Calculate the character index and offset by characters for the given word and given offset.
+ . + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + to set the starting or ending char and offset data + + + + Calculate the character index and offset by characters for the given word and given offset.
+ If the location is below the word line then set the selection to the end.
+ If the location is to the right of the word then set the selection to the end.
+ If the offset is to the left of the word set the selection to the beginning.
+ Otherwise calculate the width of each substring to find the char the location is on. + + used to create graphics to measure string + the word to calculate its index and offset + the location to calculate for + is to include the first character in the calculation + return the index of the char under the location + return the offset of the char under the location + + + + Check if the selection direction is forward or backward.
+ Is the selection start word is before the selection end word in DFS traversal. + + + + + Handler for loading a stylesheet data. + + + + + Load stylesheet data from the given source.
+ The source can be local file or web URI.
+ First raise event to allow the client to overwrite the stylesheet loading.
+ If the stylesheet is downloaded from URI we will try to correct local URIs to absolute.
+ + the container of the html to handle load stylesheet for + the source of the element to load the stylesheet by + the attributes of the link element + return the stylesheet string that has been loaded (null if failed or is given) + return stylesheet data object that was provided by overwrite (null if failed or is given) + + + + Load stylesheet string from given source (file path or uri). + + the container of the html to handle load stylesheet for + the file path or uri to load the stylesheet from + the stylesheet string + + + + Load the stylesheet from local file by given path. + + the container of the html to handle load stylesheet for + the stylesheet file to load + the loaded stylesheet string + + + + Load the stylesheet from uri by downloading the string. + + the container of the html to handle load stylesheet for + the uri to download from + the loaded stylesheet string + + + + Make relative URLs absolute in the stylesheet using the URI of the stylesheet. + + the stylesheet to correct + the stylesheet uri to use to create absolute URLs + Corrected stylesheet + + + + Low level handling of Html Renderer logic.
+ Allows html layout and rendering without association to actual control, those allowing to handle html rendering on any graphics object.
+ Using this class will require the client to handle all propagation's of mouse/keyboard events, layout/paint calls, scrolling offset, + location/size/rectangle handling and UI refresh requests.
+ + + + MaxSize and ActualSize:
+ The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can exceed the max size by layout restrictions (unwrap-able line, set image size, etc.).
+ Set zero for unlimited (width/height separately).
+ + + ScrollOffset:
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ Element that is rendered at location (50,100) with offset of (0,200) will not be rendered + at -100, therefore outside the client rectangle. + + + LinkClicked event
+ Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link to overwrite by custom logic.
+ If error occurred in event handler it will propagate up the stack. + + + StylesheetLoad event:
+ Raised when a stylesheet is about to be loaded by file path or URL in 'link' element.
+ Allows to overwrite the loaded stylesheet by providing the stylesheet data manually, or different source (file or URL) to load from.
+ Example: The stylesheet 'href' can be non-valid URI string that is interpreted in the overwrite delegate by custom logic to pre-loaded stylesheet object
+ If no alternative data is provided the original source will be used.
+ + + ImageLoad event:
+ Raised when an image is about to be loaded by file path, URL or inline data in 'img' element or background-image CSS style.
+ Allows to overwrite the loaded image by providing the image object manually, or different source (file or URL) to load from.
+ Example: image 'src' can be non-valid string that is interpreted in the overwrite delegate by custom logic to resource image object
+ Example: image 'src' in the html is relative - the overwrite intercepts the load and provide full source URL to load the image from
+ Example: image download requires authentication - the overwrite intercepts the load, downloads the image to disk using custom code and provide + file path to load the image from.
+ If no alternative data is provided the original source will be used.
+ + + Refresh event:
+ Raised when html renderer requires refresh of the control hosting (invalidation and re-layout).
+ There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + RenderError event:
+ Raised when an error occurred during html rendering.
+ + + + + + + + + + + + + + + + parser for CSS data + + + + + the root css box of the parsed html + + + + + list of all css boxes that have ":hover" selector on them + + + + + Handler for text selection in the html. + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + the parsed stylesheet data used for handling the html + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled (default - true) + + + + + Gets or sets a value indicating if anti-aliasing should be avoided + for geometry like backgrounds and borders + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ + + + + the top-left most location of the rendered html + + + + + the max width and height of the rendered html, effects layout, actual size cannot exceed this values.
+ Set zero for unlimited.
+ + + + + Gets or sets the scroll offset of the document for scroll controls + + + + + The actual size of the rendered html (after layout) + + + + + Init. + + + + + + + + + + parser for CSS data + + + + + Raised when the user clicks on a link in the html.
+ Allows canceling the execution of the link. + + + + + Raised when html renderer requires refresh of the control hosting (invalidation and re-layout). + + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when Html Renderer request scroll to specific location.
+ This can occur on document anchor click. + + + + + Raised when an error occurred during html rendering.
+ + + There is no guarantee that the event will be raised on the main thread, it can be raised on thread-pool thread. + + + + + Raised when a stylesheet is about to be loaded by file path or URI by link element.
+ This event allows to provide the stylesheet manually or provide new source (file or Uri) to load from.
+ If no alternative data is provided the original source will be used.
+ + + + + Raised when an image is about to be loaded by file path or URI.
+ This event allows to provide the image manually, if not handled the image will be loaded from file or download from URI. + + + + + the parsed stylesheet data used for handling the html + + + + + Gets or sets a value indicating if anti-aliasing should be avoided for geometry like backgrounds and borders (default - false). + + + + + Gets or sets a value indicating if image asynchronous loading should be avoided (default - false).
+ True - images are loaded synchronously during html parsing.
+ False - images are loaded asynchronously to html parsing when downloaded from URL or loaded from disk.
+ + + Asynchronously image loading allows to unblock html rendering while image is downloaded or loaded from disk using IO + ports to achieve better performance.
+ Asynchronously image loading should be avoided when the full html content must be available during render, like render to image. + + + + + Gets or sets a value indicating if image loading only when visible should be avoided (default - false).
+ True - images are loaded as soon as the html is parsed.
+ False - images that are not visible because of scroll location are not loaded until they are scrolled to. + + + Images late loading improve performance if the page contains image outside the visible scroll area, especially if there is large + amount of images, as all image loading is delayed (downloading and loading into memory).
+ Late image loading may effect the layout and actual size as image without set size will not have actual size until they are loaded + resulting in layout change during user scroll.
+ Early image loading may also effect the layout if image without known size above the current scroll location are loaded as they + will push the html elements down. + + + + + Is content selection is enabled for the rendered html (default - true).
+ If set to 'false' the rendered html will be static only with ability to click on links. + + + + + Is the build-in context menu enabled and will be shown on mouse right click (default - true) + + + + + The scroll offset of the html.
+ This will adjust the rendered html by the given offset so the content will be "scrolled".
+ + + Element that is rendered at location (50,100) with offset of (0,200) will not be rendered as it + will be at -100 therefore outside the client rectangle. + + + + + The top-left most location of the rendered html.
+ This will offset the top-left corner of the rendered html. + + + + + The max width and height of the rendered html.
+ The max width will effect the html layout wrapping lines, resize images and tables where possible.
+ The max height does NOT effect layout, but will not render outside it (clip).
+ can be exceed the max size by layout restrictions (unwrapable line, set image size, etc.).
+ Set zero for unlimited (width\height separately).
+ + + + + The actual size of the rendered html (after layout) + + + + + Get the currently selected text segment in the html. + + + + + Copy the currently selected html segment with style. + + + + + the root css box of the parsed html + + + + + the text fore color use for selected text + + + + + the back-color to use for selected text + + + + + Init with optional document and stylesheet. + + the html to init with, init empty if not given + optional: the stylesheet to init with, init default if not given + + + + + + + + + + Clear the content of the HTML container releasing any resources used to render previously existing content. + + + + + Get html from the current DOM tree with style if requested. + + Optional: controls the way styles are generated when html is generated (default: ) + generated html + + + + Get attribute value of element at the given x,y location by given key.
+ If more than one element exist with the attribute at the location the inner most is returned. + + the location to find the attribute at + the attribute key to get value by + found attribute value or null if not found + + + + Get all the links in the HTML with the element rectangle and href data. + + collection of all the links in the HTML + + + + Get css link href at the given x,y location. + + the location to find the link at + css link href if exists or null + + + + Get the rectangle of html element as calculated by html layout.
+ Element if found by id (id attribute on the html element).
+ Note: to get the screen rectangle you need to adjust by the hosting control.
+ + the id of the element to get its rectangle + the rectangle of the element or null if not found + + + + Measures the bounds of box and children, recursively. + + Device context to draw + + + + Render the html using the given device. + + the device to use to render + + + + Render the html using the given device. + + the device to use to render + + + + + Handle mouse down to handle selection. + + the control hosting the html to invalidate + the location of the mouse + + + + Handle mouse up to handle selection and link click. + + the control hosting the html to invalidate + the location of the mouse + the mouse event data + + + + Handle mouse double click to select word under the mouse. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse move to handle hover cursor and text selection. + + the control hosting the html to set cursor and invalidate + the location of the mouse + + + + Handle mouse leave to handle hover cursor. + + the control hosting the html to set cursor and invalidate + + + + Handle key down event for selection and copy. + + the control hosting the html to invalidate + the pressed key + + + + Raise the stylesheet load event with the given event args. + + the event args + + + + Raise the image load event with the given event args. + + the event args + + + + Request invalidation and re-layout of the control hosting the renderer. + + is re-layout is required for the refresh + + + + Report error in html render process. + + the type of error to report + the error message + optional: the exception that occured + + + + Handle link clicked going over event and using if not canceled. + + the control hosting the html to invalidate + the location of the mouse + the link that was clicked + + + + Add css box that has ":hover" selector to be handled on mouse hover. + + the box that has the hover selector + the css block with the css data with the selector + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + 2 + + + + Adjust the offset of the given location by the current scroll offset. + + the location to adjust + the adjusted location + + + + Check if the mouse is currently on the html container.
+ Relevant if the html container is not filled in the hosted control (location is not zero and the size is not the full size of the control). + + + + + Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. + + + + + General utilities. + + + + + Measure the size of the html by performing layout under the given restrictions. + + the graphics to use + the html to calculate the layout for + the minimal size of the rendered html (zero - not limit the width/height) + the maximum size of the rendered html, if not zero and html cannot be layout within the limit it will be clipped (zero - not limit the width/height) + return: the size of the html to be rendered within the min/max limits + + + + Perform the layout of the html container by given size restrictions returning the final size.
+ The layout can be effected by the HTML content in the if or + is set to true.
+ Handle minimum and maximum size restrictions.
+ Handle auto size and auto size for height only. if is true + is ignored.
+ + the graphics used for layout + the html container to layout + the current size + the min size restriction - can be empty for no restriction + the max size restriction - can be empty for no restriction + if to modify the size (width and height) by html content layout + if to modify the height by html content layout + + + + Parser to parse CSS stylesheet source string into CSS objects. + + + + + split CSS rule + + + + + + + + + + Utility for value parsing. + + + + + The chars to trim the css class name by + + + + + Init. + + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ If is true the parsed css blocks are added to the + default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned. + + raw css stylesheet to parse + true - combine the parsed css data with default css data, false - return only the parsed css data + the CSS data with parsed CSS objects (never null) + + + + Parse the given stylesheet source to CSS blocks dictionary.
+ The CSS blocks are organized into two level buckets of media type and class name.
+ Root media type are found under 'all' bucket.
+ The parsed css blocks are added to the given css data, merged if class name already exists. + + the CSS data to fill with parsed CSS objects + raw css stylesheet to parse + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the font-family value to parse + parsed font-family value + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + color value + + + + Remove comments from the given stylesheet. + + the stylesheet to remove comments from + stylesheet without comments + + + + Parse given stylesheet for CSS blocks
+ This blocks are added under the "all" keyword. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Parse given stylesheet for media CSS blocks
+ This blocks are added under the specific media block they are found. + + the CSS data to fill with parsed CSS objects + the stylesheet to parse + + + + Feeds the style with a block about the specific media.
+ When no media is specified, "all" will be used. + + + the CSS block to handle + optional: the media (default - all) + + + + Parse single CSS block source into CSS block instance. + + the name of the css class of the block + the CSS block to parse + the created CSS block instance + + + + Parse css block selector to support hierarchical selector (p class1 > class2). + + the class selector to parse + return the main class the css block is on + returns the hierarchy of classes or null if single class selector + + + + Parse the properties of the given css block into a key-value dictionary. + + the raw css block to parse + dictionary with parsed css block properties + + + + Add the given property to the given properties collection, if the property is complex containing + multiple css properties then parse them and add the inner properties. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse length property to add only valid lengths. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse color property to add only valid color. + + the name of the css property to add + the value of the css property to add + the properties collection to add to + + + + Parse a complex font property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + + + the value of the property to parse + parsed value + + + + Parse a complex font family css property to check if it contains multiple fonts and if the font exists.
+ returns the font family name to use or 'inherit' if failed. + + the value of the property to parse + parsed font-family value + + + + Parse a complex border property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the left, top, right or bottom direction of the border to parse + the properties collection to add the specific properties to + + + + Parse a complex margin property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border style property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border width property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex border color property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Parse a complex padding property value that contains multiple css properties into specific css properties. + + the value of the property to parse to specific values + the properties collection to add the specific properties to + + + + Split multi direction value into the proper direction values (left, top, right, bottom). + + + + + Split the value by the specified separator; e.g. Useful in values like 'padding:5 4 3 inherit' + + Value to be splitted + + Splitted and trimmed values + + + + + + + + + + + + + Parse the given substring to extract border width substring. + Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse the given substring to extract border style substring.
+ Assume given substring is not empty and all indexes are valid!
+ + found border width value or null + + + + Parse CSS properties values like numbers, Urls, etc. + + + + + + + + + + Init. + + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid double number, false - otherwise + + + + Check if the given substring is a valid double number. + Assume given substring is not empty and all indexes are valid!
+ + true - valid int number, false - otherwise + + + + Check if the given string is a valid length value. + + the string value to check + true - valid, false - invalid + + + + Evals a number and returns it. If number is a percentage, it will be multiplied by hundredPercent + + Number to be parsed + Number that represents the 100% if parsed number is a percentage + Parsed number. Zero if error while parsing. + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + if the length is in pixels and the length is font related it needs to use 72/96 factor + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + the parsed length value with adjustments + + + + Parses a length. Lengths are followed by an unit identifier (e.g. 10px, 3.1em) + + Specified length + Equivalent to 100 percent when length is percentage + + + if the length is in pixels and the length is font related it needs to use 72/96 factor + Allows the return double to be in points. If false, result will be pixels + the parsed length value with adjustments + + + + Get the unit to use for the length, use default if no unit found in length string. + + + + + Check if the given color string value is valid. + + color string value to parse + true - valid, false - invalid + + + + Parses a color value in CSS style; e.g. #ff0000, red, rgb(255,0,0), rgb(100%, 0, 0) + + color string value to parse + Color value + + + + Parses a color value in CSS style; e.g. #ff0000, RED, RGB(255,0,0), RGB(100%, 0, 0) + + color substring value to parse + substring start idx + substring length + return the parsed color + true - valid color, false - otherwise + + + + Parses a border value in CSS style; e.g. 1px, 1, thin, thick, medium + + + + + + + + Get color by parsing given hex value color string (#A28B34). + + true - valid color, false - otherwise + + + + Get color by parsing given RGB value color string (RGB(255,180,90)) + + true - valid color, false - otherwise + + + + Get color by parsing given RGBA value color string (RGBA(255,180,90,180)) + + true - valid color, false - otherwise + + + + Get color by given name, including .NET name. + + true - valid color, false - otherwise + + + + Parse the given decimal number string to positive int value.
+ Start at given , ignore whitespaces and take + as many digits as possible to parse to int. + + the string to parse + the index to start parsing at + parsed int or 0 + + + + Parse the given decimal number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Parse the given hex number string to positive int value. + Assume given substring is not empty and all indexes are valid!
+ + int value, -1 if not valid + + + + Handle css DOM tree generation from raw html and stylesheet. + + + + + Parser for CSS + + + + + Init. + + + + + Generate css tree by parsing the given html and applying the given css style data on it. + + the html to parse + the html container to use for reference resolve + the css data to use + the root of the generated tree + + + + Read styles defined inside the dom structure in links and style elements.
+ If the html tag is "style" tag parse it content and add to the css data for all future tags parsing.
+ If the html tag is "link" that point to style data parse it content and add to the css data for all future tags parsing.
+ + the box to parse style data in + the html container to use for reference resolve + the style data to fill with found styles + check if the css data has been modified by the handled html not to change the base css data + + + + Applies style to all boxes in the tree.
+ If the html tag has style defined for each apply that style to the css box of the tag.
+ If the html tag has "class" attribute and the class name has style defined apply that style on the tag css box.
+ If the html tag has "style" attribute parse it and apply the parsed style on the tag css box.
+ + the box to apply the style to + the style data for the html + + + + Set the selected text style (selection text color and background color). + + + the style data + + + + Assigns the given css classes to the given css box checking if matching.
+ Support multiple classes in single attribute separated by whitespace. + + the css box to assign css to + the css data to use to get the matching css blocks + + + + Assigns the given css style blocks to the given css box checking if matching. + + the css box to assign css to + the css data to use to get the matching css blocks + the class selector to search for css blocks + + + + Check if the given css block is assignable to the given css box.
+ the block is assignable if it has no hierarchical selectors or if the hierarchy matches.
+ Special handling for ":hover" pseudo-class.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Check if the given css block is assignable to the given css box by validating the selector.
+ + the box to check assign to + the block to check assign of + true - the block is assignable to the box, false - otherwise + + + + Assigns the given css style block properties to the given css box. + + the css box to assign css to + the css block to assign + + + + Check if the given style is allowed to be set on the given css box.
+ Used to prevent invalid CssBoxes creation like table with inline display style. + + the css box to assign css to + the style key to cehck + the style value to check + true - style allowed, false - not allowed + + + + Clone css data if it has not already been cloned.
+ Used to preserve the base css data used when changed by style inside html. + + + + + + + + + + + + Converts an HTML length into a Css length + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Cascades to the TD's the border spacified in the TABLE tag. + + + + + + + Execute action on all the "td" cells of the table.
+ Handle if there is "theader" or "tbody" exists. + + the table element + the action to execute + + + + Go over all the text boxes (boxes that have some text that will be rendered) and + remove all boxes that have only white-spaces but are not 'preformatted' so they do not effect + the rendered html. + + the current box to correct its sub-tree + + + + Go over all image boxes and if its display style is set to block, put it inside another block but set the image to inline. + + the current box to correct its sub-tree + + + + Correct the DOM tree recursively by replacing "br" html boxes with anonymous blocks that respect br spec.
+ If the "br" tag is after inline box then the anon block will have zero height only acting as newline, + but if it is after block box then it will have min-height of the font size so it will create empty line. + + the current box to correct its sub-tree + used to know if the br is following a box so it should create an empty line or not so it only + move to a new line + + + + Correct DOM tree if there is block boxes that are inside inline blocks.
+ Need to rearrange the tree so block box will be only the child of other block box. + + the current box to correct its sub-tree + + + + Rearrange the DOM of the box to have block box with boxes before the inner block box and after. + + the box that has the problem + + + + Split bad box that has inline and block boxes into two parts, the left - before the block box + and right - after the block box. + + the parent box that has the problem + the box to split into different boxes + the left block box that is created for the split + + + + Makes block boxes be among only block boxes and all inline boxes have block parent box.
+ Inline boxes should live in a pool of Inline boxes only so they will define a single block.
+ At the end of this process a block box will have only block siblings and inline box will have + only inline siblings. + + the current box to correct its sub-tree + + + + Check if the given box contains only inline child boxes in all subtree. + + the box to check + true - only inline child boxes, false - otherwise + + + + Check if the given box contains inline and block child boxes. + + the box to check + true - has variant child boxes, false - otherwise + + + + + + + + + Parses the source html to css boxes tree structure. + + the html source to parse + + + + Add html text anon box to the current box, this box will have the rendered text
+ Adding box also for text that contains only whitespaces because we don't know yet if + the box is preformatted. At later stage they will be removed if not relevant. + + the html source to parse + the start of the html part + the index of the next html tag + the current box in html tree parsing + + + + Parse the html part, the part from prev parsing index to the beginning of the next html tag.
+ + the html source to parse + the index of the next html tag + the current box in html tree parsing + the end of the parsed part, the new start index + + + + Parse raw html tag source to object.
+ Extract attributes found on the tag. + + the html source to parse + the start index of the tag in the source + the length of the tag from the start index in the source + return the name of the html tag + return the dictionary of tag attributes + true - the tag is closing tag, false - otherwise + + + + Extract html tag attributes from the given sub-string. + + the html source to parse + the start index of the tag attributes in the source + the length of the tag attributes from the start index in the source + return the dictionary of tag attributes + + + + Collection of regular expressions used when parsing + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + Static class that contains argument-checking methods + + + + + Validate given condition is true, otherwise throw exception. + + Exception type to throw. + Condition to assert. + Exception message in-case of assert failure. + + + + Validate given argument isn't Null. + + argument to validate + Name of the argument checked + if is Null + + + + Validate given argument isn't . + + argument to validate + Name of the argument checked + if is + + + + Validate given argument isn't Null or empty. + + argument to validate + Name of the argument checked + if is Null or empty + + + + Validate given argument isn't Null. + + Type expected of arg + argument to validate + Name of the argument checked + if is Null + arg cast as T + + + + Validate given argument isn't Null or empty AND argument value is the path of existing file. + + argument to validate + Name of the argument checked + if is Null or empty + if arg file-path not exist + + + + Utility methods for general stuff. + + + + + Table to convert numbers into roman digits + + + + + Check if the given char is of Asian range. + + the character to check + true - Asian char, false - otherwise + + + + Check if the given char is a digit character (0-9) and (0-9, a-f for HEX) + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Convert the given char to digit. + + the character to check + optional: is hex digit check + true - is digit, false - not a digit + + + + Get size that is max of and for width and height separately. + + + + + Get Uri object for the given path if it is valid uri path. + + the path to get uri for + uri or null if not valid + + + + Get the first value in the given dictionary. + + the type of dictionary key + the type of dictionary value + the dictionary + optional: the default value to return of no elements found in dictionary + first element or default value + + + + Get file info object for the given path if it is valid file path. + + the path to get file info for + file info or null if not valid + + + + Get web client response content type. + + the web client to get the response content type from + response content type or null + + + + Gets the representation of the online uri on the local disk. + + The online image uri. + The path of the file on the disk. + + + + Get substring seperated by whitespace starting from the given idex. + + the string to get substring in + the index to start substring search from + return the length of the found string + the index of the substring, -1 if no valid sub-string found + + + + Compare that the substring of is equal to + Assume given substring is not empty and all indexes are valid!
+ + true - equals, false - not equals + + + + Replaces invalid filename chars to '_' + + The possibly-not-valid filename + A valid filename. + + + + Convert number to alpha numeric system by the requested style (UpperAlpha, LowerRoman, Hebrew, etc.). + + the number to convert + the css style to convert by + converted string + + + + Convert the given integer into alphabetic numeric format (D, AU, etc.) + + the number to convert + is to use lowercase + the roman number string + + + + Convert the given integer into alphabetic numeric format (alpha, AU, etc.) + + the number to convert + the roman number string + + + + Convert the given integer into roman numeric format (II, VI, IX, etc.) + + the number to convert + if to use lowercase letters for roman digits + the roman number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + Convert the given integer into given alphabet numeric system. + + the number to convert + the alphabet system to use + the number string + + + + String constants to avoid typing errors. + + + + + Centimeters + + + + + Millimeters + + + + + Pixels + + + + + Inches + + + + + Em - The font size of the relevant font + + + + + The 'x-height' of the relevan font + + + + + Points + + + + + Picas + + + + + Default font size in points. Change this value to modify the default font size. + + + + + Default font used for the generic 'serif' family + + + + + Utility method for handling CSS stuff. + + + + + Brush for selection background + + + + + Brush for selection background + + + + + Gets the white space width of the specified box + + + + + + + + Get CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to get it's property value + the name of the CSS property + the value of the property, null if no such property exists + + + + Set CSS box property value by the CSS name.
+ Used as a mapping between CSS property and the class property. + + the CSS box to set it's property value + the name of the CSS property + the value to set + + + + Utility class for traversing DOM structure and execution stuff on it. + + + + + Check if the given location is inside the given box deep.
+ Check inner boxes and all lines that the given box spans to. + + the box to check + the location to check + true - location inside the box, false - otherwise + + + + Check if the given box contains only inline child boxes. + + the box to check + true - only inline child boxes, false - otherwise + + + + Recursively searches for the parent with the specified HTML Tag name + + + + + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Gets the previous sibling of this box. + + Box before this one on the tree. Null if its the first + + + + fix word space for first word in inline tag. + + the box to check + + + + Gets the next sibling of this box. + + Box before this one on the tree. Null if its the first + + + + Get attribute value by given key starting search from given box, search up the tree until + attribute found or root. + + the box to start lookup at + the attribute to get + the value of the attribute or null if not found + + + + Get css box under the given sub-tree at the given x,y location, get the inner most.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + Optional: if to get only visible boxes (default - true) + css link box if exists or null + + + + Collect all link boxes found in the HTML tree. + + the box to start search from + collection to add all link boxes to + + + + Get css link box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box by + css link box if exists or null + + + + Get css box under the given sub-tree with the given id.
+ + the box to start search from + the id to find the box by + css box if exists or null + + + + Get css line box under the given sub-tree at the given y location or the nearest line from the top.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the box to start search from + the location to find the box at + css word box if exists or null + + + + Get css word box under the given sub-tree at the given x,y location.
+ the location must be in correct scroll offset. + + the line box to search in + the location to find the box at + css word box if exists or null + + + + Find the css line box that the given word is in. + + the word to search for it's line box + line box that the word is in + + + + Get selected plain text of the given html sub-tree. + + the DOM box to get selected text from its sub-tree + the selected plain text string + + + + Generate html from the given DOM tree.
+ Generate all the style inside the html, in header or for every tag depending on value. + + the box of the html generate html from + Optional: controls the way styles are generated when html is generated + Optional: true - generate only selected html subset, false - generate all (default - false) + generated html + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the root to generate tree from + generated tree + + + + Get selected plain text of the given html sub-tree.
+ Append all the selected words. + + the builder to append the selected text to + the DOM box to get selected text from its sub-tree + the index of the last word appended + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ + the box to check its sub-tree + the collection to add the selected tags to + + + + Collect the boxes that have at least one word down the hierarchy that is selected recursively.
+ Use to handle boxes that are between selected words but don't have selected word inside.
+ + the box to check its sub-tree + the hash to add the selected boxes to + used to handle boxes that are between selected words but don't have selected word inside + is the current box is in selected sub-tree + + + + find the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + the root of the boxes tree + the selected boxes to find selection root in + the box that is the root of selected boxes + + + + Check if the given box has a names child box (has html tag) recursively. + + the box to check + true - in sub-tree there is a named box, false - otherwise + + + + Write the given html DOM sub-tree into the given string builder.
+ If are given write html only from those tags. + + used to parse CSS data + the string builder to write html into + the html sub-tree to write + Controls the way styles are generated when html is generated + Control if to generate only selected boxes, if given only boxes found in hash will be generated + the box the is the root of selected boxes (the first box to contain multiple selected boxes) + + + + Write the given html tag with all its attributes and styles. + + used to parse CSS data + the string builder to write html into + the css box with the html tag to write + Controls the way styles are generated when html is generated + + + + Clean the given style collection by removing default styles so only custom styles remain.
+ Return new collection where the old remains unchanged. + + the box the styles apply to, used to know the default style + the collection of styles to clean + new cleaned styles collection + + + + Write stylesheet data inline into the html. + + the string builder to write stylesheet into + the css data to write to the head + + + + Get the selected word with respect to partial selected words. + + the word to append + is to get selected text or all the text in the word + + + + Generate textual tree representation of the css boxes tree starting from the given root.
+ Used for debugging html parsing. + + the box to generate for + the string builder to generate to + the current indent level to set indent of generated text + + + + Defines HTML strings + + + + + List of html tags that don't have content + + + + + the html encode\decode pairs + + + + + the html decode only pairs + + + + + Init. + + + + + Is the given html tag is single tag or can have content. + + the tag to check (must be lower case) + true - is single tag, false - otherwise + + + + Decode html encoded string to regular string.
+ Handles <, >, "&. + + the string to decode + decoded string + + + + Encode regular string into html encoded string.
+ Handles <, >, "&. + + the string to encode + encoded string + + + + Decode html special charecters encoded using char entity code (€) + + the string to decode + decoded string + + + + Decode html special charecters encoded using char entity name + + the string to decode + decoded string + + + + Provides some drawing functionality + + + + + Check if the given color is visible if painted (has alpha and color values) + + the color to check + true - visible, false - not visible + + + + Clip the region the graphics will draw on by the overflow style of the containing block.
+ Recursively travel up the tree to find containing block that has overflow style set to hidden. if not + block found there will be no clipping and null will be returned. + + the graphics to clip + the box that is rendered to get containing blocks + true - was clipped, false - not clipped + + + + Draw image loading icon. + + the device to draw into + + the rectangle to draw icon in + + + + Draw image failed to load icon. + + the device to draw into + + the rectangle to draw icon in + + + + Creates a rounded rectangle using the specified corner radius
+ NW-----NE + | | + | | + SW-----SE + + the device to draw into + Rectangle to round + Radius of the north east corner + Radius of the north west corner + Radius of the south east corner + Radius of the south west corner + GraphicsPath with the lines of the rounded rectangle ready to be painted + + + + Represents sub-string of a full string starting at specific location with a specific length. + + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Init sub-string that is the full string. + + the full string that this sub-string is part of + + + + Init. + + the full string that this sub-string is part of + the start index of the sub-string + the length of the sub-string starting at + is null + + + + the full string that this sub-string is part of + + + + + the start index of the sub-string + + + + + the length of the sub-string starting at + + + + + Get string char at specific index. + + the idx to get the char at + char at index + + + + Is the sub-string is empty string. + + true - empty string, false - otherwise + + + + Is the sub-string is empty string or contains only whitespaces. + + true - empty or whitespace string, false - otherwise + + + + Is the sub-string contains only whitespaces (at least one). + + true - empty or whitespace string, false - otherwise + + + + Get a string of the sub-string.
+ This will create a new string object! + + new string that is the sub-string represented by this instance + + + + Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length. + + The zero-based starting character position of a substring in this instance. + The number of characters in the substring. + A String equivalent to the substring of length length that begins at startIndex in this instance, or + Empty if startIndex is equal to the length of this instance and length is zero. + + + + Collection of regular expressions used when parsing + + + + + Extracts CSS style comments; e.g. /* comment */ + + + + + Extracts the media types from a media at-rule; e.g. @media print, 3d, screen { + + + + + Extracts defined blocks in CSS. + WARNING: Blocks will include blocks inside at-rules. + + + + + Extracts a number; e.g. 5, 6, 7.5, 0.9 + + + + + Extracts css percentages from the string; e.g. 100% .5% 5.4% + + + + + Extracts CSS lengths; e.g. 9px 3pt .89em + + + + + Extracts CSS colors; e.g. black white #fff #fe98cd rgb(5,5,5) rgb(45%, 0, 0) + + + + + Extracts line-height values (normal, numbers, lengths, percentages) + + + + + Extracts CSS border styles; e.g. solid none dotted + + + + + Extracts CSS border widthe; e.g. 1px thin 3em + + + + + Extracts font-family values + + + + + Extracts CSS font-styles; e.g. normal italic oblique + + + + + Extracts CSS font-variant values; e.g. normal, small-caps + + + + + Extracts font-weight values; e.g. normal, bold, bolder... + + + + + Exracts font sizes: xx-small, larger, small, 34pt, 30%, 2em + + + + + Gets the font-size[/line-height]? on the font shorthand property. + Check http://www.w3.org/TR/CSS21/fonts.html#font-shorthand + + + + + Extracts HTML tags + + + + + Extracts attributes from a HTML tag; e.g. att=value, att="value" + + + + + the regexes cache that is used by the parser so not to create regex each time + + + + + Get CSS at rule from the given stylesheet. + + the stylesheet data to retrieve the rule from + the index to start the search for the rule, on return will be the value of the end of the found rule + the found at rule or null if not exists + + + + Extracts matches from the specified source + + Regular expression to extract matches + Source to extract matches + Collection of matches + + + + Searches the specified regex on the source + + + + + + + + Searches the specified regex on the source + + + + + + + + + Get regex instance for the given regex string. + + the regex string to use + the regex instance + + + + 线条图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + 初始化参数 + + + + + 返回或设置X轴间隔 + + + + + 标题 + + + + + 返回图片的宽度 + + + + + 返回或设置图片的高度 + + + + + X轴的间距 + + + + + Y轴的间距 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 背景颜色 + + + + + X轴的颜色 + + + + + Y轴的颜色 + + + + + 返回X轴数据的最大值(供给Painter调用) + + + + + 返回图片数据 + + + + + 画布 + + + + + 作图器 + + + + + 释放内容资源 + + + + + 获取X轴中的最大值 + + + + + + + 获取所有X轴列中的最大值 + + + + + + + 初始化图片 + + X轴的数据 + + + + + 画一条走势图 + + + + + + 画多条走势图 + + + + + + 作图器的基础类 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 返回此作图器的相关链走势图 + + + + + 获取某值在Y轴上的位置 + + 当前点的值 + 点坐标 + + + + 画XY轴线 + + 画布 + X轴的数据 + + + + 画标题 + + + + + + 画走势线 + + 画布 + X轴数据 + + + + 方块图 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + 画值 + + 画布 + X轴数据 + + + + 走势图的X轴数据 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + + + 标题 + + + + + 值 + + + + + 标题的颜色 + + + + + 标题的字体 + + + + + 值的颜色 + + + + + 值的字体 + + + + + 绘制颜色 + + + + + 值是否可见 + + + + + 克隆自身 + + + + + + 定义X轴的数据集合 + + + 作者: Kingthy + 日期: 2007-09-11 + MSN: Kingthy@gmail.com + 转载请注明原作者,当你有更新修改时如果方便的希望能发一份给我.谢谢 + + + + + + + + + + + + + + + + 添加一批数据 + + 轴的标题 + + + + 添加一批数据 + + 轴的标题 + 轴的值 + + + + 重置轴的值 + + 轴的值 + + + + 克隆数据 + + + + + + Indicates the behavior of a key when a cell "on the edge" is being edited. + and the normal behavior of that key would exceed the edge. For example, + for a key that normally moves one column to the left, the "edge" would be + the left most column, since the normal action of the key cannot be taken + (since there are no more columns to the left). + + + + + 按键将被忽略 + + + + + 按键将导致单元格编辑环绕到相对边缘的单元格。 + + + + + 按键将Wrap，但该列将更改为相应的相邻列。这只对正常操作为ChangeRow的键有意义。 + + + + + 按键将Wrap，但该行将更改为相应的相邻行。这只对正常操作为ChangeColumn的键有意义. + + + + + 该键将导致当前编辑操作结束。 + + + + + Indicates the normal behaviour of a key when used during a cell edit + operation. + + + + + The key press will be ignored + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the left. + + + + + The key press will end the current edit and begin an edit + operation on the next editable cell to the right. + + + + + The key press will end the current edit and begin an edit + operation on the row above. + + + + + The key press will end the current edit and begin an edit + operation on the row below + + + + + The key press will cancel the current edit + + + + + The key press will finish the current edit operation + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Custom verb that can be used for specialized actions. + + + + + Instances of this class handle key presses during a cell edit operation. + + + + + 设置给定键的行为 + + + + + + + + 处理按键操作 + + + + True if the key was completely handled. + + + + Gets or sets the ObjectListView on which the current key is being handled. + This cannot be null. + + + + + Gets the row of the cell that is currently being edited + + + + + Gets the index of the column of the cell that is being edited + + + + + Gets or sets the map that remembers the normal behaviour of keys + + + + + Gets or sets the map that remembers the desired behaviour of keys + on edge cases. + + + + + Setup the default key mapping + + + + + Handle the end edit command + + + + + Handle the cancel edit command + + + + + Placeholder that subclasses can override to handle any custom verbs + + + + + + + + Handle a change row command + + + + + + + Handle a change column command + + + + + + + Start editing the indicated cell if that cell is not already being edited + + The row to edit + The cell within that row to edit + + + + Gets the adjacent item to the given item in the given direction. + If that item is disabled, continue in that direction until an enabled item is found. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more enabled items in that direction. + + + + Gets the adjacent item to the given item in the given direction, wrapping if needed. + + The row whose neighbour is sought + The direction of the adjacentness + An OLVListView adjacent to the given item, or null if there are no more items in that direction. + + + + Gets a collection of columns that are editable in the order they are shown to the user + + + + + These items allow combo boxes to remember a value and its description. + + + + + + + + + + + + + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + This editor shows and auto completes values from the given listview column. + + + + + Create an AutoCompleteCellEditor + + + + + + + This combo box is specialised to allow editing of an enum. + + + + + + + + + + + This editor simply shows and edits integer values. + + + + + + + + + + Gets or sets the value shown by this editor + + + + + This editor simply shows and edits unsigned integer values. + + This class can't be made public because unsigned int is not a + CLS-compliant type. If you want to use, just copy the code to this class + into your project and use it from there. + + + + This editor simply shows and edits boolean values. + + + + + + + + + + This editor simply shows and edits boolean values using a checkbox + + + + + Gets or sets the value shown by this editor + + + + + Gets or sets how the checkbox will be aligned + + + + + This editor simply shows and edits floating point values. + + You can intercept the CellEditStarting event if you want + to change the characteristics of the editor. For example, by increasing + the number of decimal places. + + + + + + + + + Gets or sets the value shown by this editor + + + + + A delegate that creates an editor for the given value + + The model from which that value came + The column for which the editor is being created + A representative value of the type to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A control which can edit the given value + + + + An editor registry gives a way to decide what cell editor should be used to edit + the value of a cell. Programmers can register non-standard types and the control that + should be used to edit instances of that type. + + + All ObjectListViews share the same editor registry. + + + + + Create an EditorRegistry + + + + + Register that values of 'type' should be edited by instances of 'controlType'. + + The type of value to be edited + The type of the Control that will edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), typeof(MySpecialColorEditor)); + + + + + Register the given delegate so that it is called to create editors + for values of the given type + + The type of value to be edited + The delegate that will create a control that can edit values of 'type' + + ObjectListView.EditorRegistry.Register(typeof(Color), CreateColorEditor); + ... + public Control CreateColorEditor(Object model, OLVColumn column, Object value) + { + return new MySpecialColorEditor(); + } + + + + + Register a delegate that will be called to create an editor for values + that have not been handled. + + The delegate that will create a editor for all other types + + + + Register a delegate that will be given a chance to create a control + before any other option is considered. + + The delegate that will create a control + + + + Remove the registered handler for the given type + + Does nothing if the given type doesn't exist + The type whose registration is to be removed + + + + Create and return an editor that is appropriate for the given value. + Return null if no appropriate editor can be found. + + The model involved + The column to be edited + The value to be edited. This value may not be the exact + value for the column/model combination. It could be simply representative of + the appropriate type of value. + A Control that can edit the given type of values + + + + Create and return an editor that will edit values of the given type + + A enum type + + + + A DataListView is a ListView that can be bound to a datasource (which would normally be a DataTable or DataView). + + + This listview keeps itself in sync with its source datatable by listening for change events. + The DataListView will automatically create columns to show all of the data source's columns/properties, if there is not already + a column showing that property. This allows you to define one or two columns in the designer and then have the others generated automatically. + If you don't want any column to be auto generated, set to false. + These generated columns will be only the simplest view of the world, and would look more interesting with a few delegates installed. + This listview will also automatically generate missing aspect getters to fetch the values from the data view. + Changing data sources is possible, but error prone. Before changing data sources, the programmer is responsible for modifying/resetting + the column collection to be valid for the new data source. + Internally, a CurrencyManager controls keeping the data source in-sync with other users of the data source (as per normal .NET + behavior). This means that the model objects in the DataListView are DataRowView objects. If you write your own AspectGetters/Setters, + they will be given DataRowView objects. + + + + + Make a DataListView + + + + + + + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + When a DataSource is set, the control will create OLVColumns to show any + data source columns that are not already shown. + If the DataSource is changed, you will have to remove any previously + created columns, since they will be configured for the previous DataSource. + . + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + Adaptors cannot be shared between controls. Each DataListView needs its own adapter. + + + + + Add the given collection of model objects to this control. + + A collection of model objects + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Insert the given collection of objects before the given position + + Where to insert the objects + The objects to be inserted + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Remove the given collection of model objects from this control. + + This is a no-op for data lists, since the data + is controlled by the DataSource. Manipulate the data source + rather than this view of the data source. + + + + Change the Unfreeze behaviour + + + + + Handles parent binding context changes + + Unused EventArgs. + + + + A DataTreeListView is a TreeListView that calculates its hierarchy based on + information in the data source. + + + Like a , a DataTreeListView sources all its information + from a combination of and . + can be a DataTable, DataSet, + or anything that implements . + + + To function properly, the DataTreeListView requires: + + the table to have a column which holds a unique for the row. The name of this column must be set in . + the table to have a column which holds id of the hierarchical parent of the row. The name of this column must be set in . + a value which identifies which rows are the roots of the tree (). + + The hierarchy structure is determined finding all the rows where the parent key is equal to . These rows + become the root objects of the hierarchy. + + Like a TreeListView, the hierarchy must not contain cycles. Bad things will happen if the data is cyclic. + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + The DataSource should implement either , , + or . Some common examples are the following types of objects: + + + + + + + + When binding to a list container (i.e. one that implements the + interface, such as ) + you must also set the property in order + to identify which particular list you would like to display. You + may also set the property even when + DataSource refers to a list, since can + also be used to navigate relations between lists. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. Actually, it can be any value that can + be compared for equality against a basic type. + If this is set to the wrong value (i.e. to a value that no row + has in the parent id column), the list will be empty. + + + + + Gets or sets the value that identifies a row as a root object. + . The RootKeyValue can be of any type, + but the IDE cannot sensibly represent a value of any type, + so this is a typed wrapper around that property. + + + If you want the root value to be something other than a string, + you will have set it yourself. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + An IDragSource controls how drag out from the ObjectListView will behave + + + + + A drag operation is beginning. Return the data object that will be used + for data transfer. Return null to prevent the drag from starting. The data + object will normally include all the selected objects. + + + The returned object is later passed to the GetAllowedEffect() and EndDrag() + methods. + + What ObjectListView is being dragged from. + Which mouse button is down? + What item was directly dragged by the user? There may be more than just this + item selected. + The data object that will be used for data transfer. This will often be a subclass + of DataObject, but does not need to be. + + + + What operations are possible for this drag? This controls the icon shown during the drag + + The data object returned by StartDrag() + A combination of DragDropEffects flags + + + + The drag operation is complete. Do whatever is necessary to complete the action. + + The data object returned by StartDrag() + The value returned from GetAllowedEffects() + + + + A do-nothing implementation of IDragSource that can be safely subclassed. + + + + + See IDragSource documentation + + + + + + + + + See IDragSource documentation + + + + + + + See IDragSource documentation + + + + + + + A reasonable implementation of IDragSource that provides normal + drag source functionality. It creates a data object that supports + inter-application dragging of text and HTML representation of + the dragged rows. It can optionally force a refresh of all dragged + rows when the drag is complete. + + Subclasses can override GetDataObject() to add new + data formats to the data transfer object. + + + + Construct a SimpleDragSource + + + + + Construct a SimpleDragSource that refreshes the dragged rows when + the drag is complete + + + + + + Gets or sets whether the dragged rows should be refreshed when the + drag operation is complete. + + + + + Create a DataObject when the user does a left mouse drag operation. + See IDragSource for further information. + + + + + + + + + Which operations are allowed in the operation? By default, all operations are supported. + + + All opertions are supported + + + + The drag operation is finished. Refreshe the dragged rows if so configured. + + + + + + + Create a data object that will be used to as the data object + for the drag operation. + + + Subclasses can override this method add new formats to the data object. + + The ObjectListView that is the source of the drag + A data object for the drag + + + + Objects that implement this interface can acts as the receiver for drop + operation for an ObjectListView. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Should the drag be allowed to continue? + + + + + + This is a do-nothing implementation of IDropSink that is a useful + base class for more sophisticated implementations. + + + + + Gets or sets the ObjectListView that is the drop sink + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + Implementators should set args.Effect to the appropriate DragDropEffects. This value is returned + to the originator of the drag. + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + The drag has left the bounds of this control + + + + + The drag is moving over this control. + + This is where any drop target should be calculated. + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + + Change the cursor to reflect the current drag operation. + + You only need to override this if you want non-standard cursors. + The standard cursors are supplied automatically. + + + + + Should the drag be allowed to continue? + + + You only need to override this if you want the user to be able + to end the drop in some non-standard way, e.g. dragging to a + certain point even without releasing the mouse, or going outside + the bounds of the application. + + + + + + This is called when the mouse leaves the drop region and after the + drop has completed. + + + + + The enum indicates which target has been found for a drop operation + + + + + No applicable target has been found + + + + + The list itself is the target of the drop + + + + + An item is the target + + + + + Between two items (or above the top item or below the bottom item) + can be the target. This is not actually ever a target, only a value indicate + that it is valid to drop between items + + + + + Above an item is the target + + + + + Below an item is the target + + + + + A subitem is the target of the drop + + + + + On the right of an item is the target (not currently used) + + + + + On the left of an item is the target (not currently used) + + + + + This class represents a simple implementation of a drop sink. + + + Actually, it should be called CleverDropSink -- it's far from simple and can do quite a lot in its own right. + + + + + Make a new drop sink + + + + + Get or set the locations where a drop is allowed to occur (OR-ed together) + + + + + Gets or sets whether this sink allows model objects to be dragged from other lists. Defaults to true. + + + + + Gets or sets whether the ObjectListView should scroll when the user drags + something near to the top or bottom rows. Defaults to true. + + AutoScroll does not scroll horizontally. + + + + Gets the billboard overlay that will be used to display feedback + messages during a drag operation. + + Set this to null to stop the feedback. + + + + Get or set whether a drop can occur between items of the list + + + + + Get or set whether a drop can occur on the listview itself + + + + + Get or set whether a drop can occur on items in the list + + + + + Get or set whether a drop can occur on a subitem in the list + + + + + Gets or sets whether the drop sink should draw feedback onto the given list + during the drag operation. Defaults to true. + + If this is false, you will have to give the user feedback in some + other fashion, like cursor changes + + + + Get or set the index of the item that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get or set the color that will be used to provide drop feedback + + + + + Get whether the alt key was down during this drop event + + + + + Get whether any modifier key was down during this drop event + + + + + Get whether the control key was down during this drop event + + + + + Get whether the left mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the right mouse button was down during this drop event + + + + + Get whether the shift key was down during this drop event + + + + + Get or set the state of the keys during this drop event + + + + + Gets or sets whether the drop sink will automatically use cursors + based on the drop effect. By default, this is true. If this is + set to false, you must set the Cursor yourself. + + + + + Triggered when the sink needs to know if a drop can occur. + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + + + + + Triggered when the sink needs to know if a drop can occur + AND the source is an ObjectListView + + + Handlers should set Effect to indicate what is possible. + Handlers can change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when the drop is made. + AND the source is an ObjectListView + + + + + Cleanup the drop sink when the mouse has left the control or + the drag has finished. + + + + + Draw any feedback that is appropriate to the current drop state. + + + Any drawing is done over the top of the ListView. This operation should disturb + the Graphic as little as possible. Specifically, do not erase the area into which + you draw. + + A Graphic for drawing + The contents bounds of the ListView (not including any header) + + + + The user has released the drop over this control + + + + + + A drag has entered this control. + + Implementators should set args.Effect to the appropriate DragDropEffects. + + + + + Change the cursor to reflect the current drag operation. + + + + + + The drag is moving over this control. + + + + + + Trigger the Dropped events + + + + + + Trigger CanDrop + + + + + + Trigger Dropped + + + + + + Trigger ModelCanDrop + + + + + + Trigger ModelDropped + + + + + + Handle the timer tick event, which is sent when the listview should + scroll + + + + + When the mouse is at the given point, what should the target of the drop be? + + This method should update the DropTarget* members of the given arg block + + The mouse point, in client co-ordinates + + + + What sort of action is possible when the mouse is at the given point? + + + + + + + + + + Based solely on the state of the modifier keys, what drop operation should + be used? + + The drop operation that matches the state of the keys + + + + Should the listview be made to scroll when the mouse is at the given point? + + + + + + Update the state of our sink to reflect the information that + may have been written into the drop event args. + + + + + + Draw the feedback that shows that the background is the target + + + + + + + Draw the feedback that shows that an item (or a subitem) is the target + + + + + DropTargetItem and DropTargetSubItemIndex tells what is the target + + + + + Draw the feedback that shows the drop will occur before target + + + + + + + Draw the feedback that shows the drop will occur after target + + + + + + + Return a GraphicPath that is round corner rectangle. + + + + + + + + Calculate the target rectangle when the given item (and possible subitem) + is the target of the drop. + + + + + + + + Draw a "between items" line at the given co-ordinates + + + + + + + + + + This drop sink allows items within the same list to be rearranged, + as well as allowing items to be dropped from other lists. + + + + This class can only be used on plain ObjectListViews and FastObjectListViews. + The other flavours have no way to implement the insert operation that is required. + + + This class does not work with grouping. + + + This class works when the OLV is sorted, but it is up to the programmer + to decide what rearranging such lists "means". Example: if the control is sorting + students by academic grade, and the user drags a "Fail" grade student up amonst the "A+" + students, it is the responsibility of the programmer to makes the appropriate changes + to the model and redraw/rebuild the control so that the users action makes sense. + + + Users of this class should listen for the CanDrop event to decide + if models from another OLV can be moved to OLV under this sink. + + + + + + Create a RearrangingDropSink + + + + + Create a RearrangingDropSink + + + + + + Trigger OnModelCanDrop + + + + + + Trigger OnModelDropped + + + + + + Do the work of processing the dropped items + + + + + + When a drop sink needs to know if something can be dropped, or + to notify that a drop has occured, it uses an instance of this class. + + + + + Create a OlvDropEventArgs + + + + + Get the original drag-drop event args + + + + + Get the data object that is being dragged + + + + + Get the drop sink that originated this event + + + + + Get or set the index of the item that is the target of the drop + + + + + Get or set the location of the target of the drop + + + + + Get or set the index of the subitem that is the target of the drop + + + + + Get the item that is the target of the drop + + + + + Get or set the drag effect that should be used for this operation + + + + + Get or set if this event was handled. No further processing will be done for a handled event. + + + + + Get or set the feedback message for this operation + + + If this is not null, it will be displayed as a feedback message + during the drag. + + + + + Get the ObjectListView that is being dropped on + + + + + Get the location of the mouse (in target ListView co-ords) + + + + + Get the drop action indicated solely by the state of the modifier keys + + + + + These events are triggered when the drag source is an ObjectListView. + + + + + Create a ModelDropEventArgs + + + + + Gets the model objects that are being dragged. + + + + + Gets the ObjectListView that is the source of the dragged objects. + + + + + Get the model object that is being dropped upon. + + This is only value for TargetLocation == Item + + + + Refresh all the objects involved in the operation + + + + + A data transfer object that knows how to transform a list of model + objects into a text and HTML representation. + + + + + Create a data object from the selected objects in the given ObjectListView + + The source of the data object + + + + Create a data object which operates on the given model objects + in the given ObjectListView + + The source of the data object + The model objects to be put into the data object + + + + Gets or sets whether hidden columns will also be included in the text + and HTML representation. If this is false, only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. + + + + + Gets the ObjectListView that is being used as the source of the data + + + + + Gets the model objects that are to be placed in the data object + + + + + Put a text and HTML representation of our model objects + into the data object. + + + + + Create an exporter for the data contained in this object + + + + + + Make a HTML representation of our model objects + + + + + Convert the fragment of HTML into the Clipboards HTML format. + + The HTML format is found here http://msdn2.microsoft.com/en-us/library/aa767917.aspx + + The HTML to put onto the clipboard. It must be valid HTML! + A string that can be put onto the clipboard and will be recognized as HTML + + + + A FastDataListView virtualizes the display of data from a DataSource. It operates on + DataSets and DataTables in the same way as a DataListView, but does so much more efficiently. + + + + A FastDataListView still has to load all its data from the DataSource. If you have SQL statement + that returns 1 million rows, all 1 million rows will still need to read from the database. + However, once the rows are loaded, the FastDataListView will only build rows as they are displayed. + + + + + + + + + + + + 获取或设置在设置DataSource时是否自动生成列以显示列。 + + 必须在设置DataSource之前设置此设置。之后就没有效果了。 + + + + 获取或设置将在此列表视图中显示的VirtualListDataSource。 + + VirtualListDataSource应实现 , , + 或 . 以下是一些常见的对象类型 + + + + + + + + 绑定到列表容器时 (即，实现 接口, 比如 ) + 您还必须实现 属性，以便标识要显示的特定列表。您也可以设置 属性， + 即使当VirtualListDataSource引用列表时也是如此, 因为 还可以用于导航列表之间的关系. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets or sets the DataSourceAdaptor that does the bulk of the work needed + for data binding. + + + + + Create the DataSourceAdapter that this control will use. + + A DataSourceAdapter configured for this list + Subclasses should override this to create their + own specialized adapters + + + + Change the Unfreeze behaviour + + + + + A FastObjectListView trades function for speed. + + + On my mid-range laptop, this view builds a list of 10,000 objects in 0.1 seconds, + as opposed to a normal ObjectListView which takes 10-15 seconds. Lists of up to 50,000 items should be + able to be handled with sub-second response times even on low end machines. + + A FastObjectListView is implemented as a virtual list with many of the virtual modes limits (e.g. no sorting) + fixed through coding. There are some functions that simply cannot be provided. Specifically, a FastObjectListView cannot: + + use Tile view + show groups on XP + + + + + + + Make a FastObjectListView + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + This method preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code and performance is O(n) where n is the number of selected rows. + This method is not thread safe. + + + + + Move the given collection of objects to the given index. + + This operation only makes sense on non-grouped ObjectListViews. + + + + + + 删除任何排序并恢复到模型对象的给定顺序 + + To be really honest, Unsort() doesn't work on FastObjectListViews since + the original ordering of model objects is lost when Sort() is called. So this method + effectively just turns off sorting. + + + + 为FastObjectListView提供数据源 + + + This class isn't intended to be used directly, but it is left as a public + class just in case someone wants to subclass it. + + + + + Create a FastObjectListDataSource + + + + + + Get n'th object + + + + + + + How many items are in the data source + + + + + + Get the index of the given model + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Remove the given collection of models from this source. + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + Apply the given filters to this data source. One or both may be null. + + + + + + + Gets the full list of objects being used for this fast list. + This list is unfiltered. + + + + + Gets the list of objects from ObjectList which survive any installed filters. + + + + + Rebuild the map that remembers which model object is displayed at which line + + + + + Build our filtered list from our full list. + + + + + Concrete implementation of the ICluster interface. + + + + + Create a cluster + + The key for the cluster + + + + Return a string representation of this cluster + + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Return an indication of the ordering between this object and the given one + + + + + + + This class provides a useful base implemention of a clustering + strategy where the clusters are grouped around the value of a given column. + + + + + This field is the text that will be shown to the user when a cluster + key is null. It is exposed so it can be localized. + + + + + This field is the text that will be shown to the user when a cluster + key is empty (i.e. a string of zero length). It is exposed so it can be localized. + + + + + Gets or sets the format that will be used by default for clusters that only + contain 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + + + + Gets or sets the format that will be used by default for clusters that + contain 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + + + + Create a clustering strategy + + + + + Gets or sets the column upon which this strategy is operating + + + + + Gets or sets the format that will be used when the cluster + contains only 1 item. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster (always 1 in this case) + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatSingular will be used + + + + Gets or sets the format that will be used when the cluster + contains 0 or two or more items. The format string must accept two placeholders: + - {0} is the cluster key converted to a string + - {1} is the number of items in the cluster + + If this is not set, the value from + ClusteringStrategy.DefaultDisplayLabelFormatPlural will be used + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Create a label that combines the string representation of the cluster + key with a format string that holds an "X [N items in cluster]" type layout. + + + + + + + + This class calculates clusters from the groups that the column uses. + + + + This is the default strategy for all non-date, filterable columns. + + + This class does not strictly mimic the groups created by the given column. + In particular, if the programmer changes the default grouping technique + by listening for grouping events, this class will not mimic that behaviour. + + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + This enum is used to indicate various portions of a datetime + + + + + Year + + + + + Month + + + + + Day of the month + + + + + Hour + + + + + Minute + + + + + Second + + + + + This class implements a strategy where the model objects are clustered + according to some portion of the datetime value in the configured column. + + To create a strategy that grouped people who were born in + the same month, you would create a strategy that extracted just + the month, and formatted it to show just the month's name. Like this: + + + someColumn.ClusteringStrategy = new DateTimeClusteringStrategy(DateTimePortion.Month, "MMMM"); + + + + + Create a strategy that clusters by month/year + + + + + Create a strategy that clusters around the given parts + + + + + + + Gets or sets the format string will will be used to create a user-presentable + version of the cluster key. + + The format should use the date/time format strings, as documented + in the Windows SDK. Both standard formats and custom format will work. + "D" - long date pattern + "MMMM, yyyy" - "January, 1999" + + + + Gets or sets the parts of the DateTime that will be extracted when + determining the clustering key for an object. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Convert the given date into a user presentable string + + + + + + + Instances of this class know how to build a Filter menu. + It is responsible for clustering the values in the target column, + build a menu that shows those clusters, and then constructing + a filter that will enact the users choices. + + + Almost all of the methods in this class are declared as "virtual protected" + so that subclasses can provide alternative behaviours. + + + + + Gets or sets the string that labels the Apply button. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Clear All menu item. + Exposed so it can be localized. + + + + + Gets or sets the string that labels the Filtering menu as a whole.. + Exposed so it can be localized. + + + + + Gets or sets the string that represents Select All values. + If this is set to null or empty, no Select All option will be included. + Exposed so it can be localized. + + + + + Gets or sets the image that will be placed next to the Clear Filtering menu item + + + + + Gets or sets the image that will be placed next to all "Apply" menu items on the filtering menu + + + + + Gets or sets whether null should be considered as a valid data value. + If this is true (the default), then a cluster will null as a key will be allow. + If this is false, object that return a cluster key of null will ignored. + + + + + Gets or sets the maximum number of objects that the clustering strategy + will consider. This should be large enough to collect all unique clusters, + but small enough to finish in a reasonable time. + + The default value is 10,000. This should be perfectly + acceptable for almost all lists. + + + + Create a Filter menu on the given tool tip for the given column in the given ObjectListView. + + This is the main entry point into this class. + + + + The strip that should be shown to the user + + + + Create a collection of clusters that should be presented to the user + + + + + + + + + Order the given list of clusters in the manner in which they should be presented to the user. + + + + + + + Do the work of making a menu that shows the clusters to the users + + + + + + + + Wrap a protected section around the real HandleItemChecked method, so that if + that method tries to change a "checkedness" of an item, we don't get a recursive + stack error. Effectively, this ensure that HandleItemChecked is only called + in response to a user action. + + + + + + + Handle a user-generated ItemCheck event + + + + + + + Handle any checking/unchecking of the Select All option, and keep + its checkedness in sync with everything else that is checked. + + + + + + + + Clear all the filters that are applied to the given column + + The column from which filters are to be removed + + + + Apply the selected values from the given list as a filter on the given column + + A list in which the checked items should be used as filters + The column for which a filter should be generated + + + + Interface for model-by-model filtering + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + Interface for whole list filtering + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Base class for model-by-model filters + + + + + Should the given model be included when this filter is installed + + The model object to consider + Returns true if the model will be included by the filter + + + + This filter calls a given Predicate to decide if a model object should be included + + + + + Create a filter based on the given predicate + + The function that will filter objects + + + + Gets or sets the predicate used to filter model objects + + + + + Should the given model object be included? + + + + + + + A CompositeFilter joins several other filters together. + If there are no filters, all model objects are included + + + + + Create an empty filter + + + + + Create a composite filter from the given list of filters + + A list of filters + + + + Gets or sets the filters used by this composite + + + + + Get the sub filters that are text match filters + + + + + Decide whether or not the given model should be included by the filter + + + True if the object is included by the filter + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must satisfy all filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + A CompositeAllFilter joins several other filters together. + A model object must only satisfy one of the filters to be included. + If there are no filters, all model objects are included + + + + + Create a filter from the given filters + + + + + + Decide whether or not the given model should be included by the filter + + Filters is guaranteed to be non-empty when this method is called + The model object under consideration + True if the object is included by the filter + + + + Instances of this class extract a value from the model object + and compare that value to a list of fixed values. The model + object is included if the extracted value is in the list + + If there is no delegate installed or there are + no values to match, no model objects will be matched + + + + Create a filter that will use the given delegate to extract values + + + + + + Create a filter that will extract values using the given delegate + and compare them to the values in the given list. + + + + + + + Gets or sets the delegate that will be used to extract values + from model objects + + + + + Gets or sets the list of values that the value extracted from + the model object must match in order to be included. + + + + + Should the given model object be included? + + + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Instances of this class match a property of a model objects against + a list of bit flags. The property should be an xor-ed collection + of bits flags. + + Both the property compared and the list of possible values + must be convertible to ulongs. + + + + Create an instance + + + + + + + Gets or sets the collection of values that will be matched. + These must be ulongs (or convertible to ulongs). + + + + + Decides if the given property is a match for the values in the PossibleValues collection + + + + + + + Base class for whole list filters + + + + + Return a subset of the given list of model objects as the new + contents of the ObjectListView + + The collection of model objects that the list will possibly display + The filtered collection that holds the model objects that will be displayed. + + + + Instance of this class implement delegate based whole list filtering + + + + + A delegate that filters on a whole list + + + + + + + Create a ListFilter + + + + + + Gets or sets the delegate that will filter the list + + + + + Do the actual work of filtering + + + + + + + Filter the list so only the last N entries are displayed + + + + + Create a no-op tail filter + + + + + Create a filter that includes on the last N model objects + + + + + + Gets or sets the number of model objects that will be + returned from the tail of the list + + + + + Return the last N subset of the model objects + + + + + + + Instances of this class cluster model objects on the basis of a + property that holds an xor-ed collection of bit flags. + + + + + Create a clustering strategy that operates on the flags of the given enum + + + + + + Create a clustering strategy around the given collections of flags and their display labels. + There must be the same number of elements in both collections. + + The list of flags. + + + + + Gets the value that will be xor-ed to test for the presence of a particular value. + + + + + Gets the labels that will be used when the corresponding Value is XOR present in the data. + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + A cluster is a like collection of objects that can be usefully filtered + as whole using the filtering UI provided by the ObjectListView. + + + + + Gets or sets how many items belong to this cluster + + + + + Gets or sets the label that will be shown to the user to represent + this cluster + + + + + Gets or sets the actual data object that all members of this cluster + have commonly returned. + + + + + Implementation of this interface control the selecting of cluster keys + and how those clusters will be presented to the user + + + + + Gets or sets the column upon which this strategy will operate + + + + + Get the cluster key by which the given model will be partitioned by this strategy + + If the returned value is an IEnumerable, the given model is considered + to belong to multiple clusters + + + + + + Create a cluster to hold the given cluster key + + + + + + + Gets the display label that the given cluster should use + + + + + + + Create a filter that will include only model objects that + match one or more of the given values. + + + + + + + Instances of this class include only those rows of the listview + that match one or more given strings. + + This class can match strings by prefix, regex, or simple containment. + There are factory methods for each of these matching strategies. + + + + Create a text filter that will include rows where any cell matches + any of the given regex expressions. + + + + + Any string that is not a valid regex expression will be ignored. + + + + Create a text filter that includes rows where any cell begins with one of the given strings + + + + + + + + Create a text filter that includes rows where any cell contains any of the given strings. + + + + + + + + Create a TextFilter + + + + + + Create a TextFilter that finds the given string + + + + + + + Create a TextFilter that finds the given string using the given comparison + + + + + + + + Gets or sets which columns will be used for the comparisons? If this is null, all columns will be used + + + + + Gets or sets additional columns which will be used in the comparison. These will be used + in addition to either the Columns property or to all columns taken from the control. + + + + + Gets or sets the collection of strings that will be used for + contains matching. Setting this replaces all previous texts + of any kind. + + + + + Gets whether or not this filter has any search criteria + + + + + Gets or set the ObjectListView upon which this filter will work + + + You cannot really rebase a filter after it is created, so do not change this value. + It is included so that it can be set in an object initializer. + + + + + Gets or sets the collection of strings that will be used for + prefix matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + This is only used when doing Regex matching (obviously). + If this is not set specifically, the appropriate options are chosen to match the + StringComparison setting (culture invariant, case sensitive). + + + + + Gets or sets the collection of strings that will be used for + regex pattern matching. Setting this replaces all previous texts + of any kind. + + + + + Gets or sets how the filter will match text + + + + + Loop over the columns that are being considering by the filter + + + + + + Do the actual work of filtering + + + + + + + Find all the ways in which this filter matches the given string. + + This is used by the renderer to decide which bits of + the string should be highlighted + + A list of character ranges indicating the matched substrings + + + + Is the given column one of the columns being used by this filter? + + + + + + + Base class for the various types of string matching that TextMatchFilter provides + + + + + Gets how the filter will match text + + + + + Gets the text filter to which this component belongs + + + + + Gets or sets the text that will be matched + + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + This component provides text contains matching strategy. + + + + + Create a text contains strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides text begins with matching strategy. + + + + + Create a text begins strategy + + + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This component provides regex matching strategy. + + + + + Creates a regex strategy + + + + + + + Gets or sets the options that will be used when compiling the regular expression. + + + + + Gets or sets a compilex regular expression, based on our current Text and RegexOptions. + + + If Text fails to compile as a regular expression, this will return a Regex object + that will match all strings. + + + + + Gets whether or not our current regular expression is a valid regex + + + + + Does the given text match the filter + + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + Return true if the given cellText matches our strategy + + + + Find all the ways in which this filter matches the given string. + + + + This is used by the renderer to decide which bits of + the string should be highlighted. + + this.Text will not be null or empty when this is called. + + The text of the cell we want to search + A list of character ranges indicating the matched substrings + + + + This attribute is used to mark a property of a model + class that should be noticed by Generator class. + + + All the attributes of this class match their equivilent properties on OLVColumn. + + + + + Create a new OLVColumnAttribute + + + + + Create a new OLVColumnAttribute with the given title + + The title of the column + + + + + + + + + + + + + + + + + + + + + + + + + + + + + An array of IComparables that mark the cutoff points for values when + grouping on this column. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Properties marked with [OLVChildren] will be used as the children source in a TreeListView. + + + + + Properties marked with [OLVIgnore] will not have columns generated for them. + + + + + ColumnComparer is the workhorse for all comparison between two values of a particular column. + If the column has a specific comparer, use that to compare the values. Otherwise, do + a case insensitive string compare of the string representations of the values. + + This class inherits from both IComparer and its generic counterpart + so that it can be used on untyped and typed collections. + This is used by normal (non-virtual) ObjectListViews. Virtual lists use + ModelObjectComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column + + The column whose values will be compared + The ordering for column values + + + + Create a ColumnComparer that will order the rows in a list view according + to the values in a given column, and by a secondary column if the primary + column is equal. + + The column whose values will be compared + The ordering for column values + The column whose values will be compared for secondary sorting + The ordering for secondary column values + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare two rows + + row1 + row2 + An ordering indication: -1, 0, 1 + + + + Compare the actual values to be used for sorting + + The aspect extracted from the first row + The aspect extracted from the second row + An ordering indication: -1, 0, 1 + + + + This comparer sort list view groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + + + + Create a group comparer + + The ordering for column values + + + + Compare the two groups. OLVGroups have a "SortValue" property, + which is used if present. Otherwise, the titles of the groups will be compared. + + group1 + group2 + An ordering indication: -1, 0, 1 + + + + This comparer can be used to sort a collection of model objects by a given column + + + This is used by virtual ObjectListViews. Non-virtual lists use + ColumnComparer + + + + + Gets or sets the method that will be used to compare two strings. + The default is to compare on the current culture, case-insensitive + + + + + Create a model object comparer + + + + + + + Create a model object comparer with a secondary sorting column + + + + + + + + + Compare the two model objects + + + + + + + + Compare the actual values + + + + + + + + A helper class that translates DataSource events for an ObjectListView + + + + + Make a DataSourceAdapter + + + + + Finalize this object + + + + + Release all the resources used by this instance + + + + + Release all the resources used by this instance + + + + + Gets or sets whether or not columns will be automatically generated to show the + columns when the DataSource is set. + + This must be set before the DataSource is set. It has no effect afterwards. + + + + Get or set the DataSource that will be displayed in this list view. + + + + + Gets or sets the name of the list or table in the data source for which the DataListView is displaying data. + + If the data source is not a DataSet or DataViewManager, this property has no effect + + + + Gets the ObjectListView upon which this adaptor will operate + + + + + Gets or sets the currency manager which is handling our binding context + + + + + + + + + + + + + + + + + + + + + + + + + + + Our data source has changed. Figure out how to handle the new source + + + + + Our data source has changed. Figure out how to handle the new source + + + + + The data source for this control has changed. Reconfigure the control for the new source + + + + + Take the contents of the currently bound list and put them into the control + + + + + Create columns for the listview based on what properties are available in the data source + + + This method will create columns if there is not already a column displaying that property. + + + + + Decide if a new column should be added to the control to display + the given property + + + + + + + Configure the given column to show the given property. + The title and aspect name of the column are already filled in. + + + + + + + Generate aspect getters and putters for any columns that are missing them (and for which we have + enough information to actually generate a getter) + + + + + CurrencyManager ListChanged event handler. + Deals with fine-grained changes to list items. + + + It's actually difficult to deal with these changes in a fine-grained manner. + If our listview is grouped, then any change may make a new group appear or + an old group disappear. It is rarely enough to simply update the affected row. + + + + + + + Handle PropertyDescriptor* events + + + + + + Handle ItemMoved event + + + + + + Handle the ItemDeleted event + + + + + + Handle an ItemAdded event. + + + + + + Handle the Reset event + + + + + + Handle ItemChanged event. This is triggered when a single item + has changed, so just refresh that one item. + + + Even in this simple case, we should probably rebuild the list. + For example, the change could put the item into its own new group. + + + + The CurrencyManager calls this if the data source looks + different. We just reload everything. + + + + + CHECK: Do we need this if we are handle ListChanged metadata events? + + + + + Called by the CurrencyManager when the currently selected item + changes. We update the ListView selection so that we stay in sync + with any other controls bound to the same source. + + + + + + + Change the control's position (which is it's currently selected row) + to the nth row in the dataset + + The index of the row to be selected + + + + Handle the selection changing in our ListView. + We need to tell our currency manager about the new position. + + + + + + + Handle the frozenness of our ListView changing. + + + + + + + Handle a change to the BindingContext of our ListView. + + + + + + + These delegates are used to extract an aspect from a row object + + + + + These delegates are used to put a changed value back into a model object + + + + + These delegates can be used to convert an aspect value to a display string, + instead of using the default ToString() + + + + + These delegates are used to get the tooltip for a cell + + + + + These delegates are used to the state of the checkbox for a row object. + + + For reasons known only to someone in Microsoft, we can only set + a boolean on the ListViewItem to indicate it's "checked-ness", but when + we receive update events, we have to use a tristate CheckState. So we can + be told about an indeterminate state, but we can't set it ourselves. + + As of version 2.0, we can now return indeterminate state. + + + + + These delegates are used to get the state of the checkbox for a row object. + + + + + + + These delegates are used to put a changed check state back into a model object + + + + + These delegates are used to put a changed check state back into a model object + + + + + + + + These delegates are used to get the renderer for a particular cell + + + + + The callbacks for RightColumnClick events + + + + + This delegate will be used to own draw header column. + + + + + This delegate is called when a group has been created but not yet made + into a real ListViewGroup. The user can take this opportunity to fill + in lots of other details about the group. + + + + + These delegates are used to retrieve the object that is the key of the group to which the given row belongs. + + + + + These delegates are used to convert a group key into a title for the group + + + + + These delegates are used to get the tooltip for a column header + + + + + These delegates are used to fetch the image selector that should be used + to choose an image for this column. + + + + + These delegates are used to draw a cell + + + + + These delegates are used to fetch a row object for virtual lists + + + + + These delegates are used to format a listviewitem before it is added to the control. + + + + + These delegates can be used to return the array of texts that should be searched for text filtering + + + + + These delegates are used to sort the listview in some custom fashion + + + + + These delegates are used to order two strings. + x cannot be null. y can be null. + + + + + An ObjectListView is a much easier to use, and much more powerful, version of the ListView. + + + + An ObjectListView automatically populates a ListView control with information taken + from a given collection of objects. It can do this because each column is configured + to know which bit of the model object (the "aspect") it should be displaying. Columns similarly + understand how to sort the list based on their aspect, and how to construct groups + using their aspect. + + + Aspects are extracted by giving the name of a method to be called or a + property to be fetched. These names can be simple names or they can be dotted + to chain property access e.g. "Owner.Address.Postcode". + Aspects can also be extracted by installing a delegate. + + + An ObjectListView can show a "this list is empty" message when there is nothing to show in the list, + so that the user knows the control is supposed to be empty. + + + Right clicking on a column header should present a menu which can contain: + commands (sort, group, ungroup); filtering; and column selection. Whether these + parts of the menu appear is controlled by ShowCommandMenuOnRightClick, + ShowFilterMenuOnRightClick and SelectColumnsOnRightClick respectively. + + + The groups created by an ObjectListView can be configured to include other formatting + information, including a group icon, subtitle and task button. Using some undocumented + interfaces, these groups can even on virtual lists. + + + ObjectListView supports dragging rows to other places, including other application. + Special support is provide for drops from other ObjectListViews in the same application. + In many cases, an ObjectListView becomes a full drag source by setting to + true. Similarly, to accept drops, it is usually enough to set to true, + and then handle the and events (or the and + events, if you only want to handle drops from other ObjectListViews in your application). + + + For these classes to build correctly, the project must have references to these assemblies: + + + System + System.Data + System.Design + System.Drawing + System.Windows.Forms (obviously) + + + + + + How does a user indicate that they want to edit cells? + + + + + 列表将不支持编辑(同时F2按键无效) + + + + + 单击 单元格 将编辑值. + 选择该行，就像正常选择行一样。用户必须按F2键才能编辑主列。 + + + + + 双击子项或主列将编辑该单元格。 + F2键将编辑主列。 + + + + + 按F2键是编辑单元格的唯一方法。一旦主列被编辑， + 行中的其他单元格可以通过按Tab键进行编辑。 + + + + + 只需单击任意单元格即可编辑值，即使是主列也是如此。 + + + + + 这些值指定向用户显示列选择的方式 + + + + + 不会显示任何列选择 + + + + + 这些列将显示在主菜单中 + + + + + 这些列将显示在子菜单中 + + + + + 将显示一个模式对话框，允许用户选择列 + + + + + Triggered after a ObjectListView has been searched by the user typing into the list + + + + + Triggered after a ObjectListView has been sorted + + + + + Triggered before a ObjectListView is searched by the user typing into the list + + + Set Cancelled to true to prevent the searching from taking place. + Changing StringToFind or StartSearchFrom will change the subsequent search. + + + + + Triggered before a ObjectListView is sorted + + + Set Cancelled to true to prevent the sort from taking place. + Changing ColumnToSort or SortOrder will change the subsequent sort. + + + + + Triggered after a ObjectListView has created groups + + + + + Triggered before a ObjectListView begins to create groups + + + Set Groups to prevent the default group creation process + + + + + Triggered just before a ObjectListView creates groups + + + You can make changes to the groups, which have been created, before those + groups are created within the listview. + + + + + Triggered when a button in a cell is left clicked. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + Triggered when a cell has finished being edited. + + + + + Triggered when a cell is about to finish being edited. + + If Cancel is already true, the user is cancelling the edit operation. + Set Cancel to true to prevent the value from the cell being written into the model. + You cannot prevent the editing from finishing within this event -- you need + the CellEditValidating event for that. + + + + Triggered when a cell is about to be edited. + + Set Cancel to true to prevent the cell being edited. + You can change the the Control to be something completely different. + + + + Triggered when a cell editor needs to be validated + + + If this event is cancelled, focus will remain on the cell editor. + + + + + Triggered when a cell is left clicked. + + + + + Triggered when the mouse is above a cell. + + + + + Triggered when a cell is right clicked. + + + + + This event is triggered when a cell needs a tool tip. + + + + + This event is triggered when a checkbox is checked/unchecked on a subitem + + + + + Triggered when a column header is right clicked. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler. + + + + + This event is triggered when the control needs to filter its collection of objects. + + + + + This event is triggered when a cell needs to be formatted. + + + + + This event is triggered when the frozeness of the control changes. + + + + + This event is triggered when a row needs to be formatted. + + + + + This event is triggered when a group is about to collapse or expand. + This can be cancelled to prevent the expansion. + + + + + This event is triggered when a group changes state. + + + + + This event is triggered when a header checkbox is changing value + + + + + This event is triggered when a header needs a tool tip. + + + + + Triggered when the "hot" item changes + + + + + Triggered when a hyperlink cell is clicked. + + + + + Triggered when the task text of a group is clicked. + + + + + Is the value in the given cell a hyperlink. + + + + + Some new objects are about to be added to an ObjectListView. + + + + + The contents of the ObjectListView has changed. + + + + + The contents of the ObjectListView is about to change via a SetObjects call + + + Set Cancelled to true to prevent the contents of the list changing. This does not work with virtual lists. + + + + + Some objects are about to be removed from an ObjectListView. + + + + + This event is triggered when the user moves a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler, and when the source control + for the drag was an ObjectListView. + + + Handlers for this event should set the Effect argument and optionally the + InfoMsg property. They can also change any of the DropTarget* setttings to change + the target of the drop. + + + + + This event is triggered when the user releases a drag over an ObjectListView that + has a SimpleDropSink installed as the drop handler and when the source control + for the drag was an ObjectListView. + + + + + This event is triggered once per user action that changes the selection state + of one or more rows. + + + + + This event is triggered when the contents of the ObjectListView has scrolled. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Tell the world when a cell is about to be edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell is about to finish being edited. + + + + + Tell the world when a cell has finished being edited. + + + + + 创建一个 ObjectListView + + + + + Dispose of any resources this instance has been using + + + + + + 获取鼠标左键是否在此时按下。 + + + + + 获取该程序是否在Vista或更高版本上运行 + + + + + 获取该程序是否在Win7或更高版本上运行 + + + + + Gets or sets how what smoothing mode will be applied to graphic operations. + + + + + Gets or sets how should text be renderered. + + + + + 获取或设置当组Key为Null时将用于标题组的字符串。将其公开以使其可以本地化。 + + + + + Convert the given enumerable into an ArrayList as efficiently as possible + + The source collection + If true, this method will always create a new + collection. + An ArrayList with the same contents as the given collection. + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Return the count of items in the given enumerable + + + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + Return whether or not the given enumerable is empty. A string is regarded as + an empty collection. + + + True if the given collection is null or empty + + When we move to .NET 3.5, we can use LINQ and not need this method. + + + + + Gets or sets whether all ObjectListViews will silently ignore missing aspect errors. + + + + By default, if an ObjectListView is asked to display an aspect + (i.e. a field/property/method) + that does not exist from a model, it displays an error message in that cell, since that + condition is normally a programming error. There are some use cases where + this is not an error -- in those cases, set this to true and ObjectListView will + simply display an empty cell. + + Be warned: if you set this to true, it can be very difficult to track down + typing mistakes or name changes in AspectNames. + + + + + Gets or sets whether the control will draw a rectangle in each cell showing the cell padding. + + + + This can help with debugging display problems from cell padding. + + As with all cell padding, this setting only takes effect when the control is owner drawn. + + + + + Gets the style that will be used by default to format disabled rows + + + + + Gets the style that will be used by default to format hot rows + + + + + Gets or sets an model filter that is combined with any column filtering that the end-user specifies. + + This is different from the ModelFilter property, since setting that will replace + any column filtering, whereas setting this will combine this filter with the column filtering + + + + Get or set all the columns that this control knows about. + Only those columns where IsVisible is true will be seen by the user. + + + + If you want to add new columns programmatically, add them to + AllColumns and then call RebuildColumns(). Normally, you do not have to + deal with this property directly. Just use the IDE. + + If you do add or remove columns from the AllColumns collection, + you have to call RebuildColumns() to make those changes take effect. + + + + + 获取或设置每隔一行的背景色 + + + + + 获取已设置的交替行背景色或默认颜色 + + + + + 此属性强制ObjectListView始终按给定列对项进行分组。 + + + + + 如果AlwaysGroupByColumn不为空，则此属性将用于确定如何对这些组进行排序。 + 如果此属性的值为SortOrder.None，则排序顺序将根据用户上次单击的标题切换。 + + + + + Give access to the image list that is actually being used by the control + + + Normally, it is preferable to use SmallImageList. Only use this property + if you know exactly what you are doing. + + + + + 获取或设置编辑单元格的方式 + + Columns can also be marked as editable. + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + 默认值为 true. + + + This is always treated as true when the control is NOT owner drawn. + + When this is false and the control is owner drawn, + ObjectListView will try to calculate the width of the cell's + actual contents, and then size the editing control to be just the right width. If this is true, + the whole width of the cell will be used, regardless of the cell's contents. + + Each column can have a different value for property. This value from the control is only + used when a column is not specified one way or another. + Regardless of this setting, developers can specify the exact size of the editing control + by listening for the CellEditStarting event. + + + + + Gets or sets the engine that will handle key presses during a cell edit operation. + Settings this to null will reset it to default value. + + + + + 获取当前用于编辑单元格的控件。 + + This will obviously be null if no cell is being edited. + + + + 获取或设置编辑控件左边缘或右边缘的单元格时Tab键的行为。 + 如果为False(默认值)，则按Tab键将换行到同一行的另一侧。 + 如果为True，编辑最右边的单元格时按Tab键将前进到下一行， + 编辑最左边的单元格时按Shift-Tab组合键将更改为上一行。 + + + + + 获取或设置编辑单元格时Enter键的行为。 + 如果为False(默认值)，则按Enter键将简单地完成编辑操作。 + 如果为True，则Enter将完成编辑操作，并在当前单元格下方的单元格上启动新的编辑操作，在位于底部单元格时换行到下一行的顶部。 + + + + + 获取显示单元格提示的工具提示控件 + + + + + 获取或设置该项的每个单元格周围将留空的像素数。单元格内容在考虑填充后对齐。 + + + Each value of the given rectangle will be treated as an inset from + the corresponding side. The width of the rectangle is the padding for the + right cell edge. The height of the rectangle is the padding for the bottom + cell edge. + + + So, this.olv1.CellPadding = new Rectangle(1, 2, 3, 4); will leave one pixel + of space to the left of the cell, 2 pixels at the top, 3 pixels of space + on the right edge, and 4 pixels of space at the bottom of each cell. + + + This setting only takes effect when the control is owner drawn. + + This setting only affects the contents of the cell. The background is + not affected. + If you set this to a foolish value, your control will appear to be empty. + + + + + 获取或设置默认情况下单元格垂直对齐的方式。 + + This setting only takes effect when the control is owner drawn. It will only be noticable + when RowHeight has been set such that there is some vertical space in each row. + + + + Should this list show checkboxes? + + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + .NET's CheckedItems property is not helpful. It is just a short-hand for + iterating through the list looking for items that are checked. + + + The performance of the get method is O(n), where n is the number of items + in the control. The performance of the set method is + O(n + m) where m is the number of objects being checked. Be careful on long lists. + + + + + + 获取或设置可枚举对象中的选中对象。 + + + Useful for checking all objects in the list. + + + this.olv1.CheckedObjectsEnumerable = this.olv1.Objects; + + + + + Gets Columns for this list. We hide the original so we can associate + a specialised editor with it. + + + + + 获取/设置当列表切换到TileView(平铺视图)时应使用的列的列表。 + + + + + 按向用户显示的顺序返回可见列 + + + + + 获取显示列表的控件区域，减去任何标题控件 + + + + + 获取或设置当用户按Ctrl+C组合键时是否应将选定行复制到剪贴板 + + + + + 获取或设置按Ctrl+C键复制到剪贴板功能是否应使用安装的DragSource创建放置到剪贴板上的数据对象。 + + This is normally what is desired, unless a custom DragSource is installed + that does some very specialized drag-drop behaviour. + + + + Gets the list of decorations that will be drawn the ListView + + + + Do not modify the contents of this list directly. Use the AddDecoration() and RemoveDecoration() methods. + + + A decoration scrolls with the list contents. An overlay is fixed in place. + + + + + + 所有者绘制时，此渲染器将绘制未指定特定渲染器的列 + + 如果尝试将其设置为NULL，则它将恢复为HighlightTextRenende + + + + 获取用于绘制给定单元格的渲染器。 + + The row model for the row + The column to be drawn + The renderer used for drawing a cell. Must not return null. + + + + 获取或设置将应用于禁用项的样式。 + + If this is not set explicitly, will be used. + + + + 获取或设置已禁用的模型对象的列表。无法选择或激活已禁用的对象。 + + + + + 判断此给定模型对象是否已禁用 + + + + + + + 禁用给定的模型对象。禁用的对象无法选择或激活。 + + Must not be null + + + + 禁用所有给定的模型对象 + + + + + + 启用给定的模型对象，以便可以再次选择并激活它。 + + Must not be null + + + + 启用所有给定的模型对象 + + + + + + 忽略所有禁用的对象。这不会触发重绘或重建 + + + + + Gets or sets the object that controls how drags start from this control + + + + + Gets or sets the object that controls how drops are accepted and processed + by this ListView. + + + + If the given sink is an instance of SimpleDropSink, then events from the drop sink + will be automatically forwarded to the ObjectListView (which means that handlers + for those event can be configured within the IDE). + + If this is set to null, the control will not accept drops. + + + + + This registry decides what control should be used to edit what cells, based + on the type of the value in the cell. + + + All instances of ObjectListView share the same editor registry. + + + + 获取或设置在此列表视图中没有项时应显示的文本。 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 获取或设置绘制列表空消息时应使用的字体 + + If the EmptyListMsgOverlay has been changed to something other than a TextOverlay, + this property does nothing + + + + 返回“列表为空”消息的字体或合理的默认值 + + + + + Gets or sets the overlay responsible for drawing the List Empty msg. + + + + + 获取在筛选中幸存下来的对象的集合。 + + + + This collection is the result of filtering the current list of objects. + It is not a snapshot of the filtered list that was last used to build the control. + + + Normal warnings apply when using this with virtual lists. It will work, but it + may take a while. + + + + + + 获取或设置将用于生成筛选器菜单的策略对象 + + 如果为NULL，则不会生成筛选器菜单。 + + + + 获取或设置具有键盘焦点的行 + + + + Setting an object to be focused does *not* select it. If you want to select and focus a row, + use . + + + This property is not generally used and is only useful in specialized situations. + + + + + + 隐藏Groups集合，使其在“属性”网格中不可见。 + + + + + 获取或设置分组使用的ImageList + + 如果未设置此选项，则分组标题将不会显示任何图像。 + + + + 获取在组为空或包含多个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 + + + "[{0} [{1} 项]" + + + + 返回this.GroupWithItemCountFormat或合理的默认值 + + + + + 获取在组仅包含单个项目时应如何设置组标签的格式 + + + 给定的格式字符串必须有两个占位符： + + {0} - 原来的组标题 + {1} - 组中的项目数 (总是1) + + + "[{0} [{1} 项]" + + + + 获取GroupWithItemCountSingularFormat或合理的默认值 + + + + + 获取或设置此ObjectListView中的组是否应可折叠。 + + + 此特性只支持Vista或之后的系统. + + + + + 获取当前列表是否存在当列表为空时显示的文本 + + + + + 获取是否有要绘制的叠加层 + + + + + 获取ListView的列头控件 + + + + + 获取或设置列标题文本的绘制字体 + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + 获取或设置将用于绘制列表视图的列标题的样式 + + + + 仅当HeaderUsesThemes为false时才使用此选项。 + + + 单个列可以通过其HeaderFormatStyle属性重写此设置。 + + + + + + 获取或设置标题的最大高度。-1表示没有最大值。 + + + + + 获取或设置标题的最小高度。-1表示没有最小值。 + + + + + 获取或设置是否严格按照操作系统的主题绘制标题。 + + + + 如果设置为true，则列头将完全由系统呈现，不需要ObjectListViews的任何特殊处理。 + 页眉中将没有图像、没有过滤器指示符、没有文字换行、没有页眉样式、没有复选框。 + + 如果将其设置为False，ObjectListView将以其认为最好的方式呈现标题。 + 如果不需要特殊功能，则ObjectListView会将渲染委托给操作系统。 + 否则，ObjectListView将根据配置设置绘制标题。 + + + 没有主题的效果会因操作系统不同而不同。至少，分类指示器不会是标准的。 + + + + + + 获取或设置列头标题中的文本是否自动换行。 + + + 将在单词之间应用换行符。过长的单词仍将被省略。 + + 与所有使列头看起来不同的设置一样，HeaderUsesThemes必须设置为false，否则操作系统将负责绘制列头，并且不允许自动换行文本。 + + + + + + 获取显示列标题提示的工具提示 + + + + + 获取鼠标当前所在行的索引。 + + + + + 获取鼠标当前所在列的索引 + + + + + 获取鼠标当前所在的项/子项的一部分 + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + 获取鼠标所在的组。 + + + + + 处于“热”状态的项的索引，即在光标下方。-1表示没有项目。 + + + + + 获取和设置对游标下的行应用哪种格式 + + + + 这仅在UseHotItem为true时生效。 + + 如果样式具有叠加层，则必须对其进行设置。*之前* 将其分配给此属性。之后添加它将被忽略。 + + + + + 获取已安装的热点项样式或合理的默认值。 + + + + + 获取和设置应将哪种格式应用于超链接 + + + + + 获取和设置所选行的背景应该使用什么颜色 + + + + + 返回应用于选定行的背景颜色或合理的默认值 + + + + + 获取和设置所选行的字体应该使用什么颜色 + + + + + 返回应用于选定行的字体颜色或合理的默认值 + + + + + 使用 SelectedBackColor 代替 + + + + + 使用 SelectedBackColorOrDefault 代替 + + + + + 使用 SelectedForeColor 代替 + + + + + 使用 SelectedForeColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedBackColor 代替 + + + + + 使用 UnfocusedSelectedBackColorOrDefault 代替 + + + + + 使用 UnfocusedSelectedForeColor 代替 + + + + + 使用 UnfocusedSelectedForeColorOrDefault 代替 + + + + + 获取或设置是否应将隐藏列包括在复制或拖动到其他应用程序的行的文本表示形式中。 + 如果为False(默认值)，则仅包括可见列。 + + + + + 获取或设置复制行时，列标题是否在文本中。 + 如果为False(默认值)，在文本中将不会显示列标题。 + + + + + 如果当前正在进行单元格编辑操作，则返回TRUE + + + + + 如果在开发环境中使用ObjectListView，则返回true。 + + + + + 获取当前列表是否正在筛选其内容 + + + + + 当用户在列表中键入内容时，是否应该搜索当前排序列中的值以查找匹配项？ + 如果为False，则无论排序列是什么，都将始终使用主列。 + + When this is true, the behavior is like that of ITunes. + + + + 获取或设置此控件是否将使用SimpleDropSink接收拖动 + + + + 此设置将替换任何以前的DropSink。 + + + 将其设置为true后，SimpleDropSink仍需要配置为说明它何时可以接受拖动， + 以及在拖动某些内容时应该执行什么操作。需要执行这些操作使此属性几乎毫无用处 :( + + + + + + 获取或设置此控件是否将使用SimpleDragSource来启动拖动 + + 此设置将替换之前的任何DragSource + + + + 隐藏Items集合，使其在“属性”网格中不可见。 + + + + + 当列表中的项目处于非详细视图中时，此渲染器会绘制项目。在详细信息视图中，负责个体列的呈现器。 + + + + + 获取或设置最后一次排序的列 + + 这是PrimarySortColumn的别名 + + + + 获取或设置最后一次排序的方向 + + 这是 PrimarySortOrder的别名 + + + + 获取或设置应用于整个对象列表的筛选器。 + + + 列表将立即更新以反映此筛选器。 + + + + + 获取或设置应用于列表中每个模型对象的筛选器 + + + 您可能需要考虑使用 而不是此属性， + 因为AdditionalFilter在运行时与列筛选相结合。 + 设置此属性只是替换用户可能已给出的任何列筛选器。 + + The list is updated immediately to reflect this filter. + + + + + + Gets the hit test info last time the mouse was moved. + + Useful for hot item processing. + + + + 获取或设置列表显示的组列表。 + + + 此属性与.NET Groups属性的工作方式不同，应将其视为只读属性。 + 对列表所做的更改不会反映在ListView本身中。 + 在此列表中添加或删除组是没有意义的，这样的修改不会起到任何作用。 + 要执行此类操作，必须侦听BeforeCreatingGroups或AboutToCreateGroups事件， + 并更改这些事件中的组列表。 + + + + + 获取或设置折叠的OLVGroups的集合。 + + + + + Gets or sets whether the user wants to owner draw the header control + themselves. If this is false (the default), ObjectListView will use + custom drawing to render the header, if needed. + + + If you listen for the DrawColumnHeader event, you need to set this to true, + otherwise your event handler will not be called. + + + + + 获取/设置此列表将显示的对象集合 + + + + 设置此属性后，控件的内容将立即更新。 + + 如果可能，此方法将保留所选内容。使用 if + 如果您不想保留所选内容，请执行以下操作。 + 保留选择是该代码中最慢的部分，性能为O(N)，其中n是选定的行数。 + 此方法不是线程安全的。 + 该属性确实适用于虚拟列表：设置是没有问题的，但如果您尝试获取它， + 并且列表有1000万个对象，则可能需要一些时间才能返回。 + 此集合未经过筛选。使用 只访问那些在任何已安装的筛选器中幸存下来的对象。 + + + + + 获取当前控件所有对象组成的列表 + + + + + 获取创建群集时将考虑的对象集合。 + (用于生成类似Excel的列筛选器) + + + + + 获取或设置将在ListView顶部绘制的图像 + + + + + 获取或设置将在ListView顶部绘制的文本 + + + + + 获取或设置所有覆盖图的透明度。0表示完全透明，255表示完全不透明。 + + + 这已经过时了，请在每个覆盖上使用Transparency。 + + + + + 获取将在ListView顶部绘制的覆盖列表 + + + You can add new overlays and remove overlays that you have added, but + don't mess with the overlays that you didn't create. + + + + + Gets or sets whether the ObjectListView will be owner drawn. Defaults to true. + + + + When this is true, all of ObjectListView's neat features are available. + + We have to reimplement this property, even though we just call the base + property, in order to change the [DefaultValue] to true. + + + + + + 获取或设置主复选框是否在列表重新生成和筛选操作中保持其值。 + + + + 此属性仅在未显式设置CheckStateGetter/Putter时才有用。 + 如果您使用CheckStateGetter/Putter，那么这些方法已经持久化了行的检查性。 + + 此默认值为true。如果为False，则在重新生成或筛选列表时，复选框将丢失其值。 + 如果在虚拟列表中将其设置为false，则必须安装CheckStateGetter/Putters。 + + + + + 获取或设置记住模型对象的复选框状态的字典 + + 当PersistentCheckBoxs值为TRUE时，此选项用于虚拟列表. + + + + 获取或设置最后一次排序的列 + + + + + 获取或设置最后一次排序的方向 + + + + + 获取或设置不可编辑复选框是否绘制为禁用。默认是false。 + + + 这仅在所有者描述模式(owner drawn mode)下有效。 + + + + + 以像素为单位指定控件中每行的高度。 + + 列表视图中的行高通常由字体大小和小图像列表大小决定。 + 此设置允许覆盖该计算(原因是：您仍然不能将行高设置为小于控件中使用的字体的行高)。 + 将其设置为-1表示使用正常计算方法。 + 此功能是体验功能！如果您使用此功能，您的程序可能会发生意想不到的事情。 + + + + + 获取每行有多少像素高 + + + + + 获取此控件的每页上显示多少行 + + + + + 获取/设置将用于解析排序时相等的比较的列(第二排序列)。 + + 此设置没有用户界面。它必须以编程方式设置。 + + + + 获取或设置当使用Second darySortColumn时，它将以什么顺序比较结果 + + + + + 获取或设置当用户按Ctrl+A组合键时是否应选择所有行 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许用户选择视图中将显示哪些列 + + 这只是SelectColumnsOnRightClickBehaviour的兼容性包装属性. + + + + 获取或设置当右键单击标题时用户如何能够选择列 + + + + + 当列选择菜单打开时，是否应在选择项目后保持打开状态？保持打开状态允许用户一次打开或关闭多个列。 + + SelectColumnsOnRightClickBehaviour设置为InlineMenu时才有效。当行为设置为SubMenu菜单时，该选项不起作用。 + + + + 获取或设置选定列 + + + + 如果TintSortColumn为true，则排序列将自动成为选定列。 + + + 色调的颜色由SelectedColumnTint控制。 + + + + + + Gets or sets the decoration that will be drawn on all selected rows + + + + + 获取或设置应该使用什么颜色来给选定的列着色 + + + 色调颜色必须是Alpha可混合的，因此如果给定的颜色是纯色(即Alpha=255)，则会将其更改为具有合理的Alpha值。 + + + + + 获取或设置当前选定行的索引。 + 获取索引时，如果没有选择任何行，或者选择了多个行，则返回-1。 + + + + + 获取或设置当前选定的ListViewItem。如果未选择任何行，或者选择了多个行，则返回NULL。 + + + + + 如果只选择了一行，则从当前选定的行获取模型对象。 + 如果未选择任何行，或选择了多个行，则返回NULL。 + 设置时，这将选择显示给定模型对象的行，并将焦点放在该行上，取消选择所有其他行。 + + + + + 从当前选定的行中获取模型对象。 + 如果未选中任何行，则返回的列表为空。 + 设置此值时，请选择显示给定模型对象的行，取消选择所有其他行。 + + + + + 获取或设置当用户右键单击列标题时，是否应该显示一个菜单，允许他们选择要在列表视图上执行的常见任务 + + + + + 获取或设置当右键单击标题控件时，此ObjectListView是否像筛选菜单一样显示表格 + + + + + 获取或设置是否应按组显示其项目 + + + + + 列表视图是否应该在列标题中显示位图以显示排序方向 + + + The only reason for not wanting to have sort indicators is that, on pre-XP versions of + Windows, having sort indicators required the ListView to have a small image list, and + as soon as you give a ListView a SmallImageList, the text of column 0 is bumped 16 + pixels to the right, even if you never used an image. + + + + + 列表视图是否应该显示子项上的图像 + + + 虚拟列表必须是所有者绘制的，才能在子项上显示图像 + + + + + 此属性控制分组标签是否显示该分组项目数量 + + + 后缀的格式由GroupWithItemCountFormat/GroupWithItemCountSingularFormat属性控制 + + + + + 获取或设置控件是在所有视图中显示列标题(True)，还是仅在详细信息视图中显示列标题(False) + + + + 此属性工作不正常。JPP 2010/04/06。 + 如果它是在创建控件之前设置的，则可以正常工作。 + 但是，如果在创建控件后将其关闭，则控件将丢失其复选框(奇怪！) + + + 要在创建控件后更改此设置，事情会很复杂。 + 如果它是关闭的，而我们想要打开它，我们必须更改视图，标题就会出现。 + 如果它当前处于打开状态，而我们想要将其关闭，则必须更改视图并重新创建控制柄。 + 重新创建句柄是一个问题，因为它会使我们的复选框样式消失。 + + + 该属性不能工作在 Win XP 系统. + + + + + 重写SmallImageList属性，以便我们可以正确地隐藏其操作。 + + 如果使用RowHeight属性指定行高，则必须在设置/更改RowHeight之前完全初始化SmallImageList。 + 如果在设置行高之后将新图像添加到图像列表，则必须再次将图像列表分配给控件。像这样简单的事情会奏效的： + listView1.SmallImageList = listView1.SmallImageList; + + + + + 返回小图像列表中图像的大小或合理的默认值 + + + + + 当列表视图分组时，项是否应该按主列排序？如果为False，则项目将按分组时的同一列进行排序。 + + + + + 当列表视图分组时，一个组的末尾和下一个组的开头之间应该有多少像素 + + + + + 排序列是否应该显示轻微的色调？ + + + + + 获取或设置是否使用三态复选框？ + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + 否则，用户在选中和取消选中之间交替单击。 + 当此设置为False时，CheckStateGetter仍可以返回不确定。 + + + + + 获取或设置列表顶部项目的索引 + + + + 此属性仅在列表视图处于详细信息视图中且不显示组时才起作用。 + + + 显示组时不起作用的原因是，当启用组时，无论滚动位置如何， + Windows msg LVM_GETTOPINDEX总是返回0。 + + + + + + 获取或设置将鼠标移到标题上是否会触发CellOver事件。 + 默认为true。 + + + 将鼠标移动到标题上之前不会触发CellOver事件，因为Header被视为单独的控件。 + 如果此行为更改导致您的应用程序出现问题，请将其设置为False。 + 如果您想知道鼠标何时在标题上移动，请将此属性设置为true(默认值)。 + + + + + 通过拖动分隔线调整列的大小时，是否应在每次鼠标移动时调整填充空格的列的大小？ + 如果为False，则释放鼠标时将更新填充栏。 + + + + 如果空间填充列位于正在调整大小的列的左侧，这看起来会很奇怪：该列的右边缘将被拖动，但由于空间填充列正在收缩，其左边缘将会移动。 + + 这是合乎逻辑的行为--只是看起来不对。 + + + 考虑到上述行为，如果空间填充列不是最右边的列，最好关闭该属性。 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的背景 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的背景的颜色 + + + + + 当控件没有焦点时，应该使用什么颜色作为选定行的字体颜色。 + + + + + 当控件没有焦点或合理的默认值时，返回应用于选定行的字体颜色 + + + + + 获取或设置列表是否每隔一行提供不同的背景色？默认值为false。 + + 交替行的颜色由AlternateRowBackColor提供。 + 在.NET中，列表视图在非整行选择模式下有一个“功能”，在这种模式下，所选行不会使用正确的背景色绘制。 + + + + 是否应该为控件中的每个单元格调用FormatCell事件？ + + + 在许多情况下，不执行单元格级格式设置。 + 如果除非需要，ObjectListView不会为每个单元格触发Format Cell事件，则它的运行速度会稍快一些。 + 因此，默认情况下，它不会为每个单元格引发事件。 + + ObjectListView*确实*在每次重新生成行时引发FormatRow事件。各行可以决定是否对行中的每个单元格引发FormatCell事件。 + + + 无论此设置如何，只有当ObjectListView处于详细视图中时才会引发FormatCell事件。 + + + + + 所选行是否应使用非标准前景色和背景色绘制？ + + V2.9不再需要此属性 + + + + 获取或设置此ObjectListView是否将使用与Vista资源管理器相同的热项和选择机制。 + + + + 此属性有许多缺陷： + + 这仅适用于Vista及更高版本 + 它不能很好地与AlternateRowBackColors配合使用。 + 它不能很好地与HotItemStyles配合使用。 + 如果FullRowSelect为false，这看起来有点傻。 + 当列表是所有者绘制的时，它根本不起作用(因为所有的绘制都是由渲染器完成的)。 + 因此，它不能与TreeListView一起工作，因为它们“必须”是所有者绘制的。你仍然可以设置它，但它不会生效。 + + 但如果你一定要看起来像Vista/Win7，这是你的权限。如果这项设置搞砸了其他事情，请不要抱怨。 + + + 当此属性设置为True时，ObjectListView将不是所有者描述的。 + 这将禁用ObjectListView的许多漂亮的基于绘图的功能。 + + + + + + 获取或设置列表是否应启用筛选 + + + + + 获取或设置列表是否应将指示符放入列的标题中，以表明它正在筛选该列 + + 如果将其设置为true，HeaderUsesThemes将自动设置为false，因为我们只能在不使用主题标题时绘制筛选器指示器。 + + + + 鼠标下方的控件(复选框或按钮)是否应该被绘制为“Hot” + + + 如果为False，则当鼠标悬停在控件上时，控件的绘制方式不会有所不同。 + + 如果为False，且UseHotItem和UseHyperLinks为False，则ObjectListView可以跳过鼠标移动的某些处理。这使得鼠标移动处理几乎不使用CPU。 + + + + + + 光标下的项是否应以特殊方式设置格式？ + + + + + 获取或设置此列表视图是否应在单元格中显示超链接。 + + + + + 此控件是否应显示覆盖(Overlays) + + 覆盖(Overlays)在默认情况下是启用的，只有在它们在您的开发环境中造成问题时才需要禁用。 + + + + 是否应将此控件配置为在子项上显示复选框？ + + 如果将其设置为True，则将为该控件提供一个SmallImageList(如果它还没有一个SmallImageList)。 + 此外，如果它是一个虚拟列表，它将被设置为所有者描述的，因为虚拟列表不能在没有所有者描述的情况下绘制复选框。 + + + + 获取或设置ObjectListView是否将使用类似Vista的半透明选择机制。 + + + + 与UseExplorerTheme不同的是，这个类似Vista的方案可以在XP上运行，并且既适用于所有者描述的列表，也适用于非所有者描述的列表。 + + + 这将替换任何已安装的SelectedRowDecory。 + + + 如果您不喜欢用于选择的颜色，请忽略此属性， + 只需创建您自己的RowBorderDecory并将其分配给SelectedRowDecory， + 就像此属性设置器所做的那样。 + + + + + + 获取或设置ObjectListView是否将使用类似于Vista的半透明热行突出显示机制。 + + + + 设置此项将替换任何已安装的HotItemStyle。 + + + 如果您不喜欢热项目使用的颜色，请忽略此属性， + 只需创建您自己的HotItemStyle，填充所需的值， + 并将其分配给HotItemStyle属性，就像此属性设置器所做的那样。 + + + + + + 获取/设置此列表视图正在使用的视图样式 + + 切换到平铺(Tile)或详细信息(Details)视图会安装适合该视图的列。令人困惑的是，在平铺视图中，每列都显示为一行信息。 + + + + 此委托仅将对象的检查性作为布尔值获取。 + + 如果您永远不想担心不确定状态(这是相当常见的)，请使用此选项。 + + 这是CheckStateGetter属性的便捷包装。 + + + + + + This delegate sets the checkedness of an object as a boolean only. It must return + true or false indicating if the object was checked or not. + + Use this if you never want to worry about the + Indeterminate state (which is fairly common). + + This is a convenience wrapper around the CheckStatePutter property. + + + + + + 获取此列表视图是否能够显示组 + + + + + 获取或设置ObjectListView是否可以依赖正在引发的Application.Idle事件。 + + 在某些主机环境中(例如，在VisualStudio和Office中作为扩展运行时)，从不引发Application.Idle事件。 + 如果不会引发Idle事件，则将其设置为False，ObjectListView将自行引发这些事件。 + + + + + This delegate fetches the renderer for a particular cell. + + + + If this returns null (or is not installed), the renderer for the column will be used. + If the column renderer is null, then will be used. + + + This is called every time any cell is drawn. It must be efficient! + + + + + + This delegate is called when the list wants to show a tooltip for a particular cell. + The delegate should return the text to display, or null to use the default behavior + (which is to show the full text of truncated cell values). + + + Displaying the full text of truncated cell values only work for FullRowSelect listviews. + This is MS's behavior, not mine. Don't complain to me :) + + + + + 保存是否选中模型的属性(或字段)的名称。 + + + 该属性是可修改的。它必须具有bool(或bool？)返回类型。如果TriStateCheckBooks为真)。 + 设置此属性将替换任何已安装的CheckStateGetter或CheckStatePutter。 + 相反，稍后设置CheckStateGetter或CheckStatePutter属性将优先于此属性的行为。 + + + + + 只要ObjectListView需要知道与给定模型对象关联的行的检查状态，就会调用此委托。 + + + .NET has no support for indeterminate values, but as of v2.0, this class allows + indeterminate values. + + + + + This delegate will be called whenever the user tries to change the check state of a row. + The delegate should return the state that was actually set, which may be different + to the state given. + + + + + 此委托可用于以自定义方式对表进行排序。 + + + + 委托必须在ObjectListView上安装ListViewItemSorter。 + 安装ItemSorter会执行对ListViewItems进行排序的实际工作。 + 有关ItemSorter必须执行的操作的示例，请参见代码中的ColumnCompeller。 + + + 请勿在VirtualObjectListView上安装CustomSorter。改为重写IVirtualListDataSource的SortObjects()方法。 + + + + + + This delegate is called when the list wants to show a tooltip for a particular header. + The delegate should return the text to display, or null to use the default behavior + (which is to not show any tooltip). + + + Installing a HeaderToolTipGetter takes precedence over any text in OLVColumn.ToolTipText. + + + + + This delegate can be used to format a OLVListItem before it is added to the control. + + + The model object for the row can be found through the RowObject property of the OLVListItem object. + All subitems normally have the same style as list item, so setting the forecolor on one + subitem changes the forecolor of all subitems. + To allow subitems to have different attributes, do this: + myListViewItem.UseItemStyleForSubItems = false;. + + If UseAlternatingBackColors is true, the backcolor of the listitem will be calculated + by the control and cannot be controlled by the RowFormatter delegate. + In general, trying to use a RowFormatter + when UseAlternatingBackColors is true does not work well. + As it says in the summary, this is called before the item is added to the control. + Many properties of the OLVListItem itself are not available at that point, including: + Index, Selected, Focused, Bounds, Checked, DisplayIndex. + + + + + 将给定的模型对象添加到此控件。 + + 要显示的模型对象 + See AddObjects() for more details + + + + 将给定的模型对象集合添加到此控件。 + + 要显示的模型对象集合 + + 如果排序处于活动状态(即，如果PrimarySortColumn不为空)，则添加的对象将出现在其正确的排序位置。否则，它们将出现在列表的末尾。 + 不执行任何检查以查看是否有任何对象已在ListView中。 + 空对象将被静默忽略。 + + + + + 将列的大小调整到页眉宽度和数据的最大值。 + + + + + 设置任何自动初始化的列宽(宽度为0或-1的列将分别调整为其内容或标题的宽度)。 + + + 显然，这只会起作用一次。一旦运行，列宽将更改为其他值(不是0或-1)，因此第二次运行时不会执行任何操作。 + 若要强制所有列更改其大小，请使用 。 + + + + + 根据最后一个排序列或第一列(如果没有最后一个排序列)将视图项组织到组中 + + + + + 根据给定列将视图项组织成组 + + + + 如果AlwaysGroupByColumn属性不为Null，则列表视图项将按该列组织，并且将忽略‘Column’参数。 + + 此方法触发排序事件：BeforeSorting和AfterSorting。 + + 其值应用于排序的列。 + + + + + 根据给定列将视图项组织成组 + + 将使用哪一列进行分组 + 组将使用什么顺序 + 其值应用于排序的列。不能为空 + 列中值的排序顺序 + 当‘column’中的值相等时，请使用此列提供的值 + 次级值将如何排序 + 此方法不会触发排序事件。使用BuildGroups()执行此操作 + + + + 收集并返回影响组创建的所有变量 + + + + + + Make a list of groups that should be shown according to the given parameters + + + The list of groups to be created + This should not change the state of the control. It is possible that the + groups created will not be used. They may simply be discarded. + + + + 生成/重新生成列表中的所有列表视图项，尽可能多地保留状态 + + + + + 生成/重新生成列表中的所有列表视图项 + + If this is true, the control will try to preserve the selection, + focused item, and the scroll position (see Remarks) + + + + Use this method in situations were the contents of the list is basically the same + as previously. + + + + + + 清除此列表可能一直在使用的所有缓存信息 + + + + + Apply all required extended styles to our control. + + + + Whenever .NET code sets an extended style, it erases all other extended styles + that it doesn't use. So, we have to explicit reapply the styles that we have + added. + + + Normally, we would override CreateParms property and update + the ExStyle member, but ListView seems to ignore all ExStyles that + it doesn't already know about. Worse, when we set the LVS_EX_HEADERINALLVIEWS + value, bad things happen (the control crashes!). + + + + + + Give the listview a reasonable size of its tiles, based on the number of lines of + information that each tile is going to display. + + + + + Rebuild this list for the given view + + + + + + 移除所有对象(线程安全) + + This method can safely be called from background threads. + + + + 重置已访问其URL的内存 + + + + + 将选定行的文本和HTML表示复制到剪贴板上。 + + Be careful when using this with virtual lists. If the user has selected + 10,000,000 rows, this method will faithfully try to copy all of them to the clipboard. + From the user's point of view, your program will appear to have hung. + + + + 将给定对象的文本和HTML表示复制到剪贴板上。 + + + + + 将所有对象的文本和HTML表示复制到剪贴板上。 + + + + + 返回给定对象的html表示形式 + + + + + 取消选择列表视图中的所有行 + + + + + 返回紧跟在给定项后面的ListViewItem。 + 如果给定项为空，则返回列表中的第一个项。 + 如果给定项是最后一项，则返回NULL。 + + The item that is before the item that is returned, or null + A ListViewItem + + + + 按向用户显示的顺序返回最后一项。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + 按向用户显示的顺序返回第n项(从0开始)。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回给定listviewitem索引的显示索引。 + 如果控件未分组，则显示顺序与排序的列表顺序相同。 + 但如果列表是分组的，则显示顺序不同。 + + + + + + + 返回紧接在给定项之前出现的ListViewItem。 + 如果给定项为空，则返回列表中的最后一项。 + 如果给定项是第一项，则返回NULL。 + + The item that is before the item that is returned + A ListViewItem + + + + 在给定位置之前插入给定的对象集合 + + Where to insert the objects + The objects to be inserted + + + This operation only makes sense of non-sorted, non-grouped + lists, since any subsequent sort/group operation will rearrange + the list. + + This method only works on ObjectListViews and FastObjectListViews. + + + + + 如果选择了表示给定模型的行，则返回TRUE + + The model object to look for + Is the row selected + + + + 给定的URL是否已被访问 + + The string to be consider + Has it been visited + + + + 按给定的值增量滚动ListView。 + + Horizontal delta + Vertical delta + + + + Return a point that represents the current horizontal and vertical scroll positions + + + + + 记住给定的URL已被访问 + + The url to be remembered + This does not cause the control be redrawn + + + + 将给定的对象集合移动到给定的索引。 + + 此操作仅对未分组的ObjectListViews有意义。 + + + + + + 计算在给定点下的项目是什么？ + + + + + + + + 使用Windows控件的SUBITEMHITTEST消息执行点击测试。 + 这提供了标准ListView.HitTest()不提供的有关组点击的信息。 + + + + + + + + What is under the given point? This takes the various parts of a cell into accout, including + any custom parts that a custom renderer might use + + + + An information block about what is under the point + + + + Perform a hit test when the control is not owner drawn + + + + + + + + Perform a hit test when the control is owner drawn. This hands off responsibility + to the renderer. + + + + + + + + Pause (or unpause) all animations in the list + + true to pause, false to unpause + + + + Rebuild the columns based upon its current view and column visibility settings + + + + + 从ListView中删除给定的模型对象 + + The model to be removed + See RemoveObjects() for more details + This method is thread-safe. + + + + + 从控件中移除所有给定对象。 + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + This method is thread-safe. + + + + + 选择列表视图中的所有行 + + + + + 在列表视图的右下角设置要固定的给定图像。 + 当列表视图滚动时，此图像不会滚动。 + + + + 此方法使用ListView的原生功能显示背景图像。 + 它有几个限制： + + + 它在owner drawn模式下不能很好地工作。在owner drawn绘制模式下， + 每个单元格都会绘制自身，包括覆盖背景图像的背景。 + 启用网格线时看起来不是很好，因为网格线是在图像上绘制的。 + 它在XP上完全不起作用。 + 显然，当启用交替行背景色时，效果不佳。 + + + 如果你能忍受这些限制，原生水印就相当不错了。 + 它们是真实的背景，而不是像OverlayImage使用的半透明覆盖。 + 与覆盖相比，它们也有明显的优势，因为即使在MDI应用程序中，它们也可以正常工作。 + + 设置此选项将清除所有背景图像。 + + The image to be drawn. If null, any existing image will be removed. + + + + 将给定的图像设置为ListView的背景，以便它在列表中以给定的百分比偏移量显示。 + + + 这具有与 中所述的相同限制. + 在使用该方法之前，请确保了解这些限制。 + 这非常类似于 属性， + 但标准Backround Image不能正确处理具有透明区域的图像--它将透明区域呈现为黑色。这种方法没有这个问题。 + 设置此选项将清除所有背景水印。 + + The image to be drawn. If null, any existing image will be removed. + The horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + The vertical percentage where the image will be placed. + + + + 将给定图像设置为ListView的平铺背景。 + + + 这具有与 和 相同的限制. + 在使用该方法之前，请确保了解这些限制。 + + 要绘制的图像。如果为null，则将删除所有现有图像。 + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法。 + 该列表将立即更新 + The objects to be displayed + + + + 设置将在此列表视图中显示的对象集合。 + + 可以从后台线程安全地调用此方法. + 该列表将立即更新 + The objects to be displayed + 是否应尽可能保留列表的状态。 + + + + 将给定的模型对象更新到ListView中。 + 如果该模型尚不存在，则会添加该模型。 + + The model to be updated + + + See for more details + + 此方法是线程安全的。 + 此方法将导致重新排序列表。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更新与给定对象相等的预先存在的模型。 + 如果控件中不存在任何模型，则会添加它们。 + + Collection of objects to be updated/added + + 此方法将导致重新排序列表。 + null值将被静默忽略。 + 此方法是线程安全的。 + 此方法仅适用于ObjectListViews和FastObjectListViews。 + + + + + 更改当前模型对象上对INotifyPropertyChanged事件的任何订阅， + 以便我们不再侦听旧模型上的事件，而侦听给定集合上的事件。 + + This does nothing if UseNotifyPropertyChanged is false. + + + + + 获取或设置ObjectListView是否应订阅它给定的模型对象上的INotifyPropertyChanged事件。 + + + + 这应该在调用SetObjects()之前设置。如果将其设置为False，ObjectListView将取消订阅所有当前模型对象。 + + 如果在虚拟列表上将其设置为true，ObjectListView将遍历列表中尝试订阅更改通知的所有对象。 + 如果您的虚拟列表中有10,000,000个项目，这可能需要一些时间。 + + + + + Subscribe to INotifyPropertyChanges on the given collection of objects. + + + + + + Unsubscribe from INotifyPropertyChanges on the given collection of objects. + If the given collection is null, unsubscribe from all current subscriptions + + + + + + Return a byte array that represents the current state of the ObjectListView, such + that the state can be restored by RestoreState() + + + The state of an ObjectListView includes the attributes that the user can modify: + + current view (i.e. Details, Tile, Large Icon...) + sort column and direction + column order + column widths + column visibility + + + + It does not include selection or the scroll position. + + + A byte array representing the state of the ObjectListView + + + + Restore the state of the control from the given string, which must have been + produced by SaveState() + + A byte array returned from SaveState() + Returns true if the state was restored + + + + Instances of this class are used to store the state of an ObjectListView. + + + + + The application is idle. Trigger a SelectionChanged event. + + + + + + + The application is idle. Handle the column resizing event. + + + + + + + Handle the BeginScroll listview notification + + + True if the event was completely handled + + + + Handle the EndScroll listview notification + + + True if the event was completely handled + + + + Handle the LinkClick listview notification + + + True if the event was completely handled + + + + The cell tooltip control wants information about the tool tip that it should show. + + + + + + + Allow the HeaderControl to call back into HandleHeaderToolTipShowing without making that method public + + + + + + + The header tooltip control wants information about the tool tip that it should show. + + + + + + + Event handler for the column click event + + + + + Override the basic message pump for this control + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user wants to see the context menu. + + The windows m + A bool indicating if this m has been handled + + We want to ignore context menu requests that are triggered by right clicks on the header + + + + + Handle the Custom draw series of notifications + + The message + True if the message has been handled + + + + Handle the underlying control being destroyed + + + + + + + Handle the search for item m if possible. + + The m to be processed + bool to indicate if the msg has been handled + + + + Find the first row after the given start in which the text value in the + comparison column begins with the given text. The comparison column is column 0, + unless IsSearchOnSortColumn is true, in which case the current sort column is used. + + The text to be prefix matched + The index of the first row to consider + Which direction should be searched? + The index of the first row that matched, or -1 + The text comparison is a case-insensitive, prefix match. The search will + search the every row until a match is found, wrapping at the end if needed. + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + 是否只匹配开头 + The index of the matched row, or -1 + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + Handle the Group Info series of notifications + + The message + True if the message has been handled + + + + Handle a key down message + + + True if the msg has been handled + + + + Toggle the checkedness of the selected rows + + + + Actually, this doesn't actually toggle all rows. It toggles the first row, and + all other rows get the check state of that first row. This is actually a much + more useful behaviour. + + + If no rows are selected, this method does nothing. + + + + + + Catch the Left Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button up event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Trigger a GroupExpandCollapse event and return true if the action was cancelled + + + + + + + Catch the Right Button down event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a left mouse down at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the Left Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the right Button double click event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle a right mouse double click at the given hit test location + + Subclasses can override this to do something unique + + True if the message has been handled + + + + Catch the MouseMove event. + + The m to be processed + bool to indicate if the msg has been handled + + + + Handle notifications that have been reflected back from the parent window + + The m to be processed + bool to indicate if the msg has been handled + + + + In the notification messages, we handle attempts to change the width of our columns + + The m to be processed + bool to indicate if the msg has been handled + + + + Create a ToolTipControl to manage the tooltip control used by the listview control + + + + + Update the handle used by our cell tooltip to be the tooltip used by + the underlying Windows listview control. + + + + + Handle the WM_PAINT event + + + Return true if the msg has been handled and nothing further should be done + + + + Perform any steps needed before painting the control + + + + + Perform any steps needed after painting the control + + + + + Handle the window position changing. + + The m to be processed + bool to indicate if the msg has been handled + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a menu that is appropriate when the given column header is clicked. + + The index of the header that was clicked. This + can be -1, indicating that the header was clicked outside of a column + Where should the menu be shown + True if a menu was displayed + + + + Create the menu that should be displayed when the user right clicks + on the given column header. + + Index of the column that was right clicked. + This can be negative, which indicates a click outside of any header. + The toolstrip that should be displayed + + + + The user has right clicked on the column headers. Do whatever is required + + Return true if this event has been handle + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + Where should the menu be placed + + + + Show a popup menu at the given point which will allow the user to choose which columns + are visible on this listview + + + Where should the menu be placed + + + + 获取或设置要用于升序排序命令的文本 + + + + + 获取或设置要用于降序排序命令的文本 + + + + + 获取或设置要用于分组命令的文本 + + + + + 获取或设置要用于锁定分组命令的文本 + + + + + 获取或设置要用于不锁定分组命令的文本 + + + + + 获取或设置要用于关闭分组命令的文本 + + + + + 获取或设置要用于不排序命令的文本 + + + + + 获取或设置要用于列描述的文本 + + + + + 获取或设置要用于选择列描述的文本 + + + + + Gets or sets the image that will be place next to the Sort Ascending command + + + + + Gets or sets the image that will be placed next to the Sort Descending command + + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + + Return the menu to which the items were added + + + + Append the column selection menu items to the given menu strip. + + The menu to which the items will be added. + Return the menu to which the items were added + + + + Create the menu items that will allow columns to be choosen and add them to the + given collection + + + + + + Create a Filtering menu + + + + + + + + Override the OnColumnReordered method to do what we want + + + + + + When the column widths are changing, resize the space filling columns + + + + + + + When the column widths change, resize the space filling columns + + + + + + + When the size of the control changes, we have to resize our space filling columns. + + + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Resize our space filling columns so they fill any unoccupied width in the control + + + + + Check all rows + + + + + Check the checkbox in the given column header + + If the given columns header check box is linked to the cell check boxes, + then checkboxes in all cells will also be checked. + + + + + Mark the checkbox in the given column header as having an indeterminate value + + + + + + Mark the given object as indeterminate check state + + The model object to be marked indeterminate + + + + Mark the given object as checked in the list + + The model object to be checked + + + + Mark the given objects as checked in the list + + The model object to be checked + + + + Put a check into the check box at the given cell + + + + + + + Put an indeterminate check into the check box at the given cell + + + + + + + Return true of the given object is checked + + The model object whose checkedness is returned + Is the given object checked? + If the given object is not in the list, this method returns false. + + + + Return true of the given object is indeterminately checked + + The model object whose checkedness is returned + Is the given object indeterminately checked? + If the given object is not in the list, this method returns false. + + + + Is there a check at the check box at the given cell + + + + + + + Get the checkedness of an object from the model. Returning null means the + model does not know and the value from the control will be used. + + + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the checkedness of the given object. A checked object becomes + unchecked; an unchecked or indeterminate object becomes checked. + If the list has tristate checkboxes, the order is: + unchecked -> checked -> indeterminate -> unchecked ... + + The model object to be checked + + + + Toggle the checkbox in the header of the given column + + Obviously, this is only useful if the column actually has a header checkbox. + + + + + Toggle the check at the check box of the given cell + + + + + + + Uncheck all rows + + + + + Mark the given object as unchecked in the list + + The model object to be unchecked + + + + Mark the given objects as unchecked in the list + + The model object to be checked + + + + Uncheck the checkbox in the given column header + + + + + + Uncheck the check at the given cell + + + + + + + 返回给定索引处的列 + + Index of the column to be returned + An OLVColumn + + + + 返回给定标题处的列,如果有多个符合要求的标题,则默认只返回第一个 + + 要返回的列的名称 + An OLVColumn + + + + 返回给定视图可见的列的集合。只有Tile和Details有列；所有其他视图都有0列。 + + 正在为哪个视图计算列？ + A list of columns + + + + 返回列表中的项目数 + + 列表中的项目数 + 如果安装了筛选器，这将返回与筛选器匹配的项目数。 + + + + 返回给定索引处的项 + + Index of the item to be returned + An OLVListItem + + + + 返回给定索引处的模型对象 + + Index of the model object to be returned + A model object + + + + 找出在给定的坐标下的行和列 + X 坐标 + Y 坐标 + 给定点下的列项 + 在给定坐标点下的行项。可以为null。 + + + + 返回给定索引/列的子项 + + Index of the item to be returned + Index of the subitem to be returned + An OLVListSubItem + + + + 滚动列表视图，使给定组位于顶部。 + + The group to be revealed + + 如果该组可见，如果可能，列表仍将滚动以将该组移至顶部。 + + 这只在列表显示分组时才有效(显然)。 + 这在虚拟列表上不起作用，因为虚拟列表不使用ListViewGroups进行分组。使用 代替. + + + + + 使给定的模型对象可见 + + The model object to be revealed + + + + 返回选定行的模型对象，如果没有选择或有多个选择，则返回null + + Model object or null + + + + 返回选定行的模型对象，如果没有选择，则返回空集合 + + ArrayList + + + + 返回选中行的模型对象；如果未选中行或选中多行，则返回NULL + + Model object or null + 使用 CheckedObject 属性代替本方法 + + + + 获取选中的模型对象的集合。 + + 使用 CheckedObjects 属性代替本方法 + + + + 在列表视图中查找给定的模型对象并返回其索引 + + The model object to be found + The index of the object. -1 means the object was not present + + + + Rebuild the given ListViewItem with the data from its associated model. + + This method does not resort or regroup the view. It simply updates + the displayed data of the given item + + + + Rebuild the data on the row that is showing the given object. + + + + This method does not resort or regroup the view. + + + The given object is *not* used as the source of data for the rebuild. + It is only used to locate the matching model in the collection, + then that matching model is used as the data source. This distinction is + only important in model classes that have overridden the Equals() method. + + + If you want the given model object to replace the pre-existing model, + use . + + + + + + Update the rows that are showing the given objects + + + This method does not resort or regroup the view. + This method can safely be called from background threads. + + + + + 更新选定的行 + + This method does not resort or regroup the view. + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + Use the property to deselect all other rows + + + + 除任何当前选择外，还选择显示给定模型对象的行。 + + The object to be selected + 对象是否也应该被聚焦 + Use the property to deselect all other rows + + + + 选择显示任意给定模型对象的行。取消选择所有其他行。 + + A collection of model objects + + + + 获取或设置是否冻结列表视图。当列表视图被冻结时，它不会自我更新。 + + Frozen属性与Freeze()/UnFreeze()方法类似， + 不同之处在于将Frozen属性设置为False会立即解冻控件， + 而不管有多少未完成的Freeze()调用。 + objectListView1.Frozen = false; // unfreeze the control now! + + + + + 冻结列表视图，使其不再自我更新。 + + Freeze()/Unfreeze() calls nest correctly + + + + 解冻列表视图。如果此调用是最外层的unFreeze()，则将重新构建listview的内容。 + + Freeze()/Unfreeze() calls nest correctly + + + + 在冻结列表视图时执行所需的实际工作 + + + + + 解冻列表视图时执行所需的实际工作 + + + + + 如果选择事件当前挂起，则返回TRUE。在挂起选择事件时，不会引发SelectedIndexChanged或SelectionChanged事件。 + + + + + Suspend selection events until a matching ResumeSelectionEvents() + is called. + + Calls to this method nest correctly. Every call to SuspendSelectionEvents() + must have a matching ResumeSelectionEvents(). + + + + Resume raising selection events. + + + + + Returns a disposable that will disable selection events + during a using() block. + + + + + + Implementation only class that suspends and resumes selection + events on instance creation and disposal. + + + + + 按最后一个排序列和顺序对项目进行排序 + + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的名称 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列的索引 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + 其值将用于排序的列 + + + + 按给定列中的值和上次排序顺序对列表视图中的项进行排序 + + The column whose values will be used for the sorting. + If null, the first column will be used. + The ordering to be used for sorting. If this is None, + this.Sorting and then SortOrder.Ascending will be used + If ShowGroups is true, the rows will be grouped by the given column. + If AlwaysGroupsByColumn is not null, the rows will be grouped by that column, + and the rows within each group will be sorted by the given column. + + + + Put a sort indicator next to the text of the sort column + + + + + Put a sort indicator next to the text of the given given column + + The column to be marked + The sort order in effect on that column + + + + The name of the image used when a column is sorted ascending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + The name of the image used when a column is sorted descending + + This image is only used on pre-XP systems. System images are used for XP and later + + + + If the sort indicator images don't already exist, this method will make and install them + + + + + Remove any sorting and revert to the given order of the model objects + + + + + Do the actual work of creating the given list of groups + + + + + + For some reason, UseItemStyleForSubItems doesn't work for the colors + when owner drawing the list, so we have to specifically give each subitem + the desired colors + + The item whose subitems are to be corrected + Cells drawn via BaseRenderer don't need this, but it is needed + when an owner drawn cell uses DrawDefault=true + + + + Fill in the given OLVListItem with values of the given row + + the OLVListItem that is to be stuff with values + the model object from which values will be taken + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + + + + Convert the given image selector to an index into our image list. + Return -1 if that's not possible + + + Index of the image in the imageList, or -1 + + + + Return the tooltip that should be shown when the mouse is hovered over the given column + + The column index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回当鼠标悬停在给定单元格上时应显示的工具提示 + + The column index whose tool tip is to be fetched + The row index whose tool tip is to be fetched + A string or null if no tool tip is to be shown + + + + 返回显示给定模型对象的OLVListItem + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Do the work required after the items in a listview have been created + + + + + Do the work required after one item in a listview have been created + + + + + 准备列表视图以显示交替的行背景色 + + We cannot rely on lvi.Index in this method. + In a straight list, lvi.Index is the display index, and can be used to determine + whether the row should be colored. But when organised by groups, lvi.Index is not + useable because it still refers to the position in the overall list, not the display order. + + + + + Setup all subitem images on all rows + + + + + 告诉基础列表控件针对子项显示哪些图像 + + the index at which the item occurs + the item whose subitems are to be set + + + + Tell the underlying list control which images to show against the subitems + + the index at which the item occurs + the item whose subitems are to be set + will existing images be cleared if no new image is provided? + + + + Set the subitem image natively + + + + + + + + + Take ownership of the 'objects' collection. This separats our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + This method has the intentional side-effect of converting our list of objects to an ArrayList. + + + + + + 触发给定项目的FormatRow和可能的FormatCell事件 + + + + + + + + 触发给定项目的FormatCell事件 + + + + + + + + Make the list forget everything -- all rows and all columns + + Use if you want to remove just the rows. + + + + Update our externally visible image list so it holds the same images as our shadow list, but sized correctly + + + + + Return a copy of the given source image list, where each image has been resized to be height x height in size. + If source is null, an empty image list of the given size is returned + + Height and width of the new images + Height and width of the new images + Source of the images (can be null) + A new image list + + + + Return a bitmap of the given height x height, which shows the given image, centred. + + Height and width of new bitmap + Height and width of new bitmap + Image to be centred + The background color + A new bitmap + + + + Initialize the state image list with the required checkbox images + + + + + The name of the image used when a check box is checked + + + + + The name of the image used when a check box is unchecked + + + + + The name of the image used when a check box is Indeterminate + + + + + Setup this control so it can display check boxes on subitems + (or primary checkboxes in virtual mode) + + This gives the ListView a small image list, if it doesn't already have one. + + + + Make sure the small image list for this control has checkbox images + (used for sub-item checkboxes). + + + + This gives the ListView a small image list, if it doesn't already have one. + + + ObjectListView has to manage checkboxes on subitems separate from the checkboxes on each row. + The underlying ListView knows about the per-row checkboxes, and to make them work, OLV has to + correctly configure the StateImageList. However, the ListView cannot do checkboxes in subitems, + so ObjectListView has to handle them in a differnt fashion. So, per-row checkboxes are controlled + by images in the StateImageList, but per-cell checkboxes are handled by images in the SmallImageList. + + + + + + Owner draw the column header + + + + + + Owner draw the item + + + + + + Owner draw a single subitem + + + + + + We need the click count in the mouse up event, but that is always 1. + So we have to remember the click count from the preceding mouse down event. + + + + + + When the mouse leaves the control, remove any hot item highlighting + + + + + + When the mouse moves, we might need to change the hot item. + + + + + + Check to see if we need to start editing a cell + + + + + + Tell the world that a hyperlink was clicked and if the event isn't handled, + do the default processing. + + + + + + Do the default processing for a hyperlink clicked event, which + is to try and open the url. + + + + + + The user right clicked on the control + + + + + + This method is called every time a row is selected or deselected. This can be + a pain if the user shift-clicks 100 rows. We override this method so we can + trigger one event for any number of select/deselects that come from one user action + + + + + + Called when the handle of the underlying control is created + + + + + + This method is called after the control has been fully created. + + + + + Should we start editing the cell in response to the given mouse button event? + + + + + + + Handle a key press on this control. We specifically look for F2 which edits the primary column, + or a Tab character during an edit operation, which tries to start editing on the next (or previous) cell. + + + + + + + Start an editing operation on the first editable column of the given model. + + + + + If the model doesn't exist, or there are no editable columns, this method + will do nothing. + + This will start an edit operation regardless of CellActivationMode. + + + + + + Begin an edit operation on the given cell. + + This performs various sanity checks and passes off the real work to StartCellEdit(). + The row to be edited + The index of the cell to be edited + + + + Really start an edit operation on a given cell. The parameters are assumed to be sane. + + The row to be edited + The index of the cell to be edited + + + + Calculate the bounds of the edit control for the given item/column + + + + + + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Calculate the bounds of the edit control for the given item/column, when the listview + is not being owner drawn. + + + + + + A rectangle that is the bounds of the cell editor + + + + Try to give the given value to the provided control. Fall back to assigning a string + if the value assignment fails. + + A control + The value to be given to the control + The string to be given if the value doesn't work + + + + Setup the given control to be a cell editor + + + + + Return the value that the given control is showing + + + + + + + Called when the cell editor could be about to lose focus. Time to commit the change + + + + + + + Return the bounds of the given cell + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Return the bounds of the given cell only until the edge of the current text + + The row to be edited + The index of the cell to be edited + A Rectangle + + + + Calculate the visible bounds of the given column. The column's bottom edge is + either the bottom of the last row or the bottom of the control. + + The bounds of the control itself + The column + A Rectangle + This returns an empty rectnage if the control isn't in Details mode, + OR has doesn't have any rows, OR if the given column is hidden. + + + + Return a control that can be used to edit the value of the given cell. + + The row to be edited + The index of the cell to be edited + A Control to edit the given cell + + + + Get the first non-null value of the given column. + At most 1000 rows will be considered. + + + The first non-null value, or null if no non-null values were found + + + + Return a TextBox that can be used as a default cell editor. + + What column does the cell belong to? + + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + + + + Configure the given text box to autocomplete unique values + from the given column. At most 1000 rows will be considered. + + The textbox to configure + The column used to calculate values + Consider only this many rows + + + + Stop editing a cell and throw away any changes. + + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + + + + If a cell edit is in progress, finish the edit. + + Returns false if the finishing process was cancelled + (i.e. the cell editor is still on screen) + This method does not guarantee that the editing will finish. The validation + process can cause the finishing to be aborted. Developers should check the return value + or use IsCellEditing property after calling this method to see if the user is still + editing a cell. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + + + + Finish the cell edit operation, writing changed data back to the model object + + This method does not trigger a Validating event, so it always finishes + the cell edit. + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + + + + Remove all trace of any existing cell edit operation + + True if it is likely that another cell is going to be + edited immediately after this cell finishes editing + True if the cell editor should be disposed + + + + Force the hot item to be recalculated + + + + + Force the hot item to be recalculated + + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + Where is the mouse? + This is the main entry point for hot item handling + + + + The mouse has moved to the given pt. See if the hot item needs to be updated + + + This is the main entry point for hot item handling + + + + Update the given row using the current hot item information + + + + + + Update the given row using the given hot item information + + + + + + + + + Apply a style to the given row + + + + + + + Apply a style to a cell + + + + + + + + Remove hot item styling from the given row + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Add the given decoration to those on this list and make it appear + + The decoration + + A decoration scrolls with the listview. An overlay stays fixed in place. + + + + + Add the given overlay to those on this list and make it appear + + The overlay + + + + Draw all the decorations + + A Graphics + The items that were redrawn and whose decorations should also be redrawn + + + + Is the given decoration shown on this list + + The overlay + + + + Is the given overlay shown on this list? + + The overlay + + + + Hide any overlays. + + + This is only a temporary hiding -- the overlays will be shown + the next time the ObjectListView redraws. + + + + + Create and configure the empty list msg overlay + + + + + Initialize the standard image and text overlays + + + + + Make sure that any overlays are visible. + + + + + Refresh the display of the overlays + + + + + Refresh the display of just one overlays + + + + + Remove the given decoration from this list + + The decoration to remove + + + + Remove the given overlay to those on this list + + The overlay + + + + 创建一个筛选器，该筛选器将执行当前安装在可见列上的所有筛选。 + + + + + Do the actual work of filtering + + + + + + + + + 删除所有列筛选。 + + + + + 根据每列中定义的值筛选更新此ObjectListView的筛选 + + + + + When some setting related to filtering changes, this method is called. + + + + + 使用当前安装的模型过滤器更新所有渲染器 + + + + + 获取给定模型的复选框状态。 + + The model + 模型的复选框状态。默认为未选中。 + + + + 设置给定模型对象的复选框状态 + + The model to be remembered + The model's checkedness + The state given to the method + + + + 忽略任何持久复选框状态 + + + + + The callbacks for CellEditing events + + this + We could replace this with EventHandler<CellEditEventArgs> but that would break all + cell editing event code from v1.x. + + + + + A TreeListView combines an expandable tree structure with list view columns. + + + To support tree operations, two delegates must be provided: + + + + CanExpandGetter + + + This delegate must accept a model object and return a boolean indicating + if that model should be expandable. + + + + + ChildrenGetter + + + This delegate must accept a model object and return an IEnumerable of model + objects that will be displayed as children of the parent model. This delegate will only be called + for a model object if the CanExpandGetter has already returned true for that model. + + + + + ParentGetter + + + This delegate must accept a model object and return the parent model. + This delegate will only be called when HierarchicalCheckboxes is true OR when Reveal() is called. + + + + + The top level branches of the tree are set via the Roots property. SetObjects(), AddObjects() + and RemoveObjects() are interpreted as operations on this collection of roots. + + + To add new children to an existing branch, make changes to your model objects and then + call RefreshObject() on the parent. + + The tree must be a directed acyclic graph -- no cycles are allowed. Put more mundanely, + each model object must appear only once in the tree. If the same model object appears in two + places in the tree, the control will become confused. + + + + + This event is triggered when user input requests the expansion of a list item. + + + + + This event is triggered when user input requests the collapse of a list item. + + + + + This event is triggered after the expansion of a list item due to user input. + + + + + This event is triggered after the collapse of a list item due to user input. + + + + + Trigger the expanding event + + + + + + Trigger the collapsing event + + + + + + Trigger the expanded event + + + + + + Trigger the collapsed event + + + + + + This class handles drawing the tree structure of the primary column. + + + + + Create a TreeRenderer + + + + + Should the renderer draw glyphs at the expansion points? + + The expansion points will still function to expand/collapse even if this is false. + + + + Should the renderer draw lines connecting siblings? + + + + + Return the pen that will be used to draw the lines between branches + + + + + Should the renderer draw triangles as the expansion glyphs? + + + This looks best with ShowLines = false + + + + + Return the branch that the renderer is currently drawing. + + + + + Return the TreeListView for which the renderer is being used. + + + + + How many pixels will be reserved for each level of indentation? + + + + + The real work of drawing the tree is done in this method + + + + + + + Draw the expansion indicator + + + + + + + + Gets whether or not we should render using styles + + + + + Draw the expansion indicator using styles + + + + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the expansion indicator without using styles + + + + + + + + Draw the lines of the tree + + + + + + + + + + Do the hit test + + + + + + + + + Calculate the edit rect + + + + + + + + + + + Make a default TreeListView + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + This is called *often* -- on every mouse move when required. It must be fast. + Don't do database lookups, linear searches, or pi calculations. Just return the + value of a property. + + + When this delegate is called, the TreeListView is not in a stable state. Don't make + calls back into the control. + + + + + + Gets whether or not this listview is capable of showing groups + + + + + This is the delegate that will be used to fetch the children of a model object + + + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + When this delegate is called, the TreeListView is not in a stable state. Don't do anything + that will result in calls being made back into the control. + + + + + + This is the delegate that will be used to fetch the parent of a model object + + The parent of the given model, or null if the model doesn't exist or + if the model is a root + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivalent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + + + + Gets or sets the model objects that are expanded. + + + This can be used to expand model objects before they are seen. + + Setting this does *not* force the control to rebuild + its display. You need to call RebuildAll(true). + + + + + + Gets or sets the filter that is applied to our whole list of objects. + TreeListViews do not currently support whole list filters. + + + + + Gets or sets whether this tree list view will display hierarchical checkboxes. + Hierarchical checkboxes is when a parent's "checkedness" is calculated from + the "checkedness" of its children. If all children are checked, the parent + will be checked. If all children are unchecked, the parent will also be unchecked. + If some children are checked and others are not, the parent will be indeterminate. + + + Hierarchical checkboxes don't work with either CheckStateGetters or CheckedAspectName + (which is basically the same thing). This is because it is too expensive to build the + initial state of the control if these are installed, since the control would have to walk + *every* branch recursively since a single bottom level leaf could change the checkedness + of the top root. + + + + + Gets or sets the collection of root objects of the tree + + + + + Gets the collection of objects that will be considered when creating clusters + (which are used to generate Excel-like column filters) + + + + + After expanding a branch, should the TreeListView attempts to show as much of the + revealed descendents as possible. + + + + + The model objects that form the top level branches of the tree. + + Setting this does NOT reset the state of the control. + In particular, it does not collapse branches. + + + + Make sure that at least one column is displaying a tree. + If no columns is showing the tree, make column 0 do it. + + + + + Gets or sets the renderer that will be used to draw the tree structure. + Setting this to null resets the renderer to default. + + If a column is currently rendering the tree, the renderer + for that column will be replaced. If no column is rendering the tree, + column 0 will be given this renderer. + + + + This is the delegate that will be used to create the underlying Tree structure + that the TreeListView uses to manage the information about the tree. + + + The factory must not return null. + + Most users of TreeListView will never have to use this delegate. + + + + + + Should a wait cursor be shown when a branch is being expanded? + + When this is true, the wait cursor will be shown whilst the children of the + branch are being fetched. If the children of the branch have already been cached, + the cursor will not change. + + + + Gets the model that is used to manage the tree structure + + + Don't mess with this property unless you really know what you are doing. + If you don't already know what it's for, you don't need it. + + + + Return true if the branch at the given model is expanded + + + + + + + Collapse the subtree underneath the given model + + + + + + Collapse all subtrees within this control + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Collapse all roots and forget everything we know about all models + + + + + Expand the subtree underneath the given model object + + + + + + Expand all the branches within this tree recursively. + + Be careful: this method could take a long time for large trees. + + + + Completely rebuild the tree structure + + If true, the control will try to preserve selection and expansion + + + + Completely rebuild the tree structure + + If not null, this list of objects will be selected after the tree is rebuilt + If not null, this collection of objects will be expanded after the tree is rebuilt + If not null, this collection of objects will be checked after the tree is rebuilt + + + + Unroll all the ancestors of the given model and make sure it is then visible. + + This works best when a ParentGetter is installed. + The object to be revealed + If true, the model will be selected and focused after being revealed + True if the object was found and revealed. False if it was not found. + + + + Update the rows that are showing the given objects + + + + + Change the check state of the given object to be the given state. + + + If the given model object isn't in the list, we still try to remember + its state, in case it is referenced in the future. + + + True if the checkedness of the model changed + + + + Toggle the expanded state of the branch at the given model object + + + + + + Return whether or not the given model can expand. + + + The given model must have already been seen in the tree + + + + Return the model object that is the parent of the given model object. + + + + The given model must have already been seen in the tree. + + + + Return the collection of model objects that are the children of the + given model as they exist in the tree at the moment. + + + + + This method returns the collection of children as the tree knows them. If the given + model has never been presented to the user (e.g. it belongs to a parent that has + never been expanded), then this method will return an empty collection. + + Because of this, if you want to traverse the whole tree, this is not the method to use. + It's better to traverse the your data model directly. + + + If the given model has not already been seen in the tree or + if it is not expandable, an empty collection will be returned. + + + + + + Delegates of this type are use to decide if the given model object can be expanded + + The model under consideration + Can the given model be expanded? + + + + Delegates of this type are used to fetch the children of the given model object + + The parent whose children should be fetched + An enumerable over the children + + + + Delegates of this type are used to fetch the parent of the given model object. + + The child whose parent should be fetched + The parent of the child or null if the child is a root + + + + Delegates of this type are used to create a new underlying Tree structure. + + The view for which the Tree is being created + A subclass of Tree + + + + Handle a left button down event + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + This differs from the base method by also setting up the IndentCount property. + + + + Reinitialize the Tree structure + + + + + Recalculate the state of the checkboxes of all the items in the given list + and their ancestors. + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Recalculate the hierarchy state of the given item and its ancestors + + This only makes sense when HierarchicalCheckboxes is true. + + + + + Yield the unique ancestors of the given collection of objects. + The order of the ancestors is guaranteed to be deeper objects first. + Roots will always be last. + + + Unique ancestors of the given objects + + + + Return all the ancestors of the given model + + + + This uses ParentGetter if possible. + + If the given model is a root OR if the model doesn't exist, the collection will be empty + + The model whose ancestors should be calculated + Return a collection of ancestors of the given model. + + + + The application is idle and a SelectionChanged event has been scheduled + + + + + + + Decide if the given key event should be handled as a normal key input to the control? + + + + + + + Handle focus being lost, including making sure that the whole control is redrawn. + + + + + + Handle the keyboard input to mimic a TreeView. + + + Was the key press handled? + + + + A Tree object represents a tree structure data model that supports both + tree and flat list operations as well as fast access to branches. + + If you create a subclass of Tree, you must install it in the TreeListView + via the TreeFactory delegate. + + + + Create a Tree + + + + + + This is the delegate that will be used to decide if a model object can be expanded. + + + + + This is the delegate that will be used to fetch the children of a model object + + This delegate will only be called if the CanExpand delegate has + returned true for the model object. + + + + Get or return the top level model objects in the tree + + + + + What tree view is this Tree the model for? + + + + + Collapse the subtree underneath the given model + + The model to be collapsed. If the model isn't in the tree, + or if it is already collapsed, the command does nothing. + The index of the model in flat list version of the tree + + + + Collapse all branches in this tree + + Nothing useful + + + + Expand the subtree underneath the given model object + + The model to be expanded. + The index of the model in flat list version of the tree + + If the model isn't in the tree, + if it cannot be expanded or if it is already expanded, the command does nothing. + + + + + Expand all branches in this tree + + Return the index of the first branch that was expanded + + + + Return the Branch object that represents the given model in the tree + + The model whose branches is to be returned + The branch that represents the given model, or null if the model + isn't in the tree. + + + + Return the number of visible descendents that are below the given model. + + The model whose descendent count is to be returned + The number of visible descendents. 0 if the model doesn't exist or is collapsed + + + + Rebuild the children of the given model, refreshing any cached information held about the given object + + + The index of the model in flat list version of the tree + + + + Is the given model expanded? + + + + + + + Remember whether or not the given model was expanded + + + + + + + Insert the children of the given branch into the given position + + The branch whose children should be inserted + The index where the children should be inserted + + + + Rebuild our flat internal list of objects. + + + + + Rebuild our reverse index that maps an object to its location + in the filteredObjectList array. + + + + + + Create a new branch within this tree + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Sort the tree on the given column and in the given order + + + + + + + + + + + + + Add the given collection of objects to the roots of this tree + + + + + + + + + + + + + Remove all of the given objects from the roots of the tree. + Any objects that is not already in the roots collection is ignored. + + + + + + Set the roots of this tree to be the given collection + + + + + + Update/replace the nth object with the given object + + + + + + + + + + + + + + Is this list currently being filtered? + + + + + Should the given model be included in this control? + + The model to consider + True if it will be included + + + + + + + + + + + + + + A Branch represents a sub-tree within a tree + + + + + Indicators for branches + + + + + FirstBranch of tree + + + + + LastChild of parent + + + + + OnlyBranch of tree + + + + + Create a Branch + + + + + + + + Get the ancestor branches of this branch, with the 'oldest' ancestor first. + + + + + Can this branch be expanded? + + + + + Gets or sets our children + + + + + Get/set the model objects that are beneath this branch + + + + + Gets a list of all the branches that survive filtering + + + + + Gets or set whether this branch is expanded + + + + + Return true if this branch is the first branch of the entire tree + + + + + Return true if this branch is the last child of its parent + + + + + Return true if this branch is the only top level branch + + + + + Gets the depth level of this branch + + + + + Gets or sets which model is represented by this branch + + + + + Return the number of descendents of this branch that are currently visible + + + + + + Gets or sets our parent branch + + + + + Gets or sets our overall tree + + + + + Is this branch currently visible? A branch is visible + if it has no parent (i.e. it's a root), or its parent + is visible and expanded. + + + + + Clear any cached information that this branch is holding + + + + + Collapse this branch + + + + + Expand this branch + + + + + Expand this branch recursively + + + + + Collapse all branches in this tree + + Nothing useful + + + + Fetch the children of this branch. + + This should only be called when CanExpand is true. + + + + Collapse the visible descendents of this branch into list of model objects + + + + + + Flatten this branch's visible descendents onto the given list. + + + The branch itself is not included in the list. + + + + Force a refresh of all children recursively + + + + + Sort the sub-branches and their descendents so they are ordered according + to the given comparer. + + The comparer that orders the branches + + + + This class sorts branches according to how their respective model objects are sorted + + + + + Create a BranchComparer + + + + + + Order the two branches + + + + + + + + Let the world know that a cell edit operation is beginning or ending + + + + + Create an event args + + + + + + + + + + Change this to true to cancel the cell editing operation. + + + During the CellEditStarting event, setting this to true will prevent the cell from being edited. + During the CellEditFinishing event, if this value is already true, this indicates that the user has + cancelled the edit operation and that the handler should perform cleanup only. Setting this to true, + will prevent the ObjectListView from trying to write the new value into the model object. + + + + + During the CellEditStarting event, this can be modified to be the control that you want + to edit the value. You must fully configure the control before returning from the event, + including its bounds and the value it is showing. + During the CellEditFinishing event, you can use this to get the value that the user + entered and commit that value to the model. Changing the control during the finishing + event has no effect. + + + + + The column of the cell that is going to be or has been edited. + + + + + The model object of the row of the cell that is going to be or has been edited. + + + + + The listview item of the cell that is going to be or has been edited. + + + + + The data value of the cell as it stands in the control. + + Only validate during Validating and Finishing events. + + + + The index of the cell that is going to be or has been edited. + + + + + The data value of the cell before the edit operation began. + + + + + The bounds of the cell that is going to be or has been edited. + + + + + Gets or sets whether the control used for editing should be auto matically disposed + when the cell edit operation finishes. Defaults to true + + If the control is expensive to create, you might want to cache it and reuse for + for various cells. If so, you don't want ObjectListView to dispose of the control automatically + + + + Event blocks for events that can be cancelled + + + + + Has this event been cancelled by the event handler? + + + + + BeforeSorting + + + + + Create BeforeSortingEventArgs + + + + + + + + + Create BeforeSortingEventArgs + + + + + + + + + + + Did the event handler already do the sorting for us? + + + + + What column will be used for grouping + + + + + How will groups be ordered + + + + + What column will be used for sorting + + + + + What order will be used for sorting. None means no sorting. + + + + + What column will be used for secondary sorting? + + + + + What order will be used for secondary sorting? + + + + + Sorting has just occurred. + + + + + Create a AfterSortingEventArgs + + + + + + + + + + + Create a AfterSortingEventArgs + + + + + + What column was used for grouping? + + + + + What ordering was used for grouping? + + + + + What column was used for sorting? + + + + + What ordering was used for sorting? + + + + + What column was used for secondary sorting? + + + + + What order was used for secondary sorting? + + + + + This event is triggered when the contents of a list have changed + and we want the world to have a chance to filter the list. + + + + + Create a FilterEventArgs + + + + + + Gets or sets what objects are being filtered + + + + + Gets or sets what objects survived the filtering + + + + + This event is triggered after the items in the list have been changed, + either through SetObjects, AddObjects or RemoveObjects. + + + + + Create a ItemsChangedEventArgs + + + + + Constructor for this event when used by a virtual list + + + + + + + Gets how many items were in the list before it changed + + + + + Gets how many objects are in the list after the change. + + + + + This event is triggered by AddObjects before any change has been made to the list. + + + + + Create an ItemsAddingEventArgs + + + + + + Create an ItemsAddingEventArgs + + + + + + + Gets or sets where the collection is going to be inserted. + + + + + Gets or sets the objects to be added to the list + + + + + This event is triggered by SetObjects before any change has been made to the list. + + + When used with a virtual list, OldObjects will always be null. + + + + + Create ItemsChangingEventArgs + + + + + + + Gets the objects that were in the list before it change. + For virtual lists, this will always be null. + + + + + Gets or sets the objects that will be in the list after it changes. + + + + + This event is triggered by RemoveObjects before any change has been made to the list. + + + + + Create an ItemsRemovingEventArgs + + + + + + Gets or sets the objects that will be removed + + + + + Triggered after the user types into a list + + + + + Create an AfterSearchingEventArgs + + + + + + + Gets the string that was actually searched for + + + + + Gets or sets whether an the event handler already handled this event + + + + + Gets the index of the row that was selected by the search. + -1 means that no row was matched + + + + + Triggered when the user types into a list + + + + + Create BeforeSearchingEventArgs + + + + + + + Gets or sets the string that will be found by the search routine + + Modifying this value does not modify the memory of what the user has typed. + When the user next presses a character, the search string will revert to what + the user has actually typed. + + + + Gets or sets the index of the first row that will be considered to matching. + + + + + The parameter block when telling the world about a cell based event + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + This is null for events triggered by the header. + + + + Gets the row index of the cell + + This is -1 for events triggered by the header. + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the location of the mouse at the time of the event + + + + + Gets the state of the modifier keys at the time of the event + + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view and + for event triggered by the header + + + + Gets the HitTest object that determined which cell was hit + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Tells the world that a cell was clicked + + + + + Gets or sets the number of clicks associated with this event + + + + + Tells the world that a cell was right clicked + + + + + Gets or sets the menu that should be displayed as a result of this event. + + The menu will be positioned at Location, so changing that property changes + where the menu will be displayed. + + + + Tell the world that the mouse is over a given cell + + + + + Tells the world that the frozen-ness of the ObjectListView has changed. + + + + + Make a FreezeEventArgs + + + + + + How frozen is the control? 0 means that the control is unfrozen, + more than 0 indicates froze. + + + + + The parameter block when telling the world that a tool tip is about to be shown. + + + + + Gets the tooltip control that is triggering the tooltip event + + + + + Gets or sets the text should be shown on the tooltip for this event + + Setting this to empty or null prevents any tooltip from showing + + + + In what direction should the text for this tooltip be drawn? + + + + + Should the tooltip for this event been shown in bubble style? + + This doesn't work reliable under Vista + + + + What color should be used for the background of the tooltip + + Setting this does nothing under Vista + + + + What color should be used for the foreground of the tooltip + + Setting this does nothing under Vista + + + + What string should be used as the title for the tooltip for this event? + + + + + Which standard icon should be used for the tooltip for this event + + + + + How many milliseconds should the tooltip remain before it automatically + disappears. + + + + + What font should be used to draw the text of the tooltip? + + + + + Common information to all hyperlink events + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the item of the cell + + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the ObjectListView that is the source of the event + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the model object under the cell + + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the text of the cell + + + + + Gets or sets whether or not this cell is a hyperlink. + Defaults to true for enabled rows and false for disabled rows. + + + + + Gets or sets the url that should be invoked when this cell is clicked. + + Setting this to None or String.Empty means that this cell is not a hyperlink + + + + + + + + Gets the ObjectListView that is the source of the event + + + + + Gets the item of the cell + + + + + Gets the model object under the cell + + + + + Gets the row index of the cell + + + + + Gets the display index of the row + + + + + Should events be triggered for each cell in this row? + + + + + Parameter block for FormatCellEvent + + + + + Gets the column index of the cell + + This is -1 when the view is not in details view. + + + + Gets the column of the cell + + This is null when the view is not in details view. + + + + Gets the subitem of the cell + + This is null when the view is not in details view + + + + Gets the model value that is being displayed by the cell. + + This is null when the view is not in details view + + + + The event args when a hyperlink is clicked + + + + + Gets the url that was associated with this cell. + + + + + The event args when the check box in a column header is changing + + + + + Get the column whose checkbox is changing + + + + + Get or set the new state that should be used by the column + + + + + The event args when the hot item changed + + + + + Gets or set if this event completelely handled. If it was, no further processing + will be done for it. + + + + + Gets the part of the cell that the mouse is over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse is currently over + + + + + Gets the index of the column that the mouse is over + + In non-details view, this will always be 0. + + + + Gets the index of the row that the mouse is over + + + + + Gets the group that the mouse is over + + + + + Gets the part of the cell that the mouse used to be over + + + + + Gets an extended indication of the part of item/subitem/group that the mouse used to be over + + + + + Gets the index of the column that the mouse used to be over + + + + + Gets the index of the row that the mouse used to be over + + + + + Gets the group that the mouse used to be over + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + Let the world know that a checkbox on a subitem is changing + + + + + Create a new event block + + + + + + + + + + The column of the cell that is having its checkbox changed. + + + + + The model object of the row of the cell that is having its checkbox changed. + + + + + The listview item of the cell that is having its checkbox changed. + + + + + The current check state of the cell. + + + + + The proposed new check state of the cell. + + + + + The index of the cell that is going to be or has been edited. + + + + + This event argument block is used when groups are created for a list. + + + + + Create a CreateGroupsEventArgs + + + + + + Gets the settings that control the creation of groups + + + + + Gets or sets the groups that should be used + + + + + Has this event been cancelled by the event handler? + + + + + This event argument block is used when the text of a group task is clicked + + + + + Create a GroupTaskClickedEventArgs + + + + + + Gets which group was clicked + + + + + This event argument block is used when a group is about to expand or collapse + + + + + Create a GroupExpandingCollapsingEventArgs + + + + + + Gets which group is expanding/collapsing + + + + + Gets whether this event is going to expand the group. + If this is false, the group must be collapsing. + + + + + This event argument block is used when the state of group has changed (collapsed, selected) + + + + + Create a GroupStateChangedEventArgs + + + + + + + + Gets whether the group was collapsed by this event + + + + + Gets whether the group was focused by this event + + + + + Gets whether the group was selected by this event + + + + + Gets whether the group was uncollapsed by this event + + + + + Gets whether the group was unfocused by this event + + + + + Gets whether the group was unselected by this event + + + + + Gets which group had its state changed + + + + + Gets the previous state of the group + + + + + Gets the new state of the group + + + + + This event argument block is used when a branch of a tree is about to be expanded + + + + + Create a new event args + + + + + + + Gets the model that is about to expand. If null, all branches are going to be expanded. + + + + + Gets the OLVListItem that is about to be expanded + + + + + This event argument block is used when a branch of a tree has just been expanded + + + + + Create a new event args + + + + + + + Gets the model that is was expanded. If null, all branches were expanded. + + + + + Gets the OLVListItem that was expanded + + + + + This event argument block is used when a branch of a tree is about to be collapsed + + + + + Create a new event args + + + + + + + Gets the model that is about to collapse. If this is null, all models are going to collapse. + + + + + Gets the OLVListItem that is about to be collapsed. Can be null + + + + + This event argument block is used when a branch of a tree has just been collapsed + + + + + Create a new event args + + + + + + + Gets the model that is was collapsed. If null, all branches were collapsed + + + + + Gets the OLVListItem that was collapsed + + + + + This class contains all the settings used when groups are created + + + + + Create a GroupingParameters + + + + + + + + + + + + + + + Gets or sets the ObjectListView being grouped + + + + + Gets or sets the column used to create groups + + + + + In what order will the groups themselves be sorted? + + + + + If this is set, this comparer will be used to order the groups + + + + + If this is set, this comparer will be used to order items within each group + + + + + Gets or sets the column that will be the primary sort + + + + + Gets or sets the ordering for the primary sort + + + + + Gets or sets the column used for secondary sorting + + + + + Gets or sets the ordering for the secondary sort + + + + + Gets or sets the title format used for groups with zero or more than one element + + + + + Gets or sets the title format used for groups with only one element + + + + + Gets or sets whether the items should be sorted by the primary column + + + + + These values indicate what is the state of the group. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + Normal + + + + + Collapsed + + + + + Hidden + + + + + NoHeader + + + + + Can be collapsed + + + + + Has focus + + + + + Is Selected + + + + + Is subsetted + + + + + Subset link has focus + + + + + All styles + + + + + This mask indicates which members of a LVGROUP have valid data. These values + are taken directly from the SDK and many are not used by ObjectListView. + + + + + No mask + + + + + Group has header + + + + + Group has footer + + + + + Group has state + + + + + + + + + + + + + + + pszSubtitle is valid + + + + + pszTask is valid + + + + + pszDescriptionTop is valid + + + + + pszDescriptionBottom is valid + + + + + iTitleImage is valid + + + + + iExtendedImage is valid + + + + + iFirstItem and cItems are valid + + + + + pszSubsetTitle is valid + + + + + readonly, cItems holds count of items in visible subset, iFirstItem is valid + + + + + This mask indicates which members of a GROUPMETRICS structure are valid + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class enhance the capabilities of a normal ListViewGroup, + enabling the functionality that was released in v6 of the common controls. + + + + In this implementation (2009-09), these objects are essentially passive. + Setting properties does not automatically change the associated group in + the listview. Collapsed and Collapsible are two exceptions to this and + give immediate results. + + + This really should be a subclass of ListViewGroup, but that class is + sealed (why is that?). So this class provides the same interface as a + ListViewGroup, plus many other new properties. + + + + + + Create an OLVGroup + + + + + 按指定标题创建分组 + + 分组标题 + + + + Gets or sets the bottom description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets whether or not this group is collapsed + + + + + Gets or sets whether or not this group can be collapsed + + + + + Gets or sets some representation of the contents of this group + + This is user defined (like Tag) + + + + Gets whether this group has been created. + + + + + Gets or sets the int or string that will select the extended image to be shown against the title + + + + + Gets or sets the footer of the group + + + + + Gets the internal id of our associated ListViewGroup. + + + + + Gets or sets the header of the group + + + + + Gets or sets the horizontal alignment of the group header + + + + + Gets or sets the internally created id of the group + + + + + Gets or sets ListViewItems that are members of this group + + Listener of the BeforeCreatingGroups event can populate this collection. + It is only used on non-virtual lists. + + + + Gets or sets the key that was used to partition objects into this group + + This is user defined (like Tag) + + + + Gets the ObjectListView that this group belongs to + + If this is null, the group has not yet been created. + + + + Gets or sets the name of the group + + As of 2009-09-01, this property is not used. + + + + Gets or sets whether this group is focused + + + + + Gets or sets whether this group is selected + + + + + Gets or sets the text that will show that this group is subsetted + + + As of WinSDK v7.0, subsetting of group is officially unimplemented. + We can get around this using undocumented interfaces and may do so. + + + + + Gets or set the subtitleof the task + + + + + Gets or sets the value by which this group will be sorted. + + + + + Gets or sets the state of the group + + + + + Gets or sets which bits of State are valid + + + + + Gets or sets whether this group is showing only a subset of its elements + + + As of WinSDK v7.0, this property officially does nothing. + + + + + Gets or sets the user-defined data attached to this group + + + + + Gets or sets the task of this group + + This task is the clickable text that appears on the right margin + of the group header. + + + + Gets or sets the int or string that will select the image to be shown against the title + + + + + Gets or sets the top description of the group + + + Descriptions only appear when group is centered and there is a title image + + + + + Gets or sets the number of items that are within this group. + + This should only be used for virtual groups. + + + + Gets or sets the ListViewGroup that is shadowed by this group. + + For virtual groups, this will always be null. + + + + Calculate the index into the group image list of the given image selector + + + + + + + Convert this object to a string representation + + + + + + Insert a native group into the underlying Windows control, + *without* using a ListViewGroup + + + This is used when creating virtual groups + + + + Insert a native group into the underlying control via a ListViewGroup + + + + + + Change the members of the group to match the current contents of Items, + using a ListViewGroup + + + + + Create a native LVGROUP structure that matches this group + + + + + Get the current state of this group from the underlying control + + + + + Get the current state of this group from the underlying control + + + + + An instance of Munger gets a value from or puts a value into a target object. The property + to be peeked (or poked) is determined from a string. The peeking or poking is done using reflection. + + + Name of the aspect to be peeked can be a field, property or parameterless method. The name of an + aspect to poke can be a field, writable property or single parameter method. + + Aspect names can be dotted to chain a series of references. + + Order.Customer.HomeAddress.State + + + + + Create a do nothing Munger + + + + + Create a Munger that works on the given aspect name + + The name of the + + + + A helper method to put the given value into the given aspect of the given object. + + This method catches and silently ignores any errors that occur + while modifying the target object + The object to be modified + The name of the property/field to be modified + The value to be assigned + Did the modification work? + + + + Gets or sets whether Mungers will silently ignore missing aspect errors. + + + + By default, if a Munger is asked to fetch a field/property/method + that does not exist from a model, it returns an error message, since that + condition is normally a programming error. There are some use cases where + this is not an error, and the munger should simply keep quiet. + + By default this is true during release builds. + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or parameter-less method. + + + The name can be dotted, which chains references. If any link in the chain returns + null, the entire chain is considered to return null. + + + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + Extract the value indicated by our AspectName from the given target. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Extract the value indicated by our AspectName from the given target, raising exceptions + if the munger fails. + + If the aspect name is null or empty, this will return null. + The object that will be peeked + The value read from the target + + + + Poke the given value into the given target indicated by our AspectName. + + + + If the AspectName is a dotted path, all the selectors bar the last + are used to find the object that should be updated, and the last + selector is used as the property to update on that object. + + + So, if 'target' is a Person and the AspectName is "HomeAddress.Postcode", + this method will first fetch "HomeAddress" property, and then try to set the + "Postcode" property on the home address object. + + + The object that will be poked + The value that will be poked into the target + bool indicating whether the put worked + + + + Gets the list of SimpleMungers that match our AspectName + + + + + Convert a possibly dotted AspectName into a list of SimpleMungers + + + + + + + Evaluate the given chain of SimpleMungers against an initial target. + + + + + + + + A SimpleMunger deals with a single property/field/method on its target. + + + Munger uses a chain of these resolve a dotted aspect name. + + + + + Create a SimpleMunger + + + + + + The name of the aspect that is to be peeked or poked. + + + + This name can be a field, property or method. + When using a method to get a value, the method must be parameter-less. + When using a method to set a value, the method must accept 1 parameter. + + + It cannot be a dotted name. + + + + + + Get a value from the given target + + + + + + + Poke the given value into the given target indicated by our AspectName. + + The object that will be poked + The value that will be poked into the target + bool indicating if the put worked + + + + These exceptions are raised when a munger finds something it cannot process + + + + + Create a MungerException + + + + + + + + Get the munger that raised the exception + + + + + Gets the target that threw the exception + + + + + Wrapper for all native method calls on ListView controls + + + + + Put an image under the ListView. + + + + The ListView must have its handle created before calling this. + + + This doesn't work very well. Specifically, it doesn't play well with owner drawn, + and grid lines are drawn over it. + + + + The image to be used as the background. If this is null, any existing background image will be cleared. + If this is true, the image is pinned to the bottom right and does not scroll. The other parameters are ignored + If this is true, the image will be tiled to fill the whole control background. The offset parameters will be ignored. + If both watermark and tiled are false, this indicates the horizontal percentage where the image will be placed. 0 is absolute left, 100 is absolute right. + If both watermark and tiled are false, this indicates the vertical percentage where the image will be placed. + + + + + Flags controlling how the Image List item is + drawn + + + + + Draw item normally. + + + + + Draw item transparently. + + + + + Draw item blended with 25% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw item blended with 50% of the specified foreground colour + or the Highlight colour if no foreground colour specified. + + + + + Draw the icon's mask + + + + + Draw the icon image without using the mask + + + + + Draw the icon using the ROP specified. + + + + + Preserves the alpha channel in dest. XP only. + + + + + Scale the image to cx, cy instead of clipping it. XP only. + + + + + Scale the image to the current DPI of the display. XP only. + + + + + Enumeration containing XP ImageList Draw State options + + + + + The image state is not modified. + + + + + Adds a glow effect to the icon, which causes the icon to appear to glow + with a given color around the edges. (Note: does not appear to be implemented) + + + + + Adds a drop shadow effect to the icon. (Note: does not appear to be implemented) + + + + + Saturates the icon by increasing each color component + of the RGB triplet for each pixel in the icon. (Note: only ever appears to result in a completely unsaturated icon) + + + + + Alpha blends the icon. Alpha blending controls the transparency + level of an icon, according to the value of its alpha channel. + (Note: does not appear to be implemented). + + + + + Draws an image using the specified flags and state on XP systems. + + The image list from which an item will be drawn + Device context to draw to + Index of image to draw + X Position to draw at + Y Position to draw at + Drawing flags + Width to draw + Height to draw + State flags + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + Change the virtual list size of the given ListView (which must be in virtual mode) + + This will not change the scroll position + The listview to send a message to + How many rows should the list have? + + + + Make sure the ListView has the extended style that says to display subitem images. + + This method must be called after any .NET call that update the extended styles + since they seem to erase this setting. + The listview to send a m to + + + + + + Calculates the number of items that can fit vertically in the visible area of a list-view (which + must be in details or list view. + + The listView + Number of visible items per page + + + + For the given item and subitem, make it display the given image + + The listview to send a m to + row number (0 based) + subitem (0 is the item itself) + index into the image list + + + + Setup the given column of the listview to show the given image to the right of the text. + If the image index is -1, any previous image is cleared + + The listview to send a m to + Index of the column to modifiy + + Index into the small image list + + + + Does this version of the operating system have builtin sort indicators? + + Are there builtin sort indicators + XP and later have these + + + + Return the bounds of the update region on the given control. + + The BeginPaint() system call validates the update region, effectively wiping out this information. + So this call has to be made before the BeginPaint() call. + The control whose update region is be calculated + A rectangle + + + + Validate an area of the given control. A validated area will not be repainted at the next redraw. + + The control to be validated + The area of the control to be validated + + + + Select all rows on the given listview + + The listview whose items are to be selected + + + + Deselect all rows on the given listview + + The listview whose items are to be deselected + + + + Deselect a single row + + + + + + + Set the item state on the given item + + The listview whose item's state is to be changed + The index of the item to be changed + Which bits of the value are to be set? + The value to be set + + + + Scroll the given listview by the given deltas + + + + + true if the scroll succeeded + + + + Return the handle to the header control on the given list + + The listview whose header control is to be returned + The handle to the header control + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the edges of the given column. + + + + A Point holding the left and right co-ords of the column. + -1 means that the sides could not be retrieved. + + + + Return the index of the column of the header that is under the given point. + Return -1 if no column is under the pt + + The list we are interested in + The client co-ords + The index of the column under the point, or -1 if no column header is under that point + + + + Return the index of the divider under the given point. Return -1 if no divider is under the pt + + The list we are interested in + The client co-ords + The index of the divider under the point, or -1 if no divider is under that point + + + + Get the scroll position of the given scroll bar + + + + + + + + Change the z-order to the window 'toBeMoved' so it appear directly on top of 'reference' + + + + + + + + Make the given control/window a topmost window + + + + + + + Change the size of the window without affecting any other attributes + + + + + + + + + Show the given window without activating it + + The window to show + + + + Mark the given column as being selected. + + + The OLVColumn or null to clear + + This method works, but it prevents subitems in the given column from having + back colors. + + + + + A simple-minded implementation of a Dictionary that can handle null as a key. + + The type of the dictionary key + The type of the values to be stored + This is not a full implementation and is only meant to handle + collecting groups by their keys, since groups can have null as a key value. + + + + OLVListItems are specialized ListViewItems that know which row object they came from, + and the row index at which they are displayed, even when in group view mode. They + also know the image they should draw against themselves + + + + + Create a OLVListItem for the given row object + + + + + Create a OLVListItem for the given row object, represented by the given string and image + + + + + Gets the bounding rectangle of the item, including all subitems + + + + + Gets or sets how many pixels will be left blank around each cell of this item + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how the cells of this item will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the checkedness of this item. + + + Virtual lists don't handle checkboxes well, so we have to intercept attempts to change them + through the items, and change them into something that will work. + Unfortunately, this won't work if this property is set through the base class, since + the property is not declared as virtual. + + + + + Enable tri-state checkbox. + + .NET's Checked property was not built to handle tri-state checkboxes, + and will return True for both Checked and Indeterminate states. + + + + Gets if this item has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Gets whether or not this row can be selected and activated + + + + + Gets whether any cell on this item is showing a hyperlink + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the the model object that is source of the data for this list item. + + + + + Gets or sets the color that will be used for this row's background when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection BackColor will be used. + + + + + + Gets or sets the color that will be used for this row's foreground when it is selected and + the control is focused. + + + To work reliably, this property must be set during a FormatRow event. + + If this is not set, the normal selection ForeColor will be used. + + + + + + Return the sub item at the given index + + Index of the subitem to be returned + An OLVListSubItem + + + + Return bounds of the given subitem + + This correctly calculates the bounds even for column 0. + + + + A ListViewSubItem that knows which image should be drawn against it. + + + + + Create a OLVListSubItem + + + + + Create a OLVListSubItem that shows the given string and image + + + + + Gets or sets how many pixels will be left blank around this cell + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets how this cell will be vertically aligned + + This setting only takes effect when the control is owner drawn. + + + + Gets or sets the model value is being displayed by this subitem. + + + + + Gets if this subitem has any decorations set for it. + + + + + Gets or sets the decoration that will be drawn over this item + + Setting this replaces all other decorations + + + + Gets the collection of decorations that will be drawn over this item + + + + + Get or set the image that should be shown against this item + + This can be an Image, a string or an int. A string or an int will + be used as an index into the small image list. + + + + Gets or sets the url that should be invoked when this subitem is clicked + + + + + Gets or sets whether this cell is selected + + + + + Return the state of the animatation of the image on this subitem. + Null means there is either no image, or it is not an animation + + + + + An indication of where a hit was within ObjectListView cell + + + + + Nowhere + + + + + On the text + + + + + On the image + + + + + On the checkbox + + + + + On the expand button (TreeListView) + + + + + in a button (cell must have ButtonRenderer) + + + + + in the cell but not in any more specific location + + + + + UserDefined location1 (used for custom renderers) + + + + + On the expand/collapse widget of the group + + + + + Somewhere on a group + + + + + Somewhere in a column header + + + + + Somewhere in a column header checkbox + + + + + Somewhere in a header divider + + + + + A collection of ListViewHitTest constants + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Instances of this class encapsulate the information gathered during a OlvHitTest() + operation. + + Custom renderers can use HitTestLocation.UserDefined and the UserData + object to store more specific locations for use during event handlers. + + + + Create a OlvListViewHitTestInfo + + + + + Create a OlvListViewHitTestInfo when the header was hit + + + + + Where is the hit location? + + + + + Where is the hit location? + + + + + Which group was hit? + + + + + Custom renderers can use this information to supply more details about the hit location + + + + + Gets the item that was hit + + + + + Gets the subitem that was hit + + + + + Gets the part of the subitem that was hit + + + + + Gets the ObjectListView that was tested + + + + + Gets the model object that was hit + + + + + Gets the index of the row under the hit point or -1 + + + + + Gets the index of the column under the hit point + + + + + Gets the index of the header divider + + + + + Gets the column that was hit + + + + + Returns a string that represents the current object. + + + A string that represents the current object. + + 2 + + + + A TreeDataSourceAdapter knows how to build a tree structure from a binding list. + + To build a tree + + + + Create a data source adaptor that knows how to build a tree structure + + + + + + Gets or sets the name of the property/column that uniquely identifies each row. + + + + The value contained by this column must be unique across all rows + in the data source. Odd and unpredictable things will happen if two + rows have the same id. + + Null cannot be a valid key value. + + + + + Gets or sets the name of the property/column that contains the key of + the parent of a row. + + + + The test condition for deciding if one row is the parent of another is functionally + equivilent to this: + + Object.Equals(candidateParentRow[this.KeyAspectName], row[this.ParentKeyAspectName]) + + + Unlike key value, parent keys can be null but a null parent key can only be used + to identify root objects. + + + + + Gets or sets the value that identifies a row as a root object. + When the ParentKey of a row equals the RootKeyValue, that row will + be treated as root of the TreeListView. + + + + The test condition for deciding a root object is functionally + equivilent to this: + + Object.Equals(candidateRow[this.ParentKeyAspectName], this.RootKeyValue) + + + The RootKeyValue can be null. + + + + + Gets or sets whether or not the key columns (id and parent id) should + be shown to the user. + + This must be set before the DataSource is set. It has no effect + afterwards. + + + + Gets the DataTreeListView that is being managed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A IVirtualGroups is the interface that a virtual list must implement to support virtual groups + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + This is a safe, do nothing implementation of a grouping strategy + + + + + Return the list of groups that should be shown according to the given parameters + + + + + + + Return the index of the item that appears at the given position within the given group. + + + + + + + + Return the index of the group to which the given item belongs + + + + + + + Return the index at which the given item is shown in the given group + + + + + + + + A hint that the given range of items are going to be required + + + + + + + + + Provides grouping functionality to a FastObjectListView + + + + + Create groups for FastListView + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This is the COM interface that a ListView must be given in order for groups in virtual lists to work. + + + This interface is NOT documented by MS. It was found on Greg Chapell's site. This means that there is + no guarantee that it will work on future versions of Windows, nor continue to work on current ones. + + + + + Not sure what this does + + + + + + + Not sure what this does + + + + + + + Get the index of the item that occurs at the n'th position of the indicated group. + + Index of the group + Index within the group + Index of the item within the whole list + + + + Get the index of the group to which the given item belongs + + Index of the item within the whole list + Which occurences of the item is wanted + Index of the group + + + + Get the number of groups that contain the given item + + Index of the item within the whole list + How many groups does it occur within + + + + A hint to prepare any cache for the given range of requests + + + + + + + A default implementation of the IOwnerDataCallback interface + + + + + A VirtualListDataSource is a complete manner to provide functionality to a virtual list. + An object that implements this interface provides a VirtualObjectListView with all the + information it needs to be fully functional. + + Implementors must provide functioning implementations of at least GetObjectCount() + and GetNthObject(), otherwise nothing will appear in the list. + + + + Return the object that should be displayed at the n'th row. + + The index of the row whose object is to be returned. + The model object at the n'th row, or null if the fetching was unsuccessful. + + + + Return the number of rows that should be visible in the virtual list + + The number of rows the list view should have. + + + + Get the index of the row that is showing the given model object + + The model object sought + The index of the row showing the model, or -1 if the object could not be found. + + + + The ListView is about to request the given range of items. Do + whatever caching seems appropriate. + + + + + + + Find the first row that "matches" the given text in the given range. + + The text typed by the user + Start searching from this index. This may be greater than the 'to' parameter, + in which case the search should descend + Do not search beyond this index. This may be less than the 'from' parameter. + The column that should be considered when looking for a match. + Return the index of row that was matched, or -1 if no match was found + + + + Sort the model objects in the data source. + + + + + + + Add the given collection of model objects to this control. + + A collection of model objects + + + + Insert the given collection of model objects to this control at the position + + Index where the collection will be added + A collection of model objects + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + + + Set the collection of objects that this control will show. + + + + + + Update/replace the nth object with the given object + + + + + + + This extension allow virtual lists to filter their contents + + + + + All subsequent retrievals on this data source should be filtered + through the given filters. null means no filtering of that kind. + + + + + + + A do-nothing implementation of the VirtualListDataSource interface. + + + + + Creates an AbstractVirtualListDataSource + + + + + + The list view that this data source is giving information to. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Update/replace the nth object with the given object + + + + + + + This is a useful default implementation of SearchText method, intended to be called + by implementors of IVirtualListDataSource. + + + + + + + + + + + + + + + + + + This class mimics the behavior of VirtualObjectListView v1.x. + + + + + Creates a VirtualListVersion1DataSource + + + + + + How will the n'th object of the data source be fetched? + + + + + + + + + + + + + + + + + + + + + + Designer for and its subclasses. + + + + This designer removes properties and events that are available on ListView but that are not + useful on ObjectListView. + + + We can't inherit from System.Windows.Forms.Design.ListViewDesigner, since it is marked internal. + So, this class uses reflection to create a ListViewDesigner and then forwards messages to that designer. + + + + + + Initializes the designer with the specified component. + + The to associate the designer with. This component must always be an instance of, or derive from, . + + + + Initializes a newly created component. + + A name/value dictionary of default values to apply to properties. May be null if no default values are specified. + + + + Releases the unmanaged resources used by the and optionally releases the managed resources. + + true to release both managed and unmanaged resources; false to release only unmanaged resources. + + + + Removes the duplicate DockingActionList added by this designer to the . + + + adds an internal DockingActionList : 'Dock/Undock in Parent Container'. + But the default designer has already added that action list. So we need to remove one. + + + + + Adjusts the set of properties the component exposes through a . + + An containing the properties for the class of the component. + + + + Allows a designer to add to the set of events that it exposes through a . + + The events for the class of the component. + + + + Allows a designer to change or remove items from the set of attributes that it exposes through a . + + The attributes for the class of the component. + + + + Allows a designer to change or remove items from the set of events that it exposes through a . + + The events for the class of the component. + + + + Gets the design-time action lists supported by the component associated with the designer. + + + The design-time action lists supported by the component associated with the designer. + + + + + Gets the collection of components associated with the component managed by the designer. + + + The components that are associated with the component managed by the designer. + + + + + Indicates whether a mouse click at the specified point should be handled by the control. + + + true if a click at the specified point is to be handled by the control; otherwise, false. + + A indicating the position at which the mouse was clicked, in screen coordinates. + + + + Processes Windows messages and optionally routes them to the control. + + The to process. + + + + This class modifies a ListViewActionList, by removing the "Edit Items" and "Edit Groups" actions. + + + + That class is internal, so we cannot simply subclass it, which would be simplier. + + + Action lists use reflection to determine if that action can be executed, so we not + only have to modify the returned collection of actions, but we have to implement + the properties and commands that the returned actions use. + + + + + This class works in conjunction with the OLVColumns property to allow OLVColumns + to be added to the ObjectListView. + + + + + Create a OLVColumnCollectionEditor + + + + + + What type of object does this editor create? + + + + + + Edit a given value + + + + + + + + + What text should be shown in the list for the given object? + + + + + + + Control how the overlay is presented in the IDE + + + + + An OLVColumn knows which aspect of an object it should present. + + + The column knows how to: + + extract its aspect from the row object + convert an aspect to a string + calculate the image for the row object + extract a group "key" from the row object + convert a group "key" into a title for the group + + For sorting to work correctly, aspects from the same column + must be of the same type, that is, the same aspect cannot sometimes + return strings and other times integers. + + + + + How should the button be sized? + + + + + 每个单元格都将具有相同大小的按钮，如ButtonSize属性所示 + + + + + 每个单元格都将绘制一个填充单元格的按钮，该按钮由ButtonPadding插入 + + + + + 将调整每个按钮的大小以包含文本内容 + + + + + Create an OLVColumn + + + + + Initialize a column to have the given title, and show the given aspect + + The title of the column + The aspect to be shown in the column + + + + 此委托将用于提取要在此列中显示的值。 + + + 如果设置, AspectName属性将被忽略. + + + + + 请记住，如果当前列的AspectGetter是内部生成的，依旧可以随意重新生成 + + + + + 应调用以获取要在此列中显示的值的属性或方法的名称。 + 仅当未指定ValueGetterDelegate时才使用此选项。 + + 此名称可以用来表示对属性或无参数方法的链引用。 + "DateOfBirth" + "Owner.HomeAddress.Postcode" + + + + 此委托将用于将编辑后的值放回模型对象中。 + + + 如果IsEdable==false，则不执行任何操作。 + + + + + 用于将要在此列中显示的Aspect转换为字符串的委托。 + + 如果设置了此值，AspectToStringFormat将被忽略。 + + + + 将Aspect转换成字符串的格式文本 + + + 此字符串作为第一个参数传递给String.Format()方法。 + 仅当尚未设置AspectToStringConverter时才使用此选项。 + "{0:C}" 表示转换数字到货币 + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取或设置单元格编辑器是否应使用自动完成 + + + + + 获取用户操作是否可以隐藏此列 + + 这会同时考虑Hideable属性以及此列是否为列表视图的主列(列0)。 + + + + 编辑单元格时，是否应该使用整个单元格(减去复选框或图像使用的任何空间)？ + + + 如果控件不是所有者绘制(owner drawn)的，则始终将其视为true。 + + 如果该值为False(默认值)并且控件是所有者绘制(owner drawn)的， + ObjectListView将尝试计算单元格实际内容的宽度，然后将编辑控件的大小调整为恰到好处的宽度。 + 如果为真，则无论单元格的内容如何，都将使用单元格的整个宽度。 + + 如果未在列上设置此属性，则将使用控件中的值 + + 仅当控件处于详细信息视图中时才使用此值。 + 无论此设置如何，开发人员都可以通过侦听CellEditStarting事件来指定编辑控件的确切大小。 + + + + + 获取编辑此列中的单元格时是否应使用整个单元格 + + 这将计算当前有效值，该值可能与CellEditUseWholeCell不同 + + + + 获取或设置此列中此单元格周围将留空的像素数 + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + + 获取或设置此列中的单元格垂直对齐的方式。 + + + + 此设置仅在控件为所有者绘制(owner drawn)时生效。 + + + 如果未设置，将使用控件本身的值。 + + + + + + 获取或设置此列是否显示复选框。 + + + 在第0列上设置此选项不起作用。列0复选框由ObjectListView本身的CheckBox属性控制。 + + + + + Gets or sets the clustering strategy used for this column. + + + + The clustering strategy is used to build a Filtering menu for this item. + If this is null, a useful default will be chosen. + + + To disable filtering on this colummn, set UseFiltering to false. + + + Cluster strategies belong to a particular column. The same instance + cannot be shared between multiple columns. + + + + + + 获取或设置是否启用此列中的按钮(如果此列是按钮)，即使该行本身被禁用 + + + + + 此列是否应该调整大小以填充列表视图中的空闲空间？ + + + + 如果希望两列(或更多列)平均共享可用空间，请将此属性设置为True。 + 如果希望此列具有更大或更小的可用空间份额，则必须显式设置FreeSpaceProportion属性。 + + + 空间填充列仍然由MinimumWidth和MaximumWidth属性控制。 + + /// + + + + 控件中未占用的水平空间应分配给此列的比例是多少？ + + + + 在某些情况下，如果列(通常是最右边的列)可以随着列表视图的扩展而扩展， + 这样就可以在不必水平滚动的情况下尽可能多地看到列(您永远不应该让用户必须水平滚动任何内容！)。 + + + 调整空间填充列的大小以占据列表视图的未占用宽度的一部分(未占用宽度是一旦所有非填充列都被赋予其空间后剩余的宽度)。 + 此属性指示将分配给此列的未占用空间的相对比例。此属性的实际值并不重要，重要的是它的值相对于其他列中的值。 + 例子: + + + 如果只有一个空间填充列，则无论FreeSpaceProportion中的值如何，都将为其提供所有可用空间。 + + + 如果有两个或多个空间填充列，并且它们的FreeSpaceProportion值都相同，则它们将平等地共享空闲空间。 + + + 如果FreeSpaceProportion有三个值为3、2和1的空间填充列，则第一列将占用一半的空闲空间，第二列将占用三分之一的空闲空间，第三列将占用六分之一的空闲空间。 + + + + + + + + 获取或设置在单击此列的标题时是否对此列值重新生成组。 + + + 此设置仅在ShowGroups为true时使用。 + + 如果为False，则单击标题不会重建组。 + + 如果为false，则仍会激发BeforeCreatingGroups事件，这些事件可用于根据具体情况进行分组或提供反馈。 + + + + + 当组已创建但尚未成为真正的ListViewGroup时，将调用此委托。用户可以利用此机会填写有关该组的许多其他详细信息。 + + + + + 调用此委托以获取对象，该对象是给定行所属的组的键。 + + + + + 调用此委托将组键转换为该组的标题。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，应如何设置标签的格式 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 + + + "{0} [{1} items]" + + + + 获取this.GroupWithItemCountFormat或默认值 + + + 如果未设置GroupWithItemCountFormat，则如果可能，将从ObjectListView中获取其值。 + + + + + 当列表视图按此列分组并且组标题有项目计数时，如果组中只有一个项目，标签应该如何格式化 + + + 给定的格式字符串支持以下两个占位符： + + {0} - 原组标题 + {1} - 该组项目数 (始终为1) + + + "{0} [{1} item]" + + + + 获取this.GroupWithItemCountSingularFormat或默认值 + + + 如果未设置此值，将使用列表视图中的值 + + + + + 获取是否应在列标题中使用筛选器指示符绘制此列。 + + + + + 获取或设置将用于所有者绘制标题列的委托。 + + + + + 获取或设置将用于绘制此列标题的样式 + + 仅当拥有的ObjectListView将HeaderUsesThemes设置为False时才使用此选项。 + + + + 获取或设置绘制此列的标题时使用的字体 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置绘制此列标题文本的颜色 + + 您可能应该使用HeaderFormatStyle而不是此属性 + 这仅在HeaderUsesThemes为false时使用。 + + + + 获取或设置将在列标题中显示的图像键 + + 这仅在HeaderUsesThemes为false时使用 + + + + 获取或设置Header文本的对齐方式 + + + + + 返回Header的文本对齐方式。这将是显式设置的，或者将遵循列中文本的对齐方式 + + + + + 获取转换为StringAlignment的Header对齐方式 + + + + + 获取此列的标题中是否有图像 + + + + + 获取或设置此Header是否在Header中放置复选框 + + + + + 获取或设置此Header是否在Header中放置三态复选框 + + + + + 获取或设置此列Header中复选框的选中状态 + + + + + 获取或设置选中/取消选中标题复选框的值是否会导致将此列中所有单元格的复选框设置为相同的选中/取消选中。 + 默认值为true. + + + + 当单元格的复选框状态改变时，该函数不会与自动更新标题的功能相反。 + + + 此属性在TreeListView上的行为最好描述为未定义，应该避免。 + + + 此操作(检查/取消检查所有行)的性能为O(n)，其中n是行数。它将在大型虚拟列表上工作，但可能需要一些时间。 + + + + + + 获取或设置是否禁用标题中的复选框 + + + 单击禁用的复选框不会更改其值，但会引发HeaderCheckBoxChanging事件，使程序员有机会执行适当的操作。 + + + + 获取或设置用户是否可以隐藏此列。 + + + 无论此设置如何，列0永远不能隐藏。 + + + + + 获取或设置此列中的文本值是否类似于超链接 + + + + + 这是属性的名称，将调用该属性来获取应该在此列中显示的图像的图像选择器。 + 它可以返回int、String、Image或NULL。 + + + 如果ImageGetter不为空，则忽略此项。 + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 调用此委托以获取应该在此列中显示的图像的图像选择器。它可以返回int、String、Image或NULL。 + + + 该属性可以使用以下返回值来标识图像： + + null或-1 --表示无图像 + int -- Int值将用作图像列表的索引 + String -- 字符串值将用作图像列表的关键字 + Image -- 将直接绘制图像(仅在OwnerDrawn模式下) + + + + + + 获取或设置此列是否在其单元格中绘制按钮 + + + + 如果将其设置为true，则列的呈现器将成为ColumnButtonRenender(如果尚未成为ColumnButtonRenender)。如果设置为False，则将丢弃以前的任何按钮渲染器 + + 如果单元格的Aspect为Null或空，则不会在单元格中绘制任何内容。 + + + + Create a ColumnButtonRenderer to draw buttons in this column + + + + + + Fill in details to our ColumnButtonRenderer based on the properties set on the column + + + + + 获取或设置按钮可以占用的最大宽度。 + -1 表示不限制最大宽度 + + 仅当SizingMode为TextBound时才生效 + + + + 获取或设置当SizingMode为TextBound时单元格周围的额外空间 + + + + + 获取或设置SizingMode为FixedBound时按钮的大小 + + 如果未设置，将使用单元格的边界 + + + + 获取或设置此列显示按钮时如何调整每个按钮的大小 + + + + + 此列中显示的值是否可以编辑 + + 此默认值为false，因为控制列表视图的可编辑性的主要方法是列表视图本身。 + 列表视图可编辑后，所有列也可编辑，除非程序员显式将它们标记为不可编辑 + + + + 是否是固定宽度 + + + + + 获取/设置当视图切换到平铺视图(TileView)时是否使用此列。 + + 无论此设置如何，第0列始终包含在平铺视图中。平铺视图不能很好地处理许多“列”信息。两三个最好。 + + + + 获取或设置Header的文本是否应垂直呈现。 + + + 如果为True，最好将ToolTipText设置为列的名称，以便于阅读。 + 垂直Header仅为文本。他们不会画出图像。 + + + + + 该列是否可见 + + 更改此值后，必须调用RebuildColumns()才能使更改生效。 + + + + 此列最后一次定位在详细信息视图列中的位置是什么 + + DisplayIndex是易失性的。一旦从控件中移除列，就无法发现它在显示顺序中的位置。 + 即使列不在列表视图的活动列中，此属性也会保护该信息。 + + + + 列最大宽度 + + -1表示不限制. 将该值指定为与MinimumWidth相同的值，以生成固定宽度的列。 + + + + 列最小宽度 + + -1表示不限制. 将该值指定为与MaximumWidth相同的值，以生成固定宽度的列。 + + + + Get/set the renderer that will be invoked when a cell needs to be redrawn + + + + + This delegate is called when a cell needs to be drawn in OwnerDrawn mode. + + This method is kept primarily for backwards compatibility. + New code should implement an IRenderer, though this property will be maintained. + + + + 获取或设置执行文本搜索时是否使用此列的单元格中的文本。 + + + + 如果为False，则文本筛选器在查找匹配项时不会尝试搜索此列单元格。 + + + + + + 获取或设置一个委托，该委托将返回在使用基于文本的筛选器时应考虑进行文本匹配的文本值数组。 + + + + + 获取或设置此列的标题是否将包括该列的文本。 + + + + 如果为false，则列标题中呈现的唯一内容将是来自 . + + 只有在以下情况下才会考虑此设置: ObjectListView中的 为false . + + + + + 获取或设置当用户单击此列的标题时是否重新排序列表内容。 + + + + 如果为False，则单击标题将不会对列表进行排序，但也不会提供有关列表未排序原因的任何反馈。提供适当的反馈是程序员的责任。 + + 如果为false，则仍会触发BeforeSorting事件，该事件可用于根据具体情况进行排序或提供反馈。 + + + + + 获取或设置列内容的水平对齐方式。 + + NET将不允许列0具有除左对齐以外的任何对齐方式。我们不能更改列表视图的基本行为，但当所有者绘制时，列0现在可以有其他对齐方式。 + + + + 获取列文本对齐的StringAlignment等效项 + + + + + 当鼠标悬停在该列的标题上时，应该显示什么字符串？ + + 如果拥有的ObjectListView上安装了HeaderToolTipGetter，则将忽略此值。 + + + + 此列是否应该有一个三态复选框 + + + 如果为True，用户可以选择第三种状态(通常是不确定的)。 + + + + + 按列纵横比的首字母对对象进行分组 + + + 一种常见的模式是按该组的值的首字母对列进行分组。aspect必须是字符串(显然)。 + + + + + 获取或设置此列是否应为用户可筛选的列 + + + + + Gets or sets a filter that will only include models where the model's value + for this column is one of the values in ValuesChosenForFiltering + + + + + Gets or sets the values that will be used to generate a filter for this + column. For a model to be included by the generated filter, its value for this column + must be in this list. If the list is null or empty, this column will + not be used for filtering. + + + + + 列宽 + + + + + 获取或设置此列单元格的内容是否应自动换行 + + 如果此列使用自定义IRenender(即，不是从BaseRenender派生的)，则该呈现器负责实现自动换行。 + + + + For a given group value, return the string that should be used as the groups title. + + The group key that is being converted to a title + string + + + + Get the checkedness of the given object for this column + + The row object that is being displayed + The checkedness of the object + + + + Put the checkedness of the given object for this column + + The row object that is being displayed + + The checkedness of the object + + + + For a given row object, extract the value indicated by the AspectName property of this column. + + The row object that is being displayed + An object, which is the aspect named by AspectName + + + + For a given row object, return the object that is the key of the group that this row belongs to. + + The row object that is being displayed + Group key object + + + + For a given row object, return the image selector of the image that should displayed in this column. + + The row object that is being displayed + int or string or Image. int or string will be used as index into image list. null or -1 means no image + + + + Return the image that represents the check box for the given model + + + + + + + For a given row object, return the strings that will be searched when trying to filter by string. + + + This will normally be the simple GetStringValue result, but if this column is non-textual (e.g. image) + you might want to install a SearchValueGetter delegate which can return something that could be used + for text filtering. + + + The array of texts to be searched. If this returns null, search will not match that object. + + + + For a given row object, return the string representation of the value shown in this column. + + + For aspects that are string (e.g. aPerson.Name), the aspect and its string representation are the same. + For non-strings (e.g. aPerson.DateOfBirth), the string representation is very different. + + + + + + + For a given row object, return the object that is to be displayed in this column. + + The row object that is being displayed + An object, which is the aspect to be displayed + + + + Update the given model object with the given value using the column's + AspectName. + + The model object to be updated + The value to be put into the model + + + + Update the given model object with the given value + + The model object to be updated + The value to be put into the model + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Convert the aspect object to its string representation. + + + If the column has been given a AspectToStringConverter, that will be used to do + the conversion, otherwise just use ToString(). + The returned value will not be null. Nulls are always converted + to empty strings. + + + The value of the aspect that should be displayed + A string representation of the aspect + + + + Decide the clustering strategy that will be used for this column + + + + + + Gets or sets the type of data shown in this column. + + If this is not set, it will try to get the type + by looking through the rows of the listview. + + + + This event is triggered when the visibility of this column changes. + + + + + Tell the world when visibility of a column changes. + + + + + Create groupies + This is an untyped version to help with Generator and OLVColumn attributes + + + + + + + Create groupies + + + + + + + + Create groupies + + + + + + + + + Create groupies + + + + + + + + + + Create groupies. + Install delegates that will group the columns aspects into progressive partitions. + If an aspect is less than value[n], it will be grouped with description[n]. + If an aspect has a value greater than the last element in "values", it will be grouped + with the last element in "descriptions". + + Array of values. Values must be able to be + compared to the aspect (using IComparable) + The description for the matching value. The last element is the default description. + If there are n values, there must be n+1 descriptions. + + this.salaryColumn.MakeGroupies( + new UInt32[] { 20000, 100000 }, + new string[] { "Lowly worker", "Middle management", "Rarified elevation"}); + + + + + + + + + Create groupies based on exact value matches. + + + Install delegates that will group rows into partitions based on equality of this columns aspects. + If an aspect is equal to value[n], it will be grouped with description[n]. + If an aspect is not equal to any value, it will be grouped with "[other]". + + Array of values. Values must be able to be + equated to the aspect + The description for the matching value. + + this.marriedColumn.MakeEqualGroupies( + new MaritalStatus[] { MaritalStatus.Single, MaritalStatus.Married, MaritalStatus.Divorced, MaritalStatus.Partnered }, + new string[] { "Looking", "Content", "Looking again", "Mostly content" }); + + + + + + + + + An adorment is the common base for overlays and decorations. + + + + + Gets or sets the corner of the adornment that will be positioned at the reference corner + + + + + Gets or sets location within the reference rectange where the adornment will be drawn + + This is a simplied interface to ReferenceCorner and AdornmentCorner + + + + Gets or sets the offset by which the position of the adornment will be adjusted + + + + + Gets or sets the point of the reference rectangle to which the adornment will be aligned. + + + + + Gets or sets the degree of rotation by which the adornment will be transformed. + The centre of rotation will be the center point of the adornment. + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + Calculate the location of rectangle of the given size, + so that it's indicated corner would be at the given point. + + The point + + Which corner will be positioned at the reference point + + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.TopLeft) -> Point(50, 100) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.MiddleCenter) -> Point(45, 90) + CalculateAlignedPosition(new Point(50, 100), new Size(10, 20), System.Drawing.ContentAlignment.BottomRight) -> Point(40, 80) + + + + Calculate a rectangle that has the given size which is positioned so that + its alignment point is at the reference location of the given rect. + + + + + + + + Create a rectangle of the given size which is positioned so that + its indicated corner is at the indicated corner of the reference rect. + + + + + + + + + Creates a rectangle so that its bottom left is at the centre of the reference: + corner=BottomLeft, referenceCorner=MiddleCenter + This is a powerful concept that takes some getting used to, but is + very neat once you understand it. + + + + + Return the point at the indicated corner of the given rectangle (it doesn't + have to be a corner, but a named location) + + The reference rectangle + Which point of the rectangle should be returned? + A point + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.TopLeft) -> Point(0, 0) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.MiddleCenter) -> Point(25, 50) + CalculateReferenceLocation(new Rectangle(0, 0, 50, 100), System.Drawing.ContentAlignment.BottomRight) -> Point(50, 100) + + + + Given the item and the subitem, calculate its bounds. + + + + + + + + Apply any specified rotation to the Graphic content. + + The Graphics to be transformed + The rotation will be around the centre of this rect + + + + Reverse the rotation created by ApplyRotation() + + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Gets or sets the image that will be drawn + + + + + Gets or sets if the image will be shrunk to fit with its horizontal bounds + + + + + Draw the image in its specified location + + The Graphics used for drawing + The bounds of the rendering + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How big should the image be? + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Draw the image in its specified location, scaled so that it is not wider + than the given rectangle. Height is scaled proportional to the width. + + The image to be drawn + The Graphics used for drawing + The bounds of the rendering + How transparent should the image be (0 is completely transparent, 255 is opaque) + + + + Utility to draw a bitmap transparenly. + + + + + + + + + An adornment that will draw text + + + + + Gets or sets the background color of the text + Set this to Color.Empty to not draw a background + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the border around the billboard. + Set this to Color.Empty to remove the border + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the width of the border around the text + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the font that will be used to draw the text + + + + + Gets the font that will be used to draw the text or a reasonable default + + + + + Does this text have a background? + + + + + Does this overlay have a border? + + + + + Gets or sets the maximum width of the text. Text longer than this will wrap. + 0 means no maximum. + + + + + Gets or sets the formatting that should be used on the text + + + + + Gets or sets the text that will be drawn + + + + + Gets the brush that will be used to paint the text + + + + + Gets or sets the color of the text + + + + + Gets or sets whether the text will wrap when it exceeds its bounds + + + + + Draw our text with our stored configuration in relation to the given + reference rectangle + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + + + + Draw the given text with our stored configuration + + The Graphics used for drawing + The reference rectangle in relation to which the text will be drawn + The text to draw + How opaque should be text be + + + + Draw the text with a border + + The Graphics used for drawing + The bounds within which the text should be drawn + The text to draw + How opaque should be text be + + + + Return the rectangle that will be the precise bounds of the displayed text + + + + + The bounds of the text + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectagle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + A decoration is an overlay that draws itself in relation to a given row or cell. + Decorations scroll when the listview scrolls. + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + An AbstractDecoration is a safe do-nothing implementation of the IDecoration interface + + + + + Gets or sets the row that is to be decorated + + + + + Gets or sets the subitem that is to be decorated + + + + + Gets the bounds of the decorations row + + + + + Get the bounds of the decorations cell + + + + + Draw the decoration + + + + + + + + This decoration draws a slight tint over a column of the + owning listview. If no column is explicitly set, the selected + column in the listview will be used. + The selected column is normally the sort column, but does not have to be. + + + + + Create a TintedColumnDecoration + + + + + Create a TintedColumnDecoration + + + + + + Gets or sets the column that will be tinted + + + + + Gets or sets the color that will be 'tinted' over the selected column + + + + + Draw a slight colouring over our tinted column + + + This overlay only works when: + - the list is in Details view + - there is at least one row + - there is a selected column (or a specified tint column) + + + + + + + + This decoration draws an optionally filled border around a rectangle. + Subclasses must override CalculateBounds(). + + + + + Create a BorderDecoration + + + + + Create a BorderDecoration + + The pen used to draw the border + + + + Create a BorderDecoration + + The pen used to draw the border + The brush used to fill the rectangle + + + + Gets or sets the pen that will be used to draw the border + + + + + Gets or sets the padding that will be added to the bounds of the item + before drawing the border and fill. + + + + + How rounded should the corners of the border be? 0 means no rounding. + + If this value is too large, the edges of the border will appear odd. + + + + Gets or sets the brush that will be used to fill the border + + This value is ignored when using gradient brush + + + + Gets or sets the color that will be used as the start of a gradient fill. + + This and FillGradientTo must be given value to show a gradient + + + + Gets or sets the color that will be used as the end of a gradient fill. + + This and FillGradientFrom must be given value to show a gradient + + + + Gets or sets the fill mode that will be used for the gradient. + + + + + Draw a filled border + + + + + + + + Subclasses should override this to say where the border should be drawn + + + + + + Do the actual work of drawing the filled border + + + + + + + Create a GraphicsPath that represents a round cornered rectangle. + + + If this is 0 or less, the rectangle will not be rounded. + + + + + Instances of this class draw a border around the decorated row + + + + + Gets or sets the index of the left most column to be used for the border + + + + + Gets or sets the index of the right most column to be used for the border + + + + + Calculate the boundaries of the border + + + + + + Instances of this class draw a border around the decorated subitem. + + + + + Calculate the boundaries of the border + + + + + + This decoration puts a border around the cell being edited and + optionally "lightboxes" the cell (makes the rest of the control dark). + + + + + Create a EditingCellBorderDecoration + + + + + Create a EditingCellBorderDecoration + + Should the decoration use a lighbox display style? + + + + Gets or set whether the decoration should make the rest of + the control dark when a cell is being edited + + If this is true, FillBrush is used to overpaint + the control. + + + + Draw the decoration + + + + + + + + This decoration causes everything *except* the row under the mouse to be overpainted + with a tint, making the row under the mouse stand out in comparison. + The darker and more opaque the fill color, the more obvious the + decorated row becomes. + + + + + Create a LightBoxDecoration + + + + + Draw a tint over everything in the ObjectListView except the + row under the mouse. + + + + + + + + Instances of this class put an Image over the row/cell that it is decorating + + + + + Create an image decoration + + + + + Create an image decoration + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + Create an image decoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Instances of this class draw some text over the row/cell that they are decorating + + + + + Create a TextDecoration + + + + + Create a TextDecoration + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + Create a TextDecoration + + + + + + + + Gets or sets the item being decorated + + + + + Gets or sets the sub item being decorated + + + + + Draw this decoration + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + The interface for an object which can draw itself over the top of + an ObjectListView. + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + An interface for an overlay that supports variable levels of transparency + + + + + Gets or sets the transparency of the overlay. + 0 is completely transparent, 255 is completely opaque. + + + + + A null implementation of the IOverlay interface + + + + + Draw this overlay + + The ObjectListView that is being overlaid + The Graphics onto the given OLV + The content area of the OLV + + + + How transparent should this overlay be? + + + + + An overlay that will draw an image over the top of the ObjectListView + + + + + Create an ImageOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + An overlay that will draw text over the top of the ObjectListView + + + + + Create a TextOverlay + + + + + Gets or sets the horizontal inset by which the position of the overlay will be adjusted + + + + + Gets or sets the vertical inset by which the position of the overlay will be adjusted + + + + + Gets or sets whether the border will be drawn with rounded corners + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + A Billboard overlay is a TextOverlay positioned at an absolute point + + + + + Create a BillboardOverlay + + + + + Gets or sets where should the top left of the billboard be placed + + + + + Draw this overlay + + The ObjectListView being decorated + The Graphics used for drawing + The bounds of the rendering + + + + Renderers are the mechanism used for owner drawing cells. As such, they can also handle + hit detection and positioning of cell editing rectangles. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + Renderers that implement this interface will have the filter property updated, + each time the filter on the ObjectListView is updated. + + + + + + + + + + An AbstractRenderer is a do-nothing implementation of the IRenderer interface. + + + + + Render the whole item within an ObjectListView. This is only used in non-Details views. + + The event + A Graphics for rendering + The bounds of the item + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + Render one cell within an ObjectListView when it is in Details mode. + + The event + A Graphics for rendering + The bounds of the cell + The model object to be drawn + Return true to indicate that the event was handled and no further processing is needed. + + + + What is under the given point? + + + x co-ordinate + y co-ordinate + This method should only alter HitTestLocation and/or UserData. + + + + When the value in the given cell is to be edited, where should the edit rectangle be placed? + + + + + + + + + + + This class provides compatibility for v1 RendererDelegates + + + + + The renderer delegate that this renderer wraps + + + + + A BaseRenderer provides useful base level functionality for any custom renderer. + + + Subclasses will normally override the Render or OptionalRender method, and use the other + methods as helper functions. + + + + + Can the renderer wrap lines that do not fit completely within the cell? + + Wrapping text doesn't work with the GDI renderer. + + + + Gets or sets how many pixels will be left blank around this cell + + + + This setting only takes effect when the control is owner drawn. + + for more details. + + + + + Gets the horiztonal alignment of the column + + + + + Gets or sets how cells drawn by this renderer will be vertically aligned. + + + + If this is not set, the value from the column or control itself will be used. + + + + + + Gets the optional padding that this renderer should apply before drawing. + This property considers all possible sources of padding + + + + + Gets the vertical cell alignment that should govern the rendering. + This property considers all possible sources. + + + + + Gets or sets the image list from which keyed images will be fetched + + + + + When rendering multiple images, how many pixels should be between each image? + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Get or set the aspect of the model object that this renderer should draw + + + + + What are the bounds of the cell that is being drawn? + + + + + Get or set the OLVColumn that this renderer will draw + + + + + Get/set the event that caused this renderer to be called + + + + + Get/set the event that caused this renderer to be called + + + + + Gets or sets the font to be used for text in this cell + + + + + Gets the image list from which keyed images will be fetched + + + + + Should this renderer fill in the background before drawing? + + + + + Cache whether or not our item is selected + + + + + Is this renderer being used on a printer context? + + + + + Get or set the listitem that this renderer will be drawing + + + + + Get/set the listview for which the drawing is to be done + + + + + Get the specialized OLVSubItem that this renderer is drawing + + This returns null for column 0. + + + + Get or set the model object that this renderer should draw + + + + + Get or set the list subitem that this renderer will be drawing + + + + + The brush that will be used to paint the text + + + + + Will this renderer use the custom images from the parent ObjectListView + to draw the checkbox images. + + + + If this is true, the renderer will use the images from the + StateImageList to represent checkboxes. 0 - unchecked, 1 - checked, 2 - indeterminate. + + If this is false (the default), then the renderer will use .NET's standard + CheckBoxRenderer. + + + + + Align the second rectangle with the first rectangle, + according to the alignment of the column + + The cell's bounds + The rectangle to be aligned within the bounds + An aligned rectangle + + + + Calculate the left edge of the rectangle that aligns the outer rectangle with the inner one + according to this renderer's horizontal alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with the inner rectangle + according to this renders vertical alignment + + + + + + + + Calculate the top of the rectangle that aligns the outer rectangle with a rectangle of the given height + according to this renderer's vertical alignment + + + + + + + + Calculate the space that our rendering will occupy and then align that space + with the given rectangle, according to the Column alignment + + + Pre-padded bounds of the cell + + + + + Calculate the size of the content of this cell. + + + Pre-padded bounds of the cell + The width and height of the content + + + + Calculate the bounds of a checkbox given the (pre-padded) cell bounds + + + Pre-padded cell bounds + + + + + How much space will the check box for this cell occupy? + + Only column 0 can have check boxes. Sub item checkboxes are + treated as images + + + + + + How much space will the check box for this row occupy? + If the list doesn't have checkboxes, or this isn't the primary column, + this returns an empty size. + + + + + + + How much horizontal space will the image of this cell occupy? + + + + + + + + How much vertical space will the image of this cell occupy? + + + + + + + + How much space will the image of this cell occupy? + + + + + + + + How much horizontal space will the text of this cell occupy? + + + + + + + + + How much space will the text of this cell occupy? + + + + + + + + + Return the Color that is the background color for this item's cell + + The background color of the subitem + + + + Return the color of the background color when the item is selected + + The background color of the subitem + + + + Return the color to be used for text in this cell + + The text color of the subitem + + + + Return the color of the foreground color when the item is selected + + The foreground color of the subitem + + + + Return the image that should be drawn against this subitem + + An Image or null if no image should be drawn. + + + + Return the actual image that should be drawn when keyed by the given image selector. + An image selector can be: + an int, giving the index into the image list + a string, giving the image key into the image list + an Image, being the image itself + + + The value that indicates the image to be used + An Image or null + + + + + + + + Return the string that should be drawn within this + + + + + + Return the Color that is the background color for this item's text + + The background color of the subitem's text + + + + Render the whole item in a non-details view. + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Render one cell + + + + + + + + + + Prepare this renderer to draw in response to the given event + + + + + Use this if you want to chain a second renderer within a primary renderer. + + + + Calculate which part of this cell was hit + + + + + + + + Calculate the edit rectangle + + + + + + + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method. + The graphics context that should be used for drawing + The bounds of the subitem cell + Returns whether the rendering has already taken place. + If this returns false, the default processing will take over. + + + + + Draw our data into the given rectangle using the given graphics context. + + + Subclasses should override this method if they never want + to fall back on the default processing + The graphics context that should be used for drawing + The bounds of the subitem cell + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw the standard "[checkbox] [image] [text]" cell after the state properties have been initialized. + + + + + + + Change the bounds of the given rectangle to take any cell padding into account + + + + + + + Perform normal hit testing relative to the given aligned content bounds + + + + + + + + + + This method calculates the bounds of the text within a standard layout + (i.e. optional checkbox, optional image, text) + + This method only works correctly if the state of the renderer + has been fully initialized (see BaseRenderer.GetEditRectangle) + + + + + + + + Apply any padding to the given bounds, and then align a rectangle of the given + size within that padded area. + + + + + + + + + Draw the given image aligned horizontally within the column. + + + Over tall images are scaled to fit. Over-wide images are + truncated. This is by design! + + Graphics context to use for drawing + Bounds of the cell + The image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Pre-padded bounds of the cell + + + + Fill in the background of this cell + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the primary check box of this row (checkboxes in other sub items use a different method) + + Graphics context to use for drawing + The pre-aligned and padded target rectangle + + + + Calculate the CheckBoxState we need to correctly draw the given state + + + + + + + Should this checkbox be drawn as disabled? + + + + + Is the current item hot (i.e. under the mouse)? + + + + + Is the mouse over a checkbox in this cell? + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The optional image to be drawn + + + + Draw our subitems image and text + + Graphics context to use for drawing + Bounds of the cell + + + + Draw the given collection of image selectors + + + + + + + + Draw the given text and optional image in the "normal" fashion + + Graphics context to use for drawing + Bounds of the cell + The string to be drawn + + + + Print the given text in the given rectangle using only GDI routines + + + + + + The native list control uses GDI routines to do its drawing, so using them + here makes the owner drawn mode looks more natural. + This method doesn't honour the CanWrap setting on the renderer. All + text is single line + + + + + Gets the cell's vertical alignment as a TextFormatFlag + + + + + + Gets the StringFormat needed when drawing text using GDI+ + + + + + Print the given text in the given rectangle using normal GDI+ .NET methods + + Printing to a printer dc has to be done using this method. + + + + This renderer highlights substrings that match a given text filter. + + + + + Create a HighlightTextRenderer + + + + + Create a HighlightTextRenderer + + + + + + Create a HighlightTextRenderer + + + + + + Gets or set how rounded will be the corners of the text match frame + + + + + Gets or set the brush will be used to paint behind the matched substrings. + Set this to null to not fill the frame. + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Gets or set the pen will be used to frame the matched substrings. + Set this to null to not draw a frame. + + + + + Gets or sets whether the frame around a text match will have rounded corners + + + + + Gets or set the text that will be highlighted + + + + + Gets or sets the manner in which substring will be compared. + + + Use this to control if substring matches are case sensitive or insensitive. + + + + Handle a HitTest request after all state information has been initialized + + + + + + + + + + + Draw text using GDI + + + + + + + + Draw the highlighted text using GDI + + + + + + + + Draw an indication around the given frame that shows a text match + + + + + + + + + + Draw the text using GDI+ + + + + + + + + Draw the highlighted text using GDI+ + + + + + + + + Gets whether the renderer should actually draw highlighting + + + + + Return a GraphicPath that is a round cornered rectangle + + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + + + + + + Return a GraphicPath that is a round cornered rectangle + + The rectangle + The diameter of the corners + A round cornered rectangle path + If I could rely on people using C# 3.0+, this should be + an extension method of GraphicsPath. + + + + This class maps a data value to an image that should be drawn for that value. + + It is useful for drawing data that is represented as an enum or boolean. + + + + Return a renderer that draw boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + A Renderer + + + + Return a renderer that draw tristate boolean values using the given images + + Draw this when our data value is true + Draw this when our data value is false + Draw this when our data value is null + A Renderer + + + + Make a new empty renderer + + + + + Make a new renderer that will show the given image when the given key is the aspect value + + The data value to be matched + The image to be shown when the key is matched + + + + Make a new renderer that will show the given images when it receives the given keys + + + + + + + + + Build a renderer from the given array of keys and their matching images + + An array of key/image pairs + + + + Register the image that should be drawn when our Aspect has the data value. + + Value that the Aspect must match + An ImageSelector -- an int, string or image + + + + Render our value + + + + + + + Draw a collection of images + + + + + + + + Draw one image + + + + + + + + This renderer draws just a checkbox to match the check state of our model object. + + + + + Draw our cell + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + Handle the HitTest request + + + + + + + + + Render an image that comes from our data source. + + The image can be sourced from: + + a byte-array (normally when the image to be shown is + stored as a value in a database) + an int, which is treated as an index into the image list + a string, which is treated first as a file name, and failing that as an index into the image list + an ICollection of ints or strings, which will be drawn as consecutive images + + If an image is an animated GIF, it's state is stored in the SubItem object. + By default, the image renderer does not render animations (it begins life with animations paused). + To enable animations, you must call Unpause(). + In the current implementation (2009-09), each column showing animated gifs must have a + different instance of ImageRenderer assigned to it. You cannot share the same instance of + an image renderer between two animated gif columns. If you do, only the last column will be + animated. + + + + + Make an empty image renderer + + + + + Make an empty image renderer that begins life ready for animations + + + + + Finalizer + + + + + Should the animations in this renderer be paused? + + + + + Gets a timer that can be used to trigger redraws on animations + + + + + Pause any animations + + + + + Unpause any animations + + + + + Draw our image + + + + + + + Translate our Aspect into an image. + + The strategy is: + If its a byte array, we treat it as an in-memory image + If it's an int, we use that as an index into our image list + If it's a string, we try to load a file by that name. If we can't, + we use the string as an index into our image list. + + An image + + + + This is the method that is invoked by the timer. It basically switches control to the listview thread. + + not used + + + + This is the OnTimer callback, but invoked in the same thread as the creator of the ListView. + This method can use all of ListViews methods without creating a CrossThread exception. + + + + + Instances of this class kept track of the animation state of a single image. + + + + + Is the given image an animation + + The image to be tested + Is the image an animation? + + + + Create an AnimationState in a quiet state + + + + + Create an animation state for the given image, which may or may not + be an animation + + The image to be rendered + + + + Does this state represent a valid animation + + + + + Advance our images current frame and calculate when it will expire + + + + + Render our Aspect as a progress bar + + + + + Make a BarRenderer + + + + + Make a BarRenderer for the given range of data values + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer using a custom bar scheme + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + Make a BarRenderer that uses a horizontal gradient + + + + + 此栏是否应以系统样式绘制？ + + + + + 将从我们的单元格边框开始绘制多少像素的条形图 + + + + + 在绘制进度条之前，将使用什么颜色填充控件内部？ + + + + + 进度条边框颜色 + + + + + 进度条的边框像素宽 + + + + + 进度条的“填充”部分应该是什么颜色？ + + 仅当GradientStartColor为Color.Empty时才使用此选项 + + + + 进度条中是否显示文本百分比进度显示 + + + + + + 使用渐变以此颜色开始填充进度条 + + + + + 使用渐变填充以此颜色结尾的进度条 + + + + + 使用渐变以此颜色开始填充渐满进度条 + + + + + 使用渐变填充以此颜色结尾的渐满进度条 + + + + + 无论列变得多宽，进度条都不会比这个宽。 + + + + + 无论单元格有多高，进度条都不会比这个高 + + + + + 预期的最小数据值。小于此值的值将显示一个空条。 + + + + + 接近满时的值,高于该值时，显示不同颜色，小于等于MinimumValue或大于MaximumValue值，则表示未设置该值 + + + + + 范围的最大值。大于此值的值将给出一个完整的条形。 + + + + + The Pen that will draw the frame surrounding this bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the bar + + + + + The brush that will be used to fill the background of the bar + + + + + Draw this progress bar using a gradient + + + + + + + Draw our aspect + + + + + + + Handle the GetEditRectangle request + + + + + + + + + + + An ImagesRenderer draws zero or more images depending on the data returned by its Aspect. + + This renderer's Aspect must return a ICollection of ints, strings or Images, + each of which will be drawn horizontally one after the other. + As of v2.1, this functionality has been absorbed into ImageRenderer and this is now an + empty shell, solely for backwards compatibility. + + + + + A MultiImageRenderer draws the same image a number of times based on our data value + + The stars in the Rating column of iTunes is a good example of this type of renderer. + + + + Make a quiet renderer + + + + + Make an image renderer that will draw the indicated image, at most maxImages times. + + + + + + + + + The index of the image that should be drawn + + + + + The name of the image that should be drawn + + + + + The image selector that will give the image to be drawn + + Like all image selectors, this can be an int, string or Image + + + + What is the maximum number of images that this renderer should draw? + + + + + Values less than or equal to this will have 0 images drawn + + + + + Values greater than or equal to this will have MaxNumberImages images drawn + + + + + Draw our data value + + + + + + + A class to render a value that contains a bitwise-OR'ed collection of values. + + + + + Register the given image to the given value + + When this flag is present... + ...draw this image + + + + Draw the flags + + + + + + + Do the actual work of hit testing. Subclasses should override this rather than HitTest() + + + + + + + + + This renderer draws an image, a single line title, and then multi-line description + under the title. + + + This class works best with FullRowSelect = true. + It's not designed to work with cell editing -- it will work but will look odd. + + It's not RightToLeft friendly. + + + + + + Create a DescribedTaskRenderer + + + + + Should text be rendered using GDI routines? This makes the text look more + like a native List view control. + + + + + Gets or set the font that will be used to draw the title of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the title of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the title of the task or a reasonable default + + + + + Gets or set the font that will be used to draw the description of the task + + If this is null, the ListView's font will be used + + + + Return a font that has been set for the title or a reasonable default + + + + + Gets or set the color of the description of the task + + This color is used when the task is not selected or when the listview + has a translucent selection mechanism. + + + + Return the color of the description of the task or a reasonable default + + + + + Gets or sets the number of pixels that will be left between the image and the text + + + + + 顶部留白像素 + + + + + Gets or sets the number of pixels that will be left between the title and the description + + + + + Gets or sets the name of the aspect of the model object that contains the task description + + + + + Gets or sets the filter that is filtering the ObjectListView and for + which this renderer should highlight text + + + + + When a filter changes, keep track of the text matching filters + + + + + Fetch the description from the model class + + + + + + + + + + + + + + + Draw our item + + + + + + + Draw the task + + + + + + + + + + Handle the HitTest request + + + + + + + + + This renderer draws a functioning button in its cell + + + + + Gets or sets how each button will be sized + + + + + 获取或设置SizingMode为FixedBounds时按钮的大小 + + If this is not set, the bounds of the cell will be used + + + + 获取或设置SizingMode为TextBounds时单元格周围的额外空间 + + + + + Gets or sets the maximum width that a button can occupy. + -1 means there is no maximum width. + + This is only considered when the SizingMode is TextBounds + + + + Gets or sets the minimum width that a button can occupy. + -1 means there is no minimum width. + + This is only considered when the SizingMode is TextBounds + + + + 获取或设置此列按钮的字体颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的背景颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮的内边框颜色(如果有按钮的话) + + + + + 获取或设置此列按钮是否画边框(如果有按钮的话) + + + + + Calculate the size of the contents + + + + + + + + Draw the button + + + + + + + What part of the control is under the given point? + + + + + + + + + + What is the state of the button? + + + + + + Is the mouse over the button? + + + + + The common interface supported by all style objects + + + + + Gets or set the font that will be used by this style + + + + + Gets or set the font style + + + + + Gets or sets the ForeColor + + + + + Gets or sets the BackColor + + + + + Basic implementation of IItemStyle + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class specify how should "hot items" (non-selected + rows under the cursor) be renderered. + + + + + Gets or sets the overlay that should be drawn as part of the hot item + + + + + Gets or sets the decoration that should be drawn as part of the hot item + + A decoration is different from an overlay in that an decoration + scrolls with the listview contents, whilst an overlay does not. + + + + This class defines how a cell should be formatted + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the style of font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Instances of this class describe how hyperlinks will appear + + + + + Create a HyperlinkStyle + + + + + What sort of formatting should be applied to hyperlinks in their normal state? + + + + + What sort of formatting should be applied to hyperlinks when the mouse is over them? + + + + + What sort of formatting should be applied to hyperlinks after they have been clicked? + + + + + Gets or sets the cursor that should be shown when the mouse is over a hyperlink. + + + + + Instances of this class control one the styling of one particular state + (normal, hot, pressed) of a header control + + + + + Gets or sets the font that will be applied by this style + + + + + Gets or sets the color of the text that will be applied by this style + + + + + Gets or sets the background color that will be applied by this style + + + + + Gets or sets the color in which a frame will be drawn around the header for this column + + + + + Gets or sets the width of the frame that will be drawn around the header for this column + + + + + This class defines how a header should be formatted in its various states. + + + + + Create a new HeaderFormatStyle + + + + + What sort of formatting should be applied to a column header when the mouse is over it? + + + + + What sort of formatting should be applied to a column header in its normal state? + + + + + What sort of formatting should be applied to a column header when pressed? + + + + + Set the font for all three states + + + + + + Set the fore color for all three states + + + + + + Set the back color for all three states + + + + + + 正常为选中按钮 + + + + + 获得焦点的按钮 + + + + + 鼠标经过样式 + + + + + 获得焦点并鼠标经过 + + + + + 自定义GDI工具，绘制按钮 + + + + + 绘制圆形按钮（用法同矩形按钮） + + + + + + + + + + 绘制圆角按钮 + + 要绘制的文字 + Graphics 对象 + 要填充的矩形 + + + + + 根据普通矩形得到圆角矩形的路径 + + 原始矩形 + 半径 + 图形路径 + + + + A GlassPanelForm sits transparently over an ObjectListView to show overlays. + + + + + Get the low-level windows flag that will be given to CreateWindow. + + + + + Attach this form to the given ObjectListView + + + + + Made the overlay panel invisible + + + + + Show the overlay panel in its correctly location + + + If the panel is always shown, this method does nothing. + If the panel is being resized, this method also does nothing. + + + + + Detach this glass panel from its previous ObjectListView + + + You should unbind the overlay panel before making any changes to the + widget hierarchy. + + + + + Handle when the form that owns the ObjectListView begins to be resized + + + + + + + Handle when the form that owns the ObjectListView finished to be resized + + + + + + + The owning form has moved. Move the overlay panel too. + + + + + + + The owning form is resizing. Hide our overlay panel until the resizing stops + + + + + + + Handle when the bound OLV changes its location. The overlay panel must + be moved too, IFF it is currently visible. + + + + + + + Handle when the bound OLV changes size. The overlay panel must + resize too, IFF it is currently visible. + + + + + + + Handle when the bound OLV is part of a TabControl and that + TabControl changes tabs. The overlay panel is hidden. The + first time the bound OLV is redrawn, the overlay panel will + be shown again. + + + + + + + Somewhere the parent of the bound OLV has changed. Update + our events. + + + + + + + Handle when the bound OLV changes its visibility. + The overlay panel should match the OLV's visibility. + + + + + + + Class used to capture window messages for the header of the list view + control. + + + + + Create a header control for the given ObjectListView. + + + + + + Return the index of the column under the current cursor position, + or -1 if the cursor is not over a column + + Index of the column under the cursor, or -1 + + + + 返回此控件的Windows句柄 + + + 当ObjectListView被初始化为UserControl的一部分时，GetHeaderControl()方法返回0，直到UserControl完全初始化。 + 因此，构造函数中的AssignHandle()调用不起作用。因此，我们覆盖了Handle属性，以便值始终为当前值。 + + + + + Gets or sets a style that should be applied to the font of the + column's header text when the mouse is over that column + + THIS IS EXPERIMENTAL. USE AT OWN RISK. August 2009 + + + + 如果光标位于其复选框上，则获取光标下列的索引 + + + + + Gets the client rectangle for the header + + + + + 如果给定坐标点在给定列的复选框上方，则返回TRUE。 + + + + + + + + 获取光标是否位于“锁定”的分隔线上，即用户无法拖动的分隔线。 + + + + + 获取或设置此标头所属的列表视图 + + + + + 获取标题的最大高度。-1表示没有最大值。 + + + + + 获取标题的最小高度。-1表示没有最低要求。 + + + + + Get or set the ToolTip that shows tips for the header + + + + + 获取或设置当列标题中的文本太长而无法放入列中时，是否应对其进行自动换行 + + + + + Calculate how height the header needs to be + + Height in pixels + + + + Get the bounds of the checkbox against the given column + + + + + + + Should the given column be drawn with a checkbox against it? + + + + + + + Should the given column show a sort indicator? + + + + + + + Should the given column be drawn with a filter indicator against it? + + + + + + + Should the given column show a non-themed sort indicator? + + + + + + + Return the bounds of the item with the given index + + + + + + + Return the bounds within which the given column will be drawn + + + + + + + Force the header to redraw by invalidating it + + + + + Force the header to redraw a single column by invalidating it + + + + + Create a native tool tip control for this listview + + + + + Override the basic message pump + + + + + + Handle the LButtonDown windows message + + + + + + + Handle the LButtonUp windows message + + + + + + + Handle the SetCursor windows message + + + + + + + Handle the MouseMove windows message + + + + + + + Handle the MouseLeave windows message + + + + + + + Handle the Notify windows message + + + + + + + Handle the CustomDraw windows message + + + + + + + The message divides a ListView's space between the header and the rows of the listview. + The WINDOWPOS structure controls the headers bounds, the RECT controls the listview bounds. + + + + + + + Handle when the underlying header control is destroyed + + + + + + + Does this header need to be custom drawn? + + Word wrapping and colored text require custom drawning. Funnily enough, we + can change the font natively. + + + + Draw one cell of the header + + + + + + + + Draw a background for the header, without using Themes. + + + + + + + + + + + Draw a more-or-less pure themed header background. + + + + + + + + + + Draw a sort indicator using themes + + + + + + + Draw a sort indicator without using themes + + + + + + + + Draw an indication that this column has a filter applied to it + + + + + + + + Draw the header's image and text + + + + + + + + + Return the header format that should be used for the given column + + + + + + + What style should be applied to the header? + + + + + + + + + What font should be used to draw the header text? + + + + + + + + + What flags will be used when drawing text + + + + + Perform a HitTest for the header control + + + + Null if the given point isn't over the header + + + + Instances of this class put a CheckedListBox into a tool strip menu item. + + + + + Create a ToolStripCheckedListBox + + + + + Gets the control embedded in the menu + + + + + Gets the items shown in the checkedlistbox + + + + + Gets or sets whether an item should be checked when it is clicked + + + + + Gets a collection of the checked items + + + + + Add a possibly checked item to the control + + + + + + + Add an item with the given state to the control + + + + + + + Gets the checkedness of the i'th item + + + + + + + Set the checkedness of the i'th item + + + + + + + Check all the items in the control + + + + + Unchecked all the items in the control + + + + + Listen for events on the underlying control + + + + + + Stop listening for events on the underlying control + + + + + + Tell the world that an item was checked + + + + + Trigger the ItemCheck event + + + + + + + A limited wrapper around a Windows tooltip window. + + + + + These are the standard icons that a tooltip can display. + + + + + No icon + + + + + Info + + + + + Warning + + + + + Error + + + + + Large info (Vista and later only) + + + + + Large warning (Vista and later only) + + + + + Large error (Vista and later only) + + + + + + + + + + + + + + + + + + + + + + + + + Get or set if the style of the tooltip control + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set if the tooltip should be shown as a ballon + + + + + Get or set the background color of the tooltip + + + + + Get or set the color of the text and border on the tooltip. + + + + + Get or set the title that will be shown on the tooltip. + + + + + Get or set the icon that will be shown on the tooltip. + + + + + Gets or sets the font that will be used to draw this control. + is still. + + Setting this to null reverts to the default font. + + + + Gets or sets how many milliseconds the tooltip will remain visible while the mouse + is still. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown. + + + + + Gets or sets how many milliseconds the mouse must be still before the tooltip is shown again. + + + + + Create the underlying control. + + The parent of the tooltip + This does nothing if the control has already been created + + + + Take a copy of the current settings and restore them when the + tooltip is poppped. + + + This call cannot be nested. Subsequent calls to this method will be ignored + until PopSettings() is called. + + + + + Restore the settings of the tooltip as they were when PushSettings() + was last called. + + + + + Add the given window to those for whom this tooltip will show tips + + The window + + + + Hide any currently visible tooltip + + + + + + Remove the given window from those managed by this tooltip + + + + + + Set the maximum width of a tooltip string. + + + + + Set the maximum width of a tooltip string. + + Setting this ensures that line breaks in the tooltip are honoured. + + + + Make a TOOLINFO structure for the given window + + + A filled in TOOLINFO + + + + Handle a WmNotify message + + The msg + True if the message has been handled + + + + Handle a get display info message + + The msg + True if the message has been handled + + + + Handle a TTN_LINKCLICK message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_POP message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a TTN_SHOW message + + The msg + True if the message has been handled + This cannot call base.WndProc() since the msg may have come from another control. + + + + Handle a reflected notify message + + The msg + True if the message has been handled + + + + Mess with the basic message pump of the tooltip + + + + + + Tell the world that a tooltip is about to show + + + + + Tell the world that a tooltip is about to disappear + + + + + + + + + + + + + + + + + This form is an example of how an application could allows the user to select which columns + an ObjectListView will display, as well as select which order the columns are displayed in. + + + In Tile view, ColumnHeader.DisplayIndex does nothing. To reorder the columns you have + to change the order of objects in the Columns property. + Remember that the first column is special! + It has to remain the first column. + + + + + Make a new ColumnSelectionForm + + + + + Open this form so it will edit the columns that are available in the listview's current view + + The ObjectListView whose columns are to be altered + + + + Open this form so it will edit the columns that are available in the given listview + when the listview is showing the given type of view. + + The ObjectListView whose columns are to be altered + The view that is to be altered. Must be View.Details or View.Tile + + + + Initialize the form to show the columns of the given view + + + + + + + The user has pressed OK. Do what's requied. + + + + + + + Enable the controls on the dialog to match the current state + + + + + A Comparer that will sort a list of columns so that visible ones come before hidden ones, + and that are ordered by their display order. + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + An object that implements the IGenerator interface provides the ability + to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + The Generator class provides methods to dynamically create columns + for an ObjectListView based on the characteristics of a given collection + of model objects. + + + For a given type, a Generator can create columns to match the public properties + of that type. The generator can consider all public properties or only those public properties marked with + [OLVColumn] attribute. + + + + + Gets or sets the actual generator used by the static convinence methods. + + If you subclass the standard generator or implement IGenerator yourself, + you should install an instance of your subclass/implementation here. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + + + + Replace all columns of the given ObjectListView with columns generated + from the first member of the given enumerable. If the enumerable is + empty or null, the ObjectListView will be cleared. + + The ObjectListView to modify + The collection whose first element will be used to generate columns. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + + + + Generate columns into the given ObjectListView that come from the public properties of the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the public properties of the given type + that have a OLVColumn attribute. + + + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Generate columns into the given ObjectListView that come from the given + model object type. + + The ObjectListView to modify + The model type whose attributes will be considered. + Will columns be generated for properties that are not marked with [OLVColumn]. + + + + Generate a list of OLVColumns based on the attributes of the given type + If allProperties to true, all public properties will have a matching column generated. + If allProperties is false, only properties that have a OLVColumn attribute will have a column generated. + + + Will columns be generated for properties that are not marked with [OLVColumn]. + A collection of OLVColumns matching the attributes of Type that have OLVColumnAttributes. + + + + Replace all the columns in the given listview with the given list of columns. + + + + + + + Post process columns after creating them and adding them to the AllColumns collection. + + + + + + Create a column from the given PropertyInfo and OLVColumn attribute + + + + + + + + Make a column from the given PropertyInfo + + + + + + + Make a column from the given PropertyDescriptor + + + + + + + Create a column with all the given information + + + + + + + + + + + Create a column. + + + + + + + + + Convert a property name to a displayable title. + + + + + + + Configure the given column to show a checkbox if appropriate + + + + + + + If this given type has an property marked with [OLVChildren], make delegates that will + traverse that property as the children of an instance of the model + + + + + + + Generate CanExpand and ChildrenGetter delegates from the given property. + + + + + + + An OLVExporter converts a collection of rows from an ObjectListView + into a variety of textual formats. + + + + + What format will be used for exporting + + + + + Tab separated values, according to http://www.iana.org/assignments/media-types/text/tab-separated-values + + + + + Alias for TabSeparated + + + + + Comma separated values, according to http://www.ietf.org/rfc/rfc4180.txt + + + + + HTML table, according to me + + + + + Create an empty exporter + + + + + Create an exporter that will export all the rows of the given ObjectListView + + + + + + Create an exporter that will export all the given rows from the given ObjectListView + + + + + + + Gets or sets whether hidden columns will also be included in the textual + representation. If this is false (the default), only visible columns will + be included. + + + + + Gets or sets whether column headers will also be included in the text + and HTML representation. Default is true. + + + + + Gets the ObjectListView that is being used as the source of the data + to be exported + + + + + Gets the model objects that are to be placed in the data object + + + + + Export the nominated rows from the nominated ObjectListView. + Returns the result in the expected format. + + + + This will perform only one conversion, even if called multiple times with different formats. + + + + Convert + + + + + Encode a string such that it can be used as a value in a CSV file. + This basically means replacing any quote mark with two quote marks, + and enclosing the whole string in quotes. + + + + + + + HTML-encodes a string and returns the encoded string. + + The text string to encode. + The HTML-encoded text. + Taken from http://www.west-wind.com/weblog/posts/2009/Feb/05/Html-and-Uri-String-Encoding-without-SystemWeb + + + + A TypedObjectListView is a type-safe wrapper around an ObjectListView. + + + VCS does not support generics on controls. It can be faked to some degree, but it + cannot be completely overcome. In our case in particular, there is no way to create + the custom OLVColumn's that we need to truly be generic. So this wrapper is an + experiment in providing some type-safe access in a way that is useful and available today. + A TypedObjectListView is not more efficient than a normal ObjectListView. + Underneath, the same name of casts are performed. But it is easier to use since you + do not have to write the casts yourself. + + + The class of model object that the list will manage + + To use a TypedObjectListView, you write code like this: + + TypedObjectListView<Person> tlist = new TypedObjectListView<Person>(this.listView1); + tlist.CheckStateGetter = delegate(Person x) { return x.IsActive; }; + tlist.GetColumn(0).AspectGetter = delegate(Person x) { return x.Name; }; + ... + + To iterate over the selected objects, you can write something elegant like this: + + foreach (Person x in tlist.SelectedObjects) { + x.GrantSalaryIncrease(); + } + + + + + + Create a typed wrapper around the given list. + + The listview to be wrapped + + + + Return the model object that is checked, if only one row is checked. + If zero rows are checked, or more than one row, null is returned. + + + + + Return the list of all the checked model objects + + + + + The ObjectListView that is being wrapped + + + + + Get or set the list of all model objects + + + + + Return the model object that is selected, if only one row is selected. + If zero rows are selected, or more than one row, null is returned. + + + + + The list of model objects that are selected. + + + + + Return a typed wrapper around the column at the given index + + The index of the column + A typed column or null + + + + Return a typed wrapper around the column with the given name + + The name of the column + A typed column or null + + + + Return the model object at the given index + + The index of the model object + The model object or null + + + + CheckStateGetter + + + + + + + Gets or sets the check state getter + + + + + BooleanCheckStateGetter + + + + + + + Gets or sets the boolean check state getter + + + + + CheckStatePutter + + + + + + + + Gets or sets the check state putter delegate + + + + + BooleanCheckStatePutter + + + + + + + + Gets or sets the boolean check state putter + + + + + ToolTipGetter + + + + + + + + Gets or sets the cell tooltip getter + + + + + Gets or sets the header tool tip getter + + + + + This method will generate AspectGetters for any column that has an AspectName. + + + + + A type-safe wrapper around an OLVColumn + + + + + + Creates a TypedColumn + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Generate an aspect getter that does the same thing as the AspectName, + except without using reflection. + + + + If you have an AspectName of "Owner.Address.Postcode", this will generate + the equivilent of: this.AspectGetter = delegate (object x) { + return x.Owner.Address.Postcode; + } + + + + If AspectName is empty, this method will do nothing, otherwise + this will replace any existing AspectGetter. + + + + + + Generates an aspect getter method dynamically. The method will execute + the given dotted chain of selectors against a model object given at runtime. + + The type of model object to be passed to the generated method + A dotted chain of selectors. Each selector can be the name of a + field, property or parameter-less method. + A typed delegate + + + + This method generates the actual IL for the method. + + + + + + + + A virtual object list view operates in virtual mode, that is, it only gets model objects for + a row when it is needed. This gives it the ability to handle very large numbers of rows with + minimal resources. + + A listview is not a great user interface for a large number of items. But if you've + ever wanted to have a list with 10 million items, go ahead, knock yourself out. + Virtual lists can never iterate their contents. That would defeat the whole purpose. + Animated GIFs should not be used in virtual lists. Animated GIFs require some state + information to be stored for each animation, but virtual lists specifically do not keep any state information. + In any case, you really do not want to keep state information for 10 million animations! + + Although it isn't documented, .NET virtual lists cannot have checkboxes. This class codes around this limitation, + but you must use the functions provided by ObjectListView: CheckedObjects, CheckObject(), UncheckObject() and their friends. + If you use the normal check box properties (CheckedItems or CheckedIndicies), they will throw an exception, since the + list is in virtual mode, and .NET "knows" it can't handle checkboxes in virtual mode. + + Due to the limits of the underlying Windows control, virtual lists do not trigger ItemCheck/ItemChecked events. + Use a CheckStatePutter instead. + To enable grouping, you must provide an implmentation of IVirtualGroups interface, via the GroupingStrategy property. + Similarly, to enable filtering on the list, your VirtualListDataSource must also implement the IFilterableDataSource interface. + + + + + Create a VirtualObjectListView + + + + + Gets whether or not this listview is capabale of showing groups + + + + + Get or set the collection of model objects that are checked. + When setting this property, any row whose model object isn't + in the given collection will be unchecked. Setting to null is + equivilent to unchecking all. + + + + This property returns a simple collection. Changes made to the returned + collection do NOT affect the list. This is different to the behaviour of + CheckedIndicies collection. + + + When getting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects. + When setting CheckedObjects, the performance of this method is O(n) where n is the number of checked objects plus + the number of objects to be checked. + + + If the ListView is not currently showing CheckBoxes, this property does nothing. It does + not remember any check box settings made. + + + This class optimizes the management of CheckStates so that it will work efficiently even on + large lists of item. However, those optimizations are impossible if you install a CheckStateGetter. + With a CheckStateGetter installed, the performance of this method is O(n) where n is the size + of the list. This could be painfully slow. + + + + + Gets or sets whether or not an object will be included in the CheckedObjects + collection, even if it is not present in the control at the moment + + + This property is an implementation detail and should not be altered. + + + + + Gets the collection of objects that survive any filtering that may be in place. + + + + + Gets or sets the strategy that will be used to create groups + + + This must be provided for a virtual list to show groups. + + + + + Gets whether or not the current list is filtering its contents + + + This is only possible if our underlying data source supports filtering. + + + + + Get/set the collection of objects that this list will show + + + + The contents of the control will be updated immediately after setting this property. + + Setting this property preserves selection, if possible. Use SetObjects() if + you do not want to preserve the selection. Preserving selection is the slowest part of this + code -- performance is O(n) where n is the number of selected rows. + This method is not thread safe. + The property DOES work on virtual lists, but if you try to iterate through a list + of 10 million objects, it may take some time :) + + + + + This delegate is used to fetch a rowObject, given it's index within the list + + Only use this property if you are not using a VirtualListDataSource. + + + + Should this list show its items in groups? + + + + + Get/set the data source that is behind this virtual list + + Setting this will cause the list to redraw. + + + + Gets or sets the number of rows in this virtual list. + + + There is an annoying feature/bug in the .NET ListView class. + When you change the VirtualListSize property, it always scrolls so + that the focused item is the top item. This is annoying since it makes + the virtual list seem to flicker as the control scrolls to show the focused + item and then scrolls back to where ObjectListView wants it to be. + + + + + Return the number of items in the list + + the number of items in the list + + + + Return the model object at the given index + + Index of the model object to be returned + A model object + + + + Find the given model object within the listview and return its index + + The model object to be found + The index of the object. -1 means the object was not present + + + + Return the OLVListItem that displays the given model object + + The modelObject whose item is to be found + The OLVListItem that displays the model, or null + This method has O(n) performance. + + + + Add the given collection of model objects to this control. + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the end of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Remove all items from this list + + This method can safely be called from background threads. + + + + Scroll the listview so that the given group is at the top. + + The index of the group to be revealed + + If the group is already visible, the list will still be scrolled to move + the group to the top, if that is possible. + + This only works when the list is showing groups (obviously). + + + + + Inserts the given collection of model objects to this control at hte given location + + + A collection of model objects + + The added objects will appear in their correct sort position, if sorting + is active. Otherwise, they will appear at the given position of the list. + No check is performed to see if any of the objects are already in the ListView. + Null objects are silently ignored. + + + + + Update the rows that are showing the given objects + + This method does not resort the items. + + + + Update the rows that are selected + + This method does not resort or regroup the view. + + + + Remove all of the given objects from the control + + Collection of objects to be removed + + Nulls and model objects that are not in the ListView are silently ignored. + Due to problems in the underlying ListView, if you remove all the objects from + the control using this method and the list scroll vertically when you do so, + then when you subsequenially add more objects to the control, + the vertical scroll bar will become confused and the control will draw one or more + blank lines at the top of the list. + + + + + Select the row that is displaying the given model object. All other rows are deselected. + + Model object to select + Should the object be focused as well? + + + + Select the rows that is displaying any of the given model object. All other rows are deselected. + + A collection of model objects + This method has O(n) performance where n is the number of model objects passed. + Do not use this to select all the rows in the list -- use SelectAll() for that. + + + + Set the collection of objects that this control will show. + + + Should the state of the list be preserved as far as is possible. + + + + Get the checkedness of an object from the model. Returning null means the + model does know and the value from the control will be used. + + + + + + + Rebuild the list with its current contents. + + + Invalidate any cached information when we rebuild the list. + + + + + Clear any cached info this list may have been using + + + + + Do the work of creating groups for this control + + + + + + Do the plumbing to disable groups on a virtual list + + + + + Do the plumbing to enable groups on a virtual list + + + + + Return the position of the given itemIndex in the list as it currently shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the last item in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + Return the n'th item (0-based) in the order they are shown to the user. + If the control is not grouped, the display order is the same as the + sorted list order. But if the list is grouped, the display order is different. + + + + + + + Return the ListViewItem that appears immediately after the given item. + If the given item is null, the first item in the list will be returned. + Return null if the given item is the last item. + + The item that is before the item that is returned, or null + A OLVListItem + + + + Return the ListViewItem that appears immediately before the given item. + If the given item is null, the last item in the list will be returned. + Return null if the given item is the first item. + + The item that is before the item that is returned + A ListViewItem + + + + Make a list of groups that should be shown according to the given parameters + + + + + + + Create a OLVListItem for given row index + + The index of the row that is needed + An OLVListItem + + + + On virtual lists, this cannot work. + + + + + Record the change of checkstate for the given object in the model. + This does not update the UI -- only the model + + + + The check state that was recorded and that should be used to update + the control. + + + + Refresh the given item in the list + + The item to refresh + + + + Change the size of the list + + + + + + Take ownership of the 'objects' collection. This separates our collection from the source. + + + + This method + separates the 'objects' instance variable from its source, so that any AddObject/RemoveObject + calls will modify our collection and not the original colleciton. + + + VirtualObjectListViews always own their collections, so this is a no-op. + + + + + + Change the state of the control to reflect changes in filtering + + + + + Change the size of the virtual list so that it matches its data source + + + + + Handle the CacheVirtualItems event + + + + + + + Handle a RetrieveVirtualItem + + + + + + + Handle the SearchForVirtualList event, which is called when the user types into a virtual list + + + + + + + Find the first row in the given range of rows that prefix matches the string value of the given column. + + + + + + The index of the matched row, or -1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 初始化的时候给个alpha值,这样在灰图片的时候可以半透明 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 使图片单色化 + + + + + + + + + + + + 自定义 + + + + + 预置 + + + + + 系统 + + + + + 颜色表示法 + + + + + 根据颜色表示字符串获取对应的颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + 从文件中获取Image对象 + 这个函数的主要功能是处理一些ico文件 + 一些ico文件的格式可能比较新，直接Image.FormFile，会报内存不足的异常 + + + 是否将文件读入内存操作，如果为false,将直接返回Image.FromFile，在此情况下， + 必须手动释放Image对象，否则文件将一直处于占用状态，如果为true,则在内存中拷贝副本 + + + + + + 将图像转为Icon对象,使用png格式 + + + + + + + 将图像转为Icon对象 + + + + + + + + 返回适应指定容器大小的图像 + 如果图像的尺寸(长或宽)超出了容器范围,将按比例获取图像的缩略图返回,否则直接返回图像 + 此方法最终调用 Image.GetThumbnailImage + 但是注意,在指定的容器尺寸过小时,返回的Image尺寸不可知,是在为了显示16x16的小缩略图是发现了此问题 + 使用 GetScaleImage + + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + 返回适应指定容器大小的图像 + 在需要的情况下,此方法创建一个新对象,进行绘制 + + + + + + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + + The source image. + The rectangle to fit in to. + Horizontal image aligment in percent. + Vertical image aligment in percent. + New image size. + + + + Gets the bounding rectangle of an image required to fit + in to the given rectangle keeping the image aspect ratio. + The image will be centered in the fit box. + + The source image. + The rectangle to fit in to. + New image size. + + + + Gets the scaled size of an image required to fit + in to the given size keeping the image aspect ratio. + + The source image. + The size to fit in to. + New image size. + + + + 获取一个圆角矩形 + + + + 角度 + + + + + 获取一个圆角矩形 + + + 角度 + + + + + + + + + + + + + + + + + + + + + + 返回一个表示箭头的Path + 如果开始坐标和结束坐标之间的距离大于箭头的大小，箭头向结束坐标对齐，顶着结束坐标 + + 开始坐标 + 结束坐标（顶点，方向） + 箭头的长短，大小 + 箭头的粗细 + + + + + 在指定的Image上绘制特定标记 + + + + + 文件不存在 + + + + + + 文件不存在 + + + + + + 无法读取文件 + + + + + + + + + + + + + + + + + + + + + 验证失败中显示错误信息时用的标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + 验证控件的输入 + + + + + + + 自定义验证方法 + 在基础验证都通过后，才会调用自定义验证方法（如果有） + + + + + + + + + + 是否支持 Windows Vista 以上的玻璃效果 + + + + + 是否打开了玻璃效果 + + + + + 获取应用程序主窗体 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 这个缓存是全局的 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 所对应的绑定数据类型 + + + + + 是否对 DataBoundType 的子类型有效 + 默认无效 + 如果设置为 true，又同时添加了基类与子类的 codon，则运行时会取到哪个codon不确定 + 通常取先添加的那个 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 获取授予该组件的许可证密钥 + + + + + 0:未验证 + 1:验证失败 + 2:验证通过 + + + + + 获取组件的实例或类型的许可证（如果已给定上下文并确定拒绝许可证是否引发异常）。 + + + + + + + + + + 强类型资源类，用于查找本地化字符串等。 + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + Returns a System.String that represents the current System.Object. + + + + + + + + + + 返回此类使用的缓存 ResourceManager 实例。 + + + + + 为使用此强类型资源类的所有资源查找 + 重写当前线程的 CurrentUICulture 属性。 + + + + + 查找类似 消息 的本地化字符串。 + + + + + 查找类似 底部 的本地化字符串。 + + + + + 查找类似 顶部 的本地化字符串。 + + + + + 查找类似 更大 (48x48) 的本地化字符串。 + + + + + 查找类似 大 (32x32) 的本地化字符串。 + + + + + 查找类似 中 (24x24) 的本地化字符串。 + + + + + 查找类似 小 (16x16) 的本地化字符串。 + + + + + Returns true if the current language is the default language. + + + + + + + + + + Call GetLanguages() to retrieve a list of possible languages that can be used to set this property. + The default value is the default language. + + + + + Gets a list of available languages defined in this assembly. + + + + + + + + + + + + 如果输入的字符串包含 "${...}" 这样的格式,则认为是指代资源文件中的一个字符串资源 + + + + + + + Represents a pop-up window. + + + + + Gets the content of the pop-up. + + + + + Determines which animation to use while showing the pop-up window. + + + + + Determines which animation to use while hiding the pop-up window. + + + + + Determines the duration of the animation. + + + + + Gets or sets a value indicating whether the content should receive the focus after the pop-up has been opened. + + true if the content should be focused after the pop-up has been opened; otherwise, false. + If the FocusOnOpen property is set to false, then pop-up cannot use the fade effect. + + + + Gets or sets a value indicating whether presing the alt key should close the pop-up. + + true if presing the alt key does not close the pop-up; otherwise, false. + + + + Gets or sets a value indicating whether the is resizable. + + true if resizable; otherwise, false. + + + + Gets or sets a minimum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets or sets a maximum size of the pop-up. + + An ordered pair of type representing the width and height of a rectangle. + + + + Gets parameters of a new window. + + An object of type used when creating a new window. + + + + Initializes a new instance of the class. + + The content of the pop-up. + + Pop-up will be disposed immediately after disposion of the content control. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Processes a dialog box key. + + One of the values that represents the key to process. + + true if the key was processed by the control; otherwise, false. + + + + + Updates the pop-up region. + + + + + Shows the pop-up window below the specified control. + + The control below which the pop-up will be shown. + + When there is no space below the specified control, the pop-up control is shown above it. + + is null. + + + + Shows the pop-up window below the specified area of the specified control. + + The control used to compute screen location of specified area. + The area of control below which the pop-up will be shown. + + When there is no space below specified area, the pop-up control is shown above it. + + is null. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + A that contains the event data. + + + + Processes Windows messages. + + The Windows to process. + + + + Processes the resizing messages. + + The message. + true, if the WndProc method from the base class shouldn't be invoked. + + + + Paints the sizing grip. + + The instance containing the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Types of animation of the pop-up window. + + + + + Uses no animation. + + + + + Animates the window from left to right. This flag can be used with roll or slide animation. + + + + + Animates the window from right to left. This flag can be used with roll or slide animation. + + + + + Animates the window from top to bottom. This flag can be used with roll or slide animation. + + + + + Animates the window from bottom to top. This flag can be used with roll or slide animation. + + + + + Makes the window appear to collapse inward if it is hiding or expand outward if the window is showing. + + + + + Uses a slide animation. + + + + + Uses a fade effect. + + + + + Uses a roll animation. + + + + + Uses a default animation. + + + + + Represents a Windows combo box control with a custom popup control attached. + + + + + Initializes a new instance of the class. + + + + + Gets or sets the drop down control. + + The drop down control. + + + + Gets or sets a value indicating whether the combo box is displaying its drop-down portion. + + + true if the drop-down portion is displayed; otherwise, false. The default is false. + + + + + Occurs when the drop-down portion of a is shown. + + + + + Shows the drop down. + + + + + Occurs when the drop-down portion of the is no longer visible. + + + + + Hides the drop down. + + + + + Processes Windows messages. + + The Windows to process. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + This property is not relevant for this class. + This property is not relevant for this class. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + Represents a Windows combo box control which can be used in a popup's content control. + + + + + Initializes a new instance of the PopupControl.ComboBox class. + + + + + Raises the event. + + An that contains the event data. + + + + Raises the event. + + An that contains the event data. + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 白色到灰色的垂直渐变 + + + + + + + + + + This method handles the RenderToolStripBorder event. + + + + + + + + + + + + A ToolstripManager rendering class with advanced control features + + + + + Creates a new EasyRender class for modifications + + + + + + + + + + + + + + + + + + + + Gets the manager to edit and change the appearance of the Toolstrip + + + + + Gets the manager to edit and change the appearance of Toolstrip buttons + + + + + Gets the manager to edit and change the appearance of other Toolstrip controls + + + + + Gets the manager to edit and change the appearance of the Panels + + + + + Gets the manager to edit and change the appearance of the Toolstrip split buttons + + + + + Gets the manager to edit and change the appearance of the Status-bar + + + + + Gets or sets whether to smooth the font text on all controls + + + + + Gets or sets the color of the text if the AlterColor is set to true + + + + + Gets or sets whether to override the font-color on all controls + + + + + Creates a GraphicsPath that appreciates an area where things can be drawn + + The rectangular area which will serve as the base + The curve amount of the corners + + + + + Creates a triangle based on the size and bounds sectors + + The area which the triangle is confined to + The size of the triangle + The direction which the triangle is pointing + + + + + Gets a color array based on the state of a normal button + + The button to check the state of + + + + + + Gets a color array based on the state of a split-button + + The button to check the state of + + + + + + Gets a color array based on the state of a menu-item + + The button to check the state of + + + + + + Gets a color array based on the state of a drop-down button + + The button to check the state of + + + + + + Gets a blending property for a specified type of Toolstrip item + + The Toolstrip item + The type of item this is + + + + + Fills a specified boundary with color + + The Graphics object to draw onto + The boundaries to draw the color + The brush to fill the color + + + + Fills a specified boundary with a gradient with specified colors + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + + + + Fills a specified boundary with a gradient with specified colors at a given angle + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Fills a specified boundary with a gradient with specified colors at a given angle and with blending properties + + The Graphics object to draw onto + The boundaries to draw the color + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a set path with a defined brush + + The Graphics object to draw onto + The path to draw along + The brush to fill the color + + + + Draws a set path with specified colors + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + + + + Draws a set path with specified colors at a given angle + + The Graphics object to draw onto + The path to draw along + The area of span the border gradient covers + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + + + + Draws a set path with specified colors at a given angle with blending properties + + The Graphics object to draw onto + The path to draw along + + The color of the gradient at the top + The color of the gradient at the bottom + The angle which the gradient is drawn (null defaults to 90f) + The blending options to draw the gradient + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws a Toolstrip button + + The Toolstrip button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Toolstrip background + + The Toolstrip being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Toolstrip split-button + + The Toolstrip split-button + The Graphics object to handle + The parent Toolstrip + + + + Draws the Statusbar background + + The Statusbar being drawn + The Graphics object to handle + The affected bounds + + + + Draws a Menustrip item + + The Menustrip item + The Graphics object to handle + The parent Toolstrip + + + + Covers the button background rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Applies any and all changes made to the Renderer + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Toolstrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IToolstrip class for customization + + The IToolstrip to import the settings from + + + + Disposes of the IToolstrip class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip background gradient from the top + + + + + Gets or sets the color of the Toolstrip background gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip background + If set to null, the Toolstrip will simply draw the gradient + + + + + Gets or sets the angle which the Toolstrip background will be drawn + + + + + Gets or sets the color of the Toolstrip border gradient from the top + + + + + Gets or sets the color of the Toolstrip border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Toolstrip border + If set to null, the Toolstrip will simply draw the border + + + + + Gets or sets the angle which the Toolstrip border will be drawn + + + + + Gets or sets the curve of the border of the Toolstrip + + + + + Imports the settings from a previous or pre-defined IToolstrip and applies it to the current + + The IToolstrip to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IToolstripControls class for customization + + + + + Disposes of the IToolstripControls class and clears all resources related to it + + + + + Gets or sets the color of the Toolstrip seperator on the dark side + + + + + Gets or sets the color of the Toolstrip seperator on the light side + + + + + Gets or sets the height of the Toolstrip seperator control + + + + + Gets or sets the color of the grip dots/line at the top + + + + + Gets or sets the color of the grip shadow + + + + + Gets or sets in what mode the grip will be drawn + + + + + Gets or sets the distance, in pixels, between each grip dot + + + + + Gets or sets the size of the dots or lines for the grip + + + + + Imports the settings from a previous or pre-defined IToolstripControls and applies it to the current + + The IToolstripControls to import the settings from + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IButton and applies it to the current + + The IButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IButton class for customization + + + + + Creates a new IButton class for customization + + The IButton to import the settings from + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" and "Click" do not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Imports the settings from a previous or pre-defined IDropDownButton and applies it to the current + + The IDropDownButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new ISplitButton class for customization + + + + + Disposes of the ISplitButton class and clears all resources related to it + + + + + Gets or sets the color of the Button background at the top, when hovered over + + + + + Gets or sets the color of the Button background at the bottom, when hovered over + + + + + Gets or sets the color of the Button background at the top, when clicked + + + + + Gets or sets the color of the Button background at the bottom, when clicked + + + + + Gets or sets the blending that will occur when rendering the Button background + If set to null, the Button will simply draw the gradient + + + + + Gets or sets the angle which the Button background will be drawn + + + + + Gets or sets the color of the Button border gradient from the top + + + + + Gets or sets the color of the Button border gradient from the bottom + + + + + Gets or sets the blending that will occur when rendering the Button border + If set to null, the Button will simply draw the border + + + + + Gets or sets the angle which the Button border will be drawn + + + + + Gets or sets the color of the inside border + + + + + Gets or sets when to apply the rendering ("Normal" does not apply here) + + + + + Gets or sets the curve of the border of the Button + + + + + Gets or sets when to display the drop-down arrow + + + + + Gets or sets the color of the drop-down arrow + + + + + Imports the settings from a previous or pre-defined ISplitButton and applies it to the current + + The ISplitButton to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + + + + + + Creates a new IPanel class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient at the top of the content panel + + + + + Gets or sets the color of the gradient at the bottom of the content panel + + + + + Gets or sets whether each panel inherits the shading from the content panel + + + + + Gets or sets the angle which the background gradient is drawn + + + + + Gets or sets the blend of the background + + + + + Gets or sets a mode to render the background in + + + + + + + + + + Creates a new IStatusBar class for customization + + + + + Disposes of the IButton class and clears all resources related to it + + + + + Gets or sets the color of the gradient of the background at the top + + + + + Gets or sets the color of the gradient of the background at the bottom + + + + + Gets or sets the blending that will apply to the background + + + + + Gets or sets the angle which the background gradient will be drawn + + + + + Gets or sets the color of the dark border + + + + + Gets or sets the color of the light border + + + + + Gets or sets the color of the grip at the top-most + + + + + Gets or sets the color of the grip at the bottom-most + + + + + Gets or sets the spacing of the grip blocks + + + + + Imports the settings from a previous or pre-defined IStatusBar and applies it to the current + + The IStatusBar to import the settings from + + + + Sets the blending for both border and background to their defaults + + + + + A class designed to be used in the EasyRender master control to customize the look and feel of the base Menustrip + + + + + Creates a new IToolstrip class for customization + + + + + Creates a new IMenustrip class for customization + + The IMenustrip to import the settings from + + + + Disposes of the IMenustrip class and clears all resources related to it + + + + + Gets or sets the color of the menu-strip border (dark) + + + + + Gets or sets the color of the menu-strip border (light) + + + + + Gets or sets how the background of the menu-strip is inherited + + + + + If inheritence is set to none, the color of the background gradient at the top + + + + + If inheritence is set to none, the color of the background gradient at the bottom + + + + + If inheritence is set to none, the blending option for the background + + + + + Gets or sets the color of the margin gradient at the left + + + + + Gets or sets the color of the margin gradient at the right + + + + + Gets or sets the color of the margin border (displayed to the right) + + + + + Gets or sets the color of the root menu-strip button background when it is selected + + + + + Gets or sets the color of the root menu-strip button border when it is selected + + + + + Gets or sets the color of the seperator dark color + + + + + Gets or sets the color of the seperator light color + + + + + Gets or sets the inset position of the seperator from the left + + + + + Gets the class that handles the look and feel of the menu-strip items + + + + + Imports the settings from a previous or pre-defined IMenustrip and applies it to the current + + The IMenustrip to import the settings from + + + + Sets the blending for the background to it's default + + + + + Defines when to show an arrow + + + + + + + + + + + + + + + + + + + + Defines when to use a blend property + + + + + Use the blend when the object is drawn + + + + + Use the blend when the object is hovered over + + + + + Use the blend when the object is clicked + + + + + Use the blend when the object is checked + + + + + Always use the blend regardless of the state of the object + + + + + Defines a method of drawing a grip on a control + + + + + Draws the grip as a set of dots + + + + + Draws the grip as two lines + + + + + Does not draw the grip at all, but the object remains moveable + + + + + Defines a specific type of button to search by + + + + + + + + + + + + + + + + + + + + + + + + + Defines a method for background or object inheritence + + + + + + + + + + + + + + + Defines a method of rendering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 主菜单 + + + + + 背景透明的工具条 + + + + + 银白色至白色渐变 + + + + + 白色至银白色渐变 + + + + + + + + + + + + + + + 当前工作区窗体所关联并激活的工具栏 + + + + + 模拟运行时的外观 + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 鼠标滑过 + + + + + 控件的高度根据内容自动调整，忽略外部设置 + + + + + 边框宽度 + + + + + 文本和description文本之间的间距 + + + + + 最大显示的项数 + + + + + + + + + + 是否显示说明字段，此属性不影响弹出面板是否显示 + 弹出面板是否显示由DescriptionMember是否设置决定 + + + + + + + + + + + + + + + 下拉列表的布局模式 + + + + + + + + + + 是否允许空 + + + + + + + + + + 测量当前控件应该的高度 + + + + + + 整个可用的绘图表面 + + + + + 右边按钮的绘图表面 + + + + + 绘制边框 + + + + + + 绘制背景 + + + + + + 绘制文本 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 当前热点项生改变 + + + + + + + + + + + + + + + + + + + + + 通过外能事件获取用于绘制项的文本 + + + + + + + + + + + + + + + + + + + + + + + + + + 标题 + + + + + 验证失败时是否需要高亮显示（改变背景色） + + + + + + + + + + + + + + + + + + + + + + 排序箭头开始颜色 + + + + + 排序箭头开始颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 控件的背景画布颜色 + 因为控件的边框和过度色都有依靠改变透明度实现渐变，所以一个白色的底版就非常重要 + 使过度色不受控件本身背景色的影响，光不绘制背景不行，要刷上白色背景 + + + + + 控件背景色 + + + + + + + + + + + + + + + 边框颜色 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Represents the visual state of an image list view item. + + + + + 没有任何选择状态，处于一般正常状态 + + + + + 项处于选中状态 + + + + + 该项具有输入焦点 + + + + + 鼠标滑过 + + + + + + + + + + The item is not visible. + + + + + The item is partially visible. + + + + + The item is fully visible. + + + + + 布局方式 + + + + + 标准布局 + + + + + 使项带有描述的布局 + + + + + 双击项事件参数 + + + + + + + + + + + + + + + + 项被删除事件参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 为项绘制带有描述信息的渲染器 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + 默认布局引擎，以类似微软ListView的方式按行排列项 + + + + + 框选的最短开始长度 + + + + + 框选时滚动条的自动滚动速度 + + + + + 用于鼠标框选时，框出了控件中项的显示范围时，自动滚动滚动条 + + + + + 自动滚动时，滚动值 + + + + + 是否处于框选状态中 + + + + + 内框offset，内框offset是绝对相对于滚动条的 + + + + + 整个可显示项的边界的offset，包括上下padding部分 + + + + + 鼠标按下时项区域边界的offset，即 _itemsAreaOffset + 用于框选时，跨越可视部队画框 + + + + + 当前所能显示的最大行数 + + + + + + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + + + + + + + + + + + + + + + + + + + + + 没有任何项 + + + + + 没有任何项处于可显示状态 + + + + + 整个控件区域 + + + + + 整个可用于绘制项的可视区域 + 去除左右Padding部分，去除滚动条 + + + + + 用于绘制项的区域 + 考虑边距间隔大小和滚动条区域 + + + + + 项的尺寸 + 不放在ListView本身中定义而是放在LayoutManager中定义，是因为不同的布局方式 + 可能会是带长宽的Size做为itemSize，比如平铺的方式 + + + + + 项周围的边距 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更新整个布局引擎的状态 + + + + + 判断指定的项是否处于可见状态 + + + + + + + 获取项的呈现区域 + + + + + + + + + + + + + + + + + + + + 获取当前所有可见项 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculates the maximum number of rows and columns + that can be fully displayed. + + + + + 计算当前可见项的index范围 + + + + + 更新滚动条状态 + + + + + 创建框选框 + + + + + + 根据矩形区域选择项 + + + + + + 应用导航键，如上下左右，返回应用导航键之后的项的坐标 + + + + + 使指定下标的项处于可见状态 + + + + + + 默认渲染器，不绘制项的实际内容，但是绘制DEBUG信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 用于子类重写时删除相应的缓存 + + + + + + 绘制项的背景 + + The System.Drawing.Graphics to draw on. + The client coordinates of the item area. + + + + 绘制最终的前景 + + + + + + 绘制选择边框 + + The System.Drawing.Graphics to draw on. + The client coordinates of the selection rectangle. + + + + 绘制项的边框 + + + + + + + + 绘制项 + + + + + + + 绘制项的背景 + + + + + + + 绘制项的内容 + + + + + + + + 绘制背景 + + + + + + 绘制当前所有可见项 + + + + + + Renders the selection rectangle. + + The graphics to draw on. + + + + 默认渲染器，以类似微软ListView的方式按行绘制项，只绘制简单的文本 + + + + + 字的高度是否已初始化 + 在第一次绘制时，测量文本的高度 + + + + + + + + + + + + + + + + + + + + + + + + + 项的背景色 + + + + + 控件背景色 + + + + + 项的边框色 + + + + + 选择框颜色 + + + + + 选择框的边框色 + + + + + 当控件具有焦点时选定项的背景色 + + + + + + + + + + 控件失去焦点时选定项的背景色 + + + + + + + + + + 热点项的背景色 + + + + + + + + + + 图像内边框颜色 + + + + + 图像外边框颜色 + + + + + + + + + + Creates a control with a border. + + + + + Specifies that the control has a border with a sunken edge. + + + + + + + + + + 是否需要在调用 ResumeLayout 时重绘 + + + + + 为项扩展的用于呈现的属性 + + + + + Gets whether the shift key is down. + + + + + Gets whether the control key is down. + + + + + 鼠标左键是否处于按下状态 + + + + + 鼠标右键是否处于按下状态 + + + + + 鼠标最后点击的位置 + + + + + 当前鼠标经过的项 + + + + + + + + + + + + + + + 配色方案 + + + + + 当前布局中项的高度 + + + + + + + + + + 是否没有任何项 + + + + + + + + + + 获取当前具有输入焦点的项 + + + + + 默认的用于呈现为项中文本的Property + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + + 请求在下次调用 ResumeLayout 时重绘 + + + + + 获取当前选中的所有项 + + + + + + + + + + + + 设置扩展属性供特定LayoutEngine使用 + 如果指定的 ExtendMember 已存在，覆盖之 + 用String.Empty 或 null 做为 propertyName传入，表示删除指定的 member + + + + + + + + + + + + + + + + + + + + + 恢复正常的布局逻辑。 + + + + + + + + + + + 临时挂起控件的布局逻辑。 + + + + + + + + + + 获取当前选中项所绑定的对象 + 如果没有选中项，返回null，如果选中多项，返回选中项集合中的第一个 + + + + + + 根据指定的绑定项对象 + 设置当前列表中选定的项 + + + + + + 获取当前选中的所有项的绑定对象集合 + 如果当前没有选中任何项，返回空集合 + + + + + + 取消所有项的选择 + + + + + + + + + + + + + + + + 获取创建控件句柄时所需要的创建参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 更改了选择的项 + + + + + 双击项 + + + + + 项被删除 + + + + + 通过外能事件获取用于绘制项的文本 + + + + + Represents the color palette of the image list view. + + + + + Gets or sets the background color of the ImageListView control. + + + + + Gets or sets the background color of the ImageListViewItem. + + + + + Gets or sets the background color of alternating cells in Details View. + + + + + Gets or sets the border color of the ImageListViewItem. + + + + + Gets or sets the foreground color of the ImageListViewItem. + + + + + Gets or sets the background gradient color1 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color2 of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the border color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the fore color of the ImageListViewItem if the control is not focused. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is hovered. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is hovered. + + + + + Gets or sets the border color of the ImageListViewItem if the item is hovered. + + + + + Gets or sets the color of the insertion caret. + + + + + Gets or sets the background gradient color1 if the ImageListViewItem is selected. + + + + + Gets or sets the background gradient color2 if the ImageListViewItem is selected. + + + + + Gets or sets the border color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the fore color of the ImageListViewItem if the item is selected. + + + + + Gets or sets the background gradient color1 of the column header. + + + + + Gets or sets the background gradient color2 of the column header. + + + + + Gets or sets the background hover gradient color1 of the column header. + + + + + Gets or sets the background hover gradient color2 of the column header. + + + + + Gets or sets the cells foreground color of the column header text. + + + + + Gets or sets the cells background color if column is selected in Details View. + + + + + Gets or sets the color of the separator in Details View. + + + + + Gets or sets the foreground color of the cell text in Details View. + + + + + Gets or sets the foreground color of alternating cells text in Details View. + + + + + Gets or sets the background color of the image pane. + + + + + Gets or sets the separator line color between image pane and thumbnail view. + + + + + Gets or sets the color of labels in pane view. + + + + + Gets or sets the image inner border color for thumbnails and pane. + + + + + Gets or sets the image outer border color for thumbnails and pane. + + + + + Gets or sets the background color1 of the selection rectangle. + + + + + Gets or sets the background color2 of the selection rectangle. + + + + + Gets or sets the color of the selection rectangle border. + + + + + Initializes a new instance of the ImageListViewColor class. + + + + + Initializes a new instance of the ImageListViewColor class + from its string representation. + + String representation of the object. + + + + Copies color values from the given object. + + The source object. + + + + Represents the default color theme. + + + + + Represents the noir color theme. + + + + + Represents the mandarin color theme. + + + + + Sets the color palette to default colors. + + + + + Sets the color palette to mandarin colors. + + + + + Sets the color palette to noir colors. + + + + + Determines whether all color values of the specified + ImageListViewColor are equal to this instance. + + The object to compare with this instance. + true if the two instances have the same color values; + otherwise false. + + + + Returns a hash code for this instance. + + + A hash code for this instance, suitable for use in + hashing algorithms and data structures like a hash table. + + + + + Returns a string that represents this instance. + + + A string that represents this instance. + + + + + 测试坐标 + + + + + 项的坐标 + + + + + 是否点击了项 + + + + + + + + + + + + + + + + + + + + + + 该项当前的选中状态 + + + + + + + + + + + + + + + + + + + + 所绑定的对象 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 将指定的事件移动到(紧邻)另一个事件之前 + + + + + + + 将指定的事件移动到(紧邻)另一个事件之后 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Modify a WinForms TreeView control to use the new Explorer style theme + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + WM_COPYDATA消息所要求的数据结构 + + + + + + + + + + + + + + + + + + + + + + + + + 通过窗口的标题来查找窗口的句柄 + + + + + + + + 发送 Windows 消息 + + + + + + + + + + 还原 + + + + + 移动 + + + + + 大小 + + + + + 最小化 + + + + + 最大化 + + + + + 关闭 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 发送消息，只能传递一个自定义的消息ID和消息字符串，想传一个结构，但没成功 + + 目标进程名称，如果有多个，则给每个都发送 + 自定义数据，可以通过这个来决定如何解析下面的strMsg + 传递的消息，是一个字符串 + + + + 接收消息，得到消息字符串 + + System.Windows.Forms.Message m + 接收到的消息字符串 + + + + + + + + + 最大圆角半径 + + + + + 最小矩形边长，用于自动处理圆角大小 + + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + 圆角的半径长度 + + + + 绘制一个圆角矩形. + + 当前屏幕的图形对象 + 画笔 + 要绘制的矩形对象 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 矩形左上角X坐标 + 矩形左上角Y坐标 + 矩形右下角X坐标 + 矩形右下角Y坐标 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + 填充区域针对矩形的缩进距离 + 圆角的半径长度 + + + + 填充一个圆角矩形. + + 当前屏幕的图形对象 + 笔刷 + 要填充的矩形 + + + + 使图片单色化 + + + + + + + 获取颜色 + + + + + + + + + + + + + 颜色变化时激发 + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + The top left rectangle in auto hide strip area. + + + + + The top right rectangle in auto hide strip area. + + + + + The bottom left rectangle in auto hide strip area. + + + + + The bottom right rectangle in auto hide strip area. + + + + + Gets one of the four auto hide strip rectangles. + + Dock state. + The desired rectangle. + + As the corners are represented by , , , and , + the four strips can be easily calculated out as the borders. + + + + + Context menu. + + + This property should be obsolete as it does not support theming. Please use instead. + + + + + Context menu strip. + + + + + Overridden to avoid resize issues with nested controls + + + http://blogs.msdn.com/b/alejacma/archive/2008/11/20/controls-won-t-get-resized-once-the-nesting-hierarchy-of-windows-exceeds-a-certain-depth-x64.aspx + http://support.microsoft.com/kb/953934 + + + + + Determines whether the close button is visible on the content + + + + + There's a bug in the WinForms layout engine + that can result in a deferred layout to not + properly clear out the cached layout args after + the layout operation is performed. + Specifically, this bug is hit when the bounds of + the Pane change, initiating a layout on the parent + (DockWindow) which is where the bug hits. + To work around it, when a pane loses the DockWindow + as its parent, that parent DockWindow needs to + perform a layout to flush the cached args, if they exist. + + + + + Gets a value indicating whether dock panel can be dragged when in auto hide mode. + Default is false. + + + + + Determines the color with which the client rectangle will be drawn. + If this property is used instead of the BackColor it will not have any influence on the borders to the surrounding controls (DockPane). + The BackColor property changes the borders of surrounding controls (DockPane). + Alternatively both properties may be used (BackColor to draw and define the color of the borders and DockBackColor to define the color of the client rectangle). + For Backgroundimages: Set your prefered Image, then set the DockBackColor and the BackColor to the same Color (Control) + + + + + Dock area. + + + This is the center rectangle of control. + + Excluded spaces are for the following visual elements, + * Auto hide strips on four sides. + * Necessary paddings defined in themes. + + Therefore, all dock contents mainly fall into this area (except auto hide window, which might slightly move beyond this area). + + + + + Flag to show autohide content on mouse hover. Default value is true. + + + This flag is ignored in VS2012/2013 themes. Such themes assume it is always false. + + + + + DragHandlerBase is the base class for drag handlers. The derived class should: + 1. Define its public method BeginDrag. From within this public BeginDrag method, + DragHandlerBase.BeginDrag should be called to initialize the mouse capture + and message filtering. + 2. Override the OnDragging and OnEndDrag methods. + + + + + Loads layout from XML file. + + The file name. + Deserialization handler. + Deserialization might throw exceptions. + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + Deserialization might throw exceptions. + + The stream is closed after deserialization. + + + + + Loads layout from a stream. + + The stream. + Deserialization handler. + The flag to close the stream after deserialization. + Deserialization might throw exceptions. + + + + Deserialization handler of layout file/stream. + + Strings stored in layout file/stream. + Dock content deserialized from layout/stream. + + The deserialization handler method should handle all possible exceptions. + + If any exception happens during deserialization and is not handled, the program might crash or experience other issues. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The skin to use when displaying the DockPanel. + The skin allows custom gradient color schemes to be used when drawing the + DockStrips and Tabs. + + + + + The skin used to display the auto hide strips and tabs. + + + + + The skin used to display the Document and ToolWindow style DockStrips and Tabs. + + + + + The skin used to display the auto hide strip and tabs. + + + + + The gradient color skin for the DockStrips. + + + + + The gradient color skin for the Tabs. + + + + + The gradient color skin for the Tabs. + + + + + Font used in AutoHideStrip elements. + + + + + The skin used to display the document and tool strips and tabs. + + + + + The skin used to display the Document style DockPane strip and tab. + + + + + The skin used to display the ToolWindow style DockPane strip and tab. + + + + + Font used in DockPaneStrip elements. + + + + + The skin used to display the DockPane ToolWindow strip and tab. + + + + + The skin used to display the active ToolWindow caption. + + + + + The skin used to display the inactive ToolWindow caption. + + + + + The skin used to display the DockPane strip and tab. + + + + + The gradient color skin for the DockStrip. + + + + + The skin used to display the active DockPane tabs. + + + + + The skin used to display the inactive DockPane tabs. + + + + + The skin used to display the dock pane tab + + + + + The text color. + + + + + The skin used to display the dock pane tab + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient color skin. + + + + + The beginning gradient color. + + + + + The ending gradient color. + + + + + The gradient mode to display the colors. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Dock window base class. + + + + + Dock window of Visual Studio 2003/2005 theme. + + + + + The location to draw the DockPaneStrip for Document style windows. + + + + + + + + + + + + + + + Gets images for tabs and captions. + + + + + + + + + + Gets images for docking indicators. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Switches a pane with its first child in the pane hierarchy. (The actual hiding happens elsewhere.) + + Pane to switch + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Required designer variable. + + + + + Clean up any resources being used. + + true if managed resources should be disposed; otherwise, false. + + + + Required method for Designer support - do not modify + the contents of this method with the code editor. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Determines whether the close button is visible on the content + + + + + Calculate which tabs are displayed and in what order. + + + + + Visual Studio 2005 theme (default theme). + + + + + + + + + + X for this inside the logical strip rectangle. + + + + + Width of this . + + + + + Dock window of Visual Studio 2012 Light theme. + + + + + Initializes a new instance of the class. + + The dock panel. + State of the dock. + + + + Determines whether the close button is visible on the content + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculate which tabs are displayed and in what order. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 Light theme. + + + + + + + + + + Visual Studio 2015 theme base. + + + + + + + + + + + + + + + + diff --git a/Bin/Release/CommonControls/.NET4/RyPrint.dll b/Bin/Release/CommonControls/.NET4/RyPrint.dll deleted file mode 100644 index d08761b..0000000 Binary files a/Bin/Release/CommonControls/.NET4/RyPrint.dll and /dev/null differ diff --git a/Bin/Release/CommonControls/.NET4/RyWeb.xml b/Bin/Release/CommonControls/.NET4/RyWeb.xml deleted file mode 100644 index 0f17d55..0000000 --- a/Bin/Release/CommonControls/.NET4/RyWeb.xml +++ /dev/null @@ -1,603 +0,0 @@ - - - - RyWeb - - - - - Http连接操作帮助类 - - - - - - - - - - - - 根据相传入的数据，得到相应页面数据 - - 参数类对象 - 返回HttpResult类型 - - - - 获取数据的并解析的方法 - - - - - - - 设置编码 - - HttpItem - HttpResult - byte[] - - - - 提取网页Byte - - - - - - 为请求准备参数 - - 参数列表 - - - - 设置证书 - - - - - - 设置多个证书 - - - - - - 设置Cookie - - Http参数 - - - - 设置Post数据 - - Http参数 - - - - 设置代理 - - 参数对象 - - - - 回调验证证书问题 - - 流对象 - 证书 - X509Chain - SslPolicyErrors - bool - - - - 通过设置这个属性，可以在发出连接的时候绑定客户端发出连接所使用的IP地址。 - - - - - - - - - Http请求参考类 - - - - - 请求URL必须填写 - - - - - 请求方式默认为GET方式,当为POST方式时必须设置Postdata的值 - - - - - 默认请求超时时间 - - - - - 默认写入Post数据超时间 - - - - - 设置Host的标头信息 - - - - - 获取或设置一个值，该值指示是否与 Internet 资源建立持久性连接默认为true。 - - - - - 请求标头值 默认为text/html, application/xhtml+xml, */* - - - - - 请求返回类型默认 text/html - - - - - 客户端访问信息默认Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0) - - - - - 返回数据编码默认为NUll,可以自动识别,一般为utf-8,gbk,gb2312 - - - - - Post的数据类型 - - - - - Post请求时要发送的字符串Post数据 - - - - - Post请求时要发送的Byte类型的Post数据 - - - - - Cookie对象集合 - - - - - 请求时的Cookie - - - - - 来源地址，上次访问地址 - - - - - 证书绝对路径 - - - - - 设置代理对象，不想使用IE默认配置就设置为Null，而且不要设置ProxyIp - - - - - 是否设置为全文小写，默认为不转化 - - - - - 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 - - - - - 最大连接数 - - - - - 代理Proxy 服务器用户名 - - - - - 代理 服务器密码 - - - - - 代理 服务IP,如果要使用IE代理就设置为ieproxy - - - - - 设置返回类型String和Byte - - - - - header对象 - - - - - 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 - - - - - 获取或设置一个 System.Boolean 值，该值确定是否使用 100-Continue 行为。如果 POST 请求需要 100-Continue 响应，则为 true；否则为 false。默认值为 true。 - - - - - 设置509证书集合 - - - - - 设置或获取Post参数编码,默认的为Default编码 - - - - - Cookie返回类型,默认的是只返回字符串类型 - - - - - 获取或设置请求的身份验证信息。 - - - - - 设置请求将跟随的重定向的最大数目 - - - - - 获取和设置IfModifiedSince，默认为当前日期和时间 - - - - - 设置本地的出口ip和端口 - ] - - item.IPEndPoint = new IPEndPoint(IPAddress.Parse("192.168.1.1"),80); - - - - - Http返回参数类 - - - - - Http请求返回的Cookie - - - - - Cookie对象集合 - - - - - 返回的String类型数据 只有ResultType.String时才返回数据，其它情况为空 - - - - - 返回的Byte数组 只有ResultType.Byte时才返回数据，其它情况为空 - - - - - header对象 - - - - - 返回状态说明 - - - - - 返回状态码,默认为OK - - - - - 最后访问的URl - - - - - 获取重定向的URl - - - - - 返回类型 - - - - - 表示只返回字符串 只有Html有数据 - - - - - 表示返回字符串和字节流 ResultByte和Html都有数据返回 - - - - - Post的数据格式默认为string - - - - - 字符串类型，这时编码Encoding可不设置 - - - - - Byte类型，需要设置PostdataByte参数的值编码Encoding可设置为空 - - - - - 传文件，Postdata必须设置为文件的绝对路径，必须设置Encoding的值 - - - - - Cookie返回类型 - - - - - 只返回字符串类型的Cookie - - - - - CookieCollection格式的Cookie集合同时也返回String类型的cookie - - - - - - - - - - 以post方式获取网页源码 - - - - - - - - - 以post方式提交json内容 - - - - - - - - - 以post方式提交json内容 - - - - - - - - 以post方式获取网页源码 - - - - - - - - - - 以post方式获取网页源码 - - - - - - - - 获取网址对应的文件大小 - - - - - - - - - - - - 获取网页源码 - - - - - - - - 获取网页源码 - - - - - - - - - 获取网页源码 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 将相对网址转换成绝对网址 - - 相对网址 - 当前页面地址 - 转换后的绝对网址 - - - - - - - - - - - - - - url解密 - - - - - - - - url解密,按UTF8方式解密 - - - - - - - Url加密 - - - - - - - - Url加密,按UTF8方式加密 - - - - - - - 解密 - - - - - - - 加密 - - - - - - - - - - - - - - - - - - - - - - - - - url加密,Unicode - - - - - - - - - - - - - - - - - - - - - - Html解码,将html里未转义成功的重新转义。 - - - - - - diff --git a/Bin/Release/CommonControls/.NET4/ryControls.dll b/Bin/Release/CommonControls/.NET4/ryControls.dll deleted file mode 100644 index c4cf250..0000000 Binary files a/Bin/Release/CommonControls/.NET4/ryControls.dll and /dev/null differ diff --git a/Bin/Release/CommonControls/.NET4/ryUpdate.dll b/Bin/Release/CommonControls/.NET4/ryUpdate.dll deleted file mode 100644 index adf37b2..0000000 Binary files a/Bin/Release/CommonControls/.NET4/ryUpdate.dll and /dev/null differ diff --git a/Bin/Release/CommonControls/.NET4/ryUpdate.xml b/Bin/Release/CommonControls/.NET4/ryUpdate.xml deleted file mode 100644 index 72b168c..0000000 --- a/Bin/Release/CommonControls/.NET4/ryUpdate.xml +++ /dev/null @@ -1,489 +0,0 @@ - - - - ryUpdate - - - - - - - - - - 升级地址 - - - - - - - - - - 隔多久后再次检查更新 - - - - - 本地保存的配置信息 - - - - - 当前安装的软件版本 - - - - - 当前安装的软件修正版本 - - - - - 当前安装的数据库版本 - - - - - - - - - - - - - - - - - - - - 获取当前更新的类型 - - - - - 每隔n小时检测一次更新 - - - - - 读取版本信息完成后激发 - - - - - 没有版本更新时激发 - - - - - 发现新版本时激发 - - - - - 发生错误后激发 - - - - - 更新进度变化后激发 - - - - - 开始检测新版本 - - - - - - - - - - 初始化升级函数 - - 为null,则表示事件运行在多线程模式下，否则,事件是在窗体所在线程下 - - - - - - - - - - - - - - 获取版本信息 - - - - - 开始下载 - - - - - 开始下载 - - - - - 下载,不使用多线程 - - - - - 结束下载 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 当前登陆用户 - - - - - - - - - - 没有版本更新时激发 - - - - - - - - - - - 取消更新。 - - - - - - - - - - - - - - - - - - - - 设置升级 - - - - - 是否是在线更新 - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - - - - - - - 提示文本 - - - - - 更新日期 - - - - - 更新版本 - - - - - 更新描述 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Required designer variable. - - - - - Clean up any resources being used. - - true if managed resources should be disposed; otherwise, false. - - - - Required method for Designer support - do not modify - the contents of this method with the code editor. - - - - - - - - - - 更新类型,soft或者data - - - - - 更新描述Url - - - - - 更新描述 - - - - - 版本 - - - - - 更新日期 - - - - - 更新地址 - - - - - 在下载升级包前首先要下载的内容 - - - - - 升级程序要使用的设置xml - - - - - - - - - - 错误字符串 - - - - - 错误id - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 一个强类型的资源类，用于查找本地化的字符串等。 - - - - - 返回此类使用的缓存的 ResourceManager 实例。 - - - - - 重写当前线程的 CurrentUICulture 属性，对 - 使用此强类型资源类的所有资源查找执行重写。 - - - - diff --git a/CHANGELOG.md b/CHANGELOG.md index 29476de..286dc16 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,23 @@ -### 2022-05-26更新 +### 2023-11-07更新 + +------ + +#### RaUIV4 V4.0.2311.0701 + +- *.[全新]整合了MyDb、ryControls、MyDb_MySQL等dll文件到RaUI一个项目。 +- *.[新增]新增ApkOp类,可以轻松获取APK信息。 +- *.[新增]新增JsonExt扩展类,让Json操作更简单。 +- *.[新增]新增WebP类,可以支持webp格式的图片。 +- *.[改进]ryQuickSQL中的AddField方法改为自动替换已存在的同名值。 +- *.[修复]ryQuickSQL中的AddFieldCalc方法无法正常计算的BUG。 + +### 2022-12-06更新 + +------ +#### MyDbV4 V3.0.2212.0601 +- *.[新增]全新的RyImage类，聚合了各种图片操作函数(包括裁剪和水印功能)。 + +### 2022-05-26更新 ------ #### MyDbV4 V3.0.2205.2601 - *.[新增]新增BigFileOp类,支持对大文件和批量文件操作处理。 diff --git a/Source/AnalysisReport.sarif b/Source/AnalysisReport.sarif new file mode 100644 index 0000000..df7e93f --- /dev/null +++ b/Source/AnalysisReport.sarif @@ -0,0 +1,703 @@ +{ + "$schema": "https://schemastore.azurewebsites.net/schemas/json/sarif-2.1.0-rtm.5.json", + "version": "2.1.0", + "runs": [ + { + "tool": { + "driver": { + "name": "Dependency Analysis", + "semanticVersion": "0.4.421302", + "informationUri": "https://docs.microsoft.com/en-us/dotnet/core/porting/upgrade-assistant-overview", + "rules": [ + { + "id": "UA106", + "name": "PackageToBeAdded", + "fullDescription": { + "text": "Packages that need to be added in order to upgrade the project to chosen TFM" + }, + "helpUri": "https://docs.microsoft.com/en-us/dotnet/core/porting/upgrade-assistant-overview" + }, + { + "id": "UA103", + "name": "ReferenceToBeDeleted", + "fullDescription": { + "text": "References that need to be deleted in order to upgrade the project to chosen TFM" + }, + "helpUri": "https://docs.microsoft.com/en-us/dotnet/core/porting/upgrade-assistant-overview" + }, + { + "id": "UA108", + "name": "FrameworkReferenceToBeAdded", + "fullDescription": { + "text": "Framework Reference that need to be added in order to upgrade the project to chosen TFM" + }, + "helpUri": "https://docs.microsoft.com/en-us/dotnet/core/porting/upgrade-assistant-overview" + } + ] + } + }, + "results": [ + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers, Version=0.4.421302 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project/Itrycn_Project.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.Windows.Compatibility, Version=7.0.1 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project/Itrycn_Project.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers, Version=0.4.421302 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RyPrint/RyPrint.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.Windows.Compatibility, Version=7.0.1 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RyPrint/RyPrint.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA103", + "level": "note", + "message": { + "text": "Reference to System.Configuration needs to be deleted." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project2/Itrycn_Project2.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA103", + "level": "note", + "message": { + "text": "Reference to System.Web needs to be deleted." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project2/Itrycn_Project2.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package System.Configuration.ConfigurationManager, Version=5.0.0 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project2/Itrycn_Project2.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers, Version=0.4.421302 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project2/Itrycn_Project2.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.Windows.Compatibility, Version=7.0.1 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project2/Itrycn_Project2.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA108", + "level": "note", + "message": { + "text": "Framework Reference to Microsoft.AspNetCore.App needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project2/Itrycn_Project2.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers, Version=0.4.421302 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/SkinPreview/SkinPreview.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.Windows.Compatibility, Version=7.0.1 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/SkinPreview/SkinPreview.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA103", + "level": "note", + "message": { + "text": "Reference to System.Configuration needs to be deleted." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/RaUIV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA103", + "level": "note", + "message": { + "text": "Reference to System.Web needs to be deleted." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/RaUIV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package System.Configuration.ConfigurationManager, Version=5.0.0 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/RaUIV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers, Version=0.4.421302 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/RaUIV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.Windows.Compatibility, Version=7.0.1 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/RaUIV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA108", + "level": "note", + "message": { + "text": "Framework Reference to Microsoft.AspNetCore.App needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/RaUIV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA103", + "level": "note", + "message": { + "text": "Reference to System.Web needs to be deleted." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/MyDb/MyDbV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers, Version=0.4.421302 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/MyDb/MyDbV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA106", + "level": "note", + "message": { + "text": "Package Microsoft.Windows.Compatibility, Version=7.0.1 needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/MyDb/MyDbV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA108", + "level": "note", + "message": { + "text": "Framework Reference to Microsoft.AspNetCore.App needs to be added." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/MyDb/MyDbV4.csproj" + }, + "region": {} + } + } + ] + } + ], + "columnKind": "utf16CodeUnits" + }, + { + "tool": { + "driver": { + "name": "API Upgradability", + "semanticVersion": "0.4.421302", + "informationUri": "https://docs.microsoft.com/en-us/dotnet/core/porting/upgrade-assistant-overview", + "rules": [ + { + "id": "UA0013_L", + "name": "Replace usage of System.Windows.Forms.ContextMenu", + "fullDescription": { + "text": "Replace usage of System.Windows.Forms.ContextMenu" + } + }, + { + "id": "UA0013_M", + "name": "Replace usage of System.Windows.Forms.GridColumnStylesCollection, System.Windows.Forms.GridTablesFactory, System.Windows.Forms.GridTableStylesCollection, System.Windows.Forms.IDataGridEditingService, System.Windows.Forms.DataGrid, System.Windows.Forms.DataGrid.HitTestType, System.Windows.Forms.DataGridBoolColumn, System.Windows.Forms.DataGridCell, System.Windows.Forms.DataGridColumnStyle, System.Windows.Forms.DataGridLineStyle, System.Windows.Forms.DataGridParentRowsLabelStyle, System.Windows.Forms.DataGridPreferredColumnWidthTypeConverter, System.Windows.Forms.DataGridTableStyle, System.Windows.Forms.DataGridTextBox, System.Windows.Forms.DataGridTextBoxColumn", + "fullDescription": { + "text": "Replace usage of System.Windows.Forms.GridColumnStylesCollection, System.Windows.Forms.GridTablesFactory, System.Windows.Forms.GridTableStylesCollection, System.Windows.Forms.IDataGridEditingService, System.Windows.Forms.DataGrid, System.Windows.Forms.DataGrid.HitTestType, System.Windows.Forms.DataGridBoolColumn, System.Windows.Forms.DataGridCell, System.Windows.Forms.DataGridColumnStyle, System.Windows.Forms.DataGridLineStyle, System.Windows.Forms.DataGridParentRowsLabelStyle, System.Windows.Forms.DataGridPreferredColumnWidthTypeConverter, System.Windows.Forms.DataGridTableStyle, System.Windows.Forms.DataGridTextBox, System.Windows.Forms.DataGridTextBoxColumn" + } + } + ] + } + }, + "results": [ + { + "ruleId": "UA0013_L", + "level": "note", + "message": { + "text": "Windows Forms Deprecated controls : ContextMenu needs to be replaced with ContextMenuStrip. For more details see - https://docs.microsoft.com/en-us/dotnet/core/compatibility/winforms#removed-controls" + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/UI/WeifenLuo.WinFormsUI/Docking/DockContent.cs" + }, + "region": { + "startLine": 205 + } + } + } + ] + }, + { + "ruleId": "UA0013_M", + "level": "note", + "message": { + "text": "Windows Forms Deprecated controls : DataGrid needs to be replaced with DataGridView. For more details see - https://docs.microsoft.com/en-us/dotnet/core/compatibility/winforms#removed-controls" + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/UI/ObjectListView/DataListView.cs" + }, + "region": { + "startLine": 66 + } + } + } + ] + }, + { + "ruleId": "UA0013_L", + "level": "note", + "message": { + "text": "Windows Forms Deprecated controls : ContextMenu needs to be replaced with ContextMenuStrip. For more details see - https://docs.microsoft.com/en-us/dotnet/core/compatibility/winforms#removed-controls" + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/UI/WeifenLuo.WinFormsUI/Docking/DockContentHandler.cs" + }, + "region": { + "startLine": 724 + } + } + } + ] + }, + { + "ruleId": "UA0013_L", + "level": "note", + "message": { + "text": "Windows Forms Deprecated controls : ContextMenu needs to be replaced with ContextMenuStrip. For more details see - https://docs.microsoft.com/en-us/dotnet/core/compatibility/winforms#removed-controls" + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/UI/WeifenLuo.WinFormsUI/Docking/DockPane.cs" + }, + "region": { + "startLine": 282 + } + } + } + ] + } + ], + "columnKind": "utf16CodeUnits" + }, + { + "tool": { + "driver": { + "name": "Component Analysis", + "semanticVersion": "0.4.421302", + "informationUri": "https://docs.microsoft.com/en-us/dotnet/core/porting/upgrade-assistant-overview", + "rules": [ + { + "id": "UA209", + "name": "Microsoft.DotNet.UpgradeAssistant.Extensions.Windows.WinformsDefaultFontUpdater", + "fullDescription": { + "text": "Default Font API Alert" + } + }, + { + "id": "UA202", + "name": "Microsoft.DotNet.UpgradeAssistant.Extensions.Windows.WinformsDpiSettingUpdater", + "fullDescription": { + "text": "Winforms Source Updater" + } + } + ] + } + }, + "results": [ + { + "ruleId": "UA209", + "level": "note", + "message": { + "text": "Default font in Windows Forms has been changed from Microsoft Sans Serif to Segoe UI, in order to change the default font use the API - Application.SetDefaultFont(Font font). For more details see here - https://devblogs.microsoft.com/dotnet/whats-new-in-windows-forms-in-net-6-0-preview-5/#application-wide-default-font." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project/Itrycn_Project.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA209", + "level": "note", + "message": { + "text": "Default font in Windows Forms has been changed from Microsoft Sans Serif to Segoe UI, in order to change the default font use the API - Application.SetDefaultFont(Font font). For more details see here - https://devblogs.microsoft.com/dotnet/whats-new-in-windows-forms-in-net-6-0-preview-5/#application-wide-default-font." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RyPrint/RyPrint.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA209", + "level": "note", + "message": { + "text": "Default font in Windows Forms has been changed from Microsoft Sans Serif to Segoe UI, in order to change the default font use the API - Application.SetDefaultFont(Font font). For more details see here - https://devblogs.microsoft.com/dotnet/whats-new-in-windows-forms-in-net-6-0-preview-5/#application-wide-default-font." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project2/Itrycn_Project2.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA209", + "level": "note", + "message": { + "text": "Default font in Windows Forms has been changed from Microsoft Sans Serif to Segoe UI, in order to change the default font use the API - Application.SetDefaultFont(Font font). For more details see here - https://devblogs.microsoft.com/dotnet/whats-new-in-windows-forms-in-net-6-0-preview-5/#application-wide-default-font." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/SkinPreview/SkinPreview.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA209", + "level": "note", + "message": { + "text": "Default font in Windows Forms has been changed from Microsoft Sans Serif to Segoe UI, in order to change the default font use the API - Application.SetDefaultFont(Font font). For more details see here - https://devblogs.microsoft.com/dotnet/whats-new-in-windows-forms-in-net-6-0-preview-5/#application-wide-default-font." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/RaUI/RaUIV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA209", + "level": "note", + "message": { + "text": "Default font in Windows Forms has been changed from Microsoft Sans Serif to Segoe UI, in order to change the default font use the API - Application.SetDefaultFont(Font font). For more details see here - https://devblogs.microsoft.com/dotnet/whats-new-in-windows-forms-in-net-6-0-preview-5/#application-wide-default-font." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/MyDb/MyDbV4.csproj" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA202", + "level": "note", + "message": { + "text": "HighDpiMode needs to set in Main() instead of app.config or app.manifest - Application.SetHighDpiMode(HighDpiMode.). It is recommended to use SystemAware as the HighDpiMode option for better results." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project/Program.cs" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA202", + "level": "note", + "message": { + "text": "HighDpiMode needs to set in Main() instead of app.config or app.manifest - Application.SetHighDpiMode(HighDpiMode.). It is recommended to use SystemAware as the HighDpiMode option for better results." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/Itrycn_Project2/Program.cs" + }, + "region": {} + } + } + ] + }, + { + "ruleId": "UA202", + "level": "note", + "message": { + "text": "HighDpiMode needs to set in Main() instead of app.config or app.manifest - Application.SetHighDpiMode(HighDpiMode.). It is recommended to use SystemAware as the HighDpiMode option for better results." + }, + "locations": [ + { + "physicalLocation": { + "artifactLocation": { + "uri": "file:///E:/My%20Datas/%E6%AF%95%E6%96%B9%E9%A1%B9%E7%9B%AE/C%23/%E7%9D%BF%E5%85%83%E5%85%AC%E7%94%A8%E6%8E%A7%E4%BB%B6%E7%BB%84/Source/SkinPreview/Program.cs" + }, + "region": {} + } + } + ] + } + ], + "columnKind": "utf16CodeUnits" + } + ] +} \ No newline at end of file diff --git a/Source/Itrycn_Project/Itrycn_Project.csproj b/Source/Itrycn_Project/Itrycn_Project.csproj index ca0d5ec..00184f0 100644 --- a/Source/Itrycn_Project/Itrycn_Project.csproj +++ b/Source/Itrycn_Project/Itrycn_Project.csproj @@ -8,7 +8,7 @@ WinExe Itrycn_Project Itrycn_Project - v4.0 + v4.5.2 512 publish\ true @@ -25,6 +25,7 @@ false false true + x86 @@ -35,6 +36,7 @@ DEBUG;TRACE prompt 4 + false x86 @@ -44,11 +46,9 @@ TRACE prompt 4 + false - - ..\..\Bin\Debug\CommonControls\.NET4\RyWeb.dll - @@ -141,6 +141,7 @@ Resources.resx True + SettingsSingleFileGenerator Settings.Designer.cs @@ -157,28 +158,6 @@ - - - {9df20d86-a56e-4cf6-a3d8-f30421297b1b} - MyDbV4 - - - {6b969ce8-d723-4b2c-a8fd-fad2fb28ff01} - MyDb_SQLiteV4 - - - {9eca3a84-8545-4c4d-84d6-d23e3bdf2d90} - ryControlsV4 - - - {B6784652-825A-482C-8A21-08E2539AF2BF} - RyPrint - - - {11a63e24-0257-4c54-a109-f1a609a52a62} - ryUpdateV4 - - False diff --git a/Source/Itrycn_Project/Properties/Resources.Designer.cs b/Source/Itrycn_Project/Properties/Resources.Designer.cs index 287b148..4c58606 100644 --- a/Source/Itrycn_Project/Properties/Resources.Designer.cs +++ b/Source/Itrycn_Project/Properties/Resources.Designer.cs @@ -8,7 +8,7 @@ // //------------------------------------------------------------------------------ -namespace Itrycn_Project2.Properties { +namespace Itrycn_Project.Properties { using System; @@ -19,7 +19,7 @@ namespace Itrycn_Project2.Properties { // 类通过类似于 ResGen 或 Visual Studio 的工具自动生成的。 // 若要添加或移除成员，请编辑 .ResX 文件，然后重新运行 ResGen // (以 /str 作为命令选项)，或重新生成 VS 项目。 - [global::System.CodeDom.Compiler.GeneratedCodeAttribute("System.Resources.Tools.StronglyTypedResourceBuilder", "4.0.0.0")] + [global::System.CodeDom.Compiler.GeneratedCodeAttribute("System.Resources.Tools.StronglyTypedResourceBuilder", "17.0.0.0")] [global::System.Diagnostics.DebuggerNonUserCodeAttribute()] [global::System.Runtime.CompilerServices.CompilerGeneratedAttribute()] internal class Resources { @@ -47,8 +47,8 @@ namespace Itrycn_Project2.Properties { } /// - /// 使用此强类型资源类，为所有资源查找 - /// 重写当前线程的 CurrentUICulture 属性。 + /// 重写当前线程的 CurrentUICulture 属性，对 + /// 使用此强类型资源类的所有资源查找执行重写。 /// [global::System.ComponentModel.EditorBrowsableAttribute(global::System.ComponentModel.EditorBrowsableState.Advanced)] internal static global::System.Globalization.CultureInfo Culture { diff --git a/Source/Itrycn_Project/Properties/Settings.Designer.cs b/Source/Itrycn_Project/Properties/Settings.Designer.cs index 3e3d9ad..c4b6188 100644 --- a/Source/Itrycn_Project/Properties/Settings.Designer.cs +++ b/Source/Itrycn_Project/Properties/Settings.Designer.cs @@ -1,28 +1,24 @@ //------------------------------------------------------------------------------ // -// This code was generated by a tool. -// Runtime Version:4.0.30319.42000 +// 此代码由工具生成。 +// 运行时版本:4.0.30319.42000 // -// Changes to this file may cause incorrect behavior and will be lost if -// the code is regenerated. +// 对此文件的更改可能会导致不正确的行为，并且如果 +// 重新生成代码，这些更改将会丢失。 // //------------------------------------------------------------------------------ -namespace Itrycn_Project2.Properties -{ - - +namespace Itrycn_Project.Properties { + + [global::System.Runtime.CompilerServices.CompilerGeneratedAttribute()] - [global::System.CodeDom.Compiler.GeneratedCodeAttribute("Microsoft.VisualStudio.Editors.SettingsDesigner.SettingsSingleFileGenerator", "11.0.0.0")] - internal sealed partial class Settings : global::System.Configuration.ApplicationSettingsBase - { - + [global::System.CodeDom.Compiler.GeneratedCodeAttribute("Microsoft.VisualStudio.Editors.SettingsDesigner.SettingsSingleFileGenerator", "17.5.0.0")] + internal sealed partial class Settings : global::System.Configuration.ApplicationSettingsBase { + private static Settings defaultInstance = ((Settings)(global::System.Configuration.ApplicationSettingsBase.Synchronized(new Settings()))); - - public static Settings Default - { - get - { + + public static Settings Default { + get { return defaultInstance; } } diff --git a/Source/Itrycn_Project/app.config b/Source/Itrycn_Project/app.config new file mode 100644 index 0000000..ff99501 --- /dev/null +++ b/Source/Itrycn_Project/app.config @@ -0,0 +1,3 @@ + + + diff --git a/Source/Itrycn_Project/frmmain.Designer.cs b/Source/Itrycn_Project/frmmain.Designer.cs index 17215d5..83d8cb8 100644 --- a/Source/Itrycn_Project/frmmain.Designer.cs +++ b/Source/Itrycn_Project/frmmain.Designer.cs @@ -113,7 +113,7 @@ // picExpand // this.picExpand.Cursor = System.Windows.Forms.Cursors.Hand; - this.picExpand.Image = global::Itrycn_Project2.Properties.Resources.closetree; + this.picExpand.Image = global::Itrycn_Project.Properties.Resources.closetree; this.picExpand.Location = new System.Drawing.Point(187, 247); this.picExpand.Name = "picExpand"; this.picExpand.Size = new System.Drawing.Size(10, 49); @@ -362,8 +362,7 @@ // this.chinaCalendar1.BackColor = System.Drawing.Color.White; this.chinaCalendar1.DateTime = new System.DateTime(2019, 2, 9, 10, 54, 20, 495); - this.chinaCalendar1.HolidayFolder = "E:\\Program Files (x86)\\Microsoft Visual Studio\\2017\\Enterprise\\Common7\\IDE\\SysDb\\" + - "Holidays"; + this.chinaCalendar1.HolidayFolder = ".\\SysDb\\Holidays"; this.chinaCalendar1.Location = new System.Drawing.Point(261, 133); this.chinaCalendar1.Name = "chinaCalendar1"; this.chinaCalendar1.Size = new System.Drawing.Size(851, 509); diff --git a/Source/Itrycn_Project/frmmain.cs b/Source/Itrycn_Project/frmmain.cs index 7b6f04a..bfcdd45 100644 --- a/Source/Itrycn_Project/frmmain.cs +++ b/Source/Itrycn_Project/frmmain.cs @@ -1,276 +1,276 @@ -using Itrycn_Project2; -using ryCommon; -using System; -using System.Collections.Generic; -using System.ComponentModel; -using System.Data; -using System.Drawing; -using System.Linq; -using System.Reflection; -using System.Text; -using System.Windows.Forms; - -namespace Itrycn -{ - public partial class Frmmain : Form - { - readonly string[] prog_args; - public Frmmain(string[] args) - { - InitializeComponent(); - prog_args = args; - } - public TreeNode AddToTreeView(TreeNode parent, Type id, string text, string imageKey) - { - return AddToTreeView(parent, id, text, imageKey, ""); - } - public TreeNode AddToTreeView(TreeNode parent, Type id, string text, string imageKey, string ToolTipText) - { - TreeNode btn = new TreeNode() - { - SelectedImageKey = "selected.ico", - ImageKey = imageKey, - Text = text, - Tag = id, - ToolTipText = ToolTipText - }; - parent.Nodes.Add(btn); - return btn; +using Itrycn_Project2; +using ryCommon; +using System; +using System.Collections.Generic; +using System.ComponentModel; +using System.Data; +using System.Drawing; +using System.Linq; +using System.Reflection; +using System.Text; +using System.Windows.Forms; + +namespace Itrycn +{ + public partial class Frmmain : Form + { + readonly string[] prog_args; + public Frmmain(string[] args) + { + InitializeComponent(); + prog_args = args; + } + public TreeNode AddToTreeView(TreeNode parent, Type id, string text, string imageKey) + { + return AddToTreeView(parent, id, text, imageKey, ""); + } + public TreeNode AddToTreeView(TreeNode parent, Type id, string text, string imageKey, string ToolTipText) + { + TreeNode btn = new TreeNode() + { + SelectedImageKey = "selected.ico", + ImageKey = imageKey, + Text = text, + Tag = id, + ToolTipText = ToolTipText + }; + parent.Nodes.Add(btn); + return btn; } - readonly Dictionary dict_form = new Dictionary(); - /// - /// 显示子窗体 - /// - /// - /// - public Form ShowForm(Type type) - { - if (this.ActiveMdiChild != null) - { - if (this.ActiveMdiChild.GetType() == type) { return this.ActiveMdiChild; } - } - if (dict_form.ContainsKey(type)) - { - dict_form[type].Show(); - dict_form[type].BringToFront(); - return dict_form[type]; - } - else - { - Form frm = (Form)Activator.CreateInstance(type); - frm.Icon = Icon; - frm.MdiParent = this; - frm.BackColor = Color.White; - frm.FormBorderStyle = FormBorderStyle.None; - frm.Dock = DockStyle.Fill;//完全填充到应用程序 - //frm.WindowState = FormWindowState.Maximized; - frm.Show(); - dict_form.Add(type, frm); - return frm; - } - } - DateTime dt_lastupdate = DateTime.Now; - protected override void WndProc(ref System.Windows.Forms.Message msg) - { - switch (msg.Msg) - { - case 17189: //处理消息 - { - #region 激活窗体 - switch (msg.WParam.ToInt32()) - { - case 100:// - #region 显示界面 - if ((int)msg.LParam.ToInt32() == 100) - { - this.WindowState = FormWindowState.Normal; - this.Top = (Screen.PrimaryScreen.WorkingArea.Height - this.Height) / 2; - this.Left = (Screen.PrimaryScreen.WorkingArea.Width - this.Width) / 2; - //RyForm.SetActiveWindow(Handle); - RyForm.BringToTop(Handle); - } - #endregion - break; - } - #endregion - } - break; - default: - base.WndProc(ref msg);//调用基类函数处理非自定义消息。 - break; - } - } - SysFuns.WinHotReg winHotKey; - private void WinHotKey_OnHotkey(int HotKeyID) - { - switch (HotKeyID) - { - case 101: - MessageBox.Show("这是一个测试", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); - break; - } - } - private void Frmmain_Load(object sender, EventArgs e) - { - ChinaDate.GetYear(2020,2,1); - winHotKey = new SysFuns.WinHotReg(Handle); - winHotKey.RegHotKey(101, SysFuns.KeyModifiers.Alt, Keys.F11); - winHotKey.OnHotkey += WinHotKey_OnHotkey; - string txt = RyFiles.ReadAllText(@"E:\我的代码\毕方项目\C#\当游自动同步系统\Bin\Debug\AutoCutCopy\del.txt"); - //System.Drawing.Imaging.ImageCodecInfo[] encoders = System.Drawing.Imaging.ImageCodecInfo.GetImageEncoders(); - //for (int j = 0; j < encoders.Length; ++j) - //{ - // MessageBox.Show(encoders[j].MimeType); - //} - //ctMsgList1.AddItem("(" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss") + ")", list); - //ctMsgList1.AddItem("(" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss") + ")", list); - Itrycn_Info.OnLeftTreeAdd(this); - //MessageBox.Show(ChinaDate.Get3Fu(2019, 2).ToString()); - //object mainHandle = ryCommon.Model.ryMemoryShare.ReadFromMemory(1024, typeof(string), "3H3BrowserHandle"); - //MessageBox.Show(mainHandle.ToString()); - isExpand = false; - PicExpand_Click(picExpand,new EventArgs()); - Text = Itrycn_Info.Soft_Title+ " V" + ryCommon.RySoft.VersionStr; - notifyIcon1.Icon = this.Icon; - notifyIcon1.Text = Itrycn_Info.Soft_Title; - lblTitle.Text = Itrycn_Info.Soft_Title; - picExpand.Left = treeView1.Left + treeView1.Width + 1; - pnlLeft.Width = picExpand.Left + picExpand.Width + 1; - picExpand.Top = (pnlLeft.Height - picExpand.Height) / 2; - treeView1.ExpandAll(); - this.SetBevel(false); - dt_lastupdate = DateTime.Now; - LiveUpdate.RyUpdate update = new LiveUpdate.RyUpdate(Itrycn_Info.Update_Url); - update.CheckUpdate(); - treeView1.SelectedNode = treeView1.Nodes[0].Nodes[0]; - foreach (Control ctl in this.Controls) - { - try - { - switch(ctl) - { - case MdiClient ctlMDI: - ctlMDI.BackColor = this.BackColor; - break; - } - } - catch (InvalidCastException) - { - } - } - timer1.Enabled = true; - } - - bool isExpand = true; - private void TreeView1_BeforeSelect(object sender, TreeViewCancelEventArgs e) - { - if (e.Node.Tag == null) { e.Cancel = true; return; } - if (!Itrycn_Info.isCanCloseForm) { e.Cancel = true; return; } - } - - private void TreeView1_AfterSelect(object sender, TreeViewEventArgs e) - { - if (e.Node.Tag == null) { return; } - Itrycn_Info.OnTreeClick(this, e); - } - - private void PicExpand_Click(object sender, EventArgs e) - { - if (isExpand) - { - picExpand.Image = Itrycn_Project2.Properties.Resources.opentree; - toolTip1.SetToolTip(picExpand,"展开列表"); - treeView1.Visible = false; - picExpand.Left = 0; - pnlLeft.Width = picExpand.Width; - } - else - { - picExpand.Image = Itrycn_Project2.Properties.Resources.closetree; - toolTip1.SetToolTip(picExpand, "关闭列表"); - treeView1.Visible = true; - picExpand.Left = treeView1.Left + treeView1.Width + 1; - pnlLeft.Width = picExpand.Left + picExpand.Width + 1; - } - isExpand = !isExpand; - } - - private void Frmmain_Resize(object sender, EventArgs e) - { - picExpand.Top = (pnlLeft.Height - picExpand.Height) / 2; - } - private void MenuHomeUrl_Click(object sender, EventArgs e) - { - ryCommon.RyFiles.OpenUrl(Itrycn_Info.Soft_Url); - } - - private void BtnSetting_Click(object sender, EventArgs e) - { - FrmSetting frm = new FrmSetting(); - if(frm.ShowDialog()==DialogResult.OK) - { - Itrycn_Info.LoadSetting(); - } - } - - private void Timer1_Tick(object sender, EventArgs e) - { - if (dt_lastupdate.AddMinutes(30) < DateTime.Now) - { - dt_lastupdate = DateTime.Now; - LiveUpdate.RyUpdate update = new LiveUpdate.RyUpdate(Itrycn_Info.Update_Url); - update.CheckUpdate(); - } - } - - private void BtnAbout_Click(object sender, EventArgs e) - { - FrmAbout frm = new FrmAbout(); - frm.ShowDialog(); - } - - private void Frmmain_FormClosing(object sender, FormClosingEventArgs e) - { - if (!Itrycn_Info.isCanCloseForm) - { - e.Cancel = true; - MessageBox.Show("当前还有操作正在运行,请稍后关闭软件。", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); - } - } - - private void Frmmain_Shown(object sender, EventArgs e) - { - ryCommon.Ini ini = new Ini(Itrycn_Info.UserDataFolder + "\\Win.dat"); - ini.WriteIni(Itrycn_Info.Soft_Id, "hwnd", Handle.ToInt32()); - if (prog_args.Length >= 1) - { - if (prog_args[0] ==Itrycn_Info.Soft_Pram) - this.Hide(); - } - } - - private void 退出ToolStripMenuItem_Click(object sender, EventArgs e) - { - this.Close(); - } - - private void 显示主界面ToolStripMenuItem_Click(object sender, EventArgs e) - { - this.WindowState = FormWindowState.Normal; - this.Top = (Screen.PrimaryScreen.WorkingArea.Height - this.Height) / 2; - this.Left = (Screen.PrimaryScreen.WorkingArea.Width - this.Width) / 2; - RyForm.Show(this); - } - - private void ButtonEx2_Click(object sender, EventArgs e) - { - ryControls.Skin.SkinCommon.ButtonSkin.BackColor = Color.Red; - } - - private void LableX1_DoubleClick(object sender, EventArgs e) - { - MessageBox.Show("这是一个测试", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); - } - } -} + readonly Dictionary dict_form = new Dictionary(); + /// + /// 显示子窗体 + /// + /// + /// + public Form ShowForm(Type type) + { + if (this.ActiveMdiChild != null) + { + if (this.ActiveMdiChild.GetType() == type) { return this.ActiveMdiChild; } + } + if (dict_form.ContainsKey(type)) + { + dict_form[type].Show(); + dict_form[type].BringToFront(); + return dict_form[type]; + } + else + { + Form frm = (Form)Activator.CreateInstance(type); + frm.Icon = Icon; + frm.MdiParent = this; + frm.BackColor = Color.White; + frm.FormBorderStyle = FormBorderStyle.None; + frm.Dock = DockStyle.Fill;//完全填充到应用程序 + //frm.WindowState = FormWindowState.Maximized; + frm.Show(); + dict_form.Add(type, frm); + return frm; + } + } + DateTime dt_lastupdate = DateTime.Now; + protected override void WndProc(ref System.Windows.Forms.Message msg) + { + switch (msg.Msg) + { + case 17189: //处理消息 + { + #region 激活窗体 + switch (msg.WParam.ToInt32()) + { + case 100:// + #region 显示界面 + if ((int)msg.LParam.ToInt32() == 100) + { + this.WindowState = FormWindowState.Normal; + this.Top = (Screen.PrimaryScreen.WorkingArea.Height - this.Height) / 2; + this.Left = (Screen.PrimaryScreen.WorkingArea.Width - this.Width) / 2; + //RyForm.SetActiveWindow(Handle); + RyForm.BringToTop(Handle); + } + #endregion + break; + } + #endregion + } + break; + default: + base.WndProc(ref msg);//调用基类函数处理非自定义消息。 + break; + } + } + SysFuns.WinHotReg winHotKey; + private void WinHotKey_OnHotkey(int HotKeyID) + { + switch (HotKeyID) + { + case 101: + MessageBox.Show("这是一个测试", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); + break; + } + } + private void Frmmain_Load(object sender, EventArgs e) + { + ChinaDate.GetYear(2020,2,1); + winHotKey = new SysFuns.WinHotReg(Handle); + winHotKey.RegHotKey(101, SysFuns.KeyModifiers.Alt, Keys.F11); + winHotKey.OnHotkey += WinHotKey_OnHotkey; + string txt = RyFiles.ReadAllText(@"E:\我的代码\毕方项目\C#\当游自动同步系统\Bin\Debug\AutoCutCopy\del.txt"); + //System.Drawing.Imaging.ImageCodecInfo[] encoders = System.Drawing.Imaging.ImageCodecInfo.GetImageEncoders(); + //for (int j = 0; j < encoders.Length; ++j) + //{ + // MessageBox.Show(encoders[j].MimeType); + //} + //ctMsgList1.AddItem("(" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss") + ")", list); + //ctMsgList1.AddItem("(" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss") + ")", list); + Itrycn_Info.OnLeftTreeAdd(this); + //MessageBox.Show(ChinaDate.Get3Fu(2019, 2).ToString()); + //object mainHandle = ryCommon.Model.ryMemoryShare.ReadFromMemory(1024, typeof(string), "3H3BrowserHandle"); + //MessageBox.Show(mainHandle.ToString()); + isExpand = false; + PicExpand_Click(picExpand,new EventArgs()); + Text = Itrycn_Info.Soft_Title+ " V" + ryCommon.RySoft.VersionStr; + notifyIcon1.Icon = this.Icon; + notifyIcon1.Text = Itrycn_Info.Soft_Title; + lblTitle.Text = Itrycn_Info.Soft_Title; + picExpand.Left = treeView1.Left + treeView1.Width + 1; + pnlLeft.Width = picExpand.Left + picExpand.Width + 1; + picExpand.Top = (pnlLeft.Height - picExpand.Height) / 2; + treeView1.ExpandAll(); + this.SetBevel(false); + dt_lastupdate = DateTime.Now; + LiveUpdate.RyUpdate update = new LiveUpdate.RyUpdate(Itrycn_Info.Update_Url); + update.CheckUpdate(); + treeView1.SelectedNode = treeView1.Nodes[0].Nodes[0]; + foreach (Control ctl in this.Controls) + { + try + { + switch(ctl) + { + case MdiClient ctlMDI: + ctlMDI.BackColor = this.BackColor; + break; + } + } + catch (InvalidCastException) + { + } + } + timer1.Enabled = true; + } + + bool isExpand = true; + private void TreeView1_BeforeSelect(object sender, TreeViewCancelEventArgs e) + { + if (e.Node.Tag == null) { e.Cancel = true; return; } + if (!Itrycn_Info.isCanCloseForm) { e.Cancel = true; return; } + } + + private void TreeView1_AfterSelect(object sender, TreeViewEventArgs e) + { + if (e.Node.Tag == null) { return; } + Itrycn_Info.OnTreeClick(this, e); + } + + private void PicExpand_Click(object sender, EventArgs e) + { + if (isExpand) + { + picExpand.Image = Itrycn_Project.Properties.Resources.opentree; + toolTip1.SetToolTip(picExpand,"展开列表"); + treeView1.Visible = false; + picExpand.Left = 0; + pnlLeft.Width = picExpand.Width; + } + else + { + picExpand.Image = Itrycn_Project.Properties.Resources.closetree; + toolTip1.SetToolTip(picExpand, "关闭列表"); + treeView1.Visible = true; + picExpand.Left = treeView1.Left + treeView1.Width + 1; + pnlLeft.Width = picExpand.Left + picExpand.Width + 1; + } + isExpand = !isExpand; + } + + private void Frmmain_Resize(object sender, EventArgs e) + { + picExpand.Top = (pnlLeft.Height - picExpand.Height) / 2; + } + private void MenuHomeUrl_Click(object sender, EventArgs e) + { + ryCommon.RyFiles.OpenUrl(Itrycn_Info.Soft_Url); + } + + private void BtnSetting_Click(object sender, EventArgs e) + { + FrmSetting frm = new FrmSetting(); + if(frm.ShowDialog()==DialogResult.OK) + { + Itrycn_Info.LoadSetting(); + } + } + + private void Timer1_Tick(object sender, EventArgs e) + { + if (dt_lastupdate.AddMinutes(30) < DateTime.Now) + { + dt_lastupdate = DateTime.Now; + LiveUpdate.RyUpdate update = new LiveUpdate.RyUpdate(Itrycn_Info.Update_Url); + update.CheckUpdate(); + } + } + + private void BtnAbout_Click(object sender, EventArgs e) + { + FrmAbout frm = new FrmAbout(); + frm.ShowDialog(); + } + + private void Frmmain_FormClosing(object sender, FormClosingEventArgs e) + { + if (!Itrycn_Info.isCanCloseForm) + { + e.Cancel = true; + MessageBox.Show("当前还有操作正在运行,请稍后关闭软件。", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); + } + } + + private void Frmmain_Shown(object sender, EventArgs e) + { + ryCommon.Ini ini = new Ini(Itrycn_Info.UserDataFolder + "\\Win.dat"); + ini.WriteIni(Itrycn_Info.Soft_Id, "hwnd", Handle.ToInt32()); + if (prog_args.Length >= 1) + { + if (prog_args[0] ==Itrycn_Info.Soft_Pram) + this.Hide(); + } + } + + private void 退出ToolStripMenuItem_Click(object sender, EventArgs e) + { + this.Close(); + } + + private void 显示主界面ToolStripMenuItem_Click(object sender, EventArgs e) + { + this.WindowState = FormWindowState.Normal; + this.Top = (Screen.PrimaryScreen.WorkingArea.Height - this.Height) / 2; + this.Left = (Screen.PrimaryScreen.WorkingArea.Width - this.Width) / 2; + RyForm.Show(this); + } + + private void ButtonEx2_Click(object sender, EventArgs e) + { + ryControls.Skin.SkinCommon.ButtonSkin.BackColor = Color.Red; + } + + private void LableX1_DoubleClick(object sender, EventArgs e) + { + MessageBox.Show("这是一个测试", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); + } + } +} diff --git a/Source/Itrycn_Project2/Config/Soft_Info.cs b/Source/Itrycn_Project2/Config/Soft_Info.cs index 51e0897..693af20 100644 --- a/Source/Itrycn_Project2/Config/Soft_Info.cs +++ b/Source/Itrycn_Project2/Config/Soft_Info.cs @@ -27,7 +27,7 @@ namespace Itrycn_Project2 /// /// 在线升级配置文件的url /// - public const string Update_Url = "http://www.itrycn.com/update/ryWebMon4.xml"; + public const string Update_Url = "http://www.itjs.top/update/ryWebMon4.xml"; /// /// 软件标题 /// @@ -43,7 +43,7 @@ namespace Itrycn_Project2 /// /// 官网地址 /// - public const string Soft_Url = "http://www.itrycn.com"; + public const string Soft_Url = "http://www.itjs.top"; /// /// 售后QQ群 /// diff --git a/Source/Itrycn_Project2/DbOp/FrmAdd.cs b/Source/Itrycn_Project2/DbOp/FrmAdd.cs index 5d6d72f..3dfe8e2 100644 --- a/Source/Itrycn_Project2/DbOp/FrmAdd.cs +++ b/Source/Itrycn_Project2/DbOp/FrmAdd.cs @@ -17,6 +17,8 @@ namespace Itrycn_Project2.DbOp public string tableName = "MainTable1"; public int isAdd = 1; public string selectId = "-1"; + public DataProvider.DataProviderType dataType = DataProvider.DataProviderType.SQLiteDataProvider; + public string SQLConnStr = Itrycn_Db.SQLConnStr; public FrmAdd() { InitializeComponent(); @@ -25,13 +27,11 @@ namespace Itrycn_Project2.DbOp public void GetInfo(string id) { selectId = id; - DataProvider mydb = new DataProvider(); - IDbInterface db = Itrycn_Db.CreateDataProvider(Itrycn_Db.dataType); - if (db.ConnDb(Itrycn_Db.SQLConnStr) == 1) + IDbInterface db = DataProvider.CreateDataProvider(dataType); + if (db.ConnDb(SQLConnStr) == 1) { DataSet ds = db.ReadData(tableName, id); - if (mydb.HaveData(ds)) - { + if (ds.HaveData()){ DataRow reader = ds.Tables[0].Rows[0]; #region 读取信息 txtName.Text = reader["Name"].ToString(); @@ -50,19 +50,18 @@ namespace Itrycn_Project2.DbOp } RyQuickSQL mySQL = new RyQuickSQL(tableName); mySQL.AddField("name", txtName.Text); - DataProvider mydb = new DataProvider(); - IDbInterface db = Itrycn_Db.CreateDataProvider(Itrycn_Db.dataType); - if (db.ConnDb(Itrycn_Db.SQLConnStr) == 1) + IDbInterface db = DataProvider.CreateDataProvider(dataType); + if (db.ConnDb(SQLConnStr) == 1) { if (isAdd >= 1) { - mySQL.AddField("addTime",DateTime.Now); - mySQL.AddField("editTime", DateTime.Now); + mySQL.AddField("addTime",DateTime.Now.ToInt64()); + mySQL.AddField("editTime", DateTime.Now.ToInt64()); db.ExecuteNonQuery(mySQL.GetInsertSQL(), db.GetParameter(mySQL)); } else { - mySQL.AddField("editTime", DateTime.Now); + mySQL.AddField("editTime", DateTime.Now.ToInt64()); db.ExecuteNonQuery(mySQL.GetUpdateSQL() + " where id=" + selectId, db.GetParameter(mySQL)); } } diff --git a/Source/Itrycn_Project2/DbOp/FrmView.cs b/Source/Itrycn_Project2/DbOp/FrmView.cs index e32224f..cb74966 100644 --- a/Source/Itrycn_Project2/DbOp/FrmView.cs +++ b/Source/Itrycn_Project2/DbOp/FrmView.cs @@ -13,9 +13,19 @@ namespace Itrycn_Project2.DbOp { public partial class FrmView : RySkins.SKinForm { - string orderSQL = "order by addTime desc"; - string tableName = "MainTable1"; - string titleName = "数据"; + readonly string orderSQL = "order by addTime desc"; + readonly string tableName = "MainTable1"; + readonly string titleName = "数据"; + readonly DataProvider.DataProviderType dataType =DataProvider.DataProviderType.SQLiteDataProvider; + readonly string SQLConnStr = Itrycn_Db.SQLConnStr; + /// + /// 是否启用选择模式 + /// + public bool SelectedMode { get; set; } = false; + /// + /// 选择的信息 + /// + public ViewInfo SelectedItem { get; set; }=null; public FrmView() { InitializeComponent(); @@ -33,10 +43,9 @@ namespace Itrycn_Project2.DbOp { #region 重新载入数据 LvCbResult.ClearObjects(); - DataProvider mydb = new DataProvider(); - IDbInterface db = Itrycn_Db.CreateDataProvider(Itrycn_Db.dataType); + IDbInterface db = DataProvider.CreateDataProvider(dataType); List list = new List(); - if (db.ConnDb(Itrycn_Db.SQLConnStr) == 1) + if (db.ConnDb(SQLConnStr) == 1) { DataSet ds = db.ReadData(ctlMyPage1.GetSQLText, ctlMyPage1.T_Parameters); for (int i = 0; i < ds.Tables[0].Rows.Count; i++) @@ -46,7 +55,7 @@ namespace Itrycn_Project2.DbOp { Id=row["id"].ToInt(), Name = row["Name"].ToString(), - AddTime = row["AddTime"].ToDateTime() + AddTime = row["AddTime"].ToInt64().ToDateTime() }) ; } } @@ -57,12 +66,11 @@ namespace Itrycn_Project2.DbOp private void GetRow(int id, int index) { #region 重新载入数据 - DataProvider mydb = new DataProvider(); - IDbInterface db = Itrycn_Db.CreateDataProvider(Itrycn_Db.dataType); - if (db.ConnDb(Itrycn_Db.SQLConnStr) == 1) + IDbInterface db = DataProvider.CreateDataProvider(dataType); + if (db.ConnDb(SQLConnStr) == 1) { DataSet ds = db.ReadData("select * from " + tableName + " where id=" + id); - if (mydb.HaveData(ds)) + if (ds.HaveData()) { DataRow row = ds.Tables[0].Rows[0]; var item=(ViewInfo) LvCbResult.GetModelObject(index); @@ -79,9 +87,8 @@ namespace Itrycn_Project2.DbOp public void LoadDb(string whereSQL) { string _whereSQL = whereSQL; - DataProvider mydb = new DataProvider(); - IDbInterface db = Itrycn_Db.CreateDataProvider(Itrycn_Db.dataType); - if (db.ConnDb(Itrycn_Db.SQLConnStr) == 1) + IDbInterface db = DataProvider.CreateDataProvider(dataType); + if (db.ConnDb(SQLConnStr) == 1) { #region 重新载入数据 db.AddParameter("SearchText", "%" + rySearch1.Text + "%"); @@ -97,11 +104,13 @@ namespace Itrycn_Project2.DbOp private void BtnAdd_Click(object sender, EventArgs e) { - FrmAdd frm = new FrmAdd() + var frm = new FrmAdd() { Text = "添加"+ titleName, Icon = Icon, - isAdd = 1 + isAdd = 1, + dataType = dataType, + SQLConnStr = SQLConnStr, }; frm.mr = new ModalForm(this, frm); frm.mr.OnDialogResult += new ModalForm.DialogResultHandler((object t, DialogResult dg) => { @@ -118,11 +127,13 @@ namespace Itrycn_Project2.DbOp if (LvCbResult.SelectedObject == null) { return; } var item = (ViewInfo)LvCbResult.SelectedObject; var selectId = item.Id; - FrmAdd frm = new FrmAdd() + var frm = new FrmAdd() { Text = "修改"+ titleName, Icon = Icon, - isAdd = 0 + isAdd = 0, + dataType = dataType, + SQLConnStr = SQLConnStr, }; frm.GetInfo(selectId.ToString()); frm.mr = new ModalForm(this, frm); @@ -144,9 +155,8 @@ namespace Itrycn_Project2.DbOp { return; } - //DataProvider mydb = new DataProvider(); - IDbInterface db = Itrycn_Db.CreateDataProvider(Itrycn_Db.dataType); - if (db.ConnDb(Itrycn_Db.SQLConnStr) == 1) + IDbInterface db = DataProvider.CreateDataProvider(dataType); + if (db.ConnDb(SQLConnStr) == 1) { db.DelById(tableName, selectId.ToString()); LvCbResult.RemoveObject(item); @@ -182,7 +192,7 @@ namespace Itrycn_Project2.DbOp if (LvCbResult.SelectedObject == null) { return; } var item = (ViewInfo)LvCbResult.SelectedObject; var selectId = item.Id; - FrmAdd frm = new FrmAdd() + var frm = new FrmAdd() { Text = "添加" + titleName, Icon = Icon, @@ -198,8 +208,20 @@ namespace Itrycn_Project2.DbOp }); frm.mr.ShowModal(); } + + private void LvCbResult_MouseDoubleClick(object sender, MouseEventArgs e) + { + if(e.Button== MouseButtons.Left) + { + if(SelectedMode) + { + SelectedItem = (ViewInfo)LvCbResult.SelectedObject; + DialogResult = DialogResult.OK; + } + } + } } - class ViewInfo + public class ViewInfo { /// /// id diff --git a/Source/Itrycn_Project2/DbOp/frmView.Designer.cs b/Source/Itrycn_Project2/DbOp/frmView.Designer.cs index fed17d3..d3e289c 100644 --- a/Source/Itrycn_Project2/DbOp/frmView.Designer.cs +++ b/Source/Itrycn_Project2/DbOp/frmView.Designer.cs @@ -31,6 +31,7 @@ this.components = new System.ComponentModel.Container(); this.rySearch1 = new ryControls.rySearch(); this.contextMenuStrip1 = new System.Windows.Forms.ContextMenuStrip(this.components); + this.复制并添加数据ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem(); this.添加数据ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem(); this.修改数据ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem(); this.删除数据ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem(); @@ -41,7 +42,6 @@ this.LvCbResult = new BrightIdeasSoftware.FastObjectListView(); this.OlvName = ((BrightIdeasSoftware.OLVColumn)(new BrightIdeasSoftware.OLVColumn())); this.OlvAddTime = ((BrightIdeasSoftware.OLVColumn)(new BrightIdeasSoftware.OLVColumn())); - this.复制并添加数据ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem(); this.contextMenuStrip1.SuspendLayout(); ((System.ComponentModel.ISupportInitialize)(this.LvCbResult)).BeginInit(); this.SuspendLayout(); @@ -65,26 +65,33 @@ this.修改数据ToolStripMenuItem, this.删除数据ToolStripMenuItem}); this.contextMenuStrip1.Name = "contextMenuStrip1"; - this.contextMenuStrip1.Size = new System.Drawing.Size(181, 114); + this.contextMenuStrip1.Size = new System.Drawing.Size(161, 92); + // + // 复制并添加数据ToolStripMenuItem + // + this.复制并添加数据ToolStripMenuItem.Name = "复制并添加数据ToolStripMenuItem"; + this.复制并添加数据ToolStripMenuItem.Size = new System.Drawing.Size(160, 22); + this.复制并添加数据ToolStripMenuItem.Text = "复制并添加数据"; + this.复制并添加数据ToolStripMenuItem.Click += new System.EventHandler(this.复制并添加数据ToolStripMenuItem_Click); // // 添加数据ToolStripMenuItem // this.添加数据ToolStripMenuItem.Name = "添加数据ToolStripMenuItem"; - this.添加数据ToolStripMenuItem.Size = new System.Drawing.Size(124, 22); + this.添加数据ToolStripMenuItem.Size = new System.Drawing.Size(160, 22); this.添加数据ToolStripMenuItem.Text = "添加数据"; this.添加数据ToolStripMenuItem.Click += new System.EventHandler(this.添加数据ToolStripMenuItem_Click); // // 修改数据ToolStripMenuItem // this.修改数据ToolStripMenuItem.Name = "修改数据ToolStripMenuItem"; - this.修改数据ToolStripMenuItem.Size = new System.Drawing.Size(124, 22); + this.修改数据ToolStripMenuItem.Size = new System.Drawing.Size(160, 22); this.修改数据ToolStripMenuItem.Text = "修改数据"; this.修改数据ToolStripMenuItem.Click += new System.EventHandler(this.修改数据ToolStripMenuItem_Click); // // 删除数据ToolStripMenuItem // this.删除数据ToolStripMenuItem.Name = "删除数据ToolStripMenuItem"; - this.删除数据ToolStripMenuItem.Size = new System.Drawing.Size(124, 22); + this.删除数据ToolStripMenuItem.Size = new System.Drawing.Size(160, 22); this.删除数据ToolStripMenuItem.Text = "删除数据"; this.删除数据ToolStripMenuItem.Click += new System.EventHandler(this.删除数据ToolStripMenuItem_Click); // @@ -160,6 +167,7 @@ this.LvCbResult.EmptyListMsg = "当前列表没有任何项"; this.LvCbResult.FullRowSelect = true; this.LvCbResult.HideSelection = false; + this.LvCbResult.IsSearchOnSortColumn = false; this.LvCbResult.Location = new System.Drawing.Point(12, 60); this.LvCbResult.Name = "LvCbResult"; this.LvCbResult.RowHeight = 25; @@ -171,6 +179,7 @@ this.LvCbResult.UseFiltering = true; this.LvCbResult.View = System.Windows.Forms.View.Details; this.LvCbResult.VirtualMode = true; + this.LvCbResult.MouseDoubleClick += new System.Windows.Forms.MouseEventHandler(this.LvCbResult_MouseDoubleClick); // // OlvName // @@ -182,13 +191,6 @@ this.OlvAddTime.Text = "时间"; this.OlvAddTime.Width = 200; // - // 复制并添加数据ToolStripMenuItem - // - this.复制并添加数据ToolStripMenuItem.Name = "复制并添加数据ToolStripMenuItem"; - this.复制并添加数据ToolStripMenuItem.Size = new System.Drawing.Size(180, 22); - this.复制并添加数据ToolStripMenuItem.Text = "复制并添加数据"; - this.复制并添加数据ToolStripMenuItem.Click += new System.EventHandler(this.复制并添加数据ToolStripMenuItem_Click); - // // FrmView // this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 12F); @@ -200,6 +202,7 @@ this.Controls.Add(this.btnAdd); this.Controls.Add(this.ctlMyPage1); this.Controls.Add(this.rySearch1); + this.Location = new System.Drawing.Point(0, 0); this.Name = "FrmView"; this.StartPosition = System.Windows.Forms.FormStartPosition.CenterParent; this.Text = "浏览"; diff --git a/Source/Itrycn_Project2/Form1.Designer.cs b/Source/Itrycn_Project2/Form1.Designer.cs new file mode 100644 index 0000000..70707b1 --- /dev/null +++ b/Source/Itrycn_Project2/Form1.Designer.cs @@ -0,0 +1,61 @@ +namespace Itrycn_Project2 +{ + partial class Form1 + { + /// + /// Required designer variable. + /// + private System.ComponentModel.IContainer components = null; + + /// + /// Clean up any resources being used. + /// + /// true if managed resources should be disposed; otherwise, false. + protected override void Dispose(bool disposing) + { + if (disposing && (components != null)) + { + components.Dispose(); + } + base.Dispose(disposing); + } + + #region Windows Form Designer generated code + + /// + /// Required method for Designer support - do not modify + /// the contents of this method with the code editor. + /// + private void InitializeComponent() + { + this.chinaCalendar1 = new ryControls.ChinaCalendar(); + this.SuspendLayout(); + // + // chinaCalendar1 + // + this.chinaCalendar1.BackColor = System.Drawing.Color.White; + this.chinaCalendar1.DateTime = new System.DateTime(2022, 6, 8, 16, 4, 14, 729); + this.chinaCalendar1.HolidayFolder = "D:\\Program Files\\Microsoft Visual Studio\\2022\\Professional\\Common7\\IDE\\SysDb\\Holi" + + "days"; + this.chinaCalendar1.Location = new System.Drawing.Point(30, 25); + this.chinaCalendar1.Name = "chinaCalendar1"; + this.chinaCalendar1.Size = new System.Drawing.Size(642, 381); + this.chinaCalendar1.TabIndex = 0; + // + // Form1 + // + this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 12F); + this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font; + this.ClientSize = new System.Drawing.Size(800, 450); + this.Controls.Add(this.chinaCalendar1); + this.Name = "Form1"; + this.Text = "Form1"; + this.ResumeLayout(false); + + } + + #endregion + + private ryControls.ChinaCalendar chinaCalendar1; + } +} \ No newline at end of file diff --git a/Source/Itrycn_Project2/Form1.cs b/Source/Itrycn_Project2/Form1.cs new file mode 100644 index 0000000..dc67f57 --- /dev/null +++ b/Source/Itrycn_Project2/Form1.cs @@ -0,0 +1,19 @@ +using System; +using System.Collections.Generic; +using System.ComponentModel; +using System.Data; +using System.Drawing; +using System.Linq; +using System.Text; +using System.Windows.Forms; + +namespace Itrycn_Project2 +{ + public partial class Form1 : Form + { + public Form1() + { + InitializeComponent(); + } + } +} diff --git a/Source/Itrycn_Project2/Form1.resx b/Source/Itrycn_Project2/Form1.resx new file mode 100644 index 0000000..1af7de1 --- /dev/null +++ b/Source/Itrycn_Project2/Form1.resx @@ -0,0 +1,120 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + text/microsoft-resx + + + 2.0 + + + System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 + + + System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 + + \ No newline at end of file diff --git a/Source/Itrycn_Project2/FrmMdiMain.Designer.cs b/Source/Itrycn_Project2/FrmMdiMain.Designer.cs new file mode 100644 index 0000000..605ddf3 --- /dev/null +++ b/Source/Itrycn_Project2/FrmMdiMain.Designer.cs @@ -0,0 +1,206 @@ +namespace Itrycn_Project2 +{ + partial class FrmMdiMain + { + /// + /// Required designer variable. + /// + private System.ComponentModel.IContainer components = null; + + /// + /// Clean up any resources being used. + /// + /// true if managed resources should be disposed; otherwise, false. + protected override void Dispose(bool disposing) + { + if (disposing && (components != null)) + { + components.Dispose(); + } + base.Dispose(disposing); + } + + #region Windows Form Designer generated code + + /// + /// Required method for Designer support - do not modify + /// the contents of this method with the code editor. + /// + private void InitializeComponent() + { + RySkins.ThemeForm themeForm1 = new RySkins.ThemeForm(); + MGdu.WinFormUI.ButtonColorTable buttonColorTable1 = new MGdu.WinFormUI.ButtonColorTable(); + MGdu.WinFormUI.ButtonColorTable buttonColorTable2 = new MGdu.WinFormUI.ButtonColorTable(); + MGdu.WinFormUI.ButtonColorTable buttonColorTable3 = new MGdu.WinFormUI.ButtonColorTable(); + this.panel1 = new System.Windows.Forms.Panel(); + this.panel2 = new System.Windows.Forms.Panel(); + this.SuspendLayout(); + // + // panel1 + // + this.panel1.Dock = System.Windows.Forms.DockStyle.Top; + this.panel1.Location = new System.Drawing.Point(1, 27); + this.panel1.Name = "panel1"; + this.panel1.Size = new System.Drawing.Size(1043, 30); + this.panel1.TabIndex = 1; + // + // panel2 + // + this.panel2.Dock = System.Windows.Forms.DockStyle.Left; + this.panel2.Location = new System.Drawing.Point(1, 57); + this.panel2.Name = "panel2"; + this.panel2.Size = new System.Drawing.Size(209, 665); + this.panel2.TabIndex = 2; + // + // FrmMdiMain + // + this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 12F); + this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font; + this.ClientSize = new System.Drawing.Size(1045, 723); + this.ControlBoxOffset = new System.Drawing.Point(4, 1); + this.Controls.Add(this.panel2); + this.Controls.Add(this.panel1); + this.IconSize = new System.Drawing.Size(22, 22); + this.LeftPanel = this.panel2; + this.MinimumSize = new System.Drawing.Size(160, 60); + this.Name = "FrmMdiMain"; + this.SideResizeWidth = 4; + this.StartPosition = System.Windows.Forms.FormStartPosition.CenterScreen; + this.Text = "测试"; + this.TopPanel = this.panel1; + themeForm1.BorderWidth = 1; + themeForm1.CaptionBackColorBottom = System.Drawing.Color.SeaGreen; + themeForm1.CaptionBackColorTop = System.Drawing.Color.DarkGreen; + themeForm1.CaptionHeight = 26; + themeForm1.CaptionTextCenter = false; + themeForm1.CaptionTextColor = System.Drawing.Color.White; + themeForm1.CloseBoxBackImageHover = null; + themeForm1.CloseBoxBackImageNormal = null; + themeForm1.CloseBoxBackImagePressed = null; + buttonColorTable1.BackColorDisabled = System.Drawing.Color.Empty; + buttonColorTable1.BackColorHover = System.Drawing.Color.FromArgb(((int)(((byte)(217)))), ((int)(((byte)(71)))), ((int)(((byte)(71))))); + buttonColorTable1.BackColorNormal = System.Drawing.Color.Empty; + buttonColorTable1.BackColorPressed = System.Drawing.Color.FromArgb(((int)(((byte)(188)))), ((int)(((byte)(52)))), ((int)(((byte)(52))))); + buttonColorTable1.BorderColorDisabled = System.Drawing.Color.Empty; + buttonColorTable1.BorderColorHover = System.Drawing.Color.Empty; + buttonColorTable1.BorderColorNormal = System.Drawing.Color.Empty; + buttonColorTable1.BorderColorPressed = System.Drawing.Color.Empty; + buttonColorTable1.ForeColorDisabled = System.Drawing.Color.Empty; + buttonColorTable1.ForeColorHover = System.Drawing.Color.FromArgb(((int)(((byte)(249)))), ((int)(((byte)(240)))), ((int)(((byte)(223))))); + buttonColorTable1.ForeColorNormal = System.Drawing.Color.FromArgb(((int)(((byte)(249)))), ((int)(((byte)(240)))), ((int)(((byte)(223))))); + buttonColorTable1.ForeColorPressed = System.Drawing.Color.FromArgb(((int)(((byte)(249)))), ((int)(((byte)(240)))), ((int)(((byte)(223))))); + themeForm1.CloseBoxColor = buttonColorTable1; + themeForm1.CloseBoxSize = new System.Drawing.Size(30, 23); + themeForm1.ControlBoxOffset = new System.Drawing.Point(4, 1); + themeForm1.ControlBoxSpace = 2; + themeForm1.DrawCaptionIcon = true; + themeForm1.DrawCaptionText = true; + themeForm1.FormBackColor = System.Drawing.Color.FromArgb(((int)(((byte)(242)))), ((int)(((byte)(242)))), ((int)(((byte)(242))))); + themeForm1.FormBorderInmostColor = System.Drawing.Color.FromArgb(((int)(((byte)(248)))), ((int)(((byte)(248)))), ((int)(((byte)(248))))); + themeForm1.FormBorderInnerColor = System.Drawing.Color.White; + themeForm1.FormBorderOutterColor = System.Drawing.Color.Gray; + themeForm1.IconLeftMargin = 2; + themeForm1.IconSize = new System.Drawing.Size(22, 22); + themeForm1.MaxBoxBackImageHover = null; + themeForm1.MaxBoxBackImageNormal = null; + themeForm1.MaxBoxBackImagePressed = null; + buttonColorTable2.BackColorDisabled = System.Drawing.Color.Empty; + buttonColorTable2.BackColorHover = System.Drawing.Color.FromArgb(((int)(((byte)(67)))), ((int)(((byte)(139)))), ((int)(((byte)(221))))); + buttonColorTable2.BackColorNormal = System.Drawing.Color.Empty; + buttonColorTable2.BackColorPressed = System.Drawing.Color.FromArgb(((int)(((byte)(50)))), ((int)(((byte)(125)))), ((int)(((byte)(210))))); + buttonColorTable2.BorderColorDisabled = System.Drawing.Color.Empty; + buttonColorTable2.BorderColorHover = System.Drawing.Color.Empty; + buttonColorTable2.BorderColorNormal = System.Drawing.Color.Empty; + buttonColorTable2.BorderColorPressed = System.Drawing.Color.Empty; + buttonColorTable2.ForeColorDisabled = System.Drawing.Color.Empty; + buttonColorTable2.ForeColorHover = System.Drawing.Color.FromArgb(((int)(((byte)(249)))), ((int)(((byte)(240)))), ((int)(((byte)(223))))); + buttonColorTable2.ForeColorNormal = System.Drawing.Color.FromArgb(((int)(((byte)(249)))), ((int)(((byte)(240)))), ((int)(((byte)(223))))); + buttonColorTable2.ForeColorPressed = System.Drawing.Color.FromArgb(((int)(((byte)(249)))), ((int)(((byte)(240)))), ((int)(((byte)(223))))); + themeForm1.MaxBoxColor = buttonColorTable2; + themeForm1.MaxBoxSize = new System.Drawing.Size(30, 23); + themeForm1.Mdi_AlwaysShowListAllBtn = false; + themeForm1.Mdi_BarBackColor = System.Drawing.Color.LightSkyBlue; + themeForm1.Mdi_BarBorderColor = System.Drawing.Color.Red; + themeForm1.Mdi_BarBottomRegionBackColor = System.Drawing.Color.White; + themeForm1.Mdi_BarBottomRegionHeight = 0; + themeForm1.Mdi_BarLeftPadding = 3; + themeForm1.Mdi_BarMargin = new System.Windows.Forms.Padding(1, 27, 1, 0); + themeForm1.Mdi_BarRightPadding = 100; + themeForm1.Mdi_DrawBarBackground = false; + themeForm1.Mdi_DrawBarBorder = false; + themeForm1.Mdi_ListAllBtnAlign = MGdu.WinFormUI.BarButtonAlignmentType.Left; + themeForm1.Mdi_ListAllBtnBottomSpace = 7; + buttonColorTable3.BackColorDisabled = System.Drawing.Color.Empty; + buttonColorTable3.BackColorHover = System.Drawing.Color.White; + buttonColorTable3.BackColorNormal = System.Drawing.Color.Empty; + buttonColorTable3.BackColorPressed = System.Drawing.Color.WhiteSmoke; + buttonColorTable3.BorderColorDisabled = System.Drawing.Color.Empty; + buttonColorTable3.BorderColorHover = System.Drawing.Color.Empty; + buttonColorTable3.BorderColorNormal = System.Drawing.Color.Empty; + buttonColorTable3.BorderColorPressed = System.Drawing.Color.Empty; + buttonColorTable3.ForeColorDisabled = System.Drawing.Color.Empty; + buttonColorTable3.ForeColorHover = System.Drawing.Color.Gray; + buttonColorTable3.ForeColorNormal = System.Drawing.Color.Gray; + buttonColorTable3.ForeColorPressed = System.Drawing.Color.Gray; + themeForm1.Mdi_ListAllBtnColor = buttonColorTable3; + themeForm1.Mdi_ListAllBtnLeftSpace = 4; + themeForm1.Mdi_ListAllBtnSize = new System.Drawing.Size(36, 18); + themeForm1.Mdi_NewTabBtnBottomSpace = 1; + themeForm1.Mdi_NewTabBtnColor = buttonColorTable3; + themeForm1.Mdi_NewTabBtnLeftSpace = 4; + themeForm1.Mdi_NewTabBtnSize = new System.Drawing.Size(24, 24); + themeForm1.Mdi_ShowNewTabBtn = false; + themeForm1.Mdi_ShowTabCloseIcon = false; + themeForm1.Mdi_ShowTabIcon = true; + themeForm1.Mdi_TabActiveBackColorBottom = System.Drawing.Color.FromArgb(((int)(((byte)(248)))), ((int)(((byte)(248)))), ((int)(((byte)(248))))); + themeForm1.Mdi_TabActiveBackColorTop = System.Drawing.Color.White; + themeForm1.Mdi_TabActiveForeColor = System.Drawing.Color.Black; + themeForm1.Mdi_TabAndTabSpace = -8; + themeForm1.Mdi_TabDeactiveBackColorBottom = System.Drawing.Color.FromArgb(((int)(((byte)(230)))), ((int)(((byte)(230)))), ((int)(((byte)(230))))); + themeForm1.Mdi_TabDeactiveBackColorTop = System.Drawing.Color.FromArgb(((int)(((byte)(230)))), ((int)(((byte)(230)))), ((int)(((byte)(230))))); + themeForm1.Mdi_TabDeactiveForeColor = System.Drawing.Color.Black; + themeForm1.Mdi_TabHeight = 26; + themeForm1.Mdi_TabHeightActive = 26; + themeForm1.Mdi_TabInnerBorderColor = System.Drawing.Color.FromArgb(((int)(((byte)(180)))), ((int)(((byte)(255)))), ((int)(((byte)(255)))), ((int)(((byte)(255))))); + themeForm1.Mdi_TabMaxWidth = 145; + themeForm1.Mdi_TabMinWidth = 70; + themeForm1.Mdi_TabNormalWidth = 100; + themeForm1.Mdi_TabOutterBorderColor = System.Drawing.Color.Gray; + themeForm1.Mdi_TabShowBorder = false; + themeForm1.Mdi_TabSlopeWidth = 8; + themeForm1.Mdi_TabTopSpace = 2; + themeForm1.Mdi_UseMsgToActivateChild = true; + themeForm1.MinBoxBackImageHover = null; + themeForm1.MinBoxBackImageNormal = null; + themeForm1.MinBoxBackImagePressed = null; + themeForm1.MinBoxColor = buttonColorTable2; + themeForm1.MinBoxSize = new System.Drawing.Size(30, 23); + themeForm1.Radius = 8; + themeForm1.ResBoxBackImageHover = null; + themeForm1.ResBoxBackImageNormal = null; + themeForm1.ResBoxBackImagePressed = null; + themeForm1.RoundedStyle = MGdu.WinFormUI.MyGraphics.RoundStyle.None; + themeForm1.SetClientInset = false; + themeForm1.ShadowAValueDark = 80; + themeForm1.ShadowAValueLight = 0; + themeForm1.ShadowColor = System.Drawing.Color.Black; + themeForm1.ShadowWidth = 1; + themeForm1.ShowShadow = false; + themeForm1.SideResizeWidth = 4; + themeForm1.TextLeftMargin = 2; + themeForm1.UseDefaultTopRoundingFormRegion = false; + themeForm1.UseShadowToResize = false; + this.XTheme = themeForm1; + this.Load += new System.EventHandler(this.FrmMdiMain_Load); + this.Controls.SetChildIndex(this.panel1, 0); + this.Controls.SetChildIndex(this.panel2, 0); + this.ResumeLayout(false); + + } + + #endregion + + private System.Windows.Forms.Panel panel1; + private System.Windows.Forms.Panel panel2; + } +} \ No newline at end of file diff --git a/Source/Itrycn_Project2/FrmMdiMain.cs b/Source/Itrycn_Project2/FrmMdiMain.cs new file mode 100644 index 0000000..c916588 --- /dev/null +++ b/Source/Itrycn_Project2/FrmMdiMain.cs @@ -0,0 +1,37 @@ +using RySkins; +using System; +using System.Collections.Generic; +using System.ComponentModel; +using System.Data; +using System.Drawing; +using System.Linq; +using System.Text; +using System.Windows.Forms; + +namespace Itrycn_Project2 +{ + public partial class FrmMdiMain : SkinMdiForm + { + public FrmMdiMain() + { + InitializeComponent(); + this.MdiForms.Add(new Itrycn_Project2.Form1()); + } + + private void FrmMdiMain_Load(object sender, EventArgs e) + { + RyWeb.QuickWeb web=new RyWeb.QuickWeb(); + web.ProxyIp = "192.168.1.253:8883"; + web.ProxyUserName = "dangyou"; + web.ProxyPassWord = "88888888"; + var http= web.Get("https://www.google.com"); + Form frm = new Itrycn_Project2.Form1(); + frm.Icon = Icon; + frm.MdiParent = this; + //frm.Dock = DockStyle.Fill;//完全填充到应用程序 + frm.WindowState = FormWindowState.Maximized; + frm.Show(); + this.ActivateMdiChildForm(frm); + } + } +} diff --git a/Source/Itrycn_Project2/FrmMdiMain.resx b/Source/Itrycn_Project2/FrmMdiMain.resx new file mode 100644 index 0000000..1af7de1 --- /dev/null +++ b/Source/Itrycn_Project2/FrmMdiMain.resx @@ -0,0 +1,120 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + text/microsoft-resx + + + 2.0 + + + System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 + + + System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 + + \ No newline at end of file diff --git a/Source/Itrycn_Project2/FrmStart.Designer.cs b/Source/Itrycn_Project2/FrmStart.Designer.cs index 260ff3c..349cfdf 100644 --- a/Source/Itrycn_Project2/FrmStart.Designer.cs +++ b/Source/Itrycn_Project2/FrmStart.Designer.cs @@ -31,6 +31,7 @@ private void InitializeComponent() { this.components = new System.ComponentModel.Container(); + System.ComponentModel.ComponentResourceManager resources = new System.ComponentModel.ComponentResourceManager(typeof(FrmStart)); this.notifyIcon1 = new System.Windows.Forms.NotifyIcon(this.components); this.MenuTray = new System.Windows.Forms.ContextMenuStrip(this.components); this.显示主窗体ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem(); @@ -43,13 +44,25 @@ this.捐助ToolStripMenuItem = new System.Windows.Forms.ToolStripMenuItem(); this.chromeTabControl1 = new ryControls.ChromeTabControl(); this.tabPage1 = new System.Windows.Forms.TabPage(); + this.textBox2 = new System.Windows.Forms.TextBox(); + this.textBox1 = new System.Windows.Forms.TextBox(); + this.htmlPanel1 = new TheArtOfDev.HtmlRenderer.WinForms.HtmlPanel(); + this.pictureBox2 = new System.Windows.Forms.PictureBox(); + this.objectListView1 = new BrightIdeasSoftware.ObjectListView(); + this.olvColumn1 = ((BrightIdeasSoftware.OLVColumn)(new BrightIdeasSoftware.OLVColumn())); + this.pictureBox1 = new System.Windows.Forms.PictureBox(); this.TabLogs = new System.Windows.Forms.TabPage(); + this.button1 = new System.Windows.Forms.Button(); this.LvLogs = new BrightIdeasSoftware.ObjectListView(); this.OlvLogTime = ((BrightIdeasSoftware.OLVColumn)(new BrightIdeasSoftware.OLVColumn())); this.OlvLogText = ((BrightIdeasSoftware.OLVColumn)(new BrightIdeasSoftware.OLVColumn())); this.MenuTray.SuspendLayout(); this.menuStrip1.SuspendLayout(); this.chromeTabControl1.SuspendLayout(); + this.tabPage1.SuspendLayout(); + ((System.ComponentModel.ISupportInitialize)(this.pictureBox2)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.objectListView1)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.pictureBox1)).BeginInit(); this.TabLogs.SuspendLayout(); ((System.ComponentModel.ISupportInitialize)(this.LvLogs)).BeginInit(); this.SuspendLayout(); @@ -89,7 +102,7 @@ this.关于ToolStripMenuItem}); this.menuStrip1.Location = new System.Drawing.Point(1, 27); this.menuStrip1.Name = "menuStrip1"; - this.menuStrip1.Size = new System.Drawing.Size(787, 25); + this.menuStrip1.Size = new System.Drawing.Size(1005, 25); this.menuStrip1.TabIndex = 2; this.menuStrip1.Text = "menuStrip1"; // @@ -147,7 +160,7 @@ this.chromeTabControl1.SelectedIndex = 0; this.chromeTabControl1.ShowAddButton = false; this.chromeTabControl1.ShowCloseButton = false; - this.chromeTabControl1.Size = new System.Drawing.Size(787, 533); + this.chromeTabControl1.Size = new System.Drawing.Size(1005, 664); this.chromeTabControl1.SizeMode = System.Windows.Forms.TabSizeMode.Fixed; this.chromeTabControl1.TabContextMenuStrip = null; this.chromeTabControl1.TabIndex = 0; @@ -155,25 +168,115 @@ // // tabPage1 // + this.tabPage1.AutoScroll = true; + this.tabPage1.Controls.Add(this.textBox2); + this.tabPage1.Controls.Add(this.textBox1); + this.tabPage1.Controls.Add(this.htmlPanel1); + this.tabPage1.Controls.Add(this.pictureBox2); + this.tabPage1.Controls.Add(this.objectListView1); + this.tabPage1.Controls.Add(this.pictureBox1); this.tabPage1.Location = new System.Drawing.Point(1, 29); this.tabPage1.Name = "tabPage1"; this.tabPage1.Padding = new System.Windows.Forms.Padding(3); - this.tabPage1.Size = new System.Drawing.Size(785, 503); + this.tabPage1.Size = new System.Drawing.Size(1003, 634); this.tabPage1.TabIndex = 0; this.tabPage1.Text = "首页"; this.tabPage1.UseVisualStyleBackColor = true; // + // textBox2 + // + this.textBox2.Location = new System.Drawing.Point(260, 101); + this.textBox2.MaxLength = 32767000; + this.textBox2.Multiline = true; + this.textBox2.Name = "textBox2"; + this.textBox2.ScrollBars = System.Windows.Forms.ScrollBars.Vertical; + this.textBox2.Size = new System.Drawing.Size(397, 106); + this.textBox2.TabIndex = 21; + // + // textBox1 + // + this.textBox1.Location = new System.Drawing.Point(232, 213); + this.textBox1.Name = "textBox1"; + this.textBox1.Size = new System.Drawing.Size(359, 21); + this.textBox1.TabIndex = 20; + this.textBox1.TextChanged += new System.EventHandler(this.textBox1_TextChanged); + // + // htmlPanel1 + // + this.htmlPanel1.AutoScroll = true; + this.htmlPanel1.AutoScrollMinSize = new System.Drawing.Size(469, 20); + this.htmlPanel1.BackColor = System.Drawing.SystemColors.Window; + this.htmlPanel1.BaseStylesheet = null; + this.htmlPanel1.Location = new System.Drawing.Point(188, 346); + this.htmlPanel1.Name = "htmlPanel1"; + this.htmlPanel1.Size = new System.Drawing.Size(469, 160); + this.htmlPanel1.TabIndex = 19; + this.htmlPanel1.Text = "htmlPanel1"; + // + // pictureBox2 + // + this.pictureBox2.Location = new System.Drawing.Point(172, 330); + this.pictureBox2.Name = "pictureBox2"; + this.pictureBox2.Size = new System.Drawing.Size(518, 189); + this.pictureBox2.TabIndex = 18; + this.pictureBox2.TabStop = false; + // + // objectListView1 + // + this.objectListView1.AllColumns.Add(this.olvColumn1); + this.objectListView1.Anchor = ((System.Windows.Forms.AnchorStyles)((((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Bottom) + | System.Windows.Forms.AnchorStyles.Left) + | System.Windows.Forms.AnchorStyles.Right))); + this.objectListView1.CellEditUseWholeCell = false; + this.objectListView1.Columns.AddRange(new System.Windows.Forms.ColumnHeader[] { + this.olvColumn1}); + this.objectListView1.Cursor = System.Windows.Forms.Cursors.Default; + this.objectListView1.FullRowSelect = true; + this.objectListView1.HideSelection = false; + this.objectListView1.Location = new System.Drawing.Point(161, 45); + this.objectListView1.Name = "objectListView1"; + this.objectListView1.RowHeight = 25; + this.objectListView1.Size = new System.Drawing.Size(530, 260); + this.objectListView1.TabIndex = 17; + this.objectListView1.UseCompatibleStateImageBehavior = false; + this.objectListView1.View = System.Windows.Forms.View.Details; + // + // olvColumn1 + // + this.olvColumn1.IsButton = true; + this.olvColumn1.Width = 150; + // + // pictureBox1 + // + this.pictureBox1.Location = new System.Drawing.Point(75, 3); + this.pictureBox1.Name = "pictureBox1"; + this.pictureBox1.Size = new System.Drawing.Size(742, 625); + this.pictureBox1.SizeMode = System.Windows.Forms.PictureBoxSizeMode.AutoSize; + this.pictureBox1.TabIndex = 0; + this.pictureBox1.TabStop = false; + // // TabLogs // + this.TabLogs.Controls.Add(this.button1); this.TabLogs.Controls.Add(this.LvLogs); this.TabLogs.Location = new System.Drawing.Point(1, 29); this.TabLogs.Name = "TabLogs"; this.TabLogs.Padding = new System.Windows.Forms.Padding(3); - this.TabLogs.Size = new System.Drawing.Size(785, 503); + this.TabLogs.Size = new System.Drawing.Size(1003, 634); this.TabLogs.TabIndex = 1; this.TabLogs.Text = "日志"; this.TabLogs.UseVisualStyleBackColor = true; // + // button1 + // + this.button1.Location = new System.Drawing.Point(275, 64); + this.button1.Name = "button1"; + this.button1.Size = new System.Drawing.Size(125, 29); + this.button1.TabIndex = 15; + this.button1.Text = "button1"; + this.button1.UseVisualStyleBackColor = true; + this.button1.Click += new System.EventHandler(this.Button1_Click); + // // LvLogs // this.LvLogs.AllColumns.Add(this.OlvLogTime); @@ -191,7 +294,7 @@ this.LvLogs.Location = new System.Drawing.Point(3, 4); this.LvLogs.Name = "LvLogs"; this.LvLogs.RowHeight = 25; - this.LvLogs.Size = new System.Drawing.Size(780, 494); + this.LvLogs.Size = new System.Drawing.Size(998, 627); this.LvLogs.TabIndex = 14; this.LvLogs.UseCompatibleStateImageBehavior = false; this.LvLogs.View = System.Windows.Forms.View.Details; @@ -210,9 +313,11 @@ // this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 12F); this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font; - this.ClientSize = new System.Drawing.Size(789, 592); + this.ClientSize = new System.Drawing.Size(1007, 723); this.Controls.Add(this.menuStrip1); this.Controls.Add(this.chromeTabControl1); + this.GMFormIcon = ((System.Drawing.Image)(resources.GetObject("$this.GMFormIcon"))); + this.Icon = ((System.Drawing.Icon)(resources.GetObject("$this.Icon"))); this.Location = new System.Drawing.Point(0, 0); this.Name = "FrmStart"; this.Resizable = false; @@ -225,6 +330,11 @@ this.menuStrip1.ResumeLayout(false); this.menuStrip1.PerformLayout(); this.chromeTabControl1.ResumeLayout(false); + this.tabPage1.ResumeLayout(false); + this.tabPage1.PerformLayout(); + ((System.ComponentModel.ISupportInitialize)(this.pictureBox2)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.objectListView1)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.pictureBox1)).EndInit(); this.TabLogs.ResumeLayout(false); ((System.ComponentModel.ISupportInitialize)(this.LvLogs)).EndInit(); this.ResumeLayout(false); @@ -249,5 +359,13 @@ private BrightIdeasSoftware.ObjectListView LvLogs; private BrightIdeasSoftware.OLVColumn OlvLogTime; private BrightIdeasSoftware.OLVColumn OlvLogText; + private System.Windows.Forms.Button button1; + private System.Windows.Forms.PictureBox pictureBox1; + private BrightIdeasSoftware.ObjectListView objectListView1; + private BrightIdeasSoftware.OLVColumn olvColumn1; + private System.Windows.Forms.PictureBox pictureBox2; + private System.Windows.Forms.TextBox textBox1; + private TheArtOfDev.HtmlRenderer.WinForms.HtmlPanel htmlPanel1; + private System.Windows.Forms.TextBox textBox2; } } \ No newline at end of file diff --git a/Source/Itrycn_Project2/FrmStart.cs b/Source/Itrycn_Project2/FrmStart.cs index 262f38a..6ad5c02 100644 --- a/Source/Itrycn_Project2/FrmStart.cs +++ b/Source/Itrycn_Project2/FrmStart.cs @@ -1,4 +1,5 @@ -using Itrycn_Project2; +using HtmlAgilityPack; +using Itrycn_Project2; using ryCommon; using ryCommonDb; using System; @@ -8,7 +9,10 @@ using System.Data; using System.Drawing; using System.Linq; using System.Text; +using System.Threading; using System.Windows.Forms; +using static System.Net.Mime.MediaTypeNames; +using static System.Windows.Forms.VisualStyles.VisualStyleElement; namespace Itrycn_Project2 { @@ -32,13 +36,17 @@ namespace Itrycn_Project2 notifyIcon1.Icon = Icon; OlvLogTime.AspectGetter = delegate (object x) { return ((LogInfo)x).LogTime.ToDateTimeStr(); }; OlvLogText.AspectGetter = delegate (object x) { return ((LogInfo)x).LogText; }; + olvColumn1.AspectGetter = delegate (object x) { return "测试"; }; LvLogs.FormatRow += delegate (object x, BrightIdeasSoftware.FormatRowEventArgs e) { - LogInfo item = (LogInfo)e.Model; - if (item.Color != Color.Black) - { - e.Item.ForeColor = item.Color; - } + LogInfo item = (LogInfo)e.Model; + if (item.Color != Color.Black) + { + e.Item.ForeColor = item.Color; + } }; + RyQuickSQL mysql = new RyQuickSQL(""); + var a = mysql + "sss"; + pictureBox1.Image = RyImage.LoadPic("C:\\Users\\Administrator\\AppData\\Roaming\\DingTalk\\204132110_v2\\ImageFiles\\2861025\\1729072614_115186169904.webp"); } /// /// 添加日志 @@ -91,7 +99,7 @@ namespace Itrycn_Project2 private void 退出软件ToolStripMenuItem_Click(object sender, EventArgs e) { - Application.Exit(); + System.Windows.Forms.Application.Exit(); } private void FrmStart_Shown(object sender, EventArgs e) { @@ -177,10 +185,25 @@ namespace Itrycn_Project2 { ryCommon.RyFiles.OpenUrl(Soft_ConstInfo.Soft_Url); } - + private void FrmStart_Load(object sender, EventArgs e) { - ryCommon.PinYin.Convert("李凤鑫"); + RyWeb.QuickWeb web = new RyWeb.QuickWeb(); + textBox2.Text = web.Get("https://apkpure.com/cn/animation-throwdown-epic-ccg/com.kongregate.mobile.throwdown.google/download").Html; + //ryCommon.ApkOp apkOp = new ApkOp(); + //apkOp.AAPT_Path = "E:\\My Datas\\My Codes\\非毕方项目\\Delphi\\公司-批量安装助手XE5\\aapt.exe"; + // var kk= apkOp.Read_Apk("E:\\My Datas\\毕方项目\\Delphi\\IIS防盗链工具\\Res\\ThirdParty\\wwwroot\\update\\taobaov9.apk"); + // objectListView1.InsertObjects(0, new LogInfo[] { new LogInfo() }); + //var en= ryCommon.TxtFileEncoder.GetEncoding(@"E:\My Datas\毕方项目\C#\ryProcessManager\Bin\Debug\SysDb\applist.lst"); + //var hosts = ryCommon.RyFiles.ReadAllText(@"E:\My Datas\毕方项目\C#\ryProcessManager\Bin\Debug\UserDb\Hosts.txt"); + //var result = ryCommon.Hosts.AddHosts(hosts); + //var kk= ryCommon.ProcessExt.GetPath(24348); + //var img = RyImage.LoadPic(@"C:\Users\zilin\Desktop\1.jpg"); + //var watermark =new Bitmap(RyImage.LoadPic(@"C:\Users\zilin\Desktop\water.png")); + //var pos= new List(new WatermarkPosition[] { WatermarkPosition.FullScreenTile }); + //pictureBox1.Image = img.ReSizeW(300); + //pictureBox1.Image= img.DrawWatermark(watermark, WatermarkPosition.FullScreenTile, 0,0,20f); + //ryCommon.PinYin.Convert("李凤鑫"); Public_Config.LoadSetting(); //Itrycn_Project.Itrycn_Db.CreateTable(); //var dbver = Itrycn_Db.GetDbVer(); @@ -201,6 +224,17 @@ namespace Itrycn_Project2 //db.Free(); LiveUpdate.RyUpdate update = new LiveUpdate.RyUpdate(Soft_ConstInfo.Update_Url); update.CheckUpdate(); + //Thread th = new Thread(Start); + //th.Start(); + //void Start() + //{ + // while(true) + // { + // LvLogs.ClearObjects(); + // AddLog("测试测试"); + // Thread.Sleep(200); + // } + //} } private void 选项ToolStripMenuItem_Click(object sender, EventArgs e) @@ -234,5 +268,41 @@ namespace Itrycn_Project2 /// public Color Color { get; set; } = Color.Black; } + + private void Button1_Click(object sender, EventArgs e) + { + LvLogs.ClearObjects(); + AddLog("测试测试"); + } + + private void textBox1_TextChanged(object sender, EventArgs e) + { + //var text = ""; + //try + //{ + // HtmlAgilityPack.HtmlDocument htmlDoc = new HtmlAgilityPack.HtmlDocument(); + // htmlDoc.LoadHtml(textBox2.Text); + // HtmlNodeCollection anchors = htmlDoc.DocumentNode.SelectNodes(textBox1.Text); + // if (anchors != null) + // { + // for (int i = 0; i < anchors.Count; i++) + // { + // if (text != "") { text += "

"; } + // if (i % 2 == 0) + // { + // text += "" + System.Web.HttpUtility.HtmlEncode(anchors[i].OuterHtml) + ""; + // } + // else + // { + // text += "" + System.Web.HttpUtility.HtmlEncode(anchors[i].OuterHtml) + ""; + // } + // } + // } + //} + //catch (Exception ex){ + // text = "" + System.Web.HttpUtility.HtmlEncode(ex.Message) + ""; + //} + htmlPanel1.Text = System.Web.HttpUtility.HtmlEncode(textBox1.Text); + } } } diff --git a/Source/Itrycn_Project2/FrmStart.resx b/Source/Itrycn_Project2/FrmStart.resx index a515ae6..5fa3d54 100644 --- a/Source/Itrycn_Project2/FrmStart.resx +++ b/Source/Itrycn_Project2/FrmStart.resx @@ -129,4 +129,30 @@ 54 + + + + iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAAABGdBTUEAALGPC/xhBQAAAYdJREFUaEPt + lrFOwzAURbOwMLEwwNQFJcaxlCg/0D9jYWFhgomRrRsbGxsbCz/QnZ+A+9ArslxLddLE9kM+0pWcuO/m + XqmKUxUK/4y2bW94KRMqAG34Uh5c4FtsCavA8SWUUhcwWUeWXWB6CQw+OkYpNb4Ehr4ck9QaV8JjkIPC + S3iGU+uZo4XhMUipJ44VjseEtPgpSc+wn6m1fuCtcdgmlqIWMMbc8+3x7EwcRSuA8Hd8axpW6BQFbvly + Olbo6AV4eRxO8GgFZsMTvhSIiie8uAK+T901bxcKuYK/KR1ke+Lt/OHAey8Q3s4fhC0FkoKwyxWA0eLn + AJ6xTAGYbCCZBWBA4clIXgEM78KTZBXAoB2e5P0+mlnzFMCQGz6pOFYYGMgqPImjHQY/zi48ieMdZhiG + E2PMi88klbTWW44XBkqcYvDVNUqo8V+jXdedYfDNMfK9NRYVx5lG3/fnMHmH/grwlhzqur5E8A+xBYim + aVYI/ym2AKGUuhJdgMDr7JqXhcIvVfUD8u9YvR+UOpoAAAAASUVORK5CYII= + + + + + AAABAAEAMDAAAAAAIADQAQAAFgAAAIlQTkcNChoKAAAADUlIRFIAAAAwAAAAMAgGAAAAVwL5hwAAAARn + QU1BAACxjwv8YQUAAAGHSURBVGhD7ZaxTsMwFEWzsDCxMMDUBSXGsZQoP9A/Y2FhYYKJka0bGxsbGws/ + 0J2fgPvQK7JcS3XSxPZDPtKVnLjv5l6pilMVCv+Mtm1veCkTKgBt+FIeXOBbbAmrwPEllFIXMFlHll1g + egkMPjpGKTW+BIa+HJPUGlfCY5CDwkt4hlPrmaOF4TFIqSeOFY7HhLT4KUnPsJ+ptX7grXHYJpaiFjDG + 3PPt8exMHEUrgPB3fGsaVugUBW75cjpW6OgFeHkcTvBoBWbDE74UiIonvLgCvk/dNW8XCrmCvykdZHvi + 7fzhwHsvEN7OH4QtBZKCsMsVgNHi5wCesUwBmGwgmQVgQOHJSF4BDO/Ck2QVwKAdnuT9PppZ8xTAkBs+ + qThWGBjIKjyJox0GP84uPInjHWYYhhNjzIvPJJW01luOFwZKnGLw1TVKqPFfo13XnWHwzTHyvTUWFceZ + Rt/35zB5h/4K8JYc6rq+RPAPsQWIpmlWCP8ptgChlLoSXYDA6+yal4XCL1X1A/LvWL0flDqaAAAAAElF + TkSuQmCC + + \ No newline at end of file diff --git a/Source/Itrycn_Project2/Itrycn_Project2.csproj b/Source/Itrycn_Project2/Itrycn_Project2.csproj index 3ead0d2..0af1e94 100644 --- a/Source/Itrycn_Project2/Itrycn_Project2.csproj +++ b/Source/Itrycn_Project2/Itrycn_Project2.csproj @@ -8,7 +8,7 @@ WinExe Itrycn_Project2 Itrycn_Project2 - v4.0 + v4.5.2 512 publish\ true @@ -25,6 +25,7 @@ false false true + AnyCPU @@ -35,6 +36,7 @@ DEBUG;TRACE prompt 4 + false x86 @@ -44,15 +46,29 @@ TRACE prompt 4 + false app.manifest + + False + ..\..\Bin\Release\CommonControls\.NET4\MySql.Data.dll + + C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0\System.dll + + + False + ..\..\Bin\Release\CommonControls\.NET4\System.Data.SQLite.dll + + + + @@ -79,12 +95,24 @@ FrmView.cs + + Form + + + Form1.cs + Form FrmAbout.cs + + Form + + + FrmMdiMain.cs + Form @@ -138,9 +166,15 @@ FrmView.cs + + Form1.cs + FrmAbout.cs + + FrmMdiMain.cs + FrmStart.cs @@ -172,6 +206,7 @@ SkinMdiForm.cs + SettingsSingleFileGenerator @@ -183,24 +218,6 @@ True - - - {9df20d86-a56e-4cf6-a3d8-f30421297b1b} - MyDbV4 - - - {6b969ce8-d723-4b2c-a8fd-fad2fb28ff01} - MyDb_SQLiteV4 - - - {9eca3a84-8545-4c4d-84d6-d23e3bdf2d90} - ryControlsV4 - - - {11a63e24-0257-4c54-a109-f1a609a52a62} - ryUpdateV4 - - False @@ -211,5 +228,11 @@ + + + {74f6dd1e-c4ee-4c65-ac58-e6a0f541e314} + RaUIV4 + + \ No newline at end of file diff --git a/Source/Itrycn_Project2/OTools/FrmScan.cs b/Source/Itrycn_Project2/OTools/FrmScan.cs index 1391ca0..d02d04e 100644 --- a/Source/Itrycn_Project2/OTools/FrmScan.cs +++ b/Source/Itrycn_Project2/OTools/FrmScan.cs @@ -97,7 +97,9 @@ namespace Itrycn_Project2 })); } bool IsRunning = false; +#pragma warning disable CS0414 // 字段“FrmScan.IsExit”已被赋值，但从未使用过它的值 bool IsExit = false; +#pragma warning restore CS0414 // 字段“FrmScan.IsExit”已被赋值，但从未使用过它的值 private void BtnScan_Click(object sender, EventArgs e) { if (IsRunning) { IsExit = true; return; } diff --git a/Source/Itrycn_Project2/Program.cs b/Source/Itrycn_Project2/Program.cs index 38b6401..4fec9ad 100644 --- a/Source/Itrycn_Project2/Program.cs +++ b/Source/Itrycn_Project2/Program.cs @@ -1,61 +1,61 @@ -using Itrycn; -using Itrycn_Project2; -using ryCommon; -using System; -using System.Collections.Generic; -using System.Linq; +using Itrycn; +using Itrycn_Project2; +using ryCommon; +using System; +using System.Collections.Generic; +using System.Linq; using System.Reflection; -using System.Text; -using System.Windows.Forms; - -namespace Itrycn_Project2 -{ - static class Program - { - /// - /// 应用程序的主入口点。 - /// - [STAThread] - static void Main(string[] args) - { - AppDomain.CurrentDomain.AssemblyResolve += CurrentDomain_AssemblyResolve; - Application.ThreadException += Application_ThreadException; - AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException; - Application.EnableVisualStyles(); - Application.SetCompatibleTextRenderingDefault(false); +using System.Text; +using System.Windows.Forms; + +namespace Itrycn_Project2 +{ + static class Program + { + /// + /// 应用程序的主入口点。 + /// + [STAThread] + static void Main(string[] args) + { + AppDomain.CurrentDomain.AssemblyResolve += CurrentDomain_AssemblyResolve; + Application.ThreadException += Application_ThreadException; + AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException; + Application.EnableVisualStyles(); + Application.SetCompatibleTextRenderingDefault(false); if(ryCommon.RedistCheck.IsInstall_VC2019(RedistCheck.InstallBit.All)) { - } - Config.Init.Show(args); - } - static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e) - { - Exception ex = e.ExceptionObject as Exception; - MessageBox.Show(string.Format("捕获到未处理异常：{0}\r\n异常信息：{1}\r\n异常堆栈：{2}\r\nCLR即将退出：{3}", ex.GetType(), ex.Message, ex.StackTrace, e.IsTerminating)); - System.IO.File.WriteAllText(Application.StartupPath + "\\错误.txt", DateTime.Now.ToString() + "\r\n\r\n错误描述:" + ex.Message + "\r\n\r\n异常堆栈：" + ex.StackTrace + "\r\n\r\n异常方法：" + ex.TargetSite, Encoding.UTF8); - } - static void Application_ThreadException(object sender, System.Threading.ThreadExceptionEventArgs e) - { - Exception ex = e.Exception; - MessageBox.Show(string.Format("捕获到未处理异常：{0}\r\n异常信息：{1}\r\n异常堆栈：{2}", ex.GetType(), ex.Message, ex.StackTrace)); - System.IO.File.WriteAllText(Application.StartupPath + "\\线程错误.txt", DateTime.Now.ToString() + "\r\n\r\n错误描述:" + ex.Message + "\r\n\r\n异常堆栈：" + ex.StackTrace + "\r\n\r\n异常方法：" + ex.TargetSite, Encoding.UTF8); + } + Config.Init.Show(args); } - static Assembly CurrentDomain_AssemblyResolve(object sender, ResolveEventArgs args) - { - AssemblyName assemblyName = new AssemblyName(args.Name); - if (System.IO.File.Exists(Application.StartupPath + @"\" + assemblyName.Name + ".dll")) - { - return Assembly.LoadFrom(Application.StartupPath + @"\" + assemblyName.Name + ".dll"); - } - else if (System.IO.File.Exists(Application.StartupPath + @"\Bin\dlls\" + assemblyName.Name + ".dll")) - { - return Assembly.LoadFrom(Application.StartupPath + @"\Bin\dlls\" + assemblyName.Name + ".dll"); - } - else - { - return args.RequestingAssembly; - } - } - } -} + static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e) + { + Exception ex = e.ExceptionObject as Exception; + MessageBox.Show(string.Format("捕获到未处理异常：{0}\r\n异常信息：{1}\r\n异常堆栈：{2}\r\nCLR即将退出：{3}", ex.GetType(), ex.Message, ex.StackTrace, e.IsTerminating)); + System.IO.File.WriteAllText(Application.StartupPath + "\\错误.txt", DateTime.Now.ToString() + "\r\n\r\n错误描述:" + ex.Message + "\r\n\r\n异常堆栈：" + ex.StackTrace + "\r\n\r\n异常方法：" + ex.TargetSite, Encoding.UTF8); + } + static void Application_ThreadException(object sender, System.Threading.ThreadExceptionEventArgs e) + { + Exception ex = e.Exception; + MessageBox.Show(string.Format("捕获到未处理异常：{0}\r\n异常信息：{1}\r\n异常堆栈：{2}", ex.GetType(), ex.Message, ex.StackTrace)); + System.IO.File.WriteAllText(Application.StartupPath + "\\线程错误.txt", DateTime.Now.ToString() + "\r\n\r\n错误描述:" + ex.Message + "\r\n\r\n异常堆栈：" + ex.StackTrace + "\r\n\r\n异常方法：" + ex.TargetSite, Encoding.UTF8); + } + static Assembly CurrentDomain_AssemblyResolve(object sender, ResolveEventArgs args) + { + AssemblyName assemblyName = new AssemblyName(args.Name); + if (System.IO.File.Exists(Application.StartupPath + @"\" + assemblyName.Name + ".dll")) + { + return Assembly.LoadFrom(Application.StartupPath + @"\" + assemblyName.Name + ".dll"); + } + else if (System.IO.File.Exists(Application.StartupPath + @"\Bin\dlls\" + assemblyName.Name + ".dll")) + { + return Assembly.LoadFrom(Application.StartupPath + @"\Bin\dlls\" + assemblyName.Name + ".dll"); + } + else + { + return args.RequestingAssembly; + } + } + } +} diff --git a/Source/Itrycn_Project2/Properties/Resources.Designer.cs b/Source/Itrycn_Project2/Properties/Resources.Designer.cs index f47dab2..10a64e3 100644 --- a/Source/Itrycn_Project2/Properties/Resources.Designer.cs +++ b/Source/Itrycn_Project2/Properties/Resources.Designer.cs @@ -19,7 +19,7 @@ namespace Itrycn_Project2.Properties { // 类通过类似于 ResGen 或 Visual Studio 的工具自动生成的。 // 若要添加或移除成员，请编辑 .ResX 文件，然后重新运行 ResGen // (以 /str 作为命令选项)，或重新生成 VS 项目。 - [global::System.CodeDom.Compiler.GeneratedCodeAttribute("System.Resources.Tools.StronglyTypedResourceBuilder", "16.0.0.0")] + [global::System.CodeDom.Compiler.GeneratedCodeAttribute("System.Resources.Tools.StronglyTypedResourceBuilder", "17.0.0.0")] [global::System.Diagnostics.DebuggerNonUserCodeAttribute()] [global::System.Runtime.CompilerServices.CompilerGeneratedAttribute()] internal class Resources { @@ -47,8 +47,8 @@ namespace Itrycn_Project2.Properties { } /// - /// 重写当前线程的 CurrentUICulture 属性 - /// 重写当前线程的 CurrentUICulture 属性。 + /// 重写当前线程的 CurrentUICulture 属性，对 + /// 使用此强类型资源类的所有资源查找执行重写。 /// [global::System.ComponentModel.EditorBrowsableAttribute(global::System.ComponentModel.EditorBrowsableState.Advanced)] internal static global::System.Globalization.CultureInfo Culture { diff --git a/Source/Itrycn_Project2/Properties/Settings.Designer.cs b/Source/Itrycn_Project2/Properties/Settings.Designer.cs index 3e3d9ad..2144921 100644 --- a/Source/Itrycn_Project2/Properties/Settings.Designer.cs +++ b/Source/Itrycn_Project2/Properties/Settings.Designer.cs @@ -1,28 +1,24 @@ //------------------------------------------------------------------------------ // -// This code was generated by a tool. -// Runtime Version:4.0.30319.42000 +// 此代码由工具生成。 +// 运行时版本:4.0.30319.42000 // -// Changes to this file may cause incorrect behavior and will be lost if -// the code is regenerated. +// 对此文件的更改可能会导致不正确的行为，并且如果 +// 重新生成代码，这些更改将会丢失。 // //------------------------------------------------------------------------------ -namespace Itrycn_Project2.Properties -{ - - +namespace Itrycn_Project2.Properties { + + [global::System.Runtime.CompilerServices.CompilerGeneratedAttribute()] - [global::System.CodeDom.Compiler.GeneratedCodeAttribute("Microsoft.VisualStudio.Editors.SettingsDesigner.SettingsSingleFileGenerator", "11.0.0.0")] - internal sealed partial class Settings : global::System.Configuration.ApplicationSettingsBase - { - + [global::System.CodeDom.Compiler.GeneratedCodeAttribute("Microsoft.VisualStudio.Editors.SettingsDesigner.SettingsSingleFileGenerator", "17.5.0.0")] + internal sealed partial class Settings : global::System.Configuration.ApplicationSettingsBase { + private static Settings defaultInstance = ((Settings)(global::System.Configuration.ApplicationSettingsBase.Synchronized(new Settings()))); - - public static Settings Default - { - get - { + + public static Settings Default { + get { return defaultInstance; } } diff --git a/Source/Itrycn_Project2/SkinForms/SkinMdiForm.Designer.cs b/Source/Itrycn_Project2/SkinForms/SkinMdiForm.Designer.cs index 545209c..c753c88 100644 --- a/Source/Itrycn_Project2/SkinForms/SkinMdiForm.Designer.cs +++ b/Source/Itrycn_Project2/SkinForms/SkinMdiForm.Designer.cs @@ -35,10 +35,13 @@ namespace RySkins // this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 12F); this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font; - this.ClientSize = new System.Drawing.Size(505, 444); + this.ClientSize = new System.Drawing.Size(1035, 719); + this.FormBorderStyle = System.Windows.Forms.FormBorderStyle.None; this.IsMdiContainer = true; + this.Location = new System.Drawing.Point(0, 0); this.Name = "SkinMdiForm"; this.Text = "SkinMdiForm"; + this.Load += new System.EventHandler(this.SkinMdiForm_Load); this.ResumeLayout(false); } diff --git a/Source/Itrycn_Project2/SkinForms/SkinMdiForm.cs b/Source/Itrycn_Project2/SkinForms/SkinMdiForm.cs index b21b3ae..5d44803 100644 --- a/Source/Itrycn_Project2/SkinForms/SkinMdiForm.cs +++ b/Source/Itrycn_Project2/SkinForms/SkinMdiForm.cs @@ -18,16 +18,26 @@ namespace RySkins /// [Description("顶部栏")] public Panel TopPanel { get; set; } = null; + /// + /// 左侧栏 + /// + [Description("左侧栏")] + public Panel LeftPanel { get; set; } = null; public SkinMdiForm() { InitializeComponent(); InitMdiSkin(); } + public SkinMdiForm(string[] args) + { + InitializeComponent(); + InitMdiSkin(); + } #region 加载皮肤 /// /// 加载皮肤 /// - private void InitMdiSkin() + public void InitMdiSkin() { _mdiClient = FindMdiClient(); base.SizeChanged += new EventHandler((object sender, EventArgs e) => @@ -44,17 +54,18 @@ namespace RySkins }); base.Load += new EventHandler((object sender, EventArgs e) => { - base.XTheme = new ThemeForm(); + base.XTheme = new RySkins.ThemeForm(); base.XTheme.Mdi_TabMinWidth = 70; base.XTheme.Mdi_TabNormalWidth = 100; base.XTheme.Mdi_TabMaxWidth = 145; base.XTheme.Mdi_ShowNewTabBtn = false; base.XTheme.Mdi_AlwaysShowListAllBtn = false; base.XTheme.Mdi_BarBottomRegionHeight = 0; - base.XTheme.Mdi_ShowTabCloseIcon = false; + base.XTheme.Mdi_ShowTabCloseIcon = true; base.XTheme.Mdi_TabShowBorder = false; base.XTheme.Mdi_BarMargin = new Padding(6, 0, 100, 0); base.XTheme.Mdi_TabActiveBackColorTop = Color.White; + base.XTheme.Mdi_ShowTabIcon = false; base.XTheme.Mdi_TabActiveBackColorBottom = Color.FromArgb(248, 248, 248); base.XTheme.Mdi_TabDeactiveBackColorTop = Color.FromArgb(230, 230, 230); base.XTheme.Mdi_TabDeactiveBackColorBottom = Color.FromArgb(230, 230, 230); @@ -67,6 +78,7 @@ namespace RySkins _mdiClient.Dock = DockStyle.None; _mdiClient.BackColor = Color.White; } + this.Location = new Point((Screen.PrimaryScreen.WorkingArea.Width - Width) / 2, (Screen.PrimaryScreen.WorkingArea.Height - Height) / 2); }); base.MdiBarCreated += new EventHandler((object sender, EventArgs e) => { @@ -80,6 +92,7 @@ namespace RySkins this.Invoke(new Action(() => { this.SuspendLayout(); + //CreateNewChild(typeof(DYun.OTools.FrmGZ)); for (int i = 0; i < MdiForms.Count; i++) { CreateNewChild(MdiForms[i]); @@ -114,20 +127,52 @@ namespace RySkins form.SizeGripStyle = SizeGripStyle.Show; form.WindowState = FormWindowState.Maximized; form.Show(); - // form.ResumeLayout(false); + // form.ResumeLayout(false); //f.Focus(); } + private void CreateNewChild(Type form) + { + Form f = (Form)Activator.CreateInstance(form); + f.FormClosed += new FormClosedEventHandler(base.MdiChildClosed); + f.VisibleChanged += new EventHandler(base.MdiChildVisibleChange); + f.MdiParent = this; + //f.BackColor = Color.White; + f.FormBorderStyle = FormBorderStyle.SizableToolWindow; + f.SizeGripStyle = SizeGripStyle.Show; + f.WindowState = FormWindowState.Maximized; + f.Show(); + //f.Focus(); + } + MdiClient _mdiClient; - private int PanelTopHeight { get; set; } = 43; + private int PanelTopHeight + { + get + { + return TopPanel == null ? 0 : TopPanel.Height; + } + + } private void NewFormClick(object sender, EventArgs e) { // CreateNewChild(); } + /// + /// 至少保留一个子窗体 + /// + public bool AleastOneChild { get; set; } = true; private void ChildFormClose(object sender, EventArgs e) { if (sender is Form f) + { + if (AleastOneChild) + { + if (this.GetCurrentMdiChildren().Count == 1) { return; } + } f.Close(); + } + this.Invalidate(); } private MdiClient FindMdiClient() { @@ -148,7 +193,9 @@ namespace RySkins // newMargin = new Padding(BorderWidth, BorderWidth, BorderWidth, 0); //else //PnlMenu.Top = BorderWidth + base.XTheme.CaptionHeight; - newMargin = new Padding(BorderWidth, BorderWidth + base.XTheme.CaptionHeight + 0, BorderWidth, 0); + int left_bar_width = 0; + if (LeftPanel != null) { left_bar_width = LeftPanel.Width; } + newMargin = new Padding(BorderWidth + left_bar_width, BorderWidth + base.XTheme.CaptionHeight + PanelTopHeight, BorderWidth, 0); if (base.XTheme.Mdi_BarMargin != newMargin) { base.XTheme.Mdi_BarMargin = newMargin; @@ -157,40 +204,40 @@ namespace RySkins } private void SetPanelTopLocation(Panel PnlTop) { - Point newLocation = new Point(base.MdiBarBounds.Left, base.MdiBarBounds.Bottom); - //if (panelTop.Location == newLocation) - // return; + //Point newLocation = new Point(base.MdiBarBounds.Left, base.XTheme.CaptionHeight + BorderWidth); //var size = new Size(base.MdiBarBounds.Width, PanelTopHeight); //if (PnlTop != null) //{ - // PnlTop.Anchor = AnchorStyles.None; + // //PnlTop.Anchor = AnchorStyles.None; // PnlTop.Location = newLocation; // PnlTop.Size = size; - // PnlTop.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Top; + // //PnlTop.Anchor = AnchorStyles.Left | AnchorStyles.Right | AnchorStyles.Top; //} } private void SetFormItemLocation(Panel PnlTop) { + if (DesignMode) { return; } SetMdiBarLocation(); - //SetPanelTopLocation(PnlTop); + SetPanelTopLocation(PnlTop); SetMdiClientLocation(PnlTop); } private void SetMdiClientLocation(Panel PnlTop) { if (_mdiClient == null) return; - Point newLocation = Point.Empty; - var size = ClientRectangle.Size; + int left_bar_width = 0; + if (LeftPanel != null) { left_bar_width = LeftPanel.Width; } + Point newLocation = new Point(BorderWidth, base.XTheme.CaptionHeight + base.XTheme.Mdi_TabHeight); + var size = new Size(ClientRectangle.Width - BorderWidth - BorderWidth, ClientRectangle.Height - base.XTheme.CaptionHeight - base.XTheme.Mdi_TabHeight - BorderWidth); if (PnlTop != null) { - newLocation = new Point(PnlTop.Left, PnlTop.Bottom); + newLocation = new Point(PnlTop.Left + left_bar_width, PnlTop.Bottom + base.XTheme.Mdi_TabHeight); if (_mdiClient.Location == newLocation) return; - int height = base.ClientSize.Height - newLocation.Y - - (base.ClientSize.Width - PnlTop.Width) / 2; + int height = base.Height - newLocation.Y - BorderWidth - BorderWidth; - size = new Size(PnlTop.Width, height); + size = new Size(PnlTop.Width - left_bar_width, height); } _mdiClient.Anchor = AnchorStyles.None; _mdiClient.Location = newLocation; @@ -199,5 +246,10 @@ namespace RySkins AnchorStyles.Left | AnchorStyles.Top | AnchorStyles.Right | AnchorStyles.Bottom; } #endregion + + private void SkinMdiForm_Load(object sender, EventArgs e) + { + + } } } diff --git a/Source/Itrycn_Project2/SkinForms/ThemeForm.cs b/Source/Itrycn_Project2/SkinForms/ThemeForm.cs index d0e6530..462a2a5 100644 --- a/Source/Itrycn_Project2/SkinForms/ThemeForm.cs +++ b/Source/Itrycn_Project2/SkinForms/ThemeForm.cs @@ -5,6 +5,7 @@ using System.Collections.Generic; using System.Drawing; using System.Linq; using System.Text; +using System.Windows.Forms; namespace RySkins { @@ -18,27 +19,59 @@ namespace RySkins : base() { ThemeName = "Default"; - ryControls.Skin.SkinCommon.ButtonSkin.BackColor = Color.DarkGreen; - CaptionBackColorTop = Color.DarkGreen; - CaptionBackColorBottom = Color.SeaGreen; + ryControls.Skin.SkinCommon.ButtonSkin.BackColor = Color.MidnightBlue; ryControls.Skin.SkinCommon.ButtonSkin.ColorGradient = true; + IconSize = new Size(16, 16); + IconLeftMargin = 8; BorderWidth = 1; - //CaptionHeight = 30; - IconSize = new Size(22, 22); - //ControlBoxOffset = new Point(8, 8); - //ControlBoxSpace = 2; - SideResizeWidth = 4; - UseDefaultTopRoundingFormRegion = false; - - - RoundedStyle = RoundStyle.None; + FormBorderInnerColor = Color.Gray; FormBorderOutterColor = Color.Gray; - FormBorderInnerColor = Color.White; - SetClientInset = false; + CaptionHeight = 26; + CaptionBackColorTop = Color.Gray; + CaptionBackColorBottom = Color.SlateGray; + FormBackColor = Color.FromArgb(242, 242, 242); + CaptionTextColor = Color.White; + Mdi_UseMsgToActivateChild = true; + // shadow + SideResizeWidth = 3; ShowShadow = false; - CaptionTextCenter = false; - //CaptionTextColor = Color.FromArgb(102, 102, 102); - //FormBackColor = Color.White; + ShadowWidth = 4; + ShadowColor = Color.Gray; + ShadowAValueDark = 50; + ShadowAValueLight = 0; + UseShadowToResize = true; + base.Mdi_TabActiveBackColorTop = Color.White; + base.Mdi_TabActiveBackColorBottom = Color.FromArgb(248, 248, 248); + base.Mdi_TabDeactiveBackColorTop = Color.FromArgb(230, 230, 230); + base.Mdi_TabDeactiveBackColorBottom = Color.FromArgb(230, 230, 230); + //base.Mdi_TabDeactiveForeColor = Color.FromArgb(244, 246, 247); + CloseBoxSize = MaxBoxSize = MinBoxSize = new Size(30, 23); + ControlBoxOffset = new Point(0, 0); + ControlBoxSpace = 0; + RoundedStyle = RoundStyle.All; + Radius = 5; + ButtonColorTable closeTable = new ButtonColorTable(); + closeTable.ForeColorNormal = closeTable.ForeColorHover + = closeTable.ForeColorPressed = Color.FromArgb(249, 240, 223); + closeTable.BackColorHover = Color.FromArgb(217, 71, 71); + closeTable.BackColorPressed = Color.FromArgb(188, 52, 52); + CloseBoxColor = closeTable; + + ButtonColorTable minTable = new ButtonColorTable(); + minTable.ForeColorNormal = minTable.ForeColorHover + = minTable.ForeColorPressed = Color.FromArgb(249, 240, 223); + minTable.BackColorHover = Color.FromArgb(67, 139, 221); + minTable.BackColorPressed = Color.FromArgb(50, 125, 210); + MinBoxColor = MaxBoxColor = minTable; + base.Mdi_TabMinWidth = 70; + base.Mdi_TabNormalWidth = 100; + base.Mdi_TabMaxWidth = 145; + base.Mdi_ShowNewTabBtn = false; + base.Mdi_AlwaysShowListAllBtn = false; + base.Mdi_BarBottomRegionHeight = 0; + base.Mdi_ShowTabCloseIcon = false; + base.Mdi_TabShowBorder = false; + base.Mdi_BarMargin = new Padding(6, 0, 100, 0); } } } diff --git a/Source/Itrycn_Project2/app.config b/Source/Itrycn_Project2/app.config new file mode 100644 index 0000000..ff99501 --- /dev/null +++ b/Source/Itrycn_Project2/app.config @@ -0,0 +1,3 @@ + + + diff --git a/Source/MyDb/DbManage/Storage.cs b/Source/MyDb/DbManage/Storage.cs index 3c16faf..9bd3a56 100644 --- a/Source/MyDb/DbManage/Storage.cs +++ b/Source/MyDb/DbManage/Storage.cs @@ -1,994 +1,994 @@ -//--------------------------日期:2017-04-07 -//--------------------------版本:2.0.0 .0 -//--------------------------作者:itrycn -using System; -using System.Collections.Generic; -using System.Text; -using System.Xml; -//XML存储类 -namespace ryCommon -{ - /// - /// XML操作类 - /// - public class Storage - { - private XmlDocument xmlDoc = new XmlDocument(); - private XmlNode xmlNode; - private XmlElement element; - //private System.Xml.XmlNodeList NodeList2; - /// - /// XML操作类 - /// - public Storage() - { - string strXMLText = ""; - xmlDoc.LoadXml(strXMLText); - } - /// - /// 从XML文本中加载数据 - /// - /// - public Storage(string XMLText) //从XML文本中加载数据 - { - try - { - xmlDoc.LoadXml(XMLText); - } - catch - { - xmlDoc.LoadXml(""); - } - } - #region 从指定的XML文本中加载 - /// - /// 从指定的XML文本中加载 - /// - /// XML文本 - /// 如为1，表示加载成功，为0为失败 - public int LoadFromXMLText(string XMLText) - { - try - { - xmlDoc.LoadXml(XMLText); - return 1; - } - catch - { - xmlDoc.LoadXml(""); - return 0; - } - } - #endregion - #region 加载空的XML文本 - /// - /// 载入空的XML文档 - /// - /// 如为1，表示加载成功，为0为失败 - public int LoadEmptyXMLText() - { - try - { - xmlDoc.LoadXml(""); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 从指定的文件中加载 - /// - /// 从指定的文件中加载 - /// - /// XML文件路径 - /// 如为1，表示加载成功，为0为失败 - public int LoadFromFile(string FilePath) - { - try - { - xmlDoc.Load(FilePath); - return 1; - } - catch - { - xmlDoc.LoadXml(""); - return 0; - } - } - #endregion - #region 保存到指定文件中 - /// - /// 保存到指定文件中 - /// - /// 文件路径 - /// 如为1，表示保存成功，为0为失败 - public int SaveToFile(string sFilePath) - { - try - { - if (sFilePath != "" && !System.IO.Directory.Exists(System.IO.Path.GetDirectoryName(sFilePath))) - { - System.IO.Directory.CreateDirectory(System.IO.Path.GetDirectoryName(sFilePath)); - } - xmlDoc.Save(sFilePath); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 判断节点是否存在 - /// - /// 判断节点是否存在 - /// - /// 属性名 - /// 属性值 - /// 返回1，表示存在，其它表示不存在 - public int HaveNode(string AttrName, string sValue) - { - try - { - //根据指定路径获取节点 - XmlNode xmlNode2 = null; - xmlNode2 = xmlDoc.SelectSingleNode("root/list[@" + AttrName + "='" + sValue + "']"); - if (xmlNode2 == null) - { - return 0; - } - else - { - return 1; - } - } - catch - { - return 0; - } - } - #endregion - #region 定位节点 - /// - /// 定位节点 - /// - /// 属性名 - /// 属性值 - /// 返回第一个符合要求的结果 - public int SelectNode(string AttrName, string sValue) - { - try - { - //根据指定路径获取节点 - element = null; - xmlNode = xmlDoc.SelectSingleNode("root/list[@" + AttrName + "='" + sValue + "']"); - element = (XmlElement)xmlNode; - if (element == null) - { - return 0; - } - else - { - return 1; - } - } - catch - { - return 0; - } - } - #endregion - #region 定位节点2 - /// - /// 定位节点,如果找不到节点，就新建一个节点 - /// - /// 属性名 - /// 属性值 - /// 返回第一个符合要求的结果 - public int SelectNode2(string AttrName, string sValue) - { - try - { - //根据指定路径获取节点 - element = null; - xmlNode = xmlDoc.SelectSingleNode("root/list[@" + AttrName + "='" + sValue + "']"); - element = (XmlElement)xmlNode; - if (element == null) - { - return AddNode2(AttrName, sValue); - } - else - { - return 1; - } - } - catch - { - return 0; - } - } - #endregion - #region 定位节点3 - /// - /// 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 - /// - /// 返回第一个符合要求的结果 - public int SelectNode3(XmlNode m_xmlNode) - { - try - { - //根据指定路径获取节点 - element = null; - xmlNode = m_xmlNode; - element = (XmlElement)xmlNode; - if (element == null) - { - return 0; - } - else - { - return 1; - } - } - catch - { - return 0; - } - } - #endregion - #region 定位设置节点 - /// - /// 定位设置节点 - /// - /// 返回第一个符合要求的结果 - public int SelectNodeBySet() - { - return SelectNode2("id", "Setting"); - } - /// - /// 在节点后插入数据 - /// - /// - /// - public XmlNode InsertAfter(int index) - { - XmlNode root = xmlDoc.SelectSingleNode("root"); - XmlNode refChild = xmlDoc.SelectSingleNode("root//list[" + index + "]"); - return root.InsertAfter(xmlNode, refChild); - } - /// - /// 在节点前插入数据 - /// - /// - /// - public XmlNode InsertBefore(int index) - { - XmlNode root = xmlDoc.SelectSingleNode("root"); - XmlNode refChild = xmlDoc.SelectSingleNode("root//list["+index+"]"); - return root.InsertBefore(xmlNode, refChild); - } - #endregion - #region 获取节点数量 - /// - /// 获取节点数量 - /// - /// 属性名 - /// 属性值 - /// 返回符合要求的结果数量 - public int GetSelectNodeCount(string AttrName, string sValue) - { - try - { - //根据指定路径获取节点 - return xmlDoc.SelectNodes("root/list[@" + AttrName + "='" + sValue + "']").Count; - } - catch - { - return 0; - } - } - #endregion - #region 获取节点数量 - /// - /// 获取节点数量 - /// - /// 返回符合要求的结果数量 - public int GetNodeCount() - { - try - { - //根据指定路径获取节点 - return xmlDoc.SelectNodes("root/list").Count; - } - catch - { - return 0; - } - } - #endregion - private int ConvertInt(string str, int defValue) - { - try - { - return Convert.ToInt32(str); - } - catch - { - return defValue; - } - } - #region 获取节点数量 - /// - /// 获取节点数量 - /// - /// 属性名 - /// 属性值 - /// - /// - /// - /// 返回符合要求的结果数量 - public int GetSelectNodeCount(string AttrName, string sValue, string AttrName2, string Relation, int sValue2) - { - try - { - //根据指定路径获取节点 - XmlNodeList nodelist = xmlDoc.SelectNodes("root/list[@" + AttrName + "='" + sValue + "']"); - int icount = 0; - for (int i = 0; i < nodelist.Count; i++) - { - XmlAttribute attr = nodelist.Item(i).Attributes[AttrName2]; - if (attr != null) - { - switch (Relation) - { - case "<": - if (ConvertInt(attr.Value, 0) < sValue2) - { - icount++; - } - break; - case ">": - if (ConvertInt(attr.Value, 0) > sValue2) - { - icount++; - } - break; - case "=": - if (ConvertInt(attr.Value, 0) == sValue2) - { - icount++; - } - break; - case "<>": - if (ConvertInt(attr.Value, 0) != sValue2) - { - icount++; - } - break; - case ">=": - if (ConvertInt(attr.Value, 0) >= sValue2) - { - icount++; - } - break; - case "<=": - if (ConvertInt(attr.Value, 0) <= sValue2) - { - icount++; - } - break; - } - } - } - return icount; - } - catch - { - return 0; - } - } - #endregion - #region 设置节点值 - /// - /// 设置节点值 - /// - /// 属性名 - /// 属性值 - /// 如为1，表示加载成功，为0为失败 - public int SetAttrValue(string strName, string strValue) - { - try - { //设置节点值 - element.SetAttribute(strName, strValue); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 设置节点值(布尔类型) - /// - /// 设置节点值 - /// - /// 属性名 - /// 属性值 - /// 如为1，表示加载成功，为0为失败 - public int SetAttrValue(string strName, bool strValue) - { - try - { //设置节点值 - string m_value = "0"; - if (strValue == true) { m_value = "1"; } - element.SetAttribute(strName, m_value); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 设置节点值(int类型) - /// - /// 设置节点值 - /// - /// 属性名 - /// 属性值 - /// 如为1，表示加载成功，为0为失败 - public int SetAttrValue(string strName, int strValue) - { - try - { //设置节点值 - element.SetAttribute(strName, strValue.ToString()); - return 1; - } - catch - { - return 0; - } +//--------------------------日期:2017-04-07 +//--------------------------版本:2.0.0 .0 +//--------------------------作者:itrycn +using System; +using System.Collections.Generic; +using System.Text; +using System.Xml; +//XML存储类 +namespace ryCommon +{ + /// + /// XML操作类 + /// + public class Storage + { + private XmlDocument xmlDoc = new XmlDocument(); + private XmlNode xmlNode; + private XmlElement element; + //private System.Xml.XmlNodeList NodeList2; + /// + /// XML操作类 + /// + public Storage() + { + string strXMLText = ""; + xmlDoc.LoadXml(strXMLText); } - #endregion - #region 设置节点值(long类型) - /// - /// 设置节点值 - /// - /// 属性名 - /// 属性值 - /// 如为1，表示加载成功，为0为失败 - public long SetAttrValue(string strName, long strValue) - { - try - { //设置节点值 - element.SetAttribute(strName, strValue.ToString()); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 设置节点值(decimal类型) - /// - /// 设置节点值 - /// - /// 属性名 - /// 属性值 - /// 如为1，表示加载成功，为0为失败 - public int SetAttrValue(string strName, decimal strValue) - { - try - { //设置节点值 - element.SetAttribute(strName, strValue.ToString()); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 设置节点值(double类型) - /// - /// 设置节点值 - /// - /// 属性名 - /// 属性值 - /// 如为1，表示加载成功，为0为失败 - public int SetAttrValue(string strName, double strValue) - { - try - { //设置节点值 - element.SetAttribute(strName, strValue.ToString()); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 设置节点值(日期类型) - /// - /// 设置节点值 - /// - /// 属性名 - /// 属性值 - /// 如为1，表示加载成功，为0为失败 - public int SetAttrValue(string strName, DateTime strValue) - { - try - { //设置节点值 - element.SetAttribute(strName, strValue.ToDateTimeStr()); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 读取指定节点的值 - /// - /// 读取指定节点的值(string) - /// - /// - /// - public string GetAttrValue(string strNode) - { - try - { - if (element == null) { return ""; } - //根据路径获取节点 - return element.GetAttribute(strNode); - } - catch - { - return ""; - } - } - /// - /// 读取指定节点的值 - /// - /// - /// - /// - public string GetAttrValueByBase64(string strNode,string defValue) - { - try - { - //根据路径获取节点 - string str= element.GetAttribute(strNode); - ryCommon.Strings cStr = new Strings(); - string base64 = cStr.Base64ToStr(str); - if (base64 == "") { return defValue; } - return base64; - } - catch - { - return defValue; - } - } - /// - /// 读取指定节点的值 - /// - /// - /// - /// - public bool GetAttrValue(string strNode, bool defValue) - { - return GetAttrValueByBool(strNode, defValue); - } - /// - /// 读取指定节点的值 - /// - /// - /// - /// - public int GetAttrValue(string strNode, int defValue) - { - return GetAttrValueByInt(strNode, defValue); - } - /// - /// 获取属性值 - /// - /// - /// - /// - public long GetAttrValue(string strNode, long defValue) - { - try - { - //根据路径获取节点 - string strTemp = element.GetAttribute(strNode); - return Convert.ToInt64(strTemp); - } - catch - { - return defValue; - } - } - /// - /// 读取指定节点的值 - /// - /// - /// - /// - public decimal GetAttrValue(string strNode, decimal defValue) - { - return GetAttrValueByDecimal(strNode, defValue); - } - /// - /// 读取指定节点的值 - /// - /// - /// - /// - public double GetAttrValue(string strNode, double defValue) - { - try - { - //根据路径获取节点 - string strTemp = element.GetAttribute(strNode); - return Convert.ToDouble(strTemp); - } - catch - { - return defValue; - } - } - /// - /// 读取指定节点的值 - /// - /// - /// - /// - public DateTime GetAttrValue(string strNode, DateTime defValue) - { - return GetAttrValueByDate(strNode, defValue); - } - #endregion - #region 读取指定节点的值 - /// - /// 读取所有的节点名称 - /// - /// - public string[] GetAttrNames() - { - try - { - if (element == null) { return null; } - string[] items = new string[element.Attributes.Count]; - for (int i = 0; i < items.Length; i++) - { - items[i] = element.Attributes.Item(i).Name; - } - //根据路径获取节点 - return items; - } - catch - { - return null; - } - } - #endregion - #region 读取指定节点的值(string) - /// - /// 读取指定节点的值(string) - /// - /// - /// - /// - public string GetAttrValue(string strNode, string defValue) - { - try - { - //根据路径获取节点 - if (element == null) { return defValue; } - string strTemp = element.GetAttribute(strNode); - if (strTemp == "") - { - return defValue; - } - else - { - return strTemp; - } - } - catch - { - return defValue; - } - } - #endregion - #region 读取指定节点的值(int) - /// - /// 读取指定节点的值(int) - /// - /// - /// - /// - public int GetAttrValueByInt(string strNode, int defValue) - { - try - { - //根据路径获取节点 - if (element == null) { return defValue; } - string strTemp = element.GetAttribute(strNode); - return Convert.ToInt32(strTemp); - } - catch - { - return defValue; - } - } - #endregion - #region 读取指定节点的值(decimal) - /// - /// 读取指定节点的值(decimal) - /// - /// - /// - /// - public decimal GetAttrValueByDecimal(string strNode, decimal defValue) - { - try - { - if (element == null) { return defValue; } - //根据路径获取节点 - string strTemp = element.GetAttribute(strNode); - return Convert.ToDecimal(strTemp); - } - catch - { - return defValue; - } - } - #endregion - #region 读取指定节点的值5(布尔值) - /// - /// 读取指定节点的值 - /// - /// - /// - /// - public bool GetAttrValueByBool(string strNode, bool defValue) - { - try - { - if (element == null) { return defValue; } - //根据路径获取节点 - if (!element.HasAttribute(strNode)) { return defValue; } - string strTemp = element.GetAttribute(strNode); - if (strTemp == "1") - { - return true; - } - else - { - return false; - } - } - catch - { - return defValue; - } - } - #endregion - #region 读取指定节点的值6(日期值) - /// - /// 读取指定节点的值 - /// - /// - /// - /// - public DateTime GetAttrValueByDate(string strNode, DateTime defValue) - { - try - { - if (element == null) { return defValue; } - //根据路径获取节点 - string strTemp = element.GetAttribute(strNode); - return Convert.ToDateTime(strTemp); - } - catch - { - return defValue; - } - } - #endregion - /// - /// 获取XML文件的根元素 - /// - public XmlNode GetXmlRoot() - { - return xmlDoc.DocumentElement; - } - #region 获取所有列表 - /// - /// 获取所有列表 - /// - /// 如为1，表示获取成功，为0为失败 - public XmlNodeList GetList() - { - try - { - return xmlDoc.DocumentElement.SelectNodes("child::list"); - } - catch - { - return null; - } - } - #endregion - #region 获取所有列表 - /// - /// 获取所有列表 - /// - /// 如为1，表示获取成功，为0为失败 - public XmlNodeList GetList(string xpath) - { - try - { - return xmlDoc.DocumentElement.SelectNodes(xpath); - } - catch - { - return null; - } - } - #endregion - #region 新增节点 - /// - /// 新增节点 - /// - /// - /// - /// - public int AddNode(string strName, string strValue) - { - try - { - XmlNode xmlNode2 = xmlDoc.SelectSingleNode("root"); - XmlNode childXmlNode = xmlDoc.CreateElement("list"); - xmlNode2.AppendChild(childXmlNode); - XmlElement element2 = (XmlElement)childXmlNode; - element2.SetAttribute(strName, strValue); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 新增节点并定位到新节点 - /// - /// 新增节点并定位到新节点 - /// - /// - /// - /// - public int AddNode2(string strName, string strValue) - { - try - { - XmlNode xmlNode2 = xmlDoc.SelectSingleNode("root"); - xmlNode = xmlDoc.CreateElement("list"); - xmlNode2.AppendChild(xmlNode); - element = (XmlElement)xmlNode; - element.SetAttribute(strName, strValue); - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 新增设置节点并定位 - /// - /// 新增设置节点并定位 - /// - /// - public int AddNodeBySet() - { - return AddNode2("id", "Setting"); - } - #endregion - #region 新增节点并定位到新节点 - /// - /// 在指定节点前新增节点并定位到新节点 - /// - /// - /// - /// - /// - public int AddNodeBefore(string strName, string strValue, XmlNode xn) - { - try - { - XmlNode xmlNode2 = xmlDoc.SelectSingleNode("root"); - xmlNode = xmlDoc.CreateElement("list"); - xmlNode2.InsertBefore(xmlNode, xn); - element = (XmlElement)xmlNode; - element.SetAttribute(strName, strValue); - return 1; - } - catch - { - return 0; - } - } - #endregion - /// - /// 获取当前节点 - /// - /// - public XmlNode GetNowXMLNode() - { - return xmlNode; - } - #region 删除节点 - /// - /// 删除节点 - /// - /// - public int DeleteNode() - { - try - { - //element.RemoveAll(); - GetXmlRoot().RemoveChild(xmlNode); - xmlNode = null; - element = null; - return 1; - } - catch - { - return 0; - } - } - #endregion - #region 获取XML文本 - /// - /// 获取XML文本 - /// - /// - public string GetXMLText() - { - return xmlDoc.OuterXml; - } - /// - /// 获取XML文本 - /// - /// - public string XMLText - { - get { return xmlDoc.OuterXml; } - } - #endregion - #region 获取XML文本 - /// - /// 获取文本 - /// - /// - public string GetText() - { - return xmlDoc.ToString(); ; - } - /// - /// 获取文本 - /// - /// - public string Text - { - get { return xmlDoc.ToString(); } - } - #endregion - } -} + /// + /// 从XML文本中加载数据 + /// + /// + public Storage(string XMLText) //从XML文本中加载数据 + { + try + { + xmlDoc.LoadXml(XMLText); + } + catch + { + xmlDoc.LoadXml(""); + } + } + #region 从指定的XML文本中加载 + /// + /// 从指定的XML文本中加载 + /// + /// XML文本 + /// 如为1，表示加载成功，为0为失败 + public int LoadFromXMLText(string XMLText) + { + try + { + xmlDoc.LoadXml(XMLText); + return 1; + } + catch + { + xmlDoc.LoadXml(""); + return 0; + } + } + #endregion + #region 加载空的XML文本 + /// + /// 载入空的XML文档 + /// + /// 如为1，表示加载成功，为0为失败 + public int LoadEmptyXMLText() + { + try + { + xmlDoc.LoadXml(""); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 从指定的文件中加载 + /// + /// 从指定的文件中加载 + /// + /// XML文件路径 + /// 如为1，表示加载成功，为0为失败 + public int LoadFromFile(string FilePath) + { + try + { + xmlDoc.Load(FilePath); + return 1; + } + catch + { + xmlDoc.LoadXml(""); + return 0; + } + } + #endregion + #region 保存到指定文件中 + /// + /// 保存到指定文件中 + /// + /// 文件路径 + /// 如为1，表示保存成功，为0为失败 + public int SaveToFile(string sFilePath) + { + try + { + if (sFilePath != "" && !System.IO.Directory.Exists(System.IO.Path.GetDirectoryName(sFilePath))) + { + System.IO.Directory.CreateDirectory(System.IO.Path.GetDirectoryName(sFilePath)); + } + xmlDoc.Save(sFilePath); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 判断节点是否存在 + /// + /// 判断节点是否存在 + /// + /// 属性名 + /// 属性值 + /// 返回1，表示存在，其它表示不存在 + public int HaveNode(string AttrName, string sValue) + { + try + { + //根据指定路径获取节点 + XmlNode xmlNode2 = null; + xmlNode2 = xmlDoc.SelectSingleNode("root/list[@" + AttrName + "='" + sValue + "']"); + if (xmlNode2 == null) + { + return 0; + } + else + { + return 1; + } + } + catch + { + return 0; + } + } + #endregion + #region 定位节点 + /// + /// 定位节点 + /// + /// 属性名 + /// 属性值 + /// 返回第一个符合要求的结果 + public int SelectNode(string AttrName, string sValue) + { + try + { + //根据指定路径获取节点 + element = null; + xmlNode = xmlDoc.SelectSingleNode("root/list[@" + AttrName + "='" + sValue + "']"); + element = (XmlElement)xmlNode; + if (element == null) + { + return 0; + } + else + { + return 1; + } + } + catch + { + return 0; + } + } + #endregion + #region 定位节点2 + /// + /// 定位节点,如果找不到节点，就新建一个节点 + /// + /// 属性名 + /// 属性值 + /// 返回第一个符合要求的结果 + public int SelectNode2(string AttrName, string sValue) + { + try + { + //根据指定路径获取节点 + element = null; + xmlNode = xmlDoc.SelectSingleNode("root/list[@" + AttrName + "='" + sValue + "']"); + element = (XmlElement)xmlNode; + if (element == null) + { + return AddNode2(AttrName, sValue); + } + else + { + return 1; + } + } + catch + { + return 0; + } + } + #endregion + #region 定位节点3 + /// + /// 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 + /// + /// 返回第一个符合要求的结果 + public int SelectNode3(XmlNode m_xmlNode) + { + try + { + //根据指定路径获取节点 + element = null; + xmlNode = m_xmlNode; + element = (XmlElement)xmlNode; + if (element == null) + { + return 0; + } + else + { + return 1; + } + } + catch + { + return 0; + } + } + #endregion + #region 定位设置节点 + /// + /// 定位设置节点 + /// + /// 返回第一个符合要求的结果 + public int SelectNodeBySet() + { + return SelectNode2("id", "Setting"); + } + /// + /// 在节点后插入数据 + /// + /// + /// + public XmlNode InsertAfter(int index) + { + XmlNode root = xmlDoc.SelectSingleNode("root"); + XmlNode refChild = xmlDoc.SelectSingleNode("root//list[" + index + "]"); + return root.InsertAfter(xmlNode, refChild); + } + /// + /// 在节点前插入数据 + /// + /// + /// + public XmlNode InsertBefore(int index) + { + XmlNode root = xmlDoc.SelectSingleNode("root"); + XmlNode refChild = xmlDoc.SelectSingleNode("root//list["+index+"]"); + return root.InsertBefore(xmlNode, refChild); + } + #endregion + #region 获取节点数量 + /// + /// 获取节点数量 + /// + /// 属性名 + /// 属性值 + /// 返回符合要求的结果数量 + public int GetSelectNodeCount(string AttrName, string sValue) + { + try + { + //根据指定路径获取节点 + return xmlDoc.SelectNodes("root/list[@" + AttrName + "='" + sValue + "']").Count; + } + catch + { + return 0; + } + } + #endregion + #region 获取节点数量 + /// + /// 获取节点数量 + /// + /// 返回符合要求的结果数量 + public int GetNodeCount() + { + try + { + //根据指定路径获取节点 + return xmlDoc.SelectNodes("root/list").Count; + } + catch + { + return 0; + } + } + #endregion + private int ConvertInt(string str, int defValue) + { + try + { + return Convert.ToInt32(str); + } + catch + { + return defValue; + } + } + #region 获取节点数量 + /// + /// 获取节点数量 + /// + /// 属性名 + /// 属性值 + /// + /// + /// + /// 返回符合要求的结果数量 + public int GetSelectNodeCount(string AttrName, string sValue, string AttrName2, string Relation, int sValue2) + { + try + { + //根据指定路径获取节点 + XmlNodeList nodelist = xmlDoc.SelectNodes("root/list[@" + AttrName + "='" + sValue + "']"); + int icount = 0; + for (int i = 0; i < nodelist.Count; i++) + { + XmlAttribute attr = nodelist.Item(i).Attributes[AttrName2]; + if (attr != null) + { + switch (Relation) + { + case "<": + if (ConvertInt(attr.Value, 0) < sValue2) + { + icount++; + } + break; + case ">": + if (ConvertInt(attr.Value, 0) > sValue2) + { + icount++; + } + break; + case "=": + if (ConvertInt(attr.Value, 0) == sValue2) + { + icount++; + } + break; + case "<>": + if (ConvertInt(attr.Value, 0) != sValue2) + { + icount++; + } + break; + case ">=": + if (ConvertInt(attr.Value, 0) >= sValue2) + { + icount++; + } + break; + case "<=": + if (ConvertInt(attr.Value, 0) <= sValue2) + { + icount++; + } + break; + } + } + } + return icount; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值 + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, string strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(布尔类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, bool strValue) + { + try + { //设置节点值 + string m_value = "0"; + if (strValue == true) { m_value = "1"; } + element.SetAttribute(strName, m_value); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(int类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, int strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToString()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(long类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public long SetAttrValue(string strName, long strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToString()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(decimal类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, decimal strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToString()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(double类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, double strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToString()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(日期类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, DateTime strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToDateTimeStr()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 读取指定节点的值 + /// + /// 读取指定节点的值(string) + /// + /// + /// + public string GetAttrValue(string strNode) + { + try + { + if (element == null) { return ""; } + //根据路径获取节点 + return element.GetAttribute(strNode); + } + catch + { + return ""; + } + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public string GetAttrValueByBase64(string strNode,string defValue) + { + try + { + //根据路径获取节点 + string str= element.GetAttribute(strNode); + ryCommon.Strings cStr = new Strings(); + string base64 = cStr.Base64ToStr(str); + if (base64 == "") { return defValue; } + return base64; + } + catch + { + return defValue; + } + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public bool GetAttrValue(string strNode, bool defValue) + { + return GetAttrValueByBool(strNode, defValue); + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public int GetAttrValue(string strNode, int defValue) + { + return GetAttrValueByInt(strNode, defValue); + } + /// + /// 获取属性值 + /// + /// + /// + /// + public long GetAttrValue(string strNode, long defValue) + { + try + { + //根据路径获取节点 + string strTemp = element.GetAttribute(strNode); + return Convert.ToInt64(strTemp); + } + catch + { + return defValue; + } + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public decimal GetAttrValue(string strNode, decimal defValue) + { + return GetAttrValueByDecimal(strNode, defValue); + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public double GetAttrValue(string strNode, double defValue) + { + try + { + //根据路径获取节点 + string strTemp = element.GetAttribute(strNode); + return Convert.ToDouble(strTemp); + } + catch + { + return defValue; + } + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public DateTime GetAttrValue(string strNode, DateTime defValue) + { + return GetAttrValueByDate(strNode, defValue); + } + #endregion + #region 读取指定节点的值 + /// + /// 读取所有的节点名称 + /// + /// + public string[] GetAttrNames() + { + try + { + if (element == null) { return null; } + string[] items = new string[element.Attributes.Count]; + for (int i = 0; i < items.Length; i++) + { + items[i] = element.Attributes.Item(i).Name; + } + //根据路径获取节点 + return items; + } + catch + { + return null; + } + } + #endregion + #region 读取指定节点的值(string) + /// + /// 读取指定节点的值(string) + /// + /// + /// + /// + public string GetAttrValue(string strNode, string defValue) + { + try + { + //根据路径获取节点 + if (element == null) { return defValue; } + string strTemp = element.GetAttribute(strNode); + if (strTemp == "") + { + return defValue; + } + else + { + return strTemp; + } + } + catch + { + return defValue; + } + } + #endregion + #region 读取指定节点的值(int) + /// + /// 读取指定节点的值(int) + /// + /// + /// + /// + public int GetAttrValueByInt(string strNode, int defValue) + { + try + { + //根据路径获取节点 + if (element == null) { return defValue; } + string strTemp = element.GetAttribute(strNode); + return Convert.ToInt32(strTemp); + } + catch + { + return defValue; + } + } + #endregion + #region 读取指定节点的值(decimal) + /// + /// 读取指定节点的值(decimal) + /// + /// + /// + /// + public decimal GetAttrValueByDecimal(string strNode, decimal defValue) + { + try + { + if (element == null) { return defValue; } + //根据路径获取节点 + string strTemp = element.GetAttribute(strNode); + return Convert.ToDecimal(strTemp); + } + catch + { + return defValue; + } + } + #endregion + #region 读取指定节点的值5(布尔值) + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public bool GetAttrValueByBool(string strNode, bool defValue) + { + try + { + if (element == null) { return defValue; } + //根据路径获取节点 + if (!element.HasAttribute(strNode)) { return defValue; } + string strTemp = element.GetAttribute(strNode); + if (strTemp == "1") + { + return true; + } + else + { + return false; + } + } + catch + { + return defValue; + } + } + #endregion + #region 读取指定节点的值6(日期值) + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public DateTime GetAttrValueByDate(string strNode, DateTime defValue) + { + try + { + if (element == null) { return defValue; } + //根据路径获取节点 + string strTemp = element.GetAttribute(strNode); + return Convert.ToDateTime(strTemp); + } + catch + { + return defValue; + } + } + #endregion + /// + /// 获取XML文件的根元素 + /// + public XmlNode GetXmlRoot() + { + return xmlDoc.DocumentElement; + } + #region 获取所有列表 + /// + /// 获取所有列表 + /// + /// 如为1，表示获取成功，为0为失败 + public XmlNodeList GetList() + { + try + { + return xmlDoc.DocumentElement.SelectNodes("child::list"); + } + catch + { + return null; + } + } + #endregion + #region 获取所有列表 + /// + /// 获取所有列表 + /// + /// 如为1，表示获取成功，为0为失败 + public XmlNodeList GetList(string xpath) + { + try + { + return xmlDoc.DocumentElement.SelectNodes(xpath); + } + catch + { + return null; + } + } + #endregion + #region 新增节点 + /// + /// 新增节点 + /// + /// + /// + /// + public int AddNode(string strName, string strValue) + { + try + { + XmlNode xmlNode2 = xmlDoc.SelectSingleNode("root"); + XmlNode childXmlNode = xmlDoc.CreateElement("list"); + xmlNode2.AppendChild(childXmlNode); + XmlElement element2 = (XmlElement)childXmlNode; + element2.SetAttribute(strName, strValue); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 新增节点并定位到新节点 + /// + /// 新增节点并定位到新节点 + /// + /// + /// + /// + public int AddNode2(string strName, string strValue) + { + try + { + XmlNode xmlNode2 = xmlDoc.SelectSingleNode("root"); + xmlNode = xmlDoc.CreateElement("list"); + xmlNode2.AppendChild(xmlNode); + element = (XmlElement)xmlNode; + element.SetAttribute(strName, strValue); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 新增设置节点并定位 + /// + /// 新增设置节点并定位 + /// + /// + public int AddNodeBySet() + { + return AddNode2("id", "Setting"); + } + #endregion + #region 新增节点并定位到新节点 + /// + /// 在指定节点前新增节点并定位到新节点 + /// + /// + /// + /// + /// + public int AddNodeBefore(string strName, string strValue, XmlNode xn) + { + try + { + XmlNode xmlNode2 = xmlDoc.SelectSingleNode("root"); + xmlNode = xmlDoc.CreateElement("list"); + xmlNode2.InsertBefore(xmlNode, xn); + element = (XmlElement)xmlNode; + element.SetAttribute(strName, strValue); + return 1; + } + catch + { + return 0; + } + } + #endregion + /// + /// 获取当前节点 + /// + /// + public XmlNode GetNowXMLNode() + { + return xmlNode; + } + #region 删除节点 + /// + /// 删除节点 + /// + /// + public int DeleteNode() + { + try + { + //element.RemoveAll(); + GetXmlRoot().RemoveChild(xmlNode); + xmlNode = null; + element = null; + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 获取XML文本 + /// + /// 获取XML文本 + /// + /// + public string GetXMLText() + { + return xmlDoc.OuterXml; + } + /// + /// 获取XML文本 + /// + /// + public string XMLText + { + get { return xmlDoc.OuterXml; } + } + #endregion + #region 获取XML文本 + /// + /// 获取文本 + /// + /// + public string GetText() + { + return xmlDoc.ToString(); ; + } + /// + /// 获取文本 + /// + /// + public string Text + { + get { return xmlDoc.InnerText; } + } + #endregion + } +} diff --git a/Source/MyDb/DbManage/VarExtension.cs b/Source/MyDb/DbManage/VarExtension.cs index cf40294..0d3b5cf 100644 --- a/Source/MyDb/DbManage/VarExtension.cs +++ b/Source/MyDb/DbManage/VarExtension.cs @@ -1,6 +1,8 @@ using System; using System.Collections.Generic; +using System.Drawing; using System.Linq; +using System.Security.Policy; using System.Text; namespace ryCommon @@ -55,6 +57,15 @@ namespace ryCommon } } /// + /// 将颜色转换为Html颜色格式 + /// + /// + /// + static public string ToHtmlColor(this Color color) + { + return System.Drawing.ColorTranslator.ToHtml(color); + } + /// /// 支持忽略大小写的替换文本功能 /// /// @@ -159,6 +170,7 @@ namespace ryCommon { try { + if (input == null) { return defValue; } int tmpI = Convert.ToInt32(input); if (tmpI < minValue || tmpI > maxValue) { @@ -190,6 +202,7 @@ namespace ryCommon { try { + if (input == null) { return defValue; } return Convert.ToInt32(input); } catch @@ -339,6 +352,7 @@ namespace ryCommon { try { + if (input == null) { return defValue; } return Convert.ToDouble(input); } catch { return defValue; } @@ -352,6 +366,7 @@ namespace ryCommon { try { + if (input == null) { return 0; } return Convert.ToDouble(input); } catch { return 0d; } @@ -480,6 +495,7 @@ namespace ryCommon { try { + if (input == null) { return defValue; } double tmpI = Convert.ToDouble(input); if (tmpI < minValue || tmpI > maxValue) { @@ -520,6 +536,7 @@ namespace ryCommon { try { + if (input == null) { return defValue; } return Convert.ToDecimal(input); } catch { return defValue; } @@ -533,6 +550,7 @@ namespace ryCommon { try { + if (input == null) { return 0; } return Convert.ToDecimal(input); } catch { return 0; } @@ -549,6 +567,7 @@ namespace ryCommon { try { + if (input == null) { return defValue; } decimal tmpI = Convert.ToDecimal(input); if (tmpI < minValue || tmpI > maxValue) { @@ -571,6 +590,7 @@ namespace ryCommon { try { + if (input == null) { return defValue; } return Convert.ToDateTime(input); } catch { return defValue; } @@ -584,6 +604,7 @@ namespace ryCommon { try { + if (input == null) { return Convert.ToDateTime("2000-1-1"); } return Convert.ToDateTime(input); } catch { return Convert.ToDateTime("2000-1-1"); } @@ -595,6 +616,7 @@ namespace ryCommon /// static public bool ToBool(this object input) { + if(input == null) { return false; } return (input.ToString() == "1" || input.ToString().ToLower() == "true" || input is true); } /// @@ -676,6 +698,7 @@ namespace ryCommon { try { + if (input == null) { return false; } Convert.ToInt64(input); return input.ToString().IndexOf(".") < 0; } diff --git a/Source/MyDb/FileFuns/BigFileOp.cs b/Source/MyDb/FileFuns/BigFileOp.cs index 60c55c3..e7ea403 100644 --- a/Source/MyDb/FileFuns/BigFileOp.cs +++ b/Source/MyDb/FileFuns/BigFileOp.cs @@ -41,9 +41,12 @@ namespace ryCommon //读取复制文件流 using (FileStream fsRead = new FileStream(soucrePath, FileMode.Open, FileAccess.Read)) { - if (RyFiles.DeleteFile(targetPath) != 0) + if (System.IO.File.Exists(targetPath)) { - return false; + if (RyFiles.DeleteFile(targetPath) != 0) + { + return false; + } } RyFiles.CreateDirectory(System.IO.Path.GetDirectoryName(targetPath)); OnProgress?.Invoke(0, fsRead.Length, 0); @@ -103,6 +106,27 @@ namespace ryCommon return CopyFolder(fromDir,ToDir,0,-1,out _); } /// + /// 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + /// + /// 源路径 + /// 目标路径 + /// 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + public int CopyFileOrFolder(string fromPath, string ToPath) + { + if(System.IO.File.Exists(fromPath)) + { + return CopyBigFile(fromPath, ToPath)?0:-1; + } + else if (System.IO.Directory.Exists(fromPath)) + { + return CopyFolder(fromPath, ToPath, 0, -1, out _); + } + else + { + return 1; + } + } + /// /// 复制文件夹到目标文件夹,支持进度事件,支持中途取消 /// /// 源文件夹 diff --git a/Source/MyDb/FileFuns/ElevatedDragDropManager.cs b/Source/MyDb/FileFuns/ElevatedDragDropManager.cs index 9648209..95e3ee4 100644 --- a/Source/MyDb/FileFuns/ElevatedDragDropManager.cs +++ b/Source/MyDb/FileFuns/ElevatedDragDropManager.cs @@ -108,11 +108,18 @@ public class ElevatedDragDropManager : IMessageFilter /// /// /// - protected ElevatedDragDropManager() + public ElevatedDragDropManager() { Application.AddMessageFilter(this); } /// + /// + /// + public void Remove() + { + Application.RemoveMessageFilter(this); + } + /// /// 使管理员方式运行时支持拖放 /// /// diff --git a/Source/MyDb/FileFuns/FileInfo.cs b/Source/MyDb/FileFuns/FileInfo.cs index fb6d0e4..7a17e0d 100644 --- a/Source/MyDb/FileFuns/FileInfo.cs +++ b/Source/MyDb/FileFuns/FileInfo.cs @@ -1,45 +1,45 @@ -using System; -using System.Collections.Generic; -using System.Linq; -using System.Reflection; -using System.Text; -using System.Windows.Forms; - -namespace ryCommon -{ - /// - /// 文件信息 - /// - public class RySoft - { - /// - /// 获取版本号 - /// - public static string VersionStr - { - get - { - //Version ver = Assembly.LoadFile(Application.ExecutablePath).GetName().Version; - //Version ver = Assembly.GetEntryAssembly().GetName().Version; - //return ver.Major.ToString() + "." + ver.Minor.ToString() + "." + ver.Build.ToString() + "." + ver.; - return GetVersionStr(Application.ExecutablePath); - } - } - /// - /// 获取版本号 - /// - /// - /// - public static string GetVersionStr(string exe_path) - { - try - { - System.Diagnostics.FileVersionInfo info = System.Diagnostics.FileVersionInfo.GetVersionInfo(exe_path); - return info.ProductVersion; - } - catch { return ""; } - //Version ver = Assembly.LoadFile(exe_path).GetName().Version; - //return ver.Major.ToString() + "." + ver.Minor.ToString() + "." + ver.Build.ToString() + "." + ver.Revision.ToString(); +using System; +using System.Collections.Generic; +using System.Linq; +using System.Reflection; +using System.Text; +using System.Windows.Forms; + +namespace ryCommon +{ + /// + /// 文件信息 + /// + public class RySoft + { + /// + /// 获取版本号 + /// + public static string VersionStr + { + get + { + //Version ver = Assembly.LoadFile(Application.ExecutablePath).GetName().Version; + //Version ver = Assembly.GetEntryAssembly().GetName().Version; + //return ver.Major.ToString() + "." + ver.Minor.ToString() + "." + ver.Build.ToString() + "." + ver.; + return GetVersionStr(Application.ExecutablePath); + } + } + /// + /// 获取版本号 + /// + /// + /// + public static string GetVersionStr(string exe_path) + { + try + { + System.Diagnostics.FileVersionInfo info = System.Diagnostics.FileVersionInfo.GetVersionInfo(exe_path); + return info.ProductVersion; + } + catch { return ""; } + //Version ver = Assembly.LoadFile(exe_path).GetName().Version; + //return ver.Major.ToString() + "." + ver.Minor.ToString() + "." + ver.Build.ToString() + "." + ver.Revision.ToString(); } /// /// 根据版本字符串输出double类型的版本号 @@ -47,40 +47,141 @@ namespace ryCommon /// /// /// - public static void GetVerByVerStr(string ver, out double _softVer, out double _reVer) - { - _softVer = 0; - _reVer = 0; - string[] ver_item = ver.Split('.'); - switch (ver_item.Length) - { - case 1: - _softVer = ver_item[0].ToDouble(0); - break; - case 2: - _softVer = ver.ToDouble(0); - break; - case 3: - _softVer = (ver_item[0] + "." + ver_item[1]).ToDouble(0); - _reVer = ver_item[2].ToDouble(0); - break; - case 4: - _softVer = (ver_item[0] + "." + ver_item[1]).ToDouble(0); - _reVer = (ver_item[2] + "." + ver_item[3]).ToDouble(0); - break; - } - } + public static void GetVerByVerStr(string ver, out double _softVer, out double _reVer) + { + _softVer = 0; + _reVer = 0; + string[] ver_item = ver.Split('.'); + switch (ver_item.Length) + { + case 1: + _softVer = ver_item[0].ToDouble(0); + break; + case 2: + _softVer = ver.ToDouble(0); + break; + case 3: + _softVer = (ver_item[0] + "." + ver_item[1]).ToDouble(0); + _reVer = ver_item[2].ToDouble(0); + break; + case 4: + _softVer = (ver_item[0] + "." + ver_item[1]).ToDouble(0); + _reVer = (ver_item[2] + "." + ver_item[3]).ToDouble(0); + break; + } + } + /// /// 比较两个版本号大小 /// /// - /// - /// oldVer小于newVer,返回1,大于则返回-1,相等返回0 - public static int CompareVer(string oldVer,string NewVer) + /// + /// oldVer小于newVer,返回1,大于则返回-1,相等返回0,不支持则返回-1000 + public static int CompareVer(string oldVer,string newVer) { - GetVerByVerStr(oldVer, out double _old_softVer, out double _old_reVer); - GetVerByVerStr(NewVer, out double _new_softVer, out double _new_reVer); - return CompareVer(_old_softVer, _old_reVer, _new_softVer, _new_reVer); + if (oldVer == newVer) { return 0; } + var _oldVer = oldVer; + var _newVer = newVer; + if (_oldVer.StartsWith("v", StringComparison.OrdinalIgnoreCase)) { _oldVer = _oldVer.Substring(1); } + if (_newVer.StartsWith("v", StringComparison.OrdinalIgnoreCase)) { _newVer = _newVer.Substring(1); } + var have_ts = false; + if (!_oldVer.Replace(".", "").Replace("_", "").IsInt()) + { + _oldVer = GetVer(_oldVer); + have_ts = true; + if (_oldVer.Length == 0) + { + return -1000; + } + } + if (!_newVer.Replace(".", "").Replace("_", "").IsInt()) + { + _newVer = GetVer(_newVer); + have_ts = true; + if (_newVer.Length == 0) + { + return -1000; + } + } + var old_split = _oldVer.Split("._".ToCharArray()); + var new_split = _newVer.Split("._".ToCharArray()); + for (int i = 0; i < new_split.Length; i++) + { + var item_new = new_split[i].ToInt(); + var item_old = 0; + if (old_split.Length > i) { item_old = old_split[i].ToInt(); } + if (item_new > item_old) { return 1; } + if (item_new < item_old) { return -1; } + } + if (have_ts) + { + return -1000; + } + return 0; + } + /// + /// 从字符串中提取版本号 + /// + /// + /// + public static string GetVer(string _VerStr) + { + var have_ver = false; + var ResName = _VerStr.Replace("最新破解版", "").Replace("中文版", "").Replace("完美直装版", ""); + var start = ResName.Length; + while (start >= 1) + { + var word = ResName.Substring(start - 1, 1); + if (word == "." || word.IsInt()) + { + have_ver = true; + start--; + } + else + { + break; + } + } + if (have_ver) + { + var ver = ResName.Substring(start); + if (ver.IsInt()) + { + var ver2 = GetVer(ResName.Substring(0, start)); + if (ver2.Length > 0) + { + return ver2; + } + } + return ver; + } + else + { + start = ResName.Length; + var end_index = -1; + while (start >= 1) + { + var word = ResName.Substring(start - 1, 1); + if (word == "." || word.IsInt()) + { + if (end_index == -1) { end_index = start - 1; } + have_ver = true; + } + else + { + if (end_index != -1) + { + break; + } + } + start--; + } + if (have_ver) + { + return ResName.Substring(start, end_index - start + 1); + } + return ""; + } } /// /// 比较版本号 @@ -89,7 +190,7 @@ namespace ryCommon /// /// /// - /// old小于new,返回1,大于则返回-1,相等返回0 + /// old小于new,返回1,大于则返回-1,相等返回0 public static int CompareVer(double _old_softVer,double _old_reVer, double _new_softVer, double _new_reVer) { if (_old_softVer < _new_softVer) { return 1; } @@ -100,16 +201,16 @@ namespace ryCommon else { return -1; } } else { return -1; } - } - /// - /// 判断是否是管理员方式运行 - /// - /// - public static bool IsAdministrator() - { - System.Security.Principal.WindowsIdentity identity = System.Security.Principal.WindowsIdentity.GetCurrent(); - System.Security.Principal.WindowsPrincipal principal = new System.Security.Principal.WindowsPrincipal(identity); - return principal.IsInRole(System.Security.Principal.WindowsBuiltInRole.Administrator); - } - } -} + } + /// + /// 判断是否是管理员方式运行 + /// + /// + public static bool IsAdministrator() + { + System.Security.Principal.WindowsIdentity identity = System.Security.Principal.WindowsIdentity.GetCurrent(); + System.Security.Principal.WindowsPrincipal principal = new System.Security.Principal.WindowsPrincipal(identity); + return principal.IsInRole(System.Security.Principal.WindowsBuiltInRole.Administrator); + } + } +} diff --git a/Source/MyDb/FileFuns/Hosts.cs b/Source/MyDb/FileFuns/Hosts.cs index 1c508db..23c1b9c 100644 --- a/Source/MyDb/FileFuns/Hosts.cs +++ b/Source/MyDb/FileFuns/Hosts.cs @@ -71,35 +71,36 @@ namespace ryCommon public static int AddHosts(string list,bool write) { var hosts_path= ryCommon.RyFiles.GetRealPath("\\drivers\\etc\\hosts"); - var content = ryCommon.RyFiles.ReadAllText(hosts_path).Trim(); - var from_list = GetHosts(content); - var _list = GetHosts(list); + var sys_content = ryCommon.RyFiles.ReadAllText(hosts_path).Trim(); + var sys_list = GetHosts(sys_content); + var rule_list = GetHosts(list); bool isAdd = false;//是否有增加数据到hosts里 - for (int i = 0; i < _list.Count; i++) + for (int i = 0; i < rule_list.Count; i++) { + if (rule_list[i].Comment.Length > 0) { continue; } bool HaveRecord = false; - for (int m = from_list.Count-1; m>=0; m--) //去host文件里查找是否已含有该内容 + for (int m = sys_list.Count-1; m>=0; m--) //去host文件里查找是否已含有该内容 { - if (from_list[m].Comment.Length > 0) { continue; } - if(_list[i].Domain.ToLower()== from_list[m].Domain.ToLower()) + if (sys_list[m].Comment.Length > 0) { continue; } + if(rule_list[i].Domain.ToLower()== sys_list[m].Domain.ToLower()) { - if (_list[i].IP.Length == 0 && _list[i].IsDel) + if (rule_list[i].IP.Length == 0 && rule_list[i].IsDel) { - from_list.RemoveAt(m); + sys_list.RemoveAt(m); HaveRecord = true; } else { - if (_list[i].IP != from_list[m].IP) //如果同样域名对应的ip不一样,则删除该项,然后再插入新的ip + if (rule_list[i].IP != sys_list[m].IP) //如果同样域名对应的ip不一样,则删除该项,然后再插入新的ip { - from_list.RemoveAt(m); + sys_list.RemoveAt(m); HaveRecord = false; } else { - if (_list[i].IsDel) //如果ip和网址一致,并且标注为删除,则删除 + if (rule_list[i].IsDel) //如果ip和网址一致,并且标注为删除,则删除 { - from_list.RemoveAt(m); + sys_list.RemoveAt(m); } HaveRecord = true; } @@ -109,7 +110,7 @@ namespace ryCommon if(!HaveRecord) { isAdd = true; - from_list.Add(_list[i]); + sys_list.Add(rule_list[i]); } } if (isAdd) @@ -118,20 +119,20 @@ namespace ryCommon { try { - content = ""; - for (int i = 0; i < from_list.Count; i++) + sys_content = ""; + for (int i = 0; i < sys_list.Count; i++) { - if (content.Length > 0) { content += "\r\n"; } - if (from_list[i].Comment.Length > 0) + if (sys_content.Length > 0) { sys_content += "\r\n"; } + if (sys_list[i].Comment.Length > 0) { - content += from_list[i].Comment; + sys_content += sys_list[i].Comment; } else { - content += from_list[i].IP + "\t" + from_list[i].Domain; + sys_content += sys_list[i].IP + "\t" + sys_list[i].Domain; } } - ryCommon.RyFiles.WriteAllText(hosts_path, content, Encoding.UTF8); + ryCommon.RyFiles.WriteAllText(hosts_path, sys_content, Encoding.UTF8); } catch { diff --git a/Source/MyDb/FileFuns/RyFiles.cs b/Source/MyDb/FileFuns/RyFiles.cs index 32c9c45..21dbc54 100644 --- a/Source/MyDb/FileFuns/RyFiles.cs +++ b/Source/MyDb/FileFuns/RyFiles.cs @@ -359,6 +359,16 @@ namespace ryCommon return file_op.CopyBigFile(soucrePath, targetPath); } /// + /// 复制文件或文件夹到目标路径,不支持进度事件,支持中途取消 + /// + /// 源路径 + /// 目标路径 + /// 返回复制操作是否成功的标识，成功返回0，负数表示复制失败的文件数量。1表示源文件夹不存在 + public static int CopyFileOrFolder(string fromPath, string ToPath) + { + return file_op.CopyFileOrFolder(fromPath,ToPath); + } + /// /// 复制文件夹到目标文件夹(从3.0.2205.2601版本起已更换实现底层) /// /// 源文件夹 @@ -528,11 +538,15 @@ namespace ryCommon { var result = new sType.FileTime(); FileInfo fi = new FileInfo(fileName); - result.AccessTime = fi.LastAccessTime; - result.CreateTime = fi.CreationTime; - result.LastWriteTime = fi.LastWriteTime; + result.AccessTime = GetSecondTime(fi.LastAccessTime); + result.CreateTime = GetSecondTime(fi.CreationTime); + result.LastWriteTime = GetSecondTime(fi.LastWriteTime); return result; } + private static DateTime GetSecondTime(DateTime dt) + { + return new DateTime(dt.Year, dt.Month, dt.Day, dt.Hour, dt.Minute, dt.Second, dt.Millisecond); + } /// /// 解释错误代码 /// @@ -648,6 +662,32 @@ namespace ryCommon return RunFile(url, ""); } /// + /// 判断是否为空的文件夹 + /// + /// + /// + public static bool IsEmptyDir(string path) + { + var files = System.IO.Directory.GetFiles(path); + if(files!=null && files.Length > 0) { return false; } + var subdirs = System.IO.Directory.GetDirectories(path); + if(subdirs!=null && subdirs.Length > 0) { return false; } + return true; + } + /// + /// 文件或文件夹是否存在 + /// + /// + /// + public static bool FileOrDirExist(string path) + { + if(System.IO.File.Exists(path) || System.IO.Directory.Exists(path)) + { + return true; + } + return false; + } + /// /// 判断文件名是否有效 /// /// @@ -788,27 +828,22 @@ namespace ryCommon System.IO.File.WriteAllText(path, content, encoding); } /// + /// 以UTF-8格式写入所有文本到文件,如果文件夹不存在，会自动创建 + /// + /// + /// + public static void WriteAllText(string path, string content) + { + WriteAllText(path, content, Encoding.UTF8); + } + /// /// 从文件中加载图片,使用本方法，不会导致图片文件被占用。 /// /// + [Obsolete("当前方法已过期,请使用RyImage.LoadPic方法")] public static Image LoadPicFromFile(string path) { - if(!System.IO.File.Exists(path)) - { return null; } - try - { - FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read); - //把文件读取到字节数组 - byte[] data = new byte[fs.Length]; - fs.Read(data, 0, data.Length); - fs.Close(); - - //实例化一个内存流--->把从文件流中读取的内容[字节数组]放到内存流中去 - MemoryStream ms = new MemoryStream(data); - //设置图片框 pictureBox1中的图片 - return Image.FromStream(ms); - } - catch { return null; } + return RyImage.LoadPic(path); } /// /// 获取文件大小 @@ -858,6 +893,63 @@ namespace ryCommon return s; } /// + /// 根据文件大小字符串获取长整型表示的文件大小 + /// + /// + /// + public static Int64 GetFileSizeBySizeStr(string filesize_str) + { + long filesize; + if (filesize_str.Length == 0) + { + filesize = 0; + } + else + { + if(filesize_str.EndsWith("kb", StringComparison.OrdinalIgnoreCase)) + { + filesize = (filesize_str.Substring(0, filesize_str.Length - 2).Trim('|').ToDouble() * 1024).ToInt64(); + } + else if (filesize_str.EndsWith("mb", StringComparison.OrdinalIgnoreCase)) + { + filesize = (filesize_str.Substring(0, filesize_str.Length - 2).Trim('|').ToDouble() * 1024 * 1024).ToInt64(); + } + else if (filesize_str.EndsWith("gb", StringComparison.OrdinalIgnoreCase)) + { + filesize = (filesize_str.Substring(0, filesize_str.Length - 2).Trim('|').ToDouble() * 1024 * 1024 * 1024).ToInt64(); + } + else if (filesize_str.EndsWith("tb", StringComparison.OrdinalIgnoreCase)) + { + filesize = (filesize_str.Substring(0, filesize_str.Length - 2).Trim('|').ToDouble() * 1024 * 1024 * 1024 * 1024).ToInt64(); + } + else if (filesize_str.EndsWith("b", StringComparison.OrdinalIgnoreCase)) + { + filesize = (filesize_str.Substring(0, filesize_str.Length - 1).Trim('|').ToDouble()).ToInt64(); + } + else if (filesize_str.EndsWith("k", StringComparison.OrdinalIgnoreCase)) + { + filesize = (filesize_str.Substring(0, filesize_str.Length - 1).Trim('|').ToDouble() * 1024).ToInt64(); + } + else if (filesize_str.EndsWith("m", StringComparison.OrdinalIgnoreCase)) + { + filesize = (filesize_str.Substring(0, filesize_str.Length - 1).Trim('|').ToDouble() * 1024 * 1024).ToInt64(); + } + else if (filesize_str.EndsWith("g", StringComparison.OrdinalIgnoreCase)) + { + filesize = (filesize_str.Substring(0, filesize_str.Length - 1).Trim('|').ToDouble() * 1024 * 1024 * 1024).ToInt64(); + } + else if (filesize_str.EndsWith("t", StringComparison.OrdinalIgnoreCase)) + { + filesize = (filesize_str.Substring(0, filesize_str.Length - 1).Trim('|').ToDouble() * 1024 * 1024 * 1024 * 1024).ToInt64(); + } + else + { + return -1; + } + } + return filesize; + } + /// /// 获取文件大小字符串 /// /// @@ -879,57 +971,6 @@ namespace ryCommon } catch { } } - private static ImageCodecInfo GetEncoderInfo(String mimeType) - { - int j; - ImageCodecInfo[] encoders = ImageCodecInfo.GetImageEncoders(); - for (j = 0; j < encoders.Length; ++j) - { - if (encoders[j].MimeType == mimeType) - return encoders[j]; - } - return null; - } - private static ImageCodecInfo GetEncoderInfo(ryCommon.sType.ImageType type) - { - #region 图片格式 - ImageCodecInfo myImageCodecInfo; - string type_str = "image/jpeg"; - switch (type) - { - case sType.ImageType.Bmp: - type_str = "image/bmp"; - break; - case sType.ImageType.Jpeg: - type_str = "image/jpeg"; - break; - case sType.ImageType.Gif: - type_str = "image/gif"; - break; - case sType.ImageType.Tiff: - type_str = "image/tiff"; - break; - case sType.ImageType.Png: - type_str = "image/png"; - break; - } - myImageCodecInfo = GetEncoderInfo(type_str); - #endregion - return myImageCodecInfo; - } - private static EncoderParameters GetEncoderParameters() - { - System.Drawing.Imaging.Encoder myEncoder; - EncoderParameter myEncoderParameter; - EncoderParameters myEncoderParameters; - - myEncoder = System.Drawing.Imaging.Encoder.Quality; - myEncoderParameters = new EncoderParameters(1); - // Save the bitmap as a JPEG file with quality level 100. - myEncoderParameter = new EncoderParameter(myEncoder, 100L); - myEncoderParameters.Param[0] = myEncoderParameter; - return myEncoderParameters; - } /// /// 添加某个控件为支持拖放属性 /// @@ -937,8 +978,9 @@ namespace ryCommon /// public static ElevatedDragDropManager AddDropDrag(IntPtr handle) { - ElevatedDragDropManager.Instance.EnableDragDrop(handle); - return ElevatedDragDropManager.Instance; + var drag = new ElevatedDragDropManager(); + drag.EnableDragDrop(handle); + return drag; } /// /// 使管理员方式运行时支持拖放 @@ -955,9 +997,10 @@ namespace ryCommon /// /// /// + [Obsolete("当前方法已过期,请使用RyImage.SaveHighQualityImage代替")] public static void SaveHighQualityImage(Bitmap m,string path,ryCommon.sType.ImageType type) { - m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + RyImage.SaveHighQualityImage(m,path,type); } /// /// 保存高质量不失真照片 @@ -965,9 +1008,10 @@ namespace ryCommon /// /// /// + [Obsolete("当前方法已过期,请使用RyImage.SaveHighQualityImage代替")] public static void SaveHighQualityImage(Bitmap m, MemoryStream ms, ryCommon.sType.ImageType type) { - m.Save(ms, GetEncoderInfo(type), GetEncoderParameters()); + RyImage.SaveHighQualityImage(m, ms, type); } /// /// 保存高质量不失真照片 @@ -975,15 +1019,17 @@ namespace ryCommon /// /// /// + [Obsolete("当前方法已过期,请使用RyImage.SaveHighQualityImage代替")] public static void SaveHighQualityImage(Image m, string path, ryCommon.sType.ImageType type) { - m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + RyImage.SaveHighQualityImage(m, path, type); } /// /// 保存高质量不失真照片 /// /// /// + [Obsolete("当前方法已过期,请使用RyImage.SaveHighQualityImage代替")] public static bool SaveHighQualityImage(Bitmap m, string path) { return SaveHighQualityImage((Image)m,path); @@ -993,35 +1039,10 @@ namespace ryCommon /// /// /// + [Obsolete("当前方法已过期,请使用RyImage.SaveHighQualityImage代替")] public static bool SaveHighQualityImage(Image m, string path) { - ryCommon.sType.ImageType type = sType.ImageType.Png; - var ext = System.IO.Path.GetExtension(path).ToLower(); - switch (ext) - { - case ".png": - m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); - break; - case ".jpg": - type = sType.ImageType.Jpeg; - m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); - break; - case ".bmp": - type = sType.ImageType.Bmp; - m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); - break; - case ".gif": - type = sType.ImageType.Gif; - m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); - break; - case ".tif": - type = sType.ImageType.Tiff; - m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); - break; - default: - return false; - } - return true; + return RyImage.SaveHighQualityImage(m,path); } /// /// 获取绝对路径 diff --git a/Source/MyDb/FileFuns/RyImage.cs b/Source/MyDb/FileFuns/RyImage.cs new file mode 100644 index 0000000..2b0c41d --- /dev/null +++ b/Source/MyDb/FileFuns/RyImage.cs @@ -0,0 +1,975 @@ +using System; +using System.Collections.Generic; +using System.Drawing; +using System.Drawing.Drawing2D; +using System.Drawing.Imaging; +using System.Drawing.Text; +using System.IO; +using System.Linq; +using System.Net; +using System.Reflection; +using System.Text; +using static System.Windows.Forms.VisualStyles.VisualStyleElement.TrayNotify; + +namespace ryCommon +{ + /// + /// 图片相关API + /// + public static class RyImage + { + #region 内部方法 + private static EncoderParameters GetEncoderParameters() + { + System.Drawing.Imaging.Encoder myEncoder; + EncoderParameter myEncoderParameter; + EncoderParameters myEncoderParameters; + + myEncoder = System.Drawing.Imaging.Encoder.Quality; + myEncoderParameters = new EncoderParameters(1); + // Save the bitmap as a JPEG file with quality level 100. + myEncoderParameter = new EncoderParameter(myEncoder, 100L); + myEncoderParameters.Param[0] = myEncoderParameter; + return myEncoderParameters; + } + private static ImageCodecInfo GetEncoderInfo(String mimeType) + { + int j; + ImageCodecInfo[] encoders = ImageCodecInfo.GetImageEncoders(); + for (j = 0; j < encoders.Length; ++j) + { + if (encoders[j].MimeType == mimeType) + return encoders[j]; + } + return null; + } + private static ImageCodecInfo GetEncoderInfo(ryCommon.sType.ImageType type) + { + #region 图片格式 + ImageCodecInfo myImageCodecInfo; + string type_str = "image/jpeg"; + switch (type) + { + case sType.ImageType.Bmp: + type_str = "image/bmp"; + break; + case sType.ImageType.Jpeg: + type_str = "image/jpeg"; + break; + case sType.ImageType.Gif: + type_str = "image/gif"; + break; + case sType.ImageType.Tiff: + type_str = "image/tiff"; + break; + case sType.ImageType.Png: + type_str = "image/png"; + break; + } + myImageCodecInfo = GetEncoderInfo(type_str); + #endregion + return myImageCodecInfo; + } + #endregion + /// + /// 从文件或Url中加载图片,使用本方法，不会导致图片文件被占用。 + /// + /// + /// + public static Image LoadPic(string url) + { + if (url.IndexOfEx("http") == 0) + { + Image image = null; + try + { + WebRequest webreq = WebRequest.Create(url); + WebResponse webres = webreq.GetResponse(); + Stream stream = webres.GetResponseStream(); + image = Image.FromStream(stream); + stream.Close(); + } + catch { } + return image; + } + else + { + if (!System.IO.File.Exists(url)) + { return null; } + try + { + FileStream fs = new FileStream(url, FileMode.Open, FileAccess.Read); + //把文件读取到字节数组 + byte[] data = new byte[fs.Length]; + fs.Read(data, 0, data.Length); + fs.Close(); + + //实例化一个内存流--->把从文件流中读取的内容[字节数组]放到内存流中去 + MemoryStream ms = new MemoryStream(data); + //设置图片框 pictureBox1中的图片 + return Image.FromStream(ms); + } + catch { return null; } + } + } + #region SaveHighQualityImage 方法合集 + /// + /// 保存高质量不失真照片 + /// + /// + /// + /// + public static void SaveHighQualityImage(this Bitmap m, string path, ryCommon.sType.ImageType type) + { + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + /// + public static void SaveHighQualityImage(this Bitmap m, MemoryStream ms, ryCommon.sType.ImageType type) + { + m.Save(ms, GetEncoderInfo(type), GetEncoderParameters()); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + /// + public static void SaveHighQualityImage(this Image m, string path, ryCommon.sType.ImageType type) + { + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + public static bool SaveHighQualityImage(this Bitmap m, string path) + { + return SaveHighQualityImage((Image)m, path); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + public static bool SaveHighQualityImage(this Image m, string path) + { + ryCommon.sType.ImageType type = sType.ImageType.Png; + var ext = System.IO.Path.GetExtension(path).ToLower(); + switch (ext) + { + case ".png": + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + case ".jpg": + type = sType.ImageType.Jpeg; + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + case ".bmp": + type = sType.ImageType.Bmp; + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + case ".gif": + type = sType.ImageType.Gif; + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + case ".tif": + type = sType.ImageType.Tiff; + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + default: + return false; + } + return true; + } + #region 图片旋转函数 + /// + /// 以逆时针为方向对图像进行旋转 + /// + /// 位图流 + /// 旋转角度[0,360](前台给的) + /// + public static Bitmap Rotate(this Bitmap b, int angle) + { + angle = angle % 360; + //弧度转换 + double radian = angle * Math.PI / 180.0; + double cos = Math.Cos(radian); + double sin = Math.Sin(radian); + //原图的宽和高 + int w = b.Width; + int h = b.Height; + int W = (int)(Math.Max(Math.Abs(w * cos - h * sin), Math.Abs(w * cos + h * sin))); + int H = (int)(Math.Max(Math.Abs(w * sin - h * cos), Math.Abs(w * sin + h * cos))); + //目标位图 + Bitmap dsImage = new Bitmap(W, H); + System.Drawing.Graphics g = System.Drawing.Graphics.FromImage(dsImage); + g.InterpolationMode = System.Drawing.Drawing2D.InterpolationMode.Bilinear; + g.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.HighQuality; + //计算偏移量 + Point Offset = new Point((W - w) / 2, (H - h) / 2); + //构造图像显示区域：让图像的中心与窗口的中心点一致 + Rectangle rect = new Rectangle(Offset.X, Offset.Y, w, h); + Point center = new Point(rect.X + rect.Width / 2, rect.Y + rect.Height / 2); + g.TranslateTransform(center.X, center.Y); + g.RotateTransform(360 - angle); + //恢复图像在水平和垂直方向的平移 + g.TranslateTransform(-center.X, -center.Y); + g.DrawImage(b, rect); + //重至绘图的所有变换 + g.ResetTransform(); + g.Save(); + g.Dispose(); + //dsImage.Save("yuancd.jpg", System.Drawing.Imaging.ImageFormat.Jpeg); + return dsImage; + } + #endregion 图片旋转函数 + /// + /// 是否包括透明像素 + /// + /// + /// + /// 操作失败 + public static bool HasTransparentPixel(this System.Drawing.Image i) + { + using (Bitmap bitmap = new Bitmap(i)) + { + for (int x = 0; x < bitmap.Width; x++) + { + for (int y = 0; y < bitmap.Height; y++) + { + if (bitmap.GetPixel(x, y).A < 255) + { + return true; + } + } + } + } + + return false; + } + /// + /// 矩形边界 + /// + /// + /// + /// + private static Size ScaleRectangleToFitBounds(Size bounds, Size rect) + { + if (rect.Width < bounds.Width && rect.Height < bounds.Height) + { + return rect; + } + + if (bounds.Width == 0 || bounds.Height == 0) + { + return new Size(0, 0); + } + + double scaleFactorWidth = (double)rect.Width / bounds.Width; + double scaleFactorHeight = (double)rect.Height / bounds.Height; + + double scaleFactor = Math.Max(scaleFactorWidth, scaleFactorHeight); + return new Size() + { + Width = (int)(rect.Width / scaleFactor), + Height = (int)(rect.Height / scaleFactor) + }; + } + /// + /// 计算水印位置 + /// + /// + /// + /// + /// + private static Point CalculateWatermarkPosition(WatermarkPosition watermarkPosition, Size imageSize, Size watermarkSize) + { + Point position = new Point(); + switch (watermarkPosition) + { + case WatermarkPosition.TopLeftCorner: + position.X = 0; + position.Y = 0; + break; + case WatermarkPosition.TopCenter: + position.X = (imageSize.Width / 2) - (watermarkSize.Width / 2); + position.Y = 0; + break; + case WatermarkPosition.TopRightCorner: + position.X = imageSize.Width - watermarkSize.Width; + position.Y = 0; + break; + case WatermarkPosition.CenterLeft: + position.X = 0; + position.Y = (imageSize.Height / 2) - (watermarkSize.Height / 2); + break; + case WatermarkPosition.Center: + position.X = (imageSize.Width / 2) - (watermarkSize.Width / 2); + position.Y = (imageSize.Height / 2) - (watermarkSize.Height / 2); + break; + case WatermarkPosition.CenterRight: + position.X = imageSize.Width - watermarkSize.Width; + position.Y = (imageSize.Height / 2) - (watermarkSize.Height / 2); + break; + case WatermarkPosition.BottomLeftCorner: + position.X = 0; + position.Y = imageSize.Height - watermarkSize.Height; + break; + case WatermarkPosition.BottomCenter: + position.X = (imageSize.Width / 2) - (watermarkSize.Width / 2); + position.Y = imageSize.Height - watermarkSize.Height; + break; + case WatermarkPosition.BottomRightCorner: + position.X = imageSize.Width - watermarkSize.Width; + position.Y = imageSize.Height - watermarkSize.Height; + break; + } + return position; + } + /// + /// 写入水印 + /// + /// 原图 + /// 水印图片 + /// 水印位置 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, Bitmap wmImg, WatermarkPosition Position, float opacity) + { + return DrawWatermark(image, wmImg, new List() { Position }, 0,0, opacity); + } + /// + /// 写入水印 + /// + /// 原图 + /// 水印图片 + /// 水印位置 + /// x坐标偏移 + /// y坐标偏移 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, Bitmap wmImg, WatermarkPosition Position, int offset_x, int offset_y, float opacity) + { + return DrawWatermark(image, wmImg, new List() { Position }, offset_x, offset_y, opacity); + } + /// + /// 写入水印 + /// + /// 原图 + /// 水印图片 + /// 水印位置 + /// x坐标偏移 + /// y坐标偏移 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, Bitmap wmImg, List PositionList,int offset_x, int offset_y, float opacity) + { + Bitmap bm1 = new Bitmap(image); //克隆原图，它也是我们的返回值 + using (Graphics g = Graphics.FromImage(bm1)) + { + Size calculatedWatermarkSize = ScaleRectangleToFitBounds(bm1.Size, wmImg.Size); + + if (calculatedWatermarkSize.Width == 0 || calculatedWatermarkSize.Height == 0) + { + return bm1; + } + Bitmap scaledWatermarkBitmap = + new Bitmap(calculatedWatermarkSize.Width, calculatedWatermarkSize.Height); + using (Graphics watermarkGraphics = Graphics.FromImage(scaledWatermarkBitmap)) + { + ColorMatrix opacityMatrix = new ColorMatrix + { + Matrix33 = opacity + }; + ImageAttributes attrs = new ImageAttributes(); + attrs.SetColorMatrix(opacityMatrix, ColorMatrixFlag.Default, ColorAdjustType.Bitmap); + watermarkGraphics.DrawImage(wmImg, + new Rectangle(0, 0, scaledWatermarkBitmap.Width, scaledWatermarkBitmap.Height), + 0, 0, wmImg.Width, wmImg.Height, + GraphicsUnit.Pixel, attrs); + attrs.Dispose(); + } + + foreach (var position in PositionList) + { + if(position== WatermarkPosition.FullScreenTile) + { + //g.RotateTransform(-45); + //scaledWatermarkBitmap=scaledWatermarkBitmap.Rotate(45); + var space = 100; + var start_y = ((scaledWatermarkBitmap.Width - scaledWatermarkBitmap.Height) / Math.Sqrt(2)) + (Math.Sqrt(2) * scaledWatermarkBitmap.Height)- scaledWatermarkBitmap.Size.Height; + for (int i_y = start_y.ToInt()-50+offset_y; i_y < image.Size.Height*2; i_y += scaledWatermarkBitmap.Height + space) + { + for (int i_x = offset_x; i_x < image.Size.Width; i_x += scaledWatermarkBitmap.Width + space) + { + var bottomleft_x = i_x; + var bottomleft_y = i_y+ scaledWatermarkBitmap.Size.Height; + var bottomright_x = i_x +(scaledWatermarkBitmap.Size.Width / Math.Sqrt(2));//水印右上角x坐标 + var bottomright_y = bottomleft_y - (scaledWatermarkBitmap.Size.Width / Math.Sqrt(2));//水印右上角y坐标 + if (bottomright_x> image.Size.Width){ continue; } + if (bottomright_y< 0){ continue; } + if(bottomright_y > image.Size.Height) { + continue; + } + if (bottomleft_y > image.Size.Height) { + continue; + } + //if ((xx* Math.Sqrt(2))< scaledWatermarkBitmap.Size.Width) { continue; } + g.TranslateTransform(bottomleft_x, bottomleft_y); + g.RotateTransform(-45); + //if (i_x+ scaledWatermarkBitmap.Width> image.Size.Width) { continue; } + //if (i_y + scaledWatermarkBitmap.Height > image.Size.Height) { continue; } + g.DrawImage(scaledWatermarkBitmap, + new Rectangle(new Point(0,0), scaledWatermarkBitmap.Size), + 0, 0, scaledWatermarkBitmap.Width, scaledWatermarkBitmap.Height, GraphicsUnit.Pixel); + g.TranslateTransform(-bottomleft_x, -bottomleft_y); + g.RotateTransform(45); + ///////重置绘图平面的所有变换 + g.ResetTransform(); + } + } + continue; + } + Point watermarkPosition = CalculateWatermarkPosition(position, + image.Size, calculatedWatermarkSize); + watermarkPosition.Offset(offset_x, offset_y); + if(watermarkPosition.X<0 || watermarkPosition.Y < 0) { continue; } + if (watermarkPosition.X > bm1.Width- calculatedWatermarkSize.Width || watermarkPosition.Y>bm1.Height- calculatedWatermarkSize.Height) { continue; } + g.DrawImage(scaledWatermarkBitmap, + new Rectangle(watermarkPosition, calculatedWatermarkSize), + 0, 0, calculatedWatermarkSize.Width, calculatedWatermarkSize.Height, GraphicsUnit.Pixel); + } + scaledWatermarkBitmap.Dispose(); + } + return bm1; + } + /// + /// 计算最大字体大小 + /// + /// + /// + /// + /// + /// + /// + private static int ComputeMaxFontSize(string text, int angle, string fontName, Size maxTextSize, Graphics g) + { + for (int fontSize = 2; ; fontSize++) + { + using (Font tmpFont = new Font(fontName, fontSize, FontStyle.Bold)) + { + SizeF textSize = g.MeasureString(text, tmpFont); + SizeF rotatedTextSize = CalculateRotatedRectSize(textSize, angle); + if (((int)rotatedTextSize.Width > maxTextSize.Width) || + ((int)rotatedTextSize.Height > maxTextSize.Height)) + { + return fontSize - 1; + } + } + } + } + /// + /// 计算旋转矩形大小 + /// + /// + /// + /// + private static SizeF CalculateRotatedRectSize(SizeF rectSize, double angleDeg) + { + double angleRad = angleDeg * Math.PI / 180; + double width = rectSize.Height * Math.Abs(Math.Sin(angleRad)) + + rectSize.Width * Math.Abs(Math.Cos(angleRad)); + double height = rectSize.Height * Math.Abs(Math.Cos(angleRad)) + + rectSize.Width * Math.Abs(Math.Sin(angleRad)); + return new SizeF((float)width, (float)height); + } + /// + /// 写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// 旋转角度 + /// 水印位置 + /// x坐标偏移 + /// y坐标偏移 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, string wmText,string WatermarkFont,Color TextColor, int TextSize, int TextRotatedDegree, List PositionList, int x, int y, float opacity) + { + Bitmap bm1 = new Bitmap(image); //克隆原图，它也是我们的返回值 + using (Graphics g = Graphics.FromImage(bm1)) + { + g.SmoothingMode = SmoothingMode.AntiAlias; + g.TextRenderingHint = TextRenderingHint.AntiAlias; + + string text = wmText; + + int textAngle = TextRotatedDegree; + double sizeFactor = (double)TextSize / 100; + Size maxTextSize = new Size( + (int)(bm1.Width * sizeFactor), + (int)(bm1.Height * sizeFactor)); + + int fontSize = ComputeMaxFontSize(text, textAngle, WatermarkFont, maxTextSize, g); + + Font font = new Font(WatermarkFont, (float)fontSize, FontStyle.Bold); + SizeF originalTextSize = g.MeasureString(text, font); + SizeF rotatedTextSize = CalculateRotatedRectSize(originalTextSize, textAngle); + + Bitmap textBitmap = new Bitmap((int)rotatedTextSize.Width, (int)rotatedTextSize.Height, + PixelFormat.Format32bppArgb); + using (Graphics textG = Graphics.FromImage(textBitmap)) + { + Color color = Color.FromArgb((int)(opacity * 255), TextColor); + SolidBrush brush = new SolidBrush(color); + + textG.TranslateTransform(rotatedTextSize.Width / 2, rotatedTextSize.Height / 2); + textG.RotateTransform((float)textAngle); + textG.DrawString(text, font, brush, -originalTextSize.Width / 2, + -originalTextSize.Height / 2); + textG.ResetTransform(); + + brush.Dispose(); + } + + foreach (var position in PositionList) + { + Point textPosition = CalculateWatermarkPosition(position, + bm1.Size, rotatedTextSize.ToSize()); + g.DrawImage(textBitmap, textPosition); + } + textBitmap.Dispose(); + font.Dispose(); + } + return bm1; + } + /// + /// 写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// 旋转角度 + /// 水印位置 + /// x坐标偏移 + /// y坐标偏移 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, string wmText, string WatermarkFont, Color TextColor, int TextSize, int TextRotatedDegree, WatermarkPosition Position, int x, int y, float opacity) + { + return DrawWatermark(image, wmText, WatermarkFont, TextColor, TextSize, TextRotatedDegree, + new List() { Position }, x, y, opacity); + } + /// + /// 写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// 旋转角度 + /// 水印位置 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, string wmText, string WatermarkFont, Color TextColor, int TextSize, int TextRotatedDegree, WatermarkPosition Position, float opacity) + { + return DrawWatermark(image, wmText, WatermarkFont, TextColor, TextSize, TextRotatedDegree, + new List() { Position }, 0,0, opacity); + } + /// + /// 往图片右下角写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, string wmText, string WatermarkFont, Color TextColor, int TextSize, float opacity) + { + return DrawWatermark(image, wmText, WatermarkFont, TextColor, TextSize, 0, + new List() { WatermarkPosition.BottomRightCorner }, 0, 0, opacity); + } + /// + /// 往图片右下角写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// + public static Bitmap DrawWatermark(this Image image, string wmText, string WatermarkFont, Color TextColor, int TextSize) + { + return DrawWatermark(image, wmText, WatermarkFont, TextColor, TextSize, 0, + new List() { WatermarkPosition.BottomRightCorner }, 0, 0, 0.1f); + } + /// + /// 缩放 + /// + /// + /// 宽 + /// 高 + /// 插值算法 + /// 返回缩放后的图片 + /// Image 不能为 null + /// 操作失败 + public static System.Drawing.Image Zoom(this System.Drawing.Image i, int width, int height, InterpolationMode mode) + { + Bitmap bitmap = new Bitmap(width, height); + using (Graphics g = Graphics.FromImage(bitmap)) + { + g.InterpolationMode = mode; + g.Clear(Color.Empty); + g.DrawImage(i, new Rectangle(0, 0, width, height), new Rectangle(0, 0, i.Width, i.Height), GraphicsUnit.Pixel); + } + return bitmap; + } + /// + /// 缩放 + /// + /// + /// 宽 + /// 高 + /// 返回缩放后的图片 + /// Image 不能为 null + /// 操作失败 + public static System.Drawing.Image Zoom(this System.Drawing.Image i, int width, int height) + { + Bitmap bitmap = new Bitmap(width, height); + using (Graphics g = Graphics.FromImage(bitmap)) + { + g.InterpolationMode = InterpolationMode.HighQualityBicubic; + g.Clear(Color.Empty); + g.DrawImage(i, new Rectangle(0, 0, width, height), new Rectangle(0, 0, i.Width, i.Height), GraphicsUnit.Pixel); + } + return bitmap; + } + #endregion + /// + /// 根据原边长和新边长计算绘制的起始点坐标 + /// + /// + /// + /// + private static int GetSrc(int oldLength, int newLength) + { + return ((float)(oldLength - newLength) / 2).ToInt(); + } + /// + /// 获取缩放模式 + /// + /// + /// + /// + /// + /// 是否裁剪图片 + /// + private static ResizeMode GetMode(int oldWidth, int oldHeight, int newWidth, int newHeight, bool crop) + { + float oldScale = (float)oldWidth / oldHeight; + float newScale = (float)newWidth / newHeight; + if (crop) + { + return oldScale < newScale ? ResizeMode.WidthFirst : ResizeMode.HeightFirst; + } + else + { + return oldScale > newScale ? ResizeMode.WidthFirst : ResizeMode.HeightFirst; + } + } + /// + /// 裁剪或填充 + /// + /// + /// + /// + /// 背景色 + /// 插值算法 + /// + /// Image 不能为 null + /// 操作失败 + private static System.Drawing.Image CropOrFill(this System.Drawing.Image image, int width, int height, Color background, InterpolationMode mode) + { + Bitmap bitmap = new Bitmap(width, height); + using (Graphics g = Graphics.FromImage(bitmap)) + { + g.InterpolationMode = mode; + int srcX = GetSrc(image.Width, width); + int srcY = GetSrc(image.Height, height); + g.Clear(background); + g.DrawImage(image, new Rectangle(0, 0, width, height), srcX, srcY, width, height, GraphicsUnit.Pixel); + } + return bitmap; + } + /// + /// 裁剪 + /// + /// + /// 宽度 + /// 高度 + /// + /// 返回裁剪后的图片 + /// Image 不能为 null + /// 新的图片尺寸的宽度和高度必须大于零 + /// 操作失败 + public static System.Drawing.Image Crop(this System.Drawing.Image i, int width, int height, InterpolationMode interpolationMode) + { + return i.ReSize(width, height,Color.Transparent, GetMode(i.Width, i.Height, width, height, true), interpolationMode); + } + /// + /// 调整宽度 + /// + /// + /// + /// + public static Image ReSizeW(this Image i, int width) + { + return i.ReSize(width, (((float)width / i.Width) * i.Height).ToInt(), ResizeMode.WidthFirst); + } + /// + /// 根据最大宽度调整图片尺寸 + /// + /// + /// 最大宽度 + /// 返回调整后的图片 + /// Image 不能为 null + /// 最大宽度必须大于零 + /// 操作失败 + public static System.Drawing.Image ResizeMaxW(this System.Drawing.Image i, int maxWidth) + { + if (i.Width > maxWidth) + { + return i.ReSizeW(maxWidth); + } + else + { + return (System.Drawing.Image)i.Clone(); + } + } + /// + /// 根据最大高度调整图片尺寸 + /// + /// + /// 最大高度 + /// 返回调整后的图片 + /// Image 不能为 null + /// 最大宽度必须大于零 + /// 操作失败 + public static System.Drawing.Image ResizeMaxH(this System.Drawing.Image i, int maxHeight) + { + if (i.Height > maxHeight) + { + return i.ReSizeH(maxHeight); + } + else + { + return (System.Drawing.Image)i.Clone(); + } + } + /// + /// 调整高度 + /// + /// + /// + /// + public static Image ReSizeH(this Image i, int height) + { + return i.ReSize((((float)height / i.Height) * i.Width).ToInt(), height, ResizeMode.WidthFirst); + } + /// + /// 调整图片大小 + /// + /// + /// + /// + /// + /// + public static Image ReSize(this Image i, int width, int height, ResizeMode resizeMode) + { + return ReSize(i, width, height, Color.Transparent, resizeMode); + } + /// + /// 调整图片大小 + /// + /// + /// + /// + /// + /// + /// + public static Image ReSize(this Image i, int width, int height, Color background, ResizeMode resizeMode) + { + return ReSize(i,width,height,background,resizeMode, InterpolationMode.HighQualityBilinear); + } + /// + /// 调整图片大小 + /// + /// + /// + /// + /// + /// + /// + /// + /// + public static Image ReSize(this Image i,int width,int height, Color background, ResizeMode resizeMode, InterpolationMode interpolationMode) + { + if (width <= 0 || height <= 0) + { + throw new ArgumentOutOfRangeException("新的图片尺寸的宽和高必须大于零"); + } + //如果原图片和新图片尺寸一致，克隆对象返回 + if (i.Width == width && i.Height == height) + { + return (System.Drawing.Image)i.Clone(); + } + if (((float)i.Width / i.Height == (float)width / height)) + { + //如果原图片和新图片的比例相同，只缩放 + return i.Zoom(width, height); + } + else + { + Size size = new Size(); + //新宽高比 + float scale = (float)width / height; + if (resizeMode == ResizeMode.WidthFirst) + { + //等宽，计算高 + size.Width = i.Width; + size.Height = (i.Width / scale).ToInt(); + } + else + { + //等高，计算宽 + size.Height = i.Height; + size.Width = (i.Height * scale).ToInt(); + } + //如果原图片和新图片的比例不同，先裁剪或填充后，再缩放 + using (System.Drawing.Image cropOrFill = i.CropOrFill(size.Width, size.Height, background, interpolationMode)) + { + return cropOrFill.Zoom(width, height, interpolationMode); + } + } + } + /// + /// 转换Image为Icon + /// + /// 要转换为图标的Image对象 + /// 当image为null时是否返回null。false则抛空引用异常 + /// + public static Icon ConvertToIcon(Image image, bool nullTonull = false) + { + if (image == null) + { + if (nullTonull) { return null; } + throw new ArgumentNullException("image"); + } + + using (MemoryStream msImg = new MemoryStream() + , msIco = new MemoryStream()) + { + image.Save(msImg, ImageFormat.Png); + + using (var bin = new BinaryWriter(msIco)) + { + //写图标头部 + bin.Write((short)0); //0-1保留 + bin.Write((short)1); //2-3文件类型。1=图标, 2=光标 + bin.Write((short)1); //4-5图像数量（图标可以包含多个图像） + + bin.Write((byte)image.Width); //6图标宽度 + bin.Write((byte)image.Height); //7图标高度 + bin.Write((byte)0); //8颜色数（若像素位深>=8，填0。这是显然的，达到8bpp的颜色数最少是256，byte不够表示） + bin.Write((byte)0); //9保留。必须为0 + bin.Write((short)0); //10-11调色板 + bin.Write((short)32); //12-13位深 + bin.Write((int)msImg.Length); //14-17位图数据大小 + bin.Write(22); //18-21位图数据起始字节 + + //写图像数据 + bin.Write(msImg.ToArray()); + + bin.Flush(); + bin.Seek(0, SeekOrigin.Begin); + return new Icon(msIco); + } + } + } + } + /// + /// 缩放模式 + /// + public enum ResizeMode + { + /// + /// 宽度优先(不裁剪宽) + /// + WidthFirst, + + /// + /// 高度优先(不裁剪高) + /// + HeightFirst + } + /// + /// 水印位置 + /// + public enum WatermarkPosition + { + /// + /// 左上角 + /// + TopLeftCorner, + /// + /// 中上 + /// + TopCenter, + /// + /// 右上角 + /// + TopRightCorner, + /// + /// 左中 + /// + CenterLeft, + /// + /// 居中 + /// + Center, + /// + /// 右中 + /// + CenterRight, + /// + /// 左下角 + /// + BottomLeftCorner, + /// + /// 中下 + /// + BottomCenter, + /// + /// 右下角 + /// + BottomRightCorner, + /// + /// 全屏平铺 + /// + FullScreenTile, + } +} diff --git a/Source/MyDb/FileFuns/TxtFileEncoder.cs b/Source/MyDb/FileFuns/TxtFileEncoder.cs index 32555d8..c97e036 100644 --- a/Source/MyDb/FileFuns/TxtFileEncoder.cs +++ b/Source/MyDb/FileFuns/TxtFileEncoder.cs @@ -79,20 +79,18 @@ namespace ryCommon byte byte2; byte byte3 = 0; byte byte4; - //保存当前Seek位置 - long origPos = stream.Seek(0, SeekOrigin.Begin); - stream.Seek(0, SeekOrigin.Begin); - - int nByte = stream.ReadByte(); - byte1 = Convert.ToByte(nByte); - byte2 = Convert.ToByte(stream.ReadByte()); + BinaryReader r = new BinaryReader(stream, System.Text.Encoding.Default); + byte[] ss; + ss = r.ReadBytes(stream.Length.ToInt()); + byte1 = ss.Length>=1?ss[0]:byte.MinValue; + byte2 = ss.Length >= 2 ? ss[1] : byte.MinValue; if (stream.Length >= 3) { - byte3 = Convert.ToByte(stream.ReadByte()); + byte3 = ss.Length >= 3 ? ss[2] : byte.MinValue; } if (stream.Length >= 4) { - byte4 = Convert.ToByte(stream.ReadByte()); + byte4 = ss.Length >= 4 ? ss[3] : byte.MinValue; } //根据文件流的前4个字节判断Encoding //Unicode {0xFF, 0xFE}; @@ -110,20 +108,12 @@ namespace ryCommon { targetEncoding = Encoding.UTF8; } - else + else if (IsUTF8Bytes(ss))//UTF8 { - int index =0; - byte[] bytes = new byte[100]; - stream.Seek(origPos, SeekOrigin.Begin); - while (stream.CanRead) - { - index++; if (index >= 100) { break; } - bytes[index - 1] = Convert.ToByte(stream.ReadByte()); - } - if (GetBytesEncoding(bytes)==Encoding.UTF8) { targetEncoding = Encoding.UTF8; } + targetEncoding =new UTF8Encoding(false); } //恢复Seek位置 - stream.Seek(origPos, SeekOrigin.Begin); + r.Close(); } return targetEncoding; } @@ -173,7 +163,7 @@ namespace ryCommon return reVal; } - private static Encoding GetBytesEncoding(byte[] bs) + private static Encoding GetBytesEncoding(byte[] bs) { int len = bs.Length; if (len >= 3 && bs[0] == 0xEF && bs[1] == 0xBB && bs[2] == 0xBF) @@ -207,49 +197,76 @@ namespace ryCommon } return Encoding.UTF8; } + private static byte UTF8CharacterMask1Byte = 0b1000_0000; + private static byte Valid1Byte = 0b0000_0000;//0b0xxx_xxxx + + private static byte UTF8CharacterMask2Byte = 0b1110_0000; + private static byte Valid2Byte = 0b1100_0000;//0b110x_xxxx + + private static byte UTF8CharacterMask3Byte = 0b1111_0000; + private static byte Valid3Byte = 0b1110_0000;//0b1110_xxxx + + private static byte UTF8CharacterMask4Byte = 0b1111_1000; + private static byte Valid4Byte = 0b1111_0000;//0b1111_0xxx + + private static byte UTF8CharacterMaskForExtraByte = 0b1100_0000; + private static byte ValidExtraByte = 0b1000_0000;//0b10xx_xxxx /// /// 判断是否是不带 BOM 的 UTF8 格式 /// - /// + /// /// - public static bool IsUTF8Bytes(byte[] data) + public static bool IsUTF8Bytes(byte[] bytes) { - int charByteCounter = 1;　 //计算当前正分析的字符应还有的字节数 - byte curByte; //当前分析的字节. - for (int i = 0; i < data.Length; i++) + short extraByteCount = 0; + + foreach (byte bt in bytes) { - curByte = data[i]; - if (charByteCounter == 1) + + if (extraByteCount > 0) { - if (curByte >= 0x80) - { - //判断当前 - while (((curByte <<= 1) & 0x80) != 0) - { - charByteCounter++; - } - //标记位首位若为非0 则至少以2个1开始 如:110XXXXX...........1111110X　 - if (charByteCounter == 1 || charByteCounter > 6) - { - return false; - } - } + extraByteCount--; + + // Extra Byte Pattern. + if ((bt & UTF8CharacterMaskForExtraByte) != ValidExtraByte) + return false; + continue; } else { - //若是UTF-8 此时第一位必须为1 - if ((curByte & 0xC0) != 0x80) + // 1 Byte Pattern. + if ((bt & UTF8CharacterMask1Byte) == Valid1Byte) { - return false; + continue; } - charByteCounter--; + + // 2 Bytes Pattern. + if ((bt & UTF8CharacterMask2Byte) == Valid2Byte) + { + extraByteCount = 1; + continue; + } + + // 3 Bytes Pattern. + if ((bt & UTF8CharacterMask3Byte) == Valid3Byte) + { + extraByteCount = 2; + continue; + } + + // 4 Bytes Pattern. + if ((bt & UTF8CharacterMask4Byte) == Valid4Byte) + { + extraByteCount = 3; + continue; + } + + // invalid UTF8-Bytes. + return false; } } - if (charByteCounter > 1) - { - throw new Exception("非预期的byte格式!"); - } - return true; + + return extraByteCount >= 0; } } } diff --git a/Source/MyDb/HardWare/HardWare.cs b/Source/MyDb/HardWare/HardWare.cs new file mode 100644 index 0000000..b6cb853 --- /dev/null +++ b/Source/MyDb/HardWare/HardWare.cs @@ -0,0 +1,394 @@ +using ryCommon; +using System; +using System.Collections.Generic; +using System.Linq; +using System.Management; +using System.Text; +using System.Windows.Forms; + +namespace RyHardWare +{ + /// + /// + /// + public class HardWare + { + /// + /// 获取WMI内容 + /// + /// + /// + public string GetWMI(string sql) + { + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher(sql); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + //注意 + //Properties["Manufacturer"].Value 可能为Null，意味着没有厂商信息 + var result = ""; + while (moe.MoveNext()) + { + foreach (var item in moe.Current.Properties) + { + if (item.Value != null) + { + if (item.Value is string[]) + { + var list = (string[])item.Value; + for (int i = 0; i < list.Length; i++) + { + result += "\r\n" + item.Name + "=>数组" + i + "=>" + list[i]; + } + } + else + { + result += "\r\n" + item.Name + "=>" + item.Value.ToString(); + } + } + } + result += "\r\n"; + } + return result.Trim(); + } + /// + /// 获取WMI内容 + /// + /// + /// + public string GetWMIByName(string name) + { + return GetWMI("select * from " + name); + } + /// + /// 获取内存信息 + /// + /// + public static string GetMemoryInfo() + { + var result = ""; + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher("select * from Win32_PhysicalMemory"); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + long total_size = 0; + var index = 0; + Dictionary dict = new Dictionary(); + while (moe.MoveNext()) + { + index++; + var item = moe.Current.Properties; + long Capacity = item["Capacity"].Value.ToInt64() / 1024 / 1024 / 1024; + total_size += Capacity; + var Manufacturer = ObjToStr(item["Manufacturer"].Value); + var Speed = item["Speed"].Value.ToInt(); + var ddr = ObjToStr(item["PartNumber"].Value); + if (ddr.IndexOfEx("DDR3") >= 0) { ddr = "DDR3"; } + else if (ddr.IndexOfEx("DDR4") >= 0) { ddr = "DDR4"; } + else if (ddr.IndexOfEx("D4") >= 0) { ddr = "DDR4"; } + else if (ddr.IndexOfEx("D3") >= 0) { ddr = "DDR3"; } + else if (Speed == 266 || Speed == 333 || Speed == 400) + { + ddr = "DDR"; + } + else if (Speed == 533 || Speed == 667 || Speed == 800) + { + ddr = "DDR2"; + } + else if (Speed == 1066 || Speed == 1333 || Speed == 1600) + { + ddr = "DDR3"; + } + else if (Speed == 2400 || Speed == 2133 || Speed == 2666 || Speed == 3200) + { + ddr = "DDR4"; + } + else { ddr = "未知"; } + if (Manufacturer == "Kingston") { Manufacturer = "金士顿"; } + else if (Manufacturer == "A-DATA Technology") { Manufacturer = "威刚"; } + else { Manufacturer = GetManufacturer(Manufacturer); } + var memory = Capacity + "GB " + Manufacturer + " " + ddr + " " + Speed + "MHz"; + if (dict.ContainsKey(memory)) + { + dict[memory]++; + } + else { dict[memory] = 1; } + } + foreach (var item in dict) + { + if (result.Length > 0) { result += "/"; } + if (item.Value >= 2) + { + result += item.Key + "*" + item.Value; + } + else { result += item.Key; } + } + if (index >= 2) + { + result = total_size + "GB(" + result + ")"; + } + return result; + } + /// + /// 获取显卡信息 + /// + /// + public static string GetVideoInfo() + { + var result = ""; + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher("select * from Win32_VideoController"); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + while (moe.MoveNext()) + { + var item = moe.Current.Properties; + var Availability = ObjToStr(item["Availability"].Value); + if (Availability != "3") { continue; } + var Caption = ObjToStr(item["Caption"].Value); + string RAM_Str; + var RAM = ObjToStr(item["AdapterRAM"].Value).ToInt64()/1024/1024; + if (RAM >= 1024) { RAM_Str = (RAM / 1024m).ToNString("0.00")+"GB"; } + else { RAM_Str = RAM + "MB"; } + if (result.Length > 0) { result += "/"; } + result += Caption+ "("+ RAM_Str + ")"; + } + return result; + } + /// + /// 获取显卡信息 + /// + /// + public static string GetDiskInfo() + { + var list = GetDiskListInfo(); + var result = ""; + for (int i = 0; i < list.Count; i++) + { + if (result.Length > 0) { result += "/"; } + result += list[i]; + } + return result; + } + /// + /// 获取显卡信息 + /// + /// + public static List GetDiskListInfo() + { + var result = new List(); + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher("select * from Win32_DiskDrive"); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + while (moe.MoveNext()) + { + var item = moe.Current.Properties; + var size_long = ObjToStr(item["Size"].Value).ToInt64(); + var Size_1024 = size_long / 1024 / 1024 / 1024; + var Size_1000 = size_long / 1000 / 1000 / 1000; + string SizeStr; + if(Size_1000>=1000) + { + SizeStr = (Size_1000 / 1000) + "TB"; + } + else + { + SizeStr = Size_1000 + "GB"; + } + if (Size_1024 >= 1024) + { + SizeStr += "[实际"+(Size_1024 / 1024d).ToNString("0.00") + "TB]"; + } + else + { + SizeStr += "[实际" + Size_1024 + "GB]"; + } + var Caption = ObjToStr(item["Caption"].Value); + var MediaType = ObjToStr(item["MediaType"].Value); + if (MediaType == "External hard disk media") { continue; } + if (MediaType == "Removable Media") { continue; } + if (Caption.StartsWith("TOSHIBA", StringComparison.OrdinalIgnoreCase)) + { result.Add(SizeStr + " 东芝 " + Caption); } + else if (Caption.StartsWith("ST", StringComparison.OrdinalIgnoreCase)) + { result.Add(SizeStr + " 希捷 " + Caption); } + else if (Caption.StartsWith("WD", StringComparison.OrdinalIgnoreCase)) + { result.Add(SizeStr + " 西数 " + Caption); } + else + { + var iPos = Caption.IndexOfEx(" "); + if(iPos<=0) + { + result.Add(SizeStr + " " + Caption); + } + else + { + result.Add(SizeStr + " " + GetManufacturer(Caption.Substring(0,iPos))+" "+Caption.Substring(iPos+1)); + } + } + } + return result; + } + /// + /// 获取硬盘信息 + /// + /// + public static string GetDiskMultiInfo() + { + var list = GetDiskListInfo(); + var result = ""; + for (int i = 0; i < list.Count; i++) + { + if (result.Length > 0) { result += "\r\n"; } + result += i == 0 ? "主硬盘:" : "硬盘" + (i + 1) + ":"; + result += list[i]; + } + return result; + } + /// + /// 获取主板信息 + /// + /// + public static string GetBaseBoardInfo() + { + var result = ""; + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher("select * from WIN32_BaseBoard"); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + while (moe.MoveNext()) + { + var item = moe.Current.Properties; + var Manufacturer = ObjToStr(item["Manufacturer"].Value); + var Product = ObjToStr(item["Product"].Value); + if (result.Length > 0) { result += "/"; } + result += "["+GetManufacturer(Manufacturer) + "]" + Product; + } + return result; + } + private static string GetManufacturer(string Manufacturer) + { + var ini_path = Application.StartupPath + "\\UserDb\\Manufacturer.ini"; + if (System.IO.File.Exists(ini_path)) + { + ryCommon.Ini ini = new ryCommon.Ini(ini_path); + return ini.ReadIni(Manufacturer, "name", Manufacturer); + } + else + { + switch(Manufacturer) + { + case "SOYO":return "梅捷"; + case "BIOSTAR": case "BIOSTAR Group": return "映泰"; + case "Gigabyte Technology Co., Ltd.": return "技嘉"; + case "ASUSTeK COMPUTER INC.": return "华硕"; + case "Micro-Star International Co., Ltd.": return "微星"; + case "SUPoX COMPUTER CO.,LTD": return "磐正"; + case "Samsung": return "三星"; + case "ADATA": return "威刚"; + case "SanDisk": return "闪迪"; + case "Macmemory": return "王储"; + case "KINGSTON": return "金士顿"; + case "G Skill": return "芝奇"; + case "GALAX": return "影驰"; + case "Corsair": return "海盗船"; + case "INTEL": return "英特尔"; + } + } + return Manufacturer; + } + /// + /// 获取处理器信息 + /// + /// + public static string GetCPU() + { + ManagementObjectSearcher searcher = new ManagementObjectSearcher(); //用于查询一些如系统信息的管理对象 + searcher.Query = new SelectQuery("Win32_Processor ", "", new string[] { "Name" });//设置查询条件 + ManagementObjectCollection collection = searcher.Get(); //获取内存容量 + ManagementObjectCollection.ManagementObjectEnumerator em = collection.GetEnumerator(); + + string name = ""; + Dictionary dict = new Dictionary(); + while (em.MoveNext()) + { + ManagementBaseObject baseObj = em.Current; + if (baseObj.Properties["Name"].Value != null) + { + try + { + name = baseObj.Properties["Name"].Value.ToString(); + if (dict.ContainsKey(name)) + { + dict[name]++; + } + else { dict[name] = 1; } + } + catch + { + return ""; + } + } + } + name = ""; + foreach (var item in dict) + { + if (name.Length > 0) { name += "/"; } + if (item.Value >= 2) + { + name += "("+item.Key + ")*" + item.Value; + } + else { name += item.Key; } + } + return name; + } + /// + ///获取主要硬件信息 + /// + /// + public static string GetMainHardware() + { + return GetMainHardware(false); + } + /// + /// 获取主要硬件信息 + /// + /// 是否获取XML格式 + /// + public static string GetMainHardware(bool getbyXML) + { + if (getbyXML) + { + ryCommon.Storage mStor = new Storage(); + addValue("主板", GetBaseBoardInfo()); + addValue("处理器", GetCPU()); + addValue("显卡", GetVideoInfo()); + addValue("内存", GetMemoryInfo()); + var list_disk = HardWare.GetDiskListInfo(); + for (int i = 0; i < list_disk.Count; i++) + { + addValue((i == 0 ? "主硬盘 " : "硬盘"), list_disk[i]); + } + void addValue(string name, string value) + { + mStor.AddNode2("name", name); + mStor.SetAttrValue("value", value); + } + return mStor.XMLText; + } + else + { + var content = "主板 " + HardWare.GetBaseBoardInfo(); + content += "\r\n处理器 " + HardWare.GetCPU(); + content += "\r\n显卡 " + HardWare.GetVideoInfo(); + content += "\r\n内存 " + HardWare.GetMemoryInfo(); + var list_disk = HardWare.GetDiskListInfo(); + for (int i = 0; i < list_disk.Count; i++) + { + content += "\r\n" + (i == 0 ? "主硬盘 " : "硬盘" + " ") + list_disk[i]; + } + return content; + } + } + private static string ObjToStr(object obj) + { + if (obj == null) { return ""; } + return obj.ToString(); + } + } +} diff --git a/Source/MyDb/HtmlAgilityPack.Shared/HtmlWeb.cs b/Source/MyDb/HtmlAgilityPack.Shared/HtmlWeb.cs index 7f17b69..ebee088 100644 --- a/Source/MyDb/HtmlAgilityPack.Shared/HtmlWeb.cs +++ b/Source/MyDb/HtmlAgilityPack.Shared/HtmlWeb.cs @@ -1698,7 +1698,7 @@ namespace HtmlAgilityPack ? Encoding.GetEncoding(html ? characterSet : resp.ContentEncoding) : null; } - catch (Exception e ) + catch (Exception) { } @@ -2489,7 +2489,7 @@ namespace HtmlAgilityPack Assembly.LoadFile(path); } } - catch (Exception ex) + catch (Exception) { // Silence catch } diff --git a/Source/MyDb/Msg/RyMemoryShare.cs b/Source/MyDb/Msg/RyMemoryShare.cs index a0162e8..34bca62 100644 --- a/Source/MyDb/Msg/RyMemoryShare.cs +++ b/Source/MyDb/Msg/RyMemoryShare.cs @@ -1,145 +1,228 @@ -using System; -using System.Collections.Generic; -using System.Text; -using System.Runtime.InteropServices; -using System.Windows.Forms; - -namespace QuickMsg -{ - /// - /// 共享内存 - /// - public class RyMemoryShare - { - [DllImport("user32.dll", CharSet = CharSet.Auto)] - private static extern IntPtr SendMessage(IntPtr hWnd, int Msg, int wParam, IntPtr lParam); - - [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] - private static extern IntPtr CreateFileMapping(int hFile, IntPtr lpAttributes, uint flProtect, uint dwMaxSizeHi, uint dwMaxSizeLow, string lpName); - - [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] - private static extern IntPtr OpenFileMapping(uint dwDesiredAccess, [MarshalAs(UnmanagedType.Bool)] bool bInheritHandle, string lpName); - - [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] - private static extern IntPtr MapViewOfFile(IntPtr hFileMapping, uint dwDesiredAccess, uint dwFileOffsetHigh, uint dwFileOffsetLow, uint dwNumberOfBytesToMap); - - [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] - private static extern bool UnmapViewOfFile(IntPtr pvBaseAddress); - - [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] - private static extern bool CloseHandle(IntPtr handle); - [DllImport("kernel32", EntryPoint = "GetLastError")] - private static extern int GetLastError(); - [DllImport("user32.dll", EntryPoint = "FindWindow")] - private static extern IntPtr FindWindow(string lpClassName, string lpWindowName); - [DllImport("User32.dll")] - private static extern bool PostMessage(IntPtr hWnd, uint uMsg, int wParam, int lParam); - const int ERROR_ALREADY_EXISTS = 183; - - const int FILE_MAP_COPY = 0x0001; - const int FILE_MAP_WRITE = 0x0002; - const int FILE_MAP_READ = 0x0004; - const int FILE_MAP_ALL_ACCESS = 0x0002 | 0x0004; - - const int PAGE_READONLY = 0x02; - const int PAGE_READWRITE = 0x04; - const int PAGE_WRITECOPY = 0x08; - const int PAGE_EXECUTE = 0x10; - const int PAGE_EXECUTE_READ = 0x20; - const int PAGE_EXECUTE_READWRITE = 0x40; - - const int SEC_COMMIT = 0x8000000; - const int SEC_IMAGE = 0x1000000; - const int SEC_NOCACHE = 0x10000000; - const int SEC_RESERVE = 0x4000000; - const int INVALID_HANDLE_VALUE = -1; - /// - /// 写共享内存 - /// - /// 需要映射的文件的字节数量 - /// 映射对象（简单类型、结构体等） - /// 文件映射对象的名称 - /// - public static int WriteToMemory(uint structSize, Object obj, string fileName) - { - return WriteToMemory(structSize, obj, fileName, null, 0); - } - /// - /// 写共享内存 - /// - /// 需要映射的文件的字节数量 - /// 映射对象（简单类型、结构体等） - /// 文件映射对象的名称 - /// 发送消息的窗口句柄 - /// 发送消息 - /// - public static int WriteToMemory(uint structSize, Object obj, string fileName, string windowName, uint Msg) - { - IntPtr hShareMemoryHandle; - IntPtr hVoid; - - //判断参数的合法性 - if (structSize > 0 && fileName.Length > 0) - { - hShareMemoryHandle = CreateFileMapping(INVALID_HANDLE_VALUE, IntPtr.Zero, (uint)PAGE_READWRITE, 0, (uint)structSize, fileName); - if (hShareMemoryHandle == IntPtr.Zero) - { - //创建共享内存失败，记log - // MessageBox.Show("创建共享内存失败" + publicInfo.GetLastError().ToString()); - return -2; - } - else - { - if (ERROR_ALREADY_EXISTS == GetLastError()) - { - //共享内存已经存在，记log - //MessageBox.Show("共享内存已经存在"); - return -3; - } - } - hVoid = MapViewOfFile(hShareMemoryHandle, FILE_MAP_WRITE, 0, 0, structSize); - if (hVoid == IntPtr.Zero) - { - CloseHandle(hShareMemoryHandle); - //文件映射失败，记log - //MessageBox.Show("文件映射失败"); - return -4; - } - Marshal.StructureToPtr(obj, hVoid, false); - //发送消息，通知接收 - if (windowName != null) - { - IntPtr handle = FindWindow(null, windowName.Trim()); - if (handle == IntPtr.Zero) - { - //查找窗口失败，记log - //MessageBox.Show("查找窗口失败"); - return -5; - } - else - { - if (PostMessage(handle, (uint)Msg, 0, 0)) - { - //发送消息成功 - //MessageBox.Show("写共享内存，通知发送消息成功"); - } - } - } - } - else - { - //参数不合法，记log - //MessageBox.Show("共享内存已经存在"); - return -1; - } - return 0; - } +using System; +using System.Collections.Generic; +using System.Text; +using System.Runtime.InteropServices; +using System.Windows.Forms; +using System.Security.Cryptography; + +namespace QuickMsg +{ + /// + /// 共享内存 + /// + public class RyMemoryShare + { + [DllImport("user32.dll", CharSet = CharSet.Auto)] + private static extern IntPtr SendMessage(IntPtr hWnd, int Msg, int wParam, IntPtr lParam); + + [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] + private static extern IntPtr CreateFileMapping(int hFile, IntPtr lpAttributes, uint flProtect, uint dwMaxSizeHi, uint dwMaxSizeLow, string lpName); + + [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] + private static extern IntPtr OpenFileMapping(uint dwDesiredAccess, [MarshalAs(UnmanagedType.Bool)] bool bInheritHandle, string lpName); + + [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] + private static extern IntPtr MapViewOfFile(IntPtr hFileMapping, uint dwDesiredAccess, uint dwFileOffsetHigh, uint dwFileOffsetLow, uint dwNumberOfBytesToMap); + + [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] + private static extern bool UnmapViewOfFile(IntPtr pvBaseAddress); + + [DllImport("Kernel32.dll", CharSet = CharSet.Auto)] + private static extern bool CloseHandle(IntPtr handle); + [DllImport("kernel32", EntryPoint = "GetLastError")] + private static extern int GetLastError(); + [DllImport("user32.dll", EntryPoint = "FindWindow")] + private static extern IntPtr FindWindow(string lpClassName, string lpWindowName); + [DllImport("User32.dll")] + private static extern bool PostMessage(IntPtr hWnd, uint uMsg, int wParam, int lParam); + const int ERROR_ALREADY_EXISTS = 183; + + const int FILE_MAP_COPY = 0x0001; + const int FILE_MAP_WRITE = 0x0002; + const int FILE_MAP_READ = 0x0004; + const int FILE_MAP_ALL_ACCESS = 0x0002 | 0x0004; + + const int PAGE_READONLY = 0x02; + const int PAGE_READWRITE = 0x04; + const int PAGE_WRITECOPY = 0x08; + const int PAGE_EXECUTE = 0x10; + const int PAGE_EXECUTE_READ = 0x20; + const int PAGE_EXECUTE_READWRITE = 0x40; + + const int SEC_COMMIT = 0x8000000; + const int SEC_IMAGE = 0x1000000; + const int SEC_NOCACHE = 0x10000000; + const int SEC_RESERVE = 0x4000000; + const int INVALID_HANDLE_VALUE = -1; + /// + /// 写共享内存 + /// + /// 需要映射的文件的字节数量 + /// 映射对象（简单类型、结构体等） + /// 文件映射对象的名称 + /// + public static int WriteToMemory(uint structSize, Object obj, string fileName) + { + return WriteToMemory(structSize, obj, fileName, null, 0); + } + /// + /// 写共享内存 + /// + /// 映射对象（简单类型、结构体等） + /// 文件映射对象的名称 + /// + public static int WriteToMemory(int obj, string fileName) + { + return WriteToMemory(1024, obj, fileName, null, 0); + } + /// + /// 写共享内存 + /// + /// 映射对象（简单类型、结构体等） + /// 文件映射对象的名称 + /// + public static int WriteToMemory(long obj, string fileName) + { + return WriteToMemory(1024, obj, fileName, null, 0); + } + /// + /// 写共享内存 + /// + /// 映射对象（简单类型、结构体等） + /// 文件映射对象的名称 + /// + public static int WriteToMemory(DateTime obj, string fileName) + { + return WriteToMemory(1024, obj, fileName, null, 0); + } + /// + /// 写共享内存 + /// + /// 映射对象（简单类型、结构体等） + /// 文件映射对象的名称 + /// + public static int WriteToMemory(bool obj, string fileName) + { + return WriteToMemory(1024, obj, fileName, null, 0); + } + /// + /// 写共享内存 + /// + /// 映射对象（简单类型、结构体等） + /// 文件映射对象的名称 + /// + public static int WriteToMemory(decimal obj, string fileName) + { + return WriteToMemory(1024, obj, fileName, null, 0); + } + /// + /// 写共享内存 + /// + /// 映射对象（简单类型、结构体等） + /// 文件映射对象的名称 + /// + public static int WriteToMemory(double obj, string fileName) + { + return WriteToMemory(1024, obj, fileName, null, 0); + } + /// + /// 删除内存映射 + /// + /// + /// + public static int DelMemory(string fileName) + { + if (dict.ContainsKey(fileName+"_2")) + { + UnmapViewOfFile(dict[fileName + "_2"]); + dict.Remove(fileName + "_2"); + } + if (dict.ContainsKey(fileName + "_1")) + { + CloseHandle(dict[fileName + "_1"]); + dict.Remove(fileName + "_1"); + } + return 1; + } + private static Dictionary dict = new Dictionary(); + /// + /// 写共享内存 + /// + /// 需要映射的文件的字节数量 + /// 映射对象（简单类型、结构体等） + /// 文件映射对象的名称 + /// 发送消息的窗口句柄 + /// 发送消息 + /// + public static int WriteToMemory(uint structSize, Object obj, string fileName, string windowName, uint Msg) + { + IntPtr hShareMemoryHandle; + IntPtr hVoid; + + //判断参数的合法性 + if (structSize > 0 && fileName.Length > 0) + { + hShareMemoryHandle = CreateFileMapping(INVALID_HANDLE_VALUE, IntPtr.Zero, (uint)PAGE_READWRITE, 0, (uint)structSize, fileName); + if (hShareMemoryHandle == IntPtr.Zero) + { + //创建共享内存失败，记log + // MessageBox.Show("创建共享内存失败" + publicInfo.GetLastError().ToString()); + return -2; + } + else + { + if (ERROR_ALREADY_EXISTS == GetLastError()) + { + //共享内存已经存在，记log + //MessageBox.Show("共享内存已经存在"); + return -3; + } + } + hVoid = MapViewOfFile(hShareMemoryHandle, FILE_MAP_WRITE, 0, 0, structSize); + if (hVoid == IntPtr.Zero) + { + CloseHandle(hShareMemoryHandle); + //文件映射失败，记log + //MessageBox.Show("文件映射失败"); + return -4; + } + dict[fileName+"_1"] = hShareMemoryHandle; + dict[fileName + "_2"] = hVoid; + Marshal.StructureToPtr(obj, hVoid, false); + //发送消息，通知接收 + if (windowName != null) + { + IntPtr handle = FindWindow(null, windowName.Trim()); + if (handle == IntPtr.Zero) + { + //查找窗口失败，记log + //MessageBox.Show("查找窗口失败"); + return -5; + } + else + { + if (PostMessage(handle, (uint)Msg, 0, 0)) + { + //发送消息成功 + //MessageBox.Show("写共享内存，通知发送消息成功"); + } + } + } + } + else + { + //参数不合法，记log + //MessageBox.Show("共享内存已经存在"); + return -1; + } + return 0; + } /// /// 读共享内存 /// /// /// - /// + /// public static Int64 ReadFromMemory(string fileName,Int64 defValue) { var result= ReadFromMemory(1024, typeof(Int64), fileName); @@ -151,7 +234,7 @@ namespace QuickMsg /// /// /// - /// + /// public static int ReadFromMemory(string fileName, int defValue) { var result = ReadFromMemory(1024, typeof(int), fileName); @@ -164,98 +247,98 @@ namespace QuickMsg /// /// /// - /// + /// public static string ReadFromMemory(string fileName, uint structSize, string defValue) { var result = ReadFromMemory(structSize, typeof(string), fileName); if (result == null) { return defValue; } return (string)result; - } - /// - /// 读共享内存 - /// - /// 需要映射的文件的字节数量 - /// 类型 - /// 文件映射对象的名称 - /// 返回读到的映射对象 - public static Object ReadFromMemory(uint structSize, Type type, string fileName) - { - - IntPtr hMappingHandle; - IntPtr hVoid; - - hMappingHandle = OpenFileMapping((uint)FILE_MAP_READ, false, fileName); - if (hMappingHandle == IntPtr.Zero) - { - //打开共享内存失败，记log - //MessageBox.Show("打开共享内存失败:" + publicInfo.GetLastError().ToString()); - return null; - } - hVoid = MapViewOfFile(hMappingHandle, FILE_MAP_READ, 0, 0, structSize); - if (hVoid == IntPtr.Zero) - { - //文件映射失败，记log - // MessageBox.Show("文件映射失败——读共享内存"); - return null; - } - - Object obj = Marshal.PtrToStructure(hVoid, type); - - if (hVoid != IntPtr.Zero) - { - UnmapViewOfFile(hVoid); - hVoid = IntPtr.Zero; - } - if (hMappingHandle != IntPtr.Zero) - { - CloseHandle(hMappingHandle); - hMappingHandle = IntPtr.Zero; - } - return obj; - } - /// - /// 读共享内存 - /// - /// 需要映射的文件的字节数量 - /// 类型 - /// 文件映射对象的名称 - /// 返回读到的映射字节数据 - public static byte[] ReadFromMemory2(uint structSize, Type type, string fileName) - { - - IntPtr hMappingHandle = IntPtr.Zero; - IntPtr hVoid = IntPtr.Zero; - - hMappingHandle = OpenFileMapping((uint)FILE_MAP_READ, false, fileName); - if (hMappingHandle == IntPtr.Zero) - { - //打开共享内存失败，记log - //MessageBox.Show("打开共享内存失败:" + publicInfo.GetLastError().ToString()); - return null; - } - hVoid = MapViewOfFile(hMappingHandle, FILE_MAP_READ, 0, 0, structSize); - if (hVoid == IntPtr.Zero) - { - //文件映射失败，记log - //MessageBox.Show("文件映射失败——读共享内存"); - return null; - } - - //Object obj = Marshal.PtrToStructure(hVoid, type); - byte[] bytes = new byte[structSize]; - Marshal.Copy(hVoid, bytes, 0, bytes.Length); - - if (hVoid != IntPtr.Zero) - { - UnmapViewOfFile(hVoid); - hVoid = IntPtr.Zero; - } - if (hMappingHandle != IntPtr.Zero) - { - CloseHandle(hMappingHandle); - hMappingHandle = IntPtr.Zero; - } - return bytes; - } - } -} + } + /// + /// 读共享内存 + /// + /// 需要映射的文件的字节数量 + /// 类型 + /// 文件映射对象的名称 + /// 返回读到的映射对象 + public static Object ReadFromMemory(uint structSize, Type type, string fileName) + { + + IntPtr hMappingHandle; + IntPtr hVoid; + + hMappingHandle = OpenFileMapping((uint)FILE_MAP_READ, false, fileName); + if (hMappingHandle == IntPtr.Zero) + { + //打开共享内存失败，记log + //MessageBox.Show("打开共享内存失败:" + publicInfo.GetLastError().ToString()); + return null; + } + hVoid = MapViewOfFile(hMappingHandle, FILE_MAP_READ, 0, 0, structSize); + if (hVoid == IntPtr.Zero) + { + //文件映射失败，记log + // MessageBox.Show("文件映射失败——读共享内存"); + return null; + } + + Object obj = Marshal.PtrToStructure(hVoid, type); + + if (hVoid != IntPtr.Zero) + { + UnmapViewOfFile(hVoid); + hVoid = IntPtr.Zero; + } + if (hMappingHandle != IntPtr.Zero) + { + CloseHandle(hMappingHandle); + hMappingHandle = IntPtr.Zero; + } + return obj; + } + /// + /// 读共享内存 + /// + /// 需要映射的文件的字节数量 + /// 类型 + /// 文件映射对象的名称 + /// 返回读到的映射字节数据 + public static byte[] ReadFromMemory2(uint structSize, Type type, string fileName) + { + + IntPtr hMappingHandle = IntPtr.Zero; + IntPtr hVoid = IntPtr.Zero; + + hMappingHandle = OpenFileMapping((uint)FILE_MAP_READ, false, fileName); + if (hMappingHandle == IntPtr.Zero) + { + //打开共享内存失败，记log + //MessageBox.Show("打开共享内存失败:" + publicInfo.GetLastError().ToString()); + return null; + } + hVoid = MapViewOfFile(hMappingHandle, FILE_MAP_READ, 0, 0, structSize); + if (hVoid == IntPtr.Zero) + { + //文件映射失败，记log + //MessageBox.Show("文件映射失败——读共享内存"); + return null; + } + + //Object obj = Marshal.PtrToStructure(hVoid, type); + byte[] bytes = new byte[structSize]; + Marshal.Copy(hVoid, bytes, 0, bytes.Length); + + if (hVoid != IntPtr.Zero) + { + UnmapViewOfFile(hVoid); + hVoid = IntPtr.Zero; + } + if (hMappingHandle != IntPtr.Zero) + { + CloseHandle(hMappingHandle); + hMappingHandle = IntPtr.Zero; + } + return bytes; + } + } +} diff --git a/Source/MyDb/MyDb/DbInterface.cs b/Source/MyDb/MyDb/DbInterface.cs index 4e5db30..dc4558a 100644 --- a/Source/MyDb/MyDb/DbInterface.cs +++ b/Source/MyDb/MyDb/DbInterface.cs @@ -190,5 +190,10 @@ namespace ryCommonDb /// 释放资源 /// void Free(); + /// + /// 最后一个错误信息 + /// + /// + string GetLastError(); } } diff --git a/Source/MyDb/MyDb/MSSQL/SqlDataProvider.cs b/Source/MyDb/MyDb/MSSQL/SqlDataProvider.cs index c23bca8..81292d5 100644 --- a/Source/MyDb/MyDb/MSSQL/SqlDataProvider.cs +++ b/Source/MyDb/MyDb/MSSQL/SqlDataProvider.cs @@ -13,6 +13,15 @@ namespace ryCommonDb /// public class SqlDataProvider:IDbInterface { + private string error_text = ""; + /// + /// 获取最后一次错误信息 + /// + /// + public string GetLastError() + { + return error_text; + } ryCommonDb.MSSQLDb myDb = new MSSQLDb(); /// /// @@ -206,7 +215,7 @@ namespace ryCommonDb cmd.Dispose(); return ds; } - catch { return new System.Data.DataSet(); } + catch(Exception ex) { error_text = ex.Message; return new System.Data.DataSet(); } } /// /// @@ -259,7 +268,7 @@ namespace ryCommonDb cmd.Dispose(); return i; } - catch { return -1; } + catch(Exception ex) { error_text = ex.Message; return -1; } } /// /// 执行SQL语句 diff --git a/Source/MyDb/MyDb/ryQuickSQL.cs b/Source/MyDb/MyDb/ryQuickSQL.cs index 9d3f6dc..f29cd2a 100644 --- a/Source/MyDb/MyDb/ryQuickSQL.cs +++ b/Source/MyDb/MyDb/ryQuickSQL.cs @@ -1,369 +1,369 @@ -using System; -using System.Collections.Generic; - -namespace ryCommonDb -{ - /// - /// SQL字段类型 - /// - public class SQLIitem - { - /// - /// SQL字段类型 - /// - /// - /// - public SQLIitem(string _field,object _value) - { - Field = _field; - value = _value; - len = 0; - } - /// - /// SQL字段类型 - /// - /// - /// - /// - public SQLIitem(string _field, object _value,int _len) - { - Field = _field; - value = _value; - len = _len; - } - /// - /// SQL字段名 - /// - public string Field = ""; - /// - /// SQL字段值 - /// - public object value; - /// - /// SQL字段长度 - /// - public int len = 0; - /// - /// 不是真的值，而是用于计算的值 - /// - public bool isNoValue = false; - } - /// - /// SQL快速操作类 - /// - public class RyQuickSQL - { - /// - /// SQL快速操作类 - /// - /// - public RyQuickSQL(string _tableName) - { TableName = _tableName; } - /// - /// 表名 - /// - public string TableName{get;set;} - /// - /// 操作字段列表 - /// - public List List { get; } = new List(); - /// - /// 清理使用资源 - /// - public void Free() - { - Clear(); - } - /// - /// 清理使用资源 - /// - public void Dispose() - { - Free(); - } +using System; +using System.Collections.Generic; + +namespace ryCommonDb +{ + /// + /// SQL字段类型 + /// + public class SQLIitem + { + /// + /// SQL字段类型 + /// + /// + /// + public SQLIitem(string _field,object _value) + { + Field = _field; + value = _value; + len = 0; + } + /// + /// SQL字段类型 + /// + /// + /// + /// + public SQLIitem(string _field, object _value,int _len) + { + Field = _field; + value = _value; + len = _len; + } + /// + /// SQL字段名 + /// + public string Field = ""; + /// + /// SQL字段值 + /// + public object value; + /// + /// SQL字段长度 + /// + public int len = 0; + /// + /// 不是真的值，而是用于计算的值 + /// + public bool isNoValue = false; + } + /// + /// SQL快速操作类 + /// + public class RyQuickSQL + { + /// + /// SQL快速操作类 + /// + /// + public RyQuickSQL(string _tableName) + { TableName = _tableName; } + /// + /// 表名 + /// + public string TableName{get;set;} + /// + /// 操作字段列表 + /// + public List List { get; } = new List(); /// /// 清理使用资源 - /// + /// + public void Free() + { + Clear(); + } + /// + /// 清理使用资源 + /// + public void Dispose() + { + Free(); + } + /// + /// 清理使用资源 + /// ~RyQuickSQL() { Free(); - } - /// - /// 操作参数列表 - /// - public List List_param { get; } = new List(); - /// - /// 操作参数列表 - /// - private List List_Nullparam { get; } = new List(); - private void ListAdd(SQLIitem item) - { - if(!List.Contains(item)) - List.Add(item); - } - /// - /// 添加字符串字段 - /// - /// - /// - public void AddField(string field,string value) - { - ListAdd(new SQLIitem(field, value)); - } - /// - /// 添加null值字段 - /// - /// - public void AddNullField(string field) - { - if (!List_Nullparam.Contains(field)) - List_Nullparam.Add(field); - } - /// - /// 添加日期字段 - /// - /// - /// - public void AddField(string field, DateTime value) - { - ListAdd(new SQLIitem(field, value)); - } - /// - /// 添加int字段 - /// - /// - /// - public void AddField(string field, int value) - { - ListAdd(new SQLIitem(field, value)); - } - /// - /// 添加double字段 - /// - /// - /// - public void AddField(string field, double value) - { - ListAdd(new SQLIitem(field, value)); - } - /// - /// 添加decimal字段 - /// - /// - /// - public void AddField(string field, decimal value) - { - ListAdd(new SQLIitem(field, value)); } - /// - /// 添加byte[]字段 - /// - /// - /// - public void AddField(string field, byte[] value) - { - ListAdd(new SQLIitem(field, value)); - } - /// - /// 添加bool字段 - /// - /// - /// - public void AddField(string field, bool value) - { - ListAdd(new SQLIitem(field, value)); - } - /// - /// 添加用于计算的值 - /// - /// - /// - public void AddFieldCalc(string field, string value) - { - List_calcparam.Add(new SQLIitem(field, value) { isNoValue=true }); - } - /// - /// 添加Int64字段 - /// - /// - /// - public void AddField(string field, Int64 value) - { - ListAdd(new SQLIitem(field, value)); - } - /// - /// 清空内容 - /// - public void Clear() - { - List.Clear(); - List_param.Clear(); - List_calcparam.Clear(); - List_Nullparam.Clear(); - } - /// - /// 数量 - /// - public int Count - { - get { return List.Count + List_param.Count; } - } - /// - /// - /// - public List List_calcparam { get; set; } = new List(); - - /// - /// 输出多条件搜索。 - /// - /// 字段名,多个字段请用逗号分隔。 - /// 多个条件之间请用空格隔开 - /// - public string GetSearchSQL(string Fields, string SearchText) - { - string tmpSQL = ""; - string tmpFieldSQL = "("; - string[] m_name = Fields.Split(",，".ToCharArray()); - string[] tmpFieldNames = new string[m_name.Length]; - for (int i = 0; i < m_name.Length; i++) - { - #region 提取字段信息 - tmpFieldNames[i] = m_name[i]; - if (i == 0) - { - tmpFieldSQL += tmpFieldNames[i] + " like @SearchText"; - } - else - { - tmpFieldSQL += " or " + tmpFieldNames[i] + " like @SearchText"; - } - #endregion - } - tmpFieldSQL += ")"; - string[] m_SearchText = SearchText.Split(' '); - string tmpSearchSQL = ""; - for (int i = 0; i < m_SearchText.Length; i++) - { - if (i == 0) - { - tmpSearchSQL = tmpFieldSQL.Replace("@SearchText", "@st_ry" + i.ToString()); - } - else - { - tmpSearchSQL += " and " + tmpFieldSQL.Replace("@SearchText", "@st_ry" + i.ToString()); - } - AddParameter("@st_ry" + i.ToString(), "%" + m_SearchText[i] + "%"); - } - return tmpSQL + tmpSearchSQL; - } - /// - /// 获取插入SQL语句 - /// - /// - public string GetInsertSQL() - { - string tmpSQL = "insert into " + TableName + " "; - string tmpFieldSQL = "("; - string valueSQL = "("; - for (int i = 0; i + /// 操作参数列表 + /// + public List List_param { get; } = new List(); + /// + /// 操作参数列表 + /// + private List List_Nullparam { get; } = new List(); + private void ListAdd(SQLIitem item) + { + if(!List.Contains(item)) + List.Add(item); + } + /// + /// 添加字符串字段 + /// + /// + /// + public void AddField(string field,string value) + { + ListAdd(new SQLIitem(field, value)); + } + /// + /// 添加null值字段 + /// + /// + public void AddNullField(string field) + { + if (!List_Nullparam.Contains(field)) + List_Nullparam.Add(field); + } + /// + /// 添加日期字段 + /// + /// + /// + public void AddField(string field, DateTime value) + { + ListAdd(new SQLIitem(field, value)); + } + /// + /// 添加int字段 + /// + /// + /// + public void AddField(string field, int value) + { + ListAdd(new SQLIitem(field, value)); + } + /// + /// 添加double字段 + /// + /// + /// + public void AddField(string field, double value) + { + ListAdd(new SQLIitem(field, value)); + } + /// + /// 添加decimal字段 + /// + /// + /// + public void AddField(string field, decimal value) + { + ListAdd(new SQLIitem(field, value)); + } + /// + /// 添加byte[]字段 + /// + /// + /// + public void AddField(string field, byte[] value) + { + ListAdd(new SQLIitem(field, value)); + } + /// + /// 添加bool字段 + /// + /// + /// + public void AddField(string field, bool value) + { + ListAdd(new SQLIitem(field, value)); + } + /// + /// 添加用于计算的值 + /// + /// + /// + public void AddFieldCalc(string field, string value) + { + List_calcparam.Add(new SQLIitem(field, value) { isNoValue=true }); + } + /// + /// 添加Int64字段 + /// + /// + /// + public void AddField(string field, Int64 value) + { + ListAdd(new SQLIitem(field, value)); + } + /// + /// 清空内容 + /// + public void Clear() + { + List.Clear(); + List_param.Clear(); + List_calcparam.Clear(); + List_Nullparam.Clear(); + } + /// + /// 数量 + /// + public int Count + { + get { return List.Count + List_param.Count; } + } + /// + /// + /// + public List List_calcparam { get; set; } = new List(); + + /// + /// 输出多条件搜索。 + /// + /// 字段名,多个字段请用逗号分隔。 + /// 多个条件之间请用空格隔开 + /// + public string GetSearchSQL(string Fields, string SearchText) + { + string tmpSQL = ""; + string tmpFieldSQL = "("; + string[] m_name = Fields.Split(",，".ToCharArray()); + string[] tmpFieldNames = new string[m_name.Length]; + for (int i = 0; i < m_name.Length; i++) + { + #region 提取字段信息 + tmpFieldNames[i] = m_name[i]; + if (i == 0) + { + tmpFieldSQL += tmpFieldNames[i] + " like @SearchText"; + } + else + { + tmpFieldSQL += " or " + tmpFieldNames[i] + " like @SearchText"; + } + #endregion + } + tmpFieldSQL += ")"; + string[] m_SearchText = SearchText.Split(' '); + string tmpSearchSQL = ""; + for (int i = 0; i < m_SearchText.Length; i++) + { + if (i == 0) + { + tmpSearchSQL = tmpFieldSQL.Replace("@SearchText", "@st_ry" + i.ToString()); + } + else + { + tmpSearchSQL += " and " + tmpFieldSQL.Replace("@SearchText", "@st_ry" + i.ToString()); + } + AddParameter("@st_ry" + i.ToString(), "%" + m_SearchText[i] + "%"); + } + return tmpSQL + tmpSearchSQL; + } + /// + /// 获取插入SQL语句 + /// + /// + public string GetInsertSQL() + { + string tmpSQL = "insert into " + TableName + " "; + string tmpFieldSQL = "("; + string valueSQL = "("; + for (int i = 0; i - /// 获取更新SQL语句 - /// - /// - public string GetUpdateSQL() - { - string tmpSQL = "update " + TableName + " set "; - for (int i = 0; i < List.Count; i++) - { + } + } + for (int i = 0; i < List_Nullparam.Count; i++) + { + tmpFieldSQL += List_Nullparam[i] + ","; + valueSQL += "null,"; + } + return tmpSQL + tmpFieldSQL.Substring(0, tmpFieldSQL.Length - 1) + ") values" + valueSQL.Substring(0, valueSQL.Length - 1) + ")"; + } + /// + /// 获取更新SQL语句 + /// + /// + public string GetUpdateSQL() + { + string tmpSQL = "update " + TableName + " set "; + for (int i = 0; i < List.Count; i++) + { SQLIitem item = List[i]; if (item.value is long int1) { tmpSQL += item.Field + "=" + int1 + ","; - } + } else if (item.value is int @int) { tmpSQL += item.Field + "=" + @int + ","; - } + } else { tmpSQL += item.Field + "=" + "@" + item.Field.TrimStart('[').TrimEnd(']') + ","; - } - } - for (int i = 0; i < List_Nullparam.Count; i++) - { - tmpSQL += List_Nullparam[i] + "=" + "null,"; - } - return tmpSQL.Substring(0, tmpSQL.Length - 1); - } - /// - /// 添加参数 - /// - /// - /// - public void AddParameter(string name,object value) - { - List_param.Add(new SQLIitem(name.TrimStart('@'), value)); - } - /// - /// 获取Ole参数 - /// - /// - public System.Data.OleDb.OleDbParameter[] GetOleParameters() - { - System.Data.OleDb.OleDbParameter[] defPar = new System.Data.OleDb.OleDbParameter[List.Count+ List_param.Count]; - for (int i = 0; i < List.Count; i++) - { - SQLIitem item = List[i]; - defPar[i] =new System.Data.OleDb.OleDbParameter("@"+item.Field, item.value); - } - for (int i = List.Count; i < List.Count + List_param.Count; i++) - { - SQLIitem item = List_param[i- List.Count]; - defPar[i] = new System.Data.OleDb.OleDbParameter("@" + item.Field.TrimStart('@'), item.value); - } - return defPar; - } - /// - /// 获取SQL参数 - /// - /// - public System.Data.SqlClient.SqlParameter[] GetSqlParameter() - { - System.Data.SqlClient.SqlParameter[] defPar = new System.Data.SqlClient.SqlParameter[List.Count + List_param.Count]; - for (int i = 0; i < List.Count; i++) - { - SQLIitem item = (SQLIitem)List[i]; - defPar[i] = new System.Data.SqlClient.SqlParameter("@" + item.Field, item.value); - } - for (int i = List.Count; i < List.Count + List_param.Count; i++) - { - SQLIitem item = (SQLIitem)List_param[i - List.Count]; - defPar[i] = new System.Data.SqlClient.SqlParameter("@" + item.Field.TrimStart('@'), item.value); - } - return defPar; - } - } -} + } + } + for (int i = 0; i < List_Nullparam.Count; i++) + { + tmpSQL += List_Nullparam[i] + "=" + "null,"; + } + return tmpSQL.Substring(0, tmpSQL.Length - 1); + } + /// + /// 添加参数 + /// + /// + /// + public void AddParameter(string name,object value) + { + List_param.Add(new SQLIitem(name.TrimStart('@'), value)); + } + /// + /// 获取Ole参数 + /// + /// + public System.Data.OleDb.OleDbParameter[] GetOleParameters() + { + System.Data.OleDb.OleDbParameter[] defPar = new System.Data.OleDb.OleDbParameter[List.Count+ List_param.Count]; + for (int i = 0; i < List.Count; i++) + { + SQLIitem item = List[i]; + defPar[i] =new System.Data.OleDb.OleDbParameter("@"+item.Field, item.value); + } + for (int i = List.Count; i < List.Count + List_param.Count; i++) + { + SQLIitem item = List_param[i- List.Count]; + defPar[i] = new System.Data.OleDb.OleDbParameter("@" + item.Field.TrimStart('@'), item.value); + } + return defPar; + } + /// + /// 获取SQL参数 + /// + /// + public System.Data.SqlClient.SqlParameter[] GetSqlParameter() + { + System.Data.SqlClient.SqlParameter[] defPar = new System.Data.SqlClient.SqlParameter[List.Count + List_param.Count]; + for (int i = 0; i < List.Count; i++) + { + SQLIitem item = (SQLIitem)List[i]; + defPar[i] = new System.Data.SqlClient.SqlParameter("@" + item.Field, item.value); + } + for (int i = List.Count; i < List.Count + List_param.Count; i++) + { + SQLIitem item = (SQLIitem)List_param[i - List.Count]; + defPar[i] = new System.Data.SqlClient.SqlParameter("@" + item.Field.TrimStart('@'), item.value); + } + return defPar; + } + } +} diff --git a/Source/MyDb/MyDbV4.csproj b/Source/MyDb/MyDbV4.csproj index 2d4f6a9..088a6f4 100644 --- a/Source/MyDb/MyDbV4.csproj +++ b/Source/MyDb/MyDbV4.csproj @@ -22,6 +22,7 @@ 4 AnyCPU ..\..\Bin\Debug\CommonControls\.NET4\MyDb.xml + true none @@ -56,6 +57,7 @@ + @@ -77,9 +79,11 @@ + + @@ -139,6 +143,7 @@ + @@ -150,6 +155,8 @@ + + diff --git a/Source/MyDb/Newtonsoft.Json/Bson/BsonBinaryType.cs b/Source/MyDb/Newtonsoft.Json/Bson/BsonBinaryType.cs deleted file mode 100644 index 3ac0020..0000000 --- a/Source/MyDb/Newtonsoft.Json/Bson/BsonBinaryType.cs +++ /dev/null @@ -1,46 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -#nullable disable - -namespace Newtonsoft.Json.Bson -{ - internal enum BsonBinaryType : byte - { - Binary = 0x00, - Function = 0x01, - - [Obsolete("This type has been deprecated in the BSON specification. Use Binary instead.")] - BinaryOld = 0x02, - - [Obsolete("This type has been deprecated in the BSON specification. Use Uuid instead.")] - UuidOld = 0x03, - Uuid = 0x04, - Md5 = 0x05, - UserDefined = 0x80 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Bson/BsonBinaryWriter.cs b/Source/MyDb/Newtonsoft.Json/Bson/BsonBinaryWriter.cs deleted file mode 100644 index 1f3c0aa..0000000 --- a/Source/MyDb/Newtonsoft.Json/Bson/BsonBinaryWriter.cs +++ /dev/null @@ -1,330 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using System.IO; -using System.Text; -using Newtonsoft.Json.Utilities; - -#nullable disable - -namespace Newtonsoft.Json.Bson -{ - internal class BsonBinaryWriter - { - private static readonly Encoding Encoding = new UTF8Encoding(false); - - private readonly BinaryWriter _writer; - - private byte[] _largeByteBuffer; - - public DateTimeKind DateTimeKindHandling { get; set; } - - public BsonBinaryWriter(BinaryWriter writer) - { - DateTimeKindHandling = DateTimeKind.Utc; - _writer = writer; - } - - public void Flush() - { - _writer.Flush(); - } - - public void Close() - { -#if HAVE_STREAM_READER_WRITER_CLOSE - _writer.Close(); -#else - _writer.Dispose(); -#endif - } - - public void WriteToken(BsonToken t) - { - CalculateSize(t); - WriteTokenInternal(t); - } - - private void WriteTokenInternal(BsonToken t) - { - switch (t.Type) - { - case BsonType.Object: - { - BsonObject value = (BsonObject)t; - _writer.Write(value.CalculatedSize); - foreach (BsonProperty property in value) - { - _writer.Write((sbyte)property.Value.Type); - WriteString((string)property.Name.Value, property.Name.ByteCount, null); - WriteTokenInternal(property.Value); - } - _writer.Write((byte)0); - } - break; - case BsonType.Array: - { - BsonArray value = (BsonArray)t; - _writer.Write(value.CalculatedSize); - ulong index = 0; - foreach (BsonToken c in value) - { - _writer.Write((sbyte)c.Type); - WriteString(index.ToString(CultureInfo.InvariantCulture), MathUtils.IntLength(index), null); - WriteTokenInternal(c); - index++; - } - _writer.Write((byte)0); - } - break; - case BsonType.Integer: - { - BsonValue value = (BsonValue)t; - _writer.Write(Convert.ToInt32(value.Value, CultureInfo.InvariantCulture)); - } - break; - case BsonType.Long: - { - BsonValue value = (BsonValue)t; - _writer.Write(Convert.ToInt64(value.Value, CultureInfo.InvariantCulture)); - } - break; - case BsonType.Number: - { - BsonValue value = (BsonValue)t; - _writer.Write(Convert.ToDouble(value.Value, CultureInfo.InvariantCulture)); - } - break; - case BsonType.String: - { - BsonString value = (BsonString)t; - WriteString((string)value.Value, value.ByteCount, value.CalculatedSize - 4); - } - break; - case BsonType.Boolean: - _writer.Write(t == BsonBoolean.True); - break; - case BsonType.Null: - case BsonType.Undefined: - break; - case BsonType.Date: - { - BsonValue value = (BsonValue)t; - - long ticks = 0; - - if (value.Value is DateTime dateTime) - { - if (DateTimeKindHandling == DateTimeKind.Utc) - { - dateTime = dateTime.ToUniversalTime(); - } - else if (DateTimeKindHandling == DateTimeKind.Local) - { - dateTime = dateTime.ToLocalTime(); - } - - ticks = DateTimeUtils.ConvertDateTimeToJavaScriptTicks(dateTime, false); - } -#if HAVE_DATE_TIME_OFFSET - else - { - DateTimeOffset dateTimeOffset = (DateTimeOffset)value.Value; - ticks = DateTimeUtils.ConvertDateTimeToJavaScriptTicks(dateTimeOffset.UtcDateTime, dateTimeOffset.Offset); - } -#endif - - _writer.Write(ticks); - } - break; - case BsonType.Binary: - { - BsonBinary value = (BsonBinary)t; - - byte[] data = (byte[])value.Value; - _writer.Write(data.Length); - _writer.Write((byte)value.BinaryType); - _writer.Write(data); - } - break; - case BsonType.Oid: - { - BsonValue value = (BsonValue)t; - - byte[] data = (byte[])value.Value; - _writer.Write(data); - } - break; - case BsonType.Regex: - { - BsonRegex value = (BsonRegex)t; - - WriteString((string)value.Pattern.Value, value.Pattern.ByteCount, null); - WriteString((string)value.Options.Value, value.Options.ByteCount, null); - } - break; - default: - throw new ArgumentOutOfRangeException(nameof(t), "Unexpected token when writing BSON: {0}".FormatWith(CultureInfo.InvariantCulture, t.Type)); - } - } - - private void WriteString(string s, int byteCount, int? calculatedlengthPrefix) - { - if (calculatedlengthPrefix != null) - { - _writer.Write(calculatedlengthPrefix.GetValueOrDefault()); - } - - WriteUtf8Bytes(s, byteCount); - - _writer.Write((byte)0); - } - - public void WriteUtf8Bytes(string s, int byteCount) - { - if (s != null) - { - if (byteCount <= 256) - { - if (_largeByteBuffer == null) - { - _largeByteBuffer = new byte[256]; - } - - Encoding.GetBytes(s, 0, s.Length, _largeByteBuffer, 0); - _writer.Write(_largeByteBuffer, 0, byteCount); - } - else - { - byte[] bytes = Encoding.GetBytes(s); - _writer.Write(bytes); - } - } - } - - private int CalculateSize(int stringByteCount) - { - return stringByteCount + 1; - } - - private int CalculateSizeWithLength(int stringByteCount, bool includeSize) - { - int baseSize = (includeSize) - ? 5 // size bytes + terminator - : 1; // terminator - - return baseSize + stringByteCount; - } - - private int CalculateSize(BsonToken t) - { - switch (t.Type) - { - case BsonType.Object: - { - BsonObject value = (BsonObject)t; - - int bases = 4; - foreach (BsonProperty p in value) - { - int size = 1; - size += CalculateSize(p.Name); - size += CalculateSize(p.Value); - - bases += size; - } - bases += 1; - value.CalculatedSize = bases; - return bases; - } - case BsonType.Array: - { - BsonArray value = (BsonArray)t; - - int size = 4; - ulong index = 0; - foreach (BsonToken c in value) - { - size += 1; - size += CalculateSize(MathUtils.IntLength(index)); - size += CalculateSize(c); - index++; - } - size += 1; - value.CalculatedSize = size; - - return value.CalculatedSize; - } - case BsonType.Integer: - return 4; - case BsonType.Long: - return 8; - case BsonType.Number: - return 8; - case BsonType.String: - { - BsonString value = (BsonString)t; - string s = (string)value.Value; - value.ByteCount = (s != null) ? Encoding.GetByteCount(s) : 0; - value.CalculatedSize = CalculateSizeWithLength(value.ByteCount, value.IncludeLength); - - return value.CalculatedSize; - } - case BsonType.Boolean: - return 1; - case BsonType.Null: - case BsonType.Undefined: - return 0; - case BsonType.Date: - return 8; - case BsonType.Binary: - { - BsonBinary value = (BsonBinary)t; - - byte[] data = (byte[])value.Value; - value.CalculatedSize = 4 + 1 + data.Length; - - return value.CalculatedSize; - } - case BsonType.Oid: - return 12; - case BsonType.Regex: - { - BsonRegex value = (BsonRegex)t; - int size = 0; - size += CalculateSize(value.Pattern); - size += CalculateSize(value.Options); - value.CalculatedSize = size; - - return value.CalculatedSize; - } - default: - throw new ArgumentOutOfRangeException(nameof(t), "Unexpected token when writing BSON: {0}".FormatWith(CultureInfo.InvariantCulture, t.Type)); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Bson/BsonObjectId.cs b/Source/MyDb/Newtonsoft.Json/Bson/BsonObjectId.cs deleted file mode 100644 index 4e1461d..0000000 --- a/Source/MyDb/Newtonsoft.Json/Bson/BsonObjectId.cs +++ /dev/null @@ -1,60 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Utilities; - -#nullable disable - -namespace Newtonsoft.Json.Bson -{ - /// - /// Represents a BSON Oid (object id). - /// - [Obsolete("BSON reading and writing has been moved to its own package. See https://www.nuget.org/packages/Newtonsoft.Json.Bson for more details.")] - public class BsonObjectId - { - /// - /// Gets or sets the value of the Oid. - /// - /// The value of the Oid. - public byte[] Value { get; } - - /// - /// Initializes a new instance of the class. - /// - /// The Oid value. - public BsonObjectId(byte[] value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - if (value.Length != 12) - { - throw new ArgumentException("An ObjectId must be 12 bytes", nameof(value)); - } - - Value = value; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Bson/BsonReader.cs b/Source/MyDb/Newtonsoft.Json/Bson/BsonReader.cs deleted file mode 100644 index 4556933..0000000 --- a/Source/MyDb/Newtonsoft.Json/Bson/BsonReader.cs +++ /dev/null @@ -1,836 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; -using System.Text; -using System.IO; -using Newtonsoft.Json.Serialization; -using Newtonsoft.Json.Utilities; -using Newtonsoft.Json.Linq; - -#nullable disable - -namespace Newtonsoft.Json.Bson -{ - /// - /// Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. - /// - [Obsolete("BSON reading and writing has been moved to its own package. See https://www.nuget.org/packages/Newtonsoft.Json.Bson for more details.")] - public class BsonReader : JsonReader - { - private const int MaxCharBytesSize = 128; - private static readonly byte[] SeqRange1 = new byte[] { 0, 127 }; // range of 1-byte sequence - private static readonly byte[] SeqRange2 = new byte[] { 194, 223 }; // range of 2-byte sequence - private static readonly byte[] SeqRange3 = new byte[] { 224, 239 }; // range of 3-byte sequence - private static readonly byte[] SeqRange4 = new byte[] { 240, 244 }; // range of 4-byte sequence - - private readonly BinaryReader _reader; - private readonly List _stack; - - private byte[] _byteBuffer; - private char[] _charBuffer; - - private BsonType _currentElementType; - private BsonReaderState _bsonReaderState; - private ContainerContext _currentContext; - - private bool _readRootValueAsArray; - private bool _jsonNet35BinaryCompatibility; - private DateTimeKind _dateTimeKindHandling; - - private enum BsonReaderState - { - Normal = 0, - ReferenceStart = 1, - ReferenceRef = 2, - ReferenceId = 3, - CodeWScopeStart = 4, - CodeWScopeCode = 5, - CodeWScopeScope = 6, - CodeWScopeScopeObject = 7, - CodeWScopeScopeEnd = 8 - } - - private class ContainerContext - { - public readonly BsonType Type; - public int Length; - public int Position; - - public ContainerContext(BsonType type) - { - Type = type; - } - } - - /// - /// Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. - /// - /// - /// true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. - /// - [Obsolete("JsonNet35BinaryCompatibility will be removed in a future version of Json.NET.")] - public bool JsonNet35BinaryCompatibility - { - get => _jsonNet35BinaryCompatibility; - set => _jsonNet35BinaryCompatibility = value; - } - - /// - /// Gets or sets a value indicating whether the root object will be read as a JSON array. - /// - /// - /// true if the root object will be read as a JSON array; otherwise, false. - /// - public bool ReadRootValueAsArray - { - get => _readRootValueAsArray; - set => _readRootValueAsArray = value; - } - - /// - /// Gets or sets the used when reading values from BSON. - /// - /// The used when reading values from BSON. - public DateTimeKind DateTimeKindHandling - { - get => _dateTimeKindHandling; - set => _dateTimeKindHandling = value; - } - - /// - /// Initializes a new instance of the class. - /// - /// The containing the BSON data to read. - public BsonReader(Stream stream) - : this(stream, false, DateTimeKind.Local) - { - } - - /// - /// Initializes a new instance of the class. - /// - /// The containing the BSON data to read. - public BsonReader(BinaryReader reader) - : this(reader, false, DateTimeKind.Local) - { - } - - /// - /// Initializes a new instance of the class. - /// - /// The containing the BSON data to read. - /// if set to true the root object will be read as a JSON array. - /// The used when reading values from BSON. - public BsonReader(Stream stream, bool readRootValueAsArray, DateTimeKind dateTimeKindHandling) - { - ValidationUtils.ArgumentNotNull(stream, nameof(stream)); - _reader = new BinaryReader(stream); - _stack = new List(); - _readRootValueAsArray = readRootValueAsArray; - _dateTimeKindHandling = dateTimeKindHandling; - } - - /// - /// Initializes a new instance of the class. - /// - /// The containing the BSON data to read. - /// if set to true the root object will be read as a JSON array. - /// The used when reading values from BSON. - public BsonReader(BinaryReader reader, bool readRootValueAsArray, DateTimeKind dateTimeKindHandling) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - _reader = reader; - _stack = new List(); - _readRootValueAsArray = readRootValueAsArray; - _dateTimeKindHandling = dateTimeKindHandling; - } - - private string ReadElement() - { - _currentElementType = ReadType(); - string elementName = ReadString(); - return elementName; - } - - /// - /// Reads the next JSON token from the underlying . - /// - /// - /// true if the next token was read successfully; false if there are no more tokens to read. - /// - public override bool Read() - { - try - { - bool success; - - switch (_bsonReaderState) - { - case BsonReaderState.Normal: - success = ReadNormal(); - break; - case BsonReaderState.ReferenceStart: - case BsonReaderState.ReferenceRef: - case BsonReaderState.ReferenceId: - success = ReadReference(); - break; - case BsonReaderState.CodeWScopeStart: - case BsonReaderState.CodeWScopeCode: - case BsonReaderState.CodeWScopeScope: - case BsonReaderState.CodeWScopeScopeObject: - case BsonReaderState.CodeWScopeScopeEnd: - success = ReadCodeWScope(); - break; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}".FormatWith(CultureInfo.InvariantCulture, _bsonReaderState)); - } - - if (!success) - { - SetToken(JsonToken.None); - return false; - } - - return true; - } - catch (EndOfStreamException) - { - SetToken(JsonToken.None); - return false; - } - } - - /// - /// Changes the reader's state to . - /// If is set to true, the underlying is also closed. - /// - public override void Close() - { - base.Close(); - - if (CloseInput) - { -#if HAVE_STREAM_READER_WRITER_CLOSE - _reader?.Close(); -#else - _reader?.Dispose(); -#endif - } - } - - private bool ReadCodeWScope() - { - switch (_bsonReaderState) - { - case BsonReaderState.CodeWScopeStart: - SetToken(JsonToken.PropertyName, "$code"); - _bsonReaderState = BsonReaderState.CodeWScopeCode; - return true; - case BsonReaderState.CodeWScopeCode: - // total CodeWScope size - not used - ReadInt32(); - - SetToken(JsonToken.String, ReadLengthString()); - _bsonReaderState = BsonReaderState.CodeWScopeScope; - return true; - case BsonReaderState.CodeWScopeScope: - if (CurrentState == State.PostValue) - { - SetToken(JsonToken.PropertyName, "$scope"); - return true; - } - else - { - SetToken(JsonToken.StartObject); - _bsonReaderState = BsonReaderState.CodeWScopeScopeObject; - - ContainerContext newContext = new ContainerContext(BsonType.Object); - PushContext(newContext); - newContext.Length = ReadInt32(); - - return true; - } - case BsonReaderState.CodeWScopeScopeObject: - bool result = ReadNormal(); - if (result && TokenType == JsonToken.EndObject) - { - _bsonReaderState = BsonReaderState.CodeWScopeScopeEnd; - } - - return result; - case BsonReaderState.CodeWScopeScopeEnd: - SetToken(JsonToken.EndObject); - _bsonReaderState = BsonReaderState.Normal; - return true; - default: - throw new ArgumentOutOfRangeException(); - } - } - - private bool ReadReference() - { - switch (CurrentState) - { - case State.ObjectStart: - { - SetToken(JsonToken.PropertyName, JsonTypeReflector.RefPropertyName); - _bsonReaderState = BsonReaderState.ReferenceRef; - return true; - } - case State.Property: - { - if (_bsonReaderState == BsonReaderState.ReferenceRef) - { - SetToken(JsonToken.String, ReadLengthString()); - return true; - } - else if (_bsonReaderState == BsonReaderState.ReferenceId) - { - SetToken(JsonToken.Bytes, ReadBytes(12)); - return true; - } - else - { - throw JsonReaderException.Create(this, "Unexpected state when reading BSON reference: " + _bsonReaderState); - } - } - case State.PostValue: - { - if (_bsonReaderState == BsonReaderState.ReferenceRef) - { - SetToken(JsonToken.PropertyName, JsonTypeReflector.IdPropertyName); - _bsonReaderState = BsonReaderState.ReferenceId; - return true; - } - else if (_bsonReaderState == BsonReaderState.ReferenceId) - { - SetToken(JsonToken.EndObject); - _bsonReaderState = BsonReaderState.Normal; - return true; - } - else - { - throw JsonReaderException.Create(this, "Unexpected state when reading BSON reference: " + _bsonReaderState); - } - } - default: - throw JsonReaderException.Create(this, "Unexpected state when reading BSON reference: " + CurrentState); - } - } - - private bool ReadNormal() - { - switch (CurrentState) - { - case State.Start: - { - JsonToken token = (!_readRootValueAsArray) ? JsonToken.StartObject : JsonToken.StartArray; - BsonType type = (!_readRootValueAsArray) ? BsonType.Object : BsonType.Array; - - SetToken(token); - ContainerContext newContext = new ContainerContext(type); - PushContext(newContext); - newContext.Length = ReadInt32(); - return true; - } - case State.Complete: - case State.Closed: - return false; - case State.Property: - { - ReadType(_currentElementType); - return true; - } - case State.ObjectStart: - case State.ArrayStart: - case State.PostValue: - ContainerContext context = _currentContext; - if (context == null) - { - if (SupportMultipleContent) - { - goto case State.Start; - } - - return false; - } - - int lengthMinusEnd = context.Length - 1; - - if (context.Position < lengthMinusEnd) - { - if (context.Type == BsonType.Array) - { - ReadElement(); - ReadType(_currentElementType); - return true; - } - else - { - SetToken(JsonToken.PropertyName, ReadElement()); - return true; - } - } - else if (context.Position == lengthMinusEnd) - { - if (ReadByte() != 0) - { - throw JsonReaderException.Create(this, "Unexpected end of object byte value."); - } - - PopContext(); - if (_currentContext != null) - { - MovePosition(context.Length); - } - - JsonToken endToken = (context.Type == BsonType.Object) ? JsonToken.EndObject : JsonToken.EndArray; - SetToken(endToken); - return true; - } - else - { - throw JsonReaderException.Create(this, "Read past end of current container context."); - } - case State.ConstructorStart: - break; - case State.Constructor: - break; - case State.Error: - break; - case State.Finished: - break; - default: - throw new ArgumentOutOfRangeException(); - } - - return false; - } - - private void PopContext() - { - _stack.RemoveAt(_stack.Count - 1); - if (_stack.Count == 0) - { - _currentContext = null; - } - else - { - _currentContext = _stack[_stack.Count - 1]; - } - } - - private void PushContext(ContainerContext newContext) - { - _stack.Add(newContext); - _currentContext = newContext; - } - - private byte ReadByte() - { - MovePosition(1); - return _reader.ReadByte(); - } - - private void ReadType(BsonType type) - { - switch (type) - { - case BsonType.Number: - double d = ReadDouble(); - - if (_floatParseHandling == FloatParseHandling.Decimal) - { - SetToken(JsonToken.Float, Convert.ToDecimal(d, CultureInfo.InvariantCulture)); - } - else - { - SetToken(JsonToken.Float, d); - } - break; - case BsonType.String: - case BsonType.Symbol: - SetToken(JsonToken.String, ReadLengthString()); - break; - case BsonType.Object: - { - SetToken(JsonToken.StartObject); - - ContainerContext newContext = new ContainerContext(BsonType.Object); - PushContext(newContext); - newContext.Length = ReadInt32(); - break; - } - case BsonType.Array: - { - SetToken(JsonToken.StartArray); - - ContainerContext newContext = new ContainerContext(BsonType.Array); - PushContext(newContext); - newContext.Length = ReadInt32(); - break; - } - case BsonType.Binary: - BsonBinaryType binaryType; - byte[] data = ReadBinary(out binaryType); - - object value = (binaryType != BsonBinaryType.Uuid) - ? data - : (object)new Guid(data); - - SetToken(JsonToken.Bytes, value); - break; - case BsonType.Undefined: - SetToken(JsonToken.Undefined); - break; - case BsonType.Oid: - byte[] oid = ReadBytes(12); - SetToken(JsonToken.Bytes, oid); - break; - case BsonType.Boolean: - bool b = Convert.ToBoolean(ReadByte()); - SetToken(JsonToken.Boolean, b); - break; - case BsonType.Date: - long ticks = ReadInt64(); - DateTime utcDateTime = DateTimeUtils.ConvertJavaScriptTicksToDateTime(ticks); - - DateTime dateTime; - switch (DateTimeKindHandling) - { - case DateTimeKind.Unspecified: - dateTime = DateTime.SpecifyKind(utcDateTime, DateTimeKind.Unspecified); - break; - case DateTimeKind.Local: - dateTime = utcDateTime.ToLocalTime(); - break; - default: - dateTime = utcDateTime; - break; - } - - SetToken(JsonToken.Date, dateTime); - break; - case BsonType.Null: - SetToken(JsonToken.Null); - break; - case BsonType.Regex: - string expression = ReadString(); - string modifiers = ReadString(); - - string regex = @"/" + expression + @"/" + modifiers; - SetToken(JsonToken.String, regex); - break; - case BsonType.Reference: - SetToken(JsonToken.StartObject); - _bsonReaderState = BsonReaderState.ReferenceStart; - break; - case BsonType.Code: - SetToken(JsonToken.String, ReadLengthString()); - break; - case BsonType.CodeWScope: - SetToken(JsonToken.StartObject); - _bsonReaderState = BsonReaderState.CodeWScopeStart; - break; - case BsonType.Integer: - SetToken(JsonToken.Integer, (long)ReadInt32()); - break; - case BsonType.TimeStamp: - case BsonType.Long: - SetToken(JsonToken.Integer, ReadInt64()); - break; - default: - throw new ArgumentOutOfRangeException(nameof(type), "Unexpected BsonType value: " + type); - } - } - - private byte[] ReadBinary(out BsonBinaryType binaryType) - { - int dataLength = ReadInt32(); - - binaryType = (BsonBinaryType)ReadByte(); - -#pragma warning disable 612,618 - // the old binary type has the data length repeated in the data for some reason - if (binaryType == BsonBinaryType.BinaryOld && !_jsonNet35BinaryCompatibility) - { - dataLength = ReadInt32(); - } -#pragma warning restore 612,618 - - return ReadBytes(dataLength); - } - - private string ReadString() - { - EnsureBuffers(); - - StringBuilder builder = null; - - int totalBytesRead = 0; - // used in case of left over multibyte characters in the buffer - int offset = 0; - while (true) - { - int count = offset; - byte b; - while (count < MaxCharBytesSize && (b = _reader.ReadByte()) > 0) - { - _byteBuffer[count++] = b; - } - int byteCount = count - offset; - totalBytesRead += byteCount; - - if (count < MaxCharBytesSize && builder == null) - { - // pref optimization to avoid reading into a string builder - // if string is smaller than the buffer then return it directly - int length = Encoding.UTF8.GetChars(_byteBuffer, 0, byteCount, _charBuffer, 0); - - MovePosition(totalBytesRead + 1); - return new string(_charBuffer, 0, length); - } - else - { - // calculate the index of the end of the last full character in the buffer - int lastFullCharStop = GetLastFullCharStop(count - 1); - - int charCount = Encoding.UTF8.GetChars(_byteBuffer, 0, lastFullCharStop + 1, _charBuffer, 0); - - if (builder == null) - { - builder = new StringBuilder(MaxCharBytesSize * 2); - } - - builder.Append(_charBuffer, 0, charCount); - - if (lastFullCharStop < byteCount - 1) - { - offset = byteCount - lastFullCharStop - 1; - // copy left over multi byte characters to beginning of buffer for next iteration - Array.Copy(_byteBuffer, lastFullCharStop + 1, _byteBuffer, 0, offset); - } - else - { - // reached end of string - if (count < MaxCharBytesSize) - { - MovePosition(totalBytesRead + 1); - return builder.ToString(); - } - - offset = 0; - } - } - } - } - - private string ReadLengthString() - { - int length = ReadInt32(); - - MovePosition(length); - - string s = GetString(length - 1); - _reader.ReadByte(); - - return s; - } - - private string GetString(int length) - { - if (length == 0) - { - return string.Empty; - } - - EnsureBuffers(); - - StringBuilder builder = null; - - int totalBytesRead = 0; - - // used in case of left over multibyte characters in the buffer - int offset = 0; - do - { - int count = ((length - totalBytesRead) > MaxCharBytesSize - offset) - ? MaxCharBytesSize - offset - : length - totalBytesRead; - - int byteCount = _reader.Read(_byteBuffer, offset, count); - - if (byteCount == 0) - { - throw new EndOfStreamException("Unable to read beyond the end of the stream."); - } - - totalBytesRead += byteCount; - - // Above, byteCount is how many bytes we read this time. - // Below, byteCount is how many bytes are in the _byteBuffer. - byteCount += offset; - - if (byteCount == length) - { - // pref optimization to avoid reading into a string builder - // first iteration and all bytes read then return string directly - int charCount = Encoding.UTF8.GetChars(_byteBuffer, 0, byteCount, _charBuffer, 0); - return new string(_charBuffer, 0, charCount); - } - else - { - int lastFullCharStop = GetLastFullCharStop(byteCount - 1); - - if (builder == null) - { - builder = new StringBuilder(length); - } - - int charCount = Encoding.UTF8.GetChars(_byteBuffer, 0, lastFullCharStop + 1, _charBuffer, 0); - builder.Append(_charBuffer, 0, charCount); - - if (lastFullCharStop < byteCount - 1) - { - offset = byteCount - lastFullCharStop - 1; - // copy left over multi byte characters to beginning of buffer for next iteration - Array.Copy(_byteBuffer, lastFullCharStop + 1, _byteBuffer, 0, offset); - } - else - { - offset = 0; - } - } - } while (totalBytesRead < length); - - return builder.ToString(); - } - - private int GetLastFullCharStop(int start) - { - int lookbackPos = start; - int bis = 0; - while (lookbackPos >= 0) - { - bis = BytesInSequence(_byteBuffer[lookbackPos]); - if (bis == 0) - { - lookbackPos--; - continue; - } - else if (bis == 1) - { - break; - } - else - { - lookbackPos--; - break; - } - } - if (bis == start - lookbackPos) - { - //Full character. - return start; - } - else - { - return lookbackPos; - } - } - - private int BytesInSequence(byte b) - { - if (b <= SeqRange1[1]) - { - return 1; - } - if (b >= SeqRange2[0] && b <= SeqRange2[1]) - { - return 2; - } - if (b >= SeqRange3[0] && b <= SeqRange3[1]) - { - return 3; - } - if (b >= SeqRange4[0] && b <= SeqRange4[1]) - { - return 4; - } - return 0; - } - - private void EnsureBuffers() - { - if (_byteBuffer == null) - { - _byteBuffer = new byte[MaxCharBytesSize]; - } - if (_charBuffer == null) - { - int charBufferSize = Encoding.UTF8.GetMaxCharCount(MaxCharBytesSize); - _charBuffer = new char[charBufferSize]; - } - } - - private double ReadDouble() - { - MovePosition(8); - return _reader.ReadDouble(); - } - - private int ReadInt32() - { - MovePosition(4); - return _reader.ReadInt32(); - } - - private long ReadInt64() - { - MovePosition(8); - return _reader.ReadInt64(); - } - - private BsonType ReadType() - { - MovePosition(1); - return (BsonType)_reader.ReadSByte(); - } - - private void MovePosition(int count) - { - _currentContext.Position += count; - } - - private byte[] ReadBytes(int count) - { - MovePosition(count); - return _reader.ReadBytes(count); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Bson/BsonToken.cs b/Source/MyDb/Newtonsoft.Json/Bson/BsonToken.cs deleted file mode 100644 index 202bca6..0000000 --- a/Source/MyDb/Newtonsoft.Json/Bson/BsonToken.cs +++ /dev/null @@ -1,168 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System.Collections; -using System.Collections.Generic; - -#nullable disable - -namespace Newtonsoft.Json.Bson -{ - internal abstract class BsonToken - { - public abstract BsonType Type { get; } - public BsonToken Parent { get; set; } - public int CalculatedSize { get; set; } - } - - internal class BsonObject : BsonToken, IEnumerable - { - private readonly List _children = new List(); - - public void Add(string name, BsonToken token) - { - _children.Add(new BsonProperty { Name = new BsonString(name, false), Value = token }); - token.Parent = this; - } - - public override BsonType Type => BsonType.Object; - - public IEnumerator GetEnumerator() - { - return _children.GetEnumerator(); - } - - IEnumerator IEnumerable.GetEnumerator() - { - return GetEnumerator(); - } - } - - internal class BsonArray : BsonToken, IEnumerable - { - private readonly List _children = new List(); - - public void Add(BsonToken token) - { - _children.Add(token); - token.Parent = this; - } - - public override BsonType Type => BsonType.Array; - - public IEnumerator GetEnumerator() - { - return _children.GetEnumerator(); - } - - IEnumerator IEnumerable.GetEnumerator() - { - return GetEnumerator(); - } - } - - internal class BsonEmpty : BsonToken - { - public static readonly BsonToken Null = new BsonEmpty(BsonType.Null); - public static readonly BsonToken Undefined = new BsonEmpty(BsonType.Undefined); - - private BsonEmpty(BsonType type) - { - Type = type; - } - - public override BsonType Type { get; } - } - - internal class BsonValue : BsonToken - { - private readonly object _value; - private readonly BsonType _type; - - public BsonValue(object value, BsonType type) - { - _value = value; - _type = type; - } - - public object Value => _value; - - public override BsonType Type => _type; - } - - internal class BsonBoolean : BsonValue - { - public static readonly BsonBoolean False = new BsonBoolean(false); - public static readonly BsonBoolean True = new BsonBoolean(true); - - private BsonBoolean(bool value) - : base(value, BsonType.Boolean) - { - } - } - - internal class BsonString : BsonValue - { - public int ByteCount { get; set; } - public bool IncludeLength { get; } - - public BsonString(object value, bool includeLength) - : base(value, BsonType.String) - { - IncludeLength = includeLength; - } - } - - internal class BsonBinary : BsonValue - { - public BsonBinaryType BinaryType { get; set; } - - public BsonBinary(byte[] value, BsonBinaryType binaryType) - : base(value, BsonType.Binary) - { - BinaryType = binaryType; - } - } - - internal class BsonRegex : BsonToken - { - public BsonString Pattern { get; set; } - public BsonString Options { get; set; } - - public BsonRegex(string pattern, string options) - { - Pattern = new BsonString(pattern, false); - Options = new BsonString(options, false); - } - - public override BsonType Type => BsonType.Regex; - } - - internal class BsonProperty - { - public BsonString Name { get; set; } - public BsonToken Value { get; set; } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Bson/BsonType.cs b/Source/MyDb/Newtonsoft.Json/Bson/BsonType.cs deleted file mode 100644 index fefae2c..0000000 --- a/Source/MyDb/Newtonsoft.Json/Bson/BsonType.cs +++ /dev/null @@ -1,53 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#nullable disable - -namespace Newtonsoft.Json.Bson -{ - internal enum BsonType : sbyte - { - Number = 1, - String = 2, - Object = 3, - Array = 4, - Binary = 5, - Undefined = 6, - Oid = 7, - Boolean = 8, - Date = 9, - Null = 10, - Regex = 11, - Reference = 12, - Code = 13, - Symbol = 14, - CodeWScope = 15, - Integer = 16, - TimeStamp = 17, - Long = 18, - MinKey = -1, - MaxKey = 127 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Bson/BsonWriter.cs b/Source/MyDb/Newtonsoft.Json/Bson/BsonWriter.cs deleted file mode 100644 index 47d34fa..0000000 --- a/Source/MyDb/Newtonsoft.Json/Bson/BsonWriter.cs +++ /dev/null @@ -1,539 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using System.IO; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using System.Text; -using Newtonsoft.Json.Utilities; -using Newtonsoft.Json.Linq; -using System.Globalization; - -#nullable disable - -namespace Newtonsoft.Json.Bson -{ - /// - /// Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. - /// - [Obsolete("BSON reading and writing has been moved to its own package. See https://www.nuget.org/packages/Newtonsoft.Json.Bson for more details.")] - public class BsonWriter : JsonWriter - { - private readonly BsonBinaryWriter _writer; - - private BsonToken _root; - private BsonToken _parent; - private string _propertyName; - - /// - /// Gets or sets the used when writing values to BSON. - /// When set to no conversion will occur. - /// - /// The used when writing values to BSON. - public DateTimeKind DateTimeKindHandling - { - get => _writer.DateTimeKindHandling; - set => _writer.DateTimeKindHandling = value; - } - - /// - /// Initializes a new instance of the class. - /// - /// The to write to. - public BsonWriter(Stream stream) - { - ValidationUtils.ArgumentNotNull(stream, nameof(stream)); - _writer = new BsonBinaryWriter(new BinaryWriter(stream)); - } - - /// - /// Initializes a new instance of the class. - /// - /// The to write to. - public BsonWriter(BinaryWriter writer) - { - ValidationUtils.ArgumentNotNull(writer, nameof(writer)); - _writer = new BsonBinaryWriter(writer); - } - - /// - /// Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. - /// - public override void Flush() - { - _writer.Flush(); - } - - /// - /// Writes the end. - /// - /// The token. - protected override void WriteEnd(JsonToken token) - { - base.WriteEnd(token); - RemoveParent(); - - if (Top == 0) - { - _writer.WriteToken(_root); - } - } - - /// - /// Writes a comment /*...*/ containing the specified text. - /// - /// Text to place inside the comment. - public override void WriteComment(string text) - { - throw JsonWriterException.Create(this, "Cannot write JSON comment as BSON.", null); - } - - /// - /// Writes the start of a constructor with the given name. - /// - /// The name of the constructor. - public override void WriteStartConstructor(string name) - { - throw JsonWriterException.Create(this, "Cannot write JSON constructor as BSON.", null); - } - - /// - /// Writes raw JSON. - /// - /// The raw JSON to write. - public override void WriteRaw(string json) - { - throw JsonWriterException.Create(this, "Cannot write raw JSON as BSON.", null); - } - - /// - /// Writes raw JSON where a value is expected and updates the writer's state. - /// - /// The raw JSON to write. - public override void WriteRawValue(string json) - { - throw JsonWriterException.Create(this, "Cannot write raw JSON as BSON.", null); - } - - /// - /// Writes the beginning of a JSON array. - /// - public override void WriteStartArray() - { - base.WriteStartArray(); - - AddParent(new BsonArray()); - } - - /// - /// Writes the beginning of a JSON object. - /// - public override void WriteStartObject() - { - base.WriteStartObject(); - - AddParent(new BsonObject()); - } - - /// - /// Writes the property name of a name/value pair on a JSON object. - /// - /// The name of the property. - public override void WritePropertyName(string name) - { - base.WritePropertyName(name); - - _propertyName = name; - } - - /// - /// Closes this writer. - /// If is set to true, the underlying is also closed. - /// If is set to true, the JSON is auto-completed. - /// - public override void Close() - { - base.Close(); - - if (CloseOutput) - { - _writer?.Close(); - } - } - - private void AddParent(BsonToken container) - { - AddToken(container); - _parent = container; - } - - private void RemoveParent() - { - _parent = _parent.Parent; - } - - private void AddValue(object value, BsonType type) - { - AddToken(new BsonValue(value, type)); - } - - internal void AddToken(BsonToken token) - { - if (_parent != null) - { - if (_parent is BsonObject bo) - { - bo.Add(_propertyName, token); - _propertyName = null; - } - else - { - ((BsonArray)_parent).Add(token); - } - } - else - { - if (token.Type != BsonType.Object && token.Type != BsonType.Array) - { - throw JsonWriterException.Create(this, "Error writing {0} value. BSON must start with an Object or Array.".FormatWith(CultureInfo.InvariantCulture, token.Type), null); - } - - _parent = token; - _root = token; - } - } - - #region WriteValue methods - /// - /// Writes a value. - /// An error will raised if the value cannot be written as a single JSON token. - /// - /// The value to write. - public override void WriteValue(object value) - { -#if HAVE_BIG_INTEGER - if (value is BigInteger i) - { - SetWriteState(JsonToken.Integer, null); - AddToken(new BsonBinary(i.ToByteArray(), BsonBinaryType.Binary)); - } - else -#endif - { - base.WriteValue(value); - } - } - - /// - /// Writes a null value. - /// - public override void WriteNull() - { - base.WriteNull(); - AddToken(BsonEmpty.Null); - } - - /// - /// Writes an undefined value. - /// - public override void WriteUndefined() - { - base.WriteUndefined(); - AddToken(BsonEmpty.Undefined); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(string value) - { - base.WriteValue(value); - AddToken(value == null ? BsonEmpty.Null : new BsonString(value, true)); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(int value) - { - base.WriteValue(value); - AddValue(value, BsonType.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(uint value) - { - if (value > int.MaxValue) - { - throw JsonWriterException.Create(this, "Value is too large to fit in a signed 32 bit integer. BSON does not support unsigned values.", null); - } - - base.WriteValue(value); - AddValue(value, BsonType.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(long value) - { - base.WriteValue(value); - AddValue(value, BsonType.Long); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(ulong value) - { - if (value > long.MaxValue) - { - throw JsonWriterException.Create(this, "Value is too large to fit in a signed 64 bit integer. BSON does not support unsigned values.", null); - } - - base.WriteValue(value); - AddValue(value, BsonType.Long); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(float value) - { - base.WriteValue(value); - AddValue(value, BsonType.Number); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(double value) - { - base.WriteValue(value); - AddValue(value, BsonType.Number); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(bool value) - { - base.WriteValue(value); - AddToken(value ? BsonBoolean.True : BsonBoolean.False); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(short value) - { - base.WriteValue(value); - AddValue(value, BsonType.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(ushort value) - { - base.WriteValue(value); - AddValue(value, BsonType.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(char value) - { - base.WriteValue(value); - string s = null; -#if HAVE_CHAR_TO_STRING_WITH_CULTURE - s = value.ToString(CultureInfo.InvariantCulture); -#else - s = value.ToString(); -#endif - AddToken(new BsonString(s, true)); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(byte value) - { - base.WriteValue(value); - AddValue(value, BsonType.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(sbyte value) - { - base.WriteValue(value); - AddValue(value, BsonType.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(decimal value) - { - base.WriteValue(value); - AddValue(value, BsonType.Number); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(DateTime value) - { - base.WriteValue(value); - value = DateTimeUtils.EnsureDateTime(value, DateTimeZoneHandling); - AddValue(value, BsonType.Date); - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(DateTimeOffset value) - { - base.WriteValue(value); - AddValue(value, BsonType.Date); - } -#endif - - /// - /// Writes a [] value. - /// - /// The [] value to write. - public override void WriteValue(byte[] value) - { - if (value == null) - { - WriteNull(); - return; - } - - base.WriteValue(value); - AddToken(new BsonBinary(value, BsonBinaryType.Binary)); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(Guid value) - { - base.WriteValue(value); - AddToken(new BsonBinary(value.ToByteArray(), BsonBinaryType.Uuid)); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(TimeSpan value) - { - base.WriteValue(value); - AddToken(new BsonString(value.ToString(), true)); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(Uri value) - { - if (value == null) - { - WriteNull(); - return; - } - - base.WriteValue(value); - AddToken(new BsonString(value.ToString(), true)); - } - #endregion - - /// - /// Writes a [] value that represents a BSON object id. - /// - /// The Object ID value to write. - public void WriteObjectId(byte[] value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - - if (value.Length != 12) - { - throw JsonWriterException.Create(this, "An object id must be 12 bytes", null); - } - - // hack to update the writer state - SetWriteState(JsonToken.Undefined, null); - AddValue(value, BsonType.Oid); - } - - /// - /// Writes a BSON regex. - /// - /// The regex pattern. - /// The regex options. - public void WriteRegex(string pattern, string options) - { - ValidationUtils.ArgumentNotNull(pattern, nameof(pattern)); - - // hack to update the writer state - SetWriteState(JsonToken.Undefined, null); - AddToken(new BsonRegex(pattern, options)); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/ConstructorHandling.cs b/Source/MyDb/Newtonsoft.Json/ConstructorHandling.cs deleted file mode 100644 index e710744..0000000 --- a/Source/MyDb/Newtonsoft.Json/ConstructorHandling.cs +++ /dev/null @@ -1,43 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Specifies how constructors are used when initializing objects during deserialization by the . - /// - public enum ConstructorHandling - { - /// - /// First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. - /// - Default = 0, - - /// - /// Json.NET will use a non-public default constructor before falling back to a parameterized constructor. - /// - AllowNonPublicDefaultConstructor = 1 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/BinaryConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/BinaryConverter.cs deleted file mode 100644 index 7390503..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/BinaryConverter.cs +++ /dev/null @@ -1,212 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_LINQ || HAVE_ADO_NET -using System; -using System.Globalization; -using Newtonsoft.Json.Utilities; -using System.Collections.Generic; -using System.Diagnostics; -#if HAVE_ADO_NET -using System.Data.SqlTypes; -#endif - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a binary value to and from a base 64 string value. - /// - public class BinaryConverter : JsonConverter - { -#if HAVE_LINQ - private const string BinaryTypeName = "System.Data.Linq.Binary"; - private const string BinaryToArrayName = "ToArray"; - private static ReflectionObject? _reflectionObject; -#endif - - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - byte[] data = GetByteArray(value); - - writer.WriteValue(data); - } - - private byte[] GetByteArray(object value) - { -#if HAVE_LINQ - if (value.GetType().FullName == BinaryTypeName) - { - EnsureReflectionObject(value.GetType()); - MiscellaneousUtils.Assert(_reflectionObject != null); - - return (byte[])_reflectionObject.GetValue(value, BinaryToArrayName)!; - } -#endif -#if HAVE_ADO_NET - if (value is SqlBinary binary) - { - return binary.Value; - } -#endif - - throw new JsonSerializationException("Unexpected value type when writing binary: {0}".FormatWith(CultureInfo.InvariantCulture, value.GetType())); - } - -#if HAVE_LINQ - private static void EnsureReflectionObject(Type t) - { - if (_reflectionObject == null) - { - _reflectionObject = ReflectionObject.Create(t, t.GetConstructor(new[] { typeof(byte[]) }), BinaryToArrayName); - } - } -#endif - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - if (reader.TokenType == JsonToken.Null) - { - if (!ReflectionUtils.IsNullable(objectType)) - { - throw JsonSerializationException.Create(reader, "Cannot convert null value to {0}.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - - return null; - } - - byte[] data; - - if (reader.TokenType == JsonToken.StartArray) - { - data = ReadByteArray(reader); - } - else if (reader.TokenType == JsonToken.String) - { - // current token is already at base64 string - // unable to call ReadAsBytes so do it the old fashion way - string encodedData = reader.Value!.ToString(); - data = Convert.FromBase64String(encodedData); - } - else - { - throw JsonSerializationException.Create(reader, "Unexpected token parsing binary. Expected String or StartArray, got {0}.".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - Type t = (ReflectionUtils.IsNullableType(objectType)) - ? Nullable.GetUnderlyingType(objectType) - : objectType; - -#if HAVE_LINQ - if (t.FullName == BinaryTypeName) - { - EnsureReflectionObject(t); - MiscellaneousUtils.Assert(_reflectionObject != null); - - return _reflectionObject.Creator!(data); - } -#endif - -#if HAVE_ADO_NET - if (t == typeof(SqlBinary)) - { - return new SqlBinary(data); - } -#endif - - throw JsonSerializationException.Create(reader, "Unexpected object type when writing binary: {0}".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - - private byte[] ReadByteArray(JsonReader reader) - { - List byteList = new List(); - - while (reader.Read()) - { - switch (reader.TokenType) - { - case JsonToken.Integer: - byteList.Add(Convert.ToByte(reader.Value, CultureInfo.InvariantCulture)); - break; - case JsonToken.EndArray: - return byteList.ToArray(); - case JsonToken.Comment: - // skip - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected token when reading bytes: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - } - - throw JsonSerializationException.Create(reader, "Unexpected end when reading bytes."); - } - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { -#if HAVE_LINQ - if (objectType.FullName == BinaryTypeName) - { - return true; - } -#endif -#if HAVE_ADO_NET - if (objectType == typeof(SqlBinary) || objectType == typeof(SqlBinary?)) - { - return true; - } -#endif - - return false; - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/BsonObjectIdConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/BsonObjectIdConverter.cs deleted file mode 100644 index 5f918de..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/BsonObjectIdConverter.cs +++ /dev/null @@ -1,93 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Bson; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -#nullable disable - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a to and from JSON and BSON. - /// - [Obsolete("BSON reading and writing has been moved to its own package. See https://www.nuget.org/packages/Newtonsoft.Json.Bson for more details.")] - public class BsonObjectIdConverter : JsonConverter - { - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer) - { - BsonObjectId objectId = (BsonObjectId)value; - - if (writer is BsonWriter bsonWriter) - { - bsonWriter.WriteObjectId(objectId.Value); - } - else - { - writer.WriteValue(objectId.Value); - } - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer) - { - if (reader.TokenType != JsonToken.Bytes) - { - throw new JsonSerializationException("Expected Bytes but got {0}.".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - byte[] value = (byte[])reader.Value; - - return new BsonObjectId(value); - } - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - return (objectType == typeof(BsonObjectId)); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/CustomCreationConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/CustomCreationConverter.cs deleted file mode 100644 index f693ce5..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/CustomCreationConverter.cs +++ /dev/null @@ -1,101 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Reflection; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Creates a custom object. - /// - /// The object type to convert. - public abstract class CustomCreationConverter : JsonConverter - { - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - throw new NotSupportedException("CustomCreationConverter should only be used while deserializing."); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - if (reader.TokenType == JsonToken.Null) - { - return null; - } - - T value = Create(objectType); - if (value == null) - { - throw new JsonSerializationException("No object created."); - } - - serializer.Populate(reader, value); - return value; - } - - /// - /// Creates an object which will then be populated by the serializer. - /// - /// Type of the object. - /// The created object. - public abstract T Create(Type objectType); - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - return typeof(T).IsAssignableFrom(objectType); - } - - /// - /// Gets a value indicating whether this can write JSON. - /// - /// - /// true if this can write JSON; otherwise, false. - /// - public override bool CanWrite => false; - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/DataSetConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/DataSetConverter.cs deleted file mode 100644 index 61bb625..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/DataSetConverter.cs +++ /dev/null @@ -1,125 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ADO_NET -using System; -using System.Data; -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a to and from JSON. - /// - public class DataSetConverter : JsonConverter - { - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - DataSet dataSet = (DataSet)value; - DefaultContractResolver? resolver = serializer.ContractResolver as DefaultContractResolver; - - DataTableConverter converter = new DataTableConverter(); - - writer.WriteStartObject(); - - foreach (DataTable table in dataSet.Tables) - { - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(table.TableName) : table.TableName); - - converter.WriteJson(writer, table, serializer); - } - - writer.WriteEndObject(); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - if (reader.TokenType == JsonToken.Null) - { - return null; - } - - // handle typed datasets - DataSet ds = (objectType == typeof(DataSet)) - ? new DataSet() - : (DataSet)Activator.CreateInstance(objectType); - - DataTableConverter converter = new DataTableConverter(); - - reader.ReadAndAssert(); - - while (reader.TokenType == JsonToken.PropertyName) - { - DataTable dt = ds.Tables[(string)reader.Value!]; - bool exists = (dt != null); - - dt = (DataTable)converter.ReadJson(reader, typeof(DataTable), dt, serializer)!; - - if (!exists) - { - ds.Tables.Add(dt); - } - - reader.ReadAndAssert(); - } - - return ds; - } - - /// - /// Determines whether this instance can convert the specified value type. - /// - /// Type of the value. - /// - /// true if this instance can convert the specified value type; otherwise, false. - /// - public override bool CanConvert(Type valueType) - { - return typeof(DataSet).IsAssignableFrom(valueType); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/DataTableConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/DataTableConverter.cs deleted file mode 100644 index 7f8c529..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/DataTableConverter.cs +++ /dev/null @@ -1,254 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ADO_NET -using System.Collections; -using System.Collections.Generic; -using System.Globalization; -using Newtonsoft.Json.Utilities; -using System; -using System.Data; -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a to and from JSON. - /// - public class DataTableConverter : JsonConverter - { - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - DataTable table = (DataTable)value; - DefaultContractResolver? resolver = serializer.ContractResolver as DefaultContractResolver; - - writer.WriteStartArray(); - - foreach (DataRow row in table.Rows) - { - writer.WriteStartObject(); - foreach (DataColumn column in row.Table.Columns) - { - object columnValue = row[column]; - - if (serializer.NullValueHandling == NullValueHandling.Ignore && (columnValue == null || columnValue == DBNull.Value)) - { - continue; - } - - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(column.ColumnName) : column.ColumnName); - serializer.Serialize(writer, columnValue); - } - writer.WriteEndObject(); - } - - writer.WriteEndArray(); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - if (reader.TokenType == JsonToken.Null) - { - return null; - } - - if (!(existingValue is DataTable dt)) - { - // handle typed datasets - dt = (objectType == typeof(DataTable)) - ? new DataTable() - : (DataTable)Activator.CreateInstance(objectType); - } - - // DataTable is inside a DataSet - // populate the name from the property name - if (reader.TokenType == JsonToken.PropertyName) - { - dt.TableName = (string)reader.Value!; - - reader.ReadAndAssert(); - - if (reader.TokenType == JsonToken.Null) - { - return dt; - } - } - - if (reader.TokenType != JsonToken.StartArray) - { - throw JsonSerializationException.Create(reader, "Unexpected JSON token when reading DataTable. Expected StartArray, got {0}.".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - reader.ReadAndAssert(); - - while (reader.TokenType != JsonToken.EndArray) - { - CreateRow(reader, dt, serializer); - - reader.ReadAndAssert(); - } - - return dt; - } - - private static void CreateRow(JsonReader reader, DataTable dt, JsonSerializer serializer) - { - DataRow dr = dt.NewRow(); - reader.ReadAndAssert(); - - while (reader.TokenType == JsonToken.PropertyName) - { - string columnName = (string)reader.Value!; - - reader.ReadAndAssert(); - - DataColumn column = dt.Columns[columnName]; - if (column == null) - { - Type columnType = GetColumnDataType(reader); - column = new DataColumn(columnName, columnType); - dt.Columns.Add(column); - } - - if (column.DataType == typeof(DataTable)) - { - if (reader.TokenType == JsonToken.StartArray) - { - reader.ReadAndAssert(); - } - - DataTable nestedDt = new DataTable(); - - while (reader.TokenType != JsonToken.EndArray) - { - CreateRow(reader, nestedDt, serializer); - - reader.ReadAndAssert(); - } - - dr[columnName] = nestedDt; - } - else if (column.DataType.IsArray && column.DataType != typeof(byte[])) - { - if (reader.TokenType == JsonToken.StartArray) - { - reader.ReadAndAssert(); - } - - List o = new List(); - - while (reader.TokenType != JsonToken.EndArray) - { - o.Add(reader.Value); - reader.ReadAndAssert(); - } - - Array destinationArray = Array.CreateInstance(column.DataType.GetElementType(), o.Count); - ((IList)o).CopyTo(destinationArray, 0); - - dr[columnName] = destinationArray; - } - else - { - object columnValue = (reader.Value != null) - ? serializer.Deserialize(reader, column.DataType) ?? DBNull.Value - : DBNull.Value; - - dr[columnName] = columnValue; - } - - reader.ReadAndAssert(); - } - - dr.EndEdit(); - dt.Rows.Add(dr); - } - - private static Type GetColumnDataType(JsonReader reader) - { - JsonToken tokenType = reader.TokenType; - - switch (tokenType) - { - case JsonToken.Integer: - case JsonToken.Boolean: - case JsonToken.Float: - case JsonToken.String: - case JsonToken.Date: - case JsonToken.Bytes: - return reader.ValueType!; - case JsonToken.Null: - case JsonToken.Undefined: - case JsonToken.EndArray: - return typeof(string); - case JsonToken.StartArray: - reader.ReadAndAssert(); - if (reader.TokenType == JsonToken.StartObject) - { - return typeof(DataTable); // nested datatable - } - - Type arrayType = GetColumnDataType(reader); - return arrayType.MakeArrayType(); - default: - throw JsonSerializationException.Create(reader, "Unexpected JSON token when reading DataTable: {0}".FormatWith(CultureInfo.InvariantCulture, tokenType)); - } - } - - /// - /// Determines whether this instance can convert the specified value type. - /// - /// Type of the value. - /// - /// true if this instance can convert the specified value type; otherwise, false. - /// - public override bool CanConvert(Type valueType) - { - return typeof(DataTable).IsAssignableFrom(valueType); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/DateTimeConverterBase.cs b/Source/MyDb/Newtonsoft.Json/Converters/DateTimeConverterBase.cs deleted file mode 100644 index 076d639..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/DateTimeConverterBase.cs +++ /dev/null @@ -1,58 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Provides a base class for converting a to and from JSON. - /// - public abstract class DateTimeConverterBase : JsonConverter - { - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - if (objectType == typeof(DateTime) || objectType == typeof(DateTime?)) - { - return true; - } -#if HAVE_DATE_TIME_OFFSET - if (objectType == typeof(DateTimeOffset) || objectType == typeof(DateTimeOffset?)) - { - return true; - } -#endif - - return false; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/DiscriminatedUnionConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/DiscriminatedUnionConverter.cs deleted file mode 100644 index 5adb40b..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/DiscriminatedUnionConverter.cs +++ /dev/null @@ -1,298 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_FSHARP_TYPES -using Newtonsoft.Json.Linq; -using System; -using System.Collections; -using System.Collections.Generic; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using System.Reflection; -using Newtonsoft.Json.Serialization; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a F# discriminated union type to and from JSON. - /// - public class DiscriminatedUnionConverter : JsonConverter - { - #region UnionDefinition - internal class Union - { - public readonly FSharpFunction TagReader; - public readonly List Cases; - - public Union(FSharpFunction tagReader, List cases) - { - TagReader = tagReader; - Cases = cases; - } - } - - internal class UnionCase - { - public readonly int Tag; - public readonly string Name; - public readonly PropertyInfo[] Fields; - public readonly FSharpFunction FieldReader; - public readonly FSharpFunction Constructor; - - public UnionCase(int tag, string name, PropertyInfo[] fields, FSharpFunction fieldReader, FSharpFunction constructor) - { - Tag = tag; - Name = name; - Fields = fields; - FieldReader = fieldReader; - Constructor = constructor; - } - } - #endregion - - private const string CasePropertyName = "Case"; - private const string FieldsPropertyName = "Fields"; - - private static readonly ThreadSafeStore UnionCache = new ThreadSafeStore(CreateUnion); - private static readonly ThreadSafeStore UnionTypeLookupCache = new ThreadSafeStore(CreateUnionTypeLookup); - - private static Type CreateUnionTypeLookup(Type t) - { - // this lookup is because cases with fields are derived from union type - // need to get declaring type to avoid duplicate Unions in cache - - // hacky but I can't find an API to get the declaring type without GetUnionCases - object[] cases = (object[])FSharpUtils.Instance.GetUnionCases(null, t, null)!; - - object caseInfo = cases.First(); - - Type unionType = (Type)FSharpUtils.Instance.GetUnionCaseInfoDeclaringType(caseInfo)!; - return unionType; - } - - private static Union CreateUnion(Type t) - { - Union u = new Union((FSharpFunction)FSharpUtils.Instance.PreComputeUnionTagReader(null, t, null), new List()); - - object[] cases = (object[])FSharpUtils.Instance.GetUnionCases(null, t, null)!; - - foreach (object unionCaseInfo in cases) - { - UnionCase unionCase = new UnionCase( - (int)FSharpUtils.Instance.GetUnionCaseInfoTag(unionCaseInfo), - (string)FSharpUtils.Instance.GetUnionCaseInfoName(unionCaseInfo), - (PropertyInfo[])FSharpUtils.Instance.GetUnionCaseInfoFields(unionCaseInfo)!, - (FSharpFunction)FSharpUtils.Instance.PreComputeUnionReader(null, unionCaseInfo, null), - (FSharpFunction)FSharpUtils.Instance.PreComputeUnionConstructor(null, unionCaseInfo, null)); - - u.Cases.Add(unionCase); - } - - return u; - } - - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - DefaultContractResolver? resolver = serializer.ContractResolver as DefaultContractResolver; - - Type unionType = UnionTypeLookupCache.Get(value.GetType()); - Union union = UnionCache.Get(unionType); - - int tag = (int)union.TagReader.Invoke(value); - UnionCase caseInfo = union.Cases.Single(c => c.Tag == tag); - - writer.WriteStartObject(); - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(CasePropertyName) : CasePropertyName); - writer.WriteValue(caseInfo.Name); - if (caseInfo.Fields != null && caseInfo.Fields.Length > 0) - { - object[] fields = (object[])caseInfo.FieldReader.Invoke(value)!; - - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(FieldsPropertyName) : FieldsPropertyName); - writer.WriteStartArray(); - foreach (object field in fields) - { - serializer.Serialize(writer, field); - } - writer.WriteEndArray(); - } - writer.WriteEndObject(); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - if (reader.TokenType == JsonToken.Null) - { - return null; - } - - UnionCase? caseInfo = null; - string? caseName = null; - JArray? fields = null; - - // start object - reader.ReadAndAssert(); - - while (reader.TokenType == JsonToken.PropertyName) - { - string propertyName = reader.Value!.ToString(); - if (string.Equals(propertyName, CasePropertyName, StringComparison.OrdinalIgnoreCase)) - { - reader.ReadAndAssert(); - - Union union = UnionCache.Get(objectType); - - caseName = reader.Value!.ToString(); - - caseInfo = union.Cases.SingleOrDefault(c => c.Name == caseName); - - if (caseInfo == null) - { - throw JsonSerializationException.Create(reader, "No union type found with the name '{0}'.".FormatWith(CultureInfo.InvariantCulture, caseName)); - } - } - else if (string.Equals(propertyName, FieldsPropertyName, StringComparison.OrdinalIgnoreCase)) - { - reader.ReadAndAssert(); - if (reader.TokenType != JsonToken.StartArray) - { - throw JsonSerializationException.Create(reader, "Union fields must been an array."); - } - - fields = (JArray)JToken.ReadFrom(reader); - } - else - { - throw JsonSerializationException.Create(reader, "Unexpected property '{0}' found when reading union.".FormatWith(CultureInfo.InvariantCulture, propertyName)); - } - - reader.ReadAndAssert(); - } - - if (caseInfo == null) - { - throw JsonSerializationException.Create(reader, "No '{0}' property with union name found.".FormatWith(CultureInfo.InvariantCulture, CasePropertyName)); - } - - object?[] typedFieldValues = new object?[caseInfo.Fields.Length]; - - if (caseInfo.Fields.Length > 0 && fields == null) - { - throw JsonSerializationException.Create(reader, "No '{0}' property with union fields found.".FormatWith(CultureInfo.InvariantCulture, FieldsPropertyName)); - } - - if (fields != null) - { - if (caseInfo.Fields.Length != fields.Count) - { - throw JsonSerializationException.Create(reader, "The number of field values does not match the number of properties defined by union '{0}'.".FormatWith(CultureInfo.InvariantCulture, caseName)); - } - - for (int i = 0; i < fields.Count; i++) - { - JToken t = fields[i]; - PropertyInfo fieldProperty = caseInfo.Fields[i]; - - typedFieldValues[i] = t.ToObject(fieldProperty.PropertyType, serializer); - } - } - - object[] args = { typedFieldValues }; - - return caseInfo.Constructor.Invoke(args); - } - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - if (typeof(IEnumerable).IsAssignableFrom(objectType)) - { - return false; - } - - // all fsharp objects have CompilationMappingAttribute - // get the fsharp assembly from the attribute and initialize latebound methods - object[] attributes; -#if HAVE_FULL_REFLECTION - attributes = objectType.GetCustomAttributes(true); -#else - attributes = objectType.GetTypeInfo().GetCustomAttributes(true).ToArray(); -#endif - - bool isFSharpType = false; - foreach (object attribute in attributes) - { - Type attributeType = attribute.GetType(); - if (attributeType.FullName == "Microsoft.FSharp.Core.CompilationMappingAttribute") - { - FSharpUtils.EnsureInitialized(attributeType.Assembly()); - - isFSharpType = true; - break; - } - } - - if (!isFSharpType) - { - return false; - } - - return (bool)FSharpUtils.Instance.IsUnion(null, objectType, null); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/EntityKeyMemberConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/EntityKeyMemberConverter.cs deleted file mode 100644 index 4670dba..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/EntityKeyMemberConverter.cs +++ /dev/null @@ -1,165 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ENTITY_FRAMEWORK -using System; -using Newtonsoft.Json.Serialization; -using System.Globalization; -using Newtonsoft.Json.Utilities; -using System.Diagnostics; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts an Entity Framework to and from JSON. - /// - public class EntityKeyMemberConverter : JsonConverter - { - private const string EntityKeyMemberFullTypeName = "System.Data.EntityKeyMember"; - - private const string KeyPropertyName = "Key"; - private const string TypePropertyName = "Type"; - private const string ValuePropertyName = "Value"; - - private static ReflectionObject? _reflectionObject; - - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - EnsureReflectionObject(value.GetType()); - MiscellaneousUtils.Assert(_reflectionObject != null); - - DefaultContractResolver? resolver = serializer.ContractResolver as DefaultContractResolver; - - string keyName = (string)_reflectionObject.GetValue(value, KeyPropertyName)!; - object? keyValue = _reflectionObject.GetValue(value, ValuePropertyName); - - Type? keyValueType = keyValue?.GetType(); - - writer.WriteStartObject(); - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(KeyPropertyName) : KeyPropertyName); - writer.WriteValue(keyName); - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(TypePropertyName) : TypePropertyName); - writer.WriteValue(keyValueType?.FullName); - - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(ValuePropertyName) : ValuePropertyName); - - if (keyValueType != null) - { - if (JsonSerializerInternalWriter.TryConvertToString(keyValue!, keyValueType, out string? valueJson)) - { - writer.WriteValue(valueJson); - } - else - { - writer.WriteValue(keyValue); - } - } - else - { - writer.WriteNull(); - } - - writer.WriteEndObject(); - } - - private static void ReadAndAssertProperty(JsonReader reader, string propertyName) - { - reader.ReadAndAssert(); - - if (reader.TokenType != JsonToken.PropertyName || !string.Equals(reader.Value?.ToString(), propertyName, StringComparison.OrdinalIgnoreCase)) - { - throw new JsonSerializationException("Expected JSON property '{0}'.".FormatWith(CultureInfo.InvariantCulture, propertyName)); - } - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - EnsureReflectionObject(objectType); - MiscellaneousUtils.Assert(_reflectionObject != null); - - object entityKeyMember = _reflectionObject.Creator!(); - - ReadAndAssertProperty(reader, KeyPropertyName); - reader.ReadAndAssert(); - _reflectionObject.SetValue(entityKeyMember, KeyPropertyName, reader.Value?.ToString()); - - ReadAndAssertProperty(reader, TypePropertyName); - reader.ReadAndAssert(); - string? type = reader.Value?.ToString(); - - Type t = Type.GetType(type); - - ReadAndAssertProperty(reader, ValuePropertyName); - reader.ReadAndAssert(); - _reflectionObject.SetValue(entityKeyMember, ValuePropertyName, serializer.Deserialize(reader, t)); - - reader.ReadAndAssert(); - - return entityKeyMember; - } - - private static void EnsureReflectionObject(Type objectType) - { - if (_reflectionObject == null) - { - _reflectionObject = ReflectionObject.Create(objectType, KeyPropertyName, ValuePropertyName); - } - } - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - return objectType.AssignableToTypeName(EntityKeyMemberFullTypeName, false); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/ExpandoObjectConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/ExpandoObjectConverter.cs deleted file mode 100644 index 0b5153f..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/ExpandoObjectConverter.cs +++ /dev/null @@ -1,165 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_DYNAMIC - -using System; -using System.Collections.Generic; -using System.Dynamic; -using System.Globalization; -using System.Linq; -using System.Text; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts an to and from JSON. - /// - public class ExpandoObjectConverter : JsonConverter - { - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - // can write is set to false - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - return ReadValue(reader); - } - - private object? ReadValue(JsonReader reader) - { - if (!reader.MoveToContent()) - { - throw JsonSerializationException.Create(reader, "Unexpected end when reading ExpandoObject."); - } - - switch (reader.TokenType) - { - case JsonToken.StartObject: - return ReadObject(reader); - case JsonToken.StartArray: - return ReadList(reader); - default: - if (JsonTokenUtils.IsPrimitiveToken(reader.TokenType)) - { - return reader.Value; - } - - throw JsonSerializationException.Create(reader, "Unexpected token when converting ExpandoObject: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - } - - private object ReadList(JsonReader reader) - { - IList list = new List(); - - while (reader.Read()) - { - switch (reader.TokenType) - { - case JsonToken.Comment: - break; - default: - object? v = ReadValue(reader); - - list.Add(v); - break; - case JsonToken.EndArray: - return list; - } - } - - throw JsonSerializationException.Create(reader, "Unexpected end when reading ExpandoObject."); - } - - private object ReadObject(JsonReader reader) - { - IDictionary expandoObject = new ExpandoObject(); - - while (reader.Read()) - { - switch (reader.TokenType) - { - case JsonToken.PropertyName: - string propertyName = reader.Value!.ToString(); - - if (!reader.Read()) - { - throw JsonSerializationException.Create(reader, "Unexpected end when reading ExpandoObject."); - } - - object? v = ReadValue(reader); - - expandoObject[propertyName] = v; - break; - case JsonToken.Comment: - break; - case JsonToken.EndObject: - return expandoObject; - } - } - - throw JsonSerializationException.Create(reader, "Unexpected end when reading ExpandoObject."); - } - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - return (objectType == typeof(ExpandoObject)); - } - - /// - /// Gets a value indicating whether this can write JSON. - /// - /// - /// true if this can write JSON; otherwise, false. - /// - public override bool CanWrite => false; - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/IsoDateTimeConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/IsoDateTimeConverter.cs deleted file mode 100644 index d9c8ee2..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/IsoDateTimeConverter.cs +++ /dev/null @@ -1,194 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). - /// - public class IsoDateTimeConverter : DateTimeConverterBase - { - private const string DefaultDateTimeFormat = "yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK"; - - private DateTimeStyles _dateTimeStyles = DateTimeStyles.RoundtripKind; - private string? _dateTimeFormat; - private CultureInfo? _culture; - - /// - /// Gets or sets the date time styles used when converting a date to and from JSON. - /// - /// The date time styles used when converting a date to and from JSON. - public DateTimeStyles DateTimeStyles - { - get => _dateTimeStyles; - set => _dateTimeStyles = value; - } - - /// - /// Gets or sets the date time format used when converting a date to and from JSON. - /// - /// The date time format used when converting a date to and from JSON. - public string? DateTimeFormat - { - get => _dateTimeFormat ?? string.Empty; - set => _dateTimeFormat = (StringUtils.IsNullOrEmpty(value)) ? null : value; - } - - /// - /// Gets or sets the culture used when converting a date to and from JSON. - /// - /// The culture used when converting a date to and from JSON. - public CultureInfo Culture - { - get => _culture ?? CultureInfo.CurrentCulture; - set => _culture = value; - } - - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - string text; - - if (value is DateTime dateTime) - { - if ((_dateTimeStyles & DateTimeStyles.AdjustToUniversal) == DateTimeStyles.AdjustToUniversal - || (_dateTimeStyles & DateTimeStyles.AssumeUniversal) == DateTimeStyles.AssumeUniversal) - { - dateTime = dateTime.ToUniversalTime(); - } - - text = dateTime.ToString(_dateTimeFormat ?? DefaultDateTimeFormat, Culture); - } -#if HAVE_DATE_TIME_OFFSET - else if (value is DateTimeOffset dateTimeOffset) - { - if ((_dateTimeStyles & DateTimeStyles.AdjustToUniversal) == DateTimeStyles.AdjustToUniversal - || (_dateTimeStyles & DateTimeStyles.AssumeUniversal) == DateTimeStyles.AssumeUniversal) - { - dateTimeOffset = dateTimeOffset.ToUniversalTime(); - } - - text = dateTimeOffset.ToString(_dateTimeFormat ?? DefaultDateTimeFormat, Culture); - } -#endif - else - { - throw new JsonSerializationException("Unexpected value when converting date. Expected DateTime or DateTimeOffset, got {0}.".FormatWith(CultureInfo.InvariantCulture, ReflectionUtils.GetObjectType(value)!)); - } - - writer.WriteValue(text); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - bool nullable = ReflectionUtils.IsNullableType(objectType); - if (reader.TokenType == JsonToken.Null) - { - if (!nullable) - { - throw JsonSerializationException.Create(reader, "Cannot convert null value to {0}.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - - return null; - } - -#if HAVE_DATE_TIME_OFFSET - Type t = (nullable) - ? Nullable.GetUnderlyingType(objectType) - : objectType; -#endif - - if (reader.TokenType == JsonToken.Date) - { -#if HAVE_DATE_TIME_OFFSET - if (t == typeof(DateTimeOffset)) - { - return (reader.Value is DateTimeOffset) ? reader.Value : new DateTimeOffset((DateTime)reader.Value!); - } - - // converter is expected to return a DateTime - if (reader.Value is DateTimeOffset offset) - { - return offset.DateTime; - } -#endif - - return reader.Value; - } - - if (reader.TokenType != JsonToken.String) - { - throw JsonSerializationException.Create(reader, "Unexpected token parsing date. Expected String, got {0}.".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - string? dateText = reader.Value?.ToString(); - - if (StringUtils.IsNullOrEmpty(dateText) && nullable) - { - return null; - } - -#if HAVE_DATE_TIME_OFFSET - if (t == typeof(DateTimeOffset)) - { - if (!StringUtils.IsNullOrEmpty(_dateTimeFormat)) - { - return DateTimeOffset.ParseExact(dateText, _dateTimeFormat, Culture, _dateTimeStyles); - } - else - { - return DateTimeOffset.Parse(dateText, Culture, _dateTimeStyles); - } - } -#endif - - if (!StringUtils.IsNullOrEmpty(_dateTimeFormat)) - { - return DateTime.ParseExact(dateText, _dateTimeFormat, Culture, _dateTimeStyles); - } - else - { - return DateTime.Parse(dateText, Culture, _dateTimeStyles); - } - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Converters/JavaScriptDateTimeConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/JavaScriptDateTimeConverter.cs deleted file mode 100644 index 3408245..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/JavaScriptDateTimeConverter.cs +++ /dev/null @@ -1,111 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). - /// - public class JavaScriptDateTimeConverter : DateTimeConverterBase - { - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - long ticks; - - if (value is DateTime dateTime) - { - DateTime utcDateTime = dateTime.ToUniversalTime(); - ticks = DateTimeUtils.ConvertDateTimeToJavaScriptTicks(utcDateTime); - } -#if HAVE_DATE_TIME_OFFSET - else if (value is DateTimeOffset dateTimeOffset) - { - DateTimeOffset utcDateTimeOffset = dateTimeOffset.ToUniversalTime(); - ticks = DateTimeUtils.ConvertDateTimeToJavaScriptTicks(utcDateTimeOffset.UtcDateTime); - } -#endif - else - { - throw new JsonSerializationException("Expected date object value."); - } - - writer.WriteStartConstructor("Date"); - writer.WriteValue(ticks); - writer.WriteEndConstructor(); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing property value of the JSON that is being converted. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - if (reader.TokenType == JsonToken.Null) - { - if (!ReflectionUtils.IsNullable(objectType)) - { - throw JsonSerializationException.Create(reader, "Cannot convert null value to {0}.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - - return null; - } - - if (reader.TokenType != JsonToken.StartConstructor || !string.Equals(reader.Value?.ToString(), "Date", StringComparison.Ordinal)) - { - throw JsonSerializationException.Create(reader, "Unexpected token or value when parsing date. Token: {0}, Value: {1}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType, reader.Value)); - } - - if (!JavaScriptUtils.TryGetDateFromConstructorJson(reader, out DateTime d, out string? errorMessage)) - { - throw JsonSerializationException.Create(reader, errorMessage); - } - -#if HAVE_DATE_TIME_OFFSET - Type t = (ReflectionUtils.IsNullableType(objectType)) - ? Nullable.GetUnderlyingType(objectType) - : objectType; - if (t == typeof(DateTimeOffset)) - { - return new DateTimeOffset(d); - } -#endif - return d; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/KeyValuePairConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/KeyValuePairConverter.cs deleted file mode 100644 index 0f12f1f..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/KeyValuePairConverter.cs +++ /dev/null @@ -1,159 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using Newtonsoft.Json.Serialization; -using Newtonsoft.Json.Utilities; -using System.Reflection; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a to and from JSON. - /// - public class KeyValuePairConverter : JsonConverter - { - private const string KeyName = "Key"; - private const string ValueName = "Value"; - - private static readonly ThreadSafeStore ReflectionObjectPerType = new ThreadSafeStore(InitializeReflectionObject); - - private static ReflectionObject InitializeReflectionObject(Type t) - { - IList genericArguments = t.GetGenericArguments(); - Type keyType = genericArguments[0]; - Type valueType = genericArguments[1]; - - return ReflectionObject.Create(t, t.GetConstructor(new[] { keyType, valueType }), KeyName, ValueName); - } - - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - ReflectionObject reflectionObject = ReflectionObjectPerType.Get(value.GetType()); - - DefaultContractResolver? resolver = serializer.ContractResolver as DefaultContractResolver; - - writer.WriteStartObject(); - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(KeyName) : KeyName); - serializer.Serialize(writer, reflectionObject.GetValue(value, KeyName), reflectionObject.GetType(KeyName)); - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(ValueName) : ValueName); - serializer.Serialize(writer, reflectionObject.GetValue(value, ValueName), reflectionObject.GetType(ValueName)); - writer.WriteEndObject(); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - if (reader.TokenType == JsonToken.Null) - { - if (!ReflectionUtils.IsNullableType(objectType)) - { - throw JsonSerializationException.Create(reader, "Cannot convert null value to KeyValuePair."); - } - - return null; - } - - object? key = null; - object? value = null; - - reader.ReadAndAssert(); - - Type t = ReflectionUtils.IsNullableType(objectType) - ? Nullable.GetUnderlyingType(objectType) - : objectType; - - ReflectionObject reflectionObject = ReflectionObjectPerType.Get(t); - JsonContract keyContract = serializer.ContractResolver.ResolveContract(reflectionObject.GetType(KeyName)); - JsonContract valueContract = serializer.ContractResolver.ResolveContract(reflectionObject.GetType(ValueName)); - - while (reader.TokenType == JsonToken.PropertyName) - { - string propertyName = reader.Value!.ToString(); - if (string.Equals(propertyName, KeyName, StringComparison.OrdinalIgnoreCase)) - { - reader.ReadForTypeAndAssert(keyContract, false); - - key = serializer.Deserialize(reader, keyContract.UnderlyingType); - } - else if (string.Equals(propertyName, ValueName, StringComparison.OrdinalIgnoreCase)) - { - reader.ReadForTypeAndAssert(valueContract, false); - - value = serializer.Deserialize(reader, valueContract.UnderlyingType); - } - else - { - reader.Skip(); - } - - reader.ReadAndAssert(); - } - - return reflectionObject.Creator!(key, value); - } - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - Type t = (ReflectionUtils.IsNullableType(objectType)) - ? Nullable.GetUnderlyingType(objectType) - : objectType; - - if (t.IsValueType() && t.IsGenericType()) - { - return (t.GetGenericTypeDefinition() == typeof(KeyValuePair<,>)); - } - - return false; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/RegexConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/RegexConverter.cs deleted file mode 100644 index 8bf6e9f..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/RegexConverter.cs +++ /dev/null @@ -1,235 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Text.RegularExpressions; -using Newtonsoft.Json.Bson; -using System.Globalization; -using System.Runtime.CompilerServices; -using Newtonsoft.Json.Serialization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a to and from JSON and BSON. - /// - public class RegexConverter : JsonConverter - { - private const string PatternName = "Pattern"; - private const string OptionsName = "Options"; - - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - Regex regex = (Regex)value; - -#pragma warning disable 618 - if (writer is BsonWriter bsonWriter) - { - WriteBson(bsonWriter, regex); - } -#pragma warning restore 618 - else - { - WriteJson(writer, regex, serializer); - } - } - - private bool HasFlag(RegexOptions options, RegexOptions flag) - { - return ((options & flag) == flag); - } - -#pragma warning disable 618 - private void WriteBson(BsonWriter writer, Regex regex) - { - // Regular expression - The first cstring is the regex pattern, the second - // is the regex options string. Options are identified by characters, which - // must be stored in alphabetical order. Valid options are 'i' for case - // insensitive matching, 'm' for multiline matching, 'x' for verbose mode, - // 'l' to make \w, \W, etc. locale dependent, 's' for dotall mode - // ('.' matches everything), and 'u' to make \w, \W, etc. match unicode. - - string? options = null; - - if (HasFlag(regex.Options, RegexOptions.IgnoreCase)) - { - options += "i"; - } - - if (HasFlag(regex.Options, RegexOptions.Multiline)) - { - options += "m"; - } - - if (HasFlag(regex.Options, RegexOptions.Singleline)) - { - options += "s"; - } - - options += "u"; - - if (HasFlag(regex.Options, RegexOptions.ExplicitCapture)) - { - options += "x"; - } - - writer.WriteRegex(regex.ToString(), options); - } -#pragma warning restore 618 - - private void WriteJson(JsonWriter writer, Regex regex, JsonSerializer serializer) - { - DefaultContractResolver? resolver = serializer.ContractResolver as DefaultContractResolver; - - writer.WriteStartObject(); - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(PatternName) : PatternName); - writer.WriteValue(regex.ToString()); - writer.WritePropertyName((resolver != null) ? resolver.GetResolvedPropertyName(OptionsName) : OptionsName); - serializer.Serialize(writer, regex.Options); - writer.WriteEndObject(); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - switch (reader.TokenType) - { - case JsonToken.StartObject: - return ReadRegexObject(reader, serializer); - case JsonToken.String: - return ReadRegexString(reader); - case JsonToken.Null: - return null; - } - - throw JsonSerializationException.Create(reader, "Unexpected token when reading Regex."); - } - - private object ReadRegexString(JsonReader reader) - { - string regexText = (string)reader.Value!; - - if (regexText.Length > 0 && regexText[0] == '/') - { - int patternOptionDelimiterIndex = regexText.LastIndexOf('/'); - - if (patternOptionDelimiterIndex > 0) - { - string patternText = regexText.Substring(1, patternOptionDelimiterIndex - 1); - string optionsText = regexText.Substring(patternOptionDelimiterIndex + 1); - - RegexOptions options = MiscellaneousUtils.GetRegexOptions(optionsText); - - return new Regex(patternText, options); - } - } - - throw JsonSerializationException.Create(reader, "Regex pattern must be enclosed by slashes."); - } - - private Regex ReadRegexObject(JsonReader reader, JsonSerializer serializer) - { - string? pattern = null; - RegexOptions? options = null; - - while (reader.Read()) - { - switch (reader.TokenType) - { - case JsonToken.PropertyName: - string propertyName = reader.Value!.ToString(); - - if (!reader.Read()) - { - throw JsonSerializationException.Create(reader, "Unexpected end when reading Regex."); - } - - if (string.Equals(propertyName, PatternName, StringComparison.OrdinalIgnoreCase)) - { - pattern = (string?)reader.Value; - } - else if (string.Equals(propertyName, OptionsName, StringComparison.OrdinalIgnoreCase)) - { - options = serializer.Deserialize(reader); - } - else - { - reader.Skip(); - } - break; - case JsonToken.Comment: - break; - case JsonToken.EndObject: - if (pattern == null) - { - throw JsonSerializationException.Create(reader, "Error deserializing Regex. No pattern found."); - } - - return new Regex(pattern, options ?? RegexOptions.None); - } - } - - throw JsonSerializationException.Create(reader, "Unexpected end when reading Regex."); - } - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - return objectType.Name == nameof(Regex) && IsRegex(objectType); - } - - [MethodImpl(MethodImplOptions.NoInlining)] - private bool IsRegex(Type objectType) - { - return (objectType == typeof(Regex)); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/StringEnumConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/StringEnumConverter.cs deleted file mode 100644 index 9ba6b63..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/StringEnumConverter.cs +++ /dev/null @@ -1,276 +0,0 @@ -#region License - -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. - -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; -using System.Reflection; -using System.Runtime.Serialization; -using Newtonsoft.Json.Utilities; -using Newtonsoft.Json.Serialization; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts an to and from its name string value. - /// - public class StringEnumConverter : JsonConverter - { - /// - /// Gets or sets a value indicating whether the written enum text should be camel case. - /// The default value is false. - /// - /// true if the written enum text will be camel case; otherwise, false. - [Obsolete("StringEnumConverter.CamelCaseText is obsolete. Set StringEnumConverter.NamingStrategy with CamelCaseNamingStrategy instead.")] - public bool CamelCaseText - { - get => NamingStrategy is CamelCaseNamingStrategy ? true : false; - set - { - if (value) - { - if (NamingStrategy is CamelCaseNamingStrategy) - { - return; - } - - NamingStrategy = new CamelCaseNamingStrategy(); - } - else - { - if (!(NamingStrategy is CamelCaseNamingStrategy)) - { - return; - } - - NamingStrategy = null; - } - } - } - - /// - /// Gets or sets the naming strategy used to resolve how enum text is written. - /// - /// The naming strategy used to resolve how enum text is written. - public NamingStrategy? NamingStrategy { get; set; } - - /// - /// Gets or sets a value indicating whether integer values are allowed when serializing and deserializing. - /// The default value is true. - /// - /// true if integers are allowed when serializing and deserializing; otherwise, false. - public bool AllowIntegerValues { get; set; } = true; - - /// - /// Initializes a new instance of the class. - /// - public StringEnumConverter() - { - } - - /// - /// Initializes a new instance of the class. - /// - /// true if the written enum text will be camel case; otherwise, false. - [Obsolete("StringEnumConverter(bool) is obsolete. Create a converter with StringEnumConverter(NamingStrategy, bool) instead.")] - public StringEnumConverter(bool camelCaseText) - { - if (camelCaseText) - { - NamingStrategy = new CamelCaseNamingStrategy(); - } - } - - /// - /// Initializes a new instance of the class. - /// - /// The naming strategy used to resolve how enum text is written. - /// true if integers are allowed when serializing and deserializing; otherwise, false. - public StringEnumConverter(NamingStrategy namingStrategy, bool allowIntegerValues = true) - { - NamingStrategy = namingStrategy; - AllowIntegerValues = allowIntegerValues; - } - - /// - /// Initializes a new instance of the class. - /// - /// The of the used to write enum text. - public StringEnumConverter(Type namingStrategyType) - { - ValidationUtils.ArgumentNotNull(namingStrategyType, nameof(namingStrategyType)); - - NamingStrategy = JsonTypeReflector.CreateNamingStrategyInstance(namingStrategyType, null); - } - - /// - /// Initializes a new instance of the class. - /// - /// The of the used to write enum text. - /// - /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, - /// order, and type of these parameters. - /// - public StringEnumConverter(Type namingStrategyType, object[] namingStrategyParameters) - { - ValidationUtils.ArgumentNotNull(namingStrategyType, nameof(namingStrategyType)); - - NamingStrategy = JsonTypeReflector.CreateNamingStrategyInstance(namingStrategyType, namingStrategyParameters); - } - - /// - /// Initializes a new instance of the class. - /// - /// The of the used to write enum text. - /// - /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, - /// order, and type of these parameters. - /// - /// true if integers are allowed when serializing and deserializing; otherwise, false. - public StringEnumConverter(Type namingStrategyType, object[] namingStrategyParameters, bool allowIntegerValues) - { - ValidationUtils.ArgumentNotNull(namingStrategyType, nameof(namingStrategyType)); - - NamingStrategy = JsonTypeReflector.CreateNamingStrategyInstance(namingStrategyType, namingStrategyParameters); - AllowIntegerValues = allowIntegerValues; - } - - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - Enum e = (Enum)value; - - if (!EnumUtils.TryToString(e.GetType(), value, NamingStrategy, out string? enumName)) - { - if (!AllowIntegerValues) - { - throw JsonSerializationException.Create(null, writer.ContainerPath, "Integer value {0} is not allowed.".FormatWith(CultureInfo.InvariantCulture, e.ToString("D")), null); - } - - // enum value has no name so write number - writer.WriteValue(value); - } - else - { - writer.WriteValue(enumName); - } - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - if (reader.TokenType == JsonToken.Null) - { - if (!ReflectionUtils.IsNullableType(objectType)) - { - throw JsonSerializationException.Create(reader, "Cannot convert null value to {0}.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - - return null; - } - - bool isNullable = ReflectionUtils.IsNullableType(objectType); - Type t = isNullable ? Nullable.GetUnderlyingType(objectType) : objectType; - - try - { - if (reader.TokenType == JsonToken.String) - { - string? enumText = reader.Value?.ToString(); - - if (StringUtils.IsNullOrEmpty(enumText) && isNullable) - { - return null; - } - - return EnumUtils.ParseEnum(t, NamingStrategy, enumText!, !AllowIntegerValues); - } - - if (reader.TokenType == JsonToken.Integer) - { - if (!AllowIntegerValues) - { - throw JsonSerializationException.Create(reader, "Integer value {0} is not allowed.".FormatWith(CultureInfo.InvariantCulture, reader.Value)); - } - - return ConvertUtils.ConvertOrCast(reader.Value, CultureInfo.InvariantCulture, t); - } - } - catch (Exception ex) - { - throw JsonSerializationException.Create(reader, "Error converting value {0} to type '{1}'.".FormatWith(CultureInfo.InvariantCulture, MiscellaneousUtils.ToString(reader.Value), objectType), ex); - } - - // we don't actually expect to get here. - throw JsonSerializationException.Create(reader, "Unexpected token {0} when parsing enum.".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - Type t = (ReflectionUtils.IsNullableType(objectType)) - ? Nullable.GetUnderlyingType(objectType) - : objectType; - - return t.IsEnum(); - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Converters/UnixDateTimeConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/UnixDateTimeConverter.cs deleted file mode 100644 index d80be6e..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/UnixDateTimeConverter.cs +++ /dev/null @@ -1,132 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a to and from Unix epoch time - /// - public class UnixDateTimeConverter : DateTimeConverterBase - { - internal static readonly DateTime UnixEpoch = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc); - - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - long seconds; - - if (value is DateTime dateTime) - { - seconds = (long)(dateTime.ToUniversalTime() - UnixEpoch).TotalSeconds; - } -#if HAVE_DATE_TIME_OFFSET - else if (value is DateTimeOffset dateTimeOffset) - { - seconds = (long)(dateTimeOffset.ToUniversalTime() - UnixEpoch).TotalSeconds; - } -#endif - else - { - throw new JsonSerializationException("Expected date object value."); - } - - if (seconds < 0) - { - throw new JsonSerializationException("Cannot convert date value that is before Unix epoch of 00:00:00 UTC on 1 January 1970."); - } - - writer.WriteValue(seconds); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing property value of the JSON that is being converted. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - bool nullable = ReflectionUtils.IsNullable(objectType); - if (reader.TokenType == JsonToken.Null) - { - if (!nullable) - { - throw JsonSerializationException.Create(reader, "Cannot convert null value to {0}.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - - return null; - } - - long seconds; - - if (reader.TokenType == JsonToken.Integer) - { - seconds = (long)reader.Value!; - } - else if (reader.TokenType == JsonToken.String) - { - if (!long.TryParse((string)reader.Value!, out seconds)) - { - throw JsonSerializationException.Create(reader, "Cannot convert invalid value to {0}.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - } - else - { - throw JsonSerializationException.Create(reader, "Unexpected token parsing date. Expected Integer or String, got {0}.".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - if (seconds >= 0) - { - DateTime d = UnixEpoch.AddSeconds(seconds); - -#if HAVE_DATE_TIME_OFFSET - Type t = (nullable) - ? Nullable.GetUnderlyingType(objectType) - : objectType; - if (t == typeof(DateTimeOffset)) - { - return new DateTimeOffset(d, TimeSpan.Zero); - } -#endif - return d; - } - else - { - throw JsonSerializationException.Create(reader, "Cannot convert value that is before Unix epoch of 00:00:00 UTC on 1 January 1970 to {0}.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/VersionConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/VersionConverter.cs deleted file mode 100644 index e0cded2..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/VersionConverter.cs +++ /dev/null @@ -1,106 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Converters -{ - /// - /// Converts a to and from a string (e.g. "1.2.3.4"). - /// - public class VersionConverter : JsonConverter - { - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - } - else if (value is Version) - { - writer.WriteValue(value.ToString()); - } - else - { - throw new JsonSerializationException("Expected Version object value"); - } - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing property value of the JSON that is being converted. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - if (reader.TokenType == JsonToken.Null) - { - return null; - } - else - { - if (reader.TokenType == JsonToken.String) - { - try - { - Version v = new Version((string)reader.Value!); - return v; - } - catch (Exception ex) - { - throw JsonSerializationException.Create(reader, "Error parsing version string: {0}".FormatWith(CultureInfo.InvariantCulture, reader.Value), ex); - } - } - else - { - throw JsonSerializationException.Create(reader, "Unexpected token or value when parsing version. Token: {0}, Value: {1}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType, reader.Value)); - } - } - } - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public override bool CanConvert(Type objectType) - { - return objectType == typeof(Version); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Converters/XmlNodeConverter.cs b/Source/MyDb/Newtonsoft.Json/Converters/XmlNodeConverter.cs deleted file mode 100644 index 2abb677..0000000 --- a/Source/MyDb/Newtonsoft.Json/Converters/XmlNodeConverter.cs +++ /dev/null @@ -1,2222 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if (HAVE_XML_DOCUMENT || HAVE_XLINQ) - -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using System; -using System.Collections.Generic; -using System.Globalization; -using System.Xml; -using Newtonsoft.Json.Serialization; -#if HAVE_XLINQ -using System.Xml.Linq; -#endif -using Newtonsoft.Json.Utilities; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; - -namespace Newtonsoft.Json.Converters -{ - #region XmlNodeWrappers -#if HAVE_XML_DOCUMENT - internal class XmlDocumentWrapper : XmlNodeWrapper, IXmlDocument - { - private readonly XmlDocument _document; - - public XmlDocumentWrapper(XmlDocument document) - : base(document) - { - _document = document; - } - - public IXmlNode CreateComment(string? data) - { - return new XmlNodeWrapper(_document.CreateComment(data)); - } - - public IXmlNode CreateTextNode(string? text) - { - return new XmlNodeWrapper(_document.CreateTextNode(text)); - } - - public IXmlNode CreateCDataSection(string? data) - { - return new XmlNodeWrapper(_document.CreateCDataSection(data)); - } - - public IXmlNode CreateWhitespace(string? text) - { - return new XmlNodeWrapper(_document.CreateWhitespace(text)); - } - - public IXmlNode CreateSignificantWhitespace(string? text) - { - return new XmlNodeWrapper(_document.CreateSignificantWhitespace(text)); - } - - public IXmlNode CreateXmlDeclaration(string? version, string? encoding, string? standalone) - { - return new XmlDeclarationWrapper(_document.CreateXmlDeclaration(version, encoding, standalone)); - } - -#if HAVE_XML_DOCUMENT_TYPE - public IXmlNode CreateXmlDocumentType(string? name, string? publicId, string? systemId, string? internalSubset) - { - return new XmlDocumentTypeWrapper(_document.CreateDocumentType(name, publicId, systemId, null)); - } -#endif - - public IXmlNode CreateProcessingInstruction(string target, string? data) - { - return new XmlNodeWrapper(_document.CreateProcessingInstruction(target, data)); - } - - public IXmlElement CreateElement(string elementName) - { - return new XmlElementWrapper(_document.CreateElement(elementName)); - } - - public IXmlElement CreateElement(string qualifiedName, string namespaceUri) - { - return new XmlElementWrapper(_document.CreateElement(qualifiedName, namespaceUri)); - } - - public IXmlNode CreateAttribute(string name, string? value) - { - XmlNodeWrapper attribute = new XmlNodeWrapper(_document.CreateAttribute(name)); - attribute.Value = value; - - return attribute; - } - - public IXmlNode CreateAttribute(string qualifiedName, string namespaceUri, string? value) - { - XmlNodeWrapper attribute = new XmlNodeWrapper(_document.CreateAttribute(qualifiedName, namespaceUri)); - attribute.Value = value; - - return attribute; - } - - public IXmlElement? DocumentElement - { - get - { - if (_document.DocumentElement == null) - { - return null; - } - - return new XmlElementWrapper(_document.DocumentElement); - } - } - } - - internal class XmlElementWrapper : XmlNodeWrapper, IXmlElement - { - private readonly XmlElement _element; - - public XmlElementWrapper(XmlElement element) - : base(element) - { - _element = element; - } - - public void SetAttributeNode(IXmlNode attribute) - { - XmlNodeWrapper xmlAttributeWrapper = (XmlNodeWrapper)attribute; - - _element.SetAttributeNode((XmlAttribute)xmlAttributeWrapper.WrappedNode!); - } - - public string GetPrefixOfNamespace(string namespaceUri) - { - return _element.GetPrefixOfNamespace(namespaceUri); - } - - public bool IsEmpty => _element.IsEmpty; - } - - internal class XmlDeclarationWrapper : XmlNodeWrapper, IXmlDeclaration - { - private readonly XmlDeclaration _declaration; - - public XmlDeclarationWrapper(XmlDeclaration declaration) - : base(declaration) - { - _declaration = declaration; - } - - public string Version => _declaration.Version; - - public string Encoding - { - get => _declaration.Encoding; - set => _declaration.Encoding = value; - } - - public string Standalone - { - get => _declaration.Standalone; - set => _declaration.Standalone = value; - } - } - -#if HAVE_XML_DOCUMENT_TYPE - internal class XmlDocumentTypeWrapper : XmlNodeWrapper, IXmlDocumentType - { - private readonly XmlDocumentType _documentType; - - public XmlDocumentTypeWrapper(XmlDocumentType documentType) - : base(documentType) - { - _documentType = documentType; - } - - public string Name => _documentType.Name; - - public string System => _documentType.SystemId; - - public string Public => _documentType.PublicId; - - public string InternalSubset => _documentType.InternalSubset; - - public override string? LocalName => "DOCTYPE"; - } -#endif - - internal class XmlNodeWrapper : IXmlNode - { - private readonly XmlNode _node; - private List? _childNodes; - private List? _attributes; - - public XmlNodeWrapper(XmlNode node) - { - _node = node; - } - - public object? WrappedNode => _node; - - public XmlNodeType NodeType => _node.NodeType; - - public virtual string? LocalName => _node.LocalName; - - public List ChildNodes - { - get - { - // childnodes is read multiple times - // cache results to prevent multiple reads which kills perf in large documents - if (_childNodes == null) - { - if (!_node.HasChildNodes) - { - _childNodes = XmlNodeConverter.EmptyChildNodes; - } - else - { - _childNodes = new List(_node.ChildNodes.Count); - foreach (XmlNode childNode in _node.ChildNodes) - { - _childNodes.Add(WrapNode(childNode)); - } - } - } - - return _childNodes; - } - } - - protected virtual bool HasChildNodes => _node.HasChildNodes; - - internal static IXmlNode WrapNode(XmlNode node) - { - switch (node.NodeType) - { - case XmlNodeType.Element: - return new XmlElementWrapper((XmlElement)node); - case XmlNodeType.XmlDeclaration: - return new XmlDeclarationWrapper((XmlDeclaration)node); -#if HAVE_XML_DOCUMENT_TYPE - case XmlNodeType.DocumentType: - return new XmlDocumentTypeWrapper((XmlDocumentType)node); -#endif - default: - return new XmlNodeWrapper(node); - } - } - - public List Attributes - { - get - { - // attributes is read multiple times - // cache results to prevent multiple reads which kills perf in large documents - if (_attributes == null) - { - if (!HasAttributes) - { - _attributes = XmlNodeConverter.EmptyChildNodes; - } - else - { - _attributes = new List(_node.Attributes.Count); - foreach (XmlAttribute attribute in _node.Attributes) - { - _attributes.Add(WrapNode(attribute)); - } - } - } - - return _attributes; - } - } - - private bool HasAttributes - { - get - { - if (_node is XmlElement element) - { - return element.HasAttributes; - } - - return _node.Attributes?.Count > 0; - } - } - - public IXmlNode? ParentNode - { - get - { - XmlNode node = _node is XmlAttribute attribute ? attribute.OwnerElement : _node.ParentNode; - - if (node == null) - { - return null; - } - - return WrapNode(node); - } - } - - public string? Value - { - get => _node.Value; - set => _node.Value = value; - } - - public IXmlNode AppendChild(IXmlNode newChild) - { - XmlNodeWrapper xmlNodeWrapper = (XmlNodeWrapper)newChild; - _node.AppendChild(xmlNodeWrapper._node); - _childNodes = null; - _attributes = null; - - return newChild; - } - - public string? NamespaceUri => _node.NamespaceURI; - } -#endif -#endregion - -#region Interfaces - internal interface IXmlDocument : IXmlNode - { - IXmlNode CreateComment(string? text); - IXmlNode CreateTextNode(string? text); - IXmlNode CreateCDataSection(string? data); - IXmlNode CreateWhitespace(string? text); - IXmlNode CreateSignificantWhitespace(string? text); - IXmlNode CreateXmlDeclaration(string? version, string? encoding, string? standalone); -#if HAVE_XML_DOCUMENT_TYPE - IXmlNode CreateXmlDocumentType(string? name, string? publicId, string? systemId, string? internalSubset); -#endif - IXmlNode CreateProcessingInstruction(string target, string? data); - IXmlElement CreateElement(string elementName); - IXmlElement CreateElement(string qualifiedName, string namespaceUri); - IXmlNode CreateAttribute(string name, string? value); - IXmlNode CreateAttribute(string qualifiedName, string namespaceUri, string? value); - - IXmlElement? DocumentElement { get; } - } - - internal interface IXmlDeclaration : IXmlNode - { - string Version { get; } - string Encoding { get; set; } - string Standalone { get; set; } - } - - internal interface IXmlDocumentType : IXmlNode - { - string Name { get; } - string System { get; } - string Public { get; } - string InternalSubset { get; } - } - - internal interface IXmlElement : IXmlNode - { - void SetAttributeNode(IXmlNode attribute); - string GetPrefixOfNamespace(string namespaceUri); - bool IsEmpty { get; } - } - - internal interface IXmlNode - { - XmlNodeType NodeType { get; } - string? LocalName { get; } - List ChildNodes { get; } - List Attributes { get; } - IXmlNode? ParentNode { get; } - string? Value { get; set; } - IXmlNode AppendChild(IXmlNode newChild); - string? NamespaceUri { get; } - object? WrappedNode { get; } - } -#endregion - -#region XNodeWrappers -#if HAVE_XLINQ - internal class XDeclarationWrapper : XObjectWrapper, IXmlDeclaration - { - internal XDeclaration Declaration { get; } - - public XDeclarationWrapper(XDeclaration declaration) - : base(null) - { - Declaration = declaration; - } - - public override XmlNodeType NodeType => XmlNodeType.XmlDeclaration; - - public string Version => Declaration.Version; - - public string Encoding - { - get => Declaration.Encoding; - set => Declaration.Encoding = value; - } - - public string Standalone - { - get => Declaration.Standalone; - set => Declaration.Standalone = value; - } - } - - internal class XDocumentTypeWrapper : XObjectWrapper, IXmlDocumentType - { - private readonly XDocumentType _documentType; - - public XDocumentTypeWrapper(XDocumentType documentType) - : base(documentType) - { - _documentType = documentType; - } - - public string Name => _documentType.Name; - - public string System => _documentType.SystemId; - - public string Public => _documentType.PublicId; - - public string InternalSubset => _documentType.InternalSubset; - - public override string? LocalName => "DOCTYPE"; - } - - internal class XDocumentWrapper : XContainerWrapper, IXmlDocument - { - private XDocument Document => (XDocument)WrappedNode!; - - public XDocumentWrapper(XDocument document) - : base(document) - { - } - - public override List ChildNodes - { - get - { - List childNodes = base.ChildNodes; - if (Document.Declaration != null && (childNodes.Count == 0 || childNodes[0].NodeType != XmlNodeType.XmlDeclaration)) - { - childNodes.Insert(0, new XDeclarationWrapper(Document.Declaration)); - } - - return childNodes; - } - } - - protected override bool HasChildNodes - { - get - { - if (base.HasChildNodes) - { - return true; - } - - return Document.Declaration != null; - } - } - - public IXmlNode CreateComment(string? text) - { - return new XObjectWrapper(new XComment(text)); - } - - public IXmlNode CreateTextNode(string? text) - { - return new XObjectWrapper(new XText(text)); - } - - public IXmlNode CreateCDataSection(string? data) - { - return new XObjectWrapper(new XCData(data)); - } - - public IXmlNode CreateWhitespace(string? text) - { - return new XObjectWrapper(new XText(text)); - } - - public IXmlNode CreateSignificantWhitespace(string? text) - { - return new XObjectWrapper(new XText(text)); - } - - public IXmlNode CreateXmlDeclaration(string? version, string? encoding, string? standalone) - { - return new XDeclarationWrapper(new XDeclaration(version, encoding, standalone)); - } - - public IXmlNode CreateXmlDocumentType(string? name, string? publicId, string? systemId, string? internalSubset) - { - return new XDocumentTypeWrapper(new XDocumentType(name, publicId, systemId, internalSubset)); - } - - public IXmlNode CreateProcessingInstruction(string target, string? data) - { - return new XProcessingInstructionWrapper(new XProcessingInstruction(target, data)); - } - - public IXmlElement CreateElement(string elementName) - { - return new XElementWrapper(new XElement(elementName)); - } - - public IXmlElement CreateElement(string qualifiedName, string namespaceUri) - { - string localName = MiscellaneousUtils.GetLocalName(qualifiedName); - return new XElementWrapper(new XElement(XName.Get(localName, namespaceUri))); - } - - public IXmlNode CreateAttribute(string name, string? value) - { - return new XAttributeWrapper(new XAttribute(name, value)); - } - - public IXmlNode CreateAttribute(string qualifiedName, string namespaceUri, string? value) - { - string localName = MiscellaneousUtils.GetLocalName(qualifiedName); - return new XAttributeWrapper(new XAttribute(XName.Get(localName, namespaceUri), value)); - } - - public IXmlElement? DocumentElement - { - get - { - if (Document.Root == null) - { - return null; - } - - return new XElementWrapper(Document.Root); - } - } - - public override IXmlNode AppendChild(IXmlNode newChild) - { - if (newChild is XDeclarationWrapper declarationWrapper) - { - Document.Declaration = declarationWrapper.Declaration; - return declarationWrapper; - } - else - { - return base.AppendChild(newChild); - } - } - } - - internal class XTextWrapper : XObjectWrapper - { - private XText Text => (XText)WrappedNode!; - - public XTextWrapper(XText text) - : base(text) - { - } - - public override string? Value - { - get => Text.Value; - set => Text.Value = value; - } - - public override IXmlNode? ParentNode - { - get - { - if (Text.Parent == null) - { - return null; - } - - return XContainerWrapper.WrapNode(Text.Parent); - } - } - } - - internal class XCommentWrapper : XObjectWrapper - { - private XComment Text => (XComment)WrappedNode!; - - public XCommentWrapper(XComment text) - : base(text) - { - } - - public override string? Value - { - get => Text.Value; - set => Text.Value = value; - } - - public override IXmlNode? ParentNode - { - get - { - if (Text.Parent == null) - { - return null; - } - - return XContainerWrapper.WrapNode(Text.Parent); - } - } - } - - internal class XProcessingInstructionWrapper : XObjectWrapper - { - private XProcessingInstruction ProcessingInstruction => (XProcessingInstruction)WrappedNode!; - - public XProcessingInstructionWrapper(XProcessingInstruction processingInstruction) - : base(processingInstruction) - { - } - - public override string? LocalName => ProcessingInstruction.Target; - - public override string? Value - { - get => ProcessingInstruction.Data; - set => ProcessingInstruction.Data = value; - } - } - - internal class XContainerWrapper : XObjectWrapper - { - private List? _childNodes; - - private XContainer Container => (XContainer)WrappedNode!; - - public XContainerWrapper(XContainer container) - : base(container) - { - } - - public override List ChildNodes - { - get - { - // childnodes is read multiple times - // cache results to prevent multiple reads which kills perf in large documents - if (_childNodes == null) - { - if (!HasChildNodes) - { - _childNodes = XmlNodeConverter.EmptyChildNodes; - } - else - { - _childNodes = new List(); - foreach (XNode node in Container.Nodes()) - { - _childNodes.Add(WrapNode(node)); - } - } - } - - return _childNodes; - } - } - - protected virtual bool HasChildNodes => Container.LastNode != null; - - public override IXmlNode? ParentNode - { - get - { - if (Container.Parent == null) - { - return null; - } - - return WrapNode(Container.Parent); - } - } - - internal static IXmlNode WrapNode(XObject node) - { - if (node is XDocument document) - { - return new XDocumentWrapper(document); - } - - if (node is XElement element) - { - return new XElementWrapper(element); - } - - if (node is XContainer container) - { - return new XContainerWrapper(container); - } - - if (node is XProcessingInstruction pi) - { - return new XProcessingInstructionWrapper(pi); - } - - if (node is XText text) - { - return new XTextWrapper(text); - } - - if (node is XComment comment) - { - return new XCommentWrapper(comment); - } - - if (node is XAttribute attribute) - { - return new XAttributeWrapper(attribute); - } - - if (node is XDocumentType type) - { - return new XDocumentTypeWrapper(type); - } - - return new XObjectWrapper(node); - } - - public override IXmlNode AppendChild(IXmlNode newChild) - { - Container.Add(newChild.WrappedNode); - _childNodes = null; - - return newChild; - } - } - - internal class XObjectWrapper : IXmlNode - { - private readonly XObject? _xmlObject; - - public XObjectWrapper(XObject? xmlObject) - { - _xmlObject = xmlObject; - } - - public object? WrappedNode => _xmlObject; - - public virtual XmlNodeType NodeType => _xmlObject?.NodeType ?? XmlNodeType.None; - - public virtual string? LocalName => null; - - public virtual List ChildNodes => XmlNodeConverter.EmptyChildNodes; - - public virtual List Attributes => XmlNodeConverter.EmptyChildNodes; - - public virtual IXmlNode? ParentNode => null; - - public virtual string? Value - { - get => null; - set => throw new InvalidOperationException(); - } - - public virtual IXmlNode AppendChild(IXmlNode newChild) - { - throw new InvalidOperationException(); - } - - public virtual string? NamespaceUri => null; - } - - internal class XAttributeWrapper : XObjectWrapper - { - private XAttribute Attribute => (XAttribute)WrappedNode!; - - public XAttributeWrapper(XAttribute attribute) - : base(attribute) - { - } - - public override string? Value - { - get => Attribute.Value; - set => Attribute.Value = value; - } - - public override string? LocalName => Attribute.Name.LocalName; - - public override string? NamespaceUri => Attribute.Name.NamespaceName; - - public override IXmlNode? ParentNode - { - get - { - if (Attribute.Parent == null) - { - return null; - } - - return XContainerWrapper.WrapNode(Attribute.Parent); - } - } - } - - internal class XElementWrapper : XContainerWrapper, IXmlElement - { - private List? _attributes; - - private XElement Element => (XElement)WrappedNode!; - - public XElementWrapper(XElement element) - : base(element) - { - } - - public void SetAttributeNode(IXmlNode attribute) - { - XObjectWrapper wrapper = (XObjectWrapper)attribute; - Element.Add(wrapper.WrappedNode); - _attributes = null; - } - - public override List Attributes - { - get - { - // attributes is read multiple times - // cache results to prevent multiple reads which kills perf in large documents - if (_attributes == null) - { - if (!Element.HasAttributes && !HasImplicitNamespaceAttribute(NamespaceUri!)) - { - _attributes = XmlNodeConverter.EmptyChildNodes; - } - else - { - _attributes = new List(); - foreach (XAttribute attribute in Element.Attributes()) - { - _attributes.Add(new XAttributeWrapper(attribute)); - } - - // ensure elements created with a namespace but no namespace attribute are converted correctly - // e.g. new XElement("{http://example.com}MyElement"); - string namespaceUri = NamespaceUri!; - if (HasImplicitNamespaceAttribute(namespaceUri)) - { - _attributes.Insert(0, new XAttributeWrapper(new XAttribute("xmlns", namespaceUri))); - } - } - } - - return _attributes; - } - } - - private bool HasImplicitNamespaceAttribute(string namespaceUri) - { - if (!StringUtils.IsNullOrEmpty(namespaceUri) && namespaceUri != ParentNode?.NamespaceUri) - { - if (StringUtils.IsNullOrEmpty(GetPrefixOfNamespace(namespaceUri))) - { - bool namespaceDeclared = false; - - if (Element.HasAttributes) - { - foreach (XAttribute attribute in Element.Attributes()) - { - if (attribute.Name.LocalName == "xmlns" && StringUtils.IsNullOrEmpty(attribute.Name.NamespaceName) && attribute.Value == namespaceUri) - { - namespaceDeclared = true; - } - } - } - - if (!namespaceDeclared) - { - return true; - } - } - } - - return false; - } - - public override IXmlNode AppendChild(IXmlNode newChild) - { - IXmlNode result = base.AppendChild(newChild); - _attributes = null; - return result; - } - - public override string? Value - { - get => Element.Value; - set => Element.Value = value; - } - - public override string? LocalName => Element.Name.LocalName; - - public override string? NamespaceUri => Element.Name.NamespaceName; - - public string GetPrefixOfNamespace(string namespaceUri) - { - return Element.GetPrefixOfNamespace(namespaceUri); - } - - public bool IsEmpty => Element.IsEmpty; - } -#endif -#endregion - - /// - /// Converts XML to and from JSON. - /// - public class XmlNodeConverter : JsonConverter - { - internal static readonly List EmptyChildNodes = new List(); - - private const string TextName = "#text"; - private const string CommentName = "#comment"; - private const string CDataName = "#cdata-section"; - private const string WhitespaceName = "#whitespace"; - private const string SignificantWhitespaceName = "#significant-whitespace"; - private const string DeclarationName = "?xml"; - private const string JsonNamespaceUri = "http://james.newtonking.com/projects/json"; - - /// - /// Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. - /// - /// The name of the deserialized root element. - public string? DeserializeRootElementName { get; set; } - - /// - /// Gets or sets a value to indicate whether to write the Json.NET array attribute. - /// This attribute helps preserve arrays when converting the written XML back to JSON. - /// - /// true if the array attribute is written to the XML; otherwise, false. - public bool WriteArrayAttribute { get; set; } - - /// - /// Gets or sets a value indicating whether to write the root JSON object. - /// - /// true if the JSON root object is omitted; otherwise, false. - public bool OmitRootObject { get; set; } - - /// - /// Gets or sets a value indicating whether to encode special characters when converting JSON to XML. - /// If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify - /// XML namespaces, attributes or processing directives. Instead special characters are encoded and written - /// as part of the XML element name. - /// - /// true if special characters are encoded; otherwise, false. - public bool EncodeSpecialCharacters { get; set; } - - #region Writing - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The calling serializer. - /// The value. - public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - IXmlNode node = WrapXml(value); - - XmlNamespaceManager manager = new XmlNamespaceManager(new NameTable()); - PushParentNamespaces(node, manager); - - if (!OmitRootObject) - { - writer.WriteStartObject(); - } - - SerializeNode(writer, node, manager, !OmitRootObject); - - if (!OmitRootObject) - { - writer.WriteEndObject(); - } - } - - private IXmlNode WrapXml(object value) - { -#if HAVE_XLINQ - if (value is XObject xObject) - { - return XContainerWrapper.WrapNode(xObject); - } -#endif -#if HAVE_XML_DOCUMENT - if (value is XmlNode node) - { - return XmlNodeWrapper.WrapNode(node); - } -#endif - - throw new ArgumentException("Value must be an XML object.", nameof(value)); - } - - private void PushParentNamespaces(IXmlNode node, XmlNamespaceManager manager) - { - List? parentElements = null; - - IXmlNode? parent = node; - while ((parent = parent.ParentNode) != null) - { - if (parent.NodeType == XmlNodeType.Element) - { - if (parentElements == null) - { - parentElements = new List(); - } - - parentElements.Add(parent); - } - } - - if (parentElements != null) - { - parentElements.Reverse(); - - foreach (IXmlNode parentElement in parentElements) - { - manager.PushScope(); - foreach (IXmlNode attribute in parentElement.Attributes) - { - if (attribute.NamespaceUri == "http://www.w3.org/2000/xmlns/" && attribute.LocalName != "xmlns") - { - manager.AddNamespace(attribute.LocalName, attribute.Value); - } - } - } - } - } - - private string ResolveFullName(IXmlNode node, XmlNamespaceManager manager) - { - string? prefix = (node.NamespaceUri == null || (node.LocalName == "xmlns" && node.NamespaceUri == "http://www.w3.org/2000/xmlns/")) - ? null - : manager.LookupPrefix(node.NamespaceUri); - - if (!StringUtils.IsNullOrEmpty(prefix)) - { - return prefix + ":" + XmlConvert.DecodeName(node.LocalName); - } - else - { - return XmlConvert.DecodeName(node.LocalName); - } - } - - private string GetPropertyName(IXmlNode node, XmlNamespaceManager manager) - { - switch (node.NodeType) - { - case XmlNodeType.Attribute: - if (node.NamespaceUri == JsonNamespaceUri) - { - return "$" + node.LocalName; - } - else - { - return "@" + ResolveFullName(node, manager); - } - case XmlNodeType.CDATA: - return CDataName; - case XmlNodeType.Comment: - return CommentName; - case XmlNodeType.Element: - if (node.NamespaceUri == JsonNamespaceUri) - { - return "$" + node.LocalName; - } - else - { - return ResolveFullName(node, manager); - } - case XmlNodeType.ProcessingInstruction: - return "?" + ResolveFullName(node, manager); - case XmlNodeType.DocumentType: - return "!" + ResolveFullName(node, manager); - case XmlNodeType.XmlDeclaration: - return DeclarationName; - case XmlNodeType.SignificantWhitespace: - return SignificantWhitespaceName; - case XmlNodeType.Text: - return TextName; - case XmlNodeType.Whitespace: - return WhitespaceName; - default: - throw new JsonSerializationException("Unexpected XmlNodeType when getting node name: " + node.NodeType); - } - } - - private bool IsArray(IXmlNode node) - { - foreach (IXmlNode attribute in node.Attributes) - { - if (attribute.LocalName == "Array" && attribute.NamespaceUri == JsonNamespaceUri) - { - return XmlConvert.ToBoolean(attribute.Value); - } - } - - return false; - } - - private void SerializeGroupedNodes(JsonWriter writer, IXmlNode node, XmlNamespaceManager manager, bool writePropertyName) - { - switch (node.ChildNodes.Count) - { - case 0: - { - // nothing to serialize - break; - } - case 1: - { - // avoid grouping when there is only one node - string nodeName = GetPropertyName(node.ChildNodes[0], manager); - WriteGroupedNodes(writer, manager, writePropertyName, node.ChildNodes, nodeName); - break; - } - default: - { - // check whether nodes have the same name - // if they don't then group into dictionary together by name - - // value of dictionary will be a single IXmlNode when there is one for a name, - // or a List when there are multiple - Dictionary? nodesGroupedByName = null; - - string? nodeName = null; - - for (int i = 0; i < node.ChildNodes.Count; i++) - { - IXmlNode childNode = node.ChildNodes[i]; - string currentNodeName = GetPropertyName(childNode, manager); - - if (nodesGroupedByName == null) - { - if (nodeName == null) - { - nodeName = currentNodeName; - } - else if (currentNodeName == nodeName) - { - // current node name matches others - } - else - { - nodesGroupedByName = new Dictionary(); - if (i > 1) - { - List nodes = new List(i); - for (int j = 0; j < i; j++) - { - nodes.Add(node.ChildNodes[j]); - } - nodesGroupedByName.Add(nodeName, nodes); - } - else - { - nodesGroupedByName.Add(nodeName, node.ChildNodes[0]); - } - nodesGroupedByName.Add(currentNodeName, childNode); - } - } - else - { - if (!nodesGroupedByName.TryGetValue(currentNodeName, out object value)) - { - nodesGroupedByName.Add(currentNodeName, childNode); - } - else - { - if (!(value is List nodes)) - { - nodes = new List {(IXmlNode)value!}; - nodesGroupedByName[currentNodeName] = nodes; - } - - nodes.Add(childNode); - } - } - } - - if (nodesGroupedByName == null) - { - WriteGroupedNodes(writer, manager, writePropertyName, node.ChildNodes, nodeName!); - } - else - { - // loop through grouped nodes. write single name instances as normal, - // write multiple names together in an array - foreach (KeyValuePair nodeNameGroup in nodesGroupedByName) - { - if (nodeNameGroup.Value is List nodes) - { - WriteGroupedNodes(writer, manager, writePropertyName, nodes, nodeNameGroup.Key); - } - else - { - WriteGroupedNodes(writer, manager, writePropertyName, (IXmlNode)nodeNameGroup.Value, nodeNameGroup.Key); - } - } - } - break; - } - } - } - - private void WriteGroupedNodes(JsonWriter writer, XmlNamespaceManager manager, bool writePropertyName, List groupedNodes, string elementNames) - { - bool writeArray = groupedNodes.Count != 1 || IsArray(groupedNodes[0]); - - if (!writeArray) - { - SerializeNode(writer, groupedNodes[0], manager, writePropertyName); - } - else - { - if (writePropertyName) - { - writer.WritePropertyName(elementNames); - } - - writer.WriteStartArray(); - - for (int i = 0; i < groupedNodes.Count; i++) - { - SerializeNode(writer, groupedNodes[i], manager, false); - } - - writer.WriteEndArray(); - } - } - - private void WriteGroupedNodes(JsonWriter writer, XmlNamespaceManager manager, bool writePropertyName, IXmlNode node, string elementNames) - { - bool writeArray = IsArray(node); - - if (!writeArray) - { - SerializeNode(writer, node, manager, writePropertyName); - } - else - { - if (writePropertyName) - { - writer.WritePropertyName(elementNames); - } - - writer.WriteStartArray(); - - SerializeNode(writer, node, manager, false); - - writer.WriteEndArray(); - } - } - - private void SerializeNode(JsonWriter writer, IXmlNode node, XmlNamespaceManager manager, bool writePropertyName) - { - switch (node.NodeType) - { - case XmlNodeType.Document: - case XmlNodeType.DocumentFragment: - SerializeGroupedNodes(writer, node, manager, writePropertyName); - break; - case XmlNodeType.Element: - if (IsArray(node) && AllSameName(node) && node.ChildNodes.Count > 0) - { - SerializeGroupedNodes(writer, node, manager, false); - } - else - { - manager.PushScope(); - - foreach (IXmlNode attribute in node.Attributes) - { - if (attribute.NamespaceUri == "http://www.w3.org/2000/xmlns/") - { - string namespacePrefix = (attribute.LocalName != "xmlns") - ? XmlConvert.DecodeName(attribute.LocalName) - : string.Empty; - string? namespaceUri = attribute.Value; - if (namespaceUri == null) - { - throw new JsonSerializationException("Namespace attribute must have a value."); - } - - manager.AddNamespace(namespacePrefix, namespaceUri); - } - } - - if (writePropertyName) - { - writer.WritePropertyName(GetPropertyName(node, manager)); - } - - if (!ValueAttributes(node.Attributes) && node.ChildNodes.Count == 1 - && node.ChildNodes[0].NodeType == XmlNodeType.Text) - { - // write elements with a single text child as a name value pair - writer.WriteValue(node.ChildNodes[0].Value); - } - else if (node.ChildNodes.Count == 0 && node.Attributes.Count == 0) - { - IXmlElement element = (IXmlElement)node; - - // empty element - if (element.IsEmpty) - { - writer.WriteNull(); - } - else - { - writer.WriteValue(string.Empty); - } - } - else - { - writer.WriteStartObject(); - - for (int i = 0; i < node.Attributes.Count; i++) - { - SerializeNode(writer, node.Attributes[i], manager, true); - } - - SerializeGroupedNodes(writer, node, manager, true); - - writer.WriteEndObject(); - } - - manager.PopScope(); - } - - break; - case XmlNodeType.Comment: - if (writePropertyName) - { - writer.WriteComment(node.Value); - } - break; - case XmlNodeType.Attribute: - case XmlNodeType.Text: - case XmlNodeType.CDATA: - case XmlNodeType.ProcessingInstruction: - case XmlNodeType.Whitespace: - case XmlNodeType.SignificantWhitespace: - if (node.NamespaceUri == "http://www.w3.org/2000/xmlns/" && node.Value == JsonNamespaceUri) - { - return; - } - - if (node.NamespaceUri == JsonNamespaceUri) - { - if (node.LocalName == "Array") - { - return; - } - } - - if (writePropertyName) - { - writer.WritePropertyName(GetPropertyName(node, manager)); - } - writer.WriteValue(node.Value); - break; - case XmlNodeType.XmlDeclaration: - IXmlDeclaration declaration = (IXmlDeclaration)node; - writer.WritePropertyName(GetPropertyName(node, manager)); - writer.WriteStartObject(); - - if (!StringUtils.IsNullOrEmpty(declaration.Version)) - { - writer.WritePropertyName("@version"); - writer.WriteValue(declaration.Version); - } - if (!StringUtils.IsNullOrEmpty(declaration.Encoding)) - { - writer.WritePropertyName("@encoding"); - writer.WriteValue(declaration.Encoding); - } - if (!StringUtils.IsNullOrEmpty(declaration.Standalone)) - { - writer.WritePropertyName("@standalone"); - writer.WriteValue(declaration.Standalone); - } - - writer.WriteEndObject(); - break; - case XmlNodeType.DocumentType: - IXmlDocumentType documentType = (IXmlDocumentType)node; - writer.WritePropertyName(GetPropertyName(node, manager)); - writer.WriteStartObject(); - - if (!StringUtils.IsNullOrEmpty(documentType.Name)) - { - writer.WritePropertyName("@name"); - writer.WriteValue(documentType.Name); - } - if (!StringUtils.IsNullOrEmpty(documentType.Public)) - { - writer.WritePropertyName("@public"); - writer.WriteValue(documentType.Public); - } - if (!StringUtils.IsNullOrEmpty(documentType.System)) - { - writer.WritePropertyName("@system"); - writer.WriteValue(documentType.System); - } - if (!StringUtils.IsNullOrEmpty(documentType.InternalSubset)) - { - writer.WritePropertyName("@internalSubset"); - writer.WriteValue(documentType.InternalSubset); - } - - writer.WriteEndObject(); - break; - default: - throw new JsonSerializationException("Unexpected XmlNodeType when serializing nodes: " + node.NodeType); - } - } - - private static bool AllSameName(IXmlNode node) - { - foreach (IXmlNode childNode in node.ChildNodes) - { - if (childNode.LocalName != node.LocalName) - { - return false; - } - } - return true; - } -#endregion - - #region Reading - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - switch (reader.TokenType) - { - case JsonToken.Null: - return null; - case JsonToken.StartObject: - break; - default: - throw JsonSerializationException.Create(reader, "XmlNodeConverter can only convert JSON that begins with an object."); - } - - XmlNamespaceManager manager = new XmlNamespaceManager(new NameTable()); - IXmlDocument? document = null; - IXmlNode? rootNode = null; - -#if HAVE_XLINQ - if (typeof(XObject).IsAssignableFrom(objectType)) - { - if (objectType != typeof(XContainer) - && objectType != typeof(XDocument) - && objectType != typeof(XElement) - && objectType != typeof(XNode) - && objectType != typeof(XObject)) - { - throw JsonSerializationException.Create(reader, "XmlNodeConverter only supports deserializing XDocument, XElement, XContainer, XNode or XObject."); - } - - XDocument d = new XDocument(); - document = new XDocumentWrapper(d); - rootNode = document; - } -#endif -#if HAVE_XML_DOCUMENT - if (typeof(XmlNode).IsAssignableFrom(objectType)) - { - if (objectType != typeof(XmlDocument) - && objectType != typeof(XmlElement) - && objectType != typeof(XmlNode)) - { - throw JsonSerializationException.Create(reader, "XmlNodeConverter only supports deserializing XmlDocument, XmlElement or XmlNode."); - } - - XmlDocument d = new XmlDocument(); -#if HAVE_XML_DOCUMENT_TYPE - // prevent http request when resolving any DTD references - d.XmlResolver = null; -#endif - - document = new XmlDocumentWrapper(d); - rootNode = document; - } -#endif - - if (document == null || rootNode == null) - { - throw JsonSerializationException.Create(reader, "Unexpected type when converting XML: " + objectType); - } - - if (!StringUtils.IsNullOrEmpty(DeserializeRootElementName)) - { - ReadElement(reader, document, rootNode, DeserializeRootElementName, manager); - } - else - { - reader.ReadAndAssert(); - DeserializeNode(reader, document, manager, rootNode); - } - -#if HAVE_XLINQ - if (objectType == typeof(XElement)) - { - XElement element = (XElement)document.DocumentElement!.WrappedNode!; - element.Remove(); - - return element; - } -#endif -#if HAVE_XML_DOCUMENT - if (objectType == typeof(XmlElement)) - { - return document.DocumentElement!.WrappedNode; - } -#endif - - return document.WrappedNode; - } - - private void DeserializeValue(JsonReader reader, IXmlDocument document, XmlNamespaceManager manager, string propertyName, IXmlNode currentNode) - { - if (!EncodeSpecialCharacters) - { - switch (propertyName) - { - case TextName: - currentNode.AppendChild(document.CreateTextNode(ConvertTokenToXmlValue(reader))); - return; - case CDataName: - currentNode.AppendChild(document.CreateCDataSection(ConvertTokenToXmlValue(reader))); - return; - case WhitespaceName: - currentNode.AppendChild(document.CreateWhitespace(ConvertTokenToXmlValue(reader))); - return; - case SignificantWhitespaceName: - currentNode.AppendChild(document.CreateSignificantWhitespace(ConvertTokenToXmlValue(reader))); - return; - default: - // processing instructions and the xml declaration start with ? - if (!StringUtils.IsNullOrEmpty(propertyName) && propertyName[0] == '?') - { - CreateInstruction(reader, document, currentNode, propertyName); - return; - } -#if HAVE_XML_DOCUMENT_TYPE - else if (string.Equals(propertyName, "!DOCTYPE", StringComparison.OrdinalIgnoreCase)) - { - CreateDocumentType(reader, document, currentNode); - return; - } -#endif - break; - } - } - - if (reader.TokenType == JsonToken.StartArray) - { - // handle nested arrays - ReadArrayElements(reader, document, propertyName, currentNode, manager); - return; - } - - // have to wait until attributes have been parsed before creating element - // attributes may contain namespace info used by the element - ReadElement(reader, document, currentNode, propertyName, manager); - } - - private void ReadElement(JsonReader reader, IXmlDocument document, IXmlNode currentNode, string propertyName, XmlNamespaceManager manager) - { - if (StringUtils.IsNullOrEmpty(propertyName)) - { - throw JsonSerializationException.Create(reader, "XmlNodeConverter cannot convert JSON with an empty property name to XML."); - } - - Dictionary? attributeNameValues = null; - string? elementPrefix = null; - - if (!EncodeSpecialCharacters) - { - attributeNameValues = ShouldReadInto(reader) - ? ReadAttributeElements(reader, manager) - : null; - elementPrefix = MiscellaneousUtils.GetPrefix(propertyName); - - if (propertyName.StartsWith('@')) - { - string attributeName = propertyName.Substring(1); - string? attributePrefix = MiscellaneousUtils.GetPrefix(attributeName); - - AddAttribute(reader, document, currentNode, propertyName, attributeName, manager, attributePrefix); - return; - } - - if (propertyName.StartsWith('$')) - { - switch (propertyName) - { - case JsonTypeReflector.ArrayValuesPropertyName: - propertyName = propertyName.Substring(1); - elementPrefix = manager.LookupPrefix(JsonNamespaceUri); - CreateElement(reader, document, currentNode, propertyName, manager, elementPrefix, attributeNameValues); - return; - case JsonTypeReflector.IdPropertyName: - case JsonTypeReflector.RefPropertyName: - case JsonTypeReflector.TypePropertyName: - case JsonTypeReflector.ValuePropertyName: - string attributeName = propertyName.Substring(1); - string attributePrefix = manager.LookupPrefix(JsonNamespaceUri); - AddAttribute(reader, document, currentNode, propertyName, attributeName, manager, attributePrefix); - return; - } - } - } - else - { - if (ShouldReadInto(reader)) - { - reader.ReadAndAssert(); - } - } - - CreateElement(reader, document, currentNode, propertyName, manager, elementPrefix, attributeNameValues); - } - - private void CreateElement(JsonReader reader, IXmlDocument document, IXmlNode currentNode, string elementName, XmlNamespaceManager manager, string? elementPrefix, Dictionary? attributeNameValues) - { - IXmlElement element = CreateElement(elementName, document, elementPrefix, manager); - - currentNode.AppendChild(element); - - if (attributeNameValues != null) - { - // add attributes to newly created element - foreach (KeyValuePair nameValue in attributeNameValues) - { - string encodedName = XmlConvert.EncodeName(nameValue.Key); - string? attributePrefix = MiscellaneousUtils.GetPrefix(nameValue.Key); - - IXmlNode attribute = (!StringUtils.IsNullOrEmpty(attributePrefix)) ? document.CreateAttribute(encodedName, manager.LookupNamespace(attributePrefix) ?? string.Empty, nameValue.Value) : document.CreateAttribute(encodedName, nameValue.Value); - - element.SetAttributeNode(attribute); - } - } - - switch (reader.TokenType) - { - case JsonToken.String: - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.Boolean: - case JsonToken.Date: - case JsonToken.Bytes: - string? text = ConvertTokenToXmlValue(reader); - if (text != null) - { - element.AppendChild(document.CreateTextNode(text)); - } - break; - case JsonToken.Null: - - // empty element. do nothing - break; - case JsonToken.EndObject: - - // finished element will have no children to deserialize - manager.RemoveNamespace(string.Empty, manager.DefaultNamespace); - break; - default: - manager.PushScope(); - DeserializeNode(reader, document, manager, element); - manager.PopScope(); - manager.RemoveNamespace(string.Empty, manager.DefaultNamespace); - break; - } - } - - private static void AddAttribute(JsonReader reader, IXmlDocument document, IXmlNode currentNode, string propertyName, string attributeName, XmlNamespaceManager manager, string? attributePrefix) - { - if (currentNode.NodeType == XmlNodeType.Document) - { - throw JsonSerializationException.Create(reader, "JSON root object has property '{0}' that will be converted to an attribute. A root object cannot have any attribute properties. Consider specifying a DeserializeRootElementName.".FormatWith(CultureInfo.InvariantCulture, propertyName)); - } - - string encodedName = XmlConvert.EncodeName(attributeName); - string? attributeValue = ConvertTokenToXmlValue(reader); - - IXmlNode attribute = (!StringUtils.IsNullOrEmpty(attributePrefix)) - ? document.CreateAttribute(encodedName, manager.LookupNamespace(attributePrefix), attributeValue) - : document.CreateAttribute(encodedName, attributeValue); - - ((IXmlElement)currentNode).SetAttributeNode(attribute); - } - - private static string? ConvertTokenToXmlValue(JsonReader reader) - { - switch (reader.TokenType) - { - case JsonToken.String: - return reader.Value?.ToString(); - case JsonToken.Integer: -#if HAVE_BIG_INTEGER - if (reader.Value is BigInteger i) - { - return i.ToString(CultureInfo.InvariantCulture); - } -#endif - return XmlConvert.ToString(Convert.ToInt64(reader.Value, CultureInfo.InvariantCulture)); - case JsonToken.Float: - { - if (reader.Value is decimal d) - { - return XmlConvert.ToString(d); - } - - if (reader.Value is float f) - { - return XmlConvert.ToString(f); - } - - return XmlConvert.ToString(Convert.ToDouble(reader.Value, CultureInfo.InvariantCulture)); - } - case JsonToken.Boolean: - return XmlConvert.ToString(Convert.ToBoolean(reader.Value, CultureInfo.InvariantCulture)); - case JsonToken.Date: - { -#if HAVE_DATE_TIME_OFFSET - if (reader.Value is DateTimeOffset offset) - { - return XmlConvert.ToString(offset); - } - -#endif - DateTime d = Convert.ToDateTime(reader.Value, CultureInfo.InvariantCulture); -#if !PORTABLE || NETSTANDARD1_3 - return XmlConvert.ToString(d, DateTimeUtils.ToSerializationMode(d.Kind)); -#else - return d.ToString(DateTimeUtils.ToDateTimeFormat(d.Kind), CultureInfo.InvariantCulture); -#endif - } - case JsonToken.Bytes: - return Convert.ToBase64String((byte[])reader.Value!); - case JsonToken.Null: - return null; - default: - throw JsonSerializationException.Create(reader, "Cannot get an XML string value from token type '{0}'.".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - } - - private void ReadArrayElements(JsonReader reader, IXmlDocument document, string propertyName, IXmlNode currentNode, XmlNamespaceManager manager) - { - string? elementPrefix = MiscellaneousUtils.GetPrefix(propertyName); - - IXmlElement nestedArrayElement = CreateElement(propertyName, document, elementPrefix, manager); - - currentNode.AppendChild(nestedArrayElement); - - int count = 0; - while (reader.Read() && reader.TokenType != JsonToken.EndArray) - { - DeserializeValue(reader, document, manager, propertyName, nestedArrayElement); - count++; - } - - if (WriteArrayAttribute) - { - AddJsonArrayAttribute(nestedArrayElement, document); - } - - if (count == 1 && WriteArrayAttribute) - { - foreach (IXmlNode childNode in nestedArrayElement.ChildNodes) - { - if (childNode is IXmlElement element && element.LocalName == propertyName) - { - AddJsonArrayAttribute(element, document); - break; - } - } - } - } - - private void AddJsonArrayAttribute(IXmlElement element, IXmlDocument document) - { - element.SetAttributeNode(document.CreateAttribute("json:Array", JsonNamespaceUri, "true")); - -#if HAVE_XLINQ - // linq to xml doesn't automatically include prefixes via the namespace manager - if (element is XElementWrapper) - { - if (element.GetPrefixOfNamespace(JsonNamespaceUri) == null) - { - element.SetAttributeNode(document.CreateAttribute("xmlns:json", "http://www.w3.org/2000/xmlns/", JsonNamespaceUri)); - } - } -#endif - } - - private bool ShouldReadInto(JsonReader reader) - { - // a string token means the element only has a single text child - switch (reader.TokenType) - { - case JsonToken.String: - case JsonToken.Null: - case JsonToken.Boolean: - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.Date: - case JsonToken.Bytes: - case JsonToken.StartConstructor: - return false; - } - - return true; - } - - private Dictionary? ReadAttributeElements(JsonReader reader, XmlNamespaceManager manager) - { - Dictionary? attributeNameValues = null; - bool finished = false; - - // read properties until first non-attribute is encountered - while (!finished && reader.Read()) - { - switch (reader.TokenType) - { - case JsonToken.PropertyName: - string attributeName = reader.Value!.ToString(); - - if (!StringUtils.IsNullOrEmpty(attributeName)) - { - char firstChar = attributeName[0]; - string? attributeValue; - - switch (firstChar) - { - case '@': - if (attributeNameValues == null) - { - attributeNameValues = new Dictionary(); - } - - attributeName = attributeName.Substring(1); - reader.ReadAndAssert(); - attributeValue = ConvertTokenToXmlValue(reader); - attributeNameValues.Add(attributeName, attributeValue); - - if (IsNamespaceAttribute(attributeName, out string? namespacePrefix)) - { - manager.AddNamespace(namespacePrefix, attributeValue); - } - break; - case '$': - switch (attributeName) - { - case JsonTypeReflector.ArrayValuesPropertyName: - case JsonTypeReflector.IdPropertyName: - case JsonTypeReflector.RefPropertyName: - case JsonTypeReflector.TypePropertyName: - case JsonTypeReflector.ValuePropertyName: - // check that JsonNamespaceUri is in scope - // if it isn't then add it to document and namespace manager - string jsonPrefix = manager.LookupPrefix(JsonNamespaceUri); - if (jsonPrefix == null) - { - if (attributeNameValues == null) - { - attributeNameValues = new Dictionary(); - } - - // ensure that the prefix used is free - int? i = null; - while (manager.LookupNamespace("json" + i) != null) - { - i = i.GetValueOrDefault() + 1; - } - jsonPrefix = "json" + i; - - attributeNameValues.Add("xmlns:" + jsonPrefix, JsonNamespaceUri); - manager.AddNamespace(jsonPrefix, JsonNamespaceUri); - } - - // special case $values, it will have a non-primitive value - if (attributeName == JsonTypeReflector.ArrayValuesPropertyName) - { - finished = true; - break; - } - - attributeName = attributeName.Substring(1); - reader.ReadAndAssert(); - - if (!JsonTokenUtils.IsPrimitiveToken(reader.TokenType)) - { - throw JsonSerializationException.Create(reader, "Unexpected JsonToken: " + reader.TokenType); - } - - if (attributeNameValues == null) - { - attributeNameValues = new Dictionary(); - } - - attributeValue = reader.Value?.ToString(); - attributeNameValues.Add(jsonPrefix + ":" + attributeName, attributeValue); - break; - default: - finished = true; - break; - } - break; - default: - finished = true; - break; - } - } - else - { - finished = true; - } - - break; - case JsonToken.EndObject: - case JsonToken.Comment: - finished = true; - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected JsonToken: " + reader.TokenType); - } - } - - return attributeNameValues; - } - - private void CreateInstruction(JsonReader reader, IXmlDocument document, IXmlNode currentNode, string propertyName) - { - if (propertyName == DeclarationName) - { - string? version = null; - string? encoding = null; - string? standalone = null; - while (reader.Read() && reader.TokenType != JsonToken.EndObject) - { - switch (reader.Value?.ToString()) - { - case "@version": - reader.ReadAndAssert(); - version = ConvertTokenToXmlValue(reader); - break; - case "@encoding": - reader.ReadAndAssert(); - encoding = ConvertTokenToXmlValue(reader); - break; - case "@standalone": - reader.ReadAndAssert(); - standalone = ConvertTokenToXmlValue(reader); - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected property name encountered while deserializing XmlDeclaration: " + reader.Value); - } - } - - IXmlNode declaration = document.CreateXmlDeclaration(version, encoding, standalone); - currentNode.AppendChild(declaration); - } - else - { - IXmlNode instruction = document.CreateProcessingInstruction(propertyName.Substring(1), ConvertTokenToXmlValue(reader)); - currentNode.AppendChild(instruction); - } - } - -#if HAVE_XML_DOCUMENT_TYPE - private void CreateDocumentType(JsonReader reader, IXmlDocument document, IXmlNode currentNode) - { - string? name = null; - string? publicId = null; - string? systemId = null; - string? internalSubset = null; - while (reader.Read() && reader.TokenType != JsonToken.EndObject) - { - switch (reader.Value?.ToString()) - { - case "@name": - reader.ReadAndAssert(); - name = ConvertTokenToXmlValue(reader); - break; - case "@public": - reader.ReadAndAssert(); - publicId = ConvertTokenToXmlValue(reader); - break; - case "@system": - reader.ReadAndAssert(); - systemId = ConvertTokenToXmlValue(reader); - break; - case "@internalSubset": - reader.ReadAndAssert(); - internalSubset = ConvertTokenToXmlValue(reader); - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected property name encountered while deserializing XmlDeclaration: " + reader.Value); - } - } - - IXmlNode documentType = document.CreateXmlDocumentType(name, publicId, systemId, internalSubset); - currentNode.AppendChild(documentType); - } -#endif - - private IXmlElement CreateElement(string elementName, IXmlDocument document, string? elementPrefix, XmlNamespaceManager manager) - { - string encodeName = EncodeSpecialCharacters ? XmlConvert.EncodeLocalName(elementName) : XmlConvert.EncodeName(elementName); - string ns = StringUtils.IsNullOrEmpty(elementPrefix) ? manager.DefaultNamespace : manager.LookupNamespace(elementPrefix); - - IXmlElement element = (!StringUtils.IsNullOrEmpty(ns)) ? document.CreateElement(encodeName, ns) : document.CreateElement(encodeName); - - return element; - } - - private void DeserializeNode(JsonReader reader, IXmlDocument document, XmlNamespaceManager manager, IXmlNode currentNode) - { - do - { - switch (reader.TokenType) - { - case JsonToken.PropertyName: - if (currentNode.NodeType == XmlNodeType.Document && document.DocumentElement != null) - { - throw JsonSerializationException.Create(reader, "JSON root object has multiple properties. The root object must have a single property in order to create a valid XML document. Consider specifying a DeserializeRootElementName."); - } - - string propertyName = reader.Value!.ToString(); - reader.ReadAndAssert(); - - if (reader.TokenType == JsonToken.StartArray) - { - int count = 0; - while (reader.Read() && reader.TokenType != JsonToken.EndArray) - { - DeserializeValue(reader, document, manager, propertyName, currentNode); - count++; - } - - if (count == 1 && WriteArrayAttribute) - { - MiscellaneousUtils.GetQualifiedNameParts(propertyName, out string? elementPrefix, out string localName); - string ns = StringUtils.IsNullOrEmpty(elementPrefix) ? manager.DefaultNamespace : manager.LookupNamespace(elementPrefix); - - foreach (IXmlNode childNode in currentNode.ChildNodes) - { - if (childNode is IXmlElement element && element.LocalName == localName && element.NamespaceUri == ns) - { - AddJsonArrayAttribute(element, document); - break; - } - } - } - } - else - { - DeserializeValue(reader, document, manager, propertyName, currentNode); - } - continue; - case JsonToken.StartConstructor: - string constructorName = reader.Value!.ToString(); - - while (reader.Read() && reader.TokenType != JsonToken.EndConstructor) - { - DeserializeValue(reader, document, manager, constructorName, currentNode); - } - break; - case JsonToken.Comment: - currentNode.AppendChild(document.CreateComment((string)reader.Value!)); - break; - case JsonToken.EndObject: - case JsonToken.EndArray: - return; - default: - throw JsonSerializationException.Create(reader, "Unexpected JsonToken when deserializing node: " + reader.TokenType); - } - } while (reader.Read()); - // don't read if current token is a property. token was already read when parsing element attributes - } - - /// - /// Checks if the is a namespace attribute. - /// - /// Attribute name to test. - /// The attribute name prefix if it has one, otherwise an empty string. - /// true if attribute name is for a namespace attribute, otherwise false. - private bool IsNamespaceAttribute(string attributeName, [NotNullWhen(true)]out string? prefix) - { - if (attributeName.StartsWith("xmlns", StringComparison.Ordinal)) - { - if (attributeName.Length == 5) - { - prefix = string.Empty; - return true; - } - else if (attributeName[5] == ':') - { - prefix = attributeName.Substring(6, attributeName.Length - 6); - return true; - } - } - prefix = null; - return false; - } - - private bool ValueAttributes(List c) - { - foreach (IXmlNode xmlNode in c) - { - if (xmlNode.NamespaceUri == JsonNamespaceUri) - { - continue; - } - - if (xmlNode.NamespaceUri == "http://www.w3.org/2000/xmlns/" && xmlNode.Value == JsonNamespaceUri) - { - continue; - } - - return true; - } - - return false; - } -#endregion - - /// - /// Determines whether this instance can convert the specified value type. - /// - /// Type of the value. - /// - /// true if this instance can convert the specified value type; otherwise, false. - /// - public override bool CanConvert(Type valueType) - { -#if HAVE_XLINQ - if (valueType.AssignableToTypeName("System.Xml.Linq.XObject", false)) - { - return IsXObject(valueType); - } -#endif -#if HAVE_XML_DOCUMENT - if (valueType.AssignableToTypeName("System.Xml.XmlNode", false)) - { - return IsXmlNode(valueType); - } -#endif - - return false; - } - -#if HAVE_XLINQ - [MethodImpl(MethodImplOptions.NoInlining)] - private bool IsXObject(Type valueType) - { - return typeof(XObject).IsAssignableFrom(valueType); - } -#endif - -#if HAVE_XML_DOCUMENT - [MethodImpl(MethodImplOptions.NoInlining)] - private bool IsXmlNode(Type valueType) - { - return typeof(XmlNode).IsAssignableFrom(valueType); - } -#endif - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/DateFormatHandling.cs b/Source/MyDb/Newtonsoft.Json/DateFormatHandling.cs deleted file mode 100644 index 5c79ec9..0000000 --- a/Source/MyDb/Newtonsoft.Json/DateFormatHandling.cs +++ /dev/null @@ -1,43 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Specifies how dates are formatted when writing JSON text. - /// - public enum DateFormatHandling - { - /// - /// Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". - /// - IsoDateFormat, - - /// - /// Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". - /// - MicrosoftDateFormat - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/DateParseHandling.cs b/Source/MyDb/Newtonsoft.Json/DateParseHandling.cs deleted file mode 100644 index 7fc8a46..0000000 --- a/Source/MyDb/Newtonsoft.Json/DateParseHandling.cs +++ /dev/null @@ -1,49 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. - /// - public enum DateParseHandling - { - /// - /// Date formatted strings are not parsed to a date type and are read as strings. - /// - None = 0, - - /// - /// Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . - /// - DateTime = 1, -#if HAVE_DATE_TIME_OFFSET - /// - /// Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . - /// - DateTimeOffset = 2 -#endif - } -} diff --git a/Source/MyDb/Newtonsoft.Json/DateTimeZoneHandling.cs b/Source/MyDb/Newtonsoft.Json/DateTimeZoneHandling.cs deleted file mode 100644 index 9877d6e..0000000 --- a/Source/MyDb/Newtonsoft.Json/DateTimeZoneHandling.cs +++ /dev/null @@ -1,56 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json -{ - /// - /// Specifies how to treat the time value when converting between string and . - /// - public enum DateTimeZoneHandling - { - /// - /// Treat as local time. If the object represents a Coordinated Universal Time (UTC), it is converted to the local time. - /// - Local = 0, - - /// - /// Treat as a UTC. If the object represents a local time, it is converted to a UTC. - /// - Utc = 1, - - /// - /// Treat as a local time if a is being converted to a string. - /// If a string is being converted to , convert to a local time if a time zone is specified. - /// - Unspecified = 2, - - /// - /// Time zone information should be preserved when converting. - /// - RoundtripKind = 3 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/DefaultJsonNameTable.cs b/Source/MyDb/Newtonsoft.Json/DefaultJsonNameTable.cs deleted file mode 100644 index 5243160..0000000 --- a/Source/MyDb/Newtonsoft.Json/DefaultJsonNameTable.cs +++ /dev/null @@ -1,197 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json -{ - /// - /// The default JSON name table implementation. - /// - public class DefaultJsonNameTable : JsonNameTable - { - // used to defeat hashtable DoS attack where someone passes in lots of strings that hash to the same hash code - private static readonly int HashCodeRandomizer; - - private int _count; - private Entry[] _entries; - private int _mask = 31; - - static DefaultJsonNameTable() - { - HashCodeRandomizer = Environment.TickCount; - } - - /// - /// Initializes a new instance of the class. - /// - public DefaultJsonNameTable() - { - _entries = new Entry[_mask + 1]; - } - - /// - /// Gets a string containing the same characters as the specified range of characters in the given array. - /// - /// The character array containing the name to find. - /// The zero-based index into the array specifying the first character of the name. - /// The number of characters in the name. - /// A string containing the same characters as the specified range of characters in the given array. - public override string? Get(char[] key, int start, int length) - { - if (length == 0) - { - return string.Empty; - } - - int hashCode = length + HashCodeRandomizer; - hashCode += (hashCode << 7) ^ key[start]; - int end = start + length; - for (int i = start + 1; i < end; i++) - { - hashCode += (hashCode << 7) ^ key[i]; - } - hashCode -= hashCode >> 17; - hashCode -= hashCode >> 11; - hashCode -= hashCode >> 5; - - // make sure index is evaluated before accessing _entries, otherwise potential race condition causing IndexOutOfRangeException - var index = hashCode & _mask; - var entries = _entries; - - for (Entry entry = entries[index]; entry != null; entry = entry.Next) - { - if (entry.HashCode == hashCode && TextEquals(entry.Value, key, start, length)) - { - return entry.Value; - } - } - - return null; - } - - /// - /// Adds the specified string into name table. - /// - /// The string to add. - /// This method is not thread-safe. - /// The resolved string. - public string Add(string key) - { - if (key == null) - { - throw new ArgumentNullException(nameof(key)); - } - - int length = key.Length; - if (length == 0) - { - return string.Empty; - } - - int hashCode = length + HashCodeRandomizer; - for (int i = 0; i < key.Length; i++) - { - hashCode += (hashCode << 7) ^ key[i]; - } - hashCode -= hashCode >> 17; - hashCode -= hashCode >> 11; - hashCode -= hashCode >> 5; - for (Entry entry = _entries[hashCode & _mask]; entry != null; entry = entry.Next) - { - if (entry.HashCode == hashCode && entry.Value.Equals(key, StringComparison.Ordinal)) - { - return entry.Value; - } - } - - return AddEntry(key, hashCode); - } - - private string AddEntry(string str, int hashCode) - { - int index = hashCode & _mask; - Entry entry = new Entry(str, hashCode, _entries[index]); - _entries[index] = entry; - if (_count++ == _mask) - { - Grow(); - } - return entry.Value; - } - - private void Grow() - { - Entry[] entries = _entries; - int newMask = (_mask * 2) + 1; - Entry[] newEntries = new Entry[newMask + 1]; - - for (int i = 0; i < entries.Length; i++) - { - Entry next; - for (Entry entry = entries[i]; entry != null; entry = next) - { - int index = entry.HashCode & newMask; - next = entry.Next; - entry.Next = newEntries[index]; - newEntries[index] = entry; - } - } - _entries = newEntries; - _mask = newMask; - } - - private static bool TextEquals(string str1, char[] str2, int str2Start, int str2Length) - { - if (str1.Length != str2Length) - { - return false; - } - - for (int i = 0; i < str1.Length; i++) - { - if (str1[i] != str2[str2Start + i]) - { - return false; - } - } - return true; - } - - private class Entry - { - internal readonly string Value; - internal readonly int HashCode; - internal Entry Next; - - internal Entry(string value, int hashCode, Entry next) - { - Value = value; - HashCode = hashCode; - Next = next; - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/DefaultValueHandling.cs b/Source/MyDb/Newtonsoft.Json/DefaultValueHandling.cs deleted file mode 100644 index 4b5312b..0000000 --- a/Source/MyDb/Newtonsoft.Json/DefaultValueHandling.cs +++ /dev/null @@ -1,67 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.ComponentModel; - -namespace Newtonsoft.Json -{ - /// - /// Specifies default value handling options for the . - /// - /// - /// - /// - /// - [Flags] - public enum DefaultValueHandling - { - /// - /// Include members where the member value is the same as the member's default value when serializing objects. - /// Included members are written to JSON. Has no effect when deserializing. - /// - Include = 0, - - /// - /// Ignore members where the member value is the same as the member's default value when serializing objects - /// so that it is not written to JSON. - /// This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, - /// decimals and floating point numbers; and false for booleans). The default value ignored can be changed by - /// placing the on the property. - /// - Ignore = 1, - - /// - /// Members with a default value but no JSON will be set to their default value when deserializing. - /// - Populate = 2, - - /// - /// Ignore members where the member value is the same as the member's default value when serializing objects - /// and set members to their default value when deserializing. - /// - IgnoreAndPopulate = Ignore | Populate - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Dynamic.snk b/Source/MyDb/Newtonsoft.Json/Dynamic.snk deleted file mode 100644 index 2225208..0000000 Binary files a/Source/MyDb/Newtonsoft.Json/Dynamic.snk and /dev/null differ diff --git a/Source/MyDb/Newtonsoft.Json/FloatFormatHandling.cs b/Source/MyDb/Newtonsoft.Json/FloatFormatHandling.cs deleted file mode 100644 index 9b6bd4c..0000000 --- a/Source/MyDb/Newtonsoft.Json/FloatFormatHandling.cs +++ /dev/null @@ -1,52 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json -{ - /// - /// Specifies float format handling options when writing special floating point numbers, e.g. , - /// and with . - /// - public enum FloatFormatHandling - { - /// - /// Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". - /// - String = 0, - - /// - /// Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. - /// Note that this will produce non-valid JSON. - /// - Symbol = 1, - - /// - /// Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. - /// - DefaultValue = 2 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/FloatParseHandling.cs b/Source/MyDb/Newtonsoft.Json/FloatParseHandling.cs deleted file mode 100644 index 3058394..0000000 --- a/Source/MyDb/Newtonsoft.Json/FloatParseHandling.cs +++ /dev/null @@ -1,43 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Specifies how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - /// - public enum FloatParseHandling - { - /// - /// Floating point numbers are parsed to . - /// - Double = 0, - - /// - /// Floating point numbers are parsed to . - /// - Decimal = 1 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/FormatterAssemblyStyle.cs b/Source/MyDb/Newtonsoft.Json/FormatterAssemblyStyle.cs deleted file mode 100644 index d03a269..0000000 --- a/Source/MyDb/Newtonsoft.Json/FormatterAssemblyStyle.cs +++ /dev/null @@ -1,24 +0,0 @@ - -#if HAVE_OBSOLETE_FORMATTER_ASSEMBLY_STYLE - -namespace System.Runtime.Serialization.Formatters -{ - /// - /// Indicates the method that will be used during deserialization for locating and loading assemblies. - /// - [Obsolete("FormatterAssemblyStyle is obsolete. Use TypeNameAssemblyFormatHandling instead.")] - public enum FormatterAssemblyStyle - { - /// - /// In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the method is used to load the assembly. - /// - Simple = 0, - - /// - /// In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The is used to load the assembly. - /// - Full = 1 - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Formatting.cs b/Source/MyDb/Newtonsoft.Json/Formatting.cs deleted file mode 100644 index 9438e63..0000000 --- a/Source/MyDb/Newtonsoft.Json/Formatting.cs +++ /dev/null @@ -1,43 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Specifies formatting options for the . - /// - public enum Formatting - { - /// - /// No special formatting is applied. This is the default. - /// - None = 0, - - /// - /// Causes child objects to be indented according to the and settings. - /// - Indented = 1 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/IArrayPool.cs b/Source/MyDb/Newtonsoft.Json/IArrayPool.cs deleted file mode 100644 index 361ee89..0000000 --- a/Source/MyDb/Newtonsoft.Json/IArrayPool.cs +++ /dev/null @@ -1,22 +0,0 @@ -namespace Newtonsoft.Json -{ - /// - /// Provides an interface for using pooled arrays. - /// - /// The array type content. - public interface IArrayPool - { - /// - /// Rent an array from the pool. This array must be returned when it is no longer needed. - /// - /// The minimum required length of the array. The returned array may be longer. - /// The rented array from the pool. This array must be returned when it is no longer needed. - T[] Rent(int minimumLength); - - /// - /// Return an array to the pool. - /// - /// The array that is being returned. - void Return(T[]? array); - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/IJsonLineInfo.cs b/Source/MyDb/Newtonsoft.Json/IJsonLineInfo.cs deleted file mode 100644 index e261c7d..0000000 --- a/Source/MyDb/Newtonsoft.Json/IJsonLineInfo.cs +++ /dev/null @@ -1,53 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Provides an interface to enable a class to return line and position information. - /// - public interface IJsonLineInfo - { - /// - /// Gets a value indicating whether the class can return line information. - /// - /// - /// true if and can be provided; otherwise, false. - /// - bool HasLineInfo(); - - /// - /// Gets the current line number. - /// - /// The current line number or 0 if no line information is available (for example, when returns false). - int LineNumber { get; } - - /// - /// Gets the current line position. - /// - /// The current line position or 0 if no line information is available (for example, when returns false). - int LinePosition { get; } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonArrayAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonArrayAttribute.cs deleted file mode 100644 index 96221a7..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonArrayAttribute.cs +++ /dev/null @@ -1,73 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the how to serialize the collection. - /// - [AttributeUsage(AttributeTargets.Class | AttributeTargets.Interface, AllowMultiple = false)] - public sealed class JsonArrayAttribute : JsonContainerAttribute - { - private bool _allowNullItems; - - /// - /// Gets or sets a value indicating whether null items are allowed in the collection. - /// - /// true if null items are allowed in the collection; otherwise, false. - public bool AllowNullItems - { - get => _allowNullItems; - set => _allowNullItems = value; - } - - /// - /// Initializes a new instance of the class. - /// - public JsonArrayAttribute() - { - } - - /// - /// Initializes a new instance of the class with a flag indicating whether the array can contain null items. - /// - /// A flag indicating whether the array can contain null items. - public JsonArrayAttribute(bool allowNullItems) - { - _allowNullItems = allowNullItems; - } - - /// - /// Initializes a new instance of the class with the specified container Id. - /// - /// The container Id. - public JsonArrayAttribute(string id) - : base(id) - { - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonConstructorAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonConstructorAttribute.cs deleted file mode 100644 index cd5d1bb..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonConstructorAttribute.cs +++ /dev/null @@ -1,37 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the to use the specified constructor when deserializing that object. - /// - [AttributeUsage(AttributeTargets.Constructor, AllowMultiple = false)] - public sealed class JsonConstructorAttribute : Attribute - { - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonContainerAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonContainerAttribute.cs deleted file mode 100644 index 28f35f5..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonContainerAttribute.cs +++ /dev/null @@ -1,180 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the how to serialize the object. - /// - [AttributeUsage(AttributeTargets.Class | AttributeTargets.Interface, AllowMultiple = false)] - public abstract class JsonContainerAttribute : Attribute - { - /// - /// Gets or sets the id. - /// - /// The id. - public string? Id { get; set; } - - /// - /// Gets or sets the title. - /// - /// The title. - public string? Title { get; set; } - - /// - /// Gets or sets the description. - /// - /// The description. - public string? Description { get; set; } - - /// - /// Gets or sets the collection's items converter. - /// - /// The collection's items converter. - public Type? ItemConverterType { get; set; } - - /// - /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, - /// order, and type of these parameters. - /// - /// - /// - /// [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] - /// - /// - public object[]? ItemConverterParameters { get; set; } - - /// - /// Gets or sets the of the . - /// - /// The of the . - public Type? NamingStrategyType - { - get => _namingStrategyType; - set - { - _namingStrategyType = value; - NamingStrategyInstance = null; - } - } - - /// - /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, - /// order, and type of these parameters. - /// - /// - /// - /// [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] - /// - /// - public object[]? NamingStrategyParameters - { - get => _namingStrategyParameters; - set - { - _namingStrategyParameters = value; - NamingStrategyInstance = null; - } - } - - internal NamingStrategy? NamingStrategyInstance { get; set; } - - // yuck. can't set nullable properties on an attribute in C# - // have to use this approach to get an unset default state - internal bool? _isReference; - internal bool? _itemIsReference; - internal ReferenceLoopHandling? _itemReferenceLoopHandling; - internal TypeNameHandling? _itemTypeNameHandling; - private Type? _namingStrategyType; - private object[]? _namingStrategyParameters; - - /// - /// Gets or sets a value that indicates whether to preserve object references. - /// - /// - /// true to keep object reference; otherwise, false. The default is false. - /// - public bool IsReference - { - get => _isReference ?? default; - set => _isReference = value; - } - - /// - /// Gets or sets a value that indicates whether to preserve collection's items references. - /// - /// - /// true to keep collection's items object references; otherwise, false. The default is false. - /// - public bool ItemIsReference - { - get => _itemIsReference ?? default; - set => _itemIsReference = value; - } - - /// - /// Gets or sets the reference loop handling used when serializing the collection's items. - /// - /// The reference loop handling. - public ReferenceLoopHandling ItemReferenceLoopHandling - { - get => _itemReferenceLoopHandling ?? default; - set => _itemReferenceLoopHandling = value; - } - - /// - /// Gets or sets the type name handling used when serializing the collection's items. - /// - /// The type name handling. - public TypeNameHandling ItemTypeNameHandling - { - get => _itemTypeNameHandling ?? default; - set => _itemTypeNameHandling = value; - } - - /// - /// Initializes a new instance of the class. - /// - protected JsonContainerAttribute() - { - } - - /// - /// Initializes a new instance of the class with the specified container Id. - /// - /// The container Id. - protected JsonContainerAttribute(string id) - { - Id = id; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonConvert.cs b/Source/MyDb/Newtonsoft.Json/JsonConvert.cs deleted file mode 100644 index 5bf7e2a..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonConvert.cs +++ /dev/null @@ -1,1085 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.IO; -using System.Globalization; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Utilities; -using System.Xml; -using Newtonsoft.Json.Converters; -using Newtonsoft.Json.Serialization; -using System.Text; -using System.Diagnostics; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if HAVE_XLINQ -using System.Xml.Linq; -#endif - -namespace Newtonsoft.Json -{ - /// - /// Provides methods for converting between .NET types and JSON types. - /// - /// - /// - /// - public static class JsonConvert - { - /// - /// Gets or sets a function that creates default . - /// Default settings are automatically used by serialization methods on , - /// and and on . - /// To serialize without using any default settings create a with - /// . - /// - public static Func? DefaultSettings { get; set; } - - /// - /// Represents JavaScript's boolean value true as a string. This field is read-only. - /// - public static readonly string True = "true"; - - /// - /// Represents JavaScript's boolean value false as a string. This field is read-only. - /// - public static readonly string False = "false"; - - /// - /// Represents JavaScript's null as a string. This field is read-only. - /// - public static readonly string Null = "null"; - - /// - /// Represents JavaScript's undefined as a string. This field is read-only. - /// - public static readonly string Undefined = "undefined"; - - /// - /// Represents JavaScript's positive infinity as a string. This field is read-only. - /// - public static readonly string PositiveInfinity = "Infinity"; - - /// - /// Represents JavaScript's negative infinity as a string. This field is read-only. - /// - public static readonly string NegativeInfinity = "-Infinity"; - - /// - /// Represents JavaScript's NaN as a string. This field is read-only. - /// - public static readonly string NaN = "NaN"; - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(DateTime value) - { - return ToString(value, DateFormatHandling.IsoDateFormat, DateTimeZoneHandling.RoundtripKind); - } - - /// - /// Converts the to its JSON string representation using the specified. - /// - /// The value to convert. - /// The format the date will be converted to. - /// The time zone handling when the date is converted to a string. - /// A JSON string representation of the . - public static string ToString(DateTime value, DateFormatHandling format, DateTimeZoneHandling timeZoneHandling) - { - DateTime updatedDateTime = DateTimeUtils.EnsureDateTime(value, timeZoneHandling); - - using (StringWriter writer = StringUtils.CreateStringWriter(64)) - { - writer.Write('"'); - DateTimeUtils.WriteDateTimeString(writer, updatedDateTime, format, null, CultureInfo.InvariantCulture); - writer.Write('"'); - return writer.ToString(); - } - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(DateTimeOffset value) - { - return ToString(value, DateFormatHandling.IsoDateFormat); - } - - /// - /// Converts the to its JSON string representation using the specified. - /// - /// The value to convert. - /// The format the date will be converted to. - /// A JSON string representation of the . - public static string ToString(DateTimeOffset value, DateFormatHandling format) - { - using (StringWriter writer = StringUtils.CreateStringWriter(64)) - { - writer.Write('"'); - DateTimeUtils.WriteDateTimeOffsetString(writer, value, format, null, CultureInfo.InvariantCulture); - writer.Write('"'); - return writer.ToString(); - } - } -#endif - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(bool value) - { - return (value) ? True : False; - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(char value) - { - return ToString(char.ToString(value)); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(Enum value) - { - return value.ToString("D"); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(int value) - { - return value.ToString(null, CultureInfo.InvariantCulture); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(short value) - { - return value.ToString(null, CultureInfo.InvariantCulture); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - [CLSCompliant(false)] - public static string ToString(ushort value) - { - return value.ToString(null, CultureInfo.InvariantCulture); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - [CLSCompliant(false)] - public static string ToString(uint value) - { - return value.ToString(null, CultureInfo.InvariantCulture); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(long value) - { - return value.ToString(null, CultureInfo.InvariantCulture); - } - -#if HAVE_BIG_INTEGER - private static string ToStringInternal(BigInteger value) - { - return value.ToString(null, CultureInfo.InvariantCulture); - } -#endif - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - [CLSCompliant(false)] - public static string ToString(ulong value) - { - return value.ToString(null, CultureInfo.InvariantCulture); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(float value) - { - return EnsureDecimalPlace(value, value.ToString("R", CultureInfo.InvariantCulture)); - } - - internal static string ToString(float value, FloatFormatHandling floatFormatHandling, char quoteChar, bool nullable) - { - return EnsureFloatFormat(value, EnsureDecimalPlace(value, value.ToString("R", CultureInfo.InvariantCulture)), floatFormatHandling, quoteChar, nullable); - } - - private static string EnsureFloatFormat(double value, string text, FloatFormatHandling floatFormatHandling, char quoteChar, bool nullable) - { - if (floatFormatHandling == FloatFormatHandling.Symbol || !(double.IsInfinity(value) || double.IsNaN(value))) - { - return text; - } - - if (floatFormatHandling == FloatFormatHandling.DefaultValue) - { - return (!nullable) ? "0.0" : Null; - } - - return quoteChar + text + quoteChar; - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(double value) - { - return EnsureDecimalPlace(value, value.ToString("R", CultureInfo.InvariantCulture)); - } - - internal static string ToString(double value, FloatFormatHandling floatFormatHandling, char quoteChar, bool nullable) - { - return EnsureFloatFormat(value, EnsureDecimalPlace(value, value.ToString("R", CultureInfo.InvariantCulture)), floatFormatHandling, quoteChar, nullable); - } - - private static string EnsureDecimalPlace(double value, string text) - { - if (double.IsNaN(value) || double.IsInfinity(value) || text.IndexOf('.') != -1 || text.IndexOf('E') != -1 || text.IndexOf('e') != -1) - { - return text; - } - - return text + ".0"; - } - - private static string EnsureDecimalPlace(string text) - { - if (text.IndexOf('.') != -1) - { - return text; - } - - return text + ".0"; - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(byte value) - { - return value.ToString(null, CultureInfo.InvariantCulture); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - [CLSCompliant(false)] - public static string ToString(sbyte value) - { - return value.ToString(null, CultureInfo.InvariantCulture); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(decimal value) - { - return EnsureDecimalPlace(value.ToString(null, CultureInfo.InvariantCulture)); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(Guid value) - { - return ToString(value, '"'); - } - - internal static string ToString(Guid value, char quoteChar) - { - string text; - string qc; -#if HAVE_CHAR_TO_STRING_WITH_CULTURE - text = value.ToString("D", CultureInfo.InvariantCulture); - qc = quoteChar.ToString(CultureInfo.InvariantCulture); -#else - text = value.ToString("D"); - qc = quoteChar.ToString(); -#endif - - return qc + text + qc; - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(TimeSpan value) - { - return ToString(value, '"'); - } - - internal static string ToString(TimeSpan value, char quoteChar) - { - return ToString(value.ToString(), quoteChar); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(Uri? value) - { - if (value == null) - { - return Null; - } - - return ToString(value, '"'); - } - - internal static string ToString(Uri value, char quoteChar) - { - return ToString(value.OriginalString, quoteChar); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(string? value) - { - return ToString(value, '"'); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// The string delimiter character. - /// A JSON string representation of the . - public static string ToString(string? value, char delimiter) - { - return ToString(value, delimiter, StringEscapeHandling.Default); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// The string delimiter character. - /// The string escape handling. - /// A JSON string representation of the . - public static string ToString(string? value, char delimiter, StringEscapeHandling stringEscapeHandling) - { - if (delimiter != '"' && delimiter != '\'') - { - throw new ArgumentException("Delimiter must be a single or double quote.", nameof(delimiter)); - } - - return JavaScriptUtils.ToEscapedJavaScriptString(value, delimiter, true, stringEscapeHandling); - } - - /// - /// Converts the to its JSON string representation. - /// - /// The value to convert. - /// A JSON string representation of the . - public static string ToString(object? value) - { - if (value == null) - { - return Null; - } - - PrimitiveTypeCode typeCode = ConvertUtils.GetTypeCode(value.GetType()); - - switch (typeCode) - { - case PrimitiveTypeCode.String: - return ToString((string)value); - case PrimitiveTypeCode.Char: - return ToString((char)value); - case PrimitiveTypeCode.Boolean: - return ToString((bool)value); - case PrimitiveTypeCode.SByte: - return ToString((sbyte)value); - case PrimitiveTypeCode.Int16: - return ToString((short)value); - case PrimitiveTypeCode.UInt16: - return ToString((ushort)value); - case PrimitiveTypeCode.Int32: - return ToString((int)value); - case PrimitiveTypeCode.Byte: - return ToString((byte)value); - case PrimitiveTypeCode.UInt32: - return ToString((uint)value); - case PrimitiveTypeCode.Int64: - return ToString((long)value); - case PrimitiveTypeCode.UInt64: - return ToString((ulong)value); - case PrimitiveTypeCode.Single: - return ToString((float)value); - case PrimitiveTypeCode.Double: - return ToString((double)value); - case PrimitiveTypeCode.DateTime: - return ToString((DateTime)value); - case PrimitiveTypeCode.Decimal: - return ToString((decimal)value); -#if HAVE_DB_NULL_TYPE_CODE - case PrimitiveTypeCode.DBNull: - return Null; -#endif -#if HAVE_DATE_TIME_OFFSET - case PrimitiveTypeCode.DateTimeOffset: - return ToString((DateTimeOffset)value); -#endif - case PrimitiveTypeCode.Guid: - return ToString((Guid)value); - case PrimitiveTypeCode.Uri: - return ToString((Uri)value); - case PrimitiveTypeCode.TimeSpan: - return ToString((TimeSpan)value); -#if HAVE_BIG_INTEGER - case PrimitiveTypeCode.BigInteger: - return ToStringInternal((BigInteger)value); -#endif - } - - throw new ArgumentException("Unsupported type: {0}. Use the JsonSerializer class to get the object's JSON representation.".FormatWith(CultureInfo.InvariantCulture, value.GetType())); - } - - #region Serialize - /// - /// Serializes the specified object to a JSON string. - /// - /// The object to serialize. - /// A JSON string representation of the object. - [DebuggerStepThrough] - public static string SerializeObject(object? value) - { - return SerializeObject(value, null, (JsonSerializerSettings?)null); - } - - /// - /// Serializes the specified object to a JSON string using formatting. - /// - /// The object to serialize. - /// Indicates how the output should be formatted. - /// - /// A JSON string representation of the object. - /// - [DebuggerStepThrough] - public static string SerializeObject(object? value, Formatting formatting) - { - return SerializeObject(value, formatting, (JsonSerializerSettings?)null); - } - - /// - /// Serializes the specified object to a JSON string using a collection of . - /// - /// The object to serialize. - /// A collection of converters used while serializing. - /// A JSON string representation of the object. - [DebuggerStepThrough] - public static string SerializeObject(object? value, params JsonConverter[] converters) - { - JsonSerializerSettings? settings = (converters != null && converters.Length > 0) - ? new JsonSerializerSettings { Converters = converters } - : null; - - return SerializeObject(value, null, settings); - } - - /// - /// Serializes the specified object to a JSON string using formatting and a collection of . - /// - /// The object to serialize. - /// Indicates how the output should be formatted. - /// A collection of converters used while serializing. - /// A JSON string representation of the object. - [DebuggerStepThrough] - public static string SerializeObject(object? value, Formatting formatting, params JsonConverter[] converters) - { - JsonSerializerSettings? settings = (converters != null && converters.Length > 0) - ? new JsonSerializerSettings { Converters = converters } - : null; - - return SerializeObject(value, null, formatting, settings); - } - - /// - /// Serializes the specified object to a JSON string using . - /// - /// The object to serialize. - /// The used to serialize the object. - /// If this is null, default serialization settings will be used. - /// - /// A JSON string representation of the object. - /// - [DebuggerStepThrough] - public static string SerializeObject(object? value, JsonSerializerSettings? settings) - { - return SerializeObject(value, null, settings); - } - - /// - /// Serializes the specified object to a JSON string using a type, formatting and . - /// - /// The object to serialize. - /// The used to serialize the object. - /// If this is null, default serialization settings will be used. - /// - /// The type of the value being serialized. - /// This parameter is used when is to write out the type name if the type of the value does not match. - /// Specifying the type is optional. - /// - /// - /// A JSON string representation of the object. - /// - [DebuggerStepThrough] - public static string SerializeObject(object? value, Type? type, JsonSerializerSettings? settings) - { - JsonSerializer jsonSerializer = JsonSerializer.CreateDefault(settings); - - return SerializeObjectInternal(value, type, jsonSerializer); - } - - /// - /// Serializes the specified object to a JSON string using formatting and . - /// - /// The object to serialize. - /// Indicates how the output should be formatted. - /// The used to serialize the object. - /// If this is null, default serialization settings will be used. - /// - /// A JSON string representation of the object. - /// - [DebuggerStepThrough] - public static string SerializeObject(object? value, Formatting formatting, JsonSerializerSettings? settings) - { - return SerializeObject(value, null, formatting, settings); - } - - /// - /// Serializes the specified object to a JSON string using a type, formatting and . - /// - /// The object to serialize. - /// Indicates how the output should be formatted. - /// The used to serialize the object. - /// If this is null, default serialization settings will be used. - /// - /// The type of the value being serialized. - /// This parameter is used when is to write out the type name if the type of the value does not match. - /// Specifying the type is optional. - /// - /// - /// A JSON string representation of the object. - /// - [DebuggerStepThrough] - public static string SerializeObject(object? value, Type? type, Formatting formatting, JsonSerializerSettings? settings) - { - JsonSerializer jsonSerializer = JsonSerializer.CreateDefault(settings); - jsonSerializer.Formatting = formatting; - - return SerializeObjectInternal(value, type, jsonSerializer); - } - - private static string SerializeObjectInternal(object? value, Type? type, JsonSerializer jsonSerializer) - { - StringBuilder sb = new StringBuilder(256); - StringWriter sw = new StringWriter(sb, CultureInfo.InvariantCulture); - using (JsonTextWriter jsonWriter = new JsonTextWriter(sw)) - { - jsonWriter.Formatting = jsonSerializer.Formatting; - - jsonSerializer.Serialize(jsonWriter, value, type); - } - - return sw.ToString(); - } - #endregion - - #region Deserialize - /// - /// Deserializes the JSON to a .NET object. - /// - /// The JSON to deserialize. - /// The deserialized object from the JSON string. - [DebuggerStepThrough] - public static object? DeserializeObject(string value) - { - return DeserializeObject(value, null, (JsonSerializerSettings?)null); - } - - /// - /// Deserializes the JSON to a .NET object using . - /// - /// The JSON to deserialize. - /// - /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. - /// - /// The deserialized object from the JSON string. - [DebuggerStepThrough] - public static object? DeserializeObject(string value, JsonSerializerSettings settings) - { - return DeserializeObject(value, null, settings); - } - - /// - /// Deserializes the JSON to the specified .NET type. - /// - /// The JSON to deserialize. - /// The of object being deserialized. - /// The deserialized object from the JSON string. - [DebuggerStepThrough] - public static object? DeserializeObject(string value, Type type) - { - return DeserializeObject(value, type, (JsonSerializerSettings?)null); - } - - /// - /// Deserializes the JSON to the specified .NET type. - /// - /// The type of the object to deserialize to. - /// The JSON to deserialize. - /// The deserialized object from the JSON string. - [DebuggerStepThrough] - public static T? DeserializeObject(string value) - { - return DeserializeObject(value, (JsonSerializerSettings?)null); - } - - /// - /// Deserializes the JSON to the given anonymous type. - /// - /// - /// The anonymous type to deserialize to. This can't be specified - /// traditionally and must be inferred from the anonymous type passed - /// as a parameter. - /// - /// The JSON to deserialize. - /// The anonymous type object. - /// The deserialized anonymous type from the JSON string. - [DebuggerStepThrough] - public static T? DeserializeAnonymousType(string value, T anonymousTypeObject) - { - return DeserializeObject(value); - } - - /// - /// Deserializes the JSON to the given anonymous type using . - /// - /// - /// The anonymous type to deserialize to. This can't be specified - /// traditionally and must be inferred from the anonymous type passed - /// as a parameter. - /// - /// The JSON to deserialize. - /// The anonymous type object. - /// - /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. - /// - /// The deserialized anonymous type from the JSON string. - [DebuggerStepThrough] - public static T? DeserializeAnonymousType(string value, T anonymousTypeObject, JsonSerializerSettings settings) - { - return DeserializeObject(value, settings); - } - - /// - /// Deserializes the JSON to the specified .NET type using a collection of . - /// - /// The type of the object to deserialize to. - /// The JSON to deserialize. - /// Converters to use while deserializing. - /// The deserialized object from the JSON string. - [DebuggerStepThrough] - public static T? DeserializeObject(string value, params JsonConverter[] converters) - { - return (T?)DeserializeObject(value, typeof(T), converters); - } - - /// - /// Deserializes the JSON to the specified .NET type using . - /// - /// The type of the object to deserialize to. - /// The object to deserialize. - /// - /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. - /// - /// The deserialized object from the JSON string. - [DebuggerStepThrough] - public static T? DeserializeObject(string value, JsonSerializerSettings? settings) - { - return (T?)DeserializeObject(value, typeof(T), settings); - } - - /// - /// Deserializes the JSON to the specified .NET type using a collection of . - /// - /// The JSON to deserialize. - /// The type of the object to deserialize. - /// Converters to use while deserializing. - /// The deserialized object from the JSON string. - [DebuggerStepThrough] - public static object? DeserializeObject(string value, Type type, params JsonConverter[] converters) - { - JsonSerializerSettings? settings = (converters != null && converters.Length > 0) - ? new JsonSerializerSettings { Converters = converters } - : null; - - return DeserializeObject(value, type, settings); - } - - /// - /// Deserializes the JSON to the specified .NET type using . - /// - /// The JSON to deserialize. - /// The type of the object to deserialize to. - /// - /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. - /// - /// The deserialized object from the JSON string. - public static object? DeserializeObject(string value, Type? type, JsonSerializerSettings? settings) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - - JsonSerializer jsonSerializer = JsonSerializer.CreateDefault(settings); - - // by default DeserializeObject should check for additional content - if (!jsonSerializer.IsCheckAdditionalContentSet()) - { - jsonSerializer.CheckAdditionalContent = true; - } - - using (JsonTextReader reader = new JsonTextReader(new StringReader(value))) - { - return jsonSerializer.Deserialize(reader, type); - } - } - #endregion - - #region Populate - /// - /// Populates the object with values from the JSON string. - /// - /// The JSON to populate values from. - /// The target object to populate values onto. - [DebuggerStepThrough] - public static void PopulateObject(string value, object target) - { - PopulateObject(value, target, null); - } - - /// - /// Populates the object with values from the JSON string using . - /// - /// The JSON to populate values from. - /// The target object to populate values onto. - /// - /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. - /// - public static void PopulateObject(string value, object target, JsonSerializerSettings? settings) - { - JsonSerializer jsonSerializer = JsonSerializer.CreateDefault(settings); - - using (JsonReader jsonReader = new JsonTextReader(new StringReader(value))) - { - jsonSerializer.Populate(jsonReader, target); - - if (settings != null && settings.CheckAdditionalContent) - { - while (jsonReader.Read()) - { - if (jsonReader.TokenType != JsonToken.Comment) - { - throw JsonSerializationException.Create(jsonReader, "Additional text found in JSON string after finishing deserializing object."); - } - } - } - } - } - #endregion - - #region Xml -#if HAVE_XML_DOCUMENT - /// - /// Serializes the to a JSON string. - /// - /// The node to serialize. - /// A JSON string of the . - public static string SerializeXmlNode(XmlNode? node) - { - return SerializeXmlNode(node, Formatting.None); - } - - /// - /// Serializes the to a JSON string using formatting. - /// - /// The node to serialize. - /// Indicates how the output should be formatted. - /// A JSON string of the . - public static string SerializeXmlNode(XmlNode? node, Formatting formatting) - { - XmlNodeConverter converter = new XmlNodeConverter(); - - return SerializeObject(node, formatting, converter); - } - - /// - /// Serializes the to a JSON string using formatting and omits the root object if is true. - /// - /// The node to serialize. - /// Indicates how the output should be formatted. - /// Omits writing the root object. - /// A JSON string of the . - public static string SerializeXmlNode(XmlNode? node, Formatting formatting, bool omitRootObject) - { - XmlNodeConverter converter = new XmlNodeConverter { OmitRootObject = omitRootObject }; - - return SerializeObject(node, formatting, converter); - } - - /// - /// Deserializes the from a JSON string. - /// - /// The JSON string. - /// The deserialized . - public static XmlDocument? DeserializeXmlNode(string value) - { - return DeserializeXmlNode(value, null); - } - - /// - /// Deserializes the from a JSON string nested in a root element specified by . - /// - /// The JSON string. - /// The name of the root element to append when deserializing. - /// The deserialized . - public static XmlDocument? DeserializeXmlNode(string value, string? deserializeRootElementName) - { - return DeserializeXmlNode(value, deserializeRootElementName, false); - } - - /// - /// Deserializes the from a JSON string nested in a root element specified by - /// and writes a Json.NET array attribute for collections. - /// - /// The JSON string. - /// The name of the root element to append when deserializing. - /// - /// A value to indicate whether to write the Json.NET array attribute. - /// This attribute helps preserve arrays when converting the written XML back to JSON. - /// - /// The deserialized . - public static XmlDocument? DeserializeXmlNode(string value, string? deserializeRootElementName, bool writeArrayAttribute) - { - return DeserializeXmlNode(value, deserializeRootElementName, writeArrayAttribute, false); - } - - /// - /// Deserializes the from a JSON string nested in a root element specified by , - /// writes a Json.NET array attribute for collections, and encodes special characters. - /// - /// The JSON string. - /// The name of the root element to append when deserializing. - /// - /// A value to indicate whether to write the Json.NET array attribute. - /// This attribute helps preserve arrays when converting the written XML back to JSON. - /// - /// - /// A value to indicate whether to encode special characters when converting JSON to XML. - /// If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify - /// XML namespaces, attributes or processing directives. Instead special characters are encoded and written - /// as part of the XML element name. - /// - /// The deserialized . - public static XmlDocument? DeserializeXmlNode(string value, string? deserializeRootElementName, bool writeArrayAttribute, bool encodeSpecialCharacters) - { - XmlNodeConverter converter = new XmlNodeConverter(); - converter.DeserializeRootElementName = deserializeRootElementName; - converter.WriteArrayAttribute = writeArrayAttribute; - converter.EncodeSpecialCharacters = encodeSpecialCharacters; - - return (XmlDocument?)DeserializeObject(value, typeof(XmlDocument), converter); - } -#endif - -#if HAVE_XLINQ - /// - /// Serializes the to a JSON string. - /// - /// The node to convert to JSON. - /// A JSON string of the . - public static string SerializeXNode(XObject? node) - { - return SerializeXNode(node, Formatting.None); - } - - /// - /// Serializes the to a JSON string using formatting. - /// - /// The node to convert to JSON. - /// Indicates how the output should be formatted. - /// A JSON string of the . - public static string SerializeXNode(XObject? node, Formatting formatting) - { - return SerializeXNode(node, formatting, false); - } - - /// - /// Serializes the to a JSON string using formatting and omits the root object if is true. - /// - /// The node to serialize. - /// Indicates how the output should be formatted. - /// Omits writing the root object. - /// A JSON string of the . - public static string SerializeXNode(XObject? node, Formatting formatting, bool omitRootObject) - { - XmlNodeConverter converter = new XmlNodeConverter { OmitRootObject = omitRootObject }; - - return SerializeObject(node, formatting, converter); - } - - /// - /// Deserializes the from a JSON string. - /// - /// The JSON string. - /// The deserialized . - public static XDocument? DeserializeXNode(string value) - { - return DeserializeXNode(value, null); - } - - /// - /// Deserializes the from a JSON string nested in a root element specified by . - /// - /// The JSON string. - /// The name of the root element to append when deserializing. - /// The deserialized . - public static XDocument? DeserializeXNode(string value, string? deserializeRootElementName) - { - return DeserializeXNode(value, deserializeRootElementName, false); - } - - /// - /// Deserializes the from a JSON string nested in a root element specified by - /// and writes a Json.NET array attribute for collections. - /// - /// The JSON string. - /// The name of the root element to append when deserializing. - /// - /// A value to indicate whether to write the Json.NET array attribute. - /// This attribute helps preserve arrays when converting the written XML back to JSON. - /// - /// The deserialized . - public static XDocument? DeserializeXNode(string value, string? deserializeRootElementName, bool writeArrayAttribute) - { - return DeserializeXNode(value, deserializeRootElementName, writeArrayAttribute, false); - } - - /// - /// Deserializes the from a JSON string nested in a root element specified by , - /// writes a Json.NET array attribute for collections, and encodes special characters. - /// - /// The JSON string. - /// The name of the root element to append when deserializing. - /// - /// A value to indicate whether to write the Json.NET array attribute. - /// This attribute helps preserve arrays when converting the written XML back to JSON. - /// - /// - /// A value to indicate whether to encode special characters when converting JSON to XML. - /// If true, special characters like ':', '@', '?', '#' and '$' in JSON property names aren't used to specify - /// XML namespaces, attributes or processing directives. Instead special characters are encoded and written - /// as part of the XML element name. - /// - /// The deserialized . - public static XDocument? DeserializeXNode(string value, string? deserializeRootElementName, bool writeArrayAttribute, bool encodeSpecialCharacters) - { - XmlNodeConverter converter = new XmlNodeConverter(); - converter.DeserializeRootElementName = deserializeRootElementName; - converter.WriteArrayAttribute = writeArrayAttribute; - converter.EncodeSpecialCharacters = encodeSpecialCharacters; - - return (XDocument?)DeserializeObject(value, typeof(XDocument), converter); - } -#endif - #endregion - } -} diff --git a/Source/MyDb/Newtonsoft.Json/JsonConverter.cs b/Source/MyDb/Newtonsoft.Json/JsonConverter.cs deleted file mode 100644 index 2c04a09..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonConverter.cs +++ /dev/null @@ -1,149 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Utilities; -using System.Globalization; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; - -namespace Newtonsoft.Json -{ - /// - /// Converts an object to and from JSON. - /// - public abstract class JsonConverter - { - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public abstract void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer); - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public abstract object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer); - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public abstract bool CanConvert(Type objectType); - - /// - /// Gets a value indicating whether this can read JSON. - /// - /// true if this can read JSON; otherwise, false. - public virtual bool CanRead => true; - - /// - /// Gets a value indicating whether this can write JSON. - /// - /// true if this can write JSON; otherwise, false. - public virtual bool CanWrite => true; - } - - /// - /// Converts an object to and from JSON. - /// - /// The object type to convert. - public abstract class JsonConverter : JsonConverter - { - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public sealed override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer) - { - if (!(value != null ? value is T : ReflectionUtils.IsNullable(typeof(T)))) - { - throw new JsonSerializationException("Converter cannot write specified value to JSON. {0} is required.".FormatWith(CultureInfo.InvariantCulture, typeof(T))); - } - WriteJson(writer, (T?)value, serializer); - } - - /// - /// Writes the JSON representation of the object. - /// - /// The to write to. - /// The value. - /// The calling serializer. - public abstract void WriteJson(JsonWriter writer, T? value, JsonSerializer serializer); - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. - /// The calling serializer. - /// The object value. - public sealed override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer) - { - bool existingIsNull = existingValue == null; - if (!(existingIsNull || existingValue is T)) - { - throw new JsonSerializationException("Converter cannot read JSON with the specified existing value. {0} is required.".FormatWith(CultureInfo.InvariantCulture, typeof(T))); - } - return ReadJson(reader, objectType, existingIsNull ? default : (T?)existingValue, !existingIsNull, serializer); - } - - /// - /// Reads the JSON representation of the object. - /// - /// The to read from. - /// Type of the object. - /// The existing value of object being read. If there is no existing value then null will be used. - /// The existing value has a value. - /// The calling serializer. - /// The object value. - public abstract T? ReadJson(JsonReader reader, Type objectType, T? existingValue, bool hasExistingValue, JsonSerializer serializer); - - /// - /// Determines whether this instance can convert the specified object type. - /// - /// Type of the object. - /// - /// true if this instance can convert the specified object type; otherwise, false. - /// - public sealed override bool CanConvert(Type objectType) - { - return typeof(T).IsAssignableFrom(objectType); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonConverterAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonConverterAttribute.cs deleted file mode 100644 index a5f071e..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonConverterAttribute.cs +++ /dev/null @@ -1,77 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Utilities; -using System.Globalization; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the to use the specified when serializing the member or class. - /// - [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Interface | AttributeTargets.Enum | AttributeTargets.Parameter, AllowMultiple = false)] - public sealed class JsonConverterAttribute : Attribute - { - private readonly Type _converterType; - - /// - /// Gets the of the . - /// - /// The of the . - public Type ConverterType => _converterType; - - /// - /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// - public object[]? ConverterParameters { get; } - - /// - /// Initializes a new instance of the class. - /// - /// Type of the . - public JsonConverterAttribute(Type converterType) - { - if (converterType == null) - { - throw new ArgumentNullException(nameof(converterType)); - } - - _converterType = converterType; - } - - /// - /// Initializes a new instance of the class. - /// - /// Type of the . - /// Parameter list to use when constructing the . Can be null. - public JsonConverterAttribute(Type converterType, params object[] converterParameters) - : this(converterType) - { - ConverterParameters = converterParameters; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonConverterCollection.cs b/Source/MyDb/Newtonsoft.Json/JsonConverterCollection.cs deleted file mode 100644 index b2c0492..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonConverterCollection.cs +++ /dev/null @@ -1,39 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; -using System.Collections.ObjectModel; - -namespace Newtonsoft.Json -{ - /// - /// Represents a collection of . - /// - public class JsonConverterCollection : Collection - { - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonDictionaryAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonDictionaryAttribute.cs deleted file mode 100644 index 7ddf411..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonDictionaryAttribute.cs +++ /dev/null @@ -1,52 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the how to serialize the collection. - /// - [AttributeUsage(AttributeTargets.Class | AttributeTargets.Interface, AllowMultiple = false)] - public sealed class JsonDictionaryAttribute : JsonContainerAttribute - { - /// - /// Initializes a new instance of the class. - /// - public JsonDictionaryAttribute() - { - } - - /// - /// Initializes a new instance of the class with the specified container Id. - /// - /// The container Id. - public JsonDictionaryAttribute(string id) - : base(id) - { - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonException.cs b/Source/MyDb/Newtonsoft.Json/JsonException.cs deleted file mode 100644 index 603a781..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonException.cs +++ /dev/null @@ -1,92 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; -using System.Runtime.Serialization; -using System.Text; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json -{ - /// - /// The exception thrown when an error occurs during JSON serialization or deserialization. - /// -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - [Serializable] -#endif - public class JsonException : Exception - { - /// - /// Initializes a new instance of the class. - /// - public JsonException() - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message. - /// - /// The error message that explains the reason for the exception. - public JsonException(string message) - : base(message) - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message and a reference to the inner exception that is the cause of this exception. - /// - /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or null if no inner exception is specified. - public JsonException(string message, Exception? innerException) - : base(message, innerException) - { - } - -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - /// - /// Initializes a new instance of the class. - /// - /// The that holds the serialized object data about the exception being thrown. - /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). - public JsonException(SerializationInfo info, StreamingContext context) - : base(info, context) - { - } -#endif - - internal static JsonException Create(IJsonLineInfo lineInfo, string path, string message) - { - message = JsonPosition.FormatMessage(lineInfo, path, message); - - return new JsonException(message); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonExtensionDataAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonExtensionDataAttribute.cs deleted file mode 100644 index 6bc15b7..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonExtensionDataAttribute.cs +++ /dev/null @@ -1,37 +0,0 @@ -using System; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the to deserialize properties with no matching class member into the specified collection - /// and write values during serialization. - /// - [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property, AllowMultiple = false)] - public class JsonExtensionDataAttribute : Attribute - { - /// - /// Gets or sets a value that indicates whether to write extension data when serializing the object. - /// - /// - /// true to write extension data when serializing the object; otherwise, false. The default is true. - /// - public bool WriteData { get; set; } - - /// - /// Gets or sets a value that indicates whether to read extension data when deserializing the object. - /// - /// - /// true to read extension data when deserializing the object; otherwise, false. The default is true. - /// - public bool ReadData { get; set; } - - /// - /// Initializes a new instance of the class. - /// - public JsonExtensionDataAttribute() - { - WriteData = true; - ReadData = true; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonIgnoreAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonIgnoreAttribute.cs deleted file mode 100644 index 8229299..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonIgnoreAttribute.cs +++ /dev/null @@ -1,39 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the not to serialize the public field or public read/write property value. - /// - [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property, AllowMultiple = false)] - public sealed class JsonIgnoreAttribute : Attribute - { - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonNameTable.cs b/Source/MyDb/Newtonsoft.Json/JsonNameTable.cs deleted file mode 100644 index 1f2d243..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonNameTable.cs +++ /dev/null @@ -1,17 +0,0 @@ -namespace Newtonsoft.Json -{ - /// - /// Base class for a table of atomized string objects. - /// - public abstract class JsonNameTable - { - /// - /// Gets a string containing the same characters as the specified range of characters in the given array. - /// - /// The character array containing the name to find. - /// The zero-based index into the array specifying the first character of the name. - /// The number of characters in the name. - /// A string containing the same characters as the specified range of characters in the given array. - public abstract string? Get(char[] key, int start, int length); - } -} diff --git a/Source/MyDb/Newtonsoft.Json/JsonObjectAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonObjectAttribute.cs deleted file mode 100644 index 4ad8a7a..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonObjectAttribute.cs +++ /dev/null @@ -1,111 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the how to serialize the object. - /// - [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Interface, AllowMultiple = false)] - public sealed class JsonObjectAttribute : JsonContainerAttribute - { - private MemberSerialization _memberSerialization = MemberSerialization.OptOut; - internal MissingMemberHandling? _missingMemberHandling; - - // yuck. can't set nullable properties on an attribute in C# - // have to use this approach to get an unset default state - internal Required? _itemRequired; - internal NullValueHandling? _itemNullValueHandling; - - /// - /// Gets or sets the member serialization. - /// - /// The member serialization. - public MemberSerialization MemberSerialization - { - get => _memberSerialization; - set => _memberSerialization = value; - } - - /// - /// Gets or sets the missing member handling used when deserializing this object. - /// - /// The missing member handling. - public MissingMemberHandling MissingMemberHandling - { - get => _missingMemberHandling ?? default; - set => _missingMemberHandling = value; - } - - /// - /// Gets or sets how the object's properties with null values are handled during serialization and deserialization. - /// - /// How the object's properties with null values are handled during serialization and deserialization. - public NullValueHandling ItemNullValueHandling - { - get => _itemNullValueHandling ?? default; - set => _itemNullValueHandling = value; - } - - /// - /// Gets or sets a value that indicates whether the object's properties are required. - /// - /// - /// A value indicating whether the object's properties are required. - /// - public Required ItemRequired - { - get => _itemRequired ?? default; - set => _itemRequired = value; - } - - /// - /// Initializes a new instance of the class. - /// - public JsonObjectAttribute() - { - } - - /// - /// Initializes a new instance of the class with the specified member serialization. - /// - /// The member serialization. - public JsonObjectAttribute(MemberSerialization memberSerialization) - { - MemberSerialization = memberSerialization; - } - - /// - /// Initializes a new instance of the class with the specified container Id. - /// - /// The container Id. - public JsonObjectAttribute(string id) - : base(id) - { - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonPosition.cs b/Source/MyDb/Newtonsoft.Json/JsonPosition.cs deleted file mode 100644 index 92a6234..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonPosition.cs +++ /dev/null @@ -1,177 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; -using System.IO; -using System.Text; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json -{ - internal enum JsonContainerType - { - None = 0, - Object = 1, - Array = 2, - Constructor = 3 - } - - internal struct JsonPosition - { - private static readonly char[] SpecialCharacters = { '.', ' ', '\'', '/', '"', '[', ']', '(', ')', '\t', '\n', '\r', '\f', '\b', '\\', '\u0085', '\u2028', '\u2029' }; - - internal JsonContainerType Type; - internal int Position; - internal string? PropertyName; - internal bool HasIndex; - - public JsonPosition(JsonContainerType type) - { - Type = type; - HasIndex = TypeHasIndex(type); - Position = -1; - PropertyName = null; - } - - internal int CalculateLength() - { - switch (Type) - { - case JsonContainerType.Object: - return PropertyName!.Length + 5; - case JsonContainerType.Array: - case JsonContainerType.Constructor: - return MathUtils.IntLength((ulong)Position) + 2; - default: - throw new ArgumentOutOfRangeException(nameof(Type)); - } - } - - internal void WriteTo(StringBuilder sb, ref StringWriter? writer, ref char[]? buffer) - { - switch (Type) - { - case JsonContainerType.Object: - string propertyName = PropertyName!; - if (propertyName.IndexOfAny(SpecialCharacters) != -1) - { - sb.Append(@"['"); - - if (writer == null) - { - writer = new StringWriter(sb); - } - - JavaScriptUtils.WriteEscapedJavaScriptString(writer, propertyName, '\'', false, JavaScriptUtils.SingleQuoteCharEscapeFlags, StringEscapeHandling.Default, null, ref buffer); - - sb.Append(@"']"); - } - else - { - if (sb.Length > 0) - { - sb.Append('.'); - } - - sb.Append(propertyName); - } - break; - case JsonContainerType.Array: - case JsonContainerType.Constructor: - sb.Append('['); - sb.Append(Position); - sb.Append(']'); - break; - } - } - - internal static bool TypeHasIndex(JsonContainerType type) - { - return (type == JsonContainerType.Array || type == JsonContainerType.Constructor); - } - - internal static string BuildPath(List positions, JsonPosition? currentPosition) - { - int capacity = 0; - if (positions != null) - { - for (int i = 0; i < positions.Count; i++) - { - capacity += positions[i].CalculateLength(); - } - } - if (currentPosition != null) - { - capacity += currentPosition.GetValueOrDefault().CalculateLength(); - } - - StringBuilder sb = new StringBuilder(capacity); - StringWriter? writer = null; - char[]? buffer = null; - if (positions != null) - { - foreach (JsonPosition state in positions) - { - state.WriteTo(sb, ref writer, ref buffer); - } - } - if (currentPosition != null) - { - currentPosition.GetValueOrDefault().WriteTo(sb, ref writer, ref buffer); - } - - return sb.ToString(); - } - - internal static string FormatMessage(IJsonLineInfo? lineInfo, string path, string message) - { - // don't add a fullstop and space when message ends with a new line - if (!message.EndsWith(Environment.NewLine, StringComparison.Ordinal)) - { - message = message.Trim(); - - if (!message.EndsWith('.')) - { - message += "."; - } - - message += " "; - } - - message += "Path '{0}'".FormatWith(CultureInfo.InvariantCulture, path); - - if (lineInfo != null && lineInfo.HasLineInfo()) - { - message += ", line {0}, position {1}".FormatWith(CultureInfo.InvariantCulture, lineInfo.LineNumber, lineInfo.LinePosition); - } - - message += "."; - - return message; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonPropertyAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonPropertyAttribute.cs deleted file mode 100644 index 7ad0538..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonPropertyAttribute.cs +++ /dev/null @@ -1,223 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the to always serialize the member with the specified name. - /// - [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property | AttributeTargets.Parameter, AllowMultiple = false)] - public sealed class JsonPropertyAttribute : Attribute - { - // yuck. can't set nullable properties on an attribute in C# - // have to use this approach to get an unset default state - internal NullValueHandling? _nullValueHandling; - internal DefaultValueHandling? _defaultValueHandling; - internal ReferenceLoopHandling? _referenceLoopHandling; - internal ObjectCreationHandling? _objectCreationHandling; - internal TypeNameHandling? _typeNameHandling; - internal bool? _isReference; - internal int? _order; - internal Required? _required; - internal bool? _itemIsReference; - internal ReferenceLoopHandling? _itemReferenceLoopHandling; - internal TypeNameHandling? _itemTypeNameHandling; - - /// - /// Gets or sets the type used when serializing the property's collection items. - /// - /// The collection's items type. - public Type? ItemConverterType { get; set; } - - /// - /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, - /// order, and type of these parameters. - /// - /// - /// - /// [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] - /// - /// - public object[]? ItemConverterParameters { get; set; } - - /// - /// Gets or sets the of the . - /// - /// The of the . - public Type? NamingStrategyType { get; set; } - - /// - /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, - /// order, and type of these parameters. - /// - /// - /// - /// [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] - /// - /// - public object[]? NamingStrategyParameters { get; set; } - - /// - /// Gets or sets the null value handling used when serializing this property. - /// - /// The null value handling. - public NullValueHandling NullValueHandling - { - get => _nullValueHandling ?? default; - set => _nullValueHandling = value; - } - - /// - /// Gets or sets the default value handling used when serializing this property. - /// - /// The default value handling. - public DefaultValueHandling DefaultValueHandling - { - get => _defaultValueHandling ?? default; - set => _defaultValueHandling = value; - } - - /// - /// Gets or sets the reference loop handling used when serializing this property. - /// - /// The reference loop handling. - public ReferenceLoopHandling ReferenceLoopHandling - { - get => _referenceLoopHandling ?? default; - set => _referenceLoopHandling = value; - } - - /// - /// Gets or sets the object creation handling used when deserializing this property. - /// - /// The object creation handling. - public ObjectCreationHandling ObjectCreationHandling - { - get => _objectCreationHandling ?? default; - set => _objectCreationHandling = value; - } - - /// - /// Gets or sets the type name handling used when serializing this property. - /// - /// The type name handling. - public TypeNameHandling TypeNameHandling - { - get => _typeNameHandling ?? default; - set => _typeNameHandling = value; - } - - /// - /// Gets or sets whether this property's value is serialized as a reference. - /// - /// Whether this property's value is serialized as a reference. - public bool IsReference - { - get => _isReference ?? default; - set => _isReference = value; - } - - /// - /// Gets or sets the order of serialization of a member. - /// - /// The numeric order of serialization. - public int Order - { - get => _order ?? default; - set => _order = value; - } - - /// - /// Gets or sets a value indicating whether this property is required. - /// - /// - /// A value indicating whether this property is required. - /// - public Required Required - { - get => _required ?? Required.Default; - set => _required = value; - } - - /// - /// Gets or sets the name of the property. - /// - /// The name of the property. - public string? PropertyName { get; set; } - - /// - /// Gets or sets the reference loop handling used when serializing the property's collection items. - /// - /// The collection's items reference loop handling. - public ReferenceLoopHandling ItemReferenceLoopHandling - { - get => _itemReferenceLoopHandling ?? default; - set => _itemReferenceLoopHandling = value; - } - - /// - /// Gets or sets the type name handling used when serializing the property's collection items. - /// - /// The collection's items type name handling. - public TypeNameHandling ItemTypeNameHandling - { - get => _itemTypeNameHandling ?? default; - set => _itemTypeNameHandling = value; - } - - /// - /// Gets or sets whether this property's collection items are serialized as a reference. - /// - /// Whether this property's collection items are serialized as a reference. - public bool ItemIsReference - { - get => _itemIsReference ?? default; - set => _itemIsReference = value; - } - - /// - /// Initializes a new instance of the class. - /// - public JsonPropertyAttribute() - { - } - - /// - /// Initializes a new instance of the class with the specified name. - /// - /// Name of the property. - public JsonPropertyAttribute(string propertyName) - { - PropertyName = propertyName; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonReader.Async.cs b/Source/MyDb/Newtonsoft.Json/JsonReader.Async.cs deleted file mode 100644 index 024903e..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonReader.Async.cs +++ /dev/null @@ -1,246 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System; -using System.Collections.Generic; -using System.Threading; -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json -{ - public abstract partial class JsonReader - { - /// - /// Asynchronously reads the next JSON token from the source. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns true if the next token was read successfully; false if there are no more tokens to read. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task ReadAsync(CancellationToken cancellationToken = default) - { - return cancellationToken.CancelIfRequestedAsync() ?? Read().ToAsync(); - } - - /// - /// Asynchronously skips the children of the current token. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public async Task SkipAsync(CancellationToken cancellationToken = default) - { - if (TokenType == JsonToken.PropertyName) - { - await ReadAsync(cancellationToken).ConfigureAwait(false); - } - - if (JsonTokenUtils.IsStartToken(TokenType)) - { - int depth = Depth; - - while (await ReadAsync(cancellationToken).ConfigureAwait(false) && depth < Depth) - { - } - } - } - - internal async Task ReaderReadAndAssertAsync(CancellationToken cancellationToken) - { - if (!await ReadAsync(cancellationToken).ConfigureAwait(false)) - { - throw CreateUnexpectedEndException(); - } - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task ReadAsBooleanAsync(CancellationToken cancellationToken = default) - { - return cancellationToken.CancelIfRequestedAsync() ?? Task.FromResult(ReadAsBoolean()); - } - - /// - /// Asynchronously reads the next JSON token from the source as a []. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the []. This result will be null at the end of an array. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task ReadAsBytesAsync(CancellationToken cancellationToken = default) - { - return cancellationToken.CancelIfRequestedAsync() ?? Task.FromResult(ReadAsBytes()); - } - - internal async Task ReadArrayIntoByteArrayAsync(CancellationToken cancellationToken) - { - List buffer = new List(); - - while (true) - { - if (!await ReadAsync(cancellationToken).ConfigureAwait(false)) - { - SetToken(JsonToken.None); - } - - if (ReadArrayElementIntoByteArrayReportDone(buffer)) - { - byte[] d = buffer.ToArray(); - SetToken(JsonToken.Bytes, d, false); - return d; - } - } - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task ReadAsDateTimeAsync(CancellationToken cancellationToken = default) - { - return cancellationToken.CancelIfRequestedAsync() ?? Task.FromResult(ReadAsDateTime()); - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task ReadAsDateTimeOffsetAsync(CancellationToken cancellationToken = default) - { - return cancellationToken.CancelIfRequestedAsync() ?? Task.FromResult(ReadAsDateTimeOffset()); - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task ReadAsDecimalAsync(CancellationToken cancellationToken = default) - { - return cancellationToken.CancelIfRequestedAsync() ?? Task.FromResult(ReadAsDecimal()); - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task ReadAsDoubleAsync(CancellationToken cancellationToken = default) - { - return Task.FromResult(ReadAsDouble()); - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task ReadAsInt32Async(CancellationToken cancellationToken = default) - { - return cancellationToken.CancelIfRequestedAsync() ?? Task.FromResult(ReadAsInt32()); - } - - /// - /// Asynchronously reads the next JSON token from the source as a . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the . This result will be null at the end of an array. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task ReadAsStringAsync(CancellationToken cancellationToken = default) - { - return cancellationToken.CancelIfRequestedAsync() ?? Task.FromResult(ReadAsString()); - } - - internal async Task ReadAndMoveToContentAsync(CancellationToken cancellationToken) - { - return await ReadAsync(cancellationToken).ConfigureAwait(false) && await MoveToContentAsync(cancellationToken).ConfigureAwait(false); - } - - internal Task MoveToContentAsync(CancellationToken cancellationToken) - { - switch (TokenType) - { - case JsonToken.None: - case JsonToken.Comment: - return MoveToContentFromNonContentAsync(cancellationToken); - default: - return AsyncUtils.True; - } - } - - private async Task MoveToContentFromNonContentAsync(CancellationToken cancellationToken) - { - while (true) - { - if (!await ReadAsync(cancellationToken).ConfigureAwait(false)) - { - return false; - } - - switch (TokenType) - { - case JsonToken.None: - case JsonToken.Comment: - break; - default: - return true; - } - } - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/JsonReader.cs b/Source/MyDb/Newtonsoft.Json/JsonReader.cs deleted file mode 100644 index 2351b18..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonReader.cs +++ /dev/null @@ -1,1278 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.IO; -using System.Globalization; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using Newtonsoft.Json.Serialization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json -{ - /// - /// Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. - /// - public abstract partial class JsonReader : IDisposable - { - /// - /// Specifies the state of the reader. - /// - protected internal enum State - { - /// - /// A read method has not been called. - /// - Start, - - /// - /// The end of the file has been reached successfully. - /// - Complete, - - /// - /// Reader is at a property. - /// - Property, - - /// - /// Reader is at the start of an object. - /// - ObjectStart, - - /// - /// Reader is in an object. - /// - Object, - - /// - /// Reader is at the start of an array. - /// - ArrayStart, - - /// - /// Reader is in an array. - /// - Array, - - /// - /// The method has been called. - /// - Closed, - - /// - /// Reader has just read a value. - /// - PostValue, - - /// - /// Reader is at the start of a constructor. - /// - ConstructorStart, - - /// - /// Reader is in a constructor. - /// - Constructor, - - /// - /// An error occurred that prevents the read operation from continuing. - /// - Error, - - /// - /// The end of the file has been reached successfully. - /// - Finished - } - - // current Token data - private JsonToken _tokenType; - private object? _value; - internal char _quoteChar; - internal State _currentState; - private JsonPosition _currentPosition; - private CultureInfo? _culture; - private DateTimeZoneHandling _dateTimeZoneHandling; - private int? _maxDepth; - private bool _hasExceededMaxDepth; - internal DateParseHandling _dateParseHandling; - internal FloatParseHandling _floatParseHandling; - private string? _dateFormatString; - private List? _stack; - - /// - /// Gets the current reader state. - /// - /// The current reader state. - protected State CurrentState => _currentState; - - /// - /// Gets or sets a value indicating whether the source should be closed when this reader is closed. - /// - /// - /// true to close the source when this reader is closed; otherwise false. The default is true. - /// - public bool CloseInput { get; set; } - - /// - /// Gets or sets a value indicating whether multiple pieces of JSON content can - /// be read from a continuous stream without erroring. - /// - /// - /// true to support reading multiple pieces of JSON content; otherwise false. - /// The default is false. - /// - public bool SupportMultipleContent { get; set; } - - /// - /// Gets the quotation mark character used to enclose the value of a string. - /// - public virtual char QuoteChar - { - get => _quoteChar; - protected internal set => _quoteChar = value; - } - - /// - /// Gets or sets how time zones are handled when reading JSON. - /// - public DateTimeZoneHandling DateTimeZoneHandling - { - get => _dateTimeZoneHandling; - set - { - if (value < DateTimeZoneHandling.Local || value > DateTimeZoneHandling.RoundtripKind) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _dateTimeZoneHandling = value; - } - } - - /// - /// Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - /// - public DateParseHandling DateParseHandling - { - get => _dateParseHandling; - set - { - if (value < DateParseHandling.None || -#if HAVE_DATE_TIME_OFFSET - value > DateParseHandling.DateTimeOffset -#else - value > DateParseHandling.DateTime -#endif - ) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _dateParseHandling = value; - } - } - - /// - /// Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - /// - public FloatParseHandling FloatParseHandling - { - get => _floatParseHandling; - set - { - if (value < FloatParseHandling.Double || value > FloatParseHandling.Decimal) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _floatParseHandling = value; - } - } - - /// - /// Gets or sets how custom date formatted strings are parsed when reading JSON. - /// - public string? DateFormatString - { - get => _dateFormatString; - set => _dateFormatString = value; - } - - /// - /// Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . - /// A null value means there is no maximum. - /// The default value is 64. - /// - public int? MaxDepth - { - get => _maxDepth; - set - { - if (value <= 0) - { - throw new ArgumentException("Value must be positive.", nameof(value)); - } - - _maxDepth = value; - } - } - - /// - /// Gets the type of the current JSON token. - /// - public virtual JsonToken TokenType => _tokenType; - - /// - /// Gets the text value of the current JSON token. - /// - public virtual object? Value => _value; - - /// - /// Gets the .NET type for the current JSON token. - /// - public virtual Type? ValueType => _value?.GetType(); - - /// - /// Gets the depth of the current token in the JSON document. - /// - /// The depth of the current token in the JSON document. - public virtual int Depth - { - get - { - int depth = _stack?.Count ?? 0; - if (JsonTokenUtils.IsStartToken(TokenType) || _currentPosition.Type == JsonContainerType.None) - { - return depth; - } - else - { - return depth + 1; - } - } - } - - /// - /// Gets the path of the current JSON token. - /// - public virtual string Path - { - get - { - if (_currentPosition.Type == JsonContainerType.None) - { - return string.Empty; - } - - bool insideContainer = (_currentState != State.ArrayStart - && _currentState != State.ConstructorStart - && _currentState != State.ObjectStart); - - JsonPosition? current = insideContainer ? (JsonPosition?)_currentPosition : null; - - return JsonPosition.BuildPath(_stack!, current); - } - } - - /// - /// Gets or sets the culture used when reading JSON. Defaults to . - /// - public CultureInfo Culture - { - get => _culture ?? CultureInfo.InvariantCulture; - set => _culture = value; - } - - internal JsonPosition GetPosition(int depth) - { - if (_stack != null && depth < _stack.Count) - { - return _stack[depth]; - } - - return _currentPosition; - } - - /// - /// Initializes a new instance of the class. - /// - protected JsonReader() - { - _currentState = State.Start; - _dateTimeZoneHandling = DateTimeZoneHandling.RoundtripKind; - _dateParseHandling = DateParseHandling.DateTime; - _floatParseHandling = FloatParseHandling.Double; - _maxDepth = 64; - - CloseInput = true; - } - - private void Push(JsonContainerType value) - { - UpdateScopeWithFinishedValue(); - - if (_currentPosition.Type == JsonContainerType.None) - { - _currentPosition = new JsonPosition(value); - } - else - { - if (_stack == null) - { - _stack = new List(); - } - - _stack.Add(_currentPosition); - _currentPosition = new JsonPosition(value); - - // this is a little hacky because Depth increases when first property/value is written but only testing here is faster/simpler - if (_maxDepth != null && Depth + 1 > _maxDepth && !_hasExceededMaxDepth) - { - _hasExceededMaxDepth = true; - throw JsonReaderException.Create(this, "The reader's MaxDepth of {0} has been exceeded.".FormatWith(CultureInfo.InvariantCulture, _maxDepth)); - } - } - } - - private JsonContainerType Pop() - { - JsonPosition oldPosition; - if (_stack != null && _stack.Count > 0) - { - oldPosition = _currentPosition; - _currentPosition = _stack[_stack.Count - 1]; - _stack.RemoveAt(_stack.Count - 1); - } - else - { - oldPosition = _currentPosition; - _currentPosition = new JsonPosition(); - } - - if (_maxDepth != null && Depth <= _maxDepth) - { - _hasExceededMaxDepth = false; - } - - return oldPosition.Type; - } - - private JsonContainerType Peek() - { - return _currentPosition.Type; - } - - /// - /// Reads the next JSON token from the source. - /// - /// true if the next token was read successfully; false if there are no more tokens to read. - public abstract bool Read(); - - /// - /// Reads the next JSON token from the source as a of . - /// - /// A of . This method will return null at the end of an array. - public virtual int? ReadAsInt32() - { - JsonToken t = GetContentToken(); - - switch (t) - { - case JsonToken.None: - case JsonToken.Null: - case JsonToken.EndArray: - return null; - case JsonToken.Integer: - case JsonToken.Float: - object v = Value!; - if (v is int i) - { - return i; - } - -#if HAVE_BIG_INTEGER - if (v is BigInteger value) - { - i = (int)value; - } - else -#endif - { - try - { - i = Convert.ToInt32(v, CultureInfo.InvariantCulture); - } - catch (Exception ex) - { - // handle error for large integer overflow exceptions - throw JsonReaderException.Create(this, "Could not convert to integer: {0}.".FormatWith(CultureInfo.InvariantCulture, v), ex); - } - } - - SetToken(JsonToken.Integer, i, false); - return i; - case JsonToken.String: - string? s = (string?)Value; - return ReadInt32String(s); - } - - throw JsonReaderException.Create(this, "Error reading integer. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, t)); - } - - internal int? ReadInt32String(string? s) - { - if (StringUtils.IsNullOrEmpty(s)) - { - SetToken(JsonToken.Null, null, false); - return null; - } - - if (int.TryParse(s, NumberStyles.Integer, Culture, out int i)) - { - SetToken(JsonToken.Integer, i, false); - return i; - } - else - { - SetToken(JsonToken.String, s, false); - throw JsonReaderException.Create(this, "Could not convert string to integer: {0}.".FormatWith(CultureInfo.InvariantCulture, s)); - } - } - - /// - /// Reads the next JSON token from the source as a . - /// - /// A . This method will return null at the end of an array. - public virtual string? ReadAsString() - { - JsonToken t = GetContentToken(); - - switch (t) - { - case JsonToken.None: - case JsonToken.Null: - case JsonToken.EndArray: - return null; - case JsonToken.String: - return (string?)Value; - } - - if (JsonTokenUtils.IsPrimitiveToken(t)) - { - object? v = Value; - if (v != null) - { - string s; - if (v is IFormattable formattable) - { - s = formattable.ToString(null, Culture); - } - else - { - s = v is Uri uri ? uri.OriginalString : v.ToString(); - } - - SetToken(JsonToken.String, s, false); - return s; - } - } - - throw JsonReaderException.Create(this, "Error reading string. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, t)); - } - - /// - /// Reads the next JSON token from the source as a []. - /// - /// A [] or null if the next JSON token is null. This method will return null at the end of an array. - public virtual byte[]? ReadAsBytes() - { - JsonToken t = GetContentToken(); - - switch (t) - { - case JsonToken.StartObject: - { - ReadIntoWrappedTypeObject(); - - byte[]? data = ReadAsBytes(); - ReaderReadAndAssert(); - - if (TokenType != JsonToken.EndObject) - { - throw JsonReaderException.Create(this, "Error reading bytes. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, TokenType)); - } - - SetToken(JsonToken.Bytes, data, false); - return data; - } - case JsonToken.String: - { - // attempt to convert possible base 64 or GUID string to bytes - // GUID has to have format 00000000-0000-0000-0000-000000000000 - string s = (string)Value!; - - byte[] data; - - if (s.Length == 0) - { - data = CollectionUtils.ArrayEmpty(); - } - else if (ConvertUtils.TryConvertGuid(s, out Guid g1)) - { - data = g1.ToByteArray(); - } - else - { - data = Convert.FromBase64String(s); - } - - SetToken(JsonToken.Bytes, data, false); - return data; - } - case JsonToken.None: - case JsonToken.Null: - case JsonToken.EndArray: - return null; - case JsonToken.Bytes: - if (Value is Guid g2) - { - byte[] data = g2.ToByteArray(); - SetToken(JsonToken.Bytes, data, false); - return data; - } - - return (byte[]?)Value; - case JsonToken.StartArray: - return ReadArrayIntoByteArray(); - } - - throw JsonReaderException.Create(this, "Error reading bytes. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, t)); - } - - internal byte[] ReadArrayIntoByteArray() - { - List buffer = new List(); - - while (true) - { - if (!Read()) - { - SetToken(JsonToken.None); - } - - if (ReadArrayElementIntoByteArrayReportDone(buffer)) - { - byte[] d = buffer.ToArray(); - SetToken(JsonToken.Bytes, d, false); - return d; - } - } - } - - private bool ReadArrayElementIntoByteArrayReportDone(List buffer) - { - switch (TokenType) - { - case JsonToken.None: - throw JsonReaderException.Create(this, "Unexpected end when reading bytes."); - case JsonToken.Integer: - buffer.Add(Convert.ToByte(Value, CultureInfo.InvariantCulture)); - return false; - case JsonToken.EndArray: - return true; - case JsonToken.Comment: - return false; - default: - throw JsonReaderException.Create(this, "Unexpected token when reading bytes: {0}.".FormatWith(CultureInfo.InvariantCulture, TokenType)); - } - } - - /// - /// Reads the next JSON token from the source as a of . - /// - /// A of . This method will return null at the end of an array. - public virtual double? ReadAsDouble() - { - JsonToken t = GetContentToken(); - - switch (t) - { - case JsonToken.None: - case JsonToken.Null: - case JsonToken.EndArray: - return null; - case JsonToken.Integer: - case JsonToken.Float: - object v = Value!; - if (v is double d) - { - return d; - } - -#if HAVE_BIG_INTEGER - if (v is BigInteger value) - { - d = (double)value; - } - else -#endif - { - d = Convert.ToDouble(v, CultureInfo.InvariantCulture); - } - - SetToken(JsonToken.Float, d, false); - - return (double)d; - case JsonToken.String: - return ReadDoubleString((string?)Value); - } - - throw JsonReaderException.Create(this, "Error reading double. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, t)); - } - - internal double? ReadDoubleString(string? s) - { - if (StringUtils.IsNullOrEmpty(s)) - { - SetToken(JsonToken.Null, null, false); - return null; - } - - if (double.TryParse(s, NumberStyles.Float | NumberStyles.AllowThousands, Culture, out double d)) - { - SetToken(JsonToken.Float, d, false); - return d; - } - else - { - SetToken(JsonToken.String, s, false); - throw JsonReaderException.Create(this, "Could not convert string to double: {0}.".FormatWith(CultureInfo.InvariantCulture, s)); - } - } - - /// - /// Reads the next JSON token from the source as a of . - /// - /// A of . This method will return null at the end of an array. - public virtual bool? ReadAsBoolean() - { - JsonToken t = GetContentToken(); - - switch (t) - { - case JsonToken.None: - case JsonToken.Null: - case JsonToken.EndArray: - return null; - case JsonToken.Integer: - case JsonToken.Float: - bool b; -#if HAVE_BIG_INTEGER - if (Value is BigInteger integer) - { - b = integer != 0; - } - else -#endif - { - b = Convert.ToBoolean(Value, CultureInfo.InvariantCulture); - } - - SetToken(JsonToken.Boolean, b, false); - return b; - case JsonToken.String: - return ReadBooleanString((string?)Value); - case JsonToken.Boolean: - return (bool)Value!; - } - - throw JsonReaderException.Create(this, "Error reading boolean. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, t)); - } - - internal bool? ReadBooleanString(string? s) - { - if (StringUtils.IsNullOrEmpty(s)) - { - SetToken(JsonToken.Null, null, false); - return null; - } - - if (bool.TryParse(s, out bool b)) - { - SetToken(JsonToken.Boolean, b, false); - return b; - } - else - { - SetToken(JsonToken.String, s, false); - throw JsonReaderException.Create(this, "Could not convert string to boolean: {0}.".FormatWith(CultureInfo.InvariantCulture, s)); - } - } - - /// - /// Reads the next JSON token from the source as a of . - /// - /// A of . This method will return null at the end of an array. - public virtual decimal? ReadAsDecimal() - { - JsonToken t = GetContentToken(); - - switch (t) - { - case JsonToken.None: - case JsonToken.Null: - case JsonToken.EndArray: - return null; - case JsonToken.Integer: - case JsonToken.Float: - object v = Value!; - - if (v is decimal d) - { - return d; - } - -#if HAVE_BIG_INTEGER - if (v is BigInteger value) - { - d = (decimal)value; - } - else -#endif - { - try - { - d = Convert.ToDecimal(v, CultureInfo.InvariantCulture); - } - catch (Exception ex) - { - // handle error for large integer overflow exceptions - throw JsonReaderException.Create(this, "Could not convert to decimal: {0}.".FormatWith(CultureInfo.InvariantCulture, v), ex); - } - } - - SetToken(JsonToken.Float, d, false); - return d; - case JsonToken.String: - return ReadDecimalString((string?)Value); - } - - throw JsonReaderException.Create(this, "Error reading decimal. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, t)); - } - - internal decimal? ReadDecimalString(string? s) - { - if (StringUtils.IsNullOrEmpty(s)) - { - SetToken(JsonToken.Null, null, false); - return null; - } - - if (decimal.TryParse(s, NumberStyles.Number, Culture, out decimal d)) - { - SetToken(JsonToken.Float, d, false); - return d; - } - else if (ConvertUtils.DecimalTryParse(s.ToCharArray(), 0, s.Length, out d) == ParseResult.Success) - { - // This is to handle strings like "96.014e-05" that are not supported by traditional decimal.TryParse - SetToken(JsonToken.Float, d, false); - return d; - } - else - { - SetToken(JsonToken.String, s, false); - throw JsonReaderException.Create(this, "Could not convert string to decimal: {0}.".FormatWith(CultureInfo.InvariantCulture, s)); - } - } - - /// - /// Reads the next JSON token from the source as a of . - /// - /// A of . This method will return null at the end of an array. - public virtual DateTime? ReadAsDateTime() - { - switch (GetContentToken()) - { - case JsonToken.None: - case JsonToken.Null: - case JsonToken.EndArray: - return null; - case JsonToken.Date: -#if HAVE_DATE_TIME_OFFSET - if (Value is DateTimeOffset offset) - { - SetToken(JsonToken.Date, offset.DateTime, false); - } -#endif - - return (DateTime)Value!; - case JsonToken.String: - return ReadDateTimeString((string?)Value); - } - - throw JsonReaderException.Create(this, "Error reading date. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, TokenType)); - } - - internal DateTime? ReadDateTimeString(string? s) - { - if (StringUtils.IsNullOrEmpty(s)) - { - SetToken(JsonToken.Null, null, false); - return null; - } - - if (DateTimeUtils.TryParseDateTime(s, DateTimeZoneHandling, _dateFormatString, Culture, out DateTime dt)) - { - dt = DateTimeUtils.EnsureDateTime(dt, DateTimeZoneHandling); - SetToken(JsonToken.Date, dt, false); - return dt; - } - - if (DateTime.TryParse(s, Culture, DateTimeStyles.RoundtripKind, out dt)) - { - dt = DateTimeUtils.EnsureDateTime(dt, DateTimeZoneHandling); - SetToken(JsonToken.Date, dt, false); - return dt; - } - - throw JsonReaderException.Create(this, "Could not convert string to DateTime: {0}.".FormatWith(CultureInfo.InvariantCulture, s)); - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Reads the next JSON token from the source as a of . - /// - /// A of . This method will return null at the end of an array. - public virtual DateTimeOffset? ReadAsDateTimeOffset() - { - JsonToken t = GetContentToken(); - - switch (t) - { - case JsonToken.None: - case JsonToken.Null: - case JsonToken.EndArray: - return null; - case JsonToken.Date: - if (Value is DateTime time) - { - SetToken(JsonToken.Date, new DateTimeOffset(time), false); - } - - return (DateTimeOffset)Value!; - case JsonToken.String: - string? s = (string?)Value; - return ReadDateTimeOffsetString(s); - default: - throw JsonReaderException.Create(this, "Error reading date. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, t)); - } - } - - internal DateTimeOffset? ReadDateTimeOffsetString(string? s) - { - if (StringUtils.IsNullOrEmpty(s)) - { - SetToken(JsonToken.Null, null, false); - return null; - } - - if (DateTimeUtils.TryParseDateTimeOffset(s, _dateFormatString, Culture, out DateTimeOffset dt)) - { - SetToken(JsonToken.Date, dt, false); - return dt; - } - - if (DateTimeOffset.TryParse(s, Culture, DateTimeStyles.RoundtripKind, out dt)) - { - SetToken(JsonToken.Date, dt, false); - return dt; - } - - SetToken(JsonToken.String, s, false); - throw JsonReaderException.Create(this, "Could not convert string to DateTimeOffset: {0}.".FormatWith(CultureInfo.InvariantCulture, s)); - } -#endif - - internal void ReaderReadAndAssert() - { - if (!Read()) - { - throw CreateUnexpectedEndException(); - } - } - - internal JsonReaderException CreateUnexpectedEndException() - { - return JsonReaderException.Create(this, "Unexpected end when reading JSON."); - } - - internal void ReadIntoWrappedTypeObject() - { - ReaderReadAndAssert(); - if (Value != null && Value.ToString() == JsonTypeReflector.TypePropertyName) - { - ReaderReadAndAssert(); - if (Value != null && Value.ToString().StartsWith("System.Byte[]", StringComparison.Ordinal)) - { - ReaderReadAndAssert(); - if (Value.ToString() == JsonTypeReflector.ValuePropertyName) - { - return; - } - } - } - - throw JsonReaderException.Create(this, "Error reading bytes. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, JsonToken.StartObject)); - } - - /// - /// Skips the children of the current token. - /// - public void Skip() - { - if (TokenType == JsonToken.PropertyName) - { - Read(); - } - - if (JsonTokenUtils.IsStartToken(TokenType)) - { - int depth = Depth; - - while (Read() && (depth < Depth)) - { - } - } - } - - /// - /// Sets the current token. - /// - /// The new token. - protected void SetToken(JsonToken newToken) - { - SetToken(newToken, null, true); - } - - /// - /// Sets the current token and value. - /// - /// The new token. - /// The value. - protected void SetToken(JsonToken newToken, object? value) - { - SetToken(newToken, value, true); - } - - /// - /// Sets the current token and value. - /// - /// The new token. - /// The value. - /// A flag indicating whether the position index inside an array should be updated. - protected void SetToken(JsonToken newToken, object? value, bool updateIndex) - { - _tokenType = newToken; - _value = value; - - switch (newToken) - { - case JsonToken.StartObject: - _currentState = State.ObjectStart; - Push(JsonContainerType.Object); - break; - case JsonToken.StartArray: - _currentState = State.ArrayStart; - Push(JsonContainerType.Array); - break; - case JsonToken.StartConstructor: - _currentState = State.ConstructorStart; - Push(JsonContainerType.Constructor); - break; - case JsonToken.EndObject: - ValidateEnd(JsonToken.EndObject); - break; - case JsonToken.EndArray: - ValidateEnd(JsonToken.EndArray); - break; - case JsonToken.EndConstructor: - ValidateEnd(JsonToken.EndConstructor); - break; - case JsonToken.PropertyName: - _currentState = State.Property; - - _currentPosition.PropertyName = (string)value!; - break; - case JsonToken.Undefined: - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.Boolean: - case JsonToken.Null: - case JsonToken.Date: - case JsonToken.String: - case JsonToken.Raw: - case JsonToken.Bytes: - SetPostValueState(updateIndex); - break; - } - } - - internal void SetPostValueState(bool updateIndex) - { - if (Peek() != JsonContainerType.None || SupportMultipleContent) - { - _currentState = State.PostValue; - } - else - { - SetFinished(); - } - - if (updateIndex) - { - UpdateScopeWithFinishedValue(); - } - } - - private void UpdateScopeWithFinishedValue() - { - if (_currentPosition.HasIndex) - { - _currentPosition.Position++; - } - } - - private void ValidateEnd(JsonToken endToken) - { - JsonContainerType currentObject = Pop(); - - if (GetTypeForCloseToken(endToken) != currentObject) - { - throw JsonReaderException.Create(this, "JsonToken {0} is not valid for closing JsonType {1}.".FormatWith(CultureInfo.InvariantCulture, endToken, currentObject)); - } - - if (Peek() != JsonContainerType.None || SupportMultipleContent) - { - _currentState = State.PostValue; - } - else - { - SetFinished(); - } - } - - /// - /// Sets the state based on current token type. - /// - protected void SetStateBasedOnCurrent() - { - JsonContainerType currentObject = Peek(); - - switch (currentObject) - { - case JsonContainerType.Object: - _currentState = State.Object; - break; - case JsonContainerType.Array: - _currentState = State.Array; - break; - case JsonContainerType.Constructor: - _currentState = State.Constructor; - break; - case JsonContainerType.None: - SetFinished(); - break; - default: - throw JsonReaderException.Create(this, "While setting the reader state back to current object an unexpected JsonType was encountered: {0}".FormatWith(CultureInfo.InvariantCulture, currentObject)); - } - } - - private void SetFinished() - { - _currentState = SupportMultipleContent ? State.Start : State.Finished; - } - - private JsonContainerType GetTypeForCloseToken(JsonToken token) - { - switch (token) - { - case JsonToken.EndObject: - return JsonContainerType.Object; - case JsonToken.EndArray: - return JsonContainerType.Array; - case JsonToken.EndConstructor: - return JsonContainerType.Constructor; - default: - throw JsonReaderException.Create(this, "Not a valid close JsonToken: {0}".FormatWith(CultureInfo.InvariantCulture, token)); - } - } - - void IDisposable.Dispose() - { - Dispose(true); - GC.SuppressFinalize(this); - } - - /// - /// Releases unmanaged and - optionally - managed resources. - /// - /// true to release both managed and unmanaged resources; false to release only unmanaged resources. - protected virtual void Dispose(bool disposing) - { - if (_currentState != State.Closed && disposing) - { - Close(); - } - } - - /// - /// Changes the reader's state to . - /// If is set to true, the source is also closed. - /// - public virtual void Close() - { - _currentState = State.Closed; - _tokenType = JsonToken.None; - _value = null; - } - - internal void ReadAndAssert() - { - if (!Read()) - { - throw JsonSerializationException.Create(this, "Unexpected end when reading JSON."); - } - } - - internal void ReadForTypeAndAssert(JsonContract? contract, bool hasConverter) - { - if (!ReadForType(contract, hasConverter)) - { - throw JsonSerializationException.Create(this, "Unexpected end when reading JSON."); - } - } - - internal bool ReadForType(JsonContract? contract, bool hasConverter) - { - // don't read properties with converters as a specific value - // the value might be a string which will then get converted which will error if read as date for example - if (hasConverter) - { - return Read(); - } - - ReadType t = contract?.InternalReadType ?? ReadType.Read; - - switch (t) - { - case ReadType.Read: - return ReadAndMoveToContent(); - case ReadType.ReadAsInt32: - ReadAsInt32(); - break; - case ReadType.ReadAsInt64: - bool result = ReadAndMoveToContent(); - if (TokenType == JsonToken.Undefined) - { - throw JsonReaderException.Create(this, "An undefined token is not a valid {0}.".FormatWith(CultureInfo.InvariantCulture, contract?.UnderlyingType ?? typeof(long))); - } - return result; - case ReadType.ReadAsDecimal: - ReadAsDecimal(); - break; - case ReadType.ReadAsDouble: - ReadAsDouble(); - break; - case ReadType.ReadAsBytes: - ReadAsBytes(); - break; - case ReadType.ReadAsBoolean: - ReadAsBoolean(); - break; - case ReadType.ReadAsString: - ReadAsString(); - break; - case ReadType.ReadAsDateTime: - ReadAsDateTime(); - break; -#if HAVE_DATE_TIME_OFFSET - case ReadType.ReadAsDateTimeOffset: - ReadAsDateTimeOffset(); - break; -#endif - default: - throw new ArgumentOutOfRangeException(); - } - - return (TokenType != JsonToken.None); - } - - internal bool ReadAndMoveToContent() - { - return Read() && MoveToContent(); - } - - internal bool MoveToContent() - { - JsonToken t = TokenType; - while (t == JsonToken.None || t == JsonToken.Comment) - { - if (!Read()) - { - return false; - } - - t = TokenType; - } - - return true; - } - - private JsonToken GetContentToken() - { - JsonToken t; - do - { - if (!Read()) - { - SetToken(JsonToken.None); - return JsonToken.None; - } - else - { - t = TokenType; - } - } while (t == JsonToken.Comment); - - return t; - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/JsonReaderException.cs b/Source/MyDb/Newtonsoft.Json/JsonReaderException.cs deleted file mode 100644 index bcf9a50..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonReaderException.cs +++ /dev/null @@ -1,148 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using System.Runtime.Serialization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json -{ - /// - /// The exception thrown when an error occurs while reading JSON text. - /// -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - [Serializable] -#endif - public class JsonReaderException : JsonException - { - /// - /// Gets the line number indicating where the error occurred. - /// - /// The line number indicating where the error occurred. - public int LineNumber { get; } - - /// - /// Gets the line position indicating where the error occurred. - /// - /// The line position indicating where the error occurred. - public int LinePosition { get; } - - /// - /// Gets the path to the JSON where the error occurred. - /// - /// The path to the JSON where the error occurred. - public string? Path { get; } - - /// - /// Initializes a new instance of the class. - /// - public JsonReaderException() - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message. - /// - /// The error message that explains the reason for the exception. - public JsonReaderException(string message) - : base(message) - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message and a reference to the inner exception that is the cause of this exception. - /// - /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or null if no inner exception is specified. - public JsonReaderException(string message, Exception innerException) - : base(message, innerException) - { - } - -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - /// - /// Initializes a new instance of the class. - /// - /// The that holds the serialized object data about the exception being thrown. - /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). - public JsonReaderException(SerializationInfo info, StreamingContext context) - : base(info, context) - { - } -#endif - - /// - /// Initializes a new instance of the class - /// with a specified error message, JSON path, line number, line position, and a reference to the inner exception that is the cause of this exception. - /// - /// The error message that explains the reason for the exception. - /// The path to the JSON where the error occurred. - /// The line number indicating where the error occurred. - /// The line position indicating where the error occurred. - /// The exception that is the cause of the current exception, or null if no inner exception is specified. - public JsonReaderException(string message, string path, int lineNumber, int linePosition, Exception? innerException) - : base(message, innerException) - { - Path = path; - LineNumber = lineNumber; - LinePosition = linePosition; - } - - internal static JsonReaderException Create(JsonReader reader, string message) - { - return Create(reader, message, null); - } - - internal static JsonReaderException Create(JsonReader reader, string message, Exception? ex) - { - return Create(reader as IJsonLineInfo, reader.Path, message, ex); - } - - internal static JsonReaderException Create(IJsonLineInfo? lineInfo, string path, string message, Exception? ex) - { - message = JsonPosition.FormatMessage(lineInfo, path, message); - - int lineNumber; - int linePosition; - if (lineInfo != null && lineInfo.HasLineInfo()) - { - lineNumber = lineInfo.LineNumber; - linePosition = lineInfo.LinePosition; - } - else - { - lineNumber = 0; - linePosition = 0; - } - - return new JsonReaderException(message, path, lineNumber, linePosition, ex); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonRequiredAttribute.cs b/Source/MyDb/Newtonsoft.Json/JsonRequiredAttribute.cs deleted file mode 100644 index bc1b6b5..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonRequiredAttribute.cs +++ /dev/null @@ -1,39 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; - -namespace Newtonsoft.Json -{ - /// - /// Instructs the to always serialize the member, and to require that the member has a value. - /// - [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property, AllowMultiple = false)] - public sealed class JsonRequiredAttribute : Attribute - { - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonSerializationException.cs b/Source/MyDb/Newtonsoft.Json/JsonSerializationException.cs deleted file mode 100644 index a54789a..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonSerializationException.cs +++ /dev/null @@ -1,148 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Runtime.Serialization; -using System.Text; - -namespace Newtonsoft.Json -{ - /// - /// The exception thrown when an error occurs during JSON serialization or deserialization. - /// -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - [Serializable] -#endif - public class JsonSerializationException : JsonException - { - /// - /// Gets the line number indicating where the error occurred. - /// - /// The line number indicating where the error occurred. - public int LineNumber { get; } - - /// - /// Gets the line position indicating where the error occurred. - /// - /// The line position indicating where the error occurred. - public int LinePosition { get; } - - /// - /// Gets the path to the JSON where the error occurred. - /// - /// The path to the JSON where the error occurred. - public string? Path { get; } - - /// - /// Initializes a new instance of the class. - /// - public JsonSerializationException() - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message. - /// - /// The error message that explains the reason for the exception. - public JsonSerializationException(string message) - : base(message) - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message and a reference to the inner exception that is the cause of this exception. - /// - /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or null if no inner exception is specified. - public JsonSerializationException(string message, Exception innerException) - : base(message, innerException) - { - } - -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - /// - /// Initializes a new instance of the class. - /// - /// The that holds the serialized object data about the exception being thrown. - /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). - public JsonSerializationException(SerializationInfo info, StreamingContext context) - : base(info, context) - { - } -#endif - - /// - /// Initializes a new instance of the class - /// with a specified error message, JSON path, line number, line position, and a reference to the inner exception that is the cause of this exception. - /// - /// The error message that explains the reason for the exception. - /// The path to the JSON where the error occurred. - /// The line number indicating where the error occurred. - /// The line position indicating where the error occurred. - /// The exception that is the cause of the current exception, or null if no inner exception is specified. - public JsonSerializationException(string message, string path, int lineNumber, int linePosition, Exception? innerException) - : base(message, innerException) - { - Path = path; - LineNumber = lineNumber; - LinePosition = linePosition; - } - - internal static JsonSerializationException Create(JsonReader reader, string message) - { - return Create(reader, message, null); - } - - internal static JsonSerializationException Create(JsonReader reader, string message, Exception? ex) - { - return Create(reader as IJsonLineInfo, reader.Path, message, ex); - } - - internal static JsonSerializationException Create(IJsonLineInfo? lineInfo, string path, string message, Exception? ex) - { - message = JsonPosition.FormatMessage(lineInfo, path, message); - - int lineNumber; - int linePosition; - if (lineInfo != null && lineInfo.HasLineInfo()) - { - lineNumber = lineInfo.LineNumber; - linePosition = lineInfo.LinePosition; - } - else - { - lineNumber = 0; - linePosition = 0; - } - - return new JsonSerializationException(message, path, lineNumber, linePosition, ex); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonSerializer.cs b/Source/MyDb/Newtonsoft.Json/JsonSerializer.cs deleted file mode 100644 index 13e3a9c..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonSerializer.cs +++ /dev/null @@ -1,1226 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using System.Diagnostics; -using System.Globalization; -using System.IO; -using System.Runtime.Serialization.Formatters; -using Newtonsoft.Json.Converters; -using Newtonsoft.Json.Serialization; -using Newtonsoft.Json.Utilities; -using System.Runtime.Serialization; -using ErrorEventArgs = Newtonsoft.Json.Serialization.ErrorEventArgs; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; - -namespace Newtonsoft.Json -{ - /// - /// Serializes and deserializes objects into and from the JSON format. - /// The enables you to control how objects are encoded into JSON. - /// - public class JsonSerializer - { - internal TypeNameHandling _typeNameHandling; - internal TypeNameAssemblyFormatHandling _typeNameAssemblyFormatHandling; - internal PreserveReferencesHandling _preserveReferencesHandling; - internal ReferenceLoopHandling _referenceLoopHandling; - internal MissingMemberHandling _missingMemberHandling; - internal ObjectCreationHandling _objectCreationHandling; - internal NullValueHandling _nullValueHandling; - internal DefaultValueHandling _defaultValueHandling; - internal ConstructorHandling _constructorHandling; - internal MetadataPropertyHandling _metadataPropertyHandling; - internal JsonConverterCollection? _converters; - internal IContractResolver _contractResolver; - internal ITraceWriter? _traceWriter; - internal IEqualityComparer? _equalityComparer; - internal ISerializationBinder _serializationBinder; - internal StreamingContext _context; - private IReferenceResolver? _referenceResolver; - - private Formatting? _formatting; - private DateFormatHandling? _dateFormatHandling; - private DateTimeZoneHandling? _dateTimeZoneHandling; - private DateParseHandling? _dateParseHandling; - private FloatFormatHandling? _floatFormatHandling; - private FloatParseHandling? _floatParseHandling; - private StringEscapeHandling? _stringEscapeHandling; - private CultureInfo _culture; - private int? _maxDepth; - private bool _maxDepthSet; - private bool? _checkAdditionalContent; - private string? _dateFormatString; - private bool _dateFormatStringSet; - - /// - /// Occurs when the errors during serialization and deserialization. - /// - public virtual event EventHandler? Error; - - /// - /// Gets or sets the used by the serializer when resolving references. - /// - public virtual IReferenceResolver? ReferenceResolver - { - get => GetReferenceResolver(); - set - { - if (value == null) - { - throw new ArgumentNullException(nameof(value), "Reference resolver cannot be null."); - } - - _referenceResolver = value; - } - } - - /// - /// Gets or sets the used by the serializer when resolving type names. - /// - [Obsolete("Binder is obsolete. Use SerializationBinder instead.")] - public virtual SerializationBinder Binder - { - get - { - if (_serializationBinder is SerializationBinder legacySerializationBinder) - { - return legacySerializationBinder; - } - - if (_serializationBinder is SerializationBinderAdapter adapter) - { - return adapter.SerializationBinder; - } - - throw new InvalidOperationException("Cannot get SerializationBinder because an ISerializationBinder was previously set."); - } - set - { - if (value == null) - { - throw new ArgumentNullException(nameof(value), "Serialization binder cannot be null."); - } - - _serializationBinder = value as ISerializationBinder ?? new SerializationBinderAdapter(value); - } - } - - /// - /// Gets or sets the used by the serializer when resolving type names. - /// - public virtual ISerializationBinder SerializationBinder - { - get => _serializationBinder; - set - { - if (value == null) - { - throw new ArgumentNullException(nameof(value), "Serialization binder cannot be null."); - } - - _serializationBinder = value; - } - } - - /// - /// Gets or sets the used by the serializer when writing trace messages. - /// - /// The trace writer. - public virtual ITraceWriter? TraceWriter - { - get => _traceWriter; - set => _traceWriter = value; - } - - /// - /// Gets or sets the equality comparer used by the serializer when comparing references. - /// - /// The equality comparer. - public virtual IEqualityComparer? EqualityComparer - { - get => _equalityComparer; - set => _equalityComparer = value; - } - - /// - /// Gets or sets how type name writing and reading is handled by the serializer. - /// The default value is . - /// - /// - /// should be used with caution when your application deserializes JSON from an external source. - /// Incoming types should be validated with a custom - /// when deserializing with a value other than . - /// - public virtual TypeNameHandling TypeNameHandling - { - get => _typeNameHandling; - set - { - if (value < TypeNameHandling.None || value > TypeNameHandling.Auto) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _typeNameHandling = value; - } - } - - /// - /// Gets or sets how a type name assembly is written and resolved by the serializer. - /// The default value is . - /// - /// The type name assembly format. - [Obsolete("TypeNameAssemblyFormat is obsolete. Use TypeNameAssemblyFormatHandling instead.")] - public virtual FormatterAssemblyStyle TypeNameAssemblyFormat - { - get => (FormatterAssemblyStyle)_typeNameAssemblyFormatHandling; - set - { - if (value < FormatterAssemblyStyle.Simple || value > FormatterAssemblyStyle.Full) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _typeNameAssemblyFormatHandling = (TypeNameAssemblyFormatHandling)value; - } - } - - /// - /// Gets or sets how a type name assembly is written and resolved by the serializer. - /// The default value is . - /// - /// The type name assembly format. - public virtual TypeNameAssemblyFormatHandling TypeNameAssemblyFormatHandling - { - get => _typeNameAssemblyFormatHandling; - set - { - if (value < TypeNameAssemblyFormatHandling.Simple || value > TypeNameAssemblyFormatHandling.Full) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _typeNameAssemblyFormatHandling = value; - } - } - - /// - /// Gets or sets how object references are preserved by the serializer. - /// The default value is . - /// - public virtual PreserveReferencesHandling PreserveReferencesHandling - { - get => _preserveReferencesHandling; - set - { - if (value < PreserveReferencesHandling.None || value > PreserveReferencesHandling.All) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _preserveReferencesHandling = value; - } - } - - /// - /// Gets or sets how reference loops (e.g. a class referencing itself) is handled. - /// The default value is . - /// - public virtual ReferenceLoopHandling ReferenceLoopHandling - { - get => _referenceLoopHandling; - set - { - if (value < ReferenceLoopHandling.Error || value > ReferenceLoopHandling.Serialize) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _referenceLoopHandling = value; - } - } - - /// - /// Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - /// The default value is . - /// - public virtual MissingMemberHandling MissingMemberHandling - { - get => _missingMemberHandling; - set - { - if (value < MissingMemberHandling.Ignore || value > MissingMemberHandling.Error) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _missingMemberHandling = value; - } - } - - /// - /// Gets or sets how null values are handled during serialization and deserialization. - /// The default value is . - /// - public virtual NullValueHandling NullValueHandling - { - get => _nullValueHandling; - set - { - if (value < NullValueHandling.Include || value > NullValueHandling.Ignore) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _nullValueHandling = value; - } - } - - /// - /// Gets or sets how default values are handled during serialization and deserialization. - /// The default value is . - /// - public virtual DefaultValueHandling DefaultValueHandling - { - get => _defaultValueHandling; - set - { - if (value < DefaultValueHandling.Include || value > DefaultValueHandling.IgnoreAndPopulate) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _defaultValueHandling = value; - } - } - - /// - /// Gets or sets how objects are created during deserialization. - /// The default value is . - /// - /// The object creation handling. - public virtual ObjectCreationHandling ObjectCreationHandling - { - get => _objectCreationHandling; - set - { - if (value < ObjectCreationHandling.Auto || value > ObjectCreationHandling.Replace) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _objectCreationHandling = value; - } - } - - /// - /// Gets or sets how constructors are used during deserialization. - /// The default value is . - /// - /// The constructor handling. - public virtual ConstructorHandling ConstructorHandling - { - get => _constructorHandling; - set - { - if (value < ConstructorHandling.Default || value > ConstructorHandling.AllowNonPublicDefaultConstructor) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _constructorHandling = value; - } - } - - /// - /// Gets or sets how metadata properties are used during deserialization. - /// The default value is . - /// - /// The metadata properties handling. - public virtual MetadataPropertyHandling MetadataPropertyHandling - { - get => _metadataPropertyHandling; - set - { - if (value < MetadataPropertyHandling.Default || value > MetadataPropertyHandling.Ignore) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _metadataPropertyHandling = value; - } - } - - /// - /// Gets a collection that will be used during serialization. - /// - /// Collection that will be used during serialization. - public virtual JsonConverterCollection Converters - { - get - { - if (_converters == null) - { - _converters = new JsonConverterCollection(); - } - - return _converters; - } - } - - /// - /// Gets or sets the contract resolver used by the serializer when - /// serializing .NET objects to JSON and vice versa. - /// - public virtual IContractResolver ContractResolver - { - get => _contractResolver; - set => _contractResolver = value ?? DefaultContractResolver.Instance; - } - - /// - /// Gets or sets the used by the serializer when invoking serialization callback methods. - /// - /// The context. - public virtual StreamingContext Context - { - get => _context; - set => _context = value; - } - - /// - /// Indicates how JSON text output is formatted. - /// The default value is . - /// - public virtual Formatting Formatting - { - get => _formatting ?? JsonSerializerSettings.DefaultFormatting; - set => _formatting = value; - } - - /// - /// Gets or sets how dates are written to JSON text. - /// The default value is . - /// - public virtual DateFormatHandling DateFormatHandling - { - get => _dateFormatHandling ?? JsonSerializerSettings.DefaultDateFormatHandling; - set => _dateFormatHandling = value; - } - - /// - /// Gets or sets how time zones are handled during serialization and deserialization. - /// The default value is . - /// - public virtual DateTimeZoneHandling DateTimeZoneHandling - { - get => _dateTimeZoneHandling ?? JsonSerializerSettings.DefaultDateTimeZoneHandling; - set => _dateTimeZoneHandling = value; - } - - /// - /// Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - /// The default value is . - /// - public virtual DateParseHandling DateParseHandling - { - get => _dateParseHandling ?? JsonSerializerSettings.DefaultDateParseHandling; - set => _dateParseHandling = value; - } - - /// - /// Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - /// The default value is . - /// - public virtual FloatParseHandling FloatParseHandling - { - get => _floatParseHandling ?? JsonSerializerSettings.DefaultFloatParseHandling; - set => _floatParseHandling = value; - } - - /// - /// Gets or sets how special floating point numbers, e.g. , - /// and , - /// are written as JSON text. - /// The default value is . - /// - public virtual FloatFormatHandling FloatFormatHandling - { - get => _floatFormatHandling ?? JsonSerializerSettings.DefaultFloatFormatHandling; - set => _floatFormatHandling = value; - } - - /// - /// Gets or sets how strings are escaped when writing JSON text. - /// The default value is . - /// - public virtual StringEscapeHandling StringEscapeHandling - { - get => _stringEscapeHandling ?? JsonSerializerSettings.DefaultStringEscapeHandling; - set => _stringEscapeHandling = value; - } - - /// - /// Gets or sets how and values are formatted when writing JSON text, - /// and the expected date format when reading JSON text. - /// The default value is "yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK". - /// - public virtual string DateFormatString - { - get => _dateFormatString ?? JsonSerializerSettings.DefaultDateFormatString; - set - { - _dateFormatString = value; - _dateFormatStringSet = true; - } - } - - /// - /// Gets or sets the culture used when reading JSON. - /// The default value is . - /// - public virtual CultureInfo Culture - { - get => _culture ?? JsonSerializerSettings.DefaultCulture; - set => _culture = value; - } - - /// - /// Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . - /// A null value means there is no maximum. - /// The default value is 64. - /// - public virtual int? MaxDepth - { - get => _maxDepth; - set - { - if (value <= 0) - { - throw new ArgumentException("Value must be positive.", nameof(value)); - } - - _maxDepth = value; - _maxDepthSet = true; - } - } - - /// - /// Gets a value indicating whether there will be a check for additional JSON content after deserializing an object. - /// The default value is false. - /// - /// - /// true if there will be a check for additional JSON content after deserializing an object; otherwise, false. - /// - public virtual bool CheckAdditionalContent - { - get => _checkAdditionalContent ?? JsonSerializerSettings.DefaultCheckAdditionalContent; - set => _checkAdditionalContent = value; - } - - internal bool IsCheckAdditionalContentSet() - { - return (_checkAdditionalContent != null); - } - - /// - /// Initializes a new instance of the class. - /// - public JsonSerializer() - { - _referenceLoopHandling = JsonSerializerSettings.DefaultReferenceLoopHandling; - _missingMemberHandling = JsonSerializerSettings.DefaultMissingMemberHandling; - _nullValueHandling = JsonSerializerSettings.DefaultNullValueHandling; - _defaultValueHandling = JsonSerializerSettings.DefaultDefaultValueHandling; - _objectCreationHandling = JsonSerializerSettings.DefaultObjectCreationHandling; - _preserveReferencesHandling = JsonSerializerSettings.DefaultPreserveReferencesHandling; - _constructorHandling = JsonSerializerSettings.DefaultConstructorHandling; - _typeNameHandling = JsonSerializerSettings.DefaultTypeNameHandling; - _metadataPropertyHandling = JsonSerializerSettings.DefaultMetadataPropertyHandling; - _context = JsonSerializerSettings.DefaultContext; - _serializationBinder = DefaultSerializationBinder.Instance; - - _culture = JsonSerializerSettings.DefaultCulture; - _contractResolver = DefaultContractResolver.Instance; - } - - /// - /// Creates a new instance. - /// The will not use default settings - /// from . - /// - /// - /// A new instance. - /// The will not use default settings - /// from . - /// - public static JsonSerializer Create() - { - return new JsonSerializer(); - } - - /// - /// Creates a new instance using the specified . - /// The will not use default settings - /// from . - /// - /// The settings to be applied to the . - /// - /// A new instance using the specified . - /// The will not use default settings - /// from . - /// - public static JsonSerializer Create(JsonSerializerSettings? settings) - { - JsonSerializer serializer = Create(); - - if (settings != null) - { - ApplySerializerSettings(serializer, settings); - } - - return serializer; - } - - /// - /// Creates a new instance. - /// The will use default settings - /// from . - /// - /// - /// A new instance. - /// The will use default settings - /// from . - /// - public static JsonSerializer CreateDefault() - { - // copy static to local variable to avoid concurrency issues - JsonSerializerSettings? defaultSettings = JsonConvert.DefaultSettings?.Invoke(); - - return Create(defaultSettings); - } - - /// - /// Creates a new instance using the specified . - /// The will use default settings - /// from as well as the specified . - /// - /// The settings to be applied to the . - /// - /// A new instance using the specified . - /// The will use default settings - /// from as well as the specified . - /// - public static JsonSerializer CreateDefault(JsonSerializerSettings? settings) - { - JsonSerializer serializer = CreateDefault(); - if (settings != null) - { - ApplySerializerSettings(serializer, settings); - } - - return serializer; - } - - private static void ApplySerializerSettings(JsonSerializer serializer, JsonSerializerSettings settings) - { - if (!CollectionUtils.IsNullOrEmpty(settings.Converters)) - { - // insert settings converters at the beginning so they take precedence - // if user wants to remove one of the default converters they will have to do it manually - for (int i = 0; i < settings.Converters.Count; i++) - { - serializer.Converters.Insert(i, settings.Converters[i]); - } - } - - // serializer specific - if (settings._typeNameHandling != null) - { - serializer.TypeNameHandling = settings.TypeNameHandling; - } - if (settings._metadataPropertyHandling != null) - { - serializer.MetadataPropertyHandling = settings.MetadataPropertyHandling; - } - if (settings._typeNameAssemblyFormatHandling != null) - { - serializer.TypeNameAssemblyFormatHandling = settings.TypeNameAssemblyFormatHandling; - } - if (settings._preserveReferencesHandling != null) - { - serializer.PreserveReferencesHandling = settings.PreserveReferencesHandling; - } - if (settings._referenceLoopHandling != null) - { - serializer.ReferenceLoopHandling = settings.ReferenceLoopHandling; - } - if (settings._missingMemberHandling != null) - { - serializer.MissingMemberHandling = settings.MissingMemberHandling; - } - if (settings._objectCreationHandling != null) - { - serializer.ObjectCreationHandling = settings.ObjectCreationHandling; - } - if (settings._nullValueHandling != null) - { - serializer.NullValueHandling = settings.NullValueHandling; - } - if (settings._defaultValueHandling != null) - { - serializer.DefaultValueHandling = settings.DefaultValueHandling; - } - if (settings._constructorHandling != null) - { - serializer.ConstructorHandling = settings.ConstructorHandling; - } - if (settings._context != null) - { - serializer.Context = settings.Context; - } - if (settings._checkAdditionalContent != null) - { - serializer._checkAdditionalContent = settings._checkAdditionalContent; - } - - if (settings.Error != null) - { - serializer.Error += settings.Error; - } - - if (settings.ContractResolver != null) - { - serializer.ContractResolver = settings.ContractResolver; - } - if (settings.ReferenceResolverProvider != null) - { - serializer.ReferenceResolver = settings.ReferenceResolverProvider(); - } - if (settings.TraceWriter != null) - { - serializer.TraceWriter = settings.TraceWriter; - } - if (settings.EqualityComparer != null) - { - serializer.EqualityComparer = settings.EqualityComparer; - } - if (settings.SerializationBinder != null) - { - serializer.SerializationBinder = settings.SerializationBinder; - } - - // reader/writer specific - // unset values won't override reader/writer set values - if (settings._formatting != null) - { - serializer._formatting = settings._formatting; - } - if (settings._dateFormatHandling != null) - { - serializer._dateFormatHandling = settings._dateFormatHandling; - } - if (settings._dateTimeZoneHandling != null) - { - serializer._dateTimeZoneHandling = settings._dateTimeZoneHandling; - } - if (settings._dateParseHandling != null) - { - serializer._dateParseHandling = settings._dateParseHandling; - } - if (settings._dateFormatStringSet) - { - serializer._dateFormatString = settings._dateFormatString; - serializer._dateFormatStringSet = settings._dateFormatStringSet; - } - if (settings._floatFormatHandling != null) - { - serializer._floatFormatHandling = settings._floatFormatHandling; - } - if (settings._floatParseHandling != null) - { - serializer._floatParseHandling = settings._floatParseHandling; - } - if (settings._stringEscapeHandling != null) - { - serializer._stringEscapeHandling = settings._stringEscapeHandling; - } - if (settings._culture != null) - { - serializer._culture = settings._culture; - } - if (settings._maxDepthSet) - { - serializer._maxDepth = settings._maxDepth; - serializer._maxDepthSet = settings._maxDepthSet; - } - } - - /// - /// Populates the JSON values onto the target object. - /// - /// The that contains the JSON structure to read values from. - /// The target object to populate values onto. - [DebuggerStepThrough] - public void Populate(TextReader reader, object target) - { - Populate(new JsonTextReader(reader), target); - } - - /// - /// Populates the JSON values onto the target object. - /// - /// The that contains the JSON structure to read values from. - /// The target object to populate values onto. - [DebuggerStepThrough] - public void Populate(JsonReader reader, object target) - { - PopulateInternal(reader, target); - } - - internal virtual void PopulateInternal(JsonReader reader, object target) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - ValidationUtils.ArgumentNotNull(target, nameof(target)); - - SetupReader( - reader, - out CultureInfo? previousCulture, - out DateTimeZoneHandling? previousDateTimeZoneHandling, - out DateParseHandling? previousDateParseHandling, - out FloatParseHandling? previousFloatParseHandling, - out int? previousMaxDepth, - out string? previousDateFormatString); - - TraceJsonReader? traceJsonReader = (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - ? CreateTraceJsonReader(reader) - : null; - - JsonSerializerInternalReader serializerReader = new JsonSerializerInternalReader(this); - serializerReader.Populate(traceJsonReader ?? reader, target); - - if (traceJsonReader != null) - { - TraceWriter!.Trace(TraceLevel.Verbose, traceJsonReader.GetDeserializedJsonMessage(), null); - } - - ResetReader(reader, previousCulture, previousDateTimeZoneHandling, previousDateParseHandling, previousFloatParseHandling, previousMaxDepth, previousDateFormatString); - } - - /// - /// Deserializes the JSON structure contained by the specified . - /// - /// The that contains the JSON structure to deserialize. - /// The being deserialized. - [DebuggerStepThrough] - public object? Deserialize(JsonReader reader) - { - return Deserialize(reader, null); - } - - /// - /// Deserializes the JSON structure contained by the specified - /// into an instance of the specified type. - /// - /// The containing the object. - /// The of object being deserialized. - /// The instance of being deserialized. - [DebuggerStepThrough] - public object? Deserialize(TextReader reader, Type objectType) - { - return Deserialize(new JsonTextReader(reader), objectType); - } - - /// - /// Deserializes the JSON structure contained by the specified - /// into an instance of the specified type. - /// - /// The containing the object. - /// The type of the object to deserialize. - /// The instance of being deserialized. - [DebuggerStepThrough] - public T? Deserialize(JsonReader reader) - { - return (T?)Deserialize(reader, typeof(T)); - } - - /// - /// Deserializes the JSON structure contained by the specified - /// into an instance of the specified type. - /// - /// The containing the object. - /// The of object being deserialized. - /// The instance of being deserialized. - [DebuggerStepThrough] - public object? Deserialize(JsonReader reader, Type? objectType) - { - return DeserializeInternal(reader, objectType); - } - - internal virtual object? DeserializeInternal(JsonReader reader, Type? objectType) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - - SetupReader( - reader, - out CultureInfo? previousCulture, - out DateTimeZoneHandling? previousDateTimeZoneHandling, - out DateParseHandling? previousDateParseHandling, - out FloatParseHandling? previousFloatParseHandling, - out int? previousMaxDepth, - out string? previousDateFormatString); - - TraceJsonReader? traceJsonReader = (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - ? CreateTraceJsonReader(reader) - : null; - - JsonSerializerInternalReader serializerReader = new JsonSerializerInternalReader(this); - object? value = serializerReader.Deserialize(traceJsonReader ?? reader, objectType, CheckAdditionalContent); - - if (traceJsonReader != null) - { - TraceWriter!.Trace(TraceLevel.Verbose, traceJsonReader.GetDeserializedJsonMessage(), null); - } - - ResetReader(reader, previousCulture, previousDateTimeZoneHandling, previousDateParseHandling, previousFloatParseHandling, previousMaxDepth, previousDateFormatString); - - return value; - } - - internal void SetupReader(JsonReader reader, out CultureInfo? previousCulture, out DateTimeZoneHandling? previousDateTimeZoneHandling, out DateParseHandling? previousDateParseHandling, out FloatParseHandling? previousFloatParseHandling, out int? previousMaxDepth, out string? previousDateFormatString) - { - if (_culture != null && !_culture.Equals(reader.Culture)) - { - previousCulture = reader.Culture; - reader.Culture = _culture; - } - else - { - previousCulture = null; - } - - if (_dateTimeZoneHandling != null && reader.DateTimeZoneHandling != _dateTimeZoneHandling) - { - previousDateTimeZoneHandling = reader.DateTimeZoneHandling; - reader.DateTimeZoneHandling = _dateTimeZoneHandling.GetValueOrDefault(); - } - else - { - previousDateTimeZoneHandling = null; - } - - if (_dateParseHandling != null && reader.DateParseHandling != _dateParseHandling) - { - previousDateParseHandling = reader.DateParseHandling; - reader.DateParseHandling = _dateParseHandling.GetValueOrDefault(); - } - else - { - previousDateParseHandling = null; - } - - if (_floatParseHandling != null && reader.FloatParseHandling != _floatParseHandling) - { - previousFloatParseHandling = reader.FloatParseHandling; - reader.FloatParseHandling = _floatParseHandling.GetValueOrDefault(); - } - else - { - previousFloatParseHandling = null; - } - - if (_maxDepthSet && reader.MaxDepth != _maxDepth) - { - previousMaxDepth = reader.MaxDepth; - reader.MaxDepth = _maxDepth; - } - else - { - previousMaxDepth = null; - } - - if (_dateFormatStringSet && reader.DateFormatString != _dateFormatString) - { - previousDateFormatString = reader.DateFormatString; - reader.DateFormatString = _dateFormatString; - } - else - { - previousDateFormatString = null; - } - - if (reader is JsonTextReader textReader) - { - if (textReader.PropertyNameTable == null && _contractResolver is DefaultContractResolver resolver) - { - textReader.PropertyNameTable = resolver.GetNameTable(); - } - } - } - - private void ResetReader(JsonReader reader, CultureInfo? previousCulture, DateTimeZoneHandling? previousDateTimeZoneHandling, DateParseHandling? previousDateParseHandling, FloatParseHandling? previousFloatParseHandling, int? previousMaxDepth, string? previousDateFormatString) - { - // reset reader back to previous options - if (previousCulture != null) - { - reader.Culture = previousCulture; - } - if (previousDateTimeZoneHandling != null) - { - reader.DateTimeZoneHandling = previousDateTimeZoneHandling.GetValueOrDefault(); - } - if (previousDateParseHandling != null) - { - reader.DateParseHandling = previousDateParseHandling.GetValueOrDefault(); - } - if (previousFloatParseHandling != null) - { - reader.FloatParseHandling = previousFloatParseHandling.GetValueOrDefault(); - } - if (_maxDepthSet) - { - reader.MaxDepth = previousMaxDepth; - } - if (_dateFormatStringSet) - { - reader.DateFormatString = previousDateFormatString; - } - - if (reader is JsonTextReader textReader && textReader.PropertyNameTable != null && - _contractResolver is DefaultContractResolver resolver && textReader.PropertyNameTable == resolver.GetNameTable()) - { - textReader.PropertyNameTable = null; - } - } - - /// - /// Serializes the specified and writes the JSON structure - /// using the specified . - /// - /// The used to write the JSON structure. - /// The to serialize. - public void Serialize(TextWriter textWriter, object? value) - { - Serialize(new JsonTextWriter(textWriter), value); - } - - /// - /// Serializes the specified and writes the JSON structure - /// using the specified . - /// - /// The used to write the JSON structure. - /// The to serialize. - /// - /// The type of the value being serialized. - /// This parameter is used when is to write out the type name if the type of the value does not match. - /// Specifying the type is optional. - /// - public void Serialize(JsonWriter jsonWriter, object? value, Type? objectType) - { - SerializeInternal(jsonWriter, value, objectType); - } - - /// - /// Serializes the specified and writes the JSON structure - /// using the specified . - /// - /// The used to write the JSON structure. - /// The to serialize. - /// - /// The type of the value being serialized. - /// This parameter is used when is Auto to write out the type name if the type of the value does not match. - /// Specifying the type is optional. - /// - public void Serialize(TextWriter textWriter, object? value, Type objectType) - { - Serialize(new JsonTextWriter(textWriter), value, objectType); - } - - /// - /// Serializes the specified and writes the JSON structure - /// using the specified . - /// - /// The used to write the JSON structure. - /// The to serialize. - public void Serialize(JsonWriter jsonWriter, object? value) - { - SerializeInternal(jsonWriter, value, null); - } - - private TraceJsonReader CreateTraceJsonReader(JsonReader reader) - { - TraceJsonReader traceReader = new TraceJsonReader(reader); - if (reader.TokenType != JsonToken.None) - { - traceReader.WriteCurrentToken(); - } - - return traceReader; - } - - internal virtual void SerializeInternal(JsonWriter jsonWriter, object? value, Type? objectType) - { - ValidationUtils.ArgumentNotNull(jsonWriter, nameof(jsonWriter)); - - // set serialization options onto writer - Formatting? previousFormatting = null; - if (_formatting != null && jsonWriter.Formatting != _formatting) - { - previousFormatting = jsonWriter.Formatting; - jsonWriter.Formatting = _formatting.GetValueOrDefault(); - } - - DateFormatHandling? previousDateFormatHandling = null; - if (_dateFormatHandling != null && jsonWriter.DateFormatHandling != _dateFormatHandling) - { - previousDateFormatHandling = jsonWriter.DateFormatHandling; - jsonWriter.DateFormatHandling = _dateFormatHandling.GetValueOrDefault(); - } - - DateTimeZoneHandling? previousDateTimeZoneHandling = null; - if (_dateTimeZoneHandling != null && jsonWriter.DateTimeZoneHandling != _dateTimeZoneHandling) - { - previousDateTimeZoneHandling = jsonWriter.DateTimeZoneHandling; - jsonWriter.DateTimeZoneHandling = _dateTimeZoneHandling.GetValueOrDefault(); - } - - FloatFormatHandling? previousFloatFormatHandling = null; - if (_floatFormatHandling != null && jsonWriter.FloatFormatHandling != _floatFormatHandling) - { - previousFloatFormatHandling = jsonWriter.FloatFormatHandling; - jsonWriter.FloatFormatHandling = _floatFormatHandling.GetValueOrDefault(); - } - - StringEscapeHandling? previousStringEscapeHandling = null; - if (_stringEscapeHandling != null && jsonWriter.StringEscapeHandling != _stringEscapeHandling) - { - previousStringEscapeHandling = jsonWriter.StringEscapeHandling; - jsonWriter.StringEscapeHandling = _stringEscapeHandling.GetValueOrDefault(); - } - - CultureInfo? previousCulture = null; - if (_culture != null && !_culture.Equals(jsonWriter.Culture)) - { - previousCulture = jsonWriter.Culture; - jsonWriter.Culture = _culture; - } - - string? previousDateFormatString = null; - if (_dateFormatStringSet && jsonWriter.DateFormatString != _dateFormatString) - { - previousDateFormatString = jsonWriter.DateFormatString; - jsonWriter.DateFormatString = _dateFormatString; - } - - TraceJsonWriter? traceJsonWriter = (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - ? new TraceJsonWriter(jsonWriter) - : null; - - JsonSerializerInternalWriter serializerWriter = new JsonSerializerInternalWriter(this); - serializerWriter.Serialize(traceJsonWriter ?? jsonWriter, value, objectType); - - if (traceJsonWriter != null) - { - TraceWriter!.Trace(TraceLevel.Verbose, traceJsonWriter.GetSerializedJsonMessage(), null); - } - - // reset writer back to previous options - if (previousFormatting != null) - { - jsonWriter.Formatting = previousFormatting.GetValueOrDefault(); - } - if (previousDateFormatHandling != null) - { - jsonWriter.DateFormatHandling = previousDateFormatHandling.GetValueOrDefault(); - } - if (previousDateTimeZoneHandling != null) - { - jsonWriter.DateTimeZoneHandling = previousDateTimeZoneHandling.GetValueOrDefault(); - } - if (previousFloatFormatHandling != null) - { - jsonWriter.FloatFormatHandling = previousFloatFormatHandling.GetValueOrDefault(); - } - if (previousStringEscapeHandling != null) - { - jsonWriter.StringEscapeHandling = previousStringEscapeHandling.GetValueOrDefault(); - } - if (_dateFormatStringSet) - { - jsonWriter.DateFormatString = previousDateFormatString; - } - if (previousCulture != null) - { - jsonWriter.Culture = previousCulture; - } - } - - internal IReferenceResolver GetReferenceResolver() - { - if (_referenceResolver == null) - { - _referenceResolver = new DefaultReferenceResolver(); - } - - return _referenceResolver; - } - - internal JsonConverter? GetMatchingConverter(Type type) - { - return GetMatchingConverter(_converters, type); - } - - internal static JsonConverter? GetMatchingConverter(IList? converters, Type objectType) - { -#if DEBUG - ValidationUtils.ArgumentNotNull(objectType, nameof(objectType)); -#endif - - if (converters != null) - { - for (int i = 0; i < converters.Count; i++) - { - JsonConverter converter = converters[i]; - - if (converter.CanConvert(objectType)) - { - return converter; - } - } - } - - return null; - } - - internal void OnError(ErrorEventArgs e) - { - Error?.Invoke(this, e); - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/JsonSerializerSettings.cs b/Source/MyDb/Newtonsoft.Json/JsonSerializerSettings.cs deleted file mode 100644 index fc5205d..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonSerializerSettings.cs +++ /dev/null @@ -1,456 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using System.Globalization; -using System.Runtime.Serialization.Formatters; -using Newtonsoft.Json.Serialization; -using System.Runtime.Serialization; -using System.Diagnostics; - -namespace Newtonsoft.Json -{ - /// - /// Specifies the settings on a object. - /// - public class JsonSerializerSettings - { - internal const ReferenceLoopHandling DefaultReferenceLoopHandling = ReferenceLoopHandling.Error; - internal const MissingMemberHandling DefaultMissingMemberHandling = MissingMemberHandling.Ignore; - internal const NullValueHandling DefaultNullValueHandling = NullValueHandling.Include; - internal const DefaultValueHandling DefaultDefaultValueHandling = DefaultValueHandling.Include; - internal const ObjectCreationHandling DefaultObjectCreationHandling = ObjectCreationHandling.Auto; - internal const PreserveReferencesHandling DefaultPreserveReferencesHandling = PreserveReferencesHandling.None; - internal const ConstructorHandling DefaultConstructorHandling = ConstructorHandling.Default; - internal const TypeNameHandling DefaultTypeNameHandling = TypeNameHandling.None; - internal const MetadataPropertyHandling DefaultMetadataPropertyHandling = MetadataPropertyHandling.Default; - internal static readonly StreamingContext DefaultContext; - - internal const Formatting DefaultFormatting = Formatting.None; - internal const DateFormatHandling DefaultDateFormatHandling = DateFormatHandling.IsoDateFormat; - internal const DateTimeZoneHandling DefaultDateTimeZoneHandling = DateTimeZoneHandling.RoundtripKind; - internal const DateParseHandling DefaultDateParseHandling = DateParseHandling.DateTime; - internal const FloatParseHandling DefaultFloatParseHandling = FloatParseHandling.Double; - internal const FloatFormatHandling DefaultFloatFormatHandling = FloatFormatHandling.String; - internal const StringEscapeHandling DefaultStringEscapeHandling = StringEscapeHandling.Default; - internal const TypeNameAssemblyFormatHandling DefaultTypeNameAssemblyFormatHandling = TypeNameAssemblyFormatHandling.Simple; - internal static readonly CultureInfo DefaultCulture; - internal const bool DefaultCheckAdditionalContent = false; - internal const string DefaultDateFormatString = @"yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK"; - internal const int DefaultMaxDepth = 64; - - internal Formatting? _formatting; - internal DateFormatHandling? _dateFormatHandling; - internal DateTimeZoneHandling? _dateTimeZoneHandling; - internal DateParseHandling? _dateParseHandling; - internal FloatFormatHandling? _floatFormatHandling; - internal FloatParseHandling? _floatParseHandling; - internal StringEscapeHandling? _stringEscapeHandling; - internal CultureInfo? _culture; - internal bool? _checkAdditionalContent; - internal int? _maxDepth; - internal bool _maxDepthSet; - internal string? _dateFormatString; - internal bool _dateFormatStringSet; - internal TypeNameAssemblyFormatHandling? _typeNameAssemblyFormatHandling; - internal DefaultValueHandling? _defaultValueHandling; - internal PreserveReferencesHandling? _preserveReferencesHandling; - internal NullValueHandling? _nullValueHandling; - internal ObjectCreationHandling? _objectCreationHandling; - internal MissingMemberHandling? _missingMemberHandling; - internal ReferenceLoopHandling? _referenceLoopHandling; - internal StreamingContext? _context; - internal ConstructorHandling? _constructorHandling; - internal TypeNameHandling? _typeNameHandling; - internal MetadataPropertyHandling? _metadataPropertyHandling; - - /// - /// Gets or sets how reference loops (e.g. a class referencing itself) are handled. - /// The default value is . - /// - /// Reference loop handling. - public ReferenceLoopHandling ReferenceLoopHandling - { - get => _referenceLoopHandling ?? DefaultReferenceLoopHandling; - set => _referenceLoopHandling = value; - } - - /// - /// Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - /// The default value is . - /// - /// Missing member handling. - public MissingMemberHandling MissingMemberHandling - { - get => _missingMemberHandling ?? DefaultMissingMemberHandling; - set => _missingMemberHandling = value; - } - - /// - /// Gets or sets how objects are created during deserialization. - /// The default value is . - /// - /// The object creation handling. - public ObjectCreationHandling ObjectCreationHandling - { - get => _objectCreationHandling ?? DefaultObjectCreationHandling; - set => _objectCreationHandling = value; - } - - /// - /// Gets or sets how null values are handled during serialization and deserialization. - /// The default value is . - /// - /// Null value handling. - public NullValueHandling NullValueHandling - { - get => _nullValueHandling ?? DefaultNullValueHandling; - set => _nullValueHandling = value; - } - - /// - /// Gets or sets how default values are handled during serialization and deserialization. - /// The default value is . - /// - /// The default value handling. - public DefaultValueHandling DefaultValueHandling - { - get => _defaultValueHandling ?? DefaultDefaultValueHandling; - set => _defaultValueHandling = value; - } - - /// - /// Gets or sets a collection that will be used during serialization. - /// - /// The converters. - public IList Converters { get; set; } - - /// - /// Gets or sets how object references are preserved by the serializer. - /// The default value is . - /// - /// The preserve references handling. - public PreserveReferencesHandling PreserveReferencesHandling - { - get => _preserveReferencesHandling ?? DefaultPreserveReferencesHandling; - set => _preserveReferencesHandling = value; - } - - /// - /// Gets or sets how type name writing and reading is handled by the serializer. - /// The default value is . - /// - /// - /// should be used with caution when your application deserializes JSON from an external source. - /// Incoming types should be validated with a custom - /// when deserializing with a value other than . - /// - /// The type name handling. - public TypeNameHandling TypeNameHandling - { - get => _typeNameHandling ?? DefaultTypeNameHandling; - set => _typeNameHandling = value; - } - - /// - /// Gets or sets how metadata properties are used during deserialization. - /// The default value is . - /// - /// The metadata properties handling. - public MetadataPropertyHandling MetadataPropertyHandling - { - get => _metadataPropertyHandling ?? DefaultMetadataPropertyHandling; - set => _metadataPropertyHandling = value; - } - - /// - /// Gets or sets how a type name assembly is written and resolved by the serializer. - /// The default value is . - /// - /// The type name assembly format. - [Obsolete("TypeNameAssemblyFormat is obsolete. Use TypeNameAssemblyFormatHandling instead.")] - public FormatterAssemblyStyle TypeNameAssemblyFormat - { - get => (FormatterAssemblyStyle)TypeNameAssemblyFormatHandling; - set => TypeNameAssemblyFormatHandling = (TypeNameAssemblyFormatHandling)value; - } - - /// - /// Gets or sets how a type name assembly is written and resolved by the serializer. - /// The default value is . - /// - /// The type name assembly format. - public TypeNameAssemblyFormatHandling TypeNameAssemblyFormatHandling - { - get => _typeNameAssemblyFormatHandling ?? DefaultTypeNameAssemblyFormatHandling; - set => _typeNameAssemblyFormatHandling = value; - } - - /// - /// Gets or sets how constructors are used during deserialization. - /// The default value is . - /// - /// The constructor handling. - public ConstructorHandling ConstructorHandling - { - get => _constructorHandling ?? DefaultConstructorHandling; - set => _constructorHandling = value; - } - - /// - /// Gets or sets the contract resolver used by the serializer when - /// serializing .NET objects to JSON and vice versa. - /// - /// The contract resolver. - public IContractResolver? ContractResolver { get; set; } - - /// - /// Gets or sets the equality comparer used by the serializer when comparing references. - /// - /// The equality comparer. - public IEqualityComparer? EqualityComparer { get; set; } - - /// - /// Gets or sets the used by the serializer when resolving references. - /// - /// The reference resolver. - [Obsolete("ReferenceResolver property is obsolete. Use the ReferenceResolverProvider property to set the IReferenceResolver: settings.ReferenceResolverProvider = () => resolver")] - public IReferenceResolver? ReferenceResolver - { - get => ReferenceResolverProvider?.Invoke(); - set - { - ReferenceResolverProvider = (value != null) - ? () => value - : (Func?)null; - } - } - - /// - /// Gets or sets a function that creates the used by the serializer when resolving references. - /// - /// A function that creates the used by the serializer when resolving references. - public Func? ReferenceResolverProvider { get; set; } - - /// - /// Gets or sets the used by the serializer when writing trace messages. - /// - /// The trace writer. - public ITraceWriter? TraceWriter { get; set; } - - /// - /// Gets or sets the used by the serializer when resolving type names. - /// - /// The binder. - [Obsolete("Binder is obsolete. Use SerializationBinder instead.")] - public SerializationBinder? Binder - { - get - { - if (SerializationBinder == null) - { - return null; - } - - if (SerializationBinder is SerializationBinderAdapter adapter) - { - return adapter.SerializationBinder; - } - - throw new InvalidOperationException("Cannot get SerializationBinder because an ISerializationBinder was previously set."); - } - set => SerializationBinder = value == null ? null : new SerializationBinderAdapter(value); - } - - /// - /// Gets or sets the used by the serializer when resolving type names. - /// - /// The binder. - public ISerializationBinder? SerializationBinder { get; set; } - - /// - /// Gets or sets the error handler called during serialization and deserialization. - /// - /// The error handler called during serialization and deserialization. - public EventHandler? Error { get; set; } - - /// - /// Gets or sets the used by the serializer when invoking serialization callback methods. - /// - /// The context. - public StreamingContext Context - { - get => _context ?? DefaultContext; - set => _context = value; - } - - /// - /// Gets or sets how and values are formatted when writing JSON text, - /// and the expected date format when reading JSON text. - /// The default value is "yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK". - /// - public string DateFormatString - { - get => _dateFormatString ?? DefaultDateFormatString; - set - { - _dateFormatString = value; - _dateFormatStringSet = true; - } - } - - /// - /// Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a . - /// A null value means there is no maximum. - /// The default value is 64. - /// - public int? MaxDepth - { - get => _maxDepthSet ? _maxDepth : DefaultMaxDepth; - set - { - if (value <= 0) - { - throw new ArgumentException("Value must be positive.", nameof(value)); - } - - _maxDepth = value; - _maxDepthSet = true; - } - } - - /// - /// Indicates how JSON text output is formatted. - /// The default value is . - /// - public Formatting Formatting - { - get => _formatting ?? DefaultFormatting; - set => _formatting = value; - } - - /// - /// Gets or sets how dates are written to JSON text. - /// The default value is . - /// - public DateFormatHandling DateFormatHandling - { - get => _dateFormatHandling ?? DefaultDateFormatHandling; - set => _dateFormatHandling = value; - } - - /// - /// Gets or sets how time zones are handled during serialization and deserialization. - /// The default value is . - /// - public DateTimeZoneHandling DateTimeZoneHandling - { - get => _dateTimeZoneHandling ?? DefaultDateTimeZoneHandling; - set => _dateTimeZoneHandling = value; - } - - /// - /// Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - /// The default value is . - /// - public DateParseHandling DateParseHandling - { - get => _dateParseHandling ?? DefaultDateParseHandling; - set => _dateParseHandling = value; - } - - /// - /// Gets or sets how special floating point numbers, e.g. , - /// and , - /// are written as JSON. - /// The default value is . - /// - public FloatFormatHandling FloatFormatHandling - { - get => _floatFormatHandling ?? DefaultFloatFormatHandling; - set => _floatFormatHandling = value; - } - - /// - /// Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - /// The default value is . - /// - public FloatParseHandling FloatParseHandling - { - get => _floatParseHandling ?? DefaultFloatParseHandling; - set => _floatParseHandling = value; - } - - /// - /// Gets or sets how strings are escaped when writing JSON text. - /// The default value is . - /// - public StringEscapeHandling StringEscapeHandling - { - get => _stringEscapeHandling ?? DefaultStringEscapeHandling; - set => _stringEscapeHandling = value; - } - - /// - /// Gets or sets the culture used when reading JSON. - /// The default value is . - /// - public CultureInfo Culture - { - get => _culture ?? DefaultCulture; - set => _culture = value; - } - - /// - /// Gets a value indicating whether there will be a check for additional content after deserializing an object. - /// The default value is false. - /// - /// - /// true if there will be a check for additional content after deserializing an object; otherwise, false. - /// - public bool CheckAdditionalContent - { - get => _checkAdditionalContent ?? DefaultCheckAdditionalContent; - set => _checkAdditionalContent = value; - } - - static JsonSerializerSettings() - { - DefaultContext = new StreamingContext(); - DefaultCulture = CultureInfo.InvariantCulture; - } - - /// - /// Initializes a new instance of the class. - /// - [DebuggerStepThrough] - public JsonSerializerSettings() - { - Converters = new List(); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonTextReader.Async.cs b/Source/MyDb/Newtonsoft.Json/JsonTextReader.Async.cs deleted file mode 100644 index 7963f5b..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonTextReader.Async.cs +++ /dev/null @@ -1,1806 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System; -using System.Globalization; -using System.Threading; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using System.Threading.Tasks; -using Newtonsoft.Json.Serialization; -using Newtonsoft.Json.Utilities; -using System.Diagnostics; - -namespace Newtonsoft.Json -{ - public partial class JsonTextReader - { - // It's not safe to perform the async methods here in a derived class as if the synchronous equivalent - // has been overriden then the asychronous method will no longer be doing the same operation -#if HAVE_ASYNC // Double-check this isn't included inappropriately. - private readonly bool _safeAsync; -#endif - - /// - /// Asynchronously reads the next JSON token from the source. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns true if the next token was read successfully; false if there are no more tokens to read. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task ReadAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoReadAsync(cancellationToken) : base.ReadAsync(cancellationToken); - } - - internal Task DoReadAsync(CancellationToken cancellationToken) - { - EnsureBuffer(); - - while (true) - { - switch (_currentState) - { - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - return ParseValueAsync(cancellationToken); - case State.Object: - case State.ObjectStart: - return ParseObjectAsync(cancellationToken); - case State.PostValue: - Task task = ParsePostValueAsync(false, cancellationToken); - if (task.IsCompletedSucessfully()) - { - if (task.Result) - { - return AsyncUtils.True; - } - } - else - { - return DoReadAsync(task, cancellationToken); - } - break; - case State.Finished: - return ReadFromFinishedAsync(cancellationToken); - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - } - - private async Task DoReadAsync(Task task, CancellationToken cancellationToken) - { - bool result = await task.ConfigureAwait(false); - if (result) - { - return true; - } - return await DoReadAsync(cancellationToken).ConfigureAwait(false); - } - - private async Task ParsePostValueAsync(bool ignoreComments, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (_charsUsed == _charPos) - { - if (await ReadDataAsync(false, cancellationToken).ConfigureAwait(false) == 0) - { - _currentState = State.Finished; - return false; - } - } - else - { - _charPos++; - } - - break; - case '}': - _charPos++; - SetToken(JsonToken.EndObject); - return true; - case ']': - _charPos++; - SetToken(JsonToken.EndArray); - return true; - case ')': - _charPos++; - SetToken(JsonToken.EndConstructor); - return true; - case '/': - await ParseCommentAsync(!ignoreComments, cancellationToken).ConfigureAwait(false); - if (!ignoreComments) - { - return true; - } - break; - case ',': - _charPos++; - - // finished parsing - SetStateBasedOnCurrent(); - return false; - case ' ': - case StringUtils.Tab: - - // eat - _charPos++; - break; - case StringUtils.CarriageReturn: - await ProcessCarriageReturnAsync(false, cancellationToken).ConfigureAwait(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - default: - if (char.IsWhiteSpace(currentChar)) - { - // eat - _charPos++; - } - else - { - // handle multiple content without comma delimiter - if (SupportMultipleContent && Depth == 0) - { - SetStateBasedOnCurrent(); - return false; - } - - throw JsonReaderException.Create(this, "After parsing a value an unexpected character was encountered: {0}.".FormatWith(CultureInfo.InvariantCulture, currentChar)); - } - - break; - } - } - } - - private async Task ReadFromFinishedAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - if (await EnsureCharsAsync(0, false, cancellationToken).ConfigureAwait(false)) - { - await EatWhitespaceAsync(cancellationToken).ConfigureAwait(false); - if (_isEndOfFile) - { - SetToken(JsonToken.None); - return false; - } - - if (_chars[_charPos] == '/') - { - await ParseCommentAsync(true, cancellationToken).ConfigureAwait(false); - return true; - } - - throw JsonReaderException.Create(this, "Additional text encountered after finished reading JSON content: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - - SetToken(JsonToken.None); - return false; - } - - private Task ReadDataAsync(bool append, CancellationToken cancellationToken) - { - return ReadDataAsync(append, 0, cancellationToken); - } - - private async Task ReadDataAsync(bool append, int charsRequired, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - if (_isEndOfFile) - { - return 0; - } - - PrepareBufferForReadData(append, charsRequired); - - int charsRead = await _reader.ReadAsync(_chars, _charsUsed, _chars.Length - _charsUsed - 1, cancellationToken).ConfigureAwait(false); - - _charsUsed += charsRead; - - if (charsRead == 0) - { - _isEndOfFile = true; - } - - _chars[_charsUsed] = '\0'; - return charsRead; - } - - private async Task ParseValueAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (_charsUsed == _charPos) - { - if (await ReadDataAsync(false, cancellationToken).ConfigureAwait(false) == 0) - { - return false; - } - } - else - { - _charPos++; - } - - break; - case '"': - case '\'': - await ParseStringAsync(currentChar, ReadType.Read, cancellationToken).ConfigureAwait(false); - return true; - case 't': - await ParseTrueAsync(cancellationToken).ConfigureAwait(false); - return true; - case 'f': - await ParseFalseAsync(cancellationToken).ConfigureAwait(false); - return true; - case 'n': - if (await EnsureCharsAsync(1, true, cancellationToken).ConfigureAwait(false)) - { - switch (_chars[_charPos + 1]) - { - case 'u': - await ParseNullAsync(cancellationToken).ConfigureAwait(false); - break; - case 'e': - await ParseConstructorAsync(cancellationToken).ConfigureAwait(false); - break; - default: - throw CreateUnexpectedCharacterException(_chars[_charPos]); - } - } - else - { - _charPos++; - throw CreateUnexpectedEndException(); - } - - return true; - case 'N': - await ParseNumberNaNAsync(ReadType.Read, cancellationToken).ConfigureAwait(false); - return true; - case 'I': - await ParseNumberPositiveInfinityAsync(ReadType.Read, cancellationToken).ConfigureAwait(false); - return true; - case '-': - if (await EnsureCharsAsync(1, true, cancellationToken).ConfigureAwait(false) && _chars[_charPos + 1] == 'I') - { - await ParseNumberNegativeInfinityAsync(ReadType.Read, cancellationToken).ConfigureAwait(false); - } - else - { - await ParseNumberAsync(ReadType.Read, cancellationToken).ConfigureAwait(false); - } - return true; - case '/': - await ParseCommentAsync(true, cancellationToken).ConfigureAwait(false); - return true; - case 'u': - await ParseUndefinedAsync(cancellationToken).ConfigureAwait(false); - return true; - case '{': - _charPos++; - SetToken(JsonToken.StartObject); - return true; - case '[': - _charPos++; - SetToken(JsonToken.StartArray); - return true; - case ']': - _charPos++; - SetToken(JsonToken.EndArray); - return true; - case ',': - - // don't increment position, the next call to read will handle comma - // this is done to handle multiple empty comma values - SetToken(JsonToken.Undefined); - return true; - case ')': - _charPos++; - SetToken(JsonToken.EndConstructor); - return true; - case StringUtils.CarriageReturn: - await ProcessCarriageReturnAsync(false, cancellationToken).ConfigureAwait(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - - // eat - _charPos++; - break; - default: - if (char.IsWhiteSpace(currentChar)) - { - // eat - _charPos++; - break; - } - - if (char.IsNumber(currentChar) || currentChar == '-' || currentChar == '.') - { - await ParseNumberAsync(ReadType.Read, cancellationToken).ConfigureAwait(false); - return true; - } - - throw CreateUnexpectedCharacterException(currentChar); - } - } - } - - private async Task ReadStringIntoBufferAsync(char quote, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - int charPos = _charPos; - int initialPosition = _charPos; - int lastWritePosition = _charPos; - _stringBuffer.Position = 0; - - while (true) - { - switch (_chars[charPos++]) - { - case '\0': - if (_charsUsed == charPos - 1) - { - charPos--; - - if (await ReadDataAsync(true, cancellationToken).ConfigureAwait(false) == 0) - { - _charPos = charPos; - throw JsonReaderException.Create(this, "Unterminated string. Expected delimiter: {0}.".FormatWith(CultureInfo.InvariantCulture, quote)); - } - } - - break; - case '\\': - _charPos = charPos; - if (!await EnsureCharsAsync(0, true, cancellationToken).ConfigureAwait(false)) - { - throw JsonReaderException.Create(this, "Unterminated string. Expected delimiter: {0}.".FormatWith(CultureInfo.InvariantCulture, quote)); - } - - // start of escape sequence - int escapeStartPos = charPos - 1; - - char currentChar = _chars[charPos]; - charPos++; - - char writeChar; - - switch (currentChar) - { - case 'b': - writeChar = '\b'; - break; - case 't': - writeChar = '\t'; - break; - case 'n': - writeChar = '\n'; - break; - case 'f': - writeChar = '\f'; - break; - case 'r': - writeChar = '\r'; - break; - case '\\': - writeChar = '\\'; - break; - case '"': - case '\'': - case '/': - writeChar = currentChar; - break; - case 'u': - _charPos = charPos; - writeChar = await ParseUnicodeAsync(cancellationToken).ConfigureAwait(false); - - if (StringUtils.IsLowSurrogate(writeChar)) - { - // low surrogate with no preceding high surrogate; this char is replaced - writeChar = UnicodeReplacementChar; - } - else if (StringUtils.IsHighSurrogate(writeChar)) - { - bool anotherHighSurrogate; - - // loop for handling situations where there are multiple consecutive high surrogates - do - { - anotherHighSurrogate = false; - - // potential start of a surrogate pair - if (await EnsureCharsAsync(2, true, cancellationToken).ConfigureAwait(false) && _chars[_charPos] == '\\' && _chars[_charPos + 1] == 'u') - { - char highSurrogate = writeChar; - - _charPos += 2; - writeChar = await ParseUnicodeAsync(cancellationToken).ConfigureAwait(false); - - if (StringUtils.IsLowSurrogate(writeChar)) - { - // a valid surrogate pair! - } - else if (StringUtils.IsHighSurrogate(writeChar)) - { - // another high surrogate; replace current and start check over - highSurrogate = UnicodeReplacementChar; - anotherHighSurrogate = true; - } - else - { - // high surrogate not followed by low surrogate; original char is replaced - highSurrogate = UnicodeReplacementChar; - } - - EnsureBufferNotEmpty(); - - WriteCharToBuffer(highSurrogate, lastWritePosition, escapeStartPos); - lastWritePosition = _charPos; - } - else - { - // there are not enough remaining chars for the low surrogate or is not follow by unicode sequence - // replace high surrogate and continue on as usual - writeChar = UnicodeReplacementChar; - } - } while (anotherHighSurrogate); - } - - charPos = _charPos; - break; - default: - _charPos = charPos; - throw JsonReaderException.Create(this, "Bad JSON escape sequence: {0}.".FormatWith(CultureInfo.InvariantCulture, @"\" + currentChar)); - } - - EnsureBufferNotEmpty(); - WriteCharToBuffer(writeChar, lastWritePosition, escapeStartPos); - - lastWritePosition = charPos; - break; - case StringUtils.CarriageReturn: - _charPos = charPos - 1; - await ProcessCarriageReturnAsync(true, cancellationToken).ConfigureAwait(false); - charPos = _charPos; - break; - case StringUtils.LineFeed: - _charPos = charPos - 1; - ProcessLineFeed(); - charPos = _charPos; - break; - case '"': - case '\'': - if (_chars[charPos - 1] == quote) - { - FinishReadStringIntoBuffer(charPos - 1, initialPosition, lastWritePosition); - return; - } - - break; - } - } - } - - private Task ProcessCarriageReturnAsync(bool append, CancellationToken cancellationToken) - { - _charPos++; - - Task task = EnsureCharsAsync(1, append, cancellationToken); - if (task.IsCompletedSucessfully()) - { - SetNewLine(task.Result); - return AsyncUtils.CompletedTask; - } - - return ProcessCarriageReturnAsync(task); - } - - private async Task ProcessCarriageReturnAsync(Task task) - { - SetNewLine(await task.ConfigureAwait(false)); - } - - private async Task ParseUnicodeAsync(CancellationToken cancellationToken) - { - return ConvertUnicode(await EnsureCharsAsync(4, true, cancellationToken).ConfigureAwait(false)); - } - - private Task EnsureCharsAsync(int relativePosition, bool append, CancellationToken cancellationToken) - { - if (_charPos + relativePosition < _charsUsed) - { - return AsyncUtils.True; - } - - if (_isEndOfFile) - { - return AsyncUtils.False; - } - - return ReadCharsAsync(relativePosition, append, cancellationToken); - } - - private async Task ReadCharsAsync(int relativePosition, bool append, CancellationToken cancellationToken) - { - int charsRequired = _charPos + relativePosition - _charsUsed + 1; - - // it is possible that the TextReader doesn't return all data at once - // repeat read until the required text is returned or the reader is out of content - do - { - int charsRead = await ReadDataAsync(append, charsRequired, cancellationToken).ConfigureAwait(false); - - // no more content - if (charsRead == 0) - { - return false; - } - - charsRequired -= charsRead; - } while (charsRequired > 0); - - return true; - } - - private async Task ParseObjectAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (_charsUsed == _charPos) - { - if (await ReadDataAsync(false, cancellationToken).ConfigureAwait(false) == 0) - { - return false; - } - } - else - { - _charPos++; - } - - break; - case '}': - SetToken(JsonToken.EndObject); - _charPos++; - return true; - case '/': - await ParseCommentAsync(true, cancellationToken).ConfigureAwait(false); - return true; - case StringUtils.CarriageReturn: - await ProcessCarriageReturnAsync(false, cancellationToken).ConfigureAwait(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - - // eat - _charPos++; - break; - default: - if (char.IsWhiteSpace(currentChar)) - { - // eat - _charPos++; - } - else - { - return await ParsePropertyAsync(cancellationToken).ConfigureAwait(false); - } - - break; - } - } - } - - private async Task ParseCommentAsync(bool setToken, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - // should have already parsed / character before reaching this method - _charPos++; - - if (!await EnsureCharsAsync(1, false, cancellationToken).ConfigureAwait(false)) - { - throw JsonReaderException.Create(this, "Unexpected end while parsing comment."); - } - - bool singlelineComment; - - if (_chars[_charPos] == '*') - { - singlelineComment = false; - } - else if (_chars[_charPos] == '/') - { - singlelineComment = true; - } - else - { - throw JsonReaderException.Create(this, "Error parsing comment. Expected: *, got {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - - _charPos++; - - int initialPosition = _charPos; - - while (true) - { - switch (_chars[_charPos]) - { - case '\0': - if (_charsUsed == _charPos) - { - if (await ReadDataAsync(true, cancellationToken).ConfigureAwait(false) == 0) - { - if (!singlelineComment) - { - throw JsonReaderException.Create(this, "Unexpected end while parsing comment."); - } - - EndComment(setToken, initialPosition, _charPos); - return; - } - } - else - { - _charPos++; - } - - break; - case '*': - _charPos++; - - if (!singlelineComment) - { - if (await EnsureCharsAsync(0, true, cancellationToken).ConfigureAwait(false)) - { - if (_chars[_charPos] == '/') - { - EndComment(setToken, initialPosition, _charPos - 1); - - _charPos++; - return; - } - } - } - - break; - case StringUtils.CarriageReturn: - if (singlelineComment) - { - EndComment(setToken, initialPosition, _charPos); - return; - } - - await ProcessCarriageReturnAsync(true, cancellationToken).ConfigureAwait(false); - break; - case StringUtils.LineFeed: - if (singlelineComment) - { - EndComment(setToken, initialPosition, _charPos); - return; - } - - ProcessLineFeed(); - break; - default: - _charPos++; - break; - } - } - } - - private async Task EatWhitespaceAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (_charsUsed == _charPos) - { - if (await ReadDataAsync(false, cancellationToken).ConfigureAwait(false) == 0) - { - return; - } - } - else - { - _charPos++; - } - break; - case StringUtils.CarriageReturn: - await ProcessCarriageReturnAsync(false, cancellationToken).ConfigureAwait(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - default: - if (currentChar == ' ' || char.IsWhiteSpace(currentChar)) - { - _charPos++; - } - else - { - return; - } - break; - } - } - } - - private async Task ParseStringAsync(char quote, ReadType readType, CancellationToken cancellationToken) - { - cancellationToken.ThrowIfCancellationRequested(); - _charPos++; - - ShiftBufferIfNeeded(); - await ReadStringIntoBufferAsync(quote, cancellationToken).ConfigureAwait(false); - ParseReadString(quote, readType); - } - - private async Task MatchValueAsync(string value, CancellationToken cancellationToken) - { - return MatchValue(await EnsureCharsAsync(value.Length - 1, true, cancellationToken).ConfigureAwait(false), value); - } - - private async Task MatchValueWithTrailingSeparatorAsync(string value, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - // will match value and then move to the next character, checking that it is a separator character - if (!await MatchValueAsync(value, cancellationToken).ConfigureAwait(false)) - { - return false; - } - - if (!await EnsureCharsAsync(0, false, cancellationToken).ConfigureAwait(false)) - { - return true; - } - - return IsSeparator(_chars[_charPos]) || _chars[_charPos] == '\0'; - } - - private async Task MatchAndSetAsync(string value, JsonToken newToken, object? tokenValue, CancellationToken cancellationToken) - { - if (await MatchValueWithTrailingSeparatorAsync(value, cancellationToken).ConfigureAwait(false)) - { - SetToken(newToken, tokenValue); - } - else - { - throw JsonReaderException.Create(this, "Error parsing " + newToken.ToString().ToLowerInvariant() + " value."); - } - } - - private Task ParseTrueAsync(CancellationToken cancellationToken) - { - return MatchAndSetAsync(JsonConvert.True, JsonToken.Boolean, true, cancellationToken); - } - - private Task ParseFalseAsync(CancellationToken cancellationToken) - { - return MatchAndSetAsync(JsonConvert.False, JsonToken.Boolean, false, cancellationToken); - } - - private Task ParseNullAsync(CancellationToken cancellationToken) - { - return MatchAndSetAsync(JsonConvert.Null, JsonToken.Null, null, cancellationToken); - } - - private async Task ParseConstructorAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - if (await MatchValueWithTrailingSeparatorAsync("new", cancellationToken).ConfigureAwait(false)) - { - await EatWhitespaceAsync(cancellationToken).ConfigureAwait(false); - - int initialPosition = _charPos; - int endPosition; - - while (true) - { - char currentChar = _chars[_charPos]; - if (currentChar == '\0') - { - if (_charsUsed == _charPos) - { - if (await ReadDataAsync(true, cancellationToken).ConfigureAwait(false) == 0) - { - throw JsonReaderException.Create(this, "Unexpected end while parsing constructor."); - } - } - else - { - endPosition = _charPos; - _charPos++; - break; - } - } - else if (char.IsLetterOrDigit(currentChar)) - { - _charPos++; - } - else if (currentChar == StringUtils.CarriageReturn) - { - endPosition = _charPos; - await ProcessCarriageReturnAsync(true, cancellationToken).ConfigureAwait(false); - break; - } - else if (currentChar == StringUtils.LineFeed) - { - endPosition = _charPos; - ProcessLineFeed(); - break; - } - else if (char.IsWhiteSpace(currentChar)) - { - endPosition = _charPos; - _charPos++; - break; - } - else if (currentChar == '(') - { - endPosition = _charPos; - break; - } - else - { - throw JsonReaderException.Create(this, "Unexpected character while parsing constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, currentChar)); - } - } - - _stringReference = new StringReference(_chars, initialPosition, endPosition - initialPosition); - string constructorName = _stringReference.ToString(); - - await EatWhitespaceAsync(cancellationToken).ConfigureAwait(false); - - if (_chars[_charPos] != '(') - { - throw JsonReaderException.Create(this, "Unexpected character while parsing constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - - _charPos++; - - ClearRecentString(); - - SetToken(JsonToken.StartConstructor, constructorName); - } - else - { - throw JsonReaderException.Create(this, "Unexpected content while parsing JSON."); - } - } - - private async Task ParseNumberNaNAsync(ReadType readType, CancellationToken cancellationToken) - { - return ParseNumberNaN(readType, await MatchValueWithTrailingSeparatorAsync(JsonConvert.NaN, cancellationToken).ConfigureAwait(false)); - } - - private async Task ParseNumberPositiveInfinityAsync(ReadType readType, CancellationToken cancellationToken) - { - return ParseNumberPositiveInfinity(readType, await MatchValueWithTrailingSeparatorAsync(JsonConvert.PositiveInfinity, cancellationToken).ConfigureAwait(false)); - } - - private async Task ParseNumberNegativeInfinityAsync(ReadType readType, CancellationToken cancellationToken) - { - return ParseNumberNegativeInfinity(readType, await MatchValueWithTrailingSeparatorAsync(JsonConvert.NegativeInfinity, cancellationToken).ConfigureAwait(false)); - } - - private async Task ParseNumberAsync(ReadType readType, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - ShiftBufferIfNeeded(); - - char firstChar = _chars[_charPos]; - int initialPosition = _charPos; - - await ReadNumberIntoBufferAsync(cancellationToken).ConfigureAwait(false); - - ParseReadNumber(readType, firstChar, initialPosition); - } - - private Task ParseUndefinedAsync(CancellationToken cancellationToken) - { - return MatchAndSetAsync(JsonConvert.Undefined, JsonToken.Undefined, null, cancellationToken); - } - - private async Task ParsePropertyAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - char firstChar = _chars[_charPos]; - char quoteChar; - - if (firstChar == '"' || firstChar == '\'') - { - _charPos++; - quoteChar = firstChar; - ShiftBufferIfNeeded(); - await ReadStringIntoBufferAsync(quoteChar, cancellationToken).ConfigureAwait(false); - } - else if (ValidIdentifierChar(firstChar)) - { - quoteChar = '\0'; - ShiftBufferIfNeeded(); - await ParseUnquotedPropertyAsync(cancellationToken).ConfigureAwait(false); - } - else - { - throw JsonReaderException.Create(this, "Invalid property identifier character: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - - string propertyName; - - if (PropertyNameTable != null) - { - propertyName = PropertyNameTable.Get(_stringReference.Chars, _stringReference.StartIndex, _stringReference.Length) - // no match in name table - ?? _stringReference.ToString(); - } - else - { - propertyName = _stringReference.ToString(); - } - - await EatWhitespaceAsync(cancellationToken).ConfigureAwait(false); - - if (_chars[_charPos] != ':') - { - throw JsonReaderException.Create(this, "Invalid character after parsing property name. Expected ':' but got: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - - _charPos++; - - SetToken(JsonToken.PropertyName, propertyName); - _quoteChar = quoteChar; - ClearRecentString(); - - return true; - } - - private async Task ReadNumberIntoBufferAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - int charPos = _charPos; - - while (true) - { - char currentChar = _chars[charPos]; - if (currentChar == '\0') - { - _charPos = charPos; - - if (_charsUsed == charPos) - { - if (await ReadDataAsync(true, cancellationToken).ConfigureAwait(false) == 0) - { - return; - } - } - else - { - return; - } - } - else if (ReadNumberCharIntoBuffer(currentChar, charPos)) - { - return; - } - else - { - charPos++; - } - } - } - - private async Task ParseUnquotedPropertyAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - int initialPosition = _charPos; - - // parse unquoted property name until whitespace or colon - while (true) - { - char currentChar = _chars[_charPos]; - if (currentChar == '\0') - { - if (_charsUsed == _charPos) - { - if (await ReadDataAsync(true, cancellationToken).ConfigureAwait(false) == 0) - { - throw JsonReaderException.Create(this, "Unexpected end while parsing unquoted property name."); - } - - continue; - } - - _stringReference = new StringReference(_chars, initialPosition, _charPos - initialPosition); - return; - } - - if (ReadUnquotedPropertyReportIfDone(currentChar, initialPosition)) - { - return; - } - } - } - - private async Task ReadNullCharAsync(CancellationToken cancellationToken) - { - if (_charsUsed == _charPos) - { - if (await ReadDataAsync(false, cancellationToken).ConfigureAwait(false) == 0) - { - _isEndOfFile = true; - return true; - } - } - else - { - _charPos++; - } - - return false; - } - - private async Task HandleNullAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - if (await EnsureCharsAsync(1, true, cancellationToken).ConfigureAwait(false)) - { - if (_chars[_charPos + 1] == 'u') - { - await ParseNullAsync(cancellationToken).ConfigureAwait(false); - return; - } - - _charPos += 2; - throw CreateUnexpectedCharacterException(_chars[_charPos - 1]); - } - - _charPos = _charsUsed; - throw CreateUnexpectedEndException(); - } - - private async Task ReadFinishedAsync(CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_chars != null); - - if (await EnsureCharsAsync(0, false, cancellationToken).ConfigureAwait(false)) - { - await EatWhitespaceAsync(cancellationToken).ConfigureAwait(false); - if (_isEndOfFile) - { - SetToken(JsonToken.None); - return; - } - - if (_chars[_charPos] == '/') - { - await ParseCommentAsync(false, cancellationToken).ConfigureAwait(false); - } - else - { - throw JsonReaderException.Create(this, "Additional text encountered after finished reading JSON content: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - } - - SetToken(JsonToken.None); - } - - private async Task ReadStringValueAsync(ReadType readType, CancellationToken cancellationToken) - { - EnsureBuffer(); - MiscellaneousUtils.Assert(_chars != null); - - switch (_currentState) - { - case State.PostValue: - if (await ParsePostValueAsync(true, cancellationToken).ConfigureAwait(false)) - { - return null; - } - goto case State.Start; - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (await ReadNullCharAsync(cancellationToken).ConfigureAwait(false)) - { - SetToken(JsonToken.None, null, false); - return null; - } - - break; - case '"': - case '\'': - await ParseStringAsync(currentChar, readType, cancellationToken).ConfigureAwait(false); - return FinishReadQuotedStringValue(readType); - case '-': - if (await EnsureCharsAsync(1, true, cancellationToken).ConfigureAwait(false) && _chars[_charPos + 1] == 'I') - { - return ParseNumberNegativeInfinity(readType); - } - else - { - await ParseNumberAsync(readType, cancellationToken).ConfigureAwait(false); - return Value; - } - case '.': - case '0': - case '1': - case '2': - case '3': - case '4': - case '5': - case '6': - case '7': - case '8': - case '9': - if (readType != ReadType.ReadAsString) - { - _charPos++; - throw CreateUnexpectedCharacterException(currentChar); - } - - await ParseNumberAsync(ReadType.ReadAsString, cancellationToken).ConfigureAwait(false); - return Value; - case 't': - case 'f': - if (readType != ReadType.ReadAsString) - { - _charPos++; - throw CreateUnexpectedCharacterException(currentChar); - } - - string expected = currentChar == 't' ? JsonConvert.True : JsonConvert.False; - if (!await MatchValueWithTrailingSeparatorAsync(expected, cancellationToken).ConfigureAwait(false)) - { - throw CreateUnexpectedCharacterException(_chars[_charPos]); - } - - SetToken(JsonToken.String, expected); - return expected; - case 'I': - return await ParseNumberPositiveInfinityAsync(readType, cancellationToken).ConfigureAwait(false); - case 'N': - return await ParseNumberNaNAsync(readType, cancellationToken).ConfigureAwait(false); - case 'n': - await HandleNullAsync(cancellationToken).ConfigureAwait(false); - return null; - case '/': - await ParseCommentAsync(false, cancellationToken).ConfigureAwait(false); - break; - case ',': - ProcessValueComma(); - break; - case ']': - _charPos++; - if (_currentState == State.Array || _currentState == State.ArrayStart || _currentState == State.PostValue) - { - SetToken(JsonToken.EndArray); - return null; - } - - throw CreateUnexpectedCharacterException(currentChar); - case StringUtils.CarriageReturn: - await ProcessCarriageReturnAsync(false, cancellationToken).ConfigureAwait(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - - // eat - _charPos++; - break; - default: - _charPos++; - - if (!char.IsWhiteSpace(currentChar)) - { - throw CreateUnexpectedCharacterException(currentChar); - } - - // eat - break; - } - } - case State.Finished: - await ReadFinishedAsync(cancellationToken).ConfigureAwait(false); - return null; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - - private async Task ReadNumberValueAsync(ReadType readType, CancellationToken cancellationToken) - { - EnsureBuffer(); - MiscellaneousUtils.Assert(_chars != null); - - switch (_currentState) - { - case State.PostValue: - if (await ParsePostValueAsync(true, cancellationToken).ConfigureAwait(false)) - { - return null; - } - goto case State.Start; - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (await ReadNullCharAsync(cancellationToken).ConfigureAwait(false)) - { - SetToken(JsonToken.None, null, false); - return null; - } - - break; - case '"': - case '\'': - await ParseStringAsync(currentChar, readType, cancellationToken).ConfigureAwait(false); - return FinishReadQuotedNumber(readType); - case 'n': - await HandleNullAsync(cancellationToken).ConfigureAwait(false); - return null; - case 'N': - return await ParseNumberNaNAsync(readType, cancellationToken).ConfigureAwait(false); - case 'I': - return await ParseNumberPositiveInfinityAsync(readType, cancellationToken).ConfigureAwait(false); - case '-': - if (await EnsureCharsAsync(1, true, cancellationToken).ConfigureAwait(false) && _chars[_charPos + 1] == 'I') - { - return await ParseNumberNegativeInfinityAsync(readType, cancellationToken).ConfigureAwait(false); - } - else - { - await ParseNumberAsync(readType, cancellationToken).ConfigureAwait(false); - return Value; - } - case '.': - case '0': - case '1': - case '2': - case '3': - case '4': - case '5': - case '6': - case '7': - case '8': - case '9': - await ParseNumberAsync(readType, cancellationToken).ConfigureAwait(false); - return Value; - case '/': - await ParseCommentAsync(false, cancellationToken).ConfigureAwait(false); - break; - case ',': - ProcessValueComma(); - break; - case ']': - _charPos++; - if (_currentState == State.Array || _currentState == State.ArrayStart || _currentState == State.PostValue) - { - SetToken(JsonToken.EndArray); - return null; - } - - throw CreateUnexpectedCharacterException(currentChar); - case StringUtils.CarriageReturn: - await ProcessCarriageReturnAsync(false, cancellationToken).ConfigureAwait(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - - // eat - _charPos++; - break; - default: - _charPos++; - - if (!char.IsWhiteSpace(currentChar)) - { - throw CreateUnexpectedCharacterException(currentChar); - } - - // eat - break; - } - } - case State.Finished: - await ReadFinishedAsync(cancellationToken).ConfigureAwait(false); - return null; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task ReadAsBooleanAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoReadAsBooleanAsync(cancellationToken) : base.ReadAsBooleanAsync(cancellationToken); - } - - internal async Task DoReadAsBooleanAsync(CancellationToken cancellationToken) - { - EnsureBuffer(); - MiscellaneousUtils.Assert(_chars != null); - - switch (_currentState) - { - case State.PostValue: - if (await ParsePostValueAsync(true, cancellationToken).ConfigureAwait(false)) - { - return null; - } - goto case State.Start; - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (await ReadNullCharAsync(cancellationToken).ConfigureAwait(false)) - { - SetToken(JsonToken.None, null, false); - return null; - } - - break; - case '"': - case '\'': - await ParseStringAsync(currentChar, ReadType.Read, cancellationToken).ConfigureAwait(false); - return ReadBooleanString(_stringReference.ToString()); - case 'n': - await HandleNullAsync(cancellationToken).ConfigureAwait(false); - return null; - case '-': - case '.': - case '0': - case '1': - case '2': - case '3': - case '4': - case '5': - case '6': - case '7': - case '8': - case '9': - await ParseNumberAsync(ReadType.Read, cancellationToken).ConfigureAwait(false); - bool b; -#if HAVE_BIG_INTEGER - if (Value is BigInteger i) - { - b = i != 0; - } - else -#endif - { - b = Convert.ToBoolean(Value, CultureInfo.InvariantCulture); - } - SetToken(JsonToken.Boolean, b, false); - return b; - case 't': - case 'f': - bool isTrue = currentChar == 't'; - if (!await MatchValueWithTrailingSeparatorAsync(isTrue ? JsonConvert.True : JsonConvert.False, cancellationToken).ConfigureAwait(false)) - { - throw CreateUnexpectedCharacterException(_chars[_charPos]); - } - - SetToken(JsonToken.Boolean, isTrue); - return isTrue; - case '/': - await ParseCommentAsync(false, cancellationToken).ConfigureAwait(false); - break; - case ',': - ProcessValueComma(); - break; - case ']': - _charPos++; - if (_currentState == State.Array || _currentState == State.ArrayStart || _currentState == State.PostValue) - { - SetToken(JsonToken.EndArray); - return null; - } - - throw CreateUnexpectedCharacterException(currentChar); - case StringUtils.CarriageReturn: - await ProcessCarriageReturnAsync(false, cancellationToken).ConfigureAwait(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - - // eat - _charPos++; - break; - default: - _charPos++; - - if (!char.IsWhiteSpace(currentChar)) - { - throw CreateUnexpectedCharacterException(currentChar); - } - - // eat - break; - } - } - case State.Finished: - await ReadFinishedAsync(cancellationToken).ConfigureAwait(false); - return null; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - - /// - /// Asynchronously reads the next JSON token from the source as a []. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the []. This result will be null at the end of an array. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task ReadAsBytesAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoReadAsBytesAsync(cancellationToken) : base.ReadAsBytesAsync(cancellationToken); - } - - internal async Task DoReadAsBytesAsync(CancellationToken cancellationToken) - { - EnsureBuffer(); - MiscellaneousUtils.Assert(_chars != null); - - bool isWrapped = false; - - switch (_currentState) - { - case State.PostValue: - if (await ParsePostValueAsync(true, cancellationToken).ConfigureAwait(false)) - { - return null; - } - goto case State.Start; - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (await ReadNullCharAsync(cancellationToken).ConfigureAwait(false)) - { - SetToken(JsonToken.None, null, false); - return null; - } - - break; - case '"': - case '\'': - await ParseStringAsync(currentChar, ReadType.ReadAsBytes, cancellationToken).ConfigureAwait(false); - byte[]? data = (byte[]?)Value; - if (isWrapped) - { - await ReaderReadAndAssertAsync(cancellationToken).ConfigureAwait(false); - if (TokenType != JsonToken.EndObject) - { - throw JsonReaderException.Create(this, "Error reading bytes. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, TokenType)); - } - - SetToken(JsonToken.Bytes, data, false); - } - - return data; - case '{': - _charPos++; - SetToken(JsonToken.StartObject); - await ReadIntoWrappedTypeObjectAsync(cancellationToken).ConfigureAwait(false); - isWrapped = true; - break; - case '[': - _charPos++; - SetToken(JsonToken.StartArray); - return await ReadArrayIntoByteArrayAsync(cancellationToken).ConfigureAwait(false); - case 'n': - await HandleNullAsync(cancellationToken).ConfigureAwait(false); - return null; - case '/': - await ParseCommentAsync(false, cancellationToken).ConfigureAwait(false); - break; - case ',': - ProcessValueComma(); - break; - case ']': - _charPos++; - if (_currentState == State.Array || _currentState == State.ArrayStart || _currentState == State.PostValue) - { - SetToken(JsonToken.EndArray); - return null; - } - - throw CreateUnexpectedCharacterException(currentChar); - case StringUtils.CarriageReturn: - await ProcessCarriageReturnAsync(false, cancellationToken).ConfigureAwait(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - - // eat - _charPos++; - break; - default: - _charPos++; - - if (!char.IsWhiteSpace(currentChar)) - { - throw CreateUnexpectedCharacterException(currentChar); - } - - // eat - break; - } - } - case State.Finished: - await ReadFinishedAsync(cancellationToken).ConfigureAwait(false); - return null; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - - private async Task ReadIntoWrappedTypeObjectAsync(CancellationToken cancellationToken) - { - await ReaderReadAndAssertAsync(cancellationToken).ConfigureAwait(false); - if (Value != null && Value.ToString() == JsonTypeReflector.TypePropertyName) - { - await ReaderReadAndAssertAsync(cancellationToken).ConfigureAwait(false); - if (Value != null && Value.ToString().StartsWith("System.Byte[]", StringComparison.Ordinal)) - { - await ReaderReadAndAssertAsync(cancellationToken).ConfigureAwait(false); - if (Value.ToString() == JsonTypeReflector.ValuePropertyName) - { - return; - } - } - } - - throw JsonReaderException.Create(this, "Error reading bytes. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, JsonToken.StartObject)); - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task ReadAsDateTimeAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoReadAsDateTimeAsync(cancellationToken) : base.ReadAsDateTimeAsync(cancellationToken); - } - - internal async Task DoReadAsDateTimeAsync(CancellationToken cancellationToken) - { - return (DateTime?)await ReadStringValueAsync(ReadType.ReadAsDateTime, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task ReadAsDateTimeOffsetAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoReadAsDateTimeOffsetAsync(cancellationToken) : base.ReadAsDateTimeOffsetAsync(cancellationToken); - } - - internal async Task DoReadAsDateTimeOffsetAsync(CancellationToken cancellationToken) - { - return (DateTimeOffset?)await ReadStringValueAsync(ReadType.ReadAsDateTimeOffset, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task ReadAsDecimalAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoReadAsDecimalAsync(cancellationToken) : base.ReadAsDecimalAsync(cancellationToken); - } - - internal async Task DoReadAsDecimalAsync(CancellationToken cancellationToken) - { - return (decimal?)await ReadNumberValueAsync(ReadType.ReadAsDecimal, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task ReadAsDoubleAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoReadAsDoubleAsync(cancellationToken) : base.ReadAsDoubleAsync(cancellationToken); - } - - internal async Task DoReadAsDoubleAsync(CancellationToken cancellationToken) - { - return (double?)await ReadNumberValueAsync(ReadType.ReadAsDouble, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously reads the next JSON token from the source as a of . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the of . This result will be null at the end of an array. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task ReadAsInt32Async(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoReadAsInt32Async(cancellationToken) : base.ReadAsInt32Async(cancellationToken); - } - - internal async Task DoReadAsInt32Async(CancellationToken cancellationToken) - { - return (int?)await ReadNumberValueAsync(ReadType.ReadAsInt32, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously reads the next JSON token from the source as a . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous read. The - /// property returns the . This result will be null at the end of an array. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task ReadAsStringAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoReadAsStringAsync(cancellationToken) : base.ReadAsStringAsync(cancellationToken); - } - - internal async Task DoReadAsStringAsync(CancellationToken cancellationToken) - { - return (string?)await ReadStringValueAsync(ReadType.ReadAsString, cancellationToken).ConfigureAwait(false); - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/JsonTextReader.cs b/Source/MyDb/Newtonsoft.Json/JsonTextReader.cs deleted file mode 100644 index 0ef5b0e..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonTextReader.cs +++ /dev/null @@ -1,2655 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Runtime.CompilerServices; -using System.IO; -using System.Globalization; -using System.Diagnostics; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json -{ - internal enum ReadType - { - Read, - ReadAsInt32, - ReadAsInt64, - ReadAsBytes, - ReadAsString, - ReadAsDecimal, - ReadAsDateTime, -#if HAVE_DATE_TIME_OFFSET - ReadAsDateTimeOffset, -#endif - ReadAsDouble, - ReadAsBoolean - } - - /// - /// Represents a reader that provides fast, non-cached, forward-only access to JSON text data. - /// - public partial class JsonTextReader : JsonReader, IJsonLineInfo - { - private const char UnicodeReplacementChar = '\uFFFD'; -#if HAVE_BIG_INTEGER - private const int MaximumJavascriptIntegerCharacterLength = 380; -#endif -#if DEBUG - internal int LargeBufferLength { get; set; } = int.MaxValue / 2; -#else - private const int LargeBufferLength = int.MaxValue / 2; -#endif - - private readonly TextReader _reader; - private char[]? _chars; - private int _charsUsed; - private int _charPos; - private int _lineStartPos; - private int _lineNumber; - private bool _isEndOfFile; - private StringBuffer _stringBuffer; - private StringReference _stringReference; - private IArrayPool? _arrayPool; - - /// - /// Initializes a new instance of the class with the specified . - /// - /// The containing the JSON data to read. - public JsonTextReader(TextReader reader) - { - if (reader == null) - { - throw new ArgumentNullException(nameof(reader)); - } - - _reader = reader; - _lineNumber = 1; - -#if HAVE_ASYNC - _safeAsync = GetType() == typeof(JsonTextReader); -#endif - } - -#if DEBUG - internal char[]? CharBuffer - { - get => _chars; - set => _chars = value; - } - - internal int CharPos => _charPos; -#endif - - /// - /// Gets or sets the reader's property name table. - /// - public JsonNameTable? PropertyNameTable { get; set; } - - /// - /// Gets or sets the reader's character buffer pool. - /// - public IArrayPool? ArrayPool - { - get => _arrayPool; - set - { - if (value == null) - { - throw new ArgumentNullException(nameof(value)); - } - - _arrayPool = value; - } - } - - private void EnsureBufferNotEmpty() - { - if (_stringBuffer.IsEmpty) - { - _stringBuffer = new StringBuffer(_arrayPool, 1024); - } - } - - private void SetNewLine(bool hasNextChar) - { - MiscellaneousUtils.Assert(_chars != null); - - if (hasNextChar && _chars[_charPos] == StringUtils.LineFeed) - { - _charPos++; - } - - OnNewLine(_charPos); - } - - private void OnNewLine(int pos) - { - _lineNumber++; - _lineStartPos = pos; - } - - private void ParseString(char quote, ReadType readType) - { - _charPos++; - - ShiftBufferIfNeeded(); - ReadStringIntoBuffer(quote); - ParseReadString(quote, readType); - } - - private void ParseReadString(char quote, ReadType readType) - { - SetPostValueState(true); - - switch (readType) - { - case ReadType.ReadAsBytes: - Guid g; - byte[] data; - if (_stringReference.Length == 0) - { - data = CollectionUtils.ArrayEmpty(); - } - else if (_stringReference.Length == 36 && ConvertUtils.TryConvertGuid(_stringReference.ToString(), out g)) - { - data = g.ToByteArray(); - } - else - { - data = Convert.FromBase64CharArray(_stringReference.Chars, _stringReference.StartIndex, _stringReference.Length); - } - - SetToken(JsonToken.Bytes, data, false); - break; - case ReadType.ReadAsString: - string text = _stringReference.ToString(); - - SetToken(JsonToken.String, text, false); - _quoteChar = quote; - break; - case ReadType.ReadAsInt32: - case ReadType.ReadAsDecimal: - case ReadType.ReadAsBoolean: - // caller will convert result - break; - default: - if (_dateParseHandling != DateParseHandling.None) - { - DateParseHandling dateParseHandling; - if (readType == ReadType.ReadAsDateTime) - { - dateParseHandling = DateParseHandling.DateTime; - } -#if HAVE_DATE_TIME_OFFSET - else if (readType == ReadType.ReadAsDateTimeOffset) - { - dateParseHandling = DateParseHandling.DateTimeOffset; - } -#endif - else - { - dateParseHandling = _dateParseHandling; - } - - if (dateParseHandling == DateParseHandling.DateTime) - { - if (DateTimeUtils.TryParseDateTime(_stringReference, DateTimeZoneHandling, DateFormatString, Culture, out DateTime dt)) - { - SetToken(JsonToken.Date, dt, false); - return; - } - } -#if HAVE_DATE_TIME_OFFSET - else - { - if (DateTimeUtils.TryParseDateTimeOffset(_stringReference, DateFormatString, Culture, out DateTimeOffset dt)) - { - SetToken(JsonToken.Date, dt, false); - return; - } - } -#endif - } - - SetToken(JsonToken.String, _stringReference.ToString(), false); - _quoteChar = quote; - break; - } - } - - private static void BlockCopyChars(char[] src, int srcOffset, char[] dst, int dstOffset, int count) - { - const int charByteCount = 2; - - Buffer.BlockCopy(src, srcOffset * charByteCount, dst, dstOffset * charByteCount, count * charByteCount); - } - - private void ShiftBufferIfNeeded() - { - MiscellaneousUtils.Assert(_chars != null); - - // once in the last 10% of the buffer, or buffer is already very large then - // shift the remaining content to the start to avoid unnecessarily increasing - // the buffer size when reading numbers/strings - int length = _chars.Length; - if (length - _charPos <= length * 0.1 || length >= LargeBufferLength) - { - int count = _charsUsed - _charPos; - if (count > 0) - { - BlockCopyChars(_chars, _charPos, _chars, 0, count); - } - - _lineStartPos -= _charPos; - _charPos = 0; - _charsUsed = count; - _chars[_charsUsed] = '\0'; - } - } - - private int ReadData(bool append) - { - return ReadData(append, 0); - } - - private void PrepareBufferForReadData(bool append, int charsRequired) - { - MiscellaneousUtils.Assert(_chars != null); - - // char buffer is full - if (_charsUsed + charsRequired >= _chars.Length - 1) - { - if (append) - { - int doubledArrayLength = _chars.Length * 2; - - // copy to new array either double the size of the current or big enough to fit required content - int newArrayLength = Math.Max( - doubledArrayLength < 0 ? int.MaxValue : doubledArrayLength, // handle overflow - _charsUsed + charsRequired + 1); - - // increase the size of the buffer - char[] dst = BufferUtils.RentBuffer(_arrayPool, newArrayLength); - - BlockCopyChars(_chars, 0, dst, 0, _chars.Length); - - BufferUtils.ReturnBuffer(_arrayPool, _chars); - - _chars = dst; - } - else - { - int remainingCharCount = _charsUsed - _charPos; - - if (remainingCharCount + charsRequired + 1 >= _chars.Length) - { - // the remaining count plus the required is bigger than the current buffer size - char[] dst = BufferUtils.RentBuffer(_arrayPool, remainingCharCount + charsRequired + 1); - - if (remainingCharCount > 0) - { - BlockCopyChars(_chars, _charPos, dst, 0, remainingCharCount); - } - - BufferUtils.ReturnBuffer(_arrayPool, _chars); - - _chars = dst; - } - else - { - // copy any remaining data to the beginning of the buffer if needed and reset positions - if (remainingCharCount > 0) - { - BlockCopyChars(_chars, _charPos, _chars, 0, remainingCharCount); - } - } - - _lineStartPos -= _charPos; - _charPos = 0; - _charsUsed = remainingCharCount; - } - } - } - - private int ReadData(bool append, int charsRequired) - { - if (_isEndOfFile) - { - return 0; - } - - PrepareBufferForReadData(append, charsRequired); - MiscellaneousUtils.Assert(_chars != null); - - int attemptCharReadCount = _chars.Length - _charsUsed - 1; - - int charsRead = _reader.Read(_chars, _charsUsed, attemptCharReadCount); - - _charsUsed += charsRead; - - if (charsRead == 0) - { - _isEndOfFile = true; - } - - _chars[_charsUsed] = '\0'; - return charsRead; - } - - private bool EnsureChars(int relativePosition, bool append) - { - if (_charPos + relativePosition >= _charsUsed) - { - return ReadChars(relativePosition, append); - } - - return true; - } - - private bool ReadChars(int relativePosition, bool append) - { - if (_isEndOfFile) - { - return false; - } - - int charsRequired = _charPos + relativePosition - _charsUsed + 1; - - int totalCharsRead = 0; - - // it is possible that the TextReader doesn't return all data at once - // repeat read until the required text is returned or the reader is out of content - do - { - int charsRead = ReadData(append, charsRequired - totalCharsRead); - - // no more content - if (charsRead == 0) - { - break; - } - - totalCharsRead += charsRead; - } while (totalCharsRead < charsRequired); - - if (totalCharsRead < charsRequired) - { - return false; - } - return true; - } - - /// - /// Reads the next JSON token from the underlying . - /// - /// - /// true if the next token was read successfully; false if there are no more tokens to read. - /// - public override bool Read() - { - EnsureBuffer(); - MiscellaneousUtils.Assert(_chars != null); - - while (true) - { - switch (_currentState) - { - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - return ParseValue(); - case State.Object: - case State.ObjectStart: - return ParseObject(); - case State.PostValue: - // returns true if it hits - // end of object or array - if (ParsePostValue(false)) - { - return true; - } - break; - case State.Finished: - if (EnsureChars(0, false)) - { - EatWhitespace(); - if (_isEndOfFile) - { - SetToken(JsonToken.None); - return false; - } - if (_chars[_charPos] == '/') - { - ParseComment(true); - return true; - } - - throw JsonReaderException.Create(this, "Additional text encountered after finished reading JSON content: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - SetToken(JsonToken.None); - return false; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - } - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . This method will return null at the end of an array. - public override int? ReadAsInt32() - { - return (int?)ReadNumberValue(ReadType.ReadAsInt32); - } - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . This method will return null at the end of an array. - public override DateTime? ReadAsDateTime() - { - return (DateTime?)ReadStringValue(ReadType.ReadAsDateTime); - } - - /// - /// Reads the next JSON token from the underlying as a . - /// - /// A . This method will return null at the end of an array. - public override string? ReadAsString() - { - return (string?)ReadStringValue(ReadType.ReadAsString); - } - - /// - /// Reads the next JSON token from the underlying as a []. - /// - /// A [] or null if the next JSON token is null. This method will return null at the end of an array. - public override byte[]? ReadAsBytes() - { - EnsureBuffer(); - MiscellaneousUtils.Assert(_chars != null); - - bool isWrapped = false; - - switch (_currentState) - { - case State.PostValue: - if (ParsePostValue(true)) - { - return null; - } - goto case State.Start; - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (ReadNullChar()) - { - SetToken(JsonToken.None, null, false); - return null; - } - break; - case '"': - case '\'': - ParseString(currentChar, ReadType.ReadAsBytes); - byte[]? data = (byte[]?)Value; - if (isWrapped) - { - ReaderReadAndAssert(); - if (TokenType != JsonToken.EndObject) - { - throw JsonReaderException.Create(this, "Error reading bytes. Unexpected token: {0}.".FormatWith(CultureInfo.InvariantCulture, TokenType)); - } - SetToken(JsonToken.Bytes, data, false); - } - return data; - case '{': - _charPos++; - SetToken(JsonToken.StartObject); - ReadIntoWrappedTypeObject(); - isWrapped = true; - break; - case '[': - _charPos++; - SetToken(JsonToken.StartArray); - return ReadArrayIntoByteArray(); - case 'n': - HandleNull(); - return null; - case '/': - ParseComment(false); - break; - case ',': - ProcessValueComma(); - break; - case ']': - _charPos++; - if (_currentState == State.Array || _currentState == State.ArrayStart || _currentState == State.PostValue) - { - SetToken(JsonToken.EndArray); - return null; - } - throw CreateUnexpectedCharacterException(currentChar); - case StringUtils.CarriageReturn: - ProcessCarriageReturn(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - // eat - _charPos++; - break; - default: - _charPos++; - - if (!char.IsWhiteSpace(currentChar)) - { - throw CreateUnexpectedCharacterException(currentChar); - } - - // eat - break; - } - } - case State.Finished: - ReadFinished(); - return null; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - - private object? ReadStringValue(ReadType readType) - { - EnsureBuffer(); - MiscellaneousUtils.Assert(_chars != null); - - switch (_currentState) - { - case State.PostValue: - if (ParsePostValue(true)) - { - return null; - } - goto case State.Start; - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (ReadNullChar()) - { - SetToken(JsonToken.None, null, false); - return null; - } - break; - case '"': - case '\'': - ParseString(currentChar, readType); - return FinishReadQuotedStringValue(readType); - case '-': - if (EnsureChars(1, true) && _chars[_charPos + 1] == 'I') - { - return ParseNumberNegativeInfinity(readType); - } - else - { - ParseNumber(readType); - return Value; - } - case '.': - case '0': - case '1': - case '2': - case '3': - case '4': - case '5': - case '6': - case '7': - case '8': - case '9': - if (readType != ReadType.ReadAsString) - { - _charPos++; - throw CreateUnexpectedCharacterException(currentChar); - } - ParseNumber(ReadType.ReadAsString); - return Value; - case 't': - case 'f': - if (readType != ReadType.ReadAsString) - { - _charPos++; - throw CreateUnexpectedCharacterException(currentChar); - } - string expected = currentChar == 't' ? JsonConvert.True : JsonConvert.False; - if (!MatchValueWithTrailingSeparator(expected)) - { - throw CreateUnexpectedCharacterException(_chars[_charPos]); - } - SetToken(JsonToken.String, expected); - return expected; - case 'I': - return ParseNumberPositiveInfinity(readType); - case 'N': - return ParseNumberNaN(readType); - case 'n': - HandleNull(); - return null; - case '/': - ParseComment(false); - break; - case ',': - ProcessValueComma(); - break; - case ']': - _charPos++; - if (_currentState == State.Array || _currentState == State.ArrayStart || _currentState == State.PostValue) - { - SetToken(JsonToken.EndArray); - return null; - } - throw CreateUnexpectedCharacterException(currentChar); - case StringUtils.CarriageReturn: - ProcessCarriageReturn(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - // eat - _charPos++; - break; - default: - _charPos++; - - if (!char.IsWhiteSpace(currentChar)) - { - throw CreateUnexpectedCharacterException(currentChar); - } - - // eat - break; - } - } - case State.Finished: - ReadFinished(); - return null; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - - private object? FinishReadQuotedStringValue(ReadType readType) - { - switch (readType) - { - case ReadType.ReadAsBytes: - case ReadType.ReadAsString: - return Value; - case ReadType.ReadAsDateTime: - if (Value is DateTime time) - { - return time; - } - - return ReadDateTimeString((string?)Value); -#if HAVE_DATE_TIME_OFFSET - case ReadType.ReadAsDateTimeOffset: - if (Value is DateTimeOffset offset) - { - return offset; - } - - return ReadDateTimeOffsetString((string?)Value); -#endif - default: - throw new ArgumentOutOfRangeException(nameof(readType)); - } - } - - private JsonReaderException CreateUnexpectedCharacterException(char c) - { - return JsonReaderException.Create(this, "Unexpected character encountered while parsing value: {0}.".FormatWith(CultureInfo.InvariantCulture, c)); - } - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . This method will return null at the end of an array. - public override bool? ReadAsBoolean() - { - EnsureBuffer(); - MiscellaneousUtils.Assert(_chars != null); - - switch (_currentState) - { - case State.PostValue: - if (ParsePostValue(true)) - { - return null; - } - goto case State.Start; - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (ReadNullChar()) - { - SetToken(JsonToken.None, null, false); - return null; - } - break; - case '"': - case '\'': - ParseString(currentChar, ReadType.Read); - return ReadBooleanString(_stringReference.ToString()); - case 'n': - HandleNull(); - return null; - case '-': - case '.': - case '0': - case '1': - case '2': - case '3': - case '4': - case '5': - case '6': - case '7': - case '8': - case '9': - ParseNumber(ReadType.Read); - bool b; -#if HAVE_BIG_INTEGER - if (Value is BigInteger integer) - { - b = integer != 0; - } - else -#endif - { - b = Convert.ToBoolean(Value, CultureInfo.InvariantCulture); - } - SetToken(JsonToken.Boolean, b, false); - return b; - case 't': - case 'f': - bool isTrue = currentChar == 't'; - string expected = isTrue ? JsonConvert.True : JsonConvert.False; - - if (!MatchValueWithTrailingSeparator(expected)) - { - throw CreateUnexpectedCharacterException(_chars[_charPos]); - } - SetToken(JsonToken.Boolean, isTrue); - return isTrue; - case '/': - ParseComment(false); - break; - case ',': - ProcessValueComma(); - break; - case ']': - _charPos++; - if (_currentState == State.Array || _currentState == State.ArrayStart || _currentState == State.PostValue) - { - SetToken(JsonToken.EndArray); - return null; - } - throw CreateUnexpectedCharacterException(currentChar); - case StringUtils.CarriageReturn: - ProcessCarriageReturn(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - // eat - _charPos++; - break; - default: - _charPos++; - - if (!char.IsWhiteSpace(currentChar)) - { - throw CreateUnexpectedCharacterException(currentChar); - } - - // eat - break; - } - } - case State.Finished: - ReadFinished(); - return null; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - - private void ProcessValueComma() - { - _charPos++; - - if (_currentState != State.PostValue) - { - SetToken(JsonToken.Undefined); - JsonReaderException ex = CreateUnexpectedCharacterException(','); - // so the comma will be parsed again - _charPos--; - - throw ex; - } - - SetStateBasedOnCurrent(); - } - - private object? ReadNumberValue(ReadType readType) - { - EnsureBuffer(); - MiscellaneousUtils.Assert(_chars != null); - - switch (_currentState) - { - case State.PostValue: - if (ParsePostValue(true)) - { - return null; - } - goto case State.Start; - case State.Start: - case State.Property: - case State.Array: - case State.ArrayStart: - case State.Constructor: - case State.ConstructorStart: - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (ReadNullChar()) - { - SetToken(JsonToken.None, null, false); - return null; - } - break; - case '"': - case '\'': - ParseString(currentChar, readType); - return FinishReadQuotedNumber(readType); - case 'n': - HandleNull(); - return null; - case 'N': - return ParseNumberNaN(readType); - case 'I': - return ParseNumberPositiveInfinity(readType); - case '-': - if (EnsureChars(1, true) && _chars[_charPos + 1] == 'I') - { - return ParseNumberNegativeInfinity(readType); - } - else - { - ParseNumber(readType); - return Value; - } - case '.': - case '0': - case '1': - case '2': - case '3': - case '4': - case '5': - case '6': - case '7': - case '8': - case '9': - ParseNumber(readType); - return Value; - case '/': - ParseComment(false); - break; - case ',': - ProcessValueComma(); - break; - case ']': - _charPos++; - if (_currentState == State.Array || _currentState == State.ArrayStart || _currentState == State.PostValue) - { - SetToken(JsonToken.EndArray); - return null; - } - throw CreateUnexpectedCharacterException(currentChar); - case StringUtils.CarriageReturn: - ProcessCarriageReturn(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - // eat - _charPos++; - break; - default: - _charPos++; - - if (!char.IsWhiteSpace(currentChar)) - { - throw CreateUnexpectedCharacterException(currentChar); - } - - // eat - break; - } - } - case State.Finished: - ReadFinished(); - return null; - default: - throw JsonReaderException.Create(this, "Unexpected state: {0}.".FormatWith(CultureInfo.InvariantCulture, CurrentState)); - } - } - - private object? FinishReadQuotedNumber(ReadType readType) - { - switch (readType) - { - case ReadType.ReadAsInt32: - return ReadInt32String(_stringReference.ToString()); - case ReadType.ReadAsDecimal: - return ReadDecimalString(_stringReference.ToString()); - case ReadType.ReadAsDouble: - return ReadDoubleString(_stringReference.ToString()); - default: - throw new ArgumentOutOfRangeException(nameof(readType)); - } - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . This method will return null at the end of an array. - public override DateTimeOffset? ReadAsDateTimeOffset() - { - return (DateTimeOffset?)ReadStringValue(ReadType.ReadAsDateTimeOffset); - } -#endif - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . This method will return null at the end of an array. - public override decimal? ReadAsDecimal() - { - return (decimal?)ReadNumberValue(ReadType.ReadAsDecimal); - } - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . This method will return null at the end of an array. - public override double? ReadAsDouble() - { - return (double?)ReadNumberValue(ReadType.ReadAsDouble); - } - - private void HandleNull() - { - MiscellaneousUtils.Assert(_chars != null); - - if (EnsureChars(1, true)) - { - char next = _chars[_charPos + 1]; - - if (next == 'u') - { - ParseNull(); - return; - } - - _charPos += 2; - throw CreateUnexpectedCharacterException(_chars[_charPos - 1]); - } - - _charPos = _charsUsed; - throw CreateUnexpectedEndException(); - } - - private void ReadFinished() - { - MiscellaneousUtils.Assert(_chars != null); - - if (EnsureChars(0, false)) - { - EatWhitespace(); - if (_isEndOfFile) - { - return; - } - if (_chars[_charPos] == '/') - { - ParseComment(false); - } - else - { - throw JsonReaderException.Create(this, "Additional text encountered after finished reading JSON content: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - } - - SetToken(JsonToken.None); - } - - private bool ReadNullChar() - { - if (_charsUsed == _charPos) - { - if (ReadData(false) == 0) - { - _isEndOfFile = true; - return true; - } - } - else - { - _charPos++; - } - - return false; - } - - private void EnsureBuffer() - { - if (_chars == null) - { - _chars = BufferUtils.RentBuffer(_arrayPool, 1024); - _chars[0] = '\0'; - } - } - - private void ReadStringIntoBuffer(char quote) - { - MiscellaneousUtils.Assert(_chars != null); - - int charPos = _charPos; - int initialPosition = _charPos; - int lastWritePosition = _charPos; - _stringBuffer.Position = 0; - - while (true) - { - switch (_chars[charPos++]) - { - case '\0': - if (_charsUsed == charPos - 1) - { - charPos--; - - if (ReadData(true) == 0) - { - _charPos = charPos; - throw JsonReaderException.Create(this, "Unterminated string. Expected delimiter: {0}.".FormatWith(CultureInfo.InvariantCulture, quote)); - } - } - break; - case '\\': - _charPos = charPos; - if (!EnsureChars(0, true)) - { - throw JsonReaderException.Create(this, "Unterminated string. Expected delimiter: {0}.".FormatWith(CultureInfo.InvariantCulture, quote)); - } - - // start of escape sequence - int escapeStartPos = charPos - 1; - - char currentChar = _chars[charPos]; - charPos++; - - char writeChar; - - switch (currentChar) - { - case 'b': - writeChar = '\b'; - break; - case 't': - writeChar = '\t'; - break; - case 'n': - writeChar = '\n'; - break; - case 'f': - writeChar = '\f'; - break; - case 'r': - writeChar = '\r'; - break; - case '\\': - writeChar = '\\'; - break; - case '"': - case '\'': - case '/': - writeChar = currentChar; - break; - case 'u': - _charPos = charPos; - writeChar = ParseUnicode(); - - if (StringUtils.IsLowSurrogate(writeChar)) - { - // low surrogate with no preceding high surrogate; this char is replaced - writeChar = UnicodeReplacementChar; - } - else if (StringUtils.IsHighSurrogate(writeChar)) - { - bool anotherHighSurrogate; - - // loop for handling situations where there are multiple consecutive high surrogates - do - { - anotherHighSurrogate = false; - - // potential start of a surrogate pair - if (EnsureChars(2, true) && _chars[_charPos] == '\\' && _chars[_charPos + 1] == 'u') - { - char highSurrogate = writeChar; - - _charPos += 2; - writeChar = ParseUnicode(); - - if (StringUtils.IsLowSurrogate(writeChar)) - { - // a valid surrogate pair! - } - else if (StringUtils.IsHighSurrogate(writeChar)) - { - // another high surrogate; replace current and start check over - highSurrogate = UnicodeReplacementChar; - anotherHighSurrogate = true; - } - else - { - // high surrogate not followed by low surrogate; original char is replaced - highSurrogate = UnicodeReplacementChar; - } - - EnsureBufferNotEmpty(); - - WriteCharToBuffer(highSurrogate, lastWritePosition, escapeStartPos); - lastWritePosition = _charPos; - } - else - { - // there are not enough remaining chars for the low surrogate or is not follow by unicode sequence - // replace high surrogate and continue on as usual - writeChar = UnicodeReplacementChar; - } - } while (anotherHighSurrogate); - } - - charPos = _charPos; - break; - default: - _charPos = charPos; - throw JsonReaderException.Create(this, "Bad JSON escape sequence: {0}.".FormatWith(CultureInfo.InvariantCulture, @"\" + currentChar)); - } - - EnsureBufferNotEmpty(); - WriteCharToBuffer(writeChar, lastWritePosition, escapeStartPos); - - lastWritePosition = charPos; - break; - case StringUtils.CarriageReturn: - _charPos = charPos - 1; - ProcessCarriageReturn(true); - charPos = _charPos; - break; - case StringUtils.LineFeed: - _charPos = charPos - 1; - ProcessLineFeed(); - charPos = _charPos; - break; - case '"': - case '\'': - if (_chars[charPos - 1] == quote) - { - FinishReadStringIntoBuffer(charPos - 1, initialPosition, lastWritePosition); - return; - } - break; - } - } - } - - private void FinishReadStringIntoBuffer(int charPos, int initialPosition, int lastWritePosition) - { - MiscellaneousUtils.Assert(_chars != null); - - if (initialPosition == lastWritePosition) - { - _stringReference = new StringReference(_chars, initialPosition, charPos - initialPosition); - } - else - { - EnsureBufferNotEmpty(); - - if (charPos > lastWritePosition) - { - _stringBuffer.Append(_arrayPool, _chars, lastWritePosition, charPos - lastWritePosition); - } - - _stringReference = new StringReference(_stringBuffer.InternalBuffer!, 0, _stringBuffer.Position); - } - - _charPos = charPos + 1; - } - - private void WriteCharToBuffer(char writeChar, int lastWritePosition, int writeToPosition) - { - MiscellaneousUtils.Assert(_chars != null); - - if (writeToPosition > lastWritePosition) - { - _stringBuffer.Append(_arrayPool, _chars, lastWritePosition, writeToPosition - lastWritePosition); - } - - _stringBuffer.Append(_arrayPool, writeChar); - } - - private char ConvertUnicode(bool enoughChars) - { - MiscellaneousUtils.Assert(_chars != null); - - if (enoughChars) - { - if (ConvertUtils.TryHexTextToInt(_chars, _charPos, _charPos + 4, out int value)) - { - char hexChar = Convert.ToChar(value); - _charPos += 4; - return hexChar; - } - else - { - throw JsonReaderException.Create(this, @"Invalid Unicode escape sequence: \u{0}.".FormatWith(CultureInfo.InvariantCulture, new string(_chars, _charPos, 4))); - } - } - else - { - throw JsonReaderException.Create(this, "Unexpected end while parsing Unicode escape sequence."); - } - } - - private char ParseUnicode() - { - return ConvertUnicode(EnsureChars(4, true)); - } - - private void ReadNumberIntoBuffer() - { - MiscellaneousUtils.Assert(_chars != null); - - int charPos = _charPos; - - while (true) - { - char currentChar = _chars[charPos]; - if (currentChar == '\0') - { - _charPos = charPos; - - if (_charsUsed == charPos) - { - if (ReadData(true) == 0) - { - return; - } - } - else - { - return; - } - } - else if (ReadNumberCharIntoBuffer(currentChar, charPos)) - { - return; - } - else - { - charPos++; - } - } - } - - private bool ReadNumberCharIntoBuffer(char currentChar, int charPos) - { - switch (currentChar) - { - case '-': - case '+': - case 'a': - case 'A': - case 'b': - case 'B': - case 'c': - case 'C': - case 'd': - case 'D': - case 'e': - case 'E': - case 'f': - case 'F': - case 'x': - case 'X': - case '.': - case '0': - case '1': - case '2': - case '3': - case '4': - case '5': - case '6': - case '7': - case '8': - case '9': - return false; - default: - _charPos = charPos; - - if (char.IsWhiteSpace(currentChar) || currentChar == ',' || currentChar == '}' || currentChar == ']' || currentChar == ')' || currentChar == '/') - { - return true; - } - - throw JsonReaderException.Create(this, "Unexpected character encountered while parsing number: {0}.".FormatWith(CultureInfo.InvariantCulture, currentChar)); - } - } - - private void ClearRecentString() - { - _stringBuffer.Position = 0; - _stringReference = new StringReference(); - } - - private bool ParsePostValue(bool ignoreComments) - { - MiscellaneousUtils.Assert(_chars != null); - - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (_charsUsed == _charPos) - { - if (ReadData(false) == 0) - { - _currentState = State.Finished; - return false; - } - } - else - { - _charPos++; - } - break; - case '}': - _charPos++; - SetToken(JsonToken.EndObject); - return true; - case ']': - _charPos++; - SetToken(JsonToken.EndArray); - return true; - case ')': - _charPos++; - SetToken(JsonToken.EndConstructor); - return true; - case '/': - ParseComment(!ignoreComments); - if (!ignoreComments) - { - return true; - } - break; - case ',': - _charPos++; - - // finished parsing - SetStateBasedOnCurrent(); - return false; - case ' ': - case StringUtils.Tab: - // eat - _charPos++; - break; - case StringUtils.CarriageReturn: - ProcessCarriageReturn(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - default: - if (char.IsWhiteSpace(currentChar)) - { - // eat - _charPos++; - } - else - { - // handle multiple content without comma delimiter - if (SupportMultipleContent && Depth == 0) - { - SetStateBasedOnCurrent(); - return false; - } - - throw JsonReaderException.Create(this, "After parsing a value an unexpected character was encountered: {0}.".FormatWith(CultureInfo.InvariantCulture, currentChar)); - } - break; - } - } - } - - private bool ParseObject() - { - MiscellaneousUtils.Assert(_chars != null); - - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (_charsUsed == _charPos) - { - if (ReadData(false) == 0) - { - return false; - } - } - else - { - _charPos++; - } - break; - case '}': - SetToken(JsonToken.EndObject); - _charPos++; - return true; - case '/': - ParseComment(true); - return true; - case StringUtils.CarriageReturn: - ProcessCarriageReturn(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - // eat - _charPos++; - break; - default: - if (char.IsWhiteSpace(currentChar)) - { - // eat - _charPos++; - } - else - { - return ParseProperty(); - } - break; - } - } - } - - private bool ParseProperty() - { - MiscellaneousUtils.Assert(_chars != null); - - char firstChar = _chars[_charPos]; - char quoteChar; - - if (firstChar == '"' || firstChar == '\'') - { - _charPos++; - quoteChar = firstChar; - ShiftBufferIfNeeded(); - ReadStringIntoBuffer(quoteChar); - } - else if (ValidIdentifierChar(firstChar)) - { - quoteChar = '\0'; - ShiftBufferIfNeeded(); - ParseUnquotedProperty(); - } - else - { - throw JsonReaderException.Create(this, "Invalid property identifier character: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - - string? propertyName; - - if (PropertyNameTable != null) - { - propertyName = PropertyNameTable.Get(_stringReference.Chars, _stringReference.StartIndex, _stringReference.Length); - - // no match in name table - if (propertyName == null) - { - propertyName = _stringReference.ToString(); - } - } - else - { - propertyName = _stringReference.ToString(); - } - - EatWhitespace(); - - if (_chars[_charPos] != ':') - { - throw JsonReaderException.Create(this, "Invalid character after parsing property name. Expected ':' but got: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - - _charPos++; - - SetToken(JsonToken.PropertyName, propertyName); - _quoteChar = quoteChar; - ClearRecentString(); - - return true; - } - - private bool ValidIdentifierChar(char value) - { - return (char.IsLetterOrDigit(value) || value == '_' || value == '$'); - } - - private void ParseUnquotedProperty() - { - MiscellaneousUtils.Assert(_chars != null); - - int initialPosition = _charPos; - - // parse unquoted property name until whitespace or colon - while (true) - { - char currentChar = _chars[_charPos]; - if (currentChar == '\0') - { - if (_charsUsed == _charPos) - { - if (ReadData(true) == 0) - { - throw JsonReaderException.Create(this, "Unexpected end while parsing unquoted property name."); - } - - continue; - } - - _stringReference = new StringReference(_chars, initialPosition, _charPos - initialPosition); - return; - } - - if (ReadUnquotedPropertyReportIfDone(currentChar, initialPosition)) - { - return; - } - } - } - - private bool ReadUnquotedPropertyReportIfDone(char currentChar, int initialPosition) - { - MiscellaneousUtils.Assert(_chars != null); - - if (ValidIdentifierChar(currentChar)) - { - _charPos++; - return false; - } - - if (char.IsWhiteSpace(currentChar) || currentChar == ':') - { - _stringReference = new StringReference(_chars, initialPosition, _charPos - initialPosition); - return true; - } - - throw JsonReaderException.Create(this, "Invalid JavaScript property identifier character: {0}.".FormatWith(CultureInfo.InvariantCulture, currentChar)); - } - - private bool ParseValue() - { - MiscellaneousUtils.Assert(_chars != null); - - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (_charsUsed == _charPos) - { - if (ReadData(false) == 0) - { - return false; - } - } - else - { - _charPos++; - } - break; - case '"': - case '\'': - ParseString(currentChar, ReadType.Read); - return true; - case 't': - ParseTrue(); - return true; - case 'f': - ParseFalse(); - return true; - case 'n': - if (EnsureChars(1, true)) - { - char next = _chars[_charPos + 1]; - - if (next == 'u') - { - ParseNull(); - } - else if (next == 'e') - { - ParseConstructor(); - } - else - { - throw CreateUnexpectedCharacterException(_chars[_charPos]); - } - } - else - { - _charPos++; - throw CreateUnexpectedEndException(); - } - return true; - case 'N': - ParseNumberNaN(ReadType.Read); - return true; - case 'I': - ParseNumberPositiveInfinity(ReadType.Read); - return true; - case '-': - if (EnsureChars(1, true) && _chars[_charPos + 1] == 'I') - { - ParseNumberNegativeInfinity(ReadType.Read); - } - else - { - ParseNumber(ReadType.Read); - } - return true; - case '/': - ParseComment(true); - return true; - case 'u': - ParseUndefined(); - return true; - case '{': - _charPos++; - SetToken(JsonToken.StartObject); - return true; - case '[': - _charPos++; - SetToken(JsonToken.StartArray); - return true; - case ']': - _charPos++; - SetToken(JsonToken.EndArray); - return true; - case ',': - // don't increment position, the next call to read will handle comma - // this is done to handle multiple empty comma values - SetToken(JsonToken.Undefined); - return true; - case ')': - _charPos++; - SetToken(JsonToken.EndConstructor); - return true; - case StringUtils.CarriageReturn: - ProcessCarriageReturn(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - case ' ': - case StringUtils.Tab: - // eat - _charPos++; - break; - default: - if (char.IsWhiteSpace(currentChar)) - { - // eat - _charPos++; - break; - } - if (char.IsNumber(currentChar) || currentChar == '-' || currentChar == '.') - { - ParseNumber(ReadType.Read); - return true; - } - - throw CreateUnexpectedCharacterException(currentChar); - } - } - } - - private void ProcessLineFeed() - { - _charPos++; - OnNewLine(_charPos); - } - - private void ProcessCarriageReturn(bool append) - { - _charPos++; - - SetNewLine(EnsureChars(1, append)); - } - - private void EatWhitespace() - { - MiscellaneousUtils.Assert(_chars != null); - - while (true) - { - char currentChar = _chars[_charPos]; - - switch (currentChar) - { - case '\0': - if (_charsUsed == _charPos) - { - if (ReadData(false) == 0) - { - return; - } - } - else - { - _charPos++; - } - break; - case StringUtils.CarriageReturn: - ProcessCarriageReturn(false); - break; - case StringUtils.LineFeed: - ProcessLineFeed(); - break; - default: - if (currentChar == ' ' || char.IsWhiteSpace(currentChar)) - { - _charPos++; - } - else - { - return; - } - break; - } - } - } - - private void ParseConstructor() - { - MiscellaneousUtils.Assert(_chars != null); - - if (MatchValueWithTrailingSeparator("new")) - { - EatWhitespace(); - - int initialPosition = _charPos; - int endPosition; - - while (true) - { - char currentChar = _chars[_charPos]; - if (currentChar == '\0') - { - if (_charsUsed == _charPos) - { - if (ReadData(true) == 0) - { - throw JsonReaderException.Create(this, "Unexpected end while parsing constructor."); - } - } - else - { - endPosition = _charPos; - _charPos++; - break; - } - } - else if (char.IsLetterOrDigit(currentChar)) - { - _charPos++; - } - else if (currentChar == StringUtils.CarriageReturn) - { - endPosition = _charPos; - ProcessCarriageReturn(true); - break; - } - else if (currentChar == StringUtils.LineFeed) - { - endPosition = _charPos; - ProcessLineFeed(); - break; - } - else if (char.IsWhiteSpace(currentChar)) - { - endPosition = _charPos; - _charPos++; - break; - } - else if (currentChar == '(') - { - endPosition = _charPos; - break; - } - else - { - throw JsonReaderException.Create(this, "Unexpected character while parsing constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, currentChar)); - } - } - - _stringReference = new StringReference(_chars, initialPosition, endPosition - initialPosition); - string constructorName = _stringReference.ToString(); - - EatWhitespace(); - - if (_chars[_charPos] != '(') - { - throw JsonReaderException.Create(this, "Unexpected character while parsing constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - - _charPos++; - - ClearRecentString(); - - SetToken(JsonToken.StartConstructor, constructorName); - } - else - { - throw JsonReaderException.Create(this, "Unexpected content while parsing JSON."); - } - } - - private void ParseNumber(ReadType readType) - { - ShiftBufferIfNeeded(); - MiscellaneousUtils.Assert(_chars != null); - - char firstChar = _chars[_charPos]; - int initialPosition = _charPos; - - ReadNumberIntoBuffer(); - - ParseReadNumber(readType, firstChar, initialPosition); - } - - private void ParseReadNumber(ReadType readType, char firstChar, int initialPosition) - { - MiscellaneousUtils.Assert(_chars != null); - - // set state to PostValue now so that if there is an error parsing the number then the reader can continue - SetPostValueState(true); - - _stringReference = new StringReference(_chars, initialPosition, _charPos - initialPosition); - - object numberValue; - JsonToken numberType; - - bool singleDigit = (char.IsDigit(firstChar) && _stringReference.Length == 1); - bool nonBase10 = (firstChar == '0' && _stringReference.Length > 1 && _stringReference.Chars[_stringReference.StartIndex + 1] != '.' && _stringReference.Chars[_stringReference.StartIndex + 1] != 'e' && _stringReference.Chars[_stringReference.StartIndex + 1] != 'E'); - - switch (readType) - { - case ReadType.ReadAsString: - { - string number = _stringReference.ToString(); - - // validate that the string is a valid number - if (nonBase10) - { - try - { - if (number.StartsWith("0x", StringComparison.OrdinalIgnoreCase)) - { - Convert.ToInt64(number, 16); - } - else - { - Convert.ToInt64(number, 8); - } - } - catch (Exception ex) - { - throw ThrowReaderError("Input string '{0}' is not a valid number.".FormatWith(CultureInfo.InvariantCulture, number), ex); - } - } - else - { - if (!double.TryParse(number, NumberStyles.Float, CultureInfo.InvariantCulture, out _)) - { - throw ThrowReaderError("Input string '{0}' is not a valid number.".FormatWith(CultureInfo.InvariantCulture, _stringReference.ToString())); - } - } - - numberType = JsonToken.String; - numberValue = number; - } - break; - case ReadType.ReadAsInt32: - { - if (singleDigit) - { - // digit char values start at 48 - numberValue = firstChar - 48; - } - else if (nonBase10) - { - string number = _stringReference.ToString(); - - try - { - int integer = number.StartsWith("0x", StringComparison.OrdinalIgnoreCase) ? Convert.ToInt32(number, 16) : Convert.ToInt32(number, 8); - - numberValue = integer; - } - catch (Exception ex) - { - throw ThrowReaderError("Input string '{0}' is not a valid integer.".FormatWith(CultureInfo.InvariantCulture, number), ex); - } - } - else - { - ParseResult parseResult = ConvertUtils.Int32TryParse(_stringReference.Chars, _stringReference.StartIndex, _stringReference.Length, out int value); - if (parseResult == ParseResult.Success) - { - numberValue = value; - } - else if (parseResult == ParseResult.Overflow) - { - throw ThrowReaderError("JSON integer {0} is too large or small for an Int32.".FormatWith(CultureInfo.InvariantCulture, _stringReference.ToString())); - } - else - { - throw ThrowReaderError("Input string '{0}' is not a valid integer.".FormatWith(CultureInfo.InvariantCulture, _stringReference.ToString())); - } - } - - numberType = JsonToken.Integer; - } - break; - case ReadType.ReadAsDecimal: - { - if (singleDigit) - { - // digit char values start at 48 - numberValue = (decimal)firstChar - 48; - } - else if (nonBase10) - { - string number = _stringReference.ToString(); - - try - { - // decimal.Parse doesn't support parsing hexadecimal values - long integer = number.StartsWith("0x", StringComparison.OrdinalIgnoreCase) ? Convert.ToInt64(number, 16) : Convert.ToInt64(number, 8); - - numberValue = Convert.ToDecimal(integer); - } - catch (Exception ex) - { - throw ThrowReaderError("Input string '{0}' is not a valid decimal.".FormatWith(CultureInfo.InvariantCulture, number), ex); - } - } - else - { - ParseResult parseResult = ConvertUtils.DecimalTryParse(_stringReference.Chars, _stringReference.StartIndex, _stringReference.Length, out decimal value); - if (parseResult == ParseResult.Success) - { - numberValue = value; - } - else - { - throw ThrowReaderError("Input string '{0}' is not a valid decimal.".FormatWith(CultureInfo.InvariantCulture, _stringReference.ToString())); - } - } - - numberType = JsonToken.Float; - } - break; - case ReadType.ReadAsDouble: - { - if (singleDigit) - { - // digit char values start at 48 - numberValue = (double)firstChar - 48; - } - else if (nonBase10) - { - string number = _stringReference.ToString(); - - try - { - // double.Parse doesn't support parsing hexadecimal values - long integer = number.StartsWith("0x", StringComparison.OrdinalIgnoreCase) ? Convert.ToInt64(number, 16) : Convert.ToInt64(number, 8); - - numberValue = Convert.ToDouble(integer); - } - catch (Exception ex) - { - throw ThrowReaderError("Input string '{0}' is not a valid double.".FormatWith(CultureInfo.InvariantCulture, number), ex); - } - } - else - { - string number = _stringReference.ToString(); - - if (double.TryParse(number, NumberStyles.Float, CultureInfo.InvariantCulture, out double value)) - { - numberValue = value; - } - else - { - throw ThrowReaderError("Input string '{0}' is not a valid double.".FormatWith(CultureInfo.InvariantCulture, _stringReference.ToString())); - } - } - - numberType = JsonToken.Float; - } - break; - case ReadType.Read: - case ReadType.ReadAsInt64: - { - if (singleDigit) - { - // digit char values start at 48 - numberValue = (long)firstChar - 48; - numberType = JsonToken.Integer; - } - else if (nonBase10) - { - string number = _stringReference.ToString(); - - try - { - numberValue = number.StartsWith("0x", StringComparison.OrdinalIgnoreCase) ? Convert.ToInt64(number, 16) : Convert.ToInt64(number, 8); - } - catch (Exception ex) - { - throw ThrowReaderError("Input string '{0}' is not a valid number.".FormatWith(CultureInfo.InvariantCulture, number), ex); - } - - numberType = JsonToken.Integer; - } - else - { - ParseResult parseResult = ConvertUtils.Int64TryParse(_stringReference.Chars, _stringReference.StartIndex, _stringReference.Length, out long value); - if (parseResult == ParseResult.Success) - { - numberValue = value; - numberType = JsonToken.Integer; - } - else if (parseResult == ParseResult.Overflow) - { -#if HAVE_BIG_INTEGER - string number = _stringReference.ToString(); - - if (number.Length > MaximumJavascriptIntegerCharacterLength) - { - throw ThrowReaderError("JSON integer {0} is too large to parse.".FormatWith(CultureInfo.InvariantCulture, _stringReference.ToString())); - } - - numberValue = BigIntegerParse(number, CultureInfo.InvariantCulture); - numberType = JsonToken.Integer; -#else - throw ThrowReaderError("JSON integer {0} is too large or small for an Int64.".FormatWith(CultureInfo.InvariantCulture, _stringReference.ToString())); -#endif - } - else - { - if (_floatParseHandling == FloatParseHandling.Decimal) - { - parseResult = ConvertUtils.DecimalTryParse(_stringReference.Chars, _stringReference.StartIndex, _stringReference.Length, out decimal d); - if (parseResult == ParseResult.Success) - { - numberValue = d; - } - else - { - throw ThrowReaderError("Input string '{0}' is not a valid decimal.".FormatWith(CultureInfo.InvariantCulture, _stringReference.ToString())); - } - } - else - { - string number = _stringReference.ToString(); - - if (double.TryParse(number, NumberStyles.Float, CultureInfo.InvariantCulture, out double d)) - { - numberValue = d; - } - else - { - throw ThrowReaderError("Input string '{0}' is not a valid number.".FormatWith(CultureInfo.InvariantCulture, _stringReference.ToString())); - } - } - - numberType = JsonToken.Float; - } - } - } - break; - default: - throw JsonReaderException.Create(this, "Cannot read number value as type."); - } - - ClearRecentString(); - - // index has already been updated - SetToken(numberType, numberValue, false); - } - - private JsonReaderException ThrowReaderError(string message, Exception? ex = null) - { - SetToken(JsonToken.Undefined, null, false); - return JsonReaderException.Create(this, message, ex); - } - -#if HAVE_BIG_INTEGER - // By using the BigInteger type in a separate method, - // the runtime can execute the ParseNumber even if - // the System.Numerics.BigInteger.Parse method is - // missing, which happens in some versions of Mono - [MethodImpl(MethodImplOptions.NoInlining)] - private static object BigIntegerParse(string number, CultureInfo culture) - { - return System.Numerics.BigInteger.Parse(number, culture); - } -#endif - - private void ParseComment(bool setToken) - { - MiscellaneousUtils.Assert(_chars != null); - - // should have already parsed / character before reaching this method - _charPos++; - - if (!EnsureChars(1, false)) - { - throw JsonReaderException.Create(this, "Unexpected end while parsing comment."); - } - - bool singlelineComment; - - if (_chars[_charPos] == '*') - { - singlelineComment = false; - } - else if (_chars[_charPos] == '/') - { - singlelineComment = true; - } - else - { - throw JsonReaderException.Create(this, "Error parsing comment. Expected: *, got {0}.".FormatWith(CultureInfo.InvariantCulture, _chars[_charPos])); - } - - _charPos++; - - int initialPosition = _charPos; - - while (true) - { - switch (_chars[_charPos]) - { - case '\0': - if (_charsUsed == _charPos) - { - if (ReadData(true) == 0) - { - if (!singlelineComment) - { - throw JsonReaderException.Create(this, "Unexpected end while parsing comment."); - } - - EndComment(setToken, initialPosition, _charPos); - return; - } - } - else - { - _charPos++; - } - break; - case '*': - _charPos++; - - if (!singlelineComment) - { - if (EnsureChars(0, true)) - { - if (_chars[_charPos] == '/') - { - EndComment(setToken, initialPosition, _charPos - 1); - - _charPos++; - return; - } - } - } - break; - case StringUtils.CarriageReturn: - if (singlelineComment) - { - EndComment(setToken, initialPosition, _charPos); - return; - } - ProcessCarriageReturn(true); - break; - case StringUtils.LineFeed: - if (singlelineComment) - { - EndComment(setToken, initialPosition, _charPos); - return; - } - ProcessLineFeed(); - break; - default: - _charPos++; - break; - } - } - } - - private void EndComment(bool setToken, int initialPosition, int endPosition) - { - if (setToken) - { - SetToken(JsonToken.Comment, new string(_chars, initialPosition, endPosition - initialPosition)); - } - } - - private bool MatchValue(string value) - { - return MatchValue(EnsureChars(value.Length - 1, true), value); - } - - private bool MatchValue(bool enoughChars, string value) - { - MiscellaneousUtils.Assert(_chars != null); - - if (!enoughChars) - { - _charPos = _charsUsed; - throw CreateUnexpectedEndException(); - } - - for (int i = 0; i < value.Length; i++) - { - if (_chars[_charPos + i] != value[i]) - { - _charPos += i; - return false; - } - } - - _charPos += value.Length; - - return true; - } - - private bool MatchValueWithTrailingSeparator(string value) - { - MiscellaneousUtils.Assert(_chars != null); - - // will match value and then move to the next character, checking that it is a separator character - bool match = MatchValue(value); - - if (!match) - { - return false; - } - - if (!EnsureChars(0, false)) - { - return true; - } - - return IsSeparator(_chars[_charPos]) || _chars[_charPos] == '\0'; - } - - private bool IsSeparator(char c) - { - MiscellaneousUtils.Assert(_chars != null); - - switch (c) - { - case '}': - case ']': - case ',': - return true; - case '/': - // check next character to see if start of a comment - if (!EnsureChars(1, false)) - { - return false; - } - - char nextChart = _chars[_charPos + 1]; - - return (nextChart == '*' || nextChart == '/'); - case ')': - if (CurrentState == State.Constructor || CurrentState == State.ConstructorStart) - { - return true; - } - break; - case ' ': - case StringUtils.Tab: - case StringUtils.LineFeed: - case StringUtils.CarriageReturn: - return true; - default: - if (char.IsWhiteSpace(c)) - { - return true; - } - break; - } - - return false; - } - - private void ParseTrue() - { - // check characters equal 'true' - // and that it is followed by either a separator character - // or the text ends - if (MatchValueWithTrailingSeparator(JsonConvert.True)) - { - SetToken(JsonToken.Boolean, true); - } - else - { - throw JsonReaderException.Create(this, "Error parsing boolean value."); - } - } - - private void ParseNull() - { - if (MatchValueWithTrailingSeparator(JsonConvert.Null)) - { - SetToken(JsonToken.Null); - } - else - { - throw JsonReaderException.Create(this, "Error parsing null value."); - } - } - - private void ParseUndefined() - { - if (MatchValueWithTrailingSeparator(JsonConvert.Undefined)) - { - SetToken(JsonToken.Undefined); - } - else - { - throw JsonReaderException.Create(this, "Error parsing undefined value."); - } - } - - private void ParseFalse() - { - if (MatchValueWithTrailingSeparator(JsonConvert.False)) - { - SetToken(JsonToken.Boolean, false); - } - else - { - throw JsonReaderException.Create(this, "Error parsing boolean value."); - } - } - - private object ParseNumberNegativeInfinity(ReadType readType) - { - return ParseNumberNegativeInfinity(readType, MatchValueWithTrailingSeparator(JsonConvert.NegativeInfinity)); - } - - private object ParseNumberNegativeInfinity(ReadType readType, bool matched) - { - if (matched) - { - switch (readType) - { - case ReadType.Read: - case ReadType.ReadAsDouble: - if (_floatParseHandling == FloatParseHandling.Double) - { - SetToken(JsonToken.Float, double.NegativeInfinity); - return double.NegativeInfinity; - } - break; - case ReadType.ReadAsString: - SetToken(JsonToken.String, JsonConvert.NegativeInfinity); - return JsonConvert.NegativeInfinity; - } - - throw JsonReaderException.Create(this, "Cannot read -Infinity value."); - } - - throw JsonReaderException.Create(this, "Error parsing -Infinity value."); - } - - private object ParseNumberPositiveInfinity(ReadType readType) - { - return ParseNumberPositiveInfinity(readType, MatchValueWithTrailingSeparator(JsonConvert.PositiveInfinity)); - } - private object ParseNumberPositiveInfinity(ReadType readType, bool matched) - { - if (matched) - { - switch (readType) - { - case ReadType.Read: - case ReadType.ReadAsDouble: - if (_floatParseHandling == FloatParseHandling.Double) - { - SetToken(JsonToken.Float, double.PositiveInfinity); - return double.PositiveInfinity; - } - break; - case ReadType.ReadAsString: - SetToken(JsonToken.String, JsonConvert.PositiveInfinity); - return JsonConvert.PositiveInfinity; - } - - throw JsonReaderException.Create(this, "Cannot read Infinity value."); - } - - throw JsonReaderException.Create(this, "Error parsing Infinity value."); - } - - private object ParseNumberNaN(ReadType readType) - { - return ParseNumberNaN(readType, MatchValueWithTrailingSeparator(JsonConvert.NaN)); - } - - private object ParseNumberNaN(ReadType readType, bool matched) - { - if (matched) - { - switch (readType) - { - case ReadType.Read: - case ReadType.ReadAsDouble: - if (_floatParseHandling == FloatParseHandling.Double) - { - SetToken(JsonToken.Float, double.NaN); - return double.NaN; - } - break; - case ReadType.ReadAsString: - SetToken(JsonToken.String, JsonConvert.NaN); - return JsonConvert.NaN; - } - - throw JsonReaderException.Create(this, "Cannot read NaN value."); - } - - throw JsonReaderException.Create(this, "Error parsing NaN value."); - } - - /// - /// Changes the reader's state to . - /// If is set to true, the underlying is also closed. - /// - public override void Close() - { - base.Close(); - - if (_chars != null) - { - BufferUtils.ReturnBuffer(_arrayPool, _chars); - _chars = null; - } - - if (CloseInput) - { -#if HAVE_STREAM_READER_WRITER_CLOSE - _reader?.Close(); -#else - _reader?.Dispose(); -#endif - } - - _stringBuffer.Clear(_arrayPool); - } - - /// - /// Gets a value indicating whether the class can return line information. - /// - /// - /// true if and can be provided; otherwise, false. - /// - public bool HasLineInfo() - { - return true; - } - - /// - /// Gets the current line number. - /// - /// - /// The current line number or 0 if no line information is available (for example, returns false). - /// - public int LineNumber - { - get - { - if (CurrentState == State.Start && LinePosition == 0 && TokenType != JsonToken.Comment) - { - return 0; - } - - return _lineNumber; - } - } - - /// - /// Gets the current line position. - /// - /// - /// The current line position or 0 if no line information is available (for example, returns false). - /// - public int LinePosition => _charPos - _lineStartPos; - } -} diff --git a/Source/MyDb/Newtonsoft.Json/JsonTextWriter.Async.cs b/Source/MyDb/Newtonsoft.Json/JsonTextWriter.Async.cs deleted file mode 100644 index c1c763e..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonTextWriter.Async.cs +++ /dev/null @@ -1,1361 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System; -using System.Globalization; -using System.Threading; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; -using System.Diagnostics; - -namespace Newtonsoft.Json -{ - public partial class JsonTextWriter - { - // It's not safe to perform the async methods here in a derived class as if the synchronous equivalent - // has been overriden then the asychronous method will no longer be doing the same operation. -#if HAVE_ASYNC // Double-check this isn't included inappropriately. - private readonly bool _safeAsync; -#endif - - /// - /// Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task FlushAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoFlushAsync(cancellationToken) : base.FlushAsync(cancellationToken); - } - - internal Task DoFlushAsync(CancellationToken cancellationToken) - { - return cancellationToken.CancelIfRequestedAsync() ?? _writer.FlushAsync(); - } - - /// - /// Asynchronously writes the JSON value delimiter. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - protected override Task WriteValueDelimiterAsync(CancellationToken cancellationToken) - { - return _safeAsync ? DoWriteValueDelimiterAsync(cancellationToken) : base.WriteValueDelimiterAsync(cancellationToken); - } - - internal Task DoWriteValueDelimiterAsync(CancellationToken cancellationToken) - { - return _writer.WriteAsync(',', cancellationToken); - } - - /// - /// Asynchronously writes the specified end token. - /// - /// The end token to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - protected override Task WriteEndAsync(JsonToken token, CancellationToken cancellationToken) - { - return _safeAsync ? DoWriteEndAsync(token, cancellationToken) : base.WriteEndAsync(token, cancellationToken); - } - - internal Task DoWriteEndAsync(JsonToken token, CancellationToken cancellationToken) - { - switch (token) - { - case JsonToken.EndObject: - return _writer.WriteAsync('}', cancellationToken); - case JsonToken.EndArray: - return _writer.WriteAsync(']', cancellationToken); - case JsonToken.EndConstructor: - return _writer.WriteAsync(')', cancellationToken); - default: - throw JsonWriterException.Create(this, "Invalid JsonToken: " + token, null); - } - } - - /// - /// Asynchronously closes this writer. - /// If is set to true, the destination is also closed. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task CloseAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoCloseAsync(cancellationToken) : base.CloseAsync(cancellationToken); - } - - internal async Task DoCloseAsync(CancellationToken cancellationToken) - { - if (Top == 0) // otherwise will happen in calls to WriteEndAsync - { - cancellationToken.ThrowIfCancellationRequested(); - } - - while (Top > 0) - { - await WriteEndAsync(cancellationToken).ConfigureAwait(false); - } - - CloseBufferAndWriter(); - } - - /// - /// Asynchronously writes the end of the current JSON object or array. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteEndAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteEndInternalAsync(cancellationToken) : base.WriteEndAsync(cancellationToken); - } - - /// - /// Asynchronously writes indent characters. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - protected override Task WriteIndentAsync(CancellationToken cancellationToken) - { - return _safeAsync ? DoWriteIndentAsync(cancellationToken) : base.WriteIndentAsync(cancellationToken); - } - - internal Task DoWriteIndentAsync(CancellationToken cancellationToken) - { - // levels of indentation multiplied by the indent count - int currentIndentCount = Top * _indentation; - - int newLineLen = SetIndentChars(); - MiscellaneousUtils.Assert(_indentChars != null); - - if (currentIndentCount <= IndentCharBufferSize) - { - return _writer.WriteAsync(_indentChars, 0, newLineLen + currentIndentCount, cancellationToken); - } - - return WriteIndentAsync(currentIndentCount, newLineLen, cancellationToken); - } - - private async Task WriteIndentAsync(int currentIndentCount, int newLineLen, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(_indentChars != null); - - await _writer.WriteAsync(_indentChars, 0, newLineLen + Math.Min(currentIndentCount, IndentCharBufferSize), cancellationToken).ConfigureAwait(false); - - while ((currentIndentCount -= IndentCharBufferSize) > 0) - { - await _writer.WriteAsync(_indentChars, newLineLen, Math.Min(currentIndentCount, IndentCharBufferSize), cancellationToken).ConfigureAwait(false); - } - } - - private Task WriteValueInternalAsync(JsonToken token, string value, CancellationToken cancellationToken) - { - Task task = InternalWriteValueAsync(token, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return _writer.WriteAsync(value, cancellationToken); - } - - return WriteValueInternalAsync(task, value, cancellationToken); - } - - private async Task WriteValueInternalAsync(Task task, string value, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - await _writer.WriteAsync(value, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously writes an indent space. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - protected override Task WriteIndentSpaceAsync(CancellationToken cancellationToken) - { - return _safeAsync ? DoWriteIndentSpaceAsync(cancellationToken) : base.WriteIndentSpaceAsync(cancellationToken); - } - - internal Task DoWriteIndentSpaceAsync(CancellationToken cancellationToken) - { - return _writer.WriteAsync(' ', cancellationToken); - } - - /// - /// Asynchronously writes raw JSON without changing the writer's state. - /// - /// The raw JSON to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteRawAsync(string? json, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteRawAsync(json, cancellationToken) : base.WriteRawAsync(json, cancellationToken); - } - - internal Task DoWriteRawAsync(string? json, CancellationToken cancellationToken) - { - return _writer.WriteAsync(json, cancellationToken); - } - - /// - /// Asynchronously writes a null value. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteNullAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteNullAsync(cancellationToken) : base.WriteNullAsync(cancellationToken); - } - - internal Task DoWriteNullAsync(CancellationToken cancellationToken) - { - return WriteValueInternalAsync(JsonToken.Null, JsonConvert.Null, cancellationToken); - } - - private Task WriteDigitsAsync(ulong uvalue, bool negative, CancellationToken cancellationToken) - { - if (uvalue <= 9 & !negative) - { - return _writer.WriteAsync((char)('0' + uvalue), cancellationToken); - } - - int length = WriteNumberToBuffer(uvalue, negative); - return _writer.WriteAsync(_writeBuffer!, 0, length, cancellationToken); - } - - private Task WriteIntegerValueAsync(ulong uvalue, bool negative, CancellationToken cancellationToken) - { - Task task = InternalWriteValueAsync(JsonToken.Integer, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return WriteDigitsAsync(uvalue, negative, cancellationToken); - } - - return WriteIntegerValueAsync(task, uvalue, negative, cancellationToken); - } - - private async Task WriteIntegerValueAsync(Task task, ulong uvalue, bool negative, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - await WriteDigitsAsync(uvalue, negative, cancellationToken).ConfigureAwait(false); - } - - internal Task WriteIntegerValueAsync(long value, CancellationToken cancellationToken) - { - bool negative = value < 0; - if (negative) - { - value = -value; - } - - return WriteIntegerValueAsync((ulong)value, negative, cancellationToken); - } - - internal Task WriteIntegerValueAsync(ulong uvalue, CancellationToken cancellationToken) - { - return WriteIntegerValueAsync(uvalue, false, cancellationToken); - } - - private Task WriteEscapedStringAsync(string value, bool quote, CancellationToken cancellationToken) - { - return JavaScriptUtils.WriteEscapedJavaScriptStringAsync(_writer, value, _quoteChar, quote, _charEscapeFlags!, StringEscapeHandling, this, _writeBuffer!, cancellationToken); - } - - /// - /// Asynchronously writes the property name of a name/value pair of a JSON object. - /// - /// The name of the property. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WritePropertyNameAsync(string name, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWritePropertyNameAsync(name, cancellationToken) : base.WritePropertyNameAsync(name, cancellationToken); - } - - internal Task DoWritePropertyNameAsync(string name, CancellationToken cancellationToken) - { - Task task = InternalWritePropertyNameAsync(name, cancellationToken); - if (!task.IsCompletedSucessfully()) - { - return DoWritePropertyNameAsync(task, name, cancellationToken); - } - - task = WriteEscapedStringAsync(name, _quoteName, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return _writer.WriteAsync(':', cancellationToken); - } - - return JavaScriptUtils.WriteCharAsync(task, _writer, ':', cancellationToken); - } - - private async Task DoWritePropertyNameAsync(Task task, string name, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - - await WriteEscapedStringAsync(name, _quoteName, cancellationToken).ConfigureAwait(false); - - await _writer.WriteAsync(':').ConfigureAwait(false); - } - - /// - /// Asynchronously writes the property name of a name/value pair of a JSON object. - /// - /// The name of the property. - /// A flag to indicate whether the text should be escaped when it is written as a JSON property name. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WritePropertyNameAsync(string name, bool escape, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWritePropertyNameAsync(name, escape, cancellationToken) : base.WritePropertyNameAsync(name, escape, cancellationToken); - } - - internal async Task DoWritePropertyNameAsync(string name, bool escape, CancellationToken cancellationToken) - { - await InternalWritePropertyNameAsync(name, cancellationToken).ConfigureAwait(false); - - if (escape) - { - await WriteEscapedStringAsync(name, _quoteName, cancellationToken).ConfigureAwait(false); - } - else - { - if (_quoteName) - { - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); - } - - await _writer.WriteAsync(name, cancellationToken).ConfigureAwait(false); - - if (_quoteName) - { - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); - } - } - - await _writer.WriteAsync(':').ConfigureAwait(false); - } - - /// - /// Asynchronously writes the beginning of a JSON array. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteStartArrayAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteStartArrayAsync(cancellationToken) : base.WriteStartArrayAsync(cancellationToken); - } - - internal Task DoWriteStartArrayAsync(CancellationToken cancellationToken) - { - Task task = InternalWriteStartAsync(JsonToken.StartArray, JsonContainerType.Array, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return _writer.WriteAsync('[', cancellationToken); - } - - return DoWriteStartArrayAsync(task, cancellationToken); - } - - internal async Task DoWriteStartArrayAsync(Task task, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - - await _writer.WriteAsync('[', cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously writes the beginning of a JSON object. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteStartObjectAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteStartObjectAsync(cancellationToken) : base.WriteStartObjectAsync(cancellationToken); - } - - internal Task DoWriteStartObjectAsync(CancellationToken cancellationToken) - { - Task task = InternalWriteStartAsync(JsonToken.StartObject, JsonContainerType.Object, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return _writer.WriteAsync('{', cancellationToken); - } - - return DoWriteStartObjectAsync(task, cancellationToken); - } - - internal async Task DoWriteStartObjectAsync(Task task, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - - await _writer.WriteAsync('{', cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously writes the start of a constructor with the given name. - /// - /// The name of the constructor. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteStartConstructorAsync(string name, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteStartConstructorAsync(name, cancellationToken) : base.WriteStartConstructorAsync(name, cancellationToken); - } - - internal async Task DoWriteStartConstructorAsync(string name, CancellationToken cancellationToken) - { - await InternalWriteStartAsync(JsonToken.StartConstructor, JsonContainerType.Constructor, cancellationToken).ConfigureAwait(false); - - await _writer.WriteAsync("new ", cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync(name, cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync('(').ConfigureAwait(false); - } - - /// - /// Asynchronously writes an undefined value. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteUndefinedAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteUndefinedAsync(cancellationToken) : base.WriteUndefinedAsync(cancellationToken); - } - - internal Task DoWriteUndefinedAsync(CancellationToken cancellationToken) - { - Task task = InternalWriteValueAsync(JsonToken.Undefined, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return _writer.WriteAsync(JsonConvert.Undefined, cancellationToken); - } - - return DoWriteUndefinedAsync(task, cancellationToken); - } - - private async Task DoWriteUndefinedAsync(Task task, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - await _writer.WriteAsync(JsonConvert.Undefined, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously writes the given white space. - /// - /// The string of white space characters. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteWhitespaceAsync(string ws, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteWhitespaceAsync(ws, cancellationToken) : base.WriteWhitespaceAsync(ws, cancellationToken); - } - - internal Task DoWriteWhitespaceAsync(string ws, CancellationToken cancellationToken) - { - InternalWriteWhitespace(ws); - return _writer.WriteAsync(ws, cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(bool value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(bool value, CancellationToken cancellationToken) - { - return WriteValueInternalAsync(JsonToken.Boolean, JsonConvert.ToString(value), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(bool? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(bool? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : DoWriteValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(byte value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteIntegerValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(byte? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(byte? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : WriteIntegerValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a [] value. - /// - /// The [] value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(byte[]? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? (value == null ? WriteNullAsync(cancellationToken) : WriteValueNonNullAsync(value, cancellationToken)) : base.WriteValueAsync(value, cancellationToken); - } - - internal async Task WriteValueNonNullAsync(byte[] value, CancellationToken cancellationToken) - { - await InternalWriteValueAsync(JsonToken.Bytes, cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); - await Base64Encoder.EncodeAsync(value, 0, value.Length, cancellationToken).ConfigureAwait(false); - await Base64Encoder.FlushAsync(cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(char value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(char value, CancellationToken cancellationToken) - { - return WriteValueInternalAsync(JsonToken.String, JsonConvert.ToString(value), cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(char? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(char? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : DoWriteValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(DateTime value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal async Task DoWriteValueAsync(DateTime value, CancellationToken cancellationToken) - { - await InternalWriteValueAsync(JsonToken.Date, cancellationToken).ConfigureAwait(false); - value = DateTimeUtils.EnsureDateTime(value, DateTimeZoneHandling); - - if (StringUtils.IsNullOrEmpty(DateFormatString)) - { - int length = WriteValueToBuffer(value); - - await _writer.WriteAsync(_writeBuffer!, 0, length, cancellationToken).ConfigureAwait(false); - } - else - { - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); - await _writer.WriteAsync(value.ToString(DateFormatString, Culture), cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); - } - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(DateTime? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(DateTime? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : DoWriteValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(DateTimeOffset value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal async Task DoWriteValueAsync(DateTimeOffset value, CancellationToken cancellationToken) - { - await InternalWriteValueAsync(JsonToken.Date, cancellationToken).ConfigureAwait(false); - - if (StringUtils.IsNullOrEmpty(DateFormatString)) - { - int length = WriteValueToBuffer(value); - - await _writer.WriteAsync(_writeBuffer!, 0, length, cancellationToken).ConfigureAwait(false); - } - else - { - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); - await _writer.WriteAsync(value.ToString(DateFormatString, Culture), cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); - } - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(DateTimeOffset? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(DateTimeOffset? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : DoWriteValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(decimal value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(decimal value, CancellationToken cancellationToken) - { - return WriteValueInternalAsync(JsonToken.Float, JsonConvert.ToString(value), cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(decimal? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(decimal? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : DoWriteValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(double value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteValueAsync(value, false, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task WriteValueAsync(double value, bool nullable, CancellationToken cancellationToken) - { - return WriteValueInternalAsync(JsonToken.Float, JsonConvert.ToString(value, FloatFormatHandling, QuoteChar, nullable), cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(double? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? (value.HasValue ? WriteValueAsync(value.GetValueOrDefault(), true, cancellationToken) : WriteNullAsync(cancellationToken)) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(float value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteValueAsync(value, false, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task WriteValueAsync(float value, bool nullable, CancellationToken cancellationToken) - { - return WriteValueInternalAsync(JsonToken.Float, JsonConvert.ToString(value, FloatFormatHandling, QuoteChar, nullable), cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(float? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? (value.HasValue ? WriteValueAsync(value.GetValueOrDefault(), true, cancellationToken) : WriteNullAsync(cancellationToken)) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(Guid value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal async Task DoWriteValueAsync(Guid value, CancellationToken cancellationToken) - { - await InternalWriteValueAsync(JsonToken.String, cancellationToken).ConfigureAwait(false); - - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); -#if HAVE_CHAR_TO_STRING_WITH_CULTURE - await _writer.WriteAsync(value.ToString("D", CultureInfo.InvariantCulture), cancellationToken).ConfigureAwait(false); -#else - await _writer.WriteAsync(value.ToString("D"), cancellationToken).ConfigureAwait(false); -#endif - await _writer.WriteAsync(_quoteChar).ConfigureAwait(false); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(Guid? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(Guid? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : DoWriteValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(int value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteIntegerValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(int? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(int? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : WriteIntegerValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(long value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteIntegerValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(long? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(long? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : WriteIntegerValueAsync(value.GetValueOrDefault(), cancellationToken); - } - -#if HAVE_BIG_INTEGER - internal Task WriteValueAsync(BigInteger value, CancellationToken cancellationToken) - { - return WriteValueInternalAsync(JsonToken.Integer, value.ToString(CultureInfo.InvariantCulture), cancellationToken); - } -#endif - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(object? value, CancellationToken cancellationToken = default) - { - if (_safeAsync) - { - if (value == null) - { - return WriteNullAsync(cancellationToken); - } -#if HAVE_BIG_INTEGER - if (value is BigInteger i) - { - return WriteValueAsync(i, cancellationToken); - } -#endif - - return WriteValueAsync(this, ConvertUtils.GetTypeCode(value.GetType()), value, cancellationToken); - } - - return base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - [CLSCompliant(false)] - public override Task WriteValueAsync(sbyte value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteIntegerValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - [CLSCompliant(false)] - public override Task WriteValueAsync(sbyte? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(sbyte? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : WriteIntegerValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(short value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteIntegerValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(short? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(short? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : WriteIntegerValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(string? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(string? value, CancellationToken cancellationToken) - { - Task task = InternalWriteValueAsync(JsonToken.String, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return value == null ? _writer.WriteAsync(JsonConvert.Null, cancellationToken) : WriteEscapedStringAsync(value, true, cancellationToken); - } - - return DoWriteValueAsync(task, value, cancellationToken); - } - - private async Task DoWriteValueAsync(Task task, string? value, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - await (value == null ? _writer.WriteAsync(JsonConvert.Null, cancellationToken) : WriteEscapedStringAsync(value, true, cancellationToken)).ConfigureAwait(false); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(TimeSpan value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal async Task DoWriteValueAsync(TimeSpan value, CancellationToken cancellationToken) - { - await InternalWriteValueAsync(JsonToken.String, cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync(_quoteChar, cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync(value.ToString(null, CultureInfo.InvariantCulture), cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync(_quoteChar, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(TimeSpan? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(TimeSpan? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : DoWriteValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - [CLSCompliant(false)] - public override Task WriteValueAsync(uint value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteIntegerValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - [CLSCompliant(false)] - public override Task WriteValueAsync(uint? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(uint? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : WriteIntegerValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - [CLSCompliant(false)] - public override Task WriteValueAsync(ulong value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteIntegerValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - [CLSCompliant(false)] - public override Task WriteValueAsync(ulong? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(ulong? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : WriteIntegerValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteValueAsync(Uri? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? (value == null ? WriteNullAsync(cancellationToken) : WriteValueNotNullAsync(value, cancellationToken)) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task WriteValueNotNullAsync(Uri value, CancellationToken cancellationToken) - { - Task task = InternalWriteValueAsync(JsonToken.String, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return WriteEscapedStringAsync(value.OriginalString, true, cancellationToken); - } - - return WriteValueNotNullAsync(task, value, cancellationToken); - } - - internal async Task WriteValueNotNullAsync(Task task, Uri value, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - await WriteEscapedStringAsync(value.OriginalString, true, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - [CLSCompliant(false)] - public override Task WriteValueAsync(ushort value, CancellationToken cancellationToken = default) - { - return _safeAsync ? WriteIntegerValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - [CLSCompliant(false)] - public override Task WriteValueAsync(ushort? value, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteValueAsync(value, cancellationToken) : base.WriteValueAsync(value, cancellationToken); - } - - internal Task DoWriteValueAsync(ushort? value, CancellationToken cancellationToken) - { - return value == null ? DoWriteNullAsync(cancellationToken) : WriteIntegerValueAsync(value.GetValueOrDefault(), cancellationToken); - } - - /// - /// Asynchronously writes a comment /*...*/ containing the specified text. - /// - /// Text to place inside the comment. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteCommentAsync(string? text, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteCommentAsync(text, cancellationToken) : base.WriteCommentAsync(text, cancellationToken); - } - - internal async Task DoWriteCommentAsync(string? text, CancellationToken cancellationToken) - { - await InternalWriteCommentAsync(cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync("/*", cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync(text ?? string.Empty, cancellationToken).ConfigureAwait(false); - await _writer.WriteAsync("*/", cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously writes the end of an array. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteEndArrayAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? InternalWriteEndAsync(JsonContainerType.Array, cancellationToken) : base.WriteEndArrayAsync(cancellationToken); - } - - /// - /// Asynchronously writes the end of a constructor. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteEndConstructorAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? InternalWriteEndAsync(JsonContainerType.Constructor, cancellationToken) : base.WriteEndConstructorAsync(cancellationToken); - } - - /// - /// Asynchronously writes the end of a JSON object. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteEndObjectAsync(CancellationToken cancellationToken = default) - { - return _safeAsync ? InternalWriteEndAsync(JsonContainerType.Object, cancellationToken) : base.WriteEndObjectAsync(cancellationToken); - } - - /// - /// Asynchronously writes raw JSON where a value is expected and updates the writer's state. - /// - /// The raw JSON to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// Derived classes must override this method to get asynchronous behaviour. Otherwise it will - /// execute synchronously, returning an already-completed task. - public override Task WriteRawValueAsync(string? json, CancellationToken cancellationToken = default) - { - return _safeAsync ? DoWriteRawValueAsync(json, cancellationToken) : base.WriteRawValueAsync(json, cancellationToken); - } - - internal Task DoWriteRawValueAsync(string? json, CancellationToken cancellationToken) - { - UpdateScopeWithFinishedValue(); - Task task = AutoCompleteAsync(JsonToken.Undefined, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return WriteRawAsync(json, cancellationToken); - } - - return DoWriteRawValueAsync(task, json, cancellationToken); - } - - private async Task DoWriteRawValueAsync(Task task, string? json, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - await WriteRawAsync(json, cancellationToken).ConfigureAwait(false); - } - - internal char[] EnsureWriteBuffer(int length, int copyTo) - { - if (length < 35) - { - length = 35; - } - - char[]? buffer = _writeBuffer; - if (buffer == null) - { - return _writeBuffer = BufferUtils.RentBuffer(_arrayPool, length); - } - - if (buffer.Length >= length) - { - return buffer; - } - - char[] newBuffer = BufferUtils.RentBuffer(_arrayPool, length); - if (copyTo != 0) - { - Array.Copy(buffer, newBuffer, copyTo); - } - - BufferUtils.ReturnBuffer(_arrayPool, buffer); - _writeBuffer = newBuffer; - return newBuffer; - } - } -} -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonTextWriter.cs b/Source/MyDb/Newtonsoft.Json/JsonTextWriter.cs deleted file mode 100644 index b08dfb4..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonTextWriter.cs +++ /dev/null @@ -1,920 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using System.Text; -using System.IO; -using System.Xml; -using Newtonsoft.Json.Utilities; -using System.Diagnostics; - -namespace Newtonsoft.Json -{ - /// - /// Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. - /// - public partial class JsonTextWriter : JsonWriter - { - private const int IndentCharBufferSize = 12; - private readonly TextWriter _writer; - private Base64Encoder? _base64Encoder; - private char _indentChar; - private int _indentation; - private char _quoteChar; - private bool _quoteName; - private bool[]? _charEscapeFlags; - private char[]? _writeBuffer; - private IArrayPool? _arrayPool; - private char[]? _indentChars; - - private Base64Encoder Base64Encoder - { - get - { - if (_base64Encoder == null) - { - _base64Encoder = new Base64Encoder(_writer); - } - - return _base64Encoder; - } - } - - /// - /// Gets or sets the writer's character array pool. - /// - public IArrayPool? ArrayPool - { - get => _arrayPool; - set - { - if (value == null) - { - throw new ArgumentNullException(nameof(value)); - } - - _arrayPool = value; - } - } - - /// - /// Gets or sets how many s to write for each level in the hierarchy when is set to . - /// - public int Indentation - { - get => _indentation; - set - { - if (value < 0) - { - throw new ArgumentException("Indentation value must be greater than 0."); - } - - _indentation = value; - } - } - - /// - /// Gets or sets which character to use to quote attribute values. - /// - public char QuoteChar - { - get => _quoteChar; - set - { - if (value != '"' && value != '\'') - { - throw new ArgumentException(@"Invalid JavaScript string quote character. Valid quote characters are ' and ""."); - } - - _quoteChar = value; - UpdateCharEscapeFlags(); - } - } - - /// - /// Gets or sets which character to use for indenting when is set to . - /// - public char IndentChar - { - get => _indentChar; - set - { - if (value != _indentChar) - { - _indentChar = value; - _indentChars = null; - } - } - } - - /// - /// Gets or sets a value indicating whether object names will be surrounded with quotes. - /// - public bool QuoteName - { - get => _quoteName; - set => _quoteName = value; - } - - /// - /// Initializes a new instance of the class using the specified . - /// - /// The to write to. - public JsonTextWriter(TextWriter textWriter) - { - if (textWriter == null) - { - throw new ArgumentNullException(nameof(textWriter)); - } - - _writer = textWriter; - _quoteChar = '"'; - _quoteName = true; - _indentChar = ' '; - _indentation = 2; - - UpdateCharEscapeFlags(); - -#if HAVE_ASYNC - _safeAsync = GetType() == typeof(JsonTextWriter); -#endif - } - - /// - /// Flushes whatever is in the buffer to the underlying and also flushes the underlying . - /// - public override void Flush() - { - _writer.Flush(); - } - - /// - /// Closes this writer. - /// If is set to true, the underlying is also closed. - /// If is set to true, the JSON is auto-completed. - /// - public override void Close() - { - base.Close(); - - CloseBufferAndWriter(); - } - - private void CloseBufferAndWriter() - { - if (_writeBuffer != null) - { - BufferUtils.ReturnBuffer(_arrayPool, _writeBuffer); - _writeBuffer = null; - } - - if (CloseOutput) - { -#if HAVE_STREAM_READER_WRITER_CLOSE - _writer?.Close(); -#else - _writer?.Dispose(); -#endif - } - } - - /// - /// Writes the beginning of a JSON object. - /// - public override void WriteStartObject() - { - InternalWriteStart(JsonToken.StartObject, JsonContainerType.Object); - - _writer.Write('{'); - } - - /// - /// Writes the beginning of a JSON array. - /// - public override void WriteStartArray() - { - InternalWriteStart(JsonToken.StartArray, JsonContainerType.Array); - - _writer.Write('['); - } - - /// - /// Writes the start of a constructor with the given name. - /// - /// The name of the constructor. - public override void WriteStartConstructor(string name) - { - InternalWriteStart(JsonToken.StartConstructor, JsonContainerType.Constructor); - - _writer.Write("new "); - _writer.Write(name); - _writer.Write('('); - } - - /// - /// Writes the specified end token. - /// - /// The end token to write. - protected override void WriteEnd(JsonToken token) - { - switch (token) - { - case JsonToken.EndObject: - _writer.Write('}'); - break; - case JsonToken.EndArray: - _writer.Write(']'); - break; - case JsonToken.EndConstructor: - _writer.Write(')'); - break; - default: - throw JsonWriterException.Create(this, "Invalid JsonToken: " + token, null); - } - } - - /// - /// Writes the property name of a name/value pair on a JSON object. - /// - /// The name of the property. - public override void WritePropertyName(string name) - { - InternalWritePropertyName(name); - - WriteEscapedString(name, _quoteName); - - _writer.Write(':'); - } - - /// - /// Writes the property name of a name/value pair on a JSON object. - /// - /// The name of the property. - /// A flag to indicate whether the text should be escaped when it is written as a JSON property name. - public override void WritePropertyName(string name, bool escape) - { - InternalWritePropertyName(name); - - if (escape) - { - WriteEscapedString(name, _quoteName); - } - else - { - if (_quoteName) - { - _writer.Write(_quoteChar); - } - - _writer.Write(name); - - if (_quoteName) - { - _writer.Write(_quoteChar); - } - } - - _writer.Write(':'); - } - - internal override void OnStringEscapeHandlingChanged() - { - UpdateCharEscapeFlags(); - } - - private void UpdateCharEscapeFlags() - { - _charEscapeFlags = JavaScriptUtils.GetCharEscapeFlags(StringEscapeHandling, _quoteChar); - } - - /// - /// Writes indent characters. - /// - protected override void WriteIndent() - { - // levels of indentation multiplied by the indent count - int currentIndentCount = Top * _indentation; - - int newLineLen = SetIndentChars(); - - _writer.Write(_indentChars, 0, newLineLen + Math.Min(currentIndentCount, IndentCharBufferSize)); - - while ((currentIndentCount -= IndentCharBufferSize) > 0) - { - _writer.Write(_indentChars, newLineLen, Math.Min(currentIndentCount, IndentCharBufferSize)); - } - } - - private int SetIndentChars() - { - // Set _indentChars to be a newline followed by IndentCharBufferSize indent characters. - string writerNewLine = _writer.NewLine; - int newLineLen = writerNewLine.Length; - bool match = _indentChars != null && _indentChars.Length == IndentCharBufferSize + newLineLen; - if (match) - { - for (int i = 0; i != newLineLen; ++i) - { - if (writerNewLine[i] != _indentChars![i]) - { - match = false; - break; - } - } - } - - if (!match) - { - // If we're here, either _indentChars hasn't been set yet, or _writer.NewLine - // has been changed, or _indentChar has been changed. - _indentChars = (writerNewLine + new string(_indentChar, IndentCharBufferSize)).ToCharArray(); - } - - return newLineLen; - } - - /// - /// Writes the JSON value delimiter. - /// - protected override void WriteValueDelimiter() - { - _writer.Write(','); - } - - /// - /// Writes an indent space. - /// - protected override void WriteIndentSpace() - { - _writer.Write(' '); - } - - private void WriteValueInternal(string value, JsonToken token) - { - _writer.Write(value); - } - - #region WriteValue methods - /// - /// Writes a value. - /// An error will raised if the value cannot be written as a single JSON token. - /// - /// The value to write. - public override void WriteValue(object? value) - { -#if HAVE_BIG_INTEGER - if (value is BigInteger i) - { - InternalWriteValue(JsonToken.Integer); - WriteValueInternal(i.ToString(CultureInfo.InvariantCulture), JsonToken.String); - } - else -#endif - { - base.WriteValue(value); - } - } - - /// - /// Writes a null value. - /// - public override void WriteNull() - { - InternalWriteValue(JsonToken.Null); - WriteValueInternal(JsonConvert.Null, JsonToken.Null); - } - - /// - /// Writes an undefined value. - /// - public override void WriteUndefined() - { - InternalWriteValue(JsonToken.Undefined); - WriteValueInternal(JsonConvert.Undefined, JsonToken.Undefined); - } - - /// - /// Writes raw JSON. - /// - /// The raw JSON to write. - public override void WriteRaw(string? json) - { - InternalWriteRaw(); - - _writer.Write(json); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(string? value) - { - InternalWriteValue(JsonToken.String); - - if (value == null) - { - WriteValueInternal(JsonConvert.Null, JsonToken.Null); - } - else - { - WriteEscapedString(value, true); - } - } - - private void WriteEscapedString(string value, bool quote) - { - EnsureWriteBuffer(); - JavaScriptUtils.WriteEscapedJavaScriptString(_writer, value, _quoteChar, quote, _charEscapeFlags!, StringEscapeHandling, _arrayPool, ref _writeBuffer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(int value) - { - InternalWriteValue(JsonToken.Integer); - WriteIntegerValue(value); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(uint value) - { - InternalWriteValue(JsonToken.Integer); - WriteIntegerValue(value); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(long value) - { - InternalWriteValue(JsonToken.Integer); - WriteIntegerValue(value); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(ulong value) - { - InternalWriteValue(JsonToken.Integer); - WriteIntegerValue(value, false); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(float value) - { - InternalWriteValue(JsonToken.Float); - WriteValueInternal(JsonConvert.ToString(value, FloatFormatHandling, QuoteChar, false), JsonToken.Float); - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public override void WriteValue(float? value) - { - if (value == null) - { - WriteNull(); - } - else - { - InternalWriteValue(JsonToken.Float); - WriteValueInternal(JsonConvert.ToString(value.GetValueOrDefault(), FloatFormatHandling, QuoteChar, true), JsonToken.Float); - } - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(double value) - { - InternalWriteValue(JsonToken.Float); - WriteValueInternal(JsonConvert.ToString(value, FloatFormatHandling, QuoteChar, false), JsonToken.Float); - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public override void WriteValue(double? value) - { - if (value == null) - { - WriteNull(); - } - else - { - InternalWriteValue(JsonToken.Float); - WriteValueInternal(JsonConvert.ToString(value.GetValueOrDefault(), FloatFormatHandling, QuoteChar, true), JsonToken.Float); - } - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(bool value) - { - InternalWriteValue(JsonToken.Boolean); - WriteValueInternal(JsonConvert.ToString(value), JsonToken.Boolean); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(short value) - { - InternalWriteValue(JsonToken.Integer); - WriteIntegerValue(value); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(ushort value) - { - InternalWriteValue(JsonToken.Integer); - WriteIntegerValue(value); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(char value) - { - InternalWriteValue(JsonToken.String); - WriteValueInternal(JsonConvert.ToString(value), JsonToken.String); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(byte value) - { - InternalWriteValue(JsonToken.Integer); - WriteIntegerValue(value); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(sbyte value) - { - InternalWriteValue(JsonToken.Integer); - WriteIntegerValue(value); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(decimal value) - { - InternalWriteValue(JsonToken.Float); - WriteValueInternal(JsonConvert.ToString(value), JsonToken.Float); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(DateTime value) - { - InternalWriteValue(JsonToken.Date); - value = DateTimeUtils.EnsureDateTime(value, DateTimeZoneHandling); - - if (StringUtils.IsNullOrEmpty(DateFormatString)) - { - int length = WriteValueToBuffer(value); - - _writer.Write(_writeBuffer, 0, length); - } - else - { - _writer.Write(_quoteChar); - _writer.Write(value.ToString(DateFormatString, Culture)); - _writer.Write(_quoteChar); - } - } - - private int WriteValueToBuffer(DateTime value) - { - EnsureWriteBuffer(); - MiscellaneousUtils.Assert(_writeBuffer != null); - - int pos = 0; - _writeBuffer[pos++] = _quoteChar; - pos = DateTimeUtils.WriteDateTimeString(_writeBuffer, pos, value, null, value.Kind, DateFormatHandling); - _writeBuffer[pos++] = _quoteChar; - return pos; - } - - /// - /// Writes a [] value. - /// - /// The [] value to write. - public override void WriteValue(byte[]? value) - { - if (value == null) - { - WriteNull(); - } - else - { - InternalWriteValue(JsonToken.Bytes); - _writer.Write(_quoteChar); - Base64Encoder.Encode(value, 0, value.Length); - Base64Encoder.Flush(); - _writer.Write(_quoteChar); - } - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(DateTimeOffset value) - { - InternalWriteValue(JsonToken.Date); - - if (StringUtils.IsNullOrEmpty(DateFormatString)) - { - int length = WriteValueToBuffer(value); - - _writer.Write(_writeBuffer, 0, length); - } - else - { - _writer.Write(_quoteChar); - _writer.Write(value.ToString(DateFormatString, Culture)); - _writer.Write(_quoteChar); - } - } - - private int WriteValueToBuffer(DateTimeOffset value) - { - EnsureWriteBuffer(); - MiscellaneousUtils.Assert(_writeBuffer != null); - - int pos = 0; - _writeBuffer[pos++] = _quoteChar; - pos = DateTimeUtils.WriteDateTimeString(_writeBuffer, pos, (DateFormatHandling == DateFormatHandling.IsoDateFormat) ? value.DateTime : value.UtcDateTime, value.Offset, DateTimeKind.Local, DateFormatHandling); - _writeBuffer[pos++] = _quoteChar; - return pos; - } -#endif - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(Guid value) - { - InternalWriteValue(JsonToken.String); - - string text; - -#if HAVE_CHAR_TO_STRING_WITH_CULTURE - text = value.ToString("D", CultureInfo.InvariantCulture); -#else - text = value.ToString("D"); -#endif - - _writer.Write(_quoteChar); - _writer.Write(text); - _writer.Write(_quoteChar); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(TimeSpan value) - { - InternalWriteValue(JsonToken.String); - - string text; -#if !HAVE_TIME_SPAN_TO_STRING_WITH_CULTURE - text = value.ToString(); -#else - text = value.ToString(null, CultureInfo.InvariantCulture); -#endif - - _writer.Write(_quoteChar); - _writer.Write(text); - _writer.Write(_quoteChar); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(Uri? value) - { - if (value == null) - { - WriteNull(); - } - else - { - InternalWriteValue(JsonToken.String); - WriteEscapedString(value.OriginalString, true); - } - } - #endregion - - /// - /// Writes a comment /*...*/ containing the specified text. - /// - /// Text to place inside the comment. - public override void WriteComment(string? text) - { - InternalWriteComment(); - - _writer.Write("/*"); - _writer.Write(text); - _writer.Write("*/"); - } - - /// - /// Writes the given white space. - /// - /// The string of white space characters. - public override void WriteWhitespace(string ws) - { - InternalWriteWhitespace(ws); - - _writer.Write(ws); - } - - private void EnsureWriteBuffer() - { - if (_writeBuffer == null) - { - // maximum buffer sized used when writing iso date - _writeBuffer = BufferUtils.RentBuffer(_arrayPool, 35); - } - } - - private void WriteIntegerValue(long value) - { - if (value >= 0 && value <= 9) - { - _writer.Write((char)('0' + value)); - } - else - { - bool negative = value < 0; - WriteIntegerValue(negative ? (ulong)-value : (ulong)value, negative); - } - } - - private void WriteIntegerValue(ulong value, bool negative) - { - if (!negative & value <= 9) - { - _writer.Write((char)('0' + value)); - } - else - { - int length = WriteNumberToBuffer(value, negative); - _writer.Write(_writeBuffer, 0, length); - } - } - - private int WriteNumberToBuffer(ulong value, bool negative) - { - if (value <= uint.MaxValue) - { - // avoid the 64 bit division if possible - return WriteNumberToBuffer((uint)value, negative); - } - - EnsureWriteBuffer(); - MiscellaneousUtils.Assert(_writeBuffer != null); - - int totalLength = MathUtils.IntLength(value); - - if (negative) - { - totalLength++; - _writeBuffer[0] = '-'; - } - - int index = totalLength; - - do - { - ulong quotient = value / 10; - ulong digit = value - (quotient * 10); - _writeBuffer[--index] = (char)('0' + digit); - value = quotient; - } while (value != 0); - - return totalLength; - } - - private void WriteIntegerValue(int value) - { - if (value >= 0 && value <= 9) - { - _writer.Write((char)('0' + value)); - } - else - { - bool negative = value < 0; - WriteIntegerValue(negative ? (uint)-value : (uint)value, negative); - } - } - - private void WriteIntegerValue(uint value, bool negative) - { - if (!negative & value <= 9) - { - _writer.Write((char)('0' + value)); - } - else - { - int length = WriteNumberToBuffer(value, negative); - _writer.Write(_writeBuffer, 0, length); - } - } - - private int WriteNumberToBuffer(uint value, bool negative) - { - EnsureWriteBuffer(); - MiscellaneousUtils.Assert(_writeBuffer != null); - - int totalLength = MathUtils.IntLength(value); - - if (negative) - { - totalLength++; - _writeBuffer[0] = '-'; - } - - int index = totalLength; - - do - { - uint quotient = value / 10; - uint digit = value - (quotient * 10); - _writeBuffer[--index] = (char)('0' + digit); - value = quotient; - } while (value != 0); - - return totalLength; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonToken.cs b/Source/MyDb/Newtonsoft.Json/JsonToken.cs deleted file mode 100644 index 92632e3..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonToken.cs +++ /dev/null @@ -1,127 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; - -namespace Newtonsoft.Json -{ - /// - /// Specifies the type of JSON token. - /// - public enum JsonToken - { - /// - /// This is returned by the if a read method has not been called. - /// - None = 0, - - /// - /// An object start token. - /// - StartObject = 1, - - /// - /// An array start token. - /// - StartArray = 2, - - /// - /// A constructor start token. - /// - StartConstructor = 3, - - /// - /// An object property name. - /// - PropertyName = 4, - - /// - /// A comment. - /// - Comment = 5, - - /// - /// Raw JSON. - /// - Raw = 6, - - /// - /// An integer. - /// - Integer = 7, - - /// - /// A float. - /// - Float = 8, - - /// - /// A string. - /// - String = 9, - - /// - /// A boolean. - /// - Boolean = 10, - - /// - /// A null token. - /// - Null = 11, - - /// - /// An undefined token. - /// - Undefined = 12, - - /// - /// An object end token. - /// - EndObject = 13, - - /// - /// An array end token. - /// - EndArray = 14, - - /// - /// A constructor end token. - /// - EndConstructor = 15, - - /// - /// A Date. - /// - Date = 16, - - /// - /// Byte data. - /// - Bytes = 17 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonValidatingReader.cs b/Source/MyDb/Newtonsoft.Json/JsonValidatingReader.cs deleted file mode 100644 index 7b6de59..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonValidatingReader.cs +++ /dev/null @@ -1,1025 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Schema; -using Newtonsoft.Json.Utilities; -using System.Globalization; -using System.Text.RegularExpressions; -using System.IO; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -#nullable disable - -namespace Newtonsoft.Json -{ - /// - /// - /// Represents a reader that provides validation. - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public class JsonValidatingReader : JsonReader, IJsonLineInfo - { - private class SchemaScope - { - private readonly JTokenType _tokenType; - private readonly IList _schemas; - private readonly Dictionary _requiredProperties; - - public string CurrentPropertyName { get; set; } - public int ArrayItemCount { get; set; } - public bool IsUniqueArray { get; } - public IList UniqueArrayItems { get; } - public JTokenWriter CurrentItemWriter { get; set; } - - public IList Schemas => _schemas; - - public Dictionary RequiredProperties => _requiredProperties; - - public JTokenType TokenType => _tokenType; - - public SchemaScope(JTokenType tokenType, IList schemas) - { - _tokenType = tokenType; - _schemas = schemas; - - _requiredProperties = schemas.SelectMany(GetRequiredProperties).Distinct().ToDictionary(p => p, p => false); - - if (tokenType == JTokenType.Array && schemas.Any(s => s.UniqueItems)) - { - IsUniqueArray = true; - UniqueArrayItems = new List(); - } - } - - private IEnumerable GetRequiredProperties(JsonSchemaModel schema) - { - if (schema?.Properties == null) - { - return Enumerable.Empty(); - } - - return schema.Properties.Where(p => p.Value.Required).Select(p => p.Key); - } - } - - private readonly JsonReader _reader; - private readonly Stack _stack; - private JsonSchema _schema; - private JsonSchemaModel _model; - private SchemaScope _currentScope; - - /// - /// Sets an event handler for receiving schema validation errors. - /// - public event ValidationEventHandler ValidationEventHandler; - - /// - /// Gets the text value of the current JSON token. - /// - /// - public override object Value => _reader.Value; - - /// - /// Gets the depth of the current token in the JSON document. - /// - /// The depth of the current token in the JSON document. - public override int Depth => _reader.Depth; - - /// - /// Gets the path of the current JSON token. - /// - public override string Path => _reader.Path; - - /// - /// Gets the quotation mark character used to enclose the value of a string. - /// - /// - public override char QuoteChar - { - get { return _reader.QuoteChar; } - protected internal set { } - } - - /// - /// Gets the type of the current JSON token. - /// - /// - public override JsonToken TokenType => _reader.TokenType; - - /// - /// Gets the .NET type for the current JSON token. - /// - /// - public override Type ValueType => _reader.ValueType; - - private void Push(SchemaScope scope) - { - _stack.Push(scope); - _currentScope = scope; - } - - private SchemaScope Pop() - { - SchemaScope poppedScope = _stack.Pop(); - _currentScope = (_stack.Count != 0) - ? _stack.Peek() - : null; - - return poppedScope; - } - - private IList CurrentSchemas => _currentScope.Schemas; - - private static readonly IList EmptySchemaList = new List(); - - private IList CurrentMemberSchemas - { - get - { - if (_currentScope == null) - { - return new List(new[] { _model }); - } - - if (_currentScope.Schemas == null || _currentScope.Schemas.Count == 0) - { - return EmptySchemaList; - } - - switch (_currentScope.TokenType) - { - case JTokenType.None: - return _currentScope.Schemas; - case JTokenType.Object: - { - if (_currentScope.CurrentPropertyName == null) - { - throw new JsonReaderException("CurrentPropertyName has not been set on scope."); - } - - IList schemas = new List(); - - foreach (JsonSchemaModel schema in CurrentSchemas) - { - if (schema.Properties != null && schema.Properties.TryGetValue(_currentScope.CurrentPropertyName, out JsonSchemaModel propertySchema)) - { - schemas.Add(propertySchema); - } - if (schema.PatternProperties != null) - { - foreach (KeyValuePair patternProperty in schema.PatternProperties) - { - if (Regex.IsMatch(_currentScope.CurrentPropertyName, patternProperty.Key)) - { - schemas.Add(patternProperty.Value); - } - } - } - - if (schemas.Count == 0 && schema.AllowAdditionalProperties && schema.AdditionalProperties != null) - { - schemas.Add(schema.AdditionalProperties); - } - } - - return schemas; - } - case JTokenType.Array: - { - IList schemas = new List(); - - foreach (JsonSchemaModel schema in CurrentSchemas) - { - if (!schema.PositionalItemsValidation) - { - if (schema.Items != null && schema.Items.Count > 0) - { - schemas.Add(schema.Items[0]); - } - } - else - { - if (schema.Items != null && schema.Items.Count > 0) - { - if (schema.Items.Count > (_currentScope.ArrayItemCount - 1)) - { - schemas.Add(schema.Items[_currentScope.ArrayItemCount - 1]); - } - } - - if (schema.AllowAdditionalItems && schema.AdditionalItems != null) - { - schemas.Add(schema.AdditionalItems); - } - } - } - - return schemas; - } - case JTokenType.Constructor: - return EmptySchemaList; - default: - throw new ArgumentOutOfRangeException("TokenType", "Unexpected token type: {0}".FormatWith(CultureInfo.InvariantCulture, _currentScope.TokenType)); - } - } - } - - private void RaiseError(string message, JsonSchemaModel schema) - { - IJsonLineInfo lineInfo = this; - - string exceptionMessage = (lineInfo.HasLineInfo()) - ? message + " Line {0}, position {1}.".FormatWith(CultureInfo.InvariantCulture, lineInfo.LineNumber, lineInfo.LinePosition) - : message; - - OnValidationEvent(new JsonSchemaException(exceptionMessage, null, Path, lineInfo.LineNumber, lineInfo.LinePosition)); - } - - private void OnValidationEvent(JsonSchemaException exception) - { - ValidationEventHandler handler = ValidationEventHandler; - if (handler != null) - { - handler(this, new ValidationEventArgs(exception)); - } - else - { - throw exception; - } - } - - /// - /// Initializes a new instance of the class that - /// validates the content returned from the given . - /// - /// The to read from while validating. - public JsonValidatingReader(JsonReader reader) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - _reader = reader; - _stack = new Stack(); - } - - /// - /// Gets or sets the schema. - /// - /// The schema. - public JsonSchema Schema - { - get => _schema; - set - { - if (TokenType != JsonToken.None) - { - throw new InvalidOperationException("Cannot change schema while validating JSON."); - } - - _schema = value; - _model = null; - } - } - - /// - /// Gets the used to construct this . - /// - /// The specified in the constructor. - public JsonReader Reader => _reader; - - /// - /// Changes the reader's state to . - /// If is set to true, the underlying is also closed. - /// - public override void Close() - { - base.Close(); - if (CloseInput) - { - _reader?.Close(); - } - } - - private void ValidateNotDisallowed(JsonSchemaModel schema) - { - if (schema == null) - { - return; - } - - JsonSchemaType? currentNodeType = GetCurrentNodeSchemaType(); - if (currentNodeType != null) - { - if (JsonSchemaGenerator.HasFlag(schema.Disallow, currentNodeType.GetValueOrDefault())) - { - RaiseError("Type {0} is disallowed.".FormatWith(CultureInfo.InvariantCulture, currentNodeType), schema); - } - } - } - - private JsonSchemaType? GetCurrentNodeSchemaType() - { - switch (_reader.TokenType) - { - case JsonToken.StartObject: - return JsonSchemaType.Object; - case JsonToken.StartArray: - return JsonSchemaType.Array; - case JsonToken.Integer: - return JsonSchemaType.Integer; - case JsonToken.Float: - return JsonSchemaType.Float; - case JsonToken.String: - return JsonSchemaType.String; - case JsonToken.Boolean: - return JsonSchemaType.Boolean; - case JsonToken.Null: - return JsonSchemaType.Null; - default: - return null; - } - } - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . - public override int? ReadAsInt32() - { - int? i = _reader.ReadAsInt32(); - - ValidateCurrentToken(); - return i; - } - - /// - /// Reads the next JSON token from the underlying as a []. - /// - /// - /// A [] or null if the next JSON token is null. - /// - public override byte[] ReadAsBytes() - { - byte[] data = _reader.ReadAsBytes(); - - ValidateCurrentToken(); - return data; - } - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . - public override decimal? ReadAsDecimal() - { - decimal? d = _reader.ReadAsDecimal(); - - ValidateCurrentToken(); - return d; - } - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . - public override double? ReadAsDouble() - { - double? d = _reader.ReadAsDouble(); - - ValidateCurrentToken(); - return d; - } - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . - public override bool? ReadAsBoolean() - { - bool? b = _reader.ReadAsBoolean(); - - ValidateCurrentToken(); - return b; - } - - /// - /// Reads the next JSON token from the underlying as a . - /// - /// A . This method will return null at the end of an array. - public override string ReadAsString() - { - string s = _reader.ReadAsString(); - - ValidateCurrentToken(); - return s; - } - - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . This method will return null at the end of an array. - public override DateTime? ReadAsDateTime() - { - DateTime? dateTime = _reader.ReadAsDateTime(); - - ValidateCurrentToken(); - return dateTime; - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Reads the next JSON token from the underlying as a of . - /// - /// A of . - public override DateTimeOffset? ReadAsDateTimeOffset() - { - DateTimeOffset? dateTimeOffset = _reader.ReadAsDateTimeOffset(); - - ValidateCurrentToken(); - return dateTimeOffset; - } -#endif - - /// - /// Reads the next JSON token from the underlying . - /// - /// - /// true if the next token was read successfully; false if there are no more tokens to read. - /// - public override bool Read() - { - if (!_reader.Read()) - { - return false; - } - - if (_reader.TokenType == JsonToken.Comment) - { - return true; - } - - ValidateCurrentToken(); - return true; - } - - private void ValidateCurrentToken() - { - // first time validate has been called. build model - if (_model == null) - { - JsonSchemaModelBuilder builder = new JsonSchemaModelBuilder(); - _model = builder.Build(_schema); - - if (!JsonTokenUtils.IsStartToken(_reader.TokenType)) - { - Push(new SchemaScope(JTokenType.None, CurrentMemberSchemas)); - } - } - - switch (_reader.TokenType) - { - case JsonToken.StartObject: - ProcessValue(); - IList objectSchemas = CurrentMemberSchemas.Where(ValidateObject).ToList(); - Push(new SchemaScope(JTokenType.Object, objectSchemas)); - WriteToken(CurrentSchemas); - break; - case JsonToken.StartArray: - ProcessValue(); - IList arraySchemas = CurrentMemberSchemas.Where(ValidateArray).ToList(); - Push(new SchemaScope(JTokenType.Array, arraySchemas)); - WriteToken(CurrentSchemas); - break; - case JsonToken.StartConstructor: - ProcessValue(); - Push(new SchemaScope(JTokenType.Constructor, null)); - WriteToken(CurrentSchemas); - break; - case JsonToken.PropertyName: - WriteToken(CurrentSchemas); - foreach (JsonSchemaModel schema in CurrentSchemas) - { - ValidatePropertyName(schema); - } - break; - case JsonToken.Raw: - ProcessValue(); - break; - case JsonToken.Integer: - ProcessValue(); - WriteToken(CurrentMemberSchemas); - foreach (JsonSchemaModel schema in CurrentMemberSchemas) - { - ValidateInteger(schema); - } - break; - case JsonToken.Float: - ProcessValue(); - WriteToken(CurrentMemberSchemas); - foreach (JsonSchemaModel schema in CurrentMemberSchemas) - { - ValidateFloat(schema); - } - break; - case JsonToken.String: - ProcessValue(); - WriteToken(CurrentMemberSchemas); - foreach (JsonSchemaModel schema in CurrentMemberSchemas) - { - ValidateString(schema); - } - break; - case JsonToken.Boolean: - ProcessValue(); - WriteToken(CurrentMemberSchemas); - foreach (JsonSchemaModel schema in CurrentMemberSchemas) - { - ValidateBoolean(schema); - } - break; - case JsonToken.Null: - ProcessValue(); - WriteToken(CurrentMemberSchemas); - foreach (JsonSchemaModel schema in CurrentMemberSchemas) - { - ValidateNull(schema); - } - break; - case JsonToken.EndObject: - WriteToken(CurrentSchemas); - foreach (JsonSchemaModel schema in CurrentSchemas) - { - ValidateEndObject(schema); - } - Pop(); - break; - case JsonToken.EndArray: - WriteToken(CurrentSchemas); - foreach (JsonSchemaModel schema in CurrentSchemas) - { - ValidateEndArray(schema); - } - Pop(); - break; - case JsonToken.EndConstructor: - WriteToken(CurrentSchemas); - Pop(); - break; - case JsonToken.Undefined: - case JsonToken.Date: - case JsonToken.Bytes: - // these have no equivalent in JSON schema - WriteToken(CurrentMemberSchemas); - break; - case JsonToken.None: - // no content, do nothing - break; - default: - throw new ArgumentOutOfRangeException(); - } - } - - private void WriteToken(IList schemas) - { - foreach (SchemaScope schemaScope in _stack) - { - bool isInUniqueArray = (schemaScope.TokenType == JTokenType.Array && schemaScope.IsUniqueArray && schemaScope.ArrayItemCount > 0); - - if (isInUniqueArray || schemas.Any(s => s.Enum != null)) - { - if (schemaScope.CurrentItemWriter == null) - { - if (JsonTokenUtils.IsEndToken(_reader.TokenType)) - { - continue; - } - - schemaScope.CurrentItemWriter = new JTokenWriter(); - } - - schemaScope.CurrentItemWriter.WriteToken(_reader, false); - - // finished writing current item - if (schemaScope.CurrentItemWriter.Top == 0 && _reader.TokenType != JsonToken.PropertyName) - { - JToken finishedItem = schemaScope.CurrentItemWriter.Token; - - // start next item with new writer - schemaScope.CurrentItemWriter = null; - - if (isInUniqueArray) - { - if (schemaScope.UniqueArrayItems.Contains(finishedItem, JToken.EqualityComparer)) - { - RaiseError("Non-unique array item at index {0}.".FormatWith(CultureInfo.InvariantCulture, schemaScope.ArrayItemCount - 1), schemaScope.Schemas.First(s => s.UniqueItems)); - } - - schemaScope.UniqueArrayItems.Add(finishedItem); - } - else if (schemas.Any(s => s.Enum != null)) - { - foreach (JsonSchemaModel schema in schemas) - { - if (schema.Enum != null) - { - if (!schema.Enum.ContainsValue(finishedItem, JToken.EqualityComparer)) - { - StringWriter sw = new StringWriter(CultureInfo.InvariantCulture); - finishedItem.WriteTo(new JsonTextWriter(sw)); - - RaiseError("Value {0} is not defined in enum.".FormatWith(CultureInfo.InvariantCulture, sw.ToString()), schema); - } - } - } - } - } - } - } - } - - private void ValidateEndObject(JsonSchemaModel schema) - { - if (schema == null) - { - return; - } - - Dictionary requiredProperties = _currentScope.RequiredProperties; - - if (requiredProperties != null && requiredProperties.Values.Any(v => !v)) - { - IEnumerable unmatchedRequiredProperties = requiredProperties.Where(kv => !kv.Value).Select(kv => kv.Key); - RaiseError("Required properties are missing from object: {0}.".FormatWith(CultureInfo.InvariantCulture, string.Join(", ", unmatchedRequiredProperties -#if !HAVE_STRING_JOIN_WITH_ENUMERABLE - .ToArray() -#endif - )), schema); - } - } - - private void ValidateEndArray(JsonSchemaModel schema) - { - if (schema == null) - { - return; - } - - int arrayItemCount = _currentScope.ArrayItemCount; - - if (schema.MaximumItems != null && arrayItemCount > schema.MaximumItems) - { - RaiseError("Array item count {0} exceeds maximum count of {1}.".FormatWith(CultureInfo.InvariantCulture, arrayItemCount, schema.MaximumItems), schema); - } - - if (schema.MinimumItems != null && arrayItemCount < schema.MinimumItems) - { - RaiseError("Array item count {0} is less than minimum count of {1}.".FormatWith(CultureInfo.InvariantCulture, arrayItemCount, schema.MinimumItems), schema); - } - } - - private void ValidateNull(JsonSchemaModel schema) - { - if (schema == null) - { - return; - } - - if (!TestType(schema, JsonSchemaType.Null)) - { - return; - } - - ValidateNotDisallowed(schema); - } - - private void ValidateBoolean(JsonSchemaModel schema) - { - if (schema == null) - { - return; - } - - if (!TestType(schema, JsonSchemaType.Boolean)) - { - return; - } - - ValidateNotDisallowed(schema); - } - - private void ValidateString(JsonSchemaModel schema) - { - if (schema == null) - { - return; - } - - if (!TestType(schema, JsonSchemaType.String)) - { - return; - } - - ValidateNotDisallowed(schema); - - string value = _reader.Value.ToString(); - - if (schema.MaximumLength != null && value.Length > schema.MaximumLength) - { - RaiseError("String '{0}' exceeds maximum length of {1}.".FormatWith(CultureInfo.InvariantCulture, value, schema.MaximumLength), schema); - } - - if (schema.MinimumLength != null && value.Length < schema.MinimumLength) - { - RaiseError("String '{0}' is less than minimum length of {1}.".FormatWith(CultureInfo.InvariantCulture, value, schema.MinimumLength), schema); - } - - if (schema.Patterns != null) - { - foreach (string pattern in schema.Patterns) - { - if (!Regex.IsMatch(value, pattern)) - { - RaiseError("String '{0}' does not match regex pattern '{1}'.".FormatWith(CultureInfo.InvariantCulture, value, pattern), schema); - } - } - } - } - - private void ValidateInteger(JsonSchemaModel schema) - { - if (schema == null) - { - return; - } - - if (!TestType(schema, JsonSchemaType.Integer)) - { - return; - } - - ValidateNotDisallowed(schema); - - object value = _reader.Value; - - if (schema.Maximum != null) - { - if (JValue.Compare(JTokenType.Integer, value, schema.Maximum) > 0) - { - RaiseError("Integer {0} exceeds maximum value of {1}.".FormatWith(CultureInfo.InvariantCulture, value, schema.Maximum), schema); - } - if (schema.ExclusiveMaximum && JValue.Compare(JTokenType.Integer, value, schema.Maximum) == 0) - { - RaiseError("Integer {0} equals maximum value of {1} and exclusive maximum is true.".FormatWith(CultureInfo.InvariantCulture, value, schema.Maximum), schema); - } - } - - if (schema.Minimum != null) - { - if (JValue.Compare(JTokenType.Integer, value, schema.Minimum) < 0) - { - RaiseError("Integer {0} is less than minimum value of {1}.".FormatWith(CultureInfo.InvariantCulture, value, schema.Minimum), schema); - } - if (schema.ExclusiveMinimum && JValue.Compare(JTokenType.Integer, value, schema.Minimum) == 0) - { - RaiseError("Integer {0} equals minimum value of {1} and exclusive minimum is true.".FormatWith(CultureInfo.InvariantCulture, value, schema.Minimum), schema); - } - } - - if (schema.DivisibleBy != null) - { - bool notDivisible; -#if HAVE_BIG_INTEGER - if (value is BigInteger i) - { - // not that this will lose any decimal point on DivisibleBy - // so manually raise an error if DivisibleBy is not an integer and value is not zero - bool divisibleNonInteger = !Math.Abs(schema.DivisibleBy.Value - Math.Truncate(schema.DivisibleBy.Value)).Equals(0); - if (divisibleNonInteger) - { - notDivisible = i != 0; - } - else - { - notDivisible = i % new BigInteger(schema.DivisibleBy.Value) != 0; - } - } - else -#endif - { - notDivisible = !IsZero(Convert.ToInt64(value, CultureInfo.InvariantCulture) % schema.DivisibleBy.GetValueOrDefault()); - } - - if (notDivisible) - { - RaiseError("Integer {0} is not evenly divisible by {1}.".FormatWith(CultureInfo.InvariantCulture, JsonConvert.ToString(value), schema.DivisibleBy), schema); - } - } - } - - private void ProcessValue() - { - if (_currentScope != null && _currentScope.TokenType == JTokenType.Array) - { - _currentScope.ArrayItemCount++; - - foreach (JsonSchemaModel currentSchema in CurrentSchemas) - { - // if there is positional validation and the array index is past the number of item validation schemas and there are no additional items then error - if (currentSchema != null - && currentSchema.PositionalItemsValidation - && !currentSchema.AllowAdditionalItems - && (currentSchema.Items == null || _currentScope.ArrayItemCount - 1 >= currentSchema.Items.Count)) - { - RaiseError("Index {0} has not been defined and the schema does not allow additional items.".FormatWith(CultureInfo.InvariantCulture, _currentScope.ArrayItemCount), currentSchema); - } - } - } - } - - private void ValidateFloat(JsonSchemaModel schema) - { - if (schema == null) - { - return; - } - - if (!TestType(schema, JsonSchemaType.Float)) - { - return; - } - - ValidateNotDisallowed(schema); - - double value = Convert.ToDouble(_reader.Value, CultureInfo.InvariantCulture); - - if (schema.Maximum != null) - { - if (value > schema.Maximum) - { - RaiseError("Float {0} exceeds maximum value of {1}.".FormatWith(CultureInfo.InvariantCulture, JsonConvert.ToString(value), schema.Maximum), schema); - } - if (schema.ExclusiveMaximum && value == schema.Maximum) - { - RaiseError("Float {0} equals maximum value of {1} and exclusive maximum is true.".FormatWith(CultureInfo.InvariantCulture, JsonConvert.ToString(value), schema.Maximum), schema); - } - } - - if (schema.Minimum != null) - { - if (value < schema.Minimum) - { - RaiseError("Float {0} is less than minimum value of {1}.".FormatWith(CultureInfo.InvariantCulture, JsonConvert.ToString(value), schema.Minimum), schema); - } - if (schema.ExclusiveMinimum && value == schema.Minimum) - { - RaiseError("Float {0} equals minimum value of {1} and exclusive minimum is true.".FormatWith(CultureInfo.InvariantCulture, JsonConvert.ToString(value), schema.Minimum), schema); - } - } - - if (schema.DivisibleBy != null) - { - double remainder = FloatingPointRemainder(value, schema.DivisibleBy.GetValueOrDefault()); - - if (!IsZero(remainder)) - { - RaiseError("Float {0} is not evenly divisible by {1}.".FormatWith(CultureInfo.InvariantCulture, JsonConvert.ToString(value), schema.DivisibleBy), schema); - } - } - } - - private static double FloatingPointRemainder(double dividend, double divisor) - { - return dividend - Math.Floor(dividend / divisor) * divisor; - } - - private static bool IsZero(double value) - { - const double epsilon = 2.2204460492503131e-016; - - return Math.Abs(value) < 20.0 * epsilon; - } - - private void ValidatePropertyName(JsonSchemaModel schema) - { - if (schema == null) - { - return; - } - - string propertyName = Convert.ToString(_reader.Value, CultureInfo.InvariantCulture); - - if (_currentScope.RequiredProperties.ContainsKey(propertyName)) - { - _currentScope.RequiredProperties[propertyName] = true; - } - - if (!schema.AllowAdditionalProperties) - { - bool propertyDefinied = IsPropertyDefinied(schema, propertyName); - - if (!propertyDefinied) - { - RaiseError("Property '{0}' has not been defined and the schema does not allow additional properties.".FormatWith(CultureInfo.InvariantCulture, propertyName), schema); - } - } - - _currentScope.CurrentPropertyName = propertyName; - } - - private bool IsPropertyDefinied(JsonSchemaModel schema, string propertyName) - { - if (schema.Properties != null && schema.Properties.ContainsKey(propertyName)) - { - return true; - } - - if (schema.PatternProperties != null) - { - foreach (string pattern in schema.PatternProperties.Keys) - { - if (Regex.IsMatch(propertyName, pattern)) - { - return true; - } - } - } - - return false; - } - - private bool ValidateArray(JsonSchemaModel schema) - { - if (schema == null) - { - return true; - } - - return (TestType(schema, JsonSchemaType.Array)); - } - - private bool ValidateObject(JsonSchemaModel schema) - { - if (schema == null) - { - return true; - } - - return (TestType(schema, JsonSchemaType.Object)); - } - - private bool TestType(JsonSchemaModel currentSchema, JsonSchemaType currentType) - { - if (!JsonSchemaGenerator.HasFlag(currentSchema.Type, currentType)) - { - RaiseError("Invalid type. Expected {0} but got {1}.".FormatWith(CultureInfo.InvariantCulture, currentSchema.Type, currentType), currentSchema); - return false; - } - - return true; - } - - bool IJsonLineInfo.HasLineInfo() - { - return _reader is IJsonLineInfo lineInfo && lineInfo.HasLineInfo(); - } - - int IJsonLineInfo.LineNumber => (_reader is IJsonLineInfo lineInfo) ? lineInfo.LineNumber : 0; - - int IJsonLineInfo.LinePosition => (_reader is IJsonLineInfo lineInfo) ? lineInfo.LinePosition : 0; - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonWriter.Async.cs b/Source/MyDb/Newtonsoft.Json/JsonWriter.Async.cs deleted file mode 100644 index 750d292..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonWriter.Async.cs +++ /dev/null @@ -1,1797 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System; -using System.Globalization; -using System.Threading; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json -{ - public abstract partial class JsonWriter - { - internal Task AutoCompleteAsync(JsonToken tokenBeingWritten, CancellationToken cancellationToken) - { - State oldState = _currentState; - - // gets new state based on the current state and what is being written - State newState = StateArray[(int)tokenBeingWritten][(int)oldState]; - - if (newState == State.Error) - { - throw JsonWriterException.Create(this, "Token {0} in state {1} would result in an invalid JSON object.".FormatWith(CultureInfo.InvariantCulture, tokenBeingWritten.ToString(), oldState.ToString()), null); - } - - _currentState = newState; - - if (_formatting == Formatting.Indented) - { - switch (oldState) - { - case State.Start: - break; - case State.Property: - return WriteIndentSpaceAsync(cancellationToken); - case State.ArrayStart: - case State.ConstructorStart: - return WriteIndentAsync(cancellationToken); - case State.Array: - case State.Constructor: - return tokenBeingWritten == JsonToken.Comment ? WriteIndentAsync(cancellationToken) : AutoCompleteAsync(cancellationToken); - case State.Object: - switch (tokenBeingWritten) - { - case JsonToken.Comment: - break; - case JsonToken.PropertyName: - return AutoCompleteAsync(cancellationToken); - default: - return WriteValueDelimiterAsync(cancellationToken); - } - - break; - default: - if (tokenBeingWritten == JsonToken.PropertyName) - { - return WriteIndentAsync(cancellationToken); - } - - break; - } - } - else if (tokenBeingWritten != JsonToken.Comment) - { - switch (oldState) - { - case State.Object: - case State.Array: - case State.Constructor: - return WriteValueDelimiterAsync(cancellationToken); - } - } - - return AsyncUtils.CompletedTask; - } - - private async Task AutoCompleteAsync(CancellationToken cancellationToken) - { - await WriteValueDelimiterAsync(cancellationToken).ConfigureAwait(false); - await WriteIndentAsync(cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously closes this writer. - /// If is set to true, the destination is also closed. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task CloseAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - Close(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task FlushAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - Flush(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the specified end token. - /// - /// The end token to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - protected virtual Task WriteEndAsync(JsonToken token, CancellationToken cancellationToken) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteEnd(token); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes indent characters. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - protected virtual Task WriteIndentAsync(CancellationToken cancellationToken) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteIndent(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the JSON value delimiter. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - protected virtual Task WriteValueDelimiterAsync(CancellationToken cancellationToken) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValueDelimiter(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes an indent space. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - protected virtual Task WriteIndentSpaceAsync(CancellationToken cancellationToken) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteIndentSpace(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes raw JSON without changing the writer's state. - /// - /// The raw JSON to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteRawAsync(string? json, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteRaw(json); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the end of the current JSON object or array. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteEndAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteEnd(); - return AsyncUtils.CompletedTask; - } - - internal Task WriteEndInternalAsync(CancellationToken cancellationToken) - { - JsonContainerType type = Peek(); - switch (type) - { - case JsonContainerType.Object: - return WriteEndObjectAsync(cancellationToken); - case JsonContainerType.Array: - return WriteEndArrayAsync(cancellationToken); - case JsonContainerType.Constructor: - return WriteEndConstructorAsync(cancellationToken); - default: - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - throw JsonWriterException.Create(this, "Unexpected type when writing end: " + type, null); - } - } - - internal Task InternalWriteEndAsync(JsonContainerType type, CancellationToken cancellationToken) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - int levelsToComplete = CalculateLevelsToComplete(type); - while (levelsToComplete-- > 0) - { - JsonToken token = GetCloseTokenForType(Pop()); - - Task t; - if (_currentState == State.Property) - { - t = WriteNullAsync(cancellationToken); - if (!t.IsCompletedSucessfully()) - { - return AwaitProperty(t, levelsToComplete, token, cancellationToken); - } - } - - if (_formatting == Formatting.Indented) - { - if (_currentState != State.ObjectStart && _currentState != State.ArrayStart) - { - t = WriteIndentAsync(cancellationToken); - if (!t.IsCompletedSucessfully()) - { - return AwaitIndent(t, levelsToComplete, token, cancellationToken); - } - } - } - - t = WriteEndAsync(token, cancellationToken); - if (!t.IsCompletedSucessfully()) - { - return AwaitEnd(t, levelsToComplete, cancellationToken); - } - - UpdateCurrentState(); - } - - return AsyncUtils.CompletedTask; - - // Local functions, params renamed (capitalized) so as not to capture and allocate when calling async - async Task AwaitProperty(Task task, int LevelsToComplete, JsonToken token, CancellationToken CancellationToken) - { - await task.ConfigureAwait(false); - - // Finish current loop - if (_formatting == Formatting.Indented) - { - if (_currentState != State.ObjectStart && _currentState != State.ArrayStart) - { - await WriteIndentAsync(CancellationToken).ConfigureAwait(false); - } - } - - await WriteEndAsync(token, CancellationToken).ConfigureAwait(false); - - UpdateCurrentState(); - - await AwaitRemaining(LevelsToComplete, CancellationToken).ConfigureAwait(false); - } - - async Task AwaitIndent(Task task, int LevelsToComplete, JsonToken token, CancellationToken CancellationToken) - { - await task.ConfigureAwait(false); - - // Finish current loop - - await WriteEndAsync(token, CancellationToken).ConfigureAwait(false); - - UpdateCurrentState(); - - await AwaitRemaining(LevelsToComplete, CancellationToken).ConfigureAwait(false); - } - - async Task AwaitEnd(Task task, int LevelsToComplete, CancellationToken CancellationToken) - { - await task.ConfigureAwait(false); - - // Finish current loop - - UpdateCurrentState(); - - await AwaitRemaining(LevelsToComplete, CancellationToken).ConfigureAwait(false); - } - - async Task AwaitRemaining(int LevelsToComplete, CancellationToken CancellationToken) - { - while (LevelsToComplete-- > 0) - { - JsonToken token = GetCloseTokenForType(Pop()); - - if (_currentState == State.Property) - { - await WriteNullAsync(CancellationToken).ConfigureAwait(false); - } - - if (_formatting == Formatting.Indented) - { - if (_currentState != State.ObjectStart && _currentState != State.ArrayStart) - { - await WriteIndentAsync(CancellationToken).ConfigureAwait(false); - } - } - - await WriteEndAsync(token, CancellationToken).ConfigureAwait(false); - - UpdateCurrentState(); - } - } - } - - /// - /// Asynchronously writes the end of an array. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteEndArrayAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteEndArray(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the end of a constructor. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteEndConstructorAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteEndConstructor(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the end of a JSON object. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteEndObjectAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteEndObject(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a null value. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteNullAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteNull(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the property name of a name/value pair of a JSON object. - /// - /// The name of the property. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WritePropertyNameAsync(string name, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WritePropertyName(name); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the property name of a name/value pair of a JSON object. - /// - /// The name of the property. - /// A flag to indicate whether the text should be escaped when it is written as a JSON property name. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WritePropertyNameAsync(string name, bool escape, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WritePropertyName(name, escape); - return AsyncUtils.CompletedTask; - } - - internal Task InternalWritePropertyNameAsync(string name, CancellationToken cancellationToken) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - _currentPosition.PropertyName = name; - return AutoCompleteAsync(JsonToken.PropertyName, cancellationToken); - } - - /// - /// Asynchronously writes the beginning of a JSON array. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteStartArrayAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteStartArray(); - return AsyncUtils.CompletedTask; - } - - internal async Task InternalWriteStartAsync(JsonToken token, JsonContainerType container, CancellationToken cancellationToken) - { - UpdateScopeWithFinishedValue(); - await AutoCompleteAsync(token, cancellationToken).ConfigureAwait(false); - Push(container); - } - - /// - /// Asynchronously writes a comment /*...*/ containing the specified text. - /// - /// Text to place inside the comment. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteCommentAsync(string? text, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteComment(text); - return AsyncUtils.CompletedTask; - } - - internal Task InternalWriteCommentAsync(CancellationToken cancellationToken) - { - return AutoCompleteAsync(JsonToken.Comment, cancellationToken); - } - - /// - /// Asynchronously writes raw JSON where a value is expected and updates the writer's state. - /// - /// The raw JSON to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteRawValueAsync(string? json, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteRawValue(json); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the start of a constructor with the given name. - /// - /// The name of the constructor. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteStartConstructorAsync(string name, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteStartConstructor(name); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the beginning of a JSON object. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteStartObjectAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteStartObject(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the current token. - /// - /// The to read the token from. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public Task WriteTokenAsync(JsonReader reader, CancellationToken cancellationToken = default) - { - return WriteTokenAsync(reader, true, cancellationToken); - } - - /// - /// Asynchronously writes the current token. - /// - /// The to read the token from. - /// A flag indicating whether the current token's children should be written. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public Task WriteTokenAsync(JsonReader reader, bool writeChildren, CancellationToken cancellationToken = default) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - - return WriteTokenAsync(reader, writeChildren, true, true, cancellationToken); - } - - /// - /// Asynchronously writes the token and its value. - /// - /// The to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public Task WriteTokenAsync(JsonToken token, CancellationToken cancellationToken = default) - { - return WriteTokenAsync(token, null, cancellationToken); - } - - /// - /// Asynchronously writes the token and its value. - /// - /// The to write. - /// - /// The value to write. - /// A value is only required for tokens that have an associated value, e.g. the property name for . - /// null can be passed to the method for tokens that don't have a value, e.g. . - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public Task WriteTokenAsync(JsonToken token, object? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - switch (token) - { - case JsonToken.None: - // read to next - return AsyncUtils.CompletedTask; - case JsonToken.StartObject: - return WriteStartObjectAsync(cancellationToken); - case JsonToken.StartArray: - return WriteStartArrayAsync(cancellationToken); - case JsonToken.StartConstructor: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return WriteStartConstructorAsync(value.ToString(), cancellationToken); - case JsonToken.PropertyName: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return WritePropertyNameAsync(value.ToString(), cancellationToken); - case JsonToken.Comment: - return WriteCommentAsync(value?.ToString(), cancellationToken); - case JsonToken.Integer: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return -#if HAVE_BIG_INTEGER - value is BigInteger integer ? WriteValueAsync(integer, cancellationToken) : -#endif - WriteValueAsync(Convert.ToInt64(value, CultureInfo.InvariantCulture), cancellationToken); - case JsonToken.Float: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - if (value is decimal dec) - { - return WriteValueAsync(dec, cancellationToken); - } - - if (value is double doub) - { - return WriteValueAsync(doub, cancellationToken); - } - - if (value is float f) - { - return WriteValueAsync(f, cancellationToken); - } - - return WriteValueAsync(Convert.ToDouble(value, CultureInfo.InvariantCulture), cancellationToken); - case JsonToken.String: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return WriteValueAsync(value.ToString(), cancellationToken); - case JsonToken.Boolean: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return WriteValueAsync(Convert.ToBoolean(value, CultureInfo.InvariantCulture), cancellationToken); - case JsonToken.Null: - return WriteNullAsync(cancellationToken); - case JsonToken.Undefined: - return WriteUndefinedAsync(cancellationToken); - case JsonToken.EndObject: - return WriteEndObjectAsync(cancellationToken); - case JsonToken.EndArray: - return WriteEndArrayAsync(cancellationToken); - case JsonToken.EndConstructor: - return WriteEndConstructorAsync(cancellationToken); - case JsonToken.Date: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - if (value is DateTimeOffset offset) - { - return WriteValueAsync(offset, cancellationToken); - } - - return WriteValueAsync(Convert.ToDateTime(value, CultureInfo.InvariantCulture), cancellationToken); - case JsonToken.Raw: - return WriteRawValueAsync(value?.ToString(), cancellationToken); - case JsonToken.Bytes: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - if (value is Guid guid) - { - return WriteValueAsync(guid, cancellationToken); - } - - return WriteValueAsync((byte[]?)value, cancellationToken); - default: - throw MiscellaneousUtils.CreateArgumentOutOfRangeException(nameof(token), token, "Unexpected token type."); - } - } - - internal virtual async Task WriteTokenAsync(JsonReader reader, bool writeChildren, bool writeDateConstructorAsDate, bool writeComments, CancellationToken cancellationToken) - { - int initialDepth = CalculateWriteTokenInitialDepth(reader); - - do - { - // write a JValue date when the constructor is for a date - if (writeDateConstructorAsDate && reader.TokenType == JsonToken.StartConstructor && string.Equals(reader.Value?.ToString(), "Date", StringComparison.Ordinal)) - { - await WriteConstructorDateAsync(reader, cancellationToken).ConfigureAwait(false); - } - else - { - if (writeComments || reader.TokenType != JsonToken.Comment) - { - await WriteTokenAsync(reader.TokenType, reader.Value, cancellationToken).ConfigureAwait(false); - } - } - } while ( - // stop if we have reached the end of the token being read - initialDepth - 1 < reader.Depth - (JsonTokenUtils.IsEndToken(reader.TokenType) ? 1 : 0) - && writeChildren - && await reader.ReadAsync(cancellationToken).ConfigureAwait(false)); - - if (IsWriteTokenIncomplete(reader, writeChildren, initialDepth)) - { - throw JsonWriterException.Create(this, "Unexpected end when reading token.", null); - } - } - - // For internal use, when we know the writer does not offer true async support (e.g. when backed - // by a StringWriter) and therefore async write methods are always in practice just a less efficient - // path through the sync version. - internal async Task WriteTokenSyncReadingAsync(JsonReader reader, CancellationToken cancellationToken) - { - int initialDepth = CalculateWriteTokenInitialDepth(reader); - - do - { - // write a JValue date when the constructor is for a date - if (reader.TokenType == JsonToken.StartConstructor && string.Equals(reader.Value?.ToString(), "Date", StringComparison.Ordinal)) - { - WriteConstructorDate(reader); - } - else - { - WriteToken(reader.TokenType, reader.Value); - } - } while ( - // stop if we have reached the end of the token being read - initialDepth - 1 < reader.Depth - (JsonTokenUtils.IsEndToken(reader.TokenType) ? 1 : 0) - && await reader.ReadAsync(cancellationToken).ConfigureAwait(false)); - - if (initialDepth < CalculateWriteTokenFinalDepth(reader)) - { - throw JsonWriterException.Create(this, "Unexpected end when reading token.", null); - } - } - - private async Task WriteConstructorDateAsync(JsonReader reader, CancellationToken cancellationToken) - { - if (!await reader.ReadAsync(cancellationToken).ConfigureAwait(false)) - { - throw JsonWriterException.Create(this, "Unexpected end when reading date constructor.", null); - } - if (reader.TokenType != JsonToken.Integer) - { - throw JsonWriterException.Create(this, "Unexpected token when reading date constructor. Expected Integer, got " + reader.TokenType, null); - } - - DateTime date = DateTimeUtils.ConvertJavaScriptTicksToDateTime((long)reader.Value!); - - if (!await reader.ReadAsync(cancellationToken).ConfigureAwait(false)) - { - throw JsonWriterException.Create(this, "Unexpected end when reading date constructor.", null); - } - if (reader.TokenType != JsonToken.EndConstructor) - { - throw JsonWriterException.Create(this, "Unexpected token when reading date constructor. Expected EndConstructor, got " + reader.TokenType, null); - } - - await WriteValueAsync(date, cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(bool value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(bool? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(byte value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(byte? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a [] value. - /// - /// The [] value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(byte[]? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(char value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(char? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(DateTime value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(DateTime? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(DateTimeOffset value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(DateTimeOffset? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(decimal value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(decimal? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(double value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(double? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(float value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(float? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(Guid value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(Guid? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(int value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(int? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(long value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(long? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(object? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - [CLSCompliant(false)] - public virtual Task WriteValueAsync(sbyte value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - [CLSCompliant(false)] - public virtual Task WriteValueAsync(sbyte? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(short value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(short? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(string? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(TimeSpan value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(TimeSpan? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - [CLSCompliant(false)] - public virtual Task WriteValueAsync(uint value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - [CLSCompliant(false)] - public virtual Task WriteValueAsync(uint? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - [CLSCompliant(false)] - public virtual Task WriteValueAsync(ulong value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - [CLSCompliant(false)] - public virtual Task WriteValueAsync(ulong? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteValueAsync(Uri? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a value. - /// - /// The value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - [CLSCompliant(false)] - public virtual Task WriteValueAsync(ushort value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes a of value. - /// - /// The of value to write. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - [CLSCompliant(false)] - public virtual Task WriteValueAsync(ushort? value, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteValue(value); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes an undefined value. - /// - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteUndefinedAsync(CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteUndefined(); - return AsyncUtils.CompletedTask; - } - - /// - /// Asynchronously writes the given white space. - /// - /// The string of white space characters. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - public virtual Task WriteWhitespaceAsync(string ws, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - WriteWhitespace(ws); - return AsyncUtils.CompletedTask; - } - - internal Task InternalWriteValueAsync(JsonToken token, CancellationToken cancellationToken) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - UpdateScopeWithFinishedValue(); - return AutoCompleteAsync(token, cancellationToken); - } - - /// - /// Asynchronously ets the state of the . - /// - /// The being written. - /// The value being written. - /// The token to monitor for cancellation requests. The default value is . - /// A that represents the asynchronous operation. - /// The default behaviour is to execute synchronously, returning an already-completed task. Derived - /// classes can override this behaviour for true asynchronicity. - protected Task SetWriteStateAsync(JsonToken token, object value, CancellationToken cancellationToken) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - switch (token) - { - case JsonToken.StartObject: - return InternalWriteStartAsync(token, JsonContainerType.Object, cancellationToken); - case JsonToken.StartArray: - return InternalWriteStartAsync(token, JsonContainerType.Array, cancellationToken); - case JsonToken.StartConstructor: - return InternalWriteStartAsync(token, JsonContainerType.Constructor, cancellationToken); - case JsonToken.PropertyName: - if (!(value is string s)) - { - throw new ArgumentException("A name is required when setting property name state.", nameof(value)); - } - - return InternalWritePropertyNameAsync(s, cancellationToken); - case JsonToken.Comment: - return InternalWriteCommentAsync(cancellationToken); - case JsonToken.Raw: - return AsyncUtils.CompletedTask; - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.String: - case JsonToken.Boolean: - case JsonToken.Date: - case JsonToken.Bytes: - case JsonToken.Null: - case JsonToken.Undefined: - return InternalWriteValueAsync(token, cancellationToken); - case JsonToken.EndObject: - return InternalWriteEndAsync(JsonContainerType.Object, cancellationToken); - case JsonToken.EndArray: - return InternalWriteEndAsync(JsonContainerType.Array, cancellationToken); - case JsonToken.EndConstructor: - return InternalWriteEndAsync(JsonContainerType.Constructor, cancellationToken); - default: - throw new ArgumentOutOfRangeException(nameof(token)); - } - } - - internal static Task WriteValueAsync(JsonWriter writer, PrimitiveTypeCode typeCode, object value, CancellationToken cancellationToken) - { - while (true) - { - switch (typeCode) - { - case PrimitiveTypeCode.Char: - return writer.WriteValueAsync((char)value, cancellationToken); - case PrimitiveTypeCode.CharNullable: - return writer.WriteValueAsync(value == null ? (char?)null : (char)value, cancellationToken); - case PrimitiveTypeCode.Boolean: - return writer.WriteValueAsync((bool)value, cancellationToken); - case PrimitiveTypeCode.BooleanNullable: - return writer.WriteValueAsync(value == null ? (bool?)null : (bool)value, cancellationToken); - case PrimitiveTypeCode.SByte: - return writer.WriteValueAsync((sbyte)value, cancellationToken); - case PrimitiveTypeCode.SByteNullable: - return writer.WriteValueAsync(value == null ? (sbyte?)null : (sbyte)value, cancellationToken); - case PrimitiveTypeCode.Int16: - return writer.WriteValueAsync((short)value, cancellationToken); - case PrimitiveTypeCode.Int16Nullable: - return writer.WriteValueAsync(value == null ? (short?)null : (short)value, cancellationToken); - case PrimitiveTypeCode.UInt16: - return writer.WriteValueAsync((ushort)value, cancellationToken); - case PrimitiveTypeCode.UInt16Nullable: - return writer.WriteValueAsync(value == null ? (ushort?)null : (ushort)value, cancellationToken); - case PrimitiveTypeCode.Int32: - return writer.WriteValueAsync((int)value, cancellationToken); - case PrimitiveTypeCode.Int32Nullable: - return writer.WriteValueAsync(value == null ? (int?)null : (int)value, cancellationToken); - case PrimitiveTypeCode.Byte: - return writer.WriteValueAsync((byte)value, cancellationToken); - case PrimitiveTypeCode.ByteNullable: - return writer.WriteValueAsync(value == null ? (byte?)null : (byte)value, cancellationToken); - case PrimitiveTypeCode.UInt32: - return writer.WriteValueAsync((uint)value, cancellationToken); - case PrimitiveTypeCode.UInt32Nullable: - return writer.WriteValueAsync(value == null ? (uint?)null : (uint)value, cancellationToken); - case PrimitiveTypeCode.Int64: - return writer.WriteValueAsync((long)value, cancellationToken); - case PrimitiveTypeCode.Int64Nullable: - return writer.WriteValueAsync(value == null ? (long?)null : (long)value, cancellationToken); - case PrimitiveTypeCode.UInt64: - return writer.WriteValueAsync((ulong)value, cancellationToken); - case PrimitiveTypeCode.UInt64Nullable: - return writer.WriteValueAsync(value == null ? (ulong?)null : (ulong)value, cancellationToken); - case PrimitiveTypeCode.Single: - return writer.WriteValueAsync((float)value, cancellationToken); - case PrimitiveTypeCode.SingleNullable: - return writer.WriteValueAsync(value == null ? (float?)null : (float)value, cancellationToken); - case PrimitiveTypeCode.Double: - return writer.WriteValueAsync((double)value, cancellationToken); - case PrimitiveTypeCode.DoubleNullable: - return writer.WriteValueAsync(value == null ? (double?)null : (double)value, cancellationToken); - case PrimitiveTypeCode.DateTime: - return writer.WriteValueAsync((DateTime)value, cancellationToken); - case PrimitiveTypeCode.DateTimeNullable: - return writer.WriteValueAsync(value == null ? (DateTime?)null : (DateTime)value, cancellationToken); - case PrimitiveTypeCode.DateTimeOffset: - return writer.WriteValueAsync((DateTimeOffset)value, cancellationToken); - case PrimitiveTypeCode.DateTimeOffsetNullable: - return writer.WriteValueAsync(value == null ? (DateTimeOffset?)null : (DateTimeOffset)value, cancellationToken); - case PrimitiveTypeCode.Decimal: - return writer.WriteValueAsync((decimal)value, cancellationToken); - case PrimitiveTypeCode.DecimalNullable: - return writer.WriteValueAsync(value == null ? (decimal?)null : (decimal)value, cancellationToken); - case PrimitiveTypeCode.Guid: - return writer.WriteValueAsync((Guid)value, cancellationToken); - case PrimitiveTypeCode.GuidNullable: - return writer.WriteValueAsync(value == null ? (Guid?)null : (Guid)value, cancellationToken); - case PrimitiveTypeCode.TimeSpan: - return writer.WriteValueAsync((TimeSpan)value, cancellationToken); - case PrimitiveTypeCode.TimeSpanNullable: - return writer.WriteValueAsync(value == null ? (TimeSpan?)null : (TimeSpan)value, cancellationToken); -#if HAVE_BIG_INTEGER - case PrimitiveTypeCode.BigInteger: - - // this will call to WriteValueAsync(object) - return writer.WriteValueAsync((BigInteger)value, cancellationToken); - case PrimitiveTypeCode.BigIntegerNullable: - - // this will call to WriteValueAsync(object) - return writer.WriteValueAsync(value == null ? (BigInteger?)null : (BigInteger)value, cancellationToken); -#endif - case PrimitiveTypeCode.Uri: - return writer.WriteValueAsync((Uri)value, cancellationToken); - case PrimitiveTypeCode.String: - return writer.WriteValueAsync((string)value, cancellationToken); - case PrimitiveTypeCode.Bytes: - return writer.WriteValueAsync((byte[])value, cancellationToken); -#if HAVE_DB_NULL_TYPE_CODE - case PrimitiveTypeCode.DBNull: - return writer.WriteNullAsync(cancellationToken); -#endif - default: -#if HAVE_ICONVERTIBLE - if (value is IConvertible convertible) - { - ResolveConvertibleValue(convertible, out typeCode, out value); - continue; - } -#endif - - // write an unknown null value, fix https://github.com/JamesNK/Newtonsoft.Json/issues/1460 - if (value == null) - { - return writer.WriteNullAsync(cancellationToken); - } - - throw CreateUnsupportedTypeException(writer, value); - } - } - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/JsonWriter.cs b/Source/MyDb/Newtonsoft.Json/JsonWriter.cs deleted file mode 100644 index a68fc8c..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonWriter.cs +++ /dev/null @@ -1,1789 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.IO; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using Newtonsoft.Json.Utilities; -using System.Globalization; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -namespace Newtonsoft.Json -{ - /// - /// Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. - /// - public abstract partial class JsonWriter : IDisposable - { - internal enum State - { - Start = 0, - Property = 1, - ObjectStart = 2, - Object = 3, - ArrayStart = 4, - Array = 5, - ConstructorStart = 6, - Constructor = 7, - Closed = 8, - Error = 9 - } - - // array that gives a new state based on the current state an the token being written - private static readonly State[][] StateArray; - - internal static readonly State[][] StateArrayTemplate = new[] - { - // Start PropertyName ObjectStart Object ArrayStart Array ConstructorStart Constructor Closed Error - // - /* None */new[] { State.Error, State.Error, State.Error, State.Error, State.Error, State.Error, State.Error, State.Error, State.Error, State.Error }, - /* StartObject */new[] { State.ObjectStart, State.ObjectStart, State.Error, State.Error, State.ObjectStart, State.ObjectStart, State.ObjectStart, State.ObjectStart, State.Error, State.Error }, - /* StartArray */new[] { State.ArrayStart, State.ArrayStart, State.Error, State.Error, State.ArrayStart, State.ArrayStart, State.ArrayStart, State.ArrayStart, State.Error, State.Error }, - /* StartConstructor */new[] { State.ConstructorStart, State.ConstructorStart, State.Error, State.Error, State.ConstructorStart, State.ConstructorStart, State.ConstructorStart, State.ConstructorStart, State.Error, State.Error }, - /* Property */new[] { State.Property, State.Error, State.Property, State.Property, State.Error, State.Error, State.Error, State.Error, State.Error, State.Error }, - /* Comment */new[] { State.Start, State.Property, State.ObjectStart, State.Object, State.ArrayStart, State.Array, State.Constructor, State.Constructor, State.Error, State.Error }, - /* Raw */new[] { State.Start, State.Property, State.ObjectStart, State.Object, State.ArrayStart, State.Array, State.Constructor, State.Constructor, State.Error, State.Error }, - /* Value (this will be copied) */new[] { State.Start, State.Object, State.Error, State.Error, State.Array, State.Array, State.Constructor, State.Constructor, State.Error, State.Error } - }; - - internal static State[][] BuildStateArray() - { - List allStates = StateArrayTemplate.ToList(); - State[] errorStates = StateArrayTemplate[0]; - State[] valueStates = StateArrayTemplate[7]; - - EnumInfo enumValuesAndNames = EnumUtils.GetEnumValuesAndNames(typeof(JsonToken)); - - foreach (ulong valueToken in enumValuesAndNames.Values) - { - if (allStates.Count <= (int)valueToken) - { - JsonToken token = (JsonToken)valueToken; - switch (token) - { - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.String: - case JsonToken.Boolean: - case JsonToken.Null: - case JsonToken.Undefined: - case JsonToken.Date: - case JsonToken.Bytes: - allStates.Add(valueStates); - break; - default: - allStates.Add(errorStates); - break; - } - } - } - - return allStates.ToArray(); - } - - static JsonWriter() - { - StateArray = BuildStateArray(); - } - - private List? _stack; - private JsonPosition _currentPosition; - private State _currentState; - private Formatting _formatting; - - /// - /// Gets or sets a value indicating whether the destination should be closed when this writer is closed. - /// - /// - /// true to close the destination when this writer is closed; otherwise false. The default is true. - /// - public bool CloseOutput { get; set; } - - /// - /// Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. - /// - /// - /// true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. - /// - public bool AutoCompleteOnClose { get; set; } - - /// - /// Gets the top. - /// - /// The top. - protected internal int Top - { - get - { - int depth = _stack?.Count ?? 0; - if (Peek() != JsonContainerType.None) - { - depth++; - } - - return depth; - } - } - - /// - /// Gets the state of the writer. - /// - public WriteState WriteState - { - get - { - switch (_currentState) - { - case State.Error: - return WriteState.Error; - case State.Closed: - return WriteState.Closed; - case State.Object: - case State.ObjectStart: - return WriteState.Object; - case State.Array: - case State.ArrayStart: - return WriteState.Array; - case State.Constructor: - case State.ConstructorStart: - return WriteState.Constructor; - case State.Property: - return WriteState.Property; - case State.Start: - return WriteState.Start; - default: - throw JsonWriterException.Create(this, "Invalid state: " + _currentState, null); - } - } - } - - internal string ContainerPath - { - get - { - if (_currentPosition.Type == JsonContainerType.None || _stack == null) - { - return string.Empty; - } - - return JsonPosition.BuildPath(_stack, null); - } - } - - /// - /// Gets the path of the writer. - /// - public string Path - { - get - { - if (_currentPosition.Type == JsonContainerType.None) - { - return string.Empty; - } - - bool insideContainer = (_currentState != State.ArrayStart - && _currentState != State.ConstructorStart - && _currentState != State.ObjectStart); - - JsonPosition? current = insideContainer ? (JsonPosition?)_currentPosition : null; - - return JsonPosition.BuildPath(_stack!, current); - } - } - - private DateFormatHandling _dateFormatHandling; - private DateTimeZoneHandling _dateTimeZoneHandling; - private StringEscapeHandling _stringEscapeHandling; - private FloatFormatHandling _floatFormatHandling; - private string? _dateFormatString; - private CultureInfo? _culture; - - /// - /// Gets or sets a value indicating how JSON text output should be formatted. - /// - public Formatting Formatting - { - get => _formatting; - set - { - if (value < Formatting.None || value > Formatting.Indented) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _formatting = value; - } - } - - /// - /// Gets or sets how dates are written to JSON text. - /// - public DateFormatHandling DateFormatHandling - { - get => _dateFormatHandling; - set - { - if (value < DateFormatHandling.IsoDateFormat || value > DateFormatHandling.MicrosoftDateFormat) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _dateFormatHandling = value; - } - } - - /// - /// Gets or sets how time zones are handled when writing JSON text. - /// - public DateTimeZoneHandling DateTimeZoneHandling - { - get => _dateTimeZoneHandling; - set - { - if (value < DateTimeZoneHandling.Local || value > DateTimeZoneHandling.RoundtripKind) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _dateTimeZoneHandling = value; - } - } - - /// - /// Gets or sets how strings are escaped when writing JSON text. - /// - public StringEscapeHandling StringEscapeHandling - { - get => _stringEscapeHandling; - set - { - if (value < StringEscapeHandling.Default || value > StringEscapeHandling.EscapeHtml) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _stringEscapeHandling = value; - OnStringEscapeHandlingChanged(); - } - } - - internal virtual void OnStringEscapeHandlingChanged() - { - // hacky but there is a calculated value that relies on StringEscapeHandling - } - - /// - /// Gets or sets how special floating point numbers, e.g. , - /// and , - /// are written to JSON text. - /// - public FloatFormatHandling FloatFormatHandling - { - get => _floatFormatHandling; - set - { - if (value < FloatFormatHandling.String || value > FloatFormatHandling.DefaultValue) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _floatFormatHandling = value; - } - } - - /// - /// Gets or sets how and values are formatted when writing JSON text. - /// - public string? DateFormatString - { - get => _dateFormatString; - set => _dateFormatString = value; - } - - /// - /// Gets or sets the culture used when writing JSON. Defaults to . - /// - public CultureInfo Culture - { - get => _culture ?? CultureInfo.InvariantCulture; - set => _culture = value; - } - - /// - /// Initializes a new instance of the class. - /// - protected JsonWriter() - { - _currentState = State.Start; - _formatting = Formatting.None; - _dateTimeZoneHandling = DateTimeZoneHandling.RoundtripKind; - - CloseOutput = true; - AutoCompleteOnClose = true; - } - - internal void UpdateScopeWithFinishedValue() - { - if (_currentPosition.HasIndex) - { - _currentPosition.Position++; - } - } - - private void Push(JsonContainerType value) - { - if (_currentPosition.Type != JsonContainerType.None) - { - if (_stack == null) - { - _stack = new List(); - } - - _stack.Add(_currentPosition); - } - - _currentPosition = new JsonPosition(value); - } - - private JsonContainerType Pop() - { - JsonPosition oldPosition = _currentPosition; - - if (_stack != null && _stack.Count > 0) - { - _currentPosition = _stack[_stack.Count - 1]; - _stack.RemoveAt(_stack.Count - 1); - } - else - { - _currentPosition = new JsonPosition(); - } - - return oldPosition.Type; - } - - private JsonContainerType Peek() - { - return _currentPosition.Type; - } - - /// - /// Flushes whatever is in the buffer to the destination and also flushes the destination. - /// - public abstract void Flush(); - - /// - /// Closes this writer. - /// If is set to true, the destination is also closed. - /// If is set to true, the JSON is auto-completed. - /// - public virtual void Close() - { - if (AutoCompleteOnClose) - { - AutoCompleteAll(); - } - } - - /// - /// Writes the beginning of a JSON object. - /// - public virtual void WriteStartObject() - { - InternalWriteStart(JsonToken.StartObject, JsonContainerType.Object); - } - - /// - /// Writes the end of a JSON object. - /// - public virtual void WriteEndObject() - { - InternalWriteEnd(JsonContainerType.Object); - } - - /// - /// Writes the beginning of a JSON array. - /// - public virtual void WriteStartArray() - { - InternalWriteStart(JsonToken.StartArray, JsonContainerType.Array); - } - - /// - /// Writes the end of an array. - /// - public virtual void WriteEndArray() - { - InternalWriteEnd(JsonContainerType.Array); - } - - /// - /// Writes the start of a constructor with the given name. - /// - /// The name of the constructor. - public virtual void WriteStartConstructor(string name) - { - InternalWriteStart(JsonToken.StartConstructor, JsonContainerType.Constructor); - } - - /// - /// Writes the end constructor. - /// - public virtual void WriteEndConstructor() - { - InternalWriteEnd(JsonContainerType.Constructor); - } - - /// - /// Writes the property name of a name/value pair of a JSON object. - /// - /// The name of the property. - public virtual void WritePropertyName(string name) - { - InternalWritePropertyName(name); - } - - /// - /// Writes the property name of a name/value pair of a JSON object. - /// - /// The name of the property. - /// A flag to indicate whether the text should be escaped when it is written as a JSON property name. - public virtual void WritePropertyName(string name, bool escape) - { - WritePropertyName(name); - } - - /// - /// Writes the end of the current JSON object or array. - /// - public virtual void WriteEnd() - { - WriteEnd(Peek()); - } - - /// - /// Writes the current token and its children. - /// - /// The to read the token from. - public void WriteToken(JsonReader reader) - { - WriteToken(reader, true); - } - - /// - /// Writes the current token. - /// - /// The to read the token from. - /// A flag indicating whether the current token's children should be written. - public void WriteToken(JsonReader reader, bool writeChildren) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - - WriteToken(reader, writeChildren, true, true); - } - - /// - /// Writes the token and its value. - /// - /// The to write. - /// - /// The value to write. - /// A value is only required for tokens that have an associated value, e.g. the property name for . - /// null can be passed to the method for tokens that don't have a value, e.g. . - /// - public void WriteToken(JsonToken token, object? value) - { - switch (token) - { - case JsonToken.None: - // read to next - break; - case JsonToken.StartObject: - WriteStartObject(); - break; - case JsonToken.StartArray: - WriteStartArray(); - break; - case JsonToken.StartConstructor: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - WriteStartConstructor(value.ToString()); - break; - case JsonToken.PropertyName: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - WritePropertyName(value.ToString()); - break; - case JsonToken.Comment: - WriteComment(value?.ToString()); - break; - case JsonToken.Integer: - ValidationUtils.ArgumentNotNull(value, nameof(value)); -#if HAVE_BIG_INTEGER - if (value is BigInteger integer) - { - WriteValue(integer); - } - else -#endif - { - WriteValue(Convert.ToInt64(value, CultureInfo.InvariantCulture)); - } - break; - case JsonToken.Float: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - if (value is decimal decimalValue) - { - WriteValue(decimalValue); - } - else if (value is double doubleValue) - { - WriteValue(doubleValue); - } - else if (value is float floatValue) - { - WriteValue(floatValue); - } - else - { - WriteValue(Convert.ToDouble(value, CultureInfo.InvariantCulture)); - } - break; - case JsonToken.String: - // Allow for a null string. This matches JTokenReader behavior which can read - // a JsonToken.String with a null value. - WriteValue(value?.ToString()); - break; - case JsonToken.Boolean: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - WriteValue(Convert.ToBoolean(value, CultureInfo.InvariantCulture)); - break; - case JsonToken.Null: - WriteNull(); - break; - case JsonToken.Undefined: - WriteUndefined(); - break; - case JsonToken.EndObject: - WriteEndObject(); - break; - case JsonToken.EndArray: - WriteEndArray(); - break; - case JsonToken.EndConstructor: - WriteEndConstructor(); - break; - case JsonToken.Date: - ValidationUtils.ArgumentNotNull(value, nameof(value)); -#if HAVE_DATE_TIME_OFFSET - if (value is DateTimeOffset dt) - { - WriteValue(dt); - } - else -#endif - { - WriteValue(Convert.ToDateTime(value, CultureInfo.InvariantCulture)); - } - break; - case JsonToken.Raw: - WriteRawValue(value?.ToString()); - break; - case JsonToken.Bytes: - ValidationUtils.ArgumentNotNull(value, nameof(value)); - if (value is Guid guid) - { - WriteValue(guid); - } - else - { - WriteValue((byte[])value!); - } - break; - default: - throw MiscellaneousUtils.CreateArgumentOutOfRangeException(nameof(token), token, "Unexpected token type."); - } - } - - /// - /// Writes the token. - /// - /// The to write. - public void WriteToken(JsonToken token) - { - WriteToken(token, null); - } - - internal virtual void WriteToken(JsonReader reader, bool writeChildren, bool writeDateConstructorAsDate, bool writeComments) - { - int initialDepth = CalculateWriteTokenInitialDepth(reader); - - do - { - // write a JValue date when the constructor is for a date - if (writeDateConstructorAsDate && reader.TokenType == JsonToken.StartConstructor && string.Equals(reader.Value?.ToString(), "Date", StringComparison.Ordinal)) - { - WriteConstructorDate(reader); - } - else - { - if (writeComments || reader.TokenType != JsonToken.Comment) - { - WriteToken(reader.TokenType, reader.Value); - } - } - } while ( - // stop if we have reached the end of the token being read - initialDepth - 1 < reader.Depth - (JsonTokenUtils.IsEndToken(reader.TokenType) ? 1 : 0) - && writeChildren - && reader.Read()); - - if (IsWriteTokenIncomplete(reader, writeChildren, initialDepth)) - { - throw JsonWriterException.Create(this, "Unexpected end when reading token.", null); - } - } - - private bool IsWriteTokenIncomplete(JsonReader reader, bool writeChildren, int initialDepth) - { - int finalDepth = CalculateWriteTokenFinalDepth(reader); - return initialDepth < finalDepth || - (writeChildren && initialDepth == finalDepth && JsonTokenUtils.IsStartToken(reader.TokenType)); - } - - private int CalculateWriteTokenInitialDepth(JsonReader reader) - { - JsonToken type = reader.TokenType; - if (type == JsonToken.None) - { - return -1; - } - - return JsonTokenUtils.IsStartToken(type) ? reader.Depth : reader.Depth + 1; - } - - private int CalculateWriteTokenFinalDepth(JsonReader reader) - { - JsonToken type = reader.TokenType; - if (type == JsonToken.None) - { - return -1; - } - - return JsonTokenUtils.IsEndToken(type) ? reader.Depth - 1 : reader.Depth; - } - - private void WriteConstructorDate(JsonReader reader) - { - if (!JavaScriptUtils.TryGetDateFromConstructorJson(reader, out DateTime dateTime, out string? errorMessage)) - { - throw JsonWriterException.Create(this, errorMessage, null); - } - - WriteValue(dateTime); - } - - private void WriteEnd(JsonContainerType type) - { - switch (type) - { - case JsonContainerType.Object: - WriteEndObject(); - break; - case JsonContainerType.Array: - WriteEndArray(); - break; - case JsonContainerType.Constructor: - WriteEndConstructor(); - break; - default: - throw JsonWriterException.Create(this, "Unexpected type when writing end: " + type, null); - } - } - - private void AutoCompleteAll() - { - while (Top > 0) - { - WriteEnd(); - } - } - - private JsonToken GetCloseTokenForType(JsonContainerType type) - { - switch (type) - { - case JsonContainerType.Object: - return JsonToken.EndObject; - case JsonContainerType.Array: - return JsonToken.EndArray; - case JsonContainerType.Constructor: - return JsonToken.EndConstructor; - default: - throw JsonWriterException.Create(this, "No close token for type: " + type, null); - } - } - - private void AutoCompleteClose(JsonContainerType type) - { - int levelsToComplete = CalculateLevelsToComplete(type); - - for (int i = 0; i < levelsToComplete; i++) - { - JsonToken token = GetCloseTokenForType(Pop()); - - if (_currentState == State.Property) - { - WriteNull(); - } - - if (_formatting == Formatting.Indented) - { - if (_currentState != State.ObjectStart && _currentState != State.ArrayStart) - { - WriteIndent(); - } - } - - WriteEnd(token); - - UpdateCurrentState(); - } - } - - private int CalculateLevelsToComplete(JsonContainerType type) - { - int levelsToComplete = 0; - - if (_currentPosition.Type == type) - { - levelsToComplete = 1; - } - else - { - int top = Top - 2; - for (int i = top; i >= 0; i--) - { - int currentLevel = top - i; - - if (_stack![currentLevel].Type == type) - { - levelsToComplete = i + 2; - break; - } - } - } - - if (levelsToComplete == 0) - { - throw JsonWriterException.Create(this, "No token to close.", null); - } - - return levelsToComplete; - } - - private void UpdateCurrentState() - { - JsonContainerType currentLevelType = Peek(); - - switch (currentLevelType) - { - case JsonContainerType.Object: - _currentState = State.Object; - break; - case JsonContainerType.Array: - _currentState = State.Array; - break; - case JsonContainerType.Constructor: - _currentState = State.Array; - break; - case JsonContainerType.None: - _currentState = State.Start; - break; - default: - throw JsonWriterException.Create(this, "Unknown JsonType: " + currentLevelType, null); - } - } - - /// - /// Writes the specified end token. - /// - /// The end token to write. - protected virtual void WriteEnd(JsonToken token) - { - } - - /// - /// Writes indent characters. - /// - protected virtual void WriteIndent() - { - } - - /// - /// Writes the JSON value delimiter. - /// - protected virtual void WriteValueDelimiter() - { - } - - /// - /// Writes an indent space. - /// - protected virtual void WriteIndentSpace() - { - } - - internal void AutoComplete(JsonToken tokenBeingWritten) - { - // gets new state based on the current state and what is being written - State newState = StateArray[(int)tokenBeingWritten][(int)_currentState]; - - if (newState == State.Error) - { - throw JsonWriterException.Create(this, "Token {0} in state {1} would result in an invalid JSON object.".FormatWith(CultureInfo.InvariantCulture, tokenBeingWritten.ToString(), _currentState.ToString()), null); - } - - if ((_currentState == State.Object || _currentState == State.Array || _currentState == State.Constructor) && tokenBeingWritten != JsonToken.Comment) - { - WriteValueDelimiter(); - } - - if (_formatting == Formatting.Indented) - { - if (_currentState == State.Property) - { - WriteIndentSpace(); - } - - // don't indent a property when it is the first token to be written (i.e. at the start) - if ((_currentState == State.Array || _currentState == State.ArrayStart || _currentState == State.Constructor || _currentState == State.ConstructorStart) - || (tokenBeingWritten == JsonToken.PropertyName && _currentState != State.Start)) - { - WriteIndent(); - } - } - - _currentState = newState; - } - - #region WriteValue methods - /// - /// Writes a null value. - /// - public virtual void WriteNull() - { - InternalWriteValue(JsonToken.Null); - } - - /// - /// Writes an undefined value. - /// - public virtual void WriteUndefined() - { - InternalWriteValue(JsonToken.Undefined); - } - - /// - /// Writes raw JSON without changing the writer's state. - /// - /// The raw JSON to write. - public virtual void WriteRaw(string? json) - { - InternalWriteRaw(); - } - - /// - /// Writes raw JSON where a value is expected and updates the writer's state. - /// - /// The raw JSON to write. - public virtual void WriteRawValue(string? json) - { - // hack. want writer to change state as if a value had been written - UpdateScopeWithFinishedValue(); - AutoComplete(JsonToken.Undefined); - WriteRaw(json); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(string? value) - { - InternalWriteValue(JsonToken.String); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(int value) - { - InternalWriteValue(JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public virtual void WriteValue(uint value) - { - InternalWriteValue(JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(long value) - { - InternalWriteValue(JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public virtual void WriteValue(ulong value) - { - InternalWriteValue(JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(float value) - { - InternalWriteValue(JsonToken.Float); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(double value) - { - InternalWriteValue(JsonToken.Float); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(bool value) - { - InternalWriteValue(JsonToken.Boolean); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(short value) - { - InternalWriteValue(JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public virtual void WriteValue(ushort value) - { - InternalWriteValue(JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(char value) - { - InternalWriteValue(JsonToken.String); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(byte value) - { - InternalWriteValue(JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public virtual void WriteValue(sbyte value) - { - InternalWriteValue(JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(decimal value) - { - InternalWriteValue(JsonToken.Float); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(DateTime value) - { - InternalWriteValue(JsonToken.Date); - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(DateTimeOffset value) - { - InternalWriteValue(JsonToken.Date); - } -#endif - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(Guid value) - { - InternalWriteValue(JsonToken.String); - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(TimeSpan value) - { - InternalWriteValue(JsonToken.String); - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(int? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - [CLSCompliant(false)] - public virtual void WriteValue(uint? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(long? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - [CLSCompliant(false)] - public virtual void WriteValue(ulong? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(float? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(double? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(bool? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(short? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - [CLSCompliant(false)] - public virtual void WriteValue(ushort? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(char? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(byte? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - [CLSCompliant(false)] - public virtual void WriteValue(sbyte? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(decimal? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(DateTime? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(DateTimeOffset? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } -#endif - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(Guid? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a of value. - /// - /// The of value to write. - public virtual void WriteValue(TimeSpan? value) - { - if (value == null) - { - WriteNull(); - } - else - { - WriteValue(value.GetValueOrDefault()); - } - } - - /// - /// Writes a [] value. - /// - /// The [] value to write. - public virtual void WriteValue(byte[]? value) - { - if (value == null) - { - WriteNull(); - } - else - { - InternalWriteValue(JsonToken.Bytes); - } - } - - /// - /// Writes a value. - /// - /// The value to write. - public virtual void WriteValue(Uri? value) - { - if (value == null) - { - WriteNull(); - } - else - { - InternalWriteValue(JsonToken.String); - } - } - - /// - /// Writes a value. - /// An error will raised if the value cannot be written as a single JSON token. - /// - /// The value to write. - public virtual void WriteValue(object? value) - { - if (value == null) - { - WriteNull(); - } - else - { -#if HAVE_BIG_INTEGER - // this is here because adding a WriteValue(BigInteger) to JsonWriter will - // mean the user has to add a reference to System.Numerics.dll - if (value is BigInteger) - { - throw CreateUnsupportedTypeException(this, value); - } -#endif - - WriteValue(this, ConvertUtils.GetTypeCode(value.GetType()), value); - } - } - #endregion - - /// - /// Writes a comment /*...*/ containing the specified text. - /// - /// Text to place inside the comment. - public virtual void WriteComment(string? text) - { - InternalWriteComment(); - } - - /// - /// Writes the given white space. - /// - /// The string of white space characters. - public virtual void WriteWhitespace(string ws) - { - InternalWriteWhitespace(ws); - } - - void IDisposable.Dispose() - { - Dispose(true); - GC.SuppressFinalize(this); - } - - /// - /// Releases unmanaged and - optionally - managed resources. - /// - /// true to release both managed and unmanaged resources; false to release only unmanaged resources. - protected virtual void Dispose(bool disposing) - { - if (_currentState != State.Closed && disposing) - { - Close(); - } - } - - internal static void WriteValue(JsonWriter writer, PrimitiveTypeCode typeCode, object value) - { - while (true) - { - switch (typeCode) - { - case PrimitiveTypeCode.Char: - writer.WriteValue((char)value); - return; - - case PrimitiveTypeCode.CharNullable: - writer.WriteValue((value == null) ? (char?)null : (char)value); - return; - - case PrimitiveTypeCode.Boolean: - writer.WriteValue((bool)value); - return; - - case PrimitiveTypeCode.BooleanNullable: - writer.WriteValue((value == null) ? (bool?)null : (bool)value); - return; - - case PrimitiveTypeCode.SByte: - writer.WriteValue((sbyte)value); - return; - - case PrimitiveTypeCode.SByteNullable: - writer.WriteValue((value == null) ? (sbyte?)null : (sbyte)value); - return; - - case PrimitiveTypeCode.Int16: - writer.WriteValue((short)value); - return; - - case PrimitiveTypeCode.Int16Nullable: - writer.WriteValue((value == null) ? (short?)null : (short)value); - return; - - case PrimitiveTypeCode.UInt16: - writer.WriteValue((ushort)value); - return; - - case PrimitiveTypeCode.UInt16Nullable: - writer.WriteValue((value == null) ? (ushort?)null : (ushort)value); - return; - - case PrimitiveTypeCode.Int32: - writer.WriteValue((int)value); - return; - - case PrimitiveTypeCode.Int32Nullable: - writer.WriteValue((value == null) ? (int?)null : (int)value); - return; - - case PrimitiveTypeCode.Byte: - writer.WriteValue((byte)value); - return; - - case PrimitiveTypeCode.ByteNullable: - writer.WriteValue((value == null) ? (byte?)null : (byte)value); - return; - - case PrimitiveTypeCode.UInt32: - writer.WriteValue((uint)value); - return; - - case PrimitiveTypeCode.UInt32Nullable: - writer.WriteValue((value == null) ? (uint?)null : (uint)value); - return; - - case PrimitiveTypeCode.Int64: - writer.WriteValue((long)value); - return; - - case PrimitiveTypeCode.Int64Nullable: - writer.WriteValue((value == null) ? (long?)null : (long)value); - return; - - case PrimitiveTypeCode.UInt64: - writer.WriteValue((ulong)value); - return; - - case PrimitiveTypeCode.UInt64Nullable: - writer.WriteValue((value == null) ? (ulong?)null : (ulong)value); - return; - - case PrimitiveTypeCode.Single: - writer.WriteValue((float)value); - return; - - case PrimitiveTypeCode.SingleNullable: - writer.WriteValue((value == null) ? (float?)null : (float)value); - return; - - case PrimitiveTypeCode.Double: - writer.WriteValue((double)value); - return; - - case PrimitiveTypeCode.DoubleNullable: - writer.WriteValue((value == null) ? (double?)null : (double)value); - return; - - case PrimitiveTypeCode.DateTime: - writer.WriteValue((DateTime)value); - return; - - case PrimitiveTypeCode.DateTimeNullable: - writer.WriteValue((value == null) ? (DateTime?)null : (DateTime)value); - return; - -#if HAVE_DATE_TIME_OFFSET - case PrimitiveTypeCode.DateTimeOffset: - writer.WriteValue((DateTimeOffset)value); - return; - - case PrimitiveTypeCode.DateTimeOffsetNullable: - writer.WriteValue((value == null) ? (DateTimeOffset?)null : (DateTimeOffset)value); - return; -#endif - case PrimitiveTypeCode.Decimal: - writer.WriteValue((decimal)value); - return; - - case PrimitiveTypeCode.DecimalNullable: - writer.WriteValue((value == null) ? (decimal?)null : (decimal)value); - return; - - case PrimitiveTypeCode.Guid: - writer.WriteValue((Guid)value); - return; - - case PrimitiveTypeCode.GuidNullable: - writer.WriteValue((value == null) ? (Guid?)null : (Guid)value); - return; - - case PrimitiveTypeCode.TimeSpan: - writer.WriteValue((TimeSpan)value); - return; - - case PrimitiveTypeCode.TimeSpanNullable: - writer.WriteValue((value == null) ? (TimeSpan?)null : (TimeSpan)value); - return; - -#if HAVE_BIG_INTEGER - case PrimitiveTypeCode.BigInteger: - // this will call to WriteValue(object) - writer.WriteValue((BigInteger)value); - return; - - case PrimitiveTypeCode.BigIntegerNullable: - // this will call to WriteValue(object) - writer.WriteValue((value == null) ? (BigInteger?)null : (BigInteger)value); - return; -#endif - case PrimitiveTypeCode.Uri: - writer.WriteValue((Uri)value); - return; - - case PrimitiveTypeCode.String: - writer.WriteValue((string)value); - return; - - case PrimitiveTypeCode.Bytes: - writer.WriteValue((byte[])value); - return; - -#if HAVE_DB_NULL_TYPE_CODE - case PrimitiveTypeCode.DBNull: - writer.WriteNull(); - return; -#endif - default: -#if HAVE_ICONVERTIBLE - if (value is IConvertible convertible) - { - ResolveConvertibleValue(convertible, out typeCode, out value); - continue; - } -#endif - - // write an unknown null value, fix https://github.com/JamesNK/Newtonsoft.Json/issues/1460 - if (value == null) - { - writer.WriteNull(); - return; - } - - throw CreateUnsupportedTypeException(writer, value); - } - } - } - -#if HAVE_ICONVERTIBLE - private static void ResolveConvertibleValue(IConvertible convertible, out PrimitiveTypeCode typeCode, out object value) - { - // the value is a non-standard IConvertible - // convert to the underlying value and retry - TypeInformation typeInformation = ConvertUtils.GetTypeInformation(convertible); - - // if convertible has an underlying typecode of Object then attempt to convert it to a string - typeCode = typeInformation.TypeCode == PrimitiveTypeCode.Object ? PrimitiveTypeCode.String : typeInformation.TypeCode; - Type resolvedType = typeInformation.TypeCode == PrimitiveTypeCode.Object ? typeof(string) : typeInformation.Type; - value = convertible.ToType(resolvedType, CultureInfo.InvariantCulture); - } -#endif - - private static JsonWriterException CreateUnsupportedTypeException(JsonWriter writer, object value) - { - return JsonWriterException.Create(writer, "Unsupported type: {0}. Use the JsonSerializer class to get the object's JSON representation.".FormatWith(CultureInfo.InvariantCulture, value.GetType()), null); - } - - /// - /// Sets the state of the . - /// - /// The being written. - /// The value being written. - protected void SetWriteState(JsonToken token, object value) - { - switch (token) - { - case JsonToken.StartObject: - InternalWriteStart(token, JsonContainerType.Object); - break; - case JsonToken.StartArray: - InternalWriteStart(token, JsonContainerType.Array); - break; - case JsonToken.StartConstructor: - InternalWriteStart(token, JsonContainerType.Constructor); - break; - case JsonToken.PropertyName: - if (!(value is string s)) - { - throw new ArgumentException("A name is required when setting property name state.", nameof(value)); - } - - InternalWritePropertyName(s); - break; - case JsonToken.Comment: - InternalWriteComment(); - break; - case JsonToken.Raw: - InternalWriteRaw(); - break; - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.String: - case JsonToken.Boolean: - case JsonToken.Date: - case JsonToken.Bytes: - case JsonToken.Null: - case JsonToken.Undefined: - InternalWriteValue(token); - break; - case JsonToken.EndObject: - InternalWriteEnd(JsonContainerType.Object); - break; - case JsonToken.EndArray: - InternalWriteEnd(JsonContainerType.Array); - break; - case JsonToken.EndConstructor: - InternalWriteEnd(JsonContainerType.Constructor); - break; - default: - throw new ArgumentOutOfRangeException(nameof(token)); - } - } - - internal void InternalWriteEnd(JsonContainerType container) - { - AutoCompleteClose(container); - } - - internal void InternalWritePropertyName(string name) - { - _currentPosition.PropertyName = name; - AutoComplete(JsonToken.PropertyName); - } - - internal void InternalWriteRaw() - { - } - - internal void InternalWriteStart(JsonToken token, JsonContainerType container) - { - UpdateScopeWithFinishedValue(); - AutoComplete(token); - Push(container); - } - - internal void InternalWriteValue(JsonToken token) - { - UpdateScopeWithFinishedValue(); - AutoComplete(token); - } - - internal void InternalWriteWhitespace(string ws) - { - if (ws != null) - { - if (!StringUtils.IsWhiteSpace(ws)) - { - throw JsonWriterException.Create(this, "Only white space characters should be used.", null); - } - } - } - - internal void InternalWriteComment() - { - AutoComplete(JsonToken.Comment); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/JsonWriterException.cs b/Source/MyDb/Newtonsoft.Json/JsonWriterException.cs deleted file mode 100644 index cb5b9ac..0000000 --- a/Source/MyDb/Newtonsoft.Json/JsonWriterException.cs +++ /dev/null @@ -1,114 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Runtime.Serialization; -using System.Text; - -namespace Newtonsoft.Json -{ - /// - /// The exception thrown when an error occurs while writing JSON text. - /// -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - [Serializable] -#endif - public class JsonWriterException : JsonException - { - /// - /// Gets the path to the JSON where the error occurred. - /// - /// The path to the JSON where the error occurred. - public string? Path { get; } - - /// - /// Initializes a new instance of the class. - /// - public JsonWriterException() - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message. - /// - /// The error message that explains the reason for the exception. - public JsonWriterException(string message) - : base(message) - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message and a reference to the inner exception that is the cause of this exception. - /// - /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or null if no inner exception is specified. - public JsonWriterException(string message, Exception innerException) - : base(message, innerException) - { - } - -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - /// - /// Initializes a new instance of the class. - /// - /// The that holds the serialized object data about the exception being thrown. - /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). - public JsonWriterException(SerializationInfo info, StreamingContext context) - : base(info, context) - { - } -#endif - - /// - /// Initializes a new instance of the class - /// with a specified error message, JSON path and a reference to the inner exception that is the cause of this exception. - /// - /// The error message that explains the reason for the exception. - /// The path to the JSON where the error occurred. - /// The exception that is the cause of the current exception, or null if no inner exception is specified. - public JsonWriterException(string message, string path, Exception? innerException) - : base(message, innerException) - { - Path = path; - } - - internal static JsonWriterException Create(JsonWriter writer, string message, Exception? ex) - { - return Create(writer.ContainerPath, message, ex); - } - - internal static JsonWriterException Create(string path, string message, Exception? ex) - { - message = JsonPosition.FormatMessage(null, path, message); - - return new JsonWriterException(message, path, ex); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/CommentHandling.cs b/Source/MyDb/Newtonsoft.Json/Linq/CommentHandling.cs deleted file mode 100644 index 579235c..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/CommentHandling.cs +++ /dev/null @@ -1,43 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Linq -{ - /// - /// Specifies how JSON comments are handled when loading JSON. - /// - public enum CommentHandling - { - /// - /// Ignore comments. - /// - Ignore = 0, - - /// - /// Load comments as a with type . - /// - Load = 1 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/DuplicatePropertyNameHandling.cs b/Source/MyDb/Newtonsoft.Json/Linq/DuplicatePropertyNameHandling.cs deleted file mode 100644 index 43e27fc..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/DuplicatePropertyNameHandling.cs +++ /dev/null @@ -1,46 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Linq -{ - /// - /// Specifies how duplicate property names are handled when loading JSON. - /// - public enum DuplicatePropertyNameHandling - { - /// - /// Replace the existing value when there is a duplicate property. The value of the last property in the JSON object will be used. - /// - Replace = 0, - /// - /// Ignore the new value when there is a duplicate property. The value of the first property in the JSON object will be used. - /// - Ignore = 1, - /// - /// Throw a when a duplicate property is encountered. - /// - Error = 2 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/Extensions.cs b/Source/MyDb/Newtonsoft.Json/Linq/Extensions.cs deleted file mode 100644 index e05fd26..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/Extensions.cs +++ /dev/null @@ -1,336 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using Newtonsoft.Json.Utilities; -using System.Globalization; -using System.Diagnostics.CodeAnalysis; -using System.Runtime.CompilerServices; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -namespace Newtonsoft.Json.Linq -{ - /// - /// Contains the LINQ to JSON extension methods. - /// - public static class Extensions - { - /// - /// Returns a collection of tokens that contains the ancestors of every token in the source collection. - /// - /// The type of the objects in source, constrained to . - /// An of that contains the source collection. - /// An of that contains the ancestors of every token in the source collection. - public static IJEnumerable Ancestors(this IEnumerable source) where T : JToken - { - ValidationUtils.ArgumentNotNull(source, nameof(source)); - - return source.SelectMany(j => j.Ancestors()).AsJEnumerable(); - } - - /// - /// Returns a collection of tokens that contains every token in the source collection, and the ancestors of every token in the source collection. - /// - /// The type of the objects in source, constrained to . - /// An of that contains the source collection. - /// An of that contains every token in the source collection, the ancestors of every token in the source collection. - public static IJEnumerable AncestorsAndSelf(this IEnumerable source) where T : JToken - { - ValidationUtils.ArgumentNotNull(source, nameof(source)); - - return source.SelectMany(j => j.AncestorsAndSelf()).AsJEnumerable(); - } - - /// - /// Returns a collection of tokens that contains the descendants of every token in the source collection. - /// - /// The type of the objects in source, constrained to . - /// An of that contains the source collection. - /// An of that contains the descendants of every token in the source collection. - public static IJEnumerable Descendants(this IEnumerable source) where T : JContainer - { - ValidationUtils.ArgumentNotNull(source, nameof(source)); - - return source.SelectMany(j => j.Descendants()).AsJEnumerable(); - } - - /// - /// Returns a collection of tokens that contains every token in the source collection, and the descendants of every token in the source collection. - /// - /// The type of the objects in source, constrained to . - /// An of that contains the source collection. - /// An of that contains every token in the source collection, and the descendants of every token in the source collection. - public static IJEnumerable DescendantsAndSelf(this IEnumerable source) where T : JContainer - { - ValidationUtils.ArgumentNotNull(source, nameof(source)); - - return source.SelectMany(j => j.DescendantsAndSelf()).AsJEnumerable(); - } - - /// - /// Returns a collection of child properties of every object in the source collection. - /// - /// An of that contains the source collection. - /// An of that contains the properties of every object in the source collection. - public static IJEnumerable Properties(this IEnumerable source) - { - ValidationUtils.ArgumentNotNull(source, nameof(source)); - - return source.SelectMany(d => d.Properties()).AsJEnumerable(); - } - - /// - /// Returns a collection of child values of every object in the source collection with the given key. - /// - /// An of that contains the source collection. - /// The token key. - /// An of that contains the values of every token in the source collection with the given key. - public static IJEnumerable Values(this IEnumerable source, object? key) - { - return Values(source, key)!.AsJEnumerable(); - } - - /// - /// Returns a collection of child values of every object in the source collection. - /// - /// An of that contains the source collection. - /// An of that contains the values of every token in the source collection. - public static IJEnumerable Values(this IEnumerable source) - { - return source.Values(null); - } - - /// - /// Returns a collection of converted child values of every object in the source collection with the given key. - /// - /// The type to convert the values to. - /// An of that contains the source collection. - /// The token key. - /// An that contains the converted values of every token in the source collection with the given key. - public static IEnumerable Values(this IEnumerable source, object key) - { - return Values(source, key); - } - - /// - /// Returns a collection of converted child values of every object in the source collection. - /// - /// The type to convert the values to. - /// An of that contains the source collection. - /// An that contains the converted values of every token in the source collection. - public static IEnumerable Values(this IEnumerable source) - { - return Values(source, null); - } - - /// - /// Converts the value. - /// - /// The type to convert the value to. - /// A cast as a of . - /// A converted value. - public static U? Value(this IEnumerable value) - { - return value.Value(); - } - - /// - /// Converts the value. - /// - /// The source collection type. - /// The type to convert the value to. - /// A cast as a of . - /// A converted value. - public static U? Value(this IEnumerable value) where T : JToken - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - - if (!(value is JToken token)) - { - throw new ArgumentException("Source value must be a JToken."); - } - - return token.Convert(); - } - - internal static IEnumerable Values(this IEnumerable source, object? key) where T : JToken - { - ValidationUtils.ArgumentNotNull(source, nameof(source)); - - if (key == null) - { - foreach (T token in source) - { - if (token is JValue value) - { - yield return Convert(value); - } - else - { - foreach (JToken t in token.Children()) - { - yield return t.Convert(); - } - } - } - } - else - { - foreach (T token in source) - { - JToken? value = token[key]; - if (value != null) - { - yield return value.Convert(); - } - } - } - } - - //TODO - //public static IEnumerable InDocumentOrder(this IEnumerable source) where T : JObject; - - /// - /// Returns a collection of child tokens of every array in the source collection. - /// - /// The source collection type. - /// An of that contains the source collection. - /// An of that contains the values of every token in the source collection. - public static IJEnumerable Children(this IEnumerable source) where T : JToken - { - return Children(source)!.AsJEnumerable(); - } - - /// - /// Returns a collection of converted child tokens of every array in the source collection. - /// - /// An of that contains the source collection. - /// The type to convert the values to. - /// The source collection type. - /// An that contains the converted values of every token in the source collection. - public static IEnumerable Children(this IEnumerable source) where T : JToken - { - ValidationUtils.ArgumentNotNull(source, nameof(source)); - - return source.SelectMany(c => c.Children()).Convert(); - } - - internal static IEnumerable Convert(this IEnumerable source) where T : JToken - { - ValidationUtils.ArgumentNotNull(source, nameof(source)); - - foreach (T token in source) - { - yield return Convert(token); - } - } - - internal static U? Convert(this T token) where T : JToken? - { - if (token == null) - { -#pragma warning disable CS8653 // A default expression introduces a null value for a type parameter. - return default; -#pragma warning restore CS8653 // A default expression introduces a null value for a type parameter. - } - - if (token is U castValue - // don't want to cast JValue to its interfaces, want to get the internal value - && typeof(U) != typeof(IComparable) && typeof(U) != typeof(IFormattable)) - { - return castValue; - } - else - { - if (!(token is JValue value)) - { - throw new InvalidCastException("Cannot cast {0} to {1}.".FormatWith(CultureInfo.InvariantCulture, token.GetType(), typeof(T))); - } - - if (value.Value is U u) - { - return u; - } - - Type targetType = typeof(U); - - if (ReflectionUtils.IsNullableType(targetType)) - { - if (value.Value == null) - { -#pragma warning disable CS8653 // A default expression introduces a null value for a type parameter. - return default; -#pragma warning restore CS8653 // A default expression introduces a null value for a type parameter. - } - - targetType = Nullable.GetUnderlyingType(targetType); - } - - return (U)System.Convert.ChangeType(value.Value, targetType, CultureInfo.InvariantCulture); - } - } - - //TODO - //public static void Remove(this IEnumerable source) where T : JContainer; - - /// - /// Returns the input typed as . - /// - /// An of that contains the source collection. - /// The input typed as . - public static IJEnumerable AsJEnumerable(this IEnumerable source) - { - return source.AsJEnumerable(); - } - - /// - /// Returns the input typed as . - /// - /// The source collection type. - /// An of that contains the source collection. - /// The input typed as . - public static IJEnumerable AsJEnumerable(this IEnumerable source) where T : JToken - { - if (source == null) - { - return null!; - } - else if (source is IJEnumerable customEnumerable) - { - return customEnumerable; - } - else - { - return new JEnumerable(source); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/IJEnumerable.cs b/Source/MyDb/Newtonsoft.Json/Linq/IJEnumerable.cs deleted file mode 100644 index 133a7f6..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/IJEnumerable.cs +++ /dev/null @@ -1,46 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System.Collections.Generic; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a collection of objects. - /// - /// The type of token. - public interface IJEnumerable< -#if HAVE_VARIANT_TYPE_PARAMETERS - out -#endif - T> : IEnumerable where T : JToken - { - /// - /// Gets the of with the specified key. - /// - /// - IJEnumerable this[object key] { get; } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JArray.Async.cs b/Source/MyDb/Newtonsoft.Json/Linq/JArray.Async.cs deleted file mode 100644 index 25ffe4e..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JArray.Async.cs +++ /dev/null @@ -1,103 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System.Globalization; -using System.Threading; -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - public partial class JArray - { - /// - /// Writes this token to a asynchronously. - /// - /// A into which this method will write. - /// The token to monitor for cancellation requests. - /// A collection of which will be used when writing the token. - /// A that represents the asynchronous write operation. - public override async Task WriteToAsync(JsonWriter writer, CancellationToken cancellationToken, params JsonConverter[] converters) - { - await writer.WriteStartArrayAsync(cancellationToken).ConfigureAwait(false); - - for (int i = 0; i < _values.Count; i++) - { - await _values[i].WriteToAsync(writer, cancellationToken, converters).ConfigureAwait(false); - } - - await writer.WriteEndArrayAsync(cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously loads a from a . - /// - /// A that will be read for the content of the . - /// If this is null, default load settings will be used. - /// The token to monitor for cancellation requests. The default value is . - /// A representing the asynchronous load. The property contains the JSON that was read from the specified . - public new static Task LoadAsync(JsonReader reader, CancellationToken cancellationToken = default) - { - return LoadAsync(reader, null, cancellationToken); - } - - /// - /// Asynchronously loads a from a . - /// - /// A that will be read for the content of the . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// The token to monitor for cancellation requests. The default value is . - /// A representing the asynchronous load. The property contains the JSON that was read from the specified . - public new static async Task LoadAsync(JsonReader reader, JsonLoadSettings? settings, CancellationToken cancellationToken = default) - { - if (reader.TokenType == JsonToken.None) - { - if (!await reader.ReadAsync(cancellationToken).ConfigureAwait(false)) - { - throw JsonReaderException.Create(reader, "Error reading JArray from JsonReader."); - } - } - - await reader.MoveToContentAsync(cancellationToken).ConfigureAwait(false); - - if (reader.TokenType != JsonToken.StartArray) - { - throw JsonReaderException.Create(reader, "Error reading JArray from JsonReader. Current JsonReader item is not an array: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - JArray a = new JArray(); - a.SetLineInfo(reader as IJsonLineInfo, settings); - - await a.ReadTokenFromAsync(reader, settings, cancellationToken).ConfigureAwait(false); - - return a; - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JArray.cs b/Source/MyDb/Newtonsoft.Json/Linq/JArray.cs deleted file mode 100644 index 241a560..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JArray.cs +++ /dev/null @@ -1,403 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using Newtonsoft.Json.Utilities; -using System.IO; -using System.Globalization; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a JSON array. - /// - /// - /// - /// - public partial class JArray : JContainer, IList - { - private readonly List _values = new List(); - - /// - /// Gets the container's children tokens. - /// - /// The container's children tokens. - protected override IList ChildrenTokens => _values; - - /// - /// Gets the node type for this . - /// - /// The type. - public override JTokenType Type => JTokenType.Array; - - /// - /// Initializes a new instance of the class. - /// - public JArray() - { - } - - /// - /// Initializes a new instance of the class from another object. - /// - /// A object to copy from. - public JArray(JArray other) - : base(other) - { - } - - /// - /// Initializes a new instance of the class with the specified content. - /// - /// The contents of the array. - public JArray(params object[] content) - : this((object)content) - { - } - - /// - /// Initializes a new instance of the class with the specified content. - /// - /// The contents of the array. - public JArray(object content) - { - Add(content); - } - - internal override bool DeepEquals(JToken node) - { - return (node is JArray t && ContentsEqual(t)); - } - - internal override JToken CloneToken() - { - return new JArray(this); - } - - /// - /// Loads an from a . - /// - /// A that will be read for the content of the . - /// A that contains the JSON that was read from the specified . - public new static JArray Load(JsonReader reader) - { - return Load(reader, null); - } - - /// - /// Loads an from a . - /// - /// A that will be read for the content of the . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// A that contains the JSON that was read from the specified . - public new static JArray Load(JsonReader reader, JsonLoadSettings? settings) - { - if (reader.TokenType == JsonToken.None) - { - if (!reader.Read()) - { - throw JsonReaderException.Create(reader, "Error reading JArray from JsonReader."); - } - } - - reader.MoveToContent(); - - if (reader.TokenType != JsonToken.StartArray) - { - throw JsonReaderException.Create(reader, "Error reading JArray from JsonReader. Current JsonReader item is not an array: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - JArray a = new JArray(); - a.SetLineInfo(reader as IJsonLineInfo, settings); - - a.ReadTokenFrom(reader, settings); - - return a; - } - - /// - /// Load a from a string that contains JSON. - /// - /// A that contains JSON. - /// A populated from the string that contains JSON. - /// - /// - /// - public new static JArray Parse(string json) - { - return Parse(json, null); - } - - /// - /// Load a from a string that contains JSON. - /// - /// A that contains JSON. - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// A populated from the string that contains JSON. - /// - /// - /// - public new static JArray Parse(string json, JsonLoadSettings? settings) - { - using (JsonReader reader = new JsonTextReader(new StringReader(json))) - { - JArray a = Load(reader, settings); - - while (reader.Read()) - { - // Any content encountered here other than a comment will throw in the reader. - } - - return a; - } - } - - /// - /// Creates a from an object. - /// - /// The object that will be used to create . - /// A with the values of the specified object. - public new static JArray FromObject(object o) - { - return FromObject(o, JsonSerializer.CreateDefault()); - } - - /// - /// Creates a from an object. - /// - /// The object that will be used to create . - /// The that will be used to read the object. - /// A with the values of the specified object. - public new static JArray FromObject(object o, JsonSerializer jsonSerializer) - { - JToken token = FromObjectInternal(o, jsonSerializer); - - if (token.Type != JTokenType.Array) - { - throw new ArgumentException("Object serialized to {0}. JArray instance expected.".FormatWith(CultureInfo.InvariantCulture, token.Type)); - } - - return (JArray)token; - } - - /// - /// Writes this token to a . - /// - /// A into which this method will write. - /// A collection of which will be used when writing the token. - public override void WriteTo(JsonWriter writer, params JsonConverter[] converters) - { - writer.WriteStartArray(); - - for (int i = 0; i < _values.Count; i++) - { - _values[i].WriteTo(writer, converters); - } - - writer.WriteEndArray(); - } - - /// - /// Gets the with the specified key. - /// - /// The with the specified key. - public override JToken? this[object key] - { - get - { - ValidationUtils.ArgumentNotNull(key, nameof(key)); - - if (!(key is int)) - { - throw new ArgumentException("Accessed JArray values with invalid key value: {0}. Int32 array index expected.".FormatWith(CultureInfo.InvariantCulture, MiscellaneousUtils.ToString(key))); - } - - return GetItem((int)key); - } - set - { - ValidationUtils.ArgumentNotNull(key, nameof(key)); - - if (!(key is int)) - { - throw new ArgumentException("Set JArray values with invalid key value: {0}. Int32 array index expected.".FormatWith(CultureInfo.InvariantCulture, MiscellaneousUtils.ToString(key))); - } - - SetItem((int)key, value); - } - } - - /// - /// Gets or sets the at the specified index. - /// - /// - public JToken this[int index] - { - get => GetItem(index); - set => SetItem(index, value); - } - - internal override int IndexOfItem(JToken? item) - { - if (item == null) - { - return -1; - } - - return _values.IndexOfReference(item); - } - - internal override void MergeItem(object content, JsonMergeSettings? settings) - { - IEnumerable? a = (IsMultiContent(content) || content is JArray) - ? (IEnumerable)content - : null; - if (a == null) - { - return; - } - - MergeEnumerableContent(this, a, settings); - } - - #region IList Members - /// - /// Determines the index of a specific item in the . - /// - /// The object to locate in the . - /// - /// The index of if found in the list; otherwise, -1. - /// - public int IndexOf(JToken item) - { - return IndexOfItem(item); - } - - /// - /// Inserts an item to the at the specified index. - /// - /// The zero-based index at which should be inserted. - /// The object to insert into the . - /// - /// is not a valid index in the . - /// - public void Insert(int index, JToken item) - { - InsertItem(index, item, false); - } - - /// - /// Removes the item at the specified index. - /// - /// The zero-based index of the item to remove. - /// - /// is not a valid index in the . - /// - public void RemoveAt(int index) - { - RemoveItemAt(index); - } - - /// - /// Returns an enumerator that iterates through the collection. - /// - /// - /// A of that can be used to iterate through the collection. - /// - public IEnumerator GetEnumerator() - { - return Children().GetEnumerator(); - } - #endregion - - #region ICollection Members - /// - /// Adds an item to the . - /// - /// The object to add to the . - public void Add(JToken item) - { - Add((object)item); - } - - /// - /// Removes all items from the . - /// - public void Clear() - { - ClearItems(); - } - - /// - /// Determines whether the contains a specific value. - /// - /// The object to locate in the . - /// - /// true if is found in the ; otherwise, false. - /// - public bool Contains(JToken item) - { - return ContainsItem(item); - } - - /// - /// Copies the elements of the to an array, starting at a particular array index. - /// - /// The array. - /// Index of the array. - public void CopyTo(JToken[] array, int arrayIndex) - { - CopyItemsTo(array, arrayIndex); - } - - /// - /// Gets a value indicating whether the is read-only. - /// - /// true if the is read-only; otherwise, false. - public bool IsReadOnly => false; - - /// - /// Removes the first occurrence of a specific object from the . - /// - /// The object to remove from the . - /// - /// true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - /// - public bool Remove(JToken item) - { - return RemoveItem(item); - } - #endregion - - internal override int GetDeepHashCode() - { - return ContentsHashCode(); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JConstructor.Async.cs b/Source/MyDb/Newtonsoft.Json/Linq/JConstructor.Async.cs deleted file mode 100644 index bdbeff6..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JConstructor.Async.cs +++ /dev/null @@ -1,106 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System.Globalization; -using System.Threading; -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - public partial class JConstructor - { - /// - /// Writes this token to a asynchronously. - /// - /// A into which this method will write. - /// The token to monitor for cancellation requests. - /// A collection of which will be used when writing the token. - /// A that represents the asynchronous write operation. - public override async Task WriteToAsync(JsonWriter writer, CancellationToken cancellationToken, params JsonConverter[] converters) - { - await writer.WriteStartConstructorAsync(_name ?? string.Empty, cancellationToken).ConfigureAwait(false); - - for (int i = 0; i < _values.Count; i++) - { - await _values[i].WriteToAsync(writer, cancellationToken, converters).ConfigureAwait(false); - } - - await writer.WriteEndConstructorAsync(cancellationToken).ConfigureAwait(false); - } - - /// - /// Asynchronously loads a from a . - /// - /// A that will be read for the content of the . - /// The token to monitor for cancellation requests. The default value is . - /// - /// A that represents the asynchronous load. The - /// property returns a that contains the JSON that was read from the specified . - public new static Task LoadAsync(JsonReader reader, CancellationToken cancellationToken = default) - { - return LoadAsync(reader, null, cancellationToken); - } - - /// - /// Asynchronously loads a from a . - /// - /// A that will be read for the content of the . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// The token to monitor for cancellation requests. The default value is . - /// - /// A that represents the asynchronous load. The - /// property returns a that contains the JSON that was read from the specified . - public new static async Task LoadAsync(JsonReader reader, JsonLoadSettings? settings, CancellationToken cancellationToken = default) - { - if (reader.TokenType == JsonToken.None) - { - if (!await reader.ReadAsync(cancellationToken).ConfigureAwait(false)) - { - throw JsonReaderException.Create(reader, "Error reading JConstructor from JsonReader."); - } - } - - await reader.MoveToContentAsync(cancellationToken).ConfigureAwait(false); - - if (reader.TokenType != JsonToken.StartConstructor) - { - throw JsonReaderException.Create(reader, "Error reading JConstructor from JsonReader. Current JsonReader item is not a constructor: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - JConstructor c = new JConstructor((string)reader.Value!); - c.SetLineInfo(reader as IJsonLineInfo, settings); - - await c.ReadTokenFromAsync(reader, settings, cancellationToken).ConfigureAwait(false); - - return c; - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JConstructor.cs b/Source/MyDb/Newtonsoft.Json/Linq/JConstructor.cs deleted file mode 100644 index 4903c0a..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JConstructor.cs +++ /dev/null @@ -1,250 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using Newtonsoft.Json.Utilities; -using System.Globalization; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a JSON constructor. - /// - public partial class JConstructor : JContainer - { - private string? _name; - private readonly List _values = new List(); - - /// - /// Gets the container's children tokens. - /// - /// The container's children tokens. - protected override IList ChildrenTokens => _values; - - internal override int IndexOfItem(JToken? item) - { - if (item == null) - { - return -1; - } - - return _values.IndexOfReference(item); - } - - internal override void MergeItem(object content, JsonMergeSettings? settings) - { - if (!(content is JConstructor c)) - { - return; - } - - if (c.Name != null) - { - Name = c.Name; - } - MergeEnumerableContent(this, c, settings); - } - - /// - /// Gets or sets the name of this constructor. - /// - /// The constructor name. - public string? Name - { - get => _name; - set => _name = value; - } - - /// - /// Gets the node type for this . - /// - /// The type. - public override JTokenType Type => JTokenType.Constructor; - - /// - /// Initializes a new instance of the class. - /// - public JConstructor() - { - } - - /// - /// Initializes a new instance of the class from another object. - /// - /// A object to copy from. - public JConstructor(JConstructor other) - : base(other) - { - _name = other.Name; - } - - /// - /// Initializes a new instance of the class with the specified name and content. - /// - /// The constructor name. - /// The contents of the constructor. - public JConstructor(string name, params object[] content) - : this(name, (object)content) - { - } - - /// - /// Initializes a new instance of the class with the specified name and content. - /// - /// The constructor name. - /// The contents of the constructor. - public JConstructor(string name, object content) - : this(name) - { - Add(content); - } - - /// - /// Initializes a new instance of the class with the specified name. - /// - /// The constructor name. - public JConstructor(string name) - { - if (name == null) - { - throw new ArgumentNullException(nameof(name)); - } - - if (name.Length == 0) - { - throw new ArgumentException("Constructor name cannot be empty.", nameof(name)); - } - - _name = name; - } - - internal override bool DeepEquals(JToken node) - { - return (node is JConstructor c && _name == c.Name && ContentsEqual(c)); - } - - internal override JToken CloneToken() - { - return new JConstructor(this); - } - - /// - /// Writes this token to a . - /// - /// A into which this method will write. - /// A collection of which will be used when writing the token. - public override void WriteTo(JsonWriter writer, params JsonConverter[] converters) - { - writer.WriteStartConstructor(_name!); - - int count = _values.Count; - for (int i = 0; i < count; i++) - { - _values[i].WriteTo(writer, converters); - } - - writer.WriteEndConstructor(); - } - - /// - /// Gets the with the specified key. - /// - /// The with the specified key. - public override JToken? this[object key] - { - get - { - ValidationUtils.ArgumentNotNull(key, nameof(key)); - - if (!(key is int i)) - { - throw new ArgumentException("Accessed JConstructor values with invalid key value: {0}. Argument position index expected.".FormatWith(CultureInfo.InvariantCulture, MiscellaneousUtils.ToString(key))); - } - - return GetItem(i); - } - set - { - ValidationUtils.ArgumentNotNull(key, nameof(key)); - - if (!(key is int i)) - { - throw new ArgumentException("Set JConstructor values with invalid key value: {0}. Argument position index expected.".FormatWith(CultureInfo.InvariantCulture, MiscellaneousUtils.ToString(key))); - } - - SetItem(i, value); - } - } - - internal override int GetDeepHashCode() - { - return (_name?.GetHashCode() ?? 0) ^ ContentsHashCode(); - } - - /// - /// Loads a from a . - /// - /// A that will be read for the content of the . - /// A that contains the JSON that was read from the specified . - public new static JConstructor Load(JsonReader reader) - { - return Load(reader, null); - } - - /// - /// Loads a from a . - /// - /// A that will be read for the content of the . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// A that contains the JSON that was read from the specified . - public new static JConstructor Load(JsonReader reader, JsonLoadSettings? settings) - { - if (reader.TokenType == JsonToken.None) - { - if (!reader.Read()) - { - throw JsonReaderException.Create(reader, "Error reading JConstructor from JsonReader."); - } - } - - reader.MoveToContent(); - - if (reader.TokenType != JsonToken.StartConstructor) - { - throw JsonReaderException.Create(reader, "Error reading JConstructor from JsonReader. Current JsonReader item is not a constructor: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - JConstructor c = new JConstructor((string)reader.Value!); - c.SetLineInfo(reader as IJsonLineInfo, settings); - - c.ReadTokenFrom(reader, settings); - - return c; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JContainer.Async.cs b/Source/MyDb/Newtonsoft.Json/Linq/JContainer.Async.cs deleted file mode 100644 index beb67af..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JContainer.Async.cs +++ /dev/null @@ -1,172 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System; -using System.Diagnostics; -using System.Globalization; -using System.Threading; -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - public abstract partial class JContainer - { - internal async Task ReadTokenFromAsync(JsonReader reader, JsonLoadSettings? options, CancellationToken cancellationToken = default) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - int startDepth = reader.Depth; - - if (!await reader.ReadAsync(cancellationToken).ConfigureAwait(false)) - { - throw JsonReaderException.Create(reader, "Error reading {0} from JsonReader.".FormatWith(CultureInfo.InvariantCulture, GetType().Name)); - } - - await ReadContentFromAsync(reader, options, cancellationToken).ConfigureAwait(false); - - if (reader.Depth > startDepth) - { - throw JsonReaderException.Create(reader, "Unexpected end of content while loading {0}.".FormatWith(CultureInfo.InvariantCulture, GetType().Name)); - } - } - - private async Task ReadContentFromAsync(JsonReader reader, JsonLoadSettings? settings, CancellationToken cancellationToken = default) - { - IJsonLineInfo? lineInfo = reader as IJsonLineInfo; - - JContainer? parent = this; - - do - { - if (parent is JProperty p && p.Value != null) - { - if (parent == this) - { - return; - } - - parent = parent.Parent; - } - - MiscellaneousUtils.Assert(parent != null); - - switch (reader.TokenType) - { - case JsonToken.None: - // new reader. move to actual content - break; - case JsonToken.StartArray: - JArray a = new JArray(); - a.SetLineInfo(lineInfo, settings); - parent.Add(a); - parent = a; - break; - - case JsonToken.EndArray: - if (parent == this) - { - return; - } - - parent = parent.Parent; - break; - case JsonToken.StartObject: - JObject o = new JObject(); - o.SetLineInfo(lineInfo, settings); - parent.Add(o); - parent = o; - break; - case JsonToken.EndObject: - if (parent == this) - { - return; - } - - parent = parent.Parent; - break; - case JsonToken.StartConstructor: - JConstructor constructor = new JConstructor(reader.Value!.ToString()); - constructor.SetLineInfo(lineInfo, settings); - parent.Add(constructor); - parent = constructor; - break; - case JsonToken.EndConstructor: - if (parent == this) - { - return; - } - - parent = parent.Parent; - break; - case JsonToken.String: - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.Date: - case JsonToken.Boolean: - case JsonToken.Bytes: - JValue v = new JValue(reader.Value); - v.SetLineInfo(lineInfo, settings); - parent.Add(v); - break; - case JsonToken.Comment: - if (settings != null && settings.CommentHandling == CommentHandling.Load) - { - v = JValue.CreateComment(reader.Value!.ToString()); - v.SetLineInfo(lineInfo, settings); - parent.Add(v); - } - break; - case JsonToken.Null: - v = JValue.CreateNull(); - v.SetLineInfo(lineInfo, settings); - parent.Add(v); - break; - case JsonToken.Undefined: - v = JValue.CreateUndefined(); - v.SetLineInfo(lineInfo, settings); - parent.Add(v); - break; - case JsonToken.PropertyName: - JProperty? property = ReadProperty(reader, settings, lineInfo, parent); - if (property != null) - { - parent = property; - } - else - { - await reader.SkipAsync().ConfigureAwait(false); - } - break; - default: - throw new InvalidOperationException("The JsonReader should not be on a token of type {0}.".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - } while (await reader.ReadAsync(cancellationToken).ConfigureAwait(false)); - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JContainer.cs b/Source/MyDb/Newtonsoft.Json/Linq/JContainer.cs deleted file mode 100644 index 07f833b..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JContainer.cs +++ /dev/null @@ -1,1255 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -#if HAVE_INOTIFY_COLLECTION_CHANGED -using System.Collections.Specialized; -#endif -using System.Threading; -using Newtonsoft.Json.Utilities; -using System.Collections; -using System.Globalization; -using System.ComponentModel; -using System.Diagnostics; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a token that can contain other tokens. - /// -    public abstract partial class JContainer : JToken, IList -#if HAVE_COMPONENT_MODEL - , ITypedList, IBindingList -#endif - , IList -#if HAVE_INOTIFY_COLLECTION_CHANGED - , INotifyCollectionChanged -#endif - { -#if HAVE_COMPONENT_MODEL - internal ListChangedEventHandler? _listChanged; - internal AddingNewEventHandler? _addingNew; - - /// - /// Occurs when the list changes or an item in the list changes. - /// - public event ListChangedEventHandler ListChanged - { - add => _listChanged += value; - remove => _listChanged -= value; - } - - /// - /// Occurs before an item is added to the collection. - /// - public event AddingNewEventHandler AddingNew - { - add => _addingNew += value; - remove => _addingNew -= value; - } -#endif -#if HAVE_INOTIFY_COLLECTION_CHANGED - internal NotifyCollectionChangedEventHandler? _collectionChanged; - - /// - /// Occurs when the items list of the collection has changed, or the collection is reset. - /// - public event NotifyCollectionChangedEventHandler CollectionChanged - { - add { _collectionChanged += value; } - remove { _collectionChanged -= value; } - } -#endif - - /// - /// Gets the container's children tokens. - /// - /// The container's children tokens. - protected abstract IList ChildrenTokens { get; } - - private object? _syncRoot; -#if (HAVE_COMPONENT_MODEL || HAVE_INOTIFY_COLLECTION_CHANGED) - private bool _busy; -#endif - - internal JContainer() - { - } - - internal JContainer(JContainer other) - : this() - { - ValidationUtils.ArgumentNotNull(other, nameof(other)); - - int i = 0; - foreach (JToken child in other) - { - TryAddInternal(i, child, false); - i++; - } - - CopyAnnotations(this, other); - } - - internal void CheckReentrancy() - { -#if (HAVE_COMPONENT_MODEL || HAVE_INOTIFY_COLLECTION_CHANGED) - if (_busy) - { - throw new InvalidOperationException("Cannot change {0} during a collection change event.".FormatWith(CultureInfo.InvariantCulture, GetType())); - } -#endif - } - - internal virtual IList CreateChildrenCollection() - { - return new List(); - } - -#if HAVE_COMPONENT_MODEL - /// - /// Raises the event. - /// - /// The instance containing the event data. - protected virtual void OnAddingNew(AddingNewEventArgs e) - { - _addingNew?.Invoke(this, e); - } - - /// - /// Raises the event. - /// - /// The instance containing the event data. - protected virtual void OnListChanged(ListChangedEventArgs e) - { - ListChangedEventHandler? handler = _listChanged; - - if (handler != null) - { - _busy = true; - try - { - handler(this, e); - } - finally - { - _busy = false; - } - } - } -#endif -#if HAVE_INOTIFY_COLLECTION_CHANGED - /// - /// Raises the event. - /// - /// The instance containing the event data. - protected virtual void OnCollectionChanged(NotifyCollectionChangedEventArgs e) - { - NotifyCollectionChangedEventHandler? handler = _collectionChanged; - - if (handler != null) - { - _busy = true; - try - { - handler(this, e); - } - finally - { - _busy = false; - } - } - } -#endif - - /// - /// Gets a value indicating whether this token has child tokens. - /// - /// - /// true if this token has child values; otherwise, false. - /// - public override bool HasValues => ChildrenTokens.Count > 0; - - internal bool ContentsEqual(JContainer container) - { - if (container == this) - { - return true; - } - - IList t1 = ChildrenTokens; - IList t2 = container.ChildrenTokens; - - if (t1.Count != t2.Count) - { - return false; - } - - for (int i = 0; i < t1.Count; i++) - { - if (!t1[i].DeepEquals(t2[i])) - { - return false; - } - } - - return true; - } - - /// - /// Get the first child token of this token. - /// - /// - /// A containing the first child token of the . - /// - public override JToken? First - { - get - { - IList children = ChildrenTokens; - return (children.Count > 0) ? children[0] : null; - } - } - - /// - /// Get the last child token of this token. - /// - /// - /// A containing the last child token of the . - /// - public override JToken? Last - { - get - { - IList children = ChildrenTokens; - int count = children.Count; - return (count > 0) ? children[count - 1] : null; - } - } - - /// - /// Returns a collection of the child tokens of this token, in document order. - /// - /// - /// An of containing the child tokens of this , in document order. - /// - public override JEnumerable Children() - { - return new JEnumerable(ChildrenTokens); - } - - /// - /// Returns a collection of the child values of this token, in document order. - /// - /// The type to convert the values to. - /// - /// A containing the child values of this , in document order. - /// - public override IEnumerable Values() where T : default - { - return ChildrenTokens.Convert(); - } - - /// - /// Returns a collection of the descendant tokens for this token in document order. - /// - /// An of containing the descendant tokens of the . - public IEnumerable Descendants() - { - return GetDescendants(false); - } - - /// - /// Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - /// - /// An of containing this token, and all the descendant tokens of the . - public IEnumerable DescendantsAndSelf() - { - return GetDescendants(true); - } - - internal IEnumerable GetDescendants(bool self) - { - if (self) - { - yield return this; - } - - foreach (JToken o in ChildrenTokens) - { - yield return o; - if (o is JContainer c) - { - foreach (JToken d in c.Descendants()) - { - yield return d; - } - } - } - } - - internal bool IsMultiContent([NotNullWhen(true)]object? content) - { - return (content is IEnumerable && !(content is string) && !(content is JToken) && !(content is byte[])); - } - - internal JToken EnsureParentToken(JToken? item, bool skipParentCheck) - { - if (item == null) - { - return JValue.CreateNull(); - } - - if (skipParentCheck) - { - return item; - } - - // to avoid a token having multiple parents or creating a recursive loop, create a copy if... - // the item already has a parent - // the item is being added to itself - // the item is being added to the root parent of itself - if (item.Parent != null || item == this || (item.HasValues && Root == item)) - { - item = item.CloneToken(); - } - - return item; - } - - internal abstract int IndexOfItem(JToken? item); - - internal virtual bool InsertItem(int index, JToken? item, bool skipParentCheck) - { - IList children = ChildrenTokens; - - if (index > children.Count) - { - throw new ArgumentOutOfRangeException(nameof(index), "Index must be within the bounds of the List."); - } - - CheckReentrancy(); - - item = EnsureParentToken(item, skipParentCheck); - - JToken? previous = (index == 0) ? null : children[index - 1]; - // haven't inserted new token yet so next token is still at the inserting index - JToken? next = (index == children.Count) ? null : children[index]; - - ValidateToken(item, null); - - item.Parent = this; - - item.Previous = previous; - if (previous != null) - { - previous.Next = item; - } - - item.Next = next; - if (next != null) - { - next.Previous = item; - } - - children.Insert(index, item); - -#if HAVE_COMPONENT_MODEL - if (_listChanged != null) - { - OnListChanged(new ListChangedEventArgs(ListChangedType.ItemAdded, index)); - } -#endif -#if HAVE_INOTIFY_COLLECTION_CHANGED - if (_collectionChanged != null) - { - OnCollectionChanged(new NotifyCollectionChangedEventArgs(NotifyCollectionChangedAction.Add, item, index)); - } -#endif - - return true; - } - - internal virtual void RemoveItemAt(int index) - { - IList children = ChildrenTokens; - - if (index < 0) - { - throw new ArgumentOutOfRangeException(nameof(index), "Index is less than 0."); - } - if (index >= children.Count) - { - throw new ArgumentOutOfRangeException(nameof(index), "Index is equal to or greater than Count."); - } - - CheckReentrancy(); - - JToken item = children[index]; - JToken? previous = (index == 0) ? null : children[index - 1]; - JToken? next = (index == children.Count - 1) ? null : children[index + 1]; - - if (previous != null) - { - previous.Next = next; - } - if (next != null) - { - next.Previous = previous; - } - - item.Parent = null; - item.Previous = null; - item.Next = null; - - children.RemoveAt(index); - -#if HAVE_COMPONENT_MODEL - if (_listChanged != null) - { - OnListChanged(new ListChangedEventArgs(ListChangedType.ItemDeleted, index)); - } -#endif -#if HAVE_INOTIFY_COLLECTION_CHANGED - if (_collectionChanged != null) - { - OnCollectionChanged(new NotifyCollectionChangedEventArgs(NotifyCollectionChangedAction.Remove, item, index)); - } -#endif - } - - internal virtual bool RemoveItem(JToken? item) - { - if (item != null) - { - int index = IndexOfItem(item); - if (index >= 0) - { - RemoveItemAt(index); - return true; - } - } - - return false; - } - - internal virtual JToken GetItem(int index) - { - return ChildrenTokens[index]; - } - - internal virtual void SetItem(int index, JToken? item) - { - IList children = ChildrenTokens; - - if (index < 0) - { - throw new ArgumentOutOfRangeException(nameof(index), "Index is less than 0."); - } - if (index >= children.Count) - { - throw new ArgumentOutOfRangeException(nameof(index), "Index is equal to or greater than Count."); - } - - JToken existing = children[index]; - - if (IsTokenUnchanged(existing, item)) - { - return; - } - - CheckReentrancy(); - - item = EnsureParentToken(item, false); - - ValidateToken(item, existing); - - JToken? previous = (index == 0) ? null : children[index - 1]; - JToken? next = (index == children.Count - 1) ? null : children[index + 1]; - - item.Parent = this; - - item.Previous = previous; - if (previous != null) - { - previous.Next = item; - } - - item.Next = next; - if (next != null) - { - next.Previous = item; - } - - children[index] = item; - - existing.Parent = null; - existing.Previous = null; - existing.Next = null; - -#if HAVE_COMPONENT_MODEL - if (_listChanged != null) - { - OnListChanged(new ListChangedEventArgs(ListChangedType.ItemChanged, index)); - } -#endif -#if HAVE_INOTIFY_COLLECTION_CHANGED - if (_collectionChanged != null) - { - OnCollectionChanged(new NotifyCollectionChangedEventArgs(NotifyCollectionChangedAction.Replace, item, existing, index)); - } -#endif - } - - internal virtual void ClearItems() - { - CheckReentrancy(); - - IList children = ChildrenTokens; - - foreach (JToken item in children) - { - item.Parent = null; - item.Previous = null; - item.Next = null; - } - - children.Clear(); - -#if HAVE_COMPONENT_MODEL - if (_listChanged != null) - { - OnListChanged(new ListChangedEventArgs(ListChangedType.Reset, -1)); - } -#endif -#if HAVE_INOTIFY_COLLECTION_CHANGED - if (_collectionChanged != null) - { - OnCollectionChanged(new NotifyCollectionChangedEventArgs(NotifyCollectionChangedAction.Reset)); - } -#endif - } - - internal virtual void ReplaceItem(JToken existing, JToken replacement) - { - if (existing == null || existing.Parent != this) - { - return; - } - - int index = IndexOfItem(existing); - SetItem(index, replacement); - } - - internal virtual bool ContainsItem(JToken? item) - { - return (IndexOfItem(item) != -1); - } - - internal virtual void CopyItemsTo(Array array, int arrayIndex) - { - if (array == null) - { - throw new ArgumentNullException(nameof(array)); - } - if (arrayIndex < 0) - { - throw new ArgumentOutOfRangeException(nameof(arrayIndex), "arrayIndex is less than 0."); - } - if (arrayIndex >= array.Length && arrayIndex != 0) - { - throw new ArgumentException("arrayIndex is equal to or greater than the length of array."); - } - if (Count > array.Length - arrayIndex) - { - throw new ArgumentException("The number of elements in the source JObject is greater than the available space from arrayIndex to the end of the destination array."); - } - - int index = 0; - foreach (JToken token in ChildrenTokens) - { - array.SetValue(token, arrayIndex + index); - index++; - } - } - - internal static bool IsTokenUnchanged(JToken currentValue, JToken? newValue) - { - if (currentValue is JValue v1) - { - if (newValue == null) - { - // null will get turned into a JValue of type null - return v1.Type == JTokenType.Null; - } - - return v1.Equals(newValue); - } - - return false; - } - - internal virtual void ValidateToken(JToken o, JToken? existing) - { - ValidationUtils.ArgumentNotNull(o, nameof(o)); - - if (o.Type == JTokenType.Property) - { - throw new ArgumentException("Can not add {0} to {1}.".FormatWith(CultureInfo.InvariantCulture, o.GetType(), GetType())); - } - } - - /// - /// Adds the specified content as children of this . - /// - /// The content to be added. - public virtual void Add(object? content) - { - TryAddInternal(ChildrenTokens.Count, content, false); - } - - internal bool TryAdd(object? content) - { - return TryAddInternal(ChildrenTokens.Count, content, false); - } - - internal void AddAndSkipParentCheck(JToken token) - { - TryAddInternal(ChildrenTokens.Count, token, true); - } - - /// - /// Adds the specified content as the first children of this . - /// - /// The content to be added. - public void AddFirst(object? content) - { - TryAddInternal(0, content, false); - } - - internal bool TryAddInternal(int index, object? content, bool skipParentCheck) - { - if (IsMultiContent(content)) - { - IEnumerable enumerable = (IEnumerable)content; - - int multiIndex = index; - foreach (object c in enumerable) - { - TryAddInternal(multiIndex, c, skipParentCheck); - multiIndex++; - } - - return true; - } - else - { - JToken item = CreateFromContent(content); - - return InsertItem(index, item, skipParentCheck); - } - } - - internal static JToken CreateFromContent(object? content) - { - if (content is JToken token) - { - return token; - } - - return new JValue(content); - } - - /// - /// Creates a that can be used to add tokens to the . - /// - /// A that is ready to have content written to it. - public JsonWriter CreateWriter() - { - return new JTokenWriter(this); - } - - /// - /// Replaces the child nodes of this token with the specified content. - /// - /// The content. - public void ReplaceAll(object content) - { - ClearItems(); - Add(content); - } - - /// - /// Removes the child nodes from this token. - /// - public void RemoveAll() - { - ClearItems(); - } - - internal abstract void MergeItem(object content, JsonMergeSettings? settings); - - /// - /// Merge the specified content into this . - /// - /// The content to be merged. - public void Merge(object? content) - { - if (content == null) - { - return; - } - - ValidateContent(content); - MergeItem(content, null); - } - - /// - /// Merge the specified content into this using . - /// - /// The content to be merged. - /// The used to merge the content. - public void Merge(object? content, JsonMergeSettings? settings) - { - if (content == null) - { - return; - } - - ValidateContent(content); - MergeItem(content, settings); - } - - private void ValidateContent(object content) - { - if (content.GetType().IsSubclassOf(typeof(JToken))) - { - return; - } - if (IsMultiContent(content)) - { - return; - } - - throw new ArgumentException("Could not determine JSON object type for type {0}.".FormatWith(CultureInfo.InvariantCulture, content.GetType()), nameof(content)); - } - - internal void ReadTokenFrom(JsonReader reader, JsonLoadSettings? options) - { - int startDepth = reader.Depth; - - if (!reader.Read()) - { - throw JsonReaderException.Create(reader, "Error reading {0} from JsonReader.".FormatWith(CultureInfo.InvariantCulture, GetType().Name)); - } - - ReadContentFrom(reader, options); - - int endDepth = reader.Depth; - - if (endDepth > startDepth) - { - throw JsonReaderException.Create(reader, "Unexpected end of content while loading {0}.".FormatWith(CultureInfo.InvariantCulture, GetType().Name)); - } - } - - internal void ReadContentFrom(JsonReader r, JsonLoadSettings? settings) - { - ValidationUtils.ArgumentNotNull(r, nameof(r)); - IJsonLineInfo? lineInfo = r as IJsonLineInfo; - - JContainer? parent = this; - - do - { - if (parent is JProperty p && p.Value != null) - { - if (parent == this) - { - return; - } - - parent = parent.Parent; - } - - MiscellaneousUtils.Assert(parent != null); - - switch (r.TokenType) - { - case JsonToken.None: - // new reader. move to actual content - break; - case JsonToken.StartArray: - JArray a = new JArray(); - a.SetLineInfo(lineInfo, settings); - parent.Add(a); - parent = a; - break; - - case JsonToken.EndArray: - if (parent == this) - { - return; - } - - parent = parent.Parent; - break; - case JsonToken.StartObject: - JObject o = new JObject(); - o.SetLineInfo(lineInfo, settings); - parent.Add(o); - parent = o; - break; - case JsonToken.EndObject: - if (parent == this) - { - return; - } - - parent = parent.Parent; - break; - case JsonToken.StartConstructor: - JConstructor constructor = new JConstructor(r.Value!.ToString()); - constructor.SetLineInfo(lineInfo, settings); - parent.Add(constructor); - parent = constructor; - break; - case JsonToken.EndConstructor: - if (parent == this) - { - return; - } - - parent = parent.Parent; - break; - case JsonToken.String: - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.Date: - case JsonToken.Boolean: - case JsonToken.Bytes: - JValue v = new JValue(r.Value); - v.SetLineInfo(lineInfo, settings); - parent.Add(v); - break; - case JsonToken.Comment: - if (settings != null && settings.CommentHandling == CommentHandling.Load) - { - v = JValue.CreateComment(r.Value!.ToString()); - v.SetLineInfo(lineInfo, settings); - parent.Add(v); - } - break; - case JsonToken.Null: - v = JValue.CreateNull(); - v.SetLineInfo(lineInfo, settings); - parent.Add(v); - break; - case JsonToken.Undefined: - v = JValue.CreateUndefined(); - v.SetLineInfo(lineInfo, settings); - parent.Add(v); - break; - case JsonToken.PropertyName: - JProperty? property = ReadProperty(r, settings, lineInfo, parent); - if (property != null) - { - parent = property; - } - else - { - r.Skip(); - } - break; - default: - throw new InvalidOperationException("The JsonReader should not be on a token of type {0}.".FormatWith(CultureInfo.InvariantCulture, r.TokenType)); - } - } while (r.Read()); - } - - private static JProperty? ReadProperty(JsonReader r, JsonLoadSettings? settings, IJsonLineInfo? lineInfo, JContainer parent) - { - DuplicatePropertyNameHandling duplicatePropertyNameHandling = settings?.DuplicatePropertyNameHandling ?? DuplicatePropertyNameHandling.Replace; - - JObject parentObject = (JObject)parent; - string propertyName = r.Value!.ToString(); - JProperty? existingPropertyWithName = parentObject.Property(propertyName, StringComparison.Ordinal); - if (existingPropertyWithName != null) - { - if (duplicatePropertyNameHandling == DuplicatePropertyNameHandling.Ignore) - { - return null; - } - else if (duplicatePropertyNameHandling == DuplicatePropertyNameHandling.Error) - { - throw JsonReaderException.Create(r, "Property with the name '{0}' already exists in the current JSON object.".FormatWith(CultureInfo.InvariantCulture, propertyName)); - } - } - - JProperty property = new JProperty(propertyName); - property.SetLineInfo(lineInfo, settings); - // handle multiple properties with the same name in JSON - if (existingPropertyWithName == null) - { - parent.Add(property); - } - else - { - existingPropertyWithName.Replace(property); - } - - return property; - } - - internal int ContentsHashCode() - { - int hashCode = 0; - foreach (JToken item in ChildrenTokens) - { - hashCode ^= item.GetDeepHashCode(); - } - return hashCode; - } - -#if HAVE_COMPONENT_MODEL - string ITypedList.GetListName(PropertyDescriptor[] listAccessors) - { - return string.Empty; - } - - PropertyDescriptorCollection? ITypedList.GetItemProperties(PropertyDescriptor[] listAccessors) - { - ICustomTypeDescriptor? d = First as ICustomTypeDescriptor; - return d?.GetProperties(); - } -#endif - - #region IList Members - int IList.IndexOf(JToken item) - { - return IndexOfItem(item); - } - - void IList.Insert(int index, JToken item) - { - InsertItem(index, item, false); - } - - void IList.RemoveAt(int index) - { - RemoveItemAt(index); - } - - JToken IList.this[int index] - { - get => GetItem(index); - set => SetItem(index, value); - } - #endregion - - #region ICollection Members - void ICollection.Add(JToken item) - { - Add(item); - } - - void ICollection.Clear() - { - ClearItems(); - } - - bool ICollection.Contains(JToken item) - { - return ContainsItem(item); - } - - void ICollection.CopyTo(JToken[] array, int arrayIndex) - { - CopyItemsTo(array, arrayIndex); - } - - bool ICollection.IsReadOnly => false; - - bool ICollection.Remove(JToken item) - { - return RemoveItem(item); - } - #endregion - - private JToken? EnsureValue(object value) - { - if (value == null) - { - return null; - } - - if (value is JToken token) - { - return token; - } - - throw new ArgumentException("Argument is not a JToken."); - } - - #region IList Members - int IList.Add(object value) - { - Add(EnsureValue(value)); - return Count - 1; - } - - void IList.Clear() - { - ClearItems(); - } - - bool IList.Contains(object value) - { - return ContainsItem(EnsureValue(value)); - } - - int IList.IndexOf(object value) - { - return IndexOfItem(EnsureValue(value)); - } - - void IList.Insert(int index, object value) - { - InsertItem(index, EnsureValue(value), false); - } - - bool IList.IsFixedSize => false; - - bool IList.IsReadOnly => false; - - void IList.Remove(object value) - { - RemoveItem(EnsureValue(value)); - } - - void IList.RemoveAt(int index) - { - RemoveItemAt(index); - } - - object IList.this[int index] - { - get => GetItem(index); - set => SetItem(index, EnsureValue(value)); - } - #endregion - - #region ICollection Members - void ICollection.CopyTo(Array array, int index) - { - CopyItemsTo(array, index); - } - - /// - /// Gets the count of child JSON tokens. - /// - /// The count of child JSON tokens. - public int Count => ChildrenTokens.Count; - - bool ICollection.IsSynchronized => false; - - object ICollection.SyncRoot - { - get - { - if (_syncRoot == null) - { - Interlocked.CompareExchange(ref _syncRoot, new object(), null); - } - - return _syncRoot; - } - } - #endregion - - #region IBindingList Members -#if HAVE_COMPONENT_MODEL - void IBindingList.AddIndex(PropertyDescriptor property) - { - } - - object IBindingList.AddNew() - { - AddingNewEventArgs args = new AddingNewEventArgs(); - OnAddingNew(args); - - if (args.NewObject == null) - { - throw new JsonException("Could not determine new value to add to '{0}'.".FormatWith(CultureInfo.InvariantCulture, GetType())); - } - - if (!(args.NewObject is JToken newItem)) - { - throw new JsonException("New item to be added to collection must be compatible with {0}.".FormatWith(CultureInfo.InvariantCulture, typeof(JToken))); - } - - Add(newItem); - - return newItem; - } - - bool IBindingList.AllowEdit => true; - - bool IBindingList.AllowNew => true; - - bool IBindingList.AllowRemove => true; - - void IBindingList.ApplySort(PropertyDescriptor property, ListSortDirection direction) - { - throw new NotSupportedException(); - } - - int IBindingList.Find(PropertyDescriptor property, object key) - { - throw new NotSupportedException(); - } - - bool IBindingList.IsSorted => false; - - void IBindingList.RemoveIndex(PropertyDescriptor property) - { - } - - void IBindingList.RemoveSort() - { - throw new NotSupportedException(); - } - - ListSortDirection IBindingList.SortDirection => ListSortDirection.Ascending; - - PropertyDescriptor? IBindingList.SortProperty => null; - - bool IBindingList.SupportsChangeNotification => true; - - bool IBindingList.SupportsSearching => false; - - bool IBindingList.SupportsSorting => false; -#endif - #endregion - - internal static void MergeEnumerableContent(JContainer target, IEnumerable content, JsonMergeSettings? settings) - { - switch (settings?.MergeArrayHandling ?? MergeArrayHandling.Concat) - { - case MergeArrayHandling.Concat: - foreach (object item in content) - { - target.Add(CreateFromContent(item)); - } - break; - case MergeArrayHandling.Union: -#if HAVE_HASH_SET - HashSet items = new HashSet(target, EqualityComparer); - - foreach (object item in content) - { - JToken contentItem = CreateFromContent(item); - - if (items.Add(contentItem)) - { - target.Add(contentItem); - } - } -#else - Dictionary items = new Dictionary(EqualityComparer); - foreach (JToken t in target) - { - items[t] = true; - } - - foreach (object item in content) - { - JToken contentItem = CreateFromContent(item); - - if (!items.ContainsKey(contentItem)) - { - items[contentItem] = true; - target.Add(contentItem); - } - } -#endif - break; - case MergeArrayHandling.Replace: - if (target == content) - { - break; - } - target.ClearItems(); - foreach (object item in content) - { - target.Add(CreateFromContent(item)); - } - break; - case MergeArrayHandling.Merge: - int i = 0; - foreach (object targetItem in content) - { - if (i < target.Count) - { - JToken? sourceItem = target[i]; - - if (sourceItem is JContainer existingContainer) - { - existingContainer.Merge(targetItem, settings); - } - else - { - if (targetItem != null) - { - JToken contentValue = CreateFromContent(targetItem); - if (contentValue.Type != JTokenType.Null) - { - target[i] = contentValue; - } - } - } - } - else - { - target.Add(CreateFromContent(targetItem)); - } - - i++; - } - break; - default: - throw new ArgumentOutOfRangeException(nameof(settings), "Unexpected merge array handling when merging JSON."); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JEnumerable.cs b/Source/MyDb/Newtonsoft.Json/Linq/JEnumerable.cs deleted file mode 100644 index 541f1be..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JEnumerable.cs +++ /dev/null @@ -1,140 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using Newtonsoft.Json.Utilities; -using System.Collections; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a collection of objects. - /// - /// The type of token. - public readonly struct JEnumerable : IJEnumerable, IEquatable> where T : JToken - { - /// - /// An empty collection of objects. - /// - public static readonly JEnumerable Empty = new JEnumerable(Enumerable.Empty()); - - private readonly IEnumerable _enumerable; - - /// - /// Initializes a new instance of the struct. - /// - /// The enumerable. - public JEnumerable(IEnumerable enumerable) - { - ValidationUtils.ArgumentNotNull(enumerable, nameof(enumerable)); - - _enumerable = enumerable; - } - - /// - /// Returns an enumerator that can be used to iterate through the collection. - /// - /// - /// A that can be used to iterate through the collection. - /// - public IEnumerator GetEnumerator() - { - return (_enumerable ?? Empty).GetEnumerator(); - } - - IEnumerator IEnumerable.GetEnumerator() - { - return GetEnumerator(); - } - - /// - /// Gets the of with the specified key. - /// - /// - public IJEnumerable this[object key] - { - get - { - if (_enumerable == null) - { - return JEnumerable.Empty; - } - - return new JEnumerable(_enumerable.Values(key)!); - } - } - - /// - /// Determines whether the specified is equal to this instance. - /// - /// The to compare with this instance. - /// - /// true if the specified is equal to this instance; otherwise, false. - /// - public bool Equals(JEnumerable other) - { - return Equals(_enumerable, other._enumerable); - } - - /// - /// Determines whether the specified is equal to this instance. - /// - /// The to compare with this instance. - /// - /// true if the specified is equal to this instance; otherwise, false. - /// - public override bool Equals(object obj) - { - if (obj is JEnumerable enumerable) - { - return Equals(enumerable); - } - - return false; - } - - /// - /// Returns a hash code for this instance. - /// - /// - /// A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table. - /// - public override int GetHashCode() - { - if (_enumerable == null) - { - return 0; - } - - return _enumerable.GetHashCode(); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JObject.Async.cs b/Source/MyDb/Newtonsoft.Json/Linq/JObject.Async.cs deleted file mode 100644 index d973e8b..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JObject.Async.cs +++ /dev/null @@ -1,129 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System; -using System.Globalization; -using System.Threading; -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - public partial class JObject - { - /// - /// Writes this token to a asynchronously. - /// - /// A into which this method will write. - /// The token to monitor for cancellation requests. - /// A collection of which will be used when writing the token. - /// A that represents the asynchronous write operation. - public override Task WriteToAsync(JsonWriter writer, CancellationToken cancellationToken, params JsonConverter[] converters) - { - Task t = writer.WriteStartObjectAsync(cancellationToken); - if (!t.IsCompletedSucessfully()) - { - return AwaitProperties(t, 0, writer, cancellationToken, converters); - } - - for (int i = 0; i < _properties.Count; i++) - { - t = _properties[i].WriteToAsync(writer, cancellationToken, converters); - if (!t.IsCompletedSucessfully()) - { - return AwaitProperties(t, i + 1, writer, cancellationToken, converters); - } - } - - return writer.WriteEndObjectAsync(cancellationToken); - - // Local functions, params renamed (capitalized) so as not to capture and allocate when calling async - async Task AwaitProperties(Task task, int i, JsonWriter Writer, CancellationToken CancellationToken, JsonConverter[] Converters) - { - await task.ConfigureAwait(false); - for (; i < _properties.Count; i++) - { - await _properties[i].WriteToAsync(Writer, CancellationToken, Converters).ConfigureAwait(false); - } - - await Writer.WriteEndObjectAsync(CancellationToken).ConfigureAwait(false); - } - } - - /// - /// Asynchronously loads a from a . - /// - /// A that will be read for the content of the . - /// The token to monitor for cancellation requests. The default value is . - /// - /// A that represents the asynchronous load. The - /// property returns a that contains the JSON that was read from the specified . - public new static Task LoadAsync(JsonReader reader, CancellationToken cancellationToken = default) - { - return LoadAsync(reader, null, cancellationToken); - } - - /// - /// Asynchronously loads a from a . - /// - /// A that will be read for the content of the . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// The token to monitor for cancellation requests. The default value is . - /// - /// A that represents the asynchronous load. The - /// property returns a that contains the JSON that was read from the specified . - public new static async Task LoadAsync(JsonReader reader, JsonLoadSettings? settings, CancellationToken cancellationToken = default) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - - if (reader.TokenType == JsonToken.None) - { - if (!await reader.ReadAsync(cancellationToken).ConfigureAwait(false)) - { - throw JsonReaderException.Create(reader, "Error reading JObject from JsonReader."); - } - } - - await reader.MoveToContentAsync(cancellationToken).ConfigureAwait(false); - - if (reader.TokenType != JsonToken.StartObject) - { - throw JsonReaderException.Create(reader, "Error reading JObject from JsonReader. Current JsonReader item is not an object: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - JObject o = new JObject(); - o.SetLineInfo(reader as IJsonLineInfo, settings); - - await o.ReadTokenFromAsync(reader, settings, cancellationToken).ConfigureAwait(false); - - return o; - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JObject.cs b/Source/MyDb/Newtonsoft.Json/Linq/JObject.cs deleted file mode 100644 index 371a951..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JObject.cs +++ /dev/null @@ -1,857 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -#if HAVE_INOTIFY_COLLECTION_CHANGED -using System.Collections.ObjectModel; -using System.Collections.Specialized; -#endif -using System.ComponentModel; -#if HAVE_DYNAMIC -using System.Dynamic; -using System.Linq.Expressions; -#endif -using System.IO; -using Newtonsoft.Json.Utilities; -using System.Globalization; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a JSON object. - /// - /// - /// - /// - public partial class JObject : JContainer, IDictionary, INotifyPropertyChanged -#if HAVE_COMPONENT_MODEL - , ICustomTypeDescriptor -#endif -#if HAVE_INOTIFY_PROPERTY_CHANGING - , INotifyPropertyChanging -#endif - { - private readonly JPropertyKeyedCollection _properties = new JPropertyKeyedCollection(); - - /// - /// Gets the container's children tokens. - /// - /// The container's children tokens. - protected override IList ChildrenTokens => _properties; - - /// - /// Occurs when a property value changes. - /// - public event PropertyChangedEventHandler? PropertyChanged; - -#if HAVE_INOTIFY_PROPERTY_CHANGING - /// - /// Occurs when a property value is changing. - /// - public event PropertyChangingEventHandler? PropertyChanging; -#endif - - /// - /// Initializes a new instance of the class. - /// - public JObject() - { - } - - /// - /// Initializes a new instance of the class from another object. - /// - /// A object to copy from. - public JObject(JObject other) - : base(other) - { - } - - /// - /// Initializes a new instance of the class with the specified content. - /// - /// The contents of the object. - public JObject(params object[] content) - : this((object)content) - { - } - - /// - /// Initializes a new instance of the class with the specified content. - /// - /// The contents of the object. - public JObject(object content) - { - Add(content); - } - - internal override bool DeepEquals(JToken node) - { - if (!(node is JObject t)) - { - return false; - } - - return _properties.Compare(t._properties); - } - - internal override int IndexOfItem(JToken? item) - { - if (item == null) - { - return -1; - } - - return _properties.IndexOfReference(item); - } - - internal override bool InsertItem(int index, JToken? item, bool skipParentCheck) - { - // don't add comments to JObject, no name to reference comment by - if (item != null && item.Type == JTokenType.Comment) - { - return false; - } - - return base.InsertItem(index, item, skipParentCheck); - } - - internal override void ValidateToken(JToken o, JToken? existing) - { - ValidationUtils.ArgumentNotNull(o, nameof(o)); - - if (o.Type != JTokenType.Property) - { - throw new ArgumentException("Can not add {0} to {1}.".FormatWith(CultureInfo.InvariantCulture, o.GetType(), GetType())); - } - - JProperty newProperty = (JProperty)o; - - if (existing != null) - { - JProperty existingProperty = (JProperty)existing; - - if (newProperty.Name == existingProperty.Name) - { - return; - } - } - - if (_properties.TryGetValue(newProperty.Name, out existing)) - { - throw new ArgumentException("Can not add property {0} to {1}. Property with the same name already exists on object.".FormatWith(CultureInfo.InvariantCulture, newProperty.Name, GetType())); - } - } - - internal override void MergeItem(object content, JsonMergeSettings? settings) - { - if (!(content is JObject o)) - { - return; - } - - foreach (KeyValuePair contentItem in o) - { - JProperty? existingProperty = Property(contentItem.Key, settings?.PropertyNameComparison ?? StringComparison.Ordinal); - - if (existingProperty == null) - { - Add(contentItem.Key, contentItem.Value); - } - else if (contentItem.Value != null) - { - if (!(existingProperty.Value is JContainer existingContainer) || existingContainer.Type != contentItem.Value.Type) - { - if (!IsNull(contentItem.Value) || settings?.MergeNullValueHandling == MergeNullValueHandling.Merge) - { - existingProperty.Value = contentItem.Value; - } - } - else - { - existingContainer.Merge(contentItem.Value, settings); - } - } - } - } - - private static bool IsNull(JToken token) - { - if (token.Type == JTokenType.Null) - { - return true; - } - - if (token is JValue v && v.Value == null) - { - return true; - } - - return false; - } - - internal void InternalPropertyChanged(JProperty childProperty) - { - OnPropertyChanged(childProperty.Name); -#if HAVE_COMPONENT_MODEL - if (_listChanged != null) - { - OnListChanged(new ListChangedEventArgs(ListChangedType.ItemChanged, IndexOfItem(childProperty))); - } -#endif -#if HAVE_INOTIFY_COLLECTION_CHANGED - if (_collectionChanged != null) - { - OnCollectionChanged(new NotifyCollectionChangedEventArgs(NotifyCollectionChangedAction.Replace, childProperty, childProperty, IndexOfItem(childProperty))); - } -#endif - } - - internal void InternalPropertyChanging(JProperty childProperty) - { -#if HAVE_INOTIFY_PROPERTY_CHANGING - OnPropertyChanging(childProperty.Name); -#endif - } - - internal override JToken CloneToken() - { - return new JObject(this); - } - - /// - /// Gets the node type for this . - /// - /// The type. - public override JTokenType Type => JTokenType.Object; - - /// - /// Gets an of of this object's properties. - /// - /// An of of this object's properties. - public IEnumerable Properties() - { - return _properties.Cast(); - } - - /// - /// Gets a with the specified name. - /// - /// The property name. - /// A with the specified name or null. - public JProperty? Property(string name) - { - return Property(name, StringComparison.Ordinal); - } - - /// - /// Gets the with the specified name. - /// The exact name will be searched for first and if no matching property is found then - /// the will be used to match a property. - /// - /// The property name. - /// One of the enumeration values that specifies how the strings will be compared. - /// A matched with the specified name or null. - public JProperty? Property(string name, StringComparison comparison) - { - if (name == null) - { - return null; - } - - if (_properties.TryGetValue(name, out JToken? property)) - { - return (JProperty)property; - } - - // test above already uses this comparison so no need to repeat - if (comparison != StringComparison.Ordinal) - { - for (int i = 0; i < _properties.Count; i++) - { - JProperty p = (JProperty)_properties[i]; - if (string.Equals(p.Name, name, comparison)) - { - return p; - } - } - } - - return null; - } - - /// - /// Gets a of of this object's property values. - /// - /// A of of this object's property values. - public JEnumerable PropertyValues() - { - return new JEnumerable(Properties().Select(p => p.Value)); - } - - /// - /// Gets the with the specified key. - /// - /// The with the specified key. - public override JToken? this[object key] - { - get - { - ValidationUtils.ArgumentNotNull(key, nameof(key)); - - if (!(key is string propertyName)) - { - throw new ArgumentException("Accessed JObject values with invalid key value: {0}. Object property name expected.".FormatWith(CultureInfo.InvariantCulture, MiscellaneousUtils.ToString(key))); - } - - return this[propertyName]; - } - set - { - ValidationUtils.ArgumentNotNull(key, nameof(key)); - - if (!(key is string propertyName)) - { - throw new ArgumentException("Set JObject values with invalid key value: {0}. Object property name expected.".FormatWith(CultureInfo.InvariantCulture, MiscellaneousUtils.ToString(key))); - } - - this[propertyName] = value; - } - } - - /// - /// Gets or sets the with the specified property name. - /// - /// - public JToken? this[string propertyName] - { - get - { - ValidationUtils.ArgumentNotNull(propertyName, nameof(propertyName)); - - JProperty? property = Property(propertyName, StringComparison.Ordinal); - - return property?.Value; - } - set - { - JProperty? property = Property(propertyName, StringComparison.Ordinal); - if (property != null) - { - property.Value = value!; - } - else - { -#if HAVE_INOTIFY_PROPERTY_CHANGING - OnPropertyChanging(propertyName); -#endif - Add(propertyName, value); - OnPropertyChanged(propertyName); - } - } - } - - /// - /// Loads a from a . - /// - /// A that will be read for the content of the . - /// A that contains the JSON that was read from the specified . - /// - /// is not valid JSON. - /// - public new static JObject Load(JsonReader reader) - { - return Load(reader, null); - } - - /// - /// Loads a from a . - /// - /// A that will be read for the content of the . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// A that contains the JSON that was read from the specified . - /// - /// is not valid JSON. - /// - public new static JObject Load(JsonReader reader, JsonLoadSettings? settings) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - - if (reader.TokenType == JsonToken.None) - { - if (!reader.Read()) - { - throw JsonReaderException.Create(reader, "Error reading JObject from JsonReader."); - } - } - - reader.MoveToContent(); - - if (reader.TokenType != JsonToken.StartObject) - { - throw JsonReaderException.Create(reader, "Error reading JObject from JsonReader. Current JsonReader item is not an object: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - JObject o = new JObject(); - o.SetLineInfo(reader as IJsonLineInfo, settings); - - o.ReadTokenFrom(reader, settings); - - return o; - } - - /// - /// Load a from a string that contains JSON. - /// - /// A that contains JSON. - /// A populated from the string that contains JSON. - /// - /// is not valid JSON. - /// - /// - /// - /// - public new static JObject Parse(string json) - { - return Parse(json, null); - } - - /// - /// Load a from a string that contains JSON. - /// - /// A that contains JSON. - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// A populated from the string that contains JSON. - /// - /// is not valid JSON. - /// - /// - /// - /// - public new static JObject Parse(string json, JsonLoadSettings? settings) - { - using (JsonReader reader = new JsonTextReader(new StringReader(json))) - { - JObject o = Load(reader, settings); - - while (reader.Read()) - { - // Any content encountered here other than a comment will throw in the reader. - } - - return o; - } - } - - /// - /// Creates a from an object. - /// - /// The object that will be used to create . - /// A with the values of the specified object. - public new static JObject FromObject(object o) - { - return FromObject(o, JsonSerializer.CreateDefault()); - } - - /// - /// Creates a from an object. - /// - /// The object that will be used to create . - /// The that will be used to read the object. - /// A with the values of the specified object. - public new static JObject FromObject(object o, JsonSerializer jsonSerializer) - { - JToken token = FromObjectInternal(o, jsonSerializer); - - if (token.Type != JTokenType.Object) - { - throw new ArgumentException("Object serialized to {0}. JObject instance expected.".FormatWith(CultureInfo.InvariantCulture, token.Type)); - } - - return (JObject)token; - } - - /// - /// Writes this token to a . - /// - /// A into which this method will write. - /// A collection of which will be used when writing the token. - public override void WriteTo(JsonWriter writer, params JsonConverter[] converters) - { - writer.WriteStartObject(); - - for (int i = 0; i < _properties.Count; i++) - { - _properties[i].WriteTo(writer, converters); - } - - writer.WriteEndObject(); - } - - /// - /// Gets the with the specified property name. - /// - /// Name of the property. - /// The with the specified property name. - public JToken? GetValue(string? propertyName) - { - return GetValue(propertyName, StringComparison.Ordinal); - } - - /// - /// Gets the with the specified property name. - /// The exact property name will be searched for first and if no matching property is found then - /// the will be used to match a property. - /// - /// Name of the property. - /// One of the enumeration values that specifies how the strings will be compared. - /// The with the specified property name. - public JToken? GetValue(string? propertyName, StringComparison comparison) - { - if (propertyName == null) - { - return null; - } - - // attempt to get value via dictionary first for performance - var property = Property(propertyName, comparison); - - return property?.Value; - } - - /// - /// Tries to get the with the specified property name. - /// The exact property name will be searched for first and if no matching property is found then - /// the will be used to match a property. - /// - /// Name of the property. - /// The value. - /// One of the enumeration values that specifies how the strings will be compared. - /// true if a value was successfully retrieved; otherwise, false. - public bool TryGetValue(string propertyName, StringComparison comparison, [NotNullWhen(true)]out JToken? value) - { - value = GetValue(propertyName, comparison); - return (value != null); - } - - #region IDictionary Members - /// - /// Adds the specified property name. - /// - /// Name of the property. - /// The value. - public void Add(string propertyName, JToken? value) - { - Add(new JProperty(propertyName, value)); - } - - /// - /// Determines whether the JSON object has the specified property name. - /// - /// Name of the property. - /// true if the JSON object has the specified property name; otherwise, false. - public bool ContainsKey(string propertyName) - { - ValidationUtils.ArgumentNotNull(propertyName, nameof(propertyName)); - - return _properties.Contains(propertyName); - } - - ICollection IDictionary.Keys => _properties.Keys; - - /// - /// Removes the property with the specified name. - /// - /// Name of the property. - /// true if item was successfully removed; otherwise, false. - public bool Remove(string propertyName) - { - JProperty? property = Property(propertyName, StringComparison.Ordinal); - if (property == null) - { - return false; - } - - property.Remove(); - return true; - } - - /// - /// Tries to get the with the specified property name. - /// - /// Name of the property. - /// The value. - /// true if a value was successfully retrieved; otherwise, false. - public bool TryGetValue(string propertyName, [NotNullWhen(true)]out JToken? value) - { - JProperty? property = Property(propertyName, StringComparison.Ordinal); - if (property == null) - { - value = null; - return false; - } - - value = property.Value; - return true; - } - - ICollection IDictionary.Values => throw new NotImplementedException(); - - #endregion - - #region ICollection> Members - void ICollection>.Add(KeyValuePair item) - { - Add(new JProperty(item.Key, item.Value)); - } - - void ICollection>.Clear() - { - RemoveAll(); - } - - bool ICollection>.Contains(KeyValuePair item) - { - JProperty? property = Property(item.Key, StringComparison.Ordinal); - if (property == null) - { - return false; - } - - return (property.Value == item.Value); - } - - void ICollection>.CopyTo(KeyValuePair[] array, int arrayIndex) - { - if (array == null) - { - throw new ArgumentNullException(nameof(array)); - } - if (arrayIndex < 0) - { - throw new ArgumentOutOfRangeException(nameof(arrayIndex), "arrayIndex is less than 0."); - } - if (arrayIndex >= array.Length && arrayIndex != 0) - { - throw new ArgumentException("arrayIndex is equal to or greater than the length of array."); - } - if (Count > array.Length - arrayIndex) - { - throw new ArgumentException("The number of elements in the source JObject is greater than the available space from arrayIndex to the end of the destination array."); - } - - int index = 0; - foreach (JProperty property in _properties) - { - array[arrayIndex + index] = new KeyValuePair(property.Name, property.Value); - index++; - } - } - - bool ICollection>.IsReadOnly => false; - - bool ICollection>.Remove(KeyValuePair item) - { - if (!((ICollection>)this).Contains(item)) - { - return false; - } - - ((IDictionary)this).Remove(item.Key); - return true; - } - #endregion - - internal override int GetDeepHashCode() - { - return ContentsHashCode(); - } - - /// - /// Returns an enumerator that can be used to iterate through the collection. - /// - /// - /// A that can be used to iterate through the collection. - /// - public IEnumerator> GetEnumerator() - { - foreach (JProperty property in _properties) - { - yield return new KeyValuePair(property.Name, property.Value); - } - } - - /// - /// Raises the event with the provided arguments. - /// - /// Name of the property. - protected virtual void OnPropertyChanged(string propertyName) - { - PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName)); - } - -#if HAVE_INOTIFY_PROPERTY_CHANGING - /// - /// Raises the event with the provided arguments. - /// - /// Name of the property. - protected virtual void OnPropertyChanging(string propertyName) - { - PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(propertyName)); - } -#endif - -#if HAVE_COMPONENT_MODEL - // include custom type descriptor on JObject rather than use a provider because the properties are specific to a type - - #region ICustomTypeDescriptor - PropertyDescriptorCollection ICustomTypeDescriptor.GetProperties() - { - return ((ICustomTypeDescriptor)this).GetProperties(null); - } - - PropertyDescriptorCollection ICustomTypeDescriptor.GetProperties(Attribute[] attributes) - { - PropertyDescriptor[] propertiesArray = new PropertyDescriptor[Count]; - int i = 0; - foreach (KeyValuePair propertyValue in this) - { - propertiesArray[i] = new JPropertyDescriptor(propertyValue.Key); - i++; - } - - return new PropertyDescriptorCollection(propertiesArray); - } - - AttributeCollection ICustomTypeDescriptor.GetAttributes() - { - return AttributeCollection.Empty; - } - - string? ICustomTypeDescriptor.GetClassName() - { - return null; - } - - string? ICustomTypeDescriptor.GetComponentName() - { - return null; - } - - TypeConverter ICustomTypeDescriptor.GetConverter() - { - return new TypeConverter(); - } - - EventDescriptor? ICustomTypeDescriptor.GetDefaultEvent() - { - return null; - } - - PropertyDescriptor? ICustomTypeDescriptor.GetDefaultProperty() - { - return null; - } - - object? ICustomTypeDescriptor.GetEditor(Type editorBaseType) - { - return null; - } - - EventDescriptorCollection ICustomTypeDescriptor.GetEvents(Attribute[] attributes) - { - return EventDescriptorCollection.Empty; - } - - EventDescriptorCollection ICustomTypeDescriptor.GetEvents() - { - return EventDescriptorCollection.Empty; - } - - object? ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor pd) - { - if (pd is JPropertyDescriptor) - { - return this; - } - - return null; - } - #endregion - -#endif - -#if HAVE_DYNAMIC - /// - /// Returns the responsible for binding operations performed on this object. - /// - /// The expression tree representation of the runtime value. - /// - /// The to bind this object. - /// - protected override DynamicMetaObject GetMetaObject(Expression parameter) - { - return new DynamicProxyMetaObject(parameter, this, new JObjectDynamicProxy()); - } - - private class JObjectDynamicProxy : DynamicProxy - { - public override bool TryGetMember(JObject instance, GetMemberBinder binder, out object? result) - { - // result can be null - result = instance[binder.Name]; - return true; - } - - public override bool TrySetMember(JObject instance, SetMemberBinder binder, object value) - { - // this can throw an error if value isn't a valid for a JValue - if (!(value is JToken v)) - { - v = new JValue(value); - } - - instance[binder.Name] = v; - return true; - } - - public override IEnumerable GetDynamicMemberNames(JObject instance) - { - return instance.Properties().Select(p => p.Name); - } - } -#endif - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JProperty.Async.cs b/Source/MyDb/Newtonsoft.Json/Linq/JProperty.Async.cs deleted file mode 100644 index dcd7cb3..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JProperty.Async.cs +++ /dev/null @@ -1,118 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System.Globalization; -using System.Threading; -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - public partial class JProperty - { - /// - /// Writes this token to a asynchronously. - /// - /// A into which this method will write. - /// The token to monitor for cancellation requests. - /// A collection of which will be used when writing the token. - /// A that represents the asynchronous write operation. - public override Task WriteToAsync(JsonWriter writer, CancellationToken cancellationToken, params JsonConverter[] converters) - { - Task task = writer.WritePropertyNameAsync(_name, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return WriteValueAsync(writer, cancellationToken, converters); - } - - return WriteToAsync(task, writer, cancellationToken, converters); - } - - private async Task WriteToAsync(Task task, JsonWriter writer, CancellationToken cancellationToken, params JsonConverter[] converters) - { - await task.ConfigureAwait(false); - - await WriteValueAsync(writer, cancellationToken, converters).ConfigureAwait(false); - } - - private Task WriteValueAsync(JsonWriter writer, CancellationToken cancellationToken, JsonConverter[] converters) - { - JToken value = Value; - return value != null - ? value.WriteToAsync(writer, cancellationToken, converters) - : writer.WriteNullAsync(cancellationToken); - } - - /// - /// Asynchronously loads a from a . - /// - /// A that will be read for the content of the . - /// The token to monitor for cancellation requests. The default value is . - /// A representing the asynchronous creation. The - /// property returns a that contains the JSON that was read from the specified . - public new static Task LoadAsync(JsonReader reader, CancellationToken cancellationToken = default) - { - return LoadAsync(reader, null, cancellationToken); - } - - /// - /// Asynchronously loads a from a . - /// - /// A that will be read for the content of the . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// The token to monitor for cancellation requests. The default value is . - /// A representing the asynchronous creation. The - /// property returns a that contains the JSON that was read from the specified . - public new static async Task LoadAsync(JsonReader reader, JsonLoadSettings? settings, CancellationToken cancellationToken = default) - { - if (reader.TokenType == JsonToken.None) - { - if (!await reader.ReadAsync(cancellationToken).ConfigureAwait(false)) - { - throw JsonReaderException.Create(reader, "Error reading JProperty from JsonReader."); - } - } - - await reader.MoveToContentAsync(cancellationToken).ConfigureAwait(false); - - if (reader.TokenType != JsonToken.PropertyName) - { - throw JsonReaderException.Create(reader, "Error reading JProperty from JsonReader. Current JsonReader item is not a property: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - JProperty p = new JProperty((string)reader.Value!); - p.SetLineInfo(reader as IJsonLineInfo, settings); - - await p.ReadTokenFromAsync(reader, settings, cancellationToken).ConfigureAwait(false); - - return p; - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JProperty.cs b/Source/MyDb/Newtonsoft.Json/Linq/JProperty.cs deleted file mode 100644 index b59918d..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JProperty.cs +++ /dev/null @@ -1,401 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using Newtonsoft.Json.Utilities; -using System.Diagnostics; -using System.Globalization; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a JSON property. - /// - public partial class JProperty : JContainer - { - #region JPropertyList - private class JPropertyList : IList - { - internal JToken? _token; - - public IEnumerator GetEnumerator() - { - if (_token != null) - { - yield return _token; - } - } - - IEnumerator IEnumerable.GetEnumerator() - { - return GetEnumerator(); - } - - public void Add(JToken item) - { - _token = item; - } - - public void Clear() - { - _token = null; - } - - public bool Contains(JToken item) - { - return (_token == item); - } - - public void CopyTo(JToken[] array, int arrayIndex) - { - if (_token != null) - { - array[arrayIndex] = _token; - } - } - - public bool Remove(JToken item) - { - if (_token == item) - { - _token = null; - return true; - } - return false; - } - - public int Count => (_token != null) ? 1 : 0; - - public bool IsReadOnly => false; - - public int IndexOf(JToken item) - { - return (_token == item) ? 0 : -1; - } - - public void Insert(int index, JToken item) - { - if (index == 0) - { - _token = item; - } - } - - public void RemoveAt(int index) - { - if (index == 0) - { - _token = null; - } - } - - public JToken this[int index] - { - get - { - if (index != 0) - { - throw new IndexOutOfRangeException(); - } - - MiscellaneousUtils.Assert(_token != null); - return _token; - } - set - { - if (index != 0) - { - throw new IndexOutOfRangeException(); - } - - _token = value; - } - } - } - #endregion - - private readonly JPropertyList _content = new JPropertyList(); - private readonly string _name; - - /// - /// Gets the container's children tokens. - /// - /// The container's children tokens. - protected override IList ChildrenTokens => _content; - - /// - /// Gets the property name. - /// - /// The property name. - public string Name - { - [DebuggerStepThrough] - get { return _name; } - } - - /// - /// Gets or sets the property value. - /// - /// The property value. - public JToken Value - { - [DebuggerStepThrough] - get { return _content._token!; } - set - { - CheckReentrancy(); - - JToken newValue = value ?? JValue.CreateNull(); - - if (_content._token == null) - { - InsertItem(0, newValue, false); - } - else - { - SetItem(0, newValue); - } - } - } - - /// - /// Initializes a new instance of the class from another object. - /// - /// A object to copy from. - public JProperty(JProperty other) - : base(other) - { - _name = other.Name; - } - - internal override JToken GetItem(int index) - { - if (index != 0) - { - throw new ArgumentOutOfRangeException(); - } - - return Value; - } - - internal override void SetItem(int index, JToken? item) - { - if (index != 0) - { - throw new ArgumentOutOfRangeException(); - } - - if (IsTokenUnchanged(Value, item)) - { - return; - } - - ((JObject?)Parent)?.InternalPropertyChanging(this); - - base.SetItem(0, item); - - ((JObject?)Parent)?.InternalPropertyChanged(this); - } - - internal override bool RemoveItem(JToken? item) - { - throw new JsonException("Cannot add or remove items from {0}.".FormatWith(CultureInfo.InvariantCulture, typeof(JProperty))); - } - - internal override void RemoveItemAt(int index) - { - throw new JsonException("Cannot add or remove items from {0}.".FormatWith(CultureInfo.InvariantCulture, typeof(JProperty))); - } - - internal override int IndexOfItem(JToken? item) - { - if (item == null) - { - return -1; - } - - return _content.IndexOf(item); - } - - internal override bool InsertItem(int index, JToken? item, bool skipParentCheck) - { - // don't add comments to JProperty - if (item != null && item.Type == JTokenType.Comment) - { - return false; - } - - if (Value != null) - { - throw new JsonException("{0} cannot have multiple values.".FormatWith(CultureInfo.InvariantCulture, typeof(JProperty))); - } - - return base.InsertItem(0, item, false); - } - - internal override bool ContainsItem(JToken? item) - { - return (Value == item); - } - - internal override void MergeItem(object content, JsonMergeSettings? settings) - { - JToken? value = (content as JProperty)?.Value; - - if (value != null && value.Type != JTokenType.Null) - { - Value = value; - } - } - - internal override void ClearItems() - { - throw new JsonException("Cannot add or remove items from {0}.".FormatWith(CultureInfo.InvariantCulture, typeof(JProperty))); - } - - internal override bool DeepEquals(JToken node) - { - return (node is JProperty t && _name == t.Name && ContentsEqual(t)); - } - - internal override JToken CloneToken() - { - return new JProperty(this); - } - - /// - /// Gets the node type for this . - /// - /// The type. - public override JTokenType Type - { - [DebuggerStepThrough] - get { return JTokenType.Property; } - } - - internal JProperty(string name) - { - // called from JTokenWriter - ValidationUtils.ArgumentNotNull(name, nameof(name)); - - _name = name; - } - - /// - /// Initializes a new instance of the class. - /// - /// The property name. - /// The property content. - public JProperty(string name, params object[] content) - : this(name, (object)content) - { - } - - /// - /// Initializes a new instance of the class. - /// - /// The property name. - /// The property content. - public JProperty(string name, object? content) - { - ValidationUtils.ArgumentNotNull(name, nameof(name)); - - _name = name; - - Value = IsMultiContent(content) - ? new JArray(content) - : CreateFromContent(content); - } - - /// - /// Writes this token to a . - /// - /// A into which this method will write. - /// A collection of which will be used when writing the token. - public override void WriteTo(JsonWriter writer, params JsonConverter[] converters) - { - writer.WritePropertyName(_name); - - JToken value = Value; - if (value != null) - { - value.WriteTo(writer, converters); - } - else - { - writer.WriteNull(); - } - } - - internal override int GetDeepHashCode() - { - return _name.GetHashCode() ^ (Value?.GetDeepHashCode() ?? 0); - } - - /// - /// Loads a from a . - /// - /// A that will be read for the content of the . - /// A that contains the JSON that was read from the specified . - public new static JProperty Load(JsonReader reader) - { - return Load(reader, null); - } - - /// - /// Loads a from a . - /// - /// A that will be read for the content of the . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// A that contains the JSON that was read from the specified . - public new static JProperty Load(JsonReader reader, JsonLoadSettings? settings) - { - if (reader.TokenType == JsonToken.None) - { - if (!reader.Read()) - { - throw JsonReaderException.Create(reader, "Error reading JProperty from JsonReader."); - } - } - - reader.MoveToContent(); - - if (reader.TokenType != JsonToken.PropertyName) - { - throw JsonReaderException.Create(reader, "Error reading JProperty from JsonReader. Current JsonReader item is not a property: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - - JProperty p = new JProperty((string)reader.Value!); - p.SetLineInfo(reader as IJsonLineInfo, settings); - - p.ReadTokenFrom(reader, settings); - - return p; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JPropertyDescriptor.cs b/Source/MyDb/Newtonsoft.Json/Linq/JPropertyDescriptor.cs deleted file mode 100644 index 72ea020..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JPropertyDescriptor.cs +++ /dev/null @@ -1,156 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_COMPONENT_MODEL -using System; -using System.ComponentModel; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a view of a . - /// - public class JPropertyDescriptor : PropertyDescriptor - { - /// - /// Initializes a new instance of the class. - /// - /// The name. - public JPropertyDescriptor(string name) - : base(name, null) - { - } - - private static JObject CastInstance(object instance) - { - return (JObject)instance; - } - - /// - /// When overridden in a derived class, returns whether resetting an object changes its value. - /// - /// - /// true if resetting the component changes its value; otherwise, false. - /// - /// The component to test for reset capability. - public override bool CanResetValue(object component) - { - return false; - } - - /// - /// When overridden in a derived class, gets the current value of the property on a component. - /// - /// - /// The value of a property for a given component. - /// - /// The component with the property for which to retrieve the value. - public override object? GetValue(object component) - { - return (component as JObject)?[Name]; - } - - /// - /// When overridden in a derived class, resets the value for this property of the component to the default value. - /// - /// The component with the property value that is to be reset to the default value. - public override void ResetValue(object component) - { - } - - /// - /// When overridden in a derived class, sets the value of the component to a different value. - /// - /// The component with the property value that is to be set. - /// The new value. - public override void SetValue(object component, object value) - { - if (component is JObject o) - { - JToken token = value as JToken ?? new JValue(value); - - o[Name] = token; - } - } - - /// - /// When overridden in a derived class, determines a value indicating whether the value of this property needs to be persisted. - /// - /// - /// true if the property should be persisted; otherwise, false. - /// - /// The component with the property to be examined for persistence. - public override bool ShouldSerializeValue(object component) - { - return false; - } - - /// - /// When overridden in a derived class, gets the type of the component this property is bound to. - /// - /// - /// A that represents the type of component this property is bound to. - /// When the or - /// - /// methods are invoked, the object specified might be an instance of this type. - /// - public override Type ComponentType => typeof(JObject); - - /// - /// When overridden in a derived class, gets a value indicating whether this property is read-only. - /// - /// - /// true if the property is read-only; otherwise, false. - /// - public override bool IsReadOnly => false; - - /// - /// When overridden in a derived class, gets the type of the property. - /// - /// - /// A that represents the type of the property. - /// - public override Type PropertyType => typeof(object); - - /// - /// Gets the hash code for the name of the member. - /// - /// - /// - /// The hash code for the name of the member. - /// - protected override int NameHashCode - { - get - { - // override property to fix up an error in its documentation - int nameHashCode = base.NameHashCode; - return nameHashCode; - } - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JPropertyKeyedCollection.cs b/Source/MyDb/Newtonsoft.Json/Linq/JPropertyKeyedCollection.cs deleted file mode 100644 index 1c4c186..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JPropertyKeyedCollection.cs +++ /dev/null @@ -1,284 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Collections.ObjectModel; -using System.Diagnostics.CodeAnalysis; -using System.Runtime.CompilerServices; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - internal class JPropertyKeyedCollection : Collection - { - private static readonly IEqualityComparer Comparer = StringComparer.Ordinal; - - private Dictionary? _dictionary; - - public JPropertyKeyedCollection() : base(new List()) - { - } - - private void AddKey(string key, JToken item) - { - EnsureDictionary(); - _dictionary![key] = item; - } - - protected void ChangeItemKey(JToken item, string newKey) - { - if (!ContainsItem(item)) - { - throw new ArgumentException("The specified item does not exist in this KeyedCollection."); - } - - string keyForItem = GetKeyForItem(item); - if (!Comparer.Equals(keyForItem, newKey)) - { - if (newKey != null) - { - AddKey(newKey, item); - } - - if (keyForItem != null) - { - RemoveKey(keyForItem); - } - } - } - - protected override void ClearItems() - { - base.ClearItems(); - - _dictionary?.Clear(); - } - - public bool Contains(string key) - { - if (key == null) - { - throw new ArgumentNullException(nameof(key)); - } - - if (_dictionary != null) - { - return _dictionary.ContainsKey(key); - } - - return false; - } - - private bool ContainsItem(JToken item) - { - if (_dictionary == null) - { - return false; - } - - string key = GetKeyForItem(item); - return _dictionary.TryGetValue(key, out _); - } - - private void EnsureDictionary() - { - if (_dictionary == null) - { - _dictionary = new Dictionary(Comparer); - } - } - - private string GetKeyForItem(JToken item) - { - return ((JProperty)item).Name; - } - - protected override void InsertItem(int index, JToken item) - { - AddKey(GetKeyForItem(item), item); - base.InsertItem(index, item); - } - - public bool Remove(string key) - { - if (key == null) - { - throw new ArgumentNullException(nameof(key)); - } - - if (_dictionary != null) - { - return _dictionary.TryGetValue(key, out JToken value) && Remove(value); - } - - return false; - } - - protected override void RemoveItem(int index) - { - string keyForItem = GetKeyForItem(Items[index]); - RemoveKey(keyForItem); - base.RemoveItem(index); - } - - private void RemoveKey(string key) - { - _dictionary?.Remove(key); - } - - protected override void SetItem(int index, JToken item) - { - string keyForItem = GetKeyForItem(item); - string keyAtIndex = GetKeyForItem(Items[index]); - - if (Comparer.Equals(keyAtIndex, keyForItem)) - { - if (_dictionary != null) - { - _dictionary[keyForItem] = item; - } - } - else - { - AddKey(keyForItem, item); - - if (keyAtIndex != null) - { - RemoveKey(keyAtIndex); - } - } - base.SetItem(index, item); - } - - public JToken this[string key] - { - get - { - if (key == null) - { - throw new ArgumentNullException(nameof(key)); - } - - if (_dictionary != null) - { - return _dictionary[key]; - } - - throw new KeyNotFoundException(); - } - } - - public bool TryGetValue(string key, [NotNullWhen(true)]out JToken? value) - { - if (_dictionary == null) - { - value = null; - return false; - } - - return _dictionary.TryGetValue(key, out value); - } - - public ICollection Keys - { - get - { - EnsureDictionary(); - return _dictionary!.Keys; - } - } - - public ICollection Values - { - get - { - EnsureDictionary(); - return _dictionary!.Values; - } - } - - public int IndexOfReference(JToken t) - { - return ((List)Items).IndexOfReference(t); - } - - public bool Compare(JPropertyKeyedCollection other) - { - if (this == other) - { - return true; - } - - // dictionaries in JavaScript aren't ordered - // ignore order when comparing properties - Dictionary? d1 = _dictionary; - Dictionary? d2 = other._dictionary; - - if (d1 == null && d2 == null) - { - return true; - } - - if (d1 == null) - { - return (d2!.Count == 0); - } - - if (d2 == null) - { - return (d1.Count == 0); - } - - if (d1.Count != d2.Count) - { - return false; - } - - foreach (KeyValuePair keyAndProperty in d1) - { - if (!d2.TryGetValue(keyAndProperty.Key, out JToken secondValue)) - { - return false; - } - - JProperty p1 = (JProperty)keyAndProperty.Value; - JProperty p2 = (JProperty)secondValue; - - if (p1.Value == null) - { - return (p2.Value == null); - } - - if (!p1.Value.DeepEquals(p2.Value)) - { - return false; - } - } - - return true; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JRaw.Async.cs b/Source/MyDb/Newtonsoft.Json/Linq/JRaw.Async.cs deleted file mode 100644 index efb4f61..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JRaw.Async.cs +++ /dev/null @@ -1,57 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System.Globalization; -using System.IO; -using System.Threading; -using System.Threading.Tasks; - -namespace Newtonsoft.Json.Linq -{ - public partial class JRaw - { - /// - /// Asynchronously creates an instance of with the content of the reader's current token. - /// - /// The reader. - /// The token to monitor for cancellation requests. The default value is . - /// A representing the asynchronous creation. The - /// property returns an instance of with the content of the reader's current token. - public static async Task CreateAsync(JsonReader reader, CancellationToken cancellationToken = default) - { - using (StringWriter sw = new StringWriter(CultureInfo.InvariantCulture)) - using (JsonTextWriter jsonWriter = new JsonTextWriter(sw)) - { - await jsonWriter.WriteTokenSyncReadingAsync(reader, cancellationToken).ConfigureAwait(false); - - return new JRaw(sw.ToString()); - } - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JRaw.cs b/Source/MyDb/Newtonsoft.Json/Linq/JRaw.cs deleted file mode 100644 index 02ca51f..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JRaw.cs +++ /dev/null @@ -1,75 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System.Globalization; -using System.IO; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a raw JSON string. - /// - public partial class JRaw : JValue - { - /// - /// Initializes a new instance of the class from another object. - /// - /// A object to copy from. - public JRaw(JRaw other) - : base(other) - { - } - - /// - /// Initializes a new instance of the class. - /// - /// The raw json. - public JRaw(object? rawJson) - : base(rawJson, JTokenType.Raw) - { - } - - /// - /// Creates an instance of with the content of the reader's current token. - /// - /// The reader. - /// An instance of with the content of the reader's current token. - public static JRaw Create(JsonReader reader) - { - using (StringWriter sw = new StringWriter(CultureInfo.InvariantCulture)) - using (JsonTextWriter jsonWriter = new JsonTextWriter(sw)) - { - jsonWriter.WriteToken(reader); - - return new JRaw(sw.ToString()); - } - } - - internal override JToken CloneToken() - { - return new JRaw(this); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JToken.Async.cs b/Source/MyDb/Newtonsoft.Json/Linq/JToken.Async.cs deleted file mode 100644 index 4d147c2..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JToken.Async.cs +++ /dev/null @@ -1,178 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System; -using System.Globalization; -using System.Threading; -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - public abstract partial class JToken - { - /// - /// Writes this token to a asynchronously. - /// - /// A into which this method will write. - /// The token to monitor for cancellation requests. - /// A collection of which will be used when writing the token. - /// A that represents the asynchronous write operation. - public virtual Task WriteToAsync(JsonWriter writer, CancellationToken cancellationToken, params JsonConverter[] converters) - { - throw new NotImplementedException(); - } - - /// - /// Writes this token to a asynchronously. - /// - /// A into which this method will write. - /// A collection of which will be used when writing the token. - /// A that represents the asynchronous write operation. - public Task WriteToAsync(JsonWriter writer, params JsonConverter[] converters) - { - return WriteToAsync(writer, default, converters); - } - - /// - /// Asynchronously creates a from a . - /// - /// An positioned at the token to read into this . - /// The token to monitor for cancellation requests. The default value is . - /// - /// A that represents the asynchronous creation. The - /// property returns a that contains - /// the token and its descendant tokens - /// that were read from the reader. The runtime type of the token is determined - /// by the token type of the first token encountered in the reader. - /// - public static Task ReadFromAsync(JsonReader reader, CancellationToken cancellationToken = default) - { - return ReadFromAsync(reader, null, cancellationToken); - } - - /// - /// Asynchronously creates a from a . - /// - /// An positioned at the token to read into this . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// The token to monitor for cancellation requests. The default value is . - /// - /// A that represents the asynchronous creation. The - /// property returns a that contains - /// the token and its descendant tokens - /// that were read from the reader. The runtime type of the token is determined - /// by the token type of the first token encountered in the reader. - /// - public static async Task ReadFromAsync(JsonReader reader, JsonLoadSettings? settings, CancellationToken cancellationToken = default) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - - if (reader.TokenType == JsonToken.None) - { - if (!await (settings != null && settings.CommentHandling == CommentHandling.Ignore ? reader.ReadAndMoveToContentAsync(cancellationToken) : reader.ReadAsync(cancellationToken)).ConfigureAwait(false)) - { - throw JsonReaderException.Create(reader, "Error reading JToken from JsonReader."); - } - } - - IJsonLineInfo? lineInfo = reader as IJsonLineInfo; - - switch (reader.TokenType) - { - case JsonToken.StartObject: - return await JObject.LoadAsync(reader, settings, cancellationToken).ConfigureAwait(false); - case JsonToken.StartArray: - return await JArray.LoadAsync(reader, settings, cancellationToken).ConfigureAwait(false); - case JsonToken.StartConstructor: - return await JConstructor.LoadAsync(reader, settings, cancellationToken).ConfigureAwait(false); - case JsonToken.PropertyName: - return await JProperty.LoadAsync(reader, settings, cancellationToken).ConfigureAwait(false); - case JsonToken.String: - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.Date: - case JsonToken.Boolean: - case JsonToken.Bytes: - JValue v = new JValue(reader.Value); - v.SetLineInfo(lineInfo, settings); - return v; - case JsonToken.Comment: - v = JValue.CreateComment(reader.Value?.ToString()); - v.SetLineInfo(lineInfo, settings); - return v; - case JsonToken.Null: - v = JValue.CreateNull(); - v.SetLineInfo(lineInfo, settings); - return v; - case JsonToken.Undefined: - v = JValue.CreateUndefined(); - v.SetLineInfo(lineInfo, settings); - return v; - default: - throw JsonReaderException.Create(reader, "Error reading JToken from JsonReader. Unexpected token: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - } - - /// - /// Asynchronously creates a from a . - /// - /// A positioned at the token to read into this . - /// The token to monitor for cancellation requests. The default value is . - /// - /// A that represents the asynchronous creation. The - /// property returns a that contains the token and its descendant tokens - /// that were read from the reader. The runtime type of the token is determined - /// by the token type of the first token encountered in the reader. - /// - public static Task LoadAsync(JsonReader reader, CancellationToken cancellationToken = default) - { - return LoadAsync(reader, null, cancellationToken); - } - - /// - /// Asynchronously creates a from a . - /// - /// A positioned at the token to read into this . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// The token to monitor for cancellation requests. The default value is . - /// - /// A that represents the asynchronous creation. The - /// property returns a that contains the token and its descendant tokens - /// that were read from the reader. The runtime type of the token is determined - /// by the token type of the first token encountered in the reader. - /// - public static Task LoadAsync(JsonReader reader, JsonLoadSettings? settings, CancellationToken cancellationToken = default) - { - return ReadFromAsync(reader, settings, cancellationToken); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JToken.cs b/Source/MyDb/Newtonsoft.Json/Linq/JToken.cs deleted file mode 100644 index 9cb008a..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JToken.cs +++ /dev/null @@ -1,2758 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using Newtonsoft.Json.Linq.JsonPath; -#if HAVE_DYNAMIC -using System.Dynamic; -using System.Linq.Expressions; -#endif -using System.IO; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using Newtonsoft.Json.Utilities; -using System.Diagnostics; -using System.Globalization; -using System.Collections; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents an abstract JSON token. - /// - public abstract partial class JToken : IJEnumerable, IJsonLineInfo -#if HAVE_ICLONEABLE - , ICloneable -#endif -#if HAVE_DYNAMIC - , IDynamicMetaObjectProvider -#endif - { - private static JTokenEqualityComparer? _equalityComparer; - - private JContainer? _parent; - private JToken? _previous; - private JToken? _next; - private object? _annotations; - - private static readonly JTokenType[] BooleanTypes = new[] { JTokenType.Integer, JTokenType.Float, JTokenType.String, JTokenType.Comment, JTokenType.Raw, JTokenType.Boolean }; - private static readonly JTokenType[] NumberTypes = new[] { JTokenType.Integer, JTokenType.Float, JTokenType.String, JTokenType.Comment, JTokenType.Raw, JTokenType.Boolean }; -#if HAVE_BIG_INTEGER - private static readonly JTokenType[] BigIntegerTypes = new[] { JTokenType.Integer, JTokenType.Float, JTokenType.String, JTokenType.Comment, JTokenType.Raw, JTokenType.Boolean, JTokenType.Bytes }; -#endif - private static readonly JTokenType[] StringTypes = new[] { JTokenType.Date, JTokenType.Integer, JTokenType.Float, JTokenType.String, JTokenType.Comment, JTokenType.Raw, JTokenType.Boolean, JTokenType.Bytes, JTokenType.Guid, JTokenType.TimeSpan, JTokenType.Uri }; - private static readonly JTokenType[] GuidTypes = new[] { JTokenType.String, JTokenType.Comment, JTokenType.Raw, JTokenType.Guid, JTokenType.Bytes }; - private static readonly JTokenType[] TimeSpanTypes = new[] { JTokenType.String, JTokenType.Comment, JTokenType.Raw, JTokenType.TimeSpan }; - private static readonly JTokenType[] UriTypes = new[] { JTokenType.String, JTokenType.Comment, JTokenType.Raw, JTokenType.Uri }; - private static readonly JTokenType[] CharTypes = new[] { JTokenType.Integer, JTokenType.Float, JTokenType.String, JTokenType.Comment, JTokenType.Raw }; - private static readonly JTokenType[] DateTimeTypes = new[] { JTokenType.Date, JTokenType.String, JTokenType.Comment, JTokenType.Raw }; - private static readonly JTokenType[] BytesTypes = new[] { JTokenType.Bytes, JTokenType.String, JTokenType.Comment, JTokenType.Raw, JTokenType.Integer }; - - /// - /// Gets a comparer that can compare two tokens for value equality. - /// - /// A that can compare two nodes for value equality. - public static JTokenEqualityComparer EqualityComparer - { - get - { - if (_equalityComparer == null) - { - _equalityComparer = new JTokenEqualityComparer(); - } - - return _equalityComparer; - } - } - - /// - /// Gets or sets the parent. - /// - /// The parent. - public JContainer? Parent - { - [DebuggerStepThrough] - get { return _parent; } - internal set { _parent = value; } - } - - /// - /// Gets the root of this . - /// - /// The root of this . - public JToken Root - { - get - { - JContainer? parent = Parent; - if (parent == null) - { - return this; - } - - while (parent.Parent != null) - { - parent = parent.Parent; - } - - return parent; - } - } - - internal abstract JToken CloneToken(); - internal abstract bool DeepEquals(JToken node); - - /// - /// Gets the node type for this . - /// - /// The type. - public abstract JTokenType Type { get; } - - /// - /// Gets a value indicating whether this token has child tokens. - /// - /// - /// true if this token has child values; otherwise, false. - /// - public abstract bool HasValues { get; } - - /// - /// Compares the values of two tokens, including the values of all descendant tokens. - /// - /// The first to compare. - /// The second to compare. - /// true if the tokens are equal; otherwise false. - public static bool DeepEquals(JToken? t1, JToken? t2) - { - return (t1 == t2 || (t1 != null && t2 != null && t1.DeepEquals(t2))); - } - - /// - /// Gets the next sibling token of this node. - /// - /// The that contains the next sibling token. - public JToken? Next - { - get => _next; - internal set => _next = value; - } - - /// - /// Gets the previous sibling token of this node. - /// - /// The that contains the previous sibling token. - public JToken? Previous - { - get => _previous; - internal set => _previous = value; - } - - /// - /// Gets the path of the JSON token. - /// - public string Path - { - get - { - if (Parent == null) - { - return string.Empty; - } - - List positions = new List(); - JToken? previous = null; - for (JToken? current = this; current != null; current = current.Parent) - { - switch (current.Type) - { - case JTokenType.Property: - JProperty property = (JProperty)current; - positions.Add(new JsonPosition(JsonContainerType.Object) { PropertyName = property.Name }); - break; - case JTokenType.Array: - case JTokenType.Constructor: - if (previous != null) - { - int index = ((IList)current).IndexOf(previous); - - positions.Add(new JsonPosition(JsonContainerType.Array) { Position = index }); - } - break; - } - - previous = current; - } - -#if HAVE_FAST_REVERSE - positions.FastReverse(); -#else - positions.Reverse(); -#endif - - return JsonPosition.BuildPath(positions, null); - } - } - - internal JToken() - { - } - - /// - /// Adds the specified content immediately after this token. - /// - /// A content object that contains simple content or a collection of content objects to be added after this token. - public void AddAfterSelf(object? content) - { - if (_parent == null) - { - throw new InvalidOperationException("The parent is missing."); - } - - int index = _parent.IndexOfItem(this); - _parent.TryAddInternal(index + 1, content, false); - } - - /// - /// Adds the specified content immediately before this token. - /// - /// A content object that contains simple content or a collection of content objects to be added before this token. - public void AddBeforeSelf(object? content) - { - if (_parent == null) - { - throw new InvalidOperationException("The parent is missing."); - } - - int index = _parent.IndexOfItem(this); - _parent.TryAddInternal(index, content, false); - } - - /// - /// Returns a collection of the ancestor tokens of this token. - /// - /// A collection of the ancestor tokens of this token. - public IEnumerable Ancestors() - { - return GetAncestors(false); - } - - /// - /// Returns a collection of tokens that contain this token, and the ancestors of this token. - /// - /// A collection of tokens that contain this token, and the ancestors of this token. - public IEnumerable AncestorsAndSelf() - { - return GetAncestors(true); - } - - internal IEnumerable GetAncestors(bool self) - { - for (JToken? current = self ? this : Parent; current != null; current = current.Parent) - { - yield return current; - } - } - - /// - /// Returns a collection of the sibling tokens after this token, in document order. - /// - /// A collection of the sibling tokens after this tokens, in document order. - public IEnumerable AfterSelf() - { - if (Parent == null) - { - yield break; - } - - for (JToken? o = Next; o != null; o = o.Next) - { - yield return o; - } - } - - /// - /// Returns a collection of the sibling tokens before this token, in document order. - /// - /// A collection of the sibling tokens before this token, in document order. - public IEnumerable BeforeSelf() - { - if (Parent == null) - { - yield break; - } - - for (JToken? o = Parent.First; o != this && o != null; o = o.Next) - { - yield return o; - } - } - - /// - /// Gets the with the specified key. - /// - /// The with the specified key. - public virtual JToken? this[object key] - { - get => throw new InvalidOperationException("Cannot access child value on {0}.".FormatWith(CultureInfo.InvariantCulture, GetType())); - set => throw new InvalidOperationException("Cannot set child value on {0}.".FormatWith(CultureInfo.InvariantCulture, GetType())); - } - - /// - /// Gets the with the specified key converted to the specified type. - /// - /// The type to convert the token to. - /// The token key. - /// The converted token value. - public virtual T? Value(object key) - { - JToken? token = this[key]; - - // null check to fix MonoTouch issue - https://github.com/dolbz/Newtonsoft.Json/commit/a24e3062846b30ee505f3271ac08862bb471b822 - return token == null ? default : Extensions.Convert(token); - } - - /// - /// Get the first child token of this token. - /// - /// A containing the first child token of the . - public virtual JToken? First => throw new InvalidOperationException("Cannot access child value on {0}.".FormatWith(CultureInfo.InvariantCulture, GetType())); - - /// - /// Get the last child token of this token. - /// - /// A containing the last child token of the . - public virtual JToken? Last => throw new InvalidOperationException("Cannot access child value on {0}.".FormatWith(CultureInfo.InvariantCulture, GetType())); - - /// - /// Returns a collection of the child tokens of this token, in document order. - /// - /// An of containing the child tokens of this , in document order. - public virtual JEnumerable Children() - { - return JEnumerable.Empty; - } - - /// - /// Returns a collection of the child tokens of this token, in document order, filtered by the specified type. - /// - /// The type to filter the child tokens on. - /// A containing the child tokens of this , in document order. - public JEnumerable Children() where T : JToken - { - return new JEnumerable(Children().OfType()); - } - - /// - /// Returns a collection of the child values of this token, in document order. - /// - /// The type to convert the values to. - /// A containing the child values of this , in document order. - public virtual IEnumerable Values() - { - throw new InvalidOperationException("Cannot access child value on {0}.".FormatWith(CultureInfo.InvariantCulture, GetType())); - } - - /// - /// Removes this token from its parent. - /// - public void Remove() - { - if (_parent == null) - { - throw new InvalidOperationException("The parent is missing."); - } - - _parent.RemoveItem(this); - } - - /// - /// Replaces this token with the specified token. - /// - /// The value. - public void Replace(JToken value) - { - if (_parent == null) - { - throw new InvalidOperationException("The parent is missing."); - } - - _parent.ReplaceItem(this, value); - } - - /// - /// Writes this token to a . - /// - /// A into which this method will write. - /// A collection of which will be used when writing the token. - public abstract void WriteTo(JsonWriter writer, params JsonConverter[] converters); - - /// - /// Returns the indented JSON for this token. - /// - /// - /// ToString() returns a non-JSON string value for tokens with a type of . - /// If you want the JSON for all token types then you should use . - /// - /// - /// The indented JSON for this token. - /// - public override string ToString() - { - return ToString(Formatting.Indented); - } - - /// - /// Returns the JSON for this token using the given formatting and converters. - /// - /// Indicates how the output should be formatted. - /// A collection of s which will be used when writing the token. - /// The JSON for this token using the given formatting and converters. - public string ToString(Formatting formatting, params JsonConverter[] converters) - { - using (StringWriter sw = new StringWriter(CultureInfo.InvariantCulture)) - { - JsonTextWriter jw = new JsonTextWriter(sw); - jw.Formatting = formatting; - - WriteTo(jw, converters); - - return sw.ToString(); - } - } - - private static JValue? EnsureValue(JToken value) - { - if (value == null) - { - throw new ArgumentNullException(nameof(value)); - } - - if (value is JProperty property) - { - value = property.Value; - } - - JValue? v = value as JValue; - - return v; - } - - private static string GetType(JToken token) - { - ValidationUtils.ArgumentNotNull(token, nameof(token)); - - if (token is JProperty p) - { - token = p.Value; - } - - return token.Type.ToString(); - } - - private static bool ValidateToken(JToken o, JTokenType[] validTypes, bool nullable) - { - return (Array.IndexOf(validTypes, o.Type) != -1) || (nullable && (o.Type == JTokenType.Null || o.Type == JTokenType.Undefined)); - } - - #region Cast from operators - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator bool(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, BooleanTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Boolean.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return Convert.ToBoolean((int)integer); - } -#endif - - return Convert.ToBoolean(v.Value, CultureInfo.InvariantCulture); - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator DateTimeOffset(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, DateTimeTypes, false)) - { - throw new ArgumentException("Can not convert {0} to DateTimeOffset.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - if (v.Value is DateTimeOffset offset) - { - return offset; - } - - if (v.Value is string s) - { - return DateTimeOffset.Parse(s, CultureInfo.InvariantCulture); - } - - return new DateTimeOffset(Convert.ToDateTime(v.Value, CultureInfo.InvariantCulture)); - } -#endif - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator bool?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, BooleanTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Boolean.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return Convert.ToBoolean((int)integer); - } -#endif - - return (v.Value != null) ? (bool?)Convert.ToBoolean(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator long(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Int64.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (long)integer; - } -#endif - - return Convert.ToInt64(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator DateTime?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, DateTimeTypes, true)) - { - throw new ArgumentException("Can not convert {0} to DateTime.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_DATE_TIME_OFFSET - if (v.Value is DateTimeOffset offset) - { - return offset.DateTime; - } -#endif - - return (v.Value != null) ? (DateTime?)Convert.ToDateTime(v.Value, CultureInfo.InvariantCulture) : null; - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator DateTimeOffset?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, DateTimeTypes, true)) - { - throw new ArgumentException("Can not convert {0} to DateTimeOffset.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - if (v.Value == null) - { - return null; - } - if (v.Value is DateTimeOffset offset) - { - return offset; - } - - if (v.Value is string s) - { - return DateTimeOffset.Parse(s, CultureInfo.InvariantCulture); - } - - return new DateTimeOffset(Convert.ToDateTime(v.Value, CultureInfo.InvariantCulture)); - } -#endif - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator decimal?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Decimal.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (decimal?)integer; - } -#endif - - return (v.Value != null) ? (decimal?)Convert.ToDecimal(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator double?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Double.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (double?)integer; - } -#endif - - return (v.Value != null) ? (double?)Convert.ToDouble(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator char?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, CharTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Char.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (char?)integer; - } -#endif - - return (v.Value != null) ? (char?)Convert.ToChar(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator int(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Int32.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (int)integer; - } -#endif - - return Convert.ToInt32(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator short(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Int16.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (short)integer; - } -#endif - - return Convert.ToInt16(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - [CLSCompliant(false)] - public static explicit operator ushort(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to UInt16.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (ushort)integer; - } -#endif - - return Convert.ToUInt16(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - [CLSCompliant(false)] - public static explicit operator char(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, CharTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Char.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (char)integer; - } -#endif - - return Convert.ToChar(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator byte(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Byte.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (byte)integer; - } -#endif - - return Convert.ToByte(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - [CLSCompliant(false)] - public static explicit operator sbyte(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to SByte.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (sbyte)integer; - } -#endif - - return Convert.ToSByte(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator int?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Int32.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (int?)integer; - } -#endif - - return (v.Value != null) ? (int?)Convert.ToInt32(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator short?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Int16.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (short?)integer; - } -#endif - - return (v.Value != null) ? (short?)Convert.ToInt16(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - [CLSCompliant(false)] - public static explicit operator ushort?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to UInt16.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (ushort?)integer; - } -#endif - - return (v.Value != null) ? (ushort?)Convert.ToUInt16(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator byte?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Byte.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (byte?)integer; - } -#endif - - return (v.Value != null) ? (byte?)Convert.ToByte(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - [CLSCompliant(false)] - public static explicit operator sbyte?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to SByte.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (sbyte?)integer; - } -#endif - - return (v.Value != null) ? (sbyte?)Convert.ToSByte(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator DateTime(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, DateTimeTypes, false)) - { - throw new ArgumentException("Can not convert {0} to DateTime.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_DATE_TIME_OFFSET - if (v.Value is DateTimeOffset offset) - { - return offset.DateTime; - } -#endif - - return Convert.ToDateTime(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator long?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Int64.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (long?)integer; - } -#endif - - return (v.Value != null) ? (long?)Convert.ToInt64(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator float?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Single.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (float?)integer; - } -#endif - - return (v.Value != null) ? (float?)Convert.ToSingle(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator decimal(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Decimal.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (decimal)integer; - } -#endif - - return Convert.ToDecimal(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - [CLSCompliant(false)] - public static explicit operator uint?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to UInt32.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (uint?)integer; - } -#endif - - return (v.Value != null) ? (uint?)Convert.ToUInt32(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - [CLSCompliant(false)] - public static explicit operator ulong?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, true)) - { - throw new ArgumentException("Can not convert {0} to UInt64.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (ulong?)integer; - } -#endif - - return (v.Value != null) ? (ulong?)Convert.ToUInt64(v.Value, CultureInfo.InvariantCulture) : null; - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator double(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Double.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (double)integer; - } -#endif - - return Convert.ToDouble(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator float(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Single.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (float)integer; - } -#endif - - return Convert.ToSingle(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator string?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, StringTypes, true)) - { - throw new ArgumentException("Can not convert {0} to String.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - if (v.Value == null) - { - return null; - } - - if (v.Value is byte[] bytes) - { - return Convert.ToBase64String(bytes); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return integer.ToString(CultureInfo.InvariantCulture); - } -#endif - - return Convert.ToString(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - [CLSCompliant(false)] - public static explicit operator uint(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to UInt32.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (uint)integer; - } -#endif - - return Convert.ToUInt32(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - [CLSCompliant(false)] - public static explicit operator ulong(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, NumberTypes, false)) - { - throw new ArgumentException("Can not convert {0} to UInt64.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return (ulong)integer; - } -#endif - - return Convert.ToUInt64(v.Value, CultureInfo.InvariantCulture); - } - - /// - /// Performs an explicit conversion from to []. - /// - /// The value. - /// The result of the conversion. - public static explicit operator byte[]?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, BytesTypes, false)) - { - throw new ArgumentException("Can not convert {0} to byte array.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - if (v.Value is string) - { - return Convert.FromBase64String(Convert.ToString(v.Value, CultureInfo.InvariantCulture)); - } -#if HAVE_BIG_INTEGER - if (v.Value is BigInteger integer) - { - return integer.ToByteArray(); - } -#endif - - if (v.Value is byte[] bytes) - { - return bytes; - } - - throw new ArgumentException("Can not convert {0} to byte array.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator Guid(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, GuidTypes, false)) - { - throw new ArgumentException("Can not convert {0} to Guid.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - if (v.Value is byte[] bytes) - { - return new Guid(bytes); - } - - return (v.Value is Guid guid) ? guid : new Guid(Convert.ToString(v.Value, CultureInfo.InvariantCulture)); - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator Guid?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, GuidTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Guid.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - if (v.Value == null) - { - return null; - } - - if (v.Value is byte[] bytes) - { - return new Guid(bytes); - } - - return (v.Value is Guid guid) ? guid : new Guid(Convert.ToString(v.Value, CultureInfo.InvariantCulture)); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator TimeSpan(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, TimeSpanTypes, false)) - { - throw new ArgumentException("Can not convert {0} to TimeSpan.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - return (v.Value is TimeSpan span) ? span : ConvertUtils.ParseTimeSpan(Convert.ToString(v.Value, CultureInfo.InvariantCulture)); - } - - /// - /// Performs an explicit conversion from to of . - /// - /// The value. - /// The result of the conversion. - public static explicit operator TimeSpan?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, TimeSpanTypes, true)) - { - throw new ArgumentException("Can not convert {0} to TimeSpan.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - if (v.Value == null) - { - return null; - } - - return (v.Value is TimeSpan span) ? span : ConvertUtils.ParseTimeSpan(Convert.ToString(v.Value, CultureInfo.InvariantCulture)); - } - - /// - /// Performs an explicit conversion from to . - /// - /// The value. - /// The result of the conversion. - public static explicit operator Uri?(JToken? value) - { - if (value == null) - { - return null; - } - - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, UriTypes, true)) - { - throw new ArgumentException("Can not convert {0} to Uri.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - if (v.Value == null) - { - return null; - } - - return (v.Value is Uri uri) ? uri : new Uri(Convert.ToString(v.Value, CultureInfo.InvariantCulture)); - } - -#if HAVE_BIG_INTEGER - private static BigInteger ToBigInteger(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, BigIntegerTypes, false)) - { - throw new ArgumentException("Can not convert {0} to BigInteger.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - return ConvertUtils.ToBigInteger(v.Value!); - } - - private static BigInteger? ToBigIntegerNullable(JToken value) - { - JValue? v = EnsureValue(value); - if (v == null || !ValidateToken(v, BigIntegerTypes, true)) - { - throw new ArgumentException("Can not convert {0} to BigInteger.".FormatWith(CultureInfo.InvariantCulture, GetType(value))); - } - - if (v.Value == null) - { - return null; - } - - return ConvertUtils.ToBigInteger(v.Value); - } -#endif - #endregion - - #region Cast to operators - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(bool value) - { - return new JValue(value); - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(DateTimeOffset value) - { - return new JValue(value); - } -#endif - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(byte value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(byte? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(sbyte value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(sbyte? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(bool? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(long value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(DateTime? value) - { - return new JValue(value); - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(DateTimeOffset? value) - { - return new JValue(value); - } -#endif - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(decimal? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(double? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(short value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(ushort value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(int value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(int? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(DateTime value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(long? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(float? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(decimal value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(short? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(ushort? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(uint? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(ulong? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(double value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(float value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(string? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(uint value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - [CLSCompliant(false)] - public static implicit operator JToken(ulong value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from [] to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(byte[] value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(Uri? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(TimeSpan value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(TimeSpan? value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(Guid value) - { - return new JValue(value); - } - - /// - /// Performs an implicit conversion from of to . - /// - /// The value to create a from. - /// The initialized with the specified value. - public static implicit operator JToken(Guid? value) - { - return new JValue(value); - } - #endregion - - IEnumerator IEnumerable.GetEnumerator() - { - return ((IEnumerable)this).GetEnumerator(); - } - - IEnumerator IEnumerable.GetEnumerator() - { - return Children().GetEnumerator(); - } - - internal abstract int GetDeepHashCode(); - - IJEnumerable IJEnumerable.this[object key] => this[key]!; - - /// - /// Creates a for this token. - /// - /// A that can be used to read this token and its descendants. - public JsonReader CreateReader() - { - return new JTokenReader(this); - } - - internal static JToken FromObjectInternal(object o, JsonSerializer jsonSerializer) - { - ValidationUtils.ArgumentNotNull(o, nameof(o)); - ValidationUtils.ArgumentNotNull(jsonSerializer, nameof(jsonSerializer)); - - JToken token; - using (JTokenWriter jsonWriter = new JTokenWriter()) - { - jsonSerializer.Serialize(jsonWriter, o); - token = jsonWriter.Token!; - } - - return token; - } - - /// - /// Creates a from an object. - /// - /// The object that will be used to create . - /// A with the value of the specified object. - public static JToken FromObject(object o) - { - return FromObjectInternal(o, JsonSerializer.CreateDefault()); - } - - /// - /// Creates a from an object using the specified . - /// - /// The object that will be used to create . - /// The that will be used when reading the object. - /// A with the value of the specified object. - public static JToken FromObject(object o, JsonSerializer jsonSerializer) - { - return FromObjectInternal(o, jsonSerializer); - } - - /// - /// Creates an instance of the specified .NET type from the . - /// - /// The object type that the token will be deserialized to. - /// The new object created from the JSON value. - public T? ToObject() - { - return (T?)ToObject(typeof(T)); - } - - /// - /// Creates an instance of the specified .NET type from the . - /// - /// The object type that the token will be deserialized to. - /// The new object created from the JSON value. - public object? ToObject(Type objectType) - { - if (JsonConvert.DefaultSettings == null) - { - PrimitiveTypeCode typeCode = ConvertUtils.GetTypeCode(objectType, out bool isEnum); - - if (isEnum) - { - if (Type == JTokenType.String) - { - try - { - // use serializer so JsonConverter(typeof(StringEnumConverter)) + EnumMemberAttributes are respected - return ToObject(objectType, JsonSerializer.CreateDefault()); - } - catch (Exception ex) - { - Type enumType = objectType.IsEnum() ? objectType : Nullable.GetUnderlyingType(objectType); - throw new ArgumentException("Could not convert '{0}' to {1}.".FormatWith(CultureInfo.InvariantCulture, (string?)this, enumType.Name), ex); - } - } - - if (Type == JTokenType.Integer) - { - Type enumType = objectType.IsEnum() ? objectType : Nullable.GetUnderlyingType(objectType); - return Enum.ToObject(enumType, ((JValue)this).Value); - } - } - - switch (typeCode) - { - case PrimitiveTypeCode.BooleanNullable: - return (bool?)this; - case PrimitiveTypeCode.Boolean: - return (bool)this; - case PrimitiveTypeCode.CharNullable: - return (char?)this; - case PrimitiveTypeCode.Char: - return (char)this; - case PrimitiveTypeCode.SByte: - return (sbyte)this; - case PrimitiveTypeCode.SByteNullable: - return (sbyte?)this; - case PrimitiveTypeCode.ByteNullable: - return (byte?)this; - case PrimitiveTypeCode.Byte: - return (byte)this; - case PrimitiveTypeCode.Int16Nullable: - return (short?)this; - case PrimitiveTypeCode.Int16: - return (short)this; - case PrimitiveTypeCode.UInt16Nullable: - return (ushort?)this; - case PrimitiveTypeCode.UInt16: - return (ushort)this; - case PrimitiveTypeCode.Int32Nullable: - return (int?)this; - case PrimitiveTypeCode.Int32: - return (int)this; - case PrimitiveTypeCode.UInt32Nullable: - return (uint?)this; - case PrimitiveTypeCode.UInt32: - return (uint)this; - case PrimitiveTypeCode.Int64Nullable: - return (long?)this; - case PrimitiveTypeCode.Int64: - return (long)this; - case PrimitiveTypeCode.UInt64Nullable: - return (ulong?)this; - case PrimitiveTypeCode.UInt64: - return (ulong)this; - case PrimitiveTypeCode.SingleNullable: - return (float?)this; - case PrimitiveTypeCode.Single: - return (float)this; - case PrimitiveTypeCode.DoubleNullable: - return (double?)this; - case PrimitiveTypeCode.Double: - return (double)this; - case PrimitiveTypeCode.DecimalNullable: - return (decimal?)this; - case PrimitiveTypeCode.Decimal: - return (decimal)this; - case PrimitiveTypeCode.DateTimeNullable: - return (DateTime?)this; - case PrimitiveTypeCode.DateTime: - return (DateTime)this; -#if HAVE_DATE_TIME_OFFSET - case PrimitiveTypeCode.DateTimeOffsetNullable: - return (DateTimeOffset?)this; - case PrimitiveTypeCode.DateTimeOffset: - return (DateTimeOffset)this; -#endif - case PrimitiveTypeCode.String: - return (string?)this; - case PrimitiveTypeCode.GuidNullable: - return (Guid?)this; - case PrimitiveTypeCode.Guid: - return (Guid)this; - case PrimitiveTypeCode.Uri: - return (Uri?)this; - case PrimitiveTypeCode.TimeSpanNullable: - return (TimeSpan?)this; - case PrimitiveTypeCode.TimeSpan: - return (TimeSpan)this; -#if HAVE_BIG_INTEGER - case PrimitiveTypeCode.BigIntegerNullable: - return ToBigIntegerNullable(this); - case PrimitiveTypeCode.BigInteger: - return ToBigInteger(this); -#endif - } - } - - return ToObject(objectType, JsonSerializer.CreateDefault()); - } - - /// - /// Creates an instance of the specified .NET type from the using the specified . - /// - /// The object type that the token will be deserialized to. - /// The that will be used when creating the object. - /// The new object created from the JSON value. - public T? ToObject(JsonSerializer jsonSerializer) - { - return (T?)ToObject(typeof(T), jsonSerializer); - } - - /// - /// Creates an instance of the specified .NET type from the using the specified . - /// - /// The object type that the token will be deserialized to. - /// The that will be used when creating the object. - /// The new object created from the JSON value. - public object? ToObject(Type? objectType, JsonSerializer jsonSerializer) - { - ValidationUtils.ArgumentNotNull(jsonSerializer, nameof(jsonSerializer)); - - using (JTokenReader jsonReader = new JTokenReader(this)) - { - // Hacky fix to ensure the serializer settings are set onto the new reader. - // This is required because the serializer won't update settings when used inside of a converter. - if (jsonSerializer is JsonSerializerProxy proxy) - { - proxy._serializer.SetupReader(jsonReader, out _, out _, out _, out _, out _, out _); - } - - return jsonSerializer.Deserialize(jsonReader, objectType); - } - } - - /// - /// Creates a from a . - /// - /// A positioned at the token to read into this . - /// - /// A that contains the token and its descendant tokens - /// that were read from the reader. The runtime type of the token is determined - /// by the token type of the first token encountered in the reader. - /// - public static JToken ReadFrom(JsonReader reader) - { - return ReadFrom(reader, null); - } - - /// - /// Creates a from a . - /// - /// An positioned at the token to read into this . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// - /// A that contains the token and its descendant tokens - /// that were read from the reader. The runtime type of the token is determined - /// by the token type of the first token encountered in the reader. - /// - public static JToken ReadFrom(JsonReader reader, JsonLoadSettings? settings) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - - bool hasContent; - if (reader.TokenType == JsonToken.None) - { - hasContent = (settings != null && settings.CommentHandling == CommentHandling.Ignore) - ? reader.ReadAndMoveToContent() - : reader.Read(); - } - else if (reader.TokenType == JsonToken.Comment && settings?.CommentHandling == CommentHandling.Ignore) - { - hasContent = reader.ReadAndMoveToContent(); - } - else - { - hasContent = true; - } - - if (!hasContent) - { - throw JsonReaderException.Create(reader, "Error reading JToken from JsonReader."); - } - - IJsonLineInfo? lineInfo = reader as IJsonLineInfo; - - switch (reader.TokenType) - { - case JsonToken.StartObject: - return JObject.Load(reader, settings); - case JsonToken.StartArray: - return JArray.Load(reader, settings); - case JsonToken.StartConstructor: - return JConstructor.Load(reader, settings); - case JsonToken.PropertyName: - return JProperty.Load(reader, settings); - case JsonToken.String: - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.Date: - case JsonToken.Boolean: - case JsonToken.Bytes: - JValue v = new JValue(reader.Value); - v.SetLineInfo(lineInfo, settings); - return v; - case JsonToken.Comment: - v = JValue.CreateComment(reader.Value!.ToString()); - v.SetLineInfo(lineInfo, settings); - return v; - case JsonToken.Null: - v = JValue.CreateNull(); - v.SetLineInfo(lineInfo, settings); - return v; - case JsonToken.Undefined: - v = JValue.CreateUndefined(); - v.SetLineInfo(lineInfo, settings); - return v; - default: - throw JsonReaderException.Create(reader, "Error reading JToken from JsonReader. Unexpected token: {0}".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - } - - /// - /// Load a from a string that contains JSON. - /// - /// A that contains JSON. - /// A populated from the string that contains JSON. - public static JToken Parse(string json) - { - return Parse(json, null); - } - - /// - /// Load a from a string that contains JSON. - /// - /// A that contains JSON. - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// A populated from the string that contains JSON. - public static JToken Parse(string json, JsonLoadSettings? settings) - { - using (JsonReader reader = new JsonTextReader(new StringReader(json))) - { - JToken t = Load(reader, settings); - - while (reader.Read()) - { - // Any content encountered here other than a comment will throw in the reader. - } - - return t; - } - } - - /// - /// Creates a from a . - /// - /// A positioned at the token to read into this . - /// The used to load the JSON. - /// If this is null, default load settings will be used. - /// - /// A that contains the token and its descendant tokens - /// that were read from the reader. The runtime type of the token is determined - /// by the token type of the first token encountered in the reader. - /// - public static JToken Load(JsonReader reader, JsonLoadSettings? settings) - { - return ReadFrom(reader, settings); - } - - /// - /// Creates a from a . - /// - /// A positioned at the token to read into this . - /// - /// A that contains the token and its descendant tokens - /// that were read from the reader. The runtime type of the token is determined - /// by the token type of the first token encountered in the reader. - /// - public static JToken Load(JsonReader reader) - { - return Load(reader, null); - } - - internal void SetLineInfo(IJsonLineInfo? lineInfo, JsonLoadSettings? settings) - { - if (settings != null && settings.LineInfoHandling != LineInfoHandling.Load) - { - return; - } - - if (lineInfo == null || !lineInfo.HasLineInfo()) - { - return; - } - - SetLineInfo(lineInfo.LineNumber, lineInfo.LinePosition); - } - - private class LineInfoAnnotation - { - internal readonly int LineNumber; - internal readonly int LinePosition; - - public LineInfoAnnotation(int lineNumber, int linePosition) - { - LineNumber = lineNumber; - LinePosition = linePosition; - } - } - - internal void SetLineInfo(int lineNumber, int linePosition) - { - AddAnnotation(new LineInfoAnnotation(lineNumber, linePosition)); - } - - bool IJsonLineInfo.HasLineInfo() - { - return (Annotation() != null); - } - - int IJsonLineInfo.LineNumber - { - get - { - LineInfoAnnotation? annotation = Annotation(); - if (annotation != null) - { - return annotation.LineNumber; - } - - return 0; - } - } - - int IJsonLineInfo.LinePosition - { - get - { - LineInfoAnnotation? annotation = Annotation(); - if (annotation != null) - { - return annotation.LinePosition; - } - - return 0; - } - } - - /// - /// Selects a using a JSONPath expression. Selects the token that matches the object path. - /// - /// - /// A that contains a JSONPath expression. - /// - /// A , or null. - public JToken? SelectToken(string path) - { - return SelectToken(path, settings: null); - } - - /// - /// Selects a using a JSONPath expression. Selects the token that matches the object path. - /// - /// - /// A that contains a JSONPath expression. - /// - /// A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - /// A . - public JToken? SelectToken(string path, bool errorWhenNoMatch) - { - JsonSelectSettings? settings = errorWhenNoMatch - ? new JsonSelectSettings { ErrorWhenNoMatch = true } - : null; - - return SelectToken(path, settings); - } - - /// - /// Selects a using a JSONPath expression. Selects the token that matches the object path. - /// - /// - /// A that contains a JSONPath expression. - /// - /// The used to select tokens. - /// A . - public JToken? SelectToken(string path, JsonSelectSettings? settings) - { - JPath p = new JPath(path); - - JToken? token = null; - foreach (JToken t in p.Evaluate(this, this, settings)) - { - if (token != null) - { - throw new JsonException("Path returned multiple tokens."); - } - - token = t; - } - - return token; - } - - /// - /// Selects a collection of elements using a JSONPath expression. - /// - /// - /// A that contains a JSONPath expression. - /// - /// An of that contains the selected elements. - public IEnumerable SelectTokens(string path) - { - return SelectTokens(path, settings: null); - } - - /// - /// Selects a collection of elements using a JSONPath expression. - /// - /// - /// A that contains a JSONPath expression. - /// - /// A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - /// An of that contains the selected elements. - public IEnumerable SelectTokens(string path, bool errorWhenNoMatch) - { - JsonSelectSettings? settings = errorWhenNoMatch - ? new JsonSelectSettings { ErrorWhenNoMatch = true } - : null; - - return SelectTokens(path, settings); - } - - /// - /// Selects a collection of elements using a JSONPath expression. - /// - /// - /// A that contains a JSONPath expression. - /// - /// The used to select tokens. - /// An of that contains the selected elements. - public IEnumerable SelectTokens(string path, JsonSelectSettings? settings) - { - var p = new JPath(path); - return p.Evaluate(this, this, settings); - } - -#if HAVE_DYNAMIC - /// - /// Returns the responsible for binding operations performed on this object. - /// - /// The expression tree representation of the runtime value. - /// - /// The to bind this object. - /// - protected virtual DynamicMetaObject GetMetaObject(Expression parameter) - { - return new DynamicProxyMetaObject(parameter, this, new DynamicProxy()); - } - - /// - /// Returns the responsible for binding operations performed on this object. - /// - /// The expression tree representation of the runtime value. - /// - /// The to bind this object. - /// - DynamicMetaObject IDynamicMetaObjectProvider.GetMetaObject(Expression parameter) - { - return GetMetaObject(parameter); - } -#endif - -#if HAVE_ICLONEABLE - object ICloneable.Clone() - { - return DeepClone(); - } -#endif - - /// - /// Creates a new instance of the . All child tokens are recursively cloned. - /// - /// A new instance of the . - public JToken DeepClone() - { - return CloneToken(); - } - - /// - /// Adds an object to the annotation list of this . - /// - /// The annotation to add. - public void AddAnnotation(object annotation) - { - if (annotation == null) - { - throw new ArgumentNullException(nameof(annotation)); - } - - if (_annotations == null) - { - _annotations = (annotation is object[]) ? new[] { annotation } : annotation; - } - else - { - if (!(_annotations is object[] annotations)) - { - _annotations = new[] { _annotations, annotation }; - } - else - { - int index = 0; - while (index < annotations.Length && annotations[index] != null) - { - index++; - } - if (index == annotations.Length) - { - Array.Resize(ref annotations, index * 2); - _annotations = annotations; - } - annotations[index] = annotation; - } - } - } - - /// - /// Get the first annotation object of the specified type from this . - /// - /// The type of the annotation to retrieve. - /// The first annotation object that matches the specified type, or null if no annotation is of the specified type. - public T? Annotation() where T : class - { - if (_annotations != null) - { - if (!(_annotations is object[] annotations)) - { - return (_annotations as T); - } - for (int i = 0; i < annotations.Length; i++) - { - object annotation = annotations[i]; - if (annotation == null) - { - break; - } - - if (annotation is T local) - { - return local; - } - } - } - - return default; - } - - /// - /// Gets the first annotation object of the specified type from this . - /// - /// The of the annotation to retrieve. - /// The first annotation object that matches the specified type, or null if no annotation is of the specified type. - public object? Annotation(Type type) - { - if (type == null) - { - throw new ArgumentNullException(nameof(type)); - } - - if (_annotations != null) - { - if (!(_annotations is object[] annotations)) - { - if (type.IsInstanceOfType(_annotations)) - { - return _annotations; - } - } - else - { - for (int i = 0; i < annotations.Length; i++) - { - object o = annotations[i]; - if (o == null) - { - break; - } - - if (type.IsInstanceOfType(o)) - { - return o; - } - } - } - } - - return null; - } - - /// - /// Gets a collection of annotations of the specified type for this . - /// - /// The type of the annotations to retrieve. - /// An that contains the annotations for this . - public IEnumerable Annotations() where T : class - { - if (_annotations == null) - { - yield break; - } - - if (_annotations is object[] annotations) - { - for (int i = 0; i < annotations.Length; i++) - { - object o = annotations[i]; - if (o == null) - { - break; - } - - if (o is T casted) - { - yield return casted; - } - } - yield break; - } - - if (!(_annotations is T annotation)) - { - yield break; - } - - yield return annotation; - } - - /// - /// Gets a collection of annotations of the specified type for this . - /// - /// The of the annotations to retrieve. - /// An of that contains the annotations that match the specified type for this . - public IEnumerable Annotations(Type type) - { - if (type == null) - { - throw new ArgumentNullException(nameof(type)); - } - - if (_annotations == null) - { - yield break; - } - - if (_annotations is object[] annotations) - { - for (int i = 0; i < annotations.Length; i++) - { - object o = annotations[i]; - if (o == null) - { - break; - } - - if (type.IsInstanceOfType(o)) - { - yield return o; - } - } - yield break; - } - - if (!type.IsInstanceOfType(_annotations)) - { - yield break; - } - - yield return _annotations; - } - - /// - /// Removes the annotations of the specified type from this . - /// - /// The type of annotations to remove. - public void RemoveAnnotations() where T : class - { - if (_annotations != null) - { - if (!(_annotations is object?[] annotations)) - { - if (_annotations is T) - { - _annotations = null; - } - } - else - { - int index = 0; - int keepCount = 0; - while (index < annotations.Length) - { - object? obj2 = annotations[index]; - if (obj2 == null) - { - break; - } - - if (!(obj2 is T)) - { - annotations[keepCount++] = obj2; - } - - index++; - } - - if (keepCount != 0) - { - while (keepCount < index) - { - annotations[keepCount++] = null; - } - } - else - { - _annotations = null; - } - } - } - } - - /// - /// Removes the annotations of the specified type from this . - /// - /// The of annotations to remove. - public void RemoveAnnotations(Type type) - { - if (type == null) - { - throw new ArgumentNullException(nameof(type)); - } - - if (_annotations != null) - { - if (!(_annotations is object?[] annotations)) - { - if (type.IsInstanceOfType(_annotations)) - { - _annotations = null; - } - } - else - { - int index = 0; - int keepCount = 0; - while (index < annotations.Length) - { - object? o = annotations[index]; - if (o == null) - { - break; - } - - if (!type.IsInstanceOfType(o)) - { - annotations[keepCount++] = o; - } - - index++; - } - - if (keepCount != 0) - { - while (keepCount < index) - { - annotations[keepCount++] = null; - } - } - else - { - _annotations = null; - } - } - } - } - - internal void CopyAnnotations(JToken target, JToken source) - { - if (source._annotations is object[] annotations) - { - target._annotations = annotations.ToArray(); - } - else - { - target._annotations = source._annotations; - } - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JTokenEqualityComparer.cs b/Source/MyDb/Newtonsoft.Json/Linq/JTokenEqualityComparer.cs deleted file mode 100644 index 2930896..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JTokenEqualityComparer.cs +++ /dev/null @@ -1,64 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System.Collections.Generic; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Compares tokens to determine whether they are equal. - /// - public class JTokenEqualityComparer : IEqualityComparer - { - /// - /// Determines whether the specified objects are equal. - /// - /// The first object of type to compare. - /// The second object of type to compare. - /// - /// true if the specified objects are equal; otherwise, false. - /// - public bool Equals(JToken x, JToken y) - { - return JToken.DeepEquals(x, y); - } - - /// - /// Returns a hash code for the specified object. - /// - /// The for which a hash code is to be returned. - /// A hash code for the specified object. - /// The type of is a reference type and is null. - public int GetHashCode(JToken obj) - { - if (obj == null) - { - return 0; - } - - return obj.GetDeepHashCode(); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JTokenReader.cs b/Source/MyDb/Newtonsoft.Json/Linq/JTokenReader.cs deleted file mode 100644 index 03d21c8..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JTokenReader.cs +++ /dev/null @@ -1,345 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. - /// - public class JTokenReader : JsonReader, IJsonLineInfo - { - private readonly JToken _root; - private string? _initialPath; - private JToken? _parent; - private JToken? _current; - - /// - /// Gets the at the reader's current position. - /// - public JToken? CurrentToken => _current; - - /// - /// Initializes a new instance of the class. - /// - /// The token to read from. - public JTokenReader(JToken token) - { - ValidationUtils.ArgumentNotNull(token, nameof(token)); - - _root = token; - } - - /// - /// Initializes a new instance of the class. - /// - /// The token to read from. - /// The initial path of the token. It is prepended to the returned . - public JTokenReader(JToken token, string initialPath) - : this(token) - { - _initialPath = initialPath; - } - - /// - /// Reads the next JSON token from the underlying . - /// - /// - /// true if the next token was read successfully; false if there are no more tokens to read. - /// - public override bool Read() - { - if (CurrentState != State.Start) - { - if (_current == null) - { - return false; - } - - if (_current is JContainer container && _parent != container) - { - return ReadInto(container); - } - else - { - return ReadOver(_current); - } - } - - // The current value could already be the root value if it is a comment - if (_current == _root) - { - return false; - } - - _current = _root; - SetToken(_current); - return true; - } - - private bool ReadOver(JToken t) - { - if (t == _root) - { - return ReadToEnd(); - } - - JToken? next = t.Next; - if ((next == null || next == t) || t == t.Parent!.Last) - { - if (t.Parent == null) - { - return ReadToEnd(); - } - - return SetEnd(t.Parent); - } - else - { - _current = next; - SetToken(_current); - return true; - } - } - - private bool ReadToEnd() - { - _current = null; - SetToken(JsonToken.None); - return false; - } - - private JsonToken? GetEndToken(JContainer c) - { - switch (c.Type) - { - case JTokenType.Object: - return JsonToken.EndObject; - case JTokenType.Array: - return JsonToken.EndArray; - case JTokenType.Constructor: - return JsonToken.EndConstructor; - case JTokenType.Property: - return null; - default: - throw MiscellaneousUtils.CreateArgumentOutOfRangeException(nameof(c.Type), c.Type, "Unexpected JContainer type."); - } - } - - private bool ReadInto(JContainer c) - { - JToken? firstChild = c.First; - if (firstChild == null) - { - return SetEnd(c); - } - else - { - SetToken(firstChild); - _current = firstChild; - _parent = c; - return true; - } - } - - private bool SetEnd(JContainer c) - { - JsonToken? endToken = GetEndToken(c); - if (endToken != null) - { - SetToken(endToken.GetValueOrDefault()); - _current = c; - _parent = c; - return true; - } - else - { - return ReadOver(c); - } - } - - private void SetToken(JToken token) - { - switch (token.Type) - { - case JTokenType.Object: - SetToken(JsonToken.StartObject); - break; - case JTokenType.Array: - SetToken(JsonToken.StartArray); - break; - case JTokenType.Constructor: - SetToken(JsonToken.StartConstructor, ((JConstructor)token).Name); - break; - case JTokenType.Property: - SetToken(JsonToken.PropertyName, ((JProperty)token).Name); - break; - case JTokenType.Comment: - SetToken(JsonToken.Comment, ((JValue)token).Value); - break; - case JTokenType.Integer: - SetToken(JsonToken.Integer, ((JValue)token).Value); - break; - case JTokenType.Float: - SetToken(JsonToken.Float, ((JValue)token).Value); - break; - case JTokenType.String: - SetToken(JsonToken.String, ((JValue)token).Value); - break; - case JTokenType.Boolean: - SetToken(JsonToken.Boolean, ((JValue)token).Value); - break; - case JTokenType.Null: - SetToken(JsonToken.Null, ((JValue)token).Value); - break; - case JTokenType.Undefined: - SetToken(JsonToken.Undefined, ((JValue)token).Value); - break; - case JTokenType.Date: - { - object? v = ((JValue)token).Value; - if (v is DateTime dt) - { - v = DateTimeUtils.EnsureDateTime(dt, DateTimeZoneHandling); - } - - SetToken(JsonToken.Date, v); - break; - } - case JTokenType.Raw: - SetToken(JsonToken.Raw, ((JValue)token).Value); - break; - case JTokenType.Bytes: - SetToken(JsonToken.Bytes, ((JValue)token).Value); - break; - case JTokenType.Guid: - SetToken(JsonToken.String, SafeToString(((JValue)token).Value)); - break; - case JTokenType.Uri: - { - object? v = ((JValue)token).Value; - SetToken(JsonToken.String, v is Uri uri ? uri.OriginalString : SafeToString(v)); - break; - } - case JTokenType.TimeSpan: - SetToken(JsonToken.String, SafeToString(((JValue)token).Value)); - break; - default: - throw MiscellaneousUtils.CreateArgumentOutOfRangeException(nameof(token.Type), token.Type, "Unexpected JTokenType."); - } - } - - private string? SafeToString(object? value) - { - return value?.ToString(); - } - - bool IJsonLineInfo.HasLineInfo() - { - if (CurrentState == State.Start) - { - return false; - } - - IJsonLineInfo? info = _current; - return (info != null && info.HasLineInfo()); - } - - int IJsonLineInfo.LineNumber - { - get - { - if (CurrentState == State.Start) - { - return 0; - } - - IJsonLineInfo? info = _current; - if (info != null) - { - return info.LineNumber; - } - - return 0; - } - } - - int IJsonLineInfo.LinePosition - { - get - { - if (CurrentState == State.Start) - { - return 0; - } - - IJsonLineInfo? info = _current; - if (info != null) - { - return info.LinePosition; - } - - return 0; - } - } - - /// - /// Gets the path of the current JSON token. - /// - public override string Path - { - get - { - string path = base.Path; - - if (_initialPath == null) - { - _initialPath = _root.Path; - } - - if (!StringUtils.IsNullOrEmpty(_initialPath)) - { - if (StringUtils.IsNullOrEmpty(path)) - { - return _initialPath; - } - - if (path.StartsWith('[')) - { - path = _initialPath + path; - } - else - { - path = _initialPath + "." + path; - } - } - - return path; - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JTokenType.cs b/Source/MyDb/Newtonsoft.Json/Linq/JTokenType.cs deleted file mode 100644 index 3691873..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JTokenType.cs +++ /dev/null @@ -1,123 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Linq -{ - /// - /// Specifies the type of token. - /// - public enum JTokenType - { - /// - /// No token type has been set. - /// - None = 0, - - /// - /// A JSON object. - /// - Object = 1, - - /// - /// A JSON array. - /// - Array = 2, - - /// - /// A JSON constructor. - /// - Constructor = 3, - - /// - /// A JSON object property. - /// - Property = 4, - - /// - /// A comment. - /// - Comment = 5, - - /// - /// An integer value. - /// - Integer = 6, - - /// - /// A float value. - /// - Float = 7, - - /// - /// A string value. - /// - String = 8, - - /// - /// A boolean value. - /// - Boolean = 9, - - /// - /// A null value. - /// - Null = 10, - - /// - /// An undefined value. - /// - Undefined = 11, - - /// - /// A date value. - /// - Date = 12, - - /// - /// A raw JSON value. - /// - Raw = 13, - - /// - /// A collection of bytes value. - /// - Bytes = 14, - - /// - /// A Guid value. - /// - Guid = 15, - - /// - /// A Uri value. - /// - Uri = 16, - - /// - /// A TimeSpan value. - /// - TimeSpan = 17 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JTokenWriter.Async.cs b/Source/MyDb/Newtonsoft.Json/Linq/JTokenWriter.Async.cs deleted file mode 100644 index 1dbed28..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JTokenWriter.Async.cs +++ /dev/null @@ -1,53 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System.Threading; -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - public partial class JTokenWriter - { - // This is the only method that can benefit from Task-based asynchronicity, and that only when - // the reader provides it. - internal override Task WriteTokenAsync(JsonReader reader, bool writeChildren, bool writeDateConstructorAsDate, bool writeComments, CancellationToken cancellationToken) - { - // Since JTokenReader is a common target (and with an optimised path) and since it can't - // read truly async, catch that case. - if (reader is JTokenReader) - { - WriteToken(reader, writeChildren, writeDateConstructorAsDate, writeComments); - return AsyncUtils.CompletedTask; - } - - return WriteTokenSyncReadingAsync(reader, cancellationToken); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JTokenWriter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JTokenWriter.cs deleted file mode 100644 index 9e281c6..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JTokenWriter.cs +++ /dev/null @@ -1,538 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Diagnostics; -using System.Globalization; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. - /// - public partial class JTokenWriter : JsonWriter - { - private JContainer? _token; - private JContainer? _parent; - // used when writer is writing single value and the value has no containing parent - private JValue? _value; - private JToken? _current; - - /// - /// Gets the at the writer's current position. - /// - public JToken? CurrentToken => _current; - - /// - /// Gets the token being written. - /// - /// The token being written. - public JToken? Token - { - get - { - if (_token != null) - { - return _token; - } - - return _value; - } - } - - /// - /// Initializes a new instance of the class writing to the given . - /// - /// The container being written to. - public JTokenWriter(JContainer container) - { - ValidationUtils.ArgumentNotNull(container, nameof(container)); - - _token = container; - _parent = container; - } - - /// - /// Initializes a new instance of the class. - /// - public JTokenWriter() - { - } - - /// - /// Flushes whatever is in the buffer to the underlying . - /// - public override void Flush() - { - } - - /// - /// Closes this writer. - /// If is set to true, the JSON is auto-completed. - /// - /// - /// Setting to true has no additional effect, since the underlying is a type that cannot be closed. - /// - public override void Close() - { - base.Close(); - } - - /// - /// Writes the beginning of a JSON object. - /// - public override void WriteStartObject() - { - base.WriteStartObject(); - - AddParent(new JObject()); - } - - private void AddParent(JContainer container) - { - if (_parent == null) - { - _token = container; - } - else - { - _parent.AddAndSkipParentCheck(container); - } - - _parent = container; - _current = container; - } - - private void RemoveParent() - { - _current = _parent; - _parent = _parent!.Parent; - - if (_parent != null && _parent.Type == JTokenType.Property) - { - _parent = _parent.Parent; - } - } - - /// - /// Writes the beginning of a JSON array. - /// - public override void WriteStartArray() - { - base.WriteStartArray(); - - AddParent(new JArray()); - } - - /// - /// Writes the start of a constructor with the given name. - /// - /// The name of the constructor. - public override void WriteStartConstructor(string name) - { - base.WriteStartConstructor(name); - - AddParent(new JConstructor(name)); - } - - /// - /// Writes the end. - /// - /// The token. - protected override void WriteEnd(JsonToken token) - { - RemoveParent(); - } - - /// - /// Writes the property name of a name/value pair on a JSON object. - /// - /// The name of the property. - public override void WritePropertyName(string name) - { - // avoid duplicate property name exception - // last property name wins - (_parent as JObject)?.Remove(name); - - AddParent(new JProperty(name)); - - // don't set state until after in case of an error - // incorrect state will cause issues if writer is disposed when closing open properties - base.WritePropertyName(name); - } - - private void AddValue(object? value, JsonToken token) - { - AddValue(new JValue(value), token); - } - - internal void AddValue(JValue? value, JsonToken token) - { - if (_parent != null) - { - // TryAdd will return false if an invalid JToken type is added. - // For example, a JComment can't be added to a JObject. - // If there is an invalid JToken type then skip it. - if (_parent.TryAdd(value)) - { - _current = _parent.Last; - - if (_parent.Type == JTokenType.Property) - { - _parent = _parent.Parent; - } - } - } - else - { - _value = value ?? JValue.CreateNull(); - _current = _value; - } - } - - #region WriteValue methods - /// - /// Writes a value. - /// An error will be raised if the value cannot be written as a single JSON token. - /// - /// The value to write. - public override void WriteValue(object? value) - { -#if HAVE_BIG_INTEGER - if (value is BigInteger) - { - InternalWriteValue(JsonToken.Integer); - AddValue(value, JsonToken.Integer); - } - else -#endif - { - base.WriteValue(value); - } - } - - /// - /// Writes a null value. - /// - public override void WriteNull() - { - base.WriteNull(); - AddValue(null, JsonToken.Null); - } - - /// - /// Writes an undefined value. - /// - public override void WriteUndefined() - { - base.WriteUndefined(); - AddValue(null, JsonToken.Undefined); - } - - /// - /// Writes raw JSON. - /// - /// The raw JSON to write. - public override void WriteRaw(string? json) - { - base.WriteRaw(json); - AddValue(new JRaw(json), JsonToken.Raw); - } - - /// - /// Writes a comment /*...*/ containing the specified text. - /// - /// Text to place inside the comment. - public override void WriteComment(string? text) - { - base.WriteComment(text); - AddValue(JValue.CreateComment(text), JsonToken.Comment); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(string? value) - { - base.WriteValue(value); - AddValue(value, JsonToken.String); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(int value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(uint value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(long value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(ulong value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(float value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Float); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(double value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Float); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(bool value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Boolean); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(short value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(ushort value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(char value) - { - base.WriteValue(value); - string s; -#if HAVE_CHAR_TO_STRING_WITH_CULTURE - s = value.ToString(CultureInfo.InvariantCulture); -#else - s = value.ToString(); -#endif - AddValue(s, JsonToken.String); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(byte value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - [CLSCompliant(false)] - public override void WriteValue(sbyte value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Integer); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(decimal value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Float); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(DateTime value) - { - base.WriteValue(value); - value = DateTimeUtils.EnsureDateTime(value, DateTimeZoneHandling); - AddValue(value, JsonToken.Date); - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(DateTimeOffset value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Date); - } -#endif - - /// - /// Writes a [] value. - /// - /// The [] value to write. - public override void WriteValue(byte[]? value) - { - base.WriteValue(value); - AddValue(value, JsonToken.Bytes); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(TimeSpan value) - { - base.WriteValue(value); - AddValue(value, JsonToken.String); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(Guid value) - { - base.WriteValue(value); - AddValue(value, JsonToken.String); - } - - /// - /// Writes a value. - /// - /// The value to write. - public override void WriteValue(Uri? value) - { - base.WriteValue(value); - AddValue(value, JsonToken.String); - } - #endregion - - internal override void WriteToken(JsonReader reader, bool writeChildren, bool writeDateConstructorAsDate, bool writeComments) - { - // cloning the token rather than reading then writing it doesn't lose some type information, e.g. Guid, byte[], etc - if (reader is JTokenReader tokenReader && writeChildren && writeDateConstructorAsDate && writeComments) - { - if (tokenReader.TokenType == JsonToken.None) - { - if (!tokenReader.Read()) - { - return; - } - } - - JToken value = tokenReader.CurrentToken!.CloneToken(); - - if (_parent != null) - { - _parent.Add(value); - _current = _parent.Last; - - // if the writer was in a property then move out of it and up to its parent object - if (_parent.Type == JTokenType.Property) - { - _parent = _parent.Parent; - InternalWriteValue(JsonToken.Null); - } - } - else - { - _current = value; - - if (_token == null && _value == null) - { - _token = value as JContainer; - _value = value as JValue; - } - } - - tokenReader.Skip(); - } - else - { - base.WriteToken(reader, writeChildren, writeDateConstructorAsDate, writeComments); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JValue.Async.cs b/Source/MyDb/Newtonsoft.Json/Linq/JValue.Async.cs deleted file mode 100644 index e80b880..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JValue.Async.cs +++ /dev/null @@ -1,138 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System; -using System.Globalization; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using System.Threading; -using System.Threading.Tasks; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq -{ - public partial class JValue - { - /// - /// Writes this token to a asynchronously. - /// - /// A into which this method will write. - /// The token to monitor for cancellation requests. - /// A collection of which will be used when writing the token. - /// A that represents the asynchronous write operation. - public override Task WriteToAsync(JsonWriter writer, CancellationToken cancellationToken, params JsonConverter[] converters) - { - if (converters != null && converters.Length > 0 && _value != null) - { - JsonConverter? matchingConverter = JsonSerializer.GetMatchingConverter(converters, _value.GetType()); - if (matchingConverter != null && matchingConverter.CanWrite) - { - // TODO: Call WriteJsonAsync when it exists. - matchingConverter.WriteJson(writer, _value, JsonSerializer.CreateDefault()); - return AsyncUtils.CompletedTask; - } - } - - switch (_valueType) - { - case JTokenType.Comment: - return writer.WriteCommentAsync(_value?.ToString(), cancellationToken); - case JTokenType.Raw: - return writer.WriteRawValueAsync(_value?.ToString(), cancellationToken); - case JTokenType.Null: - return writer.WriteNullAsync(cancellationToken); - case JTokenType.Undefined: - return writer.WriteUndefinedAsync(cancellationToken); - case JTokenType.Integer: - if (_value is int i) - { - return writer.WriteValueAsync(i, cancellationToken); - } - - if (_value is long l) - { - return writer.WriteValueAsync(l, cancellationToken); - } - - if (_value is ulong ul) - { - return writer.WriteValueAsync(ul, cancellationToken); - } - -#if HAVE_BIG_INTEGER - if (_value is BigInteger integer) - { - return writer.WriteValueAsync(integer, cancellationToken); - } -#endif - - return writer.WriteValueAsync(Convert.ToInt64(_value, CultureInfo.InvariantCulture), cancellationToken); - case JTokenType.Float: - if (_value is decimal dec) - { - return writer.WriteValueAsync(dec, cancellationToken); - } - - if (_value is double d) - { - return writer.WriteValueAsync(d, cancellationToken); - } - - if (_value is float f) - { - return writer.WriteValueAsync(f, cancellationToken); - } - - return writer.WriteValueAsync(Convert.ToDouble(_value, CultureInfo.InvariantCulture), cancellationToken); - case JTokenType.String: - return writer.WriteValueAsync(_value?.ToString(), cancellationToken); - case JTokenType.Boolean: - return writer.WriteValueAsync(Convert.ToBoolean(_value, CultureInfo.InvariantCulture), cancellationToken); - case JTokenType.Date: - if (_value is DateTimeOffset offset) - { - return writer.WriteValueAsync(offset, cancellationToken); - } - - return writer.WriteValueAsync(Convert.ToDateTime(_value, CultureInfo.InvariantCulture), cancellationToken); - case JTokenType.Bytes: - return writer.WriteValueAsync((byte[]?)_value, cancellationToken); - case JTokenType.Guid: - return writer.WriteValueAsync(_value != null ? (Guid?)_value : null, cancellationToken); - case JTokenType.TimeSpan: - return writer.WriteValueAsync(_value != null ? (TimeSpan?)_value : null, cancellationToken); - case JTokenType.Uri: - return writer.WriteValueAsync((Uri?)_value, cancellationToken); - } - - throw MiscellaneousUtils.CreateArgumentOutOfRangeException(nameof(Type), _valueType, "Unexpected token type."); - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JValue.cs b/Source/MyDb/Newtonsoft.Json/Linq/JValue.cs deleted file mode 100644 index 27d5de8..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JValue.cs +++ /dev/null @@ -1,1187 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Diagnostics; -using Newtonsoft.Json.Utilities; -using System.Globalization; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if HAVE_DYNAMIC -using System.Dynamic; -using System.Linq.Expressions; -#endif -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif - -namespace Newtonsoft.Json.Linq -{ - /// - /// Represents a value in JSON (string, integer, date, etc). - /// - public partial class JValue : JToken, IEquatable, IFormattable, IComparable, IComparable -#if HAVE_ICONVERTIBLE - , IConvertible -#endif - { - private JTokenType _valueType; - private object? _value; - - internal JValue(object? value, JTokenType type) - { - _value = value; - _valueType = type; - } - - /// - /// Initializes a new instance of the class from another object. - /// - /// A object to copy from. - public JValue(JValue other) - : this(other.Value, other.Type) - { - CopyAnnotations(this, other); - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(long value) - : this(value, JTokenType.Integer) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(decimal value) - : this(value, JTokenType.Float) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(char value) - : this(value, JTokenType.String) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - [CLSCompliant(false)] - public JValue(ulong value) - : this(value, JTokenType.Integer) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(double value) - : this(value, JTokenType.Float) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(float value) - : this(value, JTokenType.Float) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(DateTime value) - : this(value, JTokenType.Date) - { - } - -#if HAVE_DATE_TIME_OFFSET - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(DateTimeOffset value) - : this(value, JTokenType.Date) - { - } -#endif - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(bool value) - : this(value, JTokenType.Boolean) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(string? value) - : this(value, JTokenType.String) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(Guid value) - : this(value, JTokenType.Guid) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(Uri? value) - : this(value, (value != null) ? JTokenType.Uri : JTokenType.Null) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(TimeSpan value) - : this(value, JTokenType.TimeSpan) - { - } - - /// - /// Initializes a new instance of the class with the given value. - /// - /// The value. - public JValue(object? value) - : this(value, GetValueType(null, value)) - { - } - - internal override bool DeepEquals(JToken node) - { - if (!(node is JValue other)) - { - return false; - } - if (other == this) - { - return true; - } - - return ValuesEquals(this, other); - } - - /// - /// Gets a value indicating whether this token has child tokens. - /// - /// - /// true if this token has child values; otherwise, false. - /// - public override bool HasValues => false; - -#if HAVE_BIG_INTEGER - private static int CompareBigInteger(BigInteger i1, object i2) - { - int result = i1.CompareTo(ConvertUtils.ToBigInteger(i2)); - - if (result != 0) - { - return result; - } - - // converting a fractional number to a BigInteger will lose the fraction - // check for fraction if result is two numbers are equal - if (i2 is decimal d1) - { - return (0m).CompareTo(Math.Abs(d1 - Math.Truncate(d1))); - } - else if (i2 is double || i2 is float) - { - double d = Convert.ToDouble(i2, CultureInfo.InvariantCulture); - return (0d).CompareTo(Math.Abs(d - Math.Truncate(d))); - } - - return result; - } -#endif - - internal static int Compare(JTokenType valueType, object? objA, object? objB) - { - if (objA == objB) - { - return 0; - } - if (objB == null) - { - return 1; - } - if (objA == null) - { - return -1; - } - - switch (valueType) - { - case JTokenType.Integer: - { -#if HAVE_BIG_INTEGER - if (objA is BigInteger integerA) - { - return CompareBigInteger(integerA, objB); - } - if (objB is BigInteger integerB) - { - return -CompareBigInteger(integerB, objA); - } -#endif - if (objA is ulong || objB is ulong || objA is decimal || objB is decimal) - { - return Convert.ToDecimal(objA, CultureInfo.InvariantCulture).CompareTo(Convert.ToDecimal(objB, CultureInfo.InvariantCulture)); - } - else if (objA is float || objB is float || objA is double || objB is double) - { - return CompareFloat(objA, objB); - } - else - { - return Convert.ToInt64(objA, CultureInfo.InvariantCulture).CompareTo(Convert.ToInt64(objB, CultureInfo.InvariantCulture)); - } - } - case JTokenType.Float: - { -#if HAVE_BIG_INTEGER - if (objA is BigInteger integerA) - { - return CompareBigInteger(integerA, objB); - } - if (objB is BigInteger integerB) - { - return -CompareBigInteger(integerB, objA); - } -#endif - if (objA is ulong || objB is ulong || objA is decimal || objB is decimal) - { - return Convert.ToDecimal(objA, CultureInfo.InvariantCulture).CompareTo(Convert.ToDecimal(objB, CultureInfo.InvariantCulture)); - } - return CompareFloat(objA, objB); - } - case JTokenType.Comment: - case JTokenType.String: - case JTokenType.Raw: - string s1 = Convert.ToString(objA, CultureInfo.InvariantCulture); - string s2 = Convert.ToString(objB, CultureInfo.InvariantCulture); - - return string.CompareOrdinal(s1, s2); - case JTokenType.Boolean: - bool b1 = Convert.ToBoolean(objA, CultureInfo.InvariantCulture); - bool b2 = Convert.ToBoolean(objB, CultureInfo.InvariantCulture); - - return b1.CompareTo(b2); - case JTokenType.Date: -#if HAVE_DATE_TIME_OFFSET - if (objA is DateTime dateA) - { -#else - DateTime dateA = (DateTime)objA; -#endif - DateTime dateB; - -#if HAVE_DATE_TIME_OFFSET - if (objB is DateTimeOffset offsetB) - { - dateB = offsetB.DateTime; - } - else -#endif - { - dateB = Convert.ToDateTime(objB, CultureInfo.InvariantCulture); - } - - return dateA.CompareTo(dateB); -#if HAVE_DATE_TIME_OFFSET - } - else - { - DateTimeOffset offsetA = (DateTimeOffset)objA; - if (!(objB is DateTimeOffset offsetB)) - { - offsetB = new DateTimeOffset(Convert.ToDateTime(objB, CultureInfo.InvariantCulture)); - } - - return offsetA.CompareTo(offsetB); - } -#endif - case JTokenType.Bytes: - if (!(objB is byte[] bytesB)) - { - throw new ArgumentException("Object must be of type byte[]."); - } - - byte[]? bytesA = objA as byte[]; - MiscellaneousUtils.Assert(bytesA != null); - - return MiscellaneousUtils.ByteArrayCompare(bytesA!, bytesB); - case JTokenType.Guid: - if (!(objB is Guid)) - { - throw new ArgumentException("Object must be of type Guid."); - } - - Guid guid1 = (Guid)objA; - Guid guid2 = (Guid)objB; - - return guid1.CompareTo(guid2); - case JTokenType.Uri: - Uri? uri2 = objB as Uri; - if (uri2 == null) - { - throw new ArgumentException("Object must be of type Uri."); - } - - Uri uri1 = (Uri)objA; - - return Comparer.Default.Compare(uri1.ToString(), uri2.ToString()); - case JTokenType.TimeSpan: - if (!(objB is TimeSpan)) - { - throw new ArgumentException("Object must be of type TimeSpan."); - } - - TimeSpan ts1 = (TimeSpan)objA; - TimeSpan ts2 = (TimeSpan)objB; - - return ts1.CompareTo(ts2); - default: - throw MiscellaneousUtils.CreateArgumentOutOfRangeException(nameof(valueType), valueType, "Unexpected value type: {0}".FormatWith(CultureInfo.InvariantCulture, valueType)); - } - } - - private static int CompareFloat(object objA, object objB) - { - double d1 = Convert.ToDouble(objA, CultureInfo.InvariantCulture); - double d2 = Convert.ToDouble(objB, CultureInfo.InvariantCulture); - - // take into account possible floating point errors - if (MathUtils.ApproxEquals(d1, d2)) - { - return 0; - } - - return d1.CompareTo(d2); - } - -#if HAVE_EXPRESSIONS - private static bool Operation(ExpressionType operation, object? objA, object? objB, out object? result) - { - if (objA is string || objB is string) - { - if (operation == ExpressionType.Add || operation == ExpressionType.AddAssign) - { - result = objA?.ToString() + objB?.ToString(); - return true; - } - } - -#if HAVE_BIG_INTEGER - if (objA is BigInteger || objB is BigInteger) - { - if (objA == null || objB == null) - { - result = null; - return true; - } - - // not that this will lose the fraction - // BigInteger doesn't have operators with non-integer types - BigInteger i1 = ConvertUtils.ToBigInteger(objA); - BigInteger i2 = ConvertUtils.ToBigInteger(objB); - - switch (operation) - { - case ExpressionType.Add: - case ExpressionType.AddAssign: - result = i1 + i2; - return true; - case ExpressionType.Subtract: - case ExpressionType.SubtractAssign: - result = i1 - i2; - return true; - case ExpressionType.Multiply: - case ExpressionType.MultiplyAssign: - result = i1 * i2; - return true; - case ExpressionType.Divide: - case ExpressionType.DivideAssign: - result = i1 / i2; - return true; - } - } - else -#endif - if (objA is ulong || objB is ulong || objA is decimal || objB is decimal) - { - if (objA == null || objB == null) - { - result = null; - return true; - } - - decimal d1 = Convert.ToDecimal(objA, CultureInfo.InvariantCulture); - decimal d2 = Convert.ToDecimal(objB, CultureInfo.InvariantCulture); - - switch (operation) - { - case ExpressionType.Add: - case ExpressionType.AddAssign: - result = d1 + d2; - return true; - case ExpressionType.Subtract: - case ExpressionType.SubtractAssign: - result = d1 - d2; - return true; - case ExpressionType.Multiply: - case ExpressionType.MultiplyAssign: - result = d1 * d2; - return true; - case ExpressionType.Divide: - case ExpressionType.DivideAssign: - result = d1 / d2; - return true; - } - } - else if (objA is float || objB is float || objA is double || objB is double) - { - if (objA == null || objB == null) - { - result = null; - return true; - } - - double d1 = Convert.ToDouble(objA, CultureInfo.InvariantCulture); - double d2 = Convert.ToDouble(objB, CultureInfo.InvariantCulture); - - switch (operation) - { - case ExpressionType.Add: - case ExpressionType.AddAssign: - result = d1 + d2; - return true; - case ExpressionType.Subtract: - case ExpressionType.SubtractAssign: - result = d1 - d2; - return true; - case ExpressionType.Multiply: - case ExpressionType.MultiplyAssign: - result = d1 * d2; - return true; - case ExpressionType.Divide: - case ExpressionType.DivideAssign: - result = d1 / d2; - return true; - } - } - else if (objA is int || objA is uint || objA is long || objA is short || objA is ushort || objA is sbyte || objA is byte || - objB is int || objB is uint || objB is long || objB is short || objB is ushort || objB is sbyte || objB is byte) - { - if (objA == null || objB == null) - { - result = null; - return true; - } - - long l1 = Convert.ToInt64(objA, CultureInfo.InvariantCulture); - long l2 = Convert.ToInt64(objB, CultureInfo.InvariantCulture); - - switch (operation) - { - case ExpressionType.Add: - case ExpressionType.AddAssign: - result = l1 + l2; - return true; - case ExpressionType.Subtract: - case ExpressionType.SubtractAssign: - result = l1 - l2; - return true; - case ExpressionType.Multiply: - case ExpressionType.MultiplyAssign: - result = l1 * l2; - return true; - case ExpressionType.Divide: - case ExpressionType.DivideAssign: - result = l1 / l2; - return true; - } - } - - result = null; - return false; - } -#endif - - internal override JToken CloneToken() - { - return new JValue(this); - } - - /// - /// Creates a comment with the given value. - /// - /// The value. - /// A comment with the given value. - public static JValue CreateComment(string? value) - { - return new JValue(value, JTokenType.Comment); - } - - /// - /// Creates a string with the given value. - /// - /// The value. - /// A string with the given value. - public static JValue CreateString(string? value) - { - return new JValue(value, JTokenType.String); - } - - /// - /// Creates a null value. - /// - /// A null value. - public static JValue CreateNull() - { - return new JValue(null, JTokenType.Null); - } - - /// - /// Creates a undefined value. - /// - /// A undefined value. - public static JValue CreateUndefined() - { - return new JValue(null, JTokenType.Undefined); - } - - private static JTokenType GetValueType(JTokenType? current, object? value) - { - if (value == null) - { - return JTokenType.Null; - } -#if HAVE_ADO_NET - else if (value == DBNull.Value) - { - return JTokenType.Null; - } -#endif - else if (value is string) - { - return GetStringValueType(current); - } - else if (value is long || value is int || value is short || value is sbyte - || value is ulong || value is uint || value is ushort || value is byte) - { - return JTokenType.Integer; - } - else if (value is Enum) - { - return JTokenType.Integer; - } -#if HAVE_BIG_INTEGER - else if (value is BigInteger) - { - return JTokenType.Integer; - } -#endif - else if (value is double || value is float || value is decimal) - { - return JTokenType.Float; - } - else if (value is DateTime) - { - return JTokenType.Date; - } -#if HAVE_DATE_TIME_OFFSET - else if (value is DateTimeOffset) - { - return JTokenType.Date; - } -#endif - else if (value is byte[]) - { - return JTokenType.Bytes; - } - else if (value is bool) - { - return JTokenType.Boolean; - } - else if (value is Guid) - { - return JTokenType.Guid; - } - else if (value is Uri) - { - return JTokenType.Uri; - } - else if (value is TimeSpan) - { - return JTokenType.TimeSpan; - } - - throw new ArgumentException("Could not determine JSON object type for type {0}.".FormatWith(CultureInfo.InvariantCulture, value.GetType())); - } - - private static JTokenType GetStringValueType(JTokenType? current) - { - if (current == null) - { - return JTokenType.String; - } - - switch (current.GetValueOrDefault()) - { - case JTokenType.Comment: - case JTokenType.String: - case JTokenType.Raw: - return current.GetValueOrDefault(); - default: - return JTokenType.String; - } - } - - /// - /// Gets the node type for this . - /// - /// The type. - public override JTokenType Type => _valueType; - - /// - /// Gets or sets the underlying token value. - /// - /// The underlying token value. - public object? Value - { - get => _value; - set - { - Type? currentType = _value?.GetType(); - Type? newType = value?.GetType(); - - if (currentType != newType) - { - _valueType = GetValueType(_valueType, value); - } - - _value = value; - } - } - - /// - /// Writes this token to a . - /// - /// A into which this method will write. - /// A collection of s which will be used when writing the token. - public override void WriteTo(JsonWriter writer, params JsonConverter[] converters) - { - if (converters != null && converters.Length > 0 && _value != null) - { - JsonConverter? matchingConverter = JsonSerializer.GetMatchingConverter(converters, _value.GetType()); - if (matchingConverter != null && matchingConverter.CanWrite) - { - matchingConverter.WriteJson(writer, _value, JsonSerializer.CreateDefault()); - return; - } - } - - switch (_valueType) - { - case JTokenType.Comment: - writer.WriteComment(_value?.ToString()); - return; - case JTokenType.Raw: - writer.WriteRawValue(_value?.ToString()); - return; - case JTokenType.Null: - writer.WriteNull(); - return; - case JTokenType.Undefined: - writer.WriteUndefined(); - return; - case JTokenType.Integer: - if (_value is int i) - { - writer.WriteValue(i); - } - else if (_value is long l) - { - writer.WriteValue(l); - } - else if (_value is ulong ul) - { - writer.WriteValue(ul); - } -#if HAVE_BIG_INTEGER - else if (_value is BigInteger integer) - { - writer.WriteValue(integer); - } -#endif - else - { - writer.WriteValue(Convert.ToInt64(_value, CultureInfo.InvariantCulture)); - } - return; - case JTokenType.Float: - if (_value is decimal dec) - { - writer.WriteValue(dec); - } - else if (_value is double d) - { - writer.WriteValue(d); - } - else if (_value is float f) - { - writer.WriteValue(f); - } - else - { - writer.WriteValue(Convert.ToDouble(_value, CultureInfo.InvariantCulture)); - } - return; - case JTokenType.String: - writer.WriteValue(_value?.ToString()); - return; - case JTokenType.Boolean: - writer.WriteValue(Convert.ToBoolean(_value, CultureInfo.InvariantCulture)); - return; - case JTokenType.Date: -#if HAVE_DATE_TIME_OFFSET - if (_value is DateTimeOffset offset) - { - writer.WriteValue(offset); - } - else -#endif - { - writer.WriteValue(Convert.ToDateTime(_value, CultureInfo.InvariantCulture)); - } - return; - case JTokenType.Bytes: - writer.WriteValue((byte[]?)_value); - return; - case JTokenType.Guid: - writer.WriteValue((_value != null) ? (Guid?)_value : null); - return; - case JTokenType.TimeSpan: - writer.WriteValue((_value != null) ? (TimeSpan?)_value : null); - return; - case JTokenType.Uri: - writer.WriteValue((Uri?)_value); - return; - } - - throw MiscellaneousUtils.CreateArgumentOutOfRangeException(nameof(Type), _valueType, "Unexpected token type."); - } - - internal override int GetDeepHashCode() - { - int valueHashCode = (_value != null) ? _value.GetHashCode() : 0; - - // GetHashCode on an enum boxes so cast to int - return ((int)_valueType).GetHashCode() ^ valueHashCode; - } - - private static bool ValuesEquals(JValue v1, JValue v2) - { - return (v1 == v2 || (v1._valueType == v2._valueType && Compare(v1._valueType, v1._value, v2._value) == 0)); - } - - /// - /// Indicates whether the current object is equal to another object of the same type. - /// - /// - /// true if the current object is equal to the parameter; otherwise, false. - /// - /// An object to compare with this object. - public bool Equals(JValue? other) - { - if (other == null) - { - return false; - } - - return ValuesEquals(this, other); - } - - /// - /// Determines whether the specified is equal to the current . - /// - /// The to compare with the current . - /// - /// true if the specified is equal to the current ; otherwise, false. - /// - public override bool Equals(object obj) - { - if (obj is JValue v) - { - return Equals(v); - } - - return false; - } - - /// - /// Serves as a hash function for a particular type. - /// - /// - /// A hash code for the current . - /// - public override int GetHashCode() - { - if (_value == null) - { - return 0; - } - - return _value.GetHashCode(); - } - - /// - /// Returns a that represents this instance. - /// - /// - /// ToString() returns a non-JSON string value for tokens with a type of . - /// If you want the JSON for all token types then you should use . - /// - /// - /// A that represents this instance. - /// - public override string ToString() - { - if (_value == null) - { - return string.Empty; - } - - return _value.ToString(); - } - - /// - /// Returns a that represents this instance. - /// - /// The format. - /// - /// A that represents this instance. - /// - public string ToString(string format) - { - return ToString(format, CultureInfo.CurrentCulture); - } - - /// - /// Returns a that represents this instance. - /// - /// The format provider. - /// - /// A that represents this instance. - /// - public string ToString(IFormatProvider formatProvider) - { - return ToString(null, formatProvider); - } - - /// - /// Returns a that represents this instance. - /// - /// The format. - /// The format provider. - /// - /// A that represents this instance. - /// - public string ToString(string? format, IFormatProvider formatProvider) - { - if (_value == null) - { - return string.Empty; - } - - if (_value is IFormattable formattable) - { - return formattable.ToString(format, formatProvider); - } - else - { - return _value.ToString(); - } - } - -#if HAVE_DYNAMIC - /// - /// Returns the responsible for binding operations performed on this object. - /// - /// The expression tree representation of the runtime value. - /// - /// The to bind this object. - /// - protected override DynamicMetaObject GetMetaObject(Expression parameter) - { - return new DynamicProxyMetaObject(parameter, this, new JValueDynamicProxy()); - } - - private class JValueDynamicProxy : DynamicProxy - { - public override bool TryConvert(JValue instance, ConvertBinder binder, [NotNullWhen(true)]out object? result) - { - if (binder.Type == typeof(JValue) || binder.Type == typeof(JToken)) - { - result = instance; - return true; - } - - object? value = instance.Value; - - if (value == null) - { - result = null; - return ReflectionUtils.IsNullable(binder.Type); - } - - result = ConvertUtils.Convert(value, CultureInfo.InvariantCulture, binder.Type); - return true; - } - - public override bool TryBinaryOperation(JValue instance, BinaryOperationBinder binder, object arg, [NotNullWhen(true)]out object? result) - { - object? compareValue = arg is JValue value ? value.Value : arg; - - switch (binder.Operation) - { - case ExpressionType.Equal: - result = (Compare(instance.Type, instance.Value, compareValue) == 0); - return true; - case ExpressionType.NotEqual: - result = (Compare(instance.Type, instance.Value, compareValue) != 0); - return true; - case ExpressionType.GreaterThan: - result = (Compare(instance.Type, instance.Value, compareValue) > 0); - return true; - case ExpressionType.GreaterThanOrEqual: - result = (Compare(instance.Type, instance.Value, compareValue) >= 0); - return true; - case ExpressionType.LessThan: - result = (Compare(instance.Type, instance.Value, compareValue) < 0); - return true; - case ExpressionType.LessThanOrEqual: - result = (Compare(instance.Type, instance.Value, compareValue) <= 0); - return true; - case ExpressionType.Add: - case ExpressionType.AddAssign: - case ExpressionType.Subtract: - case ExpressionType.SubtractAssign: - case ExpressionType.Multiply: - case ExpressionType.MultiplyAssign: - case ExpressionType.Divide: - case ExpressionType.DivideAssign: - if (Operation(binder.Operation, instance.Value, compareValue, out result)) - { - result = new JValue(result); - return true; - } - break; - } - - result = null; - return false; - } - } -#endif - - int IComparable.CompareTo(object obj) - { - if (obj == null) - { - return 1; - } - - JTokenType comparisonType; - object? otherValue; - if (obj is JValue value) - { - otherValue = value.Value; - comparisonType = (_valueType == JTokenType.String && _valueType != value._valueType) - ? value._valueType - : _valueType; - } - else - { - otherValue = obj; - comparisonType = _valueType; - } - - return Compare(comparisonType, _value, otherValue); - } - - /// - /// Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object. - /// - /// An object to compare with this instance. - /// - /// A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has these meanings: - /// Value - /// Meaning - /// Less than zero - /// This instance is less than . - /// Zero - /// This instance is equal to . - /// Greater than zero - /// This instance is greater than . - /// - /// - /// is not of the same type as this instance. - /// - public int CompareTo(JValue obj) - { - if (obj == null) - { - return 1; - } - - JTokenType comparisonType = (_valueType == JTokenType.String && _valueType != obj._valueType) - ? obj._valueType - : _valueType; - - return Compare(comparisonType, _value, obj._value); - } - -#if HAVE_ICONVERTIBLE - TypeCode IConvertible.GetTypeCode() - { - if (_value == null) - { - return TypeCode.Empty; - } - - if (_value is IConvertible convertable) - { - return convertable.GetTypeCode(); - } - - return TypeCode.Object; - } - - bool IConvertible.ToBoolean(IFormatProvider provider) - { - return (bool)this; - } - - char IConvertible.ToChar(IFormatProvider provider) - { - return (char)this; - } - - sbyte IConvertible.ToSByte(IFormatProvider provider) - { - return (sbyte)this; - } - - byte IConvertible.ToByte(IFormatProvider provider) - { - return (byte)this; - } - - short IConvertible.ToInt16(IFormatProvider provider) - { - return (short)this; - } - - ushort IConvertible.ToUInt16(IFormatProvider provider) - { - return (ushort)this; - } - - int IConvertible.ToInt32(IFormatProvider provider) - { - return (int)this; - } - - uint IConvertible.ToUInt32(IFormatProvider provider) - { - return (uint)this; - } - - long IConvertible.ToInt64(IFormatProvider provider) - { - return (long)this; - } - - ulong IConvertible.ToUInt64(IFormatProvider provider) - { - return (ulong)this; - } - - float IConvertible.ToSingle(IFormatProvider provider) - { - return (float)this; - } - - double IConvertible.ToDouble(IFormatProvider provider) - { - return (double)this; - } - - decimal IConvertible.ToDecimal(IFormatProvider provider) - { - return (decimal)this; - } - - DateTime IConvertible.ToDateTime(IFormatProvider provider) - { - return (DateTime)this; - } - - object? IConvertible.ToType(Type conversionType, IFormatProvider provider) - { - return ToObject(conversionType); - } -#endif - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonLoadSettings.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonLoadSettings.cs deleted file mode 100644 index 64aba4c..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonLoadSettings.cs +++ /dev/null @@ -1,81 +0,0 @@ -using System; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Specifies the settings used when loading JSON. - /// - public class JsonLoadSettings - { - private CommentHandling _commentHandling; - private LineInfoHandling _lineInfoHandling; - private DuplicatePropertyNameHandling _duplicatePropertyNameHandling; - - /// - /// Initializes a new instance of the class. - /// - public JsonLoadSettings() - { - _lineInfoHandling = LineInfoHandling.Load; - _commentHandling = CommentHandling.Ignore; - _duplicatePropertyNameHandling = DuplicatePropertyNameHandling.Replace; - } - - /// - /// Gets or sets how JSON comments are handled when loading JSON. - /// The default value is . - /// - /// The JSON comment handling. - public CommentHandling CommentHandling - { - get => _commentHandling; - set - { - if (value < CommentHandling.Ignore || value > CommentHandling.Load) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _commentHandling = value; - } - } - - /// - /// Gets or sets how JSON line info is handled when loading JSON. - /// The default value is . - /// - /// The JSON line info handling. - public LineInfoHandling LineInfoHandling - { - get => _lineInfoHandling; - set - { - if (value < LineInfoHandling.Ignore || value > LineInfoHandling.Load) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _lineInfoHandling = value; - } - } - - /// - /// Gets or sets how duplicate property names in JSON objects are handled when loading JSON. - /// The default value is . - /// - /// The JSON duplicate property name handling. - public DuplicatePropertyNameHandling DuplicatePropertyNameHandling - { - get => _duplicatePropertyNameHandling; - set - { - if (value < DuplicatePropertyNameHandling.Replace || value > DuplicatePropertyNameHandling.Error) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _duplicatePropertyNameHandling = value; - } - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonMergeSettings.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonMergeSettings.cs deleted file mode 100644 index 4de8fff..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonMergeSettings.cs +++ /dev/null @@ -1,103 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Specifies the settings used when merging JSON. - /// - public class JsonMergeSettings - { - private MergeArrayHandling _mergeArrayHandling; - private MergeNullValueHandling _mergeNullValueHandling; - private StringComparison _propertyNameComparison; - - /// - /// Initializes a new instance of the class. - /// - public JsonMergeSettings() - { - _propertyNameComparison = StringComparison.Ordinal; - } - - /// - /// Gets or sets the method used when merging JSON arrays. - /// - /// The method used when merging JSON arrays. - public MergeArrayHandling MergeArrayHandling - { - get => _mergeArrayHandling; - set - { - if (value < MergeArrayHandling.Concat || value > MergeArrayHandling.Merge) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _mergeArrayHandling = value; - } - } - - /// - /// Gets or sets how null value properties are merged. - /// - /// How null value properties are merged. - public MergeNullValueHandling MergeNullValueHandling - { - get => _mergeNullValueHandling; - set - { - if (value < MergeNullValueHandling.Ignore || value > MergeNullValueHandling.Merge) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _mergeNullValueHandling = value; - } - } - - /// - /// Gets or sets the comparison used to match property names while merging. - /// The exact property name will be searched for first and if no matching property is found then - /// the will be used to match a property. - /// - /// The comparison used to match property names while merging. - public StringComparison PropertyNameComparison - { - get => _propertyNameComparison; - set - { - if (value < StringComparison.CurrentCulture || value > StringComparison.OrdinalIgnoreCase) - { - throw new ArgumentOutOfRangeException(nameof(value)); - } - - _propertyNameComparison = value; - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ArrayIndexFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ArrayIndexFilter.cs deleted file mode 100644 index 0378713..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ArrayIndexFilter.cs +++ /dev/null @@ -1,44 +0,0 @@ -using System.Collections.Generic; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class ArrayIndexFilter : PathFilter - { - public int? Index { get; set; } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - foreach (JToken t in current) - { - if (Index != null) - { - JToken? v = GetTokenIndex(t, settings, Index.GetValueOrDefault()); - - if (v != null) - { - yield return v; - } - } - else - { - if (t is JArray || t is JConstructor) - { - foreach (JToken v in t) - { - yield return v; - } - } - else - { - if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Index * not valid on {0}.".FormatWith(CultureInfo.InvariantCulture, t.GetType().Name)); - } - } - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ArrayMultipleIndexFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ArrayMultipleIndexFilter.cs deleted file mode 100644 index e149229..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ArrayMultipleIndexFilter.cs +++ /dev/null @@ -1,30 +0,0 @@ -using System.Collections.Generic; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class ArrayMultipleIndexFilter : PathFilter - { - internal List Indexes; - - public ArrayMultipleIndexFilter(List indexes) - { - Indexes = indexes; - } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - foreach (JToken t in current) - { - foreach (int i in Indexes) - { - JToken? v = GetTokenIndex(t, settings, i); - - if (v != null) - { - yield return v; - } - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ArraySliceFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ArraySliceFilter.cs deleted file mode 100644 index c948b5e..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ArraySliceFilter.cs +++ /dev/null @@ -1,87 +0,0 @@ -using System; -using System.Collections.Generic; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class ArraySliceFilter : PathFilter - { - public int? Start { get; set; } - public int? End { get; set; } - public int? Step { get; set; } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - if (Step == 0) - { - throw new JsonException("Step cannot be zero."); - } - - foreach (JToken t in current) - { - if (t is JArray a) - { - // set defaults for null arguments - int stepCount = Step ?? 1; - int startIndex = Start ?? ((stepCount > 0) ? 0 : a.Count - 1); - int stopIndex = End ?? ((stepCount > 0) ? a.Count : -1); - - // start from the end of the list if start is negative - if (Start < 0) - { - startIndex = a.Count + startIndex; - } - - // end from the start of the list if stop is negative - if (End < 0) - { - stopIndex = a.Count + stopIndex; - } - - // ensure indexes keep within collection bounds - startIndex = Math.Max(startIndex, (stepCount > 0) ? 0 : int.MinValue); - startIndex = Math.Min(startIndex, (stepCount > 0) ? a.Count : a.Count - 1); - stopIndex = Math.Max(stopIndex, -1); - stopIndex = Math.Min(stopIndex, a.Count); - - bool positiveStep = (stepCount > 0); - - if (IsValid(startIndex, stopIndex, positiveStep)) - { - for (int i = startIndex; IsValid(i, stopIndex, positiveStep); i += stepCount) - { - yield return a[i]; - } - } - else - { - if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Array slice of {0} to {1} returned no results.".FormatWith(CultureInfo.InvariantCulture, - Start != null ? Start.GetValueOrDefault().ToString(CultureInfo.InvariantCulture) : "*", - End != null ? End.GetValueOrDefault().ToString(CultureInfo.InvariantCulture) : "*")); - } - } - } - else - { - if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Array slice is not valid on {0}.".FormatWith(CultureInfo.InvariantCulture, t.GetType().Name)); - } - } - } - } - - private bool IsValid(int index, int stopIndex, bool positiveStep) - { - if (positiveStep) - { - return (index < stopIndex); - } - - return (index > stopIndex); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/FieldFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/FieldFilter.cs deleted file mode 100644 index 97f6381..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/FieldFilter.cs +++ /dev/null @@ -1,53 +0,0 @@ -using System.Collections.Generic; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class FieldFilter : PathFilter - { - internal string? Name; - - public FieldFilter(string? name) - { - Name = name; - } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - foreach (JToken t in current) - { - if (t is JObject o) - { - if (Name != null) - { - JToken? v = o[Name]; - - if (v != null) - { - yield return v; - } - else if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Property '{0}' does not exist on JObject.".FormatWith(CultureInfo.InvariantCulture, Name)); - } - } - else - { - foreach (KeyValuePair p in o) - { - yield return p.Value!; - } - } - } - else - { - if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Property '{0}' not valid on {1}.".FormatWith(CultureInfo.InvariantCulture, Name ?? "*", t.GetType().Name)); - } - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/FieldMultipleFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/FieldMultipleFilter.cs deleted file mode 100644 index c3eb703..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/FieldMultipleFilter.cs +++ /dev/null @@ -1,56 +0,0 @@ -using System.Collections.Generic; -using System.Globalization; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class FieldMultipleFilter : PathFilter - { - internal List Names; - - public FieldMultipleFilter(List names) - { - Names = names; - } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - foreach (JToken t in current) - { - if (t is JObject o) - { - foreach (string name in Names) - { - JToken? v = o[name]; - - if (v != null) - { - yield return v; - } - - if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Property '{0}' does not exist on JObject.".FormatWith(CultureInfo.InvariantCulture, name)); - } - } - } - else - { - if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Properties {0} not valid on {1}.".FormatWith(CultureInfo.InvariantCulture, string.Join(", ", Names.Select(n => "'" + n + "'") -#if !HAVE_STRING_JOIN_WITH_ENUMERABLE - .ToArray() -#endif - ), t.GetType().Name)); - } - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/JPath.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/JPath.cs deleted file mode 100644 index c29fcd0..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/JPath.cs +++ /dev/null @@ -1,893 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; -using System.Text; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class JPath - { - private static readonly char[] FloatCharacters = new[] {'.', 'E', 'e'}; - - private readonly string _expression; - public List Filters { get; } - - private int _currentIndex; - - public JPath(string expression) - { - ValidationUtils.ArgumentNotNull(expression, nameof(expression)); - _expression = expression; - Filters = new List(); - - ParseMain(); - } - - private void ParseMain() - { - int currentPartStartIndex = _currentIndex; - - EatWhitespace(); - - if (_expression.Length == _currentIndex) - { - return; - } - - if (_expression[_currentIndex] == '$') - { - if (_expression.Length == 1) - { - return; - } - - // only increment position for "$." or "$[" - // otherwise assume property that starts with $ - char c = _expression[_currentIndex + 1]; - if (c == '.' || c == '[') - { - _currentIndex++; - currentPartStartIndex = _currentIndex; - } - } - - if (!ParsePath(Filters, currentPartStartIndex, false)) - { - int lastCharacterIndex = _currentIndex; - - EatWhitespace(); - - if (_currentIndex < _expression.Length) - { - throw new JsonException("Unexpected character while parsing path: " + _expression[lastCharacterIndex]); - } - } - } - - private bool ParsePath(List filters, int currentPartStartIndex, bool query) - { - bool scan = false; - bool followingIndexer = false; - bool followingDot = false; - - bool ended = false; - while (_currentIndex < _expression.Length && !ended) - { - char currentChar = _expression[_currentIndex]; - - switch (currentChar) - { - case '[': - case '(': - if (_currentIndex > currentPartStartIndex) - { - string? member = _expression.Substring(currentPartStartIndex, _currentIndex - currentPartStartIndex); - if (member == "*") - { - member = null; - } - - filters.Add(CreatePathFilter(member, scan)); - scan = false; - } - - filters.Add(ParseIndexer(currentChar, scan)); - scan = false; - - _currentIndex++; - currentPartStartIndex = _currentIndex; - followingIndexer = true; - followingDot = false; - break; - case ']': - case ')': - ended = true; - break; - case ' ': - if (_currentIndex < _expression.Length) - { - ended = true; - } - break; - case '.': - if (_currentIndex > currentPartStartIndex) - { - string? member = _expression.Substring(currentPartStartIndex, _currentIndex - currentPartStartIndex); - if (member == "*") - { - member = null; - } - - filters.Add(CreatePathFilter(member, scan)); - scan = false; - } - if (_currentIndex + 1 < _expression.Length && _expression[_currentIndex + 1] == '.') - { - scan = true; - _currentIndex++; - } - _currentIndex++; - currentPartStartIndex = _currentIndex; - followingIndexer = false; - followingDot = true; - break; - default: - if (query && (currentChar == '=' || currentChar == '<' || currentChar == '!' || currentChar == '>' || currentChar == '|' || currentChar == '&')) - { - ended = true; - } - else - { - if (followingIndexer) - { - throw new JsonException("Unexpected character following indexer: " + currentChar); - } - - _currentIndex++; - } - break; - } - } - - bool atPathEnd = (_currentIndex == _expression.Length); - - if (_currentIndex > currentPartStartIndex) - { - string? member = _expression.Substring(currentPartStartIndex, _currentIndex - currentPartStartIndex).TrimEnd(); - if (member == "*") - { - member = null; - } - filters.Add(CreatePathFilter(member, scan)); - } - else - { - // no field name following dot in path and at end of base path/query - if (followingDot && (atPathEnd || query)) - { - throw new JsonException("Unexpected end while parsing path."); - } - } - - return atPathEnd; - } - - private static PathFilter CreatePathFilter(string? member, bool scan) - { - PathFilter filter = (scan) ? (PathFilter)new ScanFilter(member) : new FieldFilter(member); - return filter; - } - - private PathFilter ParseIndexer(char indexerOpenChar, bool scan) - { - _currentIndex++; - - char indexerCloseChar = (indexerOpenChar == '[') ? ']' : ')'; - - EnsureLength("Path ended with open indexer."); - - EatWhitespace(); - - if (_expression[_currentIndex] == '\'') - { - return ParseQuotedField(indexerCloseChar, scan); - } - else if (_expression[_currentIndex] == '?') - { - return ParseQuery(indexerCloseChar, scan); - } - else - { - return ParseArrayIndexer(indexerCloseChar); - } - } - - private PathFilter ParseArrayIndexer(char indexerCloseChar) - { - int start = _currentIndex; - int? end = null; - List? indexes = null; - int colonCount = 0; - int? startIndex = null; - int? endIndex = null; - int? step = null; - - while (_currentIndex < _expression.Length) - { - char currentCharacter = _expression[_currentIndex]; - - if (currentCharacter == ' ') - { - end = _currentIndex; - EatWhitespace(); - continue; - } - - if (currentCharacter == indexerCloseChar) - { - int length = (end ?? _currentIndex) - start; - - if (indexes != null) - { - if (length == 0) - { - throw new JsonException("Array index expected."); - } - - string indexer = _expression.Substring(start, length); - int index = Convert.ToInt32(indexer, CultureInfo.InvariantCulture); - - indexes.Add(index); - return new ArrayMultipleIndexFilter(indexes); - } - else if (colonCount > 0) - { - if (length > 0) - { - string indexer = _expression.Substring(start, length); - int index = Convert.ToInt32(indexer, CultureInfo.InvariantCulture); - - if (colonCount == 1) - { - endIndex = index; - } - else - { - step = index; - } - } - - return new ArraySliceFilter { Start = startIndex, End = endIndex, Step = step }; - } - else - { - if (length == 0) - { - throw new JsonException("Array index expected."); - } - - string indexer = _expression.Substring(start, length); - int index = Convert.ToInt32(indexer, CultureInfo.InvariantCulture); - - return new ArrayIndexFilter { Index = index }; - } - } - else if (currentCharacter == ',') - { - int length = (end ?? _currentIndex) - start; - - if (length == 0) - { - throw new JsonException("Array index expected."); - } - - if (indexes == null) - { - indexes = new List(); - } - - string indexer = _expression.Substring(start, length); - indexes.Add(Convert.ToInt32(indexer, CultureInfo.InvariantCulture)); - - _currentIndex++; - - EatWhitespace(); - - start = _currentIndex; - end = null; - } - else if (currentCharacter == '*') - { - _currentIndex++; - EnsureLength("Path ended with open indexer."); - EatWhitespace(); - - if (_expression[_currentIndex] != indexerCloseChar) - { - throw new JsonException("Unexpected character while parsing path indexer: " + currentCharacter); - } - - return new ArrayIndexFilter(); - } - else if (currentCharacter == ':') - { - int length = (end ?? _currentIndex) - start; - - if (length > 0) - { - string indexer = _expression.Substring(start, length); - int index = Convert.ToInt32(indexer, CultureInfo.InvariantCulture); - - if (colonCount == 0) - { - startIndex = index; - } - else if (colonCount == 1) - { - endIndex = index; - } - else - { - step = index; - } - } - - colonCount++; - - _currentIndex++; - - EatWhitespace(); - - start = _currentIndex; - end = null; - } - else if (!char.IsDigit(currentCharacter) && currentCharacter != '-') - { - throw new JsonException("Unexpected character while parsing path indexer: " + currentCharacter); - } - else - { - if (end != null) - { - throw new JsonException("Unexpected character while parsing path indexer: " + currentCharacter); - } - - _currentIndex++; - } - } - - throw new JsonException("Path ended with open indexer."); - } - - private void EatWhitespace() - { - while (_currentIndex < _expression.Length) - { - if (_expression[_currentIndex] != ' ') - { - break; - } - - _currentIndex++; - } - } - - private PathFilter ParseQuery(char indexerCloseChar, bool scan) - { - _currentIndex++; - EnsureLength("Path ended with open indexer."); - - if (_expression[_currentIndex] != '(') - { - throw new JsonException("Unexpected character while parsing path indexer: " + _expression[_currentIndex]); - } - - _currentIndex++; - - QueryExpression expression = ParseExpression(); - - _currentIndex++; - EnsureLength("Path ended with open indexer."); - EatWhitespace(); - - if (_expression[_currentIndex] != indexerCloseChar) - { - throw new JsonException("Unexpected character while parsing path indexer: " + _expression[_currentIndex]); - } - - if (!scan) - { - return new QueryFilter(expression); - } - else - { - return new QueryScanFilter(expression); - } - } - - private bool TryParseExpression(out List? expressionPath) - { - if (_expression[_currentIndex] == '$') - { - expressionPath = new List { RootFilter.Instance }; - } - else if (_expression[_currentIndex] == '@') - { - expressionPath = new List(); - } - else - { - expressionPath = null; - return false; - } - - _currentIndex++; - - if (ParsePath(expressionPath!, _currentIndex, true)) - { - throw new JsonException("Path ended with open query."); - } - - return true; - } - - private JsonException CreateUnexpectedCharacterException() - { - return new JsonException("Unexpected character while parsing path query: " + _expression[_currentIndex]); - } - - private object ParseSide() - { - EatWhitespace(); - - if (TryParseExpression(out List? expressionPath)) - { - EatWhitespace(); - EnsureLength("Path ended with open query."); - - return expressionPath!; - } - - if (TryParseValue(out var value)) - { - EatWhitespace(); - EnsureLength("Path ended with open query."); - - return new JValue(value); - } - - throw CreateUnexpectedCharacterException(); - } - - private QueryExpression ParseExpression() - { - QueryExpression? rootExpression = null; - CompositeExpression? parentExpression = null; - - while (_currentIndex < _expression.Length) - { - object left = ParseSide(); - object? right = null; - - QueryOperator op; - if (_expression[_currentIndex] == ')' - || _expression[_currentIndex] == '|' - || _expression[_currentIndex] == '&') - { - op = QueryOperator.Exists; - } - else - { - op = ParseOperator(); - - right = ParseSide(); - } - - BooleanQueryExpression booleanExpression = new BooleanQueryExpression(op, left, right); - - if (_expression[_currentIndex] == ')') - { - if (parentExpression != null) - { - parentExpression.Expressions.Add(booleanExpression); - return rootExpression!; - } - - return booleanExpression; - } - if (_expression[_currentIndex] == '&') - { - if (!Match("&&")) - { - throw CreateUnexpectedCharacterException(); - } - - if (parentExpression == null || parentExpression.Operator != QueryOperator.And) - { - CompositeExpression andExpression = new CompositeExpression(QueryOperator.And); - - parentExpression?.Expressions.Add(andExpression); - - parentExpression = andExpression; - - if (rootExpression == null) - { - rootExpression = parentExpression; - } - } - - parentExpression.Expressions.Add(booleanExpression); - } - if (_expression[_currentIndex] == '|') - { - if (!Match("||")) - { - throw CreateUnexpectedCharacterException(); - } - - if (parentExpression == null || parentExpression.Operator != QueryOperator.Or) - { - CompositeExpression orExpression = new CompositeExpression(QueryOperator.Or); - - parentExpression?.Expressions.Add(orExpression); - - parentExpression = orExpression; - - if (rootExpression == null) - { - rootExpression = parentExpression; - } - } - - parentExpression.Expressions.Add(booleanExpression); - } - } - - throw new JsonException("Path ended with open query."); - } - - private bool TryParseValue(out object? value) - { - char currentChar = _expression[_currentIndex]; - if (currentChar == '\'') - { - value = ReadQuotedString(); - return true; - } - else if (char.IsDigit(currentChar) || currentChar == '-') - { - StringBuilder sb = new StringBuilder(); - sb.Append(currentChar); - - _currentIndex++; - while (_currentIndex < _expression.Length) - { - currentChar = _expression[_currentIndex]; - if (currentChar == ' ' || currentChar == ')') - { - string numberText = sb.ToString(); - - if (numberText.IndexOfAny(FloatCharacters) != -1) - { - bool result = double.TryParse(numberText, NumberStyles.Float | NumberStyles.AllowThousands, CultureInfo.InvariantCulture, out var d); - value = d; - return result; - } - else - { - bool result = long.TryParse(numberText, NumberStyles.Integer, CultureInfo.InvariantCulture, out var l); - value = l; - return result; - } - } - else - { - sb.Append(currentChar); - _currentIndex++; - } - } - } - else if (currentChar == 't') - { - if (Match("true")) - { - value = true; - return true; - } - } - else if (currentChar == 'f') - { - if (Match("false")) - { - value = false; - return true; - } - } - else if (currentChar == 'n') - { - if (Match("null")) - { - value = null; - return true; - } - } - else if (currentChar == '/') - { - value = ReadRegexString(); - return true; - } - - value = null; - return false; - } - - private string ReadQuotedString() - { - StringBuilder sb = new StringBuilder(); - - _currentIndex++; - while (_currentIndex < _expression.Length) - { - char currentChar = _expression[_currentIndex]; - if (currentChar == '\\' && _currentIndex + 1 < _expression.Length) - { - _currentIndex++; - currentChar = _expression[_currentIndex]; - - char resolvedChar; - switch (currentChar) - { - case 'b': - resolvedChar = '\b'; - break; - case 't': - resolvedChar = '\t'; - break; - case 'n': - resolvedChar = '\n'; - break; - case 'f': - resolvedChar = '\f'; - break; - case 'r': - resolvedChar = '\r'; - break; - case '\\': - case '"': - case '\'': - case '/': - resolvedChar = currentChar; - break; - default: - throw new JsonException(@"Unknown escape character: \" + currentChar); - } - - sb.Append(resolvedChar); - - _currentIndex++; - } - else if (currentChar == '\'') - { - _currentIndex++; - return sb.ToString(); - } - else - { - _currentIndex++; - sb.Append(currentChar); - } - } - - throw new JsonException("Path ended with an open string."); - } - - private string ReadRegexString() - { - int startIndex = _currentIndex; - - _currentIndex++; - while (_currentIndex < _expression.Length) - { - char currentChar = _expression[_currentIndex]; - - // handle escaped / character - if (currentChar == '\\' && _currentIndex + 1 < _expression.Length) - { - _currentIndex += 2; - } - else if (currentChar == '/') - { - _currentIndex++; - - while (_currentIndex < _expression.Length) - { - currentChar = _expression[_currentIndex]; - - if (char.IsLetter(currentChar)) - { - _currentIndex++; - } - else - { - break; - } - } - - return _expression.Substring(startIndex, _currentIndex - startIndex); - } - else - { - _currentIndex++; - } - } - - throw new JsonException("Path ended with an open regex."); - } - - private bool Match(string s) - { - int currentPosition = _currentIndex; - for (int i = 0; i < s.Length; i++) - { - if (currentPosition < _expression.Length && _expression[currentPosition] == s[i]) - { - currentPosition++; - } - else - { - return false; - } - } - - _currentIndex = currentPosition; - return true; - } - - private QueryOperator ParseOperator() - { - if (_currentIndex + 1 >= _expression.Length) - { - throw new JsonException("Path ended with open query."); - } - - if (Match("===")) - { - return QueryOperator.StrictEquals; - } - - if (Match("==")) - { - return QueryOperator.Equals; - } - - if (Match("=~")) - { - return QueryOperator.RegexEquals; - } - - if (Match("!==")) - { - return QueryOperator.StrictNotEquals; - } - - if (Match("!=") || Match("<>")) - { - return QueryOperator.NotEquals; - } - if (Match("<=")) - { - return QueryOperator.LessThanOrEquals; - } - if (Match("<")) - { - return QueryOperator.LessThan; - } - if (Match(">=")) - { - return QueryOperator.GreaterThanOrEquals; - } - if (Match(">")) - { - return QueryOperator.GreaterThan; - } - - throw new JsonException("Could not read query operator."); - } - - private PathFilter ParseQuotedField(char indexerCloseChar, bool scan) - { - List? fields = null; - - while (_currentIndex < _expression.Length) - { - string field = ReadQuotedString(); - - EatWhitespace(); - EnsureLength("Path ended with open indexer."); - - if (_expression[_currentIndex] == indexerCloseChar) - { - if (fields != null) - { - fields.Add(field); - return (scan) - ? (PathFilter)new ScanMultipleFilter(fields) - : (PathFilter)new FieldMultipleFilter(fields); - } - else - { - return CreatePathFilter(field, scan); - } - } - else if (_expression[_currentIndex] == ',') - { - _currentIndex++; - EatWhitespace(); - - if (fields == null) - { - fields = new List(); - } - - fields.Add(field); - } - else - { - throw new JsonException("Unexpected character while parsing path indexer: " + _expression[_currentIndex]); - } - } - - throw new JsonException("Path ended with open indexer."); - } - - private void EnsureLength(string message) - { - if (_currentIndex >= _expression.Length) - { - throw new JsonException(message); - } - } - - internal IEnumerable Evaluate(JToken root, JToken t, JsonSelectSettings? settings) - { - return Evaluate(Filters, root, t, settings); - } - - internal static IEnumerable Evaluate(List filters, JToken root, JToken t, JsonSelectSettings? settings) - { - IEnumerable current = new[] { t }; - foreach (PathFilter filter in filters) - { - current = filter.ExecuteFilter(root, current, settings); - } - - return current; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/PathFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/PathFilter.cs deleted file mode 100644 index 45a1683..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/PathFilter.cs +++ /dev/null @@ -1,80 +0,0 @@ -using System.Collections.Generic; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal abstract class PathFilter - { - public abstract IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings); - - protected static JToken? GetTokenIndex(JToken t, JsonSelectSettings? settings, int index) - { - if (t is JArray a) - { - if (a.Count <= index) - { - if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Index {0} outside the bounds of JArray.".FormatWith(CultureInfo.InvariantCulture, index)); - } - - return null; - } - - return a[index]; - } - else if (t is JConstructor c) - { - if (c.Count <= index) - { - if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Index {0} outside the bounds of JConstructor.".FormatWith(CultureInfo.InvariantCulture, index)); - } - - return null; - } - - return c[index]; - } - else - { - if (settings?.ErrorWhenNoMatch ?? false) - { - throw new JsonException("Index {0} not valid on {1}.".FormatWith(CultureInfo.InvariantCulture, index, t.GetType().Name)); - } - - return null; - } - } - - protected static JToken? GetNextScanValue(JToken originalParent, JToken? container, JToken? value) - { - // step into container's values - if (container != null && container.HasValues) - { - value = container.First; - } - else - { - // finished container, move to parent - while (value != null && value != originalParent && value == value.Parent!.Last) - { - value = value.Parent; - } - - // finished - if (value == null || value == originalParent) - { - return null; - } - - // move to next value in container - value = value.Next; - } - - return value; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/QueryExpression.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/QueryExpression.cs deleted file mode 100644 index 1ab9704..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/QueryExpression.cs +++ /dev/null @@ -1,328 +0,0 @@ -using System; -using System.Collections.Generic; -using System.Globalization; -using System.IO; -using System.Text.RegularExpressions; -using System.Diagnostics; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal enum QueryOperator - { - None = 0, - Equals = 1, - NotEquals = 2, - Exists = 3, - LessThan = 4, - LessThanOrEquals = 5, - GreaterThan = 6, - GreaterThanOrEquals = 7, - And = 8, - Or = 9, - RegexEquals = 10, - StrictEquals = 11, - StrictNotEquals = 12 - } - - internal abstract class QueryExpression - { - internal QueryOperator Operator; - - public QueryExpression(QueryOperator @operator) - { - Operator = @operator; - } - - // For unit tests - public bool IsMatch(JToken root, JToken t) - { - return IsMatch(root, t, null); - } - - public abstract bool IsMatch(JToken root, JToken t, JsonSelectSettings? settings); - } - - internal class CompositeExpression : QueryExpression - { - public List Expressions { get; set; } - - public CompositeExpression(QueryOperator @operator) : base(@operator) - { - Expressions = new List(); - } - - public override bool IsMatch(JToken root, JToken t, JsonSelectSettings? settings) - { - switch (Operator) - { - case QueryOperator.And: - foreach (QueryExpression e in Expressions) - { - if (!e.IsMatch(root, t, settings)) - { - return false; - } - } - return true; - case QueryOperator.Or: - foreach (QueryExpression e in Expressions) - { - if (e.IsMatch(root, t, settings)) - { - return true; - } - } - return false; - default: - throw new ArgumentOutOfRangeException(); - } - } - } - - internal class BooleanQueryExpression : QueryExpression - { - public readonly object Left; - public readonly object? Right; - - public BooleanQueryExpression(QueryOperator @operator, object left, object? right) : base(@operator) - { - Left = left; - Right = right; - } - - private IEnumerable GetResult(JToken root, JToken t, object? o) - { - if (o is JToken resultToken) - { - return new[] { resultToken }; - } - - if (o is List pathFilters) - { - return JPath.Evaluate(pathFilters, root, t, null); - } - - return CollectionUtils.ArrayEmpty(); - } - - public override bool IsMatch(JToken root, JToken t, JsonSelectSettings? settings) - { - if (Operator == QueryOperator.Exists) - { - return GetResult(root, t, Left).Any(); - } - - using (IEnumerator leftResults = GetResult(root, t, Left).GetEnumerator()) - { - if (leftResults.MoveNext()) - { - IEnumerable rightResultsEn = GetResult(root, t, Right); - ICollection rightResults = rightResultsEn as ICollection ?? rightResultsEn.ToList(); - - do - { - JToken leftResult = leftResults.Current; - foreach (JToken rightResult in rightResults) - { - if (MatchTokens(leftResult, rightResult, settings)) - { - return true; - } - } - } while (leftResults.MoveNext()); - } - } - - return false; - } - - private bool MatchTokens(JToken leftResult, JToken rightResult, JsonSelectSettings? settings) - { - if (leftResult is JValue leftValue && rightResult is JValue rightValue) - { - switch (Operator) - { - case QueryOperator.RegexEquals: - if (RegexEquals(leftValue, rightValue, settings)) - { - return true; - } - break; - case QueryOperator.Equals: - if (EqualsWithStringCoercion(leftValue, rightValue)) - { - return true; - } - break; - case QueryOperator.StrictEquals: - if (EqualsWithStrictMatch(leftValue, rightValue)) - { - return true; - } - break; - case QueryOperator.NotEquals: - if (!EqualsWithStringCoercion(leftValue, rightValue)) - { - return true; - } - break; - case QueryOperator.StrictNotEquals: - if (!EqualsWithStrictMatch(leftValue, rightValue)) - { - return true; - } - break; - case QueryOperator.GreaterThan: - if (leftValue.CompareTo(rightValue) > 0) - { - return true; - } - break; - case QueryOperator.GreaterThanOrEquals: - if (leftValue.CompareTo(rightValue) >= 0) - { - return true; - } - break; - case QueryOperator.LessThan: - if (leftValue.CompareTo(rightValue) < 0) - { - return true; - } - break; - case QueryOperator.LessThanOrEquals: - if (leftValue.CompareTo(rightValue) <= 0) - { - return true; - } - break; - case QueryOperator.Exists: - return true; - } - } - else - { - switch (Operator) - { - case QueryOperator.Exists: - // you can only specify primitive types in a comparison - // notequals will always be true - case QueryOperator.NotEquals: - return true; - } - } - - return false; - } - - private static bool RegexEquals(JValue input, JValue pattern, JsonSelectSettings? settings) - { - if (input.Type != JTokenType.String || pattern.Type != JTokenType.String) - { - return false; - } - - string regexText = (string)pattern.Value!; - int patternOptionDelimiterIndex = regexText.LastIndexOf('/'); - - string patternText = regexText.Substring(1, patternOptionDelimiterIndex - 1); - string optionsText = regexText.Substring(patternOptionDelimiterIndex + 1); - -#if HAVE_REGEX_TIMEOUTS - TimeSpan timeout = settings?.RegexMatchTimeout ?? Regex.InfiniteMatchTimeout; - return Regex.IsMatch((string)input.Value!, patternText, MiscellaneousUtils.GetRegexOptions(optionsText), timeout); -#else - return Regex.IsMatch((string)input.Value!, patternText, MiscellaneousUtils.GetRegexOptions(optionsText)); -#endif - } - - internal static bool EqualsWithStringCoercion(JValue value, JValue queryValue) - { - if (value.Equals(queryValue)) - { - return true; - } - - // Handle comparing an integer with a float - // e.g. Comparing 1 and 1.0 - if ((value.Type == JTokenType.Integer && queryValue.Type == JTokenType.Float) - || (value.Type == JTokenType.Float && queryValue.Type == JTokenType.Integer)) - { - return JValue.Compare(value.Type, value.Value, queryValue.Value) == 0; - } - - if (queryValue.Type != JTokenType.String) - { - return false; - } - - string queryValueString = (string)queryValue.Value!; - - string currentValueString; - - // potential performance issue with converting every value to string? - switch (value.Type) - { - case JTokenType.Date: - using (StringWriter writer = StringUtils.CreateStringWriter(64)) - { -#if HAVE_DATE_TIME_OFFSET - if (value.Value is DateTimeOffset offset) - { - DateTimeUtils.WriteDateTimeOffsetString(writer, offset, DateFormatHandling.IsoDateFormat, null, CultureInfo.InvariantCulture); - } - else -#endif - { - DateTimeUtils.WriteDateTimeString(writer, (DateTime)value.Value!, DateFormatHandling.IsoDateFormat, null, CultureInfo.InvariantCulture); - } - - currentValueString = writer.ToString(); - } - break; - case JTokenType.Bytes: - currentValueString = Convert.ToBase64String((byte[])value.Value!); - break; - case JTokenType.Guid: - case JTokenType.TimeSpan: - currentValueString = value.Value!.ToString(); - break; - case JTokenType.Uri: - currentValueString = ((Uri)value.Value!).OriginalString; - break; - default: - return false; - } - - return string.Equals(currentValueString, queryValueString, StringComparison.Ordinal); - } - - internal static bool EqualsWithStrictMatch(JValue value, JValue queryValue) - { - MiscellaneousUtils.Assert(value != null); - MiscellaneousUtils.Assert(queryValue != null); - - // Handle comparing an integer with a float - // e.g. Comparing 1 and 1.0 - if ((value.Type == JTokenType.Integer && queryValue.Type == JTokenType.Float) - || (value.Type == JTokenType.Float && queryValue.Type == JTokenType.Integer)) - { - return JValue.Compare(value.Type, value.Value, queryValue.Value) == 0; - } - - // we handle floats and integers the exact same way, so they are pseudo equivalent - if (value.Type != queryValue.Type) - { - return false; - } - - return value.Equals(queryValue); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/QueryFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/QueryFilter.cs deleted file mode 100644 index e844e11..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/QueryFilter.cs +++ /dev/null @@ -1,29 +0,0 @@ -using System; -using System.Collections.Generic; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class QueryFilter : PathFilter - { - internal QueryExpression Expression; - - public QueryFilter(QueryExpression expression) - { - Expression = expression; - } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - foreach (JToken t in current) - { - foreach (JToken v in t) - { - if (Expression.IsMatch(root, v, settings)) - { - yield return v; - } - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/QueryScanFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/QueryScanFilter.cs deleted file mode 100644 index a1b5270..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/QueryScanFilter.cs +++ /dev/null @@ -1,39 +0,0 @@ -using System; -using System.Collections.Generic; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class QueryScanFilter : PathFilter - { - internal QueryExpression Expression; - - public QueryScanFilter(QueryExpression expression) - { - Expression = expression; - } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - foreach (JToken t in current) - { - if (t is JContainer c) - { - foreach (JToken d in c.DescendantsAndSelf()) - { - if (Expression.IsMatch(root, d, settings)) - { - yield return d; - } - } - } - else - { - if (Expression.IsMatch(root, t, settings)) - { - yield return t; - } - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/RootFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/RootFilter.cs deleted file mode 100644 index 164ba0c..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/RootFilter.cs +++ /dev/null @@ -1,18 +0,0 @@ -using System.Collections.Generic; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class RootFilter : PathFilter - { - public static readonly RootFilter Instance = new RootFilter(); - - private RootFilter() - { - } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - return new[] { root }; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ScanFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ScanFilter.cs deleted file mode 100644 index a3f6adc..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ScanFilter.cs +++ /dev/null @@ -1,53 +0,0 @@ -using System.Collections.Generic; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class ScanFilter : PathFilter - { - internal string? Name; - - public ScanFilter(string? name) - { - Name = name; - } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - foreach (JToken c in current) - { - if (Name == null) - { - yield return c; - } - - JToken? value = c; - - while (true) - { - JContainer? container = value as JContainer; - - value = GetNextScanValue(c, container, value); - if (value == null) - { - break; - } - - if (value is JProperty property) - { - if (property.Name == Name) - { - yield return property.Value; - } - } - else - { - if (Name == null) - { - yield return value; - } - } - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ScanMultipleFilter.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ScanMultipleFilter.cs deleted file mode 100644 index 40e9334..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonPath/ScanMultipleFilter.cs +++ /dev/null @@ -1,44 +0,0 @@ -using System.Collections.Generic; - -namespace Newtonsoft.Json.Linq.JsonPath -{ - internal class ScanMultipleFilter : PathFilter - { - private List _names; - - public ScanMultipleFilter(List names) - { - _names = names; - } - - public override IEnumerable ExecuteFilter(JToken root, IEnumerable current, JsonSelectSettings? settings) - { - foreach (JToken c in current) - { - JToken? value = c; - - while (true) - { - JContainer? container = value as JContainer; - - value = GetNextScanValue(c, container, value); - if (value == null) - { - break; - } - - if (value is JProperty property) - { - foreach (string name in _names) - { - if (property.Name == name) - { - yield return property.Value; - } - } - } - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/JsonSelectSettings.cs b/Source/MyDb/Newtonsoft.Json/Linq/JsonSelectSettings.cs deleted file mode 100644 index 495b2dc..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/JsonSelectSettings.cs +++ /dev/null @@ -1,28 +0,0 @@ -using System; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Specifies the settings used when selecting JSON. - /// - public class JsonSelectSettings - { -#if HAVE_REGEX_TIMEOUTS - /// - /// Gets or sets a timeout that will be used when executing regular expressions. - /// - /// The timeout that will be used when executing regular expressions. - public TimeSpan? RegexMatchTimeout { get; set; } -#endif - - /// - /// Gets or sets a flag that indicates whether an error should be thrown if - /// no tokens are found when evaluating part of the expression. - /// - /// - /// A flag that indicates whether an error should be thrown if - /// no tokens are found when evaluating part of the expression. - /// - public bool ErrorWhenNoMatch { get; set; } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Linq/LineInfoHandling.cs b/Source/MyDb/Newtonsoft.Json/Linq/LineInfoHandling.cs deleted file mode 100644 index 7fbdeeb..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/LineInfoHandling.cs +++ /dev/null @@ -1,43 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Linq -{ - /// - /// Specifies how line information is handled when loading JSON. - /// - public enum LineInfoHandling - { - /// - /// Ignore line information. - /// - Ignore = 0, - - /// - /// Load line information. - /// - Load = 1 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/MergeArrayHandling.cs b/Source/MyDb/Newtonsoft.Json/Linq/MergeArrayHandling.cs deleted file mode 100644 index 5e7fadf..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/MergeArrayHandling.cs +++ /dev/null @@ -1,20 +0,0 @@ -namespace Newtonsoft.Json.Linq -{ - /// - /// Specifies how JSON arrays are merged together. - /// - public enum MergeArrayHandling - { - /// Concatenate arrays. - Concat = 0, - - /// Union arrays, skipping items that already exist. - Union = 1, - - /// Replace all array items. - Replace = 2, - - /// Merge array items together, matched by index. - Merge = 3 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Linq/MergeNullValueHandling.cs b/Source/MyDb/Newtonsoft.Json/Linq/MergeNullValueHandling.cs deleted file mode 100644 index 30d3d84..0000000 --- a/Source/MyDb/Newtonsoft.Json/Linq/MergeNullValueHandling.cs +++ /dev/null @@ -1,21 +0,0 @@ -using System; - -namespace Newtonsoft.Json.Linq -{ - /// - /// Specifies how null value properties are merged. - /// - [Flags] - public enum MergeNullValueHandling - { - /// - /// The content's null value properties will be ignored during merging. - /// - Ignore = 0, - - /// - /// The content's null value properties will be merged. - /// - Merge = 1 - } -} diff --git a/Source/MyDb/Newtonsoft.Json/MemberSerialization.cs b/Source/MyDb/Newtonsoft.Json/MemberSerialization.cs deleted file mode 100644 index b3fd7d9..0000000 --- a/Source/MyDb/Newtonsoft.Json/MemberSerialization.cs +++ /dev/null @@ -1,58 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Runtime.Serialization; -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json -{ - /// - /// Specifies the member serialization options for the . - /// - public enum MemberSerialization - { -#pragma warning disable 1584,1711,1572,1581,1580,1574 - /// - /// All public members are serialized by default. Members can be excluded using or . - /// This is the default member serialization mode. - /// - OptOut = 0, - - /// - /// Only members marked with or are serialized. - /// This member serialization mode can also be set by marking the class with . - /// - OptIn = 1, - - /// - /// All public and private fields are serialized. Members can be excluded using or . - /// This member serialization mode can also be set by marking the class with - /// and setting IgnoreSerializableAttribute on to false. - /// - Fields = 2 -#pragma warning restore 1584,1711,1572,1581,1580,1574 - } -} diff --git a/Source/MyDb/Newtonsoft.Json/MetadataPropertyHandling.cs b/Source/MyDb/Newtonsoft.Json/MetadataPropertyHandling.cs deleted file mode 100644 index 5bdacd8..0000000 --- a/Source/MyDb/Newtonsoft.Json/MetadataPropertyHandling.cs +++ /dev/null @@ -1,52 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; - -namespace Newtonsoft.Json -{ - /// - /// Specifies metadata property handling options for the . - /// - public enum MetadataPropertyHandling - { - /// - /// Read metadata properties located at the start of a JSON object. - /// - Default = 0, - - /// - /// Read metadata properties located anywhere in a JSON object. Note that this setting will impact performance. - /// - ReadAhead = 1, - - /// - /// Do not try to read metadata properties. - /// - Ignore = 2 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/MissingMemberHandling.cs b/Source/MyDb/Newtonsoft.Json/MissingMemberHandling.cs deleted file mode 100644 index 4e35081..0000000 --- a/Source/MyDb/Newtonsoft.Json/MissingMemberHandling.cs +++ /dev/null @@ -1,47 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; - -namespace Newtonsoft.Json -{ - /// - /// Specifies missing member handling options for the . - /// - public enum MissingMemberHandling - { - /// - /// Ignore a missing member and do not attempt to deserialize it. - /// - Ignore = 0, - - /// - /// Throw a when a missing member is encountered during deserialization. - /// - Error = 1 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Newtonsoft.Json.csproj b/Source/MyDb/Newtonsoft.Json/Newtonsoft.Json.csproj deleted file mode 100644 index 4dd7b55..0000000 --- a/Source/MyDb/Newtonsoft.Json/Newtonsoft.Json.csproj +++ /dev/null @@ -1,82 +0,0 @@ - - - net45;net40;net35;net20;netstandard1.0;netstandard1.3;netstandard2.0 - $(LibraryFrameworks) - 9.0 - - 11.0.0.0 - 11.0.1 - 11.0.1 - beta2 - James Newton-King - Newtonsoft - Json.NET - Json.NET is a popular high-performance JSON framework for .NET - Copyright © James Newton-King 2008 - Json.NET is a popular high-performance JSON framework for .NET - en-US - Json.NET - Newtonsoft.Json - json - packageIcon.png - $(MSBuildThisFileDirectory)packageIcon.png - https://www.newtonsoft.com/json - MIT - true - Newtonsoft.Json - Newtonsoft.Json - true - enable - 2.12 - true - snupkg - Newtonsoft.Json.ruleset - true - - - - - - - - - - - - Json.NET - HAVE_ADO_NET;HAVE_APP_DOMAIN;HAVE_ASYNC;HAVE_BIG_INTEGER;HAVE_BINARY_FORMATTER;HAVE_BINARY_SERIALIZATION;HAVE_BINARY_EXCEPTION_SERIALIZATION;HAVE_CAS;HAVE_CHAR_TO_LOWER_WITH_CULTURE;HAVE_CHAR_TO_STRING_WITH_CULTURE;HAVE_COM_ATTRIBUTES;HAVE_COMPONENT_MODEL;HAVE_CONCURRENT_COLLECTIONS;HAVE_COVARIANT_GENERICS;HAVE_DATA_CONTRACTS;HAVE_DATE_TIME_OFFSET;HAVE_DB_NULL_TYPE_CODE;HAVE_DYNAMIC;HAVE_EMPTY_TYPES;HAVE_ENTITY_FRAMEWORK;HAVE_EXPRESSIONS;HAVE_FAST_REVERSE;HAVE_FSHARP_TYPES;HAVE_FULL_REFLECTION;HAVE_GUID_TRY_PARSE;HAVE_HASH_SET;HAVE_ICLONEABLE;HAVE_ICONVERTIBLE;HAVE_IGNORE_DATA_MEMBER_ATTRIBUTE;HAVE_INOTIFY_COLLECTION_CHANGED;HAVE_INOTIFY_PROPERTY_CHANGING;HAVE_ISET;HAVE_LINQ;HAVE_MEMORY_BARRIER;HAVE_METHOD_IMPL_ATTRIBUTE;HAVE_NON_SERIALIZED_ATTRIBUTE;HAVE_READ_ONLY_COLLECTIONS;HAVE_REFLECTION_EMIT;HAVE_REGEX_TIMEOUTS;HAVE_SECURITY_SAFE_CRITICAL_ATTRIBUTE;HAVE_SERIALIZATION_BINDER_BIND_TO_NAME;HAVE_STREAM_READER_WRITER_CLOSE;HAVE_STRING_JOIN_WITH_ENUMERABLE;HAVE_TIME_SPAN_PARSE_WITH_CULTURE;HAVE_TIME_SPAN_TO_STRING_WITH_CULTURE;HAVE_TIME_ZONE_INFO;HAVE_TRACE_WRITER;HAVE_TYPE_DESCRIPTOR;HAVE_UNICODE_SURROGATE_DETECTION;HAVE_VARIANT_TYPE_PARAMETERS;HAVE_VERSION_TRY_PARSE;HAVE_XLINQ;HAVE_XML_DOCUMENT;HAVE_XML_DOCUMENT_TYPE;HAVE_CONCURRENT_DICTIONARY;$(AdditionalConstants) - - - Json.NET .NET 4.0 - NET40;HAVE_ADO_NET;HAVE_APP_DOMAIN;HAVE_BIG_INTEGER;HAVE_BINARY_FORMATTER;HAVE_BINARY_SERIALIZATION;HAVE_BINARY_EXCEPTION_SERIALIZATION;HAVE_CAS;HAVE_CHAR_TO_STRING_WITH_CULTURE;HAVE_CHAR_TO_LOWER_WITH_CULTURE;HAVE_COM_ATTRIBUTES;HAVE_COMPONENT_MODEL;HAVE_CONCURRENT_COLLECTIONS;HAVE_COVARIANT_GENERICS;HAVE_DATA_CONTRACTS;HAVE_DATE_TIME_OFFSET;HAVE_DB_NULL_TYPE_CODE;HAVE_DYNAMIC;HAVE_EMPTY_TYPES;HAVE_ENTITY_FRAMEWORK;HAVE_EXPRESSIONS;HAVE_FAST_REVERSE;HAVE_FSHARP_TYPES;HAVE_FULL_REFLECTION;HAVE_GUID_TRY_PARSE;HAVE_HASH_SET;HAVE_ICLONEABLE;HAVE_ICONVERTIBLE;HAVE_IGNORE_DATA_MEMBER_ATTRIBUTE;HAVE_INOTIFY_COLLECTION_CHANGED;HAVE_INOTIFY_PROPERTY_CHANGING;HAVE_ISET;HAVE_LINQ;HAVE_MEMORY_BARRIER;HAVE_NON_SERIALIZED_ATTRIBUTE;HAVE_REFLECTION_EMIT;HAVE_SECURITY_SAFE_CRITICAL_ATTRIBUTE;HAVE_SERIALIZATION_BINDER_BIND_TO_NAME;HAVE_STREAM_READER_WRITER_CLOSE;HAVE_STRING_JOIN_WITH_ENUMERABLE;HAVE_TIME_SPAN_PARSE_WITH_CULTURE;HAVE_TIME_SPAN_TO_STRING_WITH_CULTURE;HAVE_TIME_ZONE_INFO;HAVE_TRACE_WRITER;HAVE_TYPE_DESCRIPTOR;HAVE_UNICODE_SURROGATE_DETECTION;HAVE_VARIANT_TYPE_PARAMETERS;HAVE_VERSION_TRY_PARSE;HAVE_XLINQ;HAVE_XML_DOCUMENT;HAVE_XML_DOCUMENT_TYPE;HAVE_CONCURRENT_DICTIONARY;$(AdditionalConstants) - - - Json.NET .NET 3.5 - NET35;HAVE_ADO_NET;HAVE_APP_DOMAIN;HAVE_BINARY_FORMATTER;HAVE_BINARY_SERIALIZATION;HAVE_BINARY_EXCEPTION_SERIALIZATION;HAVE_CAS;HAVE_CHAR_TO_STRING_WITH_CULTURE;HAVE_CHAR_TO_LOWER_WITH_CULTURE;HAVE_COM_ATTRIBUTES;HAVE_COMPONENT_MODEL;HAVE_DATA_CONTRACTS;HAVE_DATE_TIME_OFFSET;HAVE_DB_NULL_TYPE_CODE;HAVE_EMPTY_TYPES;HAVE_ENTITY_FRAMEWORK;HAVE_FAST_REVERSE;HAVE_FULL_REFLECTION;HAVE_HASH_SET;HAVE_ICLONEABLE;HAVE_ICONVERTIBLE;HAVE_INOTIFY_PROPERTY_CHANGING;HAVE_LINQ;HAVE_MEMORY_BARRIER;HAVE_NON_SERIALIZED_ATTRIBUTE;HAVE_REFLECTION_EMIT;HAVE_STREAM_READER_WRITER_CLOSE;HAVE_TIME_ZONE_INFO;HAVE_TRACE_WRITER;HAVE_TYPE_DESCRIPTOR;HAVE_UNICODE_SURROGATE_DETECTION;HAVE_XLINQ;HAVE_XML_DOCUMENT;HAVE_XML_DOCUMENT_TYPE;$(AdditionalConstants) - - - Json.NET .NET 2.0 - NET20;HAVE_ADO_NET;HAVE_APP_DOMAIN;HAVE_BINARY_FORMATTER;HAVE_BINARY_SERIALIZATION;HAVE_BINARY_EXCEPTION_SERIALIZATION;HAVE_CAS;HAVE_CHAR_TO_LOWER_WITH_CULTURE;HAVE_CHAR_TO_STRING_WITH_CULTURE;HAVE_COM_ATTRIBUTES;HAVE_COMPONENT_MODEL;HAVE_DB_NULL_TYPE_CODE;HAVE_EMPTY_TYPES;HAVE_FAST_REVERSE;HAVE_FULL_REFLECTION;HAVE_ICLONEABLE;HAVE_ICONVERTIBLE;HAVE_MEMORY_BARRIER;HAVE_NON_SERIALIZED_ATTRIBUTE;HAVE_REFLECTION_EMIT;HAVE_STREAM_READER_WRITER_CLOSE;HAVE_TRACE_WRITER;HAVE_TYPE_DESCRIPTOR;HAVE_UNICODE_SURROGATE_DETECTION;HAVE_XML_DOCUMENT;HAVE_XML_DOCUMENT_TYPE;$(AdditionalConstants) - - - - - - - - Json.NET .NET Standard 1.0 - NETSTANDARD1_0;PORTABLE;HAVE_ASYNC;HAVE_COVARIANT_GENERICS;HAVE_DATA_CONTRACTS;HAVE_DATE_TIME_OFFSET;HAVE_DYNAMIC;HAVE_EXPRESSIONS;HAVE_FSHARP_TYPES;HAVE_GUID_TRY_PARSE;HAVE_HASH_SET;HAVE_IGNORE_DATA_MEMBER_ATTRIBUTE;HAVE_INOTIFY_COLLECTION_CHANGED;HAVE_ISET;HAVE_LINQ;HAVE_METHOD_IMPL_ATTRIBUTE;HAVE_READ_ONLY_COLLECTIONS;HAVE_REFLECTION_BINDER;HAVE_SERIALIZATION_BINDER_BIND_TO_NAME;HAVE_STRING_JOIN_WITH_ENUMERABLE;HAVE_TIME_SPAN_PARSE_WITH_CULTURE;HAVE_TIME_SPAN_TO_STRING_WITH_CULTURE;HAVE_TIME_ZONE_INFO;HAVE_TYPE_DESCRIPTOR;HAVE_UNICODE_SURROGATE_DETECTION;HAVE_VARIANT_TYPE_PARAMETERS;HAVE_VERSION_TRY_PARSE;HAVE_XLINQ;HAVE_OBSOLETE_FORMATTER_ASSEMBLY_STYLE;HAVE_REGEX_TIMEOUTS;$(AdditionalConstants) - - - - - - - Json.NET .NET Standard 1.3 - NETSTANDARD1_3;PORTABLE;HAVE_ASYNC;HAVE_BIG_INTEGER;HAVE_BINARY_SERIALIZATION;HAVE_COVARIANT_GENERICS;HAVE_DATA_CONTRACTS;HAVE_DATE_TIME_OFFSET;HAVE_DYNAMIC;HAVE_EXPRESSIONS;HAVE_FSHARP_TYPES;HAVE_GUID_TRY_PARSE;HAVE_HASH_SET;HAVE_IGNORE_DATA_MEMBER_ATTRIBUTE;HAVE_INOTIFY_COLLECTION_CHANGED;HAVE_INOTIFY_PROPERTY_CHANGING;HAVE_ISET;HAVE_LINQ;HAVE_METHOD_IMPL_ATTRIBUTE;HAVE_NON_SERIALIZED_ATTRIBUTE;HAVE_READ_ONLY_COLLECTIONS;HAVE_REFLECTION_BINDER;HAVE_SERIALIZATION_BINDER_BIND_TO_NAME;HAVE_STRING_JOIN_WITH_ENUMERABLE;HAVE_TIME_SPAN_PARSE_WITH_CULTURE;HAVE_TIME_SPAN_TO_STRING_WITH_CULTURE;HAVE_TIME_ZONE_INFO;HAVE_TYPE_DESCRIPTOR;HAVE_UNICODE_SURROGATE_DETECTION;HAVE_VARIANT_TYPE_PARAMETERS;HAVE_VERSION_TRY_PARSE;HAVE_XLINQ;HAVE_OBSOLETE_FORMATTER_ASSEMBLY_STYLE;HAVE_XML_DOCUMENT;HAVE_CONCURRENT_DICTIONARY;HAVE_ICONVERTIBLE;HAVE_REGEX_TIMEOUTS;HAVE_REGEX_TIMEOUTS;$(AdditionalConstants) - - - Json.NET .NET Standard 2.0 - NETSTANDARD2_0;HAVE_ADO_NET;HAVE_APP_DOMAIN;HAVE_ASYNC;HAVE_BIG_INTEGER;HAVE_BINARY_FORMATTER;HAVE_BINARY_SERIALIZATION;HAVE_BINARY_EXCEPTION_SERIALIZATION;HAVE_CHAR_TO_LOWER_WITH_CULTURE;HAVE_CHAR_TO_STRING_WITH_CULTURE;HAVE_COM_ATTRIBUTES;HAVE_COMPONENT_MODEL;HAVE_CONCURRENT_COLLECTIONS;HAVE_COVARIANT_GENERICS;HAVE_DATA_CONTRACTS;HAVE_DATE_TIME_OFFSET;HAVE_DB_NULL_TYPE_CODE;HAVE_DYNAMIC;HAVE_EMPTY_TYPES;HAVE_ENTITY_FRAMEWORK;HAVE_EXPRESSIONS;HAVE_FAST_REVERSE;HAVE_FSHARP_TYPES;HAVE_FULL_REFLECTION;HAVE_GUID_TRY_PARSE;HAVE_HASH_SET;HAVE_ICLONEABLE;HAVE_ICONVERTIBLE;HAVE_IGNORE_DATA_MEMBER_ATTRIBUTE;HAVE_INOTIFY_COLLECTION_CHANGED;HAVE_INOTIFY_PROPERTY_CHANGING;HAVE_ISET;HAVE_LINQ;HAVE_MEMORY_BARRIER;HAVE_METHOD_IMPL_ATTRIBUTE;HAVE_NON_SERIALIZED_ATTRIBUTE;HAVE_READ_ONLY_COLLECTIONS;HAVE_SECURITY_SAFE_CRITICAL_ATTRIBUTE;HAVE_SERIALIZATION_BINDER_BIND_TO_NAME;HAVE_STREAM_READER_WRITER_CLOSE;HAVE_STRING_JOIN_WITH_ENUMERABLE;HAVE_TIME_SPAN_PARSE_WITH_CULTURE;HAVE_TIME_SPAN_TO_STRING_WITH_CULTURE;HAVE_TIME_ZONE_INFO;HAVE_TRACE_WRITER;HAVE_TYPE_DESCRIPTOR;HAVE_UNICODE_SURROGATE_DETECTION;HAVE_VARIANT_TYPE_PARAMETERS;HAVE_VERSION_TRY_PARSE;HAVE_XLINQ;HAVE_XML_DOCUMENT;HAVE_XML_DOCUMENT_TYPE;HAVE_CONCURRENT_DICTIONARY;HAVE_REGEX_TIMEOUTS;$(AdditionalConstants) - - \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Newtonsoft.Json.ruleset b/Source/MyDb/Newtonsoft.Json/Newtonsoft.Json.ruleset deleted file mode 100644 index a49f1e2..0000000 --- a/Source/MyDb/Newtonsoft.Json/Newtonsoft.Json.ruleset +++ /dev/null @@ -1,199 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Source/MyDb/Newtonsoft.Json/NullValueHandling.cs b/Source/MyDb/Newtonsoft.Json/NullValueHandling.cs deleted file mode 100644 index 8a88c16..0000000 --- a/Source/MyDb/Newtonsoft.Json/NullValueHandling.cs +++ /dev/null @@ -1,47 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Specifies null value handling options for the . - /// - /// - /// - /// - /// - public enum NullValueHandling - { - /// - /// Include null values when serializing and deserializing objects. - /// - Include = 0, - - /// - /// Ignore null values when serializing and deserializing objects. - /// - Ignore = 1 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/ObjectCreationHandling.cs b/Source/MyDb/Newtonsoft.Json/ObjectCreationHandling.cs deleted file mode 100644 index cc53b14..0000000 --- a/Source/MyDb/Newtonsoft.Json/ObjectCreationHandling.cs +++ /dev/null @@ -1,48 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Specifies how object creation is handled by the . - /// - public enum ObjectCreationHandling - { - /// - /// Reuse existing objects, create new objects when needed. - /// - Auto = 0, - - /// - /// Only reuse existing objects. - /// - Reuse = 1, - - /// - /// Always create new objects. - /// - Replace = 2 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/PreserveReferencesHandling.cs b/Source/MyDb/Newtonsoft.Json/PreserveReferencesHandling.cs deleted file mode 100644 index bb6f7ae..0000000 --- a/Source/MyDb/Newtonsoft.Json/PreserveReferencesHandling.cs +++ /dev/null @@ -1,62 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; - -namespace Newtonsoft.Json -{ - /// - /// Specifies reference handling options for the . - /// Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . - /// - /// - /// - /// - [Flags] - public enum PreserveReferencesHandling - { - /// - /// Do not preserve references when serializing types. - /// - None = 0, - - /// - /// Preserve references when serializing into a JSON object structure. - /// - Objects = 1, - - /// - /// Preserve references when serializing into a JSON array structure. - /// - Arrays = 2, - - /// - /// Preserve references when serializing. - /// - All = Objects | Arrays - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Properties/AssemblyInfo.cs b/Source/MyDb/Newtonsoft.Json/Properties/AssemblyInfo.cs deleted file mode 100644 index 2a67ec4..0000000 --- a/Source/MyDb/Newtonsoft.Json/Properties/AssemblyInfo.cs +++ /dev/null @@ -1,70 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Reflection; -using System.Runtime.CompilerServices; -using System.Runtime.InteropServices; -using System.Security; - -// General Information about an assembly is controlled through the following -// set of attributes. Change these attribute values to modify the information -// associated with an assembly. -#if NET20 -[assembly: AllowPartiallyTrustedCallers] -#elif NET35 -[assembly: AllowPartiallyTrustedCallers] -#elif NET40 -[assembly: AllowPartiallyTrustedCallers] -#else -[assembly: AllowPartiallyTrustedCallers] -#endif - -#if !SIGNED - -[assembly: InternalsVisibleTo("Newtonsoft.Json.Schema")] -[assembly: InternalsVisibleTo("Newtonsoft.Json.Tests")] -#else -[assembly: InternalsVisibleTo("Newtonsoft.Json.Schema, PublicKey=0024000004800000940000000602000000240000525341310004000001000100f561df277c6c0b497d629032b410cdcf286e537c054724f7ffa0164345f62b3e642029d7a80cc351918955328c4adc8a048823ef90b0cf38ea7db0d729caf2b633c3babe08b0310198c1081995c19029bc675193744eab9d7345b8a67258ec17d112cebdbbb2a281487dceeafb9d83aa930f32103fbe1d2911425bc5744002c7")] -[assembly: InternalsVisibleTo("Newtonsoft.Json.Tests, PublicKey=0024000004800000940000000602000000240000525341310004000001000100f561df277c6c0b497d629032b410cdcf286e537c054724f7ffa0164345f62b3e642029d7a80cc351918955328c4adc8a048823ef90b0cf38ea7db0d729caf2b633c3babe08b0310198c1081995c19029bc675193744eab9d7345b8a67258ec17d112cebdbbb2a281487dceeafb9d83aa930f32103fbe1d2911425bc5744002c7")] -#endif - -[assembly: InternalsVisibleTo("Newtonsoft.Json.Dynamic, PublicKey=0024000004800000940000000602000000240000525341310004000001000100cbd8d53b9d7de30f1f1278f636ec462cf9c254991291e66ebb157a885638a517887633b898ccbcf0d5c5ff7be85a6abe9e765d0ac7cd33c68dac67e7e64530e8222101109f154ab14a941c490ac155cd1d4fcba0fabb49016b4ef28593b015cab5937da31172f03f67d09edda404b88a60023f062ae71d0b2e4438b74cc11dc9")] -[assembly: AssemblyTrademark("")] -[assembly: AssemblyCulture("")] - -#if HAVE_COM_ATTRIBUTES -// Setting ComVisible to false makes the types in this assembly not visible -// to COM components. If you need to access a type in this assembly from -// COM, set the ComVisible attribute to true on that type. - -[assembly: ComVisible(false)] - -// The following GUID is for the ID of the typelib if this project is exposed to COM - -[assembly: Guid("9ca358aa-317b-4925-8ada-4a29e943a363")] -#endif - -[assembly: CLSCompliant(true)] \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/ReferenceLoopHandling.cs b/Source/MyDb/Newtonsoft.Json/ReferenceLoopHandling.cs deleted file mode 100644 index bfa5133..0000000 --- a/Source/MyDb/Newtonsoft.Json/ReferenceLoopHandling.cs +++ /dev/null @@ -1,52 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; - -namespace Newtonsoft.Json -{ - /// - /// Specifies reference loop handling options for the . - /// - public enum ReferenceLoopHandling - { - /// - /// Throw a when a loop is encountered. - /// - Error = 0, - - /// - /// Ignore loop references and do not serialize. - /// - Ignore = 1, - - /// - /// Serialize loop references. - /// - Serialize = 2 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Required.cs b/Source/MyDb/Newtonsoft.Json/Required.cs deleted file mode 100644 index 47c91e1..0000000 --- a/Source/MyDb/Newtonsoft.Json/Required.cs +++ /dev/null @@ -1,53 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Indicating whether a property is required. - /// - public enum Required - { - /// - /// The property is not required. The default state. - /// - Default = 0, - - /// - /// The property must be defined in JSON but can be a null value. - /// - AllowNull = 1, - - /// - /// The property must be defined in JSON and cannot be a null value. - /// - Always = 2, - - /// - /// The property is not required but it cannot be a null value. - /// - DisallowNull = 3 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/Extensions.cs b/Source/MyDb/Newtonsoft.Json/Schema/Extensions.cs deleted file mode 100644 index df8ffba..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/Extensions.cs +++ /dev/null @@ -1,139 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Utilities; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - /// - /// - /// Contains the JSON schema extension methods. - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public static class Extensions - { - /// - /// - /// Determines whether the is valid. - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - /// The source to test. - /// The schema to test with. - /// - /// true if the specified is valid; otherwise, false. - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public static bool IsValid(this JToken source, JsonSchema schema) - { - bool valid = true; - source.Validate(schema, (sender, args) => { valid = false; }); - return valid; - } - - /// - /// - /// Determines whether the is valid. - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - /// The source to test. - /// The schema to test with. - /// When this method returns, contains any error messages generated while validating. - /// - /// true if the specified is valid; otherwise, false. - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public static bool IsValid(this JToken source, JsonSchema schema, out IList errorMessages) - { - IList errors = new List(); - - source.Validate(schema, (sender, args) => errors.Add(args.Message)); - - errorMessages = errors; - return (errorMessages.Count == 0); - } - - /// - /// - /// Validates the specified . - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - /// The source to test. - /// The schema to test with. - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public static void Validate(this JToken source, JsonSchema schema) - { - source.Validate(schema, null); - } - - /// - /// - /// Validates the specified . - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - /// The source to test. - /// The schema to test with. - /// The validation event handler. - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public static void Validate(this JToken source, JsonSchema schema, ValidationEventHandler validationEventHandler) - { - ValidationUtils.ArgumentNotNull(source, nameof(source)); - ValidationUtils.ArgumentNotNull(schema, nameof(schema)); - - using (JsonValidatingReader reader = new JsonValidatingReader(source.CreateReader())) - { - reader.Schema = schema; - if (validationEventHandler != null) - { - reader.ValidationEventHandler += validationEventHandler; - } - - while (reader.Read()) - { - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchema.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchema.cs deleted file mode 100644 index 034bd06..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchema.cs +++ /dev/null @@ -1,357 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.IO; -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Utilities; -using System.Globalization; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - /// - /// - /// An in-memory representation of a JSON Schema. - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public class JsonSchema - { - /// - /// Gets or sets the id. - /// - public string Id { get; set; } - - /// - /// Gets or sets the title. - /// - public string Title { get; set; } - - /// - /// Gets or sets whether the object is required. - /// - public bool? Required { get; set; } - - /// - /// Gets or sets whether the object is read-only. - /// - public bool? ReadOnly { get; set; } - - /// - /// Gets or sets whether the object is visible to users. - /// - public bool? Hidden { get; set; } - - /// - /// Gets or sets whether the object is transient. - /// - public bool? Transient { get; set; } - - /// - /// Gets or sets the description of the object. - /// - public string Description { get; set; } - - /// - /// Gets or sets the types of values allowed by the object. - /// - /// The type. - public JsonSchemaType? Type { get; set; } - - /// - /// Gets or sets the pattern. - /// - /// The pattern. - public string Pattern { get; set; } - - /// - /// Gets or sets the minimum length. - /// - /// The minimum length. - public int? MinimumLength { get; set; } - - /// - /// Gets or sets the maximum length. - /// - /// The maximum length. - public int? MaximumLength { get; set; } - - /// - /// Gets or sets a number that the value should be divisible by. - /// - /// A number that the value should be divisible by. - public double? DivisibleBy { get; set; } - - /// - /// Gets or sets the minimum. - /// - /// The minimum. - public double? Minimum { get; set; } - - /// - /// Gets or sets the maximum. - /// - /// The maximum. - public double? Maximum { get; set; } - - /// - /// Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). - /// - /// A flag indicating whether the value can not equal the number defined by the minimum attribute (). - public bool? ExclusiveMinimum { get; set; } - - /// - /// Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). - /// - /// A flag indicating whether the value can not equal the number defined by the maximum attribute (). - public bool? ExclusiveMaximum { get; set; } - - /// - /// Gets or sets the minimum number of items. - /// - /// The minimum number of items. - public int? MinimumItems { get; set; } - - /// - /// Gets or sets the maximum number of items. - /// - /// The maximum number of items. - public int? MaximumItems { get; set; } - - /// - /// Gets or sets the of items. - /// - /// The of items. - public IList Items { get; set; } - - /// - /// Gets or sets a value indicating whether items in an array are validated using the instance at their array position from . - /// - /// - /// true if items are validated using their array position; otherwise, false. - /// - public bool PositionalItemsValidation { get; set; } - - /// - /// Gets or sets the of additional items. - /// - /// The of additional items. - public JsonSchema AdditionalItems { get; set; } - - /// - /// Gets or sets a value indicating whether additional items are allowed. - /// - /// - /// true if additional items are allowed; otherwise, false. - /// - public bool AllowAdditionalItems { get; set; } - - /// - /// Gets or sets whether the array items must be unique. - /// - public bool UniqueItems { get; set; } - - /// - /// Gets or sets the of properties. - /// - /// The of properties. - public IDictionary Properties { get; set; } - - /// - /// Gets or sets the of additional properties. - /// - /// The of additional properties. - public JsonSchema AdditionalProperties { get; set; } - - /// - /// Gets or sets the pattern properties. - /// - /// The pattern properties. - public IDictionary PatternProperties { get; set; } - - /// - /// Gets or sets a value indicating whether additional properties are allowed. - /// - /// - /// true if additional properties are allowed; otherwise, false. - /// - public bool AllowAdditionalProperties { get; set; } - - /// - /// Gets or sets the required property if this property is present. - /// - /// The required property if this property is present. - public string Requires { get; set; } - - /// - /// Gets or sets the a collection of valid enum values allowed. - /// - /// A collection of valid enum values allowed. - public IList Enum { get; set; } - - /// - /// Gets or sets disallowed types. - /// - /// The disallowed types. - public JsonSchemaType? Disallow { get; set; } - - /// - /// Gets or sets the default value. - /// - /// The default value. - public JToken Default { get; set; } - - /// - /// Gets or sets the collection of that this schema extends. - /// - /// The collection of that this schema extends. - public IList Extends { get; set; } - - /// - /// Gets or sets the format. - /// - /// The format. - public string Format { get; set; } - - internal string Location { get; set; } - -#pragma warning disable CA1305 // Specify IFormatProvider - private readonly string _internalId = Guid.NewGuid().ToString("N"); -#pragma warning restore CA1305 // Specify IFormatProvider - - internal string InternalId => _internalId; - - // if this is set then this schema instance is just a deferred reference - // and will be replaced when the schema reference is resolved - internal string DeferredReference { get; set; } - internal bool ReferencesResolved { get; set; } - - /// - /// Initializes a new instance of the class. - /// - public JsonSchema() - { - AllowAdditionalProperties = true; - AllowAdditionalItems = true; - } - - /// - /// Reads a from the specified . - /// - /// The containing the JSON Schema to read. - /// The object representing the JSON Schema. - public static JsonSchema Read(JsonReader reader) - { - return Read(reader, new JsonSchemaResolver()); - } - - /// - /// Reads a from the specified . - /// - /// The containing the JSON Schema to read. - /// The to use when resolving schema references. - /// The object representing the JSON Schema. - public static JsonSchema Read(JsonReader reader, JsonSchemaResolver resolver) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - ValidationUtils.ArgumentNotNull(resolver, nameof(resolver)); - - JsonSchemaBuilder builder = new JsonSchemaBuilder(resolver); - return builder.Read(reader); - } - - /// - /// Load a from a string that contains JSON Schema. - /// - /// A that contains JSON Schema. - /// A populated from the string that contains JSON Schema. - public static JsonSchema Parse(string json) - { - return Parse(json, new JsonSchemaResolver()); - } - - /// - /// Load a from a string that contains JSON Schema using the specified . - /// - /// A that contains JSON Schema. - /// The resolver. - /// A populated from the string that contains JSON Schema. - public static JsonSchema Parse(string json, JsonSchemaResolver resolver) - { - ValidationUtils.ArgumentNotNull(json, nameof(json)); - - using (JsonReader reader = new JsonTextReader(new StringReader(json))) - { - return Read(reader, resolver); - } - } - - /// - /// Writes this schema to a . - /// - /// A into which this method will write. - public void WriteTo(JsonWriter writer) - { - WriteTo(writer, new JsonSchemaResolver()); - } - - /// - /// Writes this schema to a using the specified . - /// - /// A into which this method will write. - /// The resolver used. - public void WriteTo(JsonWriter writer, JsonSchemaResolver resolver) - { - ValidationUtils.ArgumentNotNull(writer, nameof(writer)); - ValidationUtils.ArgumentNotNull(resolver, nameof(resolver)); - - JsonSchemaWriter schemaWriter = new JsonSchemaWriter(writer, resolver); - schemaWriter.WriteSchema(this); - } - - /// - /// Returns a that represents the current . - /// - /// - /// A that represents the current . - /// - public override string ToString() - { - StringWriter writer = new StringWriter(CultureInfo.InvariantCulture); - JsonTextWriter jsonWriter = new JsonTextWriter(writer); - jsonWriter.Formatting = Formatting.Indented; - - WriteTo(jsonWriter); - - return writer.ToString(); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaBuilder.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaBuilder.cs deleted file mode 100644 index 445d3a6..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaBuilder.cs +++ /dev/null @@ -1,489 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using Newtonsoft.Json.Serialization; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using System.Globalization; -using Newtonsoft.Json.Utilities; -using Newtonsoft.Json.Linq; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - internal class JsonSchemaBuilder - { - private readonly IList _stack; - private readonly JsonSchemaResolver _resolver; - private readonly IDictionary _documentSchemas; - private JsonSchema _currentSchema; - private JObject _rootSchema; - - public JsonSchemaBuilder(JsonSchemaResolver resolver) - { - _stack = new List(); - _documentSchemas = new Dictionary(); - _resolver = resolver; - } - - private void Push(JsonSchema value) - { - _currentSchema = value; - _stack.Add(value); - _resolver.LoadedSchemas.Add(value); - _documentSchemas.Add(value.Location, value); - } - - private JsonSchema Pop() - { - JsonSchema poppedSchema = _currentSchema; - _stack.RemoveAt(_stack.Count - 1); - _currentSchema = _stack.LastOrDefault(); - - return poppedSchema; - } - - private JsonSchema CurrentSchema => _currentSchema; - - internal JsonSchema Read(JsonReader reader) - { - JToken schemaToken = JToken.ReadFrom(reader); - - _rootSchema = schemaToken as JObject; - - JsonSchema schema = BuildSchema(schemaToken); - - ResolveReferences(schema); - - return schema; - } - - private string UnescapeReference(string reference) - { - return Uri.UnescapeDataString(reference).Replace("~1", "/").Replace("~0", "~"); - } - - private JsonSchema ResolveReferences(JsonSchema schema) - { - if (schema.DeferredReference != null) - { - string reference = schema.DeferredReference; - - bool locationReference = (reference.StartsWith("#", StringComparison.Ordinal)); - if (locationReference) - { - reference = UnescapeReference(reference); - } - - JsonSchema resolvedSchema = _resolver.GetSchema(reference); - - if (resolvedSchema == null) - { - if (locationReference) - { - string[] escapedParts = schema.DeferredReference.TrimStart('#').Split(new[] { '/' }, StringSplitOptions.RemoveEmptyEntries); - JToken currentToken = _rootSchema; - foreach (string escapedPart in escapedParts) - { - string part = UnescapeReference(escapedPart); - - if (currentToken.Type == JTokenType.Object) - { - currentToken = currentToken[part]; - } - else if (currentToken.Type == JTokenType.Array || currentToken.Type == JTokenType.Constructor) - { - if (int.TryParse(part, out int index) && index >= 0 && index < currentToken.Count()) - { - currentToken = currentToken[index]; - } - else - { - currentToken = null; - } - } - - if (currentToken == null) - { - break; - } - } - - if (currentToken != null) - { - resolvedSchema = BuildSchema(currentToken); - } - } - - if (resolvedSchema == null) - { - throw new JsonException("Could not resolve schema reference '{0}'.".FormatWith(CultureInfo.InvariantCulture, schema.DeferredReference)); - } - } - - schema = resolvedSchema; - } - - if (schema.ReferencesResolved) - { - return schema; - } - - schema.ReferencesResolved = true; - - if (schema.Extends != null) - { - for (int i = 0; i < schema.Extends.Count; i++) - { - schema.Extends[i] = ResolveReferences(schema.Extends[i]); - } - } - - if (schema.Items != null) - { - for (int i = 0; i < schema.Items.Count; i++) - { - schema.Items[i] = ResolveReferences(schema.Items[i]); - } - } - - if (schema.AdditionalItems != null) - { - schema.AdditionalItems = ResolveReferences(schema.AdditionalItems); - } - - if (schema.PatternProperties != null) - { - foreach (KeyValuePair patternProperty in schema.PatternProperties.ToList()) - { - schema.PatternProperties[patternProperty.Key] = ResolveReferences(patternProperty.Value); - } - } - - if (schema.Properties != null) - { - foreach (KeyValuePair property in schema.Properties.ToList()) - { - schema.Properties[property.Key] = ResolveReferences(property.Value); - } - } - - if (schema.AdditionalProperties != null) - { - schema.AdditionalProperties = ResolveReferences(schema.AdditionalProperties); - } - - return schema; - } - - private JsonSchema BuildSchema(JToken token) - { - if (!(token is JObject schemaObject)) - { - throw JsonException.Create(token, token.Path, "Expected object while parsing schema object, got {0}.".FormatWith(CultureInfo.InvariantCulture, token.Type)); - } - - if (schemaObject.TryGetValue(JsonTypeReflector.RefPropertyName, out JToken referenceToken)) - { - JsonSchema deferredSchema = new JsonSchema(); - deferredSchema.DeferredReference = (string)referenceToken; - - return deferredSchema; - } - - string location = token.Path.Replace(".", "/").Replace("[", "/").Replace("]", string.Empty); - if (!StringUtils.IsNullOrEmpty(location)) - { - location = "/" + location; - } - location = "#" + location; - - if (_documentSchemas.TryGetValue(location, out JsonSchema existingSchema)) - { - return existingSchema; - } - - Push(new JsonSchema { Location = location }); - - ProcessSchemaProperties(schemaObject); - - return Pop(); - } - - private void ProcessSchemaProperties(JObject schemaObject) - { - foreach (KeyValuePair property in schemaObject) - { - switch (property.Key) - { - case JsonSchemaConstants.TypePropertyName: - CurrentSchema.Type = ProcessType(property.Value); - break; - case JsonSchemaConstants.IdPropertyName: - CurrentSchema.Id = (string)property.Value; - break; - case JsonSchemaConstants.TitlePropertyName: - CurrentSchema.Title = (string)property.Value; - break; - case JsonSchemaConstants.DescriptionPropertyName: - CurrentSchema.Description = (string)property.Value; - break; - case JsonSchemaConstants.PropertiesPropertyName: - CurrentSchema.Properties = ProcessProperties(property.Value); - break; - case JsonSchemaConstants.ItemsPropertyName: - ProcessItems(property.Value); - break; - case JsonSchemaConstants.AdditionalPropertiesPropertyName: - ProcessAdditionalProperties(property.Value); - break; - case JsonSchemaConstants.AdditionalItemsPropertyName: - ProcessAdditionalItems(property.Value); - break; - case JsonSchemaConstants.PatternPropertiesPropertyName: - CurrentSchema.PatternProperties = ProcessProperties(property.Value); - break; - case JsonSchemaConstants.RequiredPropertyName: - CurrentSchema.Required = (bool)property.Value; - break; - case JsonSchemaConstants.RequiresPropertyName: - CurrentSchema.Requires = (string)property.Value; - break; - case JsonSchemaConstants.MinimumPropertyName: - CurrentSchema.Minimum = (double)property.Value; - break; - case JsonSchemaConstants.MaximumPropertyName: - CurrentSchema.Maximum = (double)property.Value; - break; - case JsonSchemaConstants.ExclusiveMinimumPropertyName: - CurrentSchema.ExclusiveMinimum = (bool)property.Value; - break; - case JsonSchemaConstants.ExclusiveMaximumPropertyName: - CurrentSchema.ExclusiveMaximum = (bool)property.Value; - break; - case JsonSchemaConstants.MaximumLengthPropertyName: - CurrentSchema.MaximumLength = (int)property.Value; - break; - case JsonSchemaConstants.MinimumLengthPropertyName: - CurrentSchema.MinimumLength = (int)property.Value; - break; - case JsonSchemaConstants.MaximumItemsPropertyName: - CurrentSchema.MaximumItems = (int)property.Value; - break; - case JsonSchemaConstants.MinimumItemsPropertyName: - CurrentSchema.MinimumItems = (int)property.Value; - break; - case JsonSchemaConstants.DivisibleByPropertyName: - CurrentSchema.DivisibleBy = (double)property.Value; - break; - case JsonSchemaConstants.DisallowPropertyName: - CurrentSchema.Disallow = ProcessType(property.Value); - break; - case JsonSchemaConstants.DefaultPropertyName: - CurrentSchema.Default = property.Value.DeepClone(); - break; - case JsonSchemaConstants.HiddenPropertyName: - CurrentSchema.Hidden = (bool)property.Value; - break; - case JsonSchemaConstants.ReadOnlyPropertyName: - CurrentSchema.ReadOnly = (bool)property.Value; - break; - case JsonSchemaConstants.FormatPropertyName: - CurrentSchema.Format = (string)property.Value; - break; - case JsonSchemaConstants.PatternPropertyName: - CurrentSchema.Pattern = (string)property.Value; - break; - case JsonSchemaConstants.EnumPropertyName: - ProcessEnum(property.Value); - break; - case JsonSchemaConstants.ExtendsPropertyName: - ProcessExtends(property.Value); - break; - case JsonSchemaConstants.UniqueItemsPropertyName: - CurrentSchema.UniqueItems = (bool)property.Value; - break; - } - } - } - - private void ProcessExtends(JToken token) - { - IList schemas = new List(); - - if (token.Type == JTokenType.Array) - { - foreach (JToken schemaObject in token) - { - schemas.Add(BuildSchema(schemaObject)); - } - } - else - { - JsonSchema schema = BuildSchema(token); - if (schema != null) - { - schemas.Add(schema); - } - } - - if (schemas.Count > 0) - { - CurrentSchema.Extends = schemas; - } - } - - private void ProcessEnum(JToken token) - { - if (token.Type != JTokenType.Array) - { - throw JsonException.Create(token, token.Path, "Expected Array token while parsing enum values, got {0}.".FormatWith(CultureInfo.InvariantCulture, token.Type)); - } - - CurrentSchema.Enum = new List(); - - foreach (JToken enumValue in token) - { - CurrentSchema.Enum.Add(enumValue.DeepClone()); - } - } - - private void ProcessAdditionalProperties(JToken token) - { - if (token.Type == JTokenType.Boolean) - { - CurrentSchema.AllowAdditionalProperties = (bool)token; - } - else - { - CurrentSchema.AdditionalProperties = BuildSchema(token); - } - } - - private void ProcessAdditionalItems(JToken token) - { - if (token.Type == JTokenType.Boolean) - { - CurrentSchema.AllowAdditionalItems = (bool)token; - } - else - { - CurrentSchema.AdditionalItems = BuildSchema(token); - } - } - - private IDictionary ProcessProperties(JToken token) - { - IDictionary properties = new Dictionary(); - - if (token.Type != JTokenType.Object) - { - throw JsonException.Create(token, token.Path, "Expected Object token while parsing schema properties, got {0}.".FormatWith(CultureInfo.InvariantCulture, token.Type)); - } - - foreach (JProperty propertyToken in token) - { - if (properties.ContainsKey(propertyToken.Name)) - { - throw new JsonException("Property {0} has already been defined in schema.".FormatWith(CultureInfo.InvariantCulture, propertyToken.Name)); - } - - properties.Add(propertyToken.Name, BuildSchema(propertyToken.Value)); - } - - return properties; - } - - private void ProcessItems(JToken token) - { - CurrentSchema.Items = new List(); - - switch (token.Type) - { - case JTokenType.Object: - CurrentSchema.Items.Add(BuildSchema(token)); - CurrentSchema.PositionalItemsValidation = false; - break; - case JTokenType.Array: - CurrentSchema.PositionalItemsValidation = true; - foreach (JToken schemaToken in token) - { - CurrentSchema.Items.Add(BuildSchema(schemaToken)); - } - break; - default: - throw JsonException.Create(token, token.Path, "Expected array or JSON schema object, got {0}.".FormatWith(CultureInfo.InvariantCulture, token.Type)); - } - } - - private JsonSchemaType? ProcessType(JToken token) - { - switch (token.Type) - { - case JTokenType.Array: - // ensure type is in blank state before ORing values - JsonSchemaType? type = JsonSchemaType.None; - - foreach (JToken typeToken in token) - { - if (typeToken.Type != JTokenType.String) - { - throw JsonException.Create(typeToken, typeToken.Path, "Expected JSON schema type string token, got {0}.".FormatWith(CultureInfo.InvariantCulture, token.Type)); - } - - type = type | MapType((string)typeToken); - } - - return type; - case JTokenType.String: - return MapType((string)token); - default: - throw JsonException.Create(token, token.Path, "Expected array or JSON schema type string token, got {0}.".FormatWith(CultureInfo.InvariantCulture, token.Type)); - } - } - - internal static JsonSchemaType MapType(string type) - { - if (!JsonSchemaConstants.JsonSchemaTypeMapping.TryGetValue(type, out JsonSchemaType mappedType)) - { - throw new JsonException("Invalid JSON schema type: {0}".FormatWith(CultureInfo.InvariantCulture, type)); - } - - return mappedType; - } - - internal static string MapType(JsonSchemaType type) - { - return JsonSchemaConstants.JsonSchemaTypeMapping.Single(kv => kv.Value == type).Key; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaConstants.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaConstants.cs deleted file mode 100644 index d439394..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaConstants.cs +++ /dev/null @@ -1,82 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - internal static class JsonSchemaConstants - { - public const string TypePropertyName = "type"; - public const string PropertiesPropertyName = "properties"; - public const string ItemsPropertyName = "items"; - public const string AdditionalItemsPropertyName = "additionalItems"; - public const string RequiredPropertyName = "required"; - public const string PatternPropertiesPropertyName = "patternProperties"; - public const string AdditionalPropertiesPropertyName = "additionalProperties"; - public const string RequiresPropertyName = "requires"; - public const string MinimumPropertyName = "minimum"; - public const string MaximumPropertyName = "maximum"; - public const string ExclusiveMinimumPropertyName = "exclusiveMinimum"; - public const string ExclusiveMaximumPropertyName = "exclusiveMaximum"; - public const string MinimumItemsPropertyName = "minItems"; - public const string MaximumItemsPropertyName = "maxItems"; - public const string PatternPropertyName = "pattern"; - public const string MaximumLengthPropertyName = "maxLength"; - public const string MinimumLengthPropertyName = "minLength"; - public const string EnumPropertyName = "enum"; - public const string ReadOnlyPropertyName = "readonly"; - public const string TitlePropertyName = "title"; - public const string DescriptionPropertyName = "description"; - public const string FormatPropertyName = "format"; - public const string DefaultPropertyName = "default"; - public const string TransientPropertyName = "transient"; - public const string DivisibleByPropertyName = "divisibleBy"; - public const string HiddenPropertyName = "hidden"; - public const string DisallowPropertyName = "disallow"; - public const string ExtendsPropertyName = "extends"; - public const string IdPropertyName = "id"; - public const string UniqueItemsPropertyName = "uniqueItems"; - - public const string OptionValuePropertyName = "value"; - public const string OptionLabelPropertyName = "label"; - - public static readonly IDictionary JsonSchemaTypeMapping = new Dictionary - { - { "string", JsonSchemaType.String }, - { "object", JsonSchemaType.Object }, - { "integer", JsonSchemaType.Integer }, - { "number", JsonSchemaType.Float }, - { "null", JsonSchemaType.Null }, - { "boolean", JsonSchemaType.Boolean }, - { "array", JsonSchemaType.Array }, - { "any", JsonSchemaType.Any } - }; - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaException.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaException.cs deleted file mode 100644 index 2349589..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaException.cs +++ /dev/null @@ -1,115 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Runtime.Serialization; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - /// - /// - /// Returns detailed information about the schema exception. - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - [Serializable] -#endif - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public class JsonSchemaException : JsonException - { - /// - /// Gets the line number indicating where the error occurred. - /// - /// The line number indicating where the error occurred. - public int LineNumber { get; } - - /// - /// Gets the line position indicating where the error occurred. - /// - /// The line position indicating where the error occurred. - public int LinePosition { get; } - - /// - /// Gets the path to the JSON where the error occurred. - /// - /// The path to the JSON where the error occurred. - public string Path { get; } - - /// - /// Initializes a new instance of the class. - /// - public JsonSchemaException() - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message. - /// - /// The error message that explains the reason for the exception. - public JsonSchemaException(string message) - : base(message) - { - } - - /// - /// Initializes a new instance of the class - /// with a specified error message and a reference to the inner exception that is the cause of this exception. - /// - /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or null if no inner exception is specified. - public JsonSchemaException(string message, Exception innerException) - : base(message, innerException) - { - } - -#if HAVE_BINARY_EXCEPTION_SERIALIZATION - /// - /// Initializes a new instance of the class. - /// - /// The that holds the serialized object data about the exception being thrown. - /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). - public JsonSchemaException(SerializationInfo info, StreamingContext context) - : base(info, context) - { - } -#endif - - internal JsonSchemaException(string message, Exception innerException, string path, int lineNumber, int linePosition) - : base(message, innerException) - { - Path = path; - LineNumber = lineNumber; - LinePosition = linePosition; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaGenerator.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaGenerator.cs deleted file mode 100644 index 7cdab61..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaGenerator.cs +++ /dev/null @@ -1,504 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using System.ComponentModel; -using System.Collections.Generic; -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Utilities; -using Newtonsoft.Json.Serialization; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - /// - /// - /// Generates a from a specified . - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public class JsonSchemaGenerator - { - /// - /// Gets or sets how undefined schemas are handled by the serializer. - /// - public UndefinedSchemaIdHandling UndefinedSchemaIdHandling { get; set; } - - private IContractResolver _contractResolver; - - /// - /// Gets or sets the contract resolver. - /// - /// The contract resolver. - public IContractResolver ContractResolver - { - get - { - if (_contractResolver == null) - { - return DefaultContractResolver.Instance; - } - - return _contractResolver; - } - set => _contractResolver = value; - } - - private class TypeSchema - { - public Type Type { get; } - public JsonSchema Schema { get; } - - public TypeSchema(Type type, JsonSchema schema) - { - ValidationUtils.ArgumentNotNull(type, nameof(type)); - ValidationUtils.ArgumentNotNull(schema, nameof(schema)); - - Type = type; - Schema = schema; - } - } - - private JsonSchemaResolver _resolver; - private readonly IList _stack = new List(); - private JsonSchema _currentSchema; - - private JsonSchema CurrentSchema => _currentSchema; - - private void Push(TypeSchema typeSchema) - { - _currentSchema = typeSchema.Schema; - _stack.Add(typeSchema); - _resolver.LoadedSchemas.Add(typeSchema.Schema); - } - - private TypeSchema Pop() - { - TypeSchema popped = _stack[_stack.Count - 1]; - _stack.RemoveAt(_stack.Count - 1); - TypeSchema newValue = _stack.LastOrDefault(); - if (newValue != null) - { - _currentSchema = newValue.Schema; - } - else - { - _currentSchema = null; - } - - return popped; - } - - /// - /// Generate a from the specified type. - /// - /// The type to generate a from. - /// A generated from the specified type. - public JsonSchema Generate(Type type) - { - return Generate(type, new JsonSchemaResolver(), false); - } - - /// - /// Generate a from the specified type. - /// - /// The type to generate a from. - /// The used to resolve schema references. - /// A generated from the specified type. - public JsonSchema Generate(Type type, JsonSchemaResolver resolver) - { - return Generate(type, resolver, false); - } - - /// - /// Generate a from the specified type. - /// - /// The type to generate a from. - /// Specify whether the generated root will be nullable. - /// A generated from the specified type. - public JsonSchema Generate(Type type, bool rootSchemaNullable) - { - return Generate(type, new JsonSchemaResolver(), rootSchemaNullable); - } - - /// - /// Generate a from the specified type. - /// - /// The type to generate a from. - /// The used to resolve schema references. - /// Specify whether the generated root will be nullable. - /// A generated from the specified type. - public JsonSchema Generate(Type type, JsonSchemaResolver resolver, bool rootSchemaNullable) - { - ValidationUtils.ArgumentNotNull(type, nameof(type)); - ValidationUtils.ArgumentNotNull(resolver, nameof(resolver)); - - _resolver = resolver; - - return GenerateInternal(type, (!rootSchemaNullable) ? Required.Always : Required.Default, false); - } - - private string GetTitle(Type type) - { - JsonContainerAttribute containerAttribute = JsonTypeReflector.GetCachedAttribute(type); - - if (!StringUtils.IsNullOrEmpty(containerAttribute?.Title)) - { - return containerAttribute.Title; - } - - return null; - } - - private string GetDescription(Type type) - { - JsonContainerAttribute containerAttribute = JsonTypeReflector.GetCachedAttribute(type); - - if (!StringUtils.IsNullOrEmpty(containerAttribute?.Description)) - { - return containerAttribute.Description; - } - -#if HAVE_ADO_NET - DescriptionAttribute descriptionAttribute = ReflectionUtils.GetAttribute(type); - return descriptionAttribute?.Description; -#else - return null; -#endif - } - - private string GetTypeId(Type type, bool explicitOnly) - { - JsonContainerAttribute containerAttribute = JsonTypeReflector.GetCachedAttribute(type); - - if (!StringUtils.IsNullOrEmpty(containerAttribute?.Id)) - { - return containerAttribute.Id; - } - - if (explicitOnly) - { - return null; - } - - switch (UndefinedSchemaIdHandling) - { - case UndefinedSchemaIdHandling.UseTypeName: - return type.FullName; - case UndefinedSchemaIdHandling.UseAssemblyQualifiedName: - return type.AssemblyQualifiedName; - default: - return null; - } - } - - private JsonSchema GenerateInternal(Type type, Required valueRequired, bool required) - { - ValidationUtils.ArgumentNotNull(type, nameof(type)); - - string resolvedId = GetTypeId(type, false); - string explicitId = GetTypeId(type, true); - - if (!StringUtils.IsNullOrEmpty(resolvedId)) - { - JsonSchema resolvedSchema = _resolver.GetSchema(resolvedId); - if (resolvedSchema != null) - { - // resolved schema is not null but referencing member allows nulls - // change resolved schema to allow nulls. hacky but what are ya gonna do? - if (valueRequired != Required.Always && !HasFlag(resolvedSchema.Type, JsonSchemaType.Null)) - { - resolvedSchema.Type |= JsonSchemaType.Null; - } - if (required && resolvedSchema.Required != true) - { - resolvedSchema.Required = true; - } - - return resolvedSchema; - } - } - - // test for unresolved circular reference - if (_stack.Any(tc => tc.Type == type)) - { - throw new JsonException("Unresolved circular reference for type '{0}'. Explicitly define an Id for the type using a JsonObject/JsonArray attribute or automatically generate a type Id using the UndefinedSchemaIdHandling property.".FormatWith(CultureInfo.InvariantCulture, type)); - } - - JsonContract contract = ContractResolver.ResolveContract(type); - JsonConverter converter = contract.Converter ?? contract.InternalConverter; - - Push(new TypeSchema(type, new JsonSchema())); - - if (explicitId != null) - { - CurrentSchema.Id = explicitId; - } - - if (required) - { - CurrentSchema.Required = true; - } - CurrentSchema.Title = GetTitle(type); - CurrentSchema.Description = GetDescription(type); - - if (converter != null) - { - // todo: Add GetSchema to JsonConverter and use here? - CurrentSchema.Type = JsonSchemaType.Any; - } - else - { - switch (contract.ContractType) - { - case JsonContractType.Object: - CurrentSchema.Type = AddNullType(JsonSchemaType.Object, valueRequired); - CurrentSchema.Id = GetTypeId(type, false); - GenerateObjectSchema(type, (JsonObjectContract)contract); - break; - case JsonContractType.Array: - CurrentSchema.Type = AddNullType(JsonSchemaType.Array, valueRequired); - - CurrentSchema.Id = GetTypeId(type, false); - - JsonArrayAttribute arrayAttribute = JsonTypeReflector.GetCachedAttribute(type); - bool allowNullItem = (arrayAttribute == null || arrayAttribute.AllowNullItems); - - Type collectionItemType = ReflectionUtils.GetCollectionItemType(type); - if (collectionItemType != null) - { - CurrentSchema.Items = new List(); - CurrentSchema.Items.Add(GenerateInternal(collectionItemType, (!allowNullItem) ? Required.Always : Required.Default, false)); - } - break; - case JsonContractType.Primitive: - CurrentSchema.Type = GetJsonSchemaType(type, valueRequired); - - if (CurrentSchema.Type == JsonSchemaType.Integer && type.IsEnum() && !type.IsDefined(typeof(FlagsAttribute), true)) - { - CurrentSchema.Enum = new List(); - - EnumInfo enumValues = EnumUtils.GetEnumValuesAndNames(type); - for (int i = 0; i < enumValues.Names.Length; i++) - { - ulong v = enumValues.Values[i]; - JToken value = JToken.FromObject(Enum.ToObject(type, v)); - - CurrentSchema.Enum.Add(value); - } - } - break; - case JsonContractType.String: - JsonSchemaType schemaType = (!ReflectionUtils.IsNullable(contract.UnderlyingType)) - ? JsonSchemaType.String - : AddNullType(JsonSchemaType.String, valueRequired); - - CurrentSchema.Type = schemaType; - break; - case JsonContractType.Dictionary: - CurrentSchema.Type = AddNullType(JsonSchemaType.Object, valueRequired); - - Type keyType; - Type valueType; - ReflectionUtils.GetDictionaryKeyValueTypes(type, out keyType, out valueType); - - if (keyType != null) - { - JsonContract keyContract = ContractResolver.ResolveContract(keyType); - - // can be converted to a string - if (keyContract.ContractType == JsonContractType.Primitive) - { - CurrentSchema.AdditionalProperties = GenerateInternal(valueType, Required.Default, false); - } - } - break; -#if HAVE_BINARY_SERIALIZATION - case JsonContractType.Serializable: - CurrentSchema.Type = AddNullType(JsonSchemaType.Object, valueRequired); - CurrentSchema.Id = GetTypeId(type, false); - GenerateISerializableContract(type, (JsonISerializableContract)contract); - break; -#endif -#if HAVE_DYNAMIC - case JsonContractType.Dynamic: -#endif - case JsonContractType.Linq: - CurrentSchema.Type = JsonSchemaType.Any; - break; - default: - throw new JsonException("Unexpected contract type: {0}".FormatWith(CultureInfo.InvariantCulture, contract)); - } - } - - return Pop().Schema; - } - - private JsonSchemaType AddNullType(JsonSchemaType type, Required valueRequired) - { - if (valueRequired != Required.Always) - { - return type | JsonSchemaType.Null; - } - - return type; - } - - private bool HasFlag(DefaultValueHandling value, DefaultValueHandling flag) - { - return ((value & flag) == flag); - } - - private void GenerateObjectSchema(Type type, JsonObjectContract contract) - { - CurrentSchema.Properties = new Dictionary(); - foreach (JsonProperty property in contract.Properties) - { - if (!property.Ignored) - { - bool optional = property.NullValueHandling == NullValueHandling.Ignore || - HasFlag(property.DefaultValueHandling.GetValueOrDefault(), DefaultValueHandling.Ignore) || - property.ShouldSerialize != null || - property.GetIsSpecified != null; - - JsonSchema propertySchema = GenerateInternal(property.PropertyType, property.Required, !optional); - - if (property.DefaultValue != null) - { - propertySchema.Default = JToken.FromObject(property.DefaultValue); - } - - CurrentSchema.Properties.Add(property.PropertyName, propertySchema); - } - } - - if (type.IsSealed()) - { - CurrentSchema.AllowAdditionalProperties = false; - } - } - -#if HAVE_BINARY_SERIALIZATION - private void GenerateISerializableContract(Type type, JsonISerializableContract contract) - { - CurrentSchema.AllowAdditionalProperties = true; - } -#endif - - internal static bool HasFlag(JsonSchemaType? value, JsonSchemaType flag) - { - // default value is Any - if (value == null) - { - return true; - } - - bool match = ((value & flag) == flag); - if (match) - { - return true; - } - - // integer is a subset of float - if (flag == JsonSchemaType.Integer && (value & JsonSchemaType.Float) == JsonSchemaType.Float) - { - return true; - } - - return false; - } - - private JsonSchemaType GetJsonSchemaType(Type type, Required valueRequired) - { - JsonSchemaType schemaType = JsonSchemaType.None; - if (valueRequired != Required.Always && ReflectionUtils.IsNullable(type)) - { - schemaType = JsonSchemaType.Null; - if (ReflectionUtils.IsNullableType(type)) - { - type = Nullable.GetUnderlyingType(type); - } - } - - PrimitiveTypeCode typeCode = ConvertUtils.GetTypeCode(type); - - switch (typeCode) - { - case PrimitiveTypeCode.Empty: - case PrimitiveTypeCode.Object: - return schemaType | JsonSchemaType.String; -#if HAVE_DB_NULL_TYPE_CODE - case PrimitiveTypeCode.DBNull: - return schemaType | JsonSchemaType.Null; -#endif - case PrimitiveTypeCode.Boolean: - return schemaType | JsonSchemaType.Boolean; - case PrimitiveTypeCode.Char: - return schemaType | JsonSchemaType.String; - case PrimitiveTypeCode.SByte: - case PrimitiveTypeCode.Byte: - case PrimitiveTypeCode.Int16: - case PrimitiveTypeCode.UInt16: - case PrimitiveTypeCode.Int32: - case PrimitiveTypeCode.UInt32: - case PrimitiveTypeCode.Int64: - case PrimitiveTypeCode.UInt64: -#if HAVE_BIG_INTEGER - case PrimitiveTypeCode.BigInteger: -#endif - return schemaType | JsonSchemaType.Integer; - case PrimitiveTypeCode.Single: - case PrimitiveTypeCode.Double: - case PrimitiveTypeCode.Decimal: - return schemaType | JsonSchemaType.Float; - // convert to string? - case PrimitiveTypeCode.DateTime: -#if HAVE_DATE_TIME_OFFSET - case PrimitiveTypeCode.DateTimeOffset: -#endif - return schemaType | JsonSchemaType.String; - case PrimitiveTypeCode.String: - case PrimitiveTypeCode.Uri: - case PrimitiveTypeCode.Guid: - case PrimitiveTypeCode.TimeSpan: - case PrimitiveTypeCode.Bytes: - return schemaType | JsonSchemaType.String; - default: - throw new JsonException("Unexpected type code '{0}' for type '{1}'.".FormatWith(CultureInfo.InvariantCulture, typeCode, type)); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaModel.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaModel.cs deleted file mode 100644 index 2c55d07..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaModel.cs +++ /dev/null @@ -1,127 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Utilities; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - internal class JsonSchemaModel - { - public bool Required { get; set; } - public JsonSchemaType Type { get; set; } - public int? MinimumLength { get; set; } - public int? MaximumLength { get; set; } - public double? DivisibleBy { get; set; } - public double? Minimum { get; set; } - public double? Maximum { get; set; } - public bool ExclusiveMinimum { get; set; } - public bool ExclusiveMaximum { get; set; } - public int? MinimumItems { get; set; } - public int? MaximumItems { get; set; } - public IList Patterns { get; set; } - public IList Items { get; set; } - public IDictionary Properties { get; set; } - public IDictionary PatternProperties { get; set; } - public JsonSchemaModel AdditionalProperties { get; set; } - public JsonSchemaModel AdditionalItems { get; set; } - public bool PositionalItemsValidation { get; set; } - public bool AllowAdditionalProperties { get; set; } - public bool AllowAdditionalItems { get; set; } - public bool UniqueItems { get; set; } - public IList Enum { get; set; } - public JsonSchemaType Disallow { get; set; } - - public JsonSchemaModel() - { - Type = JsonSchemaType.Any; - AllowAdditionalProperties = true; - AllowAdditionalItems = true; - Required = false; - } - - public static JsonSchemaModel Create(IList schemata) - { - JsonSchemaModel model = new JsonSchemaModel(); - - foreach (JsonSchema schema in schemata) - { - Combine(model, schema); - } - - return model; - } - - private static void Combine(JsonSchemaModel model, JsonSchema schema) - { - // Version 3 of the Draft JSON Schema has the default value of Not Required - model.Required = model.Required || (schema.Required ?? false); - model.Type = model.Type & (schema.Type ?? JsonSchemaType.Any); - - model.MinimumLength = MathUtils.Max(model.MinimumLength, schema.MinimumLength); - model.MaximumLength = MathUtils.Min(model.MaximumLength, schema.MaximumLength); - - // not sure what is the best way to combine divisibleBy - model.DivisibleBy = MathUtils.Max(model.DivisibleBy, schema.DivisibleBy); - - model.Minimum = MathUtils.Max(model.Minimum, schema.Minimum); - model.Maximum = MathUtils.Max(model.Maximum, schema.Maximum); - model.ExclusiveMinimum = model.ExclusiveMinimum || (schema.ExclusiveMinimum ?? false); - model.ExclusiveMaximum = model.ExclusiveMaximum || (schema.ExclusiveMaximum ?? false); - - model.MinimumItems = MathUtils.Max(model.MinimumItems, schema.MinimumItems); - model.MaximumItems = MathUtils.Min(model.MaximumItems, schema.MaximumItems); - model.PositionalItemsValidation = model.PositionalItemsValidation || schema.PositionalItemsValidation; - model.AllowAdditionalProperties = model.AllowAdditionalProperties && schema.AllowAdditionalProperties; - model.AllowAdditionalItems = model.AllowAdditionalItems && schema.AllowAdditionalItems; - model.UniqueItems = model.UniqueItems || schema.UniqueItems; - if (schema.Enum != null) - { - if (model.Enum == null) - { - model.Enum = new List(); - } - - model.Enum.AddRangeDistinct(schema.Enum, JToken.EqualityComparer); - } - model.Disallow = model.Disallow | (schema.Disallow ?? JsonSchemaType.None); - - if (schema.Pattern != null) - { - if (model.Patterns == null) - { - model.Patterns = new List(); - } - - model.Patterns.AddDistinct(schema.Pattern); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaModelBuilder.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaModelBuilder.cs deleted file mode 100644 index e29d42e..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaModelBuilder.cs +++ /dev/null @@ -1,213 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - internal class JsonSchemaModelBuilder - { - private JsonSchemaNodeCollection _nodes = new JsonSchemaNodeCollection(); - private Dictionary _nodeModels = new Dictionary(); - private JsonSchemaNode _node; - - public JsonSchemaModel Build(JsonSchema schema) - { - _nodes = new JsonSchemaNodeCollection(); - _node = AddSchema(null, schema); - - _nodeModels = new Dictionary(); - JsonSchemaModel model = BuildNodeModel(_node); - - return model; - } - - public JsonSchemaNode AddSchema(JsonSchemaNode existingNode, JsonSchema schema) - { - string newId; - if (existingNode != null) - { - if (existingNode.Schemas.Contains(schema)) - { - return existingNode; - } - - newId = JsonSchemaNode.GetId(existingNode.Schemas.Union(new[] { schema })); - } - else - { - newId = JsonSchemaNode.GetId(new[] { schema }); - } - - if (_nodes.Contains(newId)) - { - return _nodes[newId]; - } - - JsonSchemaNode currentNode = (existingNode != null) - ? existingNode.Combine(schema) - : new JsonSchemaNode(schema); - - _nodes.Add(currentNode); - - AddProperties(schema.Properties, currentNode.Properties); - - AddProperties(schema.PatternProperties, currentNode.PatternProperties); - - if (schema.Items != null) - { - for (int i = 0; i < schema.Items.Count; i++) - { - AddItem(currentNode, i, schema.Items[i]); - } - } - - if (schema.AdditionalItems != null) - { - AddAdditionalItems(currentNode, schema.AdditionalItems); - } - - if (schema.AdditionalProperties != null) - { - AddAdditionalProperties(currentNode, schema.AdditionalProperties); - } - - if (schema.Extends != null) - { - foreach (JsonSchema jsonSchema in schema.Extends) - { - currentNode = AddSchema(currentNode, jsonSchema); - } - } - - return currentNode; - } - - public void AddProperties(IDictionary source, IDictionary target) - { - if (source != null) - { - foreach (KeyValuePair property in source) - { - AddProperty(target, property.Key, property.Value); - } - } - } - - public void AddProperty(IDictionary target, string propertyName, JsonSchema schema) - { - target.TryGetValue(propertyName, out JsonSchemaNode propertyNode); - - target[propertyName] = AddSchema(propertyNode, schema); - } - - public void AddItem(JsonSchemaNode parentNode, int index, JsonSchema schema) - { - JsonSchemaNode existingItemNode = (parentNode.Items.Count > index) - ? parentNode.Items[index] - : null; - - JsonSchemaNode newItemNode = AddSchema(existingItemNode, schema); - - if (!(parentNode.Items.Count > index)) - { - parentNode.Items.Add(newItemNode); - } - else - { - parentNode.Items[index] = newItemNode; - } - } - - public void AddAdditionalProperties(JsonSchemaNode parentNode, JsonSchema schema) - { - parentNode.AdditionalProperties = AddSchema(parentNode.AdditionalProperties, schema); - } - - public void AddAdditionalItems(JsonSchemaNode parentNode, JsonSchema schema) - { - parentNode.AdditionalItems = AddSchema(parentNode.AdditionalItems, schema); - } - - private JsonSchemaModel BuildNodeModel(JsonSchemaNode node) - { - if (_nodeModels.TryGetValue(node, out JsonSchemaModel model)) - { - return model; - } - - model = JsonSchemaModel.Create(node.Schemas); - _nodeModels[node] = model; - - foreach (KeyValuePair property in node.Properties) - { - if (model.Properties == null) - { - model.Properties = new Dictionary(); - } - - model.Properties[property.Key] = BuildNodeModel(property.Value); - } - foreach (KeyValuePair property in node.PatternProperties) - { - if (model.PatternProperties == null) - { - model.PatternProperties = new Dictionary(); - } - - model.PatternProperties[property.Key] = BuildNodeModel(property.Value); - } - foreach (JsonSchemaNode t in node.Items) - { - if (model.Items == null) - { - model.Items = new List(); - } - - model.Items.Add(BuildNodeModel(t)); - } - if (node.AdditionalProperties != null) - { - model.AdditionalProperties = BuildNodeModel(node.AdditionalProperties); - } - if (node.AdditionalItems != null) - { - model.AdditionalItems = BuildNodeModel(node.AdditionalItems); - } - - return model; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaNode.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaNode.cs deleted file mode 100644 index 30757f0..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaNode.cs +++ /dev/null @@ -1,87 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Collections.ObjectModel; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - internal class JsonSchemaNode - { - public string Id { get; } - public ReadOnlyCollection Schemas { get; } - public Dictionary Properties { get; } - public Dictionary PatternProperties { get; } - public List Items { get; } - public JsonSchemaNode AdditionalProperties { get; set; } - public JsonSchemaNode AdditionalItems { get; set; } - - public JsonSchemaNode(JsonSchema schema) - { - Schemas = new ReadOnlyCollection(new[] { schema }); - Properties = new Dictionary(); - PatternProperties = new Dictionary(); - Items = new List(); - - Id = GetId(Schemas); - } - - private JsonSchemaNode(JsonSchemaNode source, JsonSchema schema) - { - Schemas = new ReadOnlyCollection(source.Schemas.Union(new[] { schema }).ToList()); - Properties = new Dictionary(source.Properties); - PatternProperties = new Dictionary(source.PatternProperties); - Items = new List(source.Items); - AdditionalProperties = source.AdditionalProperties; - AdditionalItems = source.AdditionalItems; - - Id = GetId(Schemas); - } - - public JsonSchemaNode Combine(JsonSchema schema) - { - return new JsonSchemaNode(this, schema); - } - - public static string GetId(IEnumerable schemata) - { - return string.Join("-", schemata.Select(s => s.InternalId).OrderBy(id => id, StringComparer.Ordinal) -#if !HAVE_STRING_JOIN_WITH_ENUMERABLE - .ToArray() -#endif - ); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaNodeCollection.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaNodeCollection.cs deleted file mode 100644 index af5bbb7..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaNodeCollection.cs +++ /dev/null @@ -1,41 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.ObjectModel; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - internal class JsonSchemaNodeCollection : KeyedCollection - { - protected override string GetKeyForItem(JsonSchemaNode item) - { - return item.Id; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaResolver.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaResolver.cs deleted file mode 100644 index 714aebd..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaResolver.cs +++ /dev/null @@ -1,81 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - /// - /// - /// Resolves from an id. - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public class JsonSchemaResolver - { - /// - /// Gets or sets the loaded schemas. - /// - /// The loaded schemas. - public IList LoadedSchemas { get; protected set; } - - /// - /// Initializes a new instance of the class. - /// - public JsonSchemaResolver() - { - LoadedSchemas = new List(); - } - - /// - /// Gets a for the specified reference. - /// - /// The id. - /// A for the specified reference. - public virtual JsonSchema GetSchema(string reference) - { - JsonSchema schema = LoadedSchemas.SingleOrDefault(s => string.Equals(s.Id, reference, StringComparison.Ordinal)); - - if (schema == null) - { - schema = LoadedSchemas.SingleOrDefault(s => string.Equals(s.Location, reference, StringComparison.Ordinal)); - } - - return schema; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaType.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaType.cs deleted file mode 100644 index ec9181b..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaType.cs +++ /dev/null @@ -1,89 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - /// - /// - /// The value types allowed by the . - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - [Flags] - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public enum JsonSchemaType - { - /// - /// No type specified. - /// - None = 0, - - /// - /// String type. - /// - String = 1, - - /// - /// Float type. - /// - Float = 2, - - /// - /// Integer type. - /// - Integer = 4, - - /// - /// Boolean type. - /// - Boolean = 8, - - /// - /// Object type. - /// - Object = 16, - - /// - /// Array type. - /// - Array = 32, - - /// - /// Null type. - /// - Null = 64, - - /// - /// Any type. - /// - Any = String | Float | Integer | Boolean | Object | Array | Null - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaWriter.cs b/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaWriter.cs deleted file mode 100644 index c5843be..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/JsonSchemaWriter.cs +++ /dev/null @@ -1,260 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Serialization; -using Newtonsoft.Json.Utilities; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - internal class JsonSchemaWriter - { - private readonly JsonWriter _writer; - private readonly JsonSchemaResolver _resolver; - - public JsonSchemaWriter(JsonWriter writer, JsonSchemaResolver resolver) - { - ValidationUtils.ArgumentNotNull(writer, nameof(writer)); - _writer = writer; - _resolver = resolver; - } - - private void ReferenceOrWriteSchema(JsonSchema schema) - { - if (schema.Id != null && _resolver.GetSchema(schema.Id) != null) - { - _writer.WriteStartObject(); - _writer.WritePropertyName(JsonTypeReflector.RefPropertyName); - _writer.WriteValue(schema.Id); - _writer.WriteEndObject(); - } - else - { - WriteSchema(schema); - } - } - - public void WriteSchema(JsonSchema schema) - { - ValidationUtils.ArgumentNotNull(schema, nameof(schema)); - - if (!_resolver.LoadedSchemas.Contains(schema)) - { - _resolver.LoadedSchemas.Add(schema); - } - - _writer.WriteStartObject(); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.IdPropertyName, schema.Id); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.TitlePropertyName, schema.Title); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.DescriptionPropertyName, schema.Description); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.RequiredPropertyName, schema.Required); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.ReadOnlyPropertyName, schema.ReadOnly); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.HiddenPropertyName, schema.Hidden); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.TransientPropertyName, schema.Transient); - if (schema.Type != null) - { - WriteType(JsonSchemaConstants.TypePropertyName, _writer, schema.Type.GetValueOrDefault()); - } - if (!schema.AllowAdditionalProperties) - { - _writer.WritePropertyName(JsonSchemaConstants.AdditionalPropertiesPropertyName); - _writer.WriteValue(schema.AllowAdditionalProperties); - } - else - { - if (schema.AdditionalProperties != null) - { - _writer.WritePropertyName(JsonSchemaConstants.AdditionalPropertiesPropertyName); - ReferenceOrWriteSchema(schema.AdditionalProperties); - } - } - if (!schema.AllowAdditionalItems) - { - _writer.WritePropertyName(JsonSchemaConstants.AdditionalItemsPropertyName); - _writer.WriteValue(schema.AllowAdditionalItems); - } - else - { - if (schema.AdditionalItems != null) - { - _writer.WritePropertyName(JsonSchemaConstants.AdditionalItemsPropertyName); - ReferenceOrWriteSchema(schema.AdditionalItems); - } - } - WriteSchemaDictionaryIfNotNull(_writer, JsonSchemaConstants.PropertiesPropertyName, schema.Properties); - WriteSchemaDictionaryIfNotNull(_writer, JsonSchemaConstants.PatternPropertiesPropertyName, schema.PatternProperties); - WriteItems(schema); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.MinimumPropertyName, schema.Minimum); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.MaximumPropertyName, schema.Maximum); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.ExclusiveMinimumPropertyName, schema.ExclusiveMinimum); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.ExclusiveMaximumPropertyName, schema.ExclusiveMaximum); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.MinimumLengthPropertyName, schema.MinimumLength); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.MaximumLengthPropertyName, schema.MaximumLength); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.MinimumItemsPropertyName, schema.MinimumItems); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.MaximumItemsPropertyName, schema.MaximumItems); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.DivisibleByPropertyName, schema.DivisibleBy); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.FormatPropertyName, schema.Format); - WritePropertyIfNotNull(_writer, JsonSchemaConstants.PatternPropertyName, schema.Pattern); - if (schema.Enum != null) - { - _writer.WritePropertyName(JsonSchemaConstants.EnumPropertyName); - _writer.WriteStartArray(); - foreach (JToken token in schema.Enum) - { - token.WriteTo(_writer); - } - _writer.WriteEndArray(); - } - if (schema.Default != null) - { - _writer.WritePropertyName(JsonSchemaConstants.DefaultPropertyName); - schema.Default.WriteTo(_writer); - } - if (schema.Disallow != null) - { - WriteType(JsonSchemaConstants.DisallowPropertyName, _writer, schema.Disallow.GetValueOrDefault()); - } - if (schema.Extends != null && schema.Extends.Count > 0) - { - _writer.WritePropertyName(JsonSchemaConstants.ExtendsPropertyName); - if (schema.Extends.Count == 1) - { - ReferenceOrWriteSchema(schema.Extends[0]); - } - else - { - _writer.WriteStartArray(); - foreach (JsonSchema jsonSchema in schema.Extends) - { - ReferenceOrWriteSchema(jsonSchema); - } - _writer.WriteEndArray(); - } - } - _writer.WriteEndObject(); - } - - private void WriteSchemaDictionaryIfNotNull(JsonWriter writer, string propertyName, IDictionary properties) - { - if (properties != null) - { - writer.WritePropertyName(propertyName); - writer.WriteStartObject(); - foreach (KeyValuePair property in properties) - { - writer.WritePropertyName(property.Key); - ReferenceOrWriteSchema(property.Value); - } - writer.WriteEndObject(); - } - } - - private void WriteItems(JsonSchema schema) - { - if (schema.Items == null && !schema.PositionalItemsValidation) - { - return; - } - - _writer.WritePropertyName(JsonSchemaConstants.ItemsPropertyName); - - if (!schema.PositionalItemsValidation) - { - if (schema.Items != null && schema.Items.Count > 0) - { - ReferenceOrWriteSchema(schema.Items[0]); - } - else - { - _writer.WriteStartObject(); - _writer.WriteEndObject(); - } - return; - } - - _writer.WriteStartArray(); - if (schema.Items != null) - { - foreach (JsonSchema itemSchema in schema.Items) - { - ReferenceOrWriteSchema(itemSchema); - } - } - _writer.WriteEndArray(); - } - - private void WriteType(string propertyName, JsonWriter writer, JsonSchemaType type) - { - if (Enum.IsDefined(typeof(JsonSchemaType), type)) - { - writer.WritePropertyName(propertyName); - writer.WriteValue(JsonSchemaBuilder.MapType(type)); - } - else - { - IEnumerator en = EnumUtils.GetFlagsValues(type).Where(v => v != JsonSchemaType.None).GetEnumerator(); - if (en.MoveNext()) - { - writer.WritePropertyName(propertyName); - JsonSchemaType first = en.Current; - if (en.MoveNext()) - { - writer.WriteStartArray(); - writer.WriteValue(JsonSchemaBuilder.MapType(first)); - do - { - writer.WriteValue(JsonSchemaBuilder.MapType(en.Current)); - } while (en.MoveNext()); - writer.WriteEndArray(); - } - else - { - writer.WriteValue(JsonSchemaBuilder.MapType(first)); - } - } - } - } - - private void WritePropertyIfNotNull(JsonWriter writer, string propertyName, object value) - { - if (value != null) - { - writer.WritePropertyName(propertyName); - writer.WriteValue(value); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/UndefinedSchemaIdHandling.cs b/Source/MyDb/Newtonsoft.Json/Schema/UndefinedSchemaIdHandling.cs deleted file mode 100644 index 9064700..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/UndefinedSchemaIdHandling.cs +++ /dev/null @@ -1,58 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - /// - /// - /// Specifies undefined schema Id handling options for the . - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public enum UndefinedSchemaIdHandling - { - /// - /// Do not infer a schema Id. - /// - None = 0, - - /// - /// Use the .NET type name as the schema Id. - /// - UseTypeName = 1, - - /// - /// Use the assembly qualified .NET type name as the schema Id. - /// - UseAssemblyQualifiedName = 2, - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/ValidationEventArgs.cs b/Source/MyDb/Newtonsoft.Json/Schema/ValidationEventArgs.cs deleted file mode 100644 index 1800539..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/ValidationEventArgs.cs +++ /dev/null @@ -1,70 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Utilities; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - /// - /// - /// Returns detailed information related to the . - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public class ValidationEventArgs : EventArgs - { - private readonly JsonSchemaException _ex; - - internal ValidationEventArgs(JsonSchemaException ex) - { - ValidationUtils.ArgumentNotNull(ex, nameof(ex)); - _ex = ex; - } - - /// - /// Gets the associated with the validation error. - /// - /// The JsonSchemaException associated with the validation error. - public JsonSchemaException Exception => _ex; - - /// - /// Gets the path of the JSON location where the validation error occurred. - /// - /// The path of the JSON location where the validation error occurred. - public string Path => _ex.Path; - - /// - /// Gets the text description corresponding to the validation error. - /// - /// The text description. - public string Message => _ex.Message; - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Schema/ValidationEventHandler.cs b/Source/MyDb/Newtonsoft.Json/Schema/ValidationEventHandler.cs deleted file mode 100644 index cdeaed2..0000000 --- a/Source/MyDb/Newtonsoft.Json/Schema/ValidationEventHandler.cs +++ /dev/null @@ -1,42 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -#nullable disable - -namespace Newtonsoft.Json.Schema -{ - /// - /// - /// Represents the callback method that will handle JSON schema validation events and the . - /// - /// - /// JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details. - /// - /// - [Obsolete("JSON Schema validation has been moved to its own package. See https://www.newtonsoft.com/jsonschema for more details.")] - public delegate void ValidationEventHandler(object sender, ValidationEventArgs e); -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/CachedAttributeGetter.cs b/Source/MyDb/Newtonsoft.Json/Serialization/CachedAttributeGetter.cs deleted file mode 100644 index 4069759..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/CachedAttributeGetter.cs +++ /dev/null @@ -1,41 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Reflection; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - internal static class CachedAttributeGetter where T : Attribute - { - private static readonly ThreadSafeStore TypeAttributeCache = new ThreadSafeStore(JsonTypeReflector.GetAttribute); - - public static T? GetAttribute(object type) - { - return TypeAttributeCache.Get(type); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/CamelCaseNamingStrategy.cs b/Source/MyDb/Newtonsoft.Json/Serialization/CamelCaseNamingStrategy.cs deleted file mode 100644 index 0280c83..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/CamelCaseNamingStrategy.cs +++ /dev/null @@ -1,87 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// A camel case naming strategy. - /// - public class CamelCaseNamingStrategy : NamingStrategy - { - /// - /// Initializes a new instance of the class. - /// - /// - /// A flag indicating whether dictionary keys should be processed. - /// - /// - /// A flag indicating whether explicitly specified property names should be processed, - /// e.g. a property name customized with a . - /// - public CamelCaseNamingStrategy(bool processDictionaryKeys, bool overrideSpecifiedNames) - { - ProcessDictionaryKeys = processDictionaryKeys; - OverrideSpecifiedNames = overrideSpecifiedNames; - } - - /// - /// Initializes a new instance of the class. - /// - /// - /// A flag indicating whether dictionary keys should be processed. - /// - /// - /// A flag indicating whether explicitly specified property names should be processed, - /// e.g. a property name customized with a . - /// - /// - /// A flag indicating whether extension data names should be processed. - /// - public CamelCaseNamingStrategy(bool processDictionaryKeys, bool overrideSpecifiedNames, bool processExtensionDataNames) - : this(processDictionaryKeys, overrideSpecifiedNames) - { - ProcessExtensionDataNames = processExtensionDataNames; - } - - /// - /// Initializes a new instance of the class. - /// - public CamelCaseNamingStrategy() - { - } - - /// - /// Resolves the specified property name. - /// - /// The property name to resolve. - /// The resolved property name. - protected override string ResolvePropertyName(string name) - { - return StringUtils.ToCamelCase(name); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/CamelCasePropertyNamesContractResolver.cs b/Source/MyDb/Newtonsoft.Json/Serialization/CamelCasePropertyNamesContractResolver.cs deleted file mode 100644 index d3fdcf0..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/CamelCasePropertyNamesContractResolver.cs +++ /dev/null @@ -1,94 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Resolves member mappings for a type, camel casing property names. - /// - public class CamelCasePropertyNamesContractResolver : DefaultContractResolver - { - private static readonly object TypeContractCacheLock = new object(); - private static readonly DefaultJsonNameTable NameTable = new DefaultJsonNameTable(); - private static Dictionary, JsonContract>? _contractCache; - - /// - /// Initializes a new instance of the class. - /// - public CamelCasePropertyNamesContractResolver() - { - NamingStrategy = new CamelCaseNamingStrategy - { - ProcessDictionaryKeys = true, - OverrideSpecifiedNames = true - }; - } - - /// - /// Resolves the contract for a given type. - /// - /// The type to resolve a contract for. - /// The contract for a given type. - public override JsonContract ResolveContract(Type type) - { - if (type == null) - { - throw new ArgumentNullException(nameof(type)); - } - - // for backwards compadibility the CamelCasePropertyNamesContractResolver shares contracts between instances - StructMultiKey key = new StructMultiKey(GetType(), type); - Dictionary, JsonContract>? cache = _contractCache; - if (cache == null || !cache.TryGetValue(key, out JsonContract contract)) - { - contract = CreateContract(type); - - // avoid the possibility of modifying the cache dictionary while another thread is accessing it - lock (TypeContractCacheLock) - { - cache = _contractCache; - Dictionary, JsonContract> updatedCache = (cache != null) - ? new Dictionary, JsonContract>(cache) - : new Dictionary, JsonContract>(); - updatedCache[key] = contract; - - _contractCache = updatedCache; - } - } - - return contract; - } - - internal override DefaultJsonNameTable GetNameTable() - { - return NameTable; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/DefaultContractResolver.cs b/Source/MyDb/Newtonsoft.Json/Serialization/DefaultContractResolver.cs deleted file mode 100644 index 87a781b..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/DefaultContractResolver.cs +++ /dev/null @@ -1,1731 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -#if HAVE_CONCURRENT_DICTIONARY -using System.Collections.Concurrent; -#endif -using Newtonsoft.Json.Schema; -using System.Collections.Generic; -using System.ComponentModel; -#if HAVE_DYNAMIC -using System.Dynamic; -#endif -using System.Globalization; -using System.IO; -using System.Reflection; -using System.Runtime.Serialization; -#if HAVE_CAS -using System.Security.Permissions; -#endif -using Newtonsoft.Json.Converters; -using Newtonsoft.Json.Utilities; -using Newtonsoft.Json.Linq; -using System.Runtime.CompilerServices; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Used by to resolve a for a given . - /// - public class DefaultContractResolver : IContractResolver - { - private static readonly IContractResolver _instance = new DefaultContractResolver(); - - // Json.NET Schema requires a property - internal static IContractResolver Instance => _instance; - - private static readonly string[] BlacklistedTypeNames = - { - "System.IO.DriveInfo", - "System.IO.FileInfo", - "System.IO.DirectoryInfo" - }; - - private static readonly JsonConverter[] BuiltInConverters = - { -#if HAVE_ENTITY_FRAMEWORK - new EntityKeyMemberConverter(), -#endif -#if HAVE_DYNAMIC - new ExpandoObjectConverter(), -#endif -#if (HAVE_XML_DOCUMENT || HAVE_XLINQ) - new XmlNodeConverter(), -#endif -#if HAVE_ADO_NET - new BinaryConverter(), - new DataSetConverter(), - new DataTableConverter(), -#endif -#if HAVE_FSHARP_TYPES - new DiscriminatedUnionConverter(), -#endif - new KeyValuePairConverter(), -#pragma warning disable 618 - new BsonObjectIdConverter(), -#pragma warning restore 618 - new RegexConverter() - }; - - private readonly DefaultJsonNameTable _nameTable = new DefaultJsonNameTable(); - - private readonly ThreadSafeStore _contractCache; - - /// - /// Gets a value indicating whether members are being get and set using dynamic code generation. - /// This value is determined by the runtime permissions available. - /// - /// - /// true if using dynamic code generation; otherwise, false. - /// - public bool DynamicCodeGeneration => JsonTypeReflector.DynamicCodeGeneration; - -#if !PORTABLE - /// - /// Gets or sets the default members search flags. - /// - /// The default members search flags. - [Obsolete("DefaultMembersSearchFlags is obsolete. To modify the members serialized inherit from DefaultContractResolver and override the GetSerializableMembers method instead.")] - public BindingFlags DefaultMembersSearchFlags { get; set; } -#else - private readonly BindingFlags DefaultMembersSearchFlags; -#endif - - /// - /// Gets or sets a value indicating whether compiler generated members should be serialized. - /// - /// - /// true if serialized compiler generated members; otherwise, false. - /// - public bool SerializeCompilerGeneratedMembers { get; set; } - -#if HAVE_BINARY_SERIALIZATION - /// - /// Gets or sets a value indicating whether to ignore the interface when serializing and deserializing types. - /// - /// - /// true if the interface will be ignored when serializing and deserializing types; otherwise, false. - /// - public bool IgnoreSerializableInterface { get; set; } - - /// - /// Gets or sets a value indicating whether to ignore the attribute when serializing and deserializing types. - /// - /// - /// true if the attribute will be ignored when serializing and deserializing types; otherwise, false. - /// - public bool IgnoreSerializableAttribute { get; set; } -#endif - - /// - /// Gets or sets a value indicating whether to ignore IsSpecified members when serializing and deserializing types. - /// - /// - /// true if the IsSpecified members will be ignored when serializing and deserializing types; otherwise, false. - /// - public bool IgnoreIsSpecifiedMembers { get; set; } - - /// - /// Gets or sets a value indicating whether to ignore ShouldSerialize members when serializing and deserializing types. - /// - /// - /// true if the ShouldSerialize members will be ignored when serializing and deserializing types; otherwise, false. - /// - public bool IgnoreShouldSerializeMembers { get; set; } - - /// - /// Gets or sets the naming strategy used to resolve how property names and dictionary keys are serialized. - /// - /// The naming strategy used to resolve how property names and dictionary keys are serialized. - public NamingStrategy? NamingStrategy { get; set; } - - /// - /// Initializes a new instance of the class. - /// - public DefaultContractResolver() - { -#if HAVE_BINARY_SERIALIZATION - IgnoreSerializableAttribute = true; -#endif - -#pragma warning disable 618 - DefaultMembersSearchFlags = BindingFlags.Instance | BindingFlags.Public; -#pragma warning restore 618 - - _contractCache = new ThreadSafeStore(CreateContract); - } - - /// - /// Resolves the contract for a given type. - /// - /// The type to resolve a contract for. - /// The contract for a given type. - public virtual JsonContract ResolveContract(Type type) - { - ValidationUtils.ArgumentNotNull(type, nameof(type)); - - return _contractCache.Get(type); - } - - private static bool FilterMembers(MemberInfo member) - { - if (member is PropertyInfo property) - { - if (ReflectionUtils.IsIndexedProperty(property)) - { - return false; - } - - return !ReflectionUtils.IsByRefLikeType(property.PropertyType); - } - else if (member is FieldInfo field) - { - return !ReflectionUtils.IsByRefLikeType(field.FieldType); - } - - return true; - } - - /// - /// Gets the serializable members for the type. - /// - /// The type to get serializable members for. - /// The serializable members for the type. - protected virtual List GetSerializableMembers(Type objectType) - { - bool ignoreSerializableAttribute; -#if HAVE_BINARY_SERIALIZATION - ignoreSerializableAttribute = IgnoreSerializableAttribute; -#else - ignoreSerializableAttribute = true; -#endif - - MemberSerialization memberSerialization = JsonTypeReflector.GetObjectMemberSerialization(objectType, ignoreSerializableAttribute); - - // Exclude index properties - // Do not filter ByRef types here because accessing FieldType/PropertyType can trigger additonal assembly loads - IEnumerable allMembers = ReflectionUtils.GetFieldsAndProperties(objectType, BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static) - .Where(m => m is PropertyInfo p ? !ReflectionUtils.IsIndexedProperty(p) : true); - - List serializableMembers = new List(); - - if (memberSerialization != MemberSerialization.Fields) - { -#if HAVE_DATA_CONTRACTS - DataContractAttribute? dataContractAttribute = JsonTypeReflector.GetDataContractAttribute(objectType); -#endif - -#pragma warning disable 618 - // Exclude index properties and ByRef types - List defaultMembers = ReflectionUtils.GetFieldsAndProperties(objectType, DefaultMembersSearchFlags) - .Where(FilterMembers).ToList(); -#pragma warning restore 618 - - foreach (MemberInfo member in allMembers) - { - // exclude members that are compiler generated if set - if (SerializeCompilerGeneratedMembers || !member.IsDefined(typeof(CompilerGeneratedAttribute), true)) - { - if (defaultMembers.Contains(member)) - { - // add all members that are found by default member search - serializableMembers.Add(member); - } - else - { - // add members that are explicitly marked with JsonProperty/DataMember attribute - // or are a field if serializing just fields - if (JsonTypeReflector.GetAttribute(member) != null) - { - serializableMembers.Add(member); - } - else if (JsonTypeReflector.GetAttribute(member) != null) - { - serializableMembers.Add(member); - } -#if HAVE_DATA_CONTRACTS - else if (dataContractAttribute != null && JsonTypeReflector.GetAttribute(member) != null) - { - serializableMembers.Add(member); - } -#endif - else if (memberSerialization == MemberSerialization.Fields && member.MemberType() == MemberTypes.Field) - { - serializableMembers.Add(member); - } - } - } - } - -#if HAVE_DATA_CONTRACTS - // don't include EntityKey on entities objects... this is a bit hacky - if (objectType.AssignableToTypeName("System.Data.Objects.DataClasses.EntityObject", false, out _)) - { - serializableMembers = serializableMembers.Where(ShouldSerializeEntityMember).ToList(); - } -#endif - // don't include TargetSite on non-serializable exceptions - // MemberBase is problematic to serialize. Large, self referencing instances, etc - if (typeof(Exception).IsAssignableFrom(objectType)) - { - serializableMembers = serializableMembers.Where(m => !string.Equals(m.Name, "TargetSite", StringComparison.Ordinal)).ToList(); - } - } - else - { - // serialize all fields - foreach (MemberInfo member in allMembers) - { - if (member is FieldInfo field && !field.IsStatic) - { - serializableMembers.Add(member); - } - } - } - - return serializableMembers; - } - -#if HAVE_DATA_CONTRACTS - private bool ShouldSerializeEntityMember(MemberInfo memberInfo) - { - if (memberInfo is PropertyInfo propertyInfo) - { - if (propertyInfo.PropertyType.IsGenericType() && propertyInfo.PropertyType.GetGenericTypeDefinition().FullName == "System.Data.Objects.DataClasses.EntityReference`1") - { - return false; - } - } - - return true; - } -#endif - - /// - /// Creates a for the given type. - /// - /// Type of the object. - /// A for the given type. - protected virtual JsonObjectContract CreateObjectContract(Type objectType) - { - JsonObjectContract contract = new JsonObjectContract(objectType); - InitializeContract(contract); - - bool ignoreSerializableAttribute; -#if HAVE_BINARY_SERIALIZATION - ignoreSerializableAttribute = IgnoreSerializableAttribute; -#else - ignoreSerializableAttribute = true; -#endif - - contract.MemberSerialization = JsonTypeReflector.GetObjectMemberSerialization(contract.NonNullableUnderlyingType, ignoreSerializableAttribute); - contract.Properties.AddRange(CreateProperties(contract.NonNullableUnderlyingType, contract.MemberSerialization)); - - Func? extensionDataNameResolver = null; - - JsonObjectAttribute? attribute = JsonTypeReflector.GetCachedAttribute(contract.NonNullableUnderlyingType); - if (attribute != null) - { - contract.ItemRequired = attribute._itemRequired; - contract.ItemNullValueHandling = attribute._itemNullValueHandling; - contract.MissingMemberHandling = attribute._missingMemberHandling; - - if (attribute.NamingStrategyType != null) - { - NamingStrategy namingStrategy = JsonTypeReflector.GetContainerNamingStrategy(attribute)!; - extensionDataNameResolver = s => namingStrategy.GetDictionaryKey(s); - } - } - - if (extensionDataNameResolver == null) - { - extensionDataNameResolver = ResolveExtensionDataName; - } - - contract.ExtensionDataNameResolver = extensionDataNameResolver; - - if (contract.IsInstantiable) - { - ConstructorInfo? overrideConstructor = GetAttributeConstructor(contract.NonNullableUnderlyingType); - - // check if a JsonConstructorAttribute has been defined and use that - if (overrideConstructor != null) - { - contract.OverrideCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(overrideConstructor); - contract.CreatorParameters.AddRange(CreateConstructorParameters(overrideConstructor, contract.Properties)); - } - else if (contract.MemberSerialization == MemberSerialization.Fields) - { -#if HAVE_BINARY_FORMATTER - // mimic DataContractSerializer behaviour when populating fields by overriding default creator to create an uninitialized object - // note that this is only possible when the application is fully trusted so fall back to using the default constructor (if available) in partial trust - if (JsonTypeReflector.FullyTrusted) - { - contract.DefaultCreator = contract.GetUninitializedObject; - } -#endif - } - else if (contract.DefaultCreator == null || contract.DefaultCreatorNonPublic) - { - ConstructorInfo? constructor = GetParameterizedConstructor(contract.NonNullableUnderlyingType); - if (constructor != null) - { - contract.ParameterizedCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(constructor); - contract.CreatorParameters.AddRange(CreateConstructorParameters(constructor, contract.Properties)); - } - } - else if (contract.NonNullableUnderlyingType.IsValueType()) - { - // value types always have default constructor - // check whether there is a constructor that matches with non-writable properties on value type - ConstructorInfo? constructor = GetImmutableConstructor(contract.NonNullableUnderlyingType, contract.Properties); - if (constructor != null) - { - contract.OverrideCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(constructor); - contract.CreatorParameters.AddRange(CreateConstructorParameters(constructor, contract.Properties)); - } - } - } - - MemberInfo extensionDataMember = GetExtensionDataMemberForType(contract.NonNullableUnderlyingType); - if (extensionDataMember != null) - { - SetExtensionDataDelegates(contract, extensionDataMember); - } - - // serializing DirectoryInfo without ISerializable will stackoverflow - // https://github.com/JamesNK/Newtonsoft.Json/issues/1541 - if (Array.IndexOf(BlacklistedTypeNames, objectType.FullName) != -1) - { - contract.OnSerializingCallbacks.Add(ThrowUnableToSerializeError); - } - - return contract; - } - - private static void ThrowUnableToSerializeError(object o, StreamingContext context) - { - throw new JsonSerializationException("Unable to serialize instance of '{0}'.".FormatWith(CultureInfo.InvariantCulture, o.GetType())); - } - - private MemberInfo GetExtensionDataMemberForType(Type type) - { - IEnumerable members = GetClassHierarchyForType(type).SelectMany(baseType => - { - IList m = new List(); - m.AddRange(baseType.GetProperties(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.DeclaredOnly)); - m.AddRange(baseType.GetFields(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.DeclaredOnly)); - - return m; - }); - - MemberInfo extensionDataMember = members.LastOrDefault(m => - { - MemberTypes memberType = m.MemberType(); - if (memberType != MemberTypes.Property && memberType != MemberTypes.Field) - { - return false; - } - - // last instance of attribute wins on type if there are multiple - if (!m.IsDefined(typeof(JsonExtensionDataAttribute), false)) - { - return false; - } - - if (!ReflectionUtils.CanReadMemberValue(m, true)) - { - throw new JsonException("Invalid extension data attribute on '{0}'. Member '{1}' must have a getter.".FormatWith(CultureInfo.InvariantCulture, GetClrTypeFullName(m.DeclaringType), m.Name)); - } - - Type t = ReflectionUtils.GetMemberUnderlyingType(m); - - if (ReflectionUtils.ImplementsGenericDefinition(t, typeof(IDictionary<,>), out Type? dictionaryType)) - { - Type keyType = dictionaryType.GetGenericArguments()[0]; - Type valueType = dictionaryType.GetGenericArguments()[1]; - - if (keyType.IsAssignableFrom(typeof(string)) && valueType.IsAssignableFrom(typeof(JToken))) - { - return true; - } - } - - throw new JsonException("Invalid extension data attribute on '{0}'. Member '{1}' type must implement IDictionary.".FormatWith(CultureInfo.InvariantCulture, GetClrTypeFullName(m.DeclaringType), m.Name)); - }); - - return extensionDataMember; - } - - private static void SetExtensionDataDelegates(JsonObjectContract contract, MemberInfo member) - { - JsonExtensionDataAttribute? extensionDataAttribute = ReflectionUtils.GetAttribute(member); - if (extensionDataAttribute == null) - { - return; - } - - Type t = ReflectionUtils.GetMemberUnderlyingType(member); - - ReflectionUtils.ImplementsGenericDefinition(t, typeof(IDictionary<,>), out Type? dictionaryType); - - Type keyType = dictionaryType!.GetGenericArguments()[0]; - Type valueType = dictionaryType!.GetGenericArguments()[1]; - - Type createdType; - - // change type to a class if it is the base interface so it can be instantiated if needed - if (ReflectionUtils.IsGenericDefinition(t, typeof(IDictionary<,>))) - { - createdType = typeof(Dictionary<,>).MakeGenericType(keyType, valueType); - } - else - { - createdType = t; - } - - Func getExtensionDataDictionary = JsonTypeReflector.ReflectionDelegateFactory.CreateGet(member); - - if (extensionDataAttribute.ReadData) - { - Action? setExtensionDataDictionary = (ReflectionUtils.CanSetMemberValue(member, true, false)) - ? JsonTypeReflector.ReflectionDelegateFactory.CreateSet(member) - : null; - Func createExtensionDataDictionary = JsonTypeReflector.ReflectionDelegateFactory.CreateDefaultConstructor(createdType); - MethodInfo? setMethod = t.GetProperty("Item", BindingFlags.Public | BindingFlags.Instance, null, valueType, new[] { keyType }, null)?.GetSetMethod(); - if (setMethod == null) - { - // Item is explicitly implemented and non-public - // get from dictionary interface - setMethod = dictionaryType!.GetProperty("Item", BindingFlags.Public | BindingFlags.Instance, null, valueType, new[] { keyType }, null)?.GetSetMethod(); - } - - MethodCall setExtensionDataDictionaryValue = JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(setMethod!); - - ExtensionDataSetter extensionDataSetter = (o, key, value) => - { - object? dictionary = getExtensionDataDictionary(o); - if (dictionary == null) - { - if (setExtensionDataDictionary == null) - { - throw new JsonSerializationException("Cannot set value onto extension data member '{0}'. The extension data collection is null and it cannot be set.".FormatWith(CultureInfo.InvariantCulture, member.Name)); - } - - dictionary = createExtensionDataDictionary(); - setExtensionDataDictionary(o, dictionary); - } - - setExtensionDataDictionaryValue(dictionary, key, value); - }; - - contract.ExtensionDataSetter = extensionDataSetter; - } - - if (extensionDataAttribute.WriteData) - { - Type enumerableWrapper = typeof(EnumerableDictionaryWrapper<,>).MakeGenericType(keyType, valueType); - ConstructorInfo constructors = enumerableWrapper.GetConstructors().First(); - ObjectConstructor createEnumerableWrapper = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(constructors); - - ExtensionDataGetter extensionDataGetter = o => - { - object? dictionary = getExtensionDataDictionary(o); - if (dictionary == null) - { - return null; - } - - return (IEnumerable>)createEnumerableWrapper(dictionary); - }; - - contract.ExtensionDataGetter = extensionDataGetter; - } - - contract.ExtensionDataValueType = valueType; - } - - // leave as class instead of struct - // will be always return as an interface and boxed - internal class EnumerableDictionaryWrapper : IEnumerable> - { - private readonly IEnumerable> _e; - - public EnumerableDictionaryWrapper(IEnumerable> e) - { - ValidationUtils.ArgumentNotNull(e, nameof(e)); - _e = e; - } - - public IEnumerator> GetEnumerator() - { - foreach (KeyValuePair item in _e) - { - yield return new KeyValuePair(item.Key!, item.Value!); - } - } - - IEnumerator IEnumerable.GetEnumerator() - { - return GetEnumerator(); - } - } - - private ConstructorInfo? GetAttributeConstructor(Type objectType) - { - IEnumerator en = objectType.GetConstructors(BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic).Where(c => c.IsDefined(typeof(JsonConstructorAttribute), true)).GetEnumerator(); - - if (en.MoveNext()) - { - ConstructorInfo conInfo = en.Current; - if (en.MoveNext()) - { - throw new JsonException("Multiple constructors with the JsonConstructorAttribute."); - } - - return conInfo; - } - - // little hack to get Version objects to deserialize correctly - if (objectType == typeof(Version)) - { - return objectType.GetConstructor(new[] { typeof(int), typeof(int), typeof(int), typeof(int) }); - } - - return null; - } - - private ConstructorInfo? GetImmutableConstructor(Type objectType, JsonPropertyCollection memberProperties) - { - IEnumerable constructors = objectType.GetConstructors(); - IEnumerator en = constructors.GetEnumerator(); - if (en.MoveNext()) - { - ConstructorInfo constructor = en.Current; - if (!en.MoveNext()) - { - ParameterInfo[] parameters = constructor.GetParameters(); - if (parameters.Length > 0) - { - foreach (ParameterInfo parameterInfo in parameters) - { - JsonProperty? memberProperty = MatchProperty(memberProperties, parameterInfo.Name, parameterInfo.ParameterType); - if (memberProperty == null || memberProperty.Writable) - { - return null; - } - } - - return constructor; - } - } - } - - return null; - } - - private ConstructorInfo? GetParameterizedConstructor(Type objectType) - { -#if PORTABLE - IEnumerable constructors = objectType.GetConstructors(BindingFlags.Public | BindingFlags.Instance); - IEnumerator en = constructors.GetEnumerator(); - if (en.MoveNext()) - { - ConstructorInfo conInfo = en.Current; - if (!en.MoveNext()) - { - return conInfo; - } - } -#else - ConstructorInfo[] constructors = objectType.GetConstructors(BindingFlags.Public | BindingFlags.Instance); - if (constructors.Length == 1) - { - return constructors[0]; - } -#endif - return null; - } - - /// - /// Creates the constructor parameters. - /// - /// The constructor to create properties for. - /// The type's member properties. - /// Properties for the given . - protected virtual IList CreateConstructorParameters(ConstructorInfo constructor, JsonPropertyCollection memberProperties) - { - ParameterInfo[] constructorParameters = constructor.GetParameters(); - - JsonPropertyCollection parameterCollection = new JsonPropertyCollection(constructor.DeclaringType); - - foreach (ParameterInfo parameterInfo in constructorParameters) - { - if (parameterInfo.Name == null) - { - continue; - } - - JsonProperty? matchingMemberProperty = MatchProperty(memberProperties, parameterInfo.Name, parameterInfo.ParameterType); - - // ensure that property will have a name from matching property or from parameterinfo - // parameterinfo could have no name if generated by a proxy (I'm looking at you Castle) - if (matchingMemberProperty != null || parameterInfo.Name != null) - { - JsonProperty property = CreatePropertyFromConstructorParameter(matchingMemberProperty, parameterInfo); - - if (property != null) - { - parameterCollection.AddProperty(property); - } - } - } - - return parameterCollection; - } - - private JsonProperty? MatchProperty(JsonPropertyCollection properties, string name, Type type) - { - // it is possible to generate a member with a null name using Reflection.Emit - // protect against an ArgumentNullException from GetClosestMatchProperty by testing for null here - if (name == null) - { - return null; - } - - JsonProperty? property = properties.GetClosestMatchProperty(name); - // must match type as well as name - if (property == null || property.PropertyType != type) - { - return null; - } - - return property; - } - - /// - /// Creates a for the given . - /// - /// The matching member property. - /// The constructor parameter. - /// A created for the given . - protected virtual JsonProperty CreatePropertyFromConstructorParameter(JsonProperty? matchingMemberProperty, ParameterInfo parameterInfo) - { - JsonProperty property = new JsonProperty(); - property.PropertyType = parameterInfo.ParameterType; - property.AttributeProvider = new ReflectionAttributeProvider(parameterInfo); - - SetPropertySettingsFromAttributes(property, parameterInfo, parameterInfo.Name, parameterInfo.Member.DeclaringType, MemberSerialization.OptOut, out _); - - property.Readable = false; - property.Writable = true; - - // "inherit" values from matching member property if unset on parameter - if (matchingMemberProperty != null) - { - property.PropertyName = (property.PropertyName != parameterInfo.Name) ? property.PropertyName : matchingMemberProperty.PropertyName; - property.Converter = property.Converter ?? matchingMemberProperty.Converter; - - if (!property._hasExplicitDefaultValue && matchingMemberProperty._hasExplicitDefaultValue) - { - property.DefaultValue = matchingMemberProperty.DefaultValue; - } - - property._required = property._required ?? matchingMemberProperty._required; - property.IsReference = property.IsReference ?? matchingMemberProperty.IsReference; - property.NullValueHandling = property.NullValueHandling ?? matchingMemberProperty.NullValueHandling; - property.DefaultValueHandling = property.DefaultValueHandling ?? matchingMemberProperty.DefaultValueHandling; - property.ReferenceLoopHandling = property.ReferenceLoopHandling ?? matchingMemberProperty.ReferenceLoopHandling; - property.ObjectCreationHandling = property.ObjectCreationHandling ?? matchingMemberProperty.ObjectCreationHandling; - property.TypeNameHandling = property.TypeNameHandling ?? matchingMemberProperty.TypeNameHandling; - } - - return property; - } - - /// - /// Resolves the default for the contract. - /// - /// Type of the object. - /// The contract's default . - protected virtual JsonConverter? ResolveContractConverter(Type objectType) - { - return JsonTypeReflector.GetJsonConverter(objectType); - } - - private Func GetDefaultCreator(Type createdType) - { - return JsonTypeReflector.ReflectionDelegateFactory.CreateDefaultConstructor(createdType); - } - -#if NET35 - [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Portability", "CA1903:UseOnlyApiFromTargetedFramework", MessageId = "System.Runtime.Serialization.DataContractAttribute.#get_IsReference()")] -#endif - private void InitializeContract(JsonContract contract) - { - JsonContainerAttribute? containerAttribute = JsonTypeReflector.GetCachedAttribute(contract.NonNullableUnderlyingType); - if (containerAttribute != null) - { - contract.IsReference = containerAttribute._isReference; - } -#if HAVE_DATA_CONTRACTS - else - { - DataContractAttribute? dataContractAttribute = JsonTypeReflector.GetDataContractAttribute(contract.NonNullableUnderlyingType); - // doesn't have a null value - if (dataContractAttribute != null && dataContractAttribute.IsReference) - { - contract.IsReference = true; - } - } -#endif - - contract.Converter = ResolveContractConverter(contract.NonNullableUnderlyingType); - - // then see whether object is compatible with any of the built in converters - contract.InternalConverter = JsonSerializer.GetMatchingConverter(BuiltInConverters, contract.NonNullableUnderlyingType); - - if (contract.IsInstantiable - && (ReflectionUtils.HasDefaultConstructor(contract.CreatedType, true) || contract.CreatedType.IsValueType())) - { - contract.DefaultCreator = GetDefaultCreator(contract.CreatedType); - - contract.DefaultCreatorNonPublic = (!contract.CreatedType.IsValueType() && - ReflectionUtils.GetDefaultConstructor(contract.CreatedType) == null); - } - - ResolveCallbackMethods(contract, contract.NonNullableUnderlyingType); - } - - private void ResolveCallbackMethods(JsonContract contract, Type t) - { - GetCallbackMethodsForType( - t, - out List? onSerializing, - out List? onSerialized, - out List? onDeserializing, - out List? onDeserialized, - out List? onError); - - if (onSerializing != null) - { - contract.OnSerializingCallbacks.AddRange(onSerializing); - } - - if (onSerialized != null) - { - contract.OnSerializedCallbacks.AddRange(onSerialized); - } - - if (onDeserializing != null) - { - contract.OnDeserializingCallbacks.AddRange(onDeserializing); - } - - if (onDeserialized != null) - { - contract.OnDeserializedCallbacks.AddRange(onDeserialized); - } - - if (onError != null) - { - contract.OnErrorCallbacks.AddRange(onError); - } - } - - private void GetCallbackMethodsForType(Type type, out List? onSerializing, out List? onSerialized, out List? onDeserializing, out List? onDeserialized, out List? onError) - { - onSerializing = null; - onSerialized = null; - onDeserializing = null; - onDeserialized = null; - onError = null; - - foreach (Type baseType in GetClassHierarchyForType(type)) - { - // while we allow more than one OnSerialized total, only one can be defined per class - MethodInfo? currentOnSerializing = null; - MethodInfo? currentOnSerialized = null; - MethodInfo? currentOnDeserializing = null; - MethodInfo? currentOnDeserialized = null; - MethodInfo? currentOnError = null; - - bool skipSerializing = ShouldSkipSerializing(baseType); - bool skipDeserialized = ShouldSkipDeserialized(baseType); - - foreach (MethodInfo method in baseType.GetMethods(BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Instance | BindingFlags.DeclaredOnly)) - { - // compact framework errors when getting parameters for a generic method - // lame, but generic methods should not be callbacks anyway - if (method.ContainsGenericParameters) - { - continue; - } - - Type? prevAttributeType = null; - ParameterInfo[] parameters = method.GetParameters(); - - if (!skipSerializing && IsValidCallback(method, parameters, typeof(OnSerializingAttribute), currentOnSerializing, ref prevAttributeType)) - { - onSerializing = onSerializing ?? new List(); - onSerializing.Add(JsonContract.CreateSerializationCallback(method)); - currentOnSerializing = method; - } - if (IsValidCallback(method, parameters, typeof(OnSerializedAttribute), currentOnSerialized, ref prevAttributeType)) - { - onSerialized = onSerialized ?? new List(); - onSerialized.Add(JsonContract.CreateSerializationCallback(method)); - currentOnSerialized = method; - } - if (IsValidCallback(method, parameters, typeof(OnDeserializingAttribute), currentOnDeserializing, ref prevAttributeType)) - { - onDeserializing = onDeserializing ?? new List(); - onDeserializing.Add(JsonContract.CreateSerializationCallback(method)); - currentOnDeserializing = method; - } - if (!skipDeserialized && IsValidCallback(method, parameters, typeof(OnDeserializedAttribute), currentOnDeserialized, ref prevAttributeType)) - { - onDeserialized = onDeserialized ?? new List(); - onDeserialized.Add(JsonContract.CreateSerializationCallback(method)); - currentOnDeserialized = method; - } - if (IsValidCallback(method, parameters, typeof(OnErrorAttribute), currentOnError, ref prevAttributeType)) - { - onError = onError ?? new List(); - onError.Add(JsonContract.CreateSerializationErrorCallback(method)); - currentOnError = method; - } - } - } - } - - private static bool IsConcurrentOrObservableCollection(Type t) - { - if (t.IsGenericType()) - { - Type definition = t.GetGenericTypeDefinition(); - - switch (definition.FullName) - { - case "System.Collections.Concurrent.ConcurrentQueue`1": - case "System.Collections.Concurrent.ConcurrentStack`1": - case "System.Collections.Concurrent.ConcurrentBag`1": - case JsonTypeReflector.ConcurrentDictionaryTypeName: - case "System.Collections.ObjectModel.ObservableCollection`1": - return true; - } - } - - return false; - } - - private static bool ShouldSkipDeserialized(Type t) - { - // ConcurrentDictionary throws an error in its OnDeserialized so ignore - http://json.codeplex.com/discussions/257093 - if (IsConcurrentOrObservableCollection(t)) - { - return true; - } - -#if HAVE_FSHARP_TYPES - if (t.Name == FSharpUtils.FSharpSetTypeName || t.Name == FSharpUtils.FSharpMapTypeName) - { - return true; - } -#endif - - return false; - } - - private static bool ShouldSkipSerializing(Type t) - { - if (IsConcurrentOrObservableCollection(t)) - { - return true; - } - -#if HAVE_FSHARP_TYPES - if (t.Name == FSharpUtils.FSharpSetTypeName || t.Name == FSharpUtils.FSharpMapTypeName) - { - return true; - } -#endif - - return false; - } - - private List GetClassHierarchyForType(Type type) - { - List ret = new List(); - - Type current = type; - while (current != null && current != typeof(object)) - { - ret.Add(current); - current = current.BaseType(); - } - - // Return the class list in order of simple => complex - ret.Reverse(); - return ret; - } - - /// - /// Creates a for the given type. - /// - /// Type of the object. - /// A for the given type. - protected virtual JsonDictionaryContract CreateDictionaryContract(Type objectType) - { - JsonDictionaryContract contract = new JsonDictionaryContract(objectType); - InitializeContract(contract); - - JsonContainerAttribute? containerAttribute = JsonTypeReflector.GetAttribute(objectType); - if (containerAttribute?.NamingStrategyType != null) - { - NamingStrategy namingStrategy = JsonTypeReflector.GetContainerNamingStrategy(containerAttribute)!; - contract.DictionaryKeyResolver = s => namingStrategy.GetDictionaryKey(s); - } - else - { - contract.DictionaryKeyResolver = ResolveDictionaryKey; - } - - ConstructorInfo? overrideConstructor = GetAttributeConstructor(contract.NonNullableUnderlyingType); - - if (overrideConstructor != null) - { - ParameterInfo[] parameters = overrideConstructor.GetParameters(); - Type expectedParameterType = (contract.DictionaryKeyType != null && contract.DictionaryValueType != null) - ? typeof(IEnumerable<>).MakeGenericType(typeof(KeyValuePair<,>).MakeGenericType(contract.DictionaryKeyType, contract.DictionaryValueType)) - : typeof(IDictionary); - - if (parameters.Length == 0) - { - contract.HasParameterizedCreator = false; - } - else if (parameters.Length == 1 && expectedParameterType.IsAssignableFrom(parameters[0].ParameterType)) - { - contract.HasParameterizedCreator = true; - } - else - { - throw new JsonException("Constructor for '{0}' must have no parameters or a single parameter that implements '{1}'.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType, expectedParameterType)); - } - - contract.OverrideCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(overrideConstructor); - } - - return contract; - } - - /// - /// Creates a for the given type. - /// - /// Type of the object. - /// A for the given type. - protected virtual JsonArrayContract CreateArrayContract(Type objectType) - { - JsonArrayContract contract = new JsonArrayContract(objectType); - InitializeContract(contract); - - ConstructorInfo? overrideConstructor = GetAttributeConstructor(contract.NonNullableUnderlyingType); - - if (overrideConstructor != null) - { - ParameterInfo[] parameters = overrideConstructor.GetParameters(); - Type expectedParameterType = (contract.CollectionItemType != null) - ? typeof(IEnumerable<>).MakeGenericType(contract.CollectionItemType) - : typeof(IEnumerable); - - if (parameters.Length == 0) - { - contract.HasParameterizedCreator = false; - } - else if (parameters.Length == 1 && expectedParameterType.IsAssignableFrom(parameters[0].ParameterType)) - { - contract.HasParameterizedCreator = true; - } - else - { - throw new JsonException("Constructor for '{0}' must have no parameters or a single parameter that implements '{1}'.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType, expectedParameterType)); - } - - contract.OverrideCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(overrideConstructor); - } - - return contract; - } - - /// - /// Creates a for the given type. - /// - /// Type of the object. - /// A for the given type. - protected virtual JsonPrimitiveContract CreatePrimitiveContract(Type objectType) - { - JsonPrimitiveContract contract = new JsonPrimitiveContract(objectType); - InitializeContract(contract); - - return contract; - } - - /// - /// Creates a for the given type. - /// - /// Type of the object. - /// A for the given type. - protected virtual JsonLinqContract CreateLinqContract(Type objectType) - { - JsonLinqContract contract = new JsonLinqContract(objectType); - InitializeContract(contract); - - return contract; - } - -#if HAVE_BINARY_SERIALIZATION - /// - /// Creates a for the given type. - /// - /// Type of the object. - /// A for the given type. - protected virtual JsonISerializableContract CreateISerializableContract(Type objectType) - { - JsonISerializableContract contract = new JsonISerializableContract(objectType); - InitializeContract(contract); - - if (contract.IsInstantiable) - { - ConstructorInfo constructorInfo = contract.NonNullableUnderlyingType.GetConstructor(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance, null, new[] {typeof(SerializationInfo), typeof(StreamingContext)}, null); - if (constructorInfo != null) - { - ObjectConstructor creator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(constructorInfo); - - contract.ISerializableCreator = creator; - } - } - - return contract; - } -#endif - -#if HAVE_DYNAMIC - /// - /// Creates a for the given type. - /// - /// Type of the object. - /// A for the given type. - protected virtual JsonDynamicContract CreateDynamicContract(Type objectType) - { - JsonDynamicContract contract = new JsonDynamicContract(objectType); - InitializeContract(contract); - - JsonContainerAttribute? containerAttribute = JsonTypeReflector.GetAttribute(objectType); - if (containerAttribute?.NamingStrategyType != null) - { - NamingStrategy namingStrategy = JsonTypeReflector.GetContainerNamingStrategy(containerAttribute)!; - contract.PropertyNameResolver = s => namingStrategy.GetDictionaryKey(s); - } - else - { - contract.PropertyNameResolver = ResolveDictionaryKey; - } - - contract.Properties.AddRange(CreateProperties(objectType, MemberSerialization.OptOut)); - - return contract; - } -#endif - - /// - /// Creates a for the given type. - /// - /// Type of the object. - /// A for the given type. - protected virtual JsonStringContract CreateStringContract(Type objectType) - { - JsonStringContract contract = new JsonStringContract(objectType); - InitializeContract(contract); - - return contract; - } - - /// - /// Determines which contract type is created for the given type. - /// - /// Type of the object. - /// A for the given type. - protected virtual JsonContract CreateContract(Type objectType) - { - Type t = ReflectionUtils.EnsureNotByRefType(objectType); - - if (IsJsonPrimitiveType(t)) - { - return CreatePrimitiveContract(objectType); - } - - t = ReflectionUtils.EnsureNotNullableType(t); - JsonContainerAttribute? containerAttribute = JsonTypeReflector.GetCachedAttribute(t); - - if (containerAttribute is JsonObjectAttribute) - { - return CreateObjectContract(objectType); - } - - if (containerAttribute is JsonArrayAttribute) - { - return CreateArrayContract(objectType); - } - - if (containerAttribute is JsonDictionaryAttribute) - { - return CreateDictionaryContract(objectType); - } - - if (t == typeof(JToken) || t.IsSubclassOf(typeof(JToken))) - { - return CreateLinqContract(objectType); - } - - if (CollectionUtils.IsDictionaryType(t)) - { - return CreateDictionaryContract(objectType); - } - - if (typeof(IEnumerable).IsAssignableFrom(t)) - { - return CreateArrayContract(objectType); - } - - if (CanConvertToString(t)) - { - return CreateStringContract(objectType); - } - -#if HAVE_BINARY_SERIALIZATION - if (!IgnoreSerializableInterface && typeof(ISerializable).IsAssignableFrom(t) && JsonTypeReflector.IsSerializable(t)) - { - return CreateISerializableContract(objectType); - } -#endif - -#if HAVE_DYNAMIC - if (typeof(IDynamicMetaObjectProvider).IsAssignableFrom(t)) - { - return CreateDynamicContract(objectType); - } -#endif - -#if HAVE_ICONVERTIBLE - // tested last because it is not possible to automatically deserialize custom IConvertible types - if (IsIConvertible(t)) - { - return CreatePrimitiveContract(t); - } -#endif - - return CreateObjectContract(objectType); - } - - internal static bool IsJsonPrimitiveType(Type t) - { - PrimitiveTypeCode typeCode = ConvertUtils.GetTypeCode(t); - - return (typeCode != PrimitiveTypeCode.Empty && typeCode != PrimitiveTypeCode.Object); - } - -#if HAVE_ICONVERTIBLE - internal static bool IsIConvertible(Type t) - { - if (typeof(IConvertible).IsAssignableFrom(t) - || (ReflectionUtils.IsNullableType(t) && typeof(IConvertible).IsAssignableFrom(Nullable.GetUnderlyingType(t)))) - { - return !typeof(JToken).IsAssignableFrom(t); - } - - return false; - } -#endif - - internal static bool CanConvertToString(Type type) - { -#if HAVE_TYPE_DESCRIPTOR - if (JsonTypeReflector.CanTypeDescriptorConvertString(type, out _)) - { - return true; - } -#endif - - if (type == typeof(Type) || type.IsSubclassOf(typeof(Type))) - { - return true; - } - - return false; - } - - private static bool IsValidCallback(MethodInfo method, ParameterInfo[] parameters, Type attributeType, MethodInfo? currentCallback, ref Type? prevAttributeType) - { - if (!method.IsDefined(attributeType, false)) - { - return false; - } - - if (currentCallback != null) - { - throw new JsonException("Invalid attribute. Both '{0}' and '{1}' in type '{2}' have '{3}'.".FormatWith(CultureInfo.InvariantCulture, method, currentCallback, GetClrTypeFullName(method.DeclaringType), attributeType)); - } - - if (prevAttributeType != null) - { - throw new JsonException("Invalid Callback. Method '{3}' in type '{2}' has both '{0}' and '{1}'.".FormatWith(CultureInfo.InvariantCulture, prevAttributeType, attributeType, GetClrTypeFullName(method.DeclaringType), method)); - } - - if (method.IsVirtual) - { - throw new JsonException("Virtual Method '{0}' of type '{1}' cannot be marked with '{2}' attribute.".FormatWith(CultureInfo.InvariantCulture, method, GetClrTypeFullName(method.DeclaringType), attributeType)); - } - - if (method.ReturnType != typeof(void)) - { - throw new JsonException("Serialization Callback '{1}' in type '{0}' must return void.".FormatWith(CultureInfo.InvariantCulture, GetClrTypeFullName(method.DeclaringType), method)); - } - - if (attributeType == typeof(OnErrorAttribute)) - { - if (parameters == null || parameters.Length != 2 || parameters[0].ParameterType != typeof(StreamingContext) || parameters[1].ParameterType != typeof(ErrorContext)) - { - throw new JsonException("Serialization Error Callback '{1}' in type '{0}' must have two parameters of type '{2}' and '{3}'.".FormatWith(CultureInfo.InvariantCulture, GetClrTypeFullName(method.DeclaringType), method, typeof(StreamingContext), typeof(ErrorContext))); - } - } - else - { - if (parameters == null || parameters.Length != 1 || parameters[0].ParameterType != typeof(StreamingContext)) - { - throw new JsonException("Serialization Callback '{1}' in type '{0}' must have a single parameter of type '{2}'.".FormatWith(CultureInfo.InvariantCulture, GetClrTypeFullName(method.DeclaringType), method, typeof(StreamingContext))); - } - } - - prevAttributeType = attributeType; - - return true; - } - - internal static string GetClrTypeFullName(Type type) - { - if (type.IsGenericTypeDefinition() || !type.ContainsGenericParameters()) - { - return type.FullName; - } - - return "{0}.{1}".FormatWith(CultureInfo.InvariantCulture, type.Namespace, type.Name); - } - - /// - /// Creates properties for the given . - /// - /// The type to create properties for. - /// /// The member serialization mode for the type. - /// Properties for the given . - protected virtual IList CreateProperties(Type type, MemberSerialization memberSerialization) - { - List members = GetSerializableMembers(type); - if (members == null) - { - throw new JsonSerializationException("Null collection of serializable members returned."); - } - - DefaultJsonNameTable nameTable = GetNameTable(); - - JsonPropertyCollection properties = new JsonPropertyCollection(type); - - foreach (MemberInfo member in members) - { - JsonProperty property = CreateProperty(member, memberSerialization); - - if (property != null) - { - // nametable is not thread-safe for multiple writers - lock (nameTable) - { - property.PropertyName = nameTable.Add(property.PropertyName!); - } - - properties.AddProperty(property); - } - } - - IList orderedProperties = properties.OrderBy(p => p.Order ?? -1).ToList(); - return orderedProperties; - } - - internal virtual DefaultJsonNameTable GetNameTable() - { - return _nameTable; - } - - /// - /// Creates the used by the serializer to get and set values from a member. - /// - /// The member. - /// The used by the serializer to get and set values from a member. - protected virtual IValueProvider CreateMemberValueProvider(MemberInfo member) - { - // warning - this method use to cause errors with Intellitrace. Retest in VS Ultimate after changes - IValueProvider valueProvider; - -#if !(PORTABLE40 || PORTABLE || DOTNET || NETSTANDARD2_0) - if (DynamicCodeGeneration) - { - valueProvider = new DynamicValueProvider(member); - } - else - { - valueProvider = new ReflectionValueProvider(member); - } -#elif !(PORTABLE40) - valueProvider = new ExpressionValueProvider(member); -#else - valueProvider = new ReflectionValueProvider(member); -#endif - - return valueProvider; - } - - /// - /// Creates a for the given . - /// - /// The member's parent . - /// The member to create a for. - /// A created for the given . - protected virtual JsonProperty CreateProperty(MemberInfo member, MemberSerialization memberSerialization) - { - JsonProperty property = new JsonProperty(); - property.PropertyType = ReflectionUtils.GetMemberUnderlyingType(member); - property.DeclaringType = member.DeclaringType; - property.ValueProvider = CreateMemberValueProvider(member); - property.AttributeProvider = new ReflectionAttributeProvider(member); - - SetPropertySettingsFromAttributes(property, member, member.Name, member.DeclaringType, memberSerialization, out bool allowNonPublicAccess); - - if (memberSerialization != MemberSerialization.Fields) - { - property.Readable = ReflectionUtils.CanReadMemberValue(member, allowNonPublicAccess); - property.Writable = ReflectionUtils.CanSetMemberValue(member, allowNonPublicAccess, property.HasMemberAttribute); - } - else - { - // write to readonly fields - property.Readable = true; - property.Writable = true; - } - - if (!IgnoreShouldSerializeMembers) - { - property.ShouldSerialize = CreateShouldSerializeTest(member); - } - - if (!IgnoreIsSpecifiedMembers) - { - SetIsSpecifiedActions(property, member, allowNonPublicAccess); - } - - return property; - } - - private void SetPropertySettingsFromAttributes(JsonProperty property, object attributeProvider, string name, Type declaringType, MemberSerialization memberSerialization, out bool allowNonPublicAccess) - { -#if HAVE_DATA_CONTRACTS - DataContractAttribute? dataContractAttribute = JsonTypeReflector.GetDataContractAttribute(declaringType); - - MemberInfo? memberInfo = attributeProvider as MemberInfo; - - DataMemberAttribute? dataMemberAttribute; - if (dataContractAttribute != null && memberInfo != null) - { - dataMemberAttribute = JsonTypeReflector.GetDataMemberAttribute((MemberInfo)memberInfo); - } - else - { - dataMemberAttribute = null; - } -#endif - - JsonPropertyAttribute? propertyAttribute = JsonTypeReflector.GetAttribute(attributeProvider); - JsonRequiredAttribute? requiredAttribute = JsonTypeReflector.GetAttribute(attributeProvider); - - string mappedName; - bool hasSpecifiedName; - if (propertyAttribute?.PropertyName != null) - { - mappedName = propertyAttribute.PropertyName; - hasSpecifiedName = true; - } -#if HAVE_DATA_CONTRACTS - else if (dataMemberAttribute?.Name != null) - { - mappedName = dataMemberAttribute.Name; - hasSpecifiedName = true; - } -#endif - else - { - mappedName = name; - hasSpecifiedName = false; - } - - JsonContainerAttribute? containerAttribute = JsonTypeReflector.GetAttribute(declaringType); - - NamingStrategy? namingStrategy; - if (propertyAttribute?.NamingStrategyType != null) - { - namingStrategy = JsonTypeReflector.CreateNamingStrategyInstance(propertyAttribute.NamingStrategyType, propertyAttribute.NamingStrategyParameters); - } - else if (containerAttribute?.NamingStrategyType != null) - { - namingStrategy = JsonTypeReflector.GetContainerNamingStrategy(containerAttribute); - } - else - { - namingStrategy = NamingStrategy; - } - - if (namingStrategy != null) - { - property.PropertyName = namingStrategy.GetPropertyName(mappedName, hasSpecifiedName); - } - else - { - property.PropertyName = ResolvePropertyName(mappedName); - } - - property.UnderlyingName = name; - - bool hasMemberAttribute = false; - if (propertyAttribute != null) - { - property._required = propertyAttribute._required; - property.Order = propertyAttribute._order; - property.DefaultValueHandling = propertyAttribute._defaultValueHandling; - hasMemberAttribute = true; - property.NullValueHandling = propertyAttribute._nullValueHandling; - property.ReferenceLoopHandling = propertyAttribute._referenceLoopHandling; - property.ObjectCreationHandling = propertyAttribute._objectCreationHandling; - property.TypeNameHandling = propertyAttribute._typeNameHandling; - property.IsReference = propertyAttribute._isReference; - - property.ItemIsReference = propertyAttribute._itemIsReference; - property.ItemConverter = propertyAttribute.ItemConverterType != null ? JsonTypeReflector.CreateJsonConverterInstance(propertyAttribute.ItemConverterType, propertyAttribute.ItemConverterParameters) : null; - property.ItemReferenceLoopHandling = propertyAttribute._itemReferenceLoopHandling; - property.ItemTypeNameHandling = propertyAttribute._itemTypeNameHandling; - } - else - { - property.NullValueHandling = null; - property.ReferenceLoopHandling = null; - property.ObjectCreationHandling = null; - property.TypeNameHandling = null; - property.IsReference = null; - property.ItemIsReference = null; - property.ItemConverter = null; - property.ItemReferenceLoopHandling = null; - property.ItemTypeNameHandling = null; -#if HAVE_DATA_CONTRACTS - if (dataMemberAttribute != null) - { - property._required = (dataMemberAttribute.IsRequired) ? Required.AllowNull : Required.Default; - property.Order = (dataMemberAttribute.Order != -1) ? (int?)dataMemberAttribute.Order : null; - property.DefaultValueHandling = (!dataMemberAttribute.EmitDefaultValue) ? (DefaultValueHandling?)DefaultValueHandling.Ignore : null; - hasMemberAttribute = true; - } -#endif - } - - if (requiredAttribute != null) - { - property._required = Required.Always; - hasMemberAttribute = true; - } - - property.HasMemberAttribute = hasMemberAttribute; - - bool hasJsonIgnoreAttribute = - JsonTypeReflector.GetAttribute(attributeProvider) != null - // automatically ignore extension data dictionary property if it is public - || JsonTypeReflector.GetAttribute(attributeProvider) != null -#if HAVE_NON_SERIALIZED_ATTRIBUTE - || JsonTypeReflector.IsNonSerializable(attributeProvider) -#endif - ; - - if (memberSerialization != MemberSerialization.OptIn) - { - bool hasIgnoreDataMemberAttribute = false; - -#if HAVE_IGNORE_DATA_MEMBER_ATTRIBUTE - hasIgnoreDataMemberAttribute = (JsonTypeReflector.GetAttribute(attributeProvider) != null); -#endif - - // ignored if it has JsonIgnore or NonSerialized or IgnoreDataMember attributes - property.Ignored = (hasJsonIgnoreAttribute || hasIgnoreDataMemberAttribute); - } - else - { - // ignored if it has JsonIgnore/NonSerialized or does not have DataMember or JsonProperty attributes - property.Ignored = (hasJsonIgnoreAttribute || !hasMemberAttribute); - } - - // resolve converter for property - // the class type might have a converter but the property converter takes precedence - property.Converter = JsonTypeReflector.GetJsonConverter(attributeProvider); - - DefaultValueAttribute? defaultValueAttribute = JsonTypeReflector.GetAttribute(attributeProvider); - if (defaultValueAttribute != null) - { - property.DefaultValue = defaultValueAttribute.Value; - } - - allowNonPublicAccess = false; -#pragma warning disable 618 - if ((DefaultMembersSearchFlags & BindingFlags.NonPublic) == BindingFlags.NonPublic) - { - allowNonPublicAccess = true; - } -#pragma warning restore 618 - if (hasMemberAttribute) - { - allowNonPublicAccess = true; - } - if (memberSerialization == MemberSerialization.Fields) - { - allowNonPublicAccess = true; - } - } - - private Predicate? CreateShouldSerializeTest(MemberInfo member) - { - MethodInfo shouldSerializeMethod = member.DeclaringType.GetMethod(JsonTypeReflector.ShouldSerializePrefix + member.Name, ReflectionUtils.EmptyTypes); - - if (shouldSerializeMethod == null || shouldSerializeMethod.ReturnType != typeof(bool)) - { - return null; - } - - MethodCall shouldSerializeCall = - JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(shouldSerializeMethod); - - return o => (bool)shouldSerializeCall(o)!; - } - - private void SetIsSpecifiedActions(JsonProperty property, MemberInfo member, bool allowNonPublicAccess) - { - MemberInfo? specifiedMember = member.DeclaringType.GetProperty(member.Name + JsonTypeReflector.SpecifiedPostfix, BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); - if (specifiedMember == null) - { - specifiedMember = member.DeclaringType.GetField(member.Name + JsonTypeReflector.SpecifiedPostfix, BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); - } - - if (specifiedMember == null || ReflectionUtils.GetMemberUnderlyingType(specifiedMember) != typeof(bool)) - { - return; - } - - Func specifiedPropertyGet = JsonTypeReflector.ReflectionDelegateFactory.CreateGet(specifiedMember)!; - - property.GetIsSpecified = o => (bool)specifiedPropertyGet(o); - - if (ReflectionUtils.CanSetMemberValue(specifiedMember, allowNonPublicAccess, false)) - { - property.SetIsSpecified = JsonTypeReflector.ReflectionDelegateFactory.CreateSet(specifiedMember); - } - } - - /// - /// Resolves the name of the property. - /// - /// Name of the property. - /// Resolved name of the property. - protected virtual string ResolvePropertyName(string propertyName) - { - if (NamingStrategy != null) - { - return NamingStrategy.GetPropertyName(propertyName, false); - } - - return propertyName; - } - - /// - /// Resolves the name of the extension data. By default no changes are made to extension data names. - /// - /// Name of the extension data. - /// Resolved name of the extension data. - protected virtual string ResolveExtensionDataName(string extensionDataName) - { - if (NamingStrategy != null) - { - return NamingStrategy.GetExtensionDataName(extensionDataName); - } - - return extensionDataName; - } - - /// - /// Resolves the key of the dictionary. By default is used to resolve dictionary keys. - /// - /// Key of the dictionary. - /// Resolved key of the dictionary. - protected virtual string ResolveDictionaryKey(string dictionaryKey) - { - if (NamingStrategy != null) - { - return NamingStrategy.GetDictionaryKey(dictionaryKey); - } - - return ResolvePropertyName(dictionaryKey); - } - - /// - /// Gets the resolved name of the property. - /// - /// Name of the property. - /// Name of the property. - public string GetResolvedPropertyName(string propertyName) - { - // this is a new method rather than changing the visibility of ResolvePropertyName to avoid - // a breaking change for anyone who has overidden the method - return ResolvePropertyName(propertyName); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/DefaultNamingStrategy.cs b/Source/MyDb/Newtonsoft.Json/Serialization/DefaultNamingStrategy.cs deleted file mode 100644 index 0f60780..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/DefaultNamingStrategy.cs +++ /dev/null @@ -1,18 +0,0 @@ -namespace Newtonsoft.Json.Serialization -{ - /// - /// The default naming strategy. Property names and dictionary keys are unchanged. - /// - public class DefaultNamingStrategy : NamingStrategy - { - /// - /// Resolves the specified property name. - /// - /// The property name to resolve. - /// The resolved property name. - protected override string ResolvePropertyName(string name) - { - return name; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/DefaultReferenceResolver.cs b/Source/MyDb/Newtonsoft.Json/Serialization/DefaultReferenceResolver.cs deleted file mode 100644 index 83e0f48..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/DefaultReferenceResolver.cs +++ /dev/null @@ -1,83 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Utilities; -using System.Globalization; - -namespace Newtonsoft.Json.Serialization -{ - internal class DefaultReferenceResolver : IReferenceResolver - { - private int _referenceCount; - - private BidirectionalDictionary GetMappings(object context) - { - if (!(context is JsonSerializerInternalBase internalSerializer)) - { - if (context is JsonSerializerProxy proxy) - { - internalSerializer = proxy.GetInternalSerializer(); - } - else - { - throw new JsonException("The DefaultReferenceResolver can only be used internally."); - } - } - - return internalSerializer.DefaultReferenceMappings; - } - - public object ResolveReference(object context, string reference) - { - GetMappings(context).TryGetByFirst(reference, out object value); - return value; - } - - public string GetReference(object context, object value) - { - BidirectionalDictionary mappings = GetMappings(context); - - if (!mappings.TryGetBySecond(value, out string reference)) - { - _referenceCount++; - reference = _referenceCount.ToString(CultureInfo.InvariantCulture); - mappings.Set(reference, value); - } - - return reference; - } - - public void AddReference(object context, string reference, object value) - { - GetMappings(context).Set(reference, value); - } - - public bool IsReferenced(object context, object value) - { - return GetMappings(context).TryGetBySecond(value, out _); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/DefaultSerializationBinder.cs b/Source/MyDb/Newtonsoft.Json/Serialization/DefaultSerializationBinder.cs deleted file mode 100644 index 1adf55a..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/DefaultSerializationBinder.cs +++ /dev/null @@ -1,215 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Runtime.Serialization; -using System.Reflection; -using System.Globalization; -using Newtonsoft.Json.Utilities; -using System.Collections.Generic; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// The default serialization binder used when resolving and loading classes from type names. - /// - public class DefaultSerializationBinder : -#pragma warning disable 618 - SerializationBinder, -#pragma warning restore 618 - ISerializationBinder - { - internal static readonly DefaultSerializationBinder Instance = new DefaultSerializationBinder(); - - private readonly ThreadSafeStore, Type> _typeCache; - - /// - /// Initializes a new instance of the class. - /// - public DefaultSerializationBinder() - { - _typeCache = new ThreadSafeStore, Type>(GetTypeFromTypeNameKey); - } - - private Type GetTypeFromTypeNameKey(StructMultiKey typeNameKey) - { - string? assemblyName = typeNameKey.Value1; - string typeName = typeNameKey.Value2; - - if (assemblyName != null) - { - Assembly assembly; - -#if !(DOTNET || PORTABLE40 || PORTABLE) - // look, I don't like using obsolete methods as much as you do but this is the only way - // Assembly.Load won't check the GAC for a partial name -#pragma warning disable 618,612 - assembly = Assembly.LoadWithPartialName(assemblyName); -#pragma warning restore 618,612 -#elif DOTNET || PORTABLE - assembly = Assembly.Load(new AssemblyName(assemblyName)); -#else - assembly = Assembly.Load(assemblyName); -#endif - -#if HAVE_APP_DOMAIN - if (assembly == null) - { - // will find assemblies loaded with Assembly.LoadFile outside of the main directory - Assembly[] loadedAssemblies = AppDomain.CurrentDomain.GetAssemblies(); - foreach (Assembly a in loadedAssemblies) - { - // check for both full name or partial name match - if (a.FullName == assemblyName || a.GetName().Name == assemblyName) - { - assembly = a; - break; - } - } - } -#endif - - if (assembly == null) - { - throw new JsonSerializationException("Could not load assembly '{0}'.".FormatWith(CultureInfo.InvariantCulture, assemblyName)); - } - - Type? type = assembly.GetType(typeName); - if (type == null) - { - // if generic type, try manually parsing the type arguments for the case of dynamically loaded assemblies - // example generic typeName format: System.Collections.Generic.Dictionary`2[[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]] - if (typeName.IndexOf('`') >= 0) - { - try - { - type = GetGenericTypeFromTypeName(typeName, assembly); - } - catch (Exception ex) - { - throw new JsonSerializationException("Could not find type '{0}' in assembly '{1}'.".FormatWith(CultureInfo.InvariantCulture, typeName, assembly.FullName), ex); - } - } - - if (type == null) - { - throw new JsonSerializationException("Could not find type '{0}' in assembly '{1}'.".FormatWith(CultureInfo.InvariantCulture, typeName, assembly.FullName)); - } - } - - return type; - } - else - { - return Type.GetType(typeName); - } - } - - private Type? GetGenericTypeFromTypeName(string typeName, Assembly assembly) - { - Type? type = null; - int openBracketIndex = typeName.IndexOf('['); - if (openBracketIndex >= 0) - { - string genericTypeDefName = typeName.Substring(0, openBracketIndex); - Type genericTypeDef = assembly.GetType(genericTypeDefName); - if (genericTypeDef != null) - { - List genericTypeArguments = new List(); - int scope = 0; - int typeArgStartIndex = 0; - int endIndex = typeName.Length - 1; - for (int i = openBracketIndex + 1; i < endIndex; ++i) - { - char current = typeName[i]; - switch (current) - { - case '[': - if (scope == 0) - { - typeArgStartIndex = i + 1; - } - ++scope; - break; - case ']': - --scope; - if (scope == 0) - { - string typeArgAssemblyQualifiedName = typeName.Substring(typeArgStartIndex, i - typeArgStartIndex); - - StructMultiKey typeNameKey = ReflectionUtils.SplitFullyQualifiedTypeName(typeArgAssemblyQualifiedName); - genericTypeArguments.Add(GetTypeByName(typeNameKey)); - } - break; - } - } - - type = genericTypeDef.MakeGenericType(genericTypeArguments.ToArray()); - } - } - - return type; - } - - private Type GetTypeByName(StructMultiKey typeNameKey) - { - return _typeCache.Get(typeNameKey); - } - - /// - /// When overridden in a derived class, controls the binding of a serialized object to a type. - /// - /// Specifies the name of the serialized object. - /// Specifies the name of the serialized object. - /// - /// The type of the object the formatter creates a new instance of. - /// - public override Type BindToType(string? assemblyName, string typeName) - { - return GetTypeByName(new StructMultiKey(assemblyName, typeName)); - } - - /// - /// When overridden in a derived class, controls the binding of a serialized object to a type. - /// - /// The type of the object the formatter creates a new instance of. - /// Specifies the name of the serialized object. - /// Specifies the name of the serialized object. - public -#if HAVE_SERIALIZATION_BINDER_BIND_TO_NAME - override -#endif - void BindToName(Type serializedType, out string? assemblyName, out string? typeName) - { -#if !HAVE_FULL_REFLECTION - assemblyName = serializedType.GetTypeInfo().Assembly.FullName; - typeName = serializedType.FullName; -#else - assemblyName = serializedType.Assembly.FullName; - typeName = serializedType.FullName; -#endif - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/DiagnosticsTraceWriter.cs b/Source/MyDb/Newtonsoft.Json/Serialization/DiagnosticsTraceWriter.cs deleted file mode 100644 index 23ece09..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/DiagnosticsTraceWriter.cs +++ /dev/null @@ -1,79 +0,0 @@ -#if HAVE_TRACE_WRITER -using System; -using System.Diagnostics; -using DiagnosticsTrace = System.Diagnostics.Trace; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Represents a trace writer that writes to the application's instances. - /// - public class DiagnosticsTraceWriter : ITraceWriter - { - /// - /// Gets the that will be used to filter the trace messages passed to the writer. - /// For example a filter level of will exclude messages and include , - /// and messages. - /// - /// - /// The that will be used to filter the trace messages passed to the writer. - /// - public TraceLevel LevelFilter { get; set; } - - private TraceEventType GetTraceEventType(TraceLevel level) - { - switch (level) - { - case TraceLevel.Error: - return TraceEventType.Error; - case TraceLevel.Warning: - return TraceEventType.Warning; - case TraceLevel.Info: - return TraceEventType.Information; - case TraceLevel.Verbose: - return TraceEventType.Verbose; - default: - throw new ArgumentOutOfRangeException(nameof(level)); - } - } - - /// - /// Writes the specified trace level, message and optional exception. - /// - /// The at which to write this trace. - /// The trace message. - /// The trace exception. This parameter is optional. - public void Trace(TraceLevel level, string message, Exception? ex) - { - if (level == TraceLevel.Off) - { - return; - } - - TraceEventCache eventCache = new TraceEventCache(); - TraceEventType traceEventType = GetTraceEventType(level); - - foreach (TraceListener listener in DiagnosticsTrace.Listeners) - { - if (!listener.IsThreadSafe) - { - lock (listener) - { - listener.TraceEvent(eventCache, "Newtonsoft.Json", traceEventType, 0, message); - } - } - else - { - listener.TraceEvent(eventCache, "Newtonsoft.Json", traceEventType, 0, message); - } - - if (DiagnosticsTrace.AutoFlush) - { - listener.Flush(); - } - } - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/DynamicValueProvider.cs b/Source/MyDb/Newtonsoft.Json/Serialization/DynamicValueProvider.cs deleted file mode 100644 index cb19a61..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/DynamicValueProvider.cs +++ /dev/null @@ -1,120 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_REFLECTION_EMIT -using System; -using System.Collections.Generic; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#endif -using System.Text; -using System.Reflection; -using Newtonsoft.Json.Utilities; -using System.Globalization; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Get and set values for a using dynamic methods. - /// - public class DynamicValueProvider : IValueProvider - { - private readonly MemberInfo _memberInfo; - private Func? _getter; - private Action? _setter; - - /// - /// Initializes a new instance of the class. - /// - /// The member info. - public DynamicValueProvider(MemberInfo memberInfo) - { - ValidationUtils.ArgumentNotNull(memberInfo, nameof(memberInfo)); - _memberInfo = memberInfo; - } - - /// - /// Sets the value. - /// - /// The target to set the value on. - /// The value to set on the target. - public void SetValue(object target, object? value) - { - try - { - if (_setter == null) - { - _setter = DynamicReflectionDelegateFactory.Instance.CreateSet(_memberInfo); - } - -#if DEBUG - // dynamic method doesn't check whether the type is 'legal' to set - // add this check for unit tests - if (value == null) - { - if (!ReflectionUtils.IsNullable(ReflectionUtils.GetMemberUnderlyingType(_memberInfo))) - { - throw new JsonSerializationException("Incompatible value. Cannot set {0} to null.".FormatWith(CultureInfo.InvariantCulture, _memberInfo)); - } - } - else if (!ReflectionUtils.GetMemberUnderlyingType(_memberInfo).IsAssignableFrom(value.GetType())) - { - throw new JsonSerializationException("Incompatible value. Cannot set {0} to type {1}.".FormatWith(CultureInfo.InvariantCulture, _memberInfo, value.GetType())); - } -#endif - - _setter(target, value); - } - catch (Exception ex) - { - throw new JsonSerializationException("Error setting value to '{0}' on '{1}'.".FormatWith(CultureInfo.InvariantCulture, _memberInfo.Name, target.GetType()), ex); - } - } - - /// - /// Gets the value. - /// - /// The target to get the value from. - /// The value. - public object? GetValue(object target) - { - try - { - if (_getter == null) - { - _getter = DynamicReflectionDelegateFactory.Instance.CreateGet(_memberInfo); - } - - return _getter(target); - } - catch (Exception ex) - { - throw new JsonSerializationException("Error getting value from '{0}' on '{1}'.".FormatWith(CultureInfo.InvariantCulture, _memberInfo.Name, target.GetType()), ex); - } - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/ErrorContext.cs b/Source/MyDb/Newtonsoft.Json/Serialization/ErrorContext.cs deleted file mode 100644 index 173fb7f..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/ErrorContext.cs +++ /dev/null @@ -1,75 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Provides information surrounding an error. - /// - public class ErrorContext - { - internal ErrorContext(object? originalObject, object? member, string path, Exception error) - { - OriginalObject = originalObject; - Member = member; - Error = error; - Path = path; - } - - internal bool Traced { get; set; } - - /// - /// Gets the error. - /// - /// The error. - public Exception Error { get; } - - /// - /// Gets the original object that caused the error. - /// - /// The original object that caused the error. - public object? OriginalObject { get; } - - /// - /// Gets the member that caused the error. - /// - /// The member that caused the error. - public object? Member { get; } - - /// - /// Gets the path of the JSON location where the error occurred. - /// - /// The path of the JSON location where the error occurred. - public string Path { get; } - - /// - /// Gets or sets a value indicating whether this is handled. - /// - /// true if handled; otherwise, false. - public bool Handled { get; set; } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/ErrorEventArgs.cs b/Source/MyDb/Newtonsoft.Json/Serialization/ErrorEventArgs.cs deleted file mode 100644 index 8231abb..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/ErrorEventArgs.cs +++ /dev/null @@ -1,58 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Provides data for the Error event. - /// - public class ErrorEventArgs : EventArgs - { - /// - /// Gets the current object the error event is being raised against. - /// - /// The current object the error event is being raised against. - public object? CurrentObject { get; } - - /// - /// Gets the error context. - /// - /// The error context. - public ErrorContext ErrorContext { get; } - - /// - /// Initializes a new instance of the class. - /// - /// The current object. - /// The error context. - public ErrorEventArgs(object? currentObject, ErrorContext errorContext) - { - CurrentObject = currentObject; - ErrorContext = errorContext; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/ExpressionValueProvider.cs b/Source/MyDb/Newtonsoft.Json/Serialization/ExpressionValueProvider.cs deleted file mode 100644 index 99da718..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/ExpressionValueProvider.cs +++ /dev/null @@ -1,121 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if !(NET20 || NET35) - -using System; -using System.Collections.Generic; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#endif -using System.Text; -using System.Reflection; -using Newtonsoft.Json.Utilities; -using System.Globalization; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Get and set values for a using dynamic methods. - /// - public class ExpressionValueProvider : IValueProvider - { - private readonly MemberInfo _memberInfo; - private Func? _getter; - private Action? _setter; - - /// - /// Initializes a new instance of the class. - /// - /// The member info. - public ExpressionValueProvider(MemberInfo memberInfo) - { - ValidationUtils.ArgumentNotNull(memberInfo, nameof(memberInfo)); - _memberInfo = memberInfo; - } - - /// - /// Sets the value. - /// - /// The target to set the value on. - /// The value to set on the target. - public void SetValue(object target, object? value) - { - try - { - if (_setter == null) - { - _setter = ExpressionReflectionDelegateFactory.Instance.CreateSet(_memberInfo); - } - -#if DEBUG - // dynamic method doesn't check whether the type is 'legal' to set - // add this check for unit tests - if (value == null) - { - if (!ReflectionUtils.IsNullable(ReflectionUtils.GetMemberUnderlyingType(_memberInfo))) - { - throw new JsonSerializationException("Incompatible value. Cannot set {0} to null.".FormatWith(CultureInfo.InvariantCulture, _memberInfo)); - } - } - else if (!ReflectionUtils.GetMemberUnderlyingType(_memberInfo).IsAssignableFrom(value.GetType())) - { - throw new JsonSerializationException("Incompatible value. Cannot set {0} to type {1}.".FormatWith(CultureInfo.InvariantCulture, _memberInfo, value.GetType())); - } -#endif - - _setter(target, value); - } - catch (Exception ex) - { - throw new JsonSerializationException("Error setting value to '{0}' on '{1}'.".FormatWith(CultureInfo.InvariantCulture, _memberInfo.Name, target.GetType()), ex); - } - } - - /// - /// Gets the value. - /// - /// The target to get the value from. - /// The value. - public object? GetValue(object target) - { - try - { - if (_getter == null) - { - _getter = ExpressionReflectionDelegateFactory.Instance.CreateGet(_memberInfo); - } - - return _getter(target); - } - catch (Exception ex) - { - throw new JsonSerializationException("Error getting value from '{0}' on '{1}'.".FormatWith(CultureInfo.InvariantCulture, _memberInfo.Name, target.GetType()), ex); - } - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/FormatterConverter.cs b/Source/MyDb/Newtonsoft.Json/Serialization/FormatterConverter.cs deleted file mode 100644 index 3247d25..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/FormatterConverter.cs +++ /dev/null @@ -1,117 +0,0 @@ -using System; -using System.Globalization; -using System.Runtime.InteropServices; -using System.Runtime.Serialization; -using Newtonsoft.Json.Utilities; - -#if HAVE_BINARY_SERIALIZATION && !HAVE_BINARY_FORMATTER - -namespace Newtonsoft.Json.Serialization -{ - internal class FormatterConverter : IFormatterConverter - { - public object Convert(object value, Type type) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ChangeType(value, type, CultureInfo.InvariantCulture); - } - - public object Convert(object value, TypeCode typeCode) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ChangeType(value, typeCode, CultureInfo.InvariantCulture); - } - - public bool ToBoolean(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToBoolean(value, CultureInfo.InvariantCulture); - } - - public byte ToByte(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToByte(value, CultureInfo.InvariantCulture); - } - - public char ToChar(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToChar(value, CultureInfo.InvariantCulture); - } - - public DateTime ToDateTime(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToDateTime(value, CultureInfo.InvariantCulture); - } - - public decimal ToDecimal(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToDecimal(value, CultureInfo.InvariantCulture); - } - - public double ToDouble(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToDouble(value, CultureInfo.InvariantCulture); - } - - public short ToInt16(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToInt16(value, CultureInfo.InvariantCulture); - } - - public int ToInt32(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToInt32(value, CultureInfo.InvariantCulture); - } - - public long ToInt64(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToInt64(value, CultureInfo.InvariantCulture); - } - - public sbyte ToSByte(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToSByte(value, CultureInfo.InvariantCulture); - } - - public float ToSingle(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToSingle(value, CultureInfo.InvariantCulture); - } - - public string ToString(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToString(value, CultureInfo.InvariantCulture); - } - - public ushort ToUInt16(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToUInt16(value, CultureInfo.InvariantCulture); - } - - public uint ToUInt32(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToUInt32(value, CultureInfo.InvariantCulture); - } - - public ulong ToUInt64(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - return System.Convert.ToUInt64(value, CultureInfo.InvariantCulture); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/IAttributeProvider.cs b/Source/MyDb/Newtonsoft.Json/Serialization/IAttributeProvider.cs deleted file mode 100644 index b3517b7..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/IAttributeProvider.cs +++ /dev/null @@ -1,51 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Provides methods to get attributes. - /// - public interface IAttributeProvider - { - /// - /// Returns a collection of all of the attributes, or an empty collection if there are no attributes. - /// - /// When true, look up the hierarchy chain for the inherited custom attribute. - /// A collection of s, or an empty collection. - IList GetAttributes(bool inherit); - - /// - /// Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. - /// - /// The type of the attributes. - /// When true, look up the hierarchy chain for the inherited custom attribute. - /// A collection of s, or an empty collection. - IList GetAttributes(Type attributeType, bool inherit); - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/IContractResolver.cs b/Source/MyDb/Newtonsoft.Json/Serialization/IContractResolver.cs deleted file mode 100644 index 49a8ee8..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/IContractResolver.cs +++ /dev/null @@ -1,46 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Used by to resolve a for a given . - /// - /// - /// - /// - /// - public interface IContractResolver - { - /// - /// Resolves the contract for a given type. - /// - /// The type to resolve a contract for. - /// The contract for a given type. - JsonContract ResolveContract(Type type); - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/IReferenceResolver.cs b/Source/MyDb/Newtonsoft.Json/Serialization/IReferenceResolver.cs deleted file mode 100644 index f5ce5bf..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/IReferenceResolver.cs +++ /dev/null @@ -1,67 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Used to resolve references when serializing and deserializing JSON by the . - /// - public interface IReferenceResolver - { - /// - /// Resolves a reference to its object. - /// - /// The serialization context. - /// The reference to resolve. - /// The object that was resolved from the reference. - object ResolveReference(object context, string reference); - - /// - /// Gets the reference for the specified object. - /// - /// The serialization context. - /// The object to get a reference for. - /// The reference to the object. - string GetReference(object context, object value); - - /// - /// Determines whether the specified object is referenced. - /// - /// The serialization context. - /// The object to test for a reference. - /// - /// true if the specified object is referenced; otherwise, false. - /// - bool IsReferenced(object context, object value); - - /// - /// Adds a reference to the specified object. - /// - /// The serialization context. - /// The reference. - /// The object to reference. - void AddReference(object context, string reference, object value); - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/ISerializationBinder.cs b/Source/MyDb/Newtonsoft.Json/Serialization/ISerializationBinder.cs deleted file mode 100644 index 64ce1c3..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/ISerializationBinder.cs +++ /dev/null @@ -1,53 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Reflection; -using System.Runtime.Serialization; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Allows users to control class loading and mandate what class to load. - /// - public interface ISerializationBinder - { - /// - /// When implemented, controls the binding of a serialized object to a type. - /// - /// Specifies the name of the serialized object. - /// Specifies the name of the serialized object - /// The type of the object the formatter creates a new instance of. - Type BindToType(string? assemblyName, string typeName); - - /// - /// When implemented, controls the binding of a serialized object to a type. - /// - /// The type of the object the formatter creates a new instance of. - /// Specifies the name of the serialized object. - /// Specifies the name of the serialized object. - void BindToName(Type serializedType, out string? assemblyName, out string? typeName); - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/ITraceWriter.cs b/Source/MyDb/Newtonsoft.Json/Serialization/ITraceWriter.cs deleted file mode 100644 index 57f2472..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/ITraceWriter.cs +++ /dev/null @@ -1,28 +0,0 @@ -using System; -using System.Collections.Generic; -using System.Diagnostics; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Represents a trace writer. - /// - public interface ITraceWriter - { - /// - /// Gets the that will be used to filter the trace messages passed to the writer. - /// For example a filter level of will exclude messages and include , - /// and messages. - /// - /// The that will be used to filter the trace messages passed to the writer. - TraceLevel LevelFilter { get; } - - /// - /// Writes the specified trace level, message and optional exception. - /// - /// The at which to write this trace. - /// The trace message. - /// The trace exception. This parameter is optional. - void Trace(TraceLevel level, string message, Exception? ex); - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/IValueProvider.cs b/Source/MyDb/Newtonsoft.Json/Serialization/IValueProvider.cs deleted file mode 100644 index 7bfd610..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/IValueProvider.cs +++ /dev/null @@ -1,47 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Provides methods to get and set values. - /// - public interface IValueProvider - { - /// - /// Sets the value. - /// - /// The target to set the value on. - /// The value to set on the target. - void SetValue(object target, object? value); - - /// - /// Gets the value. - /// - /// The target to get the value from. - /// The value. - object? GetValue(object target); - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonArrayContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonArrayContract.cs deleted file mode 100644 index a2ce9da..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonArrayContract.cs +++ /dev/null @@ -1,326 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Collections.ObjectModel; -using System.ComponentModel; -using System.Globalization; -using System.Reflection; -using Newtonsoft.Json.Utilities; -using System.Collections; -using System.Diagnostics; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Contract details for a used by the . - /// - public class JsonArrayContract : JsonContainerContract - { - /// - /// Gets the of the collection items. - /// - /// The of the collection items. - public Type? CollectionItemType { get; } - - /// - /// Gets a value indicating whether the collection type is a multidimensional array. - /// - /// true if the collection type is a multidimensional array; otherwise, false. - public bool IsMultidimensionalArray { get; } - - private readonly Type? _genericCollectionDefinitionType; - - private Type? _genericWrapperType; - private ObjectConstructor? _genericWrapperCreator; - private Func? _genericTemporaryCollectionCreator; - - internal bool IsArray { get; } - internal bool ShouldCreateWrapper { get; } - internal bool CanDeserialize { get; private set; } - - private readonly ConstructorInfo? _parameterizedConstructor; - - private ObjectConstructor? _parameterizedCreator; - private ObjectConstructor? _overrideCreator; - - internal ObjectConstructor? ParameterizedCreator - { - get - { - if (_parameterizedCreator == null && _parameterizedConstructor != null) - { - _parameterizedCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(_parameterizedConstructor); - } - - return _parameterizedCreator; - } - } - - /// - /// Gets or sets the function used to create the object. When set this function will override . - /// - /// The function used to create the object. - public ObjectConstructor? OverrideCreator - { - get => _overrideCreator; - set - { - _overrideCreator = value; - // hacky - CanDeserialize = true; - } - } - - /// - /// Gets a value indicating whether the creator has a parameter with the collection values. - /// - /// true if the creator has a parameter with the collection values; otherwise, false. - public bool HasParameterizedCreator { get; set; } - - internal bool HasParameterizedCreatorInternal => (HasParameterizedCreator || _parameterizedCreator != null || _parameterizedConstructor != null); - - /// - /// Initializes a new instance of the class. - /// - /// The underlying type for the contract. - public JsonArrayContract(Type underlyingType) - : base(underlyingType) - { - ContractType = JsonContractType.Array; - - // netcoreapp3.0 uses EmptyPartition for empty enumerable. Treat as an empty array. - IsArray = CreatedType.IsArray || - (NonNullableUnderlyingType.IsGenericType() && NonNullableUnderlyingType.GetGenericTypeDefinition().FullName == "System.Linq.EmptyPartition`1"); - - bool canDeserialize; - - Type? tempCollectionType; - if (IsArray) - { - CollectionItemType = ReflectionUtils.GetCollectionItemType(UnderlyingType); - IsReadOnlyOrFixedSize = true; - _genericCollectionDefinitionType = typeof(List<>).MakeGenericType(CollectionItemType); - - canDeserialize = true; - IsMultidimensionalArray = (CreatedType.IsArray && UnderlyingType.GetArrayRank() > 1); - } - else if (typeof(IList).IsAssignableFrom(NonNullableUnderlyingType)) - { - if (ReflectionUtils.ImplementsGenericDefinition(NonNullableUnderlyingType, typeof(ICollection<>), out _genericCollectionDefinitionType)) - { - CollectionItemType = _genericCollectionDefinitionType.GetGenericArguments()[0]; - } - else - { - CollectionItemType = ReflectionUtils.GetCollectionItemType(NonNullableUnderlyingType); - } - - if (NonNullableUnderlyingType == typeof(IList)) - { - CreatedType = typeof(List); - } - - if (CollectionItemType != null) - { - _parameterizedConstructor = CollectionUtils.ResolveEnumerableCollectionConstructor(NonNullableUnderlyingType, CollectionItemType); - } - - IsReadOnlyOrFixedSize = ReflectionUtils.InheritsGenericDefinition(NonNullableUnderlyingType, typeof(ReadOnlyCollection<>)); - canDeserialize = true; - } - else if (ReflectionUtils.ImplementsGenericDefinition(NonNullableUnderlyingType, typeof(ICollection<>), out _genericCollectionDefinitionType)) - { - CollectionItemType = _genericCollectionDefinitionType.GetGenericArguments()[0]; - - if (ReflectionUtils.IsGenericDefinition(NonNullableUnderlyingType, typeof(ICollection<>)) - || ReflectionUtils.IsGenericDefinition(NonNullableUnderlyingType, typeof(IList<>))) - { - CreatedType = typeof(List<>).MakeGenericType(CollectionItemType); - } - -#if HAVE_ISET - if (ReflectionUtils.IsGenericDefinition(NonNullableUnderlyingType, typeof(ISet<>))) - { - CreatedType = typeof(HashSet<>).MakeGenericType(CollectionItemType); - } -#endif - - _parameterizedConstructor = CollectionUtils.ResolveEnumerableCollectionConstructor(NonNullableUnderlyingType, CollectionItemType); - canDeserialize = true; - ShouldCreateWrapper = true; - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (ReflectionUtils.ImplementsGenericDefinition(NonNullableUnderlyingType, typeof(IReadOnlyCollection<>), out tempCollectionType)) - { - CollectionItemType = tempCollectionType.GetGenericArguments()[0]; - - if (ReflectionUtils.IsGenericDefinition(NonNullableUnderlyingType, typeof(IReadOnlyCollection<>)) - || ReflectionUtils.IsGenericDefinition(NonNullableUnderlyingType, typeof(IReadOnlyList<>))) - { - CreatedType = typeof(ReadOnlyCollection<>).MakeGenericType(CollectionItemType); - } - - _genericCollectionDefinitionType = typeof(List<>).MakeGenericType(CollectionItemType); - _parameterizedConstructor = CollectionUtils.ResolveEnumerableCollectionConstructor(CreatedType, CollectionItemType); - -#if HAVE_FSHARP_TYPES - StoreFSharpListCreatorIfNecessary(NonNullableUnderlyingType); -#endif - - IsReadOnlyOrFixedSize = true; - canDeserialize = HasParameterizedCreatorInternal; - } -#endif - else if (ReflectionUtils.ImplementsGenericDefinition(NonNullableUnderlyingType, typeof(IEnumerable<>), out tempCollectionType)) - { - CollectionItemType = tempCollectionType.GetGenericArguments()[0]; - - if (ReflectionUtils.IsGenericDefinition(UnderlyingType, typeof(IEnumerable<>))) - { - CreatedType = typeof(List<>).MakeGenericType(CollectionItemType); - } - - _parameterizedConstructor = CollectionUtils.ResolveEnumerableCollectionConstructor(NonNullableUnderlyingType, CollectionItemType); - -#if HAVE_FSHARP_TYPES - StoreFSharpListCreatorIfNecessary(NonNullableUnderlyingType); -#endif - - if (NonNullableUnderlyingType.IsGenericType() && NonNullableUnderlyingType.GetGenericTypeDefinition() == typeof(IEnumerable<>)) - { - _genericCollectionDefinitionType = tempCollectionType; - - IsReadOnlyOrFixedSize = false; - ShouldCreateWrapper = false; - canDeserialize = true; - } - else - { - _genericCollectionDefinitionType = typeof(List<>).MakeGenericType(CollectionItemType); - - IsReadOnlyOrFixedSize = true; - ShouldCreateWrapper = true; - canDeserialize = HasParameterizedCreatorInternal; - } - } - else - { - // types that implement IEnumerable and nothing else - canDeserialize = false; - ShouldCreateWrapper = true; - } - - CanDeserialize = canDeserialize; - -#if (NET20 || NET35) - if (CollectionItemType != null && ReflectionUtils.IsNullableType(CollectionItemType)) - { - // bug in .NET 2.0 & 3.5 that List> throws an error when adding null via IList.Add(object) - // wrapper will handle calling Add(T) instead - if (ReflectionUtils.InheritsGenericDefinition(CreatedType, typeof(List<>), out tempCollectionType) - || (IsArray && !IsMultidimensionalArray)) - { - ShouldCreateWrapper = true; - } - } -#endif - - if (CollectionItemType != null && - ImmutableCollectionsUtils.TryBuildImmutableForArrayContract( - NonNullableUnderlyingType, - CollectionItemType, - out Type? immutableCreatedType, - out ObjectConstructor? immutableParameterizedCreator)) - { - CreatedType = immutableCreatedType; - _parameterizedCreator = immutableParameterizedCreator; - IsReadOnlyOrFixedSize = true; - CanDeserialize = true; - } - } - - internal IWrappedCollection CreateWrapper(object list) - { - if (_genericWrapperCreator == null) - { - MiscellaneousUtils.Assert(_genericCollectionDefinitionType != null); - - _genericWrapperType = typeof(CollectionWrapper<>).MakeGenericType(CollectionItemType); - - Type constructorArgument; - - if (ReflectionUtils.InheritsGenericDefinition(_genericCollectionDefinitionType, typeof(List<>)) - || _genericCollectionDefinitionType.GetGenericTypeDefinition() == typeof(IEnumerable<>)) - { - constructorArgument = typeof(ICollection<>).MakeGenericType(CollectionItemType); - } - else - { - constructorArgument = _genericCollectionDefinitionType; - } - - ConstructorInfo genericWrapperConstructor = _genericWrapperType.GetConstructor(new[] { constructorArgument }); - _genericWrapperCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(genericWrapperConstructor); - } - - return (IWrappedCollection)_genericWrapperCreator(list); - } - - internal IList CreateTemporaryCollection() - { - if (_genericTemporaryCollectionCreator == null) - { - // multidimensional array will also have array instances in it - Type collectionItemType = (IsMultidimensionalArray || CollectionItemType == null) - ? typeof(object) - : CollectionItemType; - - Type temporaryListType = typeof(List<>).MakeGenericType(collectionItemType); - _genericTemporaryCollectionCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateDefaultConstructor(temporaryListType); - } - - return (IList)_genericTemporaryCollectionCreator(); - } - -#if HAVE_FSHARP_TYPES - private void StoreFSharpListCreatorIfNecessary(Type underlyingType) - { - if (!HasParameterizedCreatorInternal && underlyingType.Name == FSharpUtils.FSharpListTypeName) - { - FSharpUtils.EnsureInitialized(underlyingType.Assembly()); - _parameterizedCreator = FSharpUtils.Instance.CreateSeq(CollectionItemType!); - } - } -#endif - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonContainerContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonContainerContract.cs deleted file mode 100644 index 9956ed3..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonContainerContract.cs +++ /dev/null @@ -1,117 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Reflection; -using Newtonsoft.Json.Utilities; -using System.Collections; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Contract details for a used by the . - /// - public class JsonContainerContract : JsonContract - { - private JsonContract? _itemContract; - private JsonContract? _finalItemContract; - - // will be null for containers that don't have an item type (e.g. IList) or for complex objects - internal JsonContract? ItemContract - { - get => _itemContract; - set - { - _itemContract = value; - if (_itemContract != null) - { - _finalItemContract = (_itemContract.UnderlyingType.IsSealed()) ? _itemContract : null; - } - else - { - _finalItemContract = null; - } - } - } - - // the final (i.e. can't be inherited from like a sealed class or valuetype) item contract - internal JsonContract? FinalItemContract => _finalItemContract; - - /// - /// Gets or sets the default collection items . - /// - /// The converter. - public JsonConverter? ItemConverter { get; set; } - - /// - /// Gets or sets a value indicating whether the collection items preserve object references. - /// - /// true if collection items preserve object references; otherwise, false. - public bool? ItemIsReference { get; set; } - - /// - /// Gets or sets the collection item reference loop handling. - /// - /// The reference loop handling. - public ReferenceLoopHandling? ItemReferenceLoopHandling { get; set; } - - /// - /// Gets or sets the collection item type name handling. - /// - /// The type name handling. - public TypeNameHandling? ItemTypeNameHandling { get; set; } - - /// - /// Initializes a new instance of the class. - /// - /// The underlying type for the contract. - internal JsonContainerContract(Type underlyingType) - : base(underlyingType) - { - JsonContainerAttribute? jsonContainerAttribute = JsonTypeReflector.GetCachedAttribute(underlyingType); - - if (jsonContainerAttribute != null) - { - if (jsonContainerAttribute.ItemConverterType != null) - { - ItemConverter = JsonTypeReflector.CreateJsonConverterInstance( - jsonContainerAttribute.ItemConverterType, - jsonContainerAttribute.ItemConverterParameters); - } - - ItemIsReference = jsonContainerAttribute._itemIsReference; - ItemReferenceLoopHandling = jsonContainerAttribute._itemReferenceLoopHandling; - ItemTypeNameHandling = jsonContainerAttribute._itemTypeNameHandling; - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonContract.cs deleted file mode 100644 index c774702..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonContract.cs +++ /dev/null @@ -1,326 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using System.Reflection; -using System.Runtime.Serialization; -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - internal enum JsonContractType - { - None = 0, - Object = 1, - Array = 2, - Primitive = 3, - String = 4, - Dictionary = 5, - Dynamic = 6, - Serializable = 7, - Linq = 8 - } - - /// - /// Handles serialization callback events. - /// - /// The object that raised the callback event. - /// The streaming context. - public delegate void SerializationCallback(object o, StreamingContext context); - - /// - /// Handles serialization error callback events. - /// - /// The object that raised the callback event. - /// The streaming context. - /// The error context. - public delegate void SerializationErrorCallback(object o, StreamingContext context, ErrorContext errorContext); - - /// - /// Sets extension data for an object during deserialization. - /// - /// The object to set extension data on. - /// The extension data key. - /// The extension data value. - public delegate void ExtensionDataSetter(object o, string key, object? value); - - /// - /// Gets extension data for an object during serialization. - /// - /// The object to set extension data on. - public delegate IEnumerable>? ExtensionDataGetter(object o); - - /// - /// Contract details for a used by the . - /// - public abstract class JsonContract - { - internal bool IsNullable; - internal bool IsConvertable; - internal bool IsEnum; - internal Type NonNullableUnderlyingType; - internal ReadType InternalReadType; - internal JsonContractType ContractType; - internal bool IsReadOnlyOrFixedSize; - internal bool IsSealed; - internal bool IsInstantiable; - - private List? _onDeserializedCallbacks; - private List? _onDeserializingCallbacks; - private List? _onSerializedCallbacks; - private List? _onSerializingCallbacks; - private List? _onErrorCallbacks; - private Type _createdType; - - /// - /// Gets the underlying type for the contract. - /// - /// The underlying type for the contract. - public Type UnderlyingType { get; } - - /// - /// Gets or sets the type created during deserialization. - /// - /// The type created during deserialization. - public Type CreatedType - { - get => _createdType; - set - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - _createdType = value; - - IsSealed = _createdType.IsSealed(); - IsInstantiable = !(_createdType.IsInterface() || _createdType.IsAbstract()); - } - } - - /// - /// Gets or sets whether this type contract is serialized as a reference. - /// - /// Whether this type contract is serialized as a reference. - public bool? IsReference { get; set; } - - /// - /// Gets or sets the default for this contract. - /// - /// The converter. - public JsonConverter? Converter { get; set; } - - /// - /// Gets the internally resolved for the contract's type. - /// This converter is used as a fallback converter when no other converter is resolved. - /// Setting will always override this converter. - /// - public JsonConverter? InternalConverter { get; internal set; } - - /// - /// Gets or sets all methods called immediately after deserialization of the object. - /// - /// The methods called immediately after deserialization of the object. - public IList OnDeserializedCallbacks - { - get - { - if (_onDeserializedCallbacks == null) - { - _onDeserializedCallbacks = new List(); - } - - return _onDeserializedCallbacks; - } - } - - /// - /// Gets or sets all methods called during deserialization of the object. - /// - /// The methods called during deserialization of the object. - public IList OnDeserializingCallbacks - { - get - { - if (_onDeserializingCallbacks == null) - { - _onDeserializingCallbacks = new List(); - } - - return _onDeserializingCallbacks; - } - } - - /// - /// Gets or sets all methods called after serialization of the object graph. - /// - /// The methods called after serialization of the object graph. - public IList OnSerializedCallbacks - { - get - { - if (_onSerializedCallbacks == null) - { - _onSerializedCallbacks = new List(); - } - - return _onSerializedCallbacks; - } - } - - /// - /// Gets or sets all methods called before serialization of the object. - /// - /// The methods called before serialization of the object. - public IList OnSerializingCallbacks - { - get - { - if (_onSerializingCallbacks == null) - { - _onSerializingCallbacks = new List(); - } - - return _onSerializingCallbacks; - } - } - - /// - /// Gets or sets all method called when an error is thrown during the serialization of the object. - /// - /// The methods called when an error is thrown during the serialization of the object. - public IList OnErrorCallbacks - { - get - { - if (_onErrorCallbacks == null) - { - _onErrorCallbacks = new List(); - } - - return _onErrorCallbacks; - } - } - - /// - /// Gets or sets the default creator method used to create the object. - /// - /// The default creator method used to create the object. - public Func? DefaultCreator { get; set; } - - /// - /// Gets or sets a value indicating whether the default creator is non-public. - /// - /// true if the default object creator is non-public; otherwise, false. - public bool DefaultCreatorNonPublic { get; set; } - - internal JsonContract(Type underlyingType) - { - ValidationUtils.ArgumentNotNull(underlyingType, nameof(underlyingType)); - - UnderlyingType = underlyingType; - - // resolve ByRef types - // typically comes from in and ref parameters on methods/ctors - underlyingType = ReflectionUtils.EnsureNotByRefType(underlyingType); - - IsNullable = ReflectionUtils.IsNullable(underlyingType); - - NonNullableUnderlyingType = (IsNullable && ReflectionUtils.IsNullableType(underlyingType)) ? Nullable.GetUnderlyingType(underlyingType) : underlyingType; - - _createdType = CreatedType = NonNullableUnderlyingType; - - IsConvertable = ConvertUtils.IsConvertible(NonNullableUnderlyingType); - IsEnum = NonNullableUnderlyingType.IsEnum(); - - InternalReadType = ReadType.Read; - } - - internal void InvokeOnSerializing(object o, StreamingContext context) - { - if (_onSerializingCallbacks != null) - { - foreach (SerializationCallback callback in _onSerializingCallbacks) - { - callback(o, context); - } - } - } - - internal void InvokeOnSerialized(object o, StreamingContext context) - { - if (_onSerializedCallbacks != null) - { - foreach (SerializationCallback callback in _onSerializedCallbacks) - { - callback(o, context); - } - } - } - - internal void InvokeOnDeserializing(object o, StreamingContext context) - { - if (_onDeserializingCallbacks != null) - { - foreach (SerializationCallback callback in _onDeserializingCallbacks) - { - callback(o, context); - } - } - } - - internal void InvokeOnDeserialized(object o, StreamingContext context) - { - if (_onDeserializedCallbacks != null) - { - foreach (SerializationCallback callback in _onDeserializedCallbacks) - { - callback(o, context); - } - } - } - - internal void InvokeOnError(object o, StreamingContext context, ErrorContext errorContext) - { - if (_onErrorCallbacks != null) - { - foreach (SerializationErrorCallback callback in _onErrorCallbacks) - { - callback(o, context, errorContext); - } - } - } - - internal static SerializationCallback CreateSerializationCallback(MethodInfo callbackMethodInfo) - { - return (o, context) => callbackMethodInfo.Invoke(o, new object[] { context }); - } - - internal static SerializationErrorCallback CreateSerializationErrorCallback(MethodInfo callbackMethodInfo) - { - return (o, context, econtext) => callbackMethodInfo.Invoke(o, new object[] { context, econtext }); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonDictionaryContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonDictionaryContract.cs deleted file mode 100644 index 6c5afbe..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonDictionaryContract.cs +++ /dev/null @@ -1,247 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Collections.ObjectModel; -using System.Reflection; -using Newtonsoft.Json.Utilities; -using System.Collections; - -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#endif - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Contract details for a used by the . - /// - public class JsonDictionaryContract : JsonContainerContract - { - /// - /// Gets or sets the dictionary key resolver. - /// - /// The dictionary key resolver. - public Func? DictionaryKeyResolver { get; set; } - - /// - /// Gets the of the dictionary keys. - /// - /// The of the dictionary keys. - public Type? DictionaryKeyType { get; } - - /// - /// Gets the of the dictionary values. - /// - /// The of the dictionary values. - public Type? DictionaryValueType { get; } - - internal JsonContract? KeyContract { get; set; } - - private readonly Type? _genericCollectionDefinitionType; - - private Type? _genericWrapperType; - private ObjectConstructor? _genericWrapperCreator; - - private Func? _genericTemporaryDictionaryCreator; - - internal bool ShouldCreateWrapper { get; } - - private readonly ConstructorInfo? _parameterizedConstructor; - - private ObjectConstructor? _overrideCreator; - private ObjectConstructor? _parameterizedCreator; - - internal ObjectConstructor? ParameterizedCreator - { - get - { - if (_parameterizedCreator == null && _parameterizedConstructor != null) - { - _parameterizedCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(_parameterizedConstructor); - } - - return _parameterizedCreator; - } - } - - /// - /// Gets or sets the function used to create the object. When set this function will override . - /// - /// The function used to create the object. - public ObjectConstructor? OverrideCreator - { - get => _overrideCreator; - set => _overrideCreator = value; - } - - /// - /// Gets a value indicating whether the creator has a parameter with the dictionary values. - /// - /// true if the creator has a parameter with the dictionary values; otherwise, false. - public bool HasParameterizedCreator { get; set; } - - internal bool HasParameterizedCreatorInternal => (HasParameterizedCreator || _parameterizedCreator != null || _parameterizedConstructor != null); - - /// - /// Initializes a new instance of the class. - /// - /// The underlying type for the contract. - public JsonDictionaryContract(Type underlyingType) - : base(underlyingType) - { - ContractType = JsonContractType.Dictionary; - - Type? keyType; - Type? valueType; - - if (ReflectionUtils.ImplementsGenericDefinition(NonNullableUnderlyingType, typeof(IDictionary<,>), out _genericCollectionDefinitionType)) - { - keyType = _genericCollectionDefinitionType.GetGenericArguments()[0]; - valueType = _genericCollectionDefinitionType.GetGenericArguments()[1]; - - if (ReflectionUtils.IsGenericDefinition(NonNullableUnderlyingType, typeof(IDictionary<,>))) - { - CreatedType = typeof(Dictionary<,>).MakeGenericType(keyType, valueType); - } - else if (NonNullableUnderlyingType.IsGenericType()) - { - // ConcurrentDictionary<,> + IDictionary setter + null value = error - // wrap to use generic setter - // https://github.com/JamesNK/Newtonsoft.Json/issues/1582 - Type typeDefinition = NonNullableUnderlyingType.GetGenericTypeDefinition(); - if (typeDefinition.FullName == JsonTypeReflector.ConcurrentDictionaryTypeName) - { - ShouldCreateWrapper = true; - } - } - -#if HAVE_READ_ONLY_COLLECTIONS - IsReadOnlyOrFixedSize = ReflectionUtils.InheritsGenericDefinition(NonNullableUnderlyingType, typeof(ReadOnlyDictionary<,>)); -#endif - - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (ReflectionUtils.ImplementsGenericDefinition(NonNullableUnderlyingType, typeof(IReadOnlyDictionary<,>), out _genericCollectionDefinitionType)) - { - keyType = _genericCollectionDefinitionType.GetGenericArguments()[0]; - valueType = _genericCollectionDefinitionType.GetGenericArguments()[1]; - - if (ReflectionUtils.IsGenericDefinition(NonNullableUnderlyingType, typeof(IReadOnlyDictionary<,>))) - { - CreatedType = typeof(ReadOnlyDictionary<,>).MakeGenericType(keyType, valueType); - } - - IsReadOnlyOrFixedSize = true; - } -#endif - else - { - ReflectionUtils.GetDictionaryKeyValueTypes(NonNullableUnderlyingType, out keyType, out valueType); - - if (NonNullableUnderlyingType == typeof(IDictionary)) - { - CreatedType = typeof(Dictionary); - } - } - - if (keyType != null && valueType != null) - { - _parameterizedConstructor = CollectionUtils.ResolveEnumerableCollectionConstructor( - CreatedType, - typeof(KeyValuePair<,>).MakeGenericType(keyType, valueType), - typeof(IDictionary<,>).MakeGenericType(keyType, valueType)); - -#if HAVE_FSHARP_TYPES - if (!HasParameterizedCreatorInternal && NonNullableUnderlyingType.Name == FSharpUtils.FSharpMapTypeName) - { - FSharpUtils.EnsureInitialized(NonNullableUnderlyingType.Assembly()); - _parameterizedCreator = FSharpUtils.Instance.CreateMap(keyType, valueType); - } -#endif - } - - if (!typeof(IDictionary).IsAssignableFrom(CreatedType)) - { - ShouldCreateWrapper = true; - } - - DictionaryKeyType = keyType; - DictionaryValueType = valueType; - -#if (NET20 || NET35) - if (DictionaryValueType != null && ReflectionUtils.IsNullableType(DictionaryValueType)) - { - // bug in .NET 2.0 & 3.5 that Dictionary> throws an error when adding null via IDictionary[key] = object - // wrapper will handle calling Add(T) instead - if (ReflectionUtils.InheritsGenericDefinition(CreatedType, typeof(Dictionary<,>), out _)) - { - ShouldCreateWrapper = true; - } - } -#endif - - if (DictionaryKeyType != null && - DictionaryValueType != null && - ImmutableCollectionsUtils.TryBuildImmutableForDictionaryContract( - NonNullableUnderlyingType, - DictionaryKeyType, - DictionaryValueType, - out Type? immutableCreatedType, - out ObjectConstructor? immutableParameterizedCreator)) - { - CreatedType = immutableCreatedType; - _parameterizedCreator = immutableParameterizedCreator; - IsReadOnlyOrFixedSize = true; - } - } - - internal IWrappedDictionary CreateWrapper(object dictionary) - { - if (_genericWrapperCreator == null) - { - _genericWrapperType = typeof(DictionaryWrapper<,>).MakeGenericType(DictionaryKeyType, DictionaryValueType); - - ConstructorInfo genericWrapperConstructor = _genericWrapperType.GetConstructor(new[] { _genericCollectionDefinitionType! }); - _genericWrapperCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(genericWrapperConstructor); - } - - return (IWrappedDictionary)_genericWrapperCreator(dictionary); - } - - internal IDictionary CreateTemporaryDictionary() - { - if (_genericTemporaryDictionaryCreator == null) - { - Type temporaryDictionaryType = typeof(Dictionary<,>).MakeGenericType(DictionaryKeyType ?? typeof(object), DictionaryValueType ?? typeof(object)); - - _genericTemporaryDictionaryCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateDefaultConstructor(temporaryDictionaryType); - } - - return (IDictionary)_genericTemporaryDictionaryCreator(); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonDynamicContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonDynamicContract.cs deleted file mode 100644 index 5908890..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonDynamicContract.cs +++ /dev/null @@ -1,116 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_DYNAMIC -using System; -using System.Dynamic; -using System.Runtime.CompilerServices; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Contract details for a used by the . - /// - public class JsonDynamicContract : JsonContainerContract - { - /// - /// Gets the object's properties. - /// - /// The object's properties. - public JsonPropertyCollection Properties { get; } - - /// - /// Gets or sets the property name resolver. - /// - /// The property name resolver. - public Func? PropertyNameResolver { get; set; } - - private readonly ThreadSafeStore>> _callSiteGetters = - new ThreadSafeStore>>(CreateCallSiteGetter); - - private readonly ThreadSafeStore>> _callSiteSetters = - new ThreadSafeStore>>(CreateCallSiteSetter); - - private static CallSite> CreateCallSiteGetter(string name) - { - GetMemberBinder getMemberBinder = (GetMemberBinder)DynamicUtils.BinderWrapper.GetMember(name, typeof(DynamicUtils)); - - return CallSite>.Create(new NoThrowGetBinderMember(getMemberBinder)); - } - - private static CallSite> CreateCallSiteSetter(string name) - { - SetMemberBinder binder = (SetMemberBinder)DynamicUtils.BinderWrapper.SetMember(name, typeof(DynamicUtils)); - - return CallSite>.Create(new NoThrowSetBinderMember(binder)); - } - - /// - /// Initializes a new instance of the class. - /// - /// The underlying type for the contract. - public JsonDynamicContract(Type underlyingType) - : base(underlyingType) - { - ContractType = JsonContractType.Dynamic; - - Properties = new JsonPropertyCollection(UnderlyingType); - } - - internal bool TryGetMember(IDynamicMetaObjectProvider dynamicProvider, string name, out object? value) - { - ValidationUtils.ArgumentNotNull(dynamicProvider, nameof(dynamicProvider)); - - CallSite> callSite = _callSiteGetters.Get(name); - - object result = callSite.Target(callSite, dynamicProvider); - - if (!ReferenceEquals(result, NoThrowExpressionVisitor.ErrorResult)) - { - value = result; - return true; - } - else - { - value = null; - return false; - } - } - - internal bool TrySetMember(IDynamicMetaObjectProvider dynamicProvider, string name, object? value) - { - ValidationUtils.ArgumentNotNull(dynamicProvider, nameof(dynamicProvider)); - - CallSite> callSite = _callSiteSetters.Get(name); - - object result = callSite.Target(callSite, dynamicProvider, value); - - return !ReferenceEquals(result, NoThrowExpressionVisitor.ErrorResult); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonFormatterConverter.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonFormatterConverter.cs deleted file mode 100644 index 46992bc..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonFormatterConverter.cs +++ /dev/null @@ -1,157 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_BINARY_SERIALIZATION -using System; -using System.Globalization; -using System.Runtime.Serialization; -using Newtonsoft.Json.Utilities; -using Newtonsoft.Json.Linq; - -namespace Newtonsoft.Json.Serialization -{ - internal class JsonFormatterConverter : IFormatterConverter - { - private readonly JsonSerializerInternalReader _reader; - private readonly JsonISerializableContract _contract; - private readonly JsonProperty? _member; - - public JsonFormatterConverter(JsonSerializerInternalReader reader, JsonISerializableContract contract, JsonProperty? member) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - ValidationUtils.ArgumentNotNull(contract, nameof(contract)); - - _reader = reader; - _contract = contract; - _member = member; - } - - private T GetTokenValue(object value) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - - JValue v = (JValue)value; - return (T)System.Convert.ChangeType(v.Value, typeof(T), CultureInfo.InvariantCulture); - } - - public object? Convert(object value, Type type) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - - if (!(value is JToken token)) - { - throw new ArgumentException("Value is not a JToken.", nameof(value)); - } - - return _reader.CreateISerializableItem(token, type, _contract, _member); - } - - public object Convert(object value, TypeCode typeCode) - { - ValidationUtils.ArgumentNotNull(value, nameof(value)); - - object? resolvedValue = (value is JValue v) ? v.Value : value; - - return System.Convert.ChangeType(resolvedValue, typeCode, CultureInfo.InvariantCulture); - } - - public bool ToBoolean(object value) - { - return GetTokenValue(value); - } - - public byte ToByte(object value) - { - return GetTokenValue(value); - } - - public char ToChar(object value) - { - return GetTokenValue(value); - } - - public DateTime ToDateTime(object value) - { - return GetTokenValue(value); - } - - public decimal ToDecimal(object value) - { - return GetTokenValue(value); - } - - public double ToDouble(object value) - { - return GetTokenValue(value); - } - - public short ToInt16(object value) - { - return GetTokenValue(value); - } - - public int ToInt32(object value) - { - return GetTokenValue(value); - } - - public long ToInt64(object value) - { - return GetTokenValue(value); - } - - public sbyte ToSByte(object value) - { - return GetTokenValue(value); - } - - public float ToSingle(object value) - { - return GetTokenValue(value); - } - - public string ToString(object value) - { - return GetTokenValue(value); - } - - public ushort ToUInt16(object value) - { - return GetTokenValue(value); - } - - public uint ToUInt32(object value) - { - return GetTokenValue(value); - } - - public ulong ToUInt64(object value) - { - return GetTokenValue(value); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonISerializableContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonISerializableContract.cs deleted file mode 100644 index 55ea9e3..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonISerializableContract.cs +++ /dev/null @@ -1,55 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_BINARY_SERIALIZATION -using System; -using System.Runtime.Serialization; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Contract details for a used by the . - /// - public class JsonISerializableContract : JsonContainerContract - { - /// - /// Gets or sets the object constructor. - /// - /// The object constructor. - public ObjectConstructor? ISerializableCreator { get; set; } - - /// - /// Initializes a new instance of the class. - /// - /// The underlying type for the contract. - public JsonISerializableContract(Type underlyingType) - : base(underlyingType) - { - ContractType = JsonContractType.Serializable; - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonLinqContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonLinqContract.cs deleted file mode 100644 index c91b3f0..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonLinqContract.cs +++ /dev/null @@ -1,45 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Contract details for a used by the . - /// - public class JsonLinqContract : JsonContract - { - /// - /// Initializes a new instance of the class. - /// - /// The underlying type for the contract. - public JsonLinqContract(Type underlyingType) - : base(underlyingType) - { - ContractType = JsonContractType.Linq; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonObjectContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonObjectContract.cs deleted file mode 100644 index 221843d..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonObjectContract.cs +++ /dev/null @@ -1,199 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using System.Reflection; -using System.Runtime.Serialization; -using System.Security; -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Contract details for a used by the . - /// - public class JsonObjectContract : JsonContainerContract - { - /// - /// Gets or sets the object member serialization. - /// - /// The member object serialization. - public MemberSerialization MemberSerialization { get; set; } - - /// - /// Gets or sets the missing member handling used when deserializing this object. - /// - /// The missing member handling. - public MissingMemberHandling? MissingMemberHandling { get; set; } - - /// - /// Gets or sets a value that indicates whether the object's properties are required. - /// - /// - /// A value indicating whether the object's properties are required. - /// - public Required? ItemRequired { get; set; } - - /// - /// Gets or sets how the object's properties with null values are handled during serialization and deserialization. - /// - /// How the object's properties with null values are handled during serialization and deserialization. - public NullValueHandling? ItemNullValueHandling { get; set; } - - /// - /// Gets the object's properties. - /// - /// The object's properties. - public JsonPropertyCollection Properties { get; } - - /// - /// Gets a collection of instances that define the parameters used with . - /// - public JsonPropertyCollection CreatorParameters - { - get - { - if (_creatorParameters == null) - { - _creatorParameters = new JsonPropertyCollection(UnderlyingType); - } - - return _creatorParameters; - } - } - - /// - /// Gets or sets the function used to create the object. When set this function will override . - /// This function is called with a collection of arguments which are defined by the collection. - /// - /// The function used to create the object. - public ObjectConstructor? OverrideCreator - { - get => _overrideCreator; - set => _overrideCreator = value; - } - - internal ObjectConstructor? ParameterizedCreator - { - get => _parameterizedCreator; - set => _parameterizedCreator = value; - } - - /// - /// Gets or sets the extension data setter. - /// - public ExtensionDataSetter? ExtensionDataSetter { get; set; } - - /// - /// Gets or sets the extension data getter. - /// - public ExtensionDataGetter? ExtensionDataGetter { get; set; } - - /// - /// Gets or sets the extension data value type. - /// - public Type? ExtensionDataValueType - { - get => _extensionDataValueType; - set - { - _extensionDataValueType = value; - ExtensionDataIsJToken = (value != null && typeof(JToken).IsAssignableFrom(value)); - } - } - - /// - /// Gets or sets the extension data name resolver. - /// - /// The extension data name resolver. - public Func? ExtensionDataNameResolver { get; set; } - - internal bool ExtensionDataIsJToken; - private bool? _hasRequiredOrDefaultValueProperties; - private ObjectConstructor? _overrideCreator; - private ObjectConstructor? _parameterizedCreator; - private JsonPropertyCollection? _creatorParameters; - private Type? _extensionDataValueType; - - internal bool HasRequiredOrDefaultValueProperties - { - get - { - if (_hasRequiredOrDefaultValueProperties == null) - { - _hasRequiredOrDefaultValueProperties = false; - - if (ItemRequired.GetValueOrDefault(Required.Default) != Required.Default) - { - _hasRequiredOrDefaultValueProperties = true; - } - else - { - foreach (JsonProperty property in Properties) - { - if (property.Required != Required.Default || (property.DefaultValueHandling & DefaultValueHandling.Populate) == DefaultValueHandling.Populate) - { - _hasRequiredOrDefaultValueProperties = true; - break; - } - } - } - } - - return _hasRequiredOrDefaultValueProperties.GetValueOrDefault(); - } - } - - /// - /// Initializes a new instance of the class. - /// - /// The underlying type for the contract. - public JsonObjectContract(Type underlyingType) - : base(underlyingType) - { - ContractType = JsonContractType.Object; - - Properties = new JsonPropertyCollection(UnderlyingType); - } - -#if HAVE_BINARY_FORMATTER -#if HAVE_SECURITY_SAFE_CRITICAL_ATTRIBUTE - [SecuritySafeCritical] -#endif - internal object GetUninitializedObject() - { - // we should never get here if the environment is not fully trusted, check just in case - if (!JsonTypeReflector.FullyTrusted) - { - throw new JsonException("Insufficient permissions. Creating an uninitialized '{0}' type requires full trust.".FormatWith(CultureInfo.InvariantCulture, NonNullableUnderlyingType)); - } - - return FormatterServices.GetUninitializedObject(NonNullableUnderlyingType); - } -#endif - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonPrimitiveContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonPrimitiveContract.cs deleted file mode 100644 index 6d662de..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonPrimitiveContract.cs +++ /dev/null @@ -1,75 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Contract details for a used by the . - /// - public class JsonPrimitiveContract : JsonContract - { - internal PrimitiveTypeCode TypeCode { get; set; } - - /// - /// Initializes a new instance of the class. - /// - /// The underlying type for the contract. - public JsonPrimitiveContract(Type underlyingType) - : base(underlyingType) - { - ContractType = JsonContractType.Primitive; - - TypeCode = ConvertUtils.GetTypeCode(underlyingType); - IsReadOnlyOrFixedSize = true; - - if (ReadTypeMap.TryGetValue(NonNullableUnderlyingType, out ReadType readType)) - { - InternalReadType = readType; - } - } - - private static readonly Dictionary ReadTypeMap = new Dictionary - { - [typeof(byte[])] = ReadType.ReadAsBytes, - [typeof(byte)] = ReadType.ReadAsInt32, - [typeof(short)] = ReadType.ReadAsInt32, - [typeof(int)] = ReadType.ReadAsInt32, - [typeof(decimal)] = ReadType.ReadAsDecimal, - [typeof(bool)] = ReadType.ReadAsBoolean, - [typeof(string)] = ReadType.ReadAsString, - [typeof(DateTime)] = ReadType.ReadAsDateTime, -#if HAVE_DATE_TIME_OFFSET - [typeof(DateTimeOffset)] = ReadType.ReadAsDateTimeOffset, -#endif - [typeof(float)] = ReadType.ReadAsDouble, - [typeof(double)] = ReadType.ReadAsDouble, - [typeof(long)] = ReadType.ReadAsInt64 - }; - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonProperty.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonProperty.cs deleted file mode 100644 index 183a5a7..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonProperty.cs +++ /dev/null @@ -1,322 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Diagnostics; -using System.Reflection; -using Newtonsoft.Json.Utilities; - -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#endif - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Maps a JSON property to a .NET member or constructor parameter. - /// - public class JsonProperty - { - internal Required? _required; - internal bool _hasExplicitDefaultValue; - - private object? _defaultValue; - private bool _hasGeneratedDefaultValue; - private string? _propertyName; - internal bool _skipPropertyNameEscape; - private Type? _propertyType; - - // use to cache contract during deserialization - internal JsonContract? PropertyContract { get; set; } - - /// - /// Gets or sets the name of the property. - /// - /// The name of the property. - public string? PropertyName - { - get => _propertyName; - set - { - _propertyName = value; - _skipPropertyNameEscape = !JavaScriptUtils.ShouldEscapeJavaScriptString(_propertyName, JavaScriptUtils.HtmlCharEscapeFlags); - } - } - - /// - /// Gets or sets the type that declared this property. - /// - /// The type that declared this property. - public Type? DeclaringType { get; set; } - - /// - /// Gets or sets the order of serialization of a member. - /// - /// The numeric order of serialization. - public int? Order { get; set; } - - /// - /// Gets or sets the name of the underlying member or parameter. - /// - /// The name of the underlying member or parameter. - public string? UnderlyingName { get; set; } - - /// - /// Gets the that will get and set the during serialization. - /// - /// The that will get and set the during serialization. - public IValueProvider? ValueProvider { get; set; } - - /// - /// Gets or sets the for this property. - /// - /// The for this property. - public IAttributeProvider? AttributeProvider { get; set; } - - /// - /// Gets or sets the type of the property. - /// - /// The type of the property. - public Type? PropertyType - { - get => _propertyType; - set - { - if (_propertyType != value) - { - _propertyType = value; - _hasGeneratedDefaultValue = false; - } - } - } - - /// - /// Gets or sets the for the property. - /// If set this converter takes precedence over the contract converter for the property type. - /// - /// The converter. - public JsonConverter? Converter { get; set; } - - /// - /// Gets or sets the member converter. - /// - /// The member converter. - [Obsolete("MemberConverter is obsolete. Use Converter instead.")] - public JsonConverter? MemberConverter - { - get => Converter; - set => Converter = value; - } - - /// - /// Gets or sets a value indicating whether this is ignored. - /// - /// true if ignored; otherwise, false. - public bool Ignored { get; set; } - - /// - /// Gets or sets a value indicating whether this is readable. - /// - /// true if readable; otherwise, false. - public bool Readable { get; set; } - - /// - /// Gets or sets a value indicating whether this is writable. - /// - /// true if writable; otherwise, false. - public bool Writable { get; set; } - - /// - /// Gets or sets a value indicating whether this has a member attribute. - /// - /// true if has a member attribute; otherwise, false. - public bool HasMemberAttribute { get; set; } - - /// - /// Gets the default value. - /// - /// The default value. - public object? DefaultValue - { - get - { - if (!_hasExplicitDefaultValue) - { - return null; - } - - return _defaultValue; - } - set - { - _hasExplicitDefaultValue = true; - _defaultValue = value; - } - } - - internal object? GetResolvedDefaultValue() - { - if (_propertyType == null) - { - return null; - } - - if (!_hasExplicitDefaultValue && !_hasGeneratedDefaultValue) - { - _defaultValue = ReflectionUtils.GetDefaultValue(_propertyType); - _hasGeneratedDefaultValue = true; - } - - return _defaultValue; - } - - /// - /// Gets or sets a value indicating whether this is required. - /// - /// A value indicating whether this is required. - public Required Required - { - get => _required ?? Required.Default; - set => _required = value; - } - - /// - /// Gets a value indicating whether has a value specified. - /// - public bool IsRequiredSpecified => _required != null; - - /// - /// Gets or sets a value indicating whether this property preserves object references. - /// - /// - /// true if this instance is reference; otherwise, false. - /// - public bool? IsReference { get; set; } - - /// - /// Gets or sets the property null value handling. - /// - /// The null value handling. - public NullValueHandling? NullValueHandling { get; set; } - - /// - /// Gets or sets the property default value handling. - /// - /// The default value handling. - public DefaultValueHandling? DefaultValueHandling { get; set; } - - /// - /// Gets or sets the property reference loop handling. - /// - /// The reference loop handling. - public ReferenceLoopHandling? ReferenceLoopHandling { get; set; } - - /// - /// Gets or sets the property object creation handling. - /// - /// The object creation handling. - public ObjectCreationHandling? ObjectCreationHandling { get; set; } - - /// - /// Gets or sets or sets the type name handling. - /// - /// The type name handling. - public TypeNameHandling? TypeNameHandling { get; set; } - - /// - /// Gets or sets a predicate used to determine whether the property should be serialized. - /// - /// A predicate used to determine whether the property should be serialized. - public Predicate? ShouldSerialize { get; set; } - - /// - /// Gets or sets a predicate used to determine whether the property should be deserialized. - /// - /// A predicate used to determine whether the property should be deserialized. - public Predicate? ShouldDeserialize { get; set; } - - /// - /// Gets or sets a predicate used to determine whether the property should be serialized. - /// - /// A predicate used to determine whether the property should be serialized. - public Predicate? GetIsSpecified { get; set; } - - /// - /// Gets or sets an action used to set whether the property has been deserialized. - /// - /// An action used to set whether the property has been deserialized. - public Action? SetIsSpecified { get; set; } - - /// - /// Returns a that represents this instance. - /// - /// - /// A that represents this instance. - /// - public override string ToString() - { - return PropertyName ?? string.Empty; - } - - /// - /// Gets or sets the converter used when serializing the property's collection items. - /// - /// The collection's items converter. - public JsonConverter? ItemConverter { get; set; } - - /// - /// Gets or sets whether this property's collection items are serialized as a reference. - /// - /// Whether this property's collection items are serialized as a reference. - public bool? ItemIsReference { get; set; } - - /// - /// Gets or sets the type name handling used when serializing the property's collection items. - /// - /// The collection's items type name handling. - public TypeNameHandling? ItemTypeNameHandling { get; set; } - - /// - /// Gets or sets the reference loop handling used when serializing the property's collection items. - /// - /// The collection's items reference loop handling. - public ReferenceLoopHandling? ItemReferenceLoopHandling { get; set; } - - internal void WritePropertyName(JsonWriter writer) - { - string? propertyName = PropertyName; - MiscellaneousUtils.Assert(propertyName != null); - - if (_skipPropertyNameEscape) - { - writer.WritePropertyName(propertyName, false); - } - else - { - writer.WritePropertyName(propertyName); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonPropertyCollection.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonPropertyCollection.cs deleted file mode 100644 index 8b3d201..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonPropertyCollection.cs +++ /dev/null @@ -1,190 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; -using System.Collections.ObjectModel; -using Newtonsoft.Json.Utilities; -using System.Globalization; -using System.Runtime.CompilerServices; -using System.Diagnostics; -using System.Diagnostics.CodeAnalysis; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// A collection of objects. - /// - public class JsonPropertyCollection : KeyedCollection - { - private readonly Type _type; - private readonly List _list; - - /// - /// Initializes a new instance of the class. - /// - /// The type. - public JsonPropertyCollection(Type type) - : base(StringComparer.Ordinal) - { - ValidationUtils.ArgumentNotNull(type, "type"); - _type = type; - - // foreach over List to avoid boxing the Enumerator - _list = (List)Items; - } - - /// - /// When implemented in a derived class, extracts the key from the specified element. - /// - /// The element from which to extract the key. - /// The key for the specified element. - protected override string GetKeyForItem(JsonProperty item) - { - return item.PropertyName!; - } - - /// - /// Adds a object. - /// - /// The property to add to the collection. - public void AddProperty(JsonProperty property) - { - MiscellaneousUtils.Assert(property.PropertyName != null); - - if (Contains(property.PropertyName)) - { - // don't overwrite existing property with ignored property - if (property.Ignored) - { - return; - } - - JsonProperty existingProperty = this[property.PropertyName]; - bool duplicateProperty = true; - - if (existingProperty.Ignored) - { - // remove ignored property so it can be replaced in collection - Remove(existingProperty); - duplicateProperty = false; - } - else - { - if (property.DeclaringType != null && existingProperty.DeclaringType != null) - { - if (property.DeclaringType.IsSubclassOf(existingProperty.DeclaringType) - || (existingProperty.DeclaringType.IsInterface() && property.DeclaringType.ImplementInterface(existingProperty.DeclaringType))) - { - // current property is on a derived class and hides the existing - Remove(existingProperty); - duplicateProperty = false; - } - if (existingProperty.DeclaringType.IsSubclassOf(property.DeclaringType) - || (property.DeclaringType.IsInterface() && existingProperty.DeclaringType.ImplementInterface(property.DeclaringType))) - { - // current property is hidden by the existing so don't add it - return; - } - - if (_type.ImplementInterface(existingProperty.DeclaringType) && _type.ImplementInterface(property.DeclaringType)) - { - // current property was already defined on another interface - return; - } - } - } - - if (duplicateProperty) - { - throw new JsonSerializationException("A member with the name '{0}' already exists on '{1}'. Use the JsonPropertyAttribute to specify another name.".FormatWith(CultureInfo.InvariantCulture, property.PropertyName, _type)); - } - } - - Add(property); - } - - /// - /// Gets the closest matching object. - /// First attempts to get an exact case match of and then - /// a case insensitive match. - /// - /// Name of the property. - /// A matching property if found. - public JsonProperty? GetClosestMatchProperty(string propertyName) - { - JsonProperty? property = GetProperty(propertyName, StringComparison.Ordinal); - if (property == null) - { - property = GetProperty(propertyName, StringComparison.OrdinalIgnoreCase); - } - - return property; - } - - private bool TryGetValue(string key, [NotNullWhen(true)]out JsonProperty? item) - { - if (Dictionary == null) - { - item = default; - return false; - } - - return Dictionary.TryGetValue(key, out item); - } - - /// - /// Gets a property by property name. - /// - /// The name of the property to get. - /// Type property name string comparison. - /// A matching property if found. - public JsonProperty? GetProperty(string propertyName, StringComparison comparisonType) - { - // KeyedCollection has an ordinal comparer - if (comparisonType == StringComparison.Ordinal) - { - if (TryGetValue(propertyName, out JsonProperty? property)) - { - return property; - } - - return null; - } - - for (int i = 0; i < _list.Count; i++) - { - JsonProperty property = _list[i]; - if (string.Equals(propertyName, property.PropertyName, comparisonType)) - { - return property; - } - } - - return null; - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerInternalBase.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerInternalBase.cs deleted file mode 100644 index 8e76dc0..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerInternalBase.cs +++ /dev/null @@ -1,159 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Diagnostics; -using System.Runtime.CompilerServices; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - internal abstract class JsonSerializerInternalBase - { - private class ReferenceEqualsEqualityComparer : IEqualityComparer - { - bool IEqualityComparer.Equals(object x, object y) - { - return ReferenceEquals(x, y); - } - - int IEqualityComparer.GetHashCode(object obj) - { - // put objects in a bucket based on their reference - return RuntimeHelpers.GetHashCode(obj); - } - } - - private ErrorContext? _currentErrorContext; - private BidirectionalDictionary? _mappings; - - internal readonly JsonSerializer Serializer; - internal readonly ITraceWriter? TraceWriter; - protected JsonSerializerProxy? InternalSerializer; - - protected JsonSerializerInternalBase(JsonSerializer serializer) - { - ValidationUtils.ArgumentNotNull(serializer, nameof(serializer)); - - Serializer = serializer; - TraceWriter = serializer.TraceWriter; - } - - internal BidirectionalDictionary DefaultReferenceMappings - { - get - { - // override equality comparer for object key dictionary - // object will be modified as it deserializes and might have mutable hashcode - if (_mappings == null) - { - _mappings = new BidirectionalDictionary( - EqualityComparer.Default, - new ReferenceEqualsEqualityComparer(), - "A different value already has the Id '{0}'.", - "A different Id has already been assigned for value '{0}'. This error may be caused by an object being reused multiple times during deserialization and can be fixed with the setting ObjectCreationHandling.Replace."); - } - - return _mappings; - } - } - - protected NullValueHandling ResolvedNullValueHandling(JsonObjectContract? containerContract, JsonProperty property) - { - NullValueHandling resolvedNullValueHandling = - property.NullValueHandling - ?? containerContract?.ItemNullValueHandling - ?? Serializer._nullValueHandling; - - return resolvedNullValueHandling; - } - - private ErrorContext GetErrorContext(object? currentObject, object? member, string path, Exception error) - { - if (_currentErrorContext == null) - { - _currentErrorContext = new ErrorContext(currentObject, member, path, error); - } - - if (_currentErrorContext.Error != error) - { - throw new InvalidOperationException("Current error context error is different to requested error."); - } - - return _currentErrorContext; - } - - protected void ClearErrorContext() - { - if (_currentErrorContext == null) - { - throw new InvalidOperationException("Could not clear error context. Error context is already null."); - } - - _currentErrorContext = null; - } - - protected bool IsErrorHandled(object? currentObject, JsonContract? contract, object? keyValue, IJsonLineInfo? lineInfo, string path, Exception ex) - { - ErrorContext errorContext = GetErrorContext(currentObject, keyValue, path, ex); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Error && !errorContext.Traced) - { - // only write error once - errorContext.Traced = true; - - // kind of a hack but meh. might clean this up later - string message = (GetType() == typeof(JsonSerializerInternalWriter)) ? "Error serializing" : "Error deserializing"; - if (contract != null) - { - message += " " + contract.UnderlyingType; - } - message += ". " + ex.Message; - - // add line information to non-json.net exception message - if (!(ex is JsonException)) - { - message = JsonPosition.FormatMessage(lineInfo, path, message); - } - - TraceWriter.Trace(TraceLevel.Error, message, ex); - } - - // attribute method is non-static so don't invoke if no object - if (contract != null && currentObject != null) - { - contract.InvokeOnError(currentObject, Serializer.Context, errorContext); - } - - if (!errorContext.Handled) - { - Serializer.OnError(new ErrorEventArgs(currentObject, errorContext)); - } - - return errorContext.Handled; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerInternalReader.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerInternalReader.cs deleted file mode 100644 index df77f51..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerInternalReader.cs +++ /dev/null @@ -1,2637 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using System.Collections.ObjectModel; -#if HAVE_DYNAMIC -using System.ComponentModel; -using System.Dynamic; -#endif -using System.Diagnostics; -using System.Globalization; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using System.Reflection; -using System.Runtime.Serialization; -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Utilities; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif - -namespace Newtonsoft.Json.Serialization -{ - internal class JsonSerializerInternalReader : JsonSerializerInternalBase - { - internal enum PropertyPresence - { - None = 0, - Null = 1, - Value = 2 - } - - public JsonSerializerInternalReader(JsonSerializer serializer) - : base(serializer) - { - } - - public void Populate(JsonReader reader, object target) - { - ValidationUtils.ArgumentNotNull(target, nameof(target)); - - Type objectType = target.GetType(); - - JsonContract contract = Serializer._contractResolver.ResolveContract(objectType); - - if (!reader.MoveToContent()) - { - throw JsonSerializationException.Create(reader, "No JSON content found."); - } - - if (reader.TokenType == JsonToken.StartArray) - { - if (contract.ContractType == JsonContractType.Array) - { - JsonArrayContract arrayContract = (JsonArrayContract)contract; - - PopulateList((arrayContract.ShouldCreateWrapper) ? arrayContract.CreateWrapper(target) : (IList)target, reader, arrayContract, null, null); - } - else - { - throw JsonSerializationException.Create(reader, "Cannot populate JSON array onto type '{0}'.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - } - else if (reader.TokenType == JsonToken.StartObject) - { - reader.ReadAndAssert(); - - string? id = null; - if (Serializer.MetadataPropertyHandling != MetadataPropertyHandling.Ignore - && reader.TokenType == JsonToken.PropertyName - && string.Equals(reader.Value!.ToString(), JsonTypeReflector.IdPropertyName, StringComparison.Ordinal)) - { - reader.ReadAndAssert(); - id = reader.Value?.ToString(); - reader.ReadAndAssert(); - } - - if (contract.ContractType == JsonContractType.Dictionary) - { - JsonDictionaryContract dictionaryContract = (JsonDictionaryContract)contract; - PopulateDictionary((dictionaryContract.ShouldCreateWrapper) ? dictionaryContract.CreateWrapper(target) : (IDictionary)target, reader, dictionaryContract, null, id); - } - else if (contract.ContractType == JsonContractType.Object) - { - PopulateObject(target, reader, (JsonObjectContract)contract, null, id); - } - else - { - throw JsonSerializationException.Create(reader, "Cannot populate JSON object onto type '{0}'.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - } - else - { - throw JsonSerializationException.Create(reader, "Unexpected initial token '{0}' when populating object. Expected JSON object or array.".FormatWith(CultureInfo.InvariantCulture, reader.TokenType)); - } - } - - private JsonContract? GetContractSafe(Type? type) - { - if (type == null) - { - return null; - } - - return GetContract(type); - } - - private JsonContract GetContract(Type type) - { - return Serializer._contractResolver.ResolveContract(type); - } - - public object? Deserialize(JsonReader reader, Type? objectType, bool checkAdditionalContent) - { - if (reader == null) - { - throw new ArgumentNullException(nameof(reader)); - } - - JsonContract? contract = GetContractSafe(objectType); - - try - { - JsonConverter? converter = GetConverter(contract, null, null, null); - - if (reader.TokenType == JsonToken.None && !reader.ReadForType(contract, converter != null)) - { - if (contract != null && !contract.IsNullable) - { - throw JsonSerializationException.Create(reader, "No JSON content found and type '{0}' is not nullable.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - return null; - } - - object? deserializedValue; - - if (converter != null && converter.CanRead) - { - deserializedValue = DeserializeConvertable(converter, reader, objectType!, null); - } - else - { - deserializedValue = CreateValueInternal(reader, objectType, contract, null, null, null, null); - } - - if (checkAdditionalContent) - { - while (reader.Read()) - { - if (reader.TokenType != JsonToken.Comment) - { - throw JsonSerializationException.Create(reader, "Additional text found in JSON string after finishing deserializing object."); - } - } - } - - return deserializedValue; - } - catch (Exception ex) - { - if (IsErrorHandled(null, contract, null, reader as IJsonLineInfo, reader.Path, ex)) - { - HandleError(reader, false, 0); - return null; - } - else - { - // clear context in case serializer is being used inside a converter - // if the converter wraps the error then not clearing the context will cause this error: - // "Current error context error is different to requested error." - ClearErrorContext(); - throw; - } - } - } - - private JsonSerializerProxy GetInternalSerializer() - { - if (InternalSerializer == null) - { - InternalSerializer = new JsonSerializerProxy(this); - } - - return InternalSerializer; - } - - private JToken? CreateJToken(JsonReader reader, JsonContract? contract) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - - if (contract != null) - { - if (contract.UnderlyingType == typeof(JRaw)) - { - return JRaw.Create(reader); - } - if (reader.TokenType == JsonToken.Null - && !(contract.UnderlyingType == typeof(JValue) || contract.UnderlyingType == typeof(JToken))) - { - return null; - } - } - - JToken? token; - using (JTokenWriter writer = new JTokenWriter()) - { - writer.WriteToken(reader); - token = writer.Token; - } - - if (contract != null && token != null) - { - if (!contract.UnderlyingType.IsAssignableFrom(token.GetType())) - { - throw JsonSerializationException.Create(reader, "Deserialized JSON type '{0}' is not compatible with expected type '{1}'." - .FormatWith(CultureInfo.InvariantCulture, token.GetType().FullName, contract.UnderlyingType.FullName)); - } - } - - return token; - } - - private JToken CreateJObject(JsonReader reader) - { - ValidationUtils.ArgumentNotNull(reader, nameof(reader)); - - // this is needed because we've already read inside the object, looking for metadata properties - using (JTokenWriter writer = new JTokenWriter()) - { - writer.WriteStartObject(); - - do - { - if (reader.TokenType == JsonToken.PropertyName) - { - string propertyName = (string)reader.Value!; - if (!reader.ReadAndMoveToContent()) - { - break; - } - - if (CheckPropertyName(reader, propertyName)) - { - continue; - } - - writer.WritePropertyName(propertyName); - writer.WriteToken(reader, true, true, false); - } - else if (reader.TokenType == JsonToken.Comment) - { - // eat - } - else - { - writer.WriteEndObject(); - return writer.Token!; - } - } while (reader.Read()); - - throw JsonSerializationException.Create(reader, "Unexpected end when deserializing object."); - } - } - - private object? CreateValueInternal(JsonReader reader, Type? objectType, JsonContract? contract, JsonProperty? member, JsonContainerContract? containerContract, JsonProperty? containerMember, object? existingValue) - { - if (contract != null && contract.ContractType == JsonContractType.Linq) - { - return CreateJToken(reader, contract); - } - - do - { - switch (reader.TokenType) - { - // populate a typed object or generic dictionary/array - // depending upon whether an objectType was supplied - case JsonToken.StartObject: - return CreateObject(reader, objectType, contract, member, containerContract, containerMember, existingValue); - case JsonToken.StartArray: - return CreateList(reader, objectType, contract, member, existingValue, null); - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.Boolean: - case JsonToken.Date: - case JsonToken.Bytes: - return EnsureType(reader, reader.Value, CultureInfo.InvariantCulture, contract, objectType); - case JsonToken.String: - string s = (string)reader.Value!; - - // string that needs to be returned as a byte array should be base 64 decoded - if (objectType == typeof(byte[])) - { - return Convert.FromBase64String(s); - } - - // convert empty string to null automatically for nullable types - if (CoerceEmptyStringToNull(objectType, contract, s)) - { - return null; - } - - return EnsureType(reader, s, CultureInfo.InvariantCulture, contract, objectType); - case JsonToken.StartConstructor: - string constructorName = reader.Value!.ToString(); - - return EnsureType(reader, constructorName, CultureInfo.InvariantCulture, contract, objectType); - case JsonToken.Null: - case JsonToken.Undefined: -#if HAVE_ADO_NET - if (objectType == typeof(DBNull)) - { - return DBNull.Value; - } -#endif - - return EnsureType(reader, reader.Value, CultureInfo.InvariantCulture, contract, objectType); - case JsonToken.Raw: - return new JRaw((string?)reader.Value); - case JsonToken.Comment: - // ignore - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected token while deserializing object: " + reader.TokenType); - } - } while (reader.Read()); - - throw JsonSerializationException.Create(reader, "Unexpected end when deserializing object."); - } - - private static bool CoerceEmptyStringToNull(Type? objectType, JsonContract? contract, string s) - { - return StringUtils.IsNullOrEmpty(s) && objectType != null && objectType != typeof(string) && objectType != typeof(object) && contract != null && contract.IsNullable; - } - - internal string GetExpectedDescription(JsonContract contract) - { - switch (contract.ContractType) - { - case JsonContractType.Object: - case JsonContractType.Dictionary: -#if HAVE_BINARY_SERIALIZATION - case JsonContractType.Serializable: -#endif -#if HAVE_DYNAMIC - case JsonContractType.Dynamic: -#endif - return @"JSON object (e.g. {""name"":""value""})"; - case JsonContractType.Array: - return @"JSON array (e.g. [1,2,3])"; - case JsonContractType.Primitive: - return @"JSON primitive value (e.g. string, number, boolean, null)"; - case JsonContractType.String: - return @"JSON string value"; - default: - throw new ArgumentOutOfRangeException(); - } - } - - private JsonConverter? GetConverter(JsonContract? contract, JsonConverter? memberConverter, JsonContainerContract? containerContract, JsonProperty? containerProperty) - { - JsonConverter? converter = null; - if (memberConverter != null) - { - // member attribute converter - converter = memberConverter; - } - else if (containerProperty?.ItemConverter != null) - { - converter = containerProperty.ItemConverter; - } - else if (containerContract?.ItemConverter != null) - { - converter = containerContract.ItemConverter; - } - else if (contract != null) - { - if (contract.Converter != null) - { - // class attribute converter - converter = contract.Converter; - } - else if (Serializer.GetMatchingConverter(contract.UnderlyingType) is JsonConverter matchingConverter) - { - // passed in converters - converter = matchingConverter; - } - else if (contract.InternalConverter != null) - { - // internally specified converter - converter = contract.InternalConverter; - } - } - return converter; - } - - private object? CreateObject(JsonReader reader, Type? objectType, JsonContract? contract, JsonProperty? member, JsonContainerContract? containerContract, JsonProperty? containerMember, object? existingValue) - { - string? id; - Type? resolvedObjectType = objectType; - - if (Serializer.MetadataPropertyHandling == MetadataPropertyHandling.Ignore) - { - // don't look for metadata properties - reader.ReadAndAssert(); - id = null; - } - else if (Serializer.MetadataPropertyHandling == MetadataPropertyHandling.ReadAhead) - { - if (!(reader is JTokenReader tokenReader)) - { - JToken t = JToken.ReadFrom(reader); - tokenReader = (JTokenReader)t.CreateReader(); - tokenReader.Culture = reader.Culture; - tokenReader.DateFormatString = reader.DateFormatString; - tokenReader.DateParseHandling = reader.DateParseHandling; - tokenReader.DateTimeZoneHandling = reader.DateTimeZoneHandling; - tokenReader.FloatParseHandling = reader.FloatParseHandling; - tokenReader.SupportMultipleContent = reader.SupportMultipleContent; - - // start - tokenReader.ReadAndAssert(); - - reader = tokenReader; - } - - if (ReadMetadataPropertiesToken(tokenReader, ref resolvedObjectType, ref contract, member, containerContract, containerMember, existingValue, out object? newValue, out id)) - { - return newValue; - } - } - else - { - reader.ReadAndAssert(); - if (ReadMetadataProperties(reader, ref resolvedObjectType, ref contract, member, containerContract, containerMember, existingValue, out object? newValue, out id)) - { - return newValue; - } - } - - if (HasNoDefinedType(contract)) - { - return CreateJObject(reader); - } - - MiscellaneousUtils.Assert(resolvedObjectType != null); - MiscellaneousUtils.Assert(contract != null); - - switch (contract.ContractType) - { - case JsonContractType.Object: - { - bool createdFromNonDefaultCreator = false; - JsonObjectContract objectContract = (JsonObjectContract)contract; - object targetObject; - // check that if type name handling is being used that the existing value is compatible with the specified type - if (existingValue != null && (resolvedObjectType == objectType || resolvedObjectType.IsAssignableFrom(existingValue.GetType()))) - { - targetObject = existingValue; - } - else - { - targetObject = CreateNewObject(reader, objectContract, member, containerMember, id, out createdFromNonDefaultCreator); - } - - // don't populate if read from non-default creator because the object has already been read - if (createdFromNonDefaultCreator) - { - return targetObject; - } - - return PopulateObject(targetObject, reader, objectContract, member, id); - } - case JsonContractType.Primitive: - { - JsonPrimitiveContract primitiveContract = (JsonPrimitiveContract)contract; - // if the content is inside $value then read past it - if (Serializer.MetadataPropertyHandling != MetadataPropertyHandling.Ignore - && reader.TokenType == JsonToken.PropertyName - && string.Equals(reader.Value!.ToString(), JsonTypeReflector.ValuePropertyName, StringComparison.Ordinal)) - { - reader.ReadAndAssert(); - - // the token should not be an object because the $type value could have been included in the object - // without needing the $value property - if (reader.TokenType == JsonToken.StartObject) - { - throw JsonSerializationException.Create(reader, "Unexpected token when deserializing primitive value: " + reader.TokenType); - } - - object? value = CreateValueInternal(reader, resolvedObjectType, primitiveContract, member, null, null, existingValue); - - reader.ReadAndAssert(); - return value; - } - break; - } - case JsonContractType.Dictionary: - { - JsonDictionaryContract dictionaryContract = (JsonDictionaryContract)contract; - object targetDictionary; - - if (existingValue == null) - { - IDictionary dictionary = CreateNewDictionary(reader, dictionaryContract, out bool createdFromNonDefaultCreator); - - if (createdFromNonDefaultCreator) - { - if (id != null) - { - throw JsonSerializationException.Create(reader, "Cannot preserve reference to readonly dictionary, or dictionary created from a non-default constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - if (contract.OnSerializingCallbacks.Count > 0) - { - throw JsonSerializationException.Create(reader, "Cannot call OnSerializing on readonly dictionary, or dictionary created from a non-default constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - if (contract.OnErrorCallbacks.Count > 0) - { - throw JsonSerializationException.Create(reader, "Cannot call OnError on readonly list, or dictionary created from a non-default constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - if (!dictionaryContract.HasParameterizedCreatorInternal) - { - throw JsonSerializationException.Create(reader, "Cannot deserialize readonly or fixed size dictionary: {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - } - - PopulateDictionary(dictionary, reader, dictionaryContract, member, id); - - if (createdFromNonDefaultCreator) - { - ObjectConstructor creator = (dictionaryContract.OverrideCreator ?? dictionaryContract.ParameterizedCreator)!; - - return creator(dictionary); - } - else if (dictionary is IWrappedDictionary wrappedDictionary) - { - return wrappedDictionary.UnderlyingDictionary; - } - - targetDictionary = dictionary; - } - else - { - targetDictionary = PopulateDictionary(dictionaryContract.ShouldCreateWrapper || !(existingValue is IDictionary) ? dictionaryContract.CreateWrapper(existingValue) : (IDictionary)existingValue, reader, dictionaryContract, member, id); - } - - return targetDictionary; - } -#if HAVE_DYNAMIC - case JsonContractType.Dynamic: - JsonDynamicContract dynamicContract = (JsonDynamicContract)contract; - return CreateDynamic(reader, dynamicContract, member, id); -#endif -#if HAVE_BINARY_SERIALIZATION - case JsonContractType.Serializable: - JsonISerializableContract serializableContract = (JsonISerializableContract)contract; - return CreateISerializable(reader, serializableContract, member, id); -#endif - } - - string message = @"Cannot deserialize the current JSON object (e.g. {{""name"":""value""}}) into type '{0}' because the type requires a {1} to deserialize correctly." + Environment.NewLine + - @"To fix this error either change the JSON to a {1} or change the deserialized type so that it is a normal .NET type (e.g. not a primitive type like integer, not a collection type like an array or List) that can be deserialized from a JSON object. JsonObjectAttribute can also be added to the type to force it to deserialize from a JSON object." + Environment.NewLine; - message = message.FormatWith(CultureInfo.InvariantCulture, resolvedObjectType, GetExpectedDescription(contract)); - - throw JsonSerializationException.Create(reader, message); - } - - private bool ReadMetadataPropertiesToken(JTokenReader reader, ref Type? objectType, ref JsonContract? contract, JsonProperty? member, JsonContainerContract? containerContract, JsonProperty? containerMember, object? existingValue, out object? newValue, out string? id) - { - id = null; - newValue = null; - - if (reader.TokenType == JsonToken.StartObject) - { - JObject current = (JObject)reader.CurrentToken!; - - JProperty? refProperty = current.Property(JsonTypeReflector.RefPropertyName, StringComparison.Ordinal); - if (refProperty != null) - { - JToken refToken = refProperty.Value; - if (refToken.Type != JTokenType.String && refToken.Type != JTokenType.Null) - { - throw JsonSerializationException.Create(refToken, refToken.Path, "JSON reference {0} property must have a string or null value.".FormatWith(CultureInfo.InvariantCulture, JsonTypeReflector.RefPropertyName), null); - } - - string? reference = (string?)refProperty; - - if (reference != null) - { - JToken? additionalContent = refProperty.Next ?? refProperty.Previous; - if (additionalContent != null) - { - throw JsonSerializationException.Create(additionalContent, additionalContent.Path, "Additional content found in JSON reference object. A JSON reference object should only have a {0} property.".FormatWith(CultureInfo.InvariantCulture, JsonTypeReflector.RefPropertyName), null); - } - - newValue = Serializer.GetReferenceResolver().ResolveReference(this, reference); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(reader, reader.Path, "Resolved object reference '{0}' to {1}.".FormatWith(CultureInfo.InvariantCulture, reference, newValue.GetType())), null); - } - - reader.Skip(); - return true; - } - } - JToken? typeToken = current[JsonTypeReflector.TypePropertyName]; - if (typeToken != null) - { - string? qualifiedTypeName = (string?)typeToken; - JsonReader typeTokenReader = typeToken.CreateReader(); - typeTokenReader.ReadAndAssert(); - ResolveTypeName(typeTokenReader, ref objectType, ref contract, member, containerContract, containerMember, qualifiedTypeName!); - - JToken? valueToken = current[JsonTypeReflector.ValuePropertyName]; - if (valueToken != null) - { - while (true) - { - reader.ReadAndAssert(); - if (reader.TokenType == JsonToken.PropertyName) - { - if ((string)reader.Value! == JsonTypeReflector.ValuePropertyName) - { - return false; - } - } - - reader.ReadAndAssert(); - reader.Skip(); - } - } - } - JToken? idToken = current[JsonTypeReflector.IdPropertyName]; - if (idToken != null) - { - id = (string?)idToken; - } - JToken? valuesToken = current[JsonTypeReflector.ArrayValuesPropertyName]; - if (valuesToken != null) - { - JsonReader listReader = valuesToken.CreateReader(); - listReader.ReadAndAssert(); - newValue = CreateList(listReader, objectType, contract, member, existingValue, id); - - reader.Skip(); - return true; - } - } - - reader.ReadAndAssert(); - return false; - } - - private bool ReadMetadataProperties(JsonReader reader, ref Type? objectType, ref JsonContract? contract, JsonProperty? member, JsonContainerContract? containerContract, JsonProperty? containerMember, object? existingValue, out object? newValue, out string? id) - { - id = null; - newValue = null; - - if (reader.TokenType == JsonToken.PropertyName) - { - string propertyName = reader.Value!.ToString(); - - if (propertyName.Length > 0 && propertyName[0] == '$') - { - // read metadata properties - // $type, $id, $ref, etc - bool metadataProperty; - - do - { - propertyName = reader.Value!.ToString(); - - if (string.Equals(propertyName, JsonTypeReflector.RefPropertyName, StringComparison.Ordinal)) - { - reader.ReadAndAssert(); - if (reader.TokenType != JsonToken.String && reader.TokenType != JsonToken.Null) - { - throw JsonSerializationException.Create(reader, "JSON reference {0} property must have a string or null value.".FormatWith(CultureInfo.InvariantCulture, JsonTypeReflector.RefPropertyName)); - } - - string? reference = reader.Value?.ToString(); - - reader.ReadAndAssert(); - - if (reference != null) - { - if (reader.TokenType == JsonToken.PropertyName) - { - throw JsonSerializationException.Create(reader, "Additional content found in JSON reference object. A JSON reference object should only have a {0} property.".FormatWith(CultureInfo.InvariantCulture, JsonTypeReflector.RefPropertyName)); - } - - newValue = Serializer.GetReferenceResolver().ResolveReference(this, reference); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Resolved object reference '{0}' to {1}.".FormatWith(CultureInfo.InvariantCulture, reference, newValue!.GetType())), null); - } - - return true; - } - else - { - metadataProperty = true; - } - } - else if (string.Equals(propertyName, JsonTypeReflector.TypePropertyName, StringComparison.Ordinal)) - { - reader.ReadAndAssert(); - string qualifiedTypeName = reader.Value!.ToString(); - - ResolveTypeName(reader, ref objectType, ref contract, member, containerContract, containerMember, qualifiedTypeName); - - reader.ReadAndAssert(); - - metadataProperty = true; - } - else if (string.Equals(propertyName, JsonTypeReflector.IdPropertyName, StringComparison.Ordinal)) - { - reader.ReadAndAssert(); - - id = reader.Value?.ToString(); - - reader.ReadAndAssert(); - metadataProperty = true; - } - else if (string.Equals(propertyName, JsonTypeReflector.ArrayValuesPropertyName, StringComparison.Ordinal)) - { - reader.ReadAndAssert(); - object? list = CreateList(reader, objectType, contract, member, existingValue, id); - reader.ReadAndAssert(); - newValue = list; - return true; - } - else - { - metadataProperty = false; - } - } while (metadataProperty && reader.TokenType == JsonToken.PropertyName); - } - } - return false; - } - - private void ResolveTypeName(JsonReader reader, ref Type? objectType, ref JsonContract? contract, JsonProperty? member, JsonContainerContract? containerContract, JsonProperty? containerMember, string qualifiedTypeName) - { - TypeNameHandling resolvedTypeNameHandling = - member?.TypeNameHandling - ?? containerContract?.ItemTypeNameHandling - ?? containerMember?.ItemTypeNameHandling - ?? Serializer._typeNameHandling; - - if (resolvedTypeNameHandling != TypeNameHandling.None) - { - StructMultiKey typeNameKey = ReflectionUtils.SplitFullyQualifiedTypeName(qualifiedTypeName); - - Type specifiedType; - try - { - specifiedType = Serializer._serializationBinder.BindToType(typeNameKey.Value1, typeNameKey.Value2); - } - catch (Exception ex) - { - throw JsonSerializationException.Create(reader, "Error resolving type specified in JSON '{0}'.".FormatWith(CultureInfo.InvariantCulture, qualifiedTypeName), ex); - } - - if (specifiedType == null) - { - throw JsonSerializationException.Create(reader, "Type specified in JSON '{0}' was not resolved.".FormatWith(CultureInfo.InvariantCulture, qualifiedTypeName)); - } - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Resolved type '{0}' to {1}.".FormatWith(CultureInfo.InvariantCulture, qualifiedTypeName, specifiedType)), null); - } - - if (objectType != null -#if HAVE_DYNAMIC - && objectType != typeof(IDynamicMetaObjectProvider) -#endif - && !objectType.IsAssignableFrom(specifiedType)) - { - throw JsonSerializationException.Create(reader, "Type specified in JSON '{0}' is not compatible with '{1}'.".FormatWith(CultureInfo.InvariantCulture, specifiedType.AssemblyQualifiedName, objectType.AssemblyQualifiedName)); - } - - objectType = specifiedType; - contract = GetContract(specifiedType); - } - } - - private JsonArrayContract EnsureArrayContract(JsonReader reader, Type objectType, JsonContract contract) - { - if (contract == null) - { - throw JsonSerializationException.Create(reader, "Could not resolve type '{0}' to a JsonContract.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - - if (!(contract is JsonArrayContract arrayContract)) - { - string message = @"Cannot deserialize the current JSON array (e.g. [1,2,3]) into type '{0}' because the type requires a {1} to deserialize correctly." + Environment.NewLine + - @"To fix this error either change the JSON to a {1} or change the deserialized type to an array or a type that implements a collection interface (e.g. ICollection, IList) like List that can be deserialized from a JSON array. JsonArrayAttribute can also be added to the type to force it to deserialize from a JSON array." + Environment.NewLine; - message = message.FormatWith(CultureInfo.InvariantCulture, objectType, GetExpectedDescription(contract)); - - throw JsonSerializationException.Create(reader, message); - } - - return arrayContract; - } - - private object? CreateList(JsonReader reader, Type? objectType, JsonContract? contract, JsonProperty? member, object? existingValue, string? id) - { - object? value; - - if (HasNoDefinedType(contract)) - { - return CreateJToken(reader, contract); - } - - MiscellaneousUtils.Assert(objectType != null); - MiscellaneousUtils.Assert(contract != null); - - JsonArrayContract arrayContract = EnsureArrayContract(reader, objectType, contract); - - if (existingValue == null) - { - IList list = CreateNewList(reader, arrayContract, out bool createdFromNonDefaultCreator); - - if (createdFromNonDefaultCreator) - { - if (id != null) - { - throw JsonSerializationException.Create(reader, "Cannot preserve reference to array or readonly list, or list created from a non-default constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - if (contract.OnSerializingCallbacks.Count > 0) - { - throw JsonSerializationException.Create(reader, "Cannot call OnSerializing on an array or readonly list, or list created from a non-default constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - if (contract.OnErrorCallbacks.Count > 0) - { - throw JsonSerializationException.Create(reader, "Cannot call OnError on an array or readonly list, or list created from a non-default constructor: {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - if (!arrayContract.HasParameterizedCreatorInternal && !arrayContract.IsArray) - { - throw JsonSerializationException.Create(reader, "Cannot deserialize readonly or fixed size list: {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - } - - if (!arrayContract.IsMultidimensionalArray) - { - PopulateList(list, reader, arrayContract, member, id); - } - else - { - PopulateMultidimensionalArray(list, reader, arrayContract, member, id); - } - - if (createdFromNonDefaultCreator) - { - if (arrayContract.IsMultidimensionalArray) - { - list = CollectionUtils.ToMultidimensionalArray(list, arrayContract.CollectionItemType!, contract.CreatedType.GetArrayRank()); - } - else if (arrayContract.IsArray) - { - Array a = Array.CreateInstance(arrayContract.CollectionItemType, list.Count); - list.CopyTo(a, 0); - list = a; - } - else - { - ObjectConstructor creator = (arrayContract.OverrideCreator ?? arrayContract.ParameterizedCreator)!; - - return creator(list); - } - } - else if (list is IWrappedCollection wrappedCollection) - { - return wrappedCollection.UnderlyingCollection; - } - - value = list; - } - else - { - if (!arrayContract.CanDeserialize) - { - throw JsonSerializationException.Create(reader, "Cannot populate list type {0}.".FormatWith(CultureInfo.InvariantCulture, contract.CreatedType)); - } - - value = PopulateList((arrayContract.ShouldCreateWrapper || !(existingValue is IList list)) ? arrayContract.CreateWrapper(existingValue) : list, reader, arrayContract, member, id); - } - - return value; - } - - private bool HasNoDefinedType(JsonContract? contract) - { - return (contract == null || contract.UnderlyingType == typeof(object) || contract.ContractType == JsonContractType.Linq -#if HAVE_DYNAMIC - || contract.UnderlyingType == typeof(IDynamicMetaObjectProvider) -#endif - ); - } - - private object? EnsureType(JsonReader reader, object? value, CultureInfo culture, JsonContract? contract, Type? targetType) - { - if (targetType == null) - { - return value; - } - - MiscellaneousUtils.Assert(contract != null); - Type? valueType = ReflectionUtils.GetObjectType(value); - - // type of value and type of target don't match - // attempt to convert value's type to target's type - if (valueType != targetType) - { - if (value == null && contract.IsNullable) - { - return null; - } - - try - { - if (contract.IsConvertable) - { - JsonPrimitiveContract primitiveContract = (JsonPrimitiveContract)contract; - - if (contract.IsEnum) - { - if (value is string s) - { - return EnumUtils.ParseEnum( - contract.NonNullableUnderlyingType, - null, - s, - false); - } - if (ConvertUtils.IsInteger(primitiveContract.TypeCode)) - { - return Enum.ToObject(contract.NonNullableUnderlyingType, value); - } - } - else if (contract.NonNullableUnderlyingType == typeof(DateTime)) - { - // use DateTimeUtils because Convert.ChangeType does not set DateTime.Kind correctly - if (value is string s && DateTimeUtils.TryParseDateTime(s, reader.DateTimeZoneHandling, reader.DateFormatString, reader.Culture, out DateTime dt)) - { - return DateTimeUtils.EnsureDateTime(dt, reader.DateTimeZoneHandling); - } - } - -#if HAVE_BIG_INTEGER - if (value is BigInteger integer) - { - return ConvertUtils.FromBigInteger(integer, contract.NonNullableUnderlyingType); - } -#endif - - // this won't work when converting to a custom IConvertible - return Convert.ChangeType(value, contract.NonNullableUnderlyingType, culture); - } - - return ConvertUtils.ConvertOrCast(value, culture, contract.NonNullableUnderlyingType); - } - catch (Exception ex) - { - throw JsonSerializationException.Create(reader, "Error converting value {0} to type '{1}'.".FormatWith(CultureInfo.InvariantCulture, MiscellaneousUtils.ToString(value), targetType), ex); - } - } - - return value; - } - - private bool SetPropertyValue(JsonProperty property, JsonConverter? propertyConverter, JsonContainerContract? containerContract, JsonProperty? containerProperty, JsonReader reader, object target) - { - bool skipSettingProperty = CalculatePropertyDetails( - property, - ref propertyConverter, - containerContract, - containerProperty, - reader, - target, - out bool useExistingValue, - out object? currentValue, - out JsonContract? propertyContract, - out bool gottenCurrentValue, - out bool ignoredValue); - - if (skipSettingProperty) - { - // Don't set extension data if the value was ignored - // e.g. a null with NullValueHandling should not go in ExtensionData - if (ignoredValue) - { - return true; - } - - return false; - } - - object? value; - - if (propertyConverter != null && propertyConverter.CanRead) - { - if (!gottenCurrentValue && property.Readable) - { - currentValue = property.ValueProvider!.GetValue(target); - } - - value = DeserializeConvertable(propertyConverter, reader, property.PropertyType!, currentValue); - } - else - { - value = CreateValueInternal(reader, property.PropertyType, propertyContract, property, containerContract, containerProperty, (useExistingValue) ? currentValue : null); - } - - // always set the value if useExistingValue is false, - // otherwise also set it if CreateValue returns a new value compared to the currentValue - // this could happen because of a JsonConverter against the type - if ((!useExistingValue || value != currentValue) - && ShouldSetPropertyValue(property, containerContract as JsonObjectContract, value)) - { - property.ValueProvider!.SetValue(target, value); - - if (property.SetIsSpecified != null) - { - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "IsSpecified for property '{0}' on {1} set to true.".FormatWith(CultureInfo.InvariantCulture, property.PropertyName, property.DeclaringType)), null); - } - - property.SetIsSpecified(target, true); - } - - return true; - } - - // the value wasn't set be JSON was populated onto the existing value - return useExistingValue; - } - - private bool CalculatePropertyDetails( - JsonProperty property, - ref JsonConverter? propertyConverter, - JsonContainerContract? containerContract, - JsonProperty? containerProperty, - JsonReader reader, - object target, - out bool useExistingValue, - out object? currentValue, - out JsonContract? propertyContract, - out bool gottenCurrentValue, - out bool ignoredValue) - { - currentValue = null; - useExistingValue = false; - propertyContract = null; - gottenCurrentValue = false; - ignoredValue = false; - - if (property.Ignored) - { - return true; - } - - JsonToken tokenType = reader.TokenType; - - if (property.PropertyContract == null) - { - property.PropertyContract = GetContractSafe(property.PropertyType); - } - - ObjectCreationHandling objectCreationHandling = - property.ObjectCreationHandling.GetValueOrDefault(Serializer._objectCreationHandling); - - if ((objectCreationHandling != ObjectCreationHandling.Replace) - && (tokenType == JsonToken.StartArray || tokenType == JsonToken.StartObject || propertyConverter != null) - && property.Readable - && property.PropertyContract?.ContractType != JsonContractType.Linq) - { - currentValue = property.ValueProvider!.GetValue(target); - gottenCurrentValue = true; - - if (currentValue != null) - { - propertyContract = GetContract(currentValue.GetType()); - - useExistingValue = (!propertyContract.IsReadOnlyOrFixedSize && !propertyContract.UnderlyingType.IsValueType()); - } - } - - if (!property.Writable && !useExistingValue) - { - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Unable to deserialize value to non-writable property '{0}' on {1}.".FormatWith(CultureInfo.InvariantCulture, property.PropertyName, property.DeclaringType)), null); - } - - return true; - } - - // test tokenType here because null might not be convertible to some types, e.g. ignoring null when applied to DateTime - if (tokenType == JsonToken.Null && ResolvedNullValueHandling(containerContract as JsonObjectContract, property) == NullValueHandling.Ignore) - { - ignoredValue = true; - return true; - } - - // test tokenType here because default value might not be convertible to actual type, e.g. default of "" for DateTime - if (HasFlag(property.DefaultValueHandling.GetValueOrDefault(Serializer._defaultValueHandling), DefaultValueHandling.Ignore) - && !HasFlag(property.DefaultValueHandling.GetValueOrDefault(Serializer._defaultValueHandling), DefaultValueHandling.Populate) - && JsonTokenUtils.IsPrimitiveToken(tokenType) - && MiscellaneousUtils.ValueEquals(reader.Value, property.GetResolvedDefaultValue())) - { - ignoredValue = true; - return true; - } - - if (currentValue == null) - { - propertyContract = property.PropertyContract; - } - else - { - propertyContract = GetContract(currentValue.GetType()); - - if (propertyContract != property.PropertyContract) - { - propertyConverter = GetConverter(propertyContract, property.Converter, containerContract, containerProperty); - } - } - - return false; - } - - private void AddReference(JsonReader reader, string id, object value) - { - try - { - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Read object reference Id '{0}' for {1}.".FormatWith(CultureInfo.InvariantCulture, id, value.GetType())), null); - } - - Serializer.GetReferenceResolver().AddReference(this, id, value); - } - catch (Exception ex) - { - throw JsonSerializationException.Create(reader, "Error reading object reference '{0}'.".FormatWith(CultureInfo.InvariantCulture, id), ex); - } - } - - private bool HasFlag(DefaultValueHandling value, DefaultValueHandling flag) - { - return ((value & flag) == flag); - } - - private bool ShouldSetPropertyValue(JsonProperty property, JsonObjectContract? contract, object? value) - { - if (value == null && ResolvedNullValueHandling(contract, property) == NullValueHandling.Ignore) - { - return false; - } - - if (HasFlag(property.DefaultValueHandling.GetValueOrDefault(Serializer._defaultValueHandling), DefaultValueHandling.Ignore) - && !HasFlag(property.DefaultValueHandling.GetValueOrDefault(Serializer._defaultValueHandling), DefaultValueHandling.Populate) - && MiscellaneousUtils.ValueEquals(value, property.GetResolvedDefaultValue())) - { - return false; - } - - if (!property.Writable) - { - return false; - } - - return true; - } - - private IList CreateNewList(JsonReader reader, JsonArrayContract contract, out bool createdFromNonDefaultCreator) - { - // some types like non-generic IEnumerable can be serialized but not deserialized - if (!contract.CanDeserialize) - { - throw JsonSerializationException.Create(reader, "Cannot create and populate list type {0}.".FormatWith(CultureInfo.InvariantCulture, contract.CreatedType)); - } - - if (contract.OverrideCreator != null) - { - if (contract.HasParameterizedCreator) - { - createdFromNonDefaultCreator = true; - return contract.CreateTemporaryCollection(); - } - else - { - object list = contract.OverrideCreator(); - - if (contract.ShouldCreateWrapper) - { - list = contract.CreateWrapper(list); - } - - createdFromNonDefaultCreator = false; - return (IList)list; - } - } - else if (contract.IsReadOnlyOrFixedSize) - { - createdFromNonDefaultCreator = true; - IList list = contract.CreateTemporaryCollection(); - - if (contract.ShouldCreateWrapper) - { - list = contract.CreateWrapper(list); - } - - return list; - } - else if (contract.DefaultCreator != null && (!contract.DefaultCreatorNonPublic || Serializer._constructorHandling == ConstructorHandling.AllowNonPublicDefaultConstructor)) - { - object list = contract.DefaultCreator(); - - if (contract.ShouldCreateWrapper) - { - list = contract.CreateWrapper(list); - } - - createdFromNonDefaultCreator = false; - return (IList)list; - } - else if (contract.HasParameterizedCreatorInternal) - { - createdFromNonDefaultCreator = true; - return contract.CreateTemporaryCollection(); - } - else - { - if (!contract.IsInstantiable) - { - throw JsonSerializationException.Create(reader, "Could not create an instance of type {0}. Type is an interface or abstract class and cannot be instantiated.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - throw JsonSerializationException.Create(reader, "Unable to find a constructor to use for type {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - } - - private IDictionary CreateNewDictionary(JsonReader reader, JsonDictionaryContract contract, out bool createdFromNonDefaultCreator) - { - if (contract.OverrideCreator != null) - { - if (contract.HasParameterizedCreator) - { - createdFromNonDefaultCreator = true; - return contract.CreateTemporaryDictionary(); - } - else - { - createdFromNonDefaultCreator = false; - return (IDictionary)contract.OverrideCreator(); - } - } - else if (contract.IsReadOnlyOrFixedSize) - { - createdFromNonDefaultCreator = true; - return contract.CreateTemporaryDictionary(); - } - else if (contract.DefaultCreator != null && (!contract.DefaultCreatorNonPublic || Serializer._constructorHandling == ConstructorHandling.AllowNonPublicDefaultConstructor)) - { - object dictionary = contract.DefaultCreator(); - - if (contract.ShouldCreateWrapper) - { - dictionary = contract.CreateWrapper(dictionary); - } - - createdFromNonDefaultCreator = false; - return (IDictionary)dictionary; - } - else if (contract.HasParameterizedCreatorInternal) - { - createdFromNonDefaultCreator = true; - return contract.CreateTemporaryDictionary(); - } - else - { - if (!contract.IsInstantiable) - { - throw JsonSerializationException.Create(reader, "Could not create an instance of type {0}. Type is an interface or abstract class and cannot be instantiated.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - throw JsonSerializationException.Create(reader, "Unable to find a default constructor to use for type {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - } - - private void OnDeserializing(JsonReader reader, JsonContract contract, object value) - { - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Started deserializing {0}".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)), null); - } - - contract.InvokeOnDeserializing(value, Serializer._context); - } - - private void OnDeserialized(JsonReader reader, JsonContract contract, object value) - { - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Finished deserializing {0}".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)), null); - } - - contract.InvokeOnDeserialized(value, Serializer._context); - } - - private object PopulateDictionary(IDictionary dictionary, JsonReader reader, JsonDictionaryContract contract, JsonProperty? containerProperty, string? id) - { - object underlyingDictionary = dictionary is IWrappedDictionary wrappedDictionary ? wrappedDictionary.UnderlyingDictionary : dictionary; - - if (id != null) - { - AddReference(reader, id, underlyingDictionary); - } - - OnDeserializing(reader, contract, underlyingDictionary); - - int initialDepth = reader.Depth; - - if (contract.KeyContract == null) - { - contract.KeyContract = GetContractSafe(contract.DictionaryKeyType); - } - - if (contract.ItemContract == null) - { - contract.ItemContract = GetContractSafe(contract.DictionaryValueType); - } - - JsonConverter? dictionaryValueConverter = contract.ItemConverter ?? GetConverter(contract.ItemContract, null, contract, containerProperty); - PrimitiveTypeCode keyTypeCode = (contract.KeyContract is JsonPrimitiveContract keyContract) ? keyContract.TypeCode : PrimitiveTypeCode.Empty; - - bool finished = false; - do - { - switch (reader.TokenType) - { - case JsonToken.PropertyName: - object keyValue = reader.Value!; - if (CheckPropertyName(reader, keyValue.ToString())) - { - continue; - } - - try - { - try - { - // this is for correctly reading ISO and MS formatted dictionary keys - switch (keyTypeCode) - { - case PrimitiveTypeCode.DateTime: - case PrimitiveTypeCode.DateTimeNullable: - { - keyValue = DateTimeUtils.TryParseDateTime(keyValue.ToString(), reader.DateTimeZoneHandling, reader.DateFormatString, reader.Culture, out DateTime dt) - ? dt - : EnsureType(reader, keyValue, CultureInfo.InvariantCulture, contract.KeyContract, contract.DictionaryKeyType)!; - break; - } -#if HAVE_DATE_TIME_OFFSET - case PrimitiveTypeCode.DateTimeOffset: - case PrimitiveTypeCode.DateTimeOffsetNullable: - { - keyValue = DateTimeUtils.TryParseDateTimeOffset(keyValue.ToString(), reader.DateFormatString, reader.Culture, out DateTimeOffset dt) - ? dt - : EnsureType(reader, keyValue, CultureInfo.InvariantCulture, contract.KeyContract, contract.DictionaryKeyType)!; - break; - } -#endif - default: - keyValue = contract.KeyContract != null && contract.KeyContract.IsEnum - ? EnumUtils.ParseEnum(contract.KeyContract.NonNullableUnderlyingType, (Serializer._contractResolver as DefaultContractResolver)?.NamingStrategy, keyValue.ToString(), false) - : EnsureType(reader, keyValue, CultureInfo.InvariantCulture, contract.KeyContract, contract.DictionaryKeyType)!; - break; - } - } - catch (Exception ex) - { - throw JsonSerializationException.Create(reader, "Could not convert string '{0}' to dictionary key type '{1}'. Create a TypeConverter to convert from the string to the key type object.".FormatWith(CultureInfo.InvariantCulture, reader.Value, contract.DictionaryKeyType), ex); - } - - if (!reader.ReadForType(contract.ItemContract, dictionaryValueConverter != null)) - { - throw JsonSerializationException.Create(reader, "Unexpected end when deserializing object."); - } - - object? itemValue; - if (dictionaryValueConverter != null && dictionaryValueConverter.CanRead) - { - itemValue = DeserializeConvertable(dictionaryValueConverter, reader, contract.DictionaryValueType!, null); - } - else - { - itemValue = CreateValueInternal(reader, contract.DictionaryValueType, contract.ItemContract, null, contract, containerProperty, null); - } - - dictionary[keyValue] = itemValue; - } - catch (Exception ex) - { - if (IsErrorHandled(underlyingDictionary, contract, keyValue, reader as IJsonLineInfo, reader.Path, ex)) - { - HandleError(reader, true, initialDepth); - } - else - { - throw; - } - } - break; - case JsonToken.Comment: - break; - case JsonToken.EndObject: - finished = true; - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected token when deserializing object: " + reader.TokenType); - } - } while (!finished && reader.Read()); - - if (!finished) - { - ThrowUnexpectedEndException(reader, contract, underlyingDictionary, "Unexpected end when deserializing object."); - } - - OnDeserialized(reader, contract, underlyingDictionary); - return underlyingDictionary; - } - - private object PopulateMultidimensionalArray(IList list, JsonReader reader, JsonArrayContract contract, JsonProperty? containerProperty, string? id) - { - int rank = contract.UnderlyingType.GetArrayRank(); - - if (id != null) - { - AddReference(reader, id, list); - } - - OnDeserializing(reader, contract, list); - - JsonContract? collectionItemContract = GetContractSafe(contract.CollectionItemType); - JsonConverter? collectionItemConverter = GetConverter(collectionItemContract, null, contract, containerProperty); - - int? previousErrorIndex = null; - Stack listStack = new Stack(); - listStack.Push(list); - IList currentList = list; - - bool finished = false; - do - { - int initialDepth = reader.Depth; - - if (listStack.Count == rank) - { - try - { - if (reader.ReadForType(collectionItemContract, collectionItemConverter != null)) - { - switch (reader.TokenType) - { - case JsonToken.EndArray: - listStack.Pop(); - currentList = listStack.Peek(); - previousErrorIndex = null; - break; - case JsonToken.Comment: - break; - default: - object? value; - - if (collectionItemConverter != null && collectionItemConverter.CanRead) - { - value = DeserializeConvertable(collectionItemConverter, reader, contract.CollectionItemType!, null); - } - else - { - value = CreateValueInternal(reader, contract.CollectionItemType, collectionItemContract, null, contract, containerProperty, null); - } - - currentList.Add(value); - break; - } - } - else - { - break; - } - } - catch (Exception ex) - { - JsonPosition errorPosition = reader.GetPosition(initialDepth); - - if (IsErrorHandled(list, contract, errorPosition.Position, reader as IJsonLineInfo, reader.Path, ex)) - { - HandleError(reader, true, initialDepth + 1); - - if (previousErrorIndex != null && previousErrorIndex == errorPosition.Position) - { - // reader index has not moved since previous error handling - // break out of reading array to prevent infinite loop - throw JsonSerializationException.Create(reader, "Infinite loop detected from error handling.", ex); - } - else - { - previousErrorIndex = errorPosition.Position; - } - } - else - { - throw; - } - } - } - else - { - if (reader.Read()) - { - switch (reader.TokenType) - { - case JsonToken.StartArray: - IList newList = new List(); - currentList.Add(newList); - listStack.Push(newList); - currentList = newList; - break; - case JsonToken.EndArray: - listStack.Pop(); - - if (listStack.Count > 0) - { - currentList = listStack.Peek(); - } - else - { - finished = true; - } - break; - case JsonToken.Comment: - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected token when deserializing multidimensional array: " + reader.TokenType); - } - } - else - { - break; - } - } - } while (!finished); - - if (!finished) - { - ThrowUnexpectedEndException(reader, contract, list, "Unexpected end when deserializing array."); - } - - OnDeserialized(reader, contract, list); - return list; - } - - private void ThrowUnexpectedEndException(JsonReader reader, JsonContract contract, object? currentObject, string message) - { - try - { - throw JsonSerializationException.Create(reader, message); - } - catch (Exception ex) - { - if (IsErrorHandled(currentObject, contract, null, reader as IJsonLineInfo, reader.Path, ex)) - { - HandleError(reader, false, 0); - } - else - { - throw; - } - } - } - - private object PopulateList(IList list, JsonReader reader, JsonArrayContract contract, JsonProperty? containerProperty, string? id) - { -#pragma warning disable CS8600, CS8602, CS8603, CS8604 - object underlyingList = list is IWrappedCollection wrappedCollection ? wrappedCollection.UnderlyingCollection : list; - - if (id != null) - { - AddReference(reader, id, underlyingList); - } - - // can't populate an existing array - if (list.IsFixedSize) - { - reader.Skip(); - return underlyingList; - } - - OnDeserializing(reader, contract, underlyingList); - - int initialDepth = reader.Depth; - - if (contract.ItemContract == null) - { - contract.ItemContract = GetContractSafe(contract.CollectionItemType); - } - - JsonConverter? collectionItemConverter = GetConverter(contract.ItemContract, null, contract, containerProperty); - - int? previousErrorIndex = null; - - bool finished = false; - do - { - try - { - if (reader.ReadForType(contract.ItemContract, collectionItemConverter != null)) - { - switch (reader.TokenType) - { - case JsonToken.EndArray: - finished = true; - break; - case JsonToken.Comment: - break; - default: - object? value; - - if (collectionItemConverter != null && collectionItemConverter.CanRead) - { - value = DeserializeConvertable(collectionItemConverter, reader, contract.CollectionItemType, null); - } - else - { - value = CreateValueInternal(reader, contract.CollectionItemType, contract.ItemContract, null, contract, containerProperty, null); - } - - list.Add(value); - break; - } - } - else - { - break; - } - } - catch (Exception ex) - { - JsonPosition errorPosition = reader.GetPosition(initialDepth); - - if (IsErrorHandled(underlyingList, contract, errorPosition.Position, reader as IJsonLineInfo, reader.Path, ex)) - { - HandleError(reader, true, initialDepth + 1); - - if (previousErrorIndex != null && previousErrorIndex == errorPosition.Position) - { - // reader index has not moved since previous error handling - // break out of reading array to prevent infinite loop - throw JsonSerializationException.Create(reader, "Infinite loop detected from error handling.", ex); - } - else - { - previousErrorIndex = errorPosition.Position; - } - } - else - { - throw; - } - } - } while (!finished); - - if (!finished) - { - ThrowUnexpectedEndException(reader, contract, underlyingList, "Unexpected end when deserializing array."); - } - - OnDeserialized(reader, contract, underlyingList); - return underlyingList; -#pragma warning restore CS8600, CS8602, CS8603, CS8604 - } - -#if HAVE_BINARY_SERIALIZATION - private object CreateISerializable(JsonReader reader, JsonISerializableContract contract, JsonProperty? member, string? id) - { - Type objectType = contract.UnderlyingType; - - if (!JsonTypeReflector.FullyTrusted) - { - string message = @"Type '{0}' implements ISerializable but cannot be deserialized using the ISerializable interface because the current application is not fully trusted and ISerializable can expose secure data." + Environment.NewLine + - @"To fix this error either change the environment to be fully trusted, change the application to not deserialize the type, add JsonObjectAttribute to the type or change the JsonSerializer setting ContractResolver to use a new DefaultContractResolver with IgnoreSerializableInterface set to true." + Environment.NewLine; - message = message.FormatWith(CultureInfo.InvariantCulture, objectType); - - throw JsonSerializationException.Create(reader, message); - } - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Deserializing {0} using ISerializable constructor.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)), null); - } - - SerializationInfo serializationInfo = new SerializationInfo(contract.UnderlyingType, new JsonFormatterConverter(this, contract, member)); - - bool finished = false; - do - { - switch (reader.TokenType) - { - case JsonToken.PropertyName: - string memberName = reader.Value!.ToString(); - if (!reader.Read()) - { - throw JsonSerializationException.Create(reader, "Unexpected end when setting {0}'s value.".FormatWith(CultureInfo.InvariantCulture, memberName)); - } - serializationInfo.AddValue(memberName, JToken.ReadFrom(reader)); - break; - case JsonToken.Comment: - break; - case JsonToken.EndObject: - finished = true; - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected token when deserializing object: " + reader.TokenType); - } - } while (!finished && reader.Read()); - - if (!finished) - { - ThrowUnexpectedEndException(reader, contract, serializationInfo, "Unexpected end when deserializing object."); - } - - if (!contract.IsInstantiable) - { - throw JsonSerializationException.Create(reader, "Could not create an instance of type {0}. Type is an interface or abstract class and cannot be instantiated.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - if (contract.ISerializableCreator == null) - { - throw JsonSerializationException.Create(reader, "ISerializable type '{0}' does not have a valid constructor. To correctly implement ISerializable a constructor that takes SerializationInfo and StreamingContext parameters should be present.".FormatWith(CultureInfo.InvariantCulture, objectType)); - } - - object createdObject = contract.ISerializableCreator(serializationInfo, Serializer._context); - - if (id != null) - { - AddReference(reader, id, createdObject); - } - - // these are together because OnDeserializing takes an object but for an ISerializable the object is fully created in the constructor - OnDeserializing(reader, contract, createdObject); - OnDeserialized(reader, contract, createdObject); - - return createdObject; - } - - internal object? CreateISerializableItem(JToken token, Type type, JsonISerializableContract contract, JsonProperty? member) - { - JsonContract? itemContract = GetContractSafe(type); - JsonConverter? itemConverter = GetConverter(itemContract, null, contract, member); - - JsonReader tokenReader = token.CreateReader(); - tokenReader.ReadAndAssert(); // Move to first token - - object? result; - if (itemConverter != null && itemConverter.CanRead) - { - result = DeserializeConvertable(itemConverter, tokenReader, type, null); - } - else - { - result = CreateValueInternal(tokenReader, type, itemContract, null, contract, member, null); - } - - return result; - } -#endif - -#if HAVE_DYNAMIC - private object CreateDynamic(JsonReader reader, JsonDynamicContract contract, JsonProperty? member, string? id) - { - IDynamicMetaObjectProvider newObject; - - if (!contract.IsInstantiable) - { - throw JsonSerializationException.Create(reader, "Could not create an instance of type {0}. Type is an interface or abstract class and cannot be instantiated.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - if (contract.DefaultCreator != null && - (!contract.DefaultCreatorNonPublic || Serializer._constructorHandling == ConstructorHandling.AllowNonPublicDefaultConstructor)) - { - newObject = (IDynamicMetaObjectProvider)contract.DefaultCreator(); - } - else - { - throw JsonSerializationException.Create(reader, "Unable to find a default constructor to use for type {0}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)); - } - - if (id != null) - { - AddReference(reader, id, newObject); - } - - OnDeserializing(reader, contract, newObject); - - int initialDepth = reader.Depth; - - bool finished = false; - do - { - switch (reader.TokenType) - { - case JsonToken.PropertyName: - string memberName = reader.Value!.ToString(); - - try - { - if (!reader.Read()) - { - throw JsonSerializationException.Create(reader, "Unexpected end when setting {0}'s value.".FormatWith(CultureInfo.InvariantCulture, memberName)); - } - - // first attempt to find a settable property, otherwise fall back to a dynamic set without type - JsonProperty? property = contract.Properties.GetClosestMatchProperty(memberName); - - if (property != null && property.Writable && !property.Ignored) - { - if (property.PropertyContract == null) - { - property.PropertyContract = GetContractSafe(property.PropertyType); - } - - JsonConverter? propertyConverter = GetConverter(property.PropertyContract, property.Converter, null, null); - - if (!SetPropertyValue(property, propertyConverter, null, member, reader, newObject)) - { - reader.Skip(); - } - } - else - { - Type t = (JsonTokenUtils.IsPrimitiveToken(reader.TokenType)) ? reader.ValueType! : typeof(IDynamicMetaObjectProvider); - - JsonContract? dynamicMemberContract = GetContractSafe(t); - JsonConverter? dynamicMemberConverter = GetConverter(dynamicMemberContract, null, null, member); - - object? value; - if (dynamicMemberConverter != null && dynamicMemberConverter.CanRead) - { - value = DeserializeConvertable(dynamicMemberConverter!, reader, t, null); - } - else - { - value = CreateValueInternal(reader, t, dynamicMemberContract, null, null, member, null); - } - - contract.TrySetMember(newObject, memberName, value); - } - } - catch (Exception ex) - { - if (IsErrorHandled(newObject, contract, memberName, reader as IJsonLineInfo, reader.Path, ex)) - { - HandleError(reader, true, initialDepth); - } - else - { - throw; - } - } - break; - case JsonToken.EndObject: - finished = true; - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected token when deserializing object: " + reader.TokenType); - } - } while (!finished && reader.Read()); - - if (!finished) - { - ThrowUnexpectedEndException(reader, contract, newObject, "Unexpected end when deserializing object."); - } - - OnDeserialized(reader, contract, newObject); - - return newObject; - } -#endif - - internal class CreatorPropertyContext - { - public readonly string Name; - public JsonProperty? Property; - public JsonProperty? ConstructorProperty; - public PropertyPresence? Presence; - public object? Value; - public bool Used; - - public CreatorPropertyContext(string name) - { - Name = name; - } - } - - private object CreateObjectUsingCreatorWithParameters(JsonReader reader, JsonObjectContract contract, JsonProperty? containerProperty, ObjectConstructor creator, string? id) - { - ValidationUtils.ArgumentNotNull(creator, nameof(creator)); - - // only need to keep a track of properties' presence if they are required or a value should be defaulted if missing - bool trackPresence = (contract.HasRequiredOrDefaultValueProperties || HasFlag(Serializer._defaultValueHandling, DefaultValueHandling.Populate)); - - Type objectType = contract.UnderlyingType; - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - string parameters = string.Join(", ", contract.CreatorParameters.Select(p => p.PropertyName) -#if !HAVE_STRING_JOIN_WITH_ENUMERABLE - .ToArray() -#endif - ); - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Deserializing {0} using creator with parameters: {1}.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType, parameters)), null); - } - - List propertyContexts = ResolvePropertyAndCreatorValues(contract, containerProperty, reader, objectType); - if (trackPresence) - { - foreach (JsonProperty property in contract.Properties) - { - if (!property.Ignored) - { - if (propertyContexts.All(p => p.Property != property)) - { - propertyContexts.Add(new CreatorPropertyContext(property.PropertyName!) - { - Property = property, - Presence = PropertyPresence.None - }); - } - } - } - } - - object?[] creatorParameterValues = new object?[contract.CreatorParameters.Count]; - - foreach (CreatorPropertyContext context in propertyContexts) - { - // set presence of read values - if (trackPresence) - { - if (context.Property != null && context.Presence == null) - { - object? v = context.Value; - PropertyPresence propertyPresence; - if (v == null) - { - propertyPresence = PropertyPresence.Null; - } - else if (v is string s) - { - propertyPresence = CoerceEmptyStringToNull(context.Property.PropertyType, context.Property.PropertyContract, s) - ? PropertyPresence.Null - : PropertyPresence.Value; - } - else - { - propertyPresence = PropertyPresence.Value; - } - - context.Presence = propertyPresence; - } - } - - JsonProperty? constructorProperty = context.ConstructorProperty; - if (constructorProperty == null && context.Property != null) - { - constructorProperty = contract.CreatorParameters.ForgivingCaseSensitiveFind(p => p.PropertyName!, context.Property.UnderlyingName!); - } - - if (constructorProperty != null && !constructorProperty.Ignored) - { - // handle giving default values to creator parameters - // this needs to happen before the call to creator - if (trackPresence) - { - if (context.Presence == PropertyPresence.None || context.Presence == PropertyPresence.Null) - { - if (constructorProperty.PropertyContract == null) - { - constructorProperty.PropertyContract = GetContractSafe(constructorProperty.PropertyType); - } - - if (HasFlag(constructorProperty.DefaultValueHandling.GetValueOrDefault(Serializer._defaultValueHandling), DefaultValueHandling.Populate)) - { - context.Value = EnsureType( - reader, - constructorProperty.GetResolvedDefaultValue(), - CultureInfo.InvariantCulture, - constructorProperty.PropertyContract!, - constructorProperty.PropertyType); - } - } - } - - int i = contract.CreatorParameters.IndexOf(constructorProperty); - creatorParameterValues[i] = context.Value; - - context.Used = true; - } - } - - object createdObject = creator(creatorParameterValues); - - if (id != null) - { - AddReference(reader, id, createdObject); - } - - OnDeserializing(reader, contract, createdObject); - - // go through unused values and set the newly created object's properties - foreach (CreatorPropertyContext context in propertyContexts) - { - if (context.Used || - context.Property == null || - context.Property.Ignored || - context.Presence == PropertyPresence.None) - { - continue; - } - - JsonProperty property = context.Property; - object? value = context.Value; - - if (ShouldSetPropertyValue(property, contract, value)) - { - property.ValueProvider!.SetValue(createdObject, value); - context.Used = true; - } - else if (!property.Writable && value != null) - { - // handle readonly collection/dictionary properties - JsonContract propertyContract = Serializer._contractResolver.ResolveContract(property.PropertyType!); - - if (propertyContract.ContractType == JsonContractType.Array) - { - JsonArrayContract propertyArrayContract = (JsonArrayContract)propertyContract; - - if (propertyArrayContract.CanDeserialize && !propertyArrayContract.IsReadOnlyOrFixedSize) - { - object? createdObjectCollection = property.ValueProvider!.GetValue(createdObject); - if (createdObjectCollection != null) - { - propertyArrayContract = (JsonArrayContract)GetContract(createdObjectCollection.GetType()); - - IList createdObjectCollectionWrapper = (propertyArrayContract.ShouldCreateWrapper) ? propertyArrayContract.CreateWrapper(createdObjectCollection) : (IList)createdObjectCollection; - - // Don't attempt to populate array/read-only list - if (!createdObjectCollectionWrapper.IsFixedSize) - { - IList newValues = (propertyArrayContract.ShouldCreateWrapper) ? propertyArrayContract.CreateWrapper(value) : (IList)value; - - foreach (object newValue in newValues) - { - createdObjectCollectionWrapper.Add(newValue); - } - } - } - } - } - else if (propertyContract.ContractType == JsonContractType.Dictionary) - { - JsonDictionaryContract dictionaryContract = (JsonDictionaryContract)propertyContract; - - if (!dictionaryContract.IsReadOnlyOrFixedSize) - { - object? createdObjectDictionary = property.ValueProvider!.GetValue(createdObject); - if (createdObjectDictionary != null) - { - IDictionary targetDictionary = (dictionaryContract.ShouldCreateWrapper) ? dictionaryContract.CreateWrapper(createdObjectDictionary) : (IDictionary)createdObjectDictionary; - IDictionary newValues = (dictionaryContract.ShouldCreateWrapper) ? dictionaryContract.CreateWrapper(value) : (IDictionary)value; - - // Manual use of IDictionaryEnumerator instead of foreach to avoid DictionaryEntry box allocations. - IDictionaryEnumerator e = newValues.GetEnumerator(); - try - { - while (e.MoveNext()) - { - DictionaryEntry entry = e.Entry; - targetDictionary[entry.Key] = entry.Value; - } - } - finally - { - (e as IDisposable)?.Dispose(); - } - } - } - } - - context.Used = true; - } - } - - if (contract.ExtensionDataSetter != null) - { - foreach (CreatorPropertyContext propertyValue in propertyContexts) - { - if (!propertyValue.Used && propertyValue.Presence != PropertyPresence.None) - { - contract.ExtensionDataSetter(createdObject, propertyValue.Name, propertyValue.Value); - } - } - } - - if (trackPresence) - { - foreach (CreatorPropertyContext context in propertyContexts) - { - if (context.Property == null) - { - continue; - } - - EndProcessProperty( - createdObject, - reader, - contract, - reader.Depth, - context.Property, - context.Presence.GetValueOrDefault(), - !context.Used); - } - } - - OnDeserialized(reader, contract, createdObject); - return createdObject; - } - - private object? DeserializeConvertable(JsonConverter converter, JsonReader reader, Type objectType, object? existingValue) - { - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Started deserializing {0} with converter {1}.".FormatWith(CultureInfo.InvariantCulture, objectType, converter.GetType())), null); - } - - object? value = converter.ReadJson(reader, objectType, existingValue, GetInternalSerializer()); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Finished deserializing {0} with converter {1}.".FormatWith(CultureInfo.InvariantCulture, objectType, converter.GetType())), null); - } - - return value; - } - - private List ResolvePropertyAndCreatorValues(JsonObjectContract contract, JsonProperty? containerProperty, JsonReader reader, Type objectType) - { - List propertyValues = new List(); - bool exit = false; - do - { - switch (reader.TokenType) - { - case JsonToken.PropertyName: - string memberName = reader.Value!.ToString(); - - CreatorPropertyContext creatorPropertyContext = new CreatorPropertyContext(memberName) - { - ConstructorProperty = contract.CreatorParameters.GetClosestMatchProperty(memberName), - Property = contract.Properties.GetClosestMatchProperty(memberName) - }; - propertyValues.Add(creatorPropertyContext); - - JsonProperty? property = creatorPropertyContext.ConstructorProperty ?? creatorPropertyContext.Property; - if (property != null) - { - if (!property.Ignored) - { - if (property.PropertyContract == null) - { - property.PropertyContract = GetContractSafe(property.PropertyType); - } - - JsonConverter? propertyConverter = GetConverter(property.PropertyContract, property.Converter, contract, containerProperty); - - if (!reader.ReadForType(property.PropertyContract, propertyConverter != null)) - { - throw JsonSerializationException.Create(reader, "Unexpected end when setting {0}'s value.".FormatWith(CultureInfo.InvariantCulture, memberName)); - } - - if (propertyConverter != null && propertyConverter.CanRead) - { - creatorPropertyContext.Value = DeserializeConvertable(propertyConverter, reader, property.PropertyType!, null); - } - else - { - creatorPropertyContext.Value = CreateValueInternal(reader, property.PropertyType, property.PropertyContract, property, contract, containerProperty, null); - } - - continue; - } - } - else - { - if (!reader.Read()) - { - throw JsonSerializationException.Create(reader, "Unexpected end when setting {0}'s value.".FormatWith(CultureInfo.InvariantCulture, memberName)); - } - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Could not find member '{0}' on {1}.".FormatWith(CultureInfo.InvariantCulture, memberName, contract.UnderlyingType)), null); - } - - if ((contract.MissingMemberHandling ?? Serializer._missingMemberHandling) == MissingMemberHandling.Error) - { - throw JsonSerializationException.Create(reader, "Could not find member '{0}' on object of type '{1}'".FormatWith(CultureInfo.InvariantCulture, memberName, objectType.Name)); - } - } - - if (contract.ExtensionDataSetter != null) - { - creatorPropertyContext.Value = ReadExtensionDataValue(contract, containerProperty, reader); - } - else - { - reader.Skip(); - } - break; - case JsonToken.Comment: - break; - case JsonToken.EndObject: - exit = true; - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected token when deserializing object: " + reader.TokenType); - } - } while (!exit && reader.Read()); - - if (!exit) - { - ThrowUnexpectedEndException(reader, contract, null, "Unexpected end when deserializing object."); - } - - return propertyValues; - } - - public object CreateNewObject(JsonReader reader, JsonObjectContract objectContract, JsonProperty? containerMember, JsonProperty? containerProperty, string? id, out bool createdFromNonDefaultCreator) - { - object? newObject = null; - - if (objectContract.OverrideCreator != null) - { - if (objectContract.CreatorParameters.Count > 0) - { - createdFromNonDefaultCreator = true; - return CreateObjectUsingCreatorWithParameters(reader, objectContract, containerMember, objectContract.OverrideCreator, id); - } - - newObject = objectContract.OverrideCreator(CollectionUtils.ArrayEmpty()); - } - else if (objectContract.DefaultCreator != null && - (!objectContract.DefaultCreatorNonPublic || Serializer._constructorHandling == ConstructorHandling.AllowNonPublicDefaultConstructor || objectContract.ParameterizedCreator == null)) - { - // use the default constructor if it is... - // public - // non-public and the user has change constructor handling settings - // non-public and there is no other creator - newObject = objectContract.DefaultCreator(); - } - else if (objectContract.ParameterizedCreator != null) - { - createdFromNonDefaultCreator = true; - return CreateObjectUsingCreatorWithParameters(reader, objectContract, containerMember, objectContract.ParameterizedCreator, id); - } - - if (newObject == null) - { - if (!objectContract.IsInstantiable) - { - throw JsonSerializationException.Create(reader, "Could not create an instance of type {0}. Type is an interface or abstract class and cannot be instantiated.".FormatWith(CultureInfo.InvariantCulture, objectContract.UnderlyingType)); - } - - throw JsonSerializationException.Create(reader, "Unable to find a constructor to use for type {0}. A class should either have a default constructor, one constructor with arguments or a constructor marked with the JsonConstructor attribute.".FormatWith(CultureInfo.InvariantCulture, objectContract.UnderlyingType)); - } - - createdFromNonDefaultCreator = false; - return newObject; - } - - private object PopulateObject(object newObject, JsonReader reader, JsonObjectContract contract, JsonProperty? member, string? id) - { - OnDeserializing(reader, contract, newObject); - - // only need to keep a track of properties' presence if they are required or a value should be defaulted if missing - Dictionary? propertiesPresence = (contract.HasRequiredOrDefaultValueProperties || HasFlag(Serializer._defaultValueHandling, DefaultValueHandling.Populate)) - ? contract.Properties.ToDictionary(m => m, m => PropertyPresence.None) - : null; - - if (id != null) - { - AddReference(reader, id, newObject); - } - - int initialDepth = reader.Depth; - - bool finished = false; - do - { - switch (reader.TokenType) - { - case JsonToken.PropertyName: - { - string propertyName = reader.Value!.ToString(); - - if (CheckPropertyName(reader, propertyName)) - { - continue; - } - - try - { - // attempt exact case match first - // then try match ignoring case - JsonProperty? property = contract.Properties.GetClosestMatchProperty(propertyName); - - if (property == null) - { - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(reader as IJsonLineInfo, reader.Path, "Could not find member '{0}' on {1}".FormatWith(CultureInfo.InvariantCulture, propertyName, contract.UnderlyingType)), null); - } - - if ((contract.MissingMemberHandling ?? Serializer._missingMemberHandling) == MissingMemberHandling.Error) - { - throw JsonSerializationException.Create(reader, "Could not find member '{0}' on object of type '{1}'".FormatWith(CultureInfo.InvariantCulture, propertyName, contract.UnderlyingType.Name)); - } - - if (!reader.Read()) - { - break; - } - - SetExtensionData(contract, member, reader, propertyName, newObject); - continue; - } - - if (property.Ignored || !ShouldDeserialize(reader, property, newObject)) - { - if (!reader.Read()) - { - break; - } - - SetPropertyPresence(reader, property, propertiesPresence); - SetExtensionData(contract, member, reader, propertyName, newObject); - } - else - { - if (property.PropertyContract == null) - { - property.PropertyContract = GetContractSafe(property.PropertyType); - } - - JsonConverter? propertyConverter = GetConverter(property.PropertyContract, property.Converter, contract, member); - - if (!reader.ReadForType(property.PropertyContract, propertyConverter != null)) - { - throw JsonSerializationException.Create(reader, "Unexpected end when setting {0}'s value.".FormatWith(CultureInfo.InvariantCulture, propertyName)); - } - - SetPropertyPresence(reader, property, propertiesPresence); - - // set extension data if property is ignored or readonly - if (!SetPropertyValue(property, propertyConverter, contract, member, reader, newObject)) - { - SetExtensionData(contract, member, reader, propertyName, newObject); - } - } - } - catch (Exception ex) - { - if (IsErrorHandled(newObject, contract, propertyName, reader as IJsonLineInfo, reader.Path, ex)) - { - HandleError(reader, true, initialDepth); - } - else - { - throw; - } - } - break; - } - case JsonToken.EndObject: - finished = true; - break; - case JsonToken.Comment: - // ignore - break; - default: - throw JsonSerializationException.Create(reader, "Unexpected token when deserializing object: " + reader.TokenType); - } - } while (!finished && reader.Read()); - - if (!finished) - { - ThrowUnexpectedEndException(reader, contract, newObject, "Unexpected end when deserializing object."); - } - - if (propertiesPresence != null) - { - foreach (KeyValuePair propertyPresence in propertiesPresence) - { - JsonProperty property = propertyPresence.Key; - PropertyPresence presence = propertyPresence.Value; - - EndProcessProperty(newObject, reader, contract, initialDepth, property, presence, true); - } - } - - OnDeserialized(reader, contract, newObject); - return newObject; - } - - private bool ShouldDeserialize(JsonReader reader, JsonProperty property, object target) - { - if (property.ShouldDeserialize == null) - { - return true; - } - - bool shouldDeserialize = property.ShouldDeserialize(target); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(null, reader.Path, "ShouldDeserialize result for property '{0}' on {1}: {2}".FormatWith(CultureInfo.InvariantCulture, property.PropertyName, property.DeclaringType, shouldDeserialize)), null); - } - - return shouldDeserialize; - } - - private bool CheckPropertyName(JsonReader reader, string memberName) - { - if (Serializer.MetadataPropertyHandling == MetadataPropertyHandling.ReadAhead) - { - switch (memberName) - { - case JsonTypeReflector.IdPropertyName: - case JsonTypeReflector.RefPropertyName: - case JsonTypeReflector.TypePropertyName: - case JsonTypeReflector.ArrayValuesPropertyName: - reader.Skip(); - return true; - } - } - return false; - } - - private void SetExtensionData(JsonObjectContract contract, JsonProperty? member, JsonReader reader, string memberName, object o) - { - if (contract.ExtensionDataSetter != null) - { - try - { - object? value = ReadExtensionDataValue(contract, member, reader); - - contract.ExtensionDataSetter(o, memberName, value); - } - catch (Exception ex) - { - throw JsonSerializationException.Create(reader, "Error setting value in extension data for type '{0}'.".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType), ex); - } - } - else - { - reader.Skip(); - } - } - - private object? ReadExtensionDataValue(JsonObjectContract contract, JsonProperty? member, JsonReader reader) - { - object? value; - if (contract.ExtensionDataIsJToken) - { - value = JToken.ReadFrom(reader); - } - else - { - value = CreateValueInternal(reader, null, null, null, contract, member, null); - } - return value; - } - - private void EndProcessProperty(object newObject, JsonReader reader, JsonObjectContract contract, int initialDepth, JsonProperty property, PropertyPresence presence, bool setDefaultValue) - { - if (presence == PropertyPresence.None || presence == PropertyPresence.Null) - { - try - { - Required resolvedRequired = property.Ignored ? Required.Default : property._required ?? contract.ItemRequired ?? Required.Default; - - switch (presence) - { - case PropertyPresence.None: - if (resolvedRequired == Required.AllowNull || resolvedRequired == Required.Always) - { - throw JsonSerializationException.Create(reader, "Required property '{0}' not found in JSON.".FormatWith(CultureInfo.InvariantCulture, property.PropertyName)); - } - - if (setDefaultValue && !property.Ignored) - { - if (property.PropertyContract == null) - { - property.PropertyContract = GetContractSafe(property.PropertyType); - } - - if (HasFlag(property.DefaultValueHandling.GetValueOrDefault(Serializer._defaultValueHandling), DefaultValueHandling.Populate) && property.Writable) - { - property.ValueProvider!.SetValue(newObject, EnsureType(reader, property.GetResolvedDefaultValue(), CultureInfo.InvariantCulture, property.PropertyContract!, property.PropertyType)); - } - } - break; - case PropertyPresence.Null: - if (resolvedRequired == Required.Always) - { - throw JsonSerializationException.Create(reader, "Required property '{0}' expects a value but got null.".FormatWith(CultureInfo.InvariantCulture, property.PropertyName)); - } - if (resolvedRequired == Required.DisallowNull) - { - throw JsonSerializationException.Create(reader, "Required property '{0}' expects a non-null value.".FormatWith(CultureInfo.InvariantCulture, property.PropertyName)); - } - break; - } - } - catch (Exception ex) - { - if (IsErrorHandled(newObject, contract, property.PropertyName, reader as IJsonLineInfo, reader.Path, ex)) - { - HandleError(reader, true, initialDepth); - } - else - { - throw; - } - } - } - } - - private void SetPropertyPresence(JsonReader reader, JsonProperty property, Dictionary? requiredProperties) - { - if (property != null && requiredProperties != null) - { - PropertyPresence propertyPresence; - switch (reader.TokenType) - { - case JsonToken.String: - propertyPresence = (CoerceEmptyStringToNull(property.PropertyType, property.PropertyContract, (string)reader.Value!)) - ? PropertyPresence.Null - : PropertyPresence.Value; - break; - case JsonToken.Null: - case JsonToken.Undefined: - propertyPresence = PropertyPresence.Null; - break; - default: - propertyPresence = PropertyPresence.Value; - break; - } - - requiredProperties[property] = propertyPresence; - } - } - - private void HandleError(JsonReader reader, bool readPastError, int initialDepth) - { - ClearErrorContext(); - - if (readPastError) - { - reader.Skip(); - - while (reader.Depth > initialDepth) - { - if (!reader.Read()) - { - break; - } - } - } - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerInternalWriter.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerInternalWriter.cs deleted file mode 100644 index 675b5fe..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerInternalWriter.cs +++ /dev/null @@ -1,1244 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using System.ComponentModel; -#if HAVE_DYNAMIC -using System.Dynamic; -#endif -using System.Diagnostics; -using System.Globalization; -using System.IO; -using System.Security; -using Newtonsoft.Json.Linq; -using Newtonsoft.Json.Utilities; -using System.Runtime.Serialization; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif - -namespace Newtonsoft.Json.Serialization -{ - internal class JsonSerializerInternalWriter : JsonSerializerInternalBase - { - private Type? _rootType; - private int _rootLevel; - private readonly List _serializeStack = new List(); - - public JsonSerializerInternalWriter(JsonSerializer serializer) - : base(serializer) - { - } - - public void Serialize(JsonWriter jsonWriter, object? value, Type? objectType) - { - if (jsonWriter == null) - { - throw new ArgumentNullException(nameof(jsonWriter)); - } - - _rootType = objectType; - _rootLevel = _serializeStack.Count + 1; - - JsonContract? contract = GetContractSafe(value); - - try - { - if (ShouldWriteReference(value, null, contract, null, null)) - { - WriteReference(jsonWriter, value!); - } - else - { - SerializeValue(jsonWriter, value, contract, null, null, null); - } - } - catch (Exception ex) - { - if (IsErrorHandled(null, contract, null, null, jsonWriter.Path, ex)) - { - HandleError(jsonWriter, 0); - } - else - { - // clear context in case serializer is being used inside a converter - // if the converter wraps the error then not clearing the context will cause this error: - // "Current error context error is different to requested error." - ClearErrorContext(); - throw; - } - } - finally - { - // clear root contract to ensure that if level was > 1 then it won't - // accidentally be used for non root values - _rootType = null; - } - } - - private JsonSerializerProxy GetInternalSerializer() - { - if (InternalSerializer == null) - { - InternalSerializer = new JsonSerializerProxy(this); - } - - return InternalSerializer; - } - - private JsonContract? GetContractSafe(object? value) - { - if (value == null) - { - return null; - } - - return GetContract(value); - } - - private JsonContract GetContract(object value) - { - return Serializer._contractResolver.ResolveContract(value.GetType()); - } - - private void SerializePrimitive(JsonWriter writer, object value, JsonPrimitiveContract contract, JsonProperty? member, JsonContainerContract? containerContract, JsonProperty? containerProperty) - { - if (contract.TypeCode == PrimitiveTypeCode.Bytes) - { - // if type name handling is enabled then wrap the base64 byte string in an object with the type name - bool includeTypeDetails = ShouldWriteType(TypeNameHandling.Objects, contract, member, containerContract, containerProperty); - if (includeTypeDetails) - { - writer.WriteStartObject(); - WriteTypeProperty(writer, contract.CreatedType); - writer.WritePropertyName(JsonTypeReflector.ValuePropertyName, false); - - JsonWriter.WriteValue(writer, contract.TypeCode, value); - - writer.WriteEndObject(); - return; - } - } - - JsonWriter.WriteValue(writer, contract.TypeCode, value); - } - - private void SerializeValue(JsonWriter writer, object? value, JsonContract? valueContract, JsonProperty? member, JsonContainerContract? containerContract, JsonProperty? containerProperty) - { - if (value == null) - { - writer.WriteNull(); - return; - } - - MiscellaneousUtils.Assert(valueContract != null); - - JsonConverter? converter = - member?.Converter ?? - containerProperty?.ItemConverter ?? - containerContract?.ItemConverter ?? - valueContract.Converter ?? - Serializer.GetMatchingConverter(valueContract.UnderlyingType) ?? - valueContract.InternalConverter; - - if (converter != null && converter.CanWrite) - { - SerializeConvertable(writer, converter, value, valueContract, containerContract, containerProperty); - return; - } - - switch (valueContract.ContractType) - { - case JsonContractType.Object: - SerializeObject(writer, value, (JsonObjectContract)valueContract, member, containerContract, containerProperty); - break; - case JsonContractType.Array: - JsonArrayContract arrayContract = (JsonArrayContract)valueContract; - if (!arrayContract.IsMultidimensionalArray) - { - SerializeList(writer, (IEnumerable)value, arrayContract, member, containerContract, containerProperty); - } - else - { - SerializeMultidimensionalArray(writer, (Array)value, arrayContract, member, containerContract, containerProperty); - } - break; - case JsonContractType.Primitive: - SerializePrimitive(writer, value, (JsonPrimitiveContract)valueContract, member, containerContract, containerProperty); - break; - case JsonContractType.String: - SerializeString(writer, value, (JsonStringContract)valueContract); - break; - case JsonContractType.Dictionary: - JsonDictionaryContract dictionaryContract = (JsonDictionaryContract)valueContract; - SerializeDictionary(writer, (value is IDictionary dictionary) ? dictionary : dictionaryContract.CreateWrapper(value), dictionaryContract, member, containerContract, containerProperty); - break; -#if HAVE_DYNAMIC - case JsonContractType.Dynamic: - SerializeDynamic(writer, (IDynamicMetaObjectProvider)value, (JsonDynamicContract)valueContract, member, containerContract, containerProperty); - break; -#endif -#if HAVE_BINARY_SERIALIZATION - case JsonContractType.Serializable: - SerializeISerializable(writer, (ISerializable)value, (JsonISerializableContract)valueContract, member, containerContract, containerProperty); - break; -#endif - case JsonContractType.Linq: - ((JToken)value).WriteTo(writer, Serializer.Converters.ToArray()); - break; - } - } - - private bool? ResolveIsReference(JsonContract contract, JsonProperty? property, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { - bool? isReference = null; - - // value could be coming from a dictionary or array and not have a property - if (property != null) - { - isReference = property.IsReference; - } - - if (isReference == null && containerProperty != null) - { - isReference = containerProperty.ItemIsReference; - } - - if (isReference == null && collectionContract != null) - { - isReference = collectionContract.ItemIsReference; - } - - if (isReference == null) - { - isReference = contract.IsReference; - } - - return isReference; - } - - private bool ShouldWriteReference(object? value, JsonProperty? property, JsonContract? valueContract, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { - if (value == null) - { - return false; - } - - MiscellaneousUtils.Assert(valueContract != null); - - if (valueContract.ContractType == JsonContractType.Primitive || valueContract.ContractType == JsonContractType.String) - { - return false; - } - - bool? isReference = ResolveIsReference(valueContract, property, collectionContract, containerProperty); - - if (isReference == null) - { - if (valueContract.ContractType == JsonContractType.Array) - { - isReference = HasFlag(Serializer._preserveReferencesHandling, PreserveReferencesHandling.Arrays); - } - else - { - isReference = HasFlag(Serializer._preserveReferencesHandling, PreserveReferencesHandling.Objects); - } - } - - if (!isReference.GetValueOrDefault()) - { - return false; - } - - return Serializer.GetReferenceResolver().IsReferenced(this, value); - } - - private bool ShouldWriteProperty(object? memberValue, JsonObjectContract? containerContract, JsonProperty property) - { - if (memberValue == null && ResolvedNullValueHandling(containerContract, property) == NullValueHandling.Ignore) - { - return false; - } - - if (HasFlag(property.DefaultValueHandling.GetValueOrDefault(Serializer._defaultValueHandling), DefaultValueHandling.Ignore) - && MiscellaneousUtils.ValueEquals(memberValue, property.GetResolvedDefaultValue())) - { - return false; - } - - return true; - } - - private bool CheckForCircularReference(JsonWriter writer, object? value, JsonProperty? property, JsonContract? contract, JsonContainerContract? containerContract, JsonProperty? containerProperty) - { - if (value == null) - { - return true; - } - - MiscellaneousUtils.Assert(contract != null); - - if (contract.ContractType == JsonContractType.Primitive || contract.ContractType == JsonContractType.String) - { - return true; - } - - ReferenceLoopHandling? referenceLoopHandling = null; - - if (property != null) - { - referenceLoopHandling = property.ReferenceLoopHandling; - } - - if (referenceLoopHandling == null && containerProperty != null) - { - referenceLoopHandling = containerProperty.ItemReferenceLoopHandling; - } - - if (referenceLoopHandling == null && containerContract != null) - { - referenceLoopHandling = containerContract.ItemReferenceLoopHandling; - } - - bool exists = (Serializer._equalityComparer != null) - ? _serializeStack.Contains(value, Serializer._equalityComparer) - : _serializeStack.Contains(value); - - if (exists) - { - string message = "Self referencing loop detected"; - if (property != null) - { - message += " for property '{0}'".FormatWith(CultureInfo.InvariantCulture, property.PropertyName); - } - message += " with type '{0}'.".FormatWith(CultureInfo.InvariantCulture, value.GetType()); - - switch (referenceLoopHandling.GetValueOrDefault(Serializer._referenceLoopHandling)) - { - case ReferenceLoopHandling.Error: - throw JsonSerializationException.Create(null, writer.ContainerPath, message, null); - case ReferenceLoopHandling.Ignore: - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(null, writer.Path, message + ". Skipping serializing self referenced value."), null); - } - - return false; - case ReferenceLoopHandling.Serialize: - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(null, writer.Path, message + ". Serializing self referenced value."), null); - } - - return true; - } - } - - return true; - } - - private void WriteReference(JsonWriter writer, object value) - { - string reference = GetReference(writer, value); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(null, writer.Path, "Writing object reference to Id '{0}' for {1}.".FormatWith(CultureInfo.InvariantCulture, reference, value.GetType())), null); - } - - writer.WriteStartObject(); - writer.WritePropertyName(JsonTypeReflector.RefPropertyName, false); - writer.WriteValue(reference); - writer.WriteEndObject(); - } - - private string GetReference(JsonWriter writer, object value) - { - try - { - string reference = Serializer.GetReferenceResolver().GetReference(this, value); - - return reference; - } - catch (Exception ex) - { - throw JsonSerializationException.Create(null, writer.ContainerPath, "Error writing object reference for '{0}'.".FormatWith(CultureInfo.InvariantCulture, value.GetType()), ex); - } - } - - internal static bool TryConvertToString(object value, Type type, [NotNullWhen(true)]out string? s) - { -#if HAVE_TYPE_DESCRIPTOR - if (JsonTypeReflector.CanTypeDescriptorConvertString(type, out TypeConverter converter)) - { - s = converter.ConvertToInvariantString(value); - return true; - } -#endif - -#if (DOTNET || PORTABLE) - if (value is Guid || value is Uri || value is TimeSpan) - { - s = value.ToString(); - return true; - } -#endif - - if (value is Type t) - { - s = t.AssemblyQualifiedName; - return true; - } - - s = null; - return false; - } - - private void SerializeString(JsonWriter writer, object value, JsonStringContract contract) - { - OnSerializing(writer, contract, value); - - TryConvertToString(value, contract.UnderlyingType, out string? s); - writer.WriteValue(s); - - OnSerialized(writer, contract, value); - } - - private void OnSerializing(JsonWriter writer, JsonContract contract, object value) - { - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(null, writer.Path, "Started serializing {0}".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)), null); - } - - contract.InvokeOnSerializing(value, Serializer._context); - } - - private void OnSerialized(JsonWriter writer, JsonContract contract, object value) - { - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(null, writer.Path, "Finished serializing {0}".FormatWith(CultureInfo.InvariantCulture, contract.UnderlyingType)), null); - } - - contract.InvokeOnSerialized(value, Serializer._context); - } - - private void SerializeObject(JsonWriter writer, object value, JsonObjectContract contract, JsonProperty? member, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { - OnSerializing(writer, contract, value); - - _serializeStack.Add(value); - - WriteObjectStart(writer, value, contract, member, collectionContract, containerProperty); - - int initialDepth = writer.Top; - - for (int index = 0; index < contract.Properties.Count; index++) - { - JsonProperty property = contract.Properties[index]; - try - { - if (!CalculatePropertyValues(writer, value, contract, member, property, out JsonContract? memberContract, out object? memberValue)) - { - continue; - } - - property.WritePropertyName(writer); - SerializeValue(writer, memberValue, memberContract, property, contract, member); - } - catch (Exception ex) - { - if (IsErrorHandled(value, contract, property.PropertyName, null, writer.ContainerPath, ex)) - { - HandleError(writer, initialDepth); - } - else - { - throw; - } - } - } - - IEnumerable>? extensionData = contract.ExtensionDataGetter?.Invoke(value); - if (extensionData != null) - { - foreach (KeyValuePair e in extensionData) - { - JsonContract keyContract = GetContract(e.Key); - JsonContract? valueContract = GetContractSafe(e.Value); - - string propertyName = GetPropertyName(writer, e.Key, keyContract, out _); - - propertyName = (contract.ExtensionDataNameResolver != null) - ? contract.ExtensionDataNameResolver(propertyName) - : propertyName; - - if (ShouldWriteReference(e.Value, null, valueContract, contract, member)) - { - writer.WritePropertyName(propertyName); - WriteReference(writer, e.Value!); - } - else - { - if (!CheckForCircularReference(writer, e.Value, null, valueContract, contract, member)) - { - continue; - } - - writer.WritePropertyName(propertyName); - - SerializeValue(writer, e.Value, valueContract, null, contract, member); - } - } - } - - writer.WriteEndObject(); - - _serializeStack.RemoveAt(_serializeStack.Count - 1); - - OnSerialized(writer, contract, value); - } - - private bool CalculatePropertyValues(JsonWriter writer, object value, JsonContainerContract contract, JsonProperty? member, JsonProperty property, [NotNullWhen(true)]out JsonContract? memberContract, out object? memberValue) - { - if (!property.Ignored && property.Readable && ShouldSerialize(writer, property, value) && IsSpecified(writer, property, value)) - { - if (property.PropertyContract == null) - { - property.PropertyContract = Serializer._contractResolver.ResolveContract(property.PropertyType!); - } - - memberValue = property.ValueProvider!.GetValue(value); - memberContract = (property.PropertyContract.IsSealed) ? property.PropertyContract : GetContractSafe(memberValue); - - if (ShouldWriteProperty(memberValue, contract as JsonObjectContract, property)) - { - if (ShouldWriteReference(memberValue, property, memberContract, contract, member)) - { - property.WritePropertyName(writer); - WriteReference(writer, memberValue!); - return false; - } - - if (!CheckForCircularReference(writer, memberValue, property, memberContract, contract, member)) - { - return false; - } - - if (memberValue == null) - { - JsonObjectContract? objectContract = contract as JsonObjectContract; - Required resolvedRequired = property._required ?? objectContract?.ItemRequired ?? Required.Default; - if (resolvedRequired == Required.Always) - { - throw JsonSerializationException.Create(null, writer.ContainerPath, "Cannot write a null value for property '{0}'. Property requires a value.".FormatWith(CultureInfo.InvariantCulture, property.PropertyName), null); - } - if (resolvedRequired == Required.DisallowNull) - { - throw JsonSerializationException.Create(null, writer.ContainerPath, "Cannot write a null value for property '{0}'. Property requires a non-null value.".FormatWith(CultureInfo.InvariantCulture, property.PropertyName), null); - } - } - -#pragma warning disable CS8762 // Parameter must have a non-null value when exiting in some condition. - return true; -#pragma warning restore CS8762 // Parameter must have a non-null value when exiting in some condition. - } - } - - memberContract = null; - memberValue = null; - return false; - } - - private void WriteObjectStart(JsonWriter writer, object value, JsonContract contract, JsonProperty? member, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { - writer.WriteStartObject(); - - bool isReference = ResolveIsReference(contract, member, collectionContract, containerProperty) ?? HasFlag(Serializer._preserveReferencesHandling, PreserveReferencesHandling.Objects); - // don't make readonly fields that aren't creator parameters the referenced value because they can't be deserialized to - if (isReference && (member == null || member.Writable || HasCreatorParameter(collectionContract, member))) - { - WriteReferenceIdProperty(writer, contract.UnderlyingType, value); - } - if (ShouldWriteType(TypeNameHandling.Objects, contract, member, collectionContract, containerProperty)) - { - WriteTypeProperty(writer, contract.UnderlyingType); - } - } - - private bool HasCreatorParameter(JsonContainerContract? contract, JsonProperty property) - { - if (!(contract is JsonObjectContract objectContract)) - { - return false; - } - - return objectContract.CreatorParameters.Contains(property.PropertyName!); - } - - private void WriteReferenceIdProperty(JsonWriter writer, Type type, object value) - { - string reference = GetReference(writer, value); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(null, writer.Path, "Writing object reference Id '{0}' for {1}.".FormatWith(CultureInfo.InvariantCulture, reference, type)), null); - } - - writer.WritePropertyName(JsonTypeReflector.IdPropertyName, false); - writer.WriteValue(reference); - } - - private void WriteTypeProperty(JsonWriter writer, Type type) - { - string typeName = ReflectionUtils.GetTypeName(type, Serializer._typeNameAssemblyFormatHandling, Serializer._serializationBinder); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(null, writer.Path, "Writing type name '{0}' for {1}.".FormatWith(CultureInfo.InvariantCulture, typeName, type)), null); - } - - writer.WritePropertyName(JsonTypeReflector.TypePropertyName, false); - writer.WriteValue(typeName); - } - - private bool HasFlag(DefaultValueHandling value, DefaultValueHandling flag) - { - return ((value & flag) == flag); - } - - private bool HasFlag(PreserveReferencesHandling value, PreserveReferencesHandling flag) - { - return ((value & flag) == flag); - } - - private bool HasFlag(TypeNameHandling value, TypeNameHandling flag) - { - return ((value & flag) == flag); - } - - private void SerializeConvertable(JsonWriter writer, JsonConverter converter, object value, JsonContract contract, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { - if (ShouldWriteReference(value, null, contract, collectionContract, containerProperty)) - { - WriteReference(writer, value); - } - else - { - if (!CheckForCircularReference(writer, value, null, contract, collectionContract, containerProperty)) - { - return; - } - - _serializeStack.Add(value); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(null, writer.Path, "Started serializing {0} with converter {1}.".FormatWith(CultureInfo.InvariantCulture, value.GetType(), converter.GetType())), null); - } - - converter.WriteJson(writer, value, GetInternalSerializer()); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Info) - { - TraceWriter.Trace(TraceLevel.Info, JsonPosition.FormatMessage(null, writer.Path, "Finished serializing {0} with converter {1}.".FormatWith(CultureInfo.InvariantCulture, value.GetType(), converter.GetType())), null); - } - - _serializeStack.RemoveAt(_serializeStack.Count - 1); - } - } - - private void SerializeList(JsonWriter writer, IEnumerable values, JsonArrayContract contract, JsonProperty? member, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { - object underlyingList = values is IWrappedCollection wrappedCollection ? wrappedCollection.UnderlyingCollection : values; - - OnSerializing(writer, contract, underlyingList); - - _serializeStack.Add(underlyingList); - - bool hasWrittenMetadataObject = WriteStartArray(writer, underlyingList, contract, member, collectionContract, containerProperty); - - writer.WriteStartArray(); - - int initialDepth = writer.Top; - - int index = 0; - // note that an error in the IEnumerable won't be caught - foreach (object value in values) - { - try - { - JsonContract? valueContract = contract.FinalItemContract ?? GetContractSafe(value); - - if (ShouldWriteReference(value, null, valueContract, contract, member)) - { - WriteReference(writer, value); - } - else - { - if (CheckForCircularReference(writer, value, null, valueContract, contract, member)) - { - SerializeValue(writer, value, valueContract, null, contract, member); - } - } - } - catch (Exception ex) - { - if (IsErrorHandled(underlyingList, contract, index, null, writer.ContainerPath, ex)) - { - HandleError(writer, initialDepth); - } - else - { - throw; - } - } - finally - { - index++; - } - } - - writer.WriteEndArray(); - - if (hasWrittenMetadataObject) - { - writer.WriteEndObject(); - } - - _serializeStack.RemoveAt(_serializeStack.Count - 1); - - OnSerialized(writer, contract, underlyingList); - } - - private void SerializeMultidimensionalArray(JsonWriter writer, Array values, JsonArrayContract contract, JsonProperty? member, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { - OnSerializing(writer, contract, values); - - _serializeStack.Add(values); - - bool hasWrittenMetadataObject = WriteStartArray(writer, values, contract, member, collectionContract, containerProperty); - - SerializeMultidimensionalArray(writer, values, contract, member, writer.Top, CollectionUtils.ArrayEmpty()); - - if (hasWrittenMetadataObject) - { - writer.WriteEndObject(); - } - - _serializeStack.RemoveAt(_serializeStack.Count - 1); - - OnSerialized(writer, contract, values); - } - - private void SerializeMultidimensionalArray(JsonWriter writer, Array values, JsonArrayContract contract, JsonProperty? member, int initialDepth, int[] indices) - { - int dimension = indices.Length; - int[] newIndices = new int[dimension + 1]; - for (int i = 0; i < dimension; i++) - { - newIndices[i] = indices[i]; - } - - writer.WriteStartArray(); - - for (int i = values.GetLowerBound(dimension); i <= values.GetUpperBound(dimension); i++) - { - newIndices[dimension] = i; - bool isTopLevel = (newIndices.Length == values.Rank); - - if (isTopLevel) - { - object value = values.GetValue(newIndices); - - try - { - JsonContract? valueContract = contract.FinalItemContract ?? GetContractSafe(value); - - if (ShouldWriteReference(value, null, valueContract, contract, member)) - { - WriteReference(writer, value); - } - else - { - if (CheckForCircularReference(writer, value, null, valueContract, contract, member)) - { - SerializeValue(writer, value, valueContract, null, contract, member); - } - } - } - catch (Exception ex) - { - if (IsErrorHandled(values, contract, i, null, writer.ContainerPath, ex)) - { - HandleError(writer, initialDepth + 1); - } - else - { - throw; - } - } - } - else - { - SerializeMultidimensionalArray(writer, values, contract, member, initialDepth + 1, newIndices); - } - } - - writer.WriteEndArray(); - } - - private bool WriteStartArray(JsonWriter writer, object values, JsonArrayContract contract, JsonProperty? member, JsonContainerContract? containerContract, JsonProperty? containerProperty) - { - bool isReference = ResolveIsReference(contract, member, containerContract, containerProperty) ?? HasFlag(Serializer._preserveReferencesHandling, PreserveReferencesHandling.Arrays); - // don't make readonly fields that aren't creator parameters the referenced value because they can't be deserialized to - isReference = (isReference && (member == null || member.Writable || HasCreatorParameter(containerContract, member))); - - bool includeTypeDetails = ShouldWriteType(TypeNameHandling.Arrays, contract, member, containerContract, containerProperty); - bool writeMetadataObject = isReference || includeTypeDetails; - - if (writeMetadataObject) - { - writer.WriteStartObject(); - - if (isReference) - { - WriteReferenceIdProperty(writer, contract.UnderlyingType, values); - } - if (includeTypeDetails) - { - WriteTypeProperty(writer, values.GetType()); - } - writer.WritePropertyName(JsonTypeReflector.ArrayValuesPropertyName, false); - } - - if (contract.ItemContract == null) - { - contract.ItemContract = Serializer._contractResolver.ResolveContract(contract.CollectionItemType ?? typeof(object)); - } - - return writeMetadataObject; - } - -#if HAVE_BINARY_SERIALIZATION -#if HAVE_SECURITY_SAFE_CRITICAL_ATTRIBUTE - [SecuritySafeCritical] -#endif - private void SerializeISerializable(JsonWriter writer, ISerializable value, JsonISerializableContract contract, JsonProperty? member, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { - if (!JsonTypeReflector.FullyTrusted) - { - string message = @"Type '{0}' implements ISerializable but cannot be serialized using the ISerializable interface because the current application is not fully trusted and ISerializable can expose secure data." + Environment.NewLine + - @"To fix this error either change the environment to be fully trusted, change the application to not deserialize the type, add JsonObjectAttribute to the type or change the JsonSerializer setting ContractResolver to use a new DefaultContractResolver with IgnoreSerializableInterface set to true." + Environment.NewLine; - message = message.FormatWith(CultureInfo.InvariantCulture, value.GetType()); - - throw JsonSerializationException.Create(null, writer.ContainerPath, message, null); - } - - OnSerializing(writer, contract, value); - _serializeStack.Add(value); - - WriteObjectStart(writer, value, contract, member, collectionContract, containerProperty); - - SerializationInfo serializationInfo = new SerializationInfo(contract.UnderlyingType, new FormatterConverter()); - value.GetObjectData(serializationInfo, Serializer._context); - - foreach (SerializationEntry serializationEntry in serializationInfo) - { - JsonContract? valueContract = GetContractSafe(serializationEntry.Value); - - if (ShouldWriteReference(serializationEntry.Value, null, valueContract, contract, member)) - { - writer.WritePropertyName(serializationEntry.Name); - WriteReference(writer, serializationEntry.Value); - } - else if (CheckForCircularReference(writer, serializationEntry.Value, null, valueContract, contract, member)) - { - writer.WritePropertyName(serializationEntry.Name); - SerializeValue(writer, serializationEntry.Value, valueContract, null, contract, member); - } - } - - writer.WriteEndObject(); - - _serializeStack.RemoveAt(_serializeStack.Count - 1); - OnSerialized(writer, contract, value); - } -#endif - -#if HAVE_DYNAMIC - private void SerializeDynamic(JsonWriter writer, IDynamicMetaObjectProvider value, JsonDynamicContract contract, JsonProperty? member, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { - OnSerializing(writer, contract, value); - _serializeStack.Add(value); - - WriteObjectStart(writer, value, contract, member, collectionContract, containerProperty); - - int initialDepth = writer.Top; - - for (int index = 0; index < contract.Properties.Count; index++) - { - JsonProperty property = contract.Properties[index]; - - // only write non-dynamic properties that have an explicit attribute - if (property.HasMemberAttribute) - { - try - { - if (!CalculatePropertyValues(writer, value, contract, member, property, out JsonContract? memberContract, out object? memberValue)) - { - continue; - } - - property.WritePropertyName(writer); - SerializeValue(writer, memberValue, memberContract, property, contract, member); - } - catch (Exception ex) - { - if (IsErrorHandled(value, contract, property.PropertyName, null, writer.ContainerPath, ex)) - { - HandleError(writer, initialDepth); - } - else - { - throw; - } - } - } - } - - foreach (string memberName in value.GetDynamicMemberNames()) - { - if (contract.TryGetMember(value, memberName, out object? memberValue)) - { - try - { - JsonContract? valueContract = GetContractSafe(memberValue); - - if (!ShouldWriteDynamicProperty(memberValue)) - { - continue; - } - - if (CheckForCircularReference(writer, memberValue, null, valueContract, contract, member)) - { - string resolvedPropertyName = (contract.PropertyNameResolver != null) - ? contract.PropertyNameResolver(memberName) - : memberName; - - writer.WritePropertyName(resolvedPropertyName); - SerializeValue(writer, memberValue, valueContract, null, contract, member); - } - } - catch (Exception ex) - { - if (IsErrorHandled(value, contract, memberName, null, writer.ContainerPath, ex)) - { - HandleError(writer, initialDepth); - } - else - { - throw; - } - } - } - } - - writer.WriteEndObject(); - - _serializeStack.RemoveAt(_serializeStack.Count - 1); - OnSerialized(writer, contract, value); - } -#endif - - private bool ShouldWriteDynamicProperty(object? memberValue) - { - if (Serializer._nullValueHandling == NullValueHandling.Ignore && memberValue == null) - { - return false; - } - - if (HasFlag(Serializer._defaultValueHandling, DefaultValueHandling.Ignore) && - (memberValue == null || MiscellaneousUtils.ValueEquals(memberValue, ReflectionUtils.GetDefaultValue(memberValue.GetType())))) - { - return false; - } - - return true; - } - - private bool ShouldWriteType(TypeNameHandling typeNameHandlingFlag, JsonContract contract, JsonProperty? member, JsonContainerContract? containerContract, JsonProperty? containerProperty) - { - TypeNameHandling resolvedTypeNameHandling = - member?.TypeNameHandling - ?? containerProperty?.ItemTypeNameHandling - ?? containerContract?.ItemTypeNameHandling - ?? Serializer._typeNameHandling; - - if (HasFlag(resolvedTypeNameHandling, typeNameHandlingFlag)) - { - return true; - } - - // instance type and the property's type's contract default type are different (no need to put the type in JSON because the type will be created by default) - if (HasFlag(resolvedTypeNameHandling, TypeNameHandling.Auto)) - { - if (member != null) - { - if (contract.NonNullableUnderlyingType != member.PropertyContract!.CreatedType) - { - return true; - } - } - else if (containerContract != null) - { - if (containerContract.ItemContract == null || contract.NonNullableUnderlyingType != containerContract.ItemContract.CreatedType) - { - return true; - } - } - else if (_rootType != null && _serializeStack.Count == _rootLevel) - { - JsonContract rootContract = Serializer._contractResolver.ResolveContract(_rootType); - - if (contract.NonNullableUnderlyingType != rootContract.CreatedType) - { - return true; - } - } - } - - return false; - } - - private void SerializeDictionary(JsonWriter writer, IDictionary values, JsonDictionaryContract contract, JsonProperty? member, JsonContainerContract? collectionContract, JsonProperty? containerProperty) - { -#pragma warning disable CS8600, CS8602, CS8604 - object underlyingDictionary = values is IWrappedDictionary wrappedDictionary ? wrappedDictionary.UnderlyingDictionary : values; - - OnSerializing(writer, contract, underlyingDictionary); - _serializeStack.Add(underlyingDictionary); - - WriteObjectStart(writer, underlyingDictionary, contract, member, collectionContract, containerProperty); - - if (contract.ItemContract == null) - { - contract.ItemContract = Serializer._contractResolver.ResolveContract(contract.DictionaryValueType ?? typeof(object)); - } - - if (contract.KeyContract == null) - { - contract.KeyContract = Serializer._contractResolver.ResolveContract(contract.DictionaryKeyType ?? typeof(object)); - } - - int initialDepth = writer.Top; - - // Manual use of IDictionaryEnumerator instead of foreach to avoid DictionaryEntry box allocations. - IDictionaryEnumerator e = values.GetEnumerator(); - try - { - while (e.MoveNext()) - { - DictionaryEntry entry = e.Entry; - - string propertyName = GetPropertyName(writer, entry.Key, contract.KeyContract, out bool escape); - - propertyName = (contract.DictionaryKeyResolver != null) - ? contract.DictionaryKeyResolver(propertyName) - : propertyName; - - try - { - object value = entry.Value; - JsonContract? valueContract = contract.FinalItemContract ?? GetContractSafe(value); - - if (ShouldWriteReference(value, null, valueContract, contract, member)) - { - writer.WritePropertyName(propertyName, escape); - WriteReference(writer, value); - } - else - { - if (!CheckForCircularReference(writer, value, null, valueContract, contract, member)) - { - continue; - } - - writer.WritePropertyName(propertyName, escape); - - SerializeValue(writer, value, valueContract, null, contract, member); - } - } - catch (Exception ex) - { - if (IsErrorHandled(underlyingDictionary, contract, propertyName, null, writer.ContainerPath, ex)) - { - HandleError(writer, initialDepth); - } - else - { - throw; - } - } - } - } - finally - { - (e as IDisposable)?.Dispose(); - } - - writer.WriteEndObject(); - - _serializeStack.RemoveAt(_serializeStack.Count - 1); - - OnSerialized(writer, contract, underlyingDictionary); -#pragma warning restore CS8600, CS8602, CS8604 - } - - private string GetPropertyName(JsonWriter writer, object name, JsonContract contract, out bool escape) - { - if (contract.ContractType == JsonContractType.Primitive) - { - JsonPrimitiveContract primitiveContract = (JsonPrimitiveContract)contract; - switch (primitiveContract.TypeCode) - { - case PrimitiveTypeCode.DateTime: - case PrimitiveTypeCode.DateTimeNullable: - { - DateTime dt = DateTimeUtils.EnsureDateTime((DateTime)name, writer.DateTimeZoneHandling); - - escape = false; - StringWriter sw = new StringWriter(CultureInfo.InvariantCulture); - DateTimeUtils.WriteDateTimeString(sw, dt, writer.DateFormatHandling, writer.DateFormatString, writer.Culture); - return sw.ToString(); - } -#if HAVE_DATE_TIME_OFFSET - case PrimitiveTypeCode.DateTimeOffset: - case PrimitiveTypeCode.DateTimeOffsetNullable: - { - escape = false; - StringWriter sw = new StringWriter(CultureInfo.InvariantCulture); - DateTimeUtils.WriteDateTimeOffsetString(sw, (DateTimeOffset)name, writer.DateFormatHandling, writer.DateFormatString, writer.Culture); - return sw.ToString(); - } -#endif - case PrimitiveTypeCode.Double: - case PrimitiveTypeCode.DoubleNullable: - { - double d = (double)name; - - escape = false; - return d.ToString("R", CultureInfo.InvariantCulture); - } - case PrimitiveTypeCode.Single: - case PrimitiveTypeCode.SingleNullable: - { - float f = (float)name; - - escape = false; - return f.ToString("R", CultureInfo.InvariantCulture); - } - default: - { - escape = true; - - if (primitiveContract.IsEnum && EnumUtils.TryToString(primitiveContract.NonNullableUnderlyingType, name, null, out string? enumName)) - { - return enumName; - } - - return Convert.ToString(name, CultureInfo.InvariantCulture); - } - } - } - else if (TryConvertToString(name, name.GetType(), out string? propertyName)) - { - escape = true; - return propertyName; - } - else - { - escape = true; - return name.ToString(); - } - } - - private void HandleError(JsonWriter writer, int initialDepth) - { - ClearErrorContext(); - - if (writer.WriteState == WriteState.Property) - { - writer.WriteNull(); - } - - while (writer.Top > initialDepth) - { - writer.WriteEnd(); - } - } - - private bool ShouldSerialize(JsonWriter writer, JsonProperty property, object target) - { - if (property.ShouldSerialize == null) - { - return true; - } - - bool shouldSerialize = property.ShouldSerialize(target); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(null, writer.Path, "ShouldSerialize result for property '{0}' on {1}: {2}".FormatWith(CultureInfo.InvariantCulture, property.PropertyName, property.DeclaringType, shouldSerialize)), null); - } - - return shouldSerialize; - } - - private bool IsSpecified(JsonWriter writer, JsonProperty property, object target) - { - if (property.GetIsSpecified == null) - { - return true; - } - - bool isSpecified = property.GetIsSpecified(target); - - if (TraceWriter != null && TraceWriter.LevelFilter >= TraceLevel.Verbose) - { - TraceWriter.Trace(TraceLevel.Verbose, JsonPosition.FormatMessage(null, writer.Path, "IsSpecified result for property '{0}' on {1}: {2}".FormatWith(CultureInfo.InvariantCulture, property.PropertyName, property.DeclaringType, isSpecified)), null); - } - - return isSpecified; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerProxy.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerProxy.cs deleted file mode 100644 index a122fe0..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonSerializerProxy.cs +++ /dev/null @@ -1,289 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Globalization; -using System.Runtime.Serialization.Formatters; -using Newtonsoft.Json.Utilities; -using System.Runtime.Serialization; - -namespace Newtonsoft.Json.Serialization -{ - internal class JsonSerializerProxy : JsonSerializer - { - private readonly JsonSerializerInternalReader? _serializerReader; - private readonly JsonSerializerInternalWriter? _serializerWriter; - internal readonly JsonSerializer _serializer; - - public override event EventHandler? Error - { - add => _serializer.Error += value; - remove => _serializer.Error -= value; - } - - public override IReferenceResolver? ReferenceResolver - { - get => _serializer.ReferenceResolver; - set => _serializer.ReferenceResolver = value; - } - - public override ITraceWriter? TraceWriter - { - get => _serializer.TraceWriter; - set => _serializer.TraceWriter = value; - } - - public override IEqualityComparer? EqualityComparer - { - get => _serializer.EqualityComparer; - set => _serializer.EqualityComparer = value; - } - - public override JsonConverterCollection Converters => _serializer.Converters; - - public override DefaultValueHandling DefaultValueHandling - { - get => _serializer.DefaultValueHandling; - set => _serializer.DefaultValueHandling = value; - } - - public override IContractResolver ContractResolver - { - get => _serializer.ContractResolver; - set => _serializer.ContractResolver = value; - } - - public override MissingMemberHandling MissingMemberHandling - { - get => _serializer.MissingMemberHandling; - set => _serializer.MissingMemberHandling = value; - } - - public override NullValueHandling NullValueHandling - { - get => _serializer.NullValueHandling; - set => _serializer.NullValueHandling = value; - } - - public override ObjectCreationHandling ObjectCreationHandling - { - get => _serializer.ObjectCreationHandling; - set => _serializer.ObjectCreationHandling = value; - } - - public override ReferenceLoopHandling ReferenceLoopHandling - { - get => _serializer.ReferenceLoopHandling; - set => _serializer.ReferenceLoopHandling = value; - } - - public override PreserveReferencesHandling PreserveReferencesHandling - { - get => _serializer.PreserveReferencesHandling; - set => _serializer.PreserveReferencesHandling = value; - } - - public override TypeNameHandling TypeNameHandling - { - get => _serializer.TypeNameHandling; - set => _serializer.TypeNameHandling = value; - } - - public override MetadataPropertyHandling MetadataPropertyHandling - { - get => _serializer.MetadataPropertyHandling; - set => _serializer.MetadataPropertyHandling = value; - } - - [Obsolete("TypeNameAssemblyFormat is obsolete. Use TypeNameAssemblyFormatHandling instead.")] - public override FormatterAssemblyStyle TypeNameAssemblyFormat - { - get => _serializer.TypeNameAssemblyFormat; - set => _serializer.TypeNameAssemblyFormat = value; - } - - public override TypeNameAssemblyFormatHandling TypeNameAssemblyFormatHandling - { - get => _serializer.TypeNameAssemblyFormatHandling; - set => _serializer.TypeNameAssemblyFormatHandling = value; - } - - public override ConstructorHandling ConstructorHandling - { - get => _serializer.ConstructorHandling; - set => _serializer.ConstructorHandling = value; - } - - [Obsolete("Binder is obsolete. Use SerializationBinder instead.")] - public override SerializationBinder Binder - { - get => _serializer.Binder; - set => _serializer.Binder = value; - } - - public override ISerializationBinder SerializationBinder - { - get => _serializer.SerializationBinder; - set => _serializer.SerializationBinder = value; - } - - public override StreamingContext Context - { - get => _serializer.Context; - set => _serializer.Context = value; - } - - public override Formatting Formatting - { - get => _serializer.Formatting; - set => _serializer.Formatting = value; - } - - public override DateFormatHandling DateFormatHandling - { - get => _serializer.DateFormatHandling; - set => _serializer.DateFormatHandling = value; - } - - public override DateTimeZoneHandling DateTimeZoneHandling - { - get => _serializer.DateTimeZoneHandling; - set => _serializer.DateTimeZoneHandling = value; - } - - public override DateParseHandling DateParseHandling - { - get => _serializer.DateParseHandling; - set => _serializer.DateParseHandling = value; - } - - public override FloatFormatHandling FloatFormatHandling - { - get => _serializer.FloatFormatHandling; - set => _serializer.FloatFormatHandling = value; - } - - public override FloatParseHandling FloatParseHandling - { - get => _serializer.FloatParseHandling; - set => _serializer.FloatParseHandling = value; - } - - public override StringEscapeHandling StringEscapeHandling - { - get => _serializer.StringEscapeHandling; - set => _serializer.StringEscapeHandling = value; - } - - public override string DateFormatString - { - get => _serializer.DateFormatString; - set => _serializer.DateFormatString = value; - } - - public override CultureInfo Culture - { - get => _serializer.Culture; - set => _serializer.Culture = value; - } - - public override int? MaxDepth - { - get => _serializer.MaxDepth; - set => _serializer.MaxDepth = value; - } - - public override bool CheckAdditionalContent - { - get => _serializer.CheckAdditionalContent; - set => _serializer.CheckAdditionalContent = value; - } - - internal JsonSerializerInternalBase GetInternalSerializer() - { - if (_serializerReader != null) - { - return _serializerReader; - } - else - { - return _serializerWriter!; - } - } - - public JsonSerializerProxy(JsonSerializerInternalReader serializerReader) - { - ValidationUtils.ArgumentNotNull(serializerReader, nameof(serializerReader)); - - _serializerReader = serializerReader; - _serializer = serializerReader.Serializer; - } - - public JsonSerializerProxy(JsonSerializerInternalWriter serializerWriter) - { - ValidationUtils.ArgumentNotNull(serializerWriter, nameof(serializerWriter)); - - _serializerWriter = serializerWriter; - _serializer = serializerWriter.Serializer; - } - - internal override object? DeserializeInternal(JsonReader reader, Type? objectType) - { - if (_serializerReader != null) - { - return _serializerReader.Deserialize(reader, objectType, false); - } - else - { - return _serializer.Deserialize(reader, objectType); - } - } - - internal override void PopulateInternal(JsonReader reader, object target) - { - if (_serializerReader != null) - { - _serializerReader.Populate(reader, target); - } - else - { - _serializer.Populate(reader, target); - } - } - - internal override void SerializeInternal(JsonWriter jsonWriter, object? value, Type? rootType) - { - if (_serializerWriter != null) - { - _serializerWriter.Serialize(jsonWriter, value, rootType); - } - else - { - _serializer.Serialize(jsonWriter, value); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonStringContract.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonStringContract.cs deleted file mode 100644 index be096bc..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonStringContract.cs +++ /dev/null @@ -1,45 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Contract details for a used by the . - /// - public class JsonStringContract : JsonPrimitiveContract - { - /// - /// Initializes a new instance of the class. - /// - /// The underlying type for the contract. - public JsonStringContract(Type underlyingType) - : base(underlyingType) - { - ContractType = JsonContractType.String; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/JsonTypeReflector.cs b/Source/MyDb/Newtonsoft.Json/Serialization/JsonTypeReflector.cs deleted file mode 100644 index 28783b4..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/JsonTypeReflector.cs +++ /dev/null @@ -1,531 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.ComponentModel; -using System.Globalization; -using System.Reflection; -using System.Security; -#if HAVE_CAS -using System.Security.Permissions; -#endif -using Newtonsoft.Json.Utilities; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using System.Runtime.Serialization; - -namespace Newtonsoft.Json.Serialization -{ - internal static class JsonTypeReflector - { - private static bool? _dynamicCodeGeneration; - private static bool? _fullyTrusted; - - public const string IdPropertyName = "$id"; - public const string RefPropertyName = "$ref"; - public const string TypePropertyName = "$type"; - public const string ValuePropertyName = "$value"; - public const string ArrayValuesPropertyName = "$values"; - - public const string ShouldSerializePrefix = "ShouldSerialize"; - public const string SpecifiedPostfix = "Specified"; - - public const string ConcurrentDictionaryTypeName = "System.Collections.Concurrent.ConcurrentDictionary`2"; - - private static readonly ThreadSafeStore> CreatorCache = - new ThreadSafeStore>(GetCreator); - -#if !(NET20 || DOTNET) - private static readonly ThreadSafeStore AssociatedMetadataTypesCache = new ThreadSafeStore(GetAssociateMetadataTypeFromAttribute); - private static ReflectionObject? _metadataTypeAttributeReflectionObject; -#endif - - public static T? GetCachedAttribute(object attributeProvider) where T : Attribute - { - return CachedAttributeGetter.GetAttribute(attributeProvider); - } - -#if HAVE_TYPE_DESCRIPTOR - public static bool CanTypeDescriptorConvertString(Type type, out TypeConverter typeConverter) - { - typeConverter = TypeDescriptor.GetConverter(type); - - // use the objectType's TypeConverter if it has one and can convert to a string - if (typeConverter != null) - { - Type converterType = typeConverter.GetType(); - - if (!string.Equals(converterType.FullName, "System.ComponentModel.ComponentConverter", StringComparison.Ordinal) - && !string.Equals(converterType.FullName, "System.ComponentModel.ReferenceConverter", StringComparison.Ordinal) - && !string.Equals(converterType.FullName, "System.Windows.Forms.Design.DataSourceConverter", StringComparison.Ordinal) - && converterType != typeof(TypeConverter)) - { - return typeConverter.CanConvertTo(typeof(string)); - } - - } - - return false; - } -#endif - -#if HAVE_DATA_CONTRACTS - public static DataContractAttribute? GetDataContractAttribute(Type type) - { - // DataContractAttribute does not have inheritance - Type currentType = type; - - while (currentType != null) - { - DataContractAttribute? result = CachedAttributeGetter.GetAttribute(currentType); - if (result != null) - { - return result; - } - - currentType = currentType.BaseType(); - } - - return null; - } - - public static DataMemberAttribute? GetDataMemberAttribute(MemberInfo memberInfo) - { - // DataMemberAttribute does not have inheritance - - // can't override a field - if (memberInfo.MemberType() == MemberTypes.Field) - { - return CachedAttributeGetter.GetAttribute(memberInfo); - } - - // search property and then search base properties if nothing is returned and the property is virtual - PropertyInfo propertyInfo = (PropertyInfo)memberInfo; - DataMemberAttribute? result = CachedAttributeGetter.GetAttribute(propertyInfo); - if (result == null) - { - if (propertyInfo.IsVirtual()) - { - Type currentType = propertyInfo.DeclaringType; - - while (result == null && currentType != null) - { - PropertyInfo baseProperty = (PropertyInfo)ReflectionUtils.GetMemberInfoFromType(currentType, propertyInfo); - if (baseProperty != null && baseProperty.IsVirtual()) - { - result = CachedAttributeGetter.GetAttribute(baseProperty); - } - - currentType = currentType.BaseType(); - } - } - } - - return result; - } -#endif - - public static MemberSerialization GetObjectMemberSerialization(Type objectType, bool ignoreSerializableAttribute) - { - JsonObjectAttribute? objectAttribute = GetCachedAttribute(objectType); - if (objectAttribute != null) - { - return objectAttribute.MemberSerialization; - } - -#if HAVE_DATA_CONTRACTS - DataContractAttribute? dataContractAttribute = GetDataContractAttribute(objectType); - if (dataContractAttribute != null) - { - return MemberSerialization.OptIn; - } -#endif - -#if HAVE_BINARY_SERIALIZATION - if (!ignoreSerializableAttribute && IsSerializable(objectType)) - { - return MemberSerialization.Fields; - } -#endif - - // the default - return MemberSerialization.OptOut; - } - - public static JsonConverter? GetJsonConverter(object attributeProvider) - { - JsonConverterAttribute? converterAttribute = GetCachedAttribute(attributeProvider); - - if (converterAttribute != null) - { - Func creator = CreatorCache.Get(converterAttribute.ConverterType); - if (creator != null) - { - return (JsonConverter)creator(converterAttribute.ConverterParameters); - } - } - - return null; - } - - /// - /// Lookup and create an instance of the type described by the argument. - /// - /// The type to create. - /// Optional arguments to pass to an initializing constructor of the JsonConverter. - /// If null, the default constructor is used. - public static JsonConverter CreateJsonConverterInstance(Type converterType, object[]? args) - { - Func converterCreator = CreatorCache.Get(converterType); - return (JsonConverter)converterCreator(args); - } - - public static NamingStrategy CreateNamingStrategyInstance(Type namingStrategyType, object[]? args) - { - Func converterCreator = CreatorCache.Get(namingStrategyType); - return (NamingStrategy)converterCreator(args); - } - - public static NamingStrategy? GetContainerNamingStrategy(JsonContainerAttribute containerAttribute) - { - if (containerAttribute.NamingStrategyInstance == null) - { - if (containerAttribute.NamingStrategyType == null) - { - return null; - } - - containerAttribute.NamingStrategyInstance = CreateNamingStrategyInstance(containerAttribute.NamingStrategyType, containerAttribute.NamingStrategyParameters); - } - - return containerAttribute.NamingStrategyInstance; - } - - private static Func GetCreator(Type type) - { - Func? defaultConstructor = (ReflectionUtils.HasDefaultConstructor(type, false)) - ? ReflectionDelegateFactory.CreateDefaultConstructor(type) - : null; - - return (parameters) => - { - try - { - if (parameters != null) - { - Type[] paramTypes = parameters.Select(param => - { - if (param == null) - { - throw new InvalidOperationException("Cannot pass a null parameter to the constructor."); - } - - return param.GetType(); - }).ToArray(); - ConstructorInfo parameterizedConstructorInfo = type.GetConstructor(paramTypes); - - if (parameterizedConstructorInfo != null) - { - ObjectConstructor parameterizedConstructor = ReflectionDelegateFactory.CreateParameterizedConstructor(parameterizedConstructorInfo); - return parameterizedConstructor(parameters); - } - else - { - throw new JsonException("No matching parameterized constructor found for '{0}'.".FormatWith(CultureInfo.InvariantCulture, type)); - } - } - - if (defaultConstructor == null) - { - throw new JsonException("No parameterless constructor defined for '{0}'.".FormatWith(CultureInfo.InvariantCulture, type)); - } - - return defaultConstructor(); - } - catch (Exception ex) - { - throw new JsonException("Error creating '{0}'.".FormatWith(CultureInfo.InvariantCulture, type), ex); - } - }; - } - -#if !(NET20 || DOTNET) - private static Type? GetAssociatedMetadataType(Type type) - { - return AssociatedMetadataTypesCache.Get(type); - } - - private static Type? GetAssociateMetadataTypeFromAttribute(Type type) - { - Attribute[] customAttributes = ReflectionUtils.GetAttributes(type, null, true); - - foreach (Attribute attribute in customAttributes) - { - Type attributeType = attribute.GetType(); - - // only test on attribute type name - // attribute assembly could change because of type forwarding, etc - if (string.Equals(attributeType.FullName, "System.ComponentModel.DataAnnotations.MetadataTypeAttribute", StringComparison.Ordinal)) - { - const string metadataClassTypeName = "MetadataClassType"; - - if (_metadataTypeAttributeReflectionObject == null) - { - _metadataTypeAttributeReflectionObject = ReflectionObject.Create(attributeType, metadataClassTypeName); - } - - return (Type?)_metadataTypeAttributeReflectionObject.GetValue(attribute, metadataClassTypeName); - } - } - - return null; - } -#endif - - private static T? GetAttribute(Type type) where T : Attribute - { - T? attribute; - -#if !(NET20 || DOTNET) - Type? metadataType = GetAssociatedMetadataType(type); - if (metadataType != null) - { - attribute = ReflectionUtils.GetAttribute(metadataType, true); - if (attribute != null) - { - return attribute; - } - } -#endif - - attribute = ReflectionUtils.GetAttribute(type, true); - if (attribute != null) - { - return attribute; - } - - foreach (Type typeInterface in type.GetInterfaces()) - { - attribute = ReflectionUtils.GetAttribute(typeInterface, true); - if (attribute != null) - { - return attribute; - } - } - - return null; - } - - private static T? GetAttribute(MemberInfo memberInfo) where T : Attribute - { - T? attribute; - -#if !(NET20 || DOTNET) - Type? metadataType = GetAssociatedMetadataType(memberInfo.DeclaringType); - if (metadataType != null) - { - MemberInfo metadataTypeMemberInfo = ReflectionUtils.GetMemberInfoFromType(metadataType, memberInfo); - - if (metadataTypeMemberInfo != null) - { - attribute = ReflectionUtils.GetAttribute(metadataTypeMemberInfo, true); - if (attribute != null) - { - return attribute; - } - } - } -#endif - - attribute = ReflectionUtils.GetAttribute(memberInfo, true); - if (attribute != null) - { - return attribute; - } - - if (memberInfo.DeclaringType != null) - { - foreach (Type typeInterface in memberInfo.DeclaringType.GetInterfaces()) - { - MemberInfo interfaceTypeMemberInfo = ReflectionUtils.GetMemberInfoFromType(typeInterface, memberInfo); - - if (interfaceTypeMemberInfo != null) - { - attribute = ReflectionUtils.GetAttribute(interfaceTypeMemberInfo, true); - if (attribute != null) - { - return attribute; - } - } - } - } - - return null; - } - -#if HAVE_NON_SERIALIZED_ATTRIBUTE - public static bool IsNonSerializable(object provider) - { -#if HAVE_FULL_REFLECTION - // no inheritance - return (ReflectionUtils.GetAttribute(provider, false) != null); -#else - if (provider is FieldInfo fieldInfo && (fieldInfo.Attributes & FieldAttributes.NotSerialized) == FieldAttributes.NotSerialized) - { - return true; - } - - return false; -#endif - } -#endif - -#if HAVE_BINARY_SERIALIZATION - public static bool IsSerializable(object provider) - { -#if HAVE_FULL_REFLECTION - // no inheritance - return (ReflectionUtils.GetAttribute(provider, false) != null); -#else - if (provider is Type type && (type.GetTypeInfo().Attributes & TypeAttributes.Serializable) == TypeAttributes.Serializable) - { - return true; - } - - return false; -#endif - } -#endif - - public static T? GetAttribute(object provider) where T : Attribute - { - if (provider is Type type) - { - return GetAttribute(type); - } - - if (provider is MemberInfo memberInfo) - { - return GetAttribute(memberInfo); - } - - return ReflectionUtils.GetAttribute(provider, true); - } - -#if DEBUG - internal static void SetFullyTrusted(bool? fullyTrusted) - { - _fullyTrusted = fullyTrusted; - } - - internal static void SetDynamicCodeGeneration(bool dynamicCodeGeneration) - { - _dynamicCodeGeneration = dynamicCodeGeneration; - } -#endif - - public static bool DynamicCodeGeneration - { -#if HAVE_SECURITY_SAFE_CRITICAL_ATTRIBUTE - [SecuritySafeCritical] -#endif - get - { - if (_dynamicCodeGeneration == null) - { -#if HAVE_CAS - try - { - new ReflectionPermission(ReflectionPermissionFlag.MemberAccess).Demand(); - new ReflectionPermission(ReflectionPermissionFlag.RestrictedMemberAccess).Demand(); - new SecurityPermission(SecurityPermissionFlag.SkipVerification).Demand(); - new SecurityPermission(SecurityPermissionFlag.UnmanagedCode).Demand(); - new SecurityPermission(PermissionState.Unrestricted).Demand(); - _dynamicCodeGeneration = true; - } - catch (Exception) - { - _dynamicCodeGeneration = false; - } -#else - _dynamicCodeGeneration = false; -#endif - } - - return _dynamicCodeGeneration.GetValueOrDefault(); - } - } - - public static bool FullyTrusted - { - get - { - if (_fullyTrusted == null) - { -#if (DOTNET || PORTABLE || PORTABLE40) - _fullyTrusted = true; -#elif !(NET20 || NET35 || PORTABLE40) - AppDomain appDomain = AppDomain.CurrentDomain; - - _fullyTrusted = appDomain.IsHomogenous && appDomain.IsFullyTrusted; -#else - try - { - new SecurityPermission(PermissionState.Unrestricted).Demand(); - _fullyTrusted = true; - } - catch (Exception) - { - _fullyTrusted = false; - } -#endif - } - - return _fullyTrusted.GetValueOrDefault(); - } - } - - public static ReflectionDelegateFactory ReflectionDelegateFactory - { - get - { -#if !(PORTABLE40 || PORTABLE || DOTNET || NETSTANDARD2_0) - if (DynamicCodeGeneration) - { - return DynamicReflectionDelegateFactory.Instance; - } - - return LateBoundReflectionDelegateFactory.Instance; -#else - return ExpressionReflectionDelegateFactory.Instance; -#endif - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/KebabCaseNamingStrategy.cs b/Source/MyDb/Newtonsoft.Json/Serialization/KebabCaseNamingStrategy.cs deleted file mode 100644 index 16ac282..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/KebabCaseNamingStrategy.cs +++ /dev/null @@ -1,84 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// A kebab case naming strategy. - /// - public class KebabCaseNamingStrategy : NamingStrategy - { - /// - /// Initializes a new instance of the class. - /// - /// - /// A flag indicating whether dictionary keys should be processed. - /// - /// - /// A flag indicating whether explicitly specified property names should be processed, - /// e.g. a property name customized with a . - /// - public KebabCaseNamingStrategy(bool processDictionaryKeys, bool overrideSpecifiedNames) - { - ProcessDictionaryKeys = processDictionaryKeys; - OverrideSpecifiedNames = overrideSpecifiedNames; - } - - /// - /// Initializes a new instance of the class. - /// - /// - /// A flag indicating whether dictionary keys should be processed. - /// - /// - /// A flag indicating whether explicitly specified property names should be processed, - /// e.g. a property name customized with a . - /// - /// - /// A flag indicating whether extension data names should be processed. - /// - public KebabCaseNamingStrategy(bool processDictionaryKeys, bool overrideSpecifiedNames, bool processExtensionDataNames) - : this(processDictionaryKeys, overrideSpecifiedNames) - { - ProcessExtensionDataNames = processExtensionDataNames; - } - - /// - /// Initializes a new instance of the class. - /// - public KebabCaseNamingStrategy() - { - } - - /// - /// Resolves the specified property name. - /// - /// The property name to resolve. - /// The resolved property name. - protected override string ResolvePropertyName(string name) => StringUtils.ToKebabCase(name); - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/MemoryTraceWriter.cs b/Source/MyDb/Newtonsoft.Json/Serialization/MemoryTraceWriter.cs deleted file mode 100644 index a2672ed..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/MemoryTraceWriter.cs +++ /dev/null @@ -1,100 +0,0 @@ -using System; -using System.Collections.Generic; -using System.Diagnostics; -using System.Globalization; -using System.Text; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Represents a trace writer that writes to memory. When the trace message limit is - /// reached then old trace messages will be removed as new messages are added. - /// - public class MemoryTraceWriter : ITraceWriter - { - private readonly Queue _traceMessages; - private readonly object _lock; - - /// - /// Gets the that will be used to filter the trace messages passed to the writer. - /// For example a filter level of will exclude messages and include , - /// and messages. - /// - /// - /// The that will be used to filter the trace messages passed to the writer. - /// - public TraceLevel LevelFilter { get; set; } - - /// - /// Initializes a new instance of the class. - /// - public MemoryTraceWriter() - { - LevelFilter = TraceLevel.Verbose; - _traceMessages = new Queue(); - _lock = new object(); - } - - /// - /// Writes the specified trace level, message and optional exception. - /// - /// The at which to write this trace. - /// The trace message. - /// The trace exception. This parameter is optional. - public void Trace(TraceLevel level, string message, Exception? ex) - { - StringBuilder sb = new StringBuilder(); - sb.Append(DateTime.Now.ToString("yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fff", CultureInfo.InvariantCulture)); - sb.Append(" "); - sb.Append(level.ToString("g")); - sb.Append(" "); - sb.Append(message); - - string s = sb.ToString(); - - lock (_lock) - { - if (_traceMessages.Count >= 1000) - { - _traceMessages.Dequeue(); - } - - _traceMessages.Enqueue(s); - } - } - - /// - /// Returns an enumeration of the most recent trace messages. - /// - /// An enumeration of the most recent trace messages. - public IEnumerable GetTraceMessages() - { - return _traceMessages; - } - - /// - /// Returns a of the most recent trace messages. - /// - /// - /// A of the most recent trace messages. - /// - public override string ToString() - { - lock (_lock) - { - StringBuilder sb = new StringBuilder(); - foreach (string traceMessage in _traceMessages) - { - if (sb.Length > 0) - { - sb.AppendLine(); - } - - sb.Append(traceMessage); - } - - return sb.ToString(); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/NamingStrategy.cs b/Source/MyDb/Newtonsoft.Json/Serialization/NamingStrategy.cs deleted file mode 100644 index 8811884..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/NamingStrategy.cs +++ /dev/null @@ -1,146 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Serialization -{ - /// - /// A base class for resolving how property names and dictionary keys are serialized. - /// - public abstract class NamingStrategy - { - /// - /// A flag indicating whether dictionary keys should be processed. - /// Defaults to false. - /// - public bool ProcessDictionaryKeys { get; set; } - - /// - /// A flag indicating whether extension data names should be processed. - /// Defaults to false. - /// - public bool ProcessExtensionDataNames { get; set; } - - /// - /// A flag indicating whether explicitly specified property names, - /// e.g. a property name customized with a , should be processed. - /// Defaults to false. - /// - public bool OverrideSpecifiedNames { get; set; } - - /// - /// Gets the serialized name for a given property name. - /// - /// The initial property name. - /// A flag indicating whether the property has had a name explicitly specified. - /// The serialized property name. - public virtual string GetPropertyName(string name, bool hasSpecifiedName) - { - if (hasSpecifiedName && !OverrideSpecifiedNames) - { - return name; - } - - return ResolvePropertyName(name); - } - - /// - /// Gets the serialized name for a given extension data name. - /// - /// The initial extension data name. - /// The serialized extension data name. - public virtual string GetExtensionDataName(string name) - { - if (!ProcessExtensionDataNames) - { - return name; - } - - return ResolvePropertyName(name); - } - - /// - /// Gets the serialized key for a given dictionary key. - /// - /// The initial dictionary key. - /// The serialized dictionary key. - public virtual string GetDictionaryKey(string key) - { - if (!ProcessDictionaryKeys) - { - return key; - } - - return ResolvePropertyName(key); - } - - /// - /// Resolves the specified property name. - /// - /// The property name to resolve. - /// The resolved property name. - protected abstract string ResolvePropertyName(string name); - - /// - /// Hash code calculation - /// - /// - public override int GetHashCode() - { - unchecked - { - var hashCode = GetType().GetHashCode(); // make sure different types do not result in equal values - hashCode = (hashCode * 397) ^ ProcessDictionaryKeys.GetHashCode(); - hashCode = (hashCode * 397) ^ ProcessExtensionDataNames.GetHashCode(); - hashCode = (hashCode * 397) ^ OverrideSpecifiedNames.GetHashCode(); - return hashCode; - } - } - - /// - /// Object equality implementation - /// - /// - /// - public override bool Equals(object obj) => Equals(obj as NamingStrategy); - - /// - /// Compare to another NamingStrategy - /// - /// - /// - protected bool Equals(NamingStrategy? other) - { - if (other == null) - { - return false; - } - - return GetType() == other.GetType() && - ProcessDictionaryKeys == other.ProcessDictionaryKeys && - ProcessExtensionDataNames == other.ProcessExtensionDataNames && - OverrideSpecifiedNames == other.OverrideSpecifiedNames; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/ObjectConstructor.cs b/Source/MyDb/Newtonsoft.Json/Serialization/ObjectConstructor.cs deleted file mode 100644 index a6945e7..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/ObjectConstructor.cs +++ /dev/null @@ -1,33 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Represents a method that constructs an object. - /// - /// The object type to create. - public delegate object ObjectConstructor(params object?[] args); -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/OnErrorAttribute.cs b/Source/MyDb/Newtonsoft.Json/Serialization/OnErrorAttribute.cs deleted file mode 100644 index cb33296..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/OnErrorAttribute.cs +++ /dev/null @@ -1,37 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// When applied to a method, specifies that the method is called when an error occurs serializing an object. - /// - [AttributeUsage(AttributeTargets.Method, Inherited = false)] - public sealed class OnErrorAttribute : Attribute - { - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/ReflectionAttributeProvider.cs b/Source/MyDb/Newtonsoft.Json/Serialization/ReflectionAttributeProvider.cs deleted file mode 100644 index f98f988..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/ReflectionAttributeProvider.cs +++ /dev/null @@ -1,71 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Reflection; -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Provides methods to get attributes from a , , or . - /// - public class ReflectionAttributeProvider : IAttributeProvider - { - private readonly object _attributeProvider; - - /// - /// Initializes a new instance of the class. - /// - /// The instance to get attributes for. This parameter should be a , , or . - public ReflectionAttributeProvider(object attributeProvider) - { - ValidationUtils.ArgumentNotNull(attributeProvider, nameof(attributeProvider)); - _attributeProvider = attributeProvider; - } - - /// - /// Returns a collection of all of the attributes, or an empty collection if there are no attributes. - /// - /// When true, look up the hierarchy chain for the inherited custom attribute. - /// A collection of s, or an empty collection. - public IList GetAttributes(bool inherit) - { - return ReflectionUtils.GetAttributes(_attributeProvider, null, inherit); - } - - /// - /// Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. - /// - /// The type of the attributes. - /// When true, look up the hierarchy chain for the inherited custom attribute. - /// A collection of s, or an empty collection. - public IList GetAttributes(Type attributeType, bool inherit) - { - return ReflectionUtils.GetAttributes(_attributeProvider, attributeType, inherit); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/ReflectionValueProvider.cs b/Source/MyDb/Newtonsoft.Json/Serialization/ReflectionValueProvider.cs deleted file mode 100644 index 7ad281b..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/ReflectionValueProvider.cs +++ /dev/null @@ -1,90 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Reflection; -using Newtonsoft.Json.Utilities; -using System.Globalization; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// Get and set values for a using reflection. - /// - public class ReflectionValueProvider : IValueProvider - { - private readonly MemberInfo _memberInfo; - - /// - /// Initializes a new instance of the class. - /// - /// The member info. - public ReflectionValueProvider(MemberInfo memberInfo) - { - ValidationUtils.ArgumentNotNull(memberInfo, nameof(memberInfo)); - _memberInfo = memberInfo; - } - - /// - /// Sets the value. - /// - /// The target to set the value on. - /// The value to set on the target. - public void SetValue(object target, object? value) - { - try - { - ReflectionUtils.SetMemberValue(_memberInfo, target, value); - } - catch (Exception ex) - { - throw new JsonSerializationException("Error setting value to '{0}' on '{1}'.".FormatWith(CultureInfo.InvariantCulture, _memberInfo.Name, target.GetType()), ex); - } - } - - /// - /// Gets the value. - /// - /// The target to get the value from. - /// The value. - public object? GetValue(object target) - { - try - { - // https://github.com/dotnet/corefx/issues/26053 - if (_memberInfo is PropertyInfo propertyInfo && propertyInfo.PropertyType.IsByRef) - { - throw new InvalidOperationException("Could not create getter for {0}. ByRef return values are not supported.".FormatWith(CultureInfo.InvariantCulture, propertyInfo)); - } - - return ReflectionUtils.GetMemberValue(_memberInfo, target); - } - catch (Exception ex) - { - throw new JsonSerializationException("Error getting value from '{0}' on '{1}'.".FormatWith(CultureInfo.InvariantCulture, _memberInfo.Name, target.GetType()), ex); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/SerializationBinderAdapter.cs b/Source/MyDb/Newtonsoft.Json/Serialization/SerializationBinderAdapter.cs deleted file mode 100644 index 6a960a3..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/SerializationBinderAdapter.cs +++ /dev/null @@ -1,59 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Runtime.Serialization; - -namespace Newtonsoft.Json.Serialization -{ - internal class SerializationBinderAdapter : ISerializationBinder - { -#pragma warning disable 618 - public readonly SerializationBinder SerializationBinder; -#pragma warning restore 618 - -#pragma warning disable 618 - public SerializationBinderAdapter(SerializationBinder serializationBinder) - { - SerializationBinder = serializationBinder; - } -#pragma warning restore 618 - - public Type BindToType(string? assemblyName, string typeName) - { - return SerializationBinder.BindToType(assemblyName, typeName); - } - - public void BindToName(Type serializedType, out string? assemblyName, out string? typeName) - { -#if HAVE_SERIALIZATION_BINDER_BIND_TO_NAME - SerializationBinder.BindToName(serializedType, out assemblyName, out typeName); -#else - assemblyName = null; - typeName = null; -#endif - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/SnakeCaseNamingStrategy.cs b/Source/MyDb/Newtonsoft.Json/Serialization/SnakeCaseNamingStrategy.cs deleted file mode 100644 index f221079..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/SnakeCaseNamingStrategy.cs +++ /dev/null @@ -1,87 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using Newtonsoft.Json.Utilities; - -namespace Newtonsoft.Json.Serialization -{ - /// - /// A snake case naming strategy. - /// - public class SnakeCaseNamingStrategy : NamingStrategy - { - /// - /// Initializes a new instance of the class. - /// - /// - /// A flag indicating whether dictionary keys should be processed. - /// - /// - /// A flag indicating whether explicitly specified property names should be processed, - /// e.g. a property name customized with a . - /// - public SnakeCaseNamingStrategy(bool processDictionaryKeys, bool overrideSpecifiedNames) - { - ProcessDictionaryKeys = processDictionaryKeys; - OverrideSpecifiedNames = overrideSpecifiedNames; - } - - /// - /// Initializes a new instance of the class. - /// - /// - /// A flag indicating whether dictionary keys should be processed. - /// - /// - /// A flag indicating whether explicitly specified property names should be processed, - /// e.g. a property name customized with a . - /// - /// - /// A flag indicating whether extension data names should be processed. - /// - public SnakeCaseNamingStrategy(bool processDictionaryKeys, bool overrideSpecifiedNames, bool processExtensionDataNames) - : this(processDictionaryKeys, overrideSpecifiedNames) - { - ProcessExtensionDataNames = processExtensionDataNames; - } - - /// - /// Initializes a new instance of the class. - /// - public SnakeCaseNamingStrategy() - { - } - - /// - /// Resolves the specified property name. - /// - /// The property name to resolve. - /// The resolved property name. - protected override string ResolvePropertyName(string name) - { - return StringUtils.ToSnakeCase(name); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/TraceJsonReader.cs b/Source/MyDb/Newtonsoft.Json/Serialization/TraceJsonReader.cs deleted file mode 100644 index 53ab497..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/TraceJsonReader.cs +++ /dev/null @@ -1,157 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; -using System.IO; -using System.Text; - -namespace Newtonsoft.Json.Serialization -{ - internal class TraceJsonReader : JsonReader, IJsonLineInfo - { - private readonly JsonReader _innerReader; - private readonly JsonTextWriter _textWriter; - private readonly StringWriter _sw; - - public TraceJsonReader(JsonReader innerReader) - { - _innerReader = innerReader; - - _sw = new StringWriter(CultureInfo.InvariantCulture); - // prefix the message in the stringwriter to avoid concat with a potentially large JSON string - _sw.Write("Deserialized JSON: " + Environment.NewLine); - - _textWriter = new JsonTextWriter(_sw); - _textWriter.Formatting = Formatting.Indented; - } - - public string GetDeserializedJsonMessage() - { - return _sw.ToString(); - } - - public override bool Read() - { - bool value = _innerReader.Read(); - WriteCurrentToken(); - return value; - } - - public override int? ReadAsInt32() - { - int? value = _innerReader.ReadAsInt32(); - WriteCurrentToken(); - return value; - } - - public override string? ReadAsString() - { - string? value = _innerReader.ReadAsString(); - WriteCurrentToken(); - return value; - } - - public override byte[]? ReadAsBytes() - { - byte[]? value = _innerReader.ReadAsBytes(); - WriteCurrentToken(); - return value; - } - - public override decimal? ReadAsDecimal() - { - decimal? value = _innerReader.ReadAsDecimal(); - WriteCurrentToken(); - return value; - } - - public override double? ReadAsDouble() - { - double? value = _innerReader.ReadAsDouble(); - WriteCurrentToken(); - return value; - } - - public override bool? ReadAsBoolean() - { - bool? value = _innerReader.ReadAsBoolean(); - WriteCurrentToken(); - return value; - } - - public override DateTime? ReadAsDateTime() - { - DateTime? value = _innerReader.ReadAsDateTime(); - WriteCurrentToken(); - return value; - } - -#if HAVE_DATE_TIME_OFFSET - public override DateTimeOffset? ReadAsDateTimeOffset() - { - DateTimeOffset? value = _innerReader.ReadAsDateTimeOffset(); - WriteCurrentToken(); - return value; - } -#endif - - public void WriteCurrentToken() - { - _textWriter.WriteToken(_innerReader, false, false, true); - } - - public override int Depth => _innerReader.Depth; - - public override string Path => _innerReader.Path; - - public override char QuoteChar - { - get => _innerReader.QuoteChar; - protected internal set => _innerReader.QuoteChar = value; - } - - public override JsonToken TokenType => _innerReader.TokenType; - - public override object? Value => _innerReader.Value; - - public override Type? ValueType => _innerReader.ValueType; - - public override void Close() - { - _innerReader.Close(); - } - - bool IJsonLineInfo.HasLineInfo() - { - return _innerReader is IJsonLineInfo lineInfo && lineInfo.HasLineInfo(); - } - - int IJsonLineInfo.LineNumber => (_innerReader is IJsonLineInfo lineInfo) ? lineInfo.LineNumber : 0; - - int IJsonLineInfo.LinePosition => (_innerReader is IJsonLineInfo lineInfo) ? lineInfo.LinePosition : 0; - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Serialization/TraceJsonWriter.cs b/Source/MyDb/Newtonsoft.Json/Serialization/TraceJsonWriter.cs deleted file mode 100644 index b660b07..0000000 --- a/Source/MyDb/Newtonsoft.Json/Serialization/TraceJsonWriter.cs +++ /dev/null @@ -1,598 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using System.IO; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif - -namespace Newtonsoft.Json.Serialization -{ - internal class TraceJsonWriter : JsonWriter - { - private readonly JsonWriter _innerWriter; - private readonly JsonTextWriter _textWriter; - private readonly StringWriter _sw; - - public TraceJsonWriter(JsonWriter innerWriter) - { - _innerWriter = innerWriter; - - _sw = new StringWriter(CultureInfo.InvariantCulture); - // prefix the message in the stringwriter to avoid concat with a potentially large JSON string - _sw.Write("Serialized JSON: " + Environment.NewLine); - - _textWriter = new JsonTextWriter(_sw); - _textWriter.Formatting = Formatting.Indented; - _textWriter.Culture = innerWriter.Culture; - _textWriter.DateFormatHandling = innerWriter.DateFormatHandling; - _textWriter.DateFormatString = innerWriter.DateFormatString; - _textWriter.DateTimeZoneHandling = innerWriter.DateTimeZoneHandling; - _textWriter.FloatFormatHandling = innerWriter.FloatFormatHandling; - } - - public string GetSerializedJsonMessage() - { - return _sw.ToString(); - } - - public override void WriteValue(decimal value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(decimal? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(bool value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(bool? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(byte value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(byte? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(char value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(char? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(byte[]? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value == null) - { - base.WriteUndefined(); - } - else - { - base.WriteValue(value); - } - } - - public override void WriteValue(DateTime value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(DateTime? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - -#if HAVE_DATE_TIME_OFFSET - public override void WriteValue(DateTimeOffset value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(DateTimeOffset? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } -#endif - - public override void WriteValue(double value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(double? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteUndefined() - { - _textWriter.WriteUndefined(); - _innerWriter.WriteUndefined(); - base.WriteUndefined(); - } - - public override void WriteNull() - { - _textWriter.WriteNull(); - _innerWriter.WriteNull(); - base.WriteUndefined(); - } - - public override void WriteValue(float value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(float? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(Guid value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(Guid? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(int value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(int? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(long value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(long? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(object? value) - { -#if HAVE_BIG_INTEGER - if (value is BigInteger) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - InternalWriteValue(JsonToken.Integer); - } - else -#endif - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value == null) - { - base.WriteUndefined(); - } - else - { - // base.WriteValue(value) will error - InternalWriteValue(JsonToken.String); - } - } - } - - public override void WriteValue(sbyte value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(sbyte? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(short value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(short? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(string? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(TimeSpan value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(TimeSpan? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(uint value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(uint? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(ulong value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(ulong? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteValue(Uri? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value == null) - { - base.WriteUndefined(); - } - else - { - base.WriteValue(value); - } - } - - public override void WriteValue(ushort value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - base.WriteValue(value); - } - - public override void WriteValue(ushort? value) - { - _textWriter.WriteValue(value); - _innerWriter.WriteValue(value); - if (value.HasValue) - { - base.WriteValue(value.GetValueOrDefault()); - } - else - { - base.WriteUndefined(); - } - } - - public override void WriteWhitespace(string ws) - { - _textWriter.WriteWhitespace(ws); - _innerWriter.WriteWhitespace(ws); - base.WriteWhitespace(ws); - } - - public override void WriteComment(string? text) - { - _textWriter.WriteComment(text); - _innerWriter.WriteComment(text); - base.WriteComment(text); - } - - public override void WriteStartArray() - { - _textWriter.WriteStartArray(); - _innerWriter.WriteStartArray(); - base.WriteStartArray(); - } - - public override void WriteEndArray() - { - _textWriter.WriteEndArray(); - _innerWriter.WriteEndArray(); - base.WriteEndArray(); - } - - public override void WriteStartConstructor(string name) - { - _textWriter.WriteStartConstructor(name); - _innerWriter.WriteStartConstructor(name); - base.WriteStartConstructor(name); - } - - public override void WriteEndConstructor() - { - _textWriter.WriteEndConstructor(); - _innerWriter.WriteEndConstructor(); - base.WriteEndConstructor(); - } - - public override void WritePropertyName(string name) - { - _textWriter.WritePropertyName(name); - _innerWriter.WritePropertyName(name); - base.WritePropertyName(name); - } - - public override void WritePropertyName(string name, bool escape) - { - _textWriter.WritePropertyName(name, escape); - _innerWriter.WritePropertyName(name, escape); - - // method with escape will error - base.WritePropertyName(name); - } - - public override void WriteStartObject() - { - _textWriter.WriteStartObject(); - _innerWriter.WriteStartObject(); - base.WriteStartObject(); - } - - public override void WriteEndObject() - { - _textWriter.WriteEndObject(); - _innerWriter.WriteEndObject(); - base.WriteEndObject(); - } - - public override void WriteRawValue(string? json) - { - _textWriter.WriteRawValue(json); - _innerWriter.WriteRawValue(json); - - // calling base method will write json twice - InternalWriteValue(JsonToken.Undefined); - } - - public override void WriteRaw(string? json) - { - _textWriter.WriteRaw(json); - _innerWriter.WriteRaw(json); - base.WriteRaw(json); - } - - public override void Close() - { - _textWriter.Close(); - _innerWriter.Close(); - base.Close(); - } - - public override void Flush() - { - _textWriter.Flush(); - _innerWriter.Flush(); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/SerializationBinder.cs b/Source/MyDb/Newtonsoft.Json/SerializationBinder.cs deleted file mode 100644 index 9a6193c..0000000 --- a/Source/MyDb/Newtonsoft.Json/SerializationBinder.cs +++ /dev/null @@ -1,36 +0,0 @@ - -#if (DOTNET || PORTABLE40 || PORTABLE) -using System; -using System.Reflection; - -namespace Newtonsoft.Json -{ - /// - /// Allows users to control class loading and mandate what class to load. - /// - [Obsolete("SerializationBinder is obsolete. Use ISerializationBinder instead.")] - public abstract class SerializationBinder - { - /// - /// When overridden in a derived class, controls the binding of a serialized object to a type. - /// - /// Specifies the name of the serialized object. - /// Specifies the name of the serialized object - /// The type of the object the formatter creates a new instance of. - public abstract Type BindToType(string? assemblyName, string typeName); - - /// - /// When overridden in a derived class, controls the binding of a serialized object to a type. - /// - /// The type of the object the formatter creates a new instance of. - /// Specifies the name of the serialized object. - /// Specifies the name of the serialized object. - public virtual void BindToName(Type serializedType, out string? assemblyName, out string? typeName) - { - assemblyName = null; - typeName = null; - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/StringEscapeHandling.cs b/Source/MyDb/Newtonsoft.Json/StringEscapeHandling.cs deleted file mode 100644 index 4016eb6..0000000 --- a/Source/MyDb/Newtonsoft.Json/StringEscapeHandling.cs +++ /dev/null @@ -1,48 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Specifies how strings are escaped when writing JSON text. - /// - public enum StringEscapeHandling - { - /// - /// Only control characters (e.g. newline) are escaped. - /// - Default = 0, - - /// - /// All non-ASCII and control characters (e.g. newline) are escaped. - /// - EscapeNonAscii = 1, - - /// - /// HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped. - /// - EscapeHtml = 2 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/TraceLevel.cs b/Source/MyDb/Newtonsoft.Json/TraceLevel.cs deleted file mode 100644 index f86958a..0000000 --- a/Source/MyDb/Newtonsoft.Json/TraceLevel.cs +++ /dev/null @@ -1,39 +0,0 @@ - -#if !HAVE_TRACE_WRITER -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json -{ - /// - /// Specifies what messages to output for the class. - /// - public enum TraceLevel - { - /// - /// Output no tracing and debugging messages. - /// - Off = 0, - - /// - /// Output error-handling messages. - /// - Error = 1, - - /// - /// Output warnings and error-handling messages. - /// - Warning = 2, - - /// - /// Output informational messages, warnings, and error-handling messages. - /// - Info = 3, - - /// - /// Output all debugging and tracing messages. - /// - Verbose = 4 - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/TypeNameAssemblyFormatHandling.cs b/Source/MyDb/Newtonsoft.Json/TypeNameAssemblyFormatHandling.cs deleted file mode 100644 index 3d21dcf..0000000 --- a/Source/MyDb/Newtonsoft.Json/TypeNameAssemblyFormatHandling.cs +++ /dev/null @@ -1,43 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json -{ - /// - /// Indicates the method that will be used during deserialization for locating and loading assemblies. - /// - public enum TypeNameAssemblyFormatHandling - { - /// - /// In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. - /// - Simple = 0, - - /// - /// In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. - /// - Full = 1 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/TypeNameHandling.cs b/Source/MyDb/Newtonsoft.Json/TypeNameHandling.cs deleted file mode 100644 index 2357299..0000000 --- a/Source/MyDb/Newtonsoft.Json/TypeNameHandling.cs +++ /dev/null @@ -1,70 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Runtime.Serialization; - -namespace Newtonsoft.Json -{ - /// - /// Specifies type name handling options for the . - /// - /// - /// should be used with caution when your application deserializes JSON from an external source. - /// Incoming types should be validated with a custom - /// when deserializing with a value other than . - /// - [Flags] - public enum TypeNameHandling - { - /// - /// Do not include the .NET type name when serializing types. - /// - None = 0, - - /// - /// Include the .NET type name when serializing into a JSON object structure. - /// - Objects = 1, - - /// - /// Include the .NET type name when serializing into a JSON array structure. - /// - Arrays = 2, - - /// - /// Always include the .NET type name when serializing. - /// - All = Objects | Arrays, - - /// - /// Include the .NET type name when the type of the object being serialized is not the same as its declared type. - /// Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON - /// you must specify a root type object with - /// or . - /// - Auto = 4 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/AsyncUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/AsyncUtils.cs deleted file mode 100644 index e863e73..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/AsyncUtils.cs +++ /dev/null @@ -1,110 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_ASYNC - -using System.Diagnostics; -using System.IO; -using System.Threading; -using System.Threading.Tasks; - -namespace Newtonsoft.Json.Utilities -{ - internal static class AsyncUtils - { - // Pre-allocate to avoid wasted allocations. - public static readonly Task False = Task.FromResult(false); - public static readonly Task True = Task.FromResult(true); - - internal static Task ToAsync(this bool value) => value ? True : False; - - public static Task? CancelIfRequestedAsync(this CancellationToken cancellationToken) - { - return cancellationToken.IsCancellationRequested ? FromCanceled(cancellationToken) : null; - } - - public static Task? CancelIfRequestedAsync(this CancellationToken cancellationToken) - { - return cancellationToken.IsCancellationRequested ? FromCanceled(cancellationToken) : null; - } - - // From 4.6 on we could use Task.FromCanceled(), but we need an equivalent for - // previous frameworks. - public static Task FromCanceled(this CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(cancellationToken.IsCancellationRequested); - return new Task(() => {}, cancellationToken); - } - - public static Task FromCanceled(this CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(cancellationToken.IsCancellationRequested); -#pragma warning disable CS8603 // Possible null reference return. - return new Task(() => default, cancellationToken); -#pragma warning restore CS8603 // Possible null reference return. - } - - // Task.Delay(0) is optimised as a cached task within the framework, and indeed - // the same cached task that Task.CompletedTask returns as of 4.6, but we'll add - // our own cached field for previous frameworks. - internal static readonly Task CompletedTask = Task.Delay(0); - - public static Task WriteAsync(this TextWriter writer, char value, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(writer != null); - return cancellationToken.IsCancellationRequested ? FromCanceled(cancellationToken) : writer.WriteAsync(value); - } - - public static Task WriteAsync(this TextWriter writer, string? value, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(writer != null); - return cancellationToken.IsCancellationRequested ? FromCanceled(cancellationToken) : writer.WriteAsync(value); - } - - public static Task WriteAsync(this TextWriter writer, char[] value, int start, int count, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(writer != null); - return cancellationToken.IsCancellationRequested ? FromCanceled(cancellationToken) : writer.WriteAsync(value, start, count); - } - - public static Task ReadAsync(this TextReader reader, char[] buffer, int index, int count, CancellationToken cancellationToken) - { - MiscellaneousUtils.Assert(reader != null); - return cancellationToken.IsCancellationRequested ? FromCanceled(cancellationToken) : reader.ReadAsync(buffer, index, count); - } - - public static bool IsCompletedSucessfully(this Task task) - { - // IsCompletedSucessfully is the faster method, but only currently exposed on .NET Core 2.0 -#if NETCOREAPP2_0 - return task.IsCompletedSucessfully; -#else - return task.Status == TaskStatus.RanToCompletion; -#endif - } - } -} - -#endif diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/Base64Encoder.cs b/Source/MyDb/Newtonsoft.Json/Utilities/Base64Encoder.cs deleted file mode 100644 index c1dd16d..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/Base64Encoder.cs +++ /dev/null @@ -1,217 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.IO; -#if HAVE_ASYNC -using System.Threading; -using System.Threading.Tasks; -#endif - -namespace Newtonsoft.Json.Utilities -{ - internal class Base64Encoder - { - private const int Base64LineSize = 76; - private const int LineSizeInBytes = 57; - - private readonly char[] _charsLine = new char[Base64LineSize]; - private readonly TextWriter _writer; - - private byte[]? _leftOverBytes; - private int _leftOverBytesCount; - - public Base64Encoder(TextWriter writer) - { - ValidationUtils.ArgumentNotNull(writer, nameof(writer)); - _writer = writer; - } - - private void ValidateEncode(byte[] buffer, int index, int count) - { - if (buffer == null) - { - throw new ArgumentNullException(nameof(buffer)); - } - - if (index < 0) - { - throw new ArgumentOutOfRangeException(nameof(index)); - } - - if (count < 0) - { - throw new ArgumentOutOfRangeException(nameof(count)); - } - - if (count > (buffer.Length - index)) - { - throw new ArgumentOutOfRangeException(nameof(count)); - } - } - - public void Encode(byte[] buffer, int index, int count) - { - ValidateEncode(buffer, index, count); - - if (_leftOverBytesCount > 0) - { - if(FulfillFromLeftover(buffer, index, ref count)) - { - return; - } - - int num2 = Convert.ToBase64CharArray(_leftOverBytes, 0, 3, _charsLine, 0); - WriteChars(_charsLine, 0, num2); - } - - StoreLeftOverBytes(buffer, index, ref count); - - int num4 = index + count; - int length = LineSizeInBytes; - while (index < num4) - { - if ((index + length) > num4) - { - length = num4 - index; - } - int num6 = Convert.ToBase64CharArray(buffer, index, length, _charsLine, 0); - WriteChars(_charsLine, 0, num6); - index += length; - } - } - - private void StoreLeftOverBytes(byte[] buffer, int index, ref int count) - { - int leftOverBytesCount = count % 3; - if (leftOverBytesCount > 0) - { - count -= leftOverBytesCount; - if (_leftOverBytes == null) - { - _leftOverBytes = new byte[3]; - } - - for (int i = 0; i < leftOverBytesCount; i++) - { - _leftOverBytes[i] = buffer[index + count + i]; - } - } - - _leftOverBytesCount = leftOverBytesCount; - } - - private bool FulfillFromLeftover(byte[] buffer, int index, ref int count) - { - int leftOverBytesCount = _leftOverBytesCount; - while (leftOverBytesCount < 3 && count > 0) - { - _leftOverBytes![leftOverBytesCount++] = buffer[index++]; - count--; - } - - if (count == 0 && leftOverBytesCount < 3) - { - _leftOverBytesCount = leftOverBytesCount; - return true; - } - - return false; - } - - public void Flush() - { - if (_leftOverBytesCount > 0) - { - int count = Convert.ToBase64CharArray(_leftOverBytes, 0, _leftOverBytesCount, _charsLine, 0); - WriteChars(_charsLine, 0, count); - _leftOverBytesCount = 0; - } - } - - private void WriteChars(char[] chars, int index, int count) - { - _writer.Write(chars, index, count); - } - -#if HAVE_ASYNC - - public async Task EncodeAsync(byte[] buffer, int index, int count, CancellationToken cancellationToken) - { - ValidateEncode(buffer, index, count); - - if (_leftOverBytesCount > 0) - { - if (FulfillFromLeftover(buffer, index, ref count)) - { - return; - } - - int num2 = Convert.ToBase64CharArray(_leftOverBytes, 0, 3, _charsLine, 0); - await WriteCharsAsync(_charsLine, 0, num2, cancellationToken).ConfigureAwait(false); - } - - StoreLeftOverBytes(buffer, index, ref count); - - int num4 = index + count; - int length = LineSizeInBytes; - while (index < num4) - { - if (index + length > num4) - { - length = num4 - index; - } - int num6 = Convert.ToBase64CharArray(buffer, index, length, _charsLine, 0); - await WriteCharsAsync(_charsLine, 0, num6, cancellationToken).ConfigureAwait(false); - index += length; - } - } - - private Task WriteCharsAsync(char[] chars, int index, int count, CancellationToken cancellationToken) - { - return _writer.WriteAsync(chars, index, count, cancellationToken); - } - - public Task FlushAsync(CancellationToken cancellationToken) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - if (_leftOverBytesCount > 0) - { - int count = Convert.ToBase64CharArray(_leftOverBytes, 0, _leftOverBytesCount, _charsLine, 0); - _leftOverBytesCount = 0; - return WriteCharsAsync(_charsLine, 0, count, cancellationToken); - } - - return AsyncUtils.CompletedTask; - } - -#endif - - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/BidirectionalDictionary.cs b/Source/MyDb/Newtonsoft.Json/Utilities/BidirectionalDictionary.cs deleted file mode 100644 index 2f97c0b..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/BidirectionalDictionary.cs +++ /dev/null @@ -1,94 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; - -namespace Newtonsoft.Json.Utilities -{ - internal class BidirectionalDictionary - { - private readonly IDictionary _firstToSecond; - private readonly IDictionary _secondToFirst; - private readonly string _duplicateFirstErrorMessage; - private readonly string _duplicateSecondErrorMessage; - - public BidirectionalDictionary() - : this(EqualityComparer.Default, EqualityComparer.Default) - { - } - - public BidirectionalDictionary(IEqualityComparer firstEqualityComparer, IEqualityComparer secondEqualityComparer) - : this( - firstEqualityComparer, - secondEqualityComparer, - "Duplicate item already exists for '{0}'.", - "Duplicate item already exists for '{0}'.") - { - } - - public BidirectionalDictionary(IEqualityComparer firstEqualityComparer, IEqualityComparer secondEqualityComparer, - string duplicateFirstErrorMessage, string duplicateSecondErrorMessage) - { - _firstToSecond = new Dictionary(firstEqualityComparer); - _secondToFirst = new Dictionary(secondEqualityComparer); - _duplicateFirstErrorMessage = duplicateFirstErrorMessage; - _duplicateSecondErrorMessage = duplicateSecondErrorMessage; - } - - public void Set(TFirst first, TSecond second) - { - if (_firstToSecond.TryGetValue(first, out TSecond existingSecond)) - { - if (!existingSecond!.Equals(second)) - { - throw new ArgumentException(_duplicateFirstErrorMessage.FormatWith(CultureInfo.InvariantCulture, first)); - } - } - - if (_secondToFirst.TryGetValue(second, out TFirst existingFirst)) - { - if (!existingFirst!.Equals(first)) - { - throw new ArgumentException(_duplicateSecondErrorMessage.FormatWith(CultureInfo.InvariantCulture, second)); - } - } - - _firstToSecond.Add(first, second); - _secondToFirst.Add(second, first); - } - - public bool TryGetByFirst(TFirst first, out TSecond second) - { - return _firstToSecond.TryGetValue(first, out second); - } - - public bool TryGetBySecond(TSecond second, out TFirst first) - { - return _secondToFirst.TryGetValue(second, out first); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/CollectionUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/CollectionUtils.cs deleted file mode 100644 index 85826a5..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/CollectionUtils.cs +++ /dev/null @@ -1,382 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Collections.ObjectModel; -using System.Reflection; -using System.Text; -using System.Collections; -using System.Diagnostics; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using System.Globalization; -#if HAVE_METHOD_IMPL_ATTRIBUTE -using System.Runtime.CompilerServices; -#endif -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Utilities -{ - internal static class CollectionUtils - { - /// - /// Determines whether the collection is null or empty. - /// - /// The collection. - /// - /// true if the collection is null or empty; otherwise, false. - /// - public static bool IsNullOrEmpty(ICollection collection) - { - if (collection != null) - { - return (collection.Count == 0); - } - return true; - } - - /// - /// Adds the elements of the specified collection to the specified generic . - /// - /// The list to add to. - /// The collection of elements to add. - public static void AddRange(this IList initial, IEnumerable collection) - { - if (initial == null) - { - throw new ArgumentNullException(nameof(initial)); - } - - if (collection == null) - { - return; - } - - foreach (T value in collection) - { - initial.Add(value); - } - } - -#if !HAVE_COVARIANT_GENERICS - public static void AddRange(this IList initial, IEnumerable collection) - { - ValidationUtils.ArgumentNotNull(initial, nameof(initial)); - - // because earlier versions of .NET didn't support covariant generics - initial.AddRange(collection.Cast()); - } -#endif - - public static bool IsDictionaryType(Type type) - { - ValidationUtils.ArgumentNotNull(type, nameof(type)); - - if (typeof(IDictionary).IsAssignableFrom(type)) - { - return true; - } - if (ReflectionUtils.ImplementsGenericDefinition(type, typeof(IDictionary<,>))) - { - return true; - } -#if HAVE_READ_ONLY_COLLECTIONS - if (ReflectionUtils.ImplementsGenericDefinition(type, typeof(IReadOnlyDictionary<,>))) - { - return true; - } -#endif - - return false; - } - - public static ConstructorInfo? ResolveEnumerableCollectionConstructor(Type collectionType, Type collectionItemType) - { - Type genericConstructorArgument = typeof(IList<>).MakeGenericType(collectionItemType); - - return ResolveEnumerableCollectionConstructor(collectionType, collectionItemType, genericConstructorArgument); - } - - public static ConstructorInfo? ResolveEnumerableCollectionConstructor(Type collectionType, Type collectionItemType, Type constructorArgumentType) - { - Type genericEnumerable = typeof(IEnumerable<>).MakeGenericType(collectionItemType); - ConstructorInfo? match = null; - - foreach (ConstructorInfo constructor in collectionType.GetConstructors(BindingFlags.Public | BindingFlags.Instance)) - { - IList parameters = constructor.GetParameters(); - - if (parameters.Count == 1) - { - Type parameterType = parameters[0].ParameterType; - - if (genericEnumerable == parameterType) - { - // exact match - match = constructor; - break; - } - - // in case we can't find an exact match, use first inexact - if (match == null) - { - if (parameterType.IsAssignableFrom(constructorArgumentType)) - { - match = constructor; - } - } - } - } - - return match; - } - - public static bool AddDistinct(this IList list, T value) - { - return list.AddDistinct(value, EqualityComparer.Default); - } - - public static bool AddDistinct(this IList list, T value, IEqualityComparer comparer) - { - if (list.ContainsValue(value, comparer)) - { - return false; - } - - list.Add(value); - return true; - } - - // this is here because LINQ Bridge doesn't support Contains with IEqualityComparer - public static bool ContainsValue(this IEnumerable source, TSource value, IEqualityComparer comparer) - { - if (comparer == null) - { - comparer = EqualityComparer.Default; - } - - if (source == null) - { - throw new ArgumentNullException(nameof(source)); - } - - foreach (TSource local in source) - { - if (comparer.Equals(local, value)) - { - return true; - } - } - - return false; - } - - public static bool AddRangeDistinct(this IList list, IEnumerable values, IEqualityComparer comparer) - { - bool allAdded = true; - foreach (T value in values) - { - if (!list.AddDistinct(value, comparer)) - { - allAdded = false; - } - } - - return allAdded; - } - - public static int IndexOf(this IEnumerable collection, Func predicate) - { - int index = 0; - foreach (T value in collection) - { - if (predicate(value)) - { - return index; - } - - index++; - } - - return -1; - } - - public static bool Contains(this List list, T value, IEqualityComparer comparer) - { - for (int i = 0; i < list.Count; i++) - { - if (comparer.Equals(value, list[i])) - { - return true; - } - } - return false; - } - - public static int IndexOfReference(this List list, T item) - { - for (int i = 0; i < list.Count; i++) - { - if (ReferenceEquals(item, list[i])) - { - return i; - } - } - - return -1; - } - -#if HAVE_FAST_REVERSE - // faster reverse in .NET Framework with value types - https://github.com/JamesNK/Newtonsoft.Json/issues/1430 - public static void FastReverse(this List list) - { - int i = 0; - int j = list.Count - 1; - while (i < j) - { - T temp = list[i]; - list[i] = list[j]; - list[j] = temp; - i++; - j--; - } - } -#endif - - private static IList GetDimensions(IList values, int dimensionsCount) - { - IList dimensions = new List(); - - IList currentArray = values; - while (true) - { - dimensions.Add(currentArray.Count); - - // don't keep calculating dimensions for arrays inside the value array - if (dimensions.Count == dimensionsCount) - { - break; - } - - if (currentArray.Count == 0) - { - break; - } - - object v = currentArray[0]; - if (v is IList list) - { - currentArray = list; - } - else - { - break; - } - } - - return dimensions; - } - - private static void CopyFromJaggedToMultidimensionalArray(IList values, Array multidimensionalArray, int[] indices) - { - int dimension = indices.Length; - if (dimension == multidimensionalArray.Rank) - { - multidimensionalArray.SetValue(JaggedArrayGetValue(values, indices), indices); - return; - } - - int dimensionLength = multidimensionalArray.GetLength(dimension); - IList list = (IList)JaggedArrayGetValue(values, indices); - int currentValuesLength = list.Count; - if (currentValuesLength != dimensionLength) - { - throw new Exception("Cannot deserialize non-cubical array as multidimensional array."); - } - - int[] newIndices = new int[dimension + 1]; - for (int i = 0; i < dimension; i++) - { - newIndices[i] = indices[i]; - } - - for (int i = 0; i < multidimensionalArray.GetLength(dimension); i++) - { - newIndices[dimension] = i; - CopyFromJaggedToMultidimensionalArray(values, multidimensionalArray, newIndices); - } - } - - private static object JaggedArrayGetValue(IList values, int[] indices) - { - IList currentList = values; - for (int i = 0; i < indices.Length; i++) - { - int index = indices[i]; - if (i == indices.Length - 1) - { - return currentList[index]; - } - else - { - currentList = (IList)currentList[index]; - } - } - return currentList; - } - - public static Array ToMultidimensionalArray(IList values, Type type, int rank) - { - IList dimensions = GetDimensions(values, rank); - - while (dimensions.Count < rank) - { - dimensions.Add(0); - } - - Array multidimensionalArray = Array.CreateInstance(type, dimensions.ToArray()); - CopyFromJaggedToMultidimensionalArray(values, multidimensionalArray, ArrayEmpty()); - - return multidimensionalArray; - } - - public static T[] ArrayEmpty() - { - // Enumerable.Empty no longer returns an empty array in .NET Core 3.0 - return EmptyArrayContainer.Empty; - } - - private static class EmptyArrayContainer - { -#pragma warning disable CA1825 // Avoid zero-length array allocations. - public static readonly T[] Empty = new T[0]; -#pragma warning restore CA1825 // Avoid zero-length array allocations. - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/CollectionWrapper.cs b/Source/MyDb/Newtonsoft.Json/Utilities/CollectionWrapper.cs deleted file mode 100644 index ebb79f2..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/CollectionWrapper.cs +++ /dev/null @@ -1,320 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using System.Threading; -using System.Globalization; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -namespace Newtonsoft.Json.Utilities -{ - internal interface IWrappedCollection : IList - { - object UnderlyingCollection { get; } - } - - internal class CollectionWrapper : ICollection, IWrappedCollection - { - private readonly IList? _list; - private readonly ICollection? _genericCollection; - private object? _syncRoot; - - public CollectionWrapper(IList list) - { - ValidationUtils.ArgumentNotNull(list, nameof(list)); - - if (list is ICollection collection) - { - _genericCollection = collection; - } - else - { - _list = list; - } - } - - public CollectionWrapper(ICollection list) - { - ValidationUtils.ArgumentNotNull(list, nameof(list)); - - _genericCollection = list; - } - - public virtual void Add(T item) - { - if (_genericCollection != null) - { - _genericCollection.Add(item); - } - else - { - _list!.Add(item); - } - } - - public virtual void Clear() - { - if (_genericCollection != null) - { - _genericCollection.Clear(); - } - else - { - _list!.Clear(); - } - } - - public virtual bool Contains(T item) - { - if (_genericCollection != null) - { - return _genericCollection.Contains(item); - } - else - { - return _list!.Contains(item); - } - } - - public virtual void CopyTo(T[] array, int arrayIndex) - { - if (_genericCollection != null) - { - _genericCollection.CopyTo(array, arrayIndex); - } - else - { - _list!.CopyTo(array, arrayIndex); - } - } - - public virtual int Count - { - get - { - if (_genericCollection != null) - { - return _genericCollection.Count; - } - else - { - return _list!.Count; - } - } - } - - public virtual bool IsReadOnly - { - get - { - if (_genericCollection != null) - { - return _genericCollection.IsReadOnly; - } - else - { - return _list!.IsReadOnly; - } - } - } - - public virtual bool Remove(T item) - { - if (_genericCollection != null) - { - return _genericCollection.Remove(item); - } - else - { - bool contains = _list!.Contains(item); - - if (contains) - { - _list!.Remove(item); - } - - return contains; - } - } - - public virtual IEnumerator GetEnumerator() - { - return (_genericCollection ?? _list.Cast()).GetEnumerator(); - } - - IEnumerator IEnumerable.GetEnumerator() - { - return ((IEnumerable)_genericCollection! ?? _list!).GetEnumerator(); - } - - int IList.Add(object value) - { - VerifyValueType(value); - Add((T)value); - - return (Count - 1); - } - - bool IList.Contains(object value) - { - if (IsCompatibleObject(value)) - { - return Contains((T)value); - } - - return false; - } - - int IList.IndexOf(object value) - { - if (_genericCollection != null) - { - throw new InvalidOperationException("Wrapped ICollection does not support IndexOf."); - } - - if (IsCompatibleObject(value)) - { - return _list!.IndexOf((T)value); - } - - return -1; - } - - void IList.RemoveAt(int index) - { - if (_genericCollection != null) - { - throw new InvalidOperationException("Wrapped ICollection does not support RemoveAt."); - } - - _list!.RemoveAt(index); - } - - void IList.Insert(int index, object value) - { - if (_genericCollection != null) - { - throw new InvalidOperationException("Wrapped ICollection does not support Insert."); - } - - VerifyValueType(value); - _list!.Insert(index, (T)value); - } - - bool IList.IsFixedSize - { - get - { - if (_genericCollection != null) - { - // ICollection only has IsReadOnly - return _genericCollection.IsReadOnly; - } - else - { - return _list!.IsFixedSize; - } - } - } - - void IList.Remove(object value) - { - if (IsCompatibleObject(value)) - { - Remove((T)value); - } - } - - object IList.this[int index] - { - get - { - if (_genericCollection != null) - { - throw new InvalidOperationException("Wrapped ICollection does not support indexer."); - } - - return _list![index]; - } - set - { - if (_genericCollection != null) - { - throw new InvalidOperationException("Wrapped ICollection does not support indexer."); - } - - VerifyValueType(value); - _list![index] = (T)value; - } - } - - void ICollection.CopyTo(Array array, int arrayIndex) - { - CopyTo((T[])array, arrayIndex); - } - - bool ICollection.IsSynchronized => false; - - object ICollection.SyncRoot - { - get - { - if (_syncRoot == null) - { - Interlocked.CompareExchange(ref _syncRoot, new object(), null); - } - - return _syncRoot; - } - } - - private static void VerifyValueType(object value) - { - if (!IsCompatibleObject(value)) - { - throw new ArgumentException("The value '{0}' is not of type '{1}' and cannot be used in this generic collection.".FormatWith(CultureInfo.InvariantCulture, value, typeof(T)), nameof(value)); - } - } - - private static bool IsCompatibleObject(object value) - { - if (!(value is T) && (value != null || (typeof(T).IsValueType() && !ReflectionUtils.IsNullableType(typeof(T))))) - { - return false; - } - - return true; - } - - public object UnderlyingCollection => (object)_genericCollection! ?? _list!; - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/ConvertUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/ConvertUtils.cs deleted file mode 100644 index 364088e..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/ConvertUtils.cs +++ /dev/null @@ -1,1577 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Globalization; -using System.ComponentModel; -using System.Runtime.CompilerServices; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -#if !HAVE_GUID_TRY_PARSE -using System.Text; -using System.Text.RegularExpressions; -#endif -using Newtonsoft.Json.Serialization; -using System.Reflection; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#endif -#if HAVE_ADO_NET -using System.Data.SqlTypes; - -#endif - -namespace Newtonsoft.Json.Utilities -{ - internal enum PrimitiveTypeCode - { - Empty = 0, - Object = 1, - Char = 2, - CharNullable = 3, - Boolean = 4, - BooleanNullable = 5, - SByte = 6, - SByteNullable = 7, - Int16 = 8, - Int16Nullable = 9, - UInt16 = 10, - UInt16Nullable = 11, - Int32 = 12, - Int32Nullable = 13, - Byte = 14, - ByteNullable = 15, - UInt32 = 16, - UInt32Nullable = 17, - Int64 = 18, - Int64Nullable = 19, - UInt64 = 20, - UInt64Nullable = 21, - Single = 22, - SingleNullable = 23, - Double = 24, - DoubleNullable = 25, - DateTime = 26, - DateTimeNullable = 27, - DateTimeOffset = 28, - DateTimeOffsetNullable = 29, - Decimal = 30, - DecimalNullable = 31, - Guid = 32, - GuidNullable = 33, - TimeSpan = 34, - TimeSpanNullable = 35, - BigInteger = 36, - BigIntegerNullable = 37, - Uri = 38, - String = 39, - Bytes = 40, - DBNull = 41 - } - - internal class TypeInformation - { - public Type Type { get; } - public PrimitiveTypeCode TypeCode { get; } - - public TypeInformation(Type type, PrimitiveTypeCode typeCode) - { - Type = type; - TypeCode = typeCode; - } - } - - internal enum ParseResult - { - None = 0, - Success = 1, - Overflow = 2, - Invalid = 3 - } - - internal static class ConvertUtils - { - private static readonly Dictionary TypeCodeMap = - new Dictionary - { - { typeof(char), PrimitiveTypeCode.Char }, - { typeof(char?), PrimitiveTypeCode.CharNullable }, - { typeof(bool), PrimitiveTypeCode.Boolean }, - { typeof(bool?), PrimitiveTypeCode.BooleanNullable }, - { typeof(sbyte), PrimitiveTypeCode.SByte }, - { typeof(sbyte?), PrimitiveTypeCode.SByteNullable }, - { typeof(short), PrimitiveTypeCode.Int16 }, - { typeof(short?), PrimitiveTypeCode.Int16Nullable }, - { typeof(ushort), PrimitiveTypeCode.UInt16 }, - { typeof(ushort?), PrimitiveTypeCode.UInt16Nullable }, - { typeof(int), PrimitiveTypeCode.Int32 }, - { typeof(int?), PrimitiveTypeCode.Int32Nullable }, - { typeof(byte), PrimitiveTypeCode.Byte }, - { typeof(byte?), PrimitiveTypeCode.ByteNullable }, - { typeof(uint), PrimitiveTypeCode.UInt32 }, - { typeof(uint?), PrimitiveTypeCode.UInt32Nullable }, - { typeof(long), PrimitiveTypeCode.Int64 }, - { typeof(long?), PrimitiveTypeCode.Int64Nullable }, - { typeof(ulong), PrimitiveTypeCode.UInt64 }, - { typeof(ulong?), PrimitiveTypeCode.UInt64Nullable }, - { typeof(float), PrimitiveTypeCode.Single }, - { typeof(float?), PrimitiveTypeCode.SingleNullable }, - { typeof(double), PrimitiveTypeCode.Double }, - { typeof(double?), PrimitiveTypeCode.DoubleNullable }, - { typeof(DateTime), PrimitiveTypeCode.DateTime }, - { typeof(DateTime?), PrimitiveTypeCode.DateTimeNullable }, -#if HAVE_DATE_TIME_OFFSET - { typeof(DateTimeOffset), PrimitiveTypeCode.DateTimeOffset }, - { typeof(DateTimeOffset?), PrimitiveTypeCode.DateTimeOffsetNullable }, -#endif - { typeof(decimal), PrimitiveTypeCode.Decimal }, - { typeof(decimal?), PrimitiveTypeCode.DecimalNullable }, - { typeof(Guid), PrimitiveTypeCode.Guid }, - { typeof(Guid?), PrimitiveTypeCode.GuidNullable }, - { typeof(TimeSpan), PrimitiveTypeCode.TimeSpan }, - { typeof(TimeSpan?), PrimitiveTypeCode.TimeSpanNullable }, -#if HAVE_BIG_INTEGER - { typeof(BigInteger), PrimitiveTypeCode.BigInteger }, - { typeof(BigInteger?), PrimitiveTypeCode.BigIntegerNullable }, -#endif - { typeof(Uri), PrimitiveTypeCode.Uri }, - { typeof(string), PrimitiveTypeCode.String }, - { typeof(byte[]), PrimitiveTypeCode.Bytes }, -#if HAVE_ADO_NET - { typeof(DBNull), PrimitiveTypeCode.DBNull } -#endif - }; - -#if HAVE_ICONVERTIBLE - private static readonly TypeInformation[] PrimitiveTypeCodes = - { - // need all of these. lookup against the index with TypeCode value - new TypeInformation(typeof(object), PrimitiveTypeCode.Empty), - new TypeInformation(typeof(object), PrimitiveTypeCode.Object), - new TypeInformation(typeof(object), PrimitiveTypeCode.DBNull), - new TypeInformation(typeof(bool), PrimitiveTypeCode.Boolean), - new TypeInformation(typeof(char), PrimitiveTypeCode.Char), - new TypeInformation(typeof(sbyte), PrimitiveTypeCode.SByte), - new TypeInformation(typeof(byte), PrimitiveTypeCode.Byte), - new TypeInformation(typeof(short), PrimitiveTypeCode.Int16), - new TypeInformation(typeof(ushort), PrimitiveTypeCode.UInt16), - new TypeInformation(typeof(int), PrimitiveTypeCode.Int32), - new TypeInformation(typeof(uint), PrimitiveTypeCode.UInt32), - new TypeInformation(typeof(long), PrimitiveTypeCode.Int64), - new TypeInformation(typeof(ulong), PrimitiveTypeCode.UInt64), - new TypeInformation(typeof(float), PrimitiveTypeCode.Single), - new TypeInformation(typeof(double), PrimitiveTypeCode.Double), - new TypeInformation(typeof(decimal), PrimitiveTypeCode.Decimal), - new TypeInformation(typeof(DateTime), PrimitiveTypeCode.DateTime), - new TypeInformation(typeof(object), PrimitiveTypeCode.Empty), // no 17 in TypeCode for some reason - new TypeInformation(typeof(string), PrimitiveTypeCode.String) - }; -#endif - - public static PrimitiveTypeCode GetTypeCode(Type t) - { - return GetTypeCode(t, out _); - } - - public static PrimitiveTypeCode GetTypeCode(Type t, out bool isEnum) - { - if (TypeCodeMap.TryGetValue(t, out PrimitiveTypeCode typeCode)) - { - isEnum = false; - return typeCode; - } - - if (t.IsEnum()) - { - isEnum = true; - return GetTypeCode(Enum.GetUnderlyingType(t)); - } - - // performance? - if (ReflectionUtils.IsNullableType(t)) - { - Type nonNullable = Nullable.GetUnderlyingType(t); - if (nonNullable.IsEnum()) - { - Type nullableUnderlyingType = typeof(Nullable<>).MakeGenericType(Enum.GetUnderlyingType(nonNullable)); - isEnum = true; - return GetTypeCode(nullableUnderlyingType); - } - } - - isEnum = false; - return PrimitiveTypeCode.Object; - } - -#if HAVE_ICONVERTIBLE - public static TypeInformation GetTypeInformation(IConvertible convertable) - { - TypeInformation typeInformation = PrimitiveTypeCodes[(int)convertable.GetTypeCode()]; - return typeInformation; - } -#endif - - public static bool IsConvertible(Type t) - { -#if HAVE_ICONVERTIBLE - return typeof(IConvertible).IsAssignableFrom(t); -#else - return ( - t == typeof(bool) || t == typeof(byte) || t == typeof(char) || t == typeof(DateTime) || t == typeof(decimal) || t == typeof(double) || t == typeof(short) || t == typeof(int) || - t == typeof(long) || t == typeof(sbyte) || t == typeof(float) || t == typeof(string) || t == typeof(ushort) || t == typeof(uint) || t == typeof(ulong) || t.IsEnum()); -#endif - } - - public static TimeSpan ParseTimeSpan(string input) - { -#if HAVE_TIME_SPAN_PARSE_WITH_CULTURE - return TimeSpan.Parse(input, CultureInfo.InvariantCulture); -#else - return TimeSpan.Parse(input); -#endif - } - - private static readonly ThreadSafeStore, Func?> CastConverters = - new ThreadSafeStore, Func?>(CreateCastConverter); - - private static Func? CreateCastConverter(StructMultiKey t) - { - Type initialType = t.Value1; - Type targetType = t.Value2; - MethodInfo castMethodInfo = targetType.GetMethod("op_Implicit", new[] { initialType }) - ?? targetType.GetMethod("op_Explicit", new[] { initialType }); - - if (castMethodInfo == null) - { - return null; - } - - MethodCall call = JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(castMethodInfo); - - return o => call(null, o); - } - -#if HAVE_BIG_INTEGER - internal static BigInteger ToBigInteger(object value) - { - if (value is BigInteger integer) - { - return integer; - } - - if (value is string s) - { - return BigInteger.Parse(s, CultureInfo.InvariantCulture); - } - - if (value is float f) - { - return new BigInteger(f); - } - if (value is double d) - { - return new BigInteger(d); - } - if (value is decimal @decimal) - { - return new BigInteger(@decimal); - } - if (value is int i) - { - return new BigInteger(i); - } - if (value is long l) - { - return new BigInteger(l); - } - if (value is uint u) - { - return new BigInteger(u); - } - if (value is ulong @ulong) - { - return new BigInteger(@ulong); - } - - if (value is byte[] bytes) - { - return new BigInteger(bytes); - } - - throw new InvalidCastException("Cannot convert {0} to BigInteger.".FormatWith(CultureInfo.InvariantCulture, value.GetType())); - } - - public static object FromBigInteger(BigInteger i, Type targetType) - { - if (targetType == typeof(decimal)) - { - return (decimal)i; - } - if (targetType == typeof(double)) - { - return (double)i; - } - if (targetType == typeof(float)) - { - return (float)i; - } - if (targetType == typeof(ulong)) - { - return (ulong)i; - } - if (targetType == typeof(bool)) - { - return i != 0; - } - - try - { - return System.Convert.ChangeType((long)i, targetType, CultureInfo.InvariantCulture); - } - catch (Exception ex) - { - throw new InvalidOperationException("Can not convert from BigInteger to {0}.".FormatWith(CultureInfo.InvariantCulture, targetType), ex); - } - } -#endif - -#region TryConvert - internal enum ConvertResult - { - Success = 0, - CannotConvertNull = 1, - NotInstantiableType = 2, - NoValidConversion = 3 - } - - public static object Convert(object initialValue, CultureInfo culture, Type targetType) - { - switch (TryConvertInternal(initialValue, culture, targetType, out object? value)) - { - case ConvertResult.Success: - return value!; - case ConvertResult.CannotConvertNull: - throw new Exception("Can not convert null {0} into non-nullable {1}.".FormatWith(CultureInfo.InvariantCulture, initialValue.GetType(), targetType)); - case ConvertResult.NotInstantiableType: - throw new ArgumentException("Target type {0} is not a value type or a non-abstract class.".FormatWith(CultureInfo.InvariantCulture, targetType), nameof(targetType)); - case ConvertResult.NoValidConversion: - throw new InvalidOperationException("Can not convert from {0} to {1}.".FormatWith(CultureInfo.InvariantCulture, initialValue.GetType(), targetType)); - default: - throw new InvalidOperationException("Unexpected conversion result."); - } - } - - private static bool TryConvert(object? initialValue, CultureInfo culture, Type targetType, out object? value) - { - try - { - if (TryConvertInternal(initialValue, culture, targetType, out value) == ConvertResult.Success) - { - return true; - } - - value = null; - return false; - } - catch - { - value = null; - return false; - } - } - - private static ConvertResult TryConvertInternal(object? initialValue, CultureInfo culture, Type targetType, out object? value) - { - if (initialValue == null) - { - throw new ArgumentNullException(nameof(initialValue)); - } - - if (ReflectionUtils.IsNullableType(targetType)) - { - targetType = Nullable.GetUnderlyingType(targetType); - } - - Type initialType = initialValue.GetType(); - - if (targetType == initialType) - { - value = initialValue; - return ConvertResult.Success; - } - - // use Convert.ChangeType if both types are IConvertible - if (IsConvertible(initialValue.GetType()) && IsConvertible(targetType)) - { - if (targetType.IsEnum()) - { - if (initialValue is string) - { - value = Enum.Parse(targetType, initialValue.ToString(), true); - return ConvertResult.Success; - } - else if (IsInteger(initialValue)) - { - value = Enum.ToObject(targetType, initialValue); - return ConvertResult.Success; - } - } - - value = System.Convert.ChangeType(initialValue, targetType, culture); - return ConvertResult.Success; - } - -#if HAVE_DATE_TIME_OFFSET - if (initialValue is DateTime dt && targetType == typeof(DateTimeOffset)) - { - value = new DateTimeOffset(dt); - return ConvertResult.Success; - } -#endif - - if (initialValue is byte[] bytes && targetType == typeof(Guid)) - { - value = new Guid(bytes); - return ConvertResult.Success; - } - - if (initialValue is Guid guid && targetType == typeof(byte[])) - { - value = guid.ToByteArray(); - return ConvertResult.Success; - } - - if (initialValue is string s) - { - if (targetType == typeof(Guid)) - { - value = new Guid(s); - return ConvertResult.Success; - } - if (targetType == typeof(Uri)) - { - value = new Uri(s, UriKind.RelativeOrAbsolute); - return ConvertResult.Success; - } - if (targetType == typeof(TimeSpan)) - { - value = ParseTimeSpan(s); - return ConvertResult.Success; - } - if (targetType == typeof(byte[])) - { - value = System.Convert.FromBase64String(s); - return ConvertResult.Success; - } - if (targetType == typeof(Version)) - { - if (VersionTryParse(s, out Version? result)) - { - value = result; - return ConvertResult.Success; - } - value = null; - return ConvertResult.NoValidConversion; - } - if (typeof(Type).IsAssignableFrom(targetType)) - { - value = Type.GetType(s, true); - return ConvertResult.Success; - } - } - -#if HAVE_BIG_INTEGER - if (targetType == typeof(BigInteger)) - { - value = ToBigInteger(initialValue); - return ConvertResult.Success; - } - if (initialValue is BigInteger integer) - { - value = FromBigInteger(integer, targetType); - return ConvertResult.Success; - } -#endif - -#if HAVE_TYPE_DESCRIPTOR - // see if source or target types have a TypeConverter that converts between the two - TypeConverter toConverter = TypeDescriptor.GetConverter(initialType); - - if (toConverter != null && toConverter.CanConvertTo(targetType)) - { - value = toConverter.ConvertTo(null, culture, initialValue, targetType); - return ConvertResult.Success; - } - - TypeConverter fromConverter = TypeDescriptor.GetConverter(targetType); - - if (fromConverter != null && fromConverter.CanConvertFrom(initialType)) - { - value = fromConverter.ConvertFrom(null, culture, initialValue); - return ConvertResult.Success; - } -#endif -#if HAVE_ADO_NET - // handle DBNull - if (initialValue == DBNull.Value) - { - if (ReflectionUtils.IsNullable(targetType)) - { - value = EnsureTypeAssignable(null, initialType, targetType); - return ConvertResult.Success; - } - - // cannot convert null to non-nullable - value = null; - return ConvertResult.CannotConvertNull; - } -#endif - - if (targetType.IsInterface() || targetType.IsGenericTypeDefinition() || targetType.IsAbstract()) - { - value = null; - return ConvertResult.NotInstantiableType; - } - - value = null; - return ConvertResult.NoValidConversion; - } -#endregion - -#region ConvertOrCast - /// - /// Converts the value to the specified type. If the value is unable to be converted, the - /// value is checked whether it assignable to the specified type. - /// - /// The value to convert. - /// The culture to use when converting. - /// The type to convert or cast the value to. - /// - /// The converted type. If conversion was unsuccessful, the initial value - /// is returned if assignable to the target type. - /// - public static object? ConvertOrCast(object? initialValue, CultureInfo culture, Type targetType) - { - if (targetType == typeof(object)) - { - return initialValue; - } - - if (initialValue == null && ReflectionUtils.IsNullable(targetType)) - { - return null; - } - - if (TryConvert(initialValue, culture, targetType, out object? convertedValue)) - { - return convertedValue; - } - - return EnsureTypeAssignable(initialValue, ReflectionUtils.GetObjectType(initialValue)!, targetType); - } -#endregion - - private static object? EnsureTypeAssignable(object? value, Type initialType, Type targetType) - { - if (value != null) - { - Type valueType = value.GetType(); - - if (targetType.IsAssignableFrom(valueType)) - { - return value; - } - - Func? castConverter = CastConverters.Get(new StructMultiKey(valueType, targetType)); - if (castConverter != null) - { - return castConverter(value); - } - } - else - { - if (ReflectionUtils.IsNullable(targetType)) - { - return null; - } - } - - throw new ArgumentException("Could not cast or convert from {0} to {1}.".FormatWith(CultureInfo.InvariantCulture, initialType?.ToString() ?? "{null}", targetType)); - } - - public static bool VersionTryParse(string input, [NotNullWhen(true)]out Version? result) - { -#if HAVE_VERSION_TRY_PARSE - return Version.TryParse(input, out result); -#else - // improve failure performance with regex? - try - { - result = new Version(input); - return true; - } - catch - { - result = null; - return false; - } -#endif - } - - public static bool IsInteger(object value) - { - switch (GetTypeCode(value.GetType())) - { - case PrimitiveTypeCode.SByte: - case PrimitiveTypeCode.Byte: - case PrimitiveTypeCode.Int16: - case PrimitiveTypeCode.UInt16: - case PrimitiveTypeCode.Int32: - case PrimitiveTypeCode.UInt32: - case PrimitiveTypeCode.Int64: - case PrimitiveTypeCode.UInt64: - return true; - default: - return false; - } - } - - public static ParseResult Int32TryParse(char[] chars, int start, int length, out int value) - { - value = 0; - - if (length == 0) - { - return ParseResult.Invalid; - } - - bool isNegative = (chars[start] == '-'); - - if (isNegative) - { - // text just a negative sign - if (length == 1) - { - return ParseResult.Invalid; - } - - start++; - length--; - } - - int end = start + length; - - // Int32.MaxValue and MinValue are 10 chars - // Or is 10 chars and start is greater than two - // Need to improve this! - if (length > 10 || (length == 10 && chars[start] - '0' > 2)) - { - // invalid result takes precedence over overflow - for (int i = start; i < end; i++) - { - int c = chars[i] - '0'; - - if (c < 0 || c > 9) - { - return ParseResult.Invalid; - } - } - - return ParseResult.Overflow; - } - - for (int i = start; i < end; i++) - { - int c = chars[i] - '0'; - - if (c < 0 || c > 9) - { - return ParseResult.Invalid; - } - - int newValue = (10 * value) - c; - - // overflow has caused the number to loop around - if (newValue > value) - { - i++; - - // double check the rest of the string that there wasn't anything invalid - // invalid result takes precedence over overflow result - for (; i < end; i++) - { - c = chars[i] - '0'; - - if (c < 0 || c > 9) - { - return ParseResult.Invalid; - } - } - - return ParseResult.Overflow; - } - - value = newValue; - } - - // go from negative to positive to avoids overflow - // negative can be slightly bigger than positive - if (!isNegative) - { - // negative integer can be one bigger than positive - if (value == int.MinValue) - { - return ParseResult.Overflow; - } - - value = -value; - } - - return ParseResult.Success; - } - - public static ParseResult Int64TryParse(char[] chars, int start, int length, out long value) - { - value = 0; - - if (length == 0) - { - return ParseResult.Invalid; - } - - bool isNegative = (chars[start] == '-'); - - if (isNegative) - { - // text just a negative sign - if (length == 1) - { - return ParseResult.Invalid; - } - - start++; - length--; - } - - int end = start + length; - - // Int64.MaxValue and MinValue are 19 chars - if (length > 19) - { - // invalid result takes precedence over overflow - for (int i = start; i < end; i++) - { - int c = chars[i] - '0'; - - if (c < 0 || c > 9) - { - return ParseResult.Invalid; - } - } - - return ParseResult.Overflow; - } - - for (int i = start; i < end; i++) - { - int c = chars[i] - '0'; - - if (c < 0 || c > 9) - { - return ParseResult.Invalid; - } - - long newValue = (10 * value) - c; - - // overflow has caused the number to loop around - if (newValue > value) - { - i++; - - // double check the rest of the string that there wasn't anything invalid - // invalid result takes precedence over overflow result - for (; i < end; i++) - { - c = chars[i] - '0'; - - if (c < 0 || c > 9) - { - return ParseResult.Invalid; - } - } - - return ParseResult.Overflow; - } - - value = newValue; - } - - // go from negative to positive to avoids overflow - // negative can be slightly bigger than positive - if (!isNegative) - { - // negative integer can be one bigger than positive - if (value == long.MinValue) - { - return ParseResult.Overflow; - } - - value = -value; - } - - return ParseResult.Success; - } - -#if HAS_CUSTOM_DOUBLE_PARSE - private static class IEEE754 - { - /// - /// Exponents for both powers of 10 and 0.1 - /// - private static readonly int[] MultExp64Power10 = new int[] - { - 4, 7, 10, 14, 17, 20, 24, 27, 30, 34, 37, 40, 44, 47, 50 - }; - - /// - /// Normalized powers of 10 - /// - private static readonly ulong[] MultVal64Power10 = new ulong[] - { - 0xa000000000000000, 0xc800000000000000, 0xfa00000000000000, - 0x9c40000000000000, 0xc350000000000000, 0xf424000000000000, - 0x9896800000000000, 0xbebc200000000000, 0xee6b280000000000, - 0x9502f90000000000, 0xba43b74000000000, 0xe8d4a51000000000, - 0x9184e72a00000000, 0xb5e620f480000000, 0xe35fa931a0000000, - }; - - /// - /// Normalized powers of 0.1 - /// - private static readonly ulong[] MultVal64Power10Inv = new ulong[] - { - 0xcccccccccccccccd, 0xa3d70a3d70a3d70b, 0x83126e978d4fdf3c, - 0xd1b71758e219652e, 0xa7c5ac471b478425, 0x8637bd05af6c69b7, - 0xd6bf94d5e57a42be, 0xabcc77118461ceff, 0x89705f4136b4a599, - 0xdbe6fecebdedd5c2, 0xafebff0bcb24ab02, 0x8cbccc096f5088cf, - 0xe12e13424bb40e18, 0xb424dc35095cd813, 0x901d7cf73ab0acdc, - }; - - /// - /// Exponents for both powers of 10^16 and 0.1^16 - /// - private static readonly int[] MultExp64Power10By16 = new int[] - { - 54, 107, 160, 213, 266, 319, 373, 426, 479, 532, 585, 638, - 691, 745, 798, 851, 904, 957, 1010, 1064, 1117, - }; - - /// - /// Normalized powers of 10^16 - /// - private static readonly ulong[] MultVal64Power10By16 = new ulong[] - { - 0x8e1bc9bf04000000, 0x9dc5ada82b70b59e, 0xaf298d050e4395d6, - 0xc2781f49ffcfa6d4, 0xd7e77a8f87daf7fa, 0xefb3ab16c59b14a0, - 0x850fadc09923329c, 0x93ba47c980e98cde, 0xa402b9c5a8d3a6e6, - 0xb616a12b7fe617a8, 0xca28a291859bbf90, 0xe070f78d39275566, - 0xf92e0c3537826140, 0x8a5296ffe33cc92c, 0x9991a6f3d6bf1762, - 0xaa7eebfb9df9de8a, 0xbd49d14aa79dbc7e, 0xd226fc195c6a2f88, - 0xe950df20247c83f8, 0x81842f29f2cce373, 0x8fcac257558ee4e2, - }; - - /// - /// Normalized powers of 0.1^16 - /// - private static readonly ulong[] MultVal64Power10By16Inv = new ulong[] - { - 0xe69594bec44de160, 0xcfb11ead453994c3, 0xbb127c53b17ec165, - 0xa87fea27a539e9b3, 0x97c560ba6b0919b5, 0x88b402f7fd7553ab, - 0xf64335bcf065d3a0, 0xddd0467c64bce4c4, 0xc7caba6e7c5382ed, - 0xb3f4e093db73a0b7, 0xa21727db38cb0053, 0x91ff83775423cc29, - 0x8380dea93da4bc82, 0xece53cec4a314f00, 0xd5605fcdcf32e217, - 0xc0314325637a1978, 0xad1c8eab5ee43ba2, 0x9becce62836ac5b0, - 0x8c71dcd9ba0b495c, 0xfd00b89747823938, 0xe3e27a444d8d991a, - }; - - /// - /// Packs *10^ as 64-bit floating point value according to IEEE 754 standard - /// - /// Sign - /// Mantissa - /// Exponent - /// - /// Adoption of native function NumberToDouble() from coreclr sources, - /// see https://github.com/dotnet/coreclr/blob/master/src/classlibnative/bcltype/number.cpp#L451 - /// - public static double PackDouble(bool negative, ulong val, int scale) - { - // handle zero value - if (val == 0) - { - return negative ? -0.0 : 0.0; - } - - // normalize the mantissa - int exp = 64; - - if ((val & 0xFFFFFFFF00000000) == 0) - { - val <<= 32; - exp -= 32; - } - if ((val & 0xFFFF000000000000) == 0) - { - val <<= 16; - exp -= 16; - } - if ((val & 0xFF00000000000000) == 0) - { - val <<= 8; - exp -= 8; - } - if ((val & 0xF000000000000000) == 0) - { - val <<= 4; - exp -= 4; - } - if ((val & 0xC000000000000000) == 0) - { - val <<= 2; - exp -= 2; - } - if ((val & 0x8000000000000000) == 0) - { - val <<= 1; - exp -= 1; - } - - if (scale < 0) - { - scale = -scale; - - // check scale bounds - if (scale >= 22 * 16) - { - // underflow - return negative ? -0.0 : 0.0; - } - - // perform scaling - int index = scale & 15; - if (index != 0) - { - exp -= MultExp64Power10[index - 1] - 1; - val = Mul64Lossy(val, MultVal64Power10Inv[index - 1], ref exp); - } - - index = scale >> 4; - if (index != 0) - { - exp -= MultExp64Power10By16[index - 1] - 1; - val = Mul64Lossy(val, MultVal64Power10By16Inv[index - 1], ref exp); - } - } - else - { - // check scale bounds - if (scale >= 22 * 16) - { - // overflow - return negative ? double.NegativeInfinity : double.PositiveInfinity; - } - - // perform scaling - int index = scale & 15; - if (index != 0) - { - exp += MultExp64Power10[index - 1]; - val = Mul64Lossy(val, MultVal64Power10[index - 1], ref exp); - } - - index = scale >> 4; - if (index != 0) - { - exp += MultExp64Power10By16[index - 1]; - val = Mul64Lossy(val, MultVal64Power10By16[index - 1], ref exp); - } - } - - // round & scale down - - if ((val & (1 << 10)) != 0) - { - // IEEE round to even - ulong tmp = val + ((1UL << 10) - 1 + ((val >> 11) & 1)); - if (tmp < val) - { - // overflow - tmp = (tmp >> 1) | 0x8000000000000000; - exp++; - } - val = tmp; - } - - // return the exponent to a biased state - - exp += 0x3FE; - - // handle overflow, underflow, "Epsilon - 1/2 Epsilon", denormalized, and the normal case - - if (exp <= 0) - { - if (exp == -52 && (val >= 0x8000000000000058)) - { - // round X where {Epsilon > X >= 2.470328229206232730000000E-324} up to Epsilon (instead of down to zero) - val = 0x0000000000000001; - } - else if (exp <= -52) - { - // underflow - val = 0; - } - else - { - // denormalized value - val >>= (-exp + 12); - } - } - else if (exp >= 0x7FF) - { - // overflow - val = 0x7FF0000000000000; - } - else - { - // normal positive exponent case - val = ((ulong)exp << 52) | ((val >> 11) & 0x000FFFFFFFFFFFFF); - } - - // apply sign - - if (negative) - { - val |= 0x8000000000000000; - } - - return BitConverter.Int64BitsToDouble((long)val); - } - - private static ulong Mul64Lossy(ulong a, ulong b, ref int exp) - { - ulong a_hi = (a >> 32); - uint a_lo = (uint)a; - ulong b_hi = (b >> 32); - uint b_lo = (uint)b; - - ulong result = a_hi * b_hi; - - // save some multiplications if lo-parts aren't big enough to produce carry - // (hi-parts will be always big enough, since a and b are normalized) - - if ((b_lo & 0xFFFF0000) != 0) - { - result += (a_hi * b_lo) >> 32; - } - - if ((a_lo & 0xFFFF0000) != 0) - { - result += (a_lo * b_hi) >> 32; - } - - // normalize - if ((result & 0x8000000000000000) == 0) - { - result <<= 1; - exp--; - } - - return result; - } - } - - public static ParseResult DoubleTryParse(char[] chars, int start, int length, out double value) - { - value = 0; - - if (length == 0) - { - return ParseResult.Invalid; - } - - bool isNegative = (chars[start] == '-'); - if (isNegative) - { - // text just a negative sign - if (length == 1) - { - return ParseResult.Invalid; - } - - start++; - length--; - } - - int i = start; - int end = start + length; - int numDecimalStart = end; - int numDecimalEnd = end; - int exponent = 0; - ulong mantissa = 0UL; - int mantissaDigits = 0; - int exponentFromMantissa = 0; - for (; i < end; i++) - { - char c = chars[i]; - switch (c) - { - case '.': - if (i == start) - { - return ParseResult.Invalid; - } - if (i + 1 == end) - { - return ParseResult.Invalid; - } - - if (numDecimalStart != end) - { - // multiple decimal points - return ParseResult.Invalid; - } - - numDecimalStart = i + 1; - break; - case 'e': - case 'E': - if (i == start) - { - return ParseResult.Invalid; - } - if (i == numDecimalStart) - { - // E follows decimal point - return ParseResult.Invalid; - } - i++; - if (i == end) - { - return ParseResult.Invalid; - } - - if (numDecimalStart < end) - { - numDecimalEnd = i - 1; - } - - c = chars[i]; - bool exponentNegative = false; - switch (c) - { - case '-': - exponentNegative = true; - i++; - break; - case '+': - i++; - break; - } - - // parse 3 digit - for (; i < end; i++) - { - c = chars[i]; - if (c < '0' || c > '9') - { - return ParseResult.Invalid; - } - - int newExponent = (10 * exponent) + (c - '0'); - // stops updating exponent when overflowing - if (exponent < newExponent) - { - exponent = newExponent; - } - } - - if (exponentNegative) - { - exponent = -exponent; - } - break; - default: - if (c < '0' || c > '9') - { - return ParseResult.Invalid; - } - - if (i == start && c == '0') - { - i++; - if (i != end) - { - c = chars[i]; - if (c == '.') - { - goto case '.'; - } - if (c == 'e' || c == 'E') - { - goto case 'E'; - } - - return ParseResult.Invalid; - } - } - - if (mantissaDigits < 19) - { - mantissa = (10 * mantissa) + (ulong)(c - '0'); - if (mantissa > 0) - { - ++mantissaDigits; - } - } - else - { - ++exponentFromMantissa; - } - break; - } - } - - exponent += exponentFromMantissa; - - // correct the decimal point - exponent -= (numDecimalEnd - numDecimalStart); - - value = IEEE754.PackDouble(isNegative, mantissa, exponent); - return double.IsInfinity(value) ? ParseResult.Overflow : ParseResult.Success; - } -#endif - - public static ParseResult DecimalTryParse(char[] chars, int start, int length, out decimal value) - { - value = 0M; - const decimal decimalMaxValueHi28 = 7922816251426433759354395033M; - const ulong decimalMaxValueHi19 = 7922816251426433759UL; - const ulong decimalMaxValueLo9 = 354395033UL; - const char decimalMaxValueLo1 = '5'; - - if (length == 0) - { - return ParseResult.Invalid; - } - - bool isNegative = (chars[start] == '-'); - if (isNegative) - { - // text just a negative sign - if (length == 1) - { - return ParseResult.Invalid; - } - - start++; - length--; - } - - int i = start; - int end = start + length; - int numDecimalStart = end; - int numDecimalEnd = end; - int exponent = 0; - ulong hi19 = 0UL; - ulong lo10 = 0UL; - int mantissaDigits = 0; - int exponentFromMantissa = 0; - char? digit29 = null; - bool? storeOnly28Digits = null; - for (; i < end; i++) - { - char c = chars[i]; - switch (c) - { - case '.': - if (i == start) - { - return ParseResult.Invalid; - } - if (i + 1 == end) - { - return ParseResult.Invalid; - } - - if (numDecimalStart != end) - { - // multiple decimal points - return ParseResult.Invalid; - } - - numDecimalStart = i + 1; - break; - case 'e': - case 'E': - if (i == start) - { - return ParseResult.Invalid; - } - if (i == numDecimalStart) - { - // E follows decimal point - return ParseResult.Invalid; - } - i++; - if (i == end) - { - return ParseResult.Invalid; - } - - if (numDecimalStart < end) - { - numDecimalEnd = i - 1; - } - - c = chars[i]; - bool exponentNegative = false; - switch (c) - { - case '-': - exponentNegative = true; - i++; - break; - case '+': - i++; - break; - } - - // parse 3 digit - for (; i < end; i++) - { - c = chars[i]; - if (c < '0' || c > '9') - { - return ParseResult.Invalid; - } - - int newExponent = (10 * exponent) + (c - '0'); - // stops updating exponent when overflowing - if (exponent < newExponent) - { - exponent = newExponent; - } - } - - if (exponentNegative) - { - exponent = -exponent; - } - break; - default: - if (c < '0' || c > '9') - { - return ParseResult.Invalid; - } - - if (i == start && c == '0') - { - i++; - if (i != end) - { - c = chars[i]; - if (c == '.') - { - goto case '.'; - } - if (c == 'e' || c == 'E') - { - goto case 'E'; - } - - return ParseResult.Invalid; - } - } - - if (mantissaDigits < 29 && (mantissaDigits != 28 || !(storeOnly28Digits ?? (storeOnly28Digits = (hi19 > decimalMaxValueHi19 || (hi19 == decimalMaxValueHi19 && (lo10 > decimalMaxValueLo9 || (lo10 == decimalMaxValueLo9 && c > decimalMaxValueLo1))))).GetValueOrDefault()))) - { - if (mantissaDigits < 19) - { - hi19 = (hi19 * 10UL) + (ulong)(c - '0'); - } - else - { - lo10 = (lo10 * 10UL) + (ulong)(c - '0'); - } - ++mantissaDigits; - } - else - { - if (!digit29.HasValue) - { - digit29 = c; - } - ++exponentFromMantissa; - } - break; - } - } - - exponent += exponentFromMantissa; - - // correct the decimal point - exponent -= (numDecimalEnd - numDecimalStart); - - if (mantissaDigits <= 19) - { - value = hi19; - } - else - { - value = (hi19 / new decimal(1, 0, 0, false, (byte)(mantissaDigits - 19))) + lo10; - } - - if (exponent > 0) - { - mantissaDigits += exponent; - if (mantissaDigits > 29) - { - return ParseResult.Overflow; - } - if (mantissaDigits == 29) - { - if (exponent > 1) - { - value /= new decimal(1, 0, 0, false, (byte)(exponent - 1)); - if (value > decimalMaxValueHi28) - { - return ParseResult.Overflow; - } - } - else if (value == decimalMaxValueHi28 && digit29 > decimalMaxValueLo1) - { - return ParseResult.Overflow; - } - value *= 10M; - } - else - { - value /= new decimal(1, 0, 0, false, (byte)exponent); - } - } - else - { - if (digit29 >= '5' && exponent >= -28) - { - ++value; - } - if (exponent < 0) - { - if (mantissaDigits + exponent + 28 <= 0) - { - value = isNegative ? -0M : 0M; - return ParseResult.Success; - } - if (exponent >= -28) - { - value *= new decimal(1, 0, 0, false, (byte)(-exponent)); - } - else - { - value /= 1e28M; - value *= new decimal(1, 0, 0, false, (byte)(-exponent - 28)); - } - } - } - - if (isNegative) - { - value = -value; - } - - return ParseResult.Success; - } - - public static bool TryConvertGuid(string s, out Guid g) - { - // GUID has to have format 00000000-0000-0000-0000-000000000000 -#if !HAVE_GUID_TRY_PARSE - if (s == null) - { - throw new ArgumentNullException("s"); - } - - Regex format = new Regex("^[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}$"); - Match match = format.Match(s); - if (match.Success) - { - g = new Guid(s); - return true; - } - - g = Guid.Empty; - return false; -#else - return Guid.TryParseExact(s, "D", out g); -#endif - } - - public static bool TryHexTextToInt(char[] text, int start, int end, out int value) - { - value = 0; - - for (int i = start; i < end; i++) - { - char ch = text[i]; - int chValue; - - if (ch <= 57 && ch >= 48) - { - chValue = ch - 48; - } - else if (ch <= 70 && ch >= 65) - { - chValue = ch - 55; - } - else if (ch <= 102 && ch >= 97) - { - chValue = ch - 87; - } - else - { - value = 0; - return false; - } - - value += chValue << ((end - 1 - i) * 4); - } - - return true; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/DateTimeParser.cs b/Source/MyDb/Newtonsoft.Json/Utilities/DateTimeParser.cs deleted file mode 100644 index 9addb98..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/DateTimeParser.cs +++ /dev/null @@ -1,277 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Utilities -{ - internal enum ParserTimeZone - { - Unspecified = 0, - Utc = 1, - LocalWestOfUtc = 2, - LocalEastOfUtc = 3 - } - - internal struct DateTimeParser - { - static DateTimeParser() - { - Power10 = new[] { -1, 10, 100, 1000, 10000, 100000, 1000000 }; - - Lzyyyy = "yyyy".Length; - Lzyyyy_ = "yyyy-".Length; - Lzyyyy_MM = "yyyy-MM".Length; - Lzyyyy_MM_ = "yyyy-MM-".Length; - Lzyyyy_MM_dd = "yyyy-MM-dd".Length; - Lzyyyy_MM_ddT = "yyyy-MM-ddT".Length; - LzHH = "HH".Length; - LzHH_ = "HH:".Length; - LzHH_mm = "HH:mm".Length; - LzHH_mm_ = "HH:mm:".Length; - LzHH_mm_ss = "HH:mm:ss".Length; - Lz_ = "-".Length; - Lz_zz = "-zz".Length; - } - - public int Year; - public int Month; - public int Day; - public int Hour; - public int Minute; - public int Second; - public int Fraction; - public int ZoneHour; - public int ZoneMinute; - public ParserTimeZone Zone; - - private char[] _text; - private int _end; - - private static readonly int[] Power10; - - private static readonly int Lzyyyy; - private static readonly int Lzyyyy_; - private static readonly int Lzyyyy_MM; - private static readonly int Lzyyyy_MM_; - private static readonly int Lzyyyy_MM_dd; - private static readonly int Lzyyyy_MM_ddT; - private static readonly int LzHH; - private static readonly int LzHH_; - private static readonly int LzHH_mm; - private static readonly int LzHH_mm_; - private static readonly int LzHH_mm_ss; - private static readonly int Lz_; - private static readonly int Lz_zz; - - private const short MaxFractionDigits = 7; - - public bool Parse(char[] text, int startIndex, int length) - { - _text = text; - _end = startIndex + length; - - if (ParseDate(startIndex) && ParseChar(Lzyyyy_MM_dd + startIndex, 'T') && ParseTimeAndZoneAndWhitespace(Lzyyyy_MM_ddT + startIndex)) - { - return true; - } - - return false; - } - - private bool ParseDate(int start) - { - return (Parse4Digit(start, out Year) - && 1 <= Year - && ParseChar(start + Lzyyyy, '-') - && Parse2Digit(start + Lzyyyy_, out Month) - && 1 <= Month - && Month <= 12 - && ParseChar(start + Lzyyyy_MM, '-') - && Parse2Digit(start + Lzyyyy_MM_, out Day) - && 1 <= Day - && Day <= DateTime.DaysInMonth(Year, Month)); - } - - private bool ParseTimeAndZoneAndWhitespace(int start) - { - return (ParseTime(ref start) && ParseZone(start)); - } - - private bool ParseTime(ref int start) - { - if (!(Parse2Digit(start, out Hour) - && Hour <= 24 - && ParseChar(start + LzHH, ':') - && Parse2Digit(start + LzHH_, out Minute) - && Minute < 60 - && ParseChar(start + LzHH_mm, ':') - && Parse2Digit(start + LzHH_mm_, out Second) - && Second < 60 - && (Hour != 24 || (Minute == 0 && Second == 0)))) // hour can be 24 if minute/second is zero) - { - return false; - } - - start += LzHH_mm_ss; - if (ParseChar(start, '.')) - { - Fraction = 0; - int numberOfDigits = 0; - - while (++start < _end && numberOfDigits < MaxFractionDigits) - { - int digit = _text[start] - '0'; - if (digit < 0 || digit > 9) - { - break; - } - - Fraction = (Fraction * 10) + digit; - - numberOfDigits++; - } - - if (numberOfDigits < MaxFractionDigits) - { - if (numberOfDigits == 0) - { - return false; - } - - Fraction *= Power10[MaxFractionDigits - numberOfDigits]; - } - - if (Hour == 24 && Fraction != 0) - { - return false; - } - } - return true; - } - - private bool ParseZone(int start) - { - if (start < _end) - { - char ch = _text[start]; - if (ch == 'Z' || ch == 'z') - { - Zone = ParserTimeZone.Utc; - start++; - } - else - { - if (start + 2 < _end - && Parse2Digit(start + Lz_, out ZoneHour) - && ZoneHour <= 99) - { - switch (ch) - { - case '-': - Zone = ParserTimeZone.LocalWestOfUtc; - start += Lz_zz; - break; - - case '+': - Zone = ParserTimeZone.LocalEastOfUtc; - start += Lz_zz; - break; - } - } - - if (start < _end) - { - if (ParseChar(start, ':')) - { - start += 1; - - if (start + 1 < _end - && Parse2Digit(start, out ZoneMinute) - && ZoneMinute <= 99) - { - start += 2; - } - } - else - { - if (start + 1 < _end - && Parse2Digit(start, out ZoneMinute) - && ZoneMinute <= 99) - { - start += 2; - } - } - } - } - } - - return (start == _end); - } - - private bool Parse4Digit(int start, out int num) - { - if (start + 3 < _end) - { - int digit1 = _text[start] - '0'; - int digit2 = _text[start + 1] - '0'; - int digit3 = _text[start + 2] - '0'; - int digit4 = _text[start + 3] - '0'; - if (0 <= digit1 && digit1 < 10 - && 0 <= digit2 && digit2 < 10 - && 0 <= digit3 && digit3 < 10 - && 0 <= digit4 && digit4 < 10) - { - num = (((((digit1 * 10) + digit2) * 10) + digit3) * 10) + digit4; - return true; - } - } - num = 0; - return false; - } - - private bool Parse2Digit(int start, out int num) - { - if (start + 1 < _end) - { - int digit1 = _text[start] - '0'; - int digit2 = _text[start + 1] - '0'; - if (0 <= digit1 && digit1 < 10 - && 0 <= digit2 && digit2 < 10) - { - num = (digit1 * 10) + digit2; - return true; - } - } - num = 0; - return false; - } - - private bool ParseChar(int start, char ch) - { - return (start < _end && _text[start] == ch); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/DateTimeUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/DateTimeUtils.cs deleted file mode 100644 index af000ea..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/DateTimeUtils.cs +++ /dev/null @@ -1,825 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.IO; -using System.Xml; -using System.Globalization; - -namespace Newtonsoft.Json.Utilities -{ - internal static class DateTimeUtils - { - internal static readonly long InitialJavaScriptDateTicks = 621355968000000000; - private const string IsoDateFormat = "yyyy-MM-ddTHH:mm:ss.FFFFFFFK"; - - private const int DaysPer100Years = 36524; - private const int DaysPer400Years = 146097; - private const int DaysPer4Years = 1461; - private const int DaysPerYear = 365; - private const long TicksPerDay = 864000000000L; - private static readonly int[] DaysToMonth365; - private static readonly int[] DaysToMonth366; - - static DateTimeUtils() - { - DaysToMonth365 = new[] { 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365 }; - DaysToMonth366 = new[] { 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366 }; - } - - public static TimeSpan GetUtcOffset(this DateTime d) - { -#if !HAVE_TIME_ZONE_INFO - return TimeZone.CurrentTimeZone.GetUtcOffset(d); -#else - return TimeZoneInfo.Local.GetUtcOffset(d); -#endif - } - -#if !(PORTABLE40 || PORTABLE) || NETSTANDARD1_3 - public static XmlDateTimeSerializationMode ToSerializationMode(DateTimeKind kind) - { - switch (kind) - { - case DateTimeKind.Local: - return XmlDateTimeSerializationMode.Local; - case DateTimeKind.Unspecified: - return XmlDateTimeSerializationMode.Unspecified; - case DateTimeKind.Utc: - return XmlDateTimeSerializationMode.Utc; - default: - throw MiscellaneousUtils.CreateArgumentOutOfRangeException(nameof(kind), kind, "Unexpected DateTimeKind value."); - } - } -#else - public static string ToDateTimeFormat(DateTimeKind kind) - { - switch (kind) - { - case DateTimeKind.Local: - return IsoDateFormat; - case DateTimeKind.Unspecified: - return "yyyy-MM-ddTHH:mm:ss.FFFFFFF"; - case DateTimeKind.Utc: - return "yyyy-MM-ddTHH:mm:ss.FFFFFFFZ"; - default: - throw MiscellaneousUtils.CreateArgumentOutOfRangeException(nameof(kind), kind, "Unexpected DateTimeKind value."); - } - } -#endif - - internal static DateTime EnsureDateTime(DateTime value, DateTimeZoneHandling timeZone) - { - switch (timeZone) - { - case DateTimeZoneHandling.Local: - value = SwitchToLocalTime(value); - break; - case DateTimeZoneHandling.Utc: - value = SwitchToUtcTime(value); - break; - case DateTimeZoneHandling.Unspecified: - value = new DateTime(value.Ticks, DateTimeKind.Unspecified); - break; - case DateTimeZoneHandling.RoundtripKind: - break; - default: - throw new ArgumentException("Invalid date time handling value."); - } - - return value; - } - - private static DateTime SwitchToLocalTime(DateTime value) - { - switch (value.Kind) - { - case DateTimeKind.Unspecified: - return new DateTime(value.Ticks, DateTimeKind.Local); - - case DateTimeKind.Utc: - return value.ToLocalTime(); - - case DateTimeKind.Local: - return value; - } - return value; - } - - private static DateTime SwitchToUtcTime(DateTime value) - { - switch (value.Kind) - { - case DateTimeKind.Unspecified: - return new DateTime(value.Ticks, DateTimeKind.Utc); - - case DateTimeKind.Utc: - return value; - - case DateTimeKind.Local: - return value.ToUniversalTime(); - } - return value; - } - - private static long ToUniversalTicks(DateTime dateTime) - { - if (dateTime.Kind == DateTimeKind.Utc) - { - return dateTime.Ticks; - } - - return ToUniversalTicks(dateTime, dateTime.GetUtcOffset()); - } - - private static long ToUniversalTicks(DateTime dateTime, TimeSpan offset) - { - // special case min and max value - // they never have a timezone appended to avoid issues - if (dateTime.Kind == DateTimeKind.Utc || dateTime == DateTime.MaxValue || dateTime == DateTime.MinValue) - { - return dateTime.Ticks; - } - - long ticks = dateTime.Ticks - offset.Ticks; - if (ticks > 3155378975999999999L) - { - return 3155378975999999999L; - } - - if (ticks < 0L) - { - return 0L; - } - - return ticks; - } - - internal static long ConvertDateTimeToJavaScriptTicks(DateTime dateTime, TimeSpan offset) - { - long universalTicks = ToUniversalTicks(dateTime, offset); - - return UniversalTicksToJavaScriptTicks(universalTicks); - } - - internal static long ConvertDateTimeToJavaScriptTicks(DateTime dateTime) - { - return ConvertDateTimeToJavaScriptTicks(dateTime, true); - } - - internal static long ConvertDateTimeToJavaScriptTicks(DateTime dateTime, bool convertToUtc) - { - long ticks = (convertToUtc) ? ToUniversalTicks(dateTime) : dateTime.Ticks; - - return UniversalTicksToJavaScriptTicks(ticks); - } - - private static long UniversalTicksToJavaScriptTicks(long universalTicks) - { - long javaScriptTicks = (universalTicks - InitialJavaScriptDateTicks) / 10000; - - return javaScriptTicks; - } - - internal static DateTime ConvertJavaScriptTicksToDateTime(long javaScriptTicks) - { - DateTime dateTime = new DateTime((javaScriptTicks * 10000) + InitialJavaScriptDateTicks, DateTimeKind.Utc); - - return dateTime; - } - - #region Parse - internal static bool TryParseDateTimeIso(StringReference text, DateTimeZoneHandling dateTimeZoneHandling, out DateTime dt) - { - DateTimeParser dateTimeParser = new DateTimeParser(); - if (!dateTimeParser.Parse(text.Chars, text.StartIndex, text.Length)) - { - dt = default; - return false; - } - - DateTime d = CreateDateTime(dateTimeParser); - - long ticks; - - switch (dateTimeParser.Zone) - { - case ParserTimeZone.Utc: - d = new DateTime(d.Ticks, DateTimeKind.Utc); - break; - - case ParserTimeZone.LocalWestOfUtc: - { - TimeSpan offset = new TimeSpan(dateTimeParser.ZoneHour, dateTimeParser.ZoneMinute, 0); - ticks = d.Ticks + offset.Ticks; - if (ticks <= DateTime.MaxValue.Ticks) - { - d = new DateTime(ticks, DateTimeKind.Utc).ToLocalTime(); - } - else - { - ticks += d.GetUtcOffset().Ticks; - if (ticks > DateTime.MaxValue.Ticks) - { - ticks = DateTime.MaxValue.Ticks; - } - - d = new DateTime(ticks, DateTimeKind.Local); - } - break; - } - case ParserTimeZone.LocalEastOfUtc: - { - TimeSpan offset = new TimeSpan(dateTimeParser.ZoneHour, dateTimeParser.ZoneMinute, 0); - ticks = d.Ticks - offset.Ticks; - if (ticks >= DateTime.MinValue.Ticks) - { - d = new DateTime(ticks, DateTimeKind.Utc).ToLocalTime(); - } - else - { - ticks += d.GetUtcOffset().Ticks; - if (ticks < DateTime.MinValue.Ticks) - { - ticks = DateTime.MinValue.Ticks; - } - - d = new DateTime(ticks, DateTimeKind.Local); - } - break; - } - } - - dt = EnsureDateTime(d, dateTimeZoneHandling); - return true; - } - -#if HAVE_DATE_TIME_OFFSET - internal static bool TryParseDateTimeOffsetIso(StringReference text, out DateTimeOffset dt) - { - DateTimeParser dateTimeParser = new DateTimeParser(); - if (!dateTimeParser.Parse(text.Chars, text.StartIndex, text.Length)) - { - dt = default; - return false; - } - - DateTime d = CreateDateTime(dateTimeParser); - - TimeSpan offset; - - switch (dateTimeParser.Zone) - { - case ParserTimeZone.Utc: - offset = new TimeSpan(0L); - break; - case ParserTimeZone.LocalWestOfUtc: - offset = new TimeSpan(-dateTimeParser.ZoneHour, -dateTimeParser.ZoneMinute, 0); - break; - case ParserTimeZone.LocalEastOfUtc: - offset = new TimeSpan(dateTimeParser.ZoneHour, dateTimeParser.ZoneMinute, 0); - break; - default: - offset = TimeZoneInfo.Local.GetUtcOffset(d); - break; - } - - long ticks = d.Ticks - offset.Ticks; - if (ticks < 0 || ticks > 3155378975999999999) - { - dt = default; - return false; - } - - dt = new DateTimeOffset(d, offset); - return true; - } -#endif - - private static DateTime CreateDateTime(DateTimeParser dateTimeParser) - { - bool is24Hour; - if (dateTimeParser.Hour == 24) - { - is24Hour = true; - dateTimeParser.Hour = 0; - } - else - { - is24Hour = false; - } - - DateTime d = new DateTime(dateTimeParser.Year, dateTimeParser.Month, dateTimeParser.Day, dateTimeParser.Hour, dateTimeParser.Minute, dateTimeParser.Second); - d = d.AddTicks(dateTimeParser.Fraction); - - if (is24Hour) - { - d = d.AddDays(1); - } - return d; - } - - internal static bool TryParseDateTime(StringReference s, DateTimeZoneHandling dateTimeZoneHandling, string? dateFormatString, CultureInfo culture, out DateTime dt) - { - if (s.Length > 0) - { - int i = s.StartIndex; - if (s[i] == '/') - { - if (s.Length >= 9 && s.StartsWith("/Date(") && s.EndsWith(")/")) - { - if (TryParseDateTimeMicrosoft(s, dateTimeZoneHandling, out dt)) - { - return true; - } - } - } - else if (s.Length >= 19 && s.Length <= 40 && char.IsDigit(s[i]) && s[i + 10] == 'T') - { - if (TryParseDateTimeIso(s, dateTimeZoneHandling, out dt)) - { - return true; - } - } - - if (!StringUtils.IsNullOrEmpty(dateFormatString)) - { - if (TryParseDateTimeExact(s.ToString(), dateTimeZoneHandling, dateFormatString, culture, out dt)) - { - return true; - } - } - } - - dt = default; - return false; - } - - internal static bool TryParseDateTime(string s, DateTimeZoneHandling dateTimeZoneHandling, string? dateFormatString, CultureInfo culture, out DateTime dt) - { - if (s.Length > 0) - { - if (s[0] == '/') - { - if (s.Length >= 9 && s.StartsWith("/Date(", StringComparison.Ordinal) && s.EndsWith(")/", StringComparison.Ordinal)) - { - if (TryParseDateTimeMicrosoft(new StringReference(s.ToCharArray(), 0, s.Length), dateTimeZoneHandling, out dt)) - { - return true; - } - } - } - else if (s.Length >= 19 && s.Length <= 40 && char.IsDigit(s[0]) && s[10] == 'T') - { - if (DateTime.TryParseExact(s, IsoDateFormat, CultureInfo.InvariantCulture, DateTimeStyles.RoundtripKind, out dt)) - { - dt = EnsureDateTime(dt, dateTimeZoneHandling); - return true; - } - } - - if (!StringUtils.IsNullOrEmpty(dateFormatString)) - { - if (TryParseDateTimeExact(s, dateTimeZoneHandling, dateFormatString, culture, out dt)) - { - return true; - } - } - } - - dt = default; - return false; - } - -#if HAVE_DATE_TIME_OFFSET - internal static bool TryParseDateTimeOffset(StringReference s, string? dateFormatString, CultureInfo culture, out DateTimeOffset dt) - { - if (s.Length > 0) - { - int i = s.StartIndex; - if (s[i] == '/') - { - if (s.Length >= 9 && s.StartsWith("/Date(") && s.EndsWith(")/")) - { - if (TryParseDateTimeOffsetMicrosoft(s, out dt)) - { - return true; - } - } - } - else if (s.Length >= 19 && s.Length <= 40 && char.IsDigit(s[i]) && s[i + 10] == 'T') - { - if (TryParseDateTimeOffsetIso(s, out dt)) - { - return true; - } - } - - if (!StringUtils.IsNullOrEmpty(dateFormatString)) - { - if (TryParseDateTimeOffsetExact(s.ToString(), dateFormatString, culture, out dt)) - { - return true; - } - } - } - - dt = default; - return false; - } - - internal static bool TryParseDateTimeOffset(string s, string? dateFormatString, CultureInfo culture, out DateTimeOffset dt) - { - if (s.Length > 0) - { - if (s[0] == '/') - { - if (s.Length >= 9 && s.StartsWith("/Date(", StringComparison.Ordinal) && s.EndsWith(")/", StringComparison.Ordinal)) - { - if (TryParseDateTimeOffsetMicrosoft(new StringReference(s.ToCharArray(), 0, s.Length), out dt)) - { - return true; - } - } - } - else if (s.Length >= 19 && s.Length <= 40 && char.IsDigit(s[0]) && s[10] == 'T') - { - if (DateTimeOffset.TryParseExact(s, IsoDateFormat, CultureInfo.InvariantCulture, DateTimeStyles.RoundtripKind, out dt)) - { - if (TryParseDateTimeOffsetIso(new StringReference(s.ToCharArray(), 0, s.Length), out dt)) - { - return true; - } - } - } - - if (!StringUtils.IsNullOrEmpty(dateFormatString)) - { - if (TryParseDateTimeOffsetExact(s, dateFormatString, culture, out dt)) - { - return true; - } - } - } - - dt = default; - return false; - } -#endif - - private static bool TryParseMicrosoftDate(StringReference text, out long ticks, out TimeSpan offset, out DateTimeKind kind) - { - kind = DateTimeKind.Utc; - - int index = text.IndexOf('+', 7, text.Length - 8); - - if (index == -1) - { - index = text.IndexOf('-', 7, text.Length - 8); - } - - if (index != -1) - { - kind = DateTimeKind.Local; - - if (!TryReadOffset(text, index + text.StartIndex, out offset)) - { - ticks = 0; - return false; - } - } - else - { - offset = TimeSpan.Zero; - index = text.Length - 2; - } - - return (ConvertUtils.Int64TryParse(text.Chars, 6 + text.StartIndex, index - 6, out ticks) == ParseResult.Success); - } - - private static bool TryParseDateTimeMicrosoft(StringReference text, DateTimeZoneHandling dateTimeZoneHandling, out DateTime dt) - { - if (!TryParseMicrosoftDate(text, out long ticks, out _, out DateTimeKind kind)) - { - dt = default; - return false; - } - - DateTime utcDateTime = ConvertJavaScriptTicksToDateTime(ticks); - - switch (kind) - { - case DateTimeKind.Unspecified: - dt = DateTime.SpecifyKind(utcDateTime.ToLocalTime(), DateTimeKind.Unspecified); - break; - case DateTimeKind.Local: - dt = utcDateTime.ToLocalTime(); - break; - default: - dt = utcDateTime; - break; - } - - dt = EnsureDateTime(dt, dateTimeZoneHandling); - return true; - } - - private static bool TryParseDateTimeExact(string text, DateTimeZoneHandling dateTimeZoneHandling, string dateFormatString, CultureInfo culture, out DateTime dt) - { - if (DateTime.TryParseExact(text, dateFormatString, culture, DateTimeStyles.RoundtripKind, out DateTime temp)) - { - temp = EnsureDateTime(temp, dateTimeZoneHandling); - dt = temp; - return true; - } - - dt = default; - return false; - } - -#if HAVE_DATE_TIME_OFFSET - private static bool TryParseDateTimeOffsetMicrosoft(StringReference text, out DateTimeOffset dt) - { - if (!TryParseMicrosoftDate(text, out long ticks, out TimeSpan offset, out _)) - { - dt = default(DateTime); - return false; - } - - DateTime utcDateTime = ConvertJavaScriptTicksToDateTime(ticks); - - dt = new DateTimeOffset(utcDateTime.Add(offset).Ticks, offset); - return true; - } - - private static bool TryParseDateTimeOffsetExact(string text, string dateFormatString, CultureInfo culture, out DateTimeOffset dt) - { - if (DateTimeOffset.TryParseExact(text, dateFormatString, culture, DateTimeStyles.RoundtripKind, out DateTimeOffset temp)) - { - dt = temp; - return true; - } - - dt = default; - return false; - } -#endif - - private static bool TryReadOffset(StringReference offsetText, int startIndex, out TimeSpan offset) - { - bool negative = (offsetText[startIndex] == '-'); - - if (ConvertUtils.Int32TryParse(offsetText.Chars, startIndex + 1, 2, out int hours) != ParseResult.Success) - { - offset = default; - return false; - } - - int minutes = 0; - if (offsetText.Length - startIndex > 5) - { - if (ConvertUtils.Int32TryParse(offsetText.Chars, startIndex + 3, 2, out minutes) != ParseResult.Success) - { - offset = default; - return false; - } - } - - offset = TimeSpan.FromHours(hours) + TimeSpan.FromMinutes(minutes); - if (negative) - { - offset = offset.Negate(); - } - - return true; - } - #endregion - - #region Write - internal static void WriteDateTimeString(TextWriter writer, DateTime value, DateFormatHandling format, string? formatString, CultureInfo culture) - { - if (StringUtils.IsNullOrEmpty(formatString)) - { - char[] chars = new char[64]; - int pos = WriteDateTimeString(chars, 0, value, null, value.Kind, format); - writer.Write(chars, 0, pos); - } - else - { - writer.Write(value.ToString(formatString, culture)); - } - } - - internal static int WriteDateTimeString(char[] chars, int start, DateTime value, TimeSpan? offset, DateTimeKind kind, DateFormatHandling format) - { - int pos = start; - - if (format == DateFormatHandling.MicrosoftDateFormat) - { - TimeSpan o = offset ?? value.GetUtcOffset(); - - long javaScriptTicks = ConvertDateTimeToJavaScriptTicks(value, o); - - @"\/Date(".CopyTo(0, chars, pos, 7); - pos += 7; - - string ticksText = javaScriptTicks.ToString(CultureInfo.InvariantCulture); - ticksText.CopyTo(0, chars, pos, ticksText.Length); - pos += ticksText.Length; - - switch (kind) - { - case DateTimeKind.Unspecified: - if (value != DateTime.MaxValue && value != DateTime.MinValue) - { - pos = WriteDateTimeOffset(chars, pos, o, format); - } - break; - case DateTimeKind.Local: - pos = WriteDateTimeOffset(chars, pos, o, format); - break; - } - - @")\/".CopyTo(0, chars, pos, 3); - pos += 3; - } - else - { - pos = WriteDefaultIsoDate(chars, pos, value); - - switch (kind) - { - case DateTimeKind.Local: - pos = WriteDateTimeOffset(chars, pos, offset ?? value.GetUtcOffset(), format); - break; - case DateTimeKind.Utc: - chars[pos++] = 'Z'; - break; - } - } - - return pos; - } - - internal static int WriteDefaultIsoDate(char[] chars, int start, DateTime dt) - { - int length = 19; - - GetDateValues(dt, out int year, out int month, out int day); - - CopyIntToCharArray(chars, start, year, 4); - chars[start + 4] = '-'; - CopyIntToCharArray(chars, start + 5, month, 2); - chars[start + 7] = '-'; - CopyIntToCharArray(chars, start + 8, day, 2); - chars[start + 10] = 'T'; - CopyIntToCharArray(chars, start + 11, dt.Hour, 2); - chars[start + 13] = ':'; - CopyIntToCharArray(chars, start + 14, dt.Minute, 2); - chars[start + 16] = ':'; - CopyIntToCharArray(chars, start + 17, dt.Second, 2); - - int fraction = (int)(dt.Ticks % 10000000L); - - if (fraction != 0) - { - int digits = 7; - while ((fraction % 10) == 0) - { - digits--; - fraction /= 10; - } - - chars[start + 19] = '.'; - CopyIntToCharArray(chars, start + 20, fraction, digits); - - length += digits + 1; - } - - return start + length; - } - - private static void CopyIntToCharArray(char[] chars, int start, int value, int digits) - { - while (digits-- != 0) - { - chars[start + digits] = (char)((value % 10) + 48); - value /= 10; - } - } - - internal static int WriteDateTimeOffset(char[] chars, int start, TimeSpan offset, DateFormatHandling format) - { - chars[start++] = (offset.Ticks >= 0L) ? '+' : '-'; - - int absHours = Math.Abs(offset.Hours); - CopyIntToCharArray(chars, start, absHours, 2); - start += 2; - - if (format == DateFormatHandling.IsoDateFormat) - { - chars[start++] = ':'; - } - - int absMinutes = Math.Abs(offset.Minutes); - CopyIntToCharArray(chars, start, absMinutes, 2); - start += 2; - - return start; - } - -#if HAVE_DATE_TIME_OFFSET - internal static void WriteDateTimeOffsetString(TextWriter writer, DateTimeOffset value, DateFormatHandling format, string? formatString, CultureInfo culture) - { - if (StringUtils.IsNullOrEmpty(formatString)) - { - char[] chars = new char[64]; - int pos = WriteDateTimeString(chars, 0, (format == DateFormatHandling.IsoDateFormat) ? value.DateTime : value.UtcDateTime, value.Offset, DateTimeKind.Local, format); - - writer.Write(chars, 0, pos); - } - else - { - writer.Write(value.ToString(formatString, culture)); - } - } -#endif - #endregion - - private static void GetDateValues(DateTime td, out int year, out int month, out int day) - { - long ticks = td.Ticks; - // n = number of days since 1/1/0001 - int n = (int)(ticks / TicksPerDay); - // y400 = number of whole 400-year periods since 1/1/0001 - int y400 = n / DaysPer400Years; - // n = day number within 400-year period - n -= y400 * DaysPer400Years; - // y100 = number of whole 100-year periods within 400-year period - int y100 = n / DaysPer100Years; - // Last 100-year period has an extra day, so decrement result if 4 - if (y100 == 4) - { - y100 = 3; - } - // n = day number within 100-year period - n -= y100 * DaysPer100Years; - // y4 = number of whole 4-year periods within 100-year period - int y4 = n / DaysPer4Years; - // n = day number within 4-year period - n -= y4 * DaysPer4Years; - // y1 = number of whole years within 4-year period - int y1 = n / DaysPerYear; - // Last year has an extra day, so decrement result if 4 - if (y1 == 4) - { - y1 = 3; - } - - year = y400 * 400 + y100 * 100 + y4 * 4 + y1 + 1; - - // n = day number within year - n -= y1 * DaysPerYear; - - // Leap year calculation looks different from IsLeapYear since y1, y4, - // and y100 are relative to year 1, not year 0 - bool leapYear = y1 == 3 && (y4 != 24 || y100 == 3); - int[] days = leapYear ? DaysToMonth366 : DaysToMonth365; - // All months have less than 32 days, so n >> 5 is a good conservative - // estimate for the month - int m = n >> 5 + 1; - // m = 1-based month number - while (n >= days[m]) - { - m++; - } - - month = m; - - // Return 1-based day-of-month - day = n - days[m - 1] + 1; - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/DictionaryWrapper.cs b/Source/MyDb/Newtonsoft.Json/Utilities/DictionaryWrapper.cs deleted file mode 100644 index a92e263..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/DictionaryWrapper.cs +++ /dev/null @@ -1,719 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Collections; -using System.Threading; -using System.Diagnostics; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif - -namespace Newtonsoft.Json.Utilities -{ - internal interface IWrappedDictionary - : IDictionary - { - object UnderlyingDictionary { get; } - } - - internal class DictionaryWrapper : IDictionary, IWrappedDictionary - { - private readonly IDictionary? _dictionary; - private readonly IDictionary? _genericDictionary; -#if HAVE_READ_ONLY_COLLECTIONS - private readonly IReadOnlyDictionary? _readOnlyDictionary; -#endif - private object? _syncRoot; - - public DictionaryWrapper(IDictionary dictionary) - { - ValidationUtils.ArgumentNotNull(dictionary, nameof(dictionary)); - - _dictionary = dictionary; - } - - public DictionaryWrapper(IDictionary dictionary) - { - ValidationUtils.ArgumentNotNull(dictionary, nameof(dictionary)); - - _genericDictionary = dictionary; - } - -#if HAVE_READ_ONLY_COLLECTIONS - public DictionaryWrapper(IReadOnlyDictionary dictionary) - { - ValidationUtils.ArgumentNotNull(dictionary, nameof(dictionary)); - - _readOnlyDictionary = dictionary; - } -#endif - - internal IDictionary GenericDictionary - { - get - { - MiscellaneousUtils.Assert(_genericDictionary != null); - return _genericDictionary; - } - } - - public void Add(TKey key, TValue value) - { - if (_dictionary != null) - { - _dictionary.Add(key, value); - } - else if (_genericDictionary != null) - { - _genericDictionary.Add(key, value); - } - else - { - throw new NotSupportedException(); - } - } - - public bool ContainsKey(TKey key) - { - if (_dictionary != null) - { - return _dictionary.Contains(key); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary.ContainsKey(key); - } -#endif - else - { - return GenericDictionary.ContainsKey(key); - } - } - - public ICollection Keys - { - get - { - if (_dictionary != null) - { - return _dictionary.Keys.Cast().ToList(); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary.Keys.ToList(); - } -#endif - else - { - return GenericDictionary.Keys; - } - } - } - - public bool Remove(TKey key) - { - if (_dictionary != null) - { - if (_dictionary.Contains(key)) - { - _dictionary.Remove(key); - return true; - } - else - { - return false; - } - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - return GenericDictionary.Remove(key); - } - } - -#pragma warning disable CS8767 // Nullability of reference types in type of parameter doesn't match implicitly implemented member (possibly because of nullability attributes). - public bool TryGetValue(TKey key, out TValue? value) -#pragma warning restore CS8767 // Nullability of reference types in type of parameter doesn't match implicitly implemented member (possibly because of nullability attributes). - { - if (_dictionary != null) - { - if (!_dictionary.Contains(key)) - { -#pragma warning disable CS8653 // A default expression introduces a null value for a type parameter. - value = default; -#pragma warning restore CS8653 // A default expression introduces a null value for a type parameter. - return false; - } - else - { - value = (TValue)_dictionary[key]; - return true; - } - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - return GenericDictionary.TryGetValue(key, out value); - } - } - - public ICollection Values - { - get - { - if (_dictionary != null) - { - return _dictionary.Values.Cast().ToList(); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary.Values.ToList(); - } -#endif - else - { - return GenericDictionary.Values; - } - } - } - - public TValue this[TKey key] - { - get - { - if (_dictionary != null) - { - return (TValue)_dictionary[key]; - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary[key]; - } -#endif - else - { - return GenericDictionary[key]; - } - } - set - { - if (_dictionary != null) - { - _dictionary[key] = value; - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - GenericDictionary[key] = value; - } - } - } - - public void Add(KeyValuePair item) - { - if (_dictionary != null) - { - ((IList)_dictionary).Add(item); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - _genericDictionary?.Add(item); - } - } - - public void Clear() - { - if (_dictionary != null) - { - _dictionary.Clear(); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - GenericDictionary.Clear(); - } - } - - public bool Contains(KeyValuePair item) - { - if (_dictionary != null) - { - return ((IList)_dictionary).Contains(item); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary.Contains(item); - } -#endif - else - { - return GenericDictionary.Contains(item); - } - } - - public void CopyTo(KeyValuePair[] array, int arrayIndex) - { - if (_dictionary != null) - { - // Manual use of IDictionaryEnumerator instead of foreach to avoid DictionaryEntry box allocations. - IDictionaryEnumerator e = _dictionary.GetEnumerator(); - try - { - while (e.MoveNext()) - { - DictionaryEntry entry = e.Entry; - array[arrayIndex++] = new KeyValuePair((TKey)entry.Key, (TValue)entry.Value); - } - } - finally - { - (e as IDisposable)?.Dispose(); - } - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - GenericDictionary.CopyTo(array, arrayIndex); - } - } - - public int Count - { - get - { - if (_dictionary != null) - { - return _dictionary.Count; - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary.Count; - } -#endif - else - { - return GenericDictionary.Count; - } - } - } - - public bool IsReadOnly - { - get - { - if (_dictionary != null) - { - return _dictionary.IsReadOnly; - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return true; - } -#endif - else - { - return GenericDictionary.IsReadOnly; - } - } - } - - public bool Remove(KeyValuePair item) - { - if (_dictionary != null) - { - if (_dictionary.Contains(item.Key)) - { - object value = _dictionary[item.Key]; - - if (Equals(value, item.Value)) - { - _dictionary.Remove(item.Key); - return true; - } - else - { - return false; - } - } - else - { - return true; - } - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - return GenericDictionary.Remove(item); - } - } - - public IEnumerator> GetEnumerator() - { - if (_dictionary != null) - { - return _dictionary.Cast().Select(de => new KeyValuePair((TKey)de.Key, (TValue)de.Value)).GetEnumerator(); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary.GetEnumerator(); - } -#endif - else - { - return GenericDictionary.GetEnumerator(); - } - } - - IEnumerator IEnumerable.GetEnumerator() - { - return GetEnumerator(); - } - - void IDictionary.Add(object key, object value) - { - if (_dictionary != null) - { - _dictionary.Add(key, value); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - GenericDictionary.Add((TKey)key, (TValue)value); - } - } - - object? IDictionary.this[object key] - { - get - { - if (_dictionary != null) - { - return _dictionary[key]; - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary[(TKey)key]; - } -#endif - else - { - return GenericDictionary[(TKey)key]; - } - } - set - { - if (_dictionary != null) - { - _dictionary[key] = value; - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - // Consider changing this code to call GenericDictionary.Remove when value is null. - // -#pragma warning disable CS8601 // Possible null reference assignment. -#pragma warning disable CS8600 // Converting null literal or possible null value to non-nullable type. - GenericDictionary[(TKey)key] = (TValue)value; -#pragma warning restore CS8600 // Converting null literal or possible null value to non-nullable type. -#pragma warning restore CS8601 // Possible null reference assignment. - } - } - } - - private readonly struct DictionaryEnumerator : IDictionaryEnumerator - { - private readonly IEnumerator> _e; - - public DictionaryEnumerator(IEnumerator> e) - { - ValidationUtils.ArgumentNotNull(e, nameof(e)); - _e = e; - } - - public DictionaryEntry Entry => (DictionaryEntry)Current; - - public object Key => Entry.Key; - - public object Value => Entry.Value; - - public object Current => new DictionaryEntry(_e.Current.Key, _e.Current.Value); - - public bool MoveNext() - { - return _e.MoveNext(); - } - - public void Reset() - { - _e.Reset(); - } - } - - IDictionaryEnumerator IDictionary.GetEnumerator() - { - if (_dictionary != null) - { - return _dictionary.GetEnumerator(); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return new DictionaryEnumerator(_readOnlyDictionary.GetEnumerator()); - } -#endif - else - { - return new DictionaryEnumerator(GenericDictionary.GetEnumerator()); - } - } - - bool IDictionary.Contains(object key) - { - if (_genericDictionary != null) - { - return _genericDictionary.ContainsKey((TKey)key); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary.ContainsKey((TKey)key); - } -#endif - else - { - return _dictionary!.Contains(key); - } - } - - bool IDictionary.IsFixedSize - { - get - { - if (_genericDictionary != null) - { - return false; - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return true; - } -#endif - else - { - return _dictionary!.IsFixedSize; - } - } - } - - ICollection IDictionary.Keys - { - get - { - if (_genericDictionary != null) - { - return _genericDictionary.Keys.ToList(); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary.Keys.ToList(); - } -#endif - else - { - return _dictionary!.Keys; - } - } - } - - public void Remove(object key) - { - if (_dictionary != null) - { - _dictionary.Remove(key); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - GenericDictionary.Remove((TKey)key); - } - } - - ICollection IDictionary.Values - { - get - { - if (_genericDictionary != null) - { - return _genericDictionary.Values.ToList(); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary.Values.ToList(); - } -#endif - else - { - return _dictionary!.Values; - } - } - } - - void ICollection.CopyTo(Array array, int index) - { - if (_dictionary != null) - { - _dictionary.CopyTo(array, index); - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - throw new NotSupportedException(); - } -#endif - else - { - GenericDictionary.CopyTo((KeyValuePair[])array, index); - } - } - - bool ICollection.IsSynchronized - { - get - { - if (_dictionary != null) - { - return _dictionary.IsSynchronized; - } - else - { - return false; - } - } - } - - object ICollection.SyncRoot - { - get - { - if (_syncRoot == null) - { - Interlocked.CompareExchange(ref _syncRoot, new object(), null); - } - - return _syncRoot; - } - } - - public object UnderlyingDictionary - { - get - { - if (_dictionary != null) - { - return _dictionary; - } -#if HAVE_READ_ONLY_COLLECTIONS - else if (_readOnlyDictionary != null) - { - return _readOnlyDictionary; - } -#endif - else - { - return GenericDictionary; - } - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/DynamicProxy.cs b/Source/MyDb/Newtonsoft.Json/Utilities/DynamicProxy.cs deleted file mode 100644 index 76734ca..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/DynamicProxy.cs +++ /dev/null @@ -1,109 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_DYNAMIC -using System.Collections.Generic; -using System.Dynamic; - -namespace Newtonsoft.Json.Utilities -{ - internal class DynamicProxy - { - public virtual IEnumerable GetDynamicMemberNames(T instance) - { - return CollectionUtils.ArrayEmpty(); - } - - public virtual bool TryBinaryOperation(T instance, BinaryOperationBinder binder, object arg, out object? result) - { - result = null; - return false; - } - - public virtual bool TryConvert(T instance, ConvertBinder binder, out object? result) - { - result = null; - return false; - } - - public virtual bool TryCreateInstance(T instance, CreateInstanceBinder binder, object[] args, out object? result) - { - result = null; - return false; - } - - public virtual bool TryDeleteIndex(T instance, DeleteIndexBinder binder, object[] indexes) - { - return false; - } - - public virtual bool TryDeleteMember(T instance, DeleteMemberBinder binder) - { - return false; - } - - public virtual bool TryGetIndex(T instance, GetIndexBinder binder, object[] indexes, out object? result) - { - result = null; - return false; - } - - public virtual bool TryGetMember(T instance, GetMemberBinder binder, out object? result) - { - result = null; - return false; - } - - public virtual bool TryInvoke(T instance, InvokeBinder binder, object[] args, out object? result) - { - result = null; - return false; - } - - public virtual bool TryInvokeMember(T instance, InvokeMemberBinder binder, object[] args, out object? result) - { - result = null; - return false; - } - - public virtual bool TrySetIndex(T instance, SetIndexBinder binder, object[] indexes, object value) - { - return false; - } - - public virtual bool TrySetMember(T instance, SetMemberBinder binder, object value) - { - return false; - } - - public virtual bool TryUnaryOperation(T instance, UnaryOperationBinder binder, out object? result) - { - result = null; - return false; - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/DynamicProxyMetaObject.cs b/Source/MyDb/Newtonsoft.Json/Utilities/DynamicProxyMetaObject.cs deleted file mode 100644 index 41286c3..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/DynamicProxyMetaObject.cs +++ /dev/null @@ -1,391 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_DYNAMIC -using System; -using System.Collections.Generic; -using System.Dynamic; -using System.Linq; -using System.Linq.Expressions; - -namespace Newtonsoft.Json.Utilities -{ - internal sealed class DynamicProxyMetaObject : DynamicMetaObject - { - private readonly DynamicProxy _proxy; - - internal DynamicProxyMetaObject(Expression expression, T value, DynamicProxy proxy) - : base(expression, BindingRestrictions.Empty, value) - { - _proxy = proxy; - } - - private bool IsOverridden(string method) - { - return ReflectionUtils.IsMethodOverridden(_proxy.GetType(), typeof(DynamicProxy), method); - } - - public override DynamicMetaObject BindGetMember(GetMemberBinder binder) - { - return IsOverridden(nameof(DynamicProxy.TryGetMember)) - ? CallMethodWithResult(nameof(DynamicProxy.TryGetMember), binder, NoArgs, e => binder.FallbackGetMember(this, e)) - : base.BindGetMember(binder); - } - - public override DynamicMetaObject BindSetMember(SetMemberBinder binder, DynamicMetaObject value) - { - return IsOverridden(nameof(DynamicProxy.TrySetMember)) - ? CallMethodReturnLast(nameof(DynamicProxy.TrySetMember), binder, GetArgs(value), e => binder.FallbackSetMember(this, value, e)) - : base.BindSetMember(binder, value); - } - - public override DynamicMetaObject BindDeleteMember(DeleteMemberBinder binder) - { - return IsOverridden(nameof(DynamicProxy.TryDeleteMember)) - ? CallMethodNoResult(nameof(DynamicProxy.TryDeleteMember), binder, NoArgs, e => binder.FallbackDeleteMember(this, e)) - : base.BindDeleteMember(binder); - } - - public override DynamicMetaObject BindConvert(ConvertBinder binder) - { - return IsOverridden(nameof(DynamicProxy.TryConvert)) - ? CallMethodWithResult(nameof(DynamicProxy.TryConvert), binder, NoArgs, e => binder.FallbackConvert(this, e)) - : base.BindConvert(binder); - } - - public override DynamicMetaObject BindInvokeMember(InvokeMemberBinder binder, DynamicMetaObject[] args) - { - if (!IsOverridden(nameof(DynamicProxy.TryInvokeMember))) - { - return base.BindInvokeMember(binder, args); - } - - // - // Generate a tree like: - // - // { - // object result; - // TryInvokeMember(payload, out result) - // ? result - // : TryGetMember(payload, out result) - // ? FallbackInvoke(result) - // : fallbackResult - // } - // - // Then it calls FallbackInvokeMember with this tree as the - // "error", giving the language the option of using this - // tree or doing .NET binding. - // - Fallback fallback = e => binder.FallbackInvokeMember(this, args, e); - - return BuildCallMethodWithResult( - nameof(DynamicProxy.TryInvokeMember), - binder, - GetArgArray(args), - BuildCallMethodWithResult( - nameof(DynamicProxy.TryGetMember), - new GetBinderAdapter(binder), - NoArgs, - fallback(null), - e => binder.FallbackInvoke(e, args, null) - ), - null - ); - } - - public override DynamicMetaObject BindCreateInstance(CreateInstanceBinder binder, DynamicMetaObject[] args) - { - return IsOverridden(nameof(DynamicProxy.TryCreateInstance)) - ? CallMethodWithResult(nameof(DynamicProxy.TryCreateInstance), binder, GetArgArray(args), e => binder.FallbackCreateInstance(this, args, e)) - : base.BindCreateInstance(binder, args); - } - - public override DynamicMetaObject BindInvoke(InvokeBinder binder, DynamicMetaObject[] args) - { - return IsOverridden(nameof(DynamicProxy.TryInvoke)) - ? CallMethodWithResult(nameof(DynamicProxy.TryInvoke), binder, GetArgArray(args), e => binder.FallbackInvoke(this, args, e)) - : base.BindInvoke(binder, args); - } - - public override DynamicMetaObject BindBinaryOperation(BinaryOperationBinder binder, DynamicMetaObject arg) - { - return IsOverridden(nameof(DynamicProxy.TryBinaryOperation)) - ? CallMethodWithResult(nameof(DynamicProxy.TryBinaryOperation), binder, GetArgs(arg), e => binder.FallbackBinaryOperation(this, arg, e)) - : base.BindBinaryOperation(binder, arg); - } - - public override DynamicMetaObject BindUnaryOperation(UnaryOperationBinder binder) - { - return IsOverridden(nameof(DynamicProxy.TryUnaryOperation)) - ? CallMethodWithResult(nameof(DynamicProxy.TryUnaryOperation), binder, NoArgs, e => binder.FallbackUnaryOperation(this, e)) - : base.BindUnaryOperation(binder); - } - - public override DynamicMetaObject BindGetIndex(GetIndexBinder binder, DynamicMetaObject[] indexes) - { - return IsOverridden(nameof(DynamicProxy.TryGetIndex)) - ? CallMethodWithResult(nameof(DynamicProxy.TryGetIndex), binder, GetArgArray(indexes), e => binder.FallbackGetIndex(this, indexes, e)) - : base.BindGetIndex(binder, indexes); - } - - public override DynamicMetaObject BindSetIndex(SetIndexBinder binder, DynamicMetaObject[] indexes, DynamicMetaObject value) - { - return IsOverridden(nameof(DynamicProxy.TrySetIndex)) - ? CallMethodReturnLast(nameof(DynamicProxy.TrySetIndex), binder, GetArgArray(indexes, value), e => binder.FallbackSetIndex(this, indexes, value, e)) - : base.BindSetIndex(binder, indexes, value); - } - - public override DynamicMetaObject BindDeleteIndex(DeleteIndexBinder binder, DynamicMetaObject[] indexes) - { - return IsOverridden(nameof(DynamicProxy.TryDeleteIndex)) - ? CallMethodNoResult(nameof(DynamicProxy.TryDeleteIndex), binder, GetArgArray(indexes), e => binder.FallbackDeleteIndex(this, indexes, e)) - : base.BindDeleteIndex(binder, indexes); - } - - private delegate DynamicMetaObject Fallback(DynamicMetaObject? errorSuggestion); - - private static Expression[] NoArgs => CollectionUtils.ArrayEmpty(); - - private static IEnumerable GetArgs(params DynamicMetaObject[] args) - { - return args.Select(arg => - { - Expression exp = arg.Expression; - return exp.Type.IsValueType() ? Expression.Convert(exp, typeof(object)) : exp; - }); - } - - private static Expression[] GetArgArray(DynamicMetaObject[] args) - { - return new[] { Expression.NewArrayInit(typeof(object), GetArgs(args)) }; - } - - private static Expression[] GetArgArray(DynamicMetaObject[] args, DynamicMetaObject value) - { - Expression exp = value.Expression; - return new[] - { - Expression.NewArrayInit(typeof(object), GetArgs(args)), - exp.Type.IsValueType() ? Expression.Convert(exp, typeof(object)) : exp - }; - } - - private static ConstantExpression Constant(DynamicMetaObjectBinder binder) - { - Type t = binder.GetType(); - while (!t.IsVisible()) - { - t = t.BaseType(); - } - return Expression.Constant(binder, t); - } - - /// - /// Helper method for generating a MetaObject which calls a - /// specific method on Dynamic that returns a result - /// - private DynamicMetaObject CallMethodWithResult(string methodName, DynamicMetaObjectBinder binder, IEnumerable args, Fallback fallback, Fallback? fallbackInvoke = null) - { - // - // First, call fallback to do default binding - // This produces either an error or a call to a .NET member - // - DynamicMetaObject fallbackResult = fallback(null); - - return BuildCallMethodWithResult(methodName, binder, args, fallbackResult, fallbackInvoke); - } - - private DynamicMetaObject BuildCallMethodWithResult(string methodName, DynamicMetaObjectBinder binder, IEnumerable args, DynamicMetaObject fallbackResult, Fallback? fallbackInvoke) - { - // - // Build a new expression like: - // { - // object result; - // TryGetMember(payload, out result) ? fallbackInvoke(result) : fallbackResult - // } - // - ParameterExpression result = Expression.Parameter(typeof(object), null); - - IList callArgs = new List(); - callArgs.Add(Expression.Convert(Expression, typeof(T))); - callArgs.Add(Constant(binder)); - callArgs.AddRange(args); - callArgs.Add(result); - - DynamicMetaObject resultMetaObject = new DynamicMetaObject(result, BindingRestrictions.Empty); - - // Need to add a conversion if calling TryConvert - if (binder.ReturnType != typeof(object)) - { - UnaryExpression convert = Expression.Convert(resultMetaObject.Expression, binder.ReturnType); - // will always be a cast or unbox - - resultMetaObject = new DynamicMetaObject(convert, resultMetaObject.Restrictions); - } - - if (fallbackInvoke != null) - { - resultMetaObject = fallbackInvoke(resultMetaObject); - } - - DynamicMetaObject callDynamic = new DynamicMetaObject( - Expression.Block( - new[] { result }, - Expression.Condition( - Expression.Call( - Expression.Constant(_proxy), - typeof(DynamicProxy).GetMethod(methodName), - callArgs - ), - resultMetaObject.Expression, - fallbackResult.Expression, - binder.ReturnType - ) - ), - GetRestrictions().Merge(resultMetaObject.Restrictions).Merge(fallbackResult.Restrictions) - ); - - return callDynamic; - } - - /// - /// Helper method for generating a MetaObject which calls a - /// specific method on Dynamic, but uses one of the arguments for - /// the result. - /// - private DynamicMetaObject CallMethodReturnLast(string methodName, DynamicMetaObjectBinder binder, IEnumerable args, Fallback fallback) - { - // - // First, call fallback to do default binding - // This produces either an error or a call to a .NET member - // - DynamicMetaObject fallbackResult = fallback(null); - - // - // Build a new expression like: - // { - // object result; - // TrySetMember(payload, result = value) ? result : fallbackResult - // } - // - ParameterExpression result = Expression.Parameter(typeof(object), null); - - IList callArgs = new List(); - callArgs.Add(Expression.Convert(Expression, typeof(T))); - callArgs.Add(Constant(binder)); - callArgs.AddRange(args); - callArgs[callArgs.Count - 1] = Expression.Assign(result, callArgs[callArgs.Count - 1]); - - return new DynamicMetaObject( - Expression.Block( - new[] { result }, - Expression.Condition( - Expression.Call( - Expression.Constant(_proxy), - typeof(DynamicProxy).GetMethod(methodName), - callArgs - ), - result, - fallbackResult.Expression, - typeof(object) - ) - ), - GetRestrictions().Merge(fallbackResult.Restrictions) - ); - } - - /// - /// Helper method for generating a MetaObject which calls a - /// specific method on Dynamic, but uses one of the arguments for - /// the result. - /// - private DynamicMetaObject CallMethodNoResult(string methodName, DynamicMetaObjectBinder binder, Expression[] args, Fallback fallback) - { - // - // First, call fallback to do default binding - // This produces either an error or a call to a .NET member - // - DynamicMetaObject fallbackResult = fallback(null); - - IList callArgs = new List(); - callArgs.Add(Expression.Convert(Expression, typeof(T))); - callArgs.Add(Constant(binder)); - callArgs.AddRange(args); - - // - // Build a new expression like: - // if (TryDeleteMember(payload)) { } else { fallbackResult } - // - return new DynamicMetaObject( - Expression.Condition( - Expression.Call( - Expression.Constant(_proxy), - typeof(DynamicProxy).GetMethod(methodName), - callArgs - ), - Expression.Empty(), - fallbackResult.Expression, - typeof(void) - ), - GetRestrictions().Merge(fallbackResult.Restrictions) - ); - } - - /// - /// Returns a Restrictions object which includes our current restrictions merged - /// with a restriction limiting our type - /// - private BindingRestrictions GetRestrictions() - { - return (Value == null && HasValue) - ? BindingRestrictions.GetInstanceRestriction(Expression, null) - : BindingRestrictions.GetTypeRestriction(Expression, LimitType); - } - - public override IEnumerable GetDynamicMemberNames() - { - return _proxy.GetDynamicMemberNames((T)Value); - } - - // It is okay to throw NotSupported from this binder. This object - // is only used by DynamicObject.GetMember--it is not expected to - // (and cannot) implement binding semantics. It is just so the DO - // can use the Name and IgnoreCase properties. - private sealed class GetBinderAdapter : GetMemberBinder - { - internal GetBinderAdapter(InvokeMemberBinder binder) : - base(binder.Name, binder.IgnoreCase) - { - } - - public override DynamicMetaObject FallbackGetMember(DynamicMetaObject target, DynamicMetaObject errorSuggestion) - { - throw new NotSupportedException(); - } - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/DynamicReflectionDelegateFactory.cs b/Source/MyDb/Newtonsoft.Json/Utilities/DynamicReflectionDelegateFactory.cs deleted file mode 100644 index e899c4c..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/DynamicReflectionDelegateFactory.cs +++ /dev/null @@ -1,404 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_REFLECTION_EMIT -using System; -using System.Collections.Generic; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#endif -using System.Reflection; -using System.Reflection.Emit; -using Newtonsoft.Json.Serialization; -using System.Globalization; - -namespace Newtonsoft.Json.Utilities -{ - internal class DynamicReflectionDelegateFactory : ReflectionDelegateFactory - { - internal static DynamicReflectionDelegateFactory Instance { get; } = new DynamicReflectionDelegateFactory(); - - private static DynamicMethod CreateDynamicMethod(string name, Type? returnType, Type[] parameterTypes, Type owner) - { - DynamicMethod dynamicMethod = !owner.IsInterface() - ? new DynamicMethod(name, returnType, parameterTypes, owner, true) - : new DynamicMethod(name, returnType, parameterTypes, owner.Module, true); - - return dynamicMethod; - } - - public override ObjectConstructor CreateParameterizedConstructor(MethodBase method) - { - DynamicMethod dynamicMethod = CreateDynamicMethod(method.ToString(), typeof(object), new[] { typeof(object[]) }, method.DeclaringType); - ILGenerator generator = dynamicMethod.GetILGenerator(); - - GenerateCreateMethodCallIL(method, generator, 0); - - return (ObjectConstructor)dynamicMethod.CreateDelegate(typeof(ObjectConstructor)); - } - - public override MethodCall CreateMethodCall(MethodBase method) - { - DynamicMethod dynamicMethod = CreateDynamicMethod(method.ToString(), typeof(object), new[] { typeof(object), typeof(object[]) }, method.DeclaringType); - ILGenerator generator = dynamicMethod.GetILGenerator(); - - GenerateCreateMethodCallIL(method, generator, 1); - - return (MethodCall)dynamicMethod.CreateDelegate(typeof(MethodCall)); - } - - private void GenerateCreateMethodCallIL(MethodBase method, ILGenerator generator, int argsIndex) - { - ParameterInfo[] args = method.GetParameters(); - - Label argsOk = generator.DefineLabel(); - - // throw an error if the number of argument values doesn't match method parameters - generator.Emit(OpCodes.Ldarg, argsIndex); - generator.Emit(OpCodes.Ldlen); - generator.Emit(OpCodes.Ldc_I4, args.Length); - generator.Emit(OpCodes.Beq, argsOk); - generator.Emit(OpCodes.Newobj, typeof(TargetParameterCountException).GetConstructor(ReflectionUtils.EmptyTypes)); - generator.Emit(OpCodes.Throw); - - generator.MarkLabel(argsOk); - - if (!method.IsConstructor && !method.IsStatic) - { - generator.PushInstance(method.DeclaringType); - } - - LocalBuilder localConvertible = generator.DeclareLocal(typeof(IConvertible)); - LocalBuilder localObject = generator.DeclareLocal(typeof(object)); - - OpCode variableAddressOpCode = args.Length < 256 ? OpCodes.Ldloca_S : OpCodes.Ldloca; - OpCode variableLoadOpCode = args.Length < 256 ? OpCodes.Ldloc_S : OpCodes.Ldloc; - - for (int i = 0; i < args.Length; i++) - { - ParameterInfo parameter = args[i]; - Type parameterType = parameter.ParameterType; - - if (parameterType.IsByRef) - { - parameterType = parameterType.GetElementType(); - - LocalBuilder localVariable = generator.DeclareLocal(parameterType); - - // don't need to set variable for 'out' parameter - if (!parameter.IsOut) - { - generator.PushArrayInstance(argsIndex, i); - - if (parameterType.IsValueType()) - { - Label skipSettingDefault = generator.DefineLabel(); - Label finishedProcessingParameter = generator.DefineLabel(); - - // check if parameter is not null - generator.Emit(OpCodes.Brtrue_S, skipSettingDefault); - - // parameter has no value, initialize to default - generator.Emit(variableAddressOpCode, localVariable); - generator.Emit(OpCodes.Initobj, parameterType); - generator.Emit(OpCodes.Br_S, finishedProcessingParameter); - - // parameter has value, get value from array again and unbox and set to variable - generator.MarkLabel(skipSettingDefault); - generator.PushArrayInstance(argsIndex, i); - generator.UnboxIfNeeded(parameterType); - generator.Emit(OpCodes.Stloc_S, localVariable); - - // parameter finished, we out! - generator.MarkLabel(finishedProcessingParameter); - } - else - { - generator.UnboxIfNeeded(parameterType); - generator.Emit(OpCodes.Stloc_S, localVariable); - } - } - - generator.Emit(variableAddressOpCode, localVariable); - } - else if (parameterType.IsValueType()) - { - generator.PushArrayInstance(argsIndex, i); - generator.Emit(OpCodes.Stloc_S, localObject); - - // have to check that value type parameters aren't null - // otherwise they will error when unboxed - Label skipSettingDefault = generator.DefineLabel(); - Label finishedProcessingParameter = generator.DefineLabel(); - - // check if parameter is not null - generator.Emit(OpCodes.Ldloc_S, localObject); - generator.Emit(OpCodes.Brtrue_S, skipSettingDefault); - - // parameter has no value, initialize to default - LocalBuilder localVariable = generator.DeclareLocal(parameterType); - generator.Emit(variableAddressOpCode, localVariable); - generator.Emit(OpCodes.Initobj, parameterType); - generator.Emit(variableLoadOpCode, localVariable); - generator.Emit(OpCodes.Br_S, finishedProcessingParameter); - - // argument has value, try to convert it to parameter type - generator.MarkLabel(skipSettingDefault); - - if (parameterType.IsPrimitive()) - { - // for primitive types we need to handle type widening (e.g. short -> int) - MethodInfo toParameterTypeMethod = typeof(IConvertible) - .GetMethod("To" + parameterType.Name, new[] { typeof(IFormatProvider) }); - - if (toParameterTypeMethod != null) - { - Label skipConvertible = generator.DefineLabel(); - - // check if argument type is an exact match for parameter type - // in this case we may use cheap unboxing instead - generator.Emit(OpCodes.Ldloc_S, localObject); - generator.Emit(OpCodes.Isinst, parameterType); - generator.Emit(OpCodes.Brtrue_S, skipConvertible); - - // types don't match, check if argument implements IConvertible - generator.Emit(OpCodes.Ldloc_S, localObject); - generator.Emit(OpCodes.Isinst, typeof(IConvertible)); - generator.Emit(OpCodes.Stloc_S, localConvertible); - generator.Emit(OpCodes.Ldloc_S, localConvertible); - generator.Emit(OpCodes.Brfalse_S, skipConvertible); - - // convert argument to parameter type - generator.Emit(OpCodes.Ldloc_S, localConvertible); - generator.Emit(OpCodes.Ldnull); - generator.Emit(OpCodes.Callvirt, toParameterTypeMethod); - generator.Emit(OpCodes.Br_S, finishedProcessingParameter); - - generator.MarkLabel(skipConvertible); - } - } - - // we got here because either argument type matches parameter (conversion will succeed), - // or argument type doesn't match parameter, but we're out of options (conversion will fail) - generator.Emit(OpCodes.Ldloc_S, localObject); - - generator.UnboxIfNeeded(parameterType); - - // parameter finished, we out! - generator.MarkLabel(finishedProcessingParameter); - } - else - { - generator.PushArrayInstance(argsIndex, i); - - generator.UnboxIfNeeded(parameterType); - } - } - - if (method.IsConstructor) - { - generator.Emit(OpCodes.Newobj, (ConstructorInfo)method); - } - else - { - generator.CallMethod((MethodInfo)method); - } - - Type returnType = method.IsConstructor - ? method.DeclaringType - : ((MethodInfo)method).ReturnType; - - if (returnType != typeof(void)) - { - generator.BoxIfNeeded(returnType); - } - else - { - generator.Emit(OpCodes.Ldnull); - } - - generator.Return(); - } - - public override Func CreateDefaultConstructor(Type type) - { - DynamicMethod dynamicMethod = CreateDynamicMethod("Create" + type.FullName, typeof(T), ReflectionUtils.EmptyTypes, type); - dynamicMethod.InitLocals = true; - ILGenerator generator = dynamicMethod.GetILGenerator(); - - GenerateCreateDefaultConstructorIL(type, generator, typeof(T)); - - return (Func)dynamicMethod.CreateDelegate(typeof(Func)); - } - - private void GenerateCreateDefaultConstructorIL(Type type, ILGenerator generator, Type delegateType) - { - if (type.IsValueType()) - { - generator.DeclareLocal(type); - generator.Emit(OpCodes.Ldloc_0); - - // only need to box if the delegate isn't returning the value type - if (type != delegateType) - { - generator.Emit(OpCodes.Box, type); - } - } - else - { - ConstructorInfo constructorInfo = - type.GetConstructor(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance, null, ReflectionUtils.EmptyTypes, null); - - if (constructorInfo == null) - { - throw new ArgumentException("Could not get constructor for {0}.".FormatWith(CultureInfo.InvariantCulture, type)); - } - - generator.Emit(OpCodes.Newobj, constructorInfo); - } - - generator.Return(); - } - - public override Func CreateGet(PropertyInfo propertyInfo) - { - DynamicMethod dynamicMethod = CreateDynamicMethod("Get" + propertyInfo.Name, typeof(object), new[] { typeof(T) }, propertyInfo.DeclaringType); - ILGenerator generator = dynamicMethod.GetILGenerator(); - - GenerateCreateGetPropertyIL(propertyInfo, generator); - - return (Func)dynamicMethod.CreateDelegate(typeof(Func)); - } - - private void GenerateCreateGetPropertyIL(PropertyInfo propertyInfo, ILGenerator generator) - { - MethodInfo getMethod = propertyInfo.GetGetMethod(true); - if (getMethod == null) - { - throw new ArgumentException("Property '{0}' does not have a getter.".FormatWith(CultureInfo.InvariantCulture, propertyInfo.Name)); - } - - if (!getMethod.IsStatic) - { - generator.PushInstance(propertyInfo.DeclaringType); - } - - generator.CallMethod(getMethod); - generator.BoxIfNeeded(propertyInfo.PropertyType); - generator.Return(); - } - - public override Func CreateGet(FieldInfo fieldInfo) - { - if (fieldInfo.IsLiteral) - { - object constantValue = fieldInfo.GetValue(null); - Func getter = o => constantValue; - return getter; - } - - DynamicMethod dynamicMethod = CreateDynamicMethod("Get" + fieldInfo.Name, typeof(T), new[] { typeof(object) }, fieldInfo.DeclaringType); - ILGenerator generator = dynamicMethod.GetILGenerator(); - - GenerateCreateGetFieldIL(fieldInfo, generator); - - return (Func)dynamicMethod.CreateDelegate(typeof(Func)); - } - - private void GenerateCreateGetFieldIL(FieldInfo fieldInfo, ILGenerator generator) - { - if (!fieldInfo.IsStatic) - { - generator.PushInstance(fieldInfo.DeclaringType); - generator.Emit(OpCodes.Ldfld, fieldInfo); - } - else - { - generator.Emit(OpCodes.Ldsfld, fieldInfo); - } - - generator.BoxIfNeeded(fieldInfo.FieldType); - generator.Return(); - } - - public override Action CreateSet(FieldInfo fieldInfo) - { - DynamicMethod dynamicMethod = CreateDynamicMethod("Set" + fieldInfo.Name, null, new[] { typeof(T), typeof(object) }, fieldInfo.DeclaringType); - ILGenerator generator = dynamicMethod.GetILGenerator(); - - GenerateCreateSetFieldIL(fieldInfo, generator); - - return (Action)dynamicMethod.CreateDelegate(typeof(Action)); - } - - internal static void GenerateCreateSetFieldIL(FieldInfo fieldInfo, ILGenerator generator) - { - if (!fieldInfo.IsStatic) - { - generator.PushInstance(fieldInfo.DeclaringType); - } - - generator.Emit(OpCodes.Ldarg_1); - generator.UnboxIfNeeded(fieldInfo.FieldType); - - if (!fieldInfo.IsStatic) - { - generator.Emit(OpCodes.Stfld, fieldInfo); - } - else - { - generator.Emit(OpCodes.Stsfld, fieldInfo); - } - - generator.Return(); - } - - public override Action CreateSet(PropertyInfo propertyInfo) - { - DynamicMethod dynamicMethod = CreateDynamicMethod("Set" + propertyInfo.Name, null, new[] { typeof(T), typeof(object) }, propertyInfo.DeclaringType); - ILGenerator generator = dynamicMethod.GetILGenerator(); - - GenerateCreateSetPropertyIL(propertyInfo, generator); - - return (Action)dynamicMethod.CreateDelegate(typeof(Action)); - } - - internal static void GenerateCreateSetPropertyIL(PropertyInfo propertyInfo, ILGenerator generator) - { - MethodInfo setMethod = propertyInfo.GetSetMethod(true); - if (!setMethod.IsStatic) - { - generator.PushInstance(propertyInfo.DeclaringType); - } - - generator.Emit(OpCodes.Ldarg_1); - generator.UnboxIfNeeded(propertyInfo.PropertyType); - generator.CallMethod(setMethod); - generator.Return(); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/DynamicUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/DynamicUtils.cs deleted file mode 100644 index acb3e3a..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/DynamicUtils.cs +++ /dev/null @@ -1,215 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_DYNAMIC -using System; -using System.Collections.Generic; -using System.Dynamic; -using System.Linq; -using System.Linq.Expressions; -#if !HAVE_REFLECTION_BINDER -using System.Reflection; -#else -using Microsoft.CSharp.RuntimeBinder; -#endif -using System.Runtime.CompilerServices; -using System.Text; -using System.Globalization; -using Newtonsoft.Json.Serialization; -using System.Diagnostics; - -namespace Newtonsoft.Json.Utilities -{ - internal static class DynamicUtils - { - internal static class BinderWrapper - { -#if !HAVE_REFLECTION_BINDER - public const string CSharpAssemblyName = "Microsoft.CSharp, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"; - - private const string BinderTypeName = "Microsoft.CSharp.RuntimeBinder.Binder, " + CSharpAssemblyName; - private const string CSharpArgumentInfoTypeName = "Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo, " + CSharpAssemblyName; - private const string CSharpArgumentInfoFlagsTypeName = "Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfoFlags, " + CSharpAssemblyName; - private const string CSharpBinderFlagsTypeName = "Microsoft.CSharp.RuntimeBinder.CSharpBinderFlags, " + CSharpAssemblyName; - - private static object? _getCSharpArgumentInfoArray; - private static object? _setCSharpArgumentInfoArray; - private static MethodCall? _getMemberCall; - private static MethodCall? _setMemberCall; - private static bool _init; - - private static void Init() - { - if (!_init) - { - Type binderType = Type.GetType(BinderTypeName, false); - if (binderType == null) - { - throw new InvalidOperationException("Could not resolve type '{0}'. You may need to add a reference to Microsoft.CSharp.dll to work with dynamic types.".FormatWith(CultureInfo.InvariantCulture, BinderTypeName)); - } - - // None - _getCSharpArgumentInfoArray = CreateSharpArgumentInfoArray(0); - // None, Constant | UseCompileTimeType - _setCSharpArgumentInfoArray = CreateSharpArgumentInfoArray(0, 3); - CreateMemberCalls(); - - _init = true; - } - } - - private static object CreateSharpArgumentInfoArray(params int[] values) - { - Type csharpArgumentInfoType = Type.GetType(CSharpArgumentInfoTypeName); - Type csharpArgumentInfoFlags = Type.GetType(CSharpArgumentInfoFlagsTypeName); - - Array a = Array.CreateInstance(csharpArgumentInfoType, values.Length); - - for (int i = 0; i < values.Length; i++) - { - MethodInfo createArgumentInfoMethod = csharpArgumentInfoType.GetMethod("Create", new[] { csharpArgumentInfoFlags, typeof(string) }); - object arg = createArgumentInfoMethod.Invoke(null, new object?[] { 0, null }); - a.SetValue(arg, i); - } - - return a; - } - - private static void CreateMemberCalls() - { - Type csharpArgumentInfoType = Type.GetType(CSharpArgumentInfoTypeName, true); - Type csharpBinderFlagsType = Type.GetType(CSharpBinderFlagsTypeName, true); - Type binderType = Type.GetType(BinderTypeName, true); - - Type csharpArgumentInfoTypeEnumerableType = typeof(IEnumerable<>).MakeGenericType(csharpArgumentInfoType); - - MethodInfo getMemberMethod = binderType.GetMethod("GetMember", new[] { csharpBinderFlagsType, typeof(string), typeof(Type), csharpArgumentInfoTypeEnumerableType }); - _getMemberCall = JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(getMemberMethod); - - MethodInfo setMemberMethod = binderType.GetMethod("SetMember", new[] { csharpBinderFlagsType, typeof(string), typeof(Type), csharpArgumentInfoTypeEnumerableType }); - _setMemberCall = JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(setMemberMethod); - } -#endif - - public static CallSiteBinder GetMember(string name, Type context) - { -#if !HAVE_REFLECTION_BINDER - Init(); - MiscellaneousUtils.Assert(_getMemberCall != null); - MiscellaneousUtils.Assert(_getCSharpArgumentInfoArray != null); - return (CallSiteBinder)_getMemberCall(null, 0, name, context, _getCSharpArgumentInfoArray)!; -#else - return Binder.GetMember( - CSharpBinderFlags.None, name, context, new[] {CSharpArgumentInfo.Create(CSharpArgumentInfoFlags.None, null)}); -#endif - } - - public static CallSiteBinder SetMember(string name, Type context) - { -#if !HAVE_REFLECTION_BINDER - Init(); - MiscellaneousUtils.Assert(_setMemberCall != null); - MiscellaneousUtils.Assert(_setCSharpArgumentInfoArray != null); - return (CallSiteBinder)_setMemberCall(null, 0, name, context, _setCSharpArgumentInfoArray)!; -#else - return Binder.SetMember( - CSharpBinderFlags.None, name, context, new[] - { - CSharpArgumentInfo.Create(CSharpArgumentInfoFlags.UseCompileTimeType, null), - CSharpArgumentInfo.Create(CSharpArgumentInfoFlags.Constant, null) - }); -#endif - } - } - - public static IEnumerable GetDynamicMemberNames(this IDynamicMetaObjectProvider dynamicProvider) - { - DynamicMetaObject metaObject = dynamicProvider.GetMetaObject(Expression.Constant(dynamicProvider)); - return metaObject.GetDynamicMemberNames(); - } - } - - internal class NoThrowGetBinderMember : GetMemberBinder - { - private readonly GetMemberBinder _innerBinder; - - public NoThrowGetBinderMember(GetMemberBinder innerBinder) - : base(innerBinder.Name, innerBinder.IgnoreCase) - { - _innerBinder = innerBinder; - } - - public override DynamicMetaObject FallbackGetMember(DynamicMetaObject target, DynamicMetaObject errorSuggestion) - { - DynamicMetaObject retMetaObject = _innerBinder.Bind(target, CollectionUtils.ArrayEmpty()); - - NoThrowExpressionVisitor noThrowVisitor = new NoThrowExpressionVisitor(); - Expression resultExpression = noThrowVisitor.Visit(retMetaObject.Expression); - - DynamicMetaObject finalMetaObject = new DynamicMetaObject(resultExpression, retMetaObject.Restrictions); - return finalMetaObject; - } - } - - internal class NoThrowSetBinderMember : SetMemberBinder - { - private readonly SetMemberBinder _innerBinder; - - public NoThrowSetBinderMember(SetMemberBinder innerBinder) - : base(innerBinder.Name, innerBinder.IgnoreCase) - { - _innerBinder = innerBinder; - } - - public override DynamicMetaObject FallbackSetMember(DynamicMetaObject target, DynamicMetaObject value, DynamicMetaObject errorSuggestion) - { - DynamicMetaObject retMetaObject = _innerBinder.Bind(target, new DynamicMetaObject[] { value }); - - NoThrowExpressionVisitor noThrowVisitor = new NoThrowExpressionVisitor(); - Expression resultExpression = noThrowVisitor.Visit(retMetaObject.Expression); - - DynamicMetaObject finalMetaObject = new DynamicMetaObject(resultExpression, retMetaObject.Restrictions); - return finalMetaObject; - } - } - - internal class NoThrowExpressionVisitor : ExpressionVisitor - { - internal static readonly object ErrorResult = new object(); - - protected override Expression VisitConditional(ConditionalExpression node) - { - // if the result of a test is to throw an error, rewrite to result an error result value - if (node.IfFalse.NodeType == ExpressionType.Throw) - { - return Expression.Condition(node.Test, node.IfTrue, Expression.Constant(ErrorResult)); - } - - return base.VisitConditional(node); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/EnumInfo.cs b/Source/MyDb/Newtonsoft.Json/Utilities/EnumInfo.cs deleted file mode 100644 index 59eebea..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/EnumInfo.cs +++ /dev/null @@ -1,43 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Utilities -{ - internal class EnumInfo - { - public EnumInfo(bool isFlags, ulong[] values, string[] names, string[] resolvedNames) - { - IsFlags = isFlags; - Values = values; - Names = names; - ResolvedNames = resolvedNames; - } - - public readonly bool IsFlags; - public readonly ulong[] Values; - public readonly string[] Names; - public readonly string[] ResolvedNames; - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/EnumUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/EnumUtils.cs deleted file mode 100644 index ea6d453..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/EnumUtils.cs +++ /dev/null @@ -1,407 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Diagnostics; -using System.Globalization; -using System.Runtime.Serialization; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using System.Reflection; -using System.Text; -using Newtonsoft.Json.Serialization; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; - -namespace Newtonsoft.Json.Utilities -{ - internal static class EnumUtils - { - private const char EnumSeparatorChar = ','; - private const string EnumSeparatorString = ", "; - - private static readonly ThreadSafeStore, EnumInfo> ValuesAndNamesPerEnum = new ThreadSafeStore, EnumInfo>(InitializeValuesAndNames); - - private static EnumInfo InitializeValuesAndNames(StructMultiKey key) - { - Type enumType = key.Value1; - string[] names = Enum.GetNames(enumType); - string[] resolvedNames = new string[names.Length]; - ulong[] values = new ulong[names.Length]; - bool hasSpecifiedName; - - for (int i = 0; i < names.Length; i++) - { - string name = names[i]; - FieldInfo f = enumType.GetField(name, BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Static)!; - values[i] = ToUInt64(f.GetValue(null)); - - string resolvedName; -#if HAVE_DATA_CONTRACTS - string specifiedName = f.GetCustomAttributes(typeof(EnumMemberAttribute), true) - .Cast() - .Select(a => a.Value) - .SingleOrDefault(); - hasSpecifiedName = specifiedName != null; - resolvedName = specifiedName ?? name; - - if (Array.IndexOf(resolvedNames, resolvedName, 0, i) != -1) - { - throw new InvalidOperationException("Enum name '{0}' already exists on enum '{1}'.".FormatWith(CultureInfo.InvariantCulture, resolvedName, enumType.Name)); - } -#else - resolvedName = name; - hasSpecifiedName = false; -#endif - - resolvedNames[i] = key.Value2 != null - ? key.Value2.GetPropertyName(resolvedName, hasSpecifiedName) - : resolvedName; - } - - bool isFlags = enumType.IsDefined(typeof(FlagsAttribute), false); - - return new EnumInfo(isFlags, values, names, resolvedNames); - } - - public static IList GetFlagsValues(T value) where T : struct - { - Type enumType = typeof(T); - - if (!enumType.IsDefined(typeof(FlagsAttribute), false)) - { - throw new ArgumentException("Enum type {0} is not a set of flags.".FormatWith(CultureInfo.InvariantCulture, enumType)); - } - - Type underlyingType = Enum.GetUnderlyingType(value.GetType()); - - ulong num = ToUInt64(value); - EnumInfo enumNameValues = GetEnumValuesAndNames(enumType); - IList selectedFlagsValues = new List(); - - for (int i = 0; i < enumNameValues.Values.Length; i++) - { - ulong v = enumNameValues.Values[i]; - - if ((num & v) == v && v != 0) - { - selectedFlagsValues.Add((T)Convert.ChangeType(v, underlyingType, CultureInfo.CurrentCulture)); - } - } - - if (selectedFlagsValues.Count == 0 && enumNameValues.Values.Any(v => v == 0)) - { - selectedFlagsValues.Add(default); - } - - return selectedFlagsValues; - } - - // Used by Newtonsoft.Json.Schema - private static CamelCaseNamingStrategy _camelCaseNamingStrategy = new CamelCaseNamingStrategy(); - public static bool TryToString(Type enumType, object value, bool camelCase, [NotNullWhen(true)]out string? name) - { - return TryToString(enumType, value, camelCase ? _camelCaseNamingStrategy : null, out name); - } - - public static bool TryToString(Type enumType, object value, NamingStrategy? namingStrategy, [NotNullWhen(true)]out string? name) - { - EnumInfo enumInfo = ValuesAndNamesPerEnum.Get(new StructMultiKey(enumType, namingStrategy)); - ulong v = ToUInt64(value); - - if (!enumInfo.IsFlags) - { - int index = Array.BinarySearch(enumInfo.Values, v); - if (index >= 0) - { - name = enumInfo.ResolvedNames[index]; - return true; - } - - // is number value - name = null; - return false; - } - else // These are flags OR'ed together (We treat everything as unsigned types) - { - name = InternalFlagsFormat(enumInfo, v); - return name != null; - } - } - - private static string? InternalFlagsFormat(EnumInfo entry, ulong result) - { - string[] resolvedNames = entry.ResolvedNames; - ulong[] values = entry.Values; - - int index = values.Length - 1; - StringBuilder sb = new StringBuilder(); - bool firstTime = true; - ulong saveResult = result; - - // We will not optimize this code further to keep it maintainable. There are some boundary checks that can be applied - // to minimize the comparsions required. This code works the same for the best/worst case. In general the number of - // items in an enum are sufficiently small and not worth the optimization. - while (index >= 0) - { - if (index == 0 && values[index] == 0) - { - break; - } - - if ((result & values[index]) == values[index]) - { - result -= values[index]; - if (!firstTime) - { - sb.Insert(0, EnumSeparatorString); - } - - string resolvedName = resolvedNames[index]; - sb.Insert(0, resolvedName); - firstTime = false; - } - - index--; - } - - string? returnString; - if (result != 0) - { - // We were unable to represent this number as a bitwise or of valid flags - returnString = null; // return null so the caller knows to .ToString() the input - } - else if (saveResult == 0) - { - // For the cases when we have zero - if (values.Length > 0 && values[0] == 0) - { - returnString = resolvedNames[0]; // Zero was one of the enum values. - } - else - { - returnString = null; - } - } - else - { - returnString = sb.ToString(); // Return the string representation - } - - return returnString; - } - - public static EnumInfo GetEnumValuesAndNames(Type enumType) - { - return ValuesAndNamesPerEnum.Get(new StructMultiKey(enumType, null)); - } - - private static ulong ToUInt64(object value) - { - PrimitiveTypeCode typeCode = ConvertUtils.GetTypeCode(value.GetType(), out bool _); - - switch (typeCode) - { - case PrimitiveTypeCode.SByte: - return (ulong)(sbyte)value; - case PrimitiveTypeCode.Byte: - return (byte)value; - case PrimitiveTypeCode.Boolean: - // direct cast from bool to byte is not allowed - return Convert.ToByte((bool)value); - case PrimitiveTypeCode.Int16: - return (ulong)(short)value; - case PrimitiveTypeCode.UInt16: - return (ushort)value; - case PrimitiveTypeCode.Char: - return (char)value; - case PrimitiveTypeCode.UInt32: - return (uint)value; - case PrimitiveTypeCode.Int32: - return (ulong)(int)value; - case PrimitiveTypeCode.UInt64: - return (ulong)value; - case PrimitiveTypeCode.Int64: - return (ulong)(long)value; - // All unsigned types will be directly cast - default: - throw new InvalidOperationException("Unknown enum type."); - } - } - - public static object ParseEnum(Type enumType, NamingStrategy? namingStrategy, string value, bool disallowNumber) - { - ValidationUtils.ArgumentNotNull(enumType, nameof(enumType)); - ValidationUtils.ArgumentNotNull(value, nameof(value)); - - if (!enumType.IsEnum()) - { - throw new ArgumentException("Type provided must be an Enum.", nameof(enumType)); - } - - EnumInfo entry = ValuesAndNamesPerEnum.Get(new StructMultiKey(enumType, namingStrategy)); - string[] enumNames = entry.Names; - string[] resolvedNames = entry.ResolvedNames; - ulong[] enumValues = entry.Values; - - // first check if the entire text (including commas) matches a resolved name - int? matchingIndex = FindIndexByName(resolvedNames, value, 0, value.Length, StringComparison.Ordinal); - if (matchingIndex != null) - { - return Enum.ToObject(enumType, enumValues[matchingIndex.Value]); - } - - int firstNonWhitespaceIndex = -1; - for (int i = 0; i < value.Length; i++) - { - if (!char.IsWhiteSpace(value[i])) - { - firstNonWhitespaceIndex = i; - break; - } - } - if (firstNonWhitespaceIndex == -1) - { - throw new ArgumentException("Must specify valid information for parsing in the string."); - } - - // check whether string is a number and parse as a number value - char firstNonWhitespaceChar = value[firstNonWhitespaceIndex]; - if (char.IsDigit(firstNonWhitespaceChar) || firstNonWhitespaceChar == '-' || firstNonWhitespaceChar == '+') - { - Type underlyingType = Enum.GetUnderlyingType(enumType); - - value = value.Trim(); - object? temp = null; - - try - { - temp = Convert.ChangeType(value, underlyingType, CultureInfo.InvariantCulture); - } - catch (FormatException) - { - // We need to Parse this as a String instead. There are cases - // when you tlbimp enums that can have values of the form "3D". - // Don't fix this code. - } - - if (temp != null) - { - if (disallowNumber) - { - throw new FormatException("Integer string '{0}' is not allowed.".FormatWith(CultureInfo.InvariantCulture, value)); - } - - return Enum.ToObject(enumType, temp); - } - } - - ulong result = 0; - - int valueIndex = firstNonWhitespaceIndex; - while (valueIndex <= value.Length) // '=' is to handle invalid case of an ending comma - { - // Find the next separator, if there is one, otherwise the end of the string. - int endIndex = value.IndexOf(EnumSeparatorChar, valueIndex); - if (endIndex == -1) - { - endIndex = value.Length; - } - - // Shift the starting and ending indices to eliminate whitespace - int endIndexNoWhitespace = endIndex; - while (valueIndex < endIndex && char.IsWhiteSpace(value[valueIndex])) - { - valueIndex++; - } - - while (endIndexNoWhitespace > valueIndex && char.IsWhiteSpace(value[endIndexNoWhitespace - 1])) - { - endIndexNoWhitespace--; - } - int valueSubstringLength = endIndexNoWhitespace - valueIndex; - - // match with case sensitivity - matchingIndex = MatchName(value, enumNames, resolvedNames, valueIndex, valueSubstringLength, StringComparison.Ordinal); - - // if no match found, attempt case insensitive search - if (matchingIndex == null) - { - matchingIndex = MatchName(value, enumNames, resolvedNames, valueIndex, valueSubstringLength, StringComparison.OrdinalIgnoreCase); - } - - if (matchingIndex == null) - { - // still can't find a match - // before we throw an error, check whether the entire string has a case insensitive match against resolve names - matchingIndex = FindIndexByName(resolvedNames, value, 0, value.Length, StringComparison.OrdinalIgnoreCase); - if (matchingIndex != null) - { - return Enum.ToObject(enumType, enumValues[matchingIndex.Value]); - } - - // no match so error - throw new ArgumentException("Requested value '{0}' was not found.".FormatWith(CultureInfo.InvariantCulture, value)); - } - - result |= enumValues[matchingIndex.Value]; - - // Move our pointer to the ending index to go again. - valueIndex = endIndex + 1; - } - - return Enum.ToObject(enumType, result); - } - - private static int? MatchName(string value, string[] enumNames, string[] resolvedNames, int valueIndex, int valueSubstringLength, StringComparison comparison) - { - int? matchingIndex = FindIndexByName(resolvedNames, value, valueIndex, valueSubstringLength, comparison); - if (matchingIndex == null) - { - matchingIndex = FindIndexByName(enumNames, value, valueIndex, valueSubstringLength, comparison); - } - - return matchingIndex; - } - - private static int? FindIndexByName(string[] enumNames, string value, int valueIndex, int valueSubstringLength, StringComparison comparison) - { - for (int i = 0; i < enumNames.Length; i++) - { - if (enumNames[i].Length == valueSubstringLength && - string.Compare(enumNames[i], 0, value, valueIndex, valueSubstringLength, comparison) == 0) - { - return i; - } - } - - return null; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/ExpressionReflectionDelegateFactory.cs b/Source/MyDb/Newtonsoft.Json/Utilities/ExpressionReflectionDelegateFactory.cs deleted file mode 100644 index 53a97ec..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/ExpressionReflectionDelegateFactory.cs +++ /dev/null @@ -1,398 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if !(NET20 || NET35) - -using System.Collections.Generic; -using System.Linq; -using System.Text; -using System; -using System.Linq.Expressions; -using System.Reflection; -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Utilities -{ - internal class ExpressionReflectionDelegateFactory : ReflectionDelegateFactory - { - private static readonly ExpressionReflectionDelegateFactory _instance = new ExpressionReflectionDelegateFactory(); - - internal static ReflectionDelegateFactory Instance => _instance; - - public override ObjectConstructor CreateParameterizedConstructor(MethodBase method) - { - ValidationUtils.ArgumentNotNull(method, nameof(method)); - - Type type = typeof(object); - - ParameterExpression argsParameterExpression = Expression.Parameter(typeof(object[]), "args"); - - Expression callExpression = BuildMethodCall(method, type, null, argsParameterExpression); - - LambdaExpression lambdaExpression = Expression.Lambda(typeof(ObjectConstructor), callExpression, argsParameterExpression); - - ObjectConstructor compiled = (ObjectConstructor)lambdaExpression.Compile(); - return compiled; - } - - public override MethodCall CreateMethodCall(MethodBase method) - { - ValidationUtils.ArgumentNotNull(method, nameof(method)); - - Type type = typeof(object); - - ParameterExpression targetParameterExpression = Expression.Parameter(type, "target"); - ParameterExpression argsParameterExpression = Expression.Parameter(typeof(object[]), "args"); - - Expression callExpression = BuildMethodCall(method, type, targetParameterExpression, argsParameterExpression); - - LambdaExpression lambdaExpression = Expression.Lambda(typeof(MethodCall), callExpression, targetParameterExpression, argsParameterExpression); - - MethodCall compiled = (MethodCall)lambdaExpression.Compile(); - return compiled; - } - - private class ByRefParameter - { - public Expression Value; - public ParameterExpression Variable; - public bool IsOut; - - public ByRefParameter(Expression value, ParameterExpression variable, bool isOut) - { - Value = value; - Variable = variable; - IsOut = isOut; - } - } - - private Expression BuildMethodCall(MethodBase method, Type type, ParameterExpression? targetParameterExpression, ParameterExpression argsParameterExpression) - { - ParameterInfo[] parametersInfo = method.GetParameters(); - - Expression[] argsExpression; - IList refParameterMap; - if (parametersInfo.Length == 0) - { - argsExpression = CollectionUtils.ArrayEmpty(); - refParameterMap = CollectionUtils.ArrayEmpty(); - } - else - { - argsExpression = new Expression[parametersInfo.Length]; - refParameterMap = new List(); - - for (int i = 0; i < parametersInfo.Length; i++) - { - ParameterInfo parameter = parametersInfo[i]; - Type parameterType = parameter.ParameterType; - bool isByRef = false; - if (parameterType.IsByRef) - { - parameterType = parameterType.GetElementType(); - isByRef = true; - } - - Expression indexExpression = Expression.Constant(i); - - Expression paramAccessorExpression = Expression.ArrayIndex(argsParameterExpression, indexExpression); - - Expression argExpression = EnsureCastExpression(paramAccessorExpression, parameterType, !isByRef); - - if (isByRef) - { - ParameterExpression variable = Expression.Variable(parameterType); - refParameterMap.Add(new ByRefParameter(argExpression, variable, parameter.IsOut)); - - argExpression = variable; - } - - argsExpression[i] = argExpression; - } - } - - Expression callExpression; - if (method.IsConstructor) - { - callExpression = Expression.New((ConstructorInfo)method, argsExpression); - } - else if (method.IsStatic) - { - callExpression = Expression.Call((MethodInfo)method, argsExpression); - } - else - { - Expression readParameter = EnsureCastExpression(targetParameterExpression!, method.DeclaringType); - - callExpression = Expression.Call(readParameter, (MethodInfo)method, argsExpression); - } - - if (method is MethodInfo m) - { - if (m.ReturnType != typeof(void)) - { - callExpression = EnsureCastExpression(callExpression, type); - } - else - { - callExpression = Expression.Block(callExpression, Expression.Constant(null)); - } - } - else - { - callExpression = EnsureCastExpression(callExpression, type); - } - - if (refParameterMap.Count > 0) - { - IList variableExpressions = new List(); - IList bodyExpressions = new List(); - foreach (ByRefParameter p in refParameterMap) - { - if (!p.IsOut) - { - bodyExpressions.Add(Expression.Assign(p.Variable, p.Value)); - } - - variableExpressions.Add(p.Variable); - } - - bodyExpressions.Add(callExpression); - - callExpression = Expression.Block(variableExpressions, bodyExpressions); - } - - return callExpression; - } - - public override Func CreateDefaultConstructor(Type type) - { - ValidationUtils.ArgumentNotNull(type, "type"); - - // avoid error from expressions compiler because of abstract class - if (type.IsAbstract()) - { - return () => (T)Activator.CreateInstance(type); - } - - try - { - Type resultType = typeof(T); - - Expression expression = Expression.New(type); - - expression = EnsureCastExpression(expression, resultType); - - LambdaExpression lambdaExpression = Expression.Lambda(typeof(Func), expression); - - Func compiled = (Func)lambdaExpression.Compile(); - return compiled; - } - catch - { - // an error can be thrown if constructor is not valid on Win8 - // will have INVOCATION_FLAGS_NON_W8P_FX_API invocation flag - return () => (T)Activator.CreateInstance(type); - } - } - - public override Func CreateGet(PropertyInfo propertyInfo) - { - ValidationUtils.ArgumentNotNull(propertyInfo, nameof(propertyInfo)); - - Type instanceType = typeof(T); - Type resultType = typeof(object); - - ParameterExpression parameterExpression = Expression.Parameter(instanceType, "instance"); - Expression resultExpression; - - MethodInfo? getMethod = propertyInfo.GetGetMethod(true); - if (getMethod == null) - { - throw new ArgumentException("Property does not have a getter."); - } - - if (getMethod.IsStatic) - { - resultExpression = Expression.MakeMemberAccess(null, propertyInfo); - } - else - { - Expression readParameter = EnsureCastExpression(parameterExpression, propertyInfo.DeclaringType); - - resultExpression = Expression.MakeMemberAccess(readParameter, propertyInfo); - } - - resultExpression = EnsureCastExpression(resultExpression, resultType); - - LambdaExpression lambdaExpression = Expression.Lambda(typeof(Func), resultExpression, parameterExpression); - - Func compiled = (Func)lambdaExpression.Compile(); - return compiled; - } - - public override Func CreateGet(FieldInfo fieldInfo) - { - ValidationUtils.ArgumentNotNull(fieldInfo, nameof(fieldInfo)); - - ParameterExpression sourceParameter = Expression.Parameter(typeof(T), "source"); - - Expression fieldExpression; - if (fieldInfo.IsStatic) - { - fieldExpression = Expression.Field(null, fieldInfo); - } - else - { - Expression sourceExpression = EnsureCastExpression(sourceParameter, fieldInfo.DeclaringType); - - fieldExpression = Expression.Field(sourceExpression, fieldInfo); - } - - fieldExpression = EnsureCastExpression(fieldExpression, typeof(object)); - - Func compiled = Expression.Lambda>(fieldExpression, sourceParameter).Compile(); - return compiled; - } - - public override Action CreateSet(FieldInfo fieldInfo) - { - ValidationUtils.ArgumentNotNull(fieldInfo, nameof(fieldInfo)); - - // use reflection for structs - // expression doesn't correctly set value - if (fieldInfo.DeclaringType.IsValueType() || fieldInfo.IsInitOnly) - { - return LateBoundReflectionDelegateFactory.Instance.CreateSet(fieldInfo); - } - - ParameterExpression sourceParameterExpression = Expression.Parameter(typeof(T), "source"); - ParameterExpression valueParameterExpression = Expression.Parameter(typeof(object), "value"); - - Expression fieldExpression; - if (fieldInfo.IsStatic) - { - fieldExpression = Expression.Field(null, fieldInfo); - } - else - { - Expression sourceExpression = EnsureCastExpression(sourceParameterExpression, fieldInfo.DeclaringType); - - fieldExpression = Expression.Field(sourceExpression, fieldInfo); - } - - Expression valueExpression = EnsureCastExpression(valueParameterExpression, fieldExpression.Type); - - BinaryExpression assignExpression = Expression.Assign(fieldExpression, valueExpression); - - LambdaExpression lambdaExpression = Expression.Lambda(typeof(Action), assignExpression, sourceParameterExpression, valueParameterExpression); - - Action compiled = (Action)lambdaExpression.Compile(); - return compiled; - } - - public override Action CreateSet(PropertyInfo propertyInfo) - { - ValidationUtils.ArgumentNotNull(propertyInfo, nameof(propertyInfo)); - - // use reflection for structs - // expression doesn't correctly set value - if (propertyInfo.DeclaringType.IsValueType()) - { - return LateBoundReflectionDelegateFactory.Instance.CreateSet(propertyInfo); - } - - Type instanceType = typeof(T); - Type valueType = typeof(object); - - ParameterExpression instanceParameter = Expression.Parameter(instanceType, "instance"); - - ParameterExpression valueParameter = Expression.Parameter(valueType, "value"); - Expression readValueParameter = EnsureCastExpression(valueParameter, propertyInfo.PropertyType); - - MethodInfo? setMethod = propertyInfo.GetSetMethod(true); - if (setMethod == null) - { - throw new ArgumentException("Property does not have a setter."); - } - - Expression setExpression; - if (setMethod.IsStatic) - { - setExpression = Expression.Call(setMethod, readValueParameter); - } - else - { - Expression readInstanceParameter = EnsureCastExpression(instanceParameter, propertyInfo.DeclaringType); - - setExpression = Expression.Call(readInstanceParameter, setMethod, readValueParameter); - } - - LambdaExpression lambdaExpression = Expression.Lambda(typeof(Action), setExpression, instanceParameter, valueParameter); - - Action compiled = (Action)lambdaExpression.Compile(); - return compiled; - } - - private Expression EnsureCastExpression(Expression expression, Type targetType, bool allowWidening = false) - { - Type expressionType = expression.Type; - - // check if a cast or conversion is required - if (expressionType == targetType || (!expressionType.IsValueType() && targetType.IsAssignableFrom(expressionType))) - { - return expression; - } - - if (targetType.IsValueType()) - { - Expression convert = Expression.Unbox(expression, targetType); - - if (allowWidening && targetType.IsPrimitive()) - { - MethodInfo toTargetTypeMethod = typeof(Convert) - .GetMethod("To" + targetType.Name, new[] { typeof(object) }); - - if (toTargetTypeMethod != null) - { - convert = Expression.Condition( - Expression.TypeIs(expression, targetType), - convert, - Expression.Call(toTargetTypeMethod, expression)); - } - } - - return Expression.Condition( - Expression.Equal(expression, Expression.Constant(null, typeof(object))), - Expression.Default(targetType), - convert); - } - - return Expression.Convert(expression, targetType); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/FSharpUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/FSharpUtils.cs deleted file mode 100644 index cb81666..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/FSharpUtils.cs +++ /dev/null @@ -1,205 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_FSHARP_TYPES -using System.Threading; -using System; -using System.Collections.Generic; -using System.Linq; -using System.Reflection; -using System.Text; -using Newtonsoft.Json.Serialization; -using System.Diagnostics; - -namespace Newtonsoft.Json.Utilities -{ - internal class FSharpFunction - { - private readonly object? _instance; - private readonly MethodCall _invoker; - - public FSharpFunction(object? instance, MethodCall invoker) - { - _instance = instance; - _invoker = invoker; - } - - public object Invoke(params object[] args) - { - object o = _invoker(_instance, args); - - return o; - } - } - - internal class FSharpUtils - { - private FSharpUtils(Assembly fsharpCoreAssembly) - { - FSharpCoreAssembly = fsharpCoreAssembly; - - Type fsharpType = fsharpCoreAssembly.GetType("Microsoft.FSharp.Reflection.FSharpType"); - - MethodInfo isUnionMethodInfo = GetMethodWithNonPublicFallback(fsharpType, "IsUnion", BindingFlags.Public | BindingFlags.Static); - IsUnion = JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(isUnionMethodInfo)!; - - MethodInfo getUnionCasesMethodInfo = GetMethodWithNonPublicFallback(fsharpType, "GetUnionCases", BindingFlags.Public | BindingFlags.Static); - GetUnionCases = JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(getUnionCasesMethodInfo)!; - - Type fsharpValue = fsharpCoreAssembly.GetType("Microsoft.FSharp.Reflection.FSharpValue"); - - PreComputeUnionTagReader = CreateFSharpFuncCall(fsharpValue, "PreComputeUnionTagReader"); - PreComputeUnionReader = CreateFSharpFuncCall(fsharpValue, "PreComputeUnionReader"); - PreComputeUnionConstructor = CreateFSharpFuncCall(fsharpValue, "PreComputeUnionConstructor"); - - Type unionCaseInfo = fsharpCoreAssembly.GetType("Microsoft.FSharp.Reflection.UnionCaseInfo"); - - GetUnionCaseInfoName = JsonTypeReflector.ReflectionDelegateFactory.CreateGet(unionCaseInfo.GetProperty("Name")!)!; - GetUnionCaseInfoTag = JsonTypeReflector.ReflectionDelegateFactory.CreateGet(unionCaseInfo.GetProperty("Tag")!)!; - GetUnionCaseInfoDeclaringType = JsonTypeReflector.ReflectionDelegateFactory.CreateGet(unionCaseInfo.GetProperty("DeclaringType")!)!; - GetUnionCaseInfoFields = JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(unionCaseInfo.GetMethod("GetFields")); - - Type listModule = fsharpCoreAssembly.GetType("Microsoft.FSharp.Collections.ListModule"); - _ofSeq = listModule.GetMethod("OfSeq"); - - _mapType = fsharpCoreAssembly.GetType("Microsoft.FSharp.Collections.FSharpMap`2"); - } - - private static readonly object Lock = new object(); - private static FSharpUtils? _instance; - - public static FSharpUtils Instance - { - get - { - MiscellaneousUtils.Assert(_instance != null); - return _instance; - } - } - - private MethodInfo _ofSeq; - private Type _mapType; - - public Assembly FSharpCoreAssembly { get; private set; } - public MethodCall IsUnion { get; private set; } - public MethodCall GetUnionCases { get; private set; } - public MethodCall PreComputeUnionTagReader { get; private set; } - public MethodCall PreComputeUnionReader { get; private set; } - public MethodCall PreComputeUnionConstructor { get; private set; } - public Func GetUnionCaseInfoDeclaringType { get; private set; } - public Func GetUnionCaseInfoName { get; private set; } - public Func GetUnionCaseInfoTag { get; private set; } - public MethodCall GetUnionCaseInfoFields { get; private set; } - - public const string FSharpSetTypeName = "FSharpSet`1"; - public const string FSharpListTypeName = "FSharpList`1"; - public const string FSharpMapTypeName = "FSharpMap`2"; - - public static void EnsureInitialized(Assembly fsharpCoreAssembly) - { - if (_instance == null) - { - lock (Lock) - { - if (_instance == null) - { - _instance = new FSharpUtils(fsharpCoreAssembly); - } - } - } - } - - private static MethodInfo GetMethodWithNonPublicFallback(Type type, string methodName, BindingFlags bindingFlags) - { - MethodInfo methodInfo = type.GetMethod(methodName, bindingFlags); - - // if no matching method then attempt to find with nonpublic flag - // this is required because in WinApps some methods are private but always using NonPublic breaks medium trust - // https://github.com/JamesNK/Newtonsoft.Json/pull/649 - // https://github.com/JamesNK/Newtonsoft.Json/issues/821 - if (methodInfo == null && (bindingFlags & BindingFlags.NonPublic) != BindingFlags.NonPublic) - { - methodInfo = type.GetMethod(methodName, bindingFlags | BindingFlags.NonPublic); - } - - return methodInfo!; - } - - private static MethodCall CreateFSharpFuncCall(Type type, string methodName) - { - MethodInfo innerMethodInfo = GetMethodWithNonPublicFallback(type, methodName, BindingFlags.Public | BindingFlags.Static); - MethodInfo invokeFunc = innerMethodInfo.ReturnType.GetMethod("Invoke", BindingFlags.Public | BindingFlags.Instance); - - MethodCall call = JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(innerMethodInfo); - MethodCall invoke = JsonTypeReflector.ReflectionDelegateFactory.CreateMethodCall(invokeFunc)!; - - MethodCall createFunction = (target, args) => - { - object? result = call(target, args); - - FSharpFunction f = new FSharpFunction(result, invoke); - return f; - }; - - return createFunction; - } - - public ObjectConstructor CreateSeq(Type t) - { - MethodInfo seqType = _ofSeq.MakeGenericMethod(t); - - return JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(seqType); - } - - public ObjectConstructor CreateMap(Type keyType, Type valueType) - { - MethodInfo creatorDefinition = typeof(FSharpUtils).GetMethod("BuildMapCreator"); - - MethodInfo creatorGeneric = creatorDefinition.MakeGenericMethod(keyType, valueType); - - return (ObjectConstructor)creatorGeneric.Invoke(this, null); - } - - public ObjectConstructor BuildMapCreator() - { - Type genericMapType = _mapType.MakeGenericType(typeof(TKey), typeof(TValue)); - ConstructorInfo ctor = genericMapType.GetConstructor(new[] { typeof(IEnumerable>) }); - ObjectConstructor ctorDelegate = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(ctor); - - ObjectConstructor creator = args => - { - // convert dictionary KeyValuePairs to Tuples - IEnumerable> values = (IEnumerable>)args[0]!; - IEnumerable> tupleValues = values.Select(kv => new Tuple(kv.Key, kv.Value)); - - return ctorDelegate(tupleValues); - }; - - return creator; - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/ILGeneratorExtensions.cs b/Source/MyDb/Newtonsoft.Json/Utilities/ILGeneratorExtensions.cs deleted file mode 100644 index d9c49ea..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/ILGeneratorExtensions.cs +++ /dev/null @@ -1,98 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -#if HAVE_REFLECTION_EMIT -using System; -using System.Reflection.Emit; -using System.Reflection; - -namespace Newtonsoft.Json.Utilities -{ - internal static class ILGeneratorExtensions - { - public static void PushInstance(this ILGenerator generator, Type type) - { - generator.Emit(OpCodes.Ldarg_0); - if (type.IsValueType()) - { - generator.Emit(OpCodes.Unbox, type); - } - else - { - generator.Emit(OpCodes.Castclass, type); - } - } - - public static void PushArrayInstance(this ILGenerator generator, int argsIndex, int arrayIndex) - { - generator.Emit(OpCodes.Ldarg, argsIndex); - generator.Emit(OpCodes.Ldc_I4, arrayIndex); - generator.Emit(OpCodes.Ldelem_Ref); - } - - public static void BoxIfNeeded(this ILGenerator generator, Type type) - { - if (type.IsValueType()) - { - generator.Emit(OpCodes.Box, type); - } - else - { - generator.Emit(OpCodes.Castclass, type); - } - } - - public static void UnboxIfNeeded(this ILGenerator generator, Type type) - { - if (type.IsValueType()) - { - generator.Emit(OpCodes.Unbox_Any, type); - } - else - { - generator.Emit(OpCodes.Castclass, type); - } - } - - public static void CallMethod(this ILGenerator generator, MethodInfo methodInfo) - { - if (methodInfo.IsFinal || !methodInfo.IsVirtual) - { - generator.Emit(OpCodes.Call, methodInfo); - } - else - { - generator.Emit(OpCodes.Callvirt, methodInfo); - } - } - - public static void Return(this ILGenerator generator) - { - generator.Emit(OpCodes.Ret); - } - } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/ImmutableCollectionsUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/ImmutableCollectionsUtils.cs deleted file mode 100644 index dfe5d45..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/ImmutableCollectionsUtils.cs +++ /dev/null @@ -1,183 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using System.Reflection; -using System.Runtime.CompilerServices; -using System.Text; -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Utilities -{ - /// - /// Helper class for serializing immutable collections. - /// Note that this is used by all builds, even those that don't support immutable collections, in case the DLL is GACed - /// https://github.com/JamesNK/Newtonsoft.Json/issues/652 - /// - internal static class ImmutableCollectionsUtils - { - internal class ImmutableCollectionTypeInfo - { - public ImmutableCollectionTypeInfo(string contractTypeName, string createdTypeName, string builderTypeName) - { - ContractTypeName = contractTypeName; - CreatedTypeName = createdTypeName; - BuilderTypeName = builderTypeName; - } - - public string ContractTypeName { get; set; } - public string CreatedTypeName { get; set; } - public string BuilderTypeName { get; set; } - } - - private const string ImmutableListGenericInterfaceTypeName = "System.Collections.Immutable.IImmutableList`1"; - private const string ImmutableQueueGenericInterfaceTypeName = "System.Collections.Immutable.IImmutableQueue`1"; - private const string ImmutableStackGenericInterfaceTypeName = "System.Collections.Immutable.IImmutableStack`1"; - private const string ImmutableSetGenericInterfaceTypeName = "System.Collections.Immutable.IImmutableSet`1"; - - private const string ImmutableArrayTypeName = "System.Collections.Immutable.ImmutableArray"; - private const string ImmutableArrayGenericTypeName = "System.Collections.Immutable.ImmutableArray`1"; - - private const string ImmutableListTypeName = "System.Collections.Immutable.ImmutableList"; - private const string ImmutableListGenericTypeName = "System.Collections.Immutable.ImmutableList`1"; - - private const string ImmutableQueueTypeName = "System.Collections.Immutable.ImmutableQueue"; - private const string ImmutableQueueGenericTypeName = "System.Collections.Immutable.ImmutableQueue`1"; - - private const string ImmutableStackTypeName = "System.Collections.Immutable.ImmutableStack"; - private const string ImmutableStackGenericTypeName = "System.Collections.Immutable.ImmutableStack`1"; - - private const string ImmutableSortedSetTypeName = "System.Collections.Immutable.ImmutableSortedSet"; - private const string ImmutableSortedSetGenericTypeName = "System.Collections.Immutable.ImmutableSortedSet`1"; - - private const string ImmutableHashSetTypeName = "System.Collections.Immutable.ImmutableHashSet"; - private const string ImmutableHashSetGenericTypeName = "System.Collections.Immutable.ImmutableHashSet`1"; - - private static readonly IList ArrayContractImmutableCollectionDefinitions = new List - { - new ImmutableCollectionTypeInfo(ImmutableListGenericInterfaceTypeName, ImmutableListGenericTypeName, ImmutableListTypeName), - new ImmutableCollectionTypeInfo(ImmutableListGenericTypeName, ImmutableListGenericTypeName, ImmutableListTypeName), - new ImmutableCollectionTypeInfo(ImmutableQueueGenericInterfaceTypeName, ImmutableQueueGenericTypeName, ImmutableQueueTypeName), - new ImmutableCollectionTypeInfo(ImmutableQueueGenericTypeName, ImmutableQueueGenericTypeName, ImmutableQueueTypeName), - new ImmutableCollectionTypeInfo(ImmutableStackGenericInterfaceTypeName, ImmutableStackGenericTypeName, ImmutableStackTypeName), - new ImmutableCollectionTypeInfo(ImmutableStackGenericTypeName, ImmutableStackGenericTypeName, ImmutableStackTypeName), - new ImmutableCollectionTypeInfo(ImmutableSetGenericInterfaceTypeName, ImmutableHashSetGenericTypeName, ImmutableHashSetTypeName), - new ImmutableCollectionTypeInfo(ImmutableSortedSetGenericTypeName, ImmutableSortedSetGenericTypeName, ImmutableSortedSetTypeName), - new ImmutableCollectionTypeInfo(ImmutableHashSetGenericTypeName, ImmutableHashSetGenericTypeName, ImmutableHashSetTypeName), - new ImmutableCollectionTypeInfo(ImmutableArrayGenericTypeName, ImmutableArrayGenericTypeName, ImmutableArrayTypeName) - }; - - private const string ImmutableDictionaryGenericInterfaceTypeName = "System.Collections.Immutable.IImmutableDictionary`2"; - - private const string ImmutableDictionaryTypeName = "System.Collections.Immutable.ImmutableDictionary"; - private const string ImmutableDictionaryGenericTypeName = "System.Collections.Immutable.ImmutableDictionary`2"; - - private const string ImmutableSortedDictionaryTypeName = "System.Collections.Immutable.ImmutableSortedDictionary"; - private const string ImmutableSortedDictionaryGenericTypeName = "System.Collections.Immutable.ImmutableSortedDictionary`2"; - - private static readonly IList DictionaryContractImmutableCollectionDefinitions = new List - { - new ImmutableCollectionTypeInfo(ImmutableDictionaryGenericInterfaceTypeName, ImmutableDictionaryGenericTypeName, ImmutableDictionaryTypeName), - new ImmutableCollectionTypeInfo(ImmutableSortedDictionaryGenericTypeName, ImmutableSortedDictionaryGenericTypeName, ImmutableSortedDictionaryTypeName), - new ImmutableCollectionTypeInfo(ImmutableDictionaryGenericTypeName, ImmutableDictionaryGenericTypeName, ImmutableDictionaryTypeName) - }; - - internal static bool TryBuildImmutableForArrayContract(Type underlyingType, Type collectionItemType, [NotNullWhen(true)]out Type? createdType, [NotNullWhen(true)]out ObjectConstructor? parameterizedCreator) - { - if (underlyingType.IsGenericType()) - { - Type underlyingTypeDefinition = underlyingType.GetGenericTypeDefinition(); - string name = underlyingTypeDefinition.FullName; - - ImmutableCollectionTypeInfo definition = ArrayContractImmutableCollectionDefinitions.FirstOrDefault(d => d.ContractTypeName == name); - if (definition != null) - { - Type createdTypeDefinition = underlyingTypeDefinition.Assembly().GetType(definition.CreatedTypeName); - Type builderTypeDefinition = underlyingTypeDefinition.Assembly().GetType(definition.BuilderTypeName); - - if (createdTypeDefinition != null && builderTypeDefinition != null) - { - MethodInfo mb = builderTypeDefinition.GetMethods().FirstOrDefault(m => m.Name == "CreateRange" && m.GetParameters().Length == 1); - if (mb != null) - { - createdType = createdTypeDefinition.MakeGenericType(collectionItemType); - MethodInfo method = mb.MakeGenericMethod(collectionItemType); - parameterizedCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(method); - return true; - } - } - } - } - - createdType = null; - parameterizedCreator = null; - return false; - } - - internal static bool TryBuildImmutableForDictionaryContract(Type underlyingType, Type keyItemType, Type valueItemType, [NotNullWhen(true)]out Type? createdType, [NotNullWhen(true)]out ObjectConstructor? parameterizedCreator) - { - if (underlyingType.IsGenericType()) - { - Type underlyingTypeDefinition = underlyingType.GetGenericTypeDefinition(); - string name = underlyingTypeDefinition.FullName; - - ImmutableCollectionTypeInfo definition = DictionaryContractImmutableCollectionDefinitions.FirstOrDefault(d => d.ContractTypeName == name); - if (definition != null) - { - Type createdTypeDefinition = underlyingTypeDefinition.Assembly().GetType(definition.CreatedTypeName); - Type builderTypeDefinition = underlyingTypeDefinition.Assembly().GetType(definition.BuilderTypeName); - - if (createdTypeDefinition != null && builderTypeDefinition != null) - { - MethodInfo mb = builderTypeDefinition.GetMethods().FirstOrDefault(m => - { - ParameterInfo[] parameters = m.GetParameters(); - - return m.Name == "CreateRange" && parameters.Length == 1 && parameters[0].ParameterType.IsGenericType() && parameters[0].ParameterType.GetGenericTypeDefinition() == typeof(IEnumerable<>); - }); - if (mb != null) - { - createdType = createdTypeDefinition.MakeGenericType(keyItemType, valueItemType); - MethodInfo method = mb.MakeGenericMethod(keyItemType, valueItemType); - parameterizedCreator = JsonTypeReflector.ReflectionDelegateFactory.CreateParameterizedConstructor(method); - return true; - } - } - } - } - - createdType = null; - parameterizedCreator = null; - return false; - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/JavaScriptUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/JavaScriptUtils.cs deleted file mode 100644 index 9619e69..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/JavaScriptUtils.cs +++ /dev/null @@ -1,656 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.IO; -#if HAVE_ASYNC -using System.Threading; -using System.Threading.Tasks; -#endif -using System.Collections.Generic; -using System.Diagnostics; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif - -namespace Newtonsoft.Json.Utilities -{ - internal static class BufferUtils - { - public static char[] RentBuffer(IArrayPool? bufferPool, int minSize) - { - if (bufferPool == null) - { - return new char[minSize]; - } - - char[] buffer = bufferPool.Rent(minSize); - return buffer; - } - - public static void ReturnBuffer(IArrayPool? bufferPool, char[]? buffer) - { - bufferPool?.Return(buffer); - } - - public static char[] EnsureBufferSize(IArrayPool? bufferPool, int size, char[]? buffer) - { - if (bufferPool == null) - { - return new char[size]; - } - - if (buffer != null) - { - bufferPool.Return(buffer); - } - - return bufferPool.Rent(size); - } - } - - internal static class JavaScriptUtils - { - internal static readonly bool[] SingleQuoteCharEscapeFlags = new bool[128]; - internal static readonly bool[] DoubleQuoteCharEscapeFlags = new bool[128]; - internal static readonly bool[] HtmlCharEscapeFlags = new bool[128]; - - private const int UnicodeTextLength = 6; - - static JavaScriptUtils() - { - IList escapeChars = new List - { - '\n', '\r', '\t', '\\', '\f', '\b', - }; - for (int i = 0; i < ' '; i++) - { - escapeChars.Add((char)i); - } - - foreach (char escapeChar in escapeChars.Union(new[] { '\'' })) - { - SingleQuoteCharEscapeFlags[escapeChar] = true; - } - foreach (char escapeChar in escapeChars.Union(new[] { '"' })) - { - DoubleQuoteCharEscapeFlags[escapeChar] = true; - } - foreach (char escapeChar in escapeChars.Union(new[] { '"', '\'', '<', '>', '&' })) - { - HtmlCharEscapeFlags[escapeChar] = true; - } - } - - private const string EscapedUnicodeText = "!"; - - public static bool[] GetCharEscapeFlags(StringEscapeHandling stringEscapeHandling, char quoteChar) - { - if (stringEscapeHandling == StringEscapeHandling.EscapeHtml) - { - return HtmlCharEscapeFlags; - } - - if (quoteChar == '"') - { - return DoubleQuoteCharEscapeFlags; - } - - return SingleQuoteCharEscapeFlags; - } - - public static bool ShouldEscapeJavaScriptString(string? s, bool[] charEscapeFlags) - { - if (s == null) - { - return false; - } - - for (int i = 0; i < s.Length; i++) - { - char c = s[i]; - if (c >= charEscapeFlags.Length || charEscapeFlags[c]) - { - return true; - } - } - - return false; - } - - public static void WriteEscapedJavaScriptString(TextWriter writer, string? s, char delimiter, bool appendDelimiters, - bool[] charEscapeFlags, StringEscapeHandling stringEscapeHandling, IArrayPool? bufferPool, ref char[]? writeBuffer) - { - // leading delimiter - if (appendDelimiters) - { - writer.Write(delimiter); - } - - if (!StringUtils.IsNullOrEmpty(s)) - { - int lastWritePosition = FirstCharToEscape(s, charEscapeFlags, stringEscapeHandling); - if (lastWritePosition == -1) - { - writer.Write(s); - } - else - { - if (lastWritePosition != 0) - { - if (writeBuffer == null || writeBuffer.Length < lastWritePosition) - { - writeBuffer = BufferUtils.EnsureBufferSize(bufferPool, lastWritePosition, writeBuffer); - } - - // write unchanged chars at start of text. - s.CopyTo(0, writeBuffer, 0, lastWritePosition); - writer.Write(writeBuffer, 0, lastWritePosition); - } - - int length; - for (int i = lastWritePosition; i < s.Length; i++) - { - char c = s[i]; - - if (c < charEscapeFlags.Length && !charEscapeFlags[c]) - { - continue; - } - - string? escapedValue; - - switch (c) - { - case '\t': - escapedValue = @"\t"; - break; - case '\n': - escapedValue = @"\n"; - break; - case '\r': - escapedValue = @"\r"; - break; - case '\f': - escapedValue = @"\f"; - break; - case '\b': - escapedValue = @"\b"; - break; - case '\\': - escapedValue = @"\\"; - break; - case '\u0085': // Next Line - escapedValue = @"\u0085"; - break; - case '\u2028': // Line Separator - escapedValue = @"\u2028"; - break; - case '\u2029': // Paragraph Separator - escapedValue = @"\u2029"; - break; - default: - if (c < charEscapeFlags.Length || stringEscapeHandling == StringEscapeHandling.EscapeNonAscii) - { - if (c == '\'' && stringEscapeHandling != StringEscapeHandling.EscapeHtml) - { - escapedValue = @"\'"; - } - else if (c == '"' && stringEscapeHandling != StringEscapeHandling.EscapeHtml) - { - escapedValue = @"\"""; - } - else - { - if (writeBuffer == null || writeBuffer.Length < UnicodeTextLength) - { - writeBuffer = BufferUtils.EnsureBufferSize(bufferPool, UnicodeTextLength, writeBuffer); - } - - StringUtils.ToCharAsUnicode(c, writeBuffer!); - - // slightly hacky but it saves multiple conditions in if test - escapedValue = EscapedUnicodeText; - } - } - else - { - escapedValue = null; - } - break; - } - - if (escapedValue == null) - { - continue; - } - - bool isEscapedUnicodeText = string.Equals(escapedValue, EscapedUnicodeText, StringComparison.Ordinal); - - if (i > lastWritePosition) - { - length = i - lastWritePosition + ((isEscapedUnicodeText) ? UnicodeTextLength : 0); - int start = (isEscapedUnicodeText) ? UnicodeTextLength : 0; - - if (writeBuffer == null || writeBuffer.Length < length) - { - char[] newBuffer = BufferUtils.RentBuffer(bufferPool, length); - - // the unicode text is already in the buffer - // copy it over when creating new buffer - if (isEscapedUnicodeText) - { - MiscellaneousUtils.Assert(writeBuffer != null, "Write buffer should never be null because it is set when the escaped unicode text is encountered."); - - Array.Copy(writeBuffer, newBuffer, UnicodeTextLength); - } - - BufferUtils.ReturnBuffer(bufferPool, writeBuffer); - - writeBuffer = newBuffer; - } - - s.CopyTo(lastWritePosition, writeBuffer, start, length - start); - - // write unchanged chars before writing escaped text - writer.Write(writeBuffer, start, length - start); - } - - lastWritePosition = i + 1; - if (!isEscapedUnicodeText) - { - writer.Write(escapedValue); - } - else - { - writer.Write(writeBuffer, 0, UnicodeTextLength); - } - } - - MiscellaneousUtils.Assert(lastWritePosition != 0); - length = s.Length - lastWritePosition; - if (length > 0) - { - if (writeBuffer == null || writeBuffer.Length < length) - { - writeBuffer = BufferUtils.EnsureBufferSize(bufferPool, length, writeBuffer); - } - - s.CopyTo(lastWritePosition, writeBuffer, 0, length); - - // write remaining text - writer.Write(writeBuffer, 0, length); - } - } - } - - // trailing delimiter - if (appendDelimiters) - { - writer.Write(delimiter); - } - } - - public static string ToEscapedJavaScriptString(string? value, char delimiter, bool appendDelimiters, StringEscapeHandling stringEscapeHandling) - { - bool[] charEscapeFlags = GetCharEscapeFlags(stringEscapeHandling, delimiter); - - using (StringWriter w = StringUtils.CreateStringWriter(value?.Length ?? 16)) - { - char[]? buffer = null; - WriteEscapedJavaScriptString(w, value, delimiter, appendDelimiters, charEscapeFlags, stringEscapeHandling, null, ref buffer); - return w.ToString(); - } - } - - private static int FirstCharToEscape(string s, bool[] charEscapeFlags, StringEscapeHandling stringEscapeHandling) - { - for (int i = 0; i != s.Length; i++) - { - char c = s[i]; - - if (c < charEscapeFlags.Length) - { - if (charEscapeFlags[c]) - { - return i; - } - } - else if (stringEscapeHandling == StringEscapeHandling.EscapeNonAscii) - { - return i; - } - else - { - switch (c) - { - case '\u0085': - case '\u2028': - case '\u2029': - return i; - } - } - } - - return -1; - } - -#if HAVE_ASYNC - public static Task WriteEscapedJavaScriptStringAsync(TextWriter writer, string s, char delimiter, bool appendDelimiters, bool[] charEscapeFlags, StringEscapeHandling stringEscapeHandling, JsonTextWriter client, char[] writeBuffer, CancellationToken cancellationToken = default) - { - if (cancellationToken.IsCancellationRequested) - { - return cancellationToken.FromCanceled(); - } - - if (appendDelimiters) - { - return WriteEscapedJavaScriptStringWithDelimitersAsync(writer, s, delimiter, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken); - } - - if (StringUtils.IsNullOrEmpty(s)) - { - return cancellationToken.CancelIfRequestedAsync() ?? AsyncUtils.CompletedTask; - } - - return WriteEscapedJavaScriptStringWithoutDelimitersAsync(writer, s, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken); - } - - private static Task WriteEscapedJavaScriptStringWithDelimitersAsync(TextWriter writer, string s, char delimiter, - bool[] charEscapeFlags, StringEscapeHandling stringEscapeHandling, JsonTextWriter client, char[] writeBuffer, CancellationToken cancellationToken) - { - Task task = writer.WriteAsync(delimiter, cancellationToken); - if (!task.IsCompletedSucessfully()) - { - return WriteEscapedJavaScriptStringWithDelimitersAsync(task, writer, s, delimiter, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken); - } - - if (!StringUtils.IsNullOrEmpty(s)) - { - task = WriteEscapedJavaScriptStringWithoutDelimitersAsync(writer, s, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken); - if (task.IsCompletedSucessfully()) - { - return writer.WriteAsync(delimiter, cancellationToken); - } - } - - return WriteCharAsync(task, writer, delimiter, cancellationToken); - - } - - private static async Task WriteEscapedJavaScriptStringWithDelimitersAsync(Task task, TextWriter writer, string s, char delimiter, - bool[] charEscapeFlags, StringEscapeHandling stringEscapeHandling, JsonTextWriter client, char[] writeBuffer, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - - if (!StringUtils.IsNullOrEmpty(s)) - { - await WriteEscapedJavaScriptStringWithoutDelimitersAsync(writer, s, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken).ConfigureAwait(false); - } - - await writer.WriteAsync(delimiter).ConfigureAwait(false); - } - - public static async Task WriteCharAsync(Task task, TextWriter writer, char c, CancellationToken cancellationToken) - { - await task.ConfigureAwait(false); - await writer.WriteAsync(c, cancellationToken).ConfigureAwait(false); - } - - private static Task WriteEscapedJavaScriptStringWithoutDelimitersAsync( - TextWriter writer, string s, bool[] charEscapeFlags, StringEscapeHandling stringEscapeHandling, - JsonTextWriter client, char[] writeBuffer, CancellationToken cancellationToken) - { - int i = FirstCharToEscape(s, charEscapeFlags, stringEscapeHandling); - return i == -1 - ? writer.WriteAsync(s, cancellationToken) - : WriteDefinitelyEscapedJavaScriptStringWithoutDelimitersAsync(writer, s, i, charEscapeFlags, stringEscapeHandling, client, writeBuffer, cancellationToken); - } - - private static async Task WriteDefinitelyEscapedJavaScriptStringWithoutDelimitersAsync( - TextWriter writer, string s, int lastWritePosition, bool[] charEscapeFlags, - StringEscapeHandling stringEscapeHandling, JsonTextWriter client, char[] writeBuffer, - CancellationToken cancellationToken) - { - if (writeBuffer == null || writeBuffer.Length < lastWritePosition) - { - writeBuffer = client.EnsureWriteBuffer(lastWritePosition, UnicodeTextLength); - } - - if (lastWritePosition != 0) - { - s.CopyTo(0, writeBuffer, 0, lastWritePosition); - - // write unchanged chars at start of text. - await writer.WriteAsync(writeBuffer, 0, lastWritePosition, cancellationToken).ConfigureAwait(false); - } - - int length; - bool isEscapedUnicodeText = false; - string? escapedValue = null; - - for (int i = lastWritePosition; i < s.Length; i++) - { - char c = s[i]; - - if (c < charEscapeFlags.Length && !charEscapeFlags[c]) - { - continue; - } - - switch (c) - { - case '\t': - escapedValue = @"\t"; - break; - case '\n': - escapedValue = @"\n"; - break; - case '\r': - escapedValue = @"\r"; - break; - case '\f': - escapedValue = @"\f"; - break; - case '\b': - escapedValue = @"\b"; - break; - case '\\': - escapedValue = @"\\"; - break; - case '\u0085': // Next Line - escapedValue = @"\u0085"; - break; - case '\u2028': // Line Separator - escapedValue = @"\u2028"; - break; - case '\u2029': // Paragraph Separator - escapedValue = @"\u2029"; - break; - default: - if (c < charEscapeFlags.Length || stringEscapeHandling == StringEscapeHandling.EscapeNonAscii) - { - if (c == '\'' && stringEscapeHandling != StringEscapeHandling.EscapeHtml) - { - escapedValue = @"\'"; - } - else if (c == '"' && stringEscapeHandling != StringEscapeHandling.EscapeHtml) - { - escapedValue = @"\"""; - } - else - { - if (writeBuffer.Length < UnicodeTextLength) - { - writeBuffer = client.EnsureWriteBuffer(UnicodeTextLength, 0); - } - - StringUtils.ToCharAsUnicode(c, writeBuffer); - - isEscapedUnicodeText = true; - } - } - else - { - continue; - } - break; - } - - if (i > lastWritePosition) - { - length = i - lastWritePosition + (isEscapedUnicodeText ? UnicodeTextLength : 0); - int start = isEscapedUnicodeText ? UnicodeTextLength : 0; - - if (writeBuffer.Length < length) - { - writeBuffer = client.EnsureWriteBuffer(length, UnicodeTextLength); - } - - s.CopyTo(lastWritePosition, writeBuffer, start, length - start); - - // write unchanged chars before writing escaped text - await writer.WriteAsync(writeBuffer, start, length - start, cancellationToken).ConfigureAwait(false); - } - - lastWritePosition = i + 1; - if (!isEscapedUnicodeText) - { - await writer.WriteAsync(escapedValue!, cancellationToken).ConfigureAwait(false); - } - else - { - await writer.WriteAsync(writeBuffer, 0, UnicodeTextLength, cancellationToken).ConfigureAwait(false); - isEscapedUnicodeText = false; - } - } - - length = s.Length - lastWritePosition; - - if (length != 0) - { - if (writeBuffer.Length < length) - { - writeBuffer = client.EnsureWriteBuffer(length, 0); - } - - s.CopyTo(lastWritePosition, writeBuffer, 0, length); - - // write remaining text - await writer.WriteAsync(writeBuffer, 0, length, cancellationToken).ConfigureAwait(false); - } - } -#endif - - public static bool TryGetDateFromConstructorJson(JsonReader reader, out DateTime dateTime, [NotNullWhen(false)]out string? errorMessage) - { - dateTime = default; - errorMessage = null; - - if (!TryGetDateConstructorValue(reader, out long? t1, out errorMessage) || t1 == null) - { - errorMessage = errorMessage ?? "Date constructor has no arguments."; - return false; - } - if (!TryGetDateConstructorValue(reader, out long? t2, out errorMessage)) - { - return false; - } - else if (t2 != null) - { - // Only create a list when there is more than one argument - List dateArgs = new List - { - t1.Value, - t2.Value - }; - while (true) - { - if (!TryGetDateConstructorValue(reader, out long? integer, out errorMessage)) - { - return false; - } - else if (integer != null) - { - dateArgs.Add(integer.Value); - } - else - { - break; - } - } - - if (dateArgs.Count > 7) - { - errorMessage = "Unexpected number of arguments when reading date constructor."; - return false; - } - - // Pad args out to the number used by the ctor - while (dateArgs.Count < 7) - { - dateArgs.Add(0); - } - - dateTime = new DateTime((int)dateArgs[0], (int)dateArgs[1] + 1, dateArgs[2] == 0 ? 1 : (int)dateArgs[2], - (int)dateArgs[3], (int)dateArgs[4], (int)dateArgs[5], (int)dateArgs[6]); - } - else - { - dateTime = DateTimeUtils.ConvertJavaScriptTicksToDateTime(t1.Value); - } - - return true; - } - - private static bool TryGetDateConstructorValue(JsonReader reader, out long? integer, [NotNullWhen(false)] out string? errorMessage) - { - integer = null; - errorMessage = null; - - if (!reader.Read()) - { - errorMessage = "Unexpected end when reading date constructor."; - return false; - } - if (reader.TokenType == JsonToken.EndConstructor) - { - return true; - } - if (reader.TokenType != JsonToken.Integer) - { - errorMessage = "Unexpected token when reading date constructor. Expected Integer, got " + reader.TokenType; - return false; - } - - integer = (long)reader.Value!; - return true; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/JsonTokenUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/JsonTokenUtils.cs deleted file mode 100644 index 7e02baa..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/JsonTokenUtils.cs +++ /dev/null @@ -1,74 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Utilities -{ - internal static class JsonTokenUtils - { - internal static bool IsEndToken(JsonToken token) - { - switch (token) - { - case JsonToken.EndObject: - case JsonToken.EndArray: - case JsonToken.EndConstructor: - return true; - default: - return false; - } - } - - internal static bool IsStartToken(JsonToken token) - { - switch (token) - { - case JsonToken.StartObject: - case JsonToken.StartArray: - case JsonToken.StartConstructor: - return true; - default: - return false; - } - } - - internal static bool IsPrimitiveToken(JsonToken token) - { - switch (token) - { - case JsonToken.Integer: - case JsonToken.Float: - case JsonToken.String: - case JsonToken.Boolean: - case JsonToken.Undefined: - case JsonToken.Null: - case JsonToken.Date: - case JsonToken.Bytes: - return true; - default: - return false; - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/LateBoundReflectionDelegateFactory.cs b/Source/MyDb/Newtonsoft.Json/Utilities/LateBoundReflectionDelegateFactory.cs deleted file mode 100644 index 277f1eb..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/LateBoundReflectionDelegateFactory.cs +++ /dev/null @@ -1,110 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using Newtonsoft.Json.Serialization; -using System.Reflection; - -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#endif - -namespace Newtonsoft.Json.Utilities -{ - internal class LateBoundReflectionDelegateFactory : ReflectionDelegateFactory - { - private static readonly LateBoundReflectionDelegateFactory _instance = new LateBoundReflectionDelegateFactory(); - - internal static ReflectionDelegateFactory Instance => _instance; - - public override ObjectConstructor CreateParameterizedConstructor(MethodBase method) - { - ValidationUtils.ArgumentNotNull(method, nameof(method)); - - if (method is ConstructorInfo c) - { - // don't convert to method group to avoid medium trust issues - // https://github.com/JamesNK/Newtonsoft.Json/issues/476 - return a => c.Invoke(a); - } - - return a => method.Invoke(null, a); - } - - public override MethodCall CreateMethodCall(MethodBase method) - { - ValidationUtils.ArgumentNotNull(method, nameof(method)); - - if (method is ConstructorInfo c) - { - return (o, a) => c.Invoke(a); - } - - return (o, a) => method.Invoke(o, a); - } - - public override Func CreateDefaultConstructor(Type type) - { - ValidationUtils.ArgumentNotNull(type, nameof(type)); - - if (type.IsValueType()) - { - return () => (T)Activator.CreateInstance(type); - } - - ConstructorInfo constructorInfo = ReflectionUtils.GetDefaultConstructor(type, true); - - return () => (T)constructorInfo.Invoke(null); - } - - public override Func CreateGet(PropertyInfo propertyInfo) - { - ValidationUtils.ArgumentNotNull(propertyInfo, nameof(propertyInfo)); - - return o => propertyInfo.GetValue(o, null); - } - - public override Func CreateGet(FieldInfo fieldInfo) - { - ValidationUtils.ArgumentNotNull(fieldInfo, nameof(fieldInfo)); - - return o => fieldInfo.GetValue(o); - } - - public override Action CreateSet(FieldInfo fieldInfo) - { - ValidationUtils.ArgumentNotNull(fieldInfo, nameof(fieldInfo)); - - return (o, v) => fieldInfo.SetValue(o, v); - } - - public override Action CreateSet(PropertyInfo propertyInfo) - { - ValidationUtils.ArgumentNotNull(propertyInfo, nameof(propertyInfo)); - - return (o, v) => propertyInfo.SetValue(o, v, null); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/LinqBridge.cs b/Source/MyDb/Newtonsoft.Json/Utilities/LinqBridge.cs deleted file mode 100644 index e1dba08..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/LinqBridge.cs +++ /dev/null @@ -1,3073 +0,0 @@ - -#if !HAVE_LINQ - -#region License, Terms and Author(s) -// -// LINQBridge -// Copyright (c) 2007-9 Atif Aziz, Joseph Albahari. All rights reserved. -// -// Author(s): -// -// Atif Aziz, http://www.raboof.com -// -// This library is free software; you can redistribute it and/or modify it -// under the terms of the New BSD License, a copy of which should have -// been delivered along with this distribution. -// -// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A -// PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -// -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using System.Diagnostics; -using System.Globalization; -using Newtonsoft.Json.Serialization; - -#nullable disable - -namespace Newtonsoft.Json.Utilities.LinqBridge -{ - /// - /// Provides a set of static (Shared in Visual Basic) methods for - /// querying objects that implement . - /// - internal static partial class Enumerable - { - /// - /// Returns the input typed as . - /// - - public static IEnumerable AsEnumerable(IEnumerable source) - { - return source; - } - - /// - /// Returns an empty that has the - /// specified type argument. - /// - - public static IEnumerable Empty() - { - return Sequence.Empty; - } - - /// - /// Converts the elements of an to the - /// specified type. - /// - - public static IEnumerable Cast( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - var servesItself = source as IEnumerable; - if (servesItself != null - && (!(servesItself is TResult[]) || servesItself.GetType().GetElementType() == typeof(TResult))) - { - return servesItself; - } - - return CastYield(source); - } - - private static IEnumerable CastYield( - IEnumerable source) - { - foreach (var item in source) - yield return (TResult) item; - } - - /// - /// Filters the elements of an based on a specified type. - /// - - public static IEnumerable OfType( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return OfTypeYield(source); - } - - private static IEnumerable OfTypeYield( - IEnumerable source) - { - foreach (var item in source) - if (item is TResult) - yield return (TResult) item; - } - - /// - /// Generates a sequence of integral numbers within a specified range. - /// - /// The value of the first integer in the sequence. - /// The number of sequential integers to generate. - - public static IEnumerable Range(int start, int count) - { - if (count < 0) - throw new ArgumentOutOfRangeException("count", count, null); - - var end = (long) start + count; - if (end - 1 >= int.MaxValue) - throw new ArgumentOutOfRangeException("count", count, null); - - return RangeYield(start, end); - } - - private static IEnumerable RangeYield(int start, long end) - { - for (var i = start; i < end; i++) - yield return i; - } - - /// - /// Generates a sequence that contains one repeated value. - /// - - public static IEnumerable Repeat(TResult element, int count) - { - if (count < 0) throw new ArgumentOutOfRangeException("count", count, null); - - return RepeatYield(element, count); - } - - private static IEnumerable RepeatYield(TResult element, int count) - { - for (var i = 0; i < count; i++) - yield return element; - } - - /// - /// Filters a sequence of values based on a predicate. - /// - - public static IEnumerable Where( - this IEnumerable source, - Func predicate) - { - CheckNotNull(source, "source"); - CheckNotNull(predicate, "predicate"); - - return WhereYield(source, predicate); - } - - private static IEnumerable WhereYield( - IEnumerable source, - Func predicate) - { - foreach (var item in source) - if (predicate(item)) - yield return item; - } - /// - /// Filters a sequence of values based on a predicate. - /// Each element's index is used in the logic of the predicate function. - /// - - public static IEnumerable Where( - this IEnumerable source, - Func predicate) - { - CheckNotNull(source, "source"); - CheckNotNull(predicate, "predicate"); - - return WhereYield(source, predicate); - } - - private static IEnumerable WhereYield( - IEnumerable source, - Func predicate) - { - var i = 0; - foreach (var item in source) - if (predicate(item, i++)) - yield return item; - } - - /// - /// Projects each element of a sequence into a new form. - /// - - public static IEnumerable Select( - this IEnumerable source, - Func selector) - { - CheckNotNull(source, "source"); - CheckNotNull(selector, "selector"); - - return SelectYield(source, selector); - } - - private static IEnumerable SelectYield( - IEnumerable source, - Func selector) - { - foreach (var item in source) - yield return selector(item); - } - - /// - /// Projects each element of a sequence into a new form by - /// incorporating the element's index. - /// - - public static IEnumerable Select( - this IEnumerable source, - Func selector) - { - CheckNotNull(source, "source"); - CheckNotNull(selector, "selector"); - - return SelectYield(source, selector); - } - - private static IEnumerable SelectYield( - IEnumerable source, - Func selector) - { - var i = 0; - foreach (var item in source) - yield return selector(item, i++); - } - - /// - /// Projects each element of a sequence to an - /// and flattens the resulting sequences into one sequence. - /// - - public static IEnumerable SelectMany( - this IEnumerable source, - Func> selector) - { - CheckNotNull(selector, "selector"); - - return source.SelectMany((item, i) => selector(item)); - } - - /// - /// Projects each element of a sequence to an , - /// and flattens the resulting sequences into one sequence. The - /// index of each source element is used in the projected form of - /// that element. - /// - - public static IEnumerable SelectMany( - this IEnumerable source, - Func> selector) - { - CheckNotNull(selector, "selector"); - - return source.SelectMany(selector, (item, subitem) => subitem); - } - - /// - /// Projects each element of a sequence to an , - /// flattens the resulting sequences into one sequence, and invokes - /// a result selector function on each element therein. - /// - - public static IEnumerable SelectMany( - this IEnumerable source, - Func> collectionSelector, - Func resultSelector) - { - CheckNotNull(collectionSelector, "collectionSelector"); - - return source.SelectMany((item, i) => collectionSelector(item), resultSelector); - } - - /// - /// Projects each element of a sequence to an , - /// flattens the resulting sequences into one sequence, and invokes - /// a result selector function on each element therein. The index of - /// each source element is used in the intermediate projected form - /// of that element. - /// - - public static IEnumerable SelectMany( - this IEnumerable source, - Func> collectionSelector, - Func resultSelector) - { - CheckNotNull(source, "source"); - CheckNotNull(collectionSelector, "collectionSelector"); - CheckNotNull(resultSelector, "resultSelector"); - - return SelectManyYield(source, collectionSelector, resultSelector); - } - - private static IEnumerable SelectManyYield( - this IEnumerable source, - Func> collectionSelector, - Func resultSelector) - { - var i = 0; - foreach (var item in source) - foreach (var subitem in collectionSelector(item, i++)) - yield return resultSelector(item, subitem); - } - - /// - /// Returns elements from a sequence as long as a specified condition is true. - /// - - public static IEnumerable TakeWhile( - this IEnumerable source, - Func predicate) - { - CheckNotNull(predicate, "predicate"); - - return source.TakeWhile((item, i) => predicate(item)); - } - - /// - /// Returns elements from a sequence as long as a specified condition is true. - /// The element's index is used in the logic of the predicate function. - /// - - public static IEnumerable TakeWhile( - this IEnumerable source, - Func predicate) - { - CheckNotNull(source, "source"); - CheckNotNull(predicate, "predicate"); - - return TakeWhileYield(source, predicate); - } - - private static IEnumerable TakeWhileYield( - this IEnumerable source, - Func predicate) - { - var i = 0; - foreach (var item in source) - if (predicate(item, i++)) - yield return item; - else - break; - } - - private static class Futures - { - public static readonly Func Default = () => default(T); - public static readonly Func Undefined = () => { throw new InvalidOperationException(); }; - } - - /// - /// Base implementation of First operator. - /// - - private static TSource FirstImpl( - this IEnumerable source, - Func empty) - { - CheckNotNull(source, "source"); - MiscellaneousUtils.Assert(empty != null); - - var list = source as IList; // optimized case for lists - if (list != null) - return list.Count > 0 ? list[0] : empty(); - - using (var e = source.GetEnumerator()) // fallback for enumeration - return e.MoveNext() ? e.Current : empty(); - } - - /// - /// Returns the first element of a sequence. - /// - - public static TSource First( - this IEnumerable source) - { - return source.FirstImpl(Futures.Undefined); - } - - /// - /// Returns the first element in a sequence that satisfies a specified condition. - /// - - public static TSource First( - this IEnumerable source, - Func predicate) - { - return First(source.Where(predicate)); - } - - /// - /// Returns the first element of a sequence, or a default value if - /// the sequence contains no elements. - /// - - public static TSource FirstOrDefault( - this IEnumerable source) - { - return source.FirstImpl(Futures.Default); - } - - /// - /// Returns the first element of the sequence that satisfies a - /// condition or a default value if no such element is found. - /// - - public static TSource FirstOrDefault( - this IEnumerable source, - Func predicate) - { - return FirstOrDefault(source.Where(predicate)); - } - - /// - /// Base implementation of Last operator. - /// - - private static TSource LastImpl( - this IEnumerable source, - Func empty) - { - CheckNotNull(source, "source"); - - var list = source as IList; // optimized case for lists - if (list != null) - return list.Count > 0 ? list[list.Count - 1] : empty(); - - using (var e = source.GetEnumerator()) - { - if (!e.MoveNext()) - return empty(); - - var last = e.Current; - while (e.MoveNext()) - last = e.Current; - - return last; - } - } - - /// - /// Returns the last element of a sequence. - /// - public static TSource Last( - this IEnumerable source) - { - return source.LastImpl(Futures.Undefined); - } - - /// - /// Returns the last element of a sequence that satisfies a - /// specified condition. - /// - - public static TSource Last( - this IEnumerable source, - Func predicate) - { - return Last(source.Where(predicate)); - } - - /// - /// Returns the last element of a sequence, or a default value if - /// the sequence contains no elements. - /// - - public static TSource LastOrDefault( - this IEnumerable source) - { - return source.LastImpl(Futures.Default); - } - - /// - /// Returns the last element of a sequence that satisfies a - /// condition or a default value if no such element is found. - /// - - public static TSource LastOrDefault( - this IEnumerable source, - Func predicate) - { - return LastOrDefault(source.Where(predicate)); - } - - /// - /// Base implementation of Single operator. - /// - - private static TSource SingleImpl( - this IEnumerable source, - Func empty) - { - CheckNotNull(source, "source"); - - using (var e = source.GetEnumerator()) - { - if (e.MoveNext()) - { - var single = e.Current; - if (!e.MoveNext()) - return single; - - throw new InvalidOperationException(); - } - - return empty(); - } - } - - /// - /// Returns the only element of a sequence, and throws an exception - /// if there is not exactly one element in the sequence. - /// - - public static TSource Single( - this IEnumerable source) - { - return source.SingleImpl(Futures.Undefined); - } - - /// - /// Returns the only element of a sequence that satisfies a - /// specified condition, and throws an exception if more than one - /// such element exists. - /// - - public static TSource Single( - this IEnumerable source, - Func predicate) - { - return Single(source.Where(predicate)); - } - - /// - /// Returns the only element of a sequence, or a default value if - /// the sequence is empty; this method throws an exception if there - /// is more than one element in the sequence. - /// - - public static TSource SingleOrDefault( - this IEnumerable source) - { - return source.SingleImpl(Futures.Default); - } - - /// - /// Returns the only element of a sequence that satisfies a - /// specified condition or a default value if no such element - /// exists; this method throws an exception if more than one element - /// satisfies the condition. - /// - - public static TSource SingleOrDefault( - this IEnumerable source, - Func predicate) - { - return SingleOrDefault(source.Where(predicate)); - } - - /// - /// Returns the element at a specified index in a sequence. - /// - - public static TSource ElementAt( - this IEnumerable source, - int index) - { - CheckNotNull(source, "source"); - - if (index < 0) - throw new ArgumentOutOfRangeException("index", index, null); - - var list = source as IList; - if (list != null) - return list[index]; - - try - { - return source.SkipWhile((item, i) => i < index).First(); - } - catch (InvalidOperationException) // if thrown by First - { - throw new ArgumentOutOfRangeException("index", index, null); - } - } - - /// - /// Returns the element at a specified index in a sequence or a - /// default value if the index is out of range. - /// - - public static TSource ElementAtOrDefault( - this IEnumerable source, - int index) - { - CheckNotNull(source, "source"); - - if (index < 0) - return default(TSource); - - var list = source as IList; - if (list != null) - return index < list.Count ? list[index] : default(TSource); - - return source.SkipWhile((item, i) => i < index).FirstOrDefault(); - } - - /// - /// Inverts the order of the elements in a sequence. - /// - - public static IEnumerable Reverse( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return ReverseYield(source); - } - - private static IEnumerable ReverseYield(IEnumerable source) - { - var stack = new Stack(source); - - foreach (var item in stack) - yield return item; - } - - /// - /// Returns a specified number of contiguous elements from the start - /// of a sequence. - /// - - public static IEnumerable Take( - this IEnumerable source, - int count) - { - return source.Where((item, i) => i < count); - } - - /// - /// Bypasses a specified number of elements in a sequence and then - /// returns the remaining elements. - /// - - public static IEnumerable Skip( - this IEnumerable source, - int count) - { - return source.Where((item, i) => i >= count); - } - - /// - /// Bypasses elements in a sequence as long as a specified condition - /// is true and then returns the remaining elements. - /// - - public static IEnumerable SkipWhile( - this IEnumerable source, - Func predicate) - { - CheckNotNull(predicate, "predicate"); - - return source.SkipWhile((item, i) => predicate(item)); - } - - /// - /// Bypasses elements in a sequence as long as a specified condition - /// is true and then returns the remaining elements. The element's - /// index is used in the logic of the predicate function. - /// - - public static IEnumerable SkipWhile( - this IEnumerable source, - Func predicate) - { - CheckNotNull(source, "source"); - CheckNotNull(predicate, "predicate"); - - return SkipWhileYield(source, predicate); - } - - private static IEnumerable SkipWhileYield( - IEnumerable source, - Func predicate) - { - using (var e = source.GetEnumerator()) - { - for (var i = 0;; i++) - { - if (!e.MoveNext()) - yield break; - - if (!predicate(e.Current, i)) - break; - } - - do - { - yield return e.Current; - } while (e.MoveNext()); - } - } - - /// - /// Returns the number of elements in a sequence. - /// - - public static int Count( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - var collection = source as ICollection; - if (collection != null) - { - return collection.Count; - } - - using (var en = source.GetEnumerator()) - { - int count = 0; - while (en.MoveNext()) - { - ++count; - } - - return count; - } - } - - /// - /// Returns a number that represents how many elements in the - /// specified sequence satisfy a condition. - /// - - public static int Count( - this IEnumerable source, - Func predicate) - { - return Count(source.Where(predicate)); - } - - /// - /// Returns a that represents the total number - /// of elements in a sequence. - /// - - public static long LongCount( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - var array = source as Array; - return array != null - ? array.LongLength - : source.Aggregate(0L, (count, item) => count + 1); - } - - /// - /// Returns a that represents how many elements - /// in a sequence satisfy a condition. - /// - - public static long LongCount( - this IEnumerable source, - Func predicate) - { - return LongCount(source.Where(predicate)); - } - - /// - /// Concatenates two sequences. - /// - - public static IEnumerable Concat( - this IEnumerable first, - IEnumerable second) - { - CheckNotNull(first, "first"); - CheckNotNull(second, "second"); - - return ConcatYield(first, second); - } - - private static IEnumerable ConcatYield( - IEnumerable first, - IEnumerable second) - { - foreach (var item in first) - yield return item; - - foreach (var item in second) - yield return item; - } - - /// - /// Creates a from an . - /// - - public static List ToList( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return new List(source); - } - - /// - /// Creates an array from an . - /// - - public static TSource[] ToArray( - this IEnumerable source) - { - IList ilist = source as IList; - if (ilist != null) - { - TSource[] array = new TSource[ilist.Count]; - ilist.CopyTo(array, 0); - return array; - } - - return source.ToList().ToArray(); - } - - /// - /// Returns distinct elements from a sequence by using the default - /// equality comparer to compare values. - /// - - public static IEnumerable Distinct( - this IEnumerable source) - { - return Distinct(source, /* comparer */ null); - } - - /// - /// Returns distinct elements from a sequence by using a specified - /// to compare values. - /// - - public static IEnumerable Distinct( - this IEnumerable source, - IEqualityComparer comparer) - { - CheckNotNull(source, "source"); - - return DistinctYield(source, comparer); - } - - private static IEnumerable DistinctYield( - IEnumerable source, - IEqualityComparer comparer) - { - var set = new Dictionary(comparer); - var gotNull = false; - - foreach (var item in source) - { - if (item == null) - { - if (gotNull) - continue; - gotNull = true; - } - else - { - if (set.ContainsKey(item)) - continue; - set.Add(item, null); - } - - yield return item; - } - } - - /// - /// Creates a from an - /// according to a specified key - /// selector function. - /// - - public static ILookup ToLookup( - this IEnumerable source, - Func keySelector) - { - return ToLookup(source, keySelector, e => e, /* comparer */ null); - } - - /// - /// Creates a from an - /// according to a specified key - /// selector function and a key comparer. - /// - - public static ILookup ToLookup( - this IEnumerable source, - Func keySelector, - IEqualityComparer comparer) - { - return ToLookup(source, keySelector, e => e, comparer); - } - - /// - /// Creates a from an - /// according to specified key - /// and element selector functions. - /// - - public static ILookup ToLookup( - this IEnumerable source, - Func keySelector, - Func elementSelector) - { - return ToLookup(source, keySelector, elementSelector, /* comparer */ null); - } - - /// - /// Creates a from an - /// according to a specified key - /// selector function, a comparer and an element selector function. - /// - - public static ILookup ToLookup( - this IEnumerable source, - Func keySelector, - Func elementSelector, - IEqualityComparer comparer) - { - CheckNotNull(source, "source"); - CheckNotNull(keySelector, "keySelector"); - CheckNotNull(elementSelector, "elementSelector"); - - var lookup = new Lookup(comparer); - - foreach (var item in source) - { - var key = keySelector(item); - - var grouping = (Grouping) lookup.Find(key); - if (grouping == null) - { - grouping = new Grouping(key); - lookup.Add(grouping); - } - - grouping.Add(elementSelector(item)); - } - - return lookup; - } - - /// - /// Groups the elements of a sequence according to a specified key - /// selector function. - /// - - public static IEnumerable> GroupBy( - this IEnumerable source, - Func keySelector) - { - return GroupBy(source, keySelector, /* comparer */ null); - } - - /// - /// Groups the elements of a sequence according to a specified key - /// selector function and compares the keys by using a specified - /// comparer. - /// - - public static IEnumerable> GroupBy( - this IEnumerable source, - Func keySelector, - IEqualityComparer comparer) - { - return GroupBy(source, keySelector, e => e, comparer); - } - - /// - /// Groups the elements of a sequence according to a specified key - /// selector function and projects the elements for each group by - /// using a specified function. - /// - - public static IEnumerable> GroupBy( - this IEnumerable source, - Func keySelector, - Func elementSelector) - { - return GroupBy(source, keySelector, elementSelector, /* comparer */ null); - } - - /// - /// Groups the elements of a sequence according to a specified key - /// selector function and creates a result value from each group and - /// its key. - /// - - public static IEnumerable> GroupBy( - this IEnumerable source, - Func keySelector, - Func elementSelector, - IEqualityComparer comparer) - { - CheckNotNull(source, "source"); - CheckNotNull(keySelector, "keySelector"); - CheckNotNull(elementSelector, "elementSelector"); - - return ToLookup(source, keySelector, elementSelector, comparer); - } - - /// - /// Groups the elements of a sequence according to a key selector - /// function. The keys are compared by using a comparer and each - /// group's elements are projected by using a specified function. - /// - - public static IEnumerable GroupBy( - this IEnumerable source, - Func keySelector, - Func, TResult> resultSelector) - { - return GroupBy(source, keySelector, resultSelector, /* comparer */ null); - } - - /// - /// Groups the elements of a sequence according to a specified key - /// selector function and creates a result value from each group and - /// its key. The elements of each group are projected by using a - /// specified function. - /// - - public static IEnumerable GroupBy( - this IEnumerable source, - Func keySelector, - Func, TResult> resultSelector, - IEqualityComparer comparer) - { - CheckNotNull(source, "source"); - CheckNotNull(keySelector, "keySelector"); - CheckNotNull(resultSelector, "resultSelector"); - - return ToLookup(source, keySelector, comparer).Select(g => resultSelector(g.Key, g)); - } - - /// - /// Groups the elements of a sequence according to a specified key - /// selector function and creates a result value from each group and - /// its key. The keys are compared by using a specified comparer. - /// - - public static IEnumerable GroupBy( - this IEnumerable source, - Func keySelector, - Func elementSelector, - Func, TResult> resultSelector) - { - return GroupBy(source, keySelector, elementSelector, resultSelector, /* comparer */ null); - } - - /// - /// Groups the elements of a sequence according to a specified key - /// selector function and creates a result value from each group and - /// its key. Key values are compared by using a specified comparer, - /// and the elements of each group are projected by using a - /// specified function. - /// - - public static IEnumerable GroupBy( - this IEnumerable source, - Func keySelector, - Func elementSelector, - Func, TResult> resultSelector, - IEqualityComparer comparer) - { - CheckNotNull(source, "source"); - CheckNotNull(keySelector, "keySelector"); - CheckNotNull(elementSelector, "elementSelector"); - CheckNotNull(resultSelector, "resultSelector"); - - return ToLookup(source, keySelector, elementSelector, comparer) - .Select(g => resultSelector(g.Key, g)); - } - - /// - /// Applies an accumulator function over a sequence. - /// - - public static TSource Aggregate( - this IEnumerable source, - Func func) - { - CheckNotNull(source, "source"); - CheckNotNull(func, "func"); - - using (var e = source.GetEnumerator()) - { - if (!e.MoveNext()) - throw new InvalidOperationException(); - - return e.Renumerable().Skip(1).Aggregate(e.Current, func); - } - } - - /// - /// Applies an accumulator function over a sequence. The specified - /// seed value is used as the initial accumulator value. - /// - - public static TAccumulate Aggregate( - this IEnumerable source, - TAccumulate seed, - Func func) - { - return Aggregate(source, seed, func, r => r); - } - - /// - /// Applies an accumulator function over a sequence. The specified - /// seed value is used as the initial accumulator value, and the - /// specified function is used to select the result value. - /// - - public static TResult Aggregate( - this IEnumerable source, - TAccumulate seed, - Func func, - Func resultSelector) - { - CheckNotNull(source, "source"); - CheckNotNull(func, "func"); - CheckNotNull(resultSelector, "resultSelector"); - - var result = seed; - - foreach (var item in source) - result = func(result, item); - - return resultSelector(result); - } - - /// - /// Produces the set union of two sequences by using the default - /// equality comparer. - /// - - public static IEnumerable Union( - this IEnumerable first, - IEnumerable second) - { - return Union(first, second, /* comparer */ null); - } - - /// - /// Produces the set union of two sequences by using a specified - /// . - /// - - public static IEnumerable Union( - this IEnumerable first, - IEnumerable second, - IEqualityComparer comparer) - { - return first.Concat(second).Distinct(comparer); - } - - /// - /// Returns the elements of the specified sequence or the type - /// parameter's default value in a singleton collection if the - /// sequence is empty. - /// - - public static IEnumerable DefaultIfEmpty( - this IEnumerable source) - { - return source.DefaultIfEmpty(default(TSource)); - } - - /// - /// Returns the elements of the specified sequence or the specified - /// value in a singleton collection if the sequence is empty. - /// - - public static IEnumerable DefaultIfEmpty( - this IEnumerable source, - TSource defaultValue) - { - CheckNotNull(source, "source"); - - return DefaultIfEmptyYield(source, defaultValue); - } - - private static IEnumerable DefaultIfEmptyYield( - IEnumerable source, - TSource defaultValue) - { - using (var e = source.GetEnumerator()) - { - if (!e.MoveNext()) - yield return defaultValue; - else - do - { - yield return e.Current; - } while (e.MoveNext()); - } - } - - /// - /// Determines whether all elements of a sequence satisfy a condition. - /// - - public static bool All( - this IEnumerable source, - Func predicate) - { - CheckNotNull(source, "source"); - CheckNotNull(predicate, "predicate"); - - foreach (var item in source) - if (!predicate(item)) - return false; - - return true; - } - - /// - /// Determines whether a sequence contains any elements. - /// - - public static bool Any( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - using (var e = source.GetEnumerator()) - return e.MoveNext(); - } - - /// - /// Determines whether any element of a sequence satisfies a - /// condition. - /// - - public static bool Any( - this IEnumerable source, - Func predicate) - { - foreach (TSource item in source) - { - if (predicate(item)) - { - return true; - } - } - - return false; - } - - /// - /// Determines whether a sequence contains a specified element by - /// using the default equality comparer. - /// - - public static bool Contains( - this IEnumerable source, - TSource value) - { - return source.Contains(value, /* comparer */ null); - } - - /// - /// Determines whether a sequence contains a specified element by - /// using a specified . - /// - - public static bool Contains( - this IEnumerable source, - TSource value, - IEqualityComparer comparer) - { - CheckNotNull(source, "source"); - - if (comparer == null) - { - var collection = source as ICollection; - if (collection != null) - return collection.Contains(value); - } - - comparer = comparer ?? EqualityComparer.Default; - return source.Any(item => comparer.Equals(item, value)); - } - - /// - /// Determines whether two sequences are equal by comparing the - /// elements by using the default equality comparer for their type. - /// - - public static bool SequenceEqual( - this IEnumerable first, - IEnumerable second) - { - return first.SequenceEqual(second, /* comparer */ null); - } - - /// - /// Determines whether two sequences are equal by comparing their - /// elements by using a specified . - /// - - public static bool SequenceEqual( - this IEnumerable first, - IEnumerable second, - IEqualityComparer comparer) - { - CheckNotNull(first, "first"); - CheckNotNull(second, "second"); - - comparer = comparer ?? EqualityComparer.Default; - - using (IEnumerator lhs = first.GetEnumerator(), - rhs = second.GetEnumerator()) - { - do - { - if (!lhs.MoveNext()) - return !rhs.MoveNext(); - - if (!rhs.MoveNext()) - return false; - } while (comparer.Equals(lhs.Current, rhs.Current)); - } - - return false; - } - - /// - /// Base implementation for Min/Max operator. - /// - - private static TSource MinMaxImpl( - this IEnumerable source, - Func lesser) - { - CheckNotNull(source, "source"); - MiscellaneousUtils.Assert(lesser != null); - - return source.Aggregate((a, item) => lesser(a, item) ? a : item); - } - - /// - /// Base implementation for Min/Max operator for nullable types. - /// - - private static TSource? MinMaxImpl( - this IEnumerable source, - TSource? seed, Func lesser) where TSource : struct - { - CheckNotNull(source, "source"); - MiscellaneousUtils.Assert(lesser != null); - - return source.Aggregate(seed, (a, item) => lesser(a, item) ? a : item); - // == MinMaxImpl(Repeat(null, 1).Concat(source), lesser); - } - - /// - /// Returns the minimum value in a generic sequence. - /// - - public static TSource Min( - this IEnumerable source) - { - var comparer = Comparer.Default; - return source.MinMaxImpl((x, y) => comparer.Compare(x, y) < 0); - } - - /// - /// Invokes a transform function on each element of a generic - /// sequence and returns the minimum resulting value. - /// - - public static TResult Min( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Min(); - } - - /// - /// Returns the maximum value in a generic sequence. - /// - - public static TSource Max( - this IEnumerable source) - { - var comparer = Comparer.Default; - return source.MinMaxImpl((x, y) => comparer.Compare(x, y) > 0); - } - - /// - /// Invokes a transform function on each element of a generic - /// sequence and returns the maximum resulting value. - /// - - public static TResult Max( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Max(); - } - - /// - /// Makes an enumerator seen as enumerable once more. - /// - /// - /// The supplied enumerator must have been started. The first element - /// returned is the element the enumerator was on when passed in. - /// DO NOT use this method if the caller must be a generator. It is - /// mostly safe among aggregate operations. - /// - - private static IEnumerable Renumerable(this IEnumerator e) - { - MiscellaneousUtils.Assert(e != null); - - do - { - yield return e.Current; - } while (e.MoveNext()); - } - - /// - /// Sorts the elements of a sequence in ascending order according to a key. - /// - - public static IOrderedEnumerable OrderBy( - this IEnumerable source, - Func keySelector) - { - return source.OrderBy(keySelector, /* comparer */ null); - } - - /// - /// Sorts the elements of a sequence in ascending order by using a - /// specified comparer. - /// - - public static IOrderedEnumerable OrderBy( - this IEnumerable source, - Func keySelector, - IComparer comparer) - { - CheckNotNull(source, "source"); - CheckNotNull(keySelector, "keySelector"); - - return new OrderedEnumerable(source, keySelector, comparer, /* descending */ false); - } - - /// - /// Sorts the elements of a sequence in descending order according to a key. - /// - - public static IOrderedEnumerable OrderByDescending( - this IEnumerable source, - Func keySelector) - { - return source.OrderByDescending(keySelector, /* comparer */ null); - } - - /// - /// Sorts the elements of a sequence in descending order by using a - /// specified comparer. - /// - - public static IOrderedEnumerable OrderByDescending( - this IEnumerable source, - Func keySelector, - IComparer comparer) - { - CheckNotNull(source, "source"); - CheckNotNull(source, "keySelector"); - - return new OrderedEnumerable(source, keySelector, comparer, /* descending */ true); - } - - /// - /// Performs a subsequent ordering of the elements in a sequence in - /// ascending order according to a key. - /// - - public static IOrderedEnumerable ThenBy( - this IOrderedEnumerable source, - Func keySelector) - { - return source.ThenBy(keySelector, /* comparer */ null); - } - - /// - /// Performs a subsequent ordering of the elements in a sequence in - /// ascending order by using a specified comparer. - /// - - public static IOrderedEnumerable ThenBy( - this IOrderedEnumerable source, - Func keySelector, - IComparer comparer) - { - CheckNotNull(source, "source"); - - return source.CreateOrderedEnumerable(keySelector, comparer, /* descending */ false); - } - - /// - /// Performs a subsequent ordering of the elements in a sequence in - /// descending order, according to a key. - /// - - public static IOrderedEnumerable ThenByDescending( - this IOrderedEnumerable source, - Func keySelector) - { - return source.ThenByDescending(keySelector, /* comparer */ null); - } - - /// - /// Performs a subsequent ordering of the elements in a sequence in - /// descending order by using a specified comparer. - /// - - public static IOrderedEnumerable ThenByDescending( - this IOrderedEnumerable source, - Func keySelector, - IComparer comparer) - { - CheckNotNull(source, "source"); - - return source.CreateOrderedEnumerable(keySelector, comparer, /* descending */ true); - } - - /// - /// Base implementation for Intersect and Except operators. - /// - - private static IEnumerable IntersectExceptImpl( - this IEnumerable first, - IEnumerable second, - IEqualityComparer comparer, - bool flag) - { - CheckNotNull(first, "first"); - CheckNotNull(second, "second"); - - var keys = new List(); - var flags = new Dictionary(comparer); - - foreach (var item in first.Where(k => !flags.ContainsKey(k))) - { - flags.Add(item, !flag); - keys.Add(item); - } - - foreach (var item in second.Where(flags.ContainsKey)) - flags[item] = flag; - - // - // As per docs, "the marked elements are yielded in the order in - // which they were collected. - // - - return keys.Where(item => flags[item]); - } - - /// - /// Produces the set intersection of two sequences by using the - /// default equality comparer to compare values. - /// - - public static IEnumerable Intersect( - this IEnumerable first, - IEnumerable second) - { - return first.Intersect(second, /* comparer */ null); - } - - /// - /// Produces the set intersection of two sequences by using the - /// specified to compare values. - /// - - public static IEnumerable Intersect( - this IEnumerable first, - IEnumerable second, - IEqualityComparer comparer) - { - return IntersectExceptImpl(first, second, comparer, /* flag */ true); - } - - /// - /// Produces the set difference of two sequences by using the - /// default equality comparer to compare values. - /// - - public static IEnumerable Except( - this IEnumerable first, - IEnumerable second) - { - return first.Except(second, /* comparer */ null); - } - - /// - /// Produces the set difference of two sequences by using the - /// specified to compare values. - /// - - public static IEnumerable Except( - this IEnumerable first, - IEnumerable second, - IEqualityComparer comparer) - { - return IntersectExceptImpl(first, second, comparer, /* flag */ false); - } - - /// - /// Creates a from an - /// according to a specified key - /// selector function. - /// - - public static Dictionary ToDictionary( - this IEnumerable source, - Func keySelector) - { - return source.ToDictionary(keySelector, /* comparer */ null); - } - - /// - /// Creates a from an - /// according to a specified key - /// selector function and key comparer. - /// - - public static Dictionary ToDictionary( - this IEnumerable source, - Func keySelector, - IEqualityComparer comparer) - { - return source.ToDictionary(keySelector, e => e); - } - - /// - /// Creates a from an - /// according to specified key - /// selector and element selector functions. - /// - - public static Dictionary ToDictionary( - this IEnumerable source, - Func keySelector, - Func elementSelector) - { - return source.ToDictionary(keySelector, elementSelector, /* comparer */ null); - } - - /// - /// Creates a from an - /// according to a specified key - /// selector function, a comparer, and an element selector function. - /// - - public static Dictionary ToDictionary( - this IEnumerable source, - Func keySelector, - Func elementSelector, - IEqualityComparer comparer) - { - CheckNotNull(source, "source"); - CheckNotNull(keySelector, "keySelector"); - CheckNotNull(elementSelector, "elementSelector"); - - var dict = new Dictionary(comparer); - - foreach (var item in source) - { - // - // ToDictionary is meant to throw ArgumentNullException if - // keySelector produces a key that is null and - // Argument exception if keySelector produces duplicate keys - // for two elements. Incidentally, the documentation for - // IDictionary.Add says that the Add method - // throws the same exceptions under the same circumstances - // so we don't need to do any additional checking or work - // here and let the Add implementation do all the heavy - // lifting. - // - - dict.Add(keySelector(item), elementSelector(item)); - } - - return dict; - } - - /// - /// Correlates the elements of two sequences based on matching keys. - /// The default equality comparer is used to compare keys. - /// - - public static IEnumerable Join( - this IEnumerable outer, - IEnumerable inner, - Func outerKeySelector, - Func innerKeySelector, - Func resultSelector) - { - return outer.Join(inner, outerKeySelector, innerKeySelector, resultSelector, /* comparer */ null); - } - - /// - /// Correlates the elements of two sequences based on matching keys. - /// The default equality comparer is used to compare keys. A - /// specified is used to compare keys. - /// - - public static IEnumerable Join( - this IEnumerable outer, - IEnumerable inner, - Func outerKeySelector, - Func innerKeySelector, - Func resultSelector, - IEqualityComparer comparer) - { - CheckNotNull(outer, "outer"); - CheckNotNull(inner, "inner"); - CheckNotNull(outerKeySelector, "outerKeySelector"); - CheckNotNull(innerKeySelector, "innerKeySelector"); - CheckNotNull(resultSelector, "resultSelector"); - - var lookup = inner.ToLookup(innerKeySelector, comparer); - - return - from o in outer - from i in lookup[outerKeySelector(o)] - select resultSelector(o, i); - } - - /// - /// Correlates the elements of two sequences based on equality of - /// keys and groups the results. The default equality comparer is - /// used to compare keys. - /// - - public static IEnumerable GroupJoin( - this IEnumerable outer, - IEnumerable inner, - Func outerKeySelector, - Func innerKeySelector, - Func, TResult> resultSelector) - { - return outer.GroupJoin(inner, outerKeySelector, innerKeySelector, resultSelector, /* comparer */ null); - } - - /// - /// Correlates the elements of two sequences based on equality of - /// keys and groups the results. The default equality comparer is - /// used to compare keys. A specified - /// is used to compare keys. - /// - - public static IEnumerable GroupJoin( - this IEnumerable outer, - IEnumerable inner, - Func outerKeySelector, - Func innerKeySelector, - Func, TResult> resultSelector, - IEqualityComparer comparer) - { - CheckNotNull(outer, "outer"); - CheckNotNull(inner, "inner"); - CheckNotNull(outerKeySelector, "outerKeySelector"); - CheckNotNull(innerKeySelector, "innerKeySelector"); - CheckNotNull(resultSelector, "resultSelector"); - - var lookup = inner.ToLookup(innerKeySelector, comparer); - return outer.Select(o => resultSelector(o, lookup[outerKeySelector(o)])); - } - - [DebuggerStepThrough] - private static void CheckNotNull(T value, string name) where T : class - { - if (value == null) - throw new ArgumentNullException(name); - } - - private static class Sequence - { - public static readonly IEnumerable Empty = new T[0]; - } - - private sealed class Grouping : List, IGrouping - { - internal Grouping(K key) - { - Key = key; - } - - public K Key { get; private set; } - } - } - - internal partial class Enumerable - { - /// - /// Computes the sum of a sequence of values. - /// - - public static int Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - int sum = 0; - foreach (var num in source) - sum = checked(sum + num); - - return sum; - } - - /// - /// Computes the sum of a sequence of - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static int Sum( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Sum(); - } - - /// - /// Computes the average of a sequence of values. - /// - - public static double Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - long sum = 0; - long count = 0; - - foreach (var num in source) - checked - { - sum += (int) num; - count++; - } - - if (count == 0) - throw new InvalidOperationException(); - - return (double) sum/count; - } - - /// - /// Computes the average of a sequence of values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static double Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - - /// - /// Computes the sum of a sequence of nullable values. - /// - - public static int? Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - int sum = 0; - foreach (var num in source) - sum = checked(sum + (num ?? 0)); - - return sum; - } - - /// - /// Computes the sum of a sequence of nullable - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static int? Sum( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Sum(); - } - - /// - /// Computes the average of a sequence of nullable values. - /// - - public static double? Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - long sum = 0; - long count = 0; - - foreach (var num in source.Where(n => n != null)) - checked - { - sum += (int) num; - count++; - } - - if (count == 0) - return null; - - return (double?) sum/count; - } - - /// - /// Computes the average of a sequence of nullable values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static double? Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - /// - /// Returns the minimum value in a sequence of nullable - /// values. - /// - - public static int? Min( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), null, (min, x) => min < x); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the minimum nullable value. - /// - - public static int? Min( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Min(); - } - - /// - /// Returns the maximum value in a sequence of nullable - /// values. - /// - - public static int? Max( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), - null, (max, x) => x == null || (max != null && x.Value < max.Value)); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the maximum nullable value. - /// - - public static int? Max( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Max(); - } - - /// - /// Computes the sum of a sequence of values. - /// - - public static long Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - long sum = 0; - foreach (var num in source) - sum = checked(sum + num); - - return sum; - } - - /// - /// Computes the sum of a sequence of - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static long Sum( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Sum(); - } - - /// - /// Computes the average of a sequence of values. - /// - - public static double Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - long sum = 0; - long count = 0; - - foreach (var num in source) - checked - { - sum += (long) num; - count++; - } - - if (count == 0) - throw new InvalidOperationException(); - - return (double) sum/count; - } - - /// - /// Computes the average of a sequence of values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static double Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - - /// - /// Computes the sum of a sequence of nullable values. - /// - - public static long? Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - long sum = 0; - foreach (var num in source) - sum = checked(sum + (num ?? 0)); - - return sum; - } - - /// - /// Computes the sum of a sequence of nullable - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static long? Sum( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Sum(); - } - - /// - /// Computes the average of a sequence of nullable values. - /// - - public static double? Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - long sum = 0; - long count = 0; - - foreach (var num in source.Where(n => n != null)) - checked - { - sum += (long) num; - count++; - } - - if (count == 0) - return null; - - return (double?) sum/count; - } - - /// - /// Computes the average of a sequence of nullable values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static double? Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - /// - /// Returns the minimum value in a sequence of nullable - /// values. - /// - - public static long? Min( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), null, (min, x) => min < x); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the minimum nullable value. - /// - - public static long? Min( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Min(); - } - - /// - /// Returns the maximum value in a sequence of nullable - /// values. - /// - - public static long? Max( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), - null, (max, x) => x == null || (max != null && x.Value < max.Value)); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the maximum nullable value. - /// - - public static long? Max( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Max(); - } - - /// - /// Computes the sum of a sequence of nullable values. - /// - - public static float Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - float sum = 0; - foreach (var num in source) - sum = checked(sum + num); - - return sum; - } - - /// - /// Computes the sum of a sequence of - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static float Sum( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Sum(); - } - - /// - /// Computes the average of a sequence of values. - /// - - public static float Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - float sum = 0; - long count = 0; - - foreach (var num in source) - checked - { - sum += (float) num; - count++; - } - - if (count == 0) - throw new InvalidOperationException(); - - return (float) sum/count; - } - - /// - /// Computes the average of a sequence of values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static float Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - - /// - /// Computes the sum of a sequence of nullable values. - /// - - public static float? Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - float sum = 0; - foreach (var num in source) - sum = checked(sum + (num ?? 0)); - - return sum; - } - - /// - /// Computes the sum of a sequence of nullable - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static float? Sum( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Sum(); - } - - /// - /// Computes the average of a sequence of nullable values. - /// - - public static float? Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - float sum = 0; - long count = 0; - - foreach (var num in source.Where(n => n != null)) - checked - { - sum += (float) num; - count++; - } - - if (count == 0) - return null; - - return (float?) sum/count; - } - - /// - /// Computes the average of a sequence of nullable values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static float? Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - /// - /// Returns the minimum value in a sequence of nullable - /// values. - /// - - public static float? Min( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), null, (min, x) => min < x); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the minimum nullable value. - /// - - public static float? Min( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Min(); - } - - /// - /// Returns the maximum value in a sequence of nullable - /// values. - /// - - public static float? Max( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), - null, (max, x) => x == null || (max != null && x.Value < max.Value)); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the maximum nullable value. - /// - - public static float? Max( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Max(); - } - - /// - /// Computes the sum of a sequence of values. - /// - - public static double Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - double sum = 0; - foreach (var num in source) - sum = checked(sum + num); - - return sum; - } - - /// - /// Computes the sum of a sequence of - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static double Sum( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Sum(); - } - - /// - /// Computes the average of a sequence of values. - /// - - public static double Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - double sum = 0; - long count = 0; - - foreach (var num in source) - checked - { - sum += (double) num; - count++; - } - - if (count == 0) - throw new InvalidOperationException(); - - return (double) sum/count; - } - - /// - /// Computes the average of a sequence of values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static double Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - - /// - /// Computes the sum of a sequence of nullable values. - /// - - public static double? Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - double sum = 0; - foreach (var num in source) - sum = checked(sum + (num ?? 0)); - - return sum; - } - - /// - /// Computes the sum of a sequence of nullable - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static double? Sum( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Sum(); - } - - /// - /// Computes the average of a sequence of nullable values. - /// - - public static double? Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - double sum = 0; - long count = 0; - - foreach (var num in source.Where(n => n != null)) - checked - { - sum += (double) num; - count++; - } - - if (count == 0) - return null; - - return (double?) sum/count; - } - - /// - /// Computes the average of a sequence of nullable values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static double? Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - /// - /// Returns the minimum value in a sequence of nullable - /// values. - /// - - public static double? Min( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), null, (min, x) => min < x); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the minimum nullable value. - /// - - public static double? Min( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Min(); - } - - /// - /// Returns the maximum value in a sequence of nullable - /// values. - /// - - public static double? Max( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), - null, (max, x) => x == null || (max != null && x.Value < max.Value)); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the maximum nullable value. - /// - - public static double? Max( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Max(); - } - - /// - /// Computes the sum of a sequence of values. - /// - - public static decimal Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - decimal sum = 0; - foreach (var num in source) - sum = checked(sum + num); - - return sum; - } - - /// - /// Computes the sum of a sequence of - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static decimal Sum( - this IEnumerable source, - Func selector) - { - CheckNotNull(source, "source"); - CheckNotNull(selector, "selector"); - - decimal sum = 0; - foreach (TSource item in source) - { - sum += selector(item); - } - - return sum; - } - - /// - /// Computes the average of a sequence of values. - /// - - public static decimal Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - decimal sum = 0; - long count = 0; - - foreach (var num in source) - checked - { - sum += (decimal) num; - count++; - } - - if (count == 0) - throw new InvalidOperationException(); - - return (decimal) sum/count; - } - - /// - /// Computes the average of a sequence of values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static decimal Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - - /// - /// Computes the sum of a sequence of nullable values. - /// - - public static decimal? Sum( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - decimal sum = 0; - foreach (var num in source) - sum = checked(sum + (num ?? 0)); - - return sum; - } - - /// - /// Computes the sum of a sequence of nullable - /// values that are obtained by invoking a transform function on - /// each element of the input sequence. - /// - - public static decimal? Sum( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Sum(); - } - - /// - /// Computes the average of a sequence of nullable values. - /// - - public static decimal? Average( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - decimal sum = 0; - long count = 0; - - foreach (var num in source.Where(n => n != null)) - checked - { - sum += (decimal) num; - count++; - } - - if (count == 0) - return null; - - return (decimal?) sum/count; - } - - /// - /// Computes the average of a sequence of nullable values - /// that are obtained by invoking a transform function on each - /// element of the input sequence. - /// - - public static decimal? Average( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Average(); - } - - /// - /// Returns the minimum value in a sequence of nullable - /// values. - /// - - public static decimal? Min( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), null, (min, x) => min < x); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the minimum nullable value. - /// - - public static decimal? Min( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Min(); - } - - /// - /// Returns the maximum value in a sequence of nullable - /// values. - /// - - public static decimal? Max( - this IEnumerable source) - { - CheckNotNull(source, "source"); - - return MinMaxImpl(source.Where(x => x != null), - null, (max, x) => x == null || (max != null && x.Value < max.Value)); - } - - /// - /// Invokes a transform function on each element of a sequence and - /// returns the maximum nullable value. - /// - - public static decimal? Max( - this IEnumerable source, - Func selector) - { - return source.Select(selector).Max(); - } - } - - /// - /// Represents a collection of objects that have a common key. - /// - internal partial interface IGrouping : IEnumerable - { - /// - /// Gets the key of the . - /// - - TKey Key { get; } - } - - /// - /// Defines an indexer, size property, and Boolean search method for - /// data structures that map keys to - /// sequences of values. - /// - internal partial interface ILookup : IEnumerable> - { - bool Contains(TKey key); - int Count { get; } - IEnumerable this[TKey key] { get; } - } - - /// - /// Represents a sorted sequence. - /// - internal partial interface IOrderedEnumerable : IEnumerable - { - /// - /// Performs a subsequent ordering on the elements of an - /// according to a key. - /// - - IOrderedEnumerable CreateOrderedEnumerable( - Func keySelector, IComparer comparer, bool descending); - } - - /// - /// Represents a collection of keys each mapped to one or more values. - /// - internal sealed class Lookup : ILookup - { - private readonly Dictionary> _map; - - internal Lookup(IEqualityComparer comparer) - { - _map = new Dictionary>(comparer); - } - - internal void Add(IGrouping item) - { - _map.Add(item.Key, item); - } - - internal IEnumerable Find(TKey key) - { - IGrouping grouping; - return _map.TryGetValue(key, out grouping) ? grouping : null; - } - - /// - /// Gets the number of key/value collection pairs in the . - /// - - public int Count => _map.Count; - - /// - /// Gets the collection of values indexed by the specified key. - /// - - public IEnumerable this[TKey key] - { - get - { - IGrouping result; - return _map.TryGetValue(key, out result) ? result : Enumerable.Empty(); - } - } - - /// - /// Determines whether a specified key is in the . - /// - - public bool Contains(TKey key) - { - return _map.ContainsKey(key); - } - - /// - /// Applies a transform function to each key and its associated - /// values and returns the results. - /// - - public IEnumerable ApplyResultSelector( - Func, TResult> resultSelector) - { - if (resultSelector == null) - throw new ArgumentNullException("resultSelector"); - - foreach (var pair in _map) - yield return resultSelector(pair.Key, pair.Value); - } - - /// - /// Returns a generic enumerator that iterates through the . - /// - - public IEnumerator> GetEnumerator() - { - return _map.Values.GetEnumerator(); - } - - IEnumerator IEnumerable.GetEnumerator() - { - return GetEnumerator(); - } - } - - internal sealed class OrderedEnumerable : IOrderedEnumerable - { - private readonly IEnumerable _source; - private readonly List> _comparisons; - - public OrderedEnumerable(IEnumerable source, - Func keySelector, IComparer comparer, bool descending) : - this(source, null, keySelector, comparer, descending) - { - } - - private OrderedEnumerable(IEnumerable source, List> comparisons, - Func keySelector, IComparer comparer, bool descending) - { - if (source == null) throw new ArgumentNullException("source"); - if (keySelector == null) throw new ArgumentNullException("keySelector"); - - _source = source; - - comparer = comparer ?? Comparer.Default; - - if (comparisons == null) - comparisons = new List>( /* capacity */ 4); - - comparisons.Add((x, y) - => (descending ? -1 : 1)*comparer.Compare(keySelector(x), keySelector(y))); - - _comparisons = comparisons; - } - - public IOrderedEnumerable CreateOrderedEnumerable( - Func keySelector, IComparer comparer, bool descending) - { - return new OrderedEnumerable(_source, _comparisons, keySelector, comparer, descending); - } - - public IEnumerator GetEnumerator() - { - // - // We sort using List.Sort, but docs say that it performs an - // unstable sort. LINQ, on the other hand, says OrderBy performs - // a stable sort. So convert the source sequence into a sequence - // of tuples where the second element tags the position of the - // element from the source sequence (First). The position is - // then used as a tie breaker when all keys compare equal, - // thus making the sort stable. - // - - var list = _source.Select(new Func>(TagPosition)).ToList(); - - list.Sort((x, y) => - { - // - // Compare keys from left to right. - // - - var comparisons = _comparisons; - for (var i = 0; i < comparisons.Count; i++) - { - var result = comparisons[i](x.First, y.First); - if (result != 0) - return result; - } - - // - // All keys compared equal so now break the tie by their - // position in the original sequence, making the sort stable. - // - - return x.Second.CompareTo(y.Second); - }); - - return list.Select(new Func, T>(GetFirst)).GetEnumerator(); - - } - - /// - /// See issue #11 - /// for why this method is needed and cannot be expressed as a - /// lambda at the call site. - /// - - private static Tuple TagPosition(T e, int i) - { - return new Tuple(e, i); - } - - /// - /// See issue #11 - /// for why this method is needed and cannot be expressed as a - /// lambda at the call site. - /// - - private static T GetFirst(Tuple pv) - { - return pv.First; - } - - IEnumerator IEnumerable.GetEnumerator() - { - return GetEnumerator(); - } - } - - [Serializable] - internal readonly struct Tuple : IEquatable> - { - public TFirst First { get; } - public TSecond Second { get; } - - public Tuple(TFirst first, TSecond second) - : this() - { - First = first; - Second = second; - } - - public override bool Equals(object obj) - { - return obj != null - && obj is Tuple - && base.Equals((Tuple) obj); - } - - public bool Equals(Tuple other) - { - return EqualityComparer.Default.Equals(other.First, First) - && EqualityComparer.Default.Equals(other.Second, Second); - } - - public override int GetHashCode() - { - var num = 0x7a2f0b42; - num = (-1521134295*num) + EqualityComparer.Default.GetHashCode(First); - return (-1521134295*num) + EqualityComparer.Default.GetHashCode(Second); - } - - public override string ToString() - { - return string.Format(CultureInfo.InvariantCulture, @"{{ First = {0}, Second = {1} }}", First, Second); - } - } -} - -namespace Newtonsoft.Json.Serialization -{ -#pragma warning disable 1591 - public delegate TResult Func(); - - public delegate TResult Func(T a); - - public delegate TResult Func(T1 arg1, T2 arg2); - - public delegate TResult Func(T1 arg1, T2 arg2, T3 arg3); - - public delegate TResult Func(T1 arg1, T2 arg2, T3 arg3, T4 arg4); - - public delegate void Action(); - - public delegate void Action(T1 arg1, T2 arg2); - - public delegate void Action(T1 arg1, T2 arg2, T3 arg3); - - public delegate void Action(T1 arg1, T2 arg2, T3 arg3, T4 arg4); -#pragma warning restore 1591 -} - -namespace System.Runtime.CompilerServices -{ - /// - /// This attribute allows us to define extension methods without - /// requiring .NET Framework 3.5. For more information, see the section, - /// Extension Methods in .NET Framework 2.0 Apps, - /// of Basic Instincts: Extension Methods - /// column in MSDN Magazine, - /// issue Nov 2007. - /// - - [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class | AttributeTargets.Assembly)] - internal sealed class ExtensionAttribute : Attribute { } -} - -#endif \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/MathUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/MathUtils.cs deleted file mode 100644 index 2818483..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/MathUtils.cs +++ /dev/null @@ -1,187 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Text; - -namespace Newtonsoft.Json.Utilities -{ - internal static class MathUtils - { - public static int IntLength(ulong i) - { - if (i < 10000000000) - { - if (i < 10) - { - return 1; - } - if (i < 100) - { - return 2; - } - if (i < 1000) - { - return 3; - } - if (i < 10000) - { - return 4; - } - if (i < 100000) - { - return 5; - } - if (i < 1000000) - { - return 6; - } - if (i < 10000000) - { - return 7; - } - if (i < 100000000) - { - return 8; - } - if (i < 1000000000) - { - return 9; - } - - return 10; - } - else - { - if (i < 100000000000) - { - return 11; - } - if (i < 1000000000000) - { - return 12; - } - if (i < 10000000000000) - { - return 13; - } - if (i < 100000000000000) - { - return 14; - } - if (i < 1000000000000000) - { - return 15; - } - if (i < 10000000000000000) - { - return 16; - } - if (i < 100000000000000000) - { - return 17; - } - if (i < 1000000000000000000) - { - return 18; - } - if (i < 10000000000000000000) - { - return 19; - } - - return 20; - } - } - - public static char IntToHex(int n) - { - if (n <= 9) - { - return (char)(n + 48); - } - - return (char)((n - 10) + 97); - } - - public static int? Min(int? val1, int? val2) - { - if (val1 == null) - { - return val2; - } - if (val2 == null) - { - return val1; - } - - return Math.Min(val1.GetValueOrDefault(), val2.GetValueOrDefault()); - } - - public static int? Max(int? val1, int? val2) - { - if (val1 == null) - { - return val2; - } - if (val2 == null) - { - return val1; - } - - return Math.Max(val1.GetValueOrDefault(), val2.GetValueOrDefault()); - } - - public static double? Max(double? val1, double? val2) - { - if (val1 == null) - { - return val2; - } - if (val2 == null) - { - return val1; - } - - return Math.Max(val1.GetValueOrDefault(), val2.GetValueOrDefault()); - } - - public static bool ApproxEquals(double d1, double d2) - { - const double epsilon = 2.2204460492503131E-16; - - if (d1 == d2) - { - return true; - } - - double tolerance = ((Math.Abs(d1) + Math.Abs(d2)) + 10.0) * epsilon; - double difference = d1 - d2; - - return (-tolerance < difference && tolerance > difference); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/MethodBinder.cs b/Source/MyDb/Newtonsoft.Json/Utilities/MethodBinder.cs deleted file mode 100644 index 541cfe5..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/MethodBinder.cs +++ /dev/null @@ -1,346 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using System.Reflection; - -namespace Newtonsoft.Json.Utilities -{ -#if PORTABLE - internal static class MethodBinder - { - - /// - /// List of primitive types which can be widened. - /// - private static readonly Type[] PrimitiveTypes = new Type[] - { - typeof(bool), typeof(char), typeof(sbyte), typeof(byte), - typeof(short), typeof(ushort), typeof(int), typeof(uint), - typeof(long), typeof(ulong), typeof(float), typeof(double) - }; - - /// - /// Widening masks for primitive types above. - /// Index of the value in this array defines a type we're widening, - /// while the bits in mask define types it can be widened to (including itself). - /// - /// For example, value at index 0 defines a bool type, and it only has bit 0 set, - /// i.e. bool values can be assigned only to bool. - /// - private static readonly int[] WideningMasks = new int[] - { - 0x0001, 0x0FE2, 0x0D54, 0x0FFA, - 0x0D50, 0x0FE2, 0x0D40, 0x0F80, - 0x0D00, 0x0E00, 0x0C00, 0x0800 - }; - - /// - /// Checks if value of primitive type can be - /// assigned to parameter of primitive type . - /// - /// Source primitive type. - /// Target primitive type. - /// true if source type can be widened to target type, false otherwise. - private static bool CanConvertPrimitive(Type from, Type to) - { - if (from == to) - { - // same type - return true; - } - - int fromMask = 0; - int toMask = 0; - - for (int i = 0; i < PrimitiveTypes.Length; i++) - { - if (PrimitiveTypes[i] == from) - { - fromMask = WideningMasks[i]; - } - else if (PrimitiveTypes[i] == to) - { - toMask = 1 << i; - } - - if (fromMask != 0 && toMask != 0) - { - break; - } - } - - return (fromMask & toMask) != 0; - } - - /// - /// Checks if a set of values with given can be used - /// to invoke a method with specified . - /// - /// Method parameters. - /// Argument types. - /// Try to pack extra arguments into the last parameter when it is marked up with . - /// true if method can be called with given arguments, false otherwise. - private static bool FilterParameters(ParameterInfo[] parameters, IList types, bool enableParamArray) - { - ValidationUtils.ArgumentNotNull(parameters, nameof(parameters)); - ValidationUtils.ArgumentNotNull(types, nameof(types)); - - if (parameters.Length == 0) - { - // fast check for parameterless methods - return types.Count == 0; - } - if (parameters.Length > types.Count) - { - // not all declared parameters were specified (optional parameters are not supported) - return false; - } - - // check if the last parameter is ParamArray - Type? paramArrayType = null; - - if (enableParamArray) - { - ParameterInfo lastParam = parameters[parameters.Length - 1]; - if (lastParam.ParameterType.IsArray && lastParam.IsDefined(typeof(ParamArrayAttribute))) - { - paramArrayType = lastParam.ParameterType.GetElementType(); - } - } - - if (paramArrayType == null && parameters.Length != types.Count) - { - // when there's no ParamArray, number of parameters should match - return false; - } - - for (int i = 0; i < types.Count; i++) - { - Type paramType = (paramArrayType != null && i >= parameters.Length - 1) ? paramArrayType : parameters[i].ParameterType; - - if (paramType == types[i]) - { - // exact match with provided type - continue; - } - - if (paramType == typeof(object)) - { - // parameter of type object matches anything - continue; - } - - if (paramType.IsPrimitive()) - { - if (!types[i].IsPrimitive() || !CanConvertPrimitive(types[i], paramType)) - { - // primitive parameter can only be assigned from compatible primitive type - return false; - } - } - else - { - if (!paramType.IsAssignableFrom(types[i])) - { - return false; - } - } - } - - return true; - } - - /// - /// Compares two sets of parameters to determine - /// which one suits better for given argument types. - /// - private class ParametersMatchComparer : IComparer - { - private readonly IList _types; - private readonly bool _enableParamArray; - - public ParametersMatchComparer(IList types, bool enableParamArray) - { - ValidationUtils.ArgumentNotNull(types, nameof(types)); - - _types = types; - _enableParamArray = enableParamArray; - } - - public int Compare(ParameterInfo[] parameters1, ParameterInfo[] parameters2) - { - ValidationUtils.ArgumentNotNull(parameters1, nameof(parameters1)); - ValidationUtils.ArgumentNotNull(parameters2, nameof(parameters2)); - - // parameterless method wins - if (parameters1.Length == 0) - { - return -1; - } - if (parameters2.Length == 0) - { - return 1; - } - - Type? paramArrayType1 = null, paramArrayType2 = null; - - if (_enableParamArray) - { - ParameterInfo lastParam1 = parameters1[parameters1.Length - 1]; - if (lastParam1.ParameterType.IsArray && lastParam1.IsDefined(typeof(ParamArrayAttribute))) - { - paramArrayType1 = lastParam1.ParameterType.GetElementType(); - } - - ParameterInfo lastParam2 = parameters2[parameters2.Length - 1]; - if (lastParam2.ParameterType.IsArray && lastParam2.IsDefined(typeof(ParamArrayAttribute))) - { - paramArrayType2 = lastParam2.ParameterType.GetElementType(); - } - - // A method using params always loses to one not using params - if (paramArrayType1 != null && paramArrayType2 == null) - { - return 1; - } - if (paramArrayType2 != null && paramArrayType1 == null) - { - return -1; - } - } - - for (int i = 0; i < _types.Count; i++) - { - Type type1 = (paramArrayType1 != null && i >= parameters1.Length - 1) ? paramArrayType1 : parameters1[i].ParameterType; - Type type2 = (paramArrayType2 != null && i >= parameters2.Length - 1) ? paramArrayType2 : parameters2[i].ParameterType; - - if (type1 == type2) - { - // exact match between parameter types doesn't change score - continue; - } - - // exact match with source type decides winner immediately - if (type1 == _types[i]) - { - return -1; - } - if (type2 == _types[i]) - { - return 1; - } - - int r = ChooseMorePreciseType(type1, type2); - if (r != 0) - { - // winner decided - return r; - } - } - - return 0; - } - - private static int ChooseMorePreciseType(Type type1, Type type2) - { - if (type1.IsByRef || type2.IsByRef) - { - if (type1.IsByRef && type2.IsByRef) - { - type1 = type1.GetElementType(); - type2 = type2.GetElementType(); - } - else if (type1.IsByRef) - { - type1 = type1.GetElementType(); - if (type1 == type2) - { - return 1; - } - } - else - { - type2 = type2.GetElementType(); - if (type2 == type1) - { - return -1; - } - } - } - - bool c1FromC2, c2FromC1; - - if (type1.IsPrimitive() && type2.IsPrimitive()) - { - c1FromC2 = CanConvertPrimitive(type2, type1); - c2FromC1 = CanConvertPrimitive(type1, type2); - } - else - { - c1FromC2 = type1.IsAssignableFrom(type2); - c2FromC1 = type2.IsAssignableFrom(type1); - } - - if (c1FromC2 == c2FromC1) - { - return 0; - } - - return c1FromC2 ? 1 : -1; - } - - } - - /// - /// Returns a best method overload for given argument . - /// - /// List of method candidates. - /// Argument types. - /// Best method overload, or null if none matched. - public static TMethod SelectMethod(IEnumerable candidates, IList types) where TMethod : MethodBase - { - ValidationUtils.ArgumentNotNull(candidates, nameof(candidates)); - ValidationUtils.ArgumentNotNull(types, nameof(types)); - - // ParamArrays are not supported by ReflectionDelegateFactory - // They will be treated like ordinary array arguments - const bool enableParamArray = false; - - return candidates - .Where(m => FilterParameters(m.GetParameters(), types, enableParamArray)) - .OrderBy(m => m.GetParameters(), new ParametersMatchComparer(types, enableParamArray)) - .FirstOrDefault(); - } - - } -#endif -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/MethodCall.cs b/Source/MyDb/Newtonsoft.Json/Utilities/MethodCall.cs deleted file mode 100644 index 745a207..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/MethodCall.cs +++ /dev/null @@ -1,29 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace Newtonsoft.Json.Utilities -{ - internal delegate TResult MethodCall(T target, params object?[] args); -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/MiscellaneousUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/MiscellaneousUtils.cs deleted file mode 100644 index 137ec44..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/MiscellaneousUtils.cs +++ /dev/null @@ -1,174 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections; -using System.Collections.Generic; -using System.ComponentModel; -using System.Reflection; -using System.Text; -using System.Globalization; -using System.Text.RegularExpressions; -using System.Diagnostics; -using System.Diagnostics.CodeAnalysis; - -namespace Newtonsoft.Json.Utilities -{ - internal delegate T Creator(); - - internal static class MiscellaneousUtils - { - [Conditional("DEBUG")] - public static void Assert([DoesNotReturnIf(false)] bool condition, string? message = null) - { - Debug.Assert(condition, message); - } - - public static bool ValueEquals(object? objA, object? objB) - { - if (objA == objB) - { - return true; - } - if (objA == null || objB == null) - { - return false; - } - - // comparing an Int32 and Int64 both of the same value returns false - // make types the same then compare - if (objA.GetType() != objB.GetType()) - { - if (ConvertUtils.IsInteger(objA) && ConvertUtils.IsInteger(objB)) - { - return Convert.ToDecimal(objA, CultureInfo.CurrentCulture).Equals(Convert.ToDecimal(objB, CultureInfo.CurrentCulture)); - } - else if ((objA is double || objA is float || objA is decimal) && (objB is double || objB is float || objB is decimal)) - { - return MathUtils.ApproxEquals(Convert.ToDouble(objA, CultureInfo.CurrentCulture), Convert.ToDouble(objB, CultureInfo.CurrentCulture)); - } - else - { - return false; - } - } - - return objA.Equals(objB); - } - - public static ArgumentOutOfRangeException CreateArgumentOutOfRangeException(string paramName, object actualValue, string message) - { - string newMessage = message + Environment.NewLine + @"Actual value was {0}.".FormatWith(CultureInfo.InvariantCulture, actualValue); - - return new ArgumentOutOfRangeException(paramName, newMessage); - } - - public static string ToString(object? value) - { - if (value == null) - { - return "{null}"; - } - - return (value is string s) ? @"""" + s + @"""" : value!.ToString(); - } - - public static int ByteArrayCompare(byte[] a1, byte[] a2) - { - int lengthCompare = a1.Length.CompareTo(a2.Length); - if (lengthCompare != 0) - { - return lengthCompare; - } - - for (int i = 0; i < a1.Length; i++) - { - int valueCompare = a1[i].CompareTo(a2[i]); - if (valueCompare != 0) - { - return valueCompare; - } - } - - return 0; - } - - public static string? GetPrefix(string qualifiedName) - { - GetQualifiedNameParts(qualifiedName, out string? prefix, out _); - - return prefix; - } - - public static string GetLocalName(string qualifiedName) - { - GetQualifiedNameParts(qualifiedName, out _, out string localName); - - return localName; - } - - public static void GetQualifiedNameParts(string qualifiedName, out string? prefix, out string localName) - { - int colonPosition = qualifiedName.IndexOf(':'); - - if ((colonPosition == -1 || colonPosition == 0) || (qualifiedName.Length - 1) == colonPosition) - { - prefix = null; - localName = qualifiedName; - } - else - { - prefix = qualifiedName.Substring(0, colonPosition); - localName = qualifiedName.Substring(colonPosition + 1); - } - } - - internal static RegexOptions GetRegexOptions(string optionsText) - { - RegexOptions options = RegexOptions.None; - - for (int i = 0; i < optionsText.Length; i++) - { - switch (optionsText[i]) - { - case 'i': - options |= RegexOptions.IgnoreCase; - break; - case 'm': - options |= RegexOptions.Multiline; - break; - case 's': - options |= RegexOptions.Singleline; - break; - case 'x': - options |= RegexOptions.ExplicitCapture; - break; - } - } - - return options; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/NullableAttributes.cs b/Source/MyDb/Newtonsoft.Json/Utilities/NullableAttributes.cs deleted file mode 100644 index fa1f55e..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/NullableAttributes.cs +++ /dev/null @@ -1,74 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -namespace System.Diagnostics.CodeAnalysis -{ - /// Specifies that an output will not be null even if the corresponding type allows it. - [AttributeUsage(AttributeTargets.Field | AttributeTargets.Method | AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.ReturnValue, AllowMultiple = true)] - internal sealed class NotNullAttribute : Attribute { } - - /// Specifies that when a method returns , the parameter will not be null even if the corresponding type allows it. - [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false)] - internal sealed class NotNullWhenAttribute : Attribute - { - /// Initializes the attribute with the specified return value condition. - /// - /// The return value condition. If the method returns this value, the associated parameter will not be null. - /// - public NotNullWhenAttribute(bool returnValue) => ReturnValue = returnValue; - - /// Gets the return value condition. - public bool ReturnValue { get; } - } - - /// Specifies that an output may be null even if the corresponding type disallows it. - [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.ReturnValue, Inherited = false)] - internal sealed class MaybeNullAttribute : Attribute - { } - - /// Specifies that null is allowed as an input even if the corresponding type disallows it. - [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property, Inherited = false)] - internal sealed class AllowNullAttribute : Attribute - { } - - /// - /// Specifies that the method will not return if the associated Boolean parameter is passed the specified value. - /// - [AttributeUsage(AttributeTargets.Parameter, Inherited = false)] - internal class DoesNotReturnIfAttribute : Attribute - { - /// - /// Initializes a new instance of the class. - /// - /// - /// The condition parameter value. Code after the method will be considered unreachable by diagnostics if the argument to - /// the associated parameter matches this value. - /// - public DoesNotReturnIfAttribute(bool parameterValue) => this.ParameterValue = parameterValue; - - /// Gets the condition parameter value. - public bool ParameterValue { get; } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/ReflectionDelegateFactory.cs b/Source/MyDb/Newtonsoft.Json/Utilities/ReflectionDelegateFactory.cs deleted file mode 100644 index 6b2d4ee..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/ReflectionDelegateFactory.cs +++ /dev/null @@ -1,83 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Globalization; -using System.Reflection; -using Newtonsoft.Json.Serialization; - -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#endif - -namespace Newtonsoft.Json.Utilities -{ - internal abstract class ReflectionDelegateFactory - { - public Func CreateGet(MemberInfo memberInfo) - { - if (memberInfo is PropertyInfo propertyInfo) - { - // https://github.com/dotnet/corefx/issues/26053 - if (propertyInfo.PropertyType.IsByRef) - { - throw new InvalidOperationException("Could not create getter for {0}. ByRef return values are not supported.".FormatWith(CultureInfo.InvariantCulture, propertyInfo)); - } - - return CreateGet(propertyInfo); - } - - if (memberInfo is FieldInfo fieldInfo) - { - return CreateGet(fieldInfo); - } - - throw new Exception("Could not create getter for {0}.".FormatWith(CultureInfo.InvariantCulture, memberInfo)); - } - - public Action CreateSet(MemberInfo memberInfo) - { - if (memberInfo is PropertyInfo propertyInfo) - { - return CreateSet(propertyInfo); - } - - if (memberInfo is FieldInfo fieldInfo) - { - return CreateSet(fieldInfo); - } - - throw new Exception("Could not create setter for {0}.".FormatWith(CultureInfo.InvariantCulture, memberInfo)); - } - - public abstract MethodCall CreateMethodCall(MethodBase method); - public abstract ObjectConstructor CreateParameterizedConstructor(MethodBase method); - public abstract Func CreateDefaultConstructor(Type type); - public abstract Func CreateGet(PropertyInfo propertyInfo); - public abstract Func CreateGet(FieldInfo fieldInfo); - public abstract Action CreateSet(FieldInfo fieldInfo); - public abstract Action CreateSet(PropertyInfo propertyInfo); - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/ReflectionObject.cs b/Source/MyDb/Newtonsoft.Json/Utilities/ReflectionObject.cs deleted file mode 100644 index 1463416..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/ReflectionObject.cs +++ /dev/null @@ -1,156 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using Newtonsoft.Json.Serialization; -using System; -using System.Collections.Generic; -using System.Reflection; -using System.Globalization; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; - -#endif - -namespace Newtonsoft.Json.Utilities -{ - internal class ReflectionMember - { - public Type? MemberType { get; set; } - public Func? Getter { get; set; } - public Action? Setter { get; set; } - } - - internal class ReflectionObject - { - public ObjectConstructor? Creator { get; } - public IDictionary Members { get; } - - private ReflectionObject(ObjectConstructor? creator) - { - Members = new Dictionary(); - Creator = creator; - } - - public object? GetValue(object target, string member) - { - Func getter = Members[member].Getter!; - return getter(target); - } - - public void SetValue(object target, string member, object? value) - { - Action setter = Members[member].Setter!; - setter(target, value); - } - - public Type GetType(string member) - { - return Members[member].MemberType!; - } - - public static ReflectionObject Create(Type t, params string[] memberNames) - { - return Create(t, null, memberNames); - } - - public static ReflectionObject Create(Type t, MethodBase? creator, params string[] memberNames) - { - ReflectionDelegateFactory delegateFactory = JsonTypeReflector.ReflectionDelegateFactory; - - ObjectConstructor? creatorConstructor = null; - if (creator != null) - { - creatorConstructor = delegateFactory.CreateParameterizedConstructor(creator); - } - else - { - if (ReflectionUtils.HasDefaultConstructor(t, false)) - { - Func ctor = delegateFactory.CreateDefaultConstructor(t); - - creatorConstructor = args => ctor(); - } - } - - ReflectionObject d = new ReflectionObject(creatorConstructor); - - foreach (string memberName in memberNames) - { - MemberInfo[] members = t.GetMember(memberName, BindingFlags.Instance | BindingFlags.Public); - if (members.Length != 1) - { - throw new ArgumentException("Expected a single member with the name '{0}'.".FormatWith(CultureInfo.InvariantCulture, memberName)); - } - - MemberInfo member = members.Single(); - - ReflectionMember reflectionMember = new ReflectionMember(); - - switch (member.MemberType()) - { - case MemberTypes.Field: - case MemberTypes.Property: - if (ReflectionUtils.CanReadMemberValue(member, false)) - { - reflectionMember.Getter = delegateFactory.CreateGet(member); - } - - if (ReflectionUtils.CanSetMemberValue(member, false, false)) - { - reflectionMember.Setter = delegateFactory.CreateSet(member); - } - break; - case MemberTypes.Method: - MethodInfo method = (MethodInfo)member; - if (method.IsPublic) - { - ParameterInfo[] parameters = method.GetParameters(); - if (parameters.Length == 0 && method.ReturnType != typeof(void)) - { - MethodCall call = delegateFactory.CreateMethodCall(method); - reflectionMember.Getter = target => call(target); - } - else if (parameters.Length == 1 && method.ReturnType == typeof(void)) - { - MethodCall call = delegateFactory.CreateMethodCall(method); - reflectionMember.Setter = (target, arg) => call(target, arg); - } - } - break; - default: - throw new ArgumentException("Unexpected member type '{0}' for member '{1}'.".FormatWith(CultureInfo.InvariantCulture, member.MemberType(), member.Name)); - } - - reflectionMember.MemberType = ReflectionUtils.GetMemberUnderlyingType(member); - - d.Members[memberName] = reflectionMember; - } - - return d; - } - } -} diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/ReflectionUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/ReflectionUtils.cs deleted file mode 100644 index 5e09de1..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/ReflectionUtils.cs +++ /dev/null @@ -1,1096 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -#if HAVE_BIG_INTEGER -using System.Numerics; -#endif -using System.Reflection; -using System.Collections; -using System.Globalization; -using System.Text; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Utilities -{ -#if (DOTNET || PORTABLE || PORTABLE40) && !NETSTANDARD2_0 - [Flags] - internal enum MemberTypes - { - Event = 2, - Field = 4, - Method = 8, - Property = 16 - } -#endif - -#if PORTABLE && !NETSTANDARD2_0 - [Flags] - internal enum BindingFlags - { - Default = 0, - IgnoreCase = 1, - DeclaredOnly = 2, - Instance = 4, - Static = 8, - Public = 16, - NonPublic = 32, - FlattenHierarchy = 64, - InvokeMethod = 256, - CreateInstance = 512, - GetField = 1024, - SetField = 2048, - GetProperty = 4096, - SetProperty = 8192, - PutDispProperty = 16384, - ExactBinding = 65536, - PutRefDispProperty = 32768, - SuppressChangeType = 131072, - OptionalParamBinding = 262144, - IgnoreReturn = 16777216 - } -#endif - - internal static class ReflectionUtils - { - public static readonly Type[] EmptyTypes; - - static ReflectionUtils() - { -#if HAVE_EMPTY_TYPES - EmptyTypes = Type.EmptyTypes; -#else - EmptyTypes = CollectionUtils.ArrayEmpty(); -#endif - } - - public static bool IsVirtual(this PropertyInfo propertyInfo) - { - ValidationUtils.ArgumentNotNull(propertyInfo, nameof(propertyInfo)); - - MethodInfo? m = propertyInfo.GetGetMethod(true); - if (m != null && m.IsVirtual) - { - return true; - } - - m = propertyInfo.GetSetMethod(true); - if (m != null && m.IsVirtual) - { - return true; - } - - return false; - } - - public static MethodInfo? GetBaseDefinition(this PropertyInfo propertyInfo) - { - ValidationUtils.ArgumentNotNull(propertyInfo, nameof(propertyInfo)); - - MethodInfo? m = propertyInfo.GetGetMethod(true); - if (m != null) - { - return m.GetBaseDefinition(); - } - - return propertyInfo.GetSetMethod(true)?.GetBaseDefinition(); - } - - public static bool IsPublic(PropertyInfo property) - { - var getMethod = property.GetGetMethod(); - if (getMethod != null && getMethod.IsPublic) - { - return true; - } - var setMethod = property.GetSetMethod(); - if (setMethod != null && setMethod.IsPublic) - { - return true; - } - - return false; - } - - public static Type? GetObjectType(object? v) - { - return v?.GetType(); - } - - public static string GetTypeName(Type t, TypeNameAssemblyFormatHandling assemblyFormat, ISerializationBinder? binder) - { - string fullyQualifiedTypeName = GetFullyQualifiedTypeName(t, binder); - - switch (assemblyFormat) - { - case TypeNameAssemblyFormatHandling.Simple: - return RemoveAssemblyDetails(fullyQualifiedTypeName); - case TypeNameAssemblyFormatHandling.Full: - return fullyQualifiedTypeName; - default: - throw new ArgumentOutOfRangeException(); - } - } - - private static string GetFullyQualifiedTypeName(Type t, ISerializationBinder? binder) - { - if (binder != null) - { - binder.BindToName(t, out string? assemblyName, out string? typeName); -#if (NET20 || NET35) - // for older SerializationBinder implementations that didn't have BindToName - if (assemblyName == null & typeName == null) - { - return t.AssemblyQualifiedName; - } -#endif - return typeName + (assemblyName == null ? "" : ", " + assemblyName); - } - - return t.AssemblyQualifiedName; - } - - private static string RemoveAssemblyDetails(string fullyQualifiedTypeName) - { - StringBuilder builder = new StringBuilder(); - - // loop through the type name and filter out qualified assembly details from nested type names - bool writingAssemblyName = false; - bool skippingAssemblyDetails = false; - for (int i = 0; i < fullyQualifiedTypeName.Length; i++) - { - char current = fullyQualifiedTypeName[i]; - switch (current) - { - case '[': - case ']': - writingAssemblyName = false; - skippingAssemblyDetails = false; - builder.Append(current); - break; - case ',': - if (!writingAssemblyName) - { - writingAssemblyName = true; - builder.Append(current); - } - else - { - skippingAssemblyDetails = true; - } - break; - default: - if (!skippingAssemblyDetails) - { - builder.Append(current); - } - break; - } - } - - return builder.ToString(); - } - - public static bool HasDefaultConstructor(Type t, bool nonPublic) - { - ValidationUtils.ArgumentNotNull(t, nameof(t)); - - if (t.IsValueType()) - { - return true; - } - - return (GetDefaultConstructor(t, nonPublic) != null); - } - - public static ConstructorInfo GetDefaultConstructor(Type t) - { - return GetDefaultConstructor(t, false); - } - - public static ConstructorInfo GetDefaultConstructor(Type t, bool nonPublic) - { - BindingFlags bindingFlags = BindingFlags.Instance | BindingFlags.Public; - if (nonPublic) - { - bindingFlags = bindingFlags | BindingFlags.NonPublic; - } - - return t.GetConstructors(bindingFlags).SingleOrDefault(c => !c.GetParameters().Any()); - } - - public static bool IsNullable(Type t) - { - ValidationUtils.ArgumentNotNull(t, nameof(t)); - - if (t.IsValueType()) - { - return IsNullableType(t); - } - - return true; - } - - public static bool IsNullableType(Type t) - { - ValidationUtils.ArgumentNotNull(t, nameof(t)); - - return (t.IsGenericType() && t.GetGenericTypeDefinition() == typeof(Nullable<>)); - } - - public static Type EnsureNotNullableType(Type t) - { - return (IsNullableType(t)) - ? Nullable.GetUnderlyingType(t) - : t; - } - - public static Type EnsureNotByRefType(Type t) - { - return (t.IsByRef && t.HasElementType) - ? t.GetElementType() - : t; - } - - public static bool IsGenericDefinition(Type type, Type genericInterfaceDefinition) - { - if (!type.IsGenericType()) - { - return false; - } - - Type t = type.GetGenericTypeDefinition(); - return (t == genericInterfaceDefinition); - } - - public static bool ImplementsGenericDefinition(Type type, Type genericInterfaceDefinition) - { - return ImplementsGenericDefinition(type, genericInterfaceDefinition, out _); - } - - public static bool ImplementsGenericDefinition(Type type, Type genericInterfaceDefinition, [NotNullWhen(true)]out Type? implementingType) - { - ValidationUtils.ArgumentNotNull(type, nameof(type)); - ValidationUtils.ArgumentNotNull(genericInterfaceDefinition, nameof(genericInterfaceDefinition)); - - if (!genericInterfaceDefinition.IsInterface() || !genericInterfaceDefinition.IsGenericTypeDefinition()) - { - throw new ArgumentNullException("'{0}' is not a generic interface definition.".FormatWith(CultureInfo.InvariantCulture, genericInterfaceDefinition)); - } - - if (type.IsInterface()) - { - if (type.IsGenericType()) - { - Type interfaceDefinition = type.GetGenericTypeDefinition(); - - if (genericInterfaceDefinition == interfaceDefinition) - { - implementingType = type; - return true; - } - } - } - - foreach (Type i in type.GetInterfaces()) - { - if (i.IsGenericType()) - { - Type interfaceDefinition = i.GetGenericTypeDefinition(); - - if (genericInterfaceDefinition == interfaceDefinition) - { - implementingType = i; - return true; - } - } - } - - implementingType = null; - return false; - } - - public static bool InheritsGenericDefinition(Type type, Type genericClassDefinition) - { - return InheritsGenericDefinition(type, genericClassDefinition, out _); - } - - public static bool InheritsGenericDefinition(Type type, Type genericClassDefinition, out Type? implementingType) - { - ValidationUtils.ArgumentNotNull(type, nameof(type)); - ValidationUtils.ArgumentNotNull(genericClassDefinition, nameof(genericClassDefinition)); - - if (!genericClassDefinition.IsClass() || !genericClassDefinition.IsGenericTypeDefinition()) - { - throw new ArgumentNullException("'{0}' is not a generic class definition.".FormatWith(CultureInfo.InvariantCulture, genericClassDefinition)); - } - - return InheritsGenericDefinitionInternal(type, genericClassDefinition, out implementingType); - } - - private static bool InheritsGenericDefinitionInternal(Type currentType, Type genericClassDefinition, out Type? implementingType) - { - do - { - if (currentType.IsGenericType() && genericClassDefinition == currentType.GetGenericTypeDefinition()) - { - implementingType = currentType; - return true; - } - - currentType = currentType.BaseType(); - } - while (currentType != null); - - implementingType = null; - return false; - } - - /// - /// Gets the type of the typed collection's items. - /// - /// The type. - /// The type of the typed collection's items. - public static Type? GetCollectionItemType(Type type) - { - ValidationUtils.ArgumentNotNull(type, nameof(type)); - - if (type.IsArray) - { - return type.GetElementType(); - } - if (ImplementsGenericDefinition(type, typeof(IEnumerable<>), out Type? genericListType)) - { - if (genericListType!.IsGenericTypeDefinition()) - { - throw new Exception("Type {0} is not a collection.".FormatWith(CultureInfo.InvariantCulture, type)); - } - - return genericListType!.GetGenericArguments()[0]; - } - if (typeof(IEnumerable).IsAssignableFrom(type)) - { - return null; - } - - throw new Exception("Type {0} is not a collection.".FormatWith(CultureInfo.InvariantCulture, type)); - } - - public static void GetDictionaryKeyValueTypes(Type dictionaryType, out Type? keyType, out Type? valueType) - { - ValidationUtils.ArgumentNotNull(dictionaryType, nameof(dictionaryType)); - - if (ImplementsGenericDefinition(dictionaryType, typeof(IDictionary<,>), out Type? genericDictionaryType)) - { - if (genericDictionaryType!.IsGenericTypeDefinition()) - { - throw new Exception("Type {0} is not a dictionary.".FormatWith(CultureInfo.InvariantCulture, dictionaryType)); - } - - Type[] dictionaryGenericArguments = genericDictionaryType!.GetGenericArguments(); - - keyType = dictionaryGenericArguments[0]; - valueType = dictionaryGenericArguments[1]; - return; - } - if (typeof(IDictionary).IsAssignableFrom(dictionaryType)) - { - keyType = null; - valueType = null; - return; - } - - throw new Exception("Type {0} is not a dictionary.".FormatWith(CultureInfo.InvariantCulture, dictionaryType)); - } - - /// - /// Gets the member's underlying type. - /// - /// The member. - /// The underlying type of the member. - public static Type GetMemberUnderlyingType(MemberInfo member) - { - ValidationUtils.ArgumentNotNull(member, nameof(member)); - - switch (member.MemberType()) - { - case MemberTypes.Field: - return ((FieldInfo)member).FieldType; - case MemberTypes.Property: - return ((PropertyInfo)member).PropertyType; - case MemberTypes.Event: - return ((EventInfo)member).EventHandlerType; - case MemberTypes.Method: - return ((MethodInfo)member).ReturnType; - default: - throw new ArgumentException("MemberInfo must be of type FieldInfo, PropertyInfo, EventInfo or MethodInfo", nameof(member)); - } - } - - public static bool IsByRefLikeType(Type type) - { - if (!type.IsValueType()) - { - return false; - } - - // IsByRefLike flag on type is not available in netstandard2.0 - Attribute[] attributes = GetAttributes(type, null, false); - for (int i = 0; i < attributes.Length; i++) - { - if (string.Equals(attributes[i].GetType().FullName, "System.Runtime.CompilerServices.IsByRefLikeAttribute", StringComparison.Ordinal)) - { - return true; - } - } - - return false; - } - - /// - /// Determines whether the property is an indexed property. - /// - /// The property. - /// - /// true if the property is an indexed property; otherwise, false. - /// - public static bool IsIndexedProperty(PropertyInfo property) - { - ValidationUtils.ArgumentNotNull(property, nameof(property)); - - return (property.GetIndexParameters().Length > 0); - } - - /// - /// Gets the member's value on the object. - /// - /// The member. - /// The target object. - /// The member's value on the object. - public static object GetMemberValue(MemberInfo member, object target) - { - ValidationUtils.ArgumentNotNull(member, nameof(member)); - ValidationUtils.ArgumentNotNull(target, nameof(target)); - - switch (member.MemberType()) - { - case MemberTypes.Field: - return ((FieldInfo)member).GetValue(target); - case MemberTypes.Property: - try - { - return ((PropertyInfo)member).GetValue(target, null); - } - catch (TargetParameterCountException e) - { - throw new ArgumentException("MemberInfo '{0}' has index parameters".FormatWith(CultureInfo.InvariantCulture, member.Name), e); - } - default: - throw new ArgumentException("MemberInfo '{0}' is not of type FieldInfo or PropertyInfo".FormatWith(CultureInfo.InvariantCulture, member.Name), nameof(member)); - } - } - - /// - /// Sets the member's value on the target object. - /// - /// The member. - /// The target. - /// The value. - public static void SetMemberValue(MemberInfo member, object target, object? value) - { - ValidationUtils.ArgumentNotNull(member, nameof(member)); - ValidationUtils.ArgumentNotNull(target, nameof(target)); - - switch (member.MemberType()) - { - case MemberTypes.Field: - ((FieldInfo)member).SetValue(target, value); - break; - case MemberTypes.Property: - ((PropertyInfo)member).SetValue(target, value, null); - break; - default: - throw new ArgumentException("MemberInfo '{0}' must be of type FieldInfo or PropertyInfo".FormatWith(CultureInfo.InvariantCulture, member.Name), nameof(member)); - } - } - - /// - /// Determines whether the specified MemberInfo can be read. - /// - /// The MemberInfo to determine whether can be read. - /// /// if set to true then allow the member to be gotten non-publicly. - /// - /// true if the specified MemberInfo can be read; otherwise, false. - /// - public static bool CanReadMemberValue(MemberInfo member, bool nonPublic) - { - switch (member.MemberType()) - { - case MemberTypes.Field: - FieldInfo fieldInfo = (FieldInfo)member; - - if (nonPublic) - { - return true; - } - else if (fieldInfo.IsPublic) - { - return true; - } - return false; - case MemberTypes.Property: - PropertyInfo propertyInfo = (PropertyInfo)member; - - if (!propertyInfo.CanRead) - { - return false; - } - if (nonPublic) - { - return true; - } - return (propertyInfo.GetGetMethod(nonPublic) != null); - default: - return false; - } - } - - /// - /// Determines whether the specified MemberInfo can be set. - /// - /// The MemberInfo to determine whether can be set. - /// if set to true then allow the member to be set non-publicly. - /// if set to true then allow the member to be set if read-only. - /// - /// true if the specified MemberInfo can be set; otherwise, false. - /// - public static bool CanSetMemberValue(MemberInfo member, bool nonPublic, bool canSetReadOnly) - { - switch (member.MemberType()) - { - case MemberTypes.Field: - FieldInfo fieldInfo = (FieldInfo)member; - - if (fieldInfo.IsLiteral) - { - return false; - } - if (fieldInfo.IsInitOnly && !canSetReadOnly) - { - return false; - } - if (nonPublic) - { - return true; - } - if (fieldInfo.IsPublic) - { - return true; - } - return false; - case MemberTypes.Property: - PropertyInfo propertyInfo = (PropertyInfo)member; - - if (!propertyInfo.CanWrite) - { - return false; - } - if (nonPublic) - { - return true; - } - return (propertyInfo.GetSetMethod(nonPublic) != null); - default: - return false; - } - } - - public static List GetFieldsAndProperties(Type type, BindingFlags bindingAttr) - { - List targetMembers = new List(); - - targetMembers.AddRange(GetFields(type, bindingAttr)); - targetMembers.AddRange(GetProperties(type, bindingAttr)); - - // for some reason .NET returns multiple members when overriding a generic member on a base class - // http://social.msdn.microsoft.com/Forums/en-US/b5abbfee-e292-4a64-8907-4e3f0fb90cd9/reflection-overriden-abstract-generic-properties?forum=netfxbcl - // filter members to only return the override on the topmost class - // update: I think this is fixed in .NET 3.5 SP1 - leave this in for now... - List distinctMembers = new List(targetMembers.Count); - - foreach (IGrouping groupedMember in targetMembers.GroupBy(m => m.Name)) - { - int count = groupedMember.Count(); - - if (count == 1) - { - distinctMembers.Add(groupedMember.First()); - } - else - { - List resolvedMembers = new List(); - foreach (MemberInfo memberInfo in groupedMember) - { - // this is a bit hacky - // if the hiding property is hiding a base property and it is virtual - // then this ensures the derived property gets used - if (resolvedMembers.Count == 0) - { - resolvedMembers.Add(memberInfo); - } - else if (!IsOverridenGenericMember(memberInfo, bindingAttr) || memberInfo.Name == "Item") - { - // two members with the same name were declared on a type - // this can be done via IL emit, e.g. Moq - if (resolvedMembers.Any(m => m.DeclaringType == memberInfo.DeclaringType)) - { - continue; - } - - resolvedMembers.Add(memberInfo); - } - } - - distinctMembers.AddRange(resolvedMembers); - } - } - - return distinctMembers; - } - - private static bool IsOverridenGenericMember(MemberInfo memberInfo, BindingFlags bindingAttr) - { - if (memberInfo.MemberType() != MemberTypes.Property) - { - return false; - } - - PropertyInfo propertyInfo = (PropertyInfo)memberInfo; - if (!IsVirtual(propertyInfo)) - { - return false; - } - - Type declaringType = propertyInfo.DeclaringType; - if (!declaringType.IsGenericType()) - { - return false; - } - Type genericTypeDefinition = declaringType.GetGenericTypeDefinition(); - if (genericTypeDefinition == null) - { - return false; - } - MemberInfo[] members = genericTypeDefinition.GetMember(propertyInfo.Name, bindingAttr); - if (members.Length == 0) - { - return false; - } - Type memberUnderlyingType = GetMemberUnderlyingType(members[0]); - if (!memberUnderlyingType.IsGenericParameter) - { - return false; - } - - return true; - } - - public static T? GetAttribute(object attributeProvider) where T : Attribute - { - return GetAttribute(attributeProvider, true); - } - - public static T? GetAttribute(object attributeProvider, bool inherit) where T : Attribute - { - T[] attributes = GetAttributes(attributeProvider, inherit); - - return attributes?.FirstOrDefault(); - } - -#if !(DOTNET || PORTABLE) || NETSTANDARD2_0 - public static T[] GetAttributes(object attributeProvider, bool inherit) where T : Attribute - { - Attribute[] a = GetAttributes(attributeProvider, typeof(T), inherit); - - if (a is T[] attributes) - { - return attributes; - } - - return a.Cast().ToArray(); - } - - public static Attribute[] GetAttributes(object attributeProvider, Type? attributeType, bool inherit) - { - ValidationUtils.ArgumentNotNull(attributeProvider, nameof(attributeProvider)); - - object provider = attributeProvider; - - // http://hyperthink.net/blog/getcustomattributes-gotcha/ - // ICustomAttributeProvider doesn't do inheritance - - switch (provider) - { - case Type t: - object[] array = attributeType != null ? t.GetCustomAttributes(attributeType, inherit) : t.GetCustomAttributes(inherit); - Attribute[] attributes = array.Cast().ToArray(); - -#if (NET20 || NET35) - // ye olde .NET GetCustomAttributes doesn't respect the inherit argument - if (inherit && t.BaseType != null) - { - attributes = attributes.Union(GetAttributes(t.BaseType, attributeType, inherit)).ToArray(); - } -#endif - - return attributes; - case Assembly a: - return (attributeType != null) ? Attribute.GetCustomAttributes(a, attributeType) : Attribute.GetCustomAttributes(a); - case MemberInfo mi: - return (attributeType != null) ? Attribute.GetCustomAttributes(mi, attributeType, inherit) : Attribute.GetCustomAttributes(mi, inherit); -#if !PORTABLE40 - case Module m: - return (attributeType != null) ? Attribute.GetCustomAttributes(m, attributeType, inherit) : Attribute.GetCustomAttributes(m, inherit); -#endif - case ParameterInfo p: - return (attributeType != null) ? Attribute.GetCustomAttributes(p, attributeType, inherit) : Attribute.GetCustomAttributes(p, inherit); - default: -#if !PORTABLE40 - ICustomAttributeProvider customAttributeProvider = (ICustomAttributeProvider)attributeProvider; - object[] result = (attributeType != null) ? customAttributeProvider.GetCustomAttributes(attributeType, inherit) : customAttributeProvider.GetCustomAttributes(inherit); - - return (Attribute[])result; -#else - throw new Exception("Cannot get attributes from '{0}'.".FormatWith(CultureInfo.InvariantCulture, provider)); -#endif - } - } -#else - public static T[] GetAttributes(object attributeProvider, bool inherit) where T : Attribute - { - return GetAttributes(attributeProvider, typeof(T), inherit).Cast().ToArray(); - } - - public static Attribute[] GetAttributes(object provider, Type? attributeType, bool inherit) - { - switch (provider) - { - case Type t: - return (attributeType != null) - ? t.GetTypeInfo().GetCustomAttributes(attributeType, inherit).ToArray() - : t.GetTypeInfo().GetCustomAttributes(inherit).ToArray(); - case Assembly a: - return (attributeType != null) ? a.GetCustomAttributes(attributeType).ToArray() : a.GetCustomAttributes().ToArray(); - case MemberInfo memberInfo: - return (attributeType != null) ? memberInfo.GetCustomAttributes(attributeType, inherit).ToArray() : memberInfo.GetCustomAttributes(inherit).ToArray(); - case Module module: - return (attributeType != null) ? module.GetCustomAttributes(attributeType).ToArray() : module.GetCustomAttributes().ToArray(); - case ParameterInfo parameterInfo: - return (attributeType != null) ? parameterInfo.GetCustomAttributes(attributeType, inherit).ToArray() : parameterInfo.GetCustomAttributes(inherit).ToArray(); - } - - throw new Exception("Cannot get attributes from '{0}'.".FormatWith(CultureInfo.InvariantCulture, provider)); - } -#endif - - public static StructMultiKey SplitFullyQualifiedTypeName(string fullyQualifiedTypeName) - { - int? assemblyDelimiterIndex = GetAssemblyDelimiterIndex(fullyQualifiedTypeName); - - string typeName; - string? assemblyName; - - if (assemblyDelimiterIndex != null) - { - typeName = fullyQualifiedTypeName.Trim(0, assemblyDelimiterIndex.GetValueOrDefault()); - assemblyName = fullyQualifiedTypeName.Trim(assemblyDelimiterIndex.GetValueOrDefault() + 1, fullyQualifiedTypeName.Length - assemblyDelimiterIndex.GetValueOrDefault() - 1); - } - else - { - typeName = fullyQualifiedTypeName; - assemblyName = null; - } - - return new StructMultiKey(assemblyName, typeName); - } - - private static int? GetAssemblyDelimiterIndex(string fullyQualifiedTypeName) - { - // we need to get the first comma following all surrounded in brackets because of generic types - // e.g. System.Collections.Generic.Dictionary`2[[System.String, mscorlib,Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]], mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 - int scope = 0; - for (int i = 0; i < fullyQualifiedTypeName.Length; i++) - { - char current = fullyQualifiedTypeName[i]; - switch (current) - { - case '[': - scope++; - break; - case ']': - scope--; - break; - case ',': - if (scope == 0) - { - return i; - } - break; - } - } - - return null; - } - - public static MemberInfo GetMemberInfoFromType(Type targetType, MemberInfo memberInfo) - { - const BindingFlags bindingAttr = BindingFlags.Instance | BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic; - - switch (memberInfo.MemberType()) - { - case MemberTypes.Property: - PropertyInfo propertyInfo = (PropertyInfo)memberInfo; - - Type[] types = propertyInfo.GetIndexParameters().Select(p => p.ParameterType).ToArray(); - - return targetType.GetProperty(propertyInfo.Name, bindingAttr, null, propertyInfo.PropertyType, types, null); - default: - return targetType.GetMember(memberInfo.Name, memberInfo.MemberType(), bindingAttr).SingleOrDefault(); - } - } - - public static IEnumerable GetFields(Type targetType, BindingFlags bindingAttr) - { - ValidationUtils.ArgumentNotNull(targetType, nameof(targetType)); - - List fieldInfos = new List(targetType.GetFields(bindingAttr)); -#if !PORTABLE - // Type.GetFields doesn't return inherited private fields - // manually find private fields from base class - GetChildPrivateFields(fieldInfos, targetType, bindingAttr); -#endif - - return fieldInfos.Cast(); - } - -#if !PORTABLE - private static void GetChildPrivateFields(IList initialFields, Type targetType, BindingFlags bindingAttr) - { - // fix weirdness with private FieldInfos only being returned for the current Type - // find base type fields and add them to result - if ((bindingAttr & BindingFlags.NonPublic) != 0) - { - // modify flags to not search for public fields - BindingFlags nonPublicBindingAttr = bindingAttr.RemoveFlag(BindingFlags.Public); - - while ((targetType = targetType.BaseType()) != null) - { - // filter out protected fields - IEnumerable childPrivateFields = - targetType.GetFields(nonPublicBindingAttr).Where(f => f.IsPrivate); - - initialFields.AddRange(childPrivateFields); - } - } - } -#endif - - public static IEnumerable GetProperties(Type targetType, BindingFlags bindingAttr) - { - ValidationUtils.ArgumentNotNull(targetType, nameof(targetType)); - - List propertyInfos = new List(targetType.GetProperties(bindingAttr)); - - // GetProperties on an interface doesn't return properties from its interfaces - if (targetType.IsInterface()) - { - foreach (Type i in targetType.GetInterfaces()) - { - propertyInfos.AddRange(i.GetProperties(bindingAttr)); - } - } - - GetChildPrivateProperties(propertyInfos, targetType, bindingAttr); - - // a base class private getter/setter will be inaccessible unless the property was gotten from the base class - for (int i = 0; i < propertyInfos.Count; i++) - { - PropertyInfo member = propertyInfos[i]; - if (member.DeclaringType != targetType) - { - PropertyInfo declaredMember = (PropertyInfo)GetMemberInfoFromType(member.DeclaringType, member); - propertyInfos[i] = declaredMember; - } - } - - return propertyInfos; - } - - public static BindingFlags RemoveFlag(this BindingFlags bindingAttr, BindingFlags flag) - { - return ((bindingAttr & flag) == flag) - ? bindingAttr ^ flag - : bindingAttr; - } - - private static void GetChildPrivateProperties(IList initialProperties, Type targetType, BindingFlags bindingAttr) - { - // fix weirdness with private PropertyInfos only being returned for the current Type - // find base type properties and add them to result - - // also find base properties that have been hidden by subtype properties with the same name - - while ((targetType = targetType.BaseType()) != null) - { - foreach (PropertyInfo propertyInfo in targetType.GetProperties(bindingAttr)) - { - PropertyInfo subTypeProperty = propertyInfo; - - if (!subTypeProperty.IsVirtual()) - { - if (!IsPublic(subTypeProperty)) - { - // have to test on name rather than reference because instances are different - // depending on the type that GetProperties was called on - int index = initialProperties.IndexOf(p => p.Name == subTypeProperty.Name); - if (index == -1) - { - initialProperties.Add(subTypeProperty); - } - else - { - PropertyInfo childProperty = initialProperties[index]; - // don't replace public child with private base - if (!IsPublic(childProperty)) - { - // replace nonpublic properties for a child, but gotten from - // the parent with the one from the child - // the property gotten from the child will have access to private getter/setter - initialProperties[index] = subTypeProperty; - } - } - } - else - { - int index = initialProperties.IndexOf(p => p.Name == subTypeProperty.Name - && p.DeclaringType == subTypeProperty.DeclaringType); - - if (index == -1) - { - initialProperties.Add(subTypeProperty); - } - } - } - else - { - Type subTypePropertyDeclaringType = subTypeProperty.GetBaseDefinition()?.DeclaringType ?? subTypeProperty.DeclaringType; - - int index = initialProperties.IndexOf(p => p.Name == subTypeProperty.Name - && p.IsVirtual() - && (p.GetBaseDefinition()?.DeclaringType ?? p.DeclaringType).IsAssignableFrom(subTypePropertyDeclaringType)); - - // don't add a virtual property that has an override - if (index == -1) - { - initialProperties.Add(subTypeProperty); - } - } - } - } - } - - public static bool IsMethodOverridden(Type currentType, Type methodDeclaringType, string method) - { - bool isMethodOverriden = currentType.GetMethods(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance) - .Any(info => - info.Name == method && - // check that the method overrides the original on DynamicObjectProxy - info.DeclaringType != methodDeclaringType - && info.GetBaseDefinition().DeclaringType == methodDeclaringType - ); - - return isMethodOverriden; - } - - public static object? GetDefaultValue(Type type) - { - if (!type.IsValueType()) - { - return null; - } - - switch (ConvertUtils.GetTypeCode(type)) - { - case PrimitiveTypeCode.Boolean: - return false; - case PrimitiveTypeCode.Char: - case PrimitiveTypeCode.SByte: - case PrimitiveTypeCode.Byte: - case PrimitiveTypeCode.Int16: - case PrimitiveTypeCode.UInt16: - case PrimitiveTypeCode.Int32: - case PrimitiveTypeCode.UInt32: - return 0; - case PrimitiveTypeCode.Int64: - case PrimitiveTypeCode.UInt64: - return 0L; - case PrimitiveTypeCode.Single: - return 0f; - case PrimitiveTypeCode.Double: - return 0.0; - case PrimitiveTypeCode.Decimal: - return 0m; - case PrimitiveTypeCode.DateTime: - return new DateTime(); -#if HAVE_BIG_INTEGER - case PrimitiveTypeCode.BigInteger: - return new BigInteger(); -#endif - case PrimitiveTypeCode.Guid: - return new Guid(); -#if HAVE_DATE_TIME_OFFSET - case PrimitiveTypeCode.DateTimeOffset: - return new DateTimeOffset(); -#endif - } - - if (IsNullable(type)) - { - return null; - } - - // possibly use IL initobj for perf here? - return Activator.CreateInstance(type); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/StringBuffer.cs b/Source/MyDb/Newtonsoft.Json/Utilities/StringBuffer.cs deleted file mode 100644 index 13f4f86..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/StringBuffer.cs +++ /dev/null @@ -1,116 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Utilities -{ - /// - /// Builds a string. Unlike this class lets you reuse its internal buffer. - /// - internal struct StringBuffer - { - private char[]? _buffer; - private int _position; - - public int Position - { - get => _position; - set => _position = value; - } - - public bool IsEmpty => _buffer == null; - - public StringBuffer(IArrayPool? bufferPool, int initalSize) : this(BufferUtils.RentBuffer(bufferPool, initalSize)) - { - } - - private StringBuffer(char[] buffer) - { - _buffer = buffer; - _position = 0; - } - - public void Append(IArrayPool? bufferPool, char value) - { - // test if the buffer array is large enough to take the value - if (_position == _buffer!.Length) - { - EnsureSize(bufferPool, 1); - } - - // set value and increment poisition - _buffer![_position++] = value; - } - - public void Append(IArrayPool? bufferPool, char[] buffer, int startIndex, int count) - { - if (_position + count >= _buffer!.Length) - { - EnsureSize(bufferPool, count); - } - - Array.Copy(buffer, startIndex, _buffer, _position, count); - - _position += count; - } - - public void Clear(IArrayPool? bufferPool) - { - if (_buffer != null) - { - BufferUtils.ReturnBuffer(bufferPool, _buffer); - _buffer = null; - } - _position = 0; - } - - private void EnsureSize(IArrayPool? bufferPool, int appendLength) - { - char[] newBuffer = BufferUtils.RentBuffer(bufferPool, (_position + appendLength) * 2); - - if (_buffer != null) - { - Array.Copy(_buffer, newBuffer, _position); - BufferUtils.ReturnBuffer(bufferPool, _buffer); - } - - _buffer = newBuffer; - } - - public override string ToString() - { - return ToString(0, _position); - } - - public string ToString(int start, int length) - { - // TODO: validation - return new string(_buffer, start, length); - } - - public char[]? InternalBuffer => _buffer; - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/StringReference.cs b/Source/MyDb/Newtonsoft.Json/Utilities/StringReference.cs deleted file mode 100644 index 44591d1..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/StringReference.cs +++ /dev/null @@ -1,111 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Utilities -{ - internal readonly struct StringReference - { - private readonly char[] _chars; - private readonly int _startIndex; - private readonly int _length; - - public char this[int i] => _chars[i]; - - public char[] Chars => _chars; - - public int StartIndex => _startIndex; - - public int Length => _length; - - public StringReference(char[] chars, int startIndex, int length) - { - _chars = chars; - _startIndex = startIndex; - _length = length; - } - - public override string ToString() - { - return new string(_chars, _startIndex, _length); - } - } - - internal static class StringReferenceExtensions - { - public static int IndexOf(this StringReference s, char c, int startIndex, int length) - { - int index = Array.IndexOf(s.Chars, c, s.StartIndex + startIndex, length); - if (index == -1) - { - return -1; - } - - return index - s.StartIndex; - } - - public static bool StartsWith(this StringReference s, string text) - { - if (text.Length > s.Length) - { - return false; - } - - char[] chars = s.Chars; - - for (int i = 0; i < text.Length; i++) - { - if (text[i] != chars[i + s.StartIndex]) - { - return false; - } - } - - return true; - } - - public static bool EndsWith(this StringReference s, string text) - { - if (text.Length > s.Length) - { - return false; - } - - char[] chars = s.Chars; - - int start = s.StartIndex + s.Length - text.Length; - for (int i = 0; i < text.Length; i++) - { - if (text[i] != chars[i + start]) - { - return false; - } - } - - return true; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/StringUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/StringUtils.cs deleted file mode 100644 index e176c88..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/StringUtils.cs +++ /dev/null @@ -1,354 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.IO; -using System.Text; -using System.Globalization; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Utilities -{ - internal static class StringUtils - { - public const string CarriageReturnLineFeed = "\r\n"; - public const string Empty = ""; - public const char CarriageReturn = '\r'; - public const char LineFeed = '\n'; - public const char Tab = '\t'; - - public static bool IsNullOrEmpty([NotNullWhen(false)] string? value) - { - return string.IsNullOrEmpty(value); - } - - public static string FormatWith(this string format, IFormatProvider provider, object? arg0) - { - return format.FormatWith(provider, new object?[] { arg0 }); - } - - public static string FormatWith(this string format, IFormatProvider provider, object? arg0, object? arg1) - { - return format.FormatWith(provider, new object?[] { arg0, arg1 }); - } - - public static string FormatWith(this string format, IFormatProvider provider, object? arg0, object? arg1, object? arg2) - { - return format.FormatWith(provider, new object?[] { arg0, arg1, arg2 }); - } - - public static string FormatWith(this string format, IFormatProvider provider, object? arg0, object? arg1, object? arg2, object? arg3) - { - return format.FormatWith(provider, new object?[] { arg0, arg1, arg2, arg3 }); - } - - private static string FormatWith(this string format, IFormatProvider provider, params object?[] args) - { - // leave this a private to force code to use an explicit overload - // avoids stack memory being reserved for the object array - ValidationUtils.ArgumentNotNull(format, nameof(format)); - - return string.Format(provider, format, args); - } - - /// - /// Determines whether the string is all white space. Empty string will return false. - /// - /// The string to test whether it is all white space. - /// - /// true if the string is all white space; otherwise, false. - /// - public static bool IsWhiteSpace(string s) - { - if (s == null) - { - throw new ArgumentNullException(nameof(s)); - } - - if (s.Length == 0) - { - return false; - } - - for (int i = 0; i < s.Length; i++) - { - if (!char.IsWhiteSpace(s[i])) - { - return false; - } - } - - return true; - } - - public static StringWriter CreateStringWriter(int capacity) - { - StringBuilder sb = new StringBuilder(capacity); - StringWriter sw = new StringWriter(sb, CultureInfo.InvariantCulture); - - return sw; - } - - public static void ToCharAsUnicode(char c, char[] buffer) - { - buffer[0] = '\\'; - buffer[1] = 'u'; - buffer[2] = MathUtils.IntToHex((c >> 12) & '\x000f'); - buffer[3] = MathUtils.IntToHex((c >> 8) & '\x000f'); - buffer[4] = MathUtils.IntToHex((c >> 4) & '\x000f'); - buffer[5] = MathUtils.IntToHex(c & '\x000f'); - } - - public static TSource ForgivingCaseSensitiveFind(this IEnumerable source, Func valueSelector, string testValue) - { - if (source == null) - { - throw new ArgumentNullException(nameof(source)); - } - if (valueSelector == null) - { - throw new ArgumentNullException(nameof(valueSelector)); - } - - IEnumerable caseInsensitiveResults = source.Where(s => string.Equals(valueSelector(s), testValue, StringComparison.OrdinalIgnoreCase)); - if (caseInsensitiveResults.Count() <= 1) - { - return caseInsensitiveResults.SingleOrDefault(); - } - else - { - // multiple results returned. now filter using case sensitivity - IEnumerable caseSensitiveResults = source.Where(s => string.Equals(valueSelector(s), testValue, StringComparison.Ordinal)); - return caseSensitiveResults.SingleOrDefault(); - } - } - - public static string ToCamelCase(string s) - { - if (StringUtils.IsNullOrEmpty(s) || !char.IsUpper(s[0])) - { - return s; - } - - char[] chars = s.ToCharArray(); - - for (int i = 0; i < chars.Length; i++) - { - if (i == 1 && !char.IsUpper(chars[i])) - { - break; - } - - bool hasNext = (i + 1 < chars.Length); - if (i > 0 && hasNext && !char.IsUpper(chars[i + 1])) - { - // if the next character is a space, which is not considered uppercase - // (otherwise we wouldn't be here...) - // we want to ensure that the following: - // 'FOO bar' is rewritten as 'foo bar', and not as 'foO bar' - // The code was written in such a way that the first word in uppercase - // ends when if finds an uppercase letter followed by a lowercase letter. - // now a ' ' (space, (char)32) is considered not upper - // but in that case we still want our current character to become lowercase - if (char.IsSeparator(chars[i + 1])) - { - chars[i] = ToLower(chars[i]); - } - - break; - } - - chars[i] = ToLower(chars[i]); - } - - return new string(chars); - } - - private static char ToLower(char c) - { -#if HAVE_CHAR_TO_LOWER_WITH_CULTURE - c = char.ToLower(c, CultureInfo.InvariantCulture); -#else - c = char.ToLowerInvariant(c); -#endif - return c; - } - - public static string ToSnakeCase(string s) => ToSeparatedCase(s, '_'); - - public static string ToKebabCase(string s) => ToSeparatedCase(s, '-'); - - private enum SeparatedCaseState - { - Start, - Lower, - Upper, - NewWord - } - - private static string ToSeparatedCase(string s, char separator) - { - if (StringUtils.IsNullOrEmpty(s)) - { - return s; - } - - StringBuilder sb = new StringBuilder(); - SeparatedCaseState state = SeparatedCaseState.Start; - - for (int i = 0; i < s.Length; i++) - { - if (s[i] == ' ') - { - if (state != SeparatedCaseState.Start) - { - state = SeparatedCaseState.NewWord; - } - } - else if (char.IsUpper(s[i])) - { - switch (state) - { - case SeparatedCaseState.Upper: - bool hasNext = (i + 1 < s.Length); - if (i > 0 && hasNext) - { - char nextChar = s[i + 1]; - if (!char.IsUpper(nextChar) && nextChar != separator) - { - sb.Append(separator); - } - } - break; - case SeparatedCaseState.Lower: - case SeparatedCaseState.NewWord: - sb.Append(separator); - break; - } - - char c; -#if HAVE_CHAR_TO_LOWER_WITH_CULTURE - c = char.ToLower(s[i], CultureInfo.InvariantCulture); -#else - c = char.ToLowerInvariant(s[i]); -#endif - sb.Append(c); - - state = SeparatedCaseState.Upper; - } - else if (s[i] == separator) - { - sb.Append(separator); - state = SeparatedCaseState.Start; - } - else - { - if (state == SeparatedCaseState.NewWord) - { - sb.Append(separator); - } - - sb.Append(s[i]); - state = SeparatedCaseState.Lower; - } - } - - return sb.ToString(); - } - - public static bool IsHighSurrogate(char c) - { -#if HAVE_UNICODE_SURROGATE_DETECTION - return char.IsHighSurrogate(c); -#else - return (c >= 55296 && c <= 56319); -#endif - } - - public static bool IsLowSurrogate(char c) - { -#if HAVE_UNICODE_SURROGATE_DETECTION - return char.IsLowSurrogate(c); -#else - return (c >= 56320 && c <= 57343); -#endif - } - - public static bool StartsWith(this string source, char value) - { - return (source.Length > 0 && source[0] == value); - } - - public static bool EndsWith(this string source, char value) - { - return (source.Length > 0 && source[source.Length - 1] == value); - } - - public static string Trim(this string s, int start, int length) - { - // References: https://referencesource.microsoft.com/#mscorlib/system/string.cs,2691 - // https://referencesource.microsoft.com/#mscorlib/system/string.cs,1226 - if (s == null) - { - throw new ArgumentNullException(); - } - if (start < 0) - { - throw new ArgumentOutOfRangeException(nameof(start)); - } - if (length < 0) - { - throw new ArgumentOutOfRangeException(nameof(length)); - } - int end = start + length - 1; - if (end >= s.Length) - { - throw new ArgumentOutOfRangeException(nameof(length)); - } - for (; start < end; start++) - { - if (!char.IsWhiteSpace(s[start])) - { - break; - } - } - for (; end >= start; end--) - { - if (!char.IsWhiteSpace(s[end])) - { - break; - } - } - return s.Substring(start, end - start + 1); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/StructMultiKey.cs b/Source/MyDb/Newtonsoft.Json/Utilities/StructMultiKey.cs deleted file mode 100644 index 10428aa..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/StructMultiKey.cs +++ /dev/null @@ -1,61 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json.Utilities -{ - internal readonly struct StructMultiKey : IEquatable> - { - public readonly T1 Value1; - public readonly T2 Value2; - - public StructMultiKey(T1 v1, T2 v2) - { - Value1 = v1; - Value2 = v2; - } - - public override int GetHashCode() - { - return (Value1?.GetHashCode() ?? 0) ^ (Value2?.GetHashCode() ?? 0); - } - - public override bool Equals(object obj) - { - if (!(obj is StructMultiKey key)) - { - return false; - } - - return Equals(key); - } - - public bool Equals(StructMultiKey other) - { - return (Equals(Value1, other.Value1) && Equals(Value2, other.Value2)); - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/ThreadSafeStore.cs b/Source/MyDb/Newtonsoft.Json/Utilities/ThreadSafeStore.cs deleted file mode 100644 index 2e135f0..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/ThreadSafeStore.cs +++ /dev/null @@ -1,109 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#endif -#if HAVE_CONCURRENT_DICTIONARY -using System.Collections.Concurrent; -#endif -using System.Threading; -using Newtonsoft.Json.Serialization; - -namespace Newtonsoft.Json.Utilities -{ - internal class ThreadSafeStore - { -#if HAVE_CONCURRENT_DICTIONARY - private readonly ConcurrentDictionary _concurrentStore; -#else - private readonly object _lock = new object(); - private Dictionary _store; -#endif - private readonly Func _creator; - - public ThreadSafeStore(Func creator) - { - ValidationUtils.ArgumentNotNull(creator, nameof(creator)); - - _creator = creator; -#if HAVE_CONCURRENT_DICTIONARY - _concurrentStore = new ConcurrentDictionary(); -#else - _store = new Dictionary(); -#endif - } - - public TValue Get(TKey key) - { -#if HAVE_CONCURRENT_DICTIONARY - return _concurrentStore.GetOrAdd(key, _creator); -#else - if (!_store.TryGetValue(key, out TValue value)) - { - return AddValue(key); - } - - return value; -#endif - } - -#if !HAVE_CONCURRENT_DICTIONARY - private TValue AddValue(TKey key) - { - TValue value = _creator(key); - - lock (_lock) - { - if (_store == null) - { - _store = new Dictionary(); - _store[key] = value; - } - else - { - // double check locking - if (_store.TryGetValue(key, out TValue checkValue)) - { - return checkValue; - } - - Dictionary newStore = new Dictionary(_store); - newStore[key] = value; - -#if HAVE_MEMORY_BARRIER - Thread.MemoryBarrier(); -#endif - _store = newStore; - } - - return value; - } - } -#endif - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/TypeExtensions.cs b/Source/MyDb/Newtonsoft.Json/Utilities/TypeExtensions.cs deleted file mode 100644 index 77b7569..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/TypeExtensions.cs +++ /dev/null @@ -1,634 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Collections.Generic; -using System.Reflection; -using System.Runtime.CompilerServices; -using System.Diagnostics.CodeAnalysis; -#if !HAVE_LINQ -using Newtonsoft.Json.Utilities.LinqBridge; -#else -using System.Linq; -#endif - -namespace Newtonsoft.Json.Utilities -{ - internal static class TypeExtensions - { -#if DOTNET || PORTABLE -#if !DOTNET - private static readonly BindingFlags DefaultFlags = BindingFlags.Public | BindingFlags.Static | BindingFlags.Instance; - - public static MethodInfo? GetGetMethod(this PropertyInfo propertyInfo) - { - return propertyInfo.GetGetMethod(false); - } - - public static MethodInfo? GetGetMethod(this PropertyInfo propertyInfo, bool nonPublic) - { - MethodInfo getMethod = propertyInfo.GetMethod; - if (getMethod != null && (getMethod.IsPublic || nonPublic)) - { - return getMethod; - } - - return null; - } - - public static MethodInfo? GetSetMethod(this PropertyInfo propertyInfo) - { - return propertyInfo.GetSetMethod(false); - } - - public static MethodInfo? GetSetMethod(this PropertyInfo propertyInfo, bool nonPublic) - { - MethodInfo setMethod = propertyInfo.SetMethod; - if (setMethod != null && (setMethod.IsPublic || nonPublic)) - { - return setMethod; - } - - return null; - } -#endif - - public static bool IsSubclassOf(this Type type, Type c) - { - return type.GetTypeInfo().IsSubclassOf(c); - } - -#if !DOTNET - public static bool IsAssignableFrom(this Type type, Type c) - { - return type.GetTypeInfo().IsAssignableFrom(c.GetTypeInfo()); - } -#endif - - public static bool IsInstanceOfType(this Type type, object? o) - { - if (o == null) - { - return false; - } - - return type.IsAssignableFrom(o.GetType()); - } -#endif - - public static MethodInfo Method(this Delegate d) - { -#if HAVE_FULL_REFLECTION - return d.Method; -#else - return d.GetMethodInfo(); -#endif - } - - public static MemberTypes MemberType(this MemberInfo memberInfo) - { -#if !(DOTNET || PORTABLE || PORTABLE40) - return memberInfo.MemberType; -#else - if (memberInfo is PropertyInfo) - { - return MemberTypes.Property; - } - else if (memberInfo is FieldInfo) - { - return MemberTypes.Field; - } - else if (memberInfo is EventInfo) - { - return MemberTypes.Event; - } - else if (memberInfo is MethodInfo) - { - return MemberTypes.Method; - } - else - { - return default; - } -#endif - } - - public static bool ContainsGenericParameters(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.ContainsGenericParameters; -#else - return type.GetTypeInfo().ContainsGenericParameters; -#endif - } - - public static bool IsInterface(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsInterface; -#else - return type.GetTypeInfo().IsInterface; -#endif - } - - public static bool IsGenericType(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsGenericType; -#else - return type.GetTypeInfo().IsGenericType; -#endif - } - - public static bool IsGenericTypeDefinition(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsGenericTypeDefinition; -#else - return type.GetTypeInfo().IsGenericTypeDefinition; -#endif - } - - public static Type BaseType(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.BaseType; -#else - return type.GetTypeInfo().BaseType; -#endif - } - - public static Assembly Assembly(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.Assembly; -#else - return type.GetTypeInfo().Assembly; -#endif - } - - public static bool IsEnum(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsEnum; -#else - return type.GetTypeInfo().IsEnum; -#endif - } - - public static bool IsClass(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsClass; -#else - return type.GetTypeInfo().IsClass; -#endif - } - - public static bool IsSealed(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsSealed; -#else - return type.GetTypeInfo().IsSealed; -#endif - } - -#if (PORTABLE40 || DOTNET || PORTABLE) - public static PropertyInfo GetProperty(this Type type, string name, BindingFlags bindingFlags, object? placeholder1, Type propertyType, IList indexParameters, object? placeholder2) - { - IEnumerable propertyInfos = type.GetProperties(bindingFlags); - - return propertyInfos.Where(p => - { - if (name != null && name != p.Name) - { - return false; - } - if (propertyType != null && propertyType != p.PropertyType) - { - return false; - } - if (indexParameters != null) - { - if (!p.GetIndexParameters().Select(ip => ip.ParameterType).SequenceEqual(indexParameters)) - { - return false; - } - } - - return true; - }).SingleOrDefault(); - } - - public static IEnumerable GetMember(this Type type, string name, MemberTypes memberType, BindingFlags bindingFlags) - { -#if PORTABLE - return type.GetMemberInternal(name, memberType, bindingFlags); -#else - return type.GetMember(name, bindingFlags).Where(m => - { - if ((m.MemberType() | memberType) != memberType) - { - return false; - } - - return true; - }); -#endif - } -#endif - -#if (DOTNET || PORTABLE) - public static MethodInfo GetBaseDefinition(this MethodInfo method) - { - return method.GetRuntimeBaseDefinition(); - } -#endif - -#if (DOTNET || PORTABLE) - public static bool IsDefined(this Type type, Type attributeType, bool inherit) - { - return type.GetTypeInfo().CustomAttributes.Any(a => a.AttributeType == attributeType); - } - -#if !DOTNET - - public static MethodInfo GetMethod(this Type type, string name) - { - return type.GetMethod(name, DefaultFlags); - } - - public static MethodInfo GetMethod(this Type type, string name, BindingFlags bindingFlags) - { - return type.GetTypeInfo().GetDeclaredMethod(name); - } - - public static MethodInfo GetMethod(this Type type, IList parameterTypes) - { - return type.GetMethod(null, parameterTypes); - } - - public static MethodInfo GetMethod(this Type type, string? name, IList parameterTypes) - { - return type.GetMethod(name, DefaultFlags, null, parameterTypes, null); - } - - public static MethodInfo GetMethod(this Type type, string? name, BindingFlags bindingFlags, object? placeHolder1, IList parameterTypes, object? placeHolder2) - { - return MethodBinder.SelectMethod(type.GetTypeInfo().DeclaredMethods.Where(m => (name == null || m.Name == name) && TestAccessibility(m, bindingFlags)), parameterTypes); - } - - public static IEnumerable GetConstructors(this Type type) - { - return type.GetConstructors(DefaultFlags); - } - - public static IEnumerable GetConstructors(this Type type, BindingFlags bindingFlags) - { - return type.GetTypeInfo().DeclaredConstructors.Where(c => TestAccessibility(c, bindingFlags)); - } - - public static ConstructorInfo GetConstructor(this Type type, IList parameterTypes) - { - return type.GetConstructor(DefaultFlags, null, parameterTypes, null); - } - - public static ConstructorInfo GetConstructor(this Type type, BindingFlags bindingFlags, object? placeholder1, IList parameterTypes, object? placeholder2) - { - return MethodBinder.SelectMethod(type.GetConstructors(bindingFlags), parameterTypes); - } - - public static MemberInfo[] GetMember(this Type type, string member) - { - return type.GetMemberInternal(member, null, DefaultFlags); - } - - public static MemberInfo[] GetMember(this Type type, string member, BindingFlags bindingFlags) - { - return type.GetMemberInternal(member, null, bindingFlags); - } - - public static MemberInfo[] GetMemberInternal(this Type type, string member, MemberTypes? memberType, BindingFlags bindingFlags) - { - return type.GetTypeInfo().GetMembersRecursive().Where(m => - m.Name == member && - // test type before accessibility - accessibility doesn't support some types - (memberType == null || (m.MemberType() | memberType) == memberType) && - TestAccessibility(m, bindingFlags)).ToArray(); - } - - public static FieldInfo? GetField(this Type type, string member) - { - return type.GetField(member, DefaultFlags); - } - - public static FieldInfo? GetField(this Type type, string member, BindingFlags bindingFlags) - { - FieldInfo field = type.GetTypeInfo().GetDeclaredField(member); - if (field == null || !TestAccessibility(field, bindingFlags)) - { - return null; - } - - return field; - } - - public static IEnumerable GetProperties(this Type type, BindingFlags bindingFlags) - { - IList properties = (bindingFlags.HasFlag(BindingFlags.DeclaredOnly)) - ? type.GetTypeInfo().DeclaredProperties.ToList() - : type.GetTypeInfo().GetPropertiesRecursive(); - - return properties.Where(p => TestAccessibility(p, bindingFlags)); - } - - private static bool ContainsMemberName(IEnumerable members, string name) - { - foreach (MemberInfo memberInfo in members) - { - if (memberInfo.Name == name) - { - return true; - } - } - - return false; - } - - private static IList GetMembersRecursive(this TypeInfo type) - { - TypeInfo? t = type; - List members = new List(); - while (t != null) - { - foreach (MemberInfo member in t.DeclaredMembers) - { - if (!ContainsMemberName(members, member.Name)) - { - members.Add(member); - } - } - t = t.BaseType?.GetTypeInfo(); - } - - return members; - } - - private static IList GetPropertiesRecursive(this TypeInfo type) - { - TypeInfo? t = type; - List properties = new List(); - while (t != null) - { - foreach (PropertyInfo member in t.DeclaredProperties) - { - if (!ContainsMemberName(properties, member.Name)) - { - properties.Add(member); - } - } - t = t.BaseType?.GetTypeInfo(); - } - - return properties; - } - - private static IList GetFieldsRecursive(this TypeInfo type) - { - TypeInfo? t = type; - List fields = new List(); - while (t != null) - { - foreach (FieldInfo member in t.DeclaredFields) - { - if (!ContainsMemberName(fields, member.Name)) - { - fields.Add(member); - } - } - t = t.BaseType?.GetTypeInfo(); - } - - return fields; - } - - public static IEnumerable GetMethods(this Type type, BindingFlags bindingFlags) - { - return type.GetTypeInfo().DeclaredMethods; - } - - public static PropertyInfo? GetProperty(this Type type, string name) - { - return type.GetProperty(name, DefaultFlags); - } - - public static PropertyInfo? GetProperty(this Type type, string name, BindingFlags bindingFlags) - { - PropertyInfo property = type.GetTypeInfo().GetDeclaredProperty(name); - if (property == null || !TestAccessibility(property, bindingFlags)) - { - return null; - } - - return property; - } - - public static IEnumerable GetFields(this Type type) - { - return type.GetFields(DefaultFlags); - } - - public static IEnumerable GetFields(this Type type, BindingFlags bindingFlags) - { - IList fields = (bindingFlags.HasFlag(BindingFlags.DeclaredOnly)) - ? type.GetTypeInfo().DeclaredFields.ToList() - : type.GetTypeInfo().GetFieldsRecursive(); - - return fields.Where(f => TestAccessibility(f, bindingFlags)).ToList(); - } - - private static bool TestAccessibility(PropertyInfo member, BindingFlags bindingFlags) - { - if (member.GetMethod != null && TestAccessibility(member.GetMethod, bindingFlags)) - { - return true; - } - - if (member.SetMethod != null && TestAccessibility(member.SetMethod, bindingFlags)) - { - return true; - } - - return false; - } - - private static bool TestAccessibility(MemberInfo member, BindingFlags bindingFlags) - { - if (member is FieldInfo f) - { - return TestAccessibility(f, bindingFlags); - } - else if (member is MethodBase m) - { - return TestAccessibility(m, bindingFlags); - } - else if (member is PropertyInfo p) - { - return TestAccessibility(p, bindingFlags); - } - - throw new ArgumentOutOfRangeException("Unexpected member type."); - } - - private static bool TestAccessibility(FieldInfo member, BindingFlags bindingFlags) - { - bool visibility = (member.IsPublic && bindingFlags.HasFlag(BindingFlags.Public)) || - (!member.IsPublic && bindingFlags.HasFlag(BindingFlags.NonPublic)); - - bool instance = (member.IsStatic && bindingFlags.HasFlag(BindingFlags.Static)) || - (!member.IsStatic && bindingFlags.HasFlag(BindingFlags.Instance)); - - return visibility && instance; - } - - private static bool TestAccessibility(MethodBase member, BindingFlags bindingFlags) - { - bool visibility = (member.IsPublic && bindingFlags.HasFlag(BindingFlags.Public)) || - (!member.IsPublic && bindingFlags.HasFlag(BindingFlags.NonPublic)); - - bool instance = (member.IsStatic && bindingFlags.HasFlag(BindingFlags.Static)) || - (!member.IsStatic && bindingFlags.HasFlag(BindingFlags.Instance)); - - return visibility && instance; - } - - public static Type[] GetGenericArguments(this Type type) - { - return type.GetTypeInfo().GenericTypeArguments; - } - - public static IEnumerable GetInterfaces(this Type type) - { - return type.GetTypeInfo().ImplementedInterfaces; - } - - public static IEnumerable GetMethods(this Type type) - { - return type.GetTypeInfo().DeclaredMethods; - } -#endif -#endif - - public static bool IsAbstract(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsAbstract; -#else - return type.GetTypeInfo().IsAbstract; -#endif - } - - public static bool IsVisible(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsVisible; -#else - return type.GetTypeInfo().IsVisible; -#endif - } - - public static bool IsValueType(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsValueType; -#else - return type.GetTypeInfo().IsValueType; -#endif - } - - public static bool IsPrimitive(this Type type) - { -#if HAVE_FULL_REFLECTION - return type.IsPrimitive; -#else - return type.GetTypeInfo().IsPrimitive; -#endif - } - - public static bool AssignableToTypeName(this Type type, string fullTypeName, bool searchInterfaces, [NotNullWhen(true)]out Type? match) - { - Type current = type; - - while (current != null) - { - if (string.Equals(current.FullName, fullTypeName, StringComparison.Ordinal)) - { - match = current; - return true; - } - - current = current.BaseType(); - } - - if (searchInterfaces) - { - foreach (Type i in type.GetInterfaces()) - { - if (string.Equals(i.Name, fullTypeName, StringComparison.Ordinal)) - { - match = type; - return true; - } - } - } - - match = null; - return false; - } - - public static bool AssignableToTypeName(this Type type, string fullTypeName, bool searchInterfaces) - { - return type.AssignableToTypeName(fullTypeName, searchInterfaces, out _); - } - - public static bool ImplementInterface(this Type type, Type interfaceType) - { - for (Type currentType = type; currentType != null; currentType = currentType.BaseType()) - { - IEnumerable interfaces = currentType.GetInterfaces(); - foreach (Type i in interfaces) - { - if (i == interfaceType || (i != null && i.ImplementInterface(interfaceType))) - { - return true; - } - } - } - - return false; - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/Utilities/ValidationUtils.cs b/Source/MyDb/Newtonsoft.Json/Utilities/ValidationUtils.cs deleted file mode 100644 index df17082..0000000 --- a/Source/MyDb/Newtonsoft.Json/Utilities/ValidationUtils.cs +++ /dev/null @@ -1,42 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; -using System.Diagnostics.CodeAnalysis; -using System.Runtime.CompilerServices; - -namespace Newtonsoft.Json.Utilities -{ - internal static class ValidationUtils - { - public static void ArgumentNotNull([NotNull]object? value, string parameterName) - { - if (value == null) - { - throw new ArgumentNullException(parameterName); - } - } - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/WriteState.cs b/Source/MyDb/Newtonsoft.Json/WriteState.cs deleted file mode 100644 index adf3ab0..0000000 --- a/Source/MyDb/Newtonsoft.Json/WriteState.cs +++ /dev/null @@ -1,72 +0,0 @@ -#region License -// Copyright (c) 2007 James Newton-King -// -// Permission is hereby granted, free of charge, to any person -// obtaining a copy of this software and associated documentation -// files (the "Software"), to deal in the Software without -// restriction, including without limitation the rights to use, -// copy, modify, merge, publish, distribute, sublicense, and/or sell -// copies of the Software, and to permit persons to whom the -// Software is furnished to do so, subject to the following -// conditions: -// -// The above copyright notice and this permission notice shall be -// included in all copies or substantial portions of the Software. -// -// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES -// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, -// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -// OTHER DEALINGS IN THE SOFTWARE. -#endregion - -using System; - -namespace Newtonsoft.Json -{ - /// - /// Specifies the state of the . - /// - public enum WriteState - { - /// - /// An exception has been thrown, which has left the in an invalid state. - /// You may call the method to put the in the Closed state. - /// Any other method calls result in an being thrown. - /// - Error = 0, - - /// - /// The method has been called. - /// - Closed = 1, - - /// - /// An object is being written. - /// - Object = 2, - - /// - /// An array is being written. - /// - Array = 3, - - /// - /// A constructor is being written. - /// - Constructor = 4, - - /// - /// A property is being written. - /// - Property = 5, - - /// - /// A write method has not been called. - /// - Start = 6 - } -} \ No newline at end of file diff --git a/Source/MyDb/Newtonsoft.Json/packageIcon.png b/Source/MyDb/Newtonsoft.Json/packageIcon.png deleted file mode 100644 index 10c06a5..0000000 Binary files a/Source/MyDb/Newtonsoft.Json/packageIcon.png and /dev/null differ diff --git a/Source/MyDb/Properties/AssemblyInfo.cs b/Source/MyDb/Properties/AssemblyInfo.cs index 950931c..24de577 100644 --- a/Source/MyDb/Properties/AssemblyInfo.cs +++ b/Source/MyDb/Properties/AssemblyInfo.cs @@ -32,5 +32,5 @@ using System; //可以指定所有这些值，也可以使用“生成号”和“修订号”的默认值， // 方法是按如下所示使用“*”: : // [assembly: AssemblyVersion("1.0.*")] -[assembly: AssemblyVersion("3.0.2205.2601")] -[assembly: AssemblyFileVersion("3.0.2205.2601")] \ No newline at end of file +[assembly: AssemblyVersion("3.0.2302.0801")] +[assembly: AssemblyFileVersion("3.0.2302.0801")] \ No newline at end of file diff --git a/Source/MyDb/RyWeb/HttpHelper.cs b/Source/MyDb/RyWeb/HttpHelper.cs index 07184f2..950d832 100644 --- a/Source/MyDb/RyWeb/HttpHelper.cs +++ b/Source/MyDb/RyWeb/HttpHelper.cs @@ -1,13 +1,14 @@ -// 类说明：HttpHelper类，用来实现Http访问，Post或者Get方式的，直接访问，带Cookie的，带证书的等方式，可以设置代理 +// +// 类说明：HttpHelper类，用来实现Http访问，Post或者Get方式的，直接访问，带Cookie的，带证书的等方式，可以设置代理 // 重要提示：请不要自行修改本类，如果因为你自己修改后将无法升级到新版本。如果确实有什么问题请到官方网站提建议， // 我们一定会及时修改 // 编码日期：2011-09-20 // 编 码 人：苏飞 -// 联系方式：361983679 +// 联系方式：361983679 // 官方网址：http://www.sufeinet.com/thread-3-1-1.html -// 修改日期：2017-01-16 -// 版 本 号：1.8 - +// 修改日期：2022-12-01 +// 版 本 号：2.3.6 +// using System; using System.Collections.Generic; using System.Text; @@ -72,13 +73,13 @@ namespace DotNet4.Utilities { if (!text2.Contains("path=")) { - if (!text2.Contains("expires=")) + if (!text2.Contains("expires=") && !text2.Contains("max-age=")) { if (!text2.Contains("domain=")) { if (!list.Contains(text)) { - list.Add(string.Format("{0};", text)); + list.Add(text); } } } @@ -136,6 +137,12 @@ namespace DotNet4.Utilities result.Html = ex.Message; } if (item.IsToLower) result.Html = result.Html.ToLower(); + //重置request，response为空 + if (item.IsReset) + { + request = null; + response = null; + } return result; } #endregion @@ -169,8 +176,10 @@ namespace DotNet4.Utilities #endregion #region byte + //处理网页Byte byte[] ResponseByte = GetByte(); + #endregion #region Html @@ -201,31 +210,11 @@ namespace DotNet4.Utilities //从这里开始我们要无视编码了 if (encoding == null) { + Match meta = Regex.Match(Encoding.Default.GetString(ResponseByte), " 0) { - int pos = charset.IndexOf("charset=", StringComparison.OrdinalIgnoreCase); - if(pos>0) - { - c = charset.Substring(pos + "charset=".Length); - } - //System.IO.File.AppendAllText(@"G:\程序开发源码\QO流程管理\Bin\Debug\1122.txt", charset+" "+ c); - } - if(c== string.Empty) - { - Match meta = Regex.Match(Encoding.Default.GetString(ResponseByte), " 0) - { - c = meta.Groups[1].Value.ToLower().Trim(); - } - } - if (c == string.Empty) - { - if(item.URL.ToLower().Replace("https://","").IndexOf("http://api.dataoke.com/index.php")==0) - { - c = "gb2312"; - } + c = meta.Groups[1].Value.ToLower().Trim(); } if (c.Length > 2) { @@ -271,12 +260,12 @@ namespace DotNet4.Utilities if (response.ContentEncoding != null && response.ContentEncoding.Equals("gzip", StringComparison.InvariantCultureIgnoreCase)) { //开始读取流并设置编码方式 - new GZipStream(response.GetResponseStream(), CompressionMode.Decompress).CopyTo(_stream, 10240); + new GZipStream(response.GetResponseStream(), CompressionMode.Decompress).CopyTo(_stream, 1024); } else { //开始读取流并设置编码方式 - response.GetResponseStream().CopyTo(_stream, 10240); + response.GetResponseStream().CopyTo(_stream, 1024); } //获取Byte ResponseByte = _stream.ToArray(); @@ -323,6 +312,10 @@ namespace DotNet4.Utilities request.Host = item.Host; } if (item.IfModifiedSince != null) request.IfModifiedSince = Convert.ToDateTime(item.IfModifiedSince); + if (item.Date != null) + { + request.Date = Convert.ToDateTime(item.Date); + } //Accept request.Accept = item.Accept; //ContentType返回类型 @@ -397,7 +390,14 @@ namespace DotNet4.Utilities { request.CookieContainer = new CookieContainer(); if (item.CookieCollection != null && item.CookieCollection.Count > 0) + { + //默认为20个，如果超出需要增加长度 + if (item.CookieCollection.Count > 20) + { + request.CookieContainer.PerDomainCapacity = item.CookieCollection.Count; + } request.CookieContainer.Add(item.CookieCollection); + } } } /// @@ -458,21 +458,17 @@ namespace DotNet4.Utilities if (item.ProxyIp.Contains(":")) { string[] plist = item.ProxyIp.Split(':'); - WebProxy myProxy = new WebProxy(plist[0].Trim(), Convert.ToInt32(plist[1].Trim())) - { - //建议连接 - Credentials = new NetworkCredential(item.ProxyUserName, item.ProxyPwd) - }; + WebProxy myProxy = new WebProxy(plist[0].Trim(), Convert.ToInt32(plist[1].Trim())); + //建议连接 + myProxy.Credentials = new NetworkCredential(item.ProxyUserName, item.ProxyPwd); //给当前请求对象 request.Proxy = myProxy; } else { - WebProxy myProxy = new WebProxy(item.ProxyIp, false) - { - //建议连接 - Credentials = new NetworkCredential(item.ProxyUserName, item.ProxyPwd) - }; + WebProxy myProxy = new WebProxy(item.ProxyIp, false); + //建议连接 + myProxy.Credentials = new NetworkCredential(item.ProxyUserName, item.ProxyPwd); //给当前请求对象 request.Proxy = myProxy; } @@ -642,6 +638,15 @@ namespace DotNet4.Utilities get { return isToLower; } set { isToLower = value; } } + private DateTime? _Date = null; + /// + /// 获取或设置要在 HTTP 请求中使用的 Date HTTP 标头值。默认不填写 + /// + public DateTime? Date + { + get { return _Date; } + set { _Date = value; } + } private Boolean allowautoredirect = false; /// /// 支持跳转页面，查询结果将是跳转后的页面，默认是不跳转 @@ -690,9 +695,9 @@ namespace DotNet4.Utilities get { return header; } set { header = value; } } - /// - /// 获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 - /// + /// + ///获取或设置用于请求的 HTTP 版本。返回结果:用于请求的 HTTP 版本。默认为 System.Net.HttpVersion.Version11。 + /// public Version ProtocolVersion { get; set; } private Boolean _expect100continue = false; /// @@ -756,6 +761,16 @@ namespace DotNet4.Utilities set { _IPEndPoint = value; } } #endregion + + private bool _isReset = false; + /// + /// 是否重置request,response的值，默认不重置，当设置为True时request,response将被设置为Null + /// + public bool IsReset + { + get { return _isReset; } + set { _isReset = value; } + } } /// /// Http返回参数类 diff --git a/Source/MyDb/RyWeb/HttpServer.cs b/Source/MyDb/RyWeb/HttpServer.cs index fce9e12..f9461fe 100644 --- a/Source/MyDb/RyWeb/HttpServer.cs +++ b/Source/MyDb/RyWeb/HttpServer.cs @@ -55,6 +55,7 @@ namespace RyWeb listener = new HttpListener(); this.port= port; listener.Prefixes.Add("http://"+ ListenerHost + ":" + port + "/"); + listener.Prefixes.Add("http://127.0.0.1:" + port + "/"); //listener.Prefixes.Add(HTTPS_PREFIX + HTTPS_PORT + "/"); listener.Start(); httpThread = new Thread(new ThreadStart(Run)); @@ -85,6 +86,7 @@ namespace RyWeb { listener = new HttpListener(); listener.Prefixes.Add("http://"+ ListenerHost + ":" + port + "/"); + listener.Prefixes.Add("http://127.0.0.1:" + port + "/"); //listener.Prefixes.Add(HTTPS_PREFIX + HTTPS_PORT + "/"); listener.Start(); } @@ -168,6 +170,7 @@ namespace RyWeb HttpRequest e = new HttpRequest(); e.Url = req.Url; e.UrlReferrer = req.UrlReferrer; + e.GetData = RyWeb.WebDecode.UrlToData(e.Url.AbsoluteUri); OnHandleGETRequest?.Invoke(this,e); resp.StatusCode = (int)e.StatusCode; html = e.ReturnHtml; @@ -179,16 +182,20 @@ namespace RyWeb Url = req.Url, UrlReferrer = req.UrlReferrer }; - var sr = new StreamReader(req.InputStream, Encoding.GetEncoding("GB2312")); + var sr = new StreamReader(req.InputStream, Encoding.GetEncoding("utf-8")); e.PostDataStr = sr.ReadToEnd(); - e.PostData= RyWeb.WebDecode.UrlToData(e.PostDataStr); + e.GetData = RyWeb.WebDecode.UrlToData(e.Url.AbsoluteUri); + e.PostData= RyWeb.WebDecode.UrlToData("f?"+e.PostDataStr); sr.Close(); OnHandlePOSTRequest?.Invoke(this, e); resp.StatusCode = (int)e.StatusCode; html = e.ReturnHtml; } - var buffer = Encoding.UTF8.GetBytes(html); + resp.ContentEncoding= Encoding.GetEncoding("utf-8"); + var buffer = Encoding.GetEncoding("utf-8").GetBytes(html); resp.ContentLength64 = buffer.Length; + resp.Headers.Add("Content-Type:text/html; charset=utf-8"); + resp.Headers.Add("Access-Control-Allow-Origin: *"); resp.OutputStream.Write(buffer, 0, buffer.Length); var outs = resp.OutputStream; outs.Close(); @@ -211,20 +218,24 @@ namespace RyWeb /// /// /// + internal Tuple>> GetData { get; set; } + /// + /// + /// internal Tuple>> PostData { get; set; } /// /// /// public string GetPostData(string Param) { - return PostData.Get(Param); + return RyWeb.WebDecode.UrlDecode(PostData.Get(Param)); } /// /// /// public string GetPostData(string Param,string defValue) { - return PostData.Get(Param, defValue); + return RyWeb.WebDecode.UrlDecode(PostData.Get(Param, defValue)); } /// /// @@ -243,6 +254,34 @@ namespace RyWeb /// /// /// + public string GetUrlData(string Param) + { + return RyWeb.WebDecode.UrlDecode(GetData.Get(Param)); + } + /// + /// + /// + public string GetUrlData(string Param, string defValue) + { + return RyWeb.WebDecode.UrlDecode(GetData.Get(Param, defValue)); + } + /// + /// + /// + public int GetUrlData(string Param, int defValue) + { + return GetData.Get(Param, defValue); + } + /// + /// + /// + public bool GetUrlData(string Param, bool defValue) + { + return GetData.Get(Param, defValue); + } + /// + /// + /// public Uri UrlReferrer { get; internal set; } /// /// diff --git a/Source/MyDb/RyWeb/QuickWeb.cs b/Source/MyDb/RyWeb/QuickWeb.cs index f6d541d..8589480 100644 --- a/Source/MyDb/RyWeb/QuickWeb.cs +++ b/Source/MyDb/RyWeb/QuickWeb.cs @@ -84,9 +84,10 @@ namespace RyWeb UserAgent = UserAgent, Referer=Referer, KeepAlive = false, - ProxyIp= ProxyIp + ProxyIp= ProxyIp, + Allowautoredirect= AllowAutoRedirect }; - if (cookie.Length > 0) + if (cookie!=null && cookie.Length > 0) { m.Cookie = cookie; } @@ -134,7 +135,7 @@ namespace RyWeb { URL = url, Method = "HEAD", - Allowautoredirect = true, + Allowautoredirect = AllowAutoRedirect, Cookie = cookie, Timeout = Timeout, ReadWriteTimeout = Timeout, @@ -179,7 +180,7 @@ namespace RyWeb { System.Net.ServicePointManager.DefaultConnectionLimit = 512; HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url); - request.AllowAutoRedirect = true; + request.AllowAutoRedirect = AllowAutoRedirect; request.Timeout = 3000; request.ReadWriteTimeout = 3000; HttpWebResponse response = (HttpWebResponse)request.GetResponse(); @@ -210,6 +211,13 @@ namespace RyWeb get; set; } = "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0)"; /// + /// 是否自动跳转 + /// + public bool AllowAutoRedirect + { + get; set; + } = true; + /// /// 获取网页源码 /// /// @@ -226,12 +234,12 @@ namespace RyWeb ContentType= "application/x-www-form-urlencoded", KeepAlive = false }; - if (cookie.Length>0) + if (cookie != null && cookie.Length>0) { m.Cookie = cookie; } m.UserAgent = UserAgent; - m.Allowautoredirect = true; + m.Allowautoredirect = AllowAutoRedirect; m.Timeout = Timeout; m.ReadWriteTimeout = Timeout; m.Referer = Referer; @@ -271,7 +279,7 @@ namespace RyWeb } m.UserAgent = UserAgent; m.Encoding = encoding; - m.Allowautoredirect = true; + m.Allowautoredirect = AllowAutoRedirect; m.Timeout = Timeout; m.ReadWriteTimeout = Timeout; m.Referer = Referer; @@ -333,6 +341,15 @@ namespace RyWeb } return (sb.ToString()); } + /// + /// + /// + /// + /// + public string UrlEncode(string str) + { + return UrlEncode(str, Encoding.UTF8); + } private readonly string cookie = ""; /// /// 将相对网址转换成绝对网址 diff --git a/Source/MyDb/RyWeb/WebDav.cs b/Source/MyDb/RyWeb/WebDav.cs new file mode 100644 index 0000000..bc2b946 --- /dev/null +++ b/Source/MyDb/RyWeb/WebDav.cs @@ -0,0 +1,335 @@ +using System; +using System.Collections.Generic; +using System.Drawing; +using System.Globalization; +using System.IO; +using System.Linq; +using System.Net; +using System.Text; +using System.Windows.Forms; +using System.Xml; + +namespace RyWeb +{ + /// + /// WebDav接口 + /// + public class WebDav + { + private string _UserName = ""; + private string _Password = ""; + private string _WebDavUrl = ""; + /// + /// WebDav初始化 + /// + /// + /// + /// + public WebDav(string _WebDavUrl, string _UserName, string _Password) + { + this._UserName = _UserName; + this._Password = _Password; + this._WebDavUrl = _WebDavUrl; + } + /// + /// 删除文件 + /// + /// 相对路径,不包括域名 + /// + public int DelFile(string _WebFilePath) + { + try + { + HttpWebRequest req = (HttpWebRequest)WebRequest.Create(new Uri(_WebDavUrl + "/" + _WebFilePath)); + req.Credentials = new NetworkCredential(_UserName, _Password); //验证密码 + req.PreAuthenticate = true; + req.Method = "DELETE"; + //req.AllowWriteStreamBuffering = true; + + req.GetResponse(); + return 1; + } + catch { return 0; } + } + /// + /// 下载文件 + /// + /// + /// + /// + public int Download(string _WebFilePath, string _SavePath) + { + return Download(_WebFilePath, _SavePath,out _); + } + /// + /// 下载文件 + /// + /// + /// + /// + /// + public int Download(string _WebFilePath,string _SavePath,out string error) + { + error = ""; + try + { + System.Uri myURi = new System.Uri(_WebFilePath); + WebRequest req = WebRequest.Create(myURi); + req.Credentials = new NetworkCredential(_UserName, _Password); //验证密码 + req.Method = "GET"; + req.Timeout = System.Threading.Timeout.Infinite; + WebResponse res = req.GetResponse(); + Stream inStream = res.GetResponseStream(); + + FileStream fs = new FileStream(_SavePath, FileMode.OpenOrCreate); + + byte[] inData = new byte[4096]; + int bytesRead = inStream.Read(inData, 0, inData.Length); + while (bytesRead > 0) + { + fs.Write(inData, 0, bytesRead); + bytesRead = inStream.Read(inData, 0, inData.Length); + } + fs.Close(); + inStream.Close(); + } + catch(Exception ex) + { + error = ex.Message; + return -1; + } + return 1; + } + /// + /// 上传文件 + /// + /// + /// + /// + public int Upload(string _WebFilePath, string _LocalFile) + { + return Upload(_WebFilePath, _LocalFile,out _); + } + /// + /// 上传文件 + /// + /// + /// + /// + /// + public int Upload(string _WebFilePath, string _LocalFile,out string error) + { + error = ""; + try + { + System.Net.HttpWebRequest req = (System.Net.HttpWebRequest)WebRequest.Create(new Uri(_WebDavUrl + "/" + _WebFilePath)); //Http和服务器交互 + req.Credentials = new NetworkCredential(_UserName, _Password); //验证密码 + req.PreAuthenticate = true; + req.Method = "PUT";//采用PUT方式 + req.AllowWriteStreamBuffering = true; + + Stream reqStream = req.GetRequestStream(); + FileStream rdm = new FileStream(_LocalFile, FileMode.Open); //打开本地文件流 + + byte[] inData = new byte[4096]; + int byteRead = rdm.Read(inData, 0, inData.Length); //二进制读文件 + while (byteRead > 0) + { + reqStream.Write(inData, 0, byteRead); //响应流写入 + byteRead = rdm.Read(inData, 0, inData.Length); + } + rdm.Close(); + reqStream.Close(); + + req.GetResponse(); //提交 + } + catch (Exception e) + { + error=e.Message; + return 0; + } + return 1; //正确返回 + } + //----新建文件夾---- + /// + /// 新建文件夹 + /// + /// + /// + public int CreateDir(string Path) + { + return CreateDir(Path, out _); + } + //----新建文件夾---- + /// + /// 新建文件夹 + /// + /// 文件夹路径 + /// + /// + public int CreateDir(string Path,out string error) + { + error = ""; + var dir_split = Path.Split('/'); + var path = ""; + for (int i = 0; i < dir_split.Length; i++) + { + if (dir_split[i].Length == 0) { continue; } + if (path.Length > 0) { path += "/"; } + path += dir_split[i]; + _createdir(path, out var _error); + if(_error.Length>0) + { + error = _error; + } + } + if (error.Length == 0) + { + return 1; + } + else + { + return 0; + } + } + //----新建文件夾---- + /// + /// 新建文件夹 + /// + /// + /// + /// + private int _createdir(string Path, out string error) + { + error = ""; + try + { + // Create the HttpWebRequest object. + System.Net.HttpWebRequest req = (System.Net.HttpWebRequest)WebRequest.Create(new Uri(_WebDavUrl + "/" + Path)); //Http和服务器交互 + req.Credentials = new NetworkCredential(_UserName, _Password); //验证密码 + // Specify the method. + req.Method = "MKCOL"; + + HttpWebResponse objResponse = (System.Net.HttpWebResponse)req.GetResponse(); + + // Close the HttpWebResponse object. + objResponse.Close(); + return 1; + } + catch (Exception ex) + { + error = ex.Message; + return 0; + } + } + /// + ///将文件或目录列出来 + /// + /// + /// + /// + public SortedList GetContents(string Path, bool deep) + { + var uri = new Uri(_WebDavUrl + "/" + Path); + HttpWebRequest _httpWebRequest = (HttpWebRequest)HttpWebRequest.Create(uri); + _httpWebRequest.Headers.Add("Translate: f"); + _httpWebRequest.Credentials = new NetworkCredential(_UserName, _Password); //验证密码 + string _requestString = @"" + + @"" + + "" + + "" + + "" + + "" + + "" + + ""; + + _httpWebRequest.Method = "PROPFIND"; + if (deep == true) + _httpWebRequest.Headers.Add("Depth: infinity"); + else + _httpWebRequest.Headers.Add("Depth: 1"); + _httpWebRequest.ContentLength = _requestString.Length; + _httpWebRequest.ContentType = "text/xml"; + + Stream _requestStream = _httpWebRequest.GetRequestStream(); + _requestStream.Write(Encoding.UTF8.GetBytes(_requestString), 0, Encoding.ASCII.GetBytes(_requestString).Length); + _requestStream.Close(); + + HttpWebResponse _httpWebResponse; + StreamReader _streamReader; + try + { + _httpWebResponse = (HttpWebResponse)_httpWebRequest.GetResponse(); + _streamReader = new StreamReader(_httpWebResponse.GetResponseStream()); + } + catch (WebException ex) + { + throw ex; + } + + StringBuilder _stringBuilder = new StringBuilder(); + + char[] _chars = new char[1024]; + int _bytesRead = 0; + + _bytesRead = _streamReader.Read(_chars, 0, 1024); + + while (_bytesRead > 0) + { + _stringBuilder.Append(_chars, 0, _bytesRead); + _bytesRead = _streamReader.Read(_chars, 0, 1024); + } + _streamReader.Close(); + + XmlDocument _xmlDocument = new XmlDocument(); + _xmlDocument.LoadXml(_stringBuilder.ToString()); + + XmlNamespaceManager _xmlNamespaceManager = new XmlNamespaceManager(_xmlDocument.NameTable); + _xmlNamespaceManager.AddNamespace("a", "DAV:"); + + XmlNodeList _nameList = _xmlDocument.SelectNodes("//a:prop/a:displayname", _xmlNamespaceManager); + XmlNodeList _isFolderList = _xmlDocument.SelectNodes("//a:prop/a:iscollection", _xmlNamespaceManager); + XmlNodeList _lastModifyList = _xmlDocument.SelectNodes("//a:prop/a:getlastmodified", _xmlNamespaceManager); + XmlNodeList _hrefList = _xmlDocument.SelectNodes("//a:href", _xmlNamespaceManager); + + SortedList _sortedListResult = new SortedList(); + ServerFileAttributes _serverFileAttributes; + + for (int i = 0; i < _nameList.Count; i++) + { + if (_hrefList[i].InnerText.ToLower(new CultureInfo("en-US")).TrimEnd(new char[] { '/' }) != uri.AbsoluteUri.ToLower(new CultureInfo("en-US")).TrimEnd(new char[] { '/' })) + { + _serverFileAttributes = new ServerFileAttributes(); + _serverFileAttributes.Name = _nameList[i].InnerText; + _serverFileAttributes.IsFolder = Convert.ToBoolean(Convert.ToInt32(_isFolderList[i].InnerText)); + _serverFileAttributes.Url = _hrefList[i].InnerText; + _serverFileAttributes.LastModified = Convert.ToDateTime(_lastModifyList[i].InnerText); + _sortedListResult.Add(_serverFileAttributes.Url, _serverFileAttributes); + } + } + return _sortedListResult; + } + } + /// + /// 定义每个文件或目录的属性 + /// + public struct ServerFileAttributes + { + /// + /// 文件名 + /// + public string Name; + /// + /// 是否是文件夹 + /// + public bool IsFolder; + /// + /// 网址 + /// + public string Url; + /// + /// 最后修改时间 + /// + public DateTime LastModified; + } +} diff --git a/Source/MyDb/SysFuns/MultiThread.cs b/Source/MyDb/SysFuns/MultiThread.cs new file mode 100644 index 0000000..5f1f530 --- /dev/null +++ b/Source/MyDb/SysFuns/MultiThread.cs @@ -0,0 +1,180 @@ +using System; +using System.Collections.Generic; +using System.ComponentModel; +using System.Linq; +using System.Text; +using System.Threading; + +namespace ryCommon +{ + /// + /// + /// + public class RyThreadInfo + { + /// + /// + /// + public int start = 0; + /// + /// + /// + public int end = 0; + } + /// + /// + /// + public class MultiThread + { + /// + /// 设置线程数量 + /// + public int ThreadCount + { + get; set; + } = 20; + /// + /// 要计算的总数量 + /// + public int CalcCount + { get; set; } + /// + /// 每个线程要计算的数量 + /// + public int EveryThreadCalcCount + { + get; set; + } + /// + /// + /// + public MultiThread() + { } + private int CompleCount = 0; + private int CompleIndex = 0; + private DateTime startTime; + /// + /// 当前已使用的时间 + /// + public TimeSpan UseTime + { + get { return (DateTime.Now - startTime); } + } + private static readonly object CompleIndexlocker = new object(); + /// + /// + /// + /// 线程数量 + /// 要计算的事务数量 + public MultiThread(int threadCount, int calcCount) + { + ThreadCount = threadCount; + CalcCount = calcCount; + } + private Thread[] _MultiThread; + /// + /// + /// + public void Start() + { + startTime = DateTime.Now; + int _ThreadCount = ThreadCount; + //线程数量大于地址总数 + if (ThreadCount > CalcCount) + { + _ThreadCount = CalcCount; + } + if (_ThreadCount == 0) + { + EveryThreadCalcCount =0; + OnAllCalcComplete?.Invoke(this, UseTime); + return; + } + else + { + EveryThreadCalcCount = (CalcCount / _ThreadCount); + } + System.Net.ServicePointManager.DefaultConnectionLimit = 1024; + if (_MultiThread != null) + { + for (int i = 0; i < _MultiThread.Length; i++) + { + if (_MultiThread[i] != null) { _MultiThread[i].Abort(); } + } + } + CompleIndex = 0; + CompleCount = _ThreadCount; + _MultiThread = new Thread[_ThreadCount]; + for (int i = 0; i < _ThreadCount; i++) + { + _MultiThread[i] = new Thread(new ThreadStart(Calc)); + ryCommon.Storage tStor = new ryCommon.Storage(); + tStor.AddNode2("id", "Info"); + tStor.SetAttrValue("start", EveryThreadCalcCount * i); + if (i == _ThreadCount - 1) + { + tStor.SetAttrValue("end", (CalcCount - 1).ToString()); + } + else + { + + tStor.SetAttrValue("end", ((EveryThreadCalcCount * (i + 1)) - 1).ToString()); + } + tStor.SetAttrValue("index", i.ToString()); + _MultiThread[i].Name = tStor.GetXMLText(); + _MultiThread[i].Start(); + } + } + /// + /// + /// + /// + /// + public delegate void ThreadHandler(object sender, RyThreadInfo e); + /// + /// + /// + /// + /// + public delegate void CompleteHandler(object sender, TimeSpan e); + /// + /// 多线程计算时激发 + /// + [Description("多线程计算时激发")] + public event ThreadHandler OnCalc; + /// + /// 在所有线程执行完毕后发生 + /// + [Description("在所有线程执行完毕后发生")] + public event CompleteHandler OnAllCalcComplete; + /// + /// 在线程执行完毕后发生,最后一个执行完毕的线程将不收到本事件通知 + /// + [Description("在线程执行完毕后发生,最后一个执行完毕的线程将不收到本事件通知")] + public event EventHandler OnCalcComplete; + private void Calc() + { + if(OnCalc!=null) + { + RyThreadInfo item = new RyThreadInfo(); + ryCommon.Storage tStor = new ryCommon.Storage(Thread.CurrentThread.Name); + tStor.SelectNode2("id", "Info"); + item.start = tStor.GetAttrValueByInt("start", 0); + item.end = tStor.GetAttrValueByInt("end", 0); + OnCalc(this, item); + } + lock (CompleIndexlocker) + { + CompleIndex++; + if (CompleIndex == CompleCount) + { + OnAllCalcComplete?.Invoke(this, UseTime); + } + else + { + OnCalcComplete?.Invoke(this, new EventArgs()); + } + } + } + } +} diff --git a/Source/MyDb/SysFuns/ProcessExt.cs b/Source/MyDb/SysFuns/ProcessExt.cs new file mode 100644 index 0000000..7a46ae9 --- /dev/null +++ b/Source/MyDb/SysFuns/ProcessExt.cs @@ -0,0 +1,82 @@ +using _SCREEN_CAPTURE; +using System; +using System.Collections.Generic; +using System.Diagnostics; +using System.IO; +using System.Linq; +using System.Runtime.InteropServices; +using System.Text; + +namespace ryCommon +{ + /// + /// 进程相关接口 + /// + public static class ProcessExt + { + [DllImport("psapi.dll")] + static extern uint GetModuleFileNameEx(IntPtr hProcess, IntPtr hModule, [Out] StringBuilder lpBaseName, [In][MarshalAs(UnmanagedType.U4)] int nSize); + /// + /// 获取进程路径 + /// + /// + /// + public static string GetPath(this Process process) + { + if (process == null) + { + return ""; + } + return GetPath(process.Id); + } + /// + /// 获取进程路径 + /// + /// + /// + public static string GetPath(int pid) + { + var processHandle =WinAPI.Kernel32.OpenProcess(0x0400 | 0x0010, false, pid); + if (processHandle == IntPtr.Zero) + { + return null; + } + const int lengthSb = 4000; + var sb = new StringBuilder(lengthSb); + string result = ""; + if (GetModuleFileNameEx(processHandle, IntPtr.Zero, sb, lengthSb) > 0) + { + result = sb.ToString(); + } + WinAPI.Kernel32.CloseHandle(processHandle); + return result; + } + /// + /// 获取命令行 + /// + /// + /// + public static string GetCommandLines(this System.Diagnostics.Process processs) + { + if (processs == null) { return ""; } + return GetCommandLines(processs.Id); + } + /// + /// 获取命令行 + /// + /// + /// + public static string GetCommandLines(int pid) + { + System.Management.ManagementObjectSearcher commandLineSearcher = new System.Management.ManagementObjectSearcher( + "SELECT CommandLine FROM Win32_Process WHERE ProcessId = " + pid); + string commandLine = ""; + foreach (var commandLineObject in commandLineSearcher.Get()) + { + commandLine += (string)commandLineObject["CommandLine"]; + } + commandLineSearcher.Dispose(); + return commandLine; + } + } +} diff --git a/Source/MyDb/SysFuns/RyForm.cs b/Source/MyDb/SysFuns/RyForm.cs index 3271140..00bd43d 100644 --- a/Source/MyDb/SysFuns/RyForm.cs +++ b/Source/MyDb/SysFuns/RyForm.cs @@ -1,222 +1,220 @@ -using System; -using System.Collections.Generic; -using System.Drawing; -using System.Linq; -using System.Runtime.InteropServices; -using System.Text; -using System.Windows.Forms; -using WinAPI; - -namespace ryCommon -{ - /// - /// 窗体操作类 - /// - public class RyForm - { - /// - /// 设置Comobox的行间距 - /// - /// - /// - public static void CmbBind(ComboBox list, int itemHeight) - { - list.DropDownStyle = ComboBoxStyle.DropDownList; - list.ItemHeight = itemHeight; - list.DrawMode = DrawMode.OwnerDrawFixed; - list.DrawItem += new DrawItemEventHandler(delegate (object sender, DrawItemEventArgs e) - { - if (e.Index < 0) - { - return; - } - e.DrawBackground(); - e.DrawFocusRectangle(); - e.Graphics.DrawString(list.Items[e.Index].ToString(), e.Font, new SolidBrush(e.ForeColor), e.Bounds.X, e.Bounds.Y + 3); - }); - } - /// - /// 移除关闭按钮。返回值，非零表示成功，零表示失败。 - /// - /// 窗口的句柄 - /// 是否成功 - public static int RemoveXButton(IntPtr iHWND) - { - int iSysMenu; - const int MF_BYCOMMAND = 0x400; //0x400-关闭 - iSysMenu = User32.GetSystemMenu(iHWND, 0); - return User32.RemoveMenu(iSysMenu, 6, MF_BYCOMMAND); - } - /// - /// 把窗体放到最前 - /// - /// - public static void BringToTop(IntPtr iHWND) - { - User32.SetForegroundWindow(iHWND); - } - /// - /// 显示窗体 - /// - /// - /// - /// - [DllImport("user32.dll", CharSet = CharSet.Auto, ExactSpelling = true)] - public static extern bool ShowWindow(HandleRef hWnd, int nCmdShow); - [DllImport("user32.dll", CharSet = CharSet.Auto)] - private static extern int SetWindowPos(IntPtr hWnd, int hWndInsertAfter, int x, int y, int Width, int Height, int flags); - private const int HWND_TOPMOST = -1; - private const int HWND_NOTOPMOST = -2; - private const int SWP_NOACTIVATE = 0x10; - private const int SWP_NOMOVE = 0x2; - private const int SWP_NOSIZE = 0x1; - /// - /// 设置窗体是否置顶 - /// - /// - /// - public static void SetTopMost(IntPtr iHWND,bool TopMost) - { - SetWindowPos(iHWND, (TopMost?HWND_TOPMOST: HWND_NOTOPMOST), 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_NOACTIVATE); - } - /// - /// 显示没有焦点的窗口 - /// - /// - public static void ShowNoActiveWindow(Form frm) - { - ShowWindow(new HandleRef(frm, frm.Handle), 4); - } - /// - /// 根据句柄获取窗口文本 - /// - /// - /// - public static string GetWinText(IntPtr Handle) - { - StringBuilder WinTitle = new StringBuilder(200); - int len = User32.GetWindowText(Handle.ToInt32(), WinTitle, 200); - return WinTitle.ToString(); - } - - /// - /// 根据句柄获取窗口类 - /// - /// - /// - public static string GetWinClass(IntPtr Handle) - { - StringBuilder WinClass = new StringBuilder(200); - int len = User32.GetClassName(Handle.ToInt32(), WinClass, 200); - return WinClass.ToString(); - } - /// - /// 获取当前活动的窗口句柄 - /// - /// - public static IntPtr GetActiveWindow() - { - return User32.GetActiveWindow(); +using System; +using System.Collections.Generic; +using System.Drawing; +using System.Linq; +using System.Runtime.InteropServices; +using System.Text; +using System.Windows.Forms; +using WinAPI; + +namespace ryCommon +{ + /// + /// 窗体操作类 + /// + public class RyForm + { + /// + /// 设置Comobox的行间距 + /// + /// + /// + public static void CmbBind(ComboBox list, int itemHeight) + { + list.DropDownStyle = ComboBoxStyle.DropDownList; + list.ItemHeight = itemHeight; + list.DrawMode = DrawMode.OwnerDrawFixed; + list.DrawItem += new DrawItemEventHandler(delegate (object sender, DrawItemEventArgs e) + { + if (e.Index < 0) + { + return; + } + e.DrawBackground(); + e.DrawFocusRectangle(); + e.Graphics.DrawString(list.Items[e.Index].ToString(), e.Font, new SolidBrush(e.ForeColor), e.Bounds.X, e.Bounds.Y + 3); + }); } - /// - /// 获取当前前台的窗口句柄 - /// - /// - public static IntPtr GetForegroundWindow() - { - return User32.GetForegroundWindow(); - } - /// - /// 设置为当前活动窗口 - /// - /// - /// - public static IntPtr SetActiveWindow(IntPtr hwnd) - { - return User32.SetActiveWindow(hwnd); - } - /// - /// 根据窗口句柄来获得进程id - /// - /// - /// - public static int GetProcessId(IntPtr hwnd) - { - User32.GetWindowThreadProcessId(hwnd, out int ID); - return ID; - } - /// - /// 显示窗体 - /// - /// - public static void Show(Form frm) - { - bool topmost = frm.TopMost; + /// + /// 移除关闭按钮。返回值，非零表示成功，零表示失败。 + /// + /// 窗口的句柄 + /// 是否成功 + public static int RemoveXButton(IntPtr iHWND) + { + int iSysMenu; + const int MF_BYCOMMAND = 0x400; //0x400-关闭 + iSysMenu = User32.GetSystemMenu(iHWND, 0); + return User32.RemoveMenu(iSysMenu, 6, MF_BYCOMMAND); + } + /// + /// 把窗体放到最前 + /// + /// + public static void BringToTop(IntPtr iHWND) + { + User32.SetForegroundWindow(iHWND); + } + /// + /// 显示窗体 + /// + /// + /// + /// + [DllImport("user32.dll", CharSet = CharSet.Auto, ExactSpelling = true)] + public static extern bool ShowWindow(HandleRef hWnd, int nCmdShow); + private const int HWND_TOPMOST = -1; + private const int HWND_NOTOPMOST = -2; + private const int SWP_NOACTIVATE = 0x10; + private const int SWP_NOMOVE = 0x2; + private const int SWP_NOSIZE = 0x1; + /// + /// 设置窗体是否置顶 + /// + /// + /// + public static void SetTopMost(IntPtr iHWND,bool TopMost) + { + WinAPI.User32.SetWindowPos(iHWND, (TopMost?HWND_TOPMOST: HWND_NOTOPMOST), 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_NOACTIVATE); + } + /// + /// 显示没有焦点的窗口 + /// + /// + public static void ShowNoActiveWindow(Form frm) + { + ShowWindow(new HandleRef(frm, frm.Handle), 4); + } + /// + /// 根据句柄获取窗口文本 + /// + /// + /// + public static string GetWinText(IntPtr Handle) + { + StringBuilder WinTitle = new StringBuilder(200); + int len = User32.GetWindowText(Handle.ToInt32(), WinTitle, 200); + return WinTitle.ToString(); + } + + /// + /// 根据句柄获取窗口类 + /// + /// + /// + public static string GetWinClass(IntPtr Handle) + { + StringBuilder WinClass = new StringBuilder(200); + int len = User32.GetClassName(Handle.ToInt32(), WinClass, 200); + return WinClass.ToString(); + } + /// + /// 获取当前活动的窗口句柄 + /// + /// + public static IntPtr GetActiveWindow() + { + return User32.GetActiveWindow(); + } + /// + /// 获取当前前台的窗口句柄 + /// + /// + public static IntPtr GetForegroundWindow() + { + return User32.GetForegroundWindow(); + } + /// + /// 设置为当前活动窗口 + /// + /// + /// + public static IntPtr SetActiveWindow(IntPtr hwnd) + { + return User32.SetActiveWindow(hwnd); + } + /// + /// 根据窗口句柄来获得进程id + /// + /// + /// + public static int GetProcessId(IntPtr hwnd) + { + User32.GetWindowThreadProcessId(hwnd, out int ID); + return ID; + } + /// + /// 显示窗体 + /// + /// + public static void Show(Form frm) + { + bool topmost = frm.TopMost; if(frm.WindowState!= FormWindowState.Normal) { frm.WindowState= FormWindowState.Normal; - } - var screen = Screen.PrimaryScreen.WorkingArea; + } + var screen = Screen.PrimaryScreen.WorkingArea; if (!screen.Contains(frm.Location)) { frm.Location = new Point((screen.Width-frm.Width)/2, (screen.Height - frm.Height) / 2); - } + } else if (!screen.Contains(new Point(frm.Left,frm.Top+100))) { frm.Location = new Point((screen.Width - frm.Width) / 2, (screen.Height - frm.Height) / 2); - } + } else if (!screen.Contains(new Point(frm.Left+100, frm.Top))) { frm.Location = new Point((screen.Width - frm.Width) / 2, (screen.Height - frm.Height) / 2); - } - frm.BringToFront(); - frm.TopMost = true; - frm.TopMost = topmost; - frm.Show(); - } - /// - /// 设置窗体父窗体为桌面,不会随着显示桌面而最小化,但无法设置窗体透明度 - /// - /// - public static void SetDesktopForm(IntPtr handle) - { - //在构造函数中或者Load中 - IntPtr hDeskTop = WinAPI.User32.FindWindow("Progman", null); - WinAPI.User32.SetParent(handle, hDeskTop); - } - /// - /// 结束进程 - /// - /// - /// - public static long KillPorc(int pid) - { - return WinAPI.Kernel32.TerminateProcess(pid,1); - } - /// - /// 打开窗体,只打开一个实例(非模态) - /// - /// - /// - public static Form ShowOne(Form type) - { - try - { - foreach (Form frm in Application.OpenForms) - { - if (frm.GetType() == type.GetType()) - { - frm.WindowState = FormWindowState.Normal; - frm.BringToFront(); - return frm; - } - } - type.StartPosition = FormStartPosition.CenterScreen; - type.Show(); - return type; - } - catch { } - return null; + } + frm.BringToFront(); + frm.TopMost = true; + frm.TopMost = topmost; + frm.Show(); + } + /// + /// 设置窗体父窗体为桌面,不会随着显示桌面而最小化,但无法设置窗体透明度 + /// + /// + public static void SetDesktopForm(IntPtr handle) + { + //在构造函数中或者Load中 + IntPtr hDeskTop = WinAPI.User32.FindWindow("Progman", null); + WinAPI.User32.SetParent(handle, hDeskTop); + } + /// + /// 结束进程 + /// + /// + /// + public static long KillPorc(int pid) + { + return WinAPI.Kernel32.TerminateProcess(pid,1); + } + /// + /// 打开窗体,只打开一个实例(非模态) + /// + /// + /// + public static Form ShowOne(Form type) + { + try + { + foreach (Form frm in Application.OpenForms) + { + if (frm.GetType() == type.GetType()) + { + frm.WindowState = FormWindowState.Normal; + frm.BringToFront(); + return frm; + } + } + type.StartPosition = FormStartPosition.CenterScreen; + type.Show(); + return type; + } + catch { } + return null; } /// /// 将窗体植入到容器控件中 @@ -224,27 +222,27 @@ namespace ryCommon /// /// 作为窗体容器的控件 /// - public static bool SetParentWin(Form frm, Control panrent_ctl) - { - if (frm == null) { return false; } - if (panrent_ctl == null) { return false; } - frm.FormBorderStyle = FormBorderStyle.None; - _ = WinAPI.User32.SetParent(frm.Handle, panrent_ctl.Handle); - _ = WinAPI.User32.MoveWindow(frm.Handle, 0, 0, panrent_ctl.Width, panrent_ctl.Height, false); - return true; - } + public static bool SetParentWin(Form frm, Control panrent_ctl) + { + if (frm == null) { return false; } + if (panrent_ctl == null) { return false; } + frm.FormBorderStyle = FormBorderStyle.None; + _ = WinAPI.User32.SetParent(frm.Handle, panrent_ctl.Handle); + _ = WinAPI.User32.MoveWindow(frm.Handle, 0, 0, panrent_ctl.Width, panrent_ctl.Height, false); + return true; + } /// /// 重新调整窗体大小以适配容器大小 /// /// /// 作为窗体容器的控件 - /// - public static bool ResizeWin(Form frm, Control panrent_ctl) - { - if (frm == null) { return false; } - if (panrent_ctl == null) { return false; } - _ = WinAPI.User32.MoveWindow(frm.Handle, 0, 0, panrent_ctl.Width, panrent_ctl.Height, true); - return true; - } - } -} + /// + public static bool ResizeWin(Form frm, Control panrent_ctl) + { + if (frm == null) { return false; } + if (panrent_ctl == null) { return false; } + _ = WinAPI.User32.MoveWindow(frm.Handle, 0, 0, panrent_ctl.Width, panrent_ctl.Height, true); + return true; + } + } +} diff --git a/Source/MyDb/SysFuns/RyRegedit.cs b/Source/MyDb/SysFuns/RyRegedit.cs index 93e5601..e5153f6 100644 --- a/Source/MyDb/SysFuns/RyRegedit.cs +++ b/Source/MyDb/SysFuns/RyRegedit.cs @@ -32,12 +32,13 @@ namespace ryCommon try { RegistryKey LMach = RegistryKey.OpenBaseKey(_RegRoot, _UseSystemBit); + if (LMach == null) { return false; } RegistryKey softwareRun = LMach.OpenSubKey(Path, false); if (softwareRun != null) { result = true; + softwareRun.Close(); } - softwareRun.Close(); LMach.Close(); return result; } diff --git a/Source/MyDb/SysFuns/RySystem.cs b/Source/MyDb/SysFuns/RySystem.cs index 0bd4651..0e82bf0 100644 --- a/Source/MyDb/SysFuns/RySystem.cs +++ b/Source/MyDb/SysFuns/RySystem.cs @@ -1,181 +1,181 @@ -using System; -using System.Collections.Generic; -using System.Drawing; -using System.Linq; -using System.Runtime.InteropServices; -using System.Text; - -namespace ryCommon -{ - /// - /// 系统函数 - /// - public class RySystem - { - /// - /// - /// - [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)] - public struct RAMP - { - /// - /// 红 - /// - [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] - public UInt16[] Red; - /// - /// 绿 - /// - [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] - public UInt16[] Green; - /// - /// 蓝 - /// - [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] - public UInt16[] Blue; - } - /// - /// 获取屏幕伽马值 - /// - /// - /// - /// - [DllImport("gdi32.dll", SetLastError = true)] - public static extern bool GetDeviceGammaRamp(IntPtr hDC, ref RAMP lpRamp); - /// - /// 设置屏幕伽马值 - /// - /// - /// - /// - [DllImport("gdi32.dll", SetLastError = true)] - public static extern bool SetDeviceGammaRamp(IntPtr hDC, ref RAMP lpRamp); - - private static readonly double[] _gammas = { 1, 1, 1 }; - private static short _brightness = 100; - // 创建结构体用于返回捕获时间 - [StructLayout(LayoutKind.Sequential)] - struct LASTINPUTINFO - { - // 设置结构体块容量 - [MarshalAs(UnmanagedType.U4)] - public int cbSize; - // 捕获的时间 - [MarshalAs(UnmanagedType.U4)] - public uint dwTime; - } - [DllImport("user32.dll")] - private static extern bool GetLastInputInfo(ref LASTINPUTINFO plii); - /// - /// 获取键盘和鼠标没有操作的时间 - /// - /// - public static long GetLastInputTime() - { - LASTINPUTINFO vLastInputInfo = new LASTINPUTINFO(); - vLastInputInfo.cbSize = Marshal.SizeOf(vLastInputInfo); - // 捕获时间 - if (!GetLastInputInfo(ref vLastInputInfo)) - return 0; - else - return Environment.TickCount - (long)vLastInputInfo.dwTime; - } - /// - /// 设置屏幕 Gamma值 - /// - /// - /// - /// - /// - public static bool SetGamma(double gammaRed, double gammaGreen, double gammaBlue) - { - _gammas[0] = gammaRed; - _gammas[1] = gammaGreen; - _gammas[2] = gammaBlue; - - return UpdateRamps(); - } - /// - /// 设置屏幕亮度 - /// - /// - /// - public static bool SetBrightness(short brightness) - { - if (brightness > 100) - brightness = 100; - - if (brightness < 0) - brightness = 0; - - _brightness = brightness; - - return UpdateRamps(); - } - - private static bool UpdateRamps() - { - double brightness = (double)_brightness / 100f; - RAMP ramp = new RAMP - { - Red = new UInt16[256], - Green = new UInt16[256], - Blue = new UInt16[256] - }; - for (int i = 0; i < 256; i++) - { - ramp.Red[i] = (ushort)GetGamma(_gammas[0]); - ramp.Green[i] = (ushort)GetGamma(_gammas[1]); - ramp.Blue[i] = (ushort)GetGamma(_gammas[2]); - double GetGamma(double gamma) - { - var r = (Math.Pow(i / 256.0, 1.0 / gamma) * 65535 + 0.5); - r *= brightness; - if (r > 65535) - r = 65535; - if (r < 0) - r = 0; - return r; - } - } - var retVal = SetDeviceGammaRamp(Graphics.FromHwnd(IntPtr.Zero).GetHdc(), ref ramp); - - //Memory allocated through stackalloc is automatically free'd - //by the CLR. - - return retVal; - } - /// - /// 获取系统名称,注意需要在app.manifest文件中设置兼容win10 - /// - /// - public static string GetOSystemVer() - { - switch (System.Environment.OSVersion.Version.Major + "." + System.Environment.OSVersion.Version.Minor) - { - case "5.0": - return "Windows2000"; - case "5.1": - return "WindowsXP"; - case "5.2": - return "Windows2003"; - case "6.0": - return "Windows2008"; - case "6.1": - return "Windows7"; - case "6.2": - return "Windows8 Or Windows8.1"; - case "6.3": - return "Windows8.1"; - case "10.0": +using System; +using System.Collections.Generic; +using System.Drawing; +using System.Linq; +using System.Runtime.InteropServices; +using System.Text; + +namespace ryCommon +{ + /// + /// 系统函数 + /// + public class RySystem + { + /// + /// + /// + [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)] + public struct RAMP + { + /// + /// 红 + /// + [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] + public UInt16[] Red; + /// + /// 绿 + /// + [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] + public UInt16[] Green; + /// + /// 蓝 + /// + [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] + public UInt16[] Blue; + } + /// + /// 获取屏幕伽马值 + /// + /// + /// + /// + [DllImport("gdi32.dll", SetLastError = true)] + public static extern bool GetDeviceGammaRamp(IntPtr hDC, ref RAMP lpRamp); + /// + /// 设置屏幕伽马值 + /// + /// + /// + /// + [DllImport("gdi32.dll", SetLastError = true)] + public static extern bool SetDeviceGammaRamp(IntPtr hDC, ref RAMP lpRamp); + + private static readonly double[] _gammas = { 1, 1, 1 }; + private static short _brightness = 100; + // 创建结构体用于返回捕获时间 + [StructLayout(LayoutKind.Sequential)] + struct LASTINPUTINFO + { + // 设置结构体块容量 + [MarshalAs(UnmanagedType.U4)] + public int cbSize; + // 捕获的时间 + [MarshalAs(UnmanagedType.U4)] + public uint dwTime; + } + [DllImport("user32.dll")] + private static extern bool GetLastInputInfo(ref LASTINPUTINFO plii); + /// + /// 获取键盘和鼠标没有操作的时间 + /// + /// + public static long GetLastInputTime() + { + LASTINPUTINFO vLastInputInfo = new LASTINPUTINFO(); + vLastInputInfo.cbSize = Marshal.SizeOf(vLastInputInfo); + // 捕获时间 + if (!GetLastInputInfo(ref vLastInputInfo)) + return 0; + else + return Environment.TickCount - (long)vLastInputInfo.dwTime; + } + /// + /// 设置屏幕 Gamma值 + /// + /// + /// + /// + /// + public static bool SetGamma(double gammaRed, double gammaGreen, double gammaBlue) + { + _gammas[0] = gammaRed; + _gammas[1] = gammaGreen; + _gammas[2] = gammaBlue; + + return UpdateRamps(); + } + /// + /// 设置屏幕亮度 + /// + /// + /// + public static bool SetBrightness(short brightness) + { + if (brightness > 100) + brightness = 100; + + if (brightness < 0) + brightness = 0; + + _brightness = brightness; + + return UpdateRamps(); + } + + private static bool UpdateRamps() + { + double brightness = (double)_brightness / 100f; + RAMP ramp = new RAMP + { + Red = new UInt16[256], + Green = new UInt16[256], + Blue = new UInt16[256] + }; + for (int i = 0; i < 256; i++) + { + ramp.Red[i] = (ushort)GetGamma(_gammas[0]); + ramp.Green[i] = (ushort)GetGamma(_gammas[1]); + ramp.Blue[i] = (ushort)GetGamma(_gammas[2]); + double GetGamma(double gamma) + { + var r = (Math.Pow(i / 256.0, 1.0 / gamma) * 65535 + 0.5); + r *= brightness; + if (r > 65535) + r = 65535; + if (r < 0) + r = 0; + return r; + } + } + var retVal = SetDeviceGammaRamp(Graphics.FromHwnd(IntPtr.Zero).GetHdc(), ref ramp); + + //Memory allocated through stackalloc is automatically free'd + //by the CLR. + + return retVal; + } + /// + /// 获取系统名称,注意需要在app.manifest文件中设置兼容win10 + /// + /// + public static string GetOSystemVer() + { + switch (System.Environment.OSVersion.Version.Major + "." + System.Environment.OSVersion.Version.Minor) + { + case "5.0": + return "Windows2000"; + case "5.1": + return "WindowsXP"; + case "5.2": + return "Windows2003"; + case "6.0": + return "Windows2008"; + case "6.1": + return "Windows7"; + case "6.2": + return "Windows8 Or Windows8.1"; + case "6.3": + return "Windows8.1"; + case "10.0": if (System.Environment.OSVersion.Version.Build < 22000) { return "Windows10"; } - else { return "Windows11"; } - default: - return "未知"; - } - } - } -} + else { return "Windows11"; } + default: + return "未知"; + } + } + } +} diff --git a/Source/MyDb/WinAPI/Kernel32.cs b/Source/MyDb/WinAPI/Kernel32.cs index 9e805bb..a8d0a6c 100644 --- a/Source/MyDb/WinAPI/Kernel32.cs +++ b/Source/MyDb/WinAPI/Kernel32.cs @@ -19,5 +19,22 @@ namespace WinAPI /// [DllImport("kernel32")] public static extern long TerminateProcess(int handle, int exitCode); + /// + /// + /// + /// + /// + /// + /// + [DllImport("kernel32.dll")] + public static extern IntPtr OpenProcess(uint processAccess, bool bInheritHandle, int processId); + /// + /// + /// + /// + /// + [DllImport("kernel32.dll", SetLastError = true)] + [return: MarshalAs(UnmanagedType.Bool)] + public static extern bool CloseHandle(IntPtr hObject); } } diff --git a/Source/MyDb/WinAPI/User32.cs b/Source/MyDb/WinAPI/User32.cs index 64394e6..9c3573b 100644 --- a/Source/MyDb/WinAPI/User32.cs +++ b/Source/MyDb/WinAPI/User32.cs @@ -388,7 +388,27 @@ namespace WinAPI /// [DllImport("user32", ExactSpelling = true, SetLastError = true)] public static extern bool UpdateLayeredWindow(IntPtr hwnd, IntPtr hdcDst, ref Point pptDst, ref Size psize, IntPtr hdcSrc, ref Point pprSrc, Int32 crKey, ref BLENDFUNCTION pblend, Int32 dwFlags); - + /// + /// 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 + /// 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 + /// + /// A handle to the window. + /// A handle to the window to precede the positioned window in the Z order. This parameter must be a window handle or one of the following values. + /// Specifies the new position of the left side of the window, in client coordinates. + /// Specifies the new position of the top of the window, in client coordinates. + /// Specifies the new width of the window, in pixels. + /// Specifies the new height of the window, in pixels. + /// Specifies the window sizing and positioning flags. This parameter can be a combination of the following values. + /// If the function succeeds, the return value is nonzero, if the function fails, the return value is zero. + [DllImport("user32", CharSet = CharSet.Auto)] + public static extern int SetWindowPos( + IntPtr hWnd, + int hWndAfter, + int X, + int Y, + int Width, + int Height, + int flags); /// /// 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。 /// 子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口。 diff --git a/Source/MyDb/bin/x86/Debug/MyDb.dll b/Source/MyDb/bin/x86/Debug/MyDb.dll deleted file mode 100644 index d1d7165..0000000 Binary files a/Source/MyDb/bin/x86/Debug/MyDb.dll and /dev/null differ diff --git a/Source/MyDb/bin/x86/Release/MyDb.dll b/Source/MyDb/bin/x86/Release/MyDb.dll deleted file mode 100644 index 3802791..0000000 Binary files a/Source/MyDb/bin/x86/Release/MyDb.dll and /dev/null differ diff --git a/Source/MyDb_MySQL/MyDb_MySQLV4.csproj b/Source/MyDb_MySQL/MyDb_MySQLV4.csproj index 75a79ae..d6f40f3 100644 --- a/Source/MyDb_MySQL/MyDb_MySQLV4.csproj +++ b/Source/MyDb_MySQL/MyDb_MySQLV4.csproj @@ -39,6 +39,10 @@ ..\..\Bin\Release\CommonControls\.NET4\MySql.Data.dll + + False + ..\..\Bin\Release\CommonControls\.NET4\RaUI.dll + @@ -51,12 +55,6 @@ - - - {9df20d86-a56e-4cf6-a3d8-f30421297b1b} - MyDbV4 - - 把从文件流中读取的内容[字节数组]放到内存流中去 + MemoryStream ms = new MemoryStream(data); + if(ext== FileExtension.WebP) + { + using (WebP webP = new WebP()) + { + return webP.Decode(data); + } + } + //设置图片框 pictureBox1中的图片 + return Image.FromStream(ms); + } + catch(Exception) + { return null; } + } + } + #region SaveHighQualityImage 方法合集 + /// + /// 保存高质量不失真照片 + /// + /// + /// + /// + public static void SaveHighQualityImage(this Bitmap m, string path, ryCommon.Pram.ImageType type) + { + SaveHighQualityImage(m, path, type, 100); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + /// + /// 图片质量,0~100 + public static void SaveHighQualityImage(this Bitmap m, string path, ryCommon.Pram.ImageType type,int quality) + { + m.Save(path, GetEncoderInfo(type), GetEncoderParameters(quality)); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + /// + public static void SaveHighQualityImage(this Bitmap m, MemoryStream ms, ryCommon.Pram.ImageType type) + { + SaveHighQualityImage(m,ms,type, 100); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + /// + /// 图片质量,0~100 + public static void SaveHighQualityImage(this Bitmap m, MemoryStream ms, ryCommon.Pram.ImageType type, int quality) + { + m.Save(ms, GetEncoderInfo(type), GetEncoderParameters(quality)); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + /// + public static void SaveHighQualityImage(this Image m, string path, ryCommon.Pram.ImageType type) + { + SaveHighQualityImage(m,path, type, 100); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + /// + /// 图片质量,0~100 + public static void SaveHighQualityImage(this Image m, string path, ryCommon.Pram.ImageType type, int quality) + { + if(!System.IO.Directory.Exists(System.IO.Path.GetDirectoryName(path))) + { + RyFiles.CreateDirectory(System.IO.Path.GetDirectoryName(path)); + } + m.Save(path, GetEncoderInfo(type), GetEncoderParameters(quality)); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + public static bool SaveHighQualityImage(this Bitmap m, string path) + { + return SaveHighQualityImage((Image)m, path); + } + /// + /// 保存高质量不失真照片 + /// + /// + /// + public static bool SaveHighQualityImage(this Image m, string path) + { + if (!System.IO.Directory.Exists(System.IO.Path.GetDirectoryName(path))) + { + RyFiles.CreateDirectory(System.IO.Path.GetDirectoryName(path)); + } + ryCommon.Pram.ImageType type = Pram.ImageType.Png; + var ext = System.IO.Path.GetExtension(path).ToLower(); + switch (ext) + { + case ".png": + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + case ".jpg": + type = Pram.ImageType.Jpeg; + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + case ".bmp": + type = Pram.ImageType.Bmp; + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + case ".gif": + type = Pram.ImageType.Gif; + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + case ".tif": + type = Pram.ImageType.Tiff; + m.Save(path, GetEncoderInfo(type), GetEncoderParameters()); + break; + default: + return false; + } + return true; + } + #region 图片旋转函数 + /// + /// 以逆时针为方向对图像进行旋转 + /// + /// 位图流 + /// 旋转角度[0,360](前台给的) + /// + public static Bitmap Rotate(this Bitmap b, int angle) + { + angle %= 360; + //弧度转换 + double radian = angle * Math.PI / 180.0; + double cos = Math.Cos(radian); + double sin = Math.Sin(radian); + //原图的宽和高 + int w = b.Width; + int h = b.Height; + int W = (int)(Math.Max(Math.Abs(w * cos - h * sin), Math.Abs(w * cos + h * sin))); + int H = (int)(Math.Max(Math.Abs(w * sin - h * cos), Math.Abs(w * sin + h * cos))); + //目标位图 + Bitmap dsImage = new Bitmap(W, H); + System.Drawing.Graphics g = System.Drawing.Graphics.FromImage(dsImage); + g.InterpolationMode = System.Drawing.Drawing2D.InterpolationMode.Bilinear; + g.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.HighQuality; + //计算偏移量 + Point Offset = new Point((W - w) / 2, (H - h) / 2); + //构造图像显示区域：让图像的中心与窗口的中心点一致 + Rectangle rect = new Rectangle(Offset.X, Offset.Y, w, h); + Point center = new Point(rect.X + rect.Width / 2, rect.Y + rect.Height / 2); + g.TranslateTransform(center.X, center.Y); + g.RotateTransform(360 - angle); + //恢复图像在水平和垂直方向的平移 + g.TranslateTransform(-center.X, -center.Y); + g.DrawImage(b, rect); + //重至绘图的所有变换 + g.ResetTransform(); + g.Save(); + g.Dispose(); + //dsImage.Save("yuancd.jpg", System.Drawing.Imaging.ImageFormat.Jpeg); + return dsImage; + } + #endregion 图片旋转函数 + /// + /// 是否包括透明像素 + /// + /// + /// + /// 操作失败 + public static bool HasTransparentPixel(this System.Drawing.Image i) + { + using (Bitmap bitmap = new Bitmap(i)) + { + for (int x = 0; x < bitmap.Width; x++) + { + for (int y = 0; y < bitmap.Height; y++) + { + if (bitmap.GetPixel(x, y).A < 255) + { + return true; + } + } + } + } + + return false; + } + /// + /// 矩形边界 + /// + /// + /// + /// + private static Size ScaleRectangleToFitBounds(Size bounds, Size rect) + { + if (rect.Width < bounds.Width && rect.Height < bounds.Height) + { + return rect; + } + + if (bounds.Width == 0 || bounds.Height == 0) + { + return new Size(0, 0); + } + + double scaleFactorWidth = (double)rect.Width / bounds.Width; + double scaleFactorHeight = (double)rect.Height / bounds.Height; + + double scaleFactor = Math.Max(scaleFactorWidth, scaleFactorHeight); + return new Size() + { + Width = (int)(rect.Width / scaleFactor), + Height = (int)(rect.Height / scaleFactor) + }; + } + /// + /// 计算水印位置 + /// + /// + /// + /// + /// + private static Point CalculateWatermarkPosition(WatermarkPosition watermarkPosition, Size imageSize, Size watermarkSize) + { + Point position = new Point(); + switch (watermarkPosition) + { + case WatermarkPosition.TopLeftCorner: + position.X = 0; + position.Y = 0; + break; + case WatermarkPosition.TopCenter: + position.X = (imageSize.Width / 2) - (watermarkSize.Width / 2); + position.Y = 0; + break; + case WatermarkPosition.TopRightCorner: + position.X = imageSize.Width - watermarkSize.Width; + position.Y = 0; + break; + case WatermarkPosition.CenterLeft: + position.X = 0; + position.Y = (imageSize.Height / 2) - (watermarkSize.Height / 2); + break; + case WatermarkPosition.Center: + position.X = (imageSize.Width / 2) - (watermarkSize.Width / 2); + position.Y = (imageSize.Height / 2) - (watermarkSize.Height / 2); + break; + case WatermarkPosition.CenterRight: + position.X = imageSize.Width - watermarkSize.Width; + position.Y = (imageSize.Height / 2) - (watermarkSize.Height / 2); + break; + case WatermarkPosition.BottomLeftCorner: + position.X = 0; + position.Y = imageSize.Height - watermarkSize.Height; + break; + case WatermarkPosition.BottomCenter: + position.X = (imageSize.Width / 2) - (watermarkSize.Width / 2); + position.Y = imageSize.Height - watermarkSize.Height; + break; + case WatermarkPosition.BottomRightCorner: + position.X = imageSize.Width - watermarkSize.Width; + position.Y = imageSize.Height - watermarkSize.Height; + break; + } + return position; + } + /// + /// 写入水印 + /// + /// 原图 + /// 水印图片 + /// 水印位置 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, Bitmap wmImg, WatermarkPosition Position, float opacity) + { + return DrawWatermark(image, wmImg, new List() { Position }, 0,0, opacity); + } + /// + /// 写入水印 + /// + /// 原图 + /// 水印图片 + /// 水印位置 + /// x坐标偏移 + /// y坐标偏移 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, Bitmap wmImg, WatermarkPosition Position, int offset_x, int offset_y, float opacity) + { + return DrawWatermark(image, wmImg, new List() { Position }, offset_x, offset_y, opacity); + } + /// + /// 写入水印 + /// + /// 原图 + /// 水印图片 + /// 水印位置 + /// x坐标偏移 + /// y坐标偏移 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, Bitmap wmImg, List PositionList,int offset_x, int offset_y, float opacity) + { + Bitmap bm1 = new Bitmap(image); //克隆原图，它也是我们的返回值 + using (Graphics g = Graphics.FromImage(bm1)) + { + Size calculatedWatermarkSize = ScaleRectangleToFitBounds(bm1.Size, wmImg.Size); + + if (calculatedWatermarkSize.Width == 0 || calculatedWatermarkSize.Height == 0) + { + return bm1; + } + Bitmap scaledWatermarkBitmap = + new Bitmap(calculatedWatermarkSize.Width, calculatedWatermarkSize.Height); + using (Graphics watermarkGraphics = Graphics.FromImage(scaledWatermarkBitmap)) + { + ColorMatrix opacityMatrix = new ColorMatrix + { + Matrix33 = opacity + }; + ImageAttributes attrs = new ImageAttributes(); + attrs.SetColorMatrix(opacityMatrix, ColorMatrixFlag.Default, ColorAdjustType.Bitmap); + watermarkGraphics.DrawImage(wmImg, + new Rectangle(0, 0, scaledWatermarkBitmap.Width, scaledWatermarkBitmap.Height), + 0, 0, wmImg.Width, wmImg.Height, + GraphicsUnit.Pixel, attrs); + attrs.Dispose(); + } + + foreach (var position in PositionList) + { + if(position== WatermarkPosition.FullScreenTile) + { + //g.RotateTransform(-45); + //scaledWatermarkBitmap=scaledWatermarkBitmap.Rotate(45); + var space = 100; + var start_y = ((scaledWatermarkBitmap.Width - scaledWatermarkBitmap.Height) / Math.Sqrt(2)) + (Math.Sqrt(2) * scaledWatermarkBitmap.Height)- scaledWatermarkBitmap.Size.Height; + for (int i_y = start_y.ToInt()-50+offset_y; i_y < image.Size.Height*2; i_y += scaledWatermarkBitmap.Height + space) + { + for (int i_x = offset_x; i_x < image.Size.Width; i_x += scaledWatermarkBitmap.Width + space) + { + var bottomleft_x = i_x; + var bottomleft_y = i_y+ scaledWatermarkBitmap.Size.Height; + var bottomright_x = i_x +(scaledWatermarkBitmap.Size.Width / Math.Sqrt(2));//水印右上角x坐标 + var bottomright_y = bottomleft_y - (scaledWatermarkBitmap.Size.Width / Math.Sqrt(2));//水印右上角y坐标 + if (bottomright_x> image.Size.Width){ continue; } + if (bottomright_y< 0){ continue; } + if(bottomright_y > image.Size.Height) { + continue; + } + if (bottomleft_y > image.Size.Height) { + continue; + } + //if ((xx* Math.Sqrt(2))< scaledWatermarkBitmap.Size.Width) { continue; } + g.TranslateTransform(bottomleft_x, bottomleft_y); + g.RotateTransform(-45); + //if (i_x+ scaledWatermarkBitmap.Width> image.Size.Width) { continue; } + //if (i_y + scaledWatermarkBitmap.Height > image.Size.Height) { continue; } + g.DrawImage(scaledWatermarkBitmap, + new Rectangle(new Point(0,0), scaledWatermarkBitmap.Size), + 0, 0, scaledWatermarkBitmap.Width, scaledWatermarkBitmap.Height, GraphicsUnit.Pixel); + g.TranslateTransform(-bottomleft_x, -bottomleft_y); + g.RotateTransform(45); + ///////重置绘图平面的所有变换 + g.ResetTransform(); + } + } + continue; + } + Point watermarkPosition = CalculateWatermarkPosition(position, + image.Size, calculatedWatermarkSize); + watermarkPosition.Offset(offset_x, offset_y); + if(watermarkPosition.X<0 || watermarkPosition.Y < 0) { continue; } + if (watermarkPosition.X > bm1.Width- calculatedWatermarkSize.Width || watermarkPosition.Y>bm1.Height- calculatedWatermarkSize.Height) { continue; } + g.DrawImage(scaledWatermarkBitmap, + new Rectangle(watermarkPosition, calculatedWatermarkSize), + 0, 0, calculatedWatermarkSize.Width, calculatedWatermarkSize.Height, GraphicsUnit.Pixel); + } + scaledWatermarkBitmap.Dispose(); + } + return bm1; + } + /// + /// 计算最大字体大小 + /// + /// + /// + /// + /// + /// + /// + private static int ComputeMaxFontSize(string text, int angle, string fontName, Size maxTextSize, Graphics g) + { + for (int fontSize = 2; ; fontSize++) + { + using (Font tmpFont = new Font(fontName, fontSize, FontStyle.Bold)) + { + SizeF textSize = g.MeasureString(text, tmpFont); + SizeF rotatedTextSize = CalculateRotatedRectSize(textSize, angle); + if (((int)rotatedTextSize.Width > maxTextSize.Width) || + ((int)rotatedTextSize.Height > maxTextSize.Height)) + { + return fontSize - 1; + } + } + } + } + /// + /// 计算旋转矩形大小 + /// + /// + /// + /// + private static SizeF CalculateRotatedRectSize(SizeF rectSize, double angleDeg) + { + double angleRad = angleDeg * Math.PI / 180; + double width = rectSize.Height * Math.Abs(Math.Sin(angleRad)) + + rectSize.Width * Math.Abs(Math.Cos(angleRad)); + double height = rectSize.Height * Math.Abs(Math.Cos(angleRad)) + + rectSize.Width * Math.Abs(Math.Sin(angleRad)); + return new SizeF((float)width, (float)height); + } + /// + /// 写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// 旋转角度 + /// 水印位置 + /// x坐标偏移 + /// y坐标偏移 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, string wmText,string WatermarkFont,Color TextColor, int TextSize, int TextRotatedDegree, List PositionList, int x, int y, float opacity) + { + Bitmap bm1 = new Bitmap(image); //克隆原图，它也是我们的返回值 + using (Graphics g = Graphics.FromImage(bm1)) + { + g.SmoothingMode = SmoothingMode.AntiAlias; + g.TextRenderingHint = TextRenderingHint.AntiAlias; + + string text = wmText; + + int textAngle = TextRotatedDegree; + double sizeFactor = (double)TextSize / 100; + Size maxTextSize = new Size( + (int)(bm1.Width * sizeFactor), + (int)(bm1.Height * sizeFactor)); + + int fontSize = ComputeMaxFontSize(text, textAngle, WatermarkFont, maxTextSize, g); + + Font font = new Font(WatermarkFont, (float)fontSize, FontStyle.Bold); + SizeF originalTextSize = g.MeasureString(text, font); + SizeF rotatedTextSize = CalculateRotatedRectSize(originalTextSize, textAngle); + + Bitmap textBitmap = new Bitmap((int)rotatedTextSize.Width, (int)rotatedTextSize.Height, + PixelFormat.Format32bppArgb); + using (Graphics textG = Graphics.FromImage(textBitmap)) + { + Color color = Color.FromArgb((int)(opacity * 255), TextColor); + SolidBrush brush = new SolidBrush(color); + + textG.TranslateTransform(rotatedTextSize.Width / 2, rotatedTextSize.Height / 2); + textG.RotateTransform((float)textAngle); + textG.DrawString(text, font, brush, x-(originalTextSize.Width / 2), + y-(originalTextSize.Height / 2)); + textG.ResetTransform(); + + brush.Dispose(); + } + + foreach (var position in PositionList) + { + Point textPosition = CalculateWatermarkPosition(position, + bm1.Size, rotatedTextSize.ToSize()); + g.DrawImage(textBitmap, textPosition); + } + textBitmap.Dispose(); + font.Dispose(); + } + return bm1; + } + /// + /// 写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// 旋转角度 + /// 水印位置 + /// x坐标偏移 + /// y坐标偏移 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, string wmText, string WatermarkFont, Color TextColor, int TextSize, int TextRotatedDegree, WatermarkPosition Position, int x, int y, float opacity) + { + return DrawWatermark(image, wmText, WatermarkFont, TextColor, TextSize, TextRotatedDegree, + new List() { Position }, x, y, opacity); + } + /// + /// 写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// 旋转角度 + /// 水印位置 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, string wmText, string WatermarkFont, Color TextColor, int TextSize, int TextRotatedDegree, WatermarkPosition Position, float opacity) + { + return DrawWatermark(image, wmText, WatermarkFont, TextColor, TextSize, TextRotatedDegree, + new List() { Position }, 0,0, opacity); + } + /// + /// 往图片右下角写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// 不透明度(0~1),越小越透明 + /// + public static Bitmap DrawWatermark(this Image image, string wmText, string WatermarkFont, Color TextColor, int TextSize, float opacity) + { + return DrawWatermark(image, wmText, WatermarkFont, TextColor, TextSize, 0, + new List() { WatermarkPosition.BottomRightCorner }, 0, 0, opacity); + } + /// + /// 往图片右下角写入水印文字 + /// + /// 图片 + /// 水印文字 + /// 水印字体名字 + /// 字体颜色 + /// 字体大小 + /// + public static Bitmap DrawWatermark(this Image image, string wmText, string WatermarkFont, Color TextColor, int TextSize) + { + return DrawWatermark(image, wmText, WatermarkFont, TextColor, TextSize, 0, + new List() { WatermarkPosition.BottomRightCorner }, 0, 0, 0.1f); + } + /// + /// 缩放 + /// + /// + /// 宽 + /// 高 + /// 插值算法 + /// 返回缩放后的图片 + /// Image 不能为 null + /// 操作失败 + public static System.Drawing.Image Zoom(this System.Drawing.Image i, int width, int height, InterpolationMode mode) + { + Bitmap bitmap = new Bitmap(width, height); + using (Graphics g = Graphics.FromImage(bitmap)) + { + g.InterpolationMode = mode; + g.Clear(Color.Empty); + g.DrawImage(i, new Rectangle(0, 0, width, height), new Rectangle(0, 0, i.Width, i.Height), GraphicsUnit.Pixel); + } + return bitmap; + } + /// + /// 缩放 + /// + /// + /// 宽 + /// 高 + /// 返回缩放后的图片 + /// Image 不能为 null + /// 操作失败 + public static System.Drawing.Image Zoom(this System.Drawing.Image i, int width, int height) + { + Bitmap bitmap = new Bitmap(width, height); + using (Graphics g = Graphics.FromImage(bitmap)) + { + g.InterpolationMode = InterpolationMode.HighQualityBicubic; + g.Clear(Color.Empty); + g.DrawImage(i, new Rectangle(0, 0, width, height), new Rectangle(0, 0, i.Width, i.Height), GraphicsUnit.Pixel); + } + return bitmap; + } + #endregion + /// + /// 根据原边长和新边长计算绘制的起始点坐标 + /// + /// + /// + /// + private static int GetSrc(int oldLength, int newLength) + { + return ((float)(oldLength - newLength) / 2).ToInt(); + } + /// + /// 获取缩放模式 + /// + /// + /// + /// + /// + /// 是否裁剪图片 + /// + private static ResizeMode GetMode(int oldWidth, int oldHeight, int newWidth, int newHeight, bool crop) + { + float oldScale = (float)oldWidth / oldHeight; + float newScale = (float)newWidth / newHeight; + if (crop) + { + return oldScale < newScale ? ResizeMode.WidthFirst : ResizeMode.HeightFirst; + } + else + { + return oldScale > newScale ? ResizeMode.WidthFirst : ResizeMode.HeightFirst; + } + } + /// + /// 裁剪或填充 + /// + /// + /// + /// + /// 背景色 + /// 插值算法 + /// + /// Image 不能为 null + /// 操作失败 + private static System.Drawing.Image CropOrFill(this System.Drawing.Image image, int width, int height, Color background, InterpolationMode mode) + { + Bitmap bitmap = new Bitmap(width, height); + using (Graphics g = Graphics.FromImage(bitmap)) + { + g.InterpolationMode = mode; + int srcX = GetSrc(image.Width, width); + int srcY = GetSrc(image.Height, height); + g.Clear(background); + g.DrawImage(image, new Rectangle(0, 0, width, height), srcX, srcY, width, height, GraphicsUnit.Pixel); + } + return bitmap; + } + /// + /// 裁剪 + /// + /// + /// 宽度 + /// 高度 + /// + /// 返回裁剪后的图片 + /// Image 不能为 null + /// 新的图片尺寸的宽度和高度必须大于零 + /// 操作失败 + public static System.Drawing.Image Crop(this System.Drawing.Image i, int width, int height, InterpolationMode interpolationMode) + { + return i.ReSize(width, height,Color.Transparent, GetMode(i.Width, i.Height, width, height, true), interpolationMode); + } + /// + /// 调整宽度 + /// + /// + /// + /// + public static Image ReSizeW(this Image i, int width) + { + return i.ReSize(width, (((float)width / i.Width) * i.Height).ToInt(), ResizeMode.WidthFirst); + } + /// + /// 根据最大宽度调整图片尺寸 + /// + /// + /// 最大宽度 + /// 返回调整后的图片 + /// Image 不能为 null + /// 最大宽度必须大于零 + /// 操作失败 + public static System.Drawing.Image ResizeMaxW(this System.Drawing.Image i, int maxWidth) + { + if (i.Width > maxWidth) + { + return i.ReSizeW(maxWidth); + } + else + { + return (System.Drawing.Image)i.Clone(); + } + } + /// + /// 根据最大高度调整图片尺寸 + /// + /// + /// 最大高度 + /// 返回调整后的图片 + /// Image 不能为 null + /// 最大宽度必须大于零 + /// 操作失败 + public static System.Drawing.Image ResizeMaxH(this System.Drawing.Image i, int maxHeight) + { + if (i.Height > maxHeight) + { + return i.ReSizeH(maxHeight); + } + else + { + return (System.Drawing.Image)i.Clone(); + } + } + /// + /// 根据最长边调整图片尺寸 + /// + /// + /// 设置最长边允许的值,当最长边大于这个值时,自动缩放 + /// 返回调整后的图片 + /// Image 不能为 null + /// 最大值必须大于零 + /// 操作失败 + public static System.Drawing.Image ResizeMax(this System.Drawing.Image i, int maxValue) + { + if (i.Height > i.Width && i.Height> maxValue) + { + return i.ReSizeH(maxValue); + } + else if (i.Width > i.Height && i.Width > maxValue) + { + return i.ReSizeW(maxValue); + } + else + { + return (System.Drawing.Image)i.Clone(); + } + } + /// + /// 调整高度 + /// + /// + /// + /// + public static Image ReSizeH(this Image i, int height) + { + return i.ReSize((((float)height / i.Height) * i.Width).ToInt(), height, ResizeMode.WidthFirst); + } + /// + /// 调整图片大小 + /// + /// + /// + /// + /// + /// + public static Image ReSize(this Image i, int width, int height, ResizeMode resizeMode) + { + return ReSize(i, width, height, Color.Transparent, resizeMode); + } + /// + /// 调整图片大小 + /// + /// + /// + /// + /// + /// + /// + public static Image ReSize(this Image i, int width, int height, Color background, ResizeMode resizeMode) + { + return ReSize(i,width,height,background,resizeMode, InterpolationMode.HighQualityBilinear); + } + /// + /// 调整图片大小 + /// + /// + /// + /// + /// + /// + /// + /// + /// + public static Image ReSize(this Image i,int width,int height, Color background, ResizeMode resizeMode, InterpolationMode interpolationMode) + { + if (width <= 0 || height <= 0) + { + throw new ArgumentOutOfRangeException("新的图片尺寸的宽和高必须大于零"); + } + //如果原图片和新图片尺寸一致，克隆对象返回 + if (i.Width == width && i.Height == height) + { + return (System.Drawing.Image)i.Clone(); + } + if (((float)i.Width / i.Height == (float)width / height)) + { + //如果原图片和新图片的比例相同，只缩放 + return i.Zoom(width, height); + } + else + { + Size size = new Size(); + //新宽高比 + float scale = (float)width / height; + if (resizeMode == ResizeMode.WidthFirst) + { + //等宽，计算高 + size.Width = i.Width; + size.Height = (i.Width / scale).ToInt(); + } + else + { + //等高，计算宽 + size.Height = i.Height; + size.Width = (i.Height * scale).ToInt(); + } + //如果原图片和新图片的比例不同，先裁剪或填充后，再缩放 + using (System.Drawing.Image cropOrFill = i.CropOrFill(size.Width, size.Height, background, interpolationMode)) + { + return cropOrFill.Zoom(width, height, interpolationMode); + } + } + } + /// + /// 转换Image为Icon + /// + /// 要转换为图标的Image对象 + /// 当image为null时是否返回null。false则抛空引用异常 + /// + public static Icon ConvertToIcon(Image image, bool nullTonull = false) + { + if (image == null) + { + if (nullTonull) { return null; } + throw new ArgumentNullException("image"); + } + + using (MemoryStream msImg = new MemoryStream() + , msIco = new MemoryStream()) + { + image.Save(msImg, ImageFormat.Png); + + using (var bin = new BinaryWriter(msIco)) + { + //写图标头部 + bin.Write((short)0); //0-1保留 + bin.Write((short)1); //2-3文件类型。1=图标, 2=光标 + bin.Write((short)1); //4-5图像数量（图标可以包含多个图像） + + bin.Write((byte)image.Width); //6图标宽度 + bin.Write((byte)image.Height); //7图标高度 + bin.Write((byte)0); //8颜色数（若像素位深>=8，填0。这是显然的，达到8bpp的颜色数最少是256，byte不够表示） + bin.Write((byte)0); //9保留。必须为0 + bin.Write((short)0); //10-11调色板 + bin.Write((short)32); //12-13位深 + bin.Write((int)msImg.Length); //14-17位图数据大小 + bin.Write(22); //18-21位图数据起始字节 + + //写图像数据 + bin.Write(msImg.ToArray()); + + bin.Flush(); + bin.Seek(0, SeekOrigin.Begin); + return new Icon(msIco); + } + } + } + } + /// + /// 缩放模式 + /// + public enum ResizeMode + { + /// + /// 宽度优先(不裁剪宽) + /// + WidthFirst, + + /// + /// 高度优先(不裁剪高) + /// + HeightFirst + } + /// + /// 水印位置 + /// + public enum WatermarkPosition + { + /// + /// 左上角 + /// + TopLeftCorner, + /// + /// 中上 + /// + TopCenter, + /// + /// 右上角 + /// + TopRightCorner, + /// + /// 左中 + /// + CenterLeft, + /// + /// 居中 + /// + Center, + /// + /// 右中 + /// + CenterRight, + /// + /// 左下角 + /// + BottomLeftCorner, + /// + /// 中下 + /// + BottomCenter, + /// + /// 右下角 + /// + BottomRightCorner, + /// + /// 全屏平铺 + /// + FullScreenTile, + } +} diff --git a/Source/RaUI/Common/FileFuns/RySetting.cs b/Source/RaUI/Common/FileFuns/RySetting.cs new file mode 100644 index 0000000..8192fe7 --- /dev/null +++ b/Source/RaUI/Common/FileFuns/RySetting.cs @@ -0,0 +1,493 @@ +using ryCommon.Pram; +using System; +using System.Collections.Generic; +using System.Linq; +using System.Text; +using System.Windows.Forms; + +namespace ryCommon +{ + /// + /// 设置管理类,快速添加设置。 + /// + public class RySetting + { + /// + /// 设置管理类,快速添加设置。 + /// + public RySetting() + { + } + /// + /// 设置管理类,快速添加设置。 + /// + /// + public RySetting(string _FilePath) + { + FilePath = _FilePath; + } + /// + /// 存储类型 + /// + public SettingType FileType = SettingType.XML; + /// + /// 配置存储路径 + /// + public string FilePath = ""; + /// + /// 设置XML内容 + /// + public string SettingXML = ""; + private string Section = "Setting"; + private List list = new List(); + /// + /// 添加控件 + /// + /// + /// + /// + public int Add(string _id,Control ctl) + { + return Add(_id, ctl, CValueType.Default,""); + } + /// + /// 设置值 + /// + /// + /// + /// + public int Add(string _id,string value) + { + return Add(_id, null, CValueType.Default,value); + } + /// + /// 添加控件 + /// + /// + /// + /// + /// + /// + public int Add(string _id, Control ctl,CValueType valuetype,object _defValue) + { + if(_id.ToLower()== Section.ToLower()) { return -1; } + list.Add(new Control_Info() { id = _id, control = ctl, value_type= valuetype, defValue= _defValue }); + return 1; + } + /// + /// 添加控件 + /// + /// + /// + /// + /// + public int Add(string _id, NumericUpDown ctl, decimal _defValue) + { + return Add(_id, ctl, CValueType.Default, _defValue); + } + /// + /// 添加控件 + /// + /// + /// + /// + /// + public int Add(string _id, DateTimePicker ctl, DateTime _defValue) + { + return Add(_id, ctl, CValueType.Default, _defValue); + } + /// + /// 添加控件 + /// + /// + /// + /// + /// + public int Add(string _id, CheckBox ctl, bool _defValue) + { + return Add(_id, ctl, CValueType.Default, _defValue); + } + /// + /// 添加控件 + /// + /// + /// + /// + /// + public int Add(string _id, ComboBox ctl, int _defValue) + { + return Add(_id, ctl, CValueType.ItemIndex, _defValue); + } + /// + /// 添加控件 + /// + /// + /// + /// + /// + public int Add(string _id, ComboBox ctl, string _defValue) + { + return Add(_id, ctl, CValueType.ItemText, _defValue); + } + /// + /// 添加控件 + /// + /// + /// + /// + /// + public int Add(string _id, TextBox ctl, string _defValue) + { + return Add(_id, ctl, CValueType.Default, _defValue); + } + /// + /// 读取配置 + /// + public void Read() + { + string filepath = FilePath; + if (FileType==SettingType.XML) + { + ryCommon.Storage myXML = new Storage(); + if (filepath == "") + { + myXML.LoadFromXMLText(SettingXML); + } + else + { + myXML.LoadFromFile(filepath); + } + myXML.SelectNode2("id", Section); + for(int i=0;i value && value >= 0) + { + cbb.SelectedIndex = value; + } + else + { + if (cbb.Items.Count > def_value && def_value >= 0) + cbb.SelectedIndex = def_value; + else + cbb.SelectedIndex = 0; + } + } + else if (item.value_type == CValueType.ItemText) + { + try + { + cbb.Text = myXML.GetAttrValue(item.id, item.defValue.ToString()); + } + catch { cbb.Text = item.defValue.ToString(); } + } + else if (item.value_type == CValueType.ObjectItem) + { + #region ObjectItem + string _id = myXML.GetAttrValue(item.id, item.defValue.ToString()); + bool haveRecord = false; + for (int m = 0; m < cbb.Items.Count; m++) + { + switch (cbb.Items[m]) + { + case ObjectItem c_item: + if (c_item.Id == _id) + { + cbb.SelectedIndex = m; + haveRecord = true; + break; + } + break; + } + } + if (!haveRecord) + { + cbb.SelectedIndex = 0; + } + #endregion + } + break; + #endregion + default: + var type = item.control.GetType().Name; + if (type == "HotkeyTextBox") + { + dynamic cc = item.control; + cc.HotKey = myXML.GetAttrValue(item.id, item.defValue.ToString()); + } + else + { + item.control.Text = myXML.GetAttrValue(item.id, item.defValue.ToString()); + } + break; + } + } + } + else if (FileType == SettingType.Ini) + { + ryCommon.Ini myIni = new ryCommon.Ini(filepath); + for (int i = 0; i < list.Count; i++) + { + Control_Info item = list[i]; + switch (item.control) + { + case CheckBox chk: + chk.Checked = myIni.ReadIni(Section, item.id, item.defValue.ToBool()); + break; + case TextBox txt: + txt.Text = myIni.ReadIni(Section, item.id, item.defValue.ToString()); + break; + case NumericUpDown num: + num.Value = myIni.ReadIni(Section, item.id, item.defValue.ToString()).ToDecimal(num.Minimum,num.Maximum, (decimal)item.defValue); + break; + case DateTimePicker dt_picker: + try + { + dt_picker.Value = RyDate.UnixTimeToDateTime(myIni.ReadIni(Section, item.id, RyDate.DateTimeToUnixTime((DateTime)item.defValue).ToString())); + } + catch + { + dt_picker.Value = (DateTime)item.defValue; + } + break; + case ComboBox cbb: + #region ComboBox + if (item.value_type == CValueType.ItemIndex || item.value_type == CValueType.Default) + { + int def_value = item.defValue.ToInt(0); + int value = myIni.ReadIni(Section, item.id, item.defValue.ToInt(0)); + if (cbb.Items.Count > value && value >= 0) + { + cbb.SelectedIndex = value; + } + else + { + if (cbb.Items.Count > def_value && def_value >= 0) + cbb.SelectedIndex = def_value; + else + cbb.SelectedIndex = 0; + } + } + else if (item.value_type == CValueType.ItemText) + { + try + { + cbb.Text = myIni.ReadIni(Section, item.id, item.defValue.ToString()); + } + catch { cbb.Text = item.defValue.ToString(); } + } + else if (item.value_type == CValueType.ObjectItem) + { + #region ObjectItem + string _id = myIni.ReadIni(Section, item.id, item.defValue.ToString()); + bool haveRecord = false; + for (int m = 0; m < cbb.Items.Count; m++) + { + switch (cbb.Items[m]) + { + case ObjectItem c_item: + if (c_item.Id == _id) + { + cbb.SelectedIndex = m; + haveRecord = true; + break; + } + break; + } + } + if (!haveRecord) + { + cbb.SelectedIndex = 0; + } + #endregion + } + break; + #endregion + default: + var type = item.control.GetType().Name; + if (type == "HotkeyTextBox") + { + dynamic cc = item.control; + cc.HotKey = myIni.ReadIni(Section, item.id, item.defValue.ToString()); + } + else + { + item.control.Text = myIni.ReadIni(Section, item.id, item.defValue.ToString()); + } + break; + } + } + } + } + /// + /// 保存配置 + /// + public void Save() + { + string filepath = FilePath; + if (FileType == SettingType.XML) + { + ryCommon.Storage myXML = new Storage(); + if (filepath == "") + { + myXML.LoadFromXMLText(SettingXML); + } + else + { + myXML.LoadFromFile(filepath); + } + myXML.SelectNode2("id", Section); + for (int i = 0; i < list.Count; i++) + { + Control_Info item = list[i]; + switch (item.control) + { + case CheckBox chk: + myXML.SetAttrValue(item.id, chk.Checked); + break; + case TextBox txt: + myXML.SetAttrValue(item.id, txt.Text); + break; + case NumericUpDown num: + myXML.SetAttrValue(item.id, num.Value); + break; + case DateTimePicker dt_picker: + myXML.SetAttrValue(item.id, RyDate.DateTimeToUnixTime(dt_picker.Value).ToString()); + break; + case ComboBox cbb: + #region ComboBox + if (item.value_type == CValueType.ItemIndex || item.value_type == CValueType.Default) + { + myXML.SetAttrValue(item.id, cbb.SelectedIndex); + } + else if (item.value_type == CValueType.ItemText) + { + myXML.SetAttrValue(item.id, cbb.Text); + } + else if (item.value_type == CValueType.ObjectItem) + { + switch (cbb.SelectedItem) + { + case ObjectItem c_item: + myXML.SetAttrValue(item.id, c_item.Id); + break; + } + } + break; + #endregion + case null: + myXML.SetAttrValue(item.id, item.defValue.ToString()); + break; + default: + var type = item.control.GetType().Name; + if (type == "HotkeyTextBox") + { + dynamic cc = item.control; + myXML.SetAttrValue(item.id, cc.HotKey); + } + else + { + myXML.SetAttrValue(item.id, item.control.Text); + } + break; + } + } + if (filepath == "") + { + SettingXML=myXML.XMLText; + } + else + { + myXML.SaveToFile(filepath); + } + } + else if (FileType == SettingType.Ini) + { + ryCommon.Ini myIni = new ryCommon.Ini(filepath); + for (int i = 0; i < list.Count; i++) + { + Control_Info item = list[i]; + switch (item.control) + { + case CheckBox chk: + myIni.WriteIni(Section, item.id, chk.Checked); + break; + case TextBox txt: + myIni.WriteIni(Section, item.id, txt.Text); + break; + case NumericUpDown num: + myIni.WriteIni(Section, item.id, num.Value); + break; + case DateTimePicker dt_picker: + myIni.WriteIni(Section, item.id, RyDate.DateTimeToUnixTime(dt_picker.Value).ToString()); + break; + case ComboBox cbb: + #region ComboBox + if (item.value_type == CValueType.ItemIndex || item.value_type == CValueType.Default) + { + myIni.WriteIni(Section, item.id, cbb.SelectedIndex); + } + else if (item.value_type == CValueType.ItemText) + { + myIni.WriteIni(Section, item.id, cbb.Text); + } + else if (item.value_type == CValueType.ObjectItem) + { + switch (cbb.SelectedItem) + { + case ObjectItem c_item: + myIni.WriteIni(Section, item.id, c_item.Id); + break; + } + } + break; + #endregion + case null: + myIni.WriteIni(Section, item.id, item.defValue.ToString()); + break; + default: + var type = item.control.GetType().Name; + if (type == "HotkeyTextBox") + { + dynamic cc = item.control; + myIni.WriteIni(Section, item.id, cc.HotKey); + + } + else + { + myIni.WriteIni(Section, item.id, item.control.Text); + } + break; + } + } + } + } + } +} diff --git a/Source/RaUI/Common/FileFuns/RySoft.cs b/Source/RaUI/Common/FileFuns/RySoft.cs new file mode 100644 index 0000000..5e53ec8 --- /dev/null +++ b/Source/RaUI/Common/FileFuns/RySoft.cs @@ -0,0 +1,176 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Reflection; +using System.Text; +using System.Windows.Forms; +using static System.Net.Mime.MediaTypeNames; + +namespace ryCommon +{ + /// + /// 文件信息 + /// + public class RySoft + { + /// + /// 获取版本号 + /// + public static string VersionStr + { + get + { + //Version ver = Assembly.LoadFile(Application.ExecutablePath).GetName().Version; + //Version ver = Assembly.GetEntryAssembly().GetName().Version; + //return ver.Major.ToString() + "." + ver.Minor.ToString() + "." + ver.Build.ToString() + "." + ver.; + return GetVersionStr(System.Windows.Forms.Application.ExecutablePath); + } + } + /// + /// 获取版本号 + /// + /// + /// + public static string GetVersionStr(string exe_path) + { + try + { + System.Diagnostics.FileVersionInfo info = System.Diagnostics.FileVersionInfo.GetVersionInfo(exe_path); + return info.ProductVersion; + } + catch { return ""; } + //Version ver = Assembly.LoadFile(exe_path).GetName().Version; + //return ver.Major.ToString() + "." + ver.Minor.ToString() + "." + ver.Build.ToString() + "." + ver.Revision.ToString(); + } + /// + /// 根据版本字符串输出double类型的版本号 + /// + /// + /// + /// + public static void GetVerByVerStr(string ver, out double _softVer, out double _reVer) + { + _softVer = 0; + _reVer = 0; + string[] ver_item = ver.Split('.'); + switch (ver_item.Length) + { + case 1: + _softVer = ver_item[0].ToDouble(0); + break; + case 2: + _softVer = ver.ToDouble(0); + break; + case 3: + _softVer = (ver_item[0] + "." + ver_item[1]).ToDouble(0); + _reVer = ver_item[2].ToDouble(0); + break; + case 4: + _softVer = (ver_item[0] + "." + ver_item[1]).ToDouble(0); + _reVer = (ver_item[2] + "." + ver_item[3]).ToDouble(0); + break; + } + } + + /// + /// 比较两个版本号大小 + /// + /// + /// + /// oldVer小于newVer,返回1,大于则返回-1,相等返回0,不支持则返回-1000 + public static int CompareVer(string oldVer,string newVer) + { + if (oldVer == newVer) { return 0; } + if(oldVer==null || newVer == null) { return -1000; } + var _oldVer = oldVer; + var _newVer = newVer; + if (_oldVer.StartsWith("v", StringComparison.OrdinalIgnoreCase)) { _oldVer = _oldVer.Substring(1); } + if (_newVer.StartsWith("v", StringComparison.OrdinalIgnoreCase)) { _newVer = _newVer.Substring(1); } + //var have_ts = false; + if (!_oldVer.Replace(".", "").Replace("_", "").IsInt()) + { + _oldVer = GetVer(_oldVer); + //have_ts = true; + if (_oldVer.Length == 0) + { + return -1000; + } + } + if (!_newVer.Replace(".", "").Replace("_", "").IsInt()) + { + _newVer = GetVer(_newVer); + //have_ts = true; + if (_newVer.Length == 0) + { + return -1000; + } + } + var old_split = _oldVer.Split("._".ToCharArray()); + var new_split = _newVer.Split("._".ToCharArray()); + for (int i = 0; i < new_split.Length; i++) + { + var item_new = new_split[i].ToInt(); + var item_old = 0; + if (old_split.Length > i) { item_old = old_split[i].ToInt(); } + if (item_new > item_old) { return 1; } + if (item_new < item_old) { return -1; } + } + //if (have_ts) + //{ + // return -1000; + //} + return 0; + } + /// + /// 从字符串中提取版本号 + /// + /// + /// + public static string GetVer(string text) + { + if (string.IsNullOrEmpty(text)) { return ""; } + var start = false; + var ver = ""; + for (int i = text.Length - 1; i >= 0; i--) + { + var word = text[i]; + if (!start && word >= '0' && word <= '9') { ver = word.ToString(); start = true; } + else if (start) + { + if ((word >= '0' && word <= '9') || word == '.') { ver = word.ToString() + ver; } + else { break; } + } + } + return ver; + } + /// + /// 比较版本号 + /// + /// + /// + /// + /// + /// old小于new,返回1,大于则返回-1,相等返回0 + public static int CompareVer(double _old_softVer,double _old_reVer, double _new_softVer, double _new_reVer) + { + if (_old_softVer < _new_softVer) { return 1; } + if (_old_softVer == _new_softVer) + { + if (_old_reVer < _new_reVer) { return 1; } + else if (_old_reVer == _new_reVer) { return 0; } + else { return -1; } + } + else { return -1; } + } + /// + /// 判断是否是管理员方式运行 + /// + /// + public static bool IsAdministrator() + { + System.Security.Principal.WindowsIdentity identity = System.Security.Principal.WindowsIdentity.GetCurrent(); + System.Security.Principal.WindowsPrincipal principal = new System.Security.Principal.WindowsPrincipal(identity); + return principal.IsInRole(System.Security.Principal.WindowsBuiltInRole.Administrator); + } + } +} diff --git a/Source/RaUI/Common/FileFuns/SoundPlay.cs b/Source/RaUI/Common/FileFuns/SoundPlay.cs new file mode 100644 index 0000000..5040cdd --- /dev/null +++ b/Source/RaUI/Common/FileFuns/SoundPlay.cs @@ -0,0 +1,149 @@ +using System; +using System.Collections.Generic; +using System.IO; +using System.Linq; +using System.Runtime.InteropServices; +using System.Text; + +namespace ryCommon +{ + /// + /// 音频播放类 + /// + public class SoundPlay + { + [DllImport("winmm.dll", SetLastError = true)] + static extern bool PlaySound(string pszSound, IntPtr hmod, uint fdwSound); + [DllImport("winmm.dll")] + static extern Int32 mciSendString(String command, StringBuilder buffer, Int32 bufferSize, IntPtr hwndCallback); + /// + /// 临时音频文件 + /// + private String m_musicPath = ""; + /// + ///父窗口句柄 + /// + private IntPtr m_Handle; + /// + /// 声音标签 + /// + [Flags] + public enum SoundFlags + { + /// play synchronously (default) + SND_SYNC = 0x0000, + /// play asynchronously + SND_ASYNC = 0x0001, + /// silence (!default) if sound not found + SND_NODEFAULT = 0x0002, + /// pszSound points to a memory file + SND_MEMORY = 0x0004, + /// loop the sound until next sndPlaySound + SND_LOOP = 0x0008, + /// don’t stop any currently playing sound + SND_NOSTOP = 0x0010, + /// Stop Playing Wave + SND_PURGE = 0x40, + /// don’t wait if the driver is busy + SND_NOWAIT = 0x00002000, + /// name is a registry alias + SND_ALIAS = 0x00010000, + /// alias is a predefined id + SND_ALIAS_ID = 0x00110000, + /// name is file name + SND_FILENAME = 0x00020000, + /// name is resource name or atom + SND_RESOURCE = 0x00040004 + } + /// + /// 音频播放类 + /// + /// embedded music file + /// 临时保存的文件位置 + /// 父窗口句柄 + public SoundPlay(Byte[] Music, string folder_path, IntPtr Handle) + { + try + { + m_Handle = Handle; + m_musicPath = Path.Combine(folder_path, "temp.mp3"); + FileStream fs = new FileStream(m_musicPath, FileMode.Create); + fs.Write(Music, 0, Music.Length); + fs.Close(); + } + catch (Exception) + { + } + } + /// + ///音频播放类 + /// + /// 要播放的音频位置 + /// 父窗口句柄 + public SoundPlay(String musicPath, IntPtr Handle) + { + m_musicPath = musicPath; + m_Handle = Handle; + } + /// + /// 音频播放类 + /// + /// + /// 父窗口句柄 + public SoundPlay(Byte[] Music, IntPtr Handle) : this(Music, @"C:\Windows\",Handle) + { + } + [DllImport("Kernel32", CharSet = CharSet.Auto)] + static extern Int32 GetShortPathName(String path, StringBuilder shortPath, Int32 shortPathLength); + /// + /// 播放音频 + /// + /// + public void Play(string path) + { + if(path != "" && System.IO.File.Exists(path)) + { + try + { + string ext = System.IO.Path.GetExtension(path).ToLower(); + if (ext == ".mp3") + { + StringBuilder shortpath = new StringBuilder(260); + int result = GetShortPathName(path, shortpath, shortpath.Capacity); + mciSendString(@"close all", null, 0, m_Handle); + mciSendString("open " + shortpath.ToString() + " alias song", null, 0, m_Handle); + mciSendString("play song", null, 0, m_Handle); + } + else if (ext == ".wav") + { + PlaySound(path, m_Handle,(uint)(SoundFlags.SND_FILENAME | SoundFlags.SND_SYNC | SoundFlags.SND_NOSTOP)); + + } + } + catch (Exception) + { + } + } + } + /// + /// 播放音频 + /// + public void Play() + { + Play(m_musicPath); + } + /// + /// 关闭音频 + /// + void CloseMedia() + { + try + { + mciSendString("Close ALL", null, 0, m_Handle); + } + catch (Exception) + { + } + } + } +} diff --git a/Source/RaUI/Common/FileFuns/Storage.cs b/Source/RaUI/Common/FileFuns/Storage.cs new file mode 100644 index 0000000..a94ca26 --- /dev/null +++ b/Source/RaUI/Common/FileFuns/Storage.cs @@ -0,0 +1,1011 @@ +//--------------------------日期:2017-04-07 +//--------------------------版本:2.0.0 .0 +//--------------------------作者:itrycn +using System; +using System.Collections.Generic; +using System.Text; +using System.Xml; +//XML存储类 +namespace ryCommon +{ + /// + /// XML操作类 + /// + public class Storage + { + private XmlDocument xmlDoc = new XmlDocument(); + private XmlNode xmlNode; + private XmlElement element; + //private System.Xml.XmlNodeList NodeList2; + /// + /// XML操作类 + /// + public Storage() + { + string strXMLText = ""; + xmlDoc.LoadXml(strXMLText); + } + /// + /// 从XML文本中加载数据 + /// + /// + public Storage(string XMLText) //从XML文本中加载数据 + { + try + { + xmlDoc.LoadXml(XMLText); + } + catch + { + xmlDoc.LoadXml(""); + } + } + #region 从指定的XML文本中加载 + /// + /// 从指定的XML文本中加载 + /// + /// XML文本 + /// 如为1，表示加载成功，为0为失败 + public int LoadFromXMLText(string XMLText) + { + try + { + xmlDoc.LoadXml(XMLText); + return 1; + } + catch + { + xmlDoc.LoadXml(""); + return 0; + } + } + #endregion + #region 加载空的XML文本 + /// + /// 载入空的XML文档 + /// + /// 如为1，表示加载成功，为0为失败 + public int LoadEmptyXMLText() + { + try + { + xmlDoc.LoadXml(""); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 从指定的文件中加载 + /// + /// 从指定的文件中加载 + /// + /// XML文件路径 + /// 如为1，表示加载成功，为0为失败 + public int LoadFromFile(string FilePath) + { + try + { + xmlDoc.Load(FilePath); + return 1; + } + catch + { + xmlDoc.LoadXml(""); + return 0; + } + } + #endregion + #region 保存到指定文件中 + /// + /// 保存到指定文件中 + /// + /// 文件路径 + /// 如为1，表示保存成功，为0为失败 + public int SaveToFile(string sFilePath) + { + try + { + if (sFilePath != "" && !System.IO.Directory.Exists(System.IO.Path.GetDirectoryName(sFilePath))) + { + System.IO.Directory.CreateDirectory(System.IO.Path.GetDirectoryName(sFilePath)); + } + xmlDoc.Save(sFilePath); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 判断节点是否存在 + /// + /// 判断节点是否存在 + /// + /// 属性名 + /// 属性值 + /// 返回1，表示存在，其它表示不存在 + public int HaveNode(string AttrName, string sValue) + { + try + { + //根据指定路径获取节点 + XmlNode xmlNode2 = null; + xmlNode2 = xmlDoc.SelectSingleNode("root/list[@" + AttrName + "='" + sValue + "']"); + if (xmlNode2 == null) + { + return 0; + } + else + { + return 1; + } + } + catch + { + return 0; + } + } + #endregion + #region 定位节点 + /// + /// 定位节点 + /// + /// 属性名 + /// 属性值 + /// 返回第一个符合要求的结果 + public int SelectNode(string AttrName, string sValue) + { + try + { + //根据指定路径获取节点 + element = null; + xmlNode = xmlDoc.SelectSingleNode("root/list[@" + AttrName + "='" + sValue + "']"); + element = (XmlElement)xmlNode; + if (element == null) + { + return 0; + } + else + { + return 1; + } + } + catch + { + return 0; + } + } + #endregion + #region 定位节点2 + /// + /// 定位节点,如果找不到节点，就新建一个节点 + /// + /// 属性名 + /// 属性值 + /// 返回第一个符合要求的结果 + public int SelectNode2(string AttrName, string sValue) + { + try + { + //根据指定路径获取节点 + element = null; + xmlNode = xmlDoc.SelectSingleNode("root/list[@" + AttrName + "='" + sValue + "']"); + element = (XmlElement)xmlNode; + if (element == null) + { + return AddNode2(AttrName, sValue); + } + else + { + return 1; + } + } + catch + { + return 0; + } + } + #endregion + #region 定位节点3 + /// + /// 根据用户的节点定位节点，输入节点时，一定要注意节点是属于类内部的，否则可能出错。 + /// + /// 返回第一个符合要求的结果 + public int SelectNode3(XmlNode m_xmlNode) + { + try + { + //根据指定路径获取节点 + element = null; + xmlNode = m_xmlNode; + element = (XmlElement)xmlNode; + if (element == null) + { + return 0; + } + else + { + return 1; + } + } + catch + { + return 0; + } + } + #endregion + #region 定位设置节点 + /// + /// 定位设置节点 + /// + /// 返回第一个符合要求的结果 + public int SelectNodeBySet() + { + return SelectNode2("id", "Setting"); + } + /// + /// 在节点后插入数据 + /// + /// + /// + public XmlNode InsertAfter(int index) + { + XmlNode root = xmlDoc.SelectSingleNode("root"); + XmlNode refChild = xmlDoc.SelectSingleNode("root//list[" + index + "]"); + return root.InsertAfter(xmlNode, refChild); + } + /// + /// 在节点前插入数据 + /// + /// + /// + public XmlNode InsertBefore(int index) + { + XmlNode root = xmlDoc.SelectSingleNode("root"); + XmlNode refChild = xmlDoc.SelectSingleNode("root//list["+index+"]"); + return root.InsertBefore(xmlNode, refChild); + } + #endregion + #region 获取节点数量 + /// + /// 获取节点数量 + /// + /// 属性名 + /// 属性值 + /// 返回符合要求的结果数量 + public int GetSelectNodeCount(string AttrName, string sValue) + { + try + { + //根据指定路径获取节点 + return xmlDoc.SelectNodes("root/list[@" + AttrName + "='" + sValue + "']").Count; + } + catch + { + return 0; + } + } + #endregion + #region 获取节点数量 + /// + /// 获取节点数量 + /// + /// 返回符合要求的结果数量 + public int GetNodeCount() + { + try + { + //根据指定路径获取节点 + return xmlDoc.SelectNodes("root/list").Count; + } + catch + { + return 0; + } + } + #endregion + private int ConvertInt(string str, int defValue) + { + try + { + return Convert.ToInt32(str); + } + catch + { + return defValue; + } + } + #region 获取节点数量 + /// + /// 获取节点数量 + /// + /// 属性名 + /// 属性值 + /// + /// + /// + /// 返回符合要求的结果数量 + public int GetSelectNodeCount(string AttrName, string sValue, string AttrName2, string Relation, int sValue2) + { + try + { + //根据指定路径获取节点 + XmlNodeList nodelist = xmlDoc.SelectNodes("root/list[@" + AttrName + "='" + sValue + "']"); + int icount = 0; + for (int i = 0; i < nodelist.Count; i++) + { + XmlAttribute attr = nodelist.Item(i).Attributes[AttrName2]; + if (attr != null) + { + switch (Relation) + { + case "<": + if (ConvertInt(attr.Value, 0) < sValue2) + { + icount++; + } + break; + case ">": + if (ConvertInt(attr.Value, 0) > sValue2) + { + icount++; + } + break; + case "=": + if (ConvertInt(attr.Value, 0) == sValue2) + { + icount++; + } + break; + case "<>": + if (ConvertInt(attr.Value, 0) != sValue2) + { + icount++; + } + break; + case ">=": + if (ConvertInt(attr.Value, 0) >= sValue2) + { + icount++; + } + break; + case "<=": + if (ConvertInt(attr.Value, 0) <= sValue2) + { + icount++; + } + break; + } + } + } + return icount; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值 + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, string strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(布尔类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, bool strValue) + { + try + { //设置节点值 + string m_value = "0"; + if (strValue == true) { m_value = "1"; } + element.SetAttribute(strName, m_value); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(int类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, int strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToString()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(long类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public long SetAttrValue(string strName, long strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToString()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(decimal类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, decimal strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToString()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(double类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, double strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToString()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 设置节点值(日期类型) + /// + /// 设置节点值 + /// + /// 属性名 + /// 属性值 + /// 如为1，表示加载成功，为0为失败 + public int SetAttrValue(string strName, DateTime strValue) + { + try + { //设置节点值 + element.SetAttribute(strName, strValue.ToDateTimeStr()); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 读取指定节点的值 + /// + /// 读取指定节点的值(string) + /// + /// + /// + public string GetAttrValue(string strNode) + { + try + { + if (element == null) { return ""; } + //根据路径获取节点 + return element.GetAttribute(strNode); + } + catch + { + return ""; + } + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public string GetAttrValueByBase64(string strNode,string defValue) + { + try + { + //根据路径获取节点 + string str= element.GetAttribute(strNode); + ryCommon.Strings cStr = new Strings(); + string base64 = cStr.Base64ToStr(str); + if (base64 == "") { return defValue; } + return base64; + } + catch + { + return defValue; + } + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public bool GetAttrValue(string strNode, bool defValue) + { + return GetAttrValueByBool(strNode, defValue); + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public int GetAttrValue(string strNode, int defValue) + { + return GetAttrValueByInt(strNode, defValue); + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + /// + /// + public int GetAttrValue(string strNode, int min,int max,int defValue) + { + var value= GetAttrValueByInt(strNode, defValue); + if(value>=min && value<=max) + { + return value; + } + return defValue; + } + /// + /// 获取属性值 + /// + /// + /// + /// + public long GetAttrValue(string strNode, long defValue) + { + try + { + //根据路径获取节点 + string strTemp = element.GetAttribute(strNode); + return Convert.ToInt64(strTemp); + } + catch + { + return defValue; + } + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public decimal GetAttrValue(string strNode, decimal defValue) + { + return GetAttrValueByDecimal(strNode, defValue); + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public double GetAttrValue(string strNode, double defValue) + { + try + { + //根据路径获取节点 + string strTemp = element.GetAttribute(strNode); + return Convert.ToDouble(strTemp); + } + catch + { + return defValue; + } + } + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public DateTime GetAttrValue(string strNode, DateTime defValue) + { + return GetAttrValueByDate(strNode, defValue); + } + #endregion + #region 读取指定节点的值 + /// + /// 读取所有的节点名称 + /// + /// + public string[] GetAttrNames() + { + try + { + if (element == null) { return null; } + string[] items = new string[element.Attributes.Count]; + for (int i = 0; i < items.Length; i++) + { + items[i] = element.Attributes.Item(i).Name; + } + //根据路径获取节点 + return items; + } + catch + { + return null; + } + } + #endregion + #region 读取指定节点的值(string) + /// + /// 读取指定节点的值(string) + /// + /// + /// + /// + public string GetAttrValue(string strNode, string defValue) + { + try + { + //根据路径获取节点 + if (element == null) { return defValue; } + string strTemp = element.GetAttribute(strNode); + if (strTemp == "") + { + return defValue; + } + else + { + return strTemp; + } + } + catch + { + return defValue; + } + } + #endregion + #region 读取指定节点的值(int) + /// + /// 读取指定节点的值(int) + /// + /// + /// + /// + public int GetAttrValueByInt(string strNode, int defValue) + { + try + { + //根据路径获取节点 + if (element == null) { return defValue; } + string strTemp = element.GetAttribute(strNode); + return Convert.ToInt32(strTemp); + } + catch + { + return defValue; + } + } + #endregion + #region 读取指定节点的值(decimal) + /// + /// 读取指定节点的值(decimal) + /// + /// + /// + /// + public decimal GetAttrValueByDecimal(string strNode, decimal defValue) + { + try + { + if (element == null) { return defValue; } + //根据路径获取节点 + string strTemp = element.GetAttribute(strNode); + return Convert.ToDecimal(strTemp); + } + catch + { + return defValue; + } + } + #endregion + #region 读取指定节点的值5(布尔值) + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public bool GetAttrValueByBool(string strNode, bool defValue) + { + try + { + if (element == null) { return defValue; } + //根据路径获取节点 + if (!element.HasAttribute(strNode)) { return defValue; } + string strTemp = element.GetAttribute(strNode); + if (strTemp == "1") + { + return true; + } + else + { + return false; + } + } + catch + { + return defValue; + } + } + #endregion + #region 读取指定节点的值6(日期值) + /// + /// 读取指定节点的值 + /// + /// + /// + /// + public DateTime GetAttrValueByDate(string strNode, DateTime defValue) + { + try + { + if (element == null) { return defValue; } + //根据路径获取节点 + string strTemp = element.GetAttribute(strNode); + return Convert.ToDateTime(strTemp); + } + catch + { + return defValue; + } + } + #endregion + /// + /// 获取XML文件的根元素 + /// + public XmlNode GetXmlRoot() + { + return xmlDoc.DocumentElement; + } + #region 获取所有列表 + /// + /// 获取所有列表 + /// + /// 如为1，表示获取成功，为0为失败 + public XmlNodeList GetList() + { + try + { + return xmlDoc.DocumentElement.SelectNodes("child::list"); + } + catch + { + return null; + } + } + #endregion + #region 获取所有列表 + /// + /// 获取所有列表 + /// + /// 如为1，表示获取成功，为0为失败 + public XmlNodeList GetList(string xpath) + { + try + { + return xmlDoc.DocumentElement.SelectNodes(xpath); + } + catch + { + return null; + } + } + #endregion + #region 新增节点 + /// + /// 新增节点 + /// + /// + /// + /// + public int AddNode(string strName, string strValue) + { + try + { + XmlNode xmlNode2 = xmlDoc.SelectSingleNode("root"); + XmlNode childXmlNode = xmlDoc.CreateElement("list"); + xmlNode2.AppendChild(childXmlNode); + XmlElement element2 = (XmlElement)childXmlNode; + element2.SetAttribute(strName, strValue); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 新增节点并定位到新节点 + /// + /// 新增节点并定位到新节点 + /// + /// + /// + /// + public int AddNode2(string strName, string strValue) + { + try + { + XmlNode xmlNode2 = xmlDoc.SelectSingleNode("root"); + xmlNode = xmlDoc.CreateElement("list"); + xmlNode2.AppendChild(xmlNode); + element = (XmlElement)xmlNode; + element.SetAttribute(strName, strValue); + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 新增设置节点并定位 + /// + /// 新增设置节点并定位 + /// + /// + public int AddNodeBySet() + { + return AddNode2("id", "Setting"); + } + #endregion + #region 新增节点并定位到新节点 + /// + /// 在指定节点前新增节点并定位到新节点 + /// + /// + /// + /// + /// + public int AddNodeBefore(string strName, string strValue, XmlNode xn) + { + try + { + XmlNode xmlNode2 = xmlDoc.SelectSingleNode("root"); + xmlNode = xmlDoc.CreateElement("list"); + xmlNode2.InsertBefore(xmlNode, xn); + element = (XmlElement)xmlNode; + element.SetAttribute(strName, strValue); + return 1; + } + catch + { + return 0; + } + } + #endregion + /// + /// 获取当前节点 + /// + /// + public XmlNode GetNowXMLNode() + { + return xmlNode; + } + #region 删除节点 + /// + /// 删除节点 + /// + /// + public int DeleteNode() + { + try + { + //element.RemoveAll(); + GetXmlRoot().RemoveChild(xmlNode); + xmlNode = null; + element = null; + return 1; + } + catch + { + return 0; + } + } + #endregion + #region 获取XML文本 + /// + /// 获取XML文本 + /// + /// + public string GetXMLText() + { + return xmlDoc.OuterXml; + } + /// + /// 获取XML文本 + /// + /// + public string XMLText + { + get { return xmlDoc.OuterXml; } + } + #endregion + #region 获取XML文本 + /// + /// 获取文本 + /// + /// + public string GetText() + { + return xmlDoc.ToString(); ; + } + /// + /// 获取文本 + /// + /// + public string Text + { + get { return xmlDoc.InnerText; } + } + #endregion + } +} diff --git a/Source/RaUI/Common/FileFuns/TxtFileEncoder.cs b/Source/RaUI/Common/FileFuns/TxtFileEncoder.cs new file mode 100644 index 0000000..c97e036 --- /dev/null +++ b/Source/RaUI/Common/FileFuns/TxtFileEncoder.cs @@ -0,0 +1,272 @@ +using System; +using System.Collections.Generic; +using System.IO; +using System.Linq; +using System.Text; + +namespace ryCommon +{ + /// + /// 用于取得一个文本文件的编码方式(Encoding)。 + /// + public class TxtFileEncoder + { + /// + /// 用于取得一个文本文件的编码方式(Encoding)。 + /// + public TxtFileEncoder() + { + // + // TODO: 在此处添加构造函数逻辑 + // + } + /// + /// 取得一个文本文件的编码方式。如果无法在文件头部找到有效的前导符，Encoding.Default将被返回。 + /// + /// 文件名。 + /// + public static Encoding GetEncoding(string fileName) + { + return GetEncoding(fileName, Encoding.Default); + } + /// + /// 取得一个文本文件流的编码方式。 + /// + /// 文本文件流。 + /// + public static Encoding GetEncoding(FileStream stream) + { + return GetEncoding(stream, Encoding.Default); + } + /// + /// 取得一个文本文件的编码方式。 + /// + /// 文件名。 + /// 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + /// + public static Encoding GetEncoding(string fileName, Encoding defaultEncoding) + { + Encoding targetEncoding = defaultEncoding; + try + { + FileStream fs = new FileStream(fileName, FileMode.Open, FileAccess.Read); + try + { + targetEncoding = GetEncoding(fs, defaultEncoding); + } + catch { } + fs.Close(); + } + catch + { + return defaultEncoding; + } + return targetEncoding; + } + /// + /// 取得一个文本文件流的编码方式。 + /// + /// 文本文件流。 + /// 默认编码方式。当该方法无法从文件的头部取得有效的前导符时，将返回该编码方式。 + /// + public static Encoding GetEncoding(FileStream stream, Encoding defaultEncoding) + { + Encoding targetEncoding = defaultEncoding; + if (stream != null && stream.Length >= 2) + { + //保存文件流的前4个字节 + byte byte1; + byte byte2; + byte byte3 = 0; + byte byte4; + BinaryReader r = new BinaryReader(stream, System.Text.Encoding.Default); + byte[] ss; + ss = r.ReadBytes(stream.Length.ToInt()); + byte1 = ss.Length>=1?ss[0]:byte.MinValue; + byte2 = ss.Length >= 2 ? ss[1] : byte.MinValue; + if (stream.Length >= 3) + { + byte3 = ss.Length >= 3 ? ss[2] : byte.MinValue; + } + if (stream.Length >= 4) + { + byte4 = ss.Length >= 4 ? ss[3] : byte.MinValue; + } + //根据文件流的前4个字节判断Encoding + //Unicode {0xFF, 0xFE}; + //BE-Unicode {0xFE, 0xFF}; + //UTF8 = {0xEF, 0xBB, 0xBF}; + if (byte1 == 0xFE && byte2 == 0xFF)//UnicodeBe + { + targetEncoding = Encoding.BigEndianUnicode; + } + else if (byte1 == 0xFF && byte2 == 0xFE && byte3 != 0xFF)//Unicode + { + targetEncoding = Encoding.Unicode; + } + else if (byte1 == 0xEF && byte2 == 0xBB && byte3 == 0xBF)//UTF8 + { + targetEncoding = Encoding.UTF8; + } + else if (IsUTF8Bytes(ss))//UTF8 + { + targetEncoding =new UTF8Encoding(false); + } + //恢复Seek位置 + r.Close(); + } + return targetEncoding; + } + + + + // 新增加一个方法，解决了不带BOM的 UTF8 编码问题 + + /// + /// 通过给定的文件流，判断文件的编码类型 + /// + /// 文件流 + /// 文件的编码类型 + public static System.Text.Encoding GetEncoding(Stream fs) + { + byte[] Unicode = new byte[] { 0xFF, 0xFE, 0x41 }; + byte[] UnicodeBIG = new byte[] { 0xFE, 0xFF, 0x00 }; + byte[] UTF8 = new byte[] { 0xEF, 0xBB, 0xBF }; //带BOM + Encoding reVal = Encoding.Default; + + BinaryReader r = new BinaryReader(fs, System.Text.Encoding.Default); + byte[] ss = r.ReadBytes(4); + if (ss[0] == 0xFE && ss[1] == 0xFF && ss[2] == 0x00) + { + reVal = Encoding.BigEndianUnicode; + } + else if (ss[0] == 0xFF && ss[1] == 0xFE && ss[2] == 0x41) + { + reVal = Encoding.Unicode; + } + else + { + if (ss[0] == 0xEF && ss[1] == 0xBB && ss[2] == 0xBF) + { + reVal = Encoding.UTF8; + } + else + { + int.TryParse(fs.Length.ToString(), out int i); + ss = r.ReadBytes(i); + + if (GetBytesEncoding(ss)==Encoding.UTF8) + reVal = Encoding.UTF8; + } + } + r.Close(); + return reVal; + + } + private static Encoding GetBytesEncoding(byte[] bs) + { + int len = bs.Length; + if (len >= 3 && bs[0] == 0xEF && bs[1] == 0xBB && bs[2] == 0xBF) + { + return Encoding.UTF8; + } + int[] cs = { 7, 5, 4, 3, 2, 1, 0, 6, 14, 30, 62, 126 }; + for (int i = 0; i < len; i++) + { + int bits = -1; + for (int j = 0; j < 6; j++) + { + if (bs[i] >> cs[j] == cs[j + 6]) + { + bits = j; + break; + } + } + if (bits == -1) + { + return Encoding.Default; + } + while (bits-- > 0) + { + i++; + if (i == len || bs[i] >> 6 != 2) + { + return Encoding.Default; + } + } + } + return Encoding.UTF8; + } + private static byte UTF8CharacterMask1Byte = 0b1000_0000; + private static byte Valid1Byte = 0b0000_0000;//0b0xxx_xxxx + + private static byte UTF8CharacterMask2Byte = 0b1110_0000; + private static byte Valid2Byte = 0b1100_0000;//0b110x_xxxx + + private static byte UTF8CharacterMask3Byte = 0b1111_0000; + private static byte Valid3Byte = 0b1110_0000;//0b1110_xxxx + + private static byte UTF8CharacterMask4Byte = 0b1111_1000; + private static byte Valid4Byte = 0b1111_0000;//0b1111_0xxx + + private static byte UTF8CharacterMaskForExtraByte = 0b1100_0000; + private static byte ValidExtraByte = 0b1000_0000;//0b10xx_xxxx + /// + /// 判断是否是不带 BOM 的 UTF8 格式 + /// + /// + /// + public static bool IsUTF8Bytes(byte[] bytes) + { + short extraByteCount = 0; + + foreach (byte bt in bytes) + { + + if (extraByteCount > 0) + { + extraByteCount--; + + // Extra Byte Pattern. + if ((bt & UTF8CharacterMaskForExtraByte) != ValidExtraByte) + return false; + continue; + } + else + { + // 1 Byte Pattern. + if ((bt & UTF8CharacterMask1Byte) == Valid1Byte) + { + continue; + } + + // 2 Bytes Pattern. + if ((bt & UTF8CharacterMask2Byte) == Valid2Byte) + { + extraByteCount = 1; + continue; + } + + // 3 Bytes Pattern. + if ((bt & UTF8CharacterMask3Byte) == Valid3Byte) + { + extraByteCount = 2; + continue; + } + + // 4 Bytes Pattern. + if ((bt & UTF8CharacterMask4Byte) == Valid4Byte) + { + extraByteCount = 3; + continue; + } + + // invalid UTF8-Bytes. + return false; + } + } + + return extraByteCount >= 0; + } + } +} diff --git a/Source/RaUI/Common/FileFuns/WebP.cs b/Source/RaUI/Common/FileFuns/WebP.cs new file mode 100644 index 0000000..5aec7c6 --- /dev/null +++ b/Source/RaUI/Common/FileFuns/WebP.cs @@ -0,0 +1,1976 @@ +///////////////////////////////////////////////////////////////////////////////////////////////////////////// +// Wrapper for WebP format in C#. (MIT) Jose M. Piñeiro +///////////////////////////////////////////////////////////////////////////////////////////////////////////// +// Decode Functions: +// Bitmap Load(string pathFileName) - Load a WebP file in bitmap. +// Bitmap Decode(byte[] rawWebP) - Decode WebP data (rawWebP) to bitmap. +// Bitmap Decode(byte[] rawWebP, WebPDecoderOptions options) - Decode WebP data (rawWebP) to bitmap using 'options'. +// Bitmap GetThumbnailFast(byte[] rawWebP, int width, int height) - Get a thumbnail from WebP data (rawWebP) with dimensions 'width x height'. Fast mode. +// Bitmap GetThumbnailQuality(byte[] rawWebP, int width, int height) - Fast get a thumbnail from WebP data (rawWebP) with dimensions 'width x height'. Quality mode. +// +// Encode Functions: +// Save(Bitmap bmp, string pathFileName, int quality) - Save bitmap with quality lost to WebP file. Opcionally select 'quality'. +// byte[] EncodeLossy(Bitmap bmp, int quality) - Encode bitmap with quality lost to WebP byte array. Opcionally select 'quality'. +// byte[] EncodeLossy(Bitmap bmp, int quality, int speed, bool info) - Encode bitmap with quality lost to WebP byte array. Select 'quality', 'speed' and opcionally select 'info'. +// byte[] EncodeLossless(Bitmap bmp) - Encode bitmap without quality lost to WebP byte array. +// byte[] EncodeLossless(Bitmap bmp, int speed, bool info = false) - Encode bitmap without quality lost to WebP byte array. Select 'speed'. +// byte[] EncodeNearLossless(Bitmap bmp, int quality, int speed = 9, bool info = false) - Encode bitmap with nearlossless to WebP byte array. Select 'quality', 'speed' and opcionally select 'info'. +// +// Another functions: +// string GetVersion() - Get the library version +// GetInfo(byte[] rawWebP, out int width, out int height, out bool has_alpha, out bool has_animation, out string format) - Get information of WEBP data +// float[] PictureDistortion(Bitmap source, Bitmap reference, int metric_type) - Get PSNR, SSIM or LSIM distortion metric between two pictures +///////////////////////////////////////////////////////////////////////////////////////////////////////////// +using System; +using System.Drawing; +using System.Drawing.Imaging; +using System.IO; +using System.Runtime.InteropServices; +using System.Security; +using System.Windows.Forms; + +namespace ryCommon +{ + /// + /// + /// + public sealed class WebP : IDisposable + { + private const int WEBP_MAX_DIMENSION = 16383; + #region | Public Decode Functions | + /// Read a WebP file + /// WebP file to load + /// Bitmap with the WebP image + public Bitmap Load(string pathFileName) + { + try + { + byte[] rawWebP = File.ReadAllBytes(pathFileName); + + return Decode(rawWebP); + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.Load"); } + } + + /// Decode a WebP image + /// The data to uncompress + /// Bitmap with the WebP image + public Bitmap Decode(byte[] rawWebP) + { + Bitmap bmp = null; + BitmapData bmpData = null; + GCHandle pinnedWebP = GCHandle.Alloc(rawWebP, GCHandleType.Pinned); + int size; + + try + { + //Get image width and height + GetInfo(rawWebP, out int imgWidth, out int imgHeight, out bool hasAlpha, out bool hasAnimation, out string format); + + //Create a BitmapData and Lock all pixels to be written + if (hasAlpha) + bmp = new Bitmap(imgWidth, imgHeight, PixelFormat.Format32bppArgb); + else + bmp = new Bitmap(imgWidth, imgHeight, PixelFormat.Format24bppRgb); + bmpData = bmp.LockBits(new Rectangle(0, 0, imgWidth, imgHeight), ImageLockMode.WriteOnly, bmp.PixelFormat); + + //Uncompress the image + int outputSize = bmpData.Stride * imgHeight; + IntPtr ptrData = pinnedWebP.AddrOfPinnedObject(); + if (bmp.PixelFormat == PixelFormat.Format24bppRgb) + size = UnsafeNativeMethods.WebPDecodeBGRInto(ptrData, rawWebP.Length, bmpData.Scan0, outputSize, bmpData.Stride); + else + size = UnsafeNativeMethods.WebPDecodeBGRAInto(ptrData, rawWebP.Length, bmpData.Scan0, outputSize, bmpData.Stride); + if (size == 0) + throw new Exception("Can´t encode WebP"); + + return bmp; + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.Decode"); } + finally + { + //Unlock the pixels + if (bmpData != null) + bmp.UnlockBits(bmpData); + + //Free memory + if (pinnedWebP.IsAllocated) + pinnedWebP.Free(); + } + } + + /// Decode a WebP image + /// the data to uncompress + /// Options for advanced decode + /// Bitmap with the WebP image + public Bitmap Decode(byte[] rawWebP, WebPDecoderOptions options) + { + GCHandle pinnedWebP = GCHandle.Alloc(rawWebP, GCHandleType.Pinned); + Bitmap bmp = null; + BitmapData bmpData = null; + VP8StatusCode result; + try + { + WebPDecoderConfig config = new WebPDecoderConfig(); + if (UnsafeNativeMethods.WebPInitDecoderConfig(ref config) == 0) + { + throw new Exception("WebPInitDecoderConfig failed. Wrong version?"); + } + // Read the .webp input file information + IntPtr ptrRawWebP = pinnedWebP.AddrOfPinnedObject(); + int height; + int width; + if (options.use_scaling == 0) + { + result = UnsafeNativeMethods.WebPGetFeatures(ptrRawWebP, rawWebP.Length, ref config.input); + if (result != VP8StatusCode.VP8_STATUS_OK) + throw new Exception("Failed WebPGetFeatures with error " + result); + + //Test cropping values + if (options.use_cropping == 1) + { + if (options.crop_left + options.crop_width > config.input.Width || options.crop_top + options.crop_height > config.input.Height) + throw new Exception("Crop options exceded WebP image dimensions"); + width = options.crop_width; + height = options.crop_height; + } + } + else + { + width = options.scaled_width; + height = options.scaled_height; + } + + config.options.bypass_filtering = options.bypass_filtering; + config.options.no_fancy_upsampling = options.no_fancy_upsampling; + config.options.use_cropping = options.use_cropping; + config.options.crop_left = options.crop_left; + config.options.crop_top = options.crop_top; + config.options.crop_width = options.crop_width; + config.options.crop_height = options.crop_height; + config.options.use_scaling = options.use_scaling; + config.options.scaled_width = options.scaled_width; + config.options.scaled_height = options.scaled_height; + config.options.use_threads = options.use_threads; + config.options.dithering_strength = options.dithering_strength; + config.options.flip = options.flip; + config.options.alpha_dithering_strength = options.alpha_dithering_strength; + + //Create a BitmapData and Lock all pixels to be written + if (config.input.Has_alpha == 1) + { + config.output.colorspace = WEBP_CSP_MODE.MODE_bgrA; + bmp = new Bitmap(config.input.Width, config.input.Height, PixelFormat.Format32bppArgb); + } + else + { + config.output.colorspace = WEBP_CSP_MODE.MODE_BGR; + bmp = new Bitmap(config.input.Width, config.input.Height, PixelFormat.Format24bppRgb); + } + bmpData = bmp.LockBits(new Rectangle(0, 0, bmp.Width, bmp.Height), ImageLockMode.WriteOnly, bmp.PixelFormat); + + // Specify the output format + config.output.u.RGBA.rgba = bmpData.Scan0; + config.output.u.RGBA.stride = bmpData.Stride; + config.output.u.RGBA.size = (UIntPtr)(bmp.Height * bmpData.Stride); + config.output.height = bmp.Height; + config.output.width = bmp.Width; + config.output.is_external_memory = 1; + + // Decode + result = UnsafeNativeMethods.WebPDecode(ptrRawWebP, rawWebP.Length, ref config); + if (result != VP8StatusCode.VP8_STATUS_OK) + { + throw new Exception("Failed WebPDecode with error " + result); + } + UnsafeNativeMethods.WebPFreeDecBuffer(ref config.output); + + return bmp; + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.Decode"); } + finally + { + //Unlock the pixels + if (bmpData != null) + bmp.UnlockBits(bmpData); + + //Free memory + if (pinnedWebP.IsAllocated) + pinnedWebP.Free(); + } + } + + /// Get Thumbnail from webP in mode faster/low quality + /// The data to uncompress + /// Wanted width of thumbnail + /// Wanted height of thumbnail + /// Bitmap with the WebP thumbnail in 24bpp + public Bitmap GetThumbnailFast(byte[] rawWebP, int width, int height) + { + GCHandle pinnedWebP = GCHandle.Alloc(rawWebP, GCHandleType.Pinned); + Bitmap bmp = null; + BitmapData bmpData = null; + + try + { + WebPDecoderConfig config = new WebPDecoderConfig(); + if (UnsafeNativeMethods.WebPInitDecoderConfig(ref config) == 0) + throw new Exception("WebPInitDecoderConfig failed. Wrong version?"); + + // Set up decode options + config.options.bypass_filtering = 1; + config.options.no_fancy_upsampling = 1; + config.options.use_threads = 1; + config.options.use_scaling = 1; + config.options.scaled_width = width; + config.options.scaled_height = height; + + // Create a BitmapData and Lock all pixels to be written + bmp = new Bitmap(width, height, PixelFormat.Format24bppRgb); + bmpData = bmp.LockBits(new Rectangle(0, 0, width, height), ImageLockMode.WriteOnly, bmp.PixelFormat); + + // Specify the output format + config.output.colorspace = WEBP_CSP_MODE.MODE_BGR; + config.output.u.RGBA.rgba = bmpData.Scan0; + config.output.u.RGBA.stride = bmpData.Stride; + config.output.u.RGBA.size = (UIntPtr)(height * bmpData.Stride); + config.output.height = height; + config.output.width = width; + config.output.is_external_memory = 1; + + // Decode + IntPtr ptrRawWebP = pinnedWebP.AddrOfPinnedObject(); + VP8StatusCode result = UnsafeNativeMethods.WebPDecode(ptrRawWebP, rawWebP.Length, ref config); + if (result != VP8StatusCode.VP8_STATUS_OK) + throw new Exception("Failed WebPDecode with error " + result); + + UnsafeNativeMethods.WebPFreeDecBuffer(ref config.output); + + return bmp; + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.Thumbnail"); } + finally + { + //Unlock the pixels + if (bmpData != null) + bmp.UnlockBits(bmpData); + + //Free memory + if (pinnedWebP.IsAllocated) + pinnedWebP.Free(); + } + } + + /// Thumbnail from webP in mode slow/high quality + /// The data to uncompress + /// Wanted width of thumbnail + /// Wanted height of thumbnail + /// Bitmap with the WebP thumbnail + public Bitmap GetThumbnailQuality(byte[] rawWebP, int width, int height) + { + GCHandle pinnedWebP = GCHandle.Alloc(rawWebP, GCHandleType.Pinned); + Bitmap bmp = null; + BitmapData bmpData = null; + + try + { + WebPDecoderConfig config = new WebPDecoderConfig(); + if (UnsafeNativeMethods.WebPInitDecoderConfig(ref config) == 0) + throw new Exception("WebPInitDecoderConfig failed. Wrong version?"); + + IntPtr ptrRawWebP = pinnedWebP.AddrOfPinnedObject(); + VP8StatusCode result = UnsafeNativeMethods.WebPGetFeatures(ptrRawWebP, rawWebP.Length, ref config.input); + if (result != VP8StatusCode.VP8_STATUS_OK) + throw new Exception("Failed WebPGetFeatures with error " + result); + + // Set up decode options + config.options.bypass_filtering = 0; + config.options.no_fancy_upsampling = 0; + config.options.use_threads = 1; + config.options.use_scaling = 1; + config.options.scaled_width = width; + config.options.scaled_height = height; + + //Create a BitmapData and Lock all pixels to be written + if (config.input.Has_alpha == 1) + { + config.output.colorspace = WEBP_CSP_MODE.MODE_bgrA; + bmp = new Bitmap(width, height, PixelFormat.Format32bppArgb); + } + else + { + config.output.colorspace = WEBP_CSP_MODE.MODE_BGR; + bmp = new Bitmap(width, height, PixelFormat.Format24bppRgb); + } + bmpData = bmp.LockBits(new Rectangle(0, 0, width, height), ImageLockMode.WriteOnly, bmp.PixelFormat); + + // Specify the output format + config.output.u.RGBA.rgba = bmpData.Scan0; + config.output.u.RGBA.stride = bmpData.Stride; + config.output.u.RGBA.size = (UIntPtr)(height * bmpData.Stride); + config.output.height = height; + config.output.width = width; + config.output.is_external_memory = 1; + + // Decode + result = UnsafeNativeMethods.WebPDecode(ptrRawWebP, rawWebP.Length, ref config); + if (result != VP8StatusCode.VP8_STATUS_OK) + throw new Exception("Failed WebPDecode with error " + result); + + UnsafeNativeMethods.WebPFreeDecBuffer(ref config.output); + + return bmp; + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.Thumbnail"); } + finally + { + //Unlock the pixels + if (bmpData != null) + bmp.UnlockBits(bmpData); + + //Free memory + if (pinnedWebP.IsAllocated) + pinnedWebP.Free(); + } + } + #endregion + + #region | Public Encode Functions | + /// Save bitmap to file in WebP format + /// Bitmap with the WebP image + /// The file to write + /// Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + public void Save(Bitmap bmp, string pathFileName, int quality = 75) + { + byte[] rawWebP; + + try + { + //Encode in webP format + rawWebP = EncodeLossy(bmp, quality); + + //Write webP file + File.WriteAllBytes(pathFileName, rawWebP); + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.Save"); } + } + + /// Lossy encoding bitmap to WebP (Simple encoding API) + /// Bitmap with the image + /// Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + /// Compressed data + public byte[] EncodeLossy(Bitmap bmp, int quality = 75) + { + //test bmp + if (bmp.Width == 0 || bmp.Height == 0) + throw new ArgumentException("Bitmap contains no data.", "bmp"); + if (bmp.Width > WEBP_MAX_DIMENSION || bmp.Height > WEBP_MAX_DIMENSION) + throw new NotSupportedException("Bitmap's dimension is too large. Max is " + WEBP_MAX_DIMENSION + "x" + WEBP_MAX_DIMENSION + " pixels."); + if (bmp.PixelFormat != PixelFormat.Format24bppRgb && bmp.PixelFormat != PixelFormat.Format32bppArgb) + throw new NotSupportedException("Only support Format24bppRgb and Format32bppArgb pixelFormat."); + + BitmapData bmpData = null; + IntPtr unmanagedData = IntPtr.Zero; + int size; + + try + { + //Get bmp data + bmpData = bmp.LockBits(new Rectangle(0, 0, bmp.Width, bmp.Height), ImageLockMode.ReadOnly, bmp.PixelFormat); + + //Compress the bmp data + if (bmp.PixelFormat == PixelFormat.Format24bppRgb) + size = UnsafeNativeMethods.WebPEncodeBGR(bmpData.Scan0, bmp.Width, bmp.Height, bmpData.Stride, quality, out unmanagedData); + else + size = UnsafeNativeMethods.WebPEncodeBGRA(bmpData.Scan0, bmp.Width, bmp.Height, bmpData.Stride, quality, out unmanagedData); + if (size == 0) + throw new Exception("Can´t encode WebP"); + + //Copy image compress data to output array + byte[] rawWebP = new byte[size]; + Marshal.Copy(unmanagedData, rawWebP, 0, size); + + return rawWebP; + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.EncodeLossly"); } + finally + { + //Unlock the pixels + if (bmpData != null) + bmp.UnlockBits(bmpData); + + //Free memory + if (unmanagedData != IntPtr.Zero) + UnsafeNativeMethods.WebPFree(unmanagedData); + } + } + + /// Lossy encoding bitmap to WebP (Advanced encoding API) + /// Bitmap with the image + /// Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + /// Between 0 (fastest, lowest compression) and 9 (slower, best compression) + /// + /// Compressed data + public byte[] EncodeLossy(Bitmap bmp, int quality, int speed, bool info = false) + { + //Inicialize config struct + WebPConfig config = new WebPConfig(); + + //Set compresion parameters + if (UnsafeNativeMethods.WebPConfigInit(ref config, WebPPreset.WEBP_PRESET_DEFAULT, 75) == 0) + throw new Exception("Can´t config preset"); + + // Add additional tuning: + config.method = speed; + if (config.method > 6) + config.method = 6; + config.quality = quality; + config.autofilter = 1; + config.pass = speed + 1; + config.segments = 4; + config.partitions = 3; + config.thread_level = 1; + config.alpha_quality = quality; + config.alpha_filtering = 2; + config.use_sharp_yuv = 1; + + if (UnsafeNativeMethods.WebPGetDecoderVersion() > 1082) //Old version don´t suport preprocessing 4 + { + config.preprocessing = 4; + config.use_sharp_yuv = 1; + } + else + config.preprocessing = 3; + + return AdvancedEncode(bmp, config, info); + } + + /// Lossless encoding bitmap to WebP (Simple encoding API) + /// Bitmap with the image + /// Compressed data + public byte[] EncodeLossless(Bitmap bmp) + { + //test bmp + if (bmp.Width == 0 || bmp.Height == 0) + throw new ArgumentException("Bitmap contains no data.", "bmp"); + if (bmp.Width > WEBP_MAX_DIMENSION || bmp.Height > WEBP_MAX_DIMENSION) + throw new NotSupportedException("Bitmap's dimension is too large. Max is " + WEBP_MAX_DIMENSION + "x" + WEBP_MAX_DIMENSION + " pixels."); + if (bmp.PixelFormat != PixelFormat.Format24bppRgb && bmp.PixelFormat != PixelFormat.Format32bppArgb) + throw new NotSupportedException("Only support Format24bppRgb and Format32bppArgb pixelFormat."); + + BitmapData bmpData = null; + IntPtr unmanagedData = IntPtr.Zero; + try + { + //Get bmp data + bmpData = bmp.LockBits(new Rectangle(0, 0, bmp.Width, bmp.Height), ImageLockMode.ReadOnly, bmp.PixelFormat); + + //Compress the bmp data + int size; + if (bmp.PixelFormat == PixelFormat.Format24bppRgb) + size = UnsafeNativeMethods.WebPEncodeLosslessBGR(bmpData.Scan0, bmp.Width, bmp.Height, bmpData.Stride, out unmanagedData); + else + size = UnsafeNativeMethods.WebPEncodeLosslessBGRA(bmpData.Scan0, bmp.Width, bmp.Height, bmpData.Stride, out unmanagedData); + + //Copy image compress data to output array + byte[] rawWebP = new byte[size]; + Marshal.Copy(unmanagedData, rawWebP, 0, size); + + return rawWebP; + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.EncodeLossless (Simple)"); } + finally + { + //Unlock the pixels + if (bmpData != null) + bmp.UnlockBits(bmpData); + + //Free memory + if (unmanagedData != IntPtr.Zero) + UnsafeNativeMethods.WebPFree(unmanagedData); + } + } + + /// Lossless encoding image in bitmap (Advanced encoding API) + /// Bitmap with the image + /// Between 0 (fastest, lowest compression) and 9 (slower, best compression) + /// Compressed data + public byte[] EncodeLossless(Bitmap bmp, int speed) + { + //Inicialize config struct + WebPConfig config = new WebPConfig(); + + //Set compresion parameters + if (UnsafeNativeMethods.WebPConfigInit(ref config, WebPPreset.WEBP_PRESET_DEFAULT, (speed + 1) * 10) == 0) + throw new Exception("Can´t config preset"); + + //Old version of dll not suport info and WebPConfigLosslessPreset + if (UnsafeNativeMethods.WebPGetDecoderVersion() > 1082) + { + if (UnsafeNativeMethods.WebPConfigLosslessPreset(ref config, speed) == 0) + throw new Exception("Can´t config lossless preset"); + } + else + { + config.lossless = 1; + config.method = speed; + if (config.method > 6) + config.method = 6; + config.quality = (speed + 1) * 10; + } + config.pass = speed + 1; + config.thread_level = 1; + config.alpha_filtering = 2; + config.use_sharp_yuv = 1; + config.exact = 0; + + return AdvancedEncode(bmp, config, false); + } + + /// Near lossless encoding image in bitmap + /// Bitmap with the image + /// Between 0 (lower quality, lowest file size) and 100 (highest quality, higher file size) + /// Between 0 (fastest, lowest compression) and 9 (slower, best compression) + /// Compress data + public byte[] EncodeNearLossless(Bitmap bmp, int quality, int speed = 9) + { + //test dll version + if (UnsafeNativeMethods.WebPGetDecoderVersion() <= 1082) + throw new Exception("This dll version not suport EncodeNearLossless"); + + //Inicialize config struct + WebPConfig config = new WebPConfig(); + + //Set compresion parameters + if (UnsafeNativeMethods.WebPConfigInit(ref config, WebPPreset.WEBP_PRESET_DEFAULT, (speed + 1) * 10) == 0) + throw new Exception("Can´t config preset"); + if (UnsafeNativeMethods.WebPConfigLosslessPreset(ref config, speed) == 0) + throw new Exception("Can´t config lossless preset"); + config.pass = speed + 1; + config.near_lossless = quality; + config.thread_level = 1; + config.alpha_filtering = 2; + config.use_sharp_yuv = 1; + config.exact = 0; + + return AdvancedEncode(bmp, config, false); + } + #endregion + + #region | Another Public Functions | + /// Get the libwebp version + /// Version of library + public string GetVersion() + { + try + { + uint v = (uint)UnsafeNativeMethods.WebPGetDecoderVersion(); + var revision = v % 256; + var minor = (v >> 8) % 256; + var major = (v >> 16) % 256; + return major + "." + minor + "." + revision; + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.GetVersion"); } + } + + /// Get info of WEBP data + /// The data of WebP + /// width of image + /// height of image + /// Image has alpha channel + /// Image is a animation + /// Format of image: 0 = undefined (/mixed), 1 = lossy, 2 = lossless + public void GetInfo(byte[] rawWebP, out int width, out int height, out bool has_alpha, out bool has_animation, out string format) + { + VP8StatusCode result; + GCHandle pinnedWebP = GCHandle.Alloc(rawWebP, GCHandleType.Pinned); + + try + { + IntPtr ptrRawWebP = pinnedWebP.AddrOfPinnedObject(); + + WebPBitstreamFeatures features = new WebPBitstreamFeatures(); + result = UnsafeNativeMethods.WebPGetFeatures(ptrRawWebP, rawWebP.Length, ref features); + + if (result != 0) + throw new Exception(result.ToString()); + + width = features.Width; + height = features.Height; + if (features.Has_alpha == 1) has_alpha = true; else has_alpha = false; + if (features.Has_animation == 1) has_animation = true; else has_animation = false; + switch (features.Format) + { + case 1: + format = "lossy"; + break; + case 2: + format = "lossless"; + break; + default: + format = "undefined"; + break; + } + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.GetInfo"); } + finally + { + //Free memory + if (pinnedWebP.IsAllocated) + pinnedWebP.Free(); + } + } + + /// Compute PSNR, SSIM or LSIM distortion metric between two pictures. Warning: this function is rather CPU-intensive. + /// Picture to measure + /// Reference picture + /// 0 = PSNR, 1 = SSIM, 2 = LSIM + /// dB in the Y/U/V/Alpha/All order + public float[] GetPictureDistortion(Bitmap source, Bitmap reference, int metric_type) + { + WebPPicture wpicSource = new WebPPicture(); + WebPPicture wpicReference = new WebPPicture(); + BitmapData sourceBmpData = null; + BitmapData referenceBmpData = null; + float[] result = new float[5]; + GCHandle pinnedResult = GCHandle.Alloc(result, GCHandleType.Pinned); + + try + { + if (source == null) + throw new Exception("Source picture is void"); + if (reference == null) + throw new Exception("Reference picture is void"); + if (metric_type > 2) + throw new Exception("Bad metric_type. Use 0 = PSNR, 1 = SSIM, 2 = LSIM"); + if (source.Width != reference.Width || source.Height != reference.Height) + throw new Exception("Source and Reference pictures have diferent dimensions"); + + // Setup the source picture data, allocating the bitmap, width and height + sourceBmpData = source.LockBits(new Rectangle(0, 0, source.Width, source.Height), ImageLockMode.ReadOnly, source.PixelFormat); + wpicSource = new WebPPicture(); + if (UnsafeNativeMethods.WebPPictureInitInternal(ref wpicSource) != 1) + throw new Exception("Can´t init WebPPictureInit"); + wpicSource.width = (int)source.Width; + wpicSource.height = (int)source.Height; + + //Put the source bitmap componets in wpic + if (sourceBmpData.PixelFormat == PixelFormat.Format32bppArgb) + { + wpicSource.use_argb = 1; + if (UnsafeNativeMethods.WebPPictureImportBGRA(ref wpicSource, sourceBmpData.Scan0, sourceBmpData.Stride) != 1) + throw new Exception("Can´t allocate memory in WebPPictureImportBGR"); + } + else + { + wpicSource.use_argb = 0; + if (UnsafeNativeMethods.WebPPictureImportBGR(ref wpicSource, sourceBmpData.Scan0, sourceBmpData.Stride) != 1) + throw new Exception("Can´t allocate memory in WebPPictureImportBGR"); + } + + // Setup the reference picture data, allocating the bitmap, width and height + referenceBmpData = reference.LockBits(new Rectangle(0, 0, reference.Width, reference.Height), ImageLockMode.ReadOnly, reference.PixelFormat); + wpicReference = new WebPPicture(); + if (UnsafeNativeMethods.WebPPictureInitInternal(ref wpicReference) != 1) + throw new Exception("Can´t init WebPPictureInit"); + wpicReference.width = (int)reference.Width; + wpicReference.height = (int)reference.Height; + wpicReference.use_argb = 1; + + //Put the source bitmap componets in wpic + if (sourceBmpData.PixelFormat == PixelFormat.Format32bppArgb) + { + wpicSource.use_argb = 1; + if (UnsafeNativeMethods.WebPPictureImportBGRA(ref wpicReference, referenceBmpData.Scan0, referenceBmpData.Stride) != 1) + throw new Exception("Can´t allocate memory in WebPPictureImportBGR"); + } + else + { + wpicSource.use_argb = 0; + if (UnsafeNativeMethods.WebPPictureImportBGR(ref wpicReference, referenceBmpData.Scan0, referenceBmpData.Stride) != 1) + throw new Exception("Can´t allocate memory in WebPPictureImportBGR"); + } + + //Measure + IntPtr ptrResult = pinnedResult.AddrOfPinnedObject(); + if (UnsafeNativeMethods.WebPPictureDistortion(ref wpicSource, ref wpicReference, metric_type, ptrResult) != 1) + throw new Exception("Can´t measure."); + return result; + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.GetPictureDistortion"); } + finally + { + //Unlock the pixels + if (sourceBmpData != null) + source.UnlockBits(sourceBmpData); + if (referenceBmpData != null) + reference.UnlockBits(referenceBmpData); + + //Free memory + if (wpicSource.argb != IntPtr.Zero) + UnsafeNativeMethods.WebPPictureFree(ref wpicSource); + if (wpicReference.argb != IntPtr.Zero) + UnsafeNativeMethods.WebPPictureFree(ref wpicReference); + //Free memory + if (pinnedResult.IsAllocated) + pinnedResult.Free(); + } + } + #endregion + + #region | Private Methods | + /// Encoding image using Advanced encoding API + /// Bitmap with the image + /// Config for encode + /// True if need encode info. + /// Compressed data + private byte[] AdvancedEncode(Bitmap bmp, WebPConfig config, bool info) + { + byte[] rawWebP = null; + byte[] dataWebp = null; + WebPPicture wpic = new WebPPicture(); + BitmapData bmpData = null; + WebPAuxStats stats = new WebPAuxStats(); + IntPtr ptrStats = IntPtr.Zero; + GCHandle pinnedArrayHandle = new GCHandle(); + int dataWebpSize; + try + { + //Validate the config + if (UnsafeNativeMethods.WebPValidateConfig(ref config) != 1) + throw new Exception("Bad config parameters"); + + //test bmp + if (bmp.Width == 0 || bmp.Height == 0) + throw new ArgumentException("Bitmap contains no data.", "bmp"); + if (bmp.Width > WEBP_MAX_DIMENSION || bmp.Height > WEBP_MAX_DIMENSION) + throw new NotSupportedException("Bitmap's dimension is too large. Max is " + WEBP_MAX_DIMENSION + "x" + WEBP_MAX_DIMENSION + " pixels."); + if (bmp.PixelFormat != PixelFormat.Format24bppRgb && bmp.PixelFormat != PixelFormat.Format32bppArgb) + throw new NotSupportedException("Only support Format24bppRgb and Format32bppArgb pixelFormat."); + + // Setup the input data, allocating a the bitmap, width and height + bmpData = bmp.LockBits(new Rectangle(0, 0, bmp.Width, bmp.Height), ImageLockMode.ReadOnly, bmp.PixelFormat); + if (UnsafeNativeMethods.WebPPictureInitInternal(ref wpic) != 1) + throw new Exception("Can´t init WebPPictureInit"); + wpic.width = (int)bmp.Width; + wpic.height = (int)bmp.Height; + wpic.use_argb = 1; + + if (bmp.PixelFormat == PixelFormat.Format32bppArgb) + { + //Put the bitmap componets in wpic + int result = UnsafeNativeMethods.WebPPictureImportBGRA(ref wpic, bmpData.Scan0, bmpData.Stride); + if (result != 1) + throw new Exception("Can´t allocate memory in WebPPictureImportBGRA"); + wpic.colorspace = (uint)WEBP_CSP_MODE.MODE_bgrA; + dataWebpSize = bmp.Width * bmp.Height * 32; + dataWebp = new byte[bmp.Width * bmp.Height * 32]; //Memory for WebP output + } + else + { + //Put the bitmap componets in wpic + int result = UnsafeNativeMethods.WebPPictureImportBGR(ref wpic, bmpData.Scan0, bmpData.Stride); + if (result != 1) + throw new Exception("Can´t allocate memory in WebPPictureImportBGR"); + dataWebpSize = bmp.Width * bmp.Height * 24; + + } + + //Set up statistics of compresion + if (info) + { + stats = new WebPAuxStats(); + ptrStats = Marshal.AllocHGlobal(Marshal.SizeOf(stats)); + Marshal.StructureToPtr(stats, ptrStats, false); + wpic.stats = ptrStats; + } + + //Memory for WebP output + + if (dataWebpSize > 2147483591) + dataWebpSize = 2147483591; + dataWebp = new byte[bmp.Width * bmp.Height * 32]; + pinnedArrayHandle = GCHandle.Alloc(dataWebp, GCHandleType.Pinned); + IntPtr initPtr = pinnedArrayHandle.AddrOfPinnedObject(); + wpic.custom_ptr = initPtr; + + // Set up a byte-writing method (write-to-memory, in this case) + UnsafeNativeMethods.OnCallback = new UnsafeNativeMethods.WebPMemoryWrite(MyWriter); + wpic.writer = Marshal.GetFunctionPointerForDelegate(UnsafeNativeMethods.OnCallback); + + //compress the input samples + if (UnsafeNativeMethods.WebPEncode(ref config, ref wpic) != 1) + throw new Exception("Encoding error: " + ((WebPEncodingError)wpic.error_code).ToString()); + + //Remove OnCallback + UnsafeNativeMethods.OnCallback = null; + + //Unlock the pixels + bmp.UnlockBits(bmpData); + bmpData = null; + + //Copy webpData to rawWebP + int size = (int)((long)wpic.custom_ptr - (long)initPtr); + rawWebP = new byte[size]; + Array.Copy(dataWebp, rawWebP, size); + + //Remove compression data + pinnedArrayHandle.Free(); + dataWebp = null; + + //Show statistics + if (info) + { + stats = (WebPAuxStats)Marshal.PtrToStructure(ptrStats, typeof(WebPAuxStats)); + MessageBox.Show("Dimension: " + wpic.width + " x " + wpic.height + " pixels\n" + + "Output: " + stats.coded_size + " bytes\n" + + "PSNR Y: " + stats.PSNRY + " db\n" + + "PSNR u: " + stats.PSNRU + " db\n" + + "PSNR v: " + stats.PSNRV + " db\n" + + "PSNR ALL: " + stats.PSNRALL + " db\n" + + "Block intra4: " + stats.block_count_intra4 + "\n" + + "Block intra16: " + stats.block_count_intra16 + "\n" + + "Block skipped: " + stats.block_count_skipped + "\n" + + "Header size: " + stats.header_bytes + " bytes\n" + + "Mode-partition: " + stats.mode_partition_0 + " bytes\n" + + "Macroblocks 0: " + stats.segment_size_segments0 + " residuals bytes\n" + + "Macroblocks 1: " + stats.segment_size_segments1 + " residuals bytes\n" + + "Macroblocks 2: " + stats.segment_size_segments2 + " residuals bytes\n" + + "Macroblocks 3: " + stats.segment_size_segments3 + " residuals bytes\n" + + "Quantizer 0: " + stats.segment_quant_segments0 + " residuals bytes\n" + + "Quantizer 1: " + stats.segment_quant_segments1 + " residuals bytes\n" + + "Quantizer 2: " + stats.segment_quant_segments2 + " residuals bytes\n" + + "Quantizer 3: " + stats.segment_quant_segments3 + " residuals bytes\n" + + "Filter level 0: " + stats.segment_level_segments0 + " residuals bytes\n" + + "Filter level 1: " + stats.segment_level_segments1 + " residuals bytes\n" + + "Filter level 2: " + stats.segment_level_segments2 + " residuals bytes\n" + + "Filter level 3: " + stats.segment_level_segments3 + " residuals bytes\n", "Compression statistics"); + } + + return rawWebP; + } + catch (Exception ex) { throw new Exception(ex.Message + "\r\nIn WebP.AdvancedEncode"); } + finally + { + //Free temporal compress memory + if (pinnedArrayHandle.IsAllocated) + { + pinnedArrayHandle.Free(); + } + + //Free statistics memory + if (ptrStats != IntPtr.Zero) + { + Marshal.FreeHGlobal(ptrStats); + } + + //Unlock the pixels + if (bmpData != null) + { + bmp.UnlockBits(bmpData); + } + + //Free memory + if (wpic.argb != IntPtr.Zero) + { + UnsafeNativeMethods.WebPPictureFree(ref wpic); + } + } + } + + private int MyWriter([InAttribute()] IntPtr data, UIntPtr data_size, ref WebPPicture picture) + { + UnsafeNativeMethods.CopyMemory(picture.custom_ptr, data, (uint)data_size); + //picture.custom_ptr = IntPtr.Add(picture.custom_ptr, (int)data_size); //Only in .NET > 4.0 + picture.custom_ptr = new IntPtr(picture.custom_ptr.ToInt64() + (int)data_size); + return 1; + } + + private delegate int MyWriterDelegate([InAttribute()] IntPtr data, UIntPtr data_size, ref WebPPicture picture); + #endregion + + #region | Destruction | + /// Free memory + public void Dispose() + { + GC.SuppressFinalize(this); + } + #endregion + } + + #region | Import libwebp functions | + [SuppressUnmanagedCodeSecurityAttribute] + internal sealed partial class UnsafeNativeMethods + { + + [DllImport("kernel32.dll", EntryPoint = "CopyMemory", SetLastError = false)] + public static extern void CopyMemory(IntPtr dest, IntPtr src, uint count); + + private static readonly int WEBP_DECODER_ABI_VERSION = 0x0208; + + /// This function will initialize the configuration according to a predefined set of parameters (referred to by 'preset') and a given quality factor. + /// The WebPConfig struct + /// Type of image + /// Quality of compresion + /// 0 if error + public static int WebPConfigInit(ref WebPConfig config, WebPPreset preset, float quality) + { + switch (IntPtr.Size) + { + case 4: + return WebPConfigInitInternal_x86(ref config, preset, quality, WEBP_DECODER_ABI_VERSION); + case 8: + return WebPConfigInitInternal_x64(ref config, preset, quality, WEBP_DECODER_ABI_VERSION); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPConfigInitInternal")] + private static extern int WebPConfigInitInternal_x86(ref WebPConfig config, WebPPreset preset, float quality, int WEBP_DECODER_ABI_VERSION); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPConfigInitInternal")] + private static extern int WebPConfigInitInternal_x64(ref WebPConfig config, WebPPreset preset, float quality, int WEBP_DECODER_ABI_VERSION); + + /// Get info of WepP image + /// Bytes[] of webp image + /// Size of rawWebP + /// Features of WebP image + /// VP8StatusCode + public static VP8StatusCode WebPGetFeatures(IntPtr rawWebP, int data_size, ref WebPBitstreamFeatures features) + { + switch (IntPtr.Size) + { + case 4: + return WebPGetFeaturesInternal_x86(rawWebP, (UIntPtr)data_size, ref features, WEBP_DECODER_ABI_VERSION); + case 8: + return WebPGetFeaturesInternal_x64(rawWebP, (UIntPtr)data_size, ref features, WEBP_DECODER_ABI_VERSION); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPGetFeaturesInternal")] + private static extern VP8StatusCode WebPGetFeaturesInternal_x86([InAttribute()] IntPtr rawWebP, UIntPtr data_size, ref WebPBitstreamFeatures features, int WEBP_DECODER_ABI_VERSION); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPGetFeaturesInternal")] + private static extern VP8StatusCode WebPGetFeaturesInternal_x64([InAttribute()] IntPtr rawWebP, UIntPtr data_size, ref WebPBitstreamFeatures features, int WEBP_DECODER_ABI_VERSION); + + /// Activate the lossless compression mode with the desired efficiency. + /// The WebPConfig struct + /// between 0 (fastest, lowest compression) and 9 (slower, best compression) + /// 0 in case of parameter errorr + public static int WebPConfigLosslessPreset(ref WebPConfig config, int level) + { + switch (IntPtr.Size) + { + case 4: + return WebPConfigLosslessPreset_x86(ref config, level); + case 8: + return WebPConfigLosslessPreset_x64(ref config, level); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPConfigLosslessPreset")] + private static extern int WebPConfigLosslessPreset_x86(ref WebPConfig config, int level); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPConfigLosslessPreset")] + private static extern int WebPConfigLosslessPreset_x64(ref WebPConfig config, int level); + + /// Check that 'config' is non-NULL and all configuration parameters are within their valid ranges. + /// The WebPConfig struct + /// 1 if config are OK + public static int WebPValidateConfig(ref WebPConfig config) + { + switch (IntPtr.Size) + { + case 4: + return WebPValidateConfig_x86(ref config); + case 8: + return WebPValidateConfig_x64(ref config); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPValidateConfig")] + private static extern int WebPValidateConfig_x86(ref WebPConfig config); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPValidateConfig")] + private static extern int WebPValidateConfig_x64(ref WebPConfig config); + + /// Init the struct WebPPicture ckecking the dll version + /// The WebPPicture struct + /// 1 if not error + public static int WebPPictureInitInternal(ref WebPPicture wpic) + { + switch (IntPtr.Size) + { + case 4: + return WebPPictureInitInternal_x86(ref wpic, WEBP_DECODER_ABI_VERSION); + case 8: + return WebPPictureInitInternal_x64(ref wpic, WEBP_DECODER_ABI_VERSION); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureInitInternal")] + private static extern int WebPPictureInitInternal_x86(ref WebPPicture wpic, int WEBP_DECODER_ABI_VERSION); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureInitInternal")] + private static extern int WebPPictureInitInternal_x64(ref WebPPicture wpic, int WEBP_DECODER_ABI_VERSION); + + /// Colorspace conversion function to import RGB samples. + /// The WebPPicture struct + /// Point to BGR data + /// stride of BGR data + /// Returns 0 in case of memory error. + public static int WebPPictureImportBGR(ref WebPPicture wpic, IntPtr bgr, int stride) + { + switch (IntPtr.Size) + { + case 4: + return WebPPictureImportBGR_x86(ref wpic, bgr, stride); + case 8: + return WebPPictureImportBGR_x64(ref wpic, bgr, stride); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureImportBGR")] + private static extern int WebPPictureImportBGR_x86(ref WebPPicture wpic, IntPtr bgr, int stride); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureImportBGR")] + private static extern int WebPPictureImportBGR_x64(ref WebPPicture wpic, IntPtr bgr, int stride); + + /// Colorspace conversion function to import RGB samples. + /// The WebPPicture struct + /// Point to BGRA data + /// stride of BGRA data + /// Returns 0 in case of memory error. + public static int WebPPictureImportBGRA(ref WebPPicture wpic, IntPtr bgra, int stride) + { + switch (IntPtr.Size) + { + case 4: + return WebPPictureImportBGRA_x86(ref wpic, bgra, stride); + case 8: + return WebPPictureImportBGRA_x64(ref wpic, bgra, stride); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureImportBGRA")] + private static extern int WebPPictureImportBGRA_x86(ref WebPPicture wpic, IntPtr bgra, int stride); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureImportBGRA")] + private static extern int WebPPictureImportBGRA_x64(ref WebPPicture wpic, IntPtr bgra, int stride); + + /// Colorspace conversion function to import RGB samples. + /// The WebPPicture struct + /// Point to BGR data + /// stride of BGR data + /// Returns 0 in case of memory error. + public static int WebPPictureImportBGRX(ref WebPPicture wpic, IntPtr bgr, int stride) + { + switch (IntPtr.Size) + { + case 4: + return WebPPictureImportBGRX_x86(ref wpic, bgr, stride); + case 8: + return WebPPictureImportBGRX_x64(ref wpic, bgr, stride); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureImportBGRX")] + private static extern int WebPPictureImportBGRX_x86(ref WebPPicture wpic, IntPtr bgr, int stride); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureImportBGRX")] + private static extern int WebPPictureImportBGRX_x64(ref WebPPicture wpic, IntPtr bgr, int stride); + + /// The writer type for output compress data + /// Data returned + /// Size of data returned + /// Picture struct + /// + [UnmanagedFunctionPointer(CallingConvention.Cdecl)] + public delegate int WebPMemoryWrite([In()] IntPtr data, UIntPtr data_size, ref WebPPicture wpic); + public static WebPMemoryWrite OnCallback; + + /// Compress to webp format + /// The config struct for compresion parameters + /// 'picture' hold the source samples in both YUV(A) or ARGB input + /// Returns 0 in case of error, 1 otherwise. In case of error, picture->error_code is updated accordingly. + public static int WebPEncode(ref WebPConfig config, ref WebPPicture picture) + { + switch (IntPtr.Size) + { + case 4: + return WebPEncode_x86(ref config, ref picture); + case 8: + return WebPEncode_x64(ref config, ref picture); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncode")] + private static extern int WebPEncode_x86(ref WebPConfig config, ref WebPPicture picture); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncode")] + private static extern int WebPEncode_x64(ref WebPConfig config, ref WebPPicture picture); + + /// Release the memory allocated by WebPPictureAlloc() or WebPPictureImport*() + /// Note that this function does _not_ free the memory used by the 'picture' object itself. + /// Besides memory (which is reclaimed) all other fields of 'picture' are preserved. + /// Picture struct + public static void WebPPictureFree(ref WebPPicture picture) + { + switch (IntPtr.Size) + { + case 4: + WebPPictureFree_x86(ref picture); + break; + case 8: + WebPPictureFree_x64(ref picture); + break; + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureFree")] + private static extern void WebPPictureFree_x86(ref WebPPicture wpic); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureFree")] + private static extern void WebPPictureFree_x64(ref WebPPicture wpic); + + /// Validate the WebP image header and retrieve the image height and width. Pointers *width and *height can be passed NULL if deemed irrelevant + /// Pointer to WebP image data + /// This is the size of the memory block pointed to by data containing the image data + /// The range is limited currently from 1 to 16383 + /// The range is limited currently from 1 to 16383 + /// 1 if success, otherwise error code returned in the case of (a) formatting error(s). + public static int WebPGetInfo(IntPtr data, int data_size, out int width, out int height) + { + switch (IntPtr.Size) + { + case 4: + return WebPGetInfo_x86(data, (UIntPtr)data_size, out width, out height); + case 8: + return WebPGetInfo_x64(data, (UIntPtr)data_size, out width, out height); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPGetInfo")] + private static extern int WebPGetInfo_x86([InAttribute()] IntPtr data, UIntPtr data_size, out int width, out int height); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPGetInfo")] + private static extern int WebPGetInfo_x64([InAttribute()] IntPtr data, UIntPtr data_size, out int width, out int height); + + /// Decode WEBP image pointed to by *data and returns BGR samples into a pre-allocated buffer + /// Pointer to WebP image data + /// This is the size of the memory block pointed to by data containing the image data + /// Pointer to decoded WebP image + /// Size of allocated buffer + /// Specifies the distance between scanlines + /// output_buffer if function succeeds; NULL otherwise + public static int WebPDecodeBGRInto(IntPtr data, int data_size, IntPtr output_buffer, int output_buffer_size, int output_stride) + { + switch (IntPtr.Size) + { + case 4: + return WebPDecodeBGRInto_x86(data, (UIntPtr)data_size, output_buffer, output_buffer_size, output_stride); + case 8: + return WebPDecodeBGRInto_x64(data, (UIntPtr)data_size, output_buffer, output_buffer_size, output_stride); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPDecodeBGRInto")] + private static extern int WebPDecodeBGRInto_x86([InAttribute()] IntPtr data, UIntPtr data_size, IntPtr output_buffer, int output_buffer_size, int output_stride); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPDecodeBGRInto")] + private static extern int WebPDecodeBGRInto_x64([InAttribute()] IntPtr data, UIntPtr data_size, IntPtr output_buffer, int output_buffer_size, int output_stride); + + /// Decode WEBP image pointed to by *data and returns BGR samples into a pre-allocated buffer + /// Pointer to WebP image data + /// This is the size of the memory block pointed to by data containing the image data + /// Pointer to decoded WebP image + /// Size of allocated buffer + /// Specifies the distance between scanlines + /// output_buffer if function succeeds; NULL otherwise + public static int WebPDecodeBGRAInto(IntPtr data, int data_size, IntPtr output_buffer, int output_buffer_size, int output_stride) + { + switch (IntPtr.Size) + { + case 4: + return WebPDecodeBGRAInto_x86(data, (UIntPtr)data_size, output_buffer, output_buffer_size, output_stride); + case 8: + return WebPDecodeBGRAInto_x64(data, (UIntPtr)data_size, output_buffer, output_buffer_size, output_stride); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPDecodeBGRAInto")] + private static extern int WebPDecodeBGRAInto_x86([InAttribute()] IntPtr data, UIntPtr data_size, IntPtr output_buffer, int output_buffer_size, int output_stride); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPDecodeBGRAInto")] + private static extern int WebPDecodeBGRAInto_x64([InAttribute()] IntPtr data, UIntPtr data_size, IntPtr output_buffer, int output_buffer_size, int output_stride); + + /// Initialize the configuration as empty. This function must always be called first, unless WebPGetFeatures() is to be called. + /// Configuration struct + /// False in case of mismatched version. + public static int WebPInitDecoderConfig(ref WebPDecoderConfig webPDecoderConfig) + { + switch (IntPtr.Size) + { + case 4: + return WebPInitDecoderConfigInternal_x86(ref webPDecoderConfig, WEBP_DECODER_ABI_VERSION); + case 8: + return WebPInitDecoderConfigInternal_x64(ref webPDecoderConfig, WEBP_DECODER_ABI_VERSION); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPInitDecoderConfigInternal")] + private static extern int WebPInitDecoderConfigInternal_x86(ref WebPDecoderConfig webPDecoderConfig, int WEBP_DECODER_ABI_VERSION); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPInitDecoderConfigInternal")] + private static extern int WebPInitDecoderConfigInternal_x64(ref WebPDecoderConfig webPDecoderConfig, int WEBP_DECODER_ABI_VERSION); + + /// Decodes the full data at once, taking 'config' into account. + /// WebP raw data to decode + /// Size of WebP data + /// Configuration struct + /// VP8_STATUS_OK if the decoding was successful + public static VP8StatusCode WebPDecode(IntPtr data, int data_size, ref WebPDecoderConfig webPDecoderConfig) + { + switch (IntPtr.Size) + { + case 4: + return WebPDecode_x86(data, (UIntPtr)data_size, ref webPDecoderConfig); + case 8: + return WebPDecode_x64(data, (UIntPtr)data_size, ref webPDecoderConfig); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPDecode")] + private static extern VP8StatusCode WebPDecode_x86(IntPtr data, UIntPtr data_size, ref WebPDecoderConfig config); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPDecode")] + private static extern VP8StatusCode WebPDecode_x64(IntPtr data, UIntPtr data_size, ref WebPDecoderConfig config); + + /// Free any memory associated with the buffer. Must always be called last. Doesn't free the 'buffer' structure itself. + /// WebPDecBuffer + public static void WebPFreeDecBuffer(ref WebPDecBuffer buffer) + { + switch (IntPtr.Size) + { + case 4: + WebPFreeDecBuffer_x86(ref buffer); + break; + case 8: + WebPFreeDecBuffer_x64(ref buffer); + break; + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPFreeDecBuffer")] + private static extern void WebPFreeDecBuffer_x86(ref WebPDecBuffer buffer); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPFreeDecBuffer")] + private static extern void WebPFreeDecBuffer_x64(ref WebPDecBuffer buffer); + + /// Lossy encoding images + /// Pointer to BGR image data + /// The range is limited currently from 1 to 16383 + /// The range is limited currently from 1 to 16383 + /// Specifies the distance between scanlines + /// Ranges from 0 (lower quality) to 100 (highest quality). Controls the loss and quality during compression + /// output_buffer with WebP image + /// Size of WebP Image or 0 if an error occurred + public static int WebPEncodeBGR(IntPtr bgr, int width, int height, int stride, float quality_factor, out IntPtr output) + { + switch (IntPtr.Size) + { + case 4: + return WebPEncodeBGR_x86(bgr, width, height, stride, quality_factor, out output); + case 8: + return WebPEncodeBGR_x64(bgr, width, height, stride, quality_factor, out output); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncodeBGR")] + private static extern int WebPEncodeBGR_x86([InAttribute()] IntPtr bgr, int width, int height, int stride, float quality_factor, out IntPtr output); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncodeBGR")] + private static extern int WebPEncodeBGR_x64([InAttribute()] IntPtr bgr, int width, int height, int stride, float quality_factor, out IntPtr output); + + /// Lossy encoding images + /// Pointer to BGRA image data + /// The range is limited currently from 1 to 16383 + /// The range is limited currently from 1 to 16383 + /// Specifies the distance between scanlines + /// Ranges from 0 (lower quality) to 100 (highest quality). Controls the loss and quality during compression + /// output_buffer with WebP image + /// Size of WebP Image or 0 if an error occurred + public static int WebPEncodeBGRA(IntPtr bgra, int width, int height, int stride, float quality_factor, out IntPtr output) + { + switch (IntPtr.Size) + { + case 4: + return WebPEncodeBGRA_x86(bgra, width, height, stride, quality_factor, out output); + case 8: + return WebPEncodeBGRA_x64(bgra, width, height, stride, quality_factor, out output); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncodeBGRA")] + private static extern int WebPEncodeBGRA_x86([InAttribute()] IntPtr bgra, int width, int height, int stride, float quality_factor, out IntPtr output); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncodeBGRA")] + private static extern int WebPEncodeBGRA_x64([InAttribute()] IntPtr bgra, int width, int height, int stride, float quality_factor, out IntPtr output); + + /// Lossless encoding images pointed to by *data in WebP format + /// Pointer to BGR image data + /// The range is limited currently from 1 to 16383 + /// The range is limited currently from 1 to 16383 + /// Specifies the distance between scanlines + /// output_buffer with WebP image + /// Size of WebP Image or 0 if an error occurred + public static int WebPEncodeLosslessBGR(IntPtr bgr, int width, int height, int stride, out IntPtr output) + { + switch (IntPtr.Size) + { + case 4: + return WebPEncodeLosslessBGR_x86(bgr, width, height, stride, out output); + case 8: + return WebPEncodeLosslessBGR_x64(bgr, width, height, stride, out output); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncodeLosslessBGR")] + private static extern int WebPEncodeLosslessBGR_x86([InAttribute()] IntPtr bgr, int width, int height, int stride, out IntPtr output); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncodeLosslessBGR")] + private static extern int WebPEncodeLosslessBGR_x64([InAttribute()] IntPtr bgr, int width, int height, int stride, out IntPtr output); + + /// Lossless encoding images pointed to by *data in WebP format + /// Pointer to BGR image data + /// The range is limited currently from 1 to 16383 + /// The range is limited currently from 1 to 16383 + /// Specifies the distance between scanlines + /// output_buffer with WebP image + /// Size of WebP Image or 0 if an error occurred + public static int WebPEncodeLosslessBGRA(IntPtr bgra, int width, int height, int stride, out IntPtr output) + { + switch (IntPtr.Size) + { + case 4: + return WebPEncodeLosslessBGRA_x86(bgra, width, height, stride, out output); + case 8: + return WebPEncodeLosslessBGRA_x64(bgra, width, height, stride, out output); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncodeLosslessBGRA")] + private static extern int WebPEncodeLosslessBGRA_x86([InAttribute()] IntPtr bgra, int width, int height, int stride, out IntPtr output); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPEncodeLosslessBGRA")] + private static extern int WebPEncodeLosslessBGRA_x64([InAttribute()] IntPtr bgra, int width, int height, int stride, out IntPtr output); + + /// Releases memory returned by the WebPEncode + /// Pointer to memory + public static void WebPFree(IntPtr p) + { + switch (IntPtr.Size) + { + case 4: + WebPFree_x86(p); + break; + case 8: + WebPFree_x64(p); + break; + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPFree")] + private static extern void WebPFree_x86(IntPtr p); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPFree")] + private static extern void WebPFree_x64(IntPtr p); + + /// Get the webp version library + /// 8bits for each of major/minor/revision packet in integer. E.g: v2.5.7 is 0x020507 + public static int WebPGetDecoderVersion() + { + switch (IntPtr.Size) + { + case 4: + return WebPGetDecoderVersion_x86(); + case 8: + return WebPGetDecoderVersion_x64(); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPGetDecoderVersion")] + private static extern int WebPGetDecoderVersion_x86(); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPGetDecoderVersion")] + private static extern int WebPGetDecoderVersion_x64(); + + /// Compute PSNR, SSIM or LSIM distortion metric between two pictures. + /// Picture to measure + /// Reference picture + /// 0 = PSNR, 1 = SSIM, 2 = LSIM + /// dB in the Y/U/V/Alpha/All order + /// False in case of error (src and ref don't have same dimension, ...) + public static int WebPPictureDistortion(ref WebPPicture srcPicture, ref WebPPicture refPicture, int metric_type, IntPtr pResult) + { + switch (IntPtr.Size) + { + case 4: + return WebPPictureDistortion_x86(ref srcPicture, ref refPicture, metric_type, pResult); + case 8: + return WebPPictureDistortion_x64(ref srcPicture, ref refPicture, metric_type, pResult); + default: + throw new InvalidOperationException("Invalid platform. Can not find proper function"); + } + } + [DllImport("libwebp_x86.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureDistortion")] + private static extern int WebPPictureDistortion_x86(ref WebPPicture srcPicture, ref WebPPicture refPicture, int metric_type, IntPtr pResult); + [DllImport("libwebp_x64.dll", CallingConvention = CallingConvention.Cdecl, EntryPoint = "WebPPictureDistortion")] + private static extern int WebPPictureDistortion_x64(ref WebPPicture srcPicture, ref WebPPicture refPicture, int metric_type, IntPtr pResult); + } + #endregion + + #region | Predefined | + /// Enumerate some predefined settings for WebPConfig, depending on the type of source picture. These presets are used when calling WebPConfigPreset(). + public enum WebPPreset + { + /// Default preset. + WEBP_PRESET_DEFAULT = 0, + /// Digital picture, like portrait, inner shot. + WEBP_PRESET_PICTURE, + /// Outdoor photograph, with natural lighting. + WEBP_PRESET_PHOTO, + /// Hand or line drawing, with high-contrast details. + WEBP_PRESET_DRAWING, + /// Small-sized colorful images. + WEBP_PRESET_ICON, + /// Text-like. + WEBP_PRESET_TEXT + }; + + /// Encoding error conditions. + public enum WebPEncodingError + { + /// No error. + VP8_ENC_OK = 0, + /// Memory error allocating objects. + VP8_ENC_ERROR_OUT_OF_MEMORY, + /// Memory error while flushing bits. + VP8_ENC_ERROR_BITSTREAM_OUT_OF_MEMORY, + /// A pointer parameter is NULL. + VP8_ENC_ERROR_NULL_PARAMETER, + /// Configuration is invalid. + VP8_ENC_ERROR_INVALID_CONFIGURATION, + /// Picture has invalid width/height. + VP8_ENC_ERROR_BAD_DIMENSION, + /// Partition is bigger than 512k. + VP8_ENC_ERROR_PARTITION0_OVERFLOW, + /// Partition is bigger than 16M. + VP8_ENC_ERROR_PARTITION_OVERFLOW, + /// Error while flushing bytes. + VP8_ENC_ERROR_BAD_WRITE, + /// File is bigger than 4G. + VP8_ENC_ERROR_FILE_TOO_BIG, + /// Abort request by user. + VP8_ENC_ERROR_USER_ABORT, + /// List terminator. always last. + VP8_ENC_ERROR_LAST, + } + + /// Enumeration of the status codes. + public enum VP8StatusCode + { + /// No error. + VP8_STATUS_OK = 0, + /// Memory error allocating objects. + VP8_STATUS_OUT_OF_MEMORY, + /// Configuration is invalid. + VP8_STATUS_INVALID_PARAM, + /// + /// + /// + VP8_STATUS_BITSTREAM_ERROR, + /// Configuration is invalid. + VP8_STATUS_UNSUPPORTED_FEATURE, + /// + /// + /// + VP8_STATUS_SUSPENDED, + /// Abort request by user. + VP8_STATUS_USER_ABORT, + /// + /// + /// + VP8_STATUS_NOT_ENOUGH_DATA, + } + + /// Image characteristics hint for the underlying encoder. + public enum WebPImageHint + { + /// Default preset. + WEBP_HINT_DEFAULT = 0, + /// Digital picture, like portrait, inner shot + WEBP_HINT_PICTURE, + /// Outdoor photograph, with natural lighting + WEBP_HINT_PHOTO, + /// Discrete tone image (graph, map-tile etc). + WEBP_HINT_GRAPH, + /// list terminator. always last. + WEBP_HINT_LAST + }; + + /// Describes the byte-ordering of packed samples in memory. + public enum WEBP_CSP_MODE + { + /// Byte-order: R,G,B,R,G,B,... + MODE_RGB = 0, + /// Byte-order: R,G,B,A,R,G,B,A,... + MODE_RGBA = 1, + /// Byte-order: B,G,R,B,G,R,... + MODE_BGR = 2, + /// Byte-order: B,G,R,A,B,G,R,A,... + MODE_BGRA = 3, + /// Byte-order: A,R,G,B,A,R,G,B,... + MODE_ARGB = 4, + /// Byte-order: RGB-565: [a4 a3 a2 a1 a0 r5 r4 r3], [r2 r1 r0 g4 g3 g2 g1 g0], ... + /// WEBP_SWAP_16BITS_CSP is defined, + /// Byte-order: RGB-565: [a4 a3 a2 a1 a0 b5 b4 b3], [b2 b1 b0 g4 g3 g2 g1 g0], ... + MODE_RGBA_4444 = 5, + /// Byte-order: RGB-565: [r4 r3 r2 r1 r0 g5 g4 g3], [g2 g1 g0 b4 b3 b2 b1 b0], ... + /// WEBP_SWAP_16BITS_CSP is defined, + /// Byte-order: [b3 b2 b1 b0 a3 a2 a1 a0], [r3 r2 r1 r0 g3 g2 g1 g0], ... + MODE_RGB_565 = 6, + /// RGB-premultiplied transparent modes (alpha value is preserved) + MODE_rgbA = 7, + /// RGB-premultiplied transparent modes (alpha value is preserved) + MODE_bgrA = 8, + /// RGB-premultiplied transparent modes (alpha value is preserved) + MODE_Argb = 9, + /// RGB-premultiplied transparent modes (alpha value is preserved) + MODE_rgbA_4444 = 10, + /// yuv 4:2:0 + MODE_YUV = 11, + /// yuv 4:2:0 + MODE_YUVA = 12, + /// MODE_LAST -> 13 + MODE_LAST = 13, + } + + /// + /// Decoding states. State normally flows as: + /// WEBP_HEADER->VP8_HEADER->VP8_PARTS0->VP8_DATA->DONE for a lossy image, and + /// WEBP_HEADER->VP8L_HEADER->VP8L_DATA->DONE for a lossless image. + /// If there is any error the decoder goes into state ERROR. + /// + enum DecState + { + STATE_WEBP_HEADER, // All the data before that of the VP8/VP8L chunk. + STATE_VP8_HEADER, // The VP8 Frame header (within the VP8 chunk). + STATE_VP8_PARTS0, + STATE_VP8_DATA, + STATE_VP8L_HEADER, + STATE_VP8L_DATA, + STATE_DONE, + STATE_ERROR + }; + #endregion + + #region | libwebp structs | + /// Features gathered from the bitstream + [StructLayoutAttribute(LayoutKind.Sequential)] + public struct WebPBitstreamFeatures + { + /// Width in pixels, as read from the bitstream. + public int Width; + /// Height in pixels, as read from the bitstream. + public int Height; + /// True if the bitstream contains an alpha channel. + public int Has_alpha; + /// True if the bitstream is an animation. + public int Has_animation; + /// 0 = undefined (/mixed), 1 = lossy, 2 = lossless + public int Format; + /// Padding for later use. + [MarshalAsAttribute(UnmanagedType.ByValArray, SizeConst = 5, ArraySubType = UnmanagedType.U4)] + private readonly uint[] pad; + }; + + /// Compression parameters. + [StructLayoutAttribute(LayoutKind.Sequential)] + public struct WebPConfig + { + /// Lossless encoding (0=lossy(default), 1=lossless). + public int lossless; + /// Between 0 (smallest file) and 100 (biggest) + public float quality; + /// Quality/speed trade-off (0=fast, 6=slower-better) + public int method; + /// Hint for image type (lossless only for now). + public WebPImageHint image_hint; + /// If non-zero, set the desired target size in bytes. Takes precedence over the 'compression' parameter. + public int target_size; + /// If non-zero, specifies the minimal distortion to try to achieve. Takes precedence over target_size. + public float target_PSNR; + /// Maximum number of segments to use, in [1..4] + public int segments; + /// Spatial Noise Shaping. 0=off, 100=maximum. + public int sns_strength; + /// Range: [0 = off .. 100 = strongest] + public int filter_strength; + /// Range: [0 = off .. 7 = least sharp] + public int filter_sharpness; + /// Filtering type: 0 = simple, 1 = strong (only used if filter_strength > 0 or autofilter > 0) + public int filter_type; + /// Auto adjust filter's strength [0 = off, 1 = on] + public int autofilter; + /// Algorithm for encoding the alpha plane (0 = none, 1 = compressed with WebP lossless). Default is 1. + public int alpha_compression; + /// Predictive filtering method for alpha plane. 0: none, 1: fast, 2: best. Default if 1. + public int alpha_filtering; + /// Between 0 (smallest size) and 100 (lossless). Default is 100. + public int alpha_quality; + /// Number of entropy-analysis passes (in [1..10]). + public int pass; + /// If true, export the compressed picture back. In-loop filtering is not applied. + public int show_compressed; + /// Preprocessing filter (0=none, 1=segment-smooth, 2=pseudo-random dithering) + public int preprocessing; + /// Log2(number of token partitions) in [0..3] Default is set to 0 for easier progressive decoding. + public int partitions; + /// Quality degradation allowed to fit the 512k limit on prediction modes coding (0: no degradation, 100: maximum possible degradation). + public int partition_limit; + /// If true, compression parameters will be remapped to better match the expected output size from JPEG compression. Generally, the output size will be similar but the degradation will be lower. + public int emulate_jpeg_size; + /// If non-zero, try and use multi-threaded encoding. + public int thread_level; + /// If set, reduce memory usage (but increase CPU use). + public int low_memory; + /// Near lossless encoding [0 = max loss .. 100 = off (default)]. + public int near_lossless; + /// If non-zero, preserve the exact RGB values under transparent area. Otherwise, discard this invisible RGB information for better compression. The default value is 0. + public int exact; + /// Reserved for future lossless feature + public int delta_palettization; + /// if needed, use sharp (and slow) RGB->YUV conversion + public int use_sharp_yuv; + /// Padding for later use. + private readonly int pad1; + private readonly int pad2; + }; + + /// Main exchange structure (input samples, output bytes, statistics) + [StructLayoutAttribute(LayoutKind.Sequential)] + public struct WebPPicture : IDisposable + { + /// Main flag for encoder selecting between ARGB or YUV input. Recommended to use ARGB input (*argb, argb_stride) for lossless, and YUV input (*y, *u, *v, etc.) for lossy + public int use_argb; + /// colorspace: should be YUV420 for now (=Y'CbCr). Value = 0 + public UInt32 colorspace; + /// Width of picture (less or equal to WEBP_MAX_DIMENSION) + public int width; + /// Height of picture (less or equal to WEBP_MAX_DIMENSION) + public int height; + /// Pointer to luma plane. + public IntPtr y; + /// Pointer to chroma U plane. + public IntPtr u; + /// Pointer to chroma V plane. + public IntPtr v; + /// Luma stride. + public int y_stride; + /// Chroma stride. + public int uv_stride; + /// Pointer to the alpha plane + public IntPtr a; + /// stride of the alpha plane + public int a_stride; + /// Padding for later use. + [MarshalAsAttribute(UnmanagedType.ByValArray, SizeConst = 2, ArraySubType = UnmanagedType.U4)] + private readonly uint[] pad1; + /// Pointer to argb (32 bit) plane. + public IntPtr argb; + /// This is stride in pixels units, not bytes. + public int argb_stride; + /// Padding for later use. + [MarshalAsAttribute(UnmanagedType.ByValArray, SizeConst = 3, ArraySubType = UnmanagedType.U4)] + private readonly uint[] pad2; + /// Byte-emission hook, to store compressed bytes as they are ready. + public IntPtr writer; + /// Can be used by the writer. + public IntPtr custom_ptr; + // map for extra information (only for lossy compression mode) + /// 1: intra type, 2: segment, 3: quant, 4: intra-16 prediction mode, 5: chroma prediction mode, 6: bit cost, 7: distortion + public int extra_info_type; + /// if not NULL, points to an array of size ((width + 15) / 16) * ((height + 15) / 16) that will be filled with a macroblock map, depending on extra_info_type. + public IntPtr extra_info; + /// Pointer to side statistics (updated only if not NULL) + public IntPtr stats; + /// Error code for the latest error encountered during encoding + public UInt32 error_code; + /// If not NULL, report progress during encoding. + public IntPtr progress_hook; + /// this field is free to be set to any value and used during callbacks (like progress-report e.g.). + public IntPtr user_data; + /// Padding for later use. + [MarshalAsAttribute(UnmanagedType.ByValArray, SizeConst = 13, ArraySubType = UnmanagedType.U4)] + private readonly uint[] pad3; + /// Row chunk of memory for yuva planes + private readonly IntPtr memory_; + /// row chunk of memory for argb planes + private readonly IntPtr memory_argb_; + /// Padding for later use. + [MarshalAsAttribute(UnmanagedType.ByValArray, SizeConst = 2, ArraySubType = UnmanagedType.U4)] + private readonly uint[] pad4; + /// + /// + /// + /// + public void Dispose() + { + throw new NotImplementedException(); + } + }; + + /// Structure for storing auxiliary statistics (mostly for lossy encoding). + [StructLayoutAttribute(LayoutKind.Sequential)] + public struct WebPAuxStats + { + /// Final size + public int coded_size; + /// Peak-signal-to-noise ratio for Y + public float PSNRY; + /// Peak-signal-to-noise ratio for U + public float PSNRU; + /// Peak-signal-to-noise ratio for V + public float PSNRV; + /// Peak-signal-to-noise ratio for All + public float PSNRALL; + /// Peak-signal-to-noise ratio for Alpha + public float PSNRAlpha; + /// Number of intra4 + public int block_count_intra4; + /// Number of intra16 + public int block_count_intra16; + /// Number of skipped macroblocks + public int block_count_skipped; + /// Approximate number of bytes spent for header + public int header_bytes; + /// Approximate number of bytes spent for mode-partition #0 + public int mode_partition_0; + /// Approximate number of bytes spent for DC coefficients for segment 0. + public int residual_bytes_DC_segments0; + /// Approximate number of bytes spent for AC coefficients for segment 0. + public int residual_bytes_AC_segments0; + /// Approximate number of bytes spent for uv coefficients for segment 0. + public int residual_bytes_uv_segments0; + /// Approximate number of bytes spent for DC coefficients for segment 1. + public int residual_bytes_DC_segments1; + /// Approximate number of bytes spent for AC coefficients for segment 1. + public int residual_bytes_AC_segments1; + /// Approximate number of bytes spent for uv coefficients for segment 1. + public int residual_bytes_uv_segments1; + /// Approximate number of bytes spent for DC coefficients for segment 2. + public int residual_bytes_DC_segments2; + /// Approximate number of bytes spent for AC coefficients for segment 2. + public int residual_bytes_AC_segments2; + /// Approximate number of bytes spent for uv coefficients for segment 2. + public int residual_bytes_uv_segments2; + /// Approximate number of bytes spent for DC coefficients for segment 3. + public int residual_bytes_DC_segments3; + /// Approximate number of bytes spent for AC coefficients for segment 3. + public int residual_bytes_AC_segments3; + /// Approximate number of bytes spent for uv coefficients for segment 3. + public int residual_bytes_uv_segments3; + /// Number of macroblocks in segments 0 + public int segment_size_segments0; + /// Number of macroblocks in segments 1 + public int segment_size_segments1; + /// Number of macroblocks in segments 2 + public int segment_size_segments2; + /// Number of macroblocks in segments 3 + public int segment_size_segments3; + /// Quantizer values for segment 0 + public int segment_quant_segments0; + /// Quantizer values for segment 1 + public int segment_quant_segments1; + /// Quantizer values for segment 2 + public int segment_quant_segments2; + /// Quantizer values for segment 3 + public int segment_quant_segments3; + /// Filtering strength for segment 0 [0..63] + public int segment_level_segments0; + /// Filtering strength for segment 1 [0..63] + public int segment_level_segments1; + /// Filtering strength for segment 2 [0..63] + public int segment_level_segments2; + /// Filtering strength for segment 3 [0..63] + public int segment_level_segments3; + /// Size of the transparency data + public int alpha_data_size; + /// Size of the enhancement layer data + public int layer_data_size; + + // lossless encoder statistics + /// bit0:predictor bit1:cross-color transform bit2:subtract-green bit3:color indexing + public Int32 lossless_features; + /// Number of precision bits of histogram + public int histogram_bits; + /// Precision bits for transform + public int transform_bits; + /// Number of bits for color cache lookup + public int cache_bits; + /// Number of color in palette, if used + public int palette_size; + /// Final lossless size + public int lossless_size; + /// Lossless header (transform, huffman etc) size + public int lossless_hdr_size; + /// Lossless image data size + public int lossless_data_size; + /// Padding for later use. + [MarshalAsAttribute(UnmanagedType.ByValArray, SizeConst = 2, ArraySubType = UnmanagedType.U4)] + private readonly uint[] pad; + }; + /// + /// + /// + [StructLayoutAttribute(LayoutKind.Sequential)] + public struct WebPDecoderConfig + { + /// Immutable bitstream features (optional) + public WebPBitstreamFeatures input; + /// Output buffer (can point to external mem) + public WebPDecBuffer output; + /// Decoding options + public WebPDecoderOptions options; + } + + /// Output buffer + [StructLayoutAttribute(LayoutKind.Sequential)] + public struct WebPDecBuffer + { + /// Colorspace. + public WEBP_CSP_MODE colorspace; + /// Width of image. + public int width; + /// Height of image. + public int height; + /// If non-zero, 'internal_memory' pointer is not used. If value is '2' or more, the external memory is considered 'slow' and multiple read/write will be avoided. + public int is_external_memory; + /// Output buffer parameters. + public RGBA_YUVA_Buffer u; + /// padding for later use. + private readonly UInt32 pad1; + /// padding for later use. + private readonly UInt32 pad2; + /// padding for later use. + private readonly UInt32 pad3; + /// padding for later use. + private readonly UInt32 pad4; + /// Internally allocated memory (only when is_external_memory is 0). Should not be used externally, but accessed via WebPRGBABuffer. + public IntPtr private_memory; + } + + /// Union of buffer parameters + [StructLayoutAttribute(LayoutKind.Explicit)] + public struct RGBA_YUVA_Buffer + { + /// + /// + /// + [FieldOffsetAttribute(0)] + public WebPRGBABuffer RGBA; + /// + /// + /// + [FieldOffsetAttribute(0)] + public WebPYUVABuffer YUVA; + } + /// + /// + /// + [StructLayoutAttribute(LayoutKind.Sequential)] + public struct WebPYUVABuffer + { + /// Pointer to luma samples + public IntPtr y; + /// Pointer to chroma U samples + public IntPtr u; + /// Pointer to chroma V samples + public IntPtr v; + /// Pointer to alpha samples + public IntPtr a; + /// luma stride + public int y_stride; + /// chroma U stride + public int u_stride; + /// chroma V stride + public int v_stride; + /// alpha stride + public int a_stride; + /// luma plane size + public UIntPtr y_size; + /// chroma plane U size + public UIntPtr u_size; + /// chroma plane V size + public UIntPtr v_size; + /// alpha plane size + public UIntPtr a_size; + } + + /// Generic structure for describing the output sample buffer. + [StructLayoutAttribute(LayoutKind.Sequential)] + public struct WebPRGBABuffer + { + /// pointer to RGBA samples. + public IntPtr rgba; + /// stride in bytes from one scanline to the next. + public int stride; + /// total size of the rgba buffer. + public UIntPtr size; + } + + /// Decoding options + [StructLayoutAttribute(LayoutKind.Sequential)] + public struct WebPDecoderOptions + { + /// if true, skip the in-loop filtering. + public int bypass_filtering; + /// if true, use faster pointwise upsampler. + public int no_fancy_upsampling; + /// if true, cropping is applied _first_ + public int use_cropping; + /// left position for cropping. Will be snapped to even values. + public int crop_left; + /// top position for cropping. Will be snapped to even values. + public int crop_top; + /// width of the cropping area + public int crop_width; + /// height of the cropping area + public int crop_height; + /// if true, scaling is applied _afterward_ + public int use_scaling; + /// final width + public int scaled_width; + /// final height + public int scaled_height; + /// if true, use multi-threaded decoding + public int use_threads; + /// dithering strength (0=Off, 100=full) + public int dithering_strength; + /// flip output vertically + public int flip; + /// alpha dithering strength in [0..100] + public int alpha_dithering_strength; + /// padding for later use. + private readonly UInt32 pad1; + /// padding for later use. + private readonly UInt32 pad2; + /// padding for later use. + private readonly UInt32 pad3; + /// padding for later use. + private readonly UInt32 pad4; + /// padding for later use. + private readonly UInt32 pad5; + }; + #endregion +} \ No newline at end of file diff --git a/Source/RaUI/Common/FileFuns/sType.cs b/Source/RaUI/Common/FileFuns/sType.cs new file mode 100644 index 0000000..e020e7b --- /dev/null +++ b/Source/RaUI/Common/FileFuns/sType.cs @@ -0,0 +1,103 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Text; + +namespace ryCommon.sType +{ + /// + /// 文件时间 + /// + public class FileTime + { + /// + /// 创建时间 + /// + public DateTime CreateTime { get; set; } = new DateTime(1970, 1, 1); + /// + /// 最后修改时间 + /// + public DateTime LastWriteTime { get; set; } = new DateTime(1970, 1, 1); + /// + /// 访问时间 + /// + public DateTime AccessTime { get; set; } = new DateTime(1970, 1, 1); + } + /// + /// + /// + public enum FileExtension + { + /// + /// + /// + JPG = 255216, + /// + /// + /// + GIF = 7173, + /// + /// + /// + PNG = 13780, + /// + /// + /// + SWF = 6787, + /// + /// + /// + RAR = 8297, + /// + /// + /// + ZIP = 8075, + /// + /// + /// + _7Z = 55122, + /// + /// + /// + WebP = 8273, + /// + /// + /// + BMP = 6677, + /// + /// + /// + VALIDFILE = 9999999 + // 255216 jpg; + + // 7173 gif; + + // 6677 bmp, + + // 13780 png; + + // 6787 swf + + // 7790 exe dll, + + // 8297 rar + + // 8075 zip + + // 55122 7z + + // 6063 xml + + // 6033 html + + // 239187 aspx + + // 117115 cs + + // 119105 js + + // 102100 txt + + // 255254 sql + } +} diff --git a/Source/RaUI/Common/HardWare/HardWare.cs b/Source/RaUI/Common/HardWare/HardWare.cs new file mode 100644 index 0000000..085e56f --- /dev/null +++ b/Source/RaUI/Common/HardWare/HardWare.cs @@ -0,0 +1,401 @@ +using ryCommon; +using System; +using System.Collections.Generic; +using System.Linq; +using System.Management; +using System.Text; +using System.Windows.Forms; + +namespace RyHardWare +{ + /// + /// + /// + public class HardWare + { + /// + /// 获取WMI内容 + /// + /// + /// + public string GetWMI(string sql) + { + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher(sql); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + //注意 + //Properties["Manufacturer"].Value 可能为Null，意味着没有厂商信息 + var result = ""; + while (moe.MoveNext()) + { + foreach (var item in moe.Current.Properties) + { + if (item.Value != null) + { + if (item.Value is string[]) + { + var list = (string[])item.Value; + for (int i = 0; i < list.Length; i++) + { + result += "\r\n" + item.Name + "=>数组" + i + "=>" + list[i]; + } + } + else + { + result += "\r\n" + item.Name + "=>" + item.Value.ToString(); + } + } + } + result += "\r\n"; + } + return result.Trim(); + } + /// + /// 获取WMI内容 + /// + /// + /// + public string GetWMIByName(string name) + { + return GetWMI("select * from " + name); + } + /// + /// 获取内存信息 + /// + /// + public static string GetMemoryInfo() + { + var result = ""; + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher("select * from Win32_PhysicalMemory"); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + long total_size = 0; + var index = 0; + Dictionary dict = new Dictionary(); + while (moe.MoveNext()) + { + index++; + var item = moe.Current.Properties; + long Capacity = item["Capacity"].Value.ToInt64() / 1024 / 1024 / 1024; + total_size += Capacity; + var Manufacturer = ObjToStr(item["Manufacturer"].Value); + var Speed = item["Speed"].Value.ToInt(); + var ddr = ObjToStr(item["PartNumber"].Value); + if (ddr.IndexOfEx("DDR3") >= 0) { ddr = "DDR3"; } + else if (ddr.IndexOfEx("DDR4") >= 0) { ddr = "DDR4"; } + else if (ddr.IndexOfEx("D4") >= 0) { ddr = "DDR4"; } + else if (ddr.IndexOfEx("D3") >= 0) { ddr = "DDR3"; } + else if (Speed == 266 || Speed == 333 || Speed == 400) + { + ddr = "DDR"; + } + else if (Speed == 533 || Speed == 667 || Speed == 800) + { + ddr = "DDR2"; + } + else if (Speed == 1066 || Speed == 1333 || Speed == 1600) + { + ddr = "DDR3"; + } + else if (Speed == 2400 || Speed == 2133 || Speed == 2666 || Speed == 2667 || Speed == 3200) + { + ddr = "DDR4"; + } + else { ddr = "未知"; } + if (Manufacturer == "Kingston") { Manufacturer = "金士顿"; } + else if (Manufacturer == "A-DATA Technology") { Manufacturer = "威刚"; } + else { Manufacturer = GetManufacturer(Manufacturer); } + var memory = Capacity + "GB " + Manufacturer + " " + ddr + " " + Speed + "MHz"; + if (dict.ContainsKey(memory)) + { + dict[memory]++; + } + else { dict[memory] = 1; } + } + foreach (var item in dict) + { + if (result.Length > 0) { result += "/"; } + if (item.Value >= 2) + { + result += item.Key + "*" + item.Value; + } + else { result += item.Key; } + } + if (index >= 2) + { + result = total_size + "GB(" + result + ")"; + } + return result; + } + /// + /// 获取显卡信息 + /// + /// + public static string GetVideoInfo() + { + var result = ""; + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher("select * from Win32_VideoController"); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + while (moe.MoveNext()) + { + var item = moe.Current.Properties; + var Availability = ObjToStr(item["Availability"].Value); + if (Availability != "3") { continue; } + var Caption = ObjToStr(item["Caption"].Value); + string RAM_Str; + var RAM = ObjToStr(item["AdapterRAM"].Value).ToInt64()/1024/1024; + if (RAM >= 1024) { RAM_Str = (RAM / 1024m).ToNString("0.00")+"GB"; } + else { RAM_Str = RAM + "MB"; } + if (result.Length > 0) { result += "/"; } + result += Caption+ "("+ RAM_Str + ")"; + } + return result; + } + /// + /// 获取显卡信息 + /// + /// + public static string GetDiskInfo() + { + var list = GetDiskListInfo(); + var result = ""; + for (int i = 0; i < list.Count; i++) + { + if (result.Length > 0) { result += "/"; } + result += list[i]; + } + return result; + } + /// + /// 获取显卡信息 + /// + /// + public static List GetDiskListInfo() + { + var result = new List(); + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher("select * from Win32_DiskDrive"); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + while (moe.MoveNext()) + { + var item = moe.Current.Properties; + var size_long = ObjToStr(item["Size"].Value).ToInt64(); + var Size_1024 = size_long / 1024 / 1024 / 1024; + var Size_1000 = size_long / 1000 / 1000 / 1000; + string SizeStr; + if(Size_1000>=1000) + { + SizeStr = (Size_1000 / 1000) + "TB"; + } + else + { + SizeStr = Size_1000 + "GB"; + } + if (Size_1024 >= 1024) + { + SizeStr += "[实际"+(Size_1024 / 1024d).ToNString("0.00") + "TB]"; + } + else + { + SizeStr += "[实际" + Size_1024 + "GB]"; + } + var Caption = ObjToStr(item["Caption"].Value); + var MediaType = ObjToStr(item["MediaType"].Value); + if (MediaType == "External hard disk media") { continue; } + if (MediaType == "Removable Media") { continue; } + if (Caption.StartsWith("TOSHIBA", StringComparison.OrdinalIgnoreCase)) + { result.Add(SizeStr + " 东芝 " + Caption); } + else if (Caption.StartsWith("ST", StringComparison.OrdinalIgnoreCase)) + { result.Add(SizeStr + " 希捷 " + Caption); } + else if (Caption.StartsWith("WD", StringComparison.OrdinalIgnoreCase)) + { result.Add(SizeStr + " 西数 " + Caption); } + + else + { + var iPos = Caption.IndexOfEx(" "); + if(iPos<=0) + { + result.Add(SizeStr + " " + Caption); + } + else + { + result.Add(SizeStr + " " + GetManufacturer(Caption.Substring(0,iPos))+" "+Caption.Substring(iPos+1)); + } + } + } + return result; + } + /// + /// 获取硬盘信息 + /// + /// + public static string GetDiskMultiInfo() + { + var list = GetDiskListInfo(); + var result = ""; + for (int i = 0; i < list.Count; i++) + { + if (result.Length > 0) { result += "\r\n"; } + result += i == 0 ? "主硬盘:" : "硬盘" + (i + 1) + ":"; + result += list[i]; + } + return result; + } + /// + /// 获取主板信息 + /// + /// + public static string GetBaseBoardInfo() + { + var result = ""; + System.Management.ManagementObjectSearcher mos = + new System.Management.ManagementObjectSearcher("select * from WIN32_BaseBoard"); + System.Management.ManagementObjectCollection.ManagementObjectEnumerator moe = mos.Get().GetEnumerator(); + while (moe.MoveNext()) + { + var item = moe.Current.Properties; + var Manufacturer = ObjToStr(item["Manufacturer"].Value); + var Product = ObjToStr(item["Product"].Value); + if (result.Length > 0) { result += "/"; } + result += "["+GetManufacturer(Manufacturer) + "]" + Product; + } + return result; + } + private static string GetManufacturer(string Manufacturer) + { + var ini_path = Application.StartupPath + "\\UserDb\\Manufacturer.ini"; + var name = ""; + if (System.IO.File.Exists(ini_path)) + { + ryCommon.Ini ini = new ryCommon.Ini(ini_path); + name= ini.ReadIni(Manufacturer, "name", Manufacturer); + } + if (name.Length == 0) + { + switch (Manufacturer) + { + case "SOYO": return "梅捷"; + case "BIOSTAR": case "BIOSTAR Group": return "映泰"; + case "Gigabyte Technology Co., Ltd.": return "技嘉"; + case "ASUSTeK COMPUTER INC.": return "华硕"; + case "Micro-Star International Co., Ltd.": return "微星"; + case "ONDA": return "昂达"; + case "Shenzhen Jinge Information Co Ltd": return "亿储"; + case "SUPoX COMPUTER CO.,LTD": return "磐正"; + case "Samsung": return "三星"; + case "ADATA": return "威刚"; + case "SanDisk": return "闪迪"; + case "Macmemory": return "王储"; + case "KINGSTON": return "金士顿"; + case "G Skill": return "芝奇"; + case "GALAX": return "影驰"; + case "Corsair": return "海盗船"; + case "INTEL": return "英特尔"; + case "Micron":return "镁光"; + case "Hitachi":return "日立"; + } + } + if (name.Length == 0) { name = Manufacturer; } + return name; + } + /// + /// 获取处理器信息 + /// + /// + public static string GetCPU() + { + ManagementObjectSearcher searcher = new ManagementObjectSearcher(); //用于查询一些如系统信息的管理对象 + searcher.Query = new SelectQuery("Win32_Processor ", "", new string[] { "Name" });//设置查询条件 + ManagementObjectCollection collection = searcher.Get(); //获取内存容量 + ManagementObjectCollection.ManagementObjectEnumerator em = collection.GetEnumerator(); + + string name = ""; + Dictionary dict = new Dictionary(); + while (em.MoveNext()) + { + ManagementBaseObject baseObj = em.Current; + if (baseObj.Properties["Name"].Value != null) + { + try + { + name = baseObj.Properties["Name"].Value.ToString(); + if (dict.ContainsKey(name)) + { + dict[name]++; + } + else { dict[name] = 1; } + } + catch + { + return ""; + } + } + } + name = ""; + foreach (var item in dict) + { + if (name.Length > 0) { name += "/"; } + if (item.Value >= 2) + { + name += "("+item.Key + ")*" + item.Value; + } + else { name += item.Key; } + } + return name; + } + /// + ///获取主要硬件信息 + /// + /// + public static string GetMainHardware() + { + return GetMainHardware(false); + } + /// + /// 获取主要硬件信息 + /// + /// 是否获取XML格式 + /// + public static string GetMainHardware(bool getbyXML) + { + if (getbyXML) + { + ryCommon.Storage mStor = new Storage(); + addValue("主板", GetBaseBoardInfo()); + addValue("处理器", GetCPU()); + addValue("显卡", GetVideoInfo()); + addValue("内存", GetMemoryInfo()); + var list_disk = HardWare.GetDiskListInfo(); + for (int i = 0; i < list_disk.Count; i++) + { + addValue((i == 0 ? "主硬盘 " : "硬盘"), list_disk[i]); + } + void addValue(string name, string value) + { + mStor.AddNode2("name", name); + mStor.SetAttrValue("value", value); + } + return mStor.XMLText; + } + else + { + var content = "主板 " + HardWare.GetBaseBoardInfo(); + content += "\r\n处理器 " + HardWare.GetCPU(); + content += "\r\n显卡 " + HardWare.GetVideoInfo(); + content += "\r\n内存 " + HardWare.GetMemoryInfo(); + var list_disk = HardWare.GetDiskListInfo(); + for (int i = 0; i < list_disk.Count; i++) + { + content += "\r\n" + (i == 0 ? "主硬盘 " : "硬盘" + " ") + list_disk[i]; + } + return content; + } + } + private static string ObjToStr(object obj) + { + if (obj == null) { return ""; } + return obj.ToString(); + } + } +} diff --git a/Source/RaUI/Common/HardWare/Network.cs b/Source/RaUI/Common/HardWare/Network.cs new file mode 100644 index 0000000..e9450d7 --- /dev/null +++ b/Source/RaUI/Common/HardWare/Network.cs @@ -0,0 +1,170 @@ +using System; +using System.Collections.Generic; +using System.Globalization; +using System.Linq; +using System.Net; +using System.Net.NetworkInformation; +using System.Net.Sockets; +using System.Text; + +namespace RyHardWare +{ + /// + /// 网络操作类 + /// + public class Network + { + /// + /// 通过NetworkInterface读取网卡Mac + /// + /// + public static string GetMacs() + { + string macs = ""; + NetworkInterface[] interfaces = NetworkInterface.GetAllNetworkInterfaces(); + foreach (NetworkInterface ni in interfaces) + { + macs += ni.GetPhysicalAddress().ToString()+"|"; + } + return macs; + } + /// + /// 通过NetworkInterface读取网卡Mac + /// + /// + public static List GetMacByNetworkInterface() + { + List macs = new List(); + NetworkInterface[] interfaces = NetworkInterface.GetAllNetworkInterfaces(); + foreach (NetworkInterface ni in interfaces) + { + macs.Add(ni.GetPhysicalAddress().ToString()); + } + return macs; + } + /// + /// 根据mac字符串来获取最终的mac地址,可以是各种MAC地址格式,非法的内容将返回null + /// + /// + /// + public static byte[] GetMac(string _mac) + { + try + { + if (_mac.Length == 12) + { + #region 无任何分隔符的MAC地址 + byte[] mac = new byte[6]; + for (int z = 0; z < 6; z++) + { + mac[z] = + byte.Parse(_mac.Substring(z * 2, 2), + NumberStyles.HexNumber); + } + return mac; + #endregion + } + else if (_mac.Length == 17) + { + #region 带分隔符的MAC地址 + byte[] mac = new byte[6]; + for (int z = 0; z < 6; z++) + { + mac[z] = + byte.Parse(_mac.Substring(z * 3, 2), + NumberStyles.HexNumber); + } + return mac; + #endregion + } + else + { + return null; + } + } + catch + { + return null; + } + } + /// + /// 远程唤醒 + /// + /// + /// + /// + public static int WakeUp(string _ip, string _mac) + { + try + { + if (_ip == "127.0.0.1") + { + _ip = "192.168.1.1"; + } + byte[] mac = GetMac(_mac); + if (mac == null) + { + return -2; + } + IPAddress ipe = IPAddress.Parse(_ip); + UdpClient client = new UdpClient(); + byte[] ipbyte = ipe.GetAddressBytes(); + ipbyte[ipbyte.Length - 1] = 255; + IPAddress ip = new IPAddress(ipbyte); + client.Connect(ip, 7); + byte[] packet = new byte[17 * 6]; + + for (int i = 0; i < 6; i++) + packet[i] = 0xFF; + + for (int i = 1; i <= 16; i++) + for (int j = 0; j < 6; j++) + packet[i * 6 + j] = mac[j]; + + int result = client.Send(packet, packet.Length); + if (result != packet.Length) + { + return 0; + } + return 1; + } + catch { return -1; } + } + /// + /// 远程唤醒 + /// + /// + /// + /// + /// + public static int WakeUpByHostname(string _hostname,int port, string _mac) + { + try + { + byte[] mac = GetMac(_mac); + if (mac == null) + { + return -2; + } + UdpClient client = new UdpClient(); + client.Connect(_hostname, port); + byte[] packet = new byte[17 * 6]; + + for (int i = 0; i < 6; i++) + packet[i] = 0xFF; + + for (int i = 1; i <= 16; i++) + for (int j = 0; j < 6; j++) + packet[i * 6 + j] = mac[j]; + + int result = client.Send(packet, packet.Length); + if (result != packet.Length) + { + return 0; + } + return 1; + } + catch { return -1; } + } + } +} diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/EncodingFoundException.cs b/Source/RaUI/Common/HtmlAgilityPack.Shared/EncodingFoundException.cs new file mode 100644 index 0000000..e33b0cc --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/EncodingFoundException.cs @@ -0,0 +1,39 @@ +// Description: Html Agility Pack - HTML Parsers, selectors, traversors, manupulators. +// Website & Documentation: http://html-agility-pack.net +// Forum & Issues: https://github.com/zzzprojects/html-agility-pack +// License: https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE +// More projects: http://www.zzzprojects.com/ +// Copyright ZZZ Projects Inc. 2014 - 2017. All rights reserved. + +using System; +using System.Text; + +namespace HtmlAgilityPack +{ + internal class EncodingFoundException : Exception + { + #region Fields + + private Encoding _encoding; + + #endregion + + #region Constructors + + internal EncodingFoundException(Encoding encoding) + { + _encoding = encoding; + } + + #endregion + + #region Properties + + internal Encoding Encoding + { + get { return _encoding; } + } + + #endregion + } +} \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.projitems b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.projitems new file mode 100644 index 0000000..fa59426 --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.projitems @@ -0,0 +1,61 @@ + + + + {766aa8be-d147-4e89-a3de-51c383456f20} + SAK + SAK + SAK + SAK + + + $(MSBuildAllProjects);$(MSBuildThisFileFullPath) + true + f1d90ca4-d7c4-43ea-852f-fb4ab5f3a600 + + + HtmlAgilityPack.Shared + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.projitems.vspscc b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.projitems.vspscc new file mode 100644 index 0000000..b6d3289 --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.projitems.vspscc @@ -0,0 +1,10 @@ +"" +{ +"FILE_VERSION" = "9237" +"ENLISTMENT_CHOICE" = "NEVER" +"PROJECT_FILE_RELATIVE_PATH" = "" +"NUMBER_OF_EXCLUDED_FILES" = "0" +"ORIGINAL_PROJECT_FILE_PATH" = "" +"NUMBER_OF_NESTED_PROJECTS" = "0" +"SOURCE_CONTROL_SETTINGS_PROVIDER" = "PROVIDER" +} diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.shproj b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.shproj new file mode 100644 index 0000000..5bd5c63 --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.shproj @@ -0,0 +1,17 @@ + + + + {5BA9A0D7-173F-4C4F-AFFA-3DD6DC2F9A79} + 14.0 + SAK + SAK + SAK + SAK + + + + + + + + \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.shproj.vspscc b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.shproj.vspscc new file mode 100644 index 0000000..b6d3289 --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAgilityPack.Shared.shproj.vspscc @@ -0,0 +1,10 @@ +"" +{ +"FILE_VERSION" = "9237" +"ENLISTMENT_CHOICE" = "NEVER" +"PROJECT_FILE_RELATIVE_PATH" = "" +"NUMBER_OF_EXCLUDED_FILES" = "0" +"ORIGINAL_PROJECT_FILE_PATH" = "" +"NUMBER_OF_NESTED_PROJECTS" = "0" +"SOURCE_CONTROL_SETTINGS_PROVIDER" = "PROVIDER" +} diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAttribute.cs b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAttribute.cs new file mode 100644 index 0000000..4527fdf --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAttribute.cs @@ -0,0 +1,327 @@ +// Description: Html Agility Pack - HTML Parsers, selectors, traversors, manupulators. +// Website & Documentation: http://html-agility-pack.net +// Forum & Issues: https://github.com/zzzprojects/html-agility-pack +// License: https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE +// More projects: http://www.zzzprojects.com/ +// Copyright ?ZZZ Projects Inc. 2014 - 2017. All rights reserved. + +#region + +using System; +using System.Diagnostics; + +#endregion + +// ReSharper disable InconsistentNaming + +namespace HtmlAgilityPack +{ + /// + /// Represents an HTML attribute. + /// + [DebuggerDisplay("Name: {OriginalName}, Value: {Value}")] + public class HtmlAttribute : IComparable + { + #region Fields + + private int _line; + internal int _lineposition; + internal string _name; + internal int _namelength; + internal int _namestartindex; + internal HtmlDocument _ownerdocument; // attribute can exists without a node + internal HtmlNode _ownernode; + private AttributeValueQuote _quoteType = AttributeValueQuote.DoubleQuote; + internal int _streamposition; + internal string _value; + internal int _valuelength; + internal int _valuestartindex; + + #endregion + + #region Constructors + + internal HtmlAttribute(HtmlDocument ownerdocument) + { + _ownerdocument = ownerdocument; + } + + #endregion + + #region Properties + + /// + /// Gets the line number of this attribute in the document. + /// + public int Line + { + get { return _line; } + internal set { _line = value; } + } + + /// + /// Gets the column number of this attribute in the document. + /// + public int LinePosition + { + get { return _lineposition; } + } + + /// + /// Gets the stream position of the value of this attribute in the document, relative to the start of the document. + /// + public int ValueStartIndex + { + get { return _valuestartindex; } + } + + /// + /// Gets the length of the value. + /// + public int ValueLength + { + get { return _valuelength; } + } + /// + /// + /// + public bool UseOriginalName { get; set; } = false; + + /// + /// Gets the qualified name of the attribute. + /// + public string Name + { + get + { + if (_name == null) + { + _name = _ownerdocument.Text.Substring(_namestartindex, _namelength); + } + + return UseOriginalName ? _name : _name.ToLowerInvariant(); + } + set + { + if (value == null) + { + throw new ArgumentNullException("value"); + } + + _name = value; + if (_ownernode != null) + { + _ownernode.SetChanged(); + } + } + } + + /// + /// Name of attribute with original case + /// + public string OriginalName + { + get { return _name; } + } + + /// + /// Gets the HTML document to which this attribute belongs. + /// + public HtmlDocument OwnerDocument + { + get { return _ownerdocument; } + } + + /// + /// Gets the HTML node to which this attribute belongs. + /// + public HtmlNode OwnerNode + { + get { return _ownernode; } + } + + /// + /// Specifies what type of quote the data should be wrapped in + /// + public AttributeValueQuote QuoteType + { + get { return _quoteType; } + set { _quoteType = value; } + } + + /// + /// Specifies what type of quote the data should be wrapped in (internal to keep backward compatibility) + /// + internal AttributeValueQuote InternalQuoteType { get; set; } + + /// + /// Gets the stream position of this attribute in the document, relative to the start of the document. + /// + public int StreamPosition + { + get { return _streamposition; } + } + + /// + /// Gets or sets the value of the attribute. + /// + public string Value + { + get + { + // A null value has been provided, the attribute should be considered as "hidden" + if (_value == null && _ownerdocument.Text == null && _valuestartindex == 0 && _valuelength == 0) + { + return null; + } + + if (_value == null) + { + _value = _ownerdocument.Text.Substring(_valuestartindex, _valuelength); + + if (!_ownerdocument.BackwardCompatibility) + { + _value = HtmlEntity.DeEntitize(_value); + } + } + + return _value; + } + set + { + _value = value; + + if (_ownernode != null) + { + _ownernode.SetChanged(); + } + } + } + + /// + /// Gets the DeEntitized value of the attribute. + /// + public string DeEntitizeValue + { + get { return HtmlEntity.DeEntitize(Value); } + } + + internal string XmlName + { + get { return HtmlDocument.GetXmlName(Name, true, OwnerDocument.OptionPreserveXmlNamespaces); } + } + + internal string XmlValue + { + get { return Value; } + } + + /// + /// Gets a valid XPath string that points to this Attribute + /// + public string XPath + { + get + { + string basePath = (OwnerNode == null) ? "/" : OwnerNode.XPath + "/"; + return basePath + GetRelativeXpath(); + } + } + + #endregion + + #region IComparable Members + + /// + /// Compares the current instance with another attribute. Comparison is based on attributes' name. + /// + /// An attribute to compare with this instance. + /// A 32-bit signed integer that indicates the relative order of the names comparison. + public int CompareTo(object obj) + { + HtmlAttribute att = obj as HtmlAttribute; + if (att == null) + { + throw new ArgumentException("obj"); + } + + return Name.CompareTo(att.Name); + } + + #endregion + + #region Public Methods + + /// + /// Creates a duplicate of this attribute. + /// + /// The cloned attribute. + public HtmlAttribute Clone() + { + HtmlAttribute att = new HtmlAttribute(_ownerdocument); + att.Name = Name; + att.Value = Value; + att.QuoteType = QuoteType; + return att; + } + + /// + /// Removes this attribute from it's parents collection + /// + public void Remove() + { + _ownernode.Attributes.Remove(this); + } + + #endregion + + #region Private Methods + + private string GetRelativeXpath() + { + if (OwnerNode == null) + return Name; + + int i = 1; + foreach (HtmlAttribute node in OwnerNode.Attributes) + { + if (node.Name != Name) continue; + + if (node == this) + break; + + i++; + } + + return "@" + Name + "[" + i + "]"; + } + + #endregion + } + + /// + /// An Enum representing different types of Quotes used for surrounding attribute values + /// + public enum AttributeValueQuote + { + /// + /// A single quote mark ' + /// + SingleQuote, + + /// + /// A double quote mark " + /// + DoubleQuote, + + /// + /// No quote mark + /// + None, + + /// + /// The initial value (current value) + /// + Initial + } +} \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAttributeCollection.cs b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAttributeCollection.cs new file mode 100644 index 0000000..4dae77d --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlAttributeCollection.cs @@ -0,0 +1,452 @@ +// Description: Html Agility Pack - HTML Parsers, selectors, traversors, manupulators. +// Website & Documentation: http://html-agility-pack.net +// Forum & Issues: https://github.com/zzzprojects/html-agility-pack +// License: https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE +// More projects: http://www.zzzprojects.com/ +// Copyright ZZZ Projects Inc. 2014 - 2017. All rights reserved. + +using System; +using System.Collections; +using System.Collections.Generic; + +namespace HtmlAgilityPack +{ + /// + /// Represents a combined list and collection of HTML nodes. + /// + public class HtmlAttributeCollection : IList + { + #region Fields + + internal Dictionary Hashitems = new Dictionary(StringComparer.OrdinalIgnoreCase); + private HtmlNode _ownernode; + internal List items = new List(); + + #endregion + + #region Constructors + + internal HtmlAttributeCollection(HtmlNode ownernode) + { + _ownernode = ownernode; + } + + #endregion + + + #region IList Members + + /// + /// Gets the number of elements actually contained in the list. + /// + public int Count + { + get { return items.Count; } + } + + /// + /// Gets readonly status of colelction + /// + public bool IsReadOnly + { + get { return false; } + } + + /// + /// Gets the attribute at the specified index. + /// + public HtmlAttribute this[int index] + { + get { return items[index]; } + set + { + var oldValue = items[index]; + + items[index] = value; + + if (oldValue.Name != value.Name) + { + Hashitems.Remove(oldValue.Name); + } + Hashitems[value.Name] = value; + + value._ownernode = _ownernode; + _ownernode.SetChanged(); + } + } + + + /// + /// Gets a given attribute from the list using its name. + /// + public HtmlAttribute this[string name] + { + get + { + if (name == null) + { + throw new ArgumentNullException("name"); + } + + HtmlAttribute value; + return Hashitems.TryGetValue(name, out value) ? value : null; + } + set + { + HtmlAttribute currentValue; + + if (!Hashitems.TryGetValue(name, out currentValue)) + { + Append(value); + } + else + { + this[items.IndexOf(currentValue)] = value; + } + } + } + + + /// + /// Adds a new attribute to the collection with the given values + /// + /// + /// + public void Add(string name, string value) + { + Append(name, value); + } + + + /// + /// Adds supplied item to collection + /// + /// + public void Add(HtmlAttribute item) + { + Append(item); + } + + /// Adds a range supplied items to collection. + /// An IEnumerable<HtmlAttribute> of items to append to this. + public void AddRange(IEnumerable items) + { + foreach (var item in items) + { + Append(item); + } + } + + /// Adds a range supplied items to collection using a dictionary. + /// A Dictionary<string,string> of items to append to this. + public void AddRange(Dictionary items) + { + foreach (var item in items) + { + Add(item.Key, item.Value); + } + } + + /// + /// Explicit clear + /// + void ICollection.Clear() + { + items.Clear(); + } + + /// + /// Retreives existence of supplied item + /// + /// + /// + public bool Contains(HtmlAttribute item) + { + return items.Contains(item); + } + + /// + /// Copies collection to array + /// + /// + /// + public void CopyTo(HtmlAttribute[] array, int arrayIndex) + { + items.CopyTo(array, arrayIndex); + } + + /// + /// Get Explicit enumerator + /// + /// + IEnumerator IEnumerable.GetEnumerator() + { + return items.GetEnumerator(); + } + + /// + /// Explicit non-generic enumerator + /// + /// + IEnumerator IEnumerable.GetEnumerator() + { + return items.GetEnumerator(); + } + + /// + /// Retrieves the index for the supplied item, -1 if not found + /// + /// + /// + public int IndexOf(HtmlAttribute item) + { + return items.IndexOf(item); + } + + /// + /// Inserts given item into collection at supplied index + /// + /// + /// + public void Insert(int index, HtmlAttribute item) + { + if (item == null) + { + throw new ArgumentNullException("item"); + } + + Hashitems[item.Name] = item; + item._ownernode = _ownernode; + items.Insert(index, item); + + _ownernode.SetChanged(); + } + + /// + /// Explicit collection remove + /// + /// + /// + bool ICollection.Remove(HtmlAttribute item) + { + return items.Remove(item); + } + + /// + /// Removes the attribute at the specified index. + /// + /// The index of the attribute to remove. + public void RemoveAt(int index) + { + HtmlAttribute att = items[index]; + Hashitems.Remove(att.Name); + items.RemoveAt(index); + + _ownernode.SetChanged(); + } + + #endregion + + #region Public Methods + + /// + /// Inserts the specified attribute as the last attribute in the collection. + /// + /// The attribute to insert. May not be null. + /// The appended attribute. + public HtmlAttribute Append(HtmlAttribute newAttribute) + { + if (_ownernode.NodeType == HtmlNodeType.Text || _ownernode.NodeType == HtmlNodeType.Comment) + { + throw new Exception("A Text or Comment node cannot have attributes."); + } + + if (newAttribute == null) + { + throw new ArgumentNullException("newAttribute"); + } + + Hashitems[newAttribute.Name] = newAttribute; + newAttribute._ownernode = _ownernode; + items.Add(newAttribute); + + _ownernode.SetChanged(); + return newAttribute; + } + + /// + /// Creates and inserts a new attribute as the last attribute in the collection. + /// + /// The name of the attribute to insert. + /// The appended attribute. + public HtmlAttribute Append(string name) + { + HtmlAttribute att = _ownernode._ownerdocument.CreateAttribute(name); + return Append(att); + } + + /// + /// Creates and inserts a new attribute as the last attribute in the collection. + /// + /// The name of the attribute to insert. + /// The value of the attribute to insert. + /// The appended attribute. + public HtmlAttribute Append(string name, string value) + { + HtmlAttribute att = _ownernode._ownerdocument.CreateAttribute(name, value); + return Append(att); + } + + /// + /// Checks for existance of attribute with given name + /// + /// + /// + public bool Contains(string name) + { + for (int i = 0; i < items.Count; i++) + { + if (String.Equals(items[i].Name, name, StringComparison.OrdinalIgnoreCase)) + return true; + } + + return false; + } + + /// + /// Inserts the specified attribute as the first node in the collection. + /// + /// The attribute to insert. May not be null. + /// The prepended attribute. + public HtmlAttribute Prepend(HtmlAttribute newAttribute) + { + Insert(0, newAttribute); + return newAttribute; + } + + /// + /// Removes a given attribute from the list. + /// + /// The attribute to remove. May not be null. + public void Remove(HtmlAttribute attribute) + { + if (attribute == null) + { + throw new ArgumentNullException("attribute"); + } + + int index = GetAttributeIndex(attribute); + if (index == -1) + { + throw new IndexOutOfRangeException(); + } + + RemoveAt(index); + } + + /// + /// Removes an attribute from the list, using its name. If there are more than one attributes with this name, they will all be removed. + /// + /// The attribute's name. May not be null. + public void Remove(string name) + { + if (name == null) + { + throw new ArgumentNullException("name"); + } + + for (int i = 0; i < items.Count; i++) + { + HtmlAttribute att = items[i]; + if (String.Equals(att.Name, name, StringComparison.OrdinalIgnoreCase)) + { + RemoveAt(i); + } + } + } + + /// + /// Remove all attributes in the list. + /// + public void RemoveAll() + { + Hashitems.Clear(); + items.Clear(); + + _ownernode.SetChanged(); + } + + #endregion + + #region LINQ Methods + + /// + /// Returns all attributes with specified name. Handles case insentivity + /// + /// Name of the attribute + /// + public IEnumerable AttributesWithName(string attributeName) + { + for (int i = 0; i < items.Count; i++) + { + if (String.Equals(items[i].Name, attributeName, StringComparison.OrdinalIgnoreCase)) + yield return items[i]; + } + } + + /// + /// Removes all attributes from the collection + /// + public void Remove() + { + items.Clear(); + } + + #endregion + + #region Internal Methods + + /// + /// Clears the attribute collection + /// + internal void Clear() + { + Hashitems.Clear(); + items.Clear(); + } + + internal int GetAttributeIndex(HtmlAttribute attribute) + { + if (attribute == null) + { + throw new ArgumentNullException("attribute"); + } + + for (int i = 0; i < items.Count; i++) + { + if ((items[i]) == attribute) + return i; + } + + return -1; + } + + internal int GetAttributeIndex(string name) + { + if (name == null) + { + throw new ArgumentNullException("name"); + } + + for (int i = 0; i < items.Count; i++) + { + if (String.Equals((items[i]).Name, name, StringComparison.OrdinalIgnoreCase)) + return i; + } + + return -1; + } + + #endregion + } +} \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlCmdLine.cs b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlCmdLine.cs new file mode 100644 index 0000000..8962a2e --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlCmdLine.cs @@ -0,0 +1,154 @@ +// Description: Html Agility Pack - HTML Parsers, selectors, traversors, manupulators. +// Website & Documentation: http://html-agility-pack.net +// Forum & Issues: https://github.com/zzzprojects/html-agility-pack +// License: https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE +// More projects: http://www.zzzprojects.com/ +// Copyright ZZZ Projects Inc. 2014 - 2017. All rights reserved. + +using System; + +#if !NETSTANDARD1_3 && !METRO +namespace HtmlAgilityPack +{ + internal class HtmlCmdLine + { +#region Static Members + + internal static bool Help; + +#endregion + +#region Constructors + + static HtmlCmdLine() + { + Help = false; + ParseArgs(); + } + +#endregion + +#region Internal Methods + + internal static string GetOption(string name, string def) + { + string p = def; + string[] args = Environment.GetCommandLineArgs(); + for (int i = 1; i < args.Length; i++) + { + GetStringArg(args[i], name, ref p); + } + + return p; + } + + internal static string GetOption(int index, string def) + { + string p = def; + string[] args = Environment.GetCommandLineArgs(); + int j = 0; + for (int i = 1; i < args.Length; i++) + { + if (GetStringArg(args[i], ref p)) + { + if (index == j) + return p; + else + p = def; + j++; + } + } + + return p; + } + + internal static bool GetOption(string name, bool def) + { + bool p = def; + string[] args = Environment.GetCommandLineArgs(); + for (int i = 1; i < args.Length; i++) + { + GetBoolArg(args[i], name, ref p); + } + + return p; + } + + internal static int GetOption(string name, int def) + { + int p = def; + string[] args = Environment.GetCommandLineArgs(); + for (int i = 1; i < args.Length; i++) + { + GetIntArg(args[i], name, ref p); + } + + return p; + } + +#endregion + +#region Private Methods + + private static void GetBoolArg(string Arg, string Name, ref bool ArgValue) + { + if (Arg.Length < (Name.Length + 1)) // -name is 1 more than name + return; + if (('/' != Arg[0]) && ('-' != Arg[0])) // not a param + return; + if (Arg.Substring(1, Name.Length).ToLowerInvariant() == Name.ToLowerInvariant()) + ArgValue = true; + } + + private static void GetIntArg(string Arg, string Name, ref int ArgValue) + { + if (Arg.Length < (Name.Length + 3)) // -name:12 is 3 more than name + return; + if (('/' != Arg[0]) && ('-' != Arg[0])) // not a param + return; + if (Arg.Substring(1, Name.Length).ToLowerInvariant() == Name.ToLowerInvariant()) + { + try + { + ArgValue = Convert.ToInt32(Arg.Substring(Name.Length + 2, Arg.Length - Name.Length - 2)); + } + catch + { + } + } + } + + private static bool GetStringArg(string Arg, ref string ArgValue) + { + if (('/' == Arg[0]) || ('-' == Arg[0])) + return false; + ArgValue = Arg; + return true; + } + + private static void GetStringArg(string Arg, string Name, ref string ArgValue) + { + if (Arg.Length < (Name.Length + 3)) // -name:x is 3 more than name + return; + if (('/' != Arg[0]) && ('-' != Arg[0])) // not a param + return; + if (Arg.Substring(1, Name.Length).ToLowerInvariant() == Name.ToLowerInvariant()) + ArgValue = Arg.Substring(Name.Length + 2, Arg.Length - Name.Length - 2); + } + + private static void ParseArgs() + { + string[] args = Environment.GetCommandLineArgs(); + for (int i = 1; i < args.Length; i++) + { + // help + GetBoolArg(args[i], "?", ref Help); + GetBoolArg(args[i], "h", ref Help); + GetBoolArg(args[i], "help", ref Help); + } + } + +#endregion + } +} +#endif \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlCommentNode.cs b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlCommentNode.cs new file mode 100644 index 0000000..926eae5 --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlCommentNode.cs @@ -0,0 +1,85 @@ +// Description: Html Agility Pack - HTML Parsers, selectors, traversors, manupulators. +// Website & Documentation: http://html-agility-pack.net +// Forum & Issues: https://github.com/zzzprojects/html-agility-pack +// License: https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE +// More projects: http://www.zzzprojects.com/ +// Copyright ZZZ Projects Inc. 2014 - 2017. All rights reserved. + +namespace HtmlAgilityPack +{ + /// + /// Represents an HTML comment. + /// + public class HtmlCommentNode : HtmlNode + { + #region Fields + + private string _comment; + + #endregion + + #region Constructors + + internal HtmlCommentNode(HtmlDocument ownerdocument, int index) + : + base(HtmlNodeType.Comment, ownerdocument, index) + { + } + + #endregion + + #region Properties + + /// + /// Gets or Sets the comment text of the node. + /// + public string Comment + { + get + { + if (_comment == null) + { + return base.InnerHtml; + } + + return _comment; + } + set { _comment = value; } + } + + /// + /// Gets or Sets the HTML between the start and end tags of the object. In the case of a text node, it is equals to OuterHtml. + /// + public override string InnerHtml + { + get + { + if (_comment == null) + { + return base.InnerHtml; + } + + return _comment; + } + set { _comment = value; } + } + + /// + /// Gets or Sets the object and its content in HTML. + /// + public override string OuterHtml + { + get + { + if (_comment == null) + { + return base.OuterHtml; + } + + return ""; + } + } + + #endregion + } +} \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlConsoleListener.cs b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlConsoleListener.cs new file mode 100644 index 0000000..e31f9f7 --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlConsoleListener.cs @@ -0,0 +1,41 @@ +// Description: Html Agility Pack - HTML Parsers, selectors, traversors, manupulators. +// Website & Documentation: http://html-agility-pack.net +// Forum & Issues: https://github.com/zzzprojects/html-agility-pack +// License: https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE +// More projects: http://www.zzzprojects.com/ +// Copyright ZZZ Projects Inc. 2014 - 2017. All rights reserved. + +#if !NETSTANDARD1_3 && !NETSTANDARD1_6 && !METRO +using System; +using System.Diagnostics; + +namespace HtmlAgilityPack +{ + internal class HtmlConsoleListener : TraceListener + { +#region Public Methods + + public override void Write(string Message) + { + Write(Message, ""); + } + + public override void Write(string Message, string Category) + { + Console.Write("T:" + Category + ": " + Message); + } + + public override void WriteLine(string Message) + { + Write(Message + "\n"); + } + + public override void WriteLine(string Message, string Category) + { + Write(Message + "\n", Category); + } + +#endregion + } +} +#endif \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlDocument.PathMethods.cs b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlDocument.PathMethods.cs new file mode 100644 index 0000000..f689f8a --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlDocument.PathMethods.cs @@ -0,0 +1,237 @@ +// Description: Html Agility Pack - HTML Parsers, selectors, traversors, manupulators. +// Website & Documentation: http://html-agility-pack.net +// Forum & Issues: https://github.com/zzzprojects/html-agility-pack +// License: https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE +// More projects: http://www.zzzprojects.com/ +// Copyright © ZZZ Projects Inc. 2014 - 2017. All rights reserved. + +#if !METRO + +using System; +using System.IO; +using System.Text; + +namespace HtmlAgilityPack +{ + public partial class HtmlDocument + { + /// + /// Detects the encoding of an HTML document from a file first, and then loads the file. + /// + /// The complete file path to be read. + public void DetectEncodingAndLoad(string path) + { + DetectEncodingAndLoad(path, true); + } + + /// + /// Detects the encoding of an HTML document from a file first, and then loads the file. + /// + /// The complete file path to be read. May not be null. + /// true to detect encoding, false otherwise. + public void DetectEncodingAndLoad(string path, bool detectEncoding) + { + if (path == null) + { + throw new ArgumentNullException("path"); + } + + Encoding enc; + if (detectEncoding) + { + enc = DetectEncoding(path); + } + else + { + enc = null; + } + + if (enc == null) + { + Load(path); + } + else + { + Load(path, enc); + } + } + + /// + /// Detects the encoding of an HTML file. + /// + /// Path for the file containing the HTML document to detect. May not be null. + /// The detected encoding. + public Encoding DetectEncoding(string path) + { + if (path == null) + { + throw new ArgumentNullException("path"); + } + +#if NETSTANDARD1_3 || NETSTANDARD1_6 + using (StreamReader sr = new StreamReader(File.OpenRead(path), OptionDefaultStreamEncoding)) +#else + using (StreamReader sr = new StreamReader(path, OptionDefaultStreamEncoding)) +#endif + { + Encoding encoding = DetectEncoding(sr); + return encoding; + } + } + + /// + /// Loads an HTML document from a file. + /// + /// The complete file path to be read. May not be null. + public void Load(string path) + { + if (path == null) + throw new ArgumentNullException("path"); + +#if NETSTANDARD1_3 || NETSTANDARD1_6 + using (StreamReader sr = new StreamReader(File.OpenRead(path), OptionDefaultStreamEncoding)) +#else + using (StreamReader sr = new StreamReader(path, OptionDefaultStreamEncoding)) +#endif + { + Load(sr); + } + } + + /// + /// Loads an HTML document from a file. + /// + /// The complete file path to be read. May not be null. + /// Indicates whether to look for byte order marks at the beginning of the file. + public void Load(string path, bool detectEncodingFromByteOrderMarks) + { + if (path == null) + throw new ArgumentNullException("path"); + +#if NETSTANDARD1_3 || NETSTANDARD1_6 + using (StreamReader sr = new StreamReader(File.OpenRead(path), detectEncodingFromByteOrderMarks)) +#else + using (StreamReader sr = new StreamReader(path, detectEncodingFromByteOrderMarks)) +#endif + { + Load(sr); + } + } + + /// + /// Loads an HTML document from a file. + /// + /// The complete file path to be read. May not be null. + /// The character encoding to use. May not be null. + public void Load(string path, Encoding encoding) + { + if (path == null) + throw new ArgumentNullException("path"); + + if (encoding == null) + throw new ArgumentNullException("encoding"); + +#if NETSTANDARD1_3 || NETSTANDARD1_6 + using (StreamReader sr = new StreamReader(File.OpenRead(path), encoding)) +#else + using (StreamReader sr = new StreamReader(path, encoding)) +#endif + { + Load(sr); + } + } + + /// + /// Loads an HTML document from a file. + /// + /// The complete file path to be read. May not be null. + /// The character encoding to use. May not be null. + /// Indicates whether to look for byte order marks at the beginning of the file. + public void Load(string path, Encoding encoding, bool detectEncodingFromByteOrderMarks) + { + if (path == null) + throw new ArgumentNullException("path"); + + if (encoding == null) + throw new ArgumentNullException("encoding"); + +#if NETSTANDARD1_3 || NETSTANDARD1_6 + using (StreamReader sr = new StreamReader(File.OpenRead(path), encoding, detectEncodingFromByteOrderMarks)) +#else + using (StreamReader sr = new StreamReader(path, encoding, detectEncodingFromByteOrderMarks)) +#endif + { + Load(sr); + } + } + + /// + /// Loads an HTML document from a file. + /// + /// The complete file path to be read. May not be null. + /// The character encoding to use. May not be null. + /// Indicates whether to look for byte order marks at the beginning of the file. + /// The minimum buffer size. + public void Load(string path, Encoding encoding, bool detectEncodingFromByteOrderMarks, int buffersize) + { + if (path == null) + throw new ArgumentNullException("path"); + + if (encoding == null) + throw new ArgumentNullException("encoding"); + +#if NETSTANDARD1_3 || NETSTANDARD1_6 + using (StreamReader sr = new StreamReader(File.OpenRead(path), encoding, detectEncodingFromByteOrderMarks, buffersize)) + +#else + using (StreamReader sr = new StreamReader(path, encoding, detectEncodingFromByteOrderMarks, buffersize)) +#endif + { + Load(sr); + } + } + + /// + /// Saves the mixed document to the specified file. + /// + /// The location of the file where you want to save the document. + public void Save(string filename) + { +#if NETSTANDARD1_3 || NETSTANDARD1_6 + using (StreamWriter sw = new StreamWriter(File.OpenWrite(filename), GetOutEncoding())) +#else + using (StreamWriter sw = new StreamWriter(filename, false, GetOutEncoding())) +#endif + { + Save(sw); + } + } + + /// + /// Saves the mixed document to the specified file. + /// + /// The location of the file where you want to save the document. May not be null. + /// The character encoding to use. May not be null. + public void Save(string filename, Encoding encoding) + { + if (filename == null) + { + throw new ArgumentNullException("filename"); + } + + if (encoding == null) + { + throw new ArgumentNullException("encoding"); + } +#if NETSTANDARD1_3 || NETSTANDARD1_6 + using (StreamWriter sw = new StreamWriter(File.OpenWrite(filename), encoding)) +#else + using (StreamWriter sw = new StreamWriter(filename, false, encoding)) +#endif + { + Save(sw); + } + } + } +} +#endif \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlDocument.Xpath.cs b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlDocument.Xpath.cs new file mode 100644 index 0000000..f6accb8 --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlDocument.Xpath.cs @@ -0,0 +1,27 @@ +// Description: Html Agility Pack - HTML Parsers, selectors, traversors, manupulators. +// Website & Documentation: http://html-agility-pack.net +// Forum & Issues: https://github.com/zzzprojects/html-agility-pack +// License: https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE +// More projects: http://www.zzzprojects.com/ +// Copyright © ZZZ Projects Inc. 2014 - 2017. All rights reserved. + +#if !METRO + +using System.Xml.XPath; + +namespace HtmlAgilityPack +{ + public partial class HtmlDocument : IXPathNavigable + { + /// + /// Creates a new XPathNavigator object for navigating this HTML document. + /// + /// An XPathNavigator object. The XPathNavigator is positioned on the root of the document. + public XPathNavigator CreateNavigator() + { + return new HtmlNodeNavigator(this, _documentnode); + } + } +} + +#endif \ No newline at end of file diff --git a/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlDocument.cs b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlDocument.cs new file mode 100644 index 0000000..801ba55 --- /dev/null +++ b/Source/RaUI/Common/HtmlAgilityPack.Shared/HtmlDocument.cs @@ -0,0 +1,2220 @@ +// Description: Html Agility Pack - HTML Parsers, selectors, traversors, manupulators. +// Website & Documentation: http://html-agility-pack.net +// Forum & Issues: https://github.com/zzzprojects/html-agility-pack +// License: https://github.com/zzzprojects/html-agility-pack/blob/master/LICENSE +// More projects: http://www.zzzprojects.com/ +// Copyright ?ZZZ Projects Inc. 2014 - 2017. All rights reserved. + +using System; +using System.Collections.Generic; +using System.IO; +using System.Text; +using System.Text.RegularExpressions; +using System.Xml; + +namespace HtmlAgilityPack +{ + /// + /// Represents a complete HTML document. + /// + public partial class HtmlDocument + { + #region Manager + + internal static bool _disableBehaviorTagP = true; + + /// True to disable, false to enable the behavior tag p. + public static bool DisableBehaviorTagP + { + get => _disableBehaviorTagP; + set + { + if (value) + { + if (HtmlNode.ElementsFlags.ContainsKey("p")) + { + HtmlNode.ElementsFlags.Remove("p"); + } + } + else + { + if (!HtmlNode.ElementsFlags.ContainsKey("p")) + { + HtmlNode.ElementsFlags.Add("p", HtmlElementFlag.Empty | HtmlElementFlag.Closed); + } + } + + _disableBehaviorTagP = value; + } + } + + /// Default builder to use in the HtmlDocument constructor + public static Action DefaultBuilder { get; set; } + + /// Action to execute before the Parse is executed + public Action ParseExecuting { get; set; } + + #endregion + + #region Fields + + /// + /// Defines the max level we would go deep into the html document + /// + private static int _maxDepthLevel = int.MaxValue; + + private int _c; +#pragma warning disable CS0618 // ͻԱѹʱ + private Crc32 _crc32; +#pragma warning restore CS0618 // ͻԱѹʱ + private HtmlAttribute _currentattribute; + private HtmlNode _currentnode; + private Encoding _declaredencoding; + private HtmlNode _documentnode; + private bool _fullcomment; + private int _index; + internal Dictionary Lastnodes = new Dictionary(); + private HtmlNode _lastparentnode; + private int _line; + private int _lineposition, _maxlineposition; + internal Dictionary Nodesid; + private ParseState _oldstate; + private bool _onlyDetectEncoding; + internal Dictionary Openednodes; + private List _parseerrors = new List(); + private string _remainder; + private int _remainderOffset; + private ParseState _state; + private Encoding _streamencoding; + private bool _useHtmlEncodingForStream; + + /// The HtmlDocument Text. Careful if you modify it. + public string Text; + + /// True to stay backward compatible with previous version of HAP. This option does not guarantee 100% compatibility. + public bool BackwardCompatibility = true; + + /// + /// Adds Debugging attributes to node. Default is false. + /// + public bool OptionAddDebuggingAttributes; + + /// + /// Defines if closing for non closed nodes must be done at the end or directly in the document. + /// Setting this to true can actually change how browsers render the page. Default is false. + /// + public bool OptionAutoCloseOnEnd; // close errors at the end + + /// + /// Defines if non closed nodes will be checked at the end of parsing. Default is true. + /// + public bool OptionCheckSyntax = true; + + /// + /// Defines if a checksum must be computed for the document while parsing. Default is false. + /// + public bool OptionComputeChecksum; + + /// + /// Defines if SelectNodes method will return null or empty collection when no node matched the XPath expression. + /// Setting this to true will return empty collection and false will return null. Default is false. + /// + public bool OptionEmptyCollection = false; + + /// True to disable, false to enable the server side code. + public bool DisableServerSideCode = false; + + + /// + /// Defines the default stream encoding to use. Default is System.Text.Encoding.Default. + /// + public Encoding OptionDefaultStreamEncoding; + + /// + /// Force to take the original comment instead of creating it + /// + public bool OptionXmlForceOriginalComment; + + /// + /// Defines if source text must be extracted while parsing errors. + /// If the document has a lot of errors, or cascading errors, parsing performance can be dramatically affected if set to true. + /// Default is false. + /// + public bool OptionExtractErrorSourceText; + + // turning this on can dramatically slow performance if a lot of errors are detected + + /// + /// Defines the maximum length of source text or parse errors. Default is 100. + /// + public int OptionExtractErrorSourceTextMaxLength = 100; + + /// + /// Defines if LI, TR, TH, TD tags must be partially fixed when nesting errors are detected. Default is false. + /// + public bool OptionFixNestedTags; // fix li, tr, th, td tags + + /// + /// Defines if output must conform to XML, instead of HTML. Default is false. + /// + public bool OptionOutputAsXml; + + /// + /// If used together with and enabled, Xml namespaces in element names are preserved. Default is false. + /// + public bool OptionPreserveXmlNamespaces; + + /// + /// Defines if attribute value output must be optimized (not bound with double quotes if it is possible). Default is false. + /// + public bool OptionOutputOptimizeAttributeValues; + + /// Defines the global attribute value quote. When specified, it will always win. + public AttributeValueQuote? GlobalAttributeValueQuote; + + /// + /// Defines if name must be output with it's original case. Useful for asp.net tags and attributes. Default is false. + /// + public bool OptionOutputOriginalCase; + + /// + /// Defines if name must be output in uppercase. Default is false. + /// + public bool OptionOutputUpperCase; + + /// + /// Defines if declared encoding must be read from the document. + /// Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node. + /// Default is true. + /// + public bool OptionReadEncoding = true; + + /// + /// Defines the name of a node that will throw the StopperNodeException when found as an end node. Default is null. + /// + public string OptionStopperNodeName; + + /// + /// Defines if the 'id' attribute must be specifically used. Default is true. + /// + public bool OptionUseIdAttribute = true; + + /// + /// Defines if empty nodes must be written as closed during output. Default is false. + /// + public bool OptionWriteEmptyNodes; + + /// + /// The max number of nested child nodes. + /// Added to prevent stackoverflow problem when a page has tens of thousands of opening html tags with no closing tags + /// + public int OptionMaxNestedChildNodes = 0; + + + #endregion + + #region Static Members + + internal static readonly string HtmlExceptionRefNotChild = "Reference node must be a child of this node"; + + internal static readonly string HtmlExceptionUseIdAttributeFalse = "You need to set UseIdAttribute property to true to enable this feature"; + + internal static readonly string HtmlExceptionClassDoesNotExist = "Class name doesn't exist"; + + internal static readonly string HtmlExceptionClassExists = "Class name already exists"; + + internal static readonly Dictionary HtmlResetters = new Dictionary() + { + {"li", new[] {"ul", "ol"}}, + {"tr", new[] {"table"}}, + {"th", new[] {"tr", "table"}}, + {"td", new[] {"tr", "table"}}, + }; + + #endregion + + #region Constructors + + /// + /// Creates an instance of an HTML document. + /// + public HtmlDocument() + { + if (DefaultBuilder != null) + { + DefaultBuilder(this); + } + + _documentnode = CreateNode(HtmlNodeType.Document, 0); +#if SILVERLIGHT || METRO || NETSTANDARD1_3 || NETSTANDARD1_6 + OptionDefaultStreamEncoding = Encoding.UTF8; +#else + OptionDefaultStreamEncoding = Encoding.Default; +#endif + } + + #endregion + + #region Properties + + /// Gets the parsed text. + /// The parsed text. + public string ParsedText + { + get { return Text; } + } + + /// + /// Defines the max level we would go deep into the html document. If this depth level is exceeded, and exception is + /// thrown. + /// + public static int MaxDepthLevel + { + get { return _maxDepthLevel; } + set { _maxDepthLevel = value; } + } + + /// + /// Gets the document CRC32 checksum if OptionComputeChecksum was set to true before parsing, 0 otherwise. + /// + [Obsolete] + public int CheckSum + { + get { return _crc32 == null ? 0 : (int) _crc32.CheckSum; } + } + + /// + /// Gets the document's declared encoding. + /// Declared encoding is determined using the meta http-equiv="content-type" content="text/html;charset=XXXXX" html node (pre-HTML5) or the meta charset="XXXXX" html node (HTML5). + /// + public Encoding DeclaredEncoding + { + get { return _declaredencoding; } + } + + /// + /// Gets the root node of the document. + /// + public HtmlNode DocumentNode + { + get { return _documentnode; } + } + + /// + /// Gets the document's output encoding. + /// + public Encoding Encoding + { + get { return GetOutEncoding(); } + } + + /// + /// Gets a list of parse errors found in the document. + /// + public IEnumerable ParseErrors + { + get { return _parseerrors; } + } + + /// + /// Gets the remaining text. + /// Will always be null if OptionStopperNodeName is null. + /// + public string Remainder + { + get { return _remainder; } + } + + /// + /// Gets the offset of Remainder in the original Html text. + /// If OptionStopperNodeName is null, this will return the length of the original Html text. + /// + public int RemainderOffset + { + get { return _remainderOffset; } + } + + /// + /// Gets the document's stream encoding. + /// + public Encoding StreamEncoding + { + get { return _streamencoding; } + } + + #endregion + + #region Public Methods + + /// + /// Gets a valid XML name. + /// + /// Any text. + /// A string that is a valid XML name. + public static string GetXmlName(string name) + { + return GetXmlName(name, false, false); + } + +#if !METRO + /// + /// + /// + /// + public void UseAttributeOriginalName(string tagName) + { + foreach (var nod in this.DocumentNode.SelectNodes("//" + tagName)) + { + foreach (var attribut in nod.Attributes) + { + attribut.UseOriginalName = true; + } + } + } +#endif + /// + /// + /// + /// + /// + /// + /// + public static string GetXmlName(string name, bool isAttribute, bool preserveXmlNamespaces) + { + string xmlname = string.Empty; + bool nameisok = true; + for (int i = 0; i < name.Length; i++) + { + // names are lcase + // note: we are very limited here, too much? + if (((name[i] >= 'a') && (name[i] <= 'z')) || + ((name[i] >= 'A') && (name[i] <= 'Z')) || + ((name[i] >= '0') && (name[i] <= '9')) || + ((isAttribute || preserveXmlNamespaces) && name[i] == ':') || + // (name[i]==':') || (name[i]=='_') || (name[i]=='-') || (name[i]=='.')) // these are bads in fact + (name[i] == '_') || (name[i] == '-') || (name[i] == '.')) + { + xmlname += name[i]; + } + else + { + nameisok = false; + byte[] bytes = Encoding.UTF8.GetBytes(new char[] {name[i]}); + for (int j = 0; j < bytes.Length; j++) + { + xmlname += bytes[j].ToString("x2"); + } + + xmlname += "_"; + } + } + + if (nameisok) + { + return xmlname; + } + + return "_" + xmlname; + } + + /// + /// Applies HTML encoding to a specified string. + /// + /// The input string to encode. May not be null. + /// The encoded string. + public static string HtmlEncode(string html) + { + return HtmlEncodeWithCompatibility(html, true); + } + + internal static string HtmlEncodeWithCompatibility(string html, bool backwardCompatibility = true) + { + if (html == null) + { + throw new ArgumentNullException("html"); + } + + // replace & by & but only once! + + Regex rx = backwardCompatibility ? new Regex("&(?!(amp;)|(lt;)|(gt;)|(quot;))", RegexOptions.IgnoreCase) : new Regex("&(?!(amp;)|(lt;)|(gt;)|(quot;)|(nbsp;)|(reg;))", RegexOptions.IgnoreCase); + return rx.Replace(html, "&").Replace("<", "<").Replace(">", ">").Replace("\"", """); + } + + /// + /// Determines if the specified character is considered as a whitespace character. + /// + /// The character to check. + /// true if if the specified character is considered as a whitespace character. + public static bool IsWhiteSpace(int c) + { + if ((c == 10) || (c == 13) || (c == 32) || (c == 9)) + { + return true; + } + + return false; + } + + /// + /// Creates an HTML attribute with the specified name. + /// + /// The name of the attribute. May not be null. + /// The new HTML attribute. + public HtmlAttribute CreateAttribute(string name) + { + if (name == null) + throw new ArgumentNullException("name"); + + HtmlAttribute att = CreateAttribute(); + att.Name = name; + return att; + } + + /// + /// Creates an HTML attribute with the specified name. + /// + /// The name of the attribute. May not be null. + /// The value of the attribute. + /// The new HTML attribute. + public HtmlAttribute CreateAttribute(string name, string value) + { + if (name == null) + { + throw new ArgumentNullException("name"); + } + + HtmlAttribute att = CreateAttribute(name); + att.Value = value; + return att; + } + + /// + /// Creates an HTML comment node. + /// + /// The new HTML comment node. + public HtmlCommentNode CreateComment() + { + return (HtmlCommentNode) CreateNode(HtmlNodeType.Comment); + } + + /// + /// Creates an HTML comment node with the specified comment text. + /// + /// The comment text. May not be null. + /// The new HTML comment node. + public HtmlCommentNode CreateComment(string comment) + { + if (comment == null) + { + throw new ArgumentNullException("comment"); + } + + HtmlCommentNode c = CreateComment(); + c.Comment = comment; + return c; + } + + /// + /// Creates an HTML element node with the specified name. + /// + /// The qualified name of the element. May not be null. + /// The new HTML node. + public HtmlNode CreateElement(string name) + { + if (name == null) + { + throw new ArgumentNullException("name"); + } + + HtmlNode node = CreateNode(HtmlNodeType.Element); + node.Name = name; + return node; + } + + /// + /// Creates an HTML text node. + /// + /// The new HTML text node. + public HtmlTextNode CreateTextNode() + { + return (HtmlTextNode) CreateNode(HtmlNodeType.Text); + } + + /// + /// Creates an HTML text node with the specified text. + /// + /// The text of the node. May not be null. + /// The new HTML text node. + public HtmlTextNode CreateTextNode(string text) + { + if (text == null) + { + throw new ArgumentNullException("text"); + } + + HtmlTextNode t = CreateTextNode(); + t.Text = text; + return t; + } + + /// + /// Detects the encoding of an HTML stream. + /// + /// The input stream. May not be null. + /// The detected encoding. + public Encoding DetectEncoding(Stream stream) + { + return DetectEncoding(stream, false); + } + + /// + /// Detects the encoding of an HTML stream. + /// + /// The input stream. May not be null. + /// The html is checked. + /// The detected encoding. + public Encoding DetectEncoding(Stream stream, bool checkHtml) + { + _useHtmlEncodingForStream = checkHtml; + + if (stream == null) + { + throw new ArgumentNullException("stream"); + } + + return DetectEncoding(new StreamReader(stream)); + } + + + /// + /// Detects the encoding of an HTML text provided on a TextReader. + /// + /// The TextReader used to feed the HTML. May not be null. + /// The detected encoding. + public Encoding DetectEncoding(TextReader reader) + { + if (reader == null) + { + throw new ArgumentNullException("reader"); + } + + _onlyDetectEncoding = true; + if (OptionCheckSyntax) + { + Openednodes = new Dictionary(); + } + else + { + Openednodes = null; + } + + if (OptionUseIdAttribute) + { + Nodesid = new Dictionary(StringComparer.OrdinalIgnoreCase); + } + else + { + Nodesid = null; + } + + StreamReader sr = reader as StreamReader; + if (sr != null && !_useHtmlEncodingForStream) + { + Text = sr.ReadToEnd(); + _streamencoding = sr.CurrentEncoding; + return _streamencoding; + } + + _streamencoding = null; + _declaredencoding = null; + + Text = reader.ReadToEnd(); + _documentnode = CreateNode(HtmlNodeType.Document, 0); + + // this is almost a hack, but it allows us not to muck with the original parsing code + try + { + Parse(); + } + catch (EncodingFoundException ex) + { + return ex.Encoding; + } + + return _streamencoding; + } + + + /// + /// Detects the encoding of an HTML text. + /// + /// The input html text. May not be null. + /// The detected encoding. + public Encoding DetectEncodingHtml(string html) + { + if (html == null) + { + throw new ArgumentNullException("html"); + } + + using (StringReader sr = new StringReader(html)) + { + Encoding encoding = DetectEncoding(sr); + return encoding; + } + } + + /// + /// Gets the HTML node with the specified 'id' attribute value. + /// + /// The attribute id to match. May not be null. + /// The HTML node with the matching id or null if not found. + public HtmlNode GetElementbyId(string id) + { + if (id == null) + { + throw new ArgumentNullException("id"); + } + + if (Nodesid == null) + { + throw new Exception(HtmlExceptionUseIdAttributeFalse); + } + + return Nodesid.ContainsKey(id) ? Nodesid[id] : null; + } + + /// + /// Loads an HTML document from a stream. + /// + /// The input stream. + public void Load(Stream stream) + { + Load(new StreamReader(stream, OptionDefaultStreamEncoding)); + } + + /// + /// Loads an HTML document from a stream. + /// + /// The input stream. + /// Indicates whether to look for byte order marks at the beginning of the stream. + public void Load(Stream stream, bool detectEncodingFromByteOrderMarks) + { + Load(new StreamReader(stream, detectEncodingFromByteOrderMarks)); + } + + /// + /// Loads an HTML document from a stream. + /// + /// The input stream. + /// The character encoding to use. + public void Load(Stream stream, Encoding encoding) + { + Load(new StreamReader(stream, encoding)); + } + + /// + /// Loads an HTML document from a stream. + /// + /// The input stream. + /// The character encoding to use. + /// Indicates whether to look for byte order marks at the beginning of the stream. + public void Load(Stream stream, Encoding encoding, bool detectEncodingFromByteOrderMarks) + { + Load(new StreamReader(stream, encoding, detectEncodingFromByteOrderMarks)); + } + + /// + /// Loads an HTML document from a stream. + /// + /// The input stream. + /// The character encoding to use. + /// Indicates whether to look for byte order marks at the beginning of the stream. + /// The minimum buffer size. + public void Load(Stream stream, Encoding encoding, bool detectEncodingFromByteOrderMarks, int buffersize) + { + Load(new StreamReader(stream, encoding, detectEncodingFromByteOrderMarks, buffersize)); + } + + + /// + /// Loads the HTML document from the specified TextReader. + /// + /// The TextReader used to feed the HTML data into the document. May not be null. + public void Load(TextReader reader) + { + // all Load methods pass down to this one + if (reader == null) + throw new ArgumentNullException("reader"); + + _onlyDetectEncoding = false; + + if (OptionCheckSyntax) + Openednodes = new Dictionary(); + else + Openednodes = null; + + if (OptionUseIdAttribute) + { + Nodesid = new Dictionary(StringComparer.OrdinalIgnoreCase); + } + else + { + Nodesid = null; + } + + StreamReader sr = reader as StreamReader; + if (sr != null) + { + try + { + // trigger bom read if needed + sr.Peek(); + } + // ReSharper disable EmptyGeneralCatchClause + catch (Exception) + // ReSharper restore EmptyGeneralCatchClause + { + // void on purpose + } + + _streamencoding = sr.CurrentEncoding; + } + else + { + _streamencoding = null; + } + + _declaredencoding = null; + + Text = reader.ReadToEnd(); + _documentnode = CreateNode(HtmlNodeType.Document, 0); + Parse(); + + if (!OptionCheckSyntax || Openednodes == null) return; + foreach (HtmlNode node in Openednodes.Values) + { + if (!node._starttag) // already reported + { + continue; + } + + string html; + if (OptionExtractErrorSourceText) + { + html = node.OuterHtml; + if (html.Length > OptionExtractErrorSourceTextMaxLength) + { + html = html.Substring(0, OptionExtractErrorSourceTextMaxLength); + } + } + else + { + html = string.Empty; + } + + AddError( + HtmlParseErrorCode.TagNotClosed, + node._line, node._lineposition, + node._streamposition, html, + "End tag was not found"); + } + + // we don't need this anymore + Openednodes.Clear(); + } + + /// + /// Loads the HTML document from the specified string. + /// + /// String containing the HTML document to load. May not be null. + public void LoadHtml(string html) + { + if (html == null) + { + throw new ArgumentNullException("html"); + } + + using (StringReader sr = new StringReader(html)) + { + Load(sr); + } + } + + /// + /// Saves the HTML document to the specified stream. + /// + /// The stream to which you want to save. + public void Save(Stream outStream) + { + StreamWriter sw = new StreamWriter(outStream, GetOutEncoding()); + Save(sw); + } + + /// + /// Saves the HTML document to the specified stream. + /// + /// The stream to which you want to save. May not be null. + /// The character encoding to use. May not be null. + public void Save(Stream outStream, Encoding encoding) + { + if (outStream == null) + { + throw new ArgumentNullException("outStream"); + } + + if (encoding == null) + { + throw new ArgumentNullException("encoding"); + } + + StreamWriter sw = new StreamWriter(outStream, encoding); + Save(sw); + } + + + /// + /// Saves the HTML document to the specified StreamWriter. + /// + /// The StreamWriter to which you want to save. + public void Save(StreamWriter writer) + { + Save((TextWriter) writer); + } + + /// + /// Saves the HTML document to the specified TextWriter. + /// + /// The TextWriter to which you want to save. May not be null. + public void Save(TextWriter writer) + { + if (writer == null) + { + throw new ArgumentNullException("writer"); + } + + DocumentNode.WriteTo(writer); + writer.Flush(); + } + + /// + /// Saves the HTML document to the specified XmlWriter. + /// + /// The XmlWriter to which you want to save. + public void Save(XmlWriter writer) + { + DocumentNode.WriteTo(writer); + writer.Flush(); + } + + #endregion + + #region Internal Methods + + internal HtmlAttribute CreateAttribute() + { + return new HtmlAttribute(this); + } + + internal HtmlNode CreateNode(HtmlNodeType type) + { + return CreateNode(type, -1); + } + + internal HtmlNode CreateNode(HtmlNodeType type, int index) + { + switch (type) + { + case HtmlNodeType.Comment: + return new HtmlCommentNode(this, index); + + case HtmlNodeType.Text: + return new HtmlTextNode(this, index); + + default: + return new HtmlNode(type, this, index); + } + } + + internal Encoding GetOutEncoding() + { + // when unspecified, use the stream encoding first + return _declaredencoding ?? (_streamencoding ?? OptionDefaultStreamEncoding); + } + + internal HtmlNode GetXmlDeclaration() + { + if (!_documentnode.HasChildNodes) + return null; + + foreach (HtmlNode node in _documentnode._childnodes) + if (node.Name == "?xml") // it's ok, names are case sensitive + return node; + + return null; + } + + internal void SetIdForNode(HtmlNode node, string id) + { + if (!OptionUseIdAttribute) + return; + + if ((Nodesid == null) || (id == null)) + return; + + if (node == null) + Nodesid.Remove(id); + else + Nodesid[id] = node; + } + + internal void UpdateLastParentNode() + { + do + { + if (_lastparentnode.Closed) + _lastparentnode = _lastparentnode.ParentNode; + } while ((_lastparentnode != null) && (_lastparentnode.Closed)); + + if (_lastparentnode == null) + _lastparentnode = _documentnode; + } + + #endregion + + #region Private Methods + + private void AddError(HtmlParseErrorCode code, int line, int linePosition, int streamPosition, string sourceText, string reason) + { + HtmlParseError err = new HtmlParseError(code, line, linePosition, streamPosition, sourceText, reason); + _parseerrors.Add(err); + return; + } + + private void CloseCurrentNode() + { + if (_currentnode.Closed) // text or document are by def closed + return; + + bool error = false; + HtmlNode prev = Utilities.GetDictionaryValueOrDefault(Lastnodes, _currentnode.Name); + + // find last node of this kind + if (prev == null) + { + if (HtmlNode.IsClosedElement(_currentnode.Name)) + { + //
will be seen as
+ _currentnode.CloseNode(_currentnode); + + // add to parent node + if (_lastparentnode != null) + { + HtmlNode foundNode = null; + Stack futureChild = new Stack(); + + if (!_currentnode.Name.Equals("br")) + { + for (HtmlNode node = _lastparentnode.LastChild; node != null; node = node.PreviousSibling) + { + // br node never can contains other nodes. + if ((node.Name == _currentnode.Name) && (!node.HasChildNodes)) + { + foundNode = node; + break; + } + + futureChild.Push(node); + } + } + + + if (foundNode != null) + { + while (futureChild.Count != 0) + { + HtmlNode node = futureChild.Pop(); + _lastparentnode.RemoveChild(node); + foundNode.AppendChild(node); + } + } + else + { + _lastparentnode.AppendChild(_currentnode); + } + } + } + else + { + // node has no parent + // node is not a closed node + + if (HtmlNode.CanOverlapElement(_currentnode.Name)) + { + // this is a hack: add it as a text node + HtmlNode closenode = CreateNode(HtmlNodeType.Text, _currentnode._outerstartindex); + closenode._outerlength = _currentnode._outerlength; + ((HtmlTextNode) closenode).Text = ((HtmlTextNode) closenode).Text.ToLowerInvariant(); + if (_lastparentnode != null) + { + _lastparentnode.AppendChild(closenode); + } + } + else + { + if (HtmlNode.IsEmptyElement(_currentnode.Name)) + { + AddError( + HtmlParseErrorCode.EndTagNotRequired, + _currentnode._line, _currentnode._lineposition, + _currentnode._streamposition, _currentnode.OuterHtml, + "End tag is not required"); + } + else + { + // node cannot overlap, node is not empty + AddError( + HtmlParseErrorCode.TagNotOpened, + _currentnode._line, _currentnode._lineposition, + _currentnode._streamposition, _currentnode.OuterHtml, + "Start tag <" + _currentnode.Name + "> was not found"); + error = true; + } + } + } + } + else + { + if (OptionFixNestedTags) + { + if (FindResetterNodes(prev, GetResetters(_currentnode.Name))) + { + AddError( + HtmlParseErrorCode.EndTagInvalidHere, + _currentnode._line, _currentnode._lineposition, + _currentnode._streamposition, _currentnode.OuterHtml, + "End tag invalid here"); + error = true; + } + } + + if (!error) + { + Lastnodes[_currentnode.Name] = prev._prevwithsamename; + prev.CloseNode(_currentnode); + } + } + + + // we close this node, get grandparent + if (!error) + { + if ((_lastparentnode != null) && + ((!HtmlNode.IsClosedElement(_currentnode.Name)) || + (_currentnode._starttag))) + { + UpdateLastParentNode(); + } + } + } + + private string CurrentNodeName() + { + return Text.Substring(_currentnode._namestartindex, _currentnode._namelength); + } + + + private void DecrementPosition() + { + _index--; + if (_lineposition == 0) + { + _lineposition = _maxlineposition; + _line--; + } + else + { + _lineposition--; + } + } + + private HtmlNode FindResetterNode(HtmlNode node, string name) + { + HtmlNode resetter = Utilities.GetDictionaryValueOrDefault(Lastnodes, name); + if (resetter == null) + return null; + + if (resetter.Closed) + return null; + + if (resetter._streamposition < node._streamposition) + { + return null; + } + + return resetter; + } + + private bool FindResetterNodes(HtmlNode node, string[] names) + { + if (names == null) + return false; + + for (int i = 0; i < names.Length; i++) + { + if (FindResetterNode(node, names[i]) != null) + return true; + } + + return false; + } + + private void FixNestedTag(string name, string[] resetters) + { + if (resetters == null) + return; + + HtmlNode prev = Utilities.GetDictionaryValueOrDefault(Lastnodes, _currentnode.Name); + // if we find a previous unclosed same name node, without a resetter node between, we must close it + if (prev == null || (Lastnodes[name].Closed)) return; + // try to find a resetter node, if found, we do nothing + if (FindResetterNodes(prev, resetters)) + { + return; + } + + // ok we need to close the prev now + // create a fake closer node + HtmlNode close = new HtmlNode(prev.NodeType, this, -1); + close._endnode = close; + prev.CloseNode(close); + } + + private void FixNestedTags() + { + // we are only interested by start tags, not closing tags + if (!_currentnode._starttag) + return; + + string name = CurrentNodeName(); + FixNestedTag(name, GetResetters(name)); + } + + private string[] GetResetters(string name) + { + string[] resetters; + + if (!HtmlResetters.TryGetValue(name, out resetters)) + { + return null; + } + + return resetters; + } + + private void IncrementPosition() + { + if (_crc32 != null) + { + // REVIEW: should we add some checksum code in DecrementPosition too? + _crc32.AddToCRC32(_c); + } + + _index++; + _maxlineposition = _lineposition; + if (_c == 10) + { + _lineposition = 0; + _line++; + } + else + { + _lineposition++; + } + } + + private bool IsValidTag() + { + bool isValidTag = _c == '<' && _index < Text.Length && (Char.IsLetter(Text[_index]) || Text[_index] == '/' || Text[_index] == '?' || Text[_index] == '!' || Text[_index] == '%'); + return isValidTag; + } + + private bool NewCheck() + { + if (_c != '<' || !IsValidTag()) + { + return false; + } + + if (_index < Text.Length) + { + if (Text[_index] == '%') + { + if (DisableServerSideCode) + { + return false; + } + + switch (_state) + { + case ParseState.AttributeAfterEquals: + PushAttributeValueStart(_index - 1); + break; + + case ParseState.BetweenAttributes: + PushAttributeNameStart(_index - 1, _lineposition -1); + break; + + case ParseState.WhichTag: + PushNodeNameStart(true, _index - 1); + _state = ParseState.Tag; + break; + } + + _oldstate = _state; + _state = ParseState.ServerSideCode; + return true; + } + } + + if (!PushNodeEnd(_index - 1, true)) + { + // stop parsing + _index = Text.Length; + return true; + } + + _state = ParseState.WhichTag; + if ((_index - 1) <= (Text.Length - 2)) + { + if (Text[_index] == '!' || Text[_index] == '?') + { + PushNodeStart(HtmlNodeType.Comment, _index - 1, _lineposition -1); + PushNodeNameStart(true, _index); + PushNodeNameEnd(_index + 1); + _state = ParseState.Comment; + if (_index < (Text.Length - 2)) + { + if ((Text[_index + 1] == '-') && + (Text[_index + 2] == '-')) + { + _fullcomment = true; + } + else + { + _fullcomment = false; + } + } + + return true; + } + } + + PushNodeStart(HtmlNodeType.Element, _index - 1, _lineposition - 1); + return true; + } + + private void Parse() + { + if (ParseExecuting != null) + { + ParseExecuting(this); + } + + int lastquote = 0; + if (OptionComputeChecksum) + { +#pragma warning disable CS0618 // ͻԱѹʱ + _crc32 = new Crc32(); +#pragma warning restore CS0618 // ͻԱѹʱ + } + + Lastnodes = new Dictionary(); + _c = 0; + _fullcomment = false; + _parseerrors = new List(); + _line = 1; + _lineposition = 0; + _maxlineposition = 0; + + _state = ParseState.Text; + _oldstate = _state; + _documentnode._innerlength = Text.Length; + _documentnode._outerlength = Text.Length; + _remainderOffset = Text.Length; + + _lastparentnode = _documentnode; + _currentnode = CreateNode(HtmlNodeType.Text, 0); + _currentattribute = null; + + _index = 0; + PushNodeStart(HtmlNodeType.Text, 0, _lineposition); + while (_index < Text.Length) + { + _c = Text[_index]; + IncrementPosition(); + + switch (_state) + { + case ParseState.Text: + if (NewCheck()) + continue; + break; + + case ParseState.WhichTag: + if (NewCheck()) + continue; + if (_c == '/') + { + PushNodeNameStart(false, _index); + } + else + { + PushNodeNameStart(true, _index - 1); + DecrementPosition(); + } + + _state = ParseState.Tag; + break; + + case ParseState.Tag: + if (NewCheck()) + continue; + if (IsWhiteSpace(_c)) + { + CloseParentImplicitExplicitNode(); + + PushNodeNameEnd(_index - 1); + if (_state != ParseState.Tag) + continue; + _state = ParseState.BetweenAttributes; + continue; + } + + if (_c == '/') + { + CloseParentImplicitExplicitNode(); + + PushNodeNameEnd(_index - 1); + if (_state != ParseState.Tag) + continue; + _state = ParseState.EmptyTag; + continue; + } + + if (_c == '>') + { + CloseParentImplicitExplicitNode(); + + //// CHECK if parent is compatible with end tag + //if (IsParentIncompatibleEndTag()) + //{ + // _state = ParseState.Text; + // PushNodeStart(HtmlNodeType.Text, _index); + // break; + //} + + PushNodeNameEnd(_index - 1); + if (_state != ParseState.Tag) + continue; + if (!PushNodeEnd(_index, false)) + { + // stop parsing + _index = Text.Length; + break; + } + + if (_state != ParseState.Tag) + continue; + _state = ParseState.Text; + PushNodeStart(HtmlNodeType.Text, _index, _lineposition); + } + + break; + + case ParseState.BetweenAttributes: + if (NewCheck()) + continue; + + if (IsWhiteSpace(_c)) + continue; + + if ((_c == '/') || (_c == '?')) + { + _state = ParseState.EmptyTag; + continue; + } + + if (_c == '>') + { + if (!PushNodeEnd(_index, false)) + { + // stop parsing + _index = Text.Length; + break; + } + + if (_state != ParseState.BetweenAttributes) + continue; + _state = ParseState.Text; + PushNodeStart(HtmlNodeType.Text, _index, _lineposition); + continue; + } + + PushAttributeNameStart(_index - 1, _lineposition -1); + _state = ParseState.AttributeName; + break; + + case ParseState.EmptyTag: + if (NewCheck()) + continue; + + if (_c == '>') + { + if (!PushNodeEnd(_index, true)) + { + // stop parsing + _index = Text.Length; + break; + } + + if (_state != ParseState.EmptyTag) + continue; + _state = ParseState.Text; + PushNodeStart(HtmlNodeType.Text, _index, _lineposition); + continue; + } + + // we may end up in this state if attributes are incorrectly seperated + // by a /-character. If so, start parsing attribute-name immediately. + if (!IsWhiteSpace(_c)) + { + // Just do nothing and push to next one! + DecrementPosition(); + _state = ParseState.BetweenAttributes; + continue; + } + else + { + _state = ParseState.BetweenAttributes; + } + + break; + + case ParseState.AttributeName: + if (NewCheck()) + continue; + + if (IsWhiteSpace(_c)) + { + PushAttributeNameEnd(_index - 1); + _state = ParseState.AttributeBeforeEquals; + continue; + } + + if (_c == '=') + { + PushAttributeNameEnd(_index - 1); + _state = ParseState.AttributeAfterEquals; + continue; + } + + if (_c == '>') + { + PushAttributeNameEnd(_index - 1); + if (!PushNodeEnd(_index, false)) + { + // stop parsing + _index = Text.Length; + break; + } + + if (_state != ParseState.AttributeName) + continue; + _state = ParseState.Text; + PushNodeStart(HtmlNodeType.Text, _index, _lineposition); + continue; + } + + break; + + case ParseState.AttributeBeforeEquals: + if (NewCheck()) + continue; + + if (IsWhiteSpace(_c)) + continue; + if (_c == '>') + { + if (!PushNodeEnd(_index, false)) + { + // stop parsing + _index = Text.Length; + break; + } + + if (_state != ParseState.AttributeBeforeEquals) + continue; + _state = ParseState.Text; + PushNodeStart(HtmlNodeType.Text, _index, _lineposition); + continue; + } + + if (_c == '=') + { + _state = ParseState.AttributeAfterEquals; + continue; + } + + // no equals, no whitespace, it's a new attrribute starting + _state = ParseState.BetweenAttributes; + DecrementPosition(); + break; + + case ParseState.AttributeAfterEquals: + if (NewCheck()) + continue; + + if (IsWhiteSpace(_c)) + continue; + + if ((_c == '\'') || (_c == '"')) + { + _state = ParseState.QuotedAttributeValue; + PushAttributeValueStart(_index, _c); + lastquote = _c; + continue; + } + + if (_c == '>') + { + if (!PushNodeEnd(_index, false)) + { + // stop parsing + _index = Text.Length; + break; + } + + if (_state != ParseState.AttributeAfterEquals) + continue; + _state = ParseState.Text; + PushNodeStart(HtmlNodeType.Text, _index, _lineposition); + continue; + } + + PushAttributeValueStart(_index - 1); + _state = ParseState.AttributeValue; + break; + + case ParseState.AttributeValue: + if (NewCheck()) + continue; + + if (IsWhiteSpace(_c)) + { + PushAttributeValueEnd(_index - 1); + _state = ParseState.BetweenAttributes; + continue; + } + + if (_c == '>') + { + PushAttributeValueEnd(_index - 1); + if (!PushNodeEnd(_index, false)) + { + // stop parsing + _index = Text.Length; + break; + } + + if (_state != ParseState.AttributeValue) + continue; + _state = ParseState.Text; + PushNodeStart(HtmlNodeType.Text, _index, _lineposition); + continue; + } + + break; + + case ParseState.QuotedAttributeValue: + if (_c == lastquote) + { + PushAttributeValueEnd(_index - 1); + _state = ParseState.BetweenAttributes; + continue; + } + + if (_c == '<') + { + if (_index < Text.Length) + { + if (Text[_index] == '%') + { + _oldstate = _state; + _state = ParseState.ServerSideCode; + continue; + } + } + } + + break; + + case ParseState.Comment: + if (_c == '>') + { + if (_fullcomment) + { + if (((Text[_index - 2] != '-') || (Text[_index - 3] != '-')) + && + ((Text[_index - 2] != '!') || (Text[_index - 3] != '-') || + (Text[_index - 4] != '-'))) + { + continue; + } + } + + if (!PushNodeEnd(_index, false)) + { + // stop parsing + _index = Text.Length; + break; + } + + _state = ParseState.Text; + PushNodeStart(HtmlNodeType.Text, _index, _lineposition); + continue; + } + + break; + + case ParseState.ServerSideCode: + if (_c == '%') + { + if (_index < Text.Length) + { + if (Text[_index] == '>') + { + switch (_oldstate) + { + case ParseState.AttributeAfterEquals: + _state = ParseState.AttributeValue; + break; + + case ParseState.BetweenAttributes: + PushAttributeNameEnd(_index + 1); + _state = ParseState.BetweenAttributes; + break; + + default: + _state = _oldstate; + break; + } + + IncrementPosition(); + } + } + } + else if (_oldstate == ParseState.QuotedAttributeValue + && _c == lastquote) + { + _state = _oldstate; + DecrementPosition(); + } + + break; + + case ParseState.PcData: + // look for ') || (IsWhiteSpace(c))) + { + // add the script as a text node + HtmlNode script = CreateNode(HtmlNodeType.Text, + _currentnode._outerstartindex + + _currentnode._outerlength); + script._outerlength = _index - 1 - script._outerstartindex; + script._streamposition = script._outerstartindex; + script._line = _currentnode.Line; + script._lineposition = _currentnode.LinePosition + _currentnode._namelength + 2; + + _currentnode.AppendChild(script); + + // https://www.w3schools.com/jsref/prop_node_innertext.asp + // textContent returns the text content of all elements, while innerText returns the content of all elements, except for